main
1// Lightweight tags point the ref at a commit. Annotated tags add a tag object and point the ref at that.
2// Delete uses the same compare-and-swap as a branch delete.
3import { encodeTag, plyError, fetchCommit, hashObject, ident, operation, parseCommitId, parseOid, parseRefname, push, resolveCommit, TYPE, ZERO_OID } from 'ply'
4import { recordGet } from '../absent.ts'
5import { err, ok, type Result } from '../http/machine.ts'
6import { type PlyError } from '../ply-result.ts'
7import { advertisedOid } from './advertised.ts'
8import { type CallOpts, type GitOutcome, type GitSpan, type GitTransport } from './call.ts'
9import { assertNever, done, refExistsAt, settle, type WorkerError, type Written } from './errors.ts'
10import { nowSeconds, stamp, type Stamp } from './identity.ts'
11import { asBody, parseDeleteOid, tagRef } from './request.ts'
12import { writeResult } from './result.ts'
13import { deleteRef } from './branch.ts'
15type Transport = GitTransport
16type Root = GitSpan
17type Outcome = GitOutcome
19function messageBody(message: string): string {
20 return message.endsWith('\n') ? message : `${message}\n`
21}
23async function commitOf(t: Transport, target: string): Promise<Result<string, PlyError>> {
24 if (parseOid(target).ok) {
25 const parsed = parseCommitId(target)
26 if (!parsed.ok) return parsed
27 const fetched = await fetchCommit(t, parsed.value)
28 if (!fetched.ok) {
29 const error = fetched.error
30 if (error.code === 'not_found' && error.miss) {
31 // Tag targets are commits. A not_found from fetchCommit stays 404 with ply's message.
32 switch (error.miss.kind) {
33 case 'commit':
34 case 'head_absent':
35 case 'head_unborn':
36 case 'is_directory':
37 case 'not_directory':
38 case 'path':
39 case 'ref':
40 case 'repository':
41 case 'submodule':
42 return err(error)
43 default:
44 return assertNever(error.miss)
45 }
46 }
47 return err(error)
48 }
49 return ok(parsed.value)
50 }
51 const resolved = await resolveCommit(t, target)
52 return resolved.ok ? ok(resolved.value.commit) : resolved
53}
55// ref_exists is the Worker's own conflict, not a PlyError: the body returns it as a value (see branch.ts).
56export async function createTag(remote: string, body: unknown, opts: CallOpts): Promise<Result<Record<string, unknown>, PlyError | WorkerError>> {
57 const raw = asBody(body)
58 const ref = tagRef(raw.name)
59 const target = raw.target
60 if (typeof target !== 'string' || target === '') throw plyError('bad_request', 'target is required')
61 if (parseOid(target).ok) {
62 const parsed = parseCommitId(target)
63 if (!parsed.ok) throw parsed.error
64 }
65 const messageField = recordGet(raw, 'message')
66 const taggerField = recordGet(raw, 'tagger')
67 const annotatedField = recordGet(raw, 'annotated')
68 const annotated = (annotatedField.tag === 'some' && annotatedField.value === true) || messageField.tag === 'some' || taggerField.tag === 'some'
69 const tagger: Stamp | null = annotated ? stamp(raw.tagger, 'tagger', nowSeconds()) : null
70 const message = messageField.tag === 'some' && typeof messageField.value === 'string' ? messageField.value : null
71 if (messageField.tag === 'some' && typeof messageField.value !== 'string') throw plyError('bad_request', 'message must be a string')
72 if (annotatedField.tag === 'some' && typeof annotatedField.value !== 'boolean') throw plyError('bad_request', 'annotated must be true or false')
73 const short = ref.replace(/^refs\/tags\//, '')
74 return settle(await operation<Written<Record<string, unknown>>>('tag_create', remote, { ...opts, attrs: { 'git.tag.ref': ref, 'git.tag.annotated': annotated } }, async ({ t, root, outcome }: { t: Transport; root: Root; outcome: Outcome }) => {
75 const existing = await advertisedOid(t, ref)
76 if (!existing.ok) return existing
77 if (existing.value) return outcome('ref_exists', refExistsAt(ref, existing.value))
78 const tip = await commitOf(t, target)
79 if (!tip.ok) return tip
80 const commit = tip.value
81 let newOid = commit
82 const objects: { type: number; data: Uint8Array<ArrayBuffer> }[] = []
83 if (annotated && tagger) {
84 const who = ident(tagger.person)
85 if (!who.ok) return who
86 const data = encodeTag({
87 object: commit,
88 type: 'commit',
89 tag: short,
90 tagger: who.value,
91 message: messageBody(message === null ? short : message),
92 })
93 if (!data.ok) return data
94 newOid = hashObject('tag', data.value)
95 objects.push({ type: TYPE.TAG, data: data.value })
96 }
97 root.set({ 'git.tag.commit': commit, 'git.tag.oid': newOid })
98 const name = parseRefname(ref)
99 if (!name.ok) return name
100 const pushed = await push(t, { ref: name.value, oldOid: ZERO_OID, newOid, objects })
101 if (!pushed.ok) {
102 if (pushed.error.code !== 'cas_conflict') return pushed
103 const cur = await advertisedOid(t, ref)
104 if (!cur.ok) return cur
105 return outcome('ref_exists', refExistsAt(ref, cur.value === null ? newOid : cur.value))
106 }
107 return outcome('tag', done(writeResult('tag', ref, newOid, null, { commit, annotated, pushBytes: pushed.value.packBytes })))
108 }))
109}
111export async function removeTag(remote: string, body: unknown, opts: CallOpts): Promise<Result<Record<string, unknown>, PlyError | WorkerError>> {
112 const raw = asBody(body)
113 return deleteRef(remote, tagRef(raw.name), parseDeleteOid(raw.oid), opts, 'tag_delete')
114}
Diagnostics4 git calls · 219 ms
CallStatusSizeTime0219 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 · hit4 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=4 git.response.bytes=145 git.response.cache=HIT git.response.duration_ms=4 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 · 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=41349 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=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
fetch2001.9 KiB212 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=212 git.response.bytes=1920 git.response.cache=MISS git.response.duration_ms=212 git.fetch.wants=5153264701d116d5d1fd4cf89eb50542ef6c529b 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=1920 git.pkt.payload.max=1899 git.sideband.band1.bytes=1898 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
- a5e2e546ce052947
- Request
- c376ef64…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format