@gusto/baerly-storage 0.2.0 → 0.4.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 (155) hide show
  1. package/LICENSE +202 -0
  2. package/NOTICE +29 -0
  3. package/README.md +176 -70
  4. package/dist/API.md +213 -139
  5. package/dist/CHANGELOG.md +434 -0
  6. package/dist/RECIPES.md +125 -0
  7. package/dist/THIRD-PARTY-LICENSES.txt +238 -0
  8. package/dist/{app-config-C0Bbw_Z6.d.ts → app-config-DyiFK3_k.d.ts} +55 -11
  9. package/dist/app-config.d.ts +1 -1
  10. package/dist/auth.d.ts +1 -1
  11. package/dist/auth.js +301 -301
  12. package/dist/auth.js.map +1 -1
  13. package/dist/aws4fetch.esm-p7eEzLCs.js +1702 -0
  14. package/dist/aws4fetch.esm-p7eEzLCs.js.map +1 -0
  15. package/dist/baerly.js +35 -15
  16. package/dist/baerly.js.map +1 -1
  17. package/dist/baerly.spec.json +342 -0
  18. package/dist/bytes-BXdamO3L.js.map +1 -1
  19. package/dist/{client-DYZfoZb9.d.ts → client-Fe8CwB73.d.ts} +10 -10
  20. package/dist/client-react.d.ts +3 -3
  21. package/dist/client-react.js +4 -4
  22. package/dist/client-react.js.map +1 -1
  23. package/dist/client.d.ts +4 -4
  24. package/dist/client.js +3 -3
  25. package/dist/client.js.map +1 -1
  26. package/dist/{cloudflare-CINJPKCW.js → cloudflare-DzKBrUlg.js} +178 -2
  27. package/dist/cloudflare-DzKBrUlg.js.map +1 -0
  28. package/dist/cloudflare.d.ts +49 -6
  29. package/dist/cloudflare.js +59 -26
  30. package/dist/cloudflare.js.map +1 -1
  31. package/dist/config-1tv0-Yzm.js +2693 -0
  32. package/dist/config-1tv0-Yzm.js.map +1 -0
  33. package/dist/constants-CfeMWQWk.js +222 -0
  34. package/dist/constants-CfeMWQWk.js.map +1 -0
  35. package/dist/context-DRZ3tZ5l.js.map +1 -1
  36. package/dist/{cost-CQt1YRkA.js → cost-DSMIVqzL.js} +43 -42
  37. package/dist/cost-DSMIVqzL.js.map +1 -0
  38. package/dist/current-json-C6nhPOm1.js +190 -0
  39. package/dist/current-json-C6nhPOm1.js.map +1 -0
  40. package/dist/{db-BM3y2JQw.d.ts → db-DsPkOVEH.d.ts} +26 -108
  41. package/dist/{deploy-CrAbfgCq.js → deploy-DonTr-CV.js} +12 -5
  42. package/dist/deploy-DonTr-CV.js.map +1 -0
  43. package/dist/dev-vite.d.ts +11 -7
  44. package/dist/dev-vite.js +7 -6
  45. package/dist/dev-vite.js.map +1 -1
  46. package/dist/dev.d.ts +1 -1
  47. package/dist/dev.js +1 -1
  48. package/dist/{doctor-Db-hzPmE.js → doctor-DSIyCDg_.js} +14 -136
  49. package/dist/doctor-DSIyCDg_.js.map +1 -0
  50. package/dist/{dump-BYA55NLP.js → dump-Bh5k26VQ.js} +10 -31
  51. package/dist/dump-Bh5k26VQ.js.map +1 -0
  52. package/dist/{errors-DOdL95kK.js → errors-Dfa3p78c.js} +25 -5
  53. package/dist/errors-Dfa3p78c.js.map +1 -0
  54. package/dist/{export-Bhbz90-z.js → export-DtF5tDIM.js} +11 -32
  55. package/dist/{export-Bhbz90-z.js.map → export-DtF5tDIM.js.map} +1 -1
  56. package/dist/{fsck-CPPZWt9p.js → fsck-D_djMO5D.js} +28 -39
  57. package/dist/fsck-D_djMO5D.js.map +1 -0
  58. package/dist/{http-Cw8p6y5b.js → http-DxM9MflO.js} +151 -79
  59. package/dist/http-DxM9MflO.js.map +1 -0
  60. package/dist/http.d.ts +42 -26
  61. package/dist/http.js +3 -2
  62. package/dist/{index-DwDTWPSU.d.ts → index-0rZcMBwy.d.ts} +10 -7
  63. package/dist/{index-C3JAH1Yo.d.ts → index-B6oexfOB.d.ts} +9 -9
  64. package/dist/{index-cUY-36AN.d.ts → index-BNRh23K9.d.ts} +21 -5
  65. package/dist/{index-DSvwEUeF.d.ts → index-BYk9oCNf.d.ts} +240 -202
  66. package/dist/index.d.ts +6 -6
  67. package/dist/index.js +5 -5
  68. package/dist/{indexes-DAu2AkTW.d.ts → indexes-Dn9hbGQG.d.ts} +2 -2
  69. package/dist/{inspect-Bdbzvi-_.js → inspect-6WZ-pC7-.js} +21 -36
  70. package/dist/inspect-6WZ-pC7-.js.map +1 -0
  71. package/dist/key-Di6yyxFu.js +35 -0
  72. package/dist/key-Di6yyxFu.js.map +1 -0
  73. package/dist/{snapshot-SS8USDUF.js → log-tail-D98U1JBo.js} +179 -84
  74. package/dist/log-tail-D98U1JBo.js.map +1 -0
  75. package/dist/{maintenance-ClzBC1Vv.js → maintenance-B4Dki6Ig.js} +438 -176
  76. package/dist/maintenance-B4Dki6Ig.js.map +1 -0
  77. package/dist/{maintenance-BRrThz8V.d.ts → maintenance-B_e0T99L.d.ts} +114 -26
  78. package/dist/{maintenance-BvOv6BMM.js → maintenance-C7coQp4c.js} +217 -94
  79. package/dist/maintenance-C7coQp4c.js.map +1 -0
  80. package/dist/maintenance.d.ts +3 -2
  81. package/dist/maintenance.js +3 -2
  82. package/dist/node.d.ts +176 -68
  83. package/dist/node.js +3 -2
  84. package/dist/{normalize-XWY25_sG.js → normalize-rjnZLwS4.js} +2 -2
  85. package/dist/normalize-rjnZLwS4.js.map +1 -0
  86. package/dist/{observability-CpOiEN0k.js → observability-wzs3-BL_.js} +279 -109
  87. package/dist/observability-wzs3-BL_.js.map +1 -0
  88. package/dist/observability.d.ts +3 -3
  89. package/dist/observability.js +1 -1
  90. package/dist/{plan-DOTl21vq.js → plan-a7PJHBCy.js} +7 -4
  91. package/dist/plan-a7PJHBCy.js.map +1 -0
  92. package/dist/{query-BmiQy328.js → query-rAtXNQQB.js} +1063 -1202
  93. package/dist/query-rAtXNQQB.js.map +1 -0
  94. package/dist/{rebuild-index-DC_nR6wP.js → rebuild-index-BVzQSZlm.js} +10 -32
  95. package/dist/rebuild-index-BVzQSZlm.js.map +1 -0
  96. package/dist/{request-BEF_OvMh.js → request-u0M51mhJ.js} +3 -3
  97. package/dist/{request-BEF_OvMh.js.map → request-u0M51mhJ.js.map} +1 -1
  98. package/dist/restore-R-4rbciV.js +778 -0
  99. package/dist/restore-R-4rbciV.js.map +1 -0
  100. package/dist/runtime-spec-qL3_lTTU.js +391 -0
  101. package/dist/runtime-spec-qL3_lTTU.js.map +1 -0
  102. package/dist/s3-http-B-z8th6O.d.ts +60 -0
  103. package/dist/s3.d.ts +47 -0
  104. package/dist/s3.js +45 -0
  105. package/dist/s3.js.map +1 -0
  106. package/dist/{shared-secret-BJdSwpgw.js → shared-secret-DgEicd3x.js} +13 -5
  107. package/dist/shared-secret-DgEicd3x.js.map +1 -0
  108. package/dist/src-BG20LZs7.js +2271 -0
  109. package/dist/src-BG20LZs7.js.map +1 -0
  110. package/dist/{src-zhEAmmF7.js → src-CYHFDrKz.js} +82 -99
  111. package/dist/src-CYHFDrKz.js.map +1 -0
  112. package/dist/{src-QQ7jDeL2.js → src-DYZ4H1aF.js} +44 -23
  113. package/dist/src-DYZ4H1aF.js.map +1 -0
  114. package/dist/subcommand-DoDA-K7d.js +197 -0
  115. package/dist/subcommand-DoDA-K7d.js.map +1 -0
  116. package/dist/time-DUqvFMHq.js +119 -0
  117. package/dist/time-DUqvFMHq.js.map +1 -0
  118. package/dist/{usage-CLjirdD-.js → usage-DBV1eQHC.js} +7 -22
  119. package/dist/usage-DBV1eQHC.js.map +1 -0
  120. package/dist/{validate-DCq_0DIn.js → validate-DtljsCh1.js} +51 -51
  121. package/dist/{validate-DCq_0DIn.js.map → validate-DtljsCh1.js.map} +1 -1
  122. package/dist/wire-izfGZDvr.js.map +1 -1
  123. package/package.json +77 -42
  124. package/dist/cloudflare-CINJPKCW.js.map +0 -1
  125. package/dist/config-DVfDGyw1.js +0 -278
  126. package/dist/config-DVfDGyw1.js.map +0 -1
  127. package/dist/cost-CQt1YRkA.js.map +0 -1
  128. package/dist/current-json-C-EyJqs0.js +0 -354
  129. package/dist/current-json-C-EyJqs0.js.map +0 -1
  130. package/dist/deploy-CrAbfgCq.js.map +0 -1
  131. package/dist/doctor-Db-hzPmE.js.map +0 -1
  132. package/dist/dump-BYA55NLP.js.map +0 -1
  133. package/dist/errors-DOdL95kK.js.map +0 -1
  134. package/dist/fsck-CPPZWt9p.js.map +0 -1
  135. package/dist/http-Cw8p6y5b.js.map +0 -1
  136. package/dist/inspect-Bdbzvi-_.js.map +0 -1
  137. package/dist/maintenance-BvOv6BMM.js.map +0 -1
  138. package/dist/maintenance-ClzBC1Vv.js.map +0 -1
  139. package/dist/normalize-XWY25_sG.js.map +0 -1
  140. package/dist/observability-CpOiEN0k.js.map +0 -1
  141. package/dist/plan-DOTl21vq.js.map +0 -1
  142. package/dist/query-BmiQy328.js.map +0 -1
  143. package/dist/rebuild-index-DC_nR6wP.js.map +0 -1
  144. package/dist/restore-C6IcmLeA.js +0 -771
  145. package/dist/restore-C6IcmLeA.js.map +0 -1
  146. package/dist/shared-secret-BJdSwpgw.js.map +0 -1
  147. package/dist/snapshot-SS8USDUF.js.map +0 -1
  148. package/dist/src-DU1sCMlr.js +0 -6236
  149. package/dist/src-DU1sCMlr.js.map +0 -1
  150. package/dist/src-QQ7jDeL2.js.map +0 -1
  151. package/dist/src-zhEAmmF7.js.map +0 -1
  152. package/dist/subcommand-DZcHcsYp.js +0 -5122
  153. package/dist/subcommand-DZcHcsYp.js.map +0 -1
  154. package/dist/usage-CLjirdD-.js.map +0 -1
  155. /package/dist/{chunk-EAsCxrDo.js → rolldown-runtime-EAsCxrDo.js} +0 -0
