main
1// The /v1 git routes, as `METHOD /path` keys of the READS and WRITES tables in src/index.js.
2// Every one runs under src/edge-trace.ts's tracer. test/worker-spans.test.js drives each key here and asserts its ply
3// spans reach Workers tracing, so a route added to index.js and not here stops the Worker at load (assertRouteTable).
4// /v1/flags and /v1/flags/eval are not git routes: they make no ply call and record no ply span.
6export const API_READ_ROUTES = [
7 'GET /v1/refs',
8 'GET /v1/discover',
9 'GET /v1/tree',
10 'GET /v1/commit',
11 'GET /v1/read',
12] as const
14export const API_WRITE_ROUTES = [
15 'POST /v1/edit',
16 'POST /v1/branch',
17 'DELETE /v1/branch',
18 'POST /v1/tag',
19 'DELETE /v1/tag',
20 'POST /v1/merge',
21 'POST /v1/rebase',
22 'POST /v1/cherry-pick',
23 'POST /v1/revert',
24] as const
26export type ApiRoute = (typeof API_READ_ROUTES)[number] | (typeof API_WRITE_ROUTES)[number]
28export const API_ROUTES: readonly ApiRoute[] = [...API_READ_ROUTES, ...API_WRITE_ROUTES]
30function drift(kind: string, want: readonly string[], table: Readonly<Record<string, unknown>>): string[] {
31 const have = Object.keys(table)
32 const missing = want.filter(key => !have.includes(key)).map(key => `${kind} table lacks ${key}`)
33 const extra = have.filter(key => !want.includes(key)).map(key => `${kind} route ${key} is not in src/api-routes.ts`)
34 return [...missing, ...extra]
35}
37/** Throws when the dispatch tables and this list differ. src/index.js calls it once, at module load. */
38export function assertRouteTable(reads: Readonly<Record<string, unknown>>, writes: Readonly<Record<string, unknown>>): void {
39 const problems = [...drift('read', API_READ_ROUTES, reads), ...drift('write', API_WRITE_ROUTES, writes)]
40 if (problems.length > 0) throw new Error(`/v1 route table drift: ${problems.join('; ')}`)
41}
Diagnostics4 git calls · 41 ms
CallStatusSizeTime041 ms
discover200152 B4 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=4 git.response.bytes=152 git.server.agent=gitty/1.0 git.server.object_format=sha1 git.server.caps=agent ls-refs fetch object-format git.server.fetch=shallow filter sideband-all git.protocol.version=2 git.pkt.frames=8 git.pkt.data=6 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=152 git.pkt.payload.max=34
ls-refs200145 B · hit5 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=5 git.response.bytes=145 git.response.cache=HIT git.response.duration_ms=5 git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=145 git.pkt.payload.max=76 git.ls_refs.count=2 git.ls_refs.head=refs/heads/main
fetchblob:none · deepen 1020040 KiB · hit2 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=2 git.response.bytes=41349 git.response.cache=HIT git.response.duration_ms=2 git.fetch.filter=blob:none git.fetch.filter.requested=tree:0 git.fetch.filter.fallback=blob:none git.fetch.filter.learned=false git.fetch.wants=526b305930b8ef382f2d7a1f9c0238730a585921 git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=6 git.pkt.data=4 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=41349 git.pkt.payload.max=41254 git.sideband.band1.bytes=41253 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=61 git.pack.bytes=41253 git.pack.ofs_delta=0 git.pack.ref_delta=0 git.pack.chain.max=0 git.pack.trailer=ab60efef4b7243678c75de64a4386986ee885c1c git.pack.full=61Open pack map
fetch200875 B · hit34 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=34 git.response.bytes=875 git.response.cache=HIT git.response.duration_ms=34 git.fetch.wants=57c3f292717f75a4906ea2eba123570c3b988b7c git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=875 git.pkt.payload.max=854 git.sideband.band1.bytes=853 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/ply-web.git
- Ref
- refs/heads/main
- Commit
- 526b305930b8ef382f2d7a1f9c0238730a585921
- cf-ray
- a5e2f5d81c433a24
- Request
- 0350a31b…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format