@gusto/baerly-storage 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (102) hide show
  1. package/dist/API.md +3 -2
  2. package/dist/CHANGELOG.md +82 -0
  3. package/dist/THIRD-PARTY-LICENSES.txt +1 -1
  4. package/dist/auth.d.ts +1 -1
  5. package/dist/aws4fetch.esm-CXE5ZbAa.js +460 -0
  6. package/dist/aws4fetch.esm-CXE5ZbAa.js.map +1 -0
  7. package/dist/baerly.js +10 -10
  8. package/dist/baerly.spec.json +1 -1
  9. package/dist/client-react.d.ts +2 -2
  10. package/dist/{client-Fe8CwB73.d.ts → client-ypCm3zjt.d.ts} +2 -2
  11. package/dist/client.d.ts +2 -2
  12. package/dist/{cloudflare-DzKBrUlg.js → cloudflare-wrVYf4bb.js} +457 -56
  13. package/dist/cloudflare-wrVYf4bb.js.map +1 -0
  14. package/dist/cloudflare.d.ts +3 -3
  15. package/dist/cloudflare.js +5 -5
  16. package/dist/{config-1tv0-Yzm.js → config-B6nTy8e2.js} +435 -33
  17. package/dist/config-B6nTy8e2.js.map +1 -0
  18. package/dist/constants-CfeMWQWk.js.map +1 -1
  19. package/dist/{cost-DSMIVqzL.js → cost-_SE_SVgZ.js} +4 -4
  20. package/dist/{cost-DSMIVqzL.js.map → cost-_SE_SVgZ.js.map} +1 -1
  21. package/dist/{db-DsPkOVEH.d.ts → db-DjjthkTi.d.ts} +2 -2
  22. package/dist/{deploy-DonTr-CV.js → deploy-Di_Q01qx.js} +5 -5
  23. package/dist/deploy-Di_Q01qx.js.map +1 -0
  24. package/dist/dev-vite.d.ts +31 -27
  25. package/dist/dev-vite.js +60 -30
  26. package/dist/dev-vite.js.map +1 -1
  27. package/dist/dev.d.ts +1 -1
  28. package/dist/doctor-RWVRpvat.js +102 -0
  29. package/dist/doctor-RWVRpvat.js.map +1 -0
  30. package/dist/{dump-Bh5k26VQ.js → dump-m2vEYDNY.js} +4 -4
  31. package/dist/{dump-Bh5k26VQ.js.map → dump-m2vEYDNY.js.map} +1 -1
  32. package/dist/{export-DtF5tDIM.js → export-DenKwEQu.js} +4 -4
  33. package/dist/{export-DtF5tDIM.js.map → export-DenKwEQu.js.map} +1 -1
  34. package/dist/{fsck-D_djMO5D.js → fsck-2Vq-7-e2.js} +5 -5
  35. package/dist/{fsck-D_djMO5D.js.map → fsck-2Vq-7-e2.js.map} +1 -1
  36. package/dist/gcs-admin-Bx6xSNJj.d.ts +123 -0
  37. package/dist/gcs.d.ts +18 -0
  38. package/dist/gcs.js +2 -0
  39. package/dist/goog4-signer-Z7KnJ1su.js +321 -0
  40. package/dist/goog4-signer-Z7KnJ1su.js.map +1 -0
  41. package/dist/{http-DGd5tbNs.js → http-7zT29K3P.js} +4 -4
  42. package/dist/{http-DGd5tbNs.js.map → http-7zT29K3P.js.map} +1 -1
  43. package/dist/{aws4fetch.esm-p7eEzLCs.js → http-transport-BTgVCY5r.js} +24 -476
  44. package/dist/http-transport-BTgVCY5r.js.map +1 -0
  45. package/dist/http.d.ts +2 -2
  46. package/dist/http.js +2 -2
  47. package/dist/{index-BNRh23K9.d.ts → index-BHz92Acj.d.ts} +2 -2
  48. package/dist/{index-BYk9oCNf.d.ts → index-CEZKQsKt.d.ts} +3 -2
  49. package/dist/{index-CuA9Mi3K.d.ts → index-DP3ClvcA.d.ts} +7 -7
  50. package/dist/{index-0rZcMBwy.d.ts → index-uE-w2dgj.d.ts} +2 -2
  51. package/dist/index.d.ts +3 -3
  52. package/dist/index.js +3 -3
  53. package/dist/{inspect-6WZ-pC7-.js → inspect-BpYbH1DM.js} +5 -5
  54. package/dist/{inspect-6WZ-pC7-.js.map → inspect-BpYbH1DM.js.map} +1 -1
  55. package/dist/{log-tail-D98U1JBo.js → log-tail-QWU4wlu-.js} +3 -11
  56. package/dist/log-tail-QWU4wlu-.js.map +1 -0
  57. package/dist/{maintenance-B_e0T99L.d.ts → maintenance-BGHGt2Yg.d.ts} +2 -2
  58. package/dist/{maintenance-B4Dki6Ig.js → maintenance-DULFcpd1.js} +4 -17
  59. package/dist/maintenance-DULFcpd1.js.map +1 -0
  60. package/dist/{maintenance-C7coQp4c.js → maintenance-fEi-UZ2o.js} +5 -11
  61. package/dist/maintenance-fEi-UZ2o.js.map +1 -0
  62. package/dist/maintenance.d.ts +1 -1
  63. package/dist/maintenance.js +1 -1
  64. package/dist/node.d.ts +21 -60
  65. package/dist/node.js +4 -3
  66. package/dist/{observability-BmflLCdF.js → observability-Ch-VQJyE.js} +38 -16
  67. package/dist/{observability-BmflLCdF.js.map → observability-Ch-VQJyE.js.map} +1 -1
  68. package/dist/observability.d.ts +2 -2
  69. package/dist/observability.js +1 -1
  70. package/dist/{plan-a7PJHBCy.js → plan-C4qgiXSg.js} +2 -2
  71. package/dist/{plan-a7PJHBCy.js.map → plan-C4qgiXSg.js.map} +1 -1
  72. package/dist/{query-rAtXNQQB.js → query-C43r-6ib.js} +2 -2
  73. package/dist/{query-rAtXNQQB.js.map → query-C43r-6ib.js.map} +1 -1
  74. package/dist/{rebuild-index-BVzQSZlm.js → rebuild-index-BH1dc1p6.js} +4 -4
  75. package/dist/{rebuild-index-BVzQSZlm.js.map → rebuild-index-BH1dc1p6.js.map} +1 -1
  76. package/dist/{restore-R-4rbciV.js → restore-D0VYWzfP.js} +5 -5
  77. package/dist/{restore-R-4rbciV.js.map → restore-D0VYWzfP.js.map} +1 -1
  78. package/dist/{runtime-spec-Dsw2-n8S.js → runtime-spec--LykAdl1.js} +2 -2
  79. package/dist/{runtime-spec-Dsw2-n8S.js.map → runtime-spec--LykAdl1.js.map} +1 -1
  80. package/dist/{s3-http-B-z8th6O.d.ts → s3-http-DD5gDc7t.d.ts} +6 -4
  81. package/dist/s3.d.ts +1 -1
  82. package/dist/s3.js +1 -1
  83. package/dist/sha256-CqcKTjw9.js +22 -0
  84. package/dist/sha256-CqcKTjw9.js.map +1 -0
  85. package/dist/{src-BL_JoPTn.js → src-BMFfDUI2.js} +68 -28
  86. package/dist/{src-BL_JoPTn.js.map → src-BMFfDUI2.js.map} +1 -1
  87. package/dist/{src-CYHFDrKz.js → src-DvbTEya2.js} +3 -3
  88. package/dist/{src-CYHFDrKz.js.map → src-DvbTEya2.js.map} +1 -1
  89. package/dist/{subcommand-DoDA-K7d.js → subcommand-BV68pqwJ.js} +2 -2
  90. package/dist/{subcommand-DoDA-K7d.js.map → subcommand-BV68pqwJ.js.map} +1 -1
  91. package/dist/{usage-DBV1eQHC.js → usage-BMZR8o6U.js} +3 -3
  92. package/dist/{usage-DBV1eQHC.js.map → usage-BMZR8o6U.js.map} +1 -1
  93. package/package.json +10 -4
  94. package/dist/aws4fetch.esm-p7eEzLCs.js.map +0 -1
  95. package/dist/cloudflare-DzKBrUlg.js.map +0 -1
  96. package/dist/config-1tv0-Yzm.js.map +0 -1
  97. package/dist/deploy-DonTr-CV.js.map +0 -1
  98. package/dist/doctor-DSIyCDg_.js +0 -346
  99. package/dist/doctor-DSIyCDg_.js.map +0 -1
  100. package/dist/log-tail-D98U1JBo.js.map +0 -1
  101. package/dist/maintenance-B4Dki6Ig.js.map +0 -1
  102. package/dist/maintenance-C7coQp4c.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"fsck-D_djMO5D.js","names":[],"sources":["../packages/cli/src/admin/fsck.ts"],"sourcesContent":["/**\n * `baerly admin fsck` — consistency walk for one collection.\n *\n * Default mode (no `--indexes`): read-only checks against the\n * snapshot + log tail.\n * 1. `current.json` exists at the expected key and parses.\n * 2. When `current.snapshot !== null`, the snapshot body's\n * SHA-256 matches the hash embedded in the filename\n * (delegated to `loadSnapshotAsMap`).\n * 3. The live log range has no holes. The upper bound is derived\n * from a single LIST of `log/` plus `current.json.tail_hint`\n * (max(highest present seq + 1, tail_hint)), and every seq from\n * `log_seq_start` up to that tail must be present.\n * This is a presence/hole check by key, NOT a per-entry decode:\n * fsck does not GET and parse each `log/<seq>.json`, so it does\n * not assert every entry is well-formed JSON or carries the locked\n * `op`/`collection`/`doc_id` fields. A full decode walk is\n * intentionally omitted to keep the op count O(LIST pages); the\n * read path validates entry shape at fold time.\n *\n * `--indexes` + `--config=<path>` mode: SKIP the snapshot + log\n * walks and ONLY check each declared index for drift via\n * `rebuildIndex(..., { dryRun: true })`. Drift is `(added > 0)`\n * (rows that should be projected but have no key on storage) or\n * `(removed > 0)` (orphan keys for rows that no longer match).\n * Read-only.\n *\n * `--indexes --fix`: same drift walk but with `dryRun: false`, so\n * `rebuildIndex` PUTs missing keys and DELETEs orphans. The findings\n * downgrade from `warning` to `info` (drift was found AND fixed in\n * one pass). `--fix` without `--indexes` is rejected — fsck has no\n * auto-fix outside the index check.\n *\n * Exit codes:\n * 0 — all checks pass.\n * 1 — InvalidConfig (bad bucket URI, missing args, unknown flag,\n * `--fix` without `--indexes`).\n * 2 — Storage / Network error during the walk.\n * 3 — Protocol invariant violation surfaced by the kernel\n * (Internal / InvalidResponse) — distinguished from exit 4\n * so CI can wire fsck as a regression gate.\n * 4 — One or more findings (orphan / hole / hash-mismatch /\n * index drift). Unique to this command; the other\n * `baerly admin` subcommands reserve 0–3.\n */\n\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { type ArgsDef } from \"citty\";\nimport {\n type BaerlyConfig,\n BaerlyError,\n type IndexDefinition,\n readCurrentJson,\n type Storage,\n} from \"@baerly/protocol\";\nimport { loadSnapshotAsMap } from \"@baerly/server\";\nimport { rebuildIndex } from \"@baerly/server/maintenance\";\nimport { parseBucketUri } from \"../bucket-uri.ts\";\nimport { emitSuccess, isJsonMode } from \"../output.ts\";\nimport {\n APP_ARG,\n assertCollectionArg,\n BUCKET_ARG,\n COLLECTION_ARG,\n defineBaerlySubcommand,\n JSON_ARG,\n TENANT_ARG,\n} from \"../subcommand.ts\";\n\nconst FSCK_ARGS = {\n bucket: BUCKET_ARG,\n app: APP_ARG,\n tenant: TENANT_ARG,\n collection: COLLECTION_ARG,\n config: {\n type: \"string\",\n required: false,\n description:\n \"Path to baerly.config.{js,mjs,json}. Required with --indexes; resolves index definitions.\",\n valueHint: \"path\",\n },\n indexes: {\n type: \"boolean\",\n description:\n \"Skip snapshot + log walks; check declared indexes for drift via rebuildIndex (read-only by default).\",\n },\n fix: {\n type: \"boolean\",\n description:\n \"With --indexes, rebuild drifted indexes (PUT missing keys, DELETE orphans). Rejected without --indexes.\",\n },\n json: JSON_ARG,\n} as const satisfies ArgsDef;\n\ntype Severity = \"ok\" | \"info\" | \"warning\" | \"finding\";\ninterface Finding {\n readonly severity: Severity;\n readonly check: string;\n readonly message: string;\n readonly key?: string;\n}\n\n/** Severities that count toward the exit-4 \"findings present\" status. */\nconst isFindingSeverity = (s: Severity): boolean => s === \"finding\" || s === \"warning\";\n\nconst loadConfigIndexes = async (\n configPath: string,\n collection: string,\n): Promise<readonly IndexDefinition[]> => {\n if (configPath.endsWith(\".ts\")) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config must point at compiled JS / JSON (got .ts: ${JSON.stringify(configPath)})`,\n );\n }\n let cfg: BaerlyConfig;\n if (configPath.endsWith(\".json\")) {\n const { readFile } = await import(\"node:fs/promises\");\n const text = await readFile(configPath, \"utf8\");\n try {\n cfg = JSON.parse(text) as BaerlyConfig;\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config JSON parse error in ${JSON.stringify(configPath)}: ${(error as Error).message}`,\n );\n }\n } else {\n const pathMod = await import(\"node:path\");\n const abs = configPath.startsWith(\"file://\")\n ? fileURLToPath(configPath)\n : pathMod.resolve(configPath);\n const mod = (await import(pathToFileURL(abs).href)) as { default?: BaerlyConfig };\n if (mod.default === undefined) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config ${JSON.stringify(configPath)} has no default export`,\n );\n }\n cfg = mod.default;\n }\n const def = cfg.collections?.[collection];\n return def?.indexes ?? [];\n};\n\nconst listKeys = async (storage: Storage, prefix: string): Promise<string[]> => {\n const out: string[] = [];\n for await (const entry of storage.list(prefix)) {\n out.push(entry.key);\n }\n return out.toSorted();\n};\n\nconst statusLine = (label: string, ok: boolean, detail: string): string =>\n ` ${label.padEnd(22)}${ok ? \"ok\" : \"error\"} ${detail}`.trimEnd();\n\ninterface IndexSummary {\n readonly name: string;\n readonly added: number;\n readonly removed: number;\n readonly kept: number;\n readonly rebuilt: boolean;\n}\n\nconst renderSnapshotLog = (\n collection: string,\n findings: readonly Finding[],\n context: {\n readonly logRange: readonly [number, number];\n readonly logEntriesPresent: number;\n readonly snapshotKey: string | null;\n },\n): string => {\n const lines: string[] = [];\n lines.push(`baerly admin fsck ${collection}`);\n const [from, toExcl] = context.logRange;\n const byCheck = new Map<string, Finding[]>();\n for (const f of findings) {\n const arr = byCheck.get(f.check) ?? [];\n arr.push(f);\n byCheck.set(f.check, arr);\n }\n lines.push(statusLine(\"current.json:\", (byCheck.get(\"current.json\") ?? []).length === 0, \"\"));\n lines.push(\n statusLine(\n \"snapshot hash:\",\n (byCheck.get(\"snapshot\") ?? []).length === 0,\n context.snapshotKey === null ? \"(no snapshot yet)\" : `(sha256 verified)`,\n ),\n );\n lines.push(\n statusLine(\n `log range [${from},${toExcl}):`,\n (byCheck.get(\"log\") ?? []).length === 0,\n `(${context.logEntriesPresent}/${toExcl - from} entries present)`,\n ),\n );\n lines.push(` status: ${findings.some(isFindingFinding) ? \"findings\" : \"ok\"}`);\n for (const f of findings) {\n lines.push(` ${f.check}: ${f.message}${f.key !== undefined ? ` (key=${f.key})` : \"\"}`);\n }\n return lines.join(\"\\n\") + \"\\n\";\n};\n\nconst renderIndexes = (\n collection: string,\n findings: readonly Finding[],\n summaries: readonly IndexSummary[],\n fix: boolean,\n): string => {\n const lines: string[] = [];\n lines.push(`baerly admin fsck ${collection} --indexes${fix ? \" --fix\" : \"\"}`);\n for (const s of summaries) {\n const verb = s.rebuilt ? \"rebuilt\" : \"would rebuild\";\n if (s.added === 0 && s.removed === 0) {\n lines.push(` ${s.name}: in sync (${s.kept} keys)`);\n } else {\n lines.push(` ${s.name}: ${verb} — added ${s.added}, removed ${s.removed}, kept ${s.kept}`);\n }\n }\n lines.push(` status: ${findings.some(isFindingFinding) ? \"findings\" : \"ok\"}`);\n for (const f of findings) {\n if (f.check === \"log\" || f.check === \"snapshot\" || f.check === \"current.json\") {\n continue;\n }\n lines.push(` ${f.check}: ${f.message}${f.key !== undefined ? ` (key=${f.key})` : \"\"}`);\n }\n return lines.join(\"\\n\") + \"\\n\";\n};\n\nconst isFindingFinding = (f: Finding): boolean => isFindingSeverity(f.severity);\n\nconst bundle = defineBaerlySubcommand({\n name: \"admin.fsck\",\n meta: {\n description: \"Read-only consistency walk for one collection.\",\n },\n args: FSCK_ARGS,\n handler: async (args, ctx) => {\n const indexMode = args.indexes === true;\n const fixMode = args.fix === true;\n if (fixMode && !indexMode) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"baerly admin fsck: --fix is only valid with --indexes (fsck has no auto-fix outside the index check)\",\n );\n }\n if (indexMode && (args.config === undefined || args.config.length === 0)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"baerly admin fsck: --indexes requires --config=<path> to resolve index definitions\",\n );\n }\n const { app, tenant } = await ctx.resolveAppTenant({ app: args.app, tenant: args.tenant });\n assertCollectionArg(args.collection, \"baerly admin fsck\");\n const bucket = await parseBucketUri(args.bucket);\n const collectionPrefix = `${bucket.keyPrefix}app/${app}/tenant/${tenant}/manifests/${args.collection}`;\n const currentJsonKey = `${collectionPrefix}/current.json`;\n\n const findings: Finding[] = [];\n\n if (indexMode) {\n // ── Index drift mode. ──────────────────────────────────────────\n // Skip snapshot + log walks. For each declared index, call\n // `rebuildIndex(..., { dryRun: !fix })` — it returns the\n // `(added, removed, kept)` triple we need to call drift.\n const defs = await loadConfigIndexes(args.config!, args.collection);\n const summaries: IndexSummary[] = [];\n for (const def of defs) {\n const check = `index.${def.name}`;\n let result;\n try {\n result = await rebuildIndex(bucket.storage, currentJsonKey, def, {\n dryRun: !fixMode,\n });\n } catch (error) {\n findings.push({\n severity: \"finding\",\n check,\n message: `${def.name}: drift check failed: ${(error as Error).message}`,\n });\n continue;\n }\n const summary: IndexSummary = {\n name: def.name,\n added: result.added,\n removed: result.removed,\n kept: result.kept,\n rebuilt: fixMode,\n };\n summaries.push(summary);\n const drifted = result.added > 0 || result.removed > 0;\n if (!drifted) {\n findings.push({\n severity: \"ok\",\n check,\n message: `${def.name}: in sync (${result.kept} keys).`,\n });\n } else if (fixMode) {\n findings.push({\n severity: \"info\",\n check,\n message: `${def.name}: rebuilt — added ${result.added}, removed ${result.removed}, kept ${result.kept}.`,\n });\n } else {\n findings.push({\n severity: \"warning\",\n check,\n message: `${def.name}: drift detected — ${result.added} missing, ${result.removed} orphaned (${result.kept} in sync).`,\n });\n }\n }\n\n if (isJsonMode()) {\n emitSuccess({\n command: \"admin.fsck\",\n status: findings.some(isFindingFinding) ? \"findings\" : \"ok\",\n collection: args.collection,\n mode: fixMode ? \"indexes-fix\" : \"indexes\",\n indexes: summaries,\n findings: findings.map((f) => ({\n severity: f.severity,\n check: f.check,\n message: f.message,\n ...(f.key !== undefined && { key: f.key }),\n })),\n });\n } else {\n process.stdout.write(renderIndexes(args.collection, findings, summaries, fixMode));\n }\n return findings.some(isFindingFinding) ? 4 : 0;\n }\n\n // ── Default mode. current.json + snapshot + log walks. ─────────\n const read = await readCurrentJson(bucket.storage, currentJsonKey);\n if (read === null) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: current.json not found at ${currentJsonKey}`,\n );\n }\n const cur = read.json;\n const logFrom = cur.log_seq_start ?? 0;\n const snapshotKey = cur.snapshot;\n\n // ── Snapshot hash verifies (loadSnapshotAsMap throws on mismatch). ──\n if (snapshotKey !== null) {\n try {\n await loadSnapshotAsMap(bucket.storage, snapshotKey, args.collection);\n } catch (error) {\n if (\n error instanceof BaerlyError &&\n (error.code === \"Internal\" || error.code === \"InvalidResponse\")\n ) {\n findings.push({\n severity: \"finding\",\n check: \"snapshot\",\n message: error.message,\n key: snapshotKey,\n });\n } else {\n throw error;\n }\n }\n }\n\n // ── Log range [from, tail) has no holes (presence check only). ──\n // LIST the log/ prefix and derive the upper bound from both listed\n // keys and `tail_hint`: under single-write commit `tail_hint` is\n // normally a lower bound, but fsck must also catch an over-claimed\n // hint whose `[log_seq_start, tail_hint)` range is not actually\n // present. Use a single LIST so the op count is O(pages).\n const logPrefix = `${collectionPrefix}/log/`;\n const presentKeys = await listKeys(bucket.storage, logPrefix);\n const presentSeqs = new Set<number>();\n let maxSeq = logFrom - 1;\n for (const key of presentKeys) {\n const tail = key.slice(logPrefix.length);\n const match = /^(\\d+)\\.json$/.exec(tail);\n if (match === null) {\n continue;\n }\n const seq = Number.parseInt(match[1]!, 10);\n if (Number.isFinite(seq)) {\n presentSeqs.add(seq);\n if (seq > maxSeq) {\n maxSeq = seq;\n }\n }\n }\n const logToExcl = Math.max(cur.tail_hint, maxSeq + 1);\n let logEntriesPresent = 0;\n for (let s = logFrom; s < logToExcl; s++) {\n if (presentSeqs.has(s)) {\n logEntriesPresent++;\n } else {\n findings.push({\n severity: \"finding\",\n check: \"log\",\n message: `missing log entry at seq ${s} inside [log_seq_start, tail)`,\n key: `${logPrefix}${s}.json`,\n });\n }\n }\n\n if (isJsonMode()) {\n emitSuccess({\n command: \"admin.fsck\",\n status: findings.some(isFindingFinding) ? \"findings\" : \"ok\",\n collection: args.collection,\n current_json_key: currentJsonKey,\n snapshot: snapshotKey,\n log_range: { from: logFrom, to_excl: logToExcl, present: logEntriesPresent },\n findings: findings.map((f) => ({\n severity: f.severity,\n check: f.check,\n message: f.message,\n ...(f.key !== undefined && { key: f.key }),\n })),\n });\n } else {\n process.stdout.write(\n renderSnapshotLog(args.collection, findings, {\n logRange: [logFrom, logToExcl],\n logEntriesPresent,\n snapshotKey,\n }),\n );\n }\n return findings.some(isFindingFinding) ? 4 : 0;\n },\n});\n\n/** citty `defineCommand` block for `baerly admin fsck`. */\nexport const fsckCmd = bundle.cmd;\n\n/**\n * Programmatic entry used by tests. Bypasses citty's `run` wrapper\n * (which would call `process.exit` and kill vitest) and returns the\n * integer exit code directly.\n */\nexport const runFsck = bundle.run;\n"],"mappings":"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"}
