@warmhub/sdk-ts 0.127.0 → 0.129.0

package/CHANGELOG.md

@@ -1,5 +1,443 @@
 # @warmhub/sdk-ts changelog
 
+<!-- warmhub-changelog-artifact:v1 -->
+
+## 0.129.0
+
+No new release notes.
+
+## 0.128.0
+
+### Documentation
+
+Versioned release notes are available as [HTML, Markdown, and JSON](https://docs.warmhub.ai/sdk/typescript/changelog/).
+
+---
+
+Historical changelog shipped with @warmhub/sdk-ts 0.127.0:
+
+# @warmhub/sdk-ts changelog
+
 Release 0.127.0.
 
 Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.126.0:
+
+# @warmhub/sdk-ts changelog
+
+Release 0.126.0.
+
+Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.125.0:
+
+# @warmhub/sdk-ts changelog
+
+Release 0.125.0.
+
+Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.124.0:
+
+# @warmhub/sdk-ts changelog
+
+Release 0.124.0.
+
+Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.123.0:
+
+# @warmhub/sdk-ts changelog
+
+Release 0.123.0.
+
+Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.122.3:
+
+# @warmhub/sdk-ts changelog
+
+Release 0.122.3.
+
+Changelog generation is temporarily disabled while the release integration is repaired.
+
+
+Earlier changelog shipped with @warmhub/sdk-ts 0.120.0:
+
+# Changelog — `@warmhub/sdk-ts`
+
+## How to read this file
+
+Entries are grouped by release. `## Unreleased` collects everything merged but
+not yet published; the release pipeline is the sole version authority and
+stamps the exact version at publish time, so no heading here ever invents one.
+
+Within a release, four change sections appear, in this order. A section is
+present only when it has entries; a release may add plain narrative sections
+after them ("Behavior worth knowing", "Still supported") when the change needs
+context that is not itself a change entry.
+
+- **Breaking** — your code must change. Every item is written as a migration:
+  what it was → what it is now → the exact edit, with before/after code → why,
+  in one line, citing the ruling.
+- **Added** — new surface. Nothing to do unless you want it.
+- **Fixed** — behavior that was wrong and now is not.
+- **Removed** — surface that is gone with nothing to put in its place. Anything
+  a caller can migrate to is filed under Breaking instead, so this section is
+  often absent.
+
+WarmHub's source repository is private, so rulings are cited by pull-request
+number rather than linked. Release notes live at
+<https://docs.warmhub.ai/releases/overview/>.
+
+The Python SDK, `warmhub`, keeps the same file in the same shape.
+
+---
+
+## Unreleased
+
+## 0.120.0
+
+Repository export v3. The exact version is stamped at publish time by the
+release pipeline; source manifests stay at `0.0.0-development`.
+
+### Breaking
+
+#### Checkpoint generation is retired — take an export instead
+
+**What it was.** Producing a fresh snapshot of a repository meant asking the
+server to mint a checkpoint, polling until the job completed, requesting a
+short-lived signed URL for the archive, downloading it outside the SDK, and
+verifying the bytes locally.
+
+**What it is now.** One call that streams verified rows, with the header,
+per-row canonical decode, ordering and trailer checks applied as the bytes
+arrive. There is no job to start, no state to poll, and no separate verify
+step — a row that reaches you has already been proven.
+
+**Migration.**
+
+Before:
+
+```ts
+import { createReadStream } from 'node:fs'
+import { writeFile } from 'node:fs/promises'
+import { Readable } from 'node:stream'
+import { verifyRepositoryCheckpointArchive } from '@warmhub/sdk-ts/checkpoint'
+
+let status = await client.repo.checkpoint.generate('acme', 'catalog')
+while (status.state !== 'complete') {
+  await new Promise((resolve) => setTimeout(resolve, 1_000))
+  status = await client.repo.checkpoint.status('acme', 'catalog', {
+    checkpointId: status.checkpointId,
+  })
+}
+
+const access = await client.repo.checkpoint.getAccess('acme', 'catalog', {
+  checkpoint: 'latest',
+  artifact: 'archive',
+})
+// Signed URL: fetched WITHOUT the WarmHub bearer token.
+const archive = await fetch(access.url)
+await writeFile('catalog.zip', Readable.fromWeb(archive.body))
+await verifyRepositoryCheckpointArchive(createReadStream('catalog.zip'))
+```
+
+After:
+
+```ts
+for await (const row of client.repo.export('acme', 'catalog')) {
+  console.log(row.kind, row.durableId, row.version)
+}
+```
+
+If you were relying on `generate` returning before the download — starting the
+build in one process and fetching it in another, or on another machine — that
+shape survives as the async token flow:
+
+```ts
+// Process A: ask for it, get a token, do not read a byte.
+const prepared = await client.repo.exportPrepare('acme', 'catalog')
+console.log(prepared.exportToken, prepared.atRepoSeq)
+
+// Process B: redeem it. `export` polls while the fold is still running.
+for await (const row of client.repo.export('acme', 'catalog', {
+  token: prepared.exportToken,
+})) {
+  // ...
+}
+```
+
+The token is redeemable only at that repository's URL, by a principal holding
+checkpoint read there.
+
+**Why.** Export format v3 replaces checkpoint generation outright; the whole
+generation pipeline is deleted server-side (PR #10020).
+
+#### `client.repo.checkpoint.generate` and `.retry` are gone
+
+**What it was.** `generate(orgName, repoName, { atLeastRepoSeq })` minted a
+checkpoint; `retry(orgName, repoName, checkpointId)` re-ran a failed one. Both
+returned a `RepositoryCheckpointStatus`.
+
+**What it is now.** Neither method exists, and the tRPC procedures behind them
+(`repo.checkpoint.generate`, `repo.checkpoint.retry`) are no longer served. The
+`repo:checkpoint-generate` scope no longer buys anything.
+
+**Migration.** Replace both with `client.repo.export`.
+
+Before:
+
+```ts
+const fresh = await client.repo.checkpoint.generate('acme', 'catalog', {
+  atLeastRepoSeq: 42,
+})
+const recovered = await client.repo.checkpoint.retry(
+  'acme',
+  'catalog',
+  failed.checkpointId,
+)
+```
+
+After:
+
+```ts
+// `atRepoSeq` pins the fence the way `atLeastRepoSeq` asked for a floor.
+// Omit it and the server pins current and echoes it back in the header.
+for await (const row of client.repo.export('acme', 'catalog', {
+  atRepoSeq: 42,
+})) {
+  // ...
+}
+```
+
+There is no retry to replace: an export is a read, so a failed one is re-read,
+not re-queued.
+
+**Why.** Same retirement (PR #10020).
+
+#### Failed checkpoint statuses now all answer `nextAction: 'none'`
+
+**What it was.** `RepositoryCheckpointStatus` carried `nextAction: 'retry'` for
+`deadline_exceeded` and `attempts_exhausted`, and `nextAction: 'generate'` for
+`invalid_source`. Each named a procedure a reader could call.
+
+**What it is now.** Those three failure codes join `repository_deleted` in a
+single variant with `nextAction: 'none'`. The `'retry'` and `'generate'`
+members are gone from the union, so a `switch` over `nextAction` that had cases
+for them will no longer typecheck against them.
+
+**Migration.**
+
+Before:
+
+```ts
+if (status.state === 'failed') {
+  switch (status.nextAction) {
+    case 'retry':
+      await client.repo.checkpoint.retry('acme', 'catalog', status.checkpointId)
+      break
+    case 'generate':
+      await client.repo.checkpoint.generate('acme', 'catalog')
+      break
+    case 'contact_support':
+      report(status.checkpointId, status.failureCode)
+      break
+  }
+}
+```
+
+After:
+
+```ts
+if (status.state === 'failed') {
+  if (status.nextAction === 'contact_support') {
+    report(status.checkpointId, status.failureCode)
+  } else {
+    // Terminal. Take an export instead of trying to revive the checkpoint.
+    for await (const row of client.repo.export('acme', 'catalog')) {
+      // ...
+    }
+  }
+}
+```
+
+**Why.** Each retired value pointed at a route the server no longer serves;
+leaving them in the vocabulary would send readers to a 404 (PR #10020).
+
+### Added
+
+- **`client.repo.export(orgName, repoName, options?)`** — an
+  `AsyncGenerator<RepositoryExportRow>` over a verified export stream. Options:
+  `mode` (`'heads'`, the default, or `'ops'`), `sinceRepoSeq` (delta base;
+  `0` means a full export), `atRepoSeq` (pin the fence), `prefer`
+  (`'sync'` | `'async'`), `token`, `session`, `afterDurableId`,
+  `pollIntervalMs`, and `signal`.
+
+- **`client.repo.exportPrepare(orgName, repoName, options?)`** — returns
+  `{ exportToken, atRepoSeq }` without waiting for the fold or reading the
+  body. Takes `mode`, `sinceRepoSeq`, `atRepoSeq`, and `signal`.
+
+- **`RepositoryExportSession` / `createRepositoryExportSession()`** — the
+  rolling verification state of one logical export: the opening `header`, the
+  resume cursor `lastDurableId`, `rowCount`, `complete`, and — once the stream
+  is finalized — `contentSha256`. Pass the same session back into `export` to
+  resume a stream that broke:
+
+  ```ts
+  import {
+    createRepositoryExportSession,
+    RepositoryExportError,
+  } from '@warmhub/sdk-ts'
+
+  const session = createRepositoryExportSession()
+  const rows: unknown[] = []
+  for (let attempt = 0; attempt < 3 && !session.complete; attempt += 1) {
+    try {
+      // The session's own cursor and fence pin the resumed request; do not
+      // recompute them.
+      for await (const row of client.repo.export('acme', 'catalog', {
+        session,
+      })) {
+        rows.push(row)
+      }
+    } catch (error) {
+      if (
+        !(error instanceof RepositoryExportError) ||
+        error.reason !== 'truncated'
+      ) {
+        throw error
+      }
+    }
+  }
+  console.log(session.rowCount, session.contentSha256)
+  ```
+
+- **`readRepositoryExportStream(source, session, expected, options?)`** — read
+  a response body you fetched with your own transport, verified against a
+  session as it goes. `client.repo.export` is the usual entry point.
+
+- **`restoreRepositoryExportSession(source, options?)`** — the offline twin:
+  replay a saved export's bytes back through the same header, canonical-row,
+  ordering and trailer checks, and get the session back rather than the rows.
+  Pass `{ partial: true }` for a download that was interrupted, then resume
+  from the session it returns.
+
+  ```ts
+  import { createReadStream } from 'node:fs'
+  import { restoreRepositoryExportSession } from '@warmhub/sdk-ts'
+
+  const session = await restoreRepositoryExportSession(
+    createReadStream('catalog.ndjson'),
+    { partial: true },
+  )
+  for await (const row of client.repo.export('acme', 'catalog', { session })) {
+    // continues from session.lastDurableId
+  }
+  ```
+
+- **`applyRepositoryExportDelta(base, delta)`** — fold a delta export onto a
+  base by `durableId`: active rows upsert, tombstones remove. Pure; neither
+  argument is mutated. Both arguments accept either an iterable of rows or a
+  `Map` returned by a previous fold, so folds chain.
+
+  ```ts
+  import { applyRepositoryExportDelta } from '@warmhub/sdk-ts'
+
+  const session = createRepositoryExportSession()
+  const base = []
+  for await (const row of client.repo.export('acme', 'catalog', { session })) {
+    base.push(row)
+  }
+  const fence = session.header?.atRepoSeq ?? 0
+
+  // Later: only what changed since that fence.
+  const delta = []
+  for await (const row of client.repo.export('acme', 'catalog', {
+    sinceRepoSeq: fence,
+  })) {
+    delta.push(row)
+  }
+
+  const current = applyRepositoryExportDelta(base, delta)
+  ```
+
+  `wref` is an opaque rendering and is never keyed on, so the fold survives a
+  rename.
+
+- **`RepositoryExportError`** with a typed `reason`:
+  `'count_mismatch'`, `'digest_mismatch'`, `'fence_mismatch'`,
+  `'header_invalid'`, `'row_invalid'`, `'row_out_of_order'`,
+  `'since_below_epoch_floor'`, `'trailer_invalid'`, `'truncated'`. Every reason
+  except `'since_below_epoch_floor'` is a local verification verdict — the
+  bytes did not prove what the trailer claimed. `'since_below_epoch_floor'` is
+  the server refusing a delta base it no longer retains; recover by re-running
+  the export with `sinceRepoSeq: 0`.
+
+- **`RepositoryExportRowMap` / `RepositoryExportRows`** — the collection types
+  `applyRepositoryExportDelta` accepts and returns.
+
+### Behavior worth knowing
+
+- **A redeemed token's bytes come from storage, not the API, and the client
+  checks what the API said.** A complete redemption answers with a short-lived
+  presigned URL rather than the export bytes, and the SDK fetches that URL
+  *without* your WarmHub bearer: the signature in the URL is the whole
+  capability, and the storage host has no business seeing a credential. The
+  record count and content digest the session derives are then checked against
+  the ones the API named — a download that does not match raises
+  `count_mismatch` or `digest_mismatch` rather than handing you rows nothing
+  independent vouched for. A refused or expired URL re-redeems the token, which
+  is a deterministic lookup, and retries; a break after rows have already been
+  yielded surfaces as an error instead, because a silent restart would hand you
+  those rows twice.
+
+- **Ordering is verified, in `heads` mode only.** A heads export is a set,
+  emitted in ascending `durableId` by unsigned UTF-8 bytes, and that order is
+  part of what the digest proves. A row that does not advance the cursor raises
+  `row_out_of_order`. An `ops` export is a log — it repeats identities by
+  design — and is not order-checked.
+
+- **Resume trailers are segment-scoped.** A resumed request carries no header,
+  and its trailer covers only that segment's rows. The session keeps two
+  hashers: a per-segment one the trailer is checked against, and a whole-stream
+  one that accumulates across segments. `session.contentSha256` is the
+  whole-stream value, and is what you should record as the export's digest.
+
+- **A trailer failure poisons the session.** `truncated` is the resumable
+  failure. `count_mismatch`, `digest_mismatch`, `fence_mismatch` and
+  `trailer_invalid` are not: the whole-stream digest has already absorbed that
+  segment's rows, so the session refuses to resume and you must start a new
+  one.
+
+- **`afterDurableId` requires a session with a header.** A resumed request gets
+  no header back, so with nothing to check the repository and fence against the
+  call is refused before it is sent. Reuse the session the broken stream wrote,
+  or rebuild one with `restoreRepositoryExportSession`.
+
+- **The async redemption poll has a floor of 50 ms**, and defaults to 1000 ms.
+  Each poll re-runs the full authorization gate, so `pollIntervalMs: 0` — or a
+  `NaN` from an unvalidated config value — is clamped rather than honored.
+
+- **Flat server error bodies keep their message.** The export route answers
+  with a flat `{ code, message }` body rather than the client's usual nested
+  `{ error: { ... } }` envelope. Those responses are re-wrapped before the
+  standard mapping runs, so classification stays standard and the server's
+  message is not discarded.
+
+### Still supported
+
+The checkpoint **read** plane is untouched: `client.repo.checkpoint.status`,
+`.latest`, `.getAccess`, and `verifyRepositoryCheckpointArchive` from
+`@warmhub/sdk-ts/checkpoint` all continue to work against archives already in
+object storage. Nothing mints new ones.
+
+**Deprecation horizon:** those read surfaces are supported until the announced
+cleanup, 30 days after GA. Their removal is a separately-filed post-GA change.
+Move download-and-verify workflows to `client.repo.export` before then.

package/changelog.json

@@ -0,0 +1,25 @@
+{
+  "schemaVersion": 1,
+  "sdk": "sdk",
+  "baseline": {
+    "version": "0.127.0",
+    "markdown": "# @warmhub/sdk-ts changelog\n\nRelease 0.127.0.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.126.0:\n\n# @warmhub/sdk-ts changelog\n\nRelease 0.126.0.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.125.0:\n\n# @warmhub/sdk-ts changelog\n\nRelease 0.125.0.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.124.0:\n\n# @warmhub/sdk-ts changelog\n\nRelease 0.124.0.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.123.0:\n\n# @warmhub/sdk-ts changelog\n\nRelease 0.123.0.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.122.3:\n\n# @warmhub/sdk-ts changelog\n\nRelease 0.122.3.\n\nChangelog generation is temporarily disabled while the release integration is repaired.\n\n\nEarlier changelog shipped with @warmhub/sdk-ts 0.120.0:\n\n# Changelog — `@warmhub/sdk-ts`\n\n## How to read this file\n\nEntries are grouped by release. `## Unreleased` collects everything merged but\nnot yet published; the release pipeline is the sole version authority and\nstamps the exact version at publish time, so no heading here ever invents one.\n\nWithin a release, four change sections appear, in this order. A section is\npresent only when it has entries; a release may add plain narrative sections\nafter them (\"Behavior worth knowing\", \"Still supported\") when the change needs\ncontext that is not itself a change entry.\n\n- **Breaking** — your code must change. Every item is written as a migration:\n  what it was → what it is now → the exact edit, with before/after code → why,\n  in one line, citing the ruling.\n- **Added** — new surface. Nothing to do unless you want it.\n- **Fixed** — behavior that was wrong and now is not.\n- **Removed** — surface that is gone with nothing to put in its place. Anything\n  a caller can migrate to is filed under Breaking instead, so this section is\n  often absent.\n\nWarmHub's source repository is private, so rulings are cited by pull-request\nnumber rather than linked. Release notes live at\n<https://docs.warmhub.ai/releases/overview/>.\n\nThe Python SDK, `warmhub`, keeps the same file in the same shape.\n\n---\n\n## Unreleased\n\n## 0.120.0\n\nRepository export v3. The exact version is stamped at publish time by the\nrelease pipeline; source manifests stay at `0.0.0-development`.\n\n### Breaking\n\n#### Checkpoint generation is retired — take an export instead\n\n**What it was.** Producing a fresh snapshot of a repository meant asking the\nserver to mint a checkpoint, polling until the job completed, requesting a\nshort-lived signed URL for the archive, downloading it outside the SDK, and\nverifying the bytes locally.\n\n**What it is now.** One call that streams verified rows, with the header,\nper-row canonical decode, ordering and trailer checks applied as the bytes\narrive. There is no job to start, no state to poll, and no separate verify\nstep — a row that reaches you has already been proven.\n\n**Migration.**\n\nBefore:\n\n```ts\nimport { createReadStream } from 'node:fs'\nimport { writeFile } from 'node:fs/promises'\nimport { Readable } from 'node:stream'\nimport { verifyRepositoryCheckpointArchive } from '@warmhub/sdk-ts/checkpoint'\n\nlet status = await client.repo.checkpoint.generate('acme', 'catalog')\nwhile (status.state !== 'complete') {\n  await new Promise((resolve) => setTimeout(resolve, 1_000))\n  status = await client.repo.checkpoint.status('acme', 'catalog', {\n    checkpointId: status.checkpointId,\n  })\n}\n\nconst access = await client.repo.checkpoint.getAccess('acme', 'catalog', {\n  checkpoint: 'latest',\n  artifact: 'archive',\n})\n// Signed URL: fetched WITHOUT the WarmHub bearer token.\nconst archive = await fetch(access.url)\nawait writeFile('catalog.zip', Readable.fromWeb(archive.body))\nawait verifyRepositoryCheckpointArchive(createReadStream('catalog.zip'))\n```\n\nAfter:\n\n```ts\nfor await (const row of client.repo.export('acme', 'catalog')) {\n  console.log(row.kind, row.durableId, row.version)\n}\n```\n\nIf you were relying on `generate` returning before the download — starting the\nbuild in one process and fetching it in another, or on another machine — that\nshape survives as the async token flow:\n\n```ts\n// Process A: ask for it, get a token, do not read a byte.\nconst prepared = await client.repo.exportPrepare('acme', 'catalog')\nconsole.log(prepared.exportToken, prepared.atRepoSeq)\n\n// Process B: redeem it. `export` polls while the fold is still running.\nfor await (const row of client.repo.export('acme', 'catalog', {\n  token: prepared.exportToken,\n})) {\n  // ...\n}\n```\n\nThe token is redeemable only at that repository's URL, by a principal holding\ncheckpoint read there.\n\n**Why.** Export format v3 replaces checkpoint generation outright; the whole\ngeneration pipeline is deleted server-side (PR #10020).\n\n#### `client.repo.checkpoint.generate` and `.retry` are gone\n\n**What it was.** `generate(orgName, repoName, { atLeastRepoSeq })` minted a\ncheckpoint; `retry(orgName, repoName, checkpointId)` re-ran a failed one. Both\nreturned a `RepositoryCheckpointStatus`.\n\n**What it is now.** Neither method exists, and the tRPC procedures behind them\n(`repo.checkpoint.generate`, `repo.checkpoint.retry`) are no longer served. The\n`repo:checkpoint-generate` scope no longer buys anything.\n\n**Migration.** Replace both with `client.repo.export`.\n\nBefore:\n\n```ts\nconst fresh = await client.repo.checkpoint.generate('acme', 'catalog', {\n  atLeastRepoSeq: 42,\n})\nconst recovered = await client.repo.checkpoint.retry(\n  'acme',\n  'catalog',\n  failed.checkpointId,\n)\n```\n\nAfter:\n\n```ts\n// `atRepoSeq` pins the fence the way `atLeastRepoSeq` asked for a floor.\n// Omit it and the server pins current and echoes it back in the header.\nfor await (const row of client.repo.export('acme', 'catalog', {\n  atRepoSeq: 42,\n})) {\n  // ...\n}\n```\n\nThere is no retry to replace: an export is a read, so a failed one is re-read,\nnot re-queued.\n\n**Why.** Same retirement (PR #10020).\n\n#### Failed checkpoint statuses now all answer `nextAction: 'none'`\n\n**What it was.** `RepositoryCheckpointStatus` carried `nextAction: 'retry'` for\n`deadline_exceeded` and `attempts_exhausted`, and `nextAction: 'generate'` for\n`invalid_source`. Each named a procedure a reader could call.\n\n**What it is now.** Those three failure codes join `repository_deleted` in a\nsingle variant with `nextAction: 'none'`. The `'retry'` and `'generate'`\nmembers are gone from the union, so a `switch` over `nextAction` that had cases\nfor them will no longer typecheck against them.\n\n**Migration.**\n\nBefore:\n\n```ts\nif (status.state === 'failed') {\n  switch (status.nextAction) {\n    case 'retry':\n      await client.repo.checkpoint.retry('acme', 'catalog', status.checkpointId)\n      break\n    case 'generate':\n      await client.repo.checkpoint.generate('acme', 'catalog')\n      break\n    case 'contact_support':\n      report(status.checkpointId, status.failureCode)\n      break\n  }\n}\n```\n\nAfter:\n\n```ts\nif (status.state === 'failed') {\n  if (status.nextAction === 'contact_support') {\n    report(status.checkpointId, status.failureCode)\n  } else {\n    // Terminal. Take an export instead of trying to revive the checkpoint.\n    for await (const row of client.repo.export('acme', 'catalog')) {\n      // ...\n    }\n  }\n}\n```\n\n**Why.** Each retired value pointed at a route the server no longer serves;\nleaving them in the vocabulary would send readers to a 404 (PR #10020).\n\n### Added\n\n- **`client.repo.export(orgName, repoName, options?)`** — an\n  `AsyncGenerator<RepositoryExportRow>` over a verified export stream. Options:\n  `mode` (`'heads'`, the default, or `'ops'`), `sinceRepoSeq` (delta base;\n  `0` means a full export), `atRepoSeq` (pin the fence), `prefer`\n  (`'sync'` | `'async'`), `token`, `session`, `afterDurableId`,\n  `pollIntervalMs`, and `signal`.\n\n- **`client.repo.exportPrepare(orgName, repoName, options?)`** — returns\n  `{ exportToken, atRepoSeq }` without waiting for the fold or reading the\n  body. Takes `mode`, `sinceRepoSeq`, `atRepoSeq`, and `signal`.\n\n- **`RepositoryExportSession` / `createRepositoryExportSession()`** — the\n  rolling verification state of one logical export: the opening `header`, the\n  resume cursor `lastDurableId`, `rowCount`, `complete`, and — once the stream\n  is finalized — `contentSha256`. Pass the same session back into `export` to\n  resume a stream that broke:\n\n  ```ts\n  import {\n    createRepositoryExportSession,\n    RepositoryExportError,\n  } from '@warmhub/sdk-ts'\n\n  const session = createRepositoryExportSession()\n  const rows: unknown[] = []\n  for (let attempt = 0; attempt < 3 && !session.complete; attempt += 1) {\n    try {\n      // The session's own cursor and fence pin the resumed request; do not\n      // recompute them.\n      for await (const row of client.repo.export('acme', 'catalog', {\n        session,\n      })) {\n        rows.push(row)\n      }\n    } catch (error) {\n      if (\n        !(error instanceof RepositoryExportError) ||\n        error.reason !== 'truncated'\n      ) {\n        throw error\n      }\n    }\n  }\n  console.log(session.rowCount, session.contentSha256)\n  ```\n\n- **`readRepositoryExportStream(source, session, expected, options?)`** — read\n  a response body you fetched with your own transport, verified against a\n  session as it goes. `client.repo.export` is the usual entry point.\n\n- **`restoreRepositoryExportSession(source, options?)`** — the offline twin:\n  replay a saved export's bytes back through the same header, canonical-row,\n  ordering and trailer checks, and get the session back rather than the rows.\n  Pass `{ partial: true }` for a download that was interrupted, then resume\n  from the session it returns.\n\n  ```ts\n  import { createReadStream } from 'node:fs'\n  import { restoreRepositoryExportSession } from '@warmhub/sdk-ts'\n\n  const session = await restoreRepositoryExportSession(\n    createReadStream('catalog.ndjson'),\n    { partial: true },\n  )\n  for await (const row of client.repo.export('acme', 'catalog', { session })) {\n    // continues from session.lastDurableId\n  }\n  ```\n\n- **`applyRepositoryExportDelta(base, delta)`** — fold a delta export onto a\n  base by `durableId`: active rows upsert, tombstones remove. Pure; neither\n  argument is mutated. Both arguments accept either an iterable of rows or a\n  `Map` returned by a previous fold, so folds chain.\n\n  ```ts\n  import { applyRepositoryExportDelta } from '@warmhub/sdk-ts'\n\n  const session = createRepositoryExportSession()\n  const base = []\n  for await (const row of client.repo.export('acme', 'catalog', { session })) {\n    base.push(row)\n  }\n  const fence = session.header?.atRepoSeq ?? 0\n\n  // Later: only what changed since that fence.\n  const delta = []\n  for await (const row of client.repo.export('acme', 'catalog', {\n    sinceRepoSeq: fence,\n  })) {\n    delta.push(row)\n  }\n\n  const current = applyRepositoryExportDelta(base, delta)\n  ```\n\n  `wref` is an opaque rendering and is never keyed on, so the fold survives a\n  rename.\n\n- **`RepositoryExportError`** with a typed `reason`:\n  `'count_mismatch'`, `'digest_mismatch'`, `'fence_mismatch'`,\n  `'header_invalid'`, `'row_invalid'`, `'row_out_of_order'`,\n  `'since_below_epoch_floor'`, `'trailer_invalid'`, `'truncated'`. Every reason\n  except `'since_below_epoch_floor'` is a local verification verdict — the\n  bytes did not prove what the trailer claimed. `'since_below_epoch_floor'` is\n  the server refusing a delta base it no longer retains; recover by re-running\n  the export with `sinceRepoSeq: 0`.\n\n- **`RepositoryExportRowMap` / `RepositoryExportRows`** — the collection types\n  `applyRepositoryExportDelta` accepts and returns.\n\n### Behavior worth knowing\n\n- **A redeemed token's bytes come from storage, not the API, and the client\n  checks what the API said.** A complete redemption answers with a short-lived\n  presigned URL rather than the export bytes, and the SDK fetches that URL\n  *without* your WarmHub bearer: the signature in the URL is the whole\n  capability, and the storage host has no business seeing a credential. The\n  record count and content digest the session derives are then checked against\n  the ones the API named — a download that does not match raises\n  `count_mismatch` or `digest_mismatch` rather than handing you rows nothing\n  independent vouched for. A refused or expired URL re-redeems the token, which\n  is a deterministic lookup, and retries; a break after rows have already been\n  yielded surfaces as an error instead, because a silent restart would hand you\n  those rows twice.\n\n- **Ordering is verified, in `heads` mode only.** A heads export is a set,\n  emitted in ascending `durableId` by unsigned UTF-8 bytes, and that order is\n  part of what the digest proves. A row that does not advance the cursor raises\n  `row_out_of_order`. An `ops` export is a log — it repeats identities by\n  design — and is not order-checked.\n\n- **Resume trailers are segment-scoped.** A resumed request carries no header,\n  and its trailer covers only that segment's rows. The session keeps two\n  hashers: a per-segment one the trailer is checked against, and a whole-stream\n  one that accumulates across segments. `session.contentSha256` is the\n  whole-stream value, and is what you should record as the export's digest.\n\n- **A trailer failure poisons the session.** `truncated` is the resumable\n  failure. `count_mismatch`, `digest_mismatch`, `fence_mismatch` and\n  `trailer_invalid` are not: the whole-stream digest has already absorbed that\n  segment's rows, so the session refuses to resume and you must start a new\n  one.\n\n- **`afterDurableId` requires a session with a header.** A resumed request gets\n  no header back, so with nothing to check the repository and fence against the\n  call is refused before it is sent. Reuse the session the broken stream wrote,\n  or rebuild one with `restoreRepositoryExportSession`.\n\n- **The async redemption poll has a floor of 50 ms**, and defaults to 1000 ms.\n  Each poll re-runs the full authorization gate, so `pollIntervalMs: 0` — or a\n  `NaN` from an unvalidated config value — is clamped rather than honored.\n\n- **Flat server error bodies keep their message.** The export route answers\n  with a flat `{ code, message }` body rather than the client's usual nested\n  `{ error: { ... } }` envelope. Those responses are re-wrapped before the\n  standard mapping runs, so classification stays standard and the server's\n  message is not discarded.\n\n### Still supported\n\nThe checkpoint **read** plane is untouched: `client.repo.checkpoint.status`,\n`.latest`, `.getAccess`, and `verifyRepositoryCheckpointArchive` from\n`@warmhub/sdk-ts/checkpoint` all continue to work against archives already in\nobject storage. Nothing mints new ones.\n\n**Deprecation horizon:** those read surfaces are supported until the announced\ncleanup, 30 days after GA. Their removal is a separately-filed post-GA change.\nMove download-and-verify workflows to `client.repo.export` before then.\n"
+  },
+  "releases": [
+    {
+      "version": "0.128.0",
+      "sourceSha": "f990f080d6f8b7310700b1d430ee1aa11dcaaf23",
+      "notes": [
+        {
+          "id": "published-changelog-artifacts",
+          "body": "### Documentation\n\nVersioned release notes are available as [HTML, Markdown, and JSON](https://docs.warmhub.ai/sdk/typescript/changelog/)."
+        }
+      ]
+    },
+    {
+      "version": "0.129.0",
+      "sourceSha": "e3b82b4b08936c141a727fc4f072a5d9ee1eeb31",
+      "notes": []
+    }
+  ]
+}

package/dist/checkpoint.js

@@ -1,2 +1,2 @@
-import {K as K$1,J as J$1,L as L$1,P as P$1,H as H$1,M,N as N$1,O,I}from'./chunk-4OSQJILK.js';import {mkdtemp,chmod,rm,open}from'fs/promises';import {tmpdir}from'os';import {join}from'path';import {createHash}from'crypto';import {Writable}from'stream';import {pipeline}from'stream/promises';import {callbackify}from'util';import {createInflateRaw,crc32}from'zlib';import {once}from'events';import {createWriteStream,createReadStream}from'fs';var d=class extends Error{constructor(e){super(rt(e));this.reason=e;}reason;name="RepositoryCheckpointVerificationError"};function rt(r){switch(r){case "source_failed":return "Repository checkpoint source could not be read";case "archive_invalid":return "Repository checkpoint archive is invalid";case "archive_integrity_mismatch":return "Repository checkpoint archive integrity does not match";case "manifest_invalid":return "Repository checkpoint manifest is invalid";case "chunk_invalid":return "Repository checkpoint chunk is invalid";case "duplicate_durable_id":return "Repository checkpoint contains a duplicate durable identity";case "scratch_cleanup_failed":return "Repository checkpoint verifier scratch cleanup failed"}}var H=67324752,ht=33639248,dt=134695760,ut=101075792,ft=117853008,lt=101010256,Y=2056,Z=8,R=45,q=813,z=65535,m=4294967295,W=33,yt=33188,S=64*1024,pt=new RegExp(`^records/[0-9a-f]{64}/part-\\d{${I}}\\.jsonl$`),mt=new TextDecoder("utf-8",{fatal:true}),E=class extends Error{};async function G(r,t){let e=new C(r);try{let i=[],n=new Set,s=!1;for(;await e.peekU32()===H;){if(s)throw new Error("manifest must be the final entry");let c=BigInt(e.position),h=await e.readExact(30);It(h);let f=h.readUInt16LE(26),p=h.readUInt16LE(28);if(f===0||p!==20)throw new Error("local entry metadata is invalid");let a=K(await e.readExact(f));if(St(a),n.has(a))throw new Error("archive entry is duplicated");n.add(a),s=a===J$1,bt(await e.readExact(p));let y=t(a),l=await wt(e,y),et=await e.readExact(24);kt(et,l),await y.finish(),i.push({name:a,localOffset:c,...l});}if(!s||i.length===0)throw new Error("archive manifest entry is missing");return await vt(e,i),{...await e.finish(),entryNames:i.map(c=>c.name)}}finally{await e.close();}}async function wt(r,t){let e=createInflateRaw({chunkSize:S}),i=0n,n=0n,s=0,o=callbackify(async a=>{try{await t.write(a);}catch(y){throw y instanceof Error?y:new Error("checkpoint sink failed")}s=crc32(a,s),n+=BigInt(a.byteLength);}),c=new Writable({highWaterMark:S,write(a,y,l){o(a,l);}}),h=pipeline(e,c),f=new A,p=Et(h,f);try{for(;!e.readableEnded;){let a=await r.readSome(S);if(!a)throw new Error("archive entry is truncated");let y=e.bytesWritten;await gt(e,a,f);let l=e.bytesWritten-y;if(!Number.isSafeInteger(l)||l<0||l>a.byteLength)throw new Error("archive inflater consumed invalid input");if(i+=BigInt(l),l<a.byteLength&&r.unread(a.subarray(l)),e.readableEnded)break;if(l===0)throw new Error("archive inflater made no progress")}return await h,{crc:s>>>0,compressedSize:i,uncompressedSize:n}}finally{e.destroyed||e.destroy(),await p;}}var A=class{#i;#t;fail(t){let e=t instanceof Error?t:new Error("archive inflater failed");this.#i=e,this.#t?.(e),this.#t=void 0;}async race(t){if(this.#i)throw this.#i;let e,i=new Promise((n,s)=>{e=o=>s(o),this.#t=e;});try{return await Promise.race([t,i])}finally{e&&this.#t===e&&(this.#t=void 0);}}};async function Et(r,t){try{await r;}catch(e){t.fail(e);}}async function gt(r,t,e){let i=new Promise((n,s)=>{r.write(t,o=>{o?s(o):n();});});await e.race(i);}async function vt(r,t){let e=BigInt(r.position);for(let h of t){let f=await r.readExact(46);Ut(f,h);let p=f.readUInt16LE(28),a=f.readUInt16LE(30);if(a!==28||f.readUInt16LE(32)!==0)throw new Error("central entry metadata is invalid");if(K(await r.readExact(p))!==h.name)throw new Error("central entry order differs");Lt(await r.readExact(a),h);}let i=BigInt(r.position)-e,n=BigInt(r.position),s=await r.readExact(56);if(w(s,0,ut),s.readBigUInt64LE(4)!==44n||s.readUInt16LE(12)!==q||s.readUInt16LE(14)!==R||s.readUInt32LE(16)!==0||s.readUInt32LE(20)!==0||s.readBigUInt64LE(24)!==BigInt(t.length)||s.readBigUInt64LE(32)!==BigInt(t.length)||s.readBigUInt64LE(40)!==i||s.readBigUInt64LE(48)!==e)throw new Error("ZIP64 end record is invalid");let o=await r.readExact(20);if(w(o,0,ft),o.readUInt32LE(4)!==0||o.readBigUInt64LE(8)!==n||o.readUInt32LE(16)!==1)throw new Error("ZIP64 locator is invalid");let c=await r.readExact(22);if(w(c,0,lt),c.readUInt16LE(4)!==0||c.readUInt16LE(6)!==0||c.readUInt16LE(8)!==z||c.readUInt16LE(10)!==z||c.readUInt32LE(12)!==m||c.readUInt32LE(16)!==m||c.readUInt16LE(20)!==0)throw new Error("classic ZIP end record is invalid")}function It(r){if(w(r,0,H),r.readUInt16LE(4)!==R||r.readUInt16LE(6)!==Y||r.readUInt16LE(8)!==Z||r.readUInt16LE(10)!==0||r.readUInt16LE(12)!==W||r.readUInt32LE(14)!==0||r.readUInt32LE(18)!==m||r.readUInt32LE(22)!==m)throw new Error("local entry header is invalid")}function bt(r){if(r.readUInt16LE(0)!==1||r.readUInt16LE(2)!==16||r.readBigUInt64LE(4)!==0n||r.readBigUInt64LE(12)!==0n)throw new Error("local ZIP64 extra is invalid")}function kt(r,t){if(w(r,0,dt),r.readUInt32LE(4)!==t.crc||r.readBigUInt64LE(8)!==t.compressedSize||r.readBigUInt64LE(16)!==t.uncompressedSize)throw new Error("archive data descriptor is invalid")}function Ut(r,t){if(w(r,0,ht),r.readUInt16LE(4)!==q||r.readUInt16LE(6)!==R||r.readUInt16LE(8)!==Y||r.readUInt16LE(10)!==Z||r.readUInt16LE(12)!==0||r.readUInt16LE(14)!==W||r.readUInt32LE(16)!==t.crc||r.readUInt32LE(20)!==m||r.readUInt32LE(24)!==m||r.readUInt16LE(34)!==0||r.readUInt16LE(36)!==0||(r.readUInt32LE(38)>>>16&65535)!==yt||r.readUInt32LE(42)!==m)throw new Error("central entry header is invalid")}function Lt(r,t){if(r.readUInt16LE(0)!==1||r.readUInt16LE(2)!==24||r.readBigUInt64LE(4)!==t.uncompressedSize||r.readBigUInt64LE(12)!==t.compressedSize||r.readBigUInt64LE(20)!==t.localOffset)throw new Error("central ZIP64 extra is invalid")}function St(r){if(r!==J$1&&!pt.test(r))throw new Error("archive entry name is invalid")}function K(r){let t=mt.decode(r);if(Buffer.byteLength(t,"utf8")!==r.byteLength)throw new Error("archive entry name is not canonical UTF-8");return t}function w(r,t,e){if(r.readUInt32LE(t)!==e)throw new Error("archive signature is invalid")}var C=class{#i;#t=createHash("sha256");#e=[];#r=0;#n=false;#o=0;position=0;constructor(t){this.#i=At(t)[Symbol.asyncIterator]();}async peekU32(){let t=await this.readExact(4);return this.unread(t),t.readUInt32LE(0)}async readExact(t){let e=Buffer.allocUnsafe(t),i=0;for(;i<t;){let n=await this.readSome(t-i);if(!n)throw new Error("archive is truncated");e.set(n,i),i+=n.byteLength;}return e}async readSome(t){for(;this.#e.length===0;)if(!await this.#s())return;let e=this.#e[0];if(!e)return;let i=e.byteLength-this.#r,n=Math.min(t,i),s=e.subarray(this.#r,this.#r+n);return this.#r+=n,this.position+=n,this.#r===e.byteLength&&(this.#e.shift(),this.#r=0),s}unread(t){if(t.byteLength!==0){if(this.#r>0){let e=this.#e[0];if(!e)throw new Error("archive reader queue is inconsistent");let i=e.subarray(this.#r);this.#e[0]=i,this.#r=0;}this.#e.unshift(t),this.position-=t.byteLength;}}async finish(){if(this.#e.length>0||await this.#s())throw new Error("archive contains trailing bytes");return {byteLength:this.#o,sha256:this.#t.digest("hex")}}async close(){try{await this.#i.return?.();}catch{}}async#s(){if(this.#n)return  false;for(;;){let t;try{t=await this.#i.next();}catch{throw new E}if(t.done)return this.#n=true,false;if(!(t.value instanceof Uint8Array))throw new E;if(t.value.byteLength!==0){if(this.#t.update(t.value),this.#o+=t.value.byteLength,!Number.isSafeInteger(this.#o))throw new Error("archive byte length is unsafe");return this.#e.push(t.value),true}}}};function At(r){return Symbol.asyncIterator in r?r:{async*[Symbol.asyncIterator](){let t=r.getReader(),e=false;try{for(;;){let{value:i,done:n}=await t.read();if(n){e=!0;return}yield i;}}finally{if(!e)try{await t.cancel();}catch{}t.releaseLock();}}}}var xt=4*1024*1024,j=8,J=64*1024,Tt=16*1024,u=4,$=4,Ot=1,Vt=u+Ot,X=Vt+$,g=class extends Error{},k=class{#i;#t;#e=[];#r=0;#n;constructor(t,e={}){this.#i=t;let i=e.sortBudgetBytes??xt;if(this.#n=e.mergeFanIn??j,!Number.isSafeInteger(i)||i<X||!Number.isSafeInteger(this.#n)||this.#n<2||this.#n>j)throw new Error("checkpoint identity sort limits are invalid");this.#t=new _(i);}add(t){let e=Buffer.byteLength(t,"utf8");if(!this.#t.canFit(e))throw new Error("checkpoint durable identity exceeds the sort budget");if(this.#t.canAdd(e)){this.#t.add(t,e);return}return this.#o(t,e)}async finish(){if(this.#e.length===0){this.#t.sortAndAssertUnique(),this.#t.clear();return}for(this.#t.isEmpty||await this.#o();this.#e.length>this.#n;){let e=[];for(let i=0;i<this.#e.length;i+=this.#n){let n=this.#e.slice(i,i+this.#n),s=this.#s();await Ft(n,s),await Promise.all(n.map(o=>rm(o,{force:true}))),e.push(s);}this.#e=e;}let t;await tt(this.#e,e=>{if(t&&P(t,e)===0)throw new g;t=e;});}async#o(t,e){let i=this.#s();this.#t.sortAndAssertUnique(),await Mt(i,this.#t),this.#e.push(i),this.#t.clear(),t!==void 0&&e!==void 0&&this.#t.add(t,e);}#s(){let t=join(this.#i,`identity-run-${String(this.#r).padStart(8,"0")}.bin`);return this.#r+=1,t}},_=class{byteBudget;#i;#t;#e=0;#r=0;constructor(t){this.byteBudget=t;let e=Math.floor(t/X);this.#t=new Uint32Array(e),this.#i=Buffer.allocUnsafe(t-e*$);}get isEmpty(){return this.#r===0}canAdd(t){return this.canFit(t)&&this.#r<this.#t.length&&this.#e+u+t<=this.#i.length}canFit(t){return t<=4294967295&&this.#t.length>0&&u+t<=this.#i.length}add(t,e){if(!this.canAdd(e))throw new Error("checkpoint durable identity exceeds the sort budget");let i=this.#e;this.#t[this.#r]=i,this.#i.writeUInt32BE(e,i),this.#i.write(t,i+u,e,"utf8"),this.#e+=u+e,this.#r+=1;}sortAndAssertUnique(){let t=this.#t.subarray(0,this.#r);t.sort((e,i)=>this.#n(e,i));for(let e=1;e<t.length;e+=1){let i=t[e-1],n=t[e];if(i===void 0||n===void 0)throw new Error("checkpoint identity offset is missing");if(this.#n(i,n)===0)throw new g}}clear(){this.#e=0,this.#r=0;}forEachSorted(t){return Dt(this.#t.subarray(0,this.#r),e=>t(this.#s(e)))}#n(t,e){return P(this.#o(t),this.#o(e))}#o(t){let e=this.#i.readUInt32BE(t);return this.#i.subarray(t+u,t+u+e)}#s(t){let e=this.#i.readUInt32BE(t);return this.#i.subarray(t,t+u+e)}};async function Mt(r,t){await Q(r,async e=>{let i=new U(e);await t.forEachSorted(n=>i.write(n)),await i.finish();});}async function Ft(r,t){await Q(t,async e=>{let i=new U(e);await tt(r,n=>i.writeValue(n)),await i.finish();});}async function Q(r,t){await(await open(r,"wx",384)).close();let i=createWriteStream(r,{flags:"a",mode:384,highWaterMark:J});try{await t(i),i.end(),await once(i,"close");}catch(n){throw i.destroy(),n}}var U=class{#i;#t=Buffer.allocUnsafe(J);#e=0;constructor(t){this.#i=t;}write(t){if(t.byteLength>this.#t.length)return this.#r(t);if(this.#e+t.byteLength>this.#t.length)return this.#n(t);this.#t.set(t,this.#e),this.#e+=t.byteLength;}writeValue(t){let e=u+t.byteLength;if(e>this.#t.length)return this.#o(t);if(this.#e+e>this.#t.length)return this.#s(t);this.#c(t);}async finish(){await this.#a();}async#r(t){await this.#a(),await b(this.#i,t);}async#n(t){await this.#a(),this.#t.set(t,this.#e),this.#e+=t.byteLength;}async#o(t){await this.#a();let e=Buffer.allocUnsafe(u);e.writeUInt32BE(t.byteLength,0),await b(this.#i,e),await b(this.#i,t);}async#s(t){await this.#a(),this.#c(t);}async#a(){if(this.#e===0)return;let t=this.#t.subarray(0,this.#e);await b(this.#i,t),this.#e=0;}#c(t){this.#t.writeUInt32BE(t.byteLength,this.#e),this.#t.set(t,this.#e+u),this.#e+=u+t.byteLength;}};async function tt(r,t){let e=r.map(i=>new B(i));try{for(await Promise.all(e.map(i=>i.advance()));;){let i;for(let s of e)s.current&&(!i||P(s.current,i.current)<0)&&(i=s);if(!i?.current)return;let n=t(i.current);n&&await n,await i.advance();}}finally{for(let i of e)i.close();}}var B=class{#i;#t;#e=Buffer.alloc(0);#r=0;current;constructor(t){this.#i=createReadStream(t,{highWaterMark:Tt}),this.#t=this.#i[Symbol.asyncIterator]();}async advance(){let t=await this.#n(u);if(!t){this.current=void 0;return}let e=t.readUInt32BE(0);if(e===0)throw new Error("checkpoint identity run is invalid");let i=await this.#n(e);if(!i)throw new Error("checkpoint identity run is truncated");this.current=i;}close(){this.#i.destroy();}async#n(t){if(t===0)return Buffer.alloc(0);if(this.#e.length-this.#r>=t){let n=this.#e.subarray(this.#r,this.#r+t);return this.#r+=t,n}let e=Buffer.allocUnsafe(t),i=0;for(;i<t;){if(this.#r<this.#e.length){let s=Math.min(t-i,this.#e.length-this.#r);this.#e.copy(e,i,this.#r,this.#r+s),this.#r+=s,i+=s;continue}let n=await this.#t.next();if(n.done){if(i===0)return;throw new Error("checkpoint identity run is truncated")}this.#e=n.value,this.#r=0;}return e}};async function Dt(r,t){for(let e of r){let i=t(e);i&&await i;}}async function b(r,t){await new Promise((e,i)=>{r.write(t,n=>{n?i(n):e();});});}function P(r,t){let e=Math.min(r.length,t.length);for(let i=0;i<e;i+=1){let n=r[i],s=t[i];if(n===void 0||s===void 0)throw new Error("checkpoint identity byte is missing");let o=n-s;if(o!==0)return o}return r.length-t.length}var L=class{#i;#t=new Map;#e=new Map;#r=[];#n;constructor(t,e={}){this.#i=new k(t,{sortBudgetBytes:e.identitySortBudgetBytes,mergeFanIn:e.identityMergeFanIn});}openEntry(t){if(t===J$1){let e=[];return {write:async i=>{e.push(i.slice());},finish:async()=>{this.#n=Buffer.concat(e);}}}return new N(t,this.#t,this.#e,this.#i,e=>this.#r.push(e))}async finish(){if(!this.#n)throw new Error("checkpoint manifest is missing");let t=await L$1(this.#n),e=t.streams.flatMap(i=>i.chunks.map(n=>({...n,shapeName:i.shapeName})));if(e.length!==this.#r.length)throw new Error("checkpoint chunk inventory does not match");for(let[i,n]of e.entries()){let s=this.#r[i];if(s.path!==n.path||s.shapeName!==n.shapeName||s.recordCount!==n.recordCount||s.byteLength!==n.byteLength||s.sha256!==n.sha256)throw new Error("checkpoint chunk integrity does not match")}for(let i of t.streams){let n=this.#t.get(i.shapeName);if(!n||P$1(n)!==i.recordCount)throw new Error("checkpoint stream does not match its manifest")}if(this.#t.size!==t.streams.length)throw new Error("checkpoint contains an undeclared stream");return await this.#i.finish(),{manifest:t,chunkCount:e.length}}},N=class{#i;#t;#e;#r;#n;#o=createHash("sha256");#s=[];#a=0;#c;#h=0;#d=0;constructor(t,e,i,n,s){this.#i=t,this.#t=e,this.#e=i,this.#r=n,this.#n=s;}async write(t){if(this.#o.update(t),this.#d+=t.byteLength,!Number.isSafeInteger(this.#d))throw new Error("checkpoint chunk byte length is unsafe");let e=0;for(;e<t.byteLength;){let i=t.indexOf(10,e);if(i<0)break;let n=this.#u(this.#l(t.subarray(e,i+1)));n&&await n,e=i+1;}e<t.byteLength&&this.#f(t.subarray(e));}async finish(){if(this.#s.length!==0||this.#h===0||!this.#c)throw new Error("checkpoint chunk framing is invalid");if(this.#d>H$1&&this.#h!==1)throw new Error("oversized checkpoint chunk has multiple rows");this.#n({path:this.#i,shapeName:this.#c,recordCount:this.#h,byteLength:this.#d,sha256:this.#o.digest("hex")});let t=this.#e.get(this.#c);if(!t)throw new Error("checkpoint stream chunk state is missing");t.previous={byteLength:this.#d};}#u(t){let e=M(t),i=e.kind==="shape"?e.wref:e.shapeName;if(this.#c!==void 0&&this.#c!==i)throw new Error("checkpoint chunk mixes Shape streams");this.#c=i,this.#h===0&&this.#y(i,t.byteLength);let n=this.#t.get(i)??N$1(i);this.#t.set(i,n),O(n,e);let s=this.#r.add(e.durableId);if(this.#h+=1,!Number.isSafeInteger(this.#h))throw new Error("checkpoint chunk row count is unsafe");return s}#f(t){if(t.byteLength!==0&&(this.#s.push(t.slice()),this.#a+=t.byteLength,!Number.isSafeInteger(this.#a)))throw new Error("checkpoint row byte length is unsafe")}#l(t){if(this.#s.length===0)return t;let e=Buffer.concat([...this.#s,t],this.#a+t.byteLength);return this.#s=[],this.#a=0,e}#y(t,e){let i=Number(this.#i.match(/part-(\d{10})\.jsonl$/)?.[1]??-1),n=this.#e.get(t)??{nextPart:0};if(i!==n.nextPart)throw new Error("checkpoint stream chunk parts are not contiguous");if(n.previous&&n.previous.byteLength<=H$1&&n.previous.byteLength+e<=H$1)throw new Error("checkpoint stream chunk closed before the byte limit");n.nextPart+=1,this.#e.set(t,n);}};async function Gt(r,t){return Kt(r,t)}async function Kt(r,t,e={}){let i=await mkdtemp(join(e.scratchParent??tmpdir(),"warmhub-checkpoint-verify-"));await chmod(i,448);let n,s;try{let o=new L(i,e),c=await G(r,p=>o.openEntry(p)),{manifest:h,chunkCount:f}=await o.finish();jt(t,c,h),n={valid:!0,checkpointId:h.checkpointId,repoSeq:h.repoSeq,recordCount:h.recordCount,chunkCount:f,totalBytes:c.byteLength,rootDigest:h.contentSha256,archiveDigest:c.sha256};}catch(o){s=Jt(o);}try{await rm(i,{recursive:!0,force:!0});}catch{s??=new d("scratch_cleanup_failed");}if(s)throw s;if(!n)throw new d("archive_invalid");return n}function jt(r,t,e){if(r&&(K$1.parse(r.sha256),r.checkpointId!==e.checkpointId||r.repoSeq!==e.repoSeq||r.byteLength!==t.byteLength||r.sha256!==t.sha256))throw new d("archive_integrity_mismatch")}function Jt(r){if(r instanceof d)return r;if(r instanceof E)return new d("source_failed");if(r instanceof g)return new d("duplicate_durable_id");let t=r instanceof Error?r.message:"";return t.includes("manifest")?new d("manifest_invalid"):t.includes("chunk")||t.includes("row")||t.includes("Shape stream")?new d("chunk_invalid"):new d("archive_invalid")}export{d as RepositoryCheckpointVerificationError,Gt as verifyRepositoryCheckpointArchive};//# sourceMappingURL=checkpoint.js.map
+import {M,L as L$1,N as N$1,R as R$1,J as J$1,O,P as P$1,Q as Q$1,K as K$1}from'./chunk-UCK4ZIVG.js';import {mkdtemp,chmod,rm,open}from'fs/promises';import {tmpdir}from'os';import {join}from'path';import {createHash}from'crypto';import {Writable}from'stream';import {pipeline}from'stream/promises';import {callbackify}from'util';import {createInflateRaw,crc32}from'zlib';import {once}from'events';import {createWriteStream,createReadStream}from'fs';var d=class extends Error{constructor(e){super(rt(e));this.reason=e;}reason;name="RepositoryCheckpointVerificationError"};function rt(r){switch(r){case "source_failed":return "Repository checkpoint source could not be read";case "archive_invalid":return "Repository checkpoint archive is invalid";case "archive_integrity_mismatch":return "Repository checkpoint archive integrity does not match";case "manifest_invalid":return "Repository checkpoint manifest is invalid";case "chunk_invalid":return "Repository checkpoint chunk is invalid";case "duplicate_durable_id":return "Repository checkpoint contains a duplicate durable identity";case "scratch_cleanup_failed":return "Repository checkpoint verifier scratch cleanup failed"}}var H=67324752,ht=33639248,dt=134695760,ut=101075792,ft=117853008,lt=101010256,Y=2056,Z=8,R=45,q=813,z=65535,m=4294967295,W=33,yt=33188,S=64*1024,pt=new RegExp(`^records/[0-9a-f]{64}/part-\\d{${K$1}}\\.jsonl$`),mt=new TextDecoder("utf-8",{fatal:true}),E=class extends Error{};async function G(r,t){let e=new C(r);try{let i=[],n=new Set,s=!1;for(;await e.peekU32()===H;){if(s)throw new Error("manifest must be the final entry");let c=BigInt(e.position),h=await e.readExact(30);It(h);let f=h.readUInt16LE(26),p=h.readUInt16LE(28);if(f===0||p!==20)throw new Error("local entry metadata is invalid");let a=K(await e.readExact(f));if(St(a),n.has(a))throw new Error("archive entry is duplicated");n.add(a),s=a===L$1,bt(await e.readExact(p));let y=t(a),l=await wt(e,y),et=await e.readExact(24);kt(et,l),await y.finish(),i.push({name:a,localOffset:c,...l});}if(!s||i.length===0)throw new Error("archive manifest entry is missing");return await vt(e,i),{...await e.finish(),entryNames:i.map(c=>c.name)}}finally{await e.close();}}async function wt(r,t){let e=createInflateRaw({chunkSize:S}),i=0n,n=0n,s=0,o=callbackify(async a=>{try{await t.write(a);}catch(y){throw y instanceof Error?y:new Error("checkpoint sink failed")}s=crc32(a,s),n+=BigInt(a.byteLength);}),c=new Writable({highWaterMark:S,write(a,y,l){o(a,l);}}),h=pipeline(e,c),f=new A,p=Et(h,f);try{for(;!e.readableEnded;){let a=await r.readSome(S);if(!a)throw new Error("archive entry is truncated");let y=e.bytesWritten;await gt(e,a,f);let l=e.bytesWritten-y;if(!Number.isSafeInteger(l)||l<0||l>a.byteLength)throw new Error("archive inflater consumed invalid input");if(i+=BigInt(l),l<a.byteLength&&r.unread(a.subarray(l)),e.readableEnded)break;if(l===0)throw new Error("archive inflater made no progress")}return await h,{crc:s>>>0,compressedSize:i,uncompressedSize:n}}finally{e.destroyed||e.destroy(),await p;}}var A=class{#i;#t;fail(t){let e=t instanceof Error?t:new Error("archive inflater failed");this.#i=e,this.#t?.(e),this.#t=void 0;}async race(t){if(this.#i)throw this.#i;let e,i=new Promise((n,s)=>{e=o=>s(o),this.#t=e;});try{return await Promise.race([t,i])}finally{e&&this.#t===e&&(this.#t=void 0);}}};async function Et(r,t){try{await r;}catch(e){t.fail(e);}}async function gt(r,t,e){let i=new Promise((n,s)=>{r.write(t,o=>{o?s(o):n();});});await e.race(i);}async function vt(r,t){let e=BigInt(r.position);for(let h of t){let f=await r.readExact(46);Ut(f,h);let p=f.readUInt16LE(28),a=f.readUInt16LE(30);if(a!==28||f.readUInt16LE(32)!==0)throw new Error("central entry metadata is invalid");if(K(await r.readExact(p))!==h.name)throw new Error("central entry order differs");Lt(await r.readExact(a),h);}let i=BigInt(r.position)-e,n=BigInt(r.position),s=await r.readExact(56);if(w(s,0,ut),s.readBigUInt64LE(4)!==44n||s.readUInt16LE(12)!==q||s.readUInt16LE(14)!==R||s.readUInt32LE(16)!==0||s.readUInt32LE(20)!==0||s.readBigUInt64LE(24)!==BigInt(t.length)||s.readBigUInt64LE(32)!==BigInt(t.length)||s.readBigUInt64LE(40)!==i||s.readBigUInt64LE(48)!==e)throw new Error("ZIP64 end record is invalid");let o=await r.readExact(20);if(w(o,0,ft),o.readUInt32LE(4)!==0||o.readBigUInt64LE(8)!==n||o.readUInt32LE(16)!==1)throw new Error("ZIP64 locator is invalid");let c=await r.readExact(22);if(w(c,0,lt),c.readUInt16LE(4)!==0||c.readUInt16LE(6)!==0||c.readUInt16LE(8)!==z||c.readUInt16LE(10)!==z||c.readUInt32LE(12)!==m||c.readUInt32LE(16)!==m||c.readUInt16LE(20)!==0)throw new Error("classic ZIP end record is invalid")}function It(r){if(w(r,0,H),r.readUInt16LE(4)!==R||r.readUInt16LE(6)!==Y||r.readUInt16LE(8)!==Z||r.readUInt16LE(10)!==0||r.readUInt16LE(12)!==W||r.readUInt32LE(14)!==0||r.readUInt32LE(18)!==m||r.readUInt32LE(22)!==m)throw new Error("local entry header is invalid")}function bt(r){if(r.readUInt16LE(0)!==1||r.readUInt16LE(2)!==16||r.readBigUInt64LE(4)!==0n||r.readBigUInt64LE(12)!==0n)throw new Error("local ZIP64 extra is invalid")}function kt(r,t){if(w(r,0,dt),r.readUInt32LE(4)!==t.crc||r.readBigUInt64LE(8)!==t.compressedSize||r.readBigUInt64LE(16)!==t.uncompressedSize)throw new Error("archive data descriptor is invalid")}function Ut(r,t){if(w(r,0,ht),r.readUInt16LE(4)!==q||r.readUInt16LE(6)!==R||r.readUInt16LE(8)!==Y||r.readUInt16LE(10)!==Z||r.readUInt16LE(12)!==0||r.readUInt16LE(14)!==W||r.readUInt32LE(16)!==t.crc||r.readUInt32LE(20)!==m||r.readUInt32LE(24)!==m||r.readUInt16LE(34)!==0||r.readUInt16LE(36)!==0||(r.readUInt32LE(38)>>>16&65535)!==yt||r.readUInt32LE(42)!==m)throw new Error("central entry header is invalid")}function Lt(r,t){if(r.readUInt16LE(0)!==1||r.readUInt16LE(2)!==24||r.readBigUInt64LE(4)!==t.uncompressedSize||r.readBigUInt64LE(12)!==t.compressedSize||r.readBigUInt64LE(20)!==t.localOffset)throw new Error("central ZIP64 extra is invalid")}function St(r){if(r!==L$1&&!pt.test(r))throw new Error("archive entry name is invalid")}function K(r){let t=mt.decode(r);if(Buffer.byteLength(t,"utf8")!==r.byteLength)throw new Error("archive entry name is not canonical UTF-8");return t}function w(r,t,e){if(r.readUInt32LE(t)!==e)throw new Error("archive signature is invalid")}var C=class{#i;#t=createHash("sha256");#e=[];#r=0;#n=false;#o=0;position=0;constructor(t){this.#i=At(t)[Symbol.asyncIterator]();}async peekU32(){let t=await this.readExact(4);return this.unread(t),t.readUInt32LE(0)}async readExact(t){let e=Buffer.allocUnsafe(t),i=0;for(;i<t;){let n=await this.readSome(t-i);if(!n)throw new Error("archive is truncated");e.set(n,i),i+=n.byteLength;}return e}async readSome(t){for(;this.#e.length===0;)if(!await this.#s())return;let e=this.#e[0];if(!e)return;let i=e.byteLength-this.#r,n=Math.min(t,i),s=e.subarray(this.#r,this.#r+n);return this.#r+=n,this.position+=n,this.#r===e.byteLength&&(this.#e.shift(),this.#r=0),s}unread(t){if(t.byteLength!==0){if(this.#r>0){let e=this.#e[0];if(!e)throw new Error("archive reader queue is inconsistent");let i=e.subarray(this.#r);this.#e[0]=i,this.#r=0;}this.#e.unshift(t),this.position-=t.byteLength;}}async finish(){if(this.#e.length>0||await this.#s())throw new Error("archive contains trailing bytes");return {byteLength:this.#o,sha256:this.#t.digest("hex")}}async close(){try{await this.#i.return?.();}catch{}}async#s(){if(this.#n)return  false;for(;;){let t;try{t=await this.#i.next();}catch{throw new E}if(t.done)return this.#n=true,false;if(!(t.value instanceof Uint8Array))throw new E;if(t.value.byteLength!==0){if(this.#t.update(t.value),this.#o+=t.value.byteLength,!Number.isSafeInteger(this.#o))throw new Error("archive byte length is unsafe");return this.#e.push(t.value),true}}}};function At(r){return Symbol.asyncIterator in r?r:{async*[Symbol.asyncIterator](){let t=r.getReader(),e=false;try{for(;;){let{value:i,done:n}=await t.read();if(n){e=!0;return}yield i;}}finally{if(!e)try{await t.cancel();}catch{}t.releaseLock();}}}}var xt=4*1024*1024,j=8,J=64*1024,Tt=16*1024,u=4,$=4,Ot=1,Vt=u+Ot,X=Vt+$,g=class extends Error{},k=class{#i;#t;#e=[];#r=0;#n;constructor(t,e={}){this.#i=t;let i=e.sortBudgetBytes??xt;if(this.#n=e.mergeFanIn??j,!Number.isSafeInteger(i)||i<X||!Number.isSafeInteger(this.#n)||this.#n<2||this.#n>j)throw new Error("checkpoint identity sort limits are invalid");this.#t=new _(i);}add(t){let e=Buffer.byteLength(t,"utf8");if(!this.#t.canFit(e))throw new Error("checkpoint durable identity exceeds the sort budget");if(this.#t.canAdd(e)){this.#t.add(t,e);return}return this.#o(t,e)}async finish(){if(this.#e.length===0){this.#t.sortAndAssertUnique(),this.#t.clear();return}for(this.#t.isEmpty||await this.#o();this.#e.length>this.#n;){let e=[];for(let i=0;i<this.#e.length;i+=this.#n){let n=this.#e.slice(i,i+this.#n),s=this.#s();await Ft(n,s),await Promise.all(n.map(o=>rm(o,{force:true}))),e.push(s);}this.#e=e;}let t;await tt(this.#e,e=>{if(t&&P(t,e)===0)throw new g;t=e;});}async#o(t,e){let i=this.#s();this.#t.sortAndAssertUnique(),await Mt(i,this.#t),this.#e.push(i),this.#t.clear(),t!==void 0&&e!==void 0&&this.#t.add(t,e);}#s(){let t=join(this.#i,`identity-run-${String(this.#r).padStart(8,"0")}.bin`);return this.#r+=1,t}},_=class{byteBudget;#i;#t;#e=0;#r=0;constructor(t){this.byteBudget=t;let e=Math.floor(t/X);this.#t=new Uint32Array(e),this.#i=Buffer.allocUnsafe(t-e*$);}get isEmpty(){return this.#r===0}canAdd(t){return this.canFit(t)&&this.#r<this.#t.length&&this.#e+u+t<=this.#i.length}canFit(t){return t<=4294967295&&this.#t.length>0&&u+t<=this.#i.length}add(t,e){if(!this.canAdd(e))throw new Error("checkpoint durable identity exceeds the sort budget");let i=this.#e;this.#t[this.#r]=i,this.#i.writeUInt32BE(e,i),this.#i.write(t,i+u,e,"utf8"),this.#e+=u+e,this.#r+=1;}sortAndAssertUnique(){let t=this.#t.subarray(0,this.#r);t.sort((e,i)=>this.#n(e,i));for(let e=1;e<t.length;e+=1){let i=t[e-1],n=t[e];if(i===void 0||n===void 0)throw new Error("checkpoint identity offset is missing");if(this.#n(i,n)===0)throw new g}}clear(){this.#e=0,this.#r=0;}forEachSorted(t){return Dt(this.#t.subarray(0,this.#r),e=>t(this.#s(e)))}#n(t,e){return P(this.#o(t),this.#o(e))}#o(t){let e=this.#i.readUInt32BE(t);return this.#i.subarray(t+u,t+u+e)}#s(t){let e=this.#i.readUInt32BE(t);return this.#i.subarray(t,t+u+e)}};async function Mt(r,t){await Q(r,async e=>{let i=new U(e);await t.forEachSorted(n=>i.write(n)),await i.finish();});}async function Ft(r,t){await Q(t,async e=>{let i=new U(e);await tt(r,n=>i.writeValue(n)),await i.finish();});}async function Q(r,t){await(await open(r,"wx",384)).close();let i=createWriteStream(r,{flags:"a",mode:384,highWaterMark:J});try{await t(i),i.end(),await once(i,"close");}catch(n){throw i.destroy(),n}}var U=class{#i;#t=Buffer.allocUnsafe(J);#e=0;constructor(t){this.#i=t;}write(t){if(t.byteLength>this.#t.length)return this.#r(t);if(this.#e+t.byteLength>this.#t.length)return this.#n(t);this.#t.set(t,this.#e),this.#e+=t.byteLength;}writeValue(t){let e=u+t.byteLength;if(e>this.#t.length)return this.#o(t);if(this.#e+e>this.#t.length)return this.#s(t);this.#c(t);}async finish(){await this.#a();}async#r(t){await this.#a(),await b(this.#i,t);}async#n(t){await this.#a(),this.#t.set(t,this.#e),this.#e+=t.byteLength;}async#o(t){await this.#a();let e=Buffer.allocUnsafe(u);e.writeUInt32BE(t.byteLength,0),await b(this.#i,e),await b(this.#i,t);}async#s(t){await this.#a(),this.#c(t);}async#a(){if(this.#e===0)return;let t=this.#t.subarray(0,this.#e);await b(this.#i,t),this.#e=0;}#c(t){this.#t.writeUInt32BE(t.byteLength,this.#e),this.#t.set(t,this.#e+u),this.#e+=u+t.byteLength;}};async function tt(r,t){let e=r.map(i=>new B(i));try{for(await Promise.all(e.map(i=>i.advance()));;){let i;for(let s of e)s.current&&(!i||P(s.current,i.current)<0)&&(i=s);if(!i?.current)return;let n=t(i.current);n&&await n,await i.advance();}}finally{for(let i of e)i.close();}}var B=class{#i;#t;#e=Buffer.alloc(0);#r=0;current;constructor(t){this.#i=createReadStream(t,{highWaterMark:Tt}),this.#t=this.#i[Symbol.asyncIterator]();}async advance(){let t=await this.#n(u);if(!t){this.current=void 0;return}let e=t.readUInt32BE(0);if(e===0)throw new Error("checkpoint identity run is invalid");let i=await this.#n(e);if(!i)throw new Error("checkpoint identity run is truncated");this.current=i;}close(){this.#i.destroy();}async#n(t){if(t===0)return Buffer.alloc(0);if(this.#e.length-this.#r>=t){let n=this.#e.subarray(this.#r,this.#r+t);return this.#r+=t,n}let e=Buffer.allocUnsafe(t),i=0;for(;i<t;){if(this.#r<this.#e.length){let s=Math.min(t-i,this.#e.length-this.#r);this.#e.copy(e,i,this.#r,this.#r+s),this.#r+=s,i+=s;continue}let n=await this.#t.next();if(n.done){if(i===0)return;throw new Error("checkpoint identity run is truncated")}this.#e=n.value,this.#r=0;}return e}};async function Dt(r,t){for(let e of r){let i=t(e);i&&await i;}}async function b(r,t){await new Promise((e,i)=>{r.write(t,n=>{n?i(n):e();});});}function P(r,t){let e=Math.min(r.length,t.length);for(let i=0;i<e;i+=1){let n=r[i],s=t[i];if(n===void 0||s===void 0)throw new Error("checkpoint identity byte is missing");let o=n-s;if(o!==0)return o}return r.length-t.length}var L=class{#i;#t=new Map;#e=new Map;#r=[];#n;constructor(t,e={}){this.#i=new k(t,{sortBudgetBytes:e.identitySortBudgetBytes,mergeFanIn:e.identityMergeFanIn});}openEntry(t){if(t===L$1){let e=[];return {write:async i=>{e.push(i.slice());},finish:async()=>{this.#n=Buffer.concat(e);}}}return new N(t,this.#t,this.#e,this.#i,e=>this.#r.push(e))}async finish(){if(!this.#n)throw new Error("checkpoint manifest is missing");let t=await N$1(this.#n),e=t.streams.flatMap(i=>i.chunks.map(n=>({...n,shapeName:i.shapeName})));if(e.length!==this.#r.length)throw new Error("checkpoint chunk inventory does not match");for(let[i,n]of e.entries()){let s=this.#r[i];if(s.path!==n.path||s.shapeName!==n.shapeName||s.recordCount!==n.recordCount||s.byteLength!==n.byteLength||s.sha256!==n.sha256)throw new Error("checkpoint chunk integrity does not match")}for(let i of t.streams){let n=this.#t.get(i.shapeName);if(!n||R$1(n)!==i.recordCount)throw new Error("checkpoint stream does not match its manifest")}if(this.#t.size!==t.streams.length)throw new Error("checkpoint contains an undeclared stream");return await this.#i.finish(),{manifest:t,chunkCount:e.length}}},N=class{#i;#t;#e;#r;#n;#o=createHash("sha256");#s=[];#a=0;#c;#h=0;#d=0;constructor(t,e,i,n,s){this.#i=t,this.#t=e,this.#e=i,this.#r=n,this.#n=s;}async write(t){if(this.#o.update(t),this.#d+=t.byteLength,!Number.isSafeInteger(this.#d))throw new Error("checkpoint chunk byte length is unsafe");let e=0;for(;e<t.byteLength;){let i=t.indexOf(10,e);if(i<0)break;let n=this.#u(this.#l(t.subarray(e,i+1)));n&&await n,e=i+1;}e<t.byteLength&&this.#f(t.subarray(e));}async finish(){if(this.#s.length!==0||this.#h===0||!this.#c)throw new Error("checkpoint chunk framing is invalid");if(this.#d>J$1&&this.#h!==1)throw new Error("oversized checkpoint chunk has multiple rows");this.#n({path:this.#i,shapeName:this.#c,recordCount:this.#h,byteLength:this.#d,sha256:this.#o.digest("hex")});let t=this.#e.get(this.#c);if(!t)throw new Error("checkpoint stream chunk state is missing");t.previous={byteLength:this.#d};}#u(t){let e=O(t),i=e.kind==="shape"?e.wref:e.shapeName;if(this.#c!==void 0&&this.#c!==i)throw new Error("checkpoint chunk mixes Shape streams");this.#c=i,this.#h===0&&this.#y(i,t.byteLength);let n=this.#t.get(i)??P$1(i);this.#t.set(i,n),Q$1(n,e);let s=this.#r.add(e.durableId);if(this.#h+=1,!Number.isSafeInteger(this.#h))throw new Error("checkpoint chunk row count is unsafe");return s}#f(t){if(t.byteLength!==0&&(this.#s.push(t.slice()),this.#a+=t.byteLength,!Number.isSafeInteger(this.#a)))throw new Error("checkpoint row byte length is unsafe")}#l(t){if(this.#s.length===0)return t;let e=Buffer.concat([...this.#s,t],this.#a+t.byteLength);return this.#s=[],this.#a=0,e}#y(t,e){let i=Number(this.#i.match(/part-(\d{10})\.jsonl$/)?.[1]??-1),n=this.#e.get(t)??{nextPart:0};if(i!==n.nextPart)throw new Error("checkpoint stream chunk parts are not contiguous");if(n.previous&&n.previous.byteLength<=J$1&&n.previous.byteLength+e<=J$1)throw new Error("checkpoint stream chunk closed before the byte limit");n.nextPart+=1,this.#e.set(t,n);}};async function Gt(r,t){return Kt(r,t)}async function Kt(r,t,e={}){let i=await mkdtemp(join(e.scratchParent??tmpdir(),"warmhub-checkpoint-verify-"));await chmod(i,448);let n,s;try{let o=new L(i,e),c=await G(r,p=>o.openEntry(p)),{manifest:h,chunkCount:f}=await o.finish();jt(t,c,h),n={valid:!0,checkpointId:h.checkpointId,repoSeq:h.repoSeq,recordCount:h.recordCount,chunkCount:f,totalBytes:c.byteLength,rootDigest:h.contentSha256,archiveDigest:c.sha256};}catch(o){s=Jt(o);}try{await rm(i,{recursive:!0,force:!0});}catch{s??=new d("scratch_cleanup_failed");}if(s)throw s;if(!n)throw new d("archive_invalid");return n}function jt(r,t,e){if(r&&(M.parse(r.sha256),r.checkpointId!==e.checkpointId||r.repoSeq!==e.repoSeq||r.byteLength!==t.byteLength||r.sha256!==t.sha256))throw new d("archive_integrity_mismatch")}function Jt(r){if(r instanceof d)return r;if(r instanceof E)return new d("source_failed");if(r instanceof g)return new d("duplicate_durable_id");let t=r instanceof Error?r.message:"";return t.includes("manifest")?new d("manifest_invalid"):t.includes("chunk")||t.includes("row")||t.includes("Shape stream")?new d("chunk_invalid"):new d("archive_invalid")}export{d as RepositoryCheckpointVerificationError,Gt as verifyRepositoryCheckpointArchive};//# sourceMappingURL=checkpoint.js.map
 //# sourceMappingURL=checkpoint.js.map