@@ -1 +1 @@
1
- {"version":3,"file":"export-Bhbz90-z.js","names":[],"sources":["../packages/cli/src/export/ddl.ts","../packages/cli/src/export/rows.ts","../packages/cli/src/export/where.ts","../packages/cli/src/export/plan-sidecar.ts","../packages/cli/src/export.ts"],"sourcesContent":["import { BaerlyError } from \"@baerly/protocol\";\nimport type { ExportPlan } from \"./types.ts\";\n\n/**\n * Emit a `CREATE TABLE` statement for the plan, one line per column,\n * terminated with a semicolon + newline so the output is directly\n * pipeable into `psql` / `sqlite3` / `wrangler d1 execute`.\n *\n * `_id` is the primary key (always first in `plan.columns`).\n *\n * D1 today is sqlite-flavoured: same DDL as `target=sqlite` with a\n * single difference — D1 disallows table names starting with\n * `sqlite_`. We refuse them up front.\n */\nexport const emitCreateTable = (plan: ExportPlan): string => {\n if (plan.columns.length === 0) {\n throw new BaerlyError(\n \"SchemaError\",\n `emitCreateTable: collection ${JSON.stringify(plan.table)} has no observed columns — empty snapshot?`,\n );\n }\n if (plan.target === \"d1\" && plan.table.toLowerCase().startsWith(\"sqlite_\")) {\n throw new BaerlyError(\n \"SchemaError\",\n `emitCreateTable: D1 reserves the sqlite_ table-name prefix (got ${JSON.stringify(plan.table)})`,\n );\n }\n const lines: string[] = [];\n lines.push(`CREATE TABLE ${plan.tableIdentifier} (`);\n const colLines: string[] = [];\n for (const col of plan.columns) {\n const nullClause = col.nullable ? \"\" : \" NOT NULL\";\n const pkClause = col.source === \"_id\" ? \" PRIMARY KEY\" : \"\";\n colLines.push(` ${col.identifier} ${col.sqlType}${nullClause}${pkClause}`);\n }\n lines.push(colLines.join(\",\\n\"));\n lines.push(\");\");\n return lines.join(\"\\n\") + \"\\n\";\n};\n","import type { DocumentValue } from \"@baerly/protocol\";\nimport type { ExportPlan, ExportRow } from \"./types.ts\";\nimport { quoteValue } from \"./sql-escape.ts\";\n\n/**\n * Emit one `INSERT INTO …` statement per row. The emitted SQL is\n * directly pipeable into `psql` / `sqlite3` / `wrangler d1\n * execute`. Per-row statements (not one big VALUES tuple) so a\n * mid-stream failure has bounded blast radius.\n *\n * For columns whose plan has `jsonEncoded: true`, the row's value\n * is JSON-stringified first and then string-quoted. Postgres\n * accepts a literal text JSON in a `jsonb` column. SQLite / D1 see\n * the JSON as plain TEXT.\n *\n * Rows are streamed via the async-iterable protocol so the export\n * never materialises the full SQL output in memory. The caller\n * concatenates the yielded chunks (or pipes them straight to disk\n * / stdout).\n */\nexport async function* emitInsertStatements(\n plan: ExportPlan,\n rows: ReadonlyMap<string, ExportRow>,\n): AsyncIterable<string> {\n const columnList = plan.columns.map((c) => c.identifier).join(\", \");\n // Iterate in `Map` insertion order — stable, and the snapshot\n // body itself sorts by `_id` (compactor.ts: `docs is sorted by\n // _id for deterministic byte output`).\n for (const [id, body] of rows) {\n const values: string[] = [];\n for (const col of plan.columns) {\n const raw: DocumentValue | undefined =\n col.source === \"_id\"\n ? (id as DocumentValue)\n : (body as Record<string, DocumentValue>)[col.source];\n if (raw === undefined) {\n values.push(\"NULL\");\n continue;\n }\n if (col.jsonEncoded) {\n const json = JSON.stringify(raw);\n values.push(quoteValue(json, plan.target));\n } else {\n values.push(quoteValue(raw, plan.target));\n }\n }\n yield `INSERT INTO ${plan.tableIdentifier} (${columnList}) VALUES (${values.join(\", \")});\\n`;\n }\n}\n","/**\n * Wire-predicate → SQL `WHERE` clause translation.\n *\n * Pure function. The translator consumes a validated\n * {@link PredicateWire} — the same shape the read path uses — and\n * an {@link ExportPlan} (from `./plan.ts`), and emits a SQL fragment\n * matched against the plan's columns.\n *\n * Three classes of clause:\n *\n * 1. Flat column, top-level field → direct comparator\n * (`\"status\" = 'open'`, `\"priority\" > 5`).\n * 2. JSON-encoded column → JSON-path operators (Postgres `->`/`->>`\n * chains; SQLite/D1 `json_extract(…, '$.…')`).\n * 3. Unmatchable clause (dotted path against a flat column, or a\n * field naming an unknown column) → `1 = 0` plus a hint the CLI\n * surfaces as a `-- TODO(baerly export):` comment above the\n * emitted statement.\n *\n * Dynamic predicates are invisible at runtime — we see the\n * materialised wire, not the source expression. Callers that know\n * they constructed the wire dynamically can pass\n * `options.dynamicHint` to surface an operator-supplied note.\n */\n\nimport {\n BaerlyError,\n type DocumentValue,\n type PredicateClause,\n type PredicateWire,\n validateWire,\n} from \"@baerly/protocol\";\nimport { quoteValue } from \"./sql-escape.ts\";\nimport type { ColumnPlan, ExportPlan, SqlTarget } from \"./types.ts\";\n\nexport interface WhereTranslation {\n /** SQL fragment without the leading `WHERE`. Empty when no predicate. */\n readonly sql: string;\n /**\n * Hand-edit hints for the operator. One entry per non-matchable\n * clause (§3.6) or per dynamically-constructed sub-clause flagged\n * by the caller. The CLI surfaces these as `-- TODO(baerly export): …`\n * comments above the emitted statement.\n */\n readonly hints: readonly string[];\n}\n\n/**\n * Translate a validated {@link PredicateWire} into a SQL WHERE-clause\n * fragment matched against the plan's columns. The first argument\n * must already have been validated by {@link validateWire} — the\n * function re-validates defensively but the caller's invariant\n * matters for error-message provenance.\n *\n * Pure function. No I/O. Same wire + plan + target → same SQL string.\n *\n * @throws BaerlyError code=\"InvalidConfig\" — wire fails\n * {@link validateWire}; same shape `Query<T>.where` already\n * surfaces.\n */\nexport const translatePredicateWireToSql = (\n wire: PredicateWire,\n plan: ExportPlan,\n options?: { readonly dynamicHint?: string },\n): WhereTranslation => {\n validateWire(wire);\n const hints: string[] = [];\n if (options?.dynamicHint !== undefined && options.dynamicHint.length > 0) {\n hints.push(\n `caller-flagged dynamic predicate: ${options.dynamicHint}. Review the emitted SQL for completeness.`,\n );\n }\n const clauses: string[] = [];\n for (const clause of wire.clauses) {\n clauses.push(...clauseForWire(clause, plan, hints));\n }\n return {\n sql: clauses.length === 0 ? \"\" : clauses.join(\" AND \"),\n hints,\n };\n};\n\nconst clauseForWire = (clause: PredicateClause, plan: ExportPlan, hints: string[]): string[] => {\n const segments = clause.field.includes(\".\") ? clause.field.split(\".\") : [clause.field];\n const head = segments[0];\n if (head === undefined || head.length === 0) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"translatePredicateWireToSql: empty field path encountered (defensive)\",\n );\n }\n const col = plan.columns.find((c) => c.source === head);\n if (col === undefined) {\n hints.push(\n `predicate field ${JSON.stringify(clause.field)} references a key never observed in the snapshot; this clause cannot match.`,\n );\n return [\"1 = 0\"];\n }\n // §3.2 — flat column, top-level field → direct comparator.\n if (!col.jsonEncoded && segments.length === 1) {\n return [flatColumnClause(col.identifier, clause, plan.target)];\n }\n // §3.6 — flat column, dotted path → unmatchable.\n if (!col.jsonEncoded && segments.length > 1) {\n hints.push(\n `predicate path ${JSON.stringify(clause.field)} addresses a flat column; this clause cannot match. Hand-edit if intended.`,\n );\n return [\"1 = 0\"];\n }\n // §3.3 — JSON column, top-level field.\n if (col.jsonEncoded && segments.length === 1) {\n return [jsonColumnRootClause(col, clause, plan.target)];\n }\n // §3.4 / §3.5 — JSON column, dotted path.\n return [jsonPathClause(col, segments.slice(1), clause, plan.target)];\n};\n\nconst flatColumnClause = (\n identifier: string,\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n switch (clause.op) {\n case \"eq\": {\n return `${identifier} = ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gt\": {\n return `${identifier} > ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gte\": {\n return `${identifier} >= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lt\": {\n return `${identifier} < ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lte\": {\n return `${identifier} <= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"in\": {\n return `${identifier} IN (${(clause.value as ReadonlyArray<DocumentValue>)\n .map((v) => quoteLeaf(v, target))\n .join(\", \")})`;\n }\n }\n};\n\nconst jsonColumnRootClause = (\n col: ColumnPlan,\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n // The root JSON column stores the value as JSON-encoded text;\n // we compare against the JSON encoding of the predicate value.\n // Range and `in` ops on a JSON-encoded root column compare the\n // JSON text lexicographically, which is rarely what the caller\n // wanted — for those, the operator is expected to promote the\n // field into a flat column or hand-edit the emitted SQL.\n if (clause.op === \"eq\") {\n const literal = JSON.stringify(clause.value);\n if (target === \"postgres\") {\n return `${col.identifier}::text = ${quoteValue(literal, target)}`;\n }\n return `${col.identifier} = ${quoteValue(literal, target)}`;\n }\n if (clause.op === \"in\") {\n const literals = (clause.value as ReadonlyArray<DocumentValue>).map((v) =>\n quoteValue(JSON.stringify(v), target),\n );\n if (target === \"postgres\") {\n return `${col.identifier}::text IN (${literals.join(\", \")})`;\n }\n return `${col.identifier} IN (${literals.join(\", \")})`;\n }\n // Range against JSON-encoded root: fall back to a lex compare on\n // the JSON serialisation. Surface a comment via the SQL itself;\n // the operator can hand-edit.\n const comparator = rangeComparator(clause.op);\n const literal = JSON.stringify(clause.value);\n if (target === \"postgres\") {\n return `${col.identifier}::text ${comparator} ${quoteValue(literal, target)}`;\n }\n return `${col.identifier} ${comparator} ${quoteValue(literal, target)}`;\n};\n\nconst jsonPathClause = (\n col: ColumnPlan,\n tail: readonly string[],\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n const accessor = jsonPathAccessor(col.identifier, tail, target);\n switch (clause.op) {\n case \"eq\": {\n return `${accessor} = ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gt\": {\n return `${accessor} > ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gte\": {\n return `${accessor} >= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lt\": {\n return `${accessor} < ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lte\": {\n return `${accessor} <= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"in\": {\n return `${accessor} IN (${(clause.value as ReadonlyArray<DocumentValue>)\n .map((v) => quoteLeaf(v, target))\n .join(\", \")})`;\n }\n }\n};\n\nconst rangeComparator = (op: PredicateClause[\"op\"]): string => {\n if (op === \"gt\") {\n return \">\";\n }\n if (op === \"gte\") {\n return \">=\";\n }\n if (op === \"lt\") {\n return \"<\";\n }\n return \"<=\";\n};\n\nconst jsonPathAccessor = (\n identifier: string,\n tail: readonly string[],\n target: SqlTarget,\n): string => {\n if (target === \"postgres\") {\n let expr = identifier;\n for (let i = 0; i < tail.length; i++) {\n const seg = tail[i]!;\n const isLast = i === tail.length - 1;\n const key = `'${seg.replace(/'/g, \"''\")}'`;\n expr = `${expr}${isLast ? \"->>\" : \"->\"}${key}`;\n }\n return expr;\n }\n const jsonPath = `'$.${tail.map((s) => s.replace(/'/g, \"''\")).join(\".\")}'`;\n return `json_extract(${identifier}, ${jsonPath})`;\n};\n\n/**\n * Quote a leaf primitive for use as the right-hand side of a\n * comparison. Booleans branch on target. Nested objects must never\n * reach here — wire `eq` clauses on nested objects can only come\n * from the callback form `q.eq(\"nested\", { ... })`, which the\n * export translator does not support today.\n */\nconst quoteLeaf = (value: DocumentValue, target: SqlTarget): string => {\n if (typeof value === \"object\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"translatePredicateWireToSql: nested object reached leaf quoter — callback-form q.eq(field, object) is not supported for SQL export. Hand-edit the emitted SQL.\",\n );\n }\n return quoteValue(value, target);\n};\n","/**\n * Sidecar plan serialisation for `baerly export`.\n *\n * `baerly export --output=foo.sql` writes the inferred {@link ExportPlan}\n * alongside the SQL dump as `foo.sql.plan.json`. The round-trip test\n * (`tests/integration/export-round-trip.test.ts`) consumes the sidecar\n * to coerce SQLite-returned values back to their original JS type\n * (e.g. SQLite stores booleans as 0/1; we restore `true`/`false`).\n *\n * Wire shape (`schemaVersion = 1`):\n *\n * ```json\n * {\n * \"schemaVersion\": 1,\n * \"table\": \"tickets\",\n * \"target\": \"sqlite\",\n * \"columns\": [\n * { \"source\": \"_id\", \"sqlType\": \"TEXT\", \"nullable\": false, \"jsonEncoded\": false },\n * ...\n * ]\n * }\n * ```\n *\n * `identifier` is NOT carried on the wire — we re-derive it via\n * {@link quoteIdentifier} on deserialise. An attacker writing the\n * sidecar should not get SQL-emit control over identifiers.\n *\n * `rowCount` is also not preserved across the sidecar boundary; the\n * deserialised plan reports `0`. This is intentional — consumers that\n * care about row count read the SQL stream itself.\n */\n\nimport { BaerlyError } from \"@baerly/protocol\";\nimport { quoteIdentifier } from \"./sql-escape.ts\";\nimport type { ColumnPlan, ExportPlan, SqlTarget, SqlType } from \"./types.ts\";\n\nconst SIDECAR_SCHEMA_VERSION = 1 as const;\n\nconst VALID_TARGETS: ReadonlySet<string> = new Set([\"postgres\", \"sqlite\", \"d1\"]);\n\nconst VALID_SQL_TYPES: ReadonlySet<string> = new Set([\n \"text\",\n \"boolean\",\n \"integer\",\n \"double precision\",\n \"jsonb\",\n \"TEXT\",\n \"INTEGER\",\n \"REAL\",\n]);\n\n/**\n * Encode an {@link ExportPlan} as the canonical sidecar JSON string.\n *\n * Wire format is pretty-printed (`indent=2`) with a trailing newline\n * so `cat sidecar.plan.json` is human-readable and `diff` works on\n * two sidecars without spurious line-end noise. The on-wire bytes\n * embed the `schemaVersion` discriminator so future shape changes\n * are detectable; `identifier` and `tableIdentifier` are NOT carried\n * (they're re-derived via {@link quoteIdentifier} on deserialise).\n */\nexport const serializeExportPlan = (plan: ExportPlan): string => {\n return (\n JSON.stringify(\n {\n schemaVersion: SIDECAR_SCHEMA_VERSION,\n table: plan.table,\n target: plan.target,\n columns: plan.columns.map((c) => ({\n source: c.source,\n sqlType: c.sqlType,\n nullable: c.nullable,\n jsonEncoded: c.jsonEncoded,\n })),\n },\n null,\n 2,\n ) + \"\\n\"\n );\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\n/**\n * Parse the sidecar JSON string back into an {@link ExportPlan}.\n *\n * @throws BaerlyError code=\"InvalidConfig\" when the sidecar JSON is\n * malformed, the schema version is unsupported, or any required\n * field is missing / has an unexpected type. Identifiers are\n * re-quoted via {@link quoteIdentifier} rather than copied off the\n * wire — the sidecar cannot smuggle SQL-injection via a\n * pre-quoted identifier.\n */\nexport const deserializeExportPlan = (text: string): ExportPlan => {\n let raw: unknown;\n try {\n raw = JSON.parse(text);\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: parse failed: ${(error as Error).message}`,\n );\n }\n if (!isObject(raw)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"deserializeExportPlan: top-level value is not an object\",\n );\n }\n if (raw[\"schemaVersion\"] !== SIDECAR_SCHEMA_VERSION) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: unsupported schemaVersion ${String(raw[\"schemaVersion\"])} (expected ${String(SIDECAR_SCHEMA_VERSION)})`,\n );\n }\n if (typeof raw[\"table\"] !== \"string\" || raw[\"table\"].length === 0) {\n throw new BaerlyError(\"InvalidConfig\", \"deserializeExportPlan: missing or empty table\");\n }\n if (typeof raw[\"target\"] !== \"string\" || !VALID_TARGETS.has(raw[\"target\"])) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: unknown target ${JSON.stringify(raw[\"target\"])}`,\n );\n }\n if (!Array.isArray(raw[\"columns\"])) {\n throw new BaerlyError(\"InvalidConfig\", \"deserializeExportPlan: columns is not an array\");\n }\n const table = raw[\"table\"];\n const target = raw[\"target\"] as SqlTarget;\n const columns: ColumnPlan[] = [];\n for (const [i, col] of raw[\"columns\"].entries()) {\n if (!isObject(col)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}] is not an object`,\n );\n }\n if (typeof col[\"source\"] !== \"string\" || col[\"source\"].length === 0) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].source is missing or empty`,\n );\n }\n if (typeof col[\"sqlType\"] !== \"string\" || !VALID_SQL_TYPES.has(col[\"sqlType\"])) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].sqlType ${JSON.stringify(col[\"sqlType\"])} is not a recognised SqlType`,\n );\n }\n if (typeof col[\"nullable\"] !== \"boolean\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].nullable is not a boolean`,\n );\n }\n if (typeof col[\"jsonEncoded\"] !== \"boolean\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].jsonEncoded is not a boolean`,\n );\n }\n columns.push({\n source: col[\"source\"],\n identifier: quoteIdentifier(col[\"source\"], target),\n sqlType: col[\"sqlType\"] as SqlType,\n nullable: col[\"nullable\"],\n jsonEncoded: col[\"jsonEncoded\"],\n });\n }\n return {\n table,\n target,\n tableIdentifier: quoteIdentifier(table, target),\n columns,\n // Not preserved across the sidecar boundary — see file JSDoc.\n rowCount: 0,\n };\n};\n","/* eslint-disable no-underscore-dangle -- `_id` is the locked\n primary-key field on document shapes; the exporter threads it\n through the materialised view and the emitted INSERT rows. */\n\n/**\n * `baerly export` — snapshot dump of one collection to SQL.\n *\n * Drives the export modules end-to-end: load the materialised view,\n * infer an `ExportPlan` over the row shape, emit `CREATE TABLE` +\n * `INSERT` statements. When `--where=<json>` is supplied the\n * predicate is translated via `translatePredicateToSql` and applied\n * in-memory through `matches(...)` so the emitted INSERTs already\n * match the filter; the translated WHERE clause is also surfaced as a\n * comment above the inserts so operators can inspect / hand-edit it.\n *\n * The sidecar file (`<output>.plan.json`) carries the `ExportPlan` so\n * a follow-up round-trip ingest can verify the column schema. The\n * sidecar is JSON via `JSON.stringify` — the plan shape is the public\n * contract.\n *\n * Args:\n * --bucket Required. Bucket URI.\n * --app Required (or via baerly.config.ts).\n * --tenant Required (or via baerly.config.ts).\n * --collection Required. Collection name.\n * --target Required. postgres | sqlite | d1.\n * --where Optional. JSON-encoded `Predicate<T>`.\n * --where-comment Optional. Caller hint surfaced as a\n * `-- TODO(baerly export):` comment.\n * --output Optional. Path to write SQL into; default\n * stdout. The sidecar plan is written to\n * `<output>.plan.json` unless `--no-sidecar`.\n * --no-sidecar Skip emitting the sidecar plan file.\n * --json JSON envelope on stdout (or stderr on error).\n *\n * Exit codes:\n * 0 — dump completed.\n * 1 — InvalidConfig (bad args / bucket URI / --where JSON / unknown --target).\n * 2 — Storage / Network error.\n * 3 — Protocol invariant (Internal / InvalidResponse / Conflict).\n */\n\nimport { writeFile } from \"node:fs/promises\";\nimport { type ArgsDef } from \"citty\";\nimport { BaerlyError, matchesWire, type PredicateWire, validateWire } from \"@baerly/protocol\";\nimport {\n type ExportPlan,\n type ExportRow,\n type SqlTarget,\n emitCreateTable,\n emitInsertStatements,\n inferPlanForCollection,\n loadMaterialisedView,\n serializeExportPlan,\n translatePredicateWireToSql,\n} from \"./export/index.ts\";\nimport { parseBucketUri } from \"./bucket-uri.ts\";\nimport { emitSuccess } from \"./output.ts\";\nimport { defineBaerlySubcommand } from \"./subcommand.ts\";\n\nconst EXPORT_ARGS = {\n bucket: {\n type: \"string\",\n required: true,\n description: \"Bucket URI (s3://<bucket>[/<prefix>], file:///<abs>, memory://<bucket>)\",\n valueHint: \"bucket-uri\",\n },\n app: {\n type: \"string\",\n required: false,\n description: \"Application name segment (defaults to baerly.config.ts).\",\n valueHint: \"app\",\n },\n tenant: {\n type: \"string\",\n required: false,\n description: \"Tenant name segment (defaults to baerly.config.ts).\",\n valueHint: \"tenant\",\n },\n collection: {\n type: \"string\",\n required: true,\n description: \"Collection name.\",\n valueHint: \"name\",\n },\n target: {\n type: \"enum\",\n options: [\"postgres\", \"sqlite\", \"d1\"],\n required: true,\n description: \"SQL target: postgres | sqlite | d1.\",\n },\n where: {\n type: \"string\",\n required: false,\n description: \"JSON-encoded PredicateWire ({ clauses: [...] }) filtering the rows to export.\",\n valueHint: \"json\",\n },\n \"where-comment\": {\n type: \"string\",\n required: false,\n description: \"Caller hint surfaced as a -- TODO(baerly export): comment.\",\n valueHint: \"text\",\n },\n output: {\n type: \"string\",\n required: false,\n description: \"Path to write SQL into; default stdout.\",\n valueHint: \"path\",\n },\n sidecar: {\n type: \"boolean\",\n default: true,\n description: \"Emit a <output>.plan.json sidecar (default true; pass --no-sidecar to skip).\",\n },\n json: {\n type: \"boolean\",\n description: \"Emit a structured JSON envelope to stdout (success) or stderr (error)\",\n },\n} as const satisfies ArgsDef;\n\nconst parseWherePredicate = (raw: string): PredicateWire => {\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: --where is not valid JSON: ${(error as Error).message}`,\n );\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: --where must decode to a JSON object (got ${describeNonObject(parsed)})`,\n );\n }\n // Re-validate defensively; the translator will reject too, but\n // surfacing the error here gives a single uniform error path.\n validateWire(parsed as PredicateWire);\n return parsed as PredicateWire;\n};\n\nconst filterRows = (\n rows: ReadonlyMap<string, ExportRow>,\n wire: PredicateWire | null,\n): Map<string, ExportRow> => {\n const filtered = new Map<string, ExportRow>();\n for (const [id, body] of rows) {\n if (wire === null) {\n filtered.set(id, body);\n continue;\n }\n if (matchesWire(wire, body)) {\n filtered.set(id, body);\n }\n }\n return filtered;\n};\n\nconst buildSql = async (\n plan: ExportPlan,\n rows: ReadonlyMap<string, ExportRow>,\n whereClause: string,\n whereHints: readonly string[],\n): Promise<string> => {\n let out = emitCreateTable(plan);\n for (const hint of whereHints) {\n out += `-- TODO(baerly export): ${hint}\\n`;\n }\n if (whereClause.length > 0) {\n out += `-- WHERE clause for review: ${whereClause}\\n`;\n }\n for await (const chunk of emitInsertStatements(plan, rows)) {\n out += chunk;\n }\n return out;\n};\n\nconst bundle = defineBaerlySubcommand({\n name: \"export\",\n meta: {\n description: \"Snapshot dump of one collection to SQL.\",\n },\n args: EXPORT_ARGS,\n handler: async (args, ctx) => {\n const target: SqlTarget = args.target;\n const { app, tenant } = await ctx.resolveAppTenant({ app: args.app, tenant: args.tenant });\n const bucket = await parseBucketUri(args.bucket);\n const currentJsonKey = `${bucket.keyPrefix}app/${app}/tenant/${tenant}/manifests/${args.collection}/current.json`;\n const view = await loadMaterialisedView({\n storage: bucket.storage,\n currentJsonKey,\n collection: args.collection,\n });\n if (view === null) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: collection ${JSON.stringify(args.collection)} is not provisioned (no current.json at ${currentJsonKey})`,\n );\n }\n const plan = inferPlanForCollection({\n rows: view,\n target,\n table: args.collection,\n });\n\n let wire: PredicateWire | null = null;\n let whereClause = \"\";\n let whereHints: readonly string[] = [];\n if (typeof args.where === \"string\" && args.where.length > 0) {\n wire = parseWherePredicate(args.where);\n const translation = translatePredicateWireToSql(\n wire,\n plan,\n typeof args[\"where-comment\"] === \"string\" && args[\"where-comment\"].length > 0\n ? { dynamicHint: args[\"where-comment\"] }\n : undefined,\n );\n whereClause = translation.sql;\n whereHints = translation.hints;\n } else if (typeof args[\"where-comment\"] === \"string\" && args[\"where-comment\"].length > 0) {\n // Bare --where-comment with no predicate still surfaces the operator's\n // note so reviewers see the intent.\n whereHints = [\n `caller-flagged dynamic predicate: ${args[\"where-comment\"]}. No predicate supplied; emitted INSERTs cover the full collection.`,\n ];\n }\n\n const filtered = filterRows(view, wire);\n const sql = await buildSql(plan, filtered, whereClause, whereHints);\n\n const outputPath = args.output;\n if (typeof outputPath === \"string\" && outputPath.length > 0) {\n await writeFile(outputPath, sql, \"utf8\");\n if (args.sidecar !== false) {\n await writeFile(`${outputPath}.plan.json`, serializeExportPlan(plan), \"utf8\");\n }\n } else {\n process.stdout.write(sql);\n }\n\n emitSuccess({\n command: \"export\",\n status: \"ok\",\n collection: args.collection,\n target,\n rows: filtered.size,\n hints: whereHints,\n ...(typeof outputPath === \"string\" && outputPath.length > 0 && { output: outputPath }),\n });\n return 0;\n },\n});\n\n/** citty `defineCommand` block for `baerly export`. */\nexport const exportCmd = 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 runExport = bundle.run;\n\n// Build a human-readable label for the \"expected JSON object\" error.\n// `null`, arrays, and the bare `undefined` need to be disambiguated\n// from `typeof`'s default \"object\".\nconst describeNonObject = (v: unknown): string => {\n if (v === null) {\n return \"null\";\n }\n if (Array.isArray(v)) {\n return \"array\";\n }\n return typeof v;\n};\n"],"mappings":"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"}
1
+ {"version":3,"file":"export-DtF5tDIM.js","names":[],"sources":["../packages/cli/src/export/ddl.ts","../packages/cli/src/export/rows.ts","../packages/cli/src/export/where.ts","../packages/cli/src/export/plan-sidecar.ts","../packages/cli/src/export.ts"],"sourcesContent":["import { BaerlyError } from \"@baerly/protocol\";\nimport type { ExportPlan } from \"./types.ts\";\n\n/**\n * Emit a `CREATE TABLE` statement for the plan, one line per column,\n * terminated with a semicolon + newline so the output is directly\n * pipeable into `psql` / `sqlite3` / `wrangler d1 execute`.\n *\n * `_id` is the primary key (always first in `plan.columns`).\n *\n * D1 today is sqlite-flavoured: same DDL as `target=sqlite` with a\n * single difference — D1 disallows table names starting with\n * `sqlite_`. We refuse them up front.\n */\nexport const emitCreateTable = (plan: ExportPlan): string => {\n if (plan.columns.length === 0) {\n throw new BaerlyError(\n \"SchemaError\",\n `emitCreateTable: collection ${JSON.stringify(plan.table)} has no observed columns — empty snapshot?`,\n );\n }\n if (plan.target === \"d1\" && plan.table.toLowerCase().startsWith(\"sqlite_\")) {\n throw new BaerlyError(\n \"SchemaError\",\n `emitCreateTable: D1 reserves the sqlite_ table-name prefix (got ${JSON.stringify(plan.table)})`,\n );\n }\n const lines: string[] = [];\n lines.push(`CREATE TABLE ${plan.tableIdentifier} (`);\n const colLines: string[] = [];\n for (const col of plan.columns) {\n const nullClause = col.nullable ? \"\" : \" NOT NULL\";\n const pkClause = col.source === \"_id\" ? \" PRIMARY KEY\" : \"\";\n colLines.push(` ${col.identifier} ${col.sqlType}${nullClause}${pkClause}`);\n }\n lines.push(colLines.join(\",\\n\"));\n lines.push(\");\");\n return lines.join(\"\\n\") + \"\\n\";\n};\n","import type { DocumentValue } from \"@baerly/protocol\";\nimport type { ExportPlan, ExportRow } from \"./types.ts\";\nimport { quoteValue } from \"./sql-escape.ts\";\n\n/**\n * Emit one `INSERT INTO …` statement per row. The emitted SQL is\n * directly pipeable into `psql` / `sqlite3` / `wrangler d1\n * execute`. Per-row statements (not one big VALUES tuple) so a\n * mid-stream failure has bounded blast radius.\n *\n * For columns whose plan has `jsonEncoded: true`, the row's value\n * is JSON-stringified first and then string-quoted. Postgres\n * accepts a literal text JSON in a `jsonb` column. SQLite / D1 see\n * the JSON as plain TEXT.\n *\n * Rows are streamed via the async-iterable protocol so the export\n * never materialises the full SQL output in memory. The caller\n * concatenates the yielded chunks (or pipes them straight to disk\n * / stdout).\n */\nexport async function* emitInsertStatements(\n plan: ExportPlan,\n rows: ReadonlyMap<string, ExportRow>,\n): AsyncIterable<string> {\n const columnList = plan.columns.map((c) => c.identifier).join(\", \");\n // Iterate in `Map` insertion order — stable, and the snapshot\n // body itself sorts by `_id` (compactor.ts: `docs is sorted by\n // _id for deterministic byte output`).\n for (const [id, body] of rows) {\n const values: string[] = [];\n for (const col of plan.columns) {\n const raw: DocumentValue | undefined =\n col.source === \"_id\"\n ? (id as DocumentValue)\n : (body as Record<string, DocumentValue>)[col.source];\n if (raw === undefined) {\n values.push(\"NULL\");\n continue;\n }\n if (col.jsonEncoded) {\n const json = JSON.stringify(raw);\n values.push(quoteValue(json, plan.target));\n } else {\n values.push(quoteValue(raw, plan.target));\n }\n }\n yield `INSERT INTO ${plan.tableIdentifier} (${columnList}) VALUES (${values.join(\", \")});\\n`;\n }\n}\n","/**\n * Wire-predicate → SQL `WHERE` clause translation.\n *\n * Pure function. The translator consumes a validated\n * {@link PredicateWire} — the same shape the read path uses — and\n * an {@link ExportPlan} (from `./plan.ts`), and emits a SQL fragment\n * matched against the plan's columns.\n *\n * Three classes of clause:\n *\n * 1. Flat column, top-level field → direct comparator\n * (`\"status\" = 'open'`, `\"priority\" > 5`).\n * 2. JSON-encoded column → JSON-path operators (Postgres `->`/`->>`\n * chains; SQLite/D1 `json_extract(…, '$.…')`).\n * 3. Unmatchable clause (dotted path against a flat column, or a\n * field naming an unknown column) → `1 = 0` plus a hint the CLI\n * surfaces as a `-- TODO(baerly export):` comment above the\n * emitted statement.\n *\n * Dynamic predicates are invisible at runtime — we see the\n * materialised wire, not the source expression. Callers that know\n * they constructed the wire dynamically can pass\n * `options.dynamicHint` to surface an operator-supplied note.\n */\n\nimport {\n BaerlyError,\n type DocumentValue,\n type PredicateClause,\n type PredicateWire,\n validateWire,\n} from \"@baerly/protocol\";\nimport { quoteValue } from \"./sql-escape.ts\";\nimport type { ColumnPlan, ExportPlan, SqlTarget } from \"./types.ts\";\n\nexport interface WhereTranslation {\n /** SQL fragment without the leading `WHERE`. Empty when no predicate. */\n readonly sql: string;\n /**\n * Hand-edit hints for the operator. One entry per non-matchable\n * clause (§3.6) or per dynamically-constructed sub-clause flagged\n * by the caller. The CLI surfaces these as `-- TODO(baerly export): …`\n * comments above the emitted statement.\n */\n readonly hints: readonly string[];\n}\n\n/**\n * Translate a validated {@link PredicateWire} into a SQL WHERE-clause\n * fragment matched against the plan's columns. The first argument\n * must already have been validated by {@link validateWire} — the\n * function re-validates defensively but the caller's invariant\n * matters for error-message provenance.\n *\n * Pure function. No I/O. Same wire + plan + target → same SQL string.\n *\n * @throws BaerlyError code=\"InvalidConfig\" — wire fails\n * {@link validateWire}; same shape `Query<T>.where` already\n * surfaces.\n */\nexport const translatePredicateWireToSql = (\n wire: PredicateWire,\n plan: ExportPlan,\n options?: { readonly dynamicHint?: string },\n): WhereTranslation => {\n validateWire(wire);\n const hints: string[] = [];\n if (options?.dynamicHint !== undefined && options.dynamicHint.length > 0) {\n hints.push(\n `caller-flagged dynamic predicate: ${options.dynamicHint}. Review the emitted SQL for completeness.`,\n );\n }\n const clauses: string[] = [];\n for (const clause of wire.clauses) {\n clauses.push(...clauseForWire(clause, plan, hints));\n }\n return {\n sql: clauses.length === 0 ? \"\" : clauses.join(\" AND \"),\n hints,\n };\n};\n\nconst clauseForWire = (clause: PredicateClause, plan: ExportPlan, hints: string[]): string[] => {\n const segments = clause.field.includes(\".\") ? clause.field.split(\".\") : [clause.field];\n const head = segments[0];\n if (head === undefined || head.length === 0) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"translatePredicateWireToSql: empty field path encountered (defensive)\",\n );\n }\n const col = plan.columns.find((c) => c.source === head);\n if (col === undefined) {\n hints.push(\n `predicate field ${JSON.stringify(clause.field)} references a key never observed in the snapshot; this clause cannot match.`,\n );\n return [\"1 = 0\"];\n }\n // §3.2 — flat column, top-level field → direct comparator.\n if (!col.jsonEncoded && segments.length === 1) {\n return [flatColumnClause(col.identifier, clause, plan.target)];\n }\n // §3.6 — flat column, dotted path → unmatchable.\n if (!col.jsonEncoded && segments.length > 1) {\n hints.push(\n `predicate path ${JSON.stringify(clause.field)} addresses a flat column; this clause cannot match. Hand-edit if intended.`,\n );\n return [\"1 = 0\"];\n }\n // §3.3 — JSON column, top-level field.\n if (col.jsonEncoded && segments.length === 1) {\n return [jsonColumnRootClause(col, clause, plan.target)];\n }\n // §3.4 / §3.5 — JSON column, dotted path.\n return [jsonPathClause(col, segments.slice(1), clause, plan.target)];\n};\n\nconst flatColumnClause = (\n identifier: string,\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n switch (clause.op) {\n case \"eq\": {\n return `${identifier} = ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gt\": {\n return `${identifier} > ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gte\": {\n return `${identifier} >= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lt\": {\n return `${identifier} < ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lte\": {\n return `${identifier} <= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"in\": {\n return `${identifier} IN (${(clause.value as ReadonlyArray<DocumentValue>)\n .map((v) => quoteLeaf(v, target))\n .join(\", \")})`;\n }\n }\n};\n\nconst jsonColumnRootClause = (\n col: ColumnPlan,\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n // The root JSON column stores the value as JSON-encoded text;\n // we compare against the JSON encoding of the predicate value.\n // Range and `in` ops on a JSON-encoded root column compare the\n // JSON text lexicographically, which is rarely what the caller\n // wanted — for those, the operator is expected to promote the\n // field into a flat column or hand-edit the emitted SQL.\n if (clause.op === \"eq\") {\n const literal = JSON.stringify(clause.value);\n if (target === \"postgres\") {\n return `${col.identifier}::text = ${quoteValue(literal, target)}`;\n }\n return `${col.identifier} = ${quoteValue(literal, target)}`;\n }\n if (clause.op === \"in\") {\n const literals = (clause.value as ReadonlyArray<DocumentValue>).map((v) =>\n quoteValue(JSON.stringify(v), target),\n );\n if (target === \"postgres\") {\n return `${col.identifier}::text IN (${literals.join(\", \")})`;\n }\n return `${col.identifier} IN (${literals.join(\", \")})`;\n }\n // Range against JSON-encoded root: fall back to a lex compare on\n // the JSON serialisation. Surface a comment via the SQL itself;\n // the operator can hand-edit.\n const comparator = rangeComparator(clause.op);\n const literal = JSON.stringify(clause.value);\n if (target === \"postgres\") {\n return `${col.identifier}::text ${comparator} ${quoteValue(literal, target)}`;\n }\n return `${col.identifier} ${comparator} ${quoteValue(literal, target)}`;\n};\n\nconst jsonPathClause = (\n col: ColumnPlan,\n tail: readonly string[],\n clause: PredicateClause,\n target: SqlTarget,\n): string => {\n const accessor = jsonPathAccessor(col.identifier, tail, target);\n switch (clause.op) {\n case \"eq\": {\n return `${accessor} = ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gt\": {\n return `${accessor} > ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"gte\": {\n return `${accessor} >= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lt\": {\n return `${accessor} < ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"lte\": {\n return `${accessor} <= ${quoteLeaf(clause.value as DocumentValue, target)}`;\n }\n case \"in\": {\n return `${accessor} IN (${(clause.value as ReadonlyArray<DocumentValue>)\n .map((v) => quoteLeaf(v, target))\n .join(\", \")})`;\n }\n }\n};\n\nconst rangeComparator = (op: PredicateClause[\"op\"]): string => {\n if (op === \"gt\") {\n return \">\";\n }\n if (op === \"gte\") {\n return \">=\";\n }\n if (op === \"lt\") {\n return \"<\";\n }\n return \"<=\";\n};\n\nconst jsonPathAccessor = (\n identifier: string,\n tail: readonly string[],\n target: SqlTarget,\n): string => {\n if (target === \"postgres\") {\n let expr = identifier;\n for (let i = 0; i < tail.length; i++) {\n const seg = tail[i]!;\n const isLast = i === tail.length - 1;\n const key = `'${seg.replace(/'/g, \"''\")}'`;\n expr = `${expr}${isLast ? \"->>\" : \"->\"}${key}`;\n }\n return expr;\n }\n const jsonPath = `'$.${tail.map((s) => s.replace(/'/g, \"''\")).join(\".\")}'`;\n return `json_extract(${identifier}, ${jsonPath})`;\n};\n\n/**\n * Quote a leaf primitive for use as the right-hand side of a\n * comparison. Booleans branch on target. Nested objects must never\n * reach here — wire `eq` clauses on nested objects can only come\n * from the callback form `q.eq(\"nested\", { ... })`, which the\n * export translator does not support today.\n */\nconst quoteLeaf = (value: DocumentValue, target: SqlTarget): string => {\n if (typeof value === \"object\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"translatePredicateWireToSql: nested object reached leaf quoter — callback-form q.eq(field, object) is not supported for SQL export. Hand-edit the emitted SQL.\",\n );\n }\n return quoteValue(value, target);\n};\n","/**\n * Sidecar plan serialisation for `baerly export`.\n *\n * `baerly export --output=foo.sql` writes the inferred {@link ExportPlan}\n * alongside the SQL dump as `foo.sql.plan.json`. The round-trip test\n * (`tests/integration/export-round-trip.test.ts`) consumes the sidecar\n * to coerce SQLite-returned values back to their original JS type\n * (e.g. SQLite stores booleans as 0/1; we restore `true`/`false`).\n *\n * Wire shape (`schemaVersion = 1`):\n *\n * ```json\n * {\n * \"schemaVersion\": 1,\n * \"table\": \"tickets\",\n * \"target\": \"sqlite\",\n * \"columns\": [\n * { \"source\": \"_id\", \"sqlType\": \"TEXT\", \"nullable\": false, \"jsonEncoded\": false },\n * ...\n * ]\n * }\n * ```\n *\n * `identifier` is NOT carried on the wire — we re-derive it via\n * {@link quoteIdentifier} on deserialise. An attacker writing the\n * sidecar should not get SQL-emit control over identifiers.\n *\n * `rowCount` is also not preserved across the sidecar boundary; the\n * deserialised plan reports `0`. This is intentional — consumers that\n * care about row count read the SQL stream itself.\n */\n\nimport { BaerlyError } from \"@baerly/protocol\";\nimport { quoteIdentifier } from \"./sql-escape.ts\";\nimport type { ColumnPlan, ExportPlan, SqlTarget, SqlType } from \"./types.ts\";\n\nconst SIDECAR_SCHEMA_VERSION = 1 as const;\n\nconst VALID_TARGETS: ReadonlySet<string> = new Set([\"postgres\", \"sqlite\", \"d1\"]);\n\nconst VALID_SQL_TYPES: ReadonlySet<string> = new Set([\n \"text\",\n \"boolean\",\n \"integer\",\n \"double precision\",\n \"jsonb\",\n \"TEXT\",\n \"INTEGER\",\n \"REAL\",\n]);\n\n/**\n * Encode an {@link ExportPlan} as the canonical sidecar JSON string.\n *\n * Wire format is pretty-printed (`indent=2`) with a trailing newline\n * so `cat sidecar.plan.json` is human-readable and `diff` works on\n * two sidecars without spurious line-end noise. The on-wire bytes\n * embed the `schemaVersion` discriminator so future shape changes\n * are detectable; `identifier` and `tableIdentifier` are NOT carried\n * (they're re-derived via {@link quoteIdentifier} on deserialise).\n */\nexport const serializeExportPlan = (plan: ExportPlan): string => {\n return (\n JSON.stringify(\n {\n schemaVersion: SIDECAR_SCHEMA_VERSION,\n table: plan.table,\n target: plan.target,\n columns: plan.columns.map((c) => ({\n source: c.source,\n sqlType: c.sqlType,\n nullable: c.nullable,\n jsonEncoded: c.jsonEncoded,\n })),\n },\n null,\n 2,\n ) + \"\\n\"\n );\n};\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n value !== null && typeof value === \"object\" && !Array.isArray(value);\n\n/**\n * Parse the sidecar JSON string back into an {@link ExportPlan}.\n *\n * @throws BaerlyError code=\"InvalidConfig\" when the sidecar JSON is\n * malformed, the schema version is unsupported, or any required\n * field is missing / has an unexpected type. Identifiers are\n * re-quoted via {@link quoteIdentifier} rather than copied off the\n * wire — the sidecar cannot smuggle SQL-injection via a\n * pre-quoted identifier.\n */\nexport const deserializeExportPlan = (text: string): ExportPlan => {\n let raw: unknown;\n try {\n raw = JSON.parse(text);\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: parse failed: ${(error as Error).message}`,\n );\n }\n if (!isObject(raw)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n \"deserializeExportPlan: top-level value is not an object\",\n );\n }\n if (raw[\"schemaVersion\"] !== SIDECAR_SCHEMA_VERSION) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: unsupported schemaVersion ${String(raw[\"schemaVersion\"])} (expected ${String(SIDECAR_SCHEMA_VERSION)})`,\n );\n }\n if (typeof raw[\"table\"] !== \"string\" || raw[\"table\"].length === 0) {\n throw new BaerlyError(\"InvalidConfig\", \"deserializeExportPlan: missing or empty table\");\n }\n if (typeof raw[\"target\"] !== \"string\" || !VALID_TARGETS.has(raw[\"target\"])) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: unknown target ${JSON.stringify(raw[\"target\"])}`,\n );\n }\n if (!Array.isArray(raw[\"columns\"])) {\n throw new BaerlyError(\"InvalidConfig\", \"deserializeExportPlan: columns is not an array\");\n }\n const table = raw[\"table\"];\n const target = raw[\"target\"] as SqlTarget;\n const columns: ColumnPlan[] = [];\n for (const [i, col] of raw[\"columns\"].entries()) {\n if (!isObject(col)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}] is not an object`,\n );\n }\n if (typeof col[\"source\"] !== \"string\" || col[\"source\"].length === 0) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].source is missing or empty`,\n );\n }\n if (typeof col[\"sqlType\"] !== \"string\" || !VALID_SQL_TYPES.has(col[\"sqlType\"])) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].sqlType ${JSON.stringify(col[\"sqlType\"])} is not a recognised SqlType`,\n );\n }\n if (typeof col[\"nullable\"] !== \"boolean\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].nullable is not a boolean`,\n );\n }\n if (typeof col[\"jsonEncoded\"] !== \"boolean\") {\n throw new BaerlyError(\n \"InvalidConfig\",\n `deserializeExportPlan: columns[${i}].jsonEncoded is not a boolean`,\n );\n }\n columns.push({\n source: col[\"source\"],\n identifier: quoteIdentifier(col[\"source\"], target),\n sqlType: col[\"sqlType\"] as SqlType,\n nullable: col[\"nullable\"],\n jsonEncoded: col[\"jsonEncoded\"],\n });\n }\n return {\n table,\n target,\n tableIdentifier: quoteIdentifier(table, target),\n columns,\n // Not preserved across the sidecar boundary — see file JSDoc.\n rowCount: 0,\n };\n};\n","/* eslint-disable no-underscore-dangle -- `_id` is the locked\n primary-key field on document shapes; the exporter threads it\n through the materialised view and the emitted INSERT rows. */\n\n/**\n * `baerly export` — snapshot dump of one collection to SQL.\n *\n * Drives the export modules end-to-end: load the materialised view,\n * infer an `ExportPlan` over the row shape, emit `CREATE TABLE` +\n * `INSERT` statements. When `--where=<json>` is supplied the\n * predicate is translated via `translatePredicateToSql` and applied\n * in-memory through `matches(...)` so the emitted INSERTs already\n * match the filter; the translated WHERE clause is also surfaced as a\n * comment above the inserts so operators can inspect / hand-edit it.\n *\n * The sidecar file (`<output>.plan.json`) carries the `ExportPlan` so\n * a follow-up round-trip ingest can verify the column schema. The\n * sidecar is JSON via `JSON.stringify` — the plan shape is the public\n * contract.\n *\n * Args:\n * --bucket Required. Bucket URI.\n * --app Required (or via baerly.config.ts).\n * --tenant Required (or via baerly.config.ts).\n * --collection Required. Collection name.\n * --target Required. postgres | sqlite | d1.\n * --where Optional. JSON-encoded `Predicate<T>`.\n * --where-comment Optional. Caller hint surfaced as a\n * `-- TODO(baerly export):` comment.\n * --output Optional. Path to write SQL into; default\n * stdout. The sidecar plan is written to\n * `<output>.plan.json` unless `--no-sidecar`.\n * --no-sidecar Skip emitting the sidecar plan file.\n * --json JSON envelope on stdout (or stderr on error).\n *\n * Exit codes:\n * 0 — dump completed.\n * 1 — InvalidConfig (bad args / bucket URI / --where JSON / unknown --target).\n * 2 — Storage / Network error.\n * 3 — Protocol invariant (Internal / InvalidResponse / Conflict).\n */\n\nimport { writeFile } from \"node:fs/promises\";\nimport { type ArgsDef } from \"citty\";\nimport { BaerlyError, matchesWire, type PredicateWire, validateWire } from \"@baerly/protocol\";\nimport {\n type ExportPlan,\n type ExportRow,\n type SqlTarget,\n emitCreateTable,\n emitInsertStatements,\n inferPlanForCollection,\n loadMaterialisedView,\n serializeExportPlan,\n translatePredicateWireToSql,\n} from \"./export/index.ts\";\nimport { parseBucketUri } from \"./bucket-uri.ts\";\nimport { emitSuccess } 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 EXPORT_ARGS = {\n bucket: BUCKET_ARG,\n app: APP_ARG,\n tenant: TENANT_ARG,\n collection: COLLECTION_ARG,\n target: {\n type: \"enum\",\n options: [\"postgres\", \"sqlite\", \"d1\"],\n required: true,\n description: \"SQL target: postgres | sqlite | d1.\",\n },\n where: {\n type: \"string\",\n required: false,\n description: \"JSON-encoded PredicateWire ({ clauses: [...] }) filtering the rows to export.\",\n valueHint: \"json\",\n },\n \"where-comment\": {\n type: \"string\",\n required: false,\n description: \"Caller hint surfaced as a -- TODO(baerly export): comment.\",\n valueHint: \"text\",\n },\n output: {\n type: \"string\",\n required: false,\n description: \"Path to write SQL into; default stdout.\",\n valueHint: \"path\",\n },\n sidecar: {\n type: \"boolean\",\n default: true,\n description: \"Emit a <output>.plan.json sidecar (default true; pass --no-sidecar to skip).\",\n },\n json: JSON_ARG,\n} as const satisfies ArgsDef;\n\nconst parseWherePredicate = (raw: string): PredicateWire => {\n let parsed: unknown;\n try {\n parsed = JSON.parse(raw);\n } catch (error) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: --where is not valid JSON: ${(error as Error).message}`,\n );\n }\n if (parsed === null || typeof parsed !== \"object\" || Array.isArray(parsed)) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: --where must decode to a JSON object (got ${describeNonObject(parsed)})`,\n );\n }\n // Re-validate defensively; the translator will reject too, but\n // surfacing the error here gives a single uniform error path.\n validateWire(parsed as PredicateWire);\n return parsed as PredicateWire;\n};\n\nconst filterRows = (\n rows: ReadonlyMap<string, ExportRow>,\n wire: PredicateWire | null,\n): Map<string, ExportRow> => {\n const filtered = new Map<string, ExportRow>();\n for (const [id, body] of rows) {\n if (wire === null) {\n filtered.set(id, body);\n continue;\n }\n if (matchesWire(wire, body)) {\n filtered.set(id, body);\n }\n }\n return filtered;\n};\n\nconst buildSql = async (\n plan: ExportPlan,\n rows: ReadonlyMap<string, ExportRow>,\n whereClause: string,\n whereHints: readonly string[],\n): Promise<string> => {\n let out = emitCreateTable(plan);\n for (const hint of whereHints) {\n out += `-- TODO(baerly export): ${hint}\\n`;\n }\n if (whereClause.length > 0) {\n out += `-- WHERE clause for review: ${whereClause}\\n`;\n }\n for await (const chunk of emitInsertStatements(plan, rows)) {\n out += chunk;\n }\n return out;\n};\n\nconst bundle = defineBaerlySubcommand({\n name: \"export\",\n meta: {\n description: \"Snapshot dump of one collection to SQL.\",\n },\n args: EXPORT_ARGS,\n handler: async (args, ctx) => {\n const target: SqlTarget = args.target;\n const { app, tenant } = await ctx.resolveAppTenant({ app: args.app, tenant: args.tenant });\n assertCollectionArg(args.collection, \"baerly export\");\n const bucket = await parseBucketUri(args.bucket);\n const currentJsonKey = `${bucket.keyPrefix}app/${app}/tenant/${tenant}/manifests/${args.collection}/current.json`;\n const view = await loadMaterialisedView({\n storage: bucket.storage,\n currentJsonKey,\n collection: args.collection,\n });\n if (view === null) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `baerly export: collection ${JSON.stringify(args.collection)} is not provisioned (no current.json at ${currentJsonKey})`,\n );\n }\n const plan = inferPlanForCollection({\n rows: view,\n target,\n table: args.collection,\n });\n\n let wire: PredicateWire | null = null;\n let whereClause = \"\";\n let whereHints: readonly string[] = [];\n if (typeof args.where === \"string\" && args.where.length > 0) {\n wire = parseWherePredicate(args.where);\n const translation = translatePredicateWireToSql(\n wire,\n plan,\n typeof args[\"where-comment\"] === \"string\" && args[\"where-comment\"].length > 0\n ? { dynamicHint: args[\"where-comment\"] }\n : undefined,\n );\n whereClause = translation.sql;\n whereHints = translation.hints;\n } else if (typeof args[\"where-comment\"] === \"string\" && args[\"where-comment\"].length > 0) {\n // Bare --where-comment with no predicate still surfaces the operator's\n // note so reviewers see the intent.\n whereHints = [\n `caller-flagged dynamic predicate: ${args[\"where-comment\"]}. No predicate supplied; emitted INSERTs cover the full collection.`,\n ];\n }\n\n const filtered = filterRows(view, wire);\n const sql = await buildSql(plan, filtered, whereClause, whereHints);\n\n const outputPath = args.output;\n if (typeof outputPath === \"string\" && outputPath.length > 0) {\n await writeFile(outputPath, sql, \"utf8\");\n if (args.sidecar !== false) {\n await writeFile(`${outputPath}.plan.json`, serializeExportPlan(plan), \"utf8\");\n }\n } else {\n process.stdout.write(sql);\n }\n\n emitSuccess({\n command: \"export\",\n status: \"ok\",\n collection: args.collection,\n target,\n rows: filtered.size,\n hints: whereHints,\n ...(typeof outputPath === \"string\" && outputPath.length > 0 && { output: outputPath }),\n });\n return 0;\n },\n});\n\n/** citty `defineCommand` block for `baerly export`. */\nexport const exportCmd = 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 runExport = bundle.run;\n\n// Build a human-readable label for the \"expected JSON object\" error.\n// `null`, arrays, and the bare `undefined` need to be disambiguated\n// from `typeof`'s default \"object\".\nconst describeNonObject = (v: unknown): string => {\n if (v === null) {\n return \"null\";\n }\n if (Array.isArray(v)) {\n return \"array\";\n }\n return typeof v;\n};\n"],"mappings":"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"}
@@ -1,7 +1,8 @@
1
- import { f as readCurrentJson, n as loadSnapshotAsMap } from "./snapshot-SS8USDUF.js";
2
- import { i as rebuildIndex } from "./maintenance-BvOv6BMM.js";
3
- import { n as parseBucketUri, t as defineBaerlySubcommand } from "./subcommand-DZcHcsYp.js";
1
+ import { r as parseBucketUri } from "./config-1tv0-Yzm.js";
2
+ import { c as loadSnapshotAsMap, h as readCurrentJson } from "./log-tail-D98U1JBo.js";
3
+ import { i as rebuildIndex } from "./maintenance-C7coQp4c.js";
4
4
  import { i as isJsonMode, o as BaerlyError, r as emitSuccess } from "./baerly.js";
5
+ import { a as TENANT_ARG, i as JSON_ARG, n as BUCKET_ARG, o as assertCollectionArg, r as COLLECTION_ARG, s as defineBaerlySubcommand, t as APP_ARG } from "./subcommand-DoDA-K7d.js";
5
6
  import { fileURLToPath, pathToFileURL } from "node:url";
6
7
  //#region src/admin/fsck.ts
7
8
  /**
@@ -13,10 +14,16 @@ import { fileURLToPath, pathToFileURL } from "node:url";
13
14
  * 2. When `current.snapshot !== null`, the snapshot body's
14
15
  * SHA-256 matches the hash embedded in the filename
15
16
  * (delegated to `loadSnapshotAsMap`).
16
- * 3. The log range `[log_seq_start, next_seq)` has no holes —
17
- * every `log/<seq>.json` is present (HEAD-cheap LIST scan).
18
- * 4. Every entry inside the live tail is well-formed JSON with
19
- * the locked `op`, `collection`, and `doc_id` fields.
17
+ * 3. The live log range has no holes. The upper bound is derived
18
+ * from a single LIST of `log/` plus `current.json.tail_hint`
19
+ * (max(highest present seq + 1, tail_hint)), and every seq from
20
+ * `log_seq_start` up to that tail must be present.
21
+ * This is a presence/hole check by key, NOT a per-entry decode:
22
+ * fsck does not GET and parse each `log/<seq>.json`, so it does
23
+ * not assert every entry is well-formed JSON or carries the locked
24
+ * `op`/`collection`/`doc_id` fields. A full decode walk is
25
+ * intentionally omitted to keep the op count O(LIST pages); the
26
+ * read path validates entry shape at fold time.
20
27
  *
21
28
  * `--indexes` + `--config=<path>` mode: SKIP the snapshot + log
22
29
  * walks and ONLY check each declared index for drift via
@@ -44,30 +51,10 @@ import { fileURLToPath, pathToFileURL } from "node:url";
44
51
  * `baerly admin` subcommands reserve 0–3.
45
52
  */
46
53
  const FSCK_ARGS = {
47
- bucket: {
48
- type: "string",
49
- required: true,
50
- description: "Bucket URI (s3://<bucket>[/<prefix>], file:///<abs>, memory://<bucket>)",
51
- valueHint: "bucket-uri"
52
- },
53
- app: {
54
- type: "string",
55
- required: false,
56
- description: "Application name segment (defaults to baerly.config.ts).",
57
- valueHint: "app"
58
- },
59
- tenant: {
60
- type: "string",
61
- required: false,
62
- description: "Tenant name segment (defaults to baerly.config.ts).",
63
- valueHint: "tenant"
64
- },
65
- collection: {
66
- type: "string",
67
- required: true,
68
- description: "Collection name.",
69
- valueHint: "name"
70
- },
54
+ bucket: BUCKET_ARG,
55
+ app: APP_ARG,
56
+ tenant: TENANT_ARG,
57
+ collection: COLLECTION_ARG,
71
58
  config: {
72
59
  type: "string",
73
60
  required: false,
@@ -82,10 +69,7 @@ const FSCK_ARGS = {
82
69
  type: "boolean",
83
70
  description: "With --indexes, rebuild drifted indexes (PUT missing keys, DELETE orphans). Rejected without --indexes."
84
71
  },
85
- json: {
86
- type: "boolean",
87
- description: "Emit a structured JSON envelope to stdout (success) or stderr (error)"
88
- }
72
+ json: JSON_ARG
89
73
  };
90
74
  /** Severities that count toward the exit-4 "findings present" status. */
91
75
  const isFindingSeverity = (s) => s === "finding" || s === "warning";
@@ -160,6 +144,7 @@ const bundle = defineBaerlySubcommand({
160
144
  app: args.app,
161
145
  tenant: args.tenant
162
146
  });
147
+ assertCollectionArg(args.collection, "baerly admin fsck");
163
148
  const bucket = await parseBucketUri(args.bucket);
164
149
  const collectionPrefix = `${bucket.keyPrefix}app/${app}/tenant/${tenant}/manifests/${args.collection}`;
165
150
  const currentJsonKey = `${collectionPrefix}/current.json`;
@@ -224,7 +209,6 @@ const bundle = defineBaerlySubcommand({
224
209
  if (read === null) throw new BaerlyError("InvalidConfig", `baerly admin fsck: current.json not found at ${currentJsonKey}`);
225
210
  const cur = read.json;
226
211
  const logFrom = cur.log_seq_start ?? 0;
227
- const logToExcl = cur.next_seq;
228
212
  const snapshotKey = cur.snapshot;
229
213
  if (snapshotKey !== null) try {
230
214
  await loadSnapshotAsMap(bucket.storage, snapshotKey, args.collection);
@@ -240,19 +224,24 @@ const bundle = defineBaerlySubcommand({
240
224
  const logPrefix = `${collectionPrefix}/log/`;
241
225
  const presentKeys = await listKeys(bucket.storage, logPrefix);
242
226
  const presentSeqs = /* @__PURE__ */ new Set();
227
+ let maxSeq = logFrom - 1;
243
228
  for (const key of presentKeys) {
244
229
  const tail = key.slice(logPrefix.length);
245
230
  const match = /^(\d+)\.json$/.exec(tail);
246
231
  if (match === null) continue;
247
232
  const seq = Number.parseInt(match[1], 10);
248
- if (Number.isFinite(seq)) presentSeqs.add(seq);
233
+ if (Number.isFinite(seq)) {
234
+ presentSeqs.add(seq);
235
+ if (seq > maxSeq) maxSeq = seq;
236
+ }
249
237
  }
238
+ const logToExcl = Math.max(cur.tail_hint, maxSeq + 1);
250
239
  let logEntriesPresent = 0;
251
240
  for (let s = logFrom; s < logToExcl; s++) if (presentSeqs.has(s)) logEntriesPresent++;
252
241
  else findings.push({
253
242
  severity: "finding",
254
243
  check: "log",
255
- message: `missing log entry at seq ${s} inside [log_seq_start, next_seq)`,
244
+ message: `missing log entry at seq ${s} inside [log_seq_start, tail)`,
256
245
  key: `${logPrefix}${s}.json`
257
246
  });
258
247
  if (isJsonMode()) emitSuccess({
@@ -287,4 +276,4 @@ bundle.run;
287
276
  //#endregion
288
277
  export { fsckCmd };
289
278
 
290
- //# sourceMappingURL=fsck-CPPZWt9p.js.map
279
+ //# sourceMappingURL=fsck-D_djMO5D.js.map
@@ -0,0 +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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"}