1
+ {"version":3,"file":"fsck-2Vq-7-e2.js","names":[],"sources":["../packages/cli/src/admin/fsck.ts"],"sourcesContent":["/**\n * `baerly admin fsck` — consistency walk for one collection.\n *\n * Default mode (no `--indexes`): read-only checks against the\n * snapshot + log tail.\n * 1. `current.json` exists at the expected key and parses.\n * 2. When `current.snapshot !== null`, the snapshot body's\n * SHA-256 matches the hash embedded in the filename\n * (delegated to `loadSnapshotAsMap`).\n * 3. The live log range has no holes. The upper bound is derived\n * from a single LIST of `log/` plus `current.json.tail_hint`\n * (max(highest present seq + 1, tail_hint)), and every seq from\n * `log_seq_start` up to that tail must be present.\n * This is a presence/hole check by key, NOT a per-entry decode:\n * fsck does not GET and parse each `log/<seq>.json`, so it does\n * not assert every entry is well-formed JSON or carries the locked\n * `op`/`collection`/`doc_id` fields. A full decode walk is\n * intentionally omitted to keep the op count O(LIST pages); the\n * read path validates entry shape at fold time.\n *\n * `--indexes` + `--config=<path>` mode: SKIP the snapshot + log\n * walks and ONLY check each declared index for drift via\n * `rebuildIndex(..., { dryRun: true })`. Drift is `(added > 0)`\n * (rows that should be projected but have no key on storage) or\n * `(removed > 0)` (orphan keys for rows that no longer match).\n * Read-only.\n *\n * `--indexes --fix`: same drift walk but with `dryRun: false`, so\n * `rebuildIndex` PUTs missing keys and DELETEs orphans. The findings\n * downgrade from `warning` to `info` (drift was found AND fixed in\n * one pass). `--fix` without `--indexes` is rejected — fsck has no\n * auto-fix outside the index check.\n *\n * Exit codes:\n * 0 — all checks pass.\n * 1 — InvalidConfig (bad bucket URI, missing args, unknown flag,\n * `--fix` without `--indexes`).\n * 2 — Storage / Network error during the walk.\n * 3 — Protocol invariant violation surfaced by the kernel\n * (Internal / InvalidResponse) — distinguished from exit 4\n * so CI can wire fsck as a regression gate.\n * 4 — One or more findings (orphan / hole / hash-mismatch /\n * index drift). Unique to this command; the other\n * `baerly admin` subcommands reserve 0–3.\n */\n\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { type ArgsDef } from \"citty\";\nimport {\n type BaerlyConfig,\n BaerlyError,\n type IndexDefinition,\n readCurrentJson,\n type Storage,\n} from \"@baerly/protocol\";\nimport { loadSnapshotAsMap } from \"@baerly/server\";\nimport { rebuildIndex } from \"@baerly/server/maintenance\";\nimport { parseBucketUri } from \"../bucket-uri.ts\";\nimport { emitSuccess, isJsonMode } from \"../output.ts\";\nimport {\n APP_ARG,\n assertCollectionArg,\n BUCKET_ARG,\n COLLECTION_ARG,\n defineBaerlySubcommand,\n JSON_ARG,\n TENANT_ARG,\n} from \"../subcommand.ts\";\n\nconst FSCK_ARGS = {\n bucket: BUCKET_ARG,\n app: APP_ARG,\n tenant: TENANT_ARG,\n collection: COLLECTION_ARG,\n config: {\n type: \"string\",\n required: false,\n description:\n \"Path to baerly.config.{js,mjs,json}. Required with --indexes; resolves index definitions.\",\n valueHint: \"path\",\n },\n indexes: {\n type: \"boolean\",\n description:\n \"Skip snapshot + log walks; check declared indexes for drift via rebuildIndex (read-only by default).\",\n },\n fix: {\n type: \"boolean\",\n description:\n \"With --indexes, rebuild drifted indexes (PUT missing keys, DELETE orphans). Rejected without --indexes.\",\n },\n json: JSON_ARG,\n} as const satisfies ArgsDef;\n\ntype Severity = \"ok\" | \"info\" | \"warning\" | \"finding\";\ninterface Finding {\n readonly severity: Severity;\n readonly check: string;\n readonly message: string;\n readonly key?: string;\n}\n\n/** Severities that count toward the exit-4 \"findings present\" status. */\nconst isFindingSeverity = (s: Severity): boolean => s === \"finding\" || s === \"warning\";\n\nconst loadConfigIndexes = async (\n configPath: string,\n collection: string,\n): Promise<readonly IndexDefinition[]> => {\n if (configPath.endsWith(\".ts\")) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config must point at compiled JS / JSON (got .ts: ${JSON.stringify(configPath)})`,\n );\n }\n let cfg: BaerlyConfig;\n if (configPath.endsWith(\".json\")) {\n const { readFile } = await import(\"node:fs/promises\");\n const text = await readFile(configPath, \"utf8\");\n try {\n cfg = JSON.parse(text) as BaerlyConfig;\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config JSON parse error in ${JSON.stringify(configPath)}: ${(error as Error).message}`,\n );\n }\n } else {\n const pathMod = await import(\"node:path\");\n const abs = configPath.startsWith(\"file://\")\n ? fileURLToPath(configPath)\n : pathMod.resolve(configPath);\n const mod = (await import(pathToFileURL(abs).href)) as { default?: BaerlyConfig };\n if (mod.default === undefined) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: --config ${JSON.stringify(configPath)} has no default export`,\n );\n }\n cfg = mod.default;\n }\n const def = cfg.collections?.[collection];\n return def?.indexes ?? [];\n};\n\nconst listKeys = async (storage: Storage, prefix: string): Promise<string[]> => {\n const out: string[] = [];\n for await (const entry of storage.list(prefix)) {\n out.push(entry.key);\n }\n return out.toSorted();\n};\n\nconst statusLine = (label: string, ok: boolean, detail: string): string =>\n ` ${label.padEnd(22)}${ok ? \"ok\" : \"error\"} ${detail}`.trimEnd();\n\ninterface IndexSummary {\n readonly name: string;\n readonly added: number;\n readonly removed: number;\n readonly kept: number;\n readonly rebuilt: boolean;\n}\n\nconst renderSnapshotLog = (\n collection: string,\n findings: readonly Finding[],\n context: {\n readonly logRange: readonly [number, number];\n readonly logEntriesPresent: number;\n readonly snapshotKey: string | null;\n },\n): string => {\n const lines: string[] = [];\n lines.push(`baerly admin fsck ${collection}`);\n const [from, toExcl] = context.logRange;\n const byCheck = new Map<string, Finding[]>();\n for (const f of findings) {\n const arr = byCheck.get(f.check) ?? [];\n arr.push(f);\n byCheck.set(f.check, arr);\n }\n lines.push(statusLine(\"current.json:\", (byCheck.get(\"current.json\") ?? []).length === 0, \"\"));\n lines.push(\n statusLine(\n \"snapshot hash:\",\n (byCheck.get(\"snapshot\") ?? []).length === 0,\n context.snapshotKey === null ? \"(no snapshot yet)\" : `(sha256 verified)`,\n ),\n );\n lines.push(\n statusLine(\n `log range [${from},${toExcl}):`,\n (byCheck.get(\"log\") ?? []).length === 0,\n `(${context.logEntriesPresent}/${toExcl - from} entries present)`,\n ),\n );\n lines.push(` status: ${findings.some(isFindingFinding) ? \"findings\" : \"ok\"}`);\n for (const f of findings) {\n lines.push(` ${f.check}: ${f.message}${f.key !== undefined ? ` (key=${f.key})` : \"\"}`);\n }\n return lines.join(\"\\n\") + \"\\n\";\n};\n\nconst renderIndexes = (\n collection: string,\n findings: readonly Finding[],\n summaries: readonly IndexSummary[],\n fix: boolean,\n): string => {\n const lines: string[] = [];\n lines.push(`baerly admin fsck ${collection} --indexes${fix ? \" --fix\" : \"\"}`);\n for (const s of summaries) {\n const verb = s.rebuilt ? \"rebuilt\" : \"would rebuild\";\n if (s.added === 0 && s.removed === 0) {\n lines.push(` ${s.name}: in sync (${s.kept} keys)`);\n } else {\n lines.push(` ${s.name}: ${verb} — added ${s.added}, removed ${s.removed}, kept ${s.kept}`);\n }\n }\n lines.push(` status: ${findings.some(isFindingFinding) ? \"findings\" : \"ok\"}`);\n for (const f of findings) {\n if (f.check === \"log\" || f.check === \"snapshot\" || f.check === \"current.json\") {\n continue;\n }\n lines.push(` ${f.check}: ${f.message}${f.key !== undefined ? ` (key=${f.key})` : \"\"}`);\n }\n return lines.join(\"\\n\") + \"\\n\";\n};\n\nconst isFindingFinding = (f: Finding): boolean => isFindingSeverity(f.severity);\n\nconst bundle = defineBaerlySubcommand({\n name: \"admin.fsck\",\n meta: {\n description: \"Read-only consistency walk for one collection.\",\n },\n args: FSCK_ARGS,\n handler: async (args, ctx) => {\n const indexMode = args.indexes === true;\n const fixMode = args.fix === true;\n if (fixMode && !indexMode) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"baerly admin fsck: --fix is only valid with --indexes (fsck has no auto-fix outside the index check)\",\n );\n }\n if (indexMode && (args.config === undefined || args.config.length === 0)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"baerly admin fsck: --indexes requires --config=<path> to resolve index definitions\",\n );\n }\n const { app, tenant } = await ctx.resolveAppTenant({ app: args.app, tenant: args.tenant });\n assertCollectionArg(args.collection, \"baerly admin fsck\");\n const bucket = await parseBucketUri(args.bucket);\n const collectionPrefix = `${bucket.keyPrefix}app/${app}/tenant/${tenant}/manifests/${args.collection}`;\n const currentJsonKey = `${collectionPrefix}/current.json`;\n\n const findings: Finding[] = [];\n\n if (indexMode) {\n // ── Index drift mode. ──────────────────────────────────────────\n // Skip snapshot + log walks. For each declared index, call\n // `rebuildIndex(..., { dryRun: !fix })` — it returns the\n // `(added, removed, kept)` triple we need to call drift.\n const defs = await loadConfigIndexes(args.config!, args.collection);\n const summaries: IndexSummary[] = [];\n for (const def of defs) {\n const check = `index.${def.name}`;\n let result;\n try {\n result = await rebuildIndex(bucket.storage, currentJsonKey, def, {\n dryRun: !fixMode,\n });\n } catch (error) {\n findings.push({\n severity: \"finding\",\n check,\n message: `${def.name}: drift check failed: ${(error as Error).message}`,\n });\n continue;\n }\n const summary: IndexSummary = {\n name: def.name,\n added: result.added,\n removed: result.removed,\n kept: result.kept,\n rebuilt: fixMode,\n };\n summaries.push(summary);\n const drifted = result.added > 0 || result.removed > 0;\n if (!drifted) {\n findings.push({\n severity: \"ok\",\n check,\n message: `${def.name}: in sync (${result.kept} keys).`,\n });\n } else if (fixMode) {\n findings.push({\n severity: \"info\",\n check,\n message: `${def.name}: rebuilt — added ${result.added}, removed ${result.removed}, kept ${result.kept}.`,\n });\n } else {\n findings.push({\n severity: \"warning\",\n check,\n message: `${def.name}: drift detected — ${result.added} missing, ${result.removed} orphaned (${result.kept} in sync).`,\n });\n }\n }\n\n if (isJsonMode()) {\n emitSuccess({\n command: \"admin.fsck\",\n status: findings.some(isFindingFinding) ? \"findings\" : \"ok\",\n collection: args.collection,\n mode: fixMode ? \"indexes-fix\" : \"indexes\",\n indexes: summaries,\n findings: findings.map((f) => ({\n severity: f.severity,\n check: f.check,\n message: f.message,\n ...(f.key !== undefined && { key: f.key }),\n })),\n });\n } else {\n process.stdout.write(renderIndexes(args.collection, findings, summaries, fixMode));\n }\n return findings.some(isFindingFinding) ? 4 : 0;\n }\n\n // ── Default mode. current.json + snapshot + log walks. ─────────\n const read = await readCurrentJson(bucket.storage, currentJsonKey);\n if (read === null) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly admin fsck: current.json not found at ${currentJsonKey}`,\n );\n }\n const cur = read.json;\n const logFrom = cur.log_seq_start ?? 0;\n const snapshotKey = cur.snapshot;\n\n // ── Snapshot hash verifies (loadSnapshotAsMap throws on mismatch). ──\n if (snapshotKey !== null) {\n try {\n await loadSnapshotAsMap(bucket.storage, snapshotKey, args.collection);\n } catch (error) {\n if (\n error instanceof BaerlyError &&\n (error.code === \"Internal\" || error.code === \"InvalidResponse\")\n ) {\n findings.push({\n severity: \"finding\",\n check: \"snapshot\",\n message: error.message,\n key: snapshotKey,\n });\n } else {\n throw error;\n }\n }\n }\n\n // ── Log range [from, tail) has no holes (presence check only). ──\n // LIST the log/ prefix and derive the upper bound from both listed\n // keys and `tail_hint`: under single-write commit `tail_hint` is\n // normally a lower bound, but fsck must also catch an over-claimed\n // hint whose `[log_seq_start, tail_hint)` range is not actually\n // present. Use a single LIST so the op count is O(pages).\n const logPrefix = `${collectionPrefix}/log/`;\n const presentKeys = await listKeys(bucket.storage, logPrefix);\n const presentSeqs = new Set<number>();\n let maxSeq = logFrom - 1;\n for (const key of presentKeys) {\n const tail = key.slice(logPrefix.length);\n const match = /^(\\d+)\\.json$/.exec(tail);\n if (match === null) {\n continue;\n }\n const seq = Number.parseInt(match[1]!, 10);\n if (Number.isFinite(seq)) {\n presentSeqs.add(seq);\n if (seq > maxSeq) {\n maxSeq = seq;\n }\n }\n }\n const logToExcl = Math.max(cur.tail_hint, maxSeq + 1);\n let logEntriesPresent = 0;\n for (let s = logFrom; s < logToExcl; s++) {\n if (presentSeqs.has(s)) {\n logEntriesPresent++;\n } else {\n findings.push({\n severity: \"finding\",\n check: \"log\",\n message: `missing log entry at seq ${s} inside [log_seq_start, tail)`,\n key: `${logPrefix}${s}.json`,\n });\n }\n }\n\n if (isJsonMode()) {\n emitSuccess({\n command: \"admin.fsck\",\n status: findings.some(isFindingFinding) ? \"findings\" : \"ok\",\n collection: args.collection,\n current_json_key: currentJsonKey,\n snapshot: snapshotKey,\n log_range: { from: logFrom, to_excl: logToExcl, present: logEntriesPresent },\n findings: findings.map((f) => ({\n severity: f.severity,\n check: f.check,\n message: f.message,\n ...(f.key !== undefined && { key: f.key }),\n })),\n });\n } else {\n process.stdout.write(\n renderSnapshotLog(args.collection, findings, {\n logRange: [logFrom, logToExcl],\n logEntriesPresent,\n snapshotKey,\n }),\n );\n }\n return findings.some(isFindingFinding) ? 4 : 0;\n },\n});\n\n/** citty `defineCommand` block for `baerly admin fsck`. */\nexport const fsckCmd = bundle.cmd;\n\n/**\n * Programmatic entry used by tests. Bypasses citty's `run` wrapper\n * (which would call `process.exit` and kill vitest) and returns the\n * integer exit code directly.\n */\nexport const runFsck = bundle.run;\n"],"mappings":"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"}
@@ -0,0 +1,123 @@
1
+ import { _ as StoragePutOptions, g as StorageListEntry, h as StorageGetResult, m as StorageGetOptions, p as Storage, v as StoragePutResult } from "./index-CEZKQsKt.js";
2
+
3
+ //#region packages/adapter-node/src/gcs-http.d.ts
4
+ /** Default GCS native XML API endpoint. */
5
+ declare const DEFAULT_GCS_ENDPOINT = "https://storage.googleapis.com";
6
+ /**
7
+ * Construction-time options for {@link GcsHttpStorage}. Everything is
8
+ * optional except `bucket`; `endpoint` defaults to the GCS native XML
9
+ * API host. `sign` is injected — `gcsStorage` wires in the
10
+ * GOOG4-HMAC-SHA256 signer ({@link goog4Signer}); unit tests pass a
11
+ * passthrough.
12
+ */
13
+ interface GcsHttpStorageOptions {
14
+ /** GCS endpoint. Defaults to `https://storage.googleapis.com`. */
15
+ endpoint?: string;
16
+ /** GCS bucket name. */
17
+ bucket: string;
18
+ /** `fetch` implementation. Defaults to `globalThis.fetch.bind(globalThis)`. */
19
+ fetch?: typeof fetch;
20
+ /** Signs requests before send. GOOG4-HMAC-SHA256 in production. */
21
+ sign?: (req: Request) => Promise<Request>;
22
+ /** Max retries for transient (non-permanent) failures. */
23
+ retries?: number;
24
+ /** Initial backoff in ms. */
25
+ backoffMs?: number;
26
+ }
27
+ /**
28
+ * `Storage` impl that speaks the GCS native XML API and drives GCS's own
29
+ * `x-goog-if-generation-match` conditional writes. Unlike GCS's S3-interop
30
+ * endpoint (which treats `If-Match`/`If-None-Match` as read-scoped and can
31
+ * never linearize the log), the native API returns 412 on any precondition
32
+ * miss and the object `generation` in `x-goog-generation`. That generation
33
+ * is carried verbatim in the opaque `Storage` etag.
34
+ *
35
+ * Authentication is plugged in via `sign` (GOOG4-HMAC-SHA256); this class
36
+ * does no signing itself.
37
+ */
38
+ declare class GcsHttpStorage implements Storage {
39
+ #private;
40
+ constructor(options: GcsHttpStorageOptions);
41
+ get(key: string, opts?: StorageGetOptions): Promise<StorageGetResult | null>;
42
+ put(key: string, body: Uint8Array, opts?: StoragePutOptions): Promise<StoragePutResult>;
43
+ delete(key: string, opts?: {
44
+ signal?: AbortSignal;
45
+ }): Promise<void>;
46
+ list(prefix: string, opts?: {
47
+ startAfter?: string;
48
+ maxKeys?: number;
49
+ signal?: AbortSignal;
50
+ }): AsyncIterable<StorageListEntry>;
51
+ }
52
+ //#endregion
53
+ //#region packages/adapter-node/src/credentials/types.d.ts
54
+ /**
55
+ * Temporary or static AWS-shaped credentials. Field shape matches
56
+ * `@smithy/types`' `AwsCredentialIdentity` so callers can pass
57
+ * `@aws-sdk/credential-providers` output directly (e.g.
58
+ * `fromTokenFile()`) without an adapter.
59
+ *
60
+ * `expiration` is the absolute time at which `accessKeyId` /
61
+ * `secretAccessKey` / `sessionToken` stop being valid. When present,
62
+ * the signing layer re-resolves credentials some buffer before that
63
+ * time. When absent, credentials are treated as static.
64
+ */
65
+ type Credentials = {
66
+ readonly accessKeyId: string;
67
+ readonly secretAccessKey: string;
68
+ readonly sessionToken?: string;
69
+ readonly expiration?: Date;
70
+ };
71
+ /**
72
+ * Async credential resolver. Called by the signing layer on demand —
73
+ * once on first sign, then again when cached `expiration` is within
74
+ * the refresh buffer. Closure is the natural place to keep retry /
75
+ * fallback / fan-out logic; the signing layer only cares about the
76
+ * resolved shape.
77
+ *
78
+ * **Refresh is driven by `Credentials.expiration`.** If your provider
79
+ * returns no `expiration`, the signer will call this function
80
+ * **exactly once** for the lifetime of the storage handle and reuse
81
+ * those credentials forever. That's the right default for genuinely
82
+ * static creds (e.g. `process.env`), but it's a footgun if you're
83
+ * resolving rotating credentials and forgot to set `expiration` —
84
+ * the first 1 h works, then every request 403s with no retry. Set
85
+ * `expiration` on every refresh-eligible resolve.
86
+ *
87
+ * Implementations should be safe to call concurrently — the signing
88
+ * layer single-flights refresh, but tests and chained providers may
89
+ * call this in parallel.
90
+ */
91
+ type CredentialsProvider = () => Promise<Credentials>;
92
+ //#endregion
93
+ //#region packages/adapter-node/src/gcs-admin.d.ts
94
+ /**
95
+ * Result of {@link gcsVersioningStatus}. `inconclusive` carries a
96
+ * human-readable `reason` (an `HTTP <status>` string, or a thrown
97
+ * error's message) so a diagnostic caller can explain why the probe
98
+ * couldn't decide without re-deriving it.
99
+ */
100
+ type GcsVersioningStatus = {
101
+ readonly kind: "enabled";
102
+ } | {
103
+ readonly kind: "disabled";
104
+ } | {
105
+ readonly kind: "inconclusive";
106
+ readonly reason: string;
107
+ };
108
+ /**
109
+ * Read a GCS bucket's Object Versioning setting over the native XML API
110
+ * (`GET <endpoint>/<bucket>?versioning`), signed with GOOG4-HMAC-SHA256.
111
+ * Never throws — a non-2xx response or a network error resolves to
112
+ * `{ kind: "inconclusive", reason }`, so callers (e.g. `baerly doctor`)
113
+ * can degrade gracefully instead of aborting.
114
+ */
115
+ declare function gcsVersioningStatus(opts: {
116
+ bucket: string;
117
+ credentials: Credentials | CredentialsProvider; /** Defaults to the native GCS host. */
118
+ endpoint?: string; /** Injected in tests; defaults to global fetch. */
119
+ fetch?: typeof fetch;
120
+ }): Promise<GcsVersioningStatus>;
121
+ //#endregion
122
+ export { DEFAULT_GCS_ENDPOINT as a, CredentialsProvider as i, gcsVersioningStatus as n, GcsHttpStorage as o, Credentials as r, GcsHttpStorageOptions as s, GcsVersioningStatus as t };
123
+ //# sourceMappingURL=gcs-admin-Bx6xSNJj.d.ts.map
package/dist/gcs.d.ts ADDED
@@ -0,0 +1,18 @@
1
+ import { a as DEFAULT_GCS_ENDPOINT, i as CredentialsProvider, o as GcsHttpStorage, r as Credentials, s as GcsHttpStorageOptions, t as GcsVersioningStatus } from "./gcs-admin-Bx6xSNJj.js";
2
+
3
+ //#region packages/adapter-node/src/credentials/goog4-signer.d.ts
4
+ /**
5
+ * Inputs for {@link goog4Signer}. Named for parity with
6
+ * `SigV4SignerOptions` so both signer families read the same on the
7
+ * curated `/s3` + `/gcs` subpaths.
8
+ */
9
+ interface Goog4SignerOptions {
10
+ /** GCS HMAC interoperability credentials (static) or an async resolver. */
11
+ credentials: Credentials | CredentialsProvider;
12
+ /** Clock seam for deterministic tests; defaults to `Date.now`. */
13
+ now?: () => number;
14
+ }
15
+ declare function goog4Signer(opts: Goog4SignerOptions): (req: Request) => Promise<Request>;
16
+ //#endregion
17
+ export { DEFAULT_GCS_ENDPOINT, GcsHttpStorage, type GcsHttpStorageOptions, type GcsVersioningStatus, type Goog4SignerOptions, goog4Signer };
18
+ //# sourceMappingURL=gcs.d.ts.map
package/dist/gcs.js ADDED
@@ -0,0 +1,2 @@
1
+ import { n as DEFAULT_GCS_ENDPOINT, r as GcsHttpStorage, t as goog4Signer } from "./goog4-signer-Z7KnJ1su.js";
2
+ export { DEFAULT_GCS_ENDPOINT, GcsHttpStorage, goog4Signer };
@@ -0,0 +1,321 @@
1
+ import { g as RATE_LIMIT_BACKOFF_MILLIS } from "./constants-CfeMWQWk.js";
2
+ import { t as BaerlyError } from "./errors-Dfa3p78c.js";
3
+ import { t as sha256Hex } from "./sha256-CqcKTjw9.js";
4
+ import { t as assertValidStorageKey } from "./key-Di6yyxFu.js";
5
+ import { t as delay } from "./time-DUqvFMHq.js";
6
+ import { n as parseRetryAfter, o as parseListObjectsV2CommandOutput, r as retry, t as mapStorageError } from "./http-transport-BTgVCY5r.js";
7
+ //#region packages/adapter-node/src/gcs-http.ts
8
+ /** Default GCS native XML API endpoint. */
9
+ const DEFAULT_GCS_ENDPOINT = "https://storage.googleapis.com";
10
+ /**
11
+ * `Storage` impl that speaks the GCS native XML API and drives GCS's own
12
+ * `x-goog-if-generation-match` conditional writes. Unlike GCS's S3-interop
13
+ * endpoint (which treats `If-Match`/`If-None-Match` as read-scoped and can
14
+ * never linearize the log), the native API returns 412 on any precondition
15
+ * miss and the object `generation` in `x-goog-generation`. That generation
16
+ * is carried verbatim in the opaque `Storage` etag.
17
+ *
18
+ * Authentication is plugged in via `sign` (GOOG4-HMAC-SHA256); this class
19
+ * does no signing itself.
20
+ */
21
+ var GcsHttpStorage = class {
22
+ #endpoint;
23
+ #bucket;
24
+ #fetch;
25
+ #sign;
26
+ #retries;
27
+ #backoffMs;
28
+ constructor(options) {
29
+ this.#endpoint = (options.endpoint ?? "https://storage.googleapis.com").replace(/\/+$/, "");
30
+ this.#bucket = options.bucket;
31
+ this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);
32
+ this.#sign = options.sign;
33
+ this.#retries = options.retries ?? 8;
34
+ this.#backoffMs = options.backoffMs ?? 100;
35
+ }
36
+ #objectUrl(key, generation) {
37
+ assertValidStorageKey(key);
38
+ const base = `${this.#endpoint}/${this.#bucket}/${encodeURIComponent(key)}`;
39
+ return generation !== void 0 ? `${base}?generation=${encodeURIComponent(generation)}` : base;
40
+ }
41
+ async #dispatch(req) {
42
+ const signed = this.#sign ? await this.#sign(req) : req;
43
+ try {
44
+ return await this.#fetch(signed);
45
+ } catch (error) {
46
+ if (error instanceof BaerlyError) throw error;
47
+ throw new BaerlyError("NetworkError", error instanceof Error ? error.message : String(error), error);
48
+ }
49
+ }
50
+ #retry(fn) {
51
+ return retry(fn, {
52
+ retries: this.#retries,
53
+ backoffMs: this.#backoffMs
54
+ });
55
+ }
56
+ async get(key, opts) {
57
+ opts?.signal?.throwIfAborted();
58
+ const url = this.#objectUrl(key, opts?.versionId);
59
+ return this.#retry(async () => {
60
+ const res = await this.#dispatch(new Request(url, {
61
+ method: "GET",
62
+ signal: opts?.signal ?? null
63
+ }));
64
+ switch (res.status) {
65
+ case 200: {
66
+ const etag = res.headers.get("x-goog-generation");
67
+ if (etag === null) throw new BaerlyError("InvalidResponse", `GET ${key}: missing x-goog-generation`);
68
+ return {
69
+ body: new Uint8Array(await res.arrayBuffer()),
70
+ etag
71
+ };
72
+ }
73
+ case 304:
74
+ case 404: return null;
75
+ default: throw await mapStorageError(res, "GET", key);
76
+ }
77
+ });
78
+ }
79
+ async put(key, body, opts) {
80
+ opts?.signal?.throwIfAborted();
81
+ const url = this.#objectUrl(key);
82
+ const headers = new Headers();
83
+ headers.set("Content-Type", opts?.contentType ?? "application/octet-stream");
84
+ if (opts?.ifNoneMatch === "*") headers.set("x-goog-if-generation-match", "0");
85
+ else if (opts?.ifMatch !== void 0) headers.set("x-goog-if-generation-match", opts.ifMatch);
86
+ return this.#retry(async () => {
87
+ const res = await this.#dispatch(new Request(url, {
88
+ method: "PUT",
89
+ headers,
90
+ body,
91
+ signal: opts?.signal ?? null
92
+ }));
93
+ if (res.status === 412) throw new BaerlyError("Conflict", `PUT ${key}: precondition failed`);
94
+ if (res.status !== 200 && res.status !== 204) throw await mapStorageError(res, "PUT", key);
95
+ const etag = res.headers.get("x-goog-generation");
96
+ if (etag === null) throw new BaerlyError("InvalidResponse", `PUT ${key}: missing x-goog-generation`);
97
+ const dateStr = res.headers.get("Date");
98
+ const result = { etag };
99
+ if (dateStr !== null) result.serverDate = new Date(dateStr);
100
+ return result;
101
+ });
102
+ }
103
+ async delete(key, opts) {
104
+ opts?.signal?.throwIfAborted();
105
+ const url = this.#objectUrl(key);
106
+ await this.#retry(async () => {
107
+ const res = await this.#dispatch(new Request(url, {
108
+ method: "DELETE",
109
+ signal: opts?.signal ?? null
110
+ }));
111
+ if (res.status !== 200 && res.status !== 204 && res.status !== 404) throw await mapStorageError(res, "DELETE", key);
112
+ });
113
+ }
114
+ async *list(prefix, opts) {
115
+ opts?.signal?.throwIfAborted();
116
+ let yielded = 0;
117
+ let continuationToken;
118
+ const startAfter = opts?.startAfter ?? "";
119
+ while (true) {
120
+ opts?.signal?.throwIfAborted();
121
+ const params = new URLSearchParams();
122
+ params.set("list-type", "2");
123
+ params.set("prefix", prefix);
124
+ params.set("encoding-type", "url");
125
+ if (continuationToken !== void 0) params.set("continuation-token", continuationToken);
126
+ else if (startAfter !== "") params.set("start-after", startAfter);
127
+ if (opts?.maxKeys !== void 0) {
128
+ const remaining = opts.maxKeys - yielded;
129
+ params.set("max-keys", String(Math.min(remaining, 1e3)));
130
+ }
131
+ const url = `${this.#endpoint}/${this.#bucket}/?${params.toString()}`;
132
+ let parsed;
133
+ let lastHint;
134
+ for (let attempt = 0; attempt < 10; attempt++) {
135
+ const outcome = await this.#retry(async () => {
136
+ const res = await this.#dispatch(new Request(url, {
137
+ method: "GET",
138
+ signal: opts?.signal ?? null
139
+ }));
140
+ if (res.status === 200) return {
141
+ kind: "ok",
142
+ body: await res.text()
143
+ };
144
+ if (res.status === 429) return {
145
+ kind: "ratelimited",
146
+ retryAfterSeconds: parseRetryAfter(res.headers.get("Retry-After"))
147
+ };
148
+ throw await mapStorageError(res, "LIST", prefix);
149
+ });
150
+ if (outcome.kind === "ok") {
151
+ parsed = parseListObjectsV2CommandOutput(outcome.body);
152
+ break;
153
+ }
154
+ lastHint = outcome.retryAfterSeconds;
155
+ const hintMs = outcome.retryAfterSeconds !== void 0 ? outcome.retryAfterSeconds * 1e3 : 0;
156
+ await delay(Math.max(hintMs, RATE_LIMIT_BACKOFF_MILLIS));
157
+ }
158
+ if (parsed === void 0) throw new BaerlyError("NetworkError", `LIST ${prefix}: rate-limited`, {
159
+ status: 429,
160
+ ...lastHint !== void 0 ? { retryAfterSeconds: lastHint } : {}
161
+ });
162
+ for (const entry of parsed.Contents ?? []) {
163
+ if (entry.Key === void 0) continue;
164
+ yield {
165
+ key: entry.Key,
166
+ etag: entry.Generation ?? "",
167
+ ...entry.LastModified !== void 0 && { lastModified: entry.LastModified }
168
+ };
169
+ yielded += 1;
170
+ if (opts?.maxKeys !== void 0 && yielded >= opts.maxKeys) return;
171
+ }
172
+ continuationToken = parsed.NextContinuationToken;
173
+ if (continuationToken === void 0 || continuationToken === "") return;
174
+ }
175
+ }
176
+ };
177
+ //#endregion
178
+ //#region packages/adapter-node/src/credentials/goog4-signer.ts
179
+ /** GOOG4 signing-key prefix (vs AWS SigV4's "AWS4"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */
180
+ const GOOG4_KEY_PREFIX = "GOOG4";
181
+ /** Credential-scope terminator (vs SigV4's "aws4_request"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */
182
+ const GOOG4_REQUEST = "goog4_request";
183
+ /** Signing algorithm string. @see https://docs.cloud.google.com/storage/docs/authentication/signatures */
184
+ const GOOG4_ALGORITHM = "GOOG4-HMAC-SHA256";
185
+ /** GCS storage service name in the credential scope (vs SigV4's "s3"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */
186
+ const GOOG4_SERVICE = "storage";
187
+ /** GCS accepts "auto" as the signing region. @see https://docs.cloud.google.com/storage/docs/authentication/signatures */
188
+ const GOOG4_REGION = "auto";
189
+ const encoder = new TextEncoder();
190
+ function toHex(bytes) {
191
+ let hex = "";
192
+ for (let i = 0; i < bytes.length; i++) hex += bytes[i].toString(16).padStart(2, "0");
193
+ return hex;
194
+ }
195
+ /** RFC-3986-strict percent-encoding for canonical query components: encodes
196
+ * everything except the unreserved set A-Za-z0-9-._~. encodeURIComponent
197
+ * already handles that set but leaves !'()* unescaped, so escape those too.
198
+ * @see https://docs.cloud.google.com/storage/docs/authentication/canonical-requests */
199
+ function uriEncode(s) {
200
+ return encodeURIComponent(s).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
201
+ }
202
+ /** Canonical-URI encoding for the request path. `URL.pathname` already
203
+ * percent-encodes spaces / non-ASCII / control chars (and `^` `` ` `` `{` `}`),
204
+ * but leaves GCS's enumerated reserved set raw — the sub-delims, `:@`, and
205
+ * `[]`. GCS canonicalizes the path it receives by percent-encoding exactly
206
+ * that set (`?=!#$&'()*+,:;@[]"`; `?#"` can't survive in `pathname`), so we
207
+ * must reproduce the same delta or a `[`/`]`-bearing key signs differently
208
+ * than GCS computes it (403 SignatureDoesNotMatch). Target only the delta so
209
+ * already-encoded `%XX` and the unreserved set stay intact (no double-encode).
210
+ * This is a denylist, not an allow-list, on purpose: over-encoding chars GCS
211
+ * leaves raw (`|` `` ` `` `{}` …) would itself cause a mismatch.
212
+ * @see https://docs.cloud.google.com/storage/docs/authentication/canonical-requests */
213
+ function canonicalUri(pathname) {
214
+ return pathname.replace(/[!$&'()*+,;=:@[\]]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
215
+ }
216
+ async function hmac(key, data) {
217
+ const view = new Uint8Array(key.byteLength);
218
+ view.set(key);
219
+ const cryptoKey = await crypto.subtle.importKey("raw", view, {
220
+ name: "HMAC",
221
+ hash: "SHA-256"
222
+ }, false, ["sign"]);
223
+ const sig = await crypto.subtle.sign("HMAC", cryptoKey, encoder.encode(data));
224
+ return new Uint8Array(sig);
225
+ }
226
+ /** Pure: build the GOOG4 canonical request string. Exported for the intermediates test. */
227
+ function goog4CanonicalRequest(input) {
228
+ const u = new URL(input.url);
229
+ const normalized = {};
230
+ for (const [name, value] of Object.entries(input.signedHeaders)) normalized[name.toLowerCase()] = value;
231
+ const names = Object.keys(normalized).toSorted();
232
+ const canonicalHeaders = names.map((n) => `${n}:${normalized[n].trim()}\n`).join("");
233
+ const signedHeaderList = names.join(";");
234
+ const query = [...u.searchParams].map(([k, v]) => [uriEncode(k), uriEncode(v)]).toSorted((a, b) => {
235
+ const ka = `${a[0]}\0${a[1]}`;
236
+ const kb = `${b[0]}\0${b[1]}`;
237
+ if (ka < kb) return -1;
238
+ return ka > kb ? 1 : 0;
239
+ }).map(([k, v]) => `${k}=${v}`).join("&");
240
+ return [
241
+ input.method,
242
+ canonicalUri(u.pathname),
243
+ query,
244
+ canonicalHeaders,
245
+ signedHeaderList,
246
+ input.hashedPayload
247
+ ].join("\n");
248
+ }
249
+ /** Pure: build the SigV4-family string-to-sign. Async because it hashes the canonical request. */
250
+ async function goog4StringToSign(input) {
251
+ const hash = await sha256Hex(encoder.encode(input.canonicalRequest));
252
+ return [
253
+ input.algorithm,
254
+ input.amzDate,
255
+ input.scope,
256
+ hash
257
+ ].join("\n");
258
+ }
259
+ /**
260
+ * The SigV4-family signing machinery: four-stage HMAC key chain + final HMAC.
261
+ * Identical between GOOG4 and AWS SigV4 modulo the {keyPrefix, terminator,
262
+ * service, region} constants — which is exactly what the AWS-vector oracle
263
+ * exploits to prove this in CI. Exported for oracle 1.
264
+ */
265
+ async function sigV4Signature(input) {
266
+ return toHex(await hmac(await hmac(await hmac(await hmac(await hmac(encoder.encode(input.keyPrefix + input.secretAccessKey), input.yyyymmdd), input.region), input.service), input.terminator), input.stringToSign));
267
+ }
268
+ function amzDateFrom(ms) {
269
+ const amzDate = new Date(ms).toISOString().replace(/[:-]/g, "").replace(/\.\d{3}Z$/, "Z");
270
+ return {
271
+ amzDate,
272
+ yyyymmdd: amzDate.slice(0, 8)
273
+ };
274
+ }
275
+ function goog4Signer(opts) {
276
+ const now = opts.now ?? (() => Date.now());
277
+ const resolve = async () => typeof opts.credentials === "function" ? opts.credentials() : opts.credentials;
278
+ return async (req) => {
279
+ const creds = await resolve();
280
+ const { amzDate, yyyymmdd } = amzDateFrom(now());
281
+ const scope = `${yyyymmdd}/${GOOG4_REGION}/${GOOG4_SERVICE}/${GOOG4_REQUEST}`;
282
+ const payloadHash = await sha256Hex(new Uint8Array(await req.clone().arrayBuffer()));
283
+ const url = new URL(req.url);
284
+ const headers = new Headers(req.headers);
285
+ headers.set("host", url.host);
286
+ headers.set("x-goog-date", amzDate);
287
+ headers.set("x-goog-content-sha256", payloadHash);
288
+ const signedHeaders = {};
289
+ for (const [name, value] of headers) {
290
+ const lower = name.toLowerCase();
291
+ if (lower === "host" || lower === "content-type" || lower.startsWith("x-goog-")) signedHeaders[lower] = value;
292
+ }
293
+ const stringToSign = await goog4StringToSign({
294
+ algorithm: GOOG4_ALGORITHM,
295
+ amzDate,
296
+ scope,
297
+ canonicalRequest: goog4CanonicalRequest({
298
+ method: req.method,
299
+ url: req.url,
300
+ signedHeaders,
301
+ hashedPayload: payloadHash
302
+ })
303
+ });
304
+ const signature = await sigV4Signature({
305
+ keyPrefix: GOOG4_KEY_PREFIX,
306
+ terminator: GOOG4_REQUEST,
307
+ service: GOOG4_SERVICE,
308
+ region: GOOG4_REGION,
309
+ secretAccessKey: creds.secretAccessKey,
310
+ yyyymmdd,
311
+ stringToSign
312
+ });
313
+ const signedHeaderList = Object.keys(signedHeaders).map((n) => n.toLowerCase()).toSorted().join(";");
314
+ headers.set("Authorization", `${GOOG4_ALGORITHM} Credential=${creds.accessKeyId}/${scope}, SignedHeaders=${signedHeaderList}, Signature=${signature}`);
315
+ return new Request(req, { headers });
316
+ };
317
+ }
318
+ //#endregion
319
+ export { DEFAULT_GCS_ENDPOINT as n, GcsHttpStorage as r, goog4Signer as t };
320
+
321
+ //# sourceMappingURL=goog4-signer-Z7KnJ1su.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"goog4-signer-Z7KnJ1su.js","names":["#endpoint","#bucket","#fetch","#sign","#retries","#backoffMs","#dispatch","#objectUrl","#retry"],"sources":["../packages/adapter-node/src/gcs-http.ts","../packages/adapter-node/src/credentials/goog4-signer.ts"],"sourcesContent":["import {\n BaerlyError,\n LIST_OBJECT_MAX_RETRIES,\n RATE_LIMIT_BACKOFF_MILLIS,\n S3_REQUEST_MAX_RETRIES,\n assertValidStorageKey,\n delay,\n type Storage,\n type StorageGetOptions,\n type StorageGetResult,\n type StorageListEntry,\n type StoragePutOptions,\n type StoragePutResult,\n} from \"@baerly/protocol\";\nimport { mapStorageError, parseRetryAfter, retry } from \"./http-transport.ts\";\nimport { parseListObjectsV2CommandOutput } from \"./xml.ts\";\n\n/** Default GCS native XML API endpoint. */\nexport const DEFAULT_GCS_ENDPOINT = \"https://storage.googleapis.com\";\n\n/**\n * Construction-time options for {@link GcsHttpStorage}. Everything is\n * optional except `bucket`; `endpoint` defaults to the GCS native XML\n * API host. `sign` is injected — `gcsStorage` wires in the\n * GOOG4-HMAC-SHA256 signer ({@link goog4Signer}); unit tests pass a\n * passthrough.\n */\nexport interface GcsHttpStorageOptions {\n /** GCS endpoint. Defaults to `https://storage.googleapis.com`. */\n endpoint?: string;\n /** GCS bucket name. */\n bucket: string;\n /** `fetch` implementation. Defaults to `globalThis.fetch.bind(globalThis)`. */\n fetch?: typeof fetch;\n /** Signs requests before send. GOOG4-HMAC-SHA256 in production. */\n sign?: (req: Request) => Promise<Request>;\n /** Max retries for transient (non-permanent) failures. */\n retries?: number;\n /** Initial backoff in ms. */\n backoffMs?: number;\n}\n\n/**\n * `Storage` impl that speaks the GCS native XML API and drives GCS's own\n * `x-goog-if-generation-match` conditional writes. Unlike GCS's S3-interop\n * endpoint (which treats `If-Match`/`If-None-Match` as read-scoped and can\n * never linearize the log), the native API returns 412 on any precondition\n * miss and the object `generation` in `x-goog-generation`. That generation\n * is carried verbatim in the opaque `Storage` etag.\n *\n * Authentication is plugged in via `sign` (GOOG4-HMAC-SHA256); this class\n * does no signing itself.\n */\nexport class GcsHttpStorage implements Storage {\n readonly #endpoint: string;\n readonly #bucket: string;\n readonly #fetch: typeof fetch;\n readonly #sign?: (req: Request) => Promise<Request>;\n readonly #retries: number;\n readonly #backoffMs: number;\n\n constructor(options: GcsHttpStorageOptions) {\n this.#endpoint = (options.endpoint ?? DEFAULT_GCS_ENDPOINT).replace(/\\/+$/, \"\");\n this.#bucket = options.bucket;\n this.#fetch = options.fetch ?? globalThis.fetch.bind(globalThis);\n this.#sign = options.sign;\n this.#retries = options.retries ?? S3_REQUEST_MAX_RETRIES;\n this.#backoffMs = options.backoffMs ?? 100;\n }\n\n #objectUrl(key: string, generation?: string): string {\n // Choke point for every key-addressing verb — reject unaddressable\n // `.`/`..`/empty keys before URL normalization turns them into a\n // bucket-root 403. @see storage-compatibility.md \"Key namespace\".\n assertValidStorageKey(key);\n const base = `${this.#endpoint}/${this.#bucket}/${encodeURIComponent(key)}`;\n // GCS's native equivalent of S3 ?versionId= is ?generation=. Not\n // exercised by the kernel (which never pins a historical version),\n // but threaded for parity with the Storage interface.\n return generation !== undefined ? `${base}?generation=${encodeURIComponent(generation)}` : base;\n }\n\n async #dispatch(req: Request): Promise<Response> {\n const signed = this.#sign ? await this.#sign(req) : req;\n try {\n return await this.#fetch(signed);\n } catch (error) {\n if (error instanceof BaerlyError) {\n throw error;\n }\n const msg = error instanceof Error ? error.message : String(error);\n throw new BaerlyError(\"NetworkError\", msg, error);\n }\n }\n\n #retry<T>(fn: () => Promise<T>): Promise<T> {\n return retry(fn, { retries: this.#retries, backoffMs: this.#backoffMs });\n }\n\n async get(key: string, opts?: StorageGetOptions): Promise<StorageGetResult | null> {\n opts?.signal?.throwIfAborted();\n const url = this.#objectUrl(key, opts?.versionId);\n // DELTA 4: no conditional read. GCS's native XML API has no\n // generation-based conditional GET. `x-goog-if-generation-{match,\n // not-match}` ARE honored against the `generation` this adapter carries\n // as the opaque etag — but only as write-style CAS preconditions that\n // 412 on failure, never as a 304-when-unchanged read. Empirically\n // confirmed on a real bucket under GOOG4 signing:\n // `if-generation-match: <stale>` → 412, and\n // `if-generation-not-match: <live-gen>` → 200 with the full body (not\n // 304); no header combination yields a conditional-read 304.\n // `opts.ifNoneMatch` is therefore intentionally ignored; the conformance\n // suite opts GCS out via `supportsConditionalGet: false`. Safe for\n // baerly: the kernel never issues a conditional read — every\n // `ifNoneMatch` it sends is `put(…, { ifNoneMatch: \"*\" })`\n // create-if-absent.\n return this.#retry(async () => {\n const res = await this.#dispatch(\n new Request(url, { method: \"GET\", signal: opts?.signal ?? null }),\n );\n switch (res.status) {\n case 200: {\n // DELTA 2: version token is x-goog-generation. No ETag fallback —\n // GCS's ETag is a quoted-MD5, not a generation; a fallback value\n // would poison the next x-goog-if-generation-match CAS. Fail loud\n // if absent (it is present on every GCS PUT/GET).\n const etag = res.headers.get(\"x-goog-generation\");\n if (etag === null) {\n throw new BaerlyError(\"InvalidResponse\", `GET ${key}: missing x-goog-generation`);\n }\n const body = new Uint8Array(await res.arrayBuffer());\n return { body, etag };\n }\n case 304:\n case 404: {\n return null;\n }\n default: {\n throw await mapStorageError(res, \"GET\", key);\n }\n }\n });\n }\n\n async put(key: string, body: Uint8Array, opts?: StoragePutOptions): Promise<StoragePutResult> {\n opts?.signal?.throwIfAborted();\n const url = this.#objectUrl(key);\n const headers = new Headers();\n headers.set(\"Content-Type\", opts?.contentType ?? \"application/octet-stream\");\n // DELTA 1: native generation precondition, not S3 If-Match/If-None-Match.\n // ifNoneMatch:\"*\" => create-if-absent (:0); ifMatch => CAS (:<generation>).\n if (opts?.ifNoneMatch === \"*\") {\n headers.set(\"x-goog-if-generation-match\", \"0\");\n } else if (opts?.ifMatch !== undefined) {\n headers.set(\"x-goog-if-generation-match\", opts.ifMatch);\n }\n return this.#retry(async () => {\n const res = await this.#dispatch(\n new Request(url, {\n method: \"PUT\",\n headers,\n // TS lib.dom narrows BodyInit; the runtime accepts Uint8Array.\n body: body as BodyInit,\n signal: opts?.signal ?? null,\n }),\n );\n // DELTA 3: 412 is the ONLY precondition-failure status on GCS, for\n // BOTH create-collision and stale-CAS. No S3-style 409-contended\n // branch, no 404-with-ifMatch branch.\n if (res.status === 412) {\n throw new BaerlyError(\"Conflict\", `PUT ${key}: precondition failed`);\n }\n if (res.status !== 200 && res.status !== 204) {\n throw await mapStorageError(res, \"PUT\", key);\n }\n // DELTA 2: version token is x-goog-generation, returned as etag. No\n // ETag fallback — GCS's ETag is a quoted-MD5, not a generation; a\n // fallback value would poison the next x-goog-if-generation-match CAS.\n // Fail loud if absent (it is present on every GCS PUT/GET).\n const etag = res.headers.get(\"x-goog-generation\");\n if (etag === null) {\n throw new BaerlyError(\"InvalidResponse\", `PUT ${key}: missing x-goog-generation`);\n }\n const dateStr = res.headers.get(\"Date\");\n const result: { etag: string; serverDate?: Date } = { etag };\n if (dateStr !== null) {\n result.serverDate = new Date(dateStr);\n }\n return result;\n });\n }\n\n async delete(key: string, opts?: { signal?: AbortSignal }): Promise<void> {\n opts?.signal?.throwIfAborted();\n const url = this.#objectUrl(key);\n await this.#retry(async () => {\n const res = await this.#dispatch(\n new Request(url, { method: \"DELETE\", signal: opts?.signal ?? null }),\n );\n // 200 / 204 / 404 → success (idempotent); any other status is a real\n // failure (403 → AccessDenied, 429/≥500 → retryable NetworkError, else\n // InvalidResponse) rather than a silently-swallowed non-2xx.\n if (res.status !== 200 && res.status !== 204 && res.status !== 404) {\n throw await mapStorageError(res, \"DELETE\", key);\n }\n });\n }\n\n async *list(\n prefix: string,\n opts?: { startAfter?: string; maxKeys?: number; signal?: AbortSignal },\n ): AsyncIterable<StorageListEntry> {\n opts?.signal?.throwIfAborted();\n let yielded = 0;\n let continuationToken: string | undefined;\n const startAfter = opts?.startAfter ?? \"\";\n while (true) {\n opts?.signal?.throwIfAborted();\n const params = new URLSearchParams();\n params.set(\"list-type\", \"2\");\n params.set(\"prefix\", prefix);\n params.set(\"encoding-type\", \"url\");\n if (continuationToken !== undefined) {\n params.set(\"continuation-token\", continuationToken);\n } else if (startAfter !== \"\") {\n params.set(\"start-after\", startAfter);\n }\n if (opts?.maxKeys !== undefined) {\n const remaining = opts.maxKeys - yielded;\n params.set(\"max-keys\", String(Math.min(remaining, 1000)));\n }\n const url = `${this.#endpoint}/${this.#bucket}/?${params.toString()}`;\n\n let parsed: Awaited<ReturnType<typeof parseListObjectsV2CommandOutput>> | undefined;\n let lastHint: number | undefined;\n for (let attempt = 0; attempt < LIST_OBJECT_MAX_RETRIES; attempt++) {\n const outcome = await this.#retry(async () => {\n const res = await this.#dispatch(\n new Request(url, { method: \"GET\", signal: opts?.signal ?? null }),\n );\n if (res.status === 200) {\n return { kind: \"ok\" as const, body: await res.text() };\n }\n if (res.status === 429) {\n return {\n kind: \"ratelimited\" as const,\n retryAfterSeconds: parseRetryAfter(res.headers.get(\"Retry-After\")),\n };\n }\n throw await mapStorageError(res, \"LIST\", prefix);\n });\n if (outcome.kind === \"ok\") {\n parsed = parseListObjectsV2CommandOutput(outcome.body);\n break;\n }\n lastHint = outcome.retryAfterSeconds;\n const hintMs =\n outcome.retryAfterSeconds !== undefined ? outcome.retryAfterSeconds * 1000 : 0;\n await delay(Math.max(hintMs, RATE_LIMIT_BACKOFF_MILLIS));\n }\n if (parsed === undefined) {\n throw new BaerlyError(\"NetworkError\", `LIST ${prefix}: rate-limited`, {\n status: 429,\n ...(lastHint !== undefined ? { retryAfterSeconds: lastHint } : {}),\n });\n }\n\n for (const entry of parsed.Contents ?? []) {\n if (entry.Key === undefined) {\n continue;\n }\n yield {\n // The version token is the generation, not the MD5 `<ETag>`, so the\n // list etag matches what get/put return for the same object (the\n // universal list-etag == version-token contract). GCS emits\n // `<Generation>` for every object; the `?? \"\"` is a defensive floor\n // for a malformed row and, like every list etag, is CAS-unused.\n key: entry.Key,\n etag: entry.Generation ?? \"\",\n ...(entry.LastModified !== undefined && { lastModified: entry.LastModified }),\n };\n yielded += 1;\n if (opts?.maxKeys !== undefined && yielded >= opts.maxKeys) {\n return;\n }\n }\n continuationToken = parsed.NextContinuationToken;\n if (continuationToken === undefined || continuationToken === \"\") {\n return;\n }\n }\n }\n}\n","import { sha256Hex } from \"@baerly/protocol\";\nimport type { Credentials, CredentialsProvider } from \"./types.ts\";\n\n/** GOOG4 signing-key prefix (vs AWS SigV4's \"AWS4\"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */\nconst GOOG4_KEY_PREFIX = \"GOOG4\";\n/** Credential-scope terminator (vs SigV4's \"aws4_request\"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */\nconst GOOG4_REQUEST = \"goog4_request\";\n/** Signing algorithm string. @see https://docs.cloud.google.com/storage/docs/authentication/signatures */\nconst GOOG4_ALGORITHM = \"GOOG4-HMAC-SHA256\";\n/** GCS storage service name in the credential scope (vs SigV4's \"s3\"). @see https://docs.cloud.google.com/storage/docs/authentication/signatures */\nconst GOOG4_SERVICE = \"storage\";\n/** GCS accepts \"auto\" as the signing region. @see https://docs.cloud.google.com/storage/docs/authentication/signatures */\nconst GOOG4_REGION = \"auto\";\n\nconst encoder = new TextEncoder();\n\n// SHA-256 hex comes from `@baerly/protocol` (shared with snapshotHash /\n// versionFromContent). `toHex` stays local: `sigV4Signature` still needs to\n// hex-encode raw HMAC output, which is not a SHA-256 digest.\nfunction toHex(bytes: Uint8Array): string {\n let hex = \"\";\n for (let i = 0; i < bytes.length; i++) {\n hex += bytes[i]!.toString(16).padStart(2, \"0\");\n }\n return hex;\n}\n\n/** RFC-3986-strict percent-encoding for canonical query components: encodes\n * everything except the unreserved set A-Za-z0-9-._~. encodeURIComponent\n * already handles that set but leaves !'()* unescaped, so escape those too.\n * @see https://docs.cloud.google.com/storage/docs/authentication/canonical-requests */\nfunction uriEncode(s: string): string {\n return encodeURIComponent(s).replace(\n /[!'()*]/g,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n}\n\n/** Canonical-URI encoding for the request path. `URL.pathname` already\n * percent-encodes spaces / non-ASCII / control chars (and `^` `` ` `` `{` `}`),\n * but leaves GCS's enumerated reserved set raw — the sub-delims, `:@`, and\n * `[]`. GCS canonicalizes the path it receives by percent-encoding exactly\n * that set (`?=!#$&'()*+,:;@[]\"`; `?#\"` can't survive in `pathname`), so we\n * must reproduce the same delta or a `[`/`]`-bearing key signs differently\n * than GCS computes it (403 SignatureDoesNotMatch). Target only the delta so\n * already-encoded `%XX` and the unreserved set stay intact (no double-encode).\n * This is a denylist, not an allow-list, on purpose: over-encoding chars GCS\n * leaves raw (`|` `` ` `` `{}` …) would itself cause a mismatch.\n * @see https://docs.cloud.google.com/storage/docs/authentication/canonical-requests */\nfunction canonicalUri(pathname: string): string {\n return pathname.replace(\n /[!$&'()*+,;=:@[\\]]/g,\n (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`,\n );\n}\n\nasync function hmac(key: Uint8Array, data: string): Promise<Uint8Array> {\n const view = new Uint8Array(key.byteLength);\n view.set(key);\n const cryptoKey = await crypto.subtle.importKey(\n \"raw\",\n view,\n { name: \"HMAC\", hash: \"SHA-256\" },\n false,\n [\"sign\"],\n );\n const sig = await crypto.subtle.sign(\"HMAC\", cryptoKey, encoder.encode(data));\n return new Uint8Array(sig);\n}\n\n/** Pure: build the GOOG4 canonical request string. Exported for the intermediates test. */\nexport function goog4CanonicalRequest(input: {\n method: string;\n url: string;\n signedHeaders: Record<string, string>;\n hashedPayload: string;\n}): string {\n const u = new URL(input.url);\n // Normalize to lowercase keys once, so the sort order and the value lookup\n // agree even if a caller passes mixed-case header names (`{ Host: ... }`).\n // The internal caller already lowercases via `Headers` iteration, but this\n // function is also exported for the intermediates test — normalizing here\n // makes the lowercase-key invariant guaranteed rather than assumed.\n const normalized: Record<string, string> = {};\n for (const [name, value] of Object.entries(input.signedHeaders)) {\n normalized[name.toLowerCase()] = value;\n }\n const names = Object.keys(normalized).toSorted();\n const canonicalHeaders = names.map((n) => `${n}:${normalized[n]!.trim()}\\n`).join(\"\");\n const signedHeaderList = names.join(\";\");\n // Sort by encoded key then encoded value; a \"key\\0value\" join makes the pair\n // orderable with a single string comparison (avoids a nested ternary).\n const query = [...u.searchParams]\n .map(([k, v]) => [uriEncode(k), uriEncode(v)] as const)\n .toSorted((a, b) => {\n const ka = `${a[0]}\\0${a[1]}`;\n const kb = `${b[0]}\\0${b[1]}`;\n if (ka < kb) {\n return -1;\n }\n return ka > kb ? 1 : 0;\n })\n .map(([k, v]) => `${k}=${v}`)\n .join(\"&\");\n return [\n input.method,\n canonicalUri(u.pathname), // percent-encoded by URL, plus sub-delims/:@ per GOOG4\n query,\n canonicalHeaders, // trailing \\n included per entry; joined below with \\n\n signedHeaderList,\n input.hashedPayload,\n ].join(\"\\n\");\n}\n\n/** Pure: build the SigV4-family string-to-sign. Async because it hashes the canonical request. */\nexport async function goog4StringToSign(input: {\n algorithm: string;\n amzDate: string;\n scope: string;\n canonicalRequest: string;\n}): Promise<string> {\n const hash = await sha256Hex(encoder.encode(input.canonicalRequest));\n return [input.algorithm, input.amzDate, input.scope, hash].join(\"\\n\");\n}\n\n/**\n * The SigV4-family signing machinery: four-stage HMAC key chain + final HMAC.\n * Identical between GOOG4 and AWS SigV4 modulo the {keyPrefix, terminator,\n * service, region} constants — which is exactly what the AWS-vector oracle\n * exploits to prove this in CI. Exported for oracle 1.\n */\nexport async function sigV4Signature(input: {\n keyPrefix: string;\n terminator: string;\n service: string;\n region: string;\n secretAccessKey: string;\n yyyymmdd: string;\n stringToSign: string;\n}): Promise<string> {\n const dateKey = await hmac(\n encoder.encode(input.keyPrefix + input.secretAccessKey),\n input.yyyymmdd,\n );\n const dateRegionKey = await hmac(dateKey, input.region);\n const dateSvcKey = await hmac(dateRegionKey, input.service);\n const signingKey = await hmac(dateSvcKey, input.terminator);\n return toHex(await hmac(signingKey, input.stringToSign));\n}\n\nfunction amzDateFrom(ms: number): { amzDate: string; yyyymmdd: string } {\n const iso = new Date(ms).toISOString(); // 2025-01-01T00:00:00.000Z\n const amzDate = iso.replace(/[:-]/g, \"\").replace(/\\.\\d{3}Z$/, \"Z\"); // 20250101T000000Z\n return { amzDate, yyyymmdd: amzDate.slice(0, 8) };\n}\n\n/**\n * Inputs for {@link goog4Signer}. Named for parity with\n * `SigV4SignerOptions` so both signer families read the same on the\n * curated `/s3` + `/gcs` subpaths.\n */\nexport interface Goog4SignerOptions {\n /** GCS HMAC interoperability credentials (static) or an async resolver. */\n credentials: Credentials | CredentialsProvider;\n /** Clock seam for deterministic tests; defaults to `Date.now`. */\n now?: () => number;\n}\n\nexport function goog4Signer(opts: Goog4SignerOptions): (req: Request) => Promise<Request> {\n const now = opts.now ?? (() => Date.now());\n const resolve = async (): Promise<Credentials> =>\n typeof opts.credentials === \"function\" ? opts.credentials() : opts.credentials;\n\n return async (req) => {\n const creds = await resolve();\n const { amzDate, yyyymmdd } = amzDateFrom(now());\n const scope = `${yyyymmdd}/${GOOG4_REGION}/${GOOG4_SERVICE}/${GOOG4_REQUEST}`;\n\n const body = new Uint8Array(await req.clone().arrayBuffer());\n // `body` already owns a fresh ArrayBuffer, so `sha256Hex`'s defensive copy\n // is redundant for this caller — but the shared helper keeps it for callers\n // whose Uint8Array may be a view over a larger buffer (TS#61375). Not worth\n // special-casing the shared helper; correctness over one avoided copy.\n const payloadHash = await sha256Hex(body);\n\n const url = new URL(req.url);\n const headers = new Headers(req.headers);\n headers.set(\"host\", url.host);\n headers.set(\"x-goog-date\", amzDate);\n headers.set(\"x-goog-content-sha256\", payloadHash);\n // No session-token header: GCS HMAC interoperability keys are long-lived\n // (access-ID + secret) with no STS-style temporary-credential concept, and\n // GCS documents no header analogous to AWS's x-amz-security-token. A\n // `sessionToken` on the shared Credentials shape (set by the AWS providers)\n // is therefore intentionally ignored here rather than signed into a\n // fabricated x-goog-security-token header.\n // @see https://docs.cloud.google.com/storage/docs/authentication/signatures\n\n // SignedHeaders MUST be computed dynamically from the request — this is the\n // load-bearing correctness point. GCS rejects (403 SignatureDoesNotMatch)\n // any x-goog-* header on the wire that is absent from SignedHeaders, and the\n // transport (Task 1.1) sets x-goog-if-generation-match BEFORE calling sign().\n // A fixed list would leave the precondition header unsigned → every\n // conditional write (the whole commit path) fails, while a bodyless GET\n // still passes — so this bug hides from any smoke test that does not\n // exercise a conditional PUT. Scan the actual request headers instead.\n const signedHeaders: Record<string, string> = {};\n for (const [name, value] of headers) {\n const lower = name.toLowerCase();\n if (lower === \"host\" || lower === \"content-type\" || lower.startsWith(\"x-goog-\")) {\n signedHeaders[lower] = value;\n }\n }\n\n const canonical = goog4CanonicalRequest({\n method: req.method,\n url: req.url,\n signedHeaders,\n hashedPayload: payloadHash,\n });\n const stringToSign = await goog4StringToSign({\n algorithm: GOOG4_ALGORITHM,\n amzDate,\n scope,\n canonicalRequest: canonical,\n });\n const signature = await sigV4Signature({\n keyPrefix: GOOG4_KEY_PREFIX,\n terminator: GOOG4_REQUEST,\n service: GOOG4_SERVICE,\n region: GOOG4_REGION,\n secretAccessKey: creds.secretAccessKey,\n yyyymmdd,\n stringToSign,\n });\n\n const signedHeaderList = Object.keys(signedHeaders)\n .map((n) => n.toLowerCase())\n .toSorted()\n .join(\";\");\n headers.set(\n \"Authorization\",\n `${GOOG4_ALGORITHM} Credential=${creds.accessKeyId}/${scope}, ` +\n `SignedHeaders=${signedHeaderList}, Signature=${signature}`,\n );\n return new Request(req, { headers });\n };\n}\n"],"mappings":"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"}