main
1// The commit reads and names merge.ts and rebase.ts share. Internal: not a package entry, and kept out of merge.ts
2// so the ./merge entry does not export them.
3/* oxlint-disable eslint/require-await, typescript/promise-function-async -- as merge.ts: a function that forwards a promise */
4import type { Transport } from './transport.js';
5import type { Author, Commit } from './merge.js';
6import type { ValidatedIdent } from './validate.js';
7import type { ErrorOf, PlyError } from './errors.js';
8import type { FetchedCommit } from './commit.js';
9import type { Option, Result } from './result.js';
10import { fail } from './errors.js';
11import { objectAt } from './fetch.js';
12import { commitById } from './commit.js';
13import { parseCommit, TYPE } from './objects.js';
14import { validateIdent, validateRef } from './validate.js';
15import { parseOid, ZERO_OID, type Oid } from './oid.js';
16import { andThen, getOrElse, map, none, ok, some } from './result.js';
17import { fromNullish } from './absent.js';
19// a branch name as git's messages print it
20export const short = (r: string): string => r.replace(/^refs\/heads\//u, '');
21// Effect: one commit by oid (deepen 1: the commit alone), as bytes or parsed
22export const commitBytesAt = async (t: Transport, oid: Oid): Promise<Result<{ readonly data: Uint8Array }, PlyError>> => objectAt(t, oid, { expectType: TYPE.COMMIT, deepen: 1 });
23export const commitAt = async (t: Transport, oid: Oid): Promise<Result<Commit, PlyError>> => andThen(await commitBytesAt(t, oid), b => parseCommit(b.data, t.limits));
25export const isOid = (s: string): boolean => parseOid(s).ok;
26// A merge `from` or rebase `onto`, as read.js's resolveCommit takes a name (#103 item 4): a 40-hex commit id is taken as
27// given (Some; the all-zero id names nothing), anything else is a ref name (validated; None: ask ls-refs).
28// The id is parsed once, here: Some carries the Oid.
29export const givenOid = (name: string, what: string): Result<Option<Oid>, ErrorOf<'bad_request'>> => {
30 const id = parseOid(name);
31 if (!id.ok) return map(validateRef(name), () => none);
32 if (id.value === ZERO_OID) return fail('bad_request', `${what} must not be the zero oid`, { what });
33 return ok(some(id.value));
34};
35// Effect: a given commit id is a commit on the server, fetched alone (deepen 1). fetchCommit's not_found (a commit
36// miss: absent, or not a commit) is the caller's not_found, with that same miss. Every other code passes through: a
37// corrupt pack stays pack_corrupt (retryable), and is not reported as a missing commit.
38export const assertCommit = async (t: Transport, oid: Oid, what: string): Promise<Result<FetchedCommit, PlyError>> => {
39 const r = await commitById(t, oid);
40 if (r.ok) return r;
41 if (r.error.code !== 'not_found') return r;
42 return fail('not_found', `${what} ${oid} is not a commit on the remote`, { what, miss: r.error.miss });
43};
44// A commit stamp: who and when, each stamp with its own time and zone (#103 item 4). `time` is the operation's, for a
45// stamp that gives none (or null); an omitted zone is +0000. No stamp at all (null) is refused by validateIdent.
46export const stamp = (p: Author | null, time: number): Result<ValidatedIdent, ErrorOf<'bad_request'>> =>
47 validateIdent(p === null ? { time } : { name: p.name, email: p.email, time: getOrElse(fromNullish(p.time), time), tz: p.tz });
Diagnostics4 git calls · 28 ms
CallStatusSizeTime028 ms
discover200152 B3 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=3 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 · hit3 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=3 git.response.bytes=145 git.response.cache=HIT git.response.duration_ms=3 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 1020038 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=38434 git.response.cache=HIT git.response.duration_ms=3 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=19912563f540228593df0c489082e5e2508e21e4 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=38434 git.pkt.payload.max=38339 git.sideband.band1.bytes=38338 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=63 git.pack.bytes=38338 git.pack.ofs_delta=0 git.pack.ref_delta=8 git.pack.chain.max=8 git.pack.trailer=0bc36ab7adf82d3109177f11f1ea93f1ce071f77 git.pack.full=55Open pack map
fetch2001.4 KiB · hit22 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=22 git.response.bytes=1480 git.response.cache=HIT git.response.duration_ms=22 git.fetch.wants=e60f7366b3806aa23b367950de36e20a5055c8cd 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=1480 git.pkt.payload.max=1459 git.sideband.band1.bytes=1458 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.git
- Ref
- refs/heads/main
- Commit
- 19912563f540228593df0c489082e5e2508e21e4
- cf-ray
- a5e31c546c4a8682
- Request
- 772a3e5c…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format