@gusto/baerly-storage 0.2.0 → 0.3.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.
- package/LICENSE +202 -0
- package/NOTICE +29 -0
- package/README.md +93 -52
- package/dist/API.md +151 -109
- package/dist/CHANGELOG.md +144 -0
- package/dist/THIRD-PARTY-LICENSES.txt +312 -0
- package/dist/{app-config-C0Bbw_Z6.d.ts → app-config-BIzyAKzy.d.ts} +14 -2
- package/dist/app-config.d.ts +1 -1
- package/dist/auth.d.ts +1 -1
- package/dist/auth.js +288 -288
- package/dist/auth.js.map +1 -1
- package/dist/baerly.js +10 -10
- package/dist/baerly.js.map +1 -1
- package/dist/bytes-BXdamO3L.js.map +1 -1
- package/dist/{client-DYZfoZb9.d.ts → client-BJXF3XJA.d.ts} +10 -10
- package/dist/client-react.d.ts +3 -3
- package/dist/client-react.js.map +1 -1
- package/dist/client.d.ts +3 -3
- package/dist/client.js.map +1 -1
- package/dist/{cloudflare-CINJPKCW.js → cloudflare-Cn2ibODt.js} +178 -2
- package/dist/cloudflare-Cn2ibODt.js.map +1 -0
- package/dist/cloudflare.d.ts +4 -4
- package/dist/cloudflare.js +10 -11
- package/dist/cloudflare.js.map +1 -1
- package/dist/{subcommand-DZcHcsYp.js → config-CGyBopy3.js} +643 -439
- package/dist/config-CGyBopy3.js.map +1 -0
- package/dist/context-DRZ3tZ5l.js.map +1 -1
- package/dist/{cost-CQt1YRkA.js → cost-BZ_MDBmn.js} +6 -4
- package/dist/cost-BZ_MDBmn.js.map +1 -0
- package/dist/{current-json-C-EyJqs0.js → current-json-DsN7FNY1.js} +47 -13
- package/dist/current-json-DsN7FNY1.js.map +1 -0
- package/dist/{db-BM3y2JQw.d.ts → db-CCT6tDfY.d.ts} +26 -108
- package/dist/{deploy-CrAbfgCq.js → deploy-BKKyGlSJ.js} +11 -4
- package/dist/deploy-BKKyGlSJ.js.map +1 -0
- package/dist/dev-vite.d.ts +5 -5
- package/dist/dev-vite.js +5 -5
- package/dist/dev-vite.js.map +1 -1
- package/dist/dev.d.ts +1 -1
- package/dist/dev.js +1 -1
- package/dist/{doctor-Db-hzPmE.js → doctor-BVU4GNXN.js} +13 -132
- package/dist/doctor-BVU4GNXN.js.map +1 -0
- package/dist/{dump-BYA55NLP.js → dump-DPEAKub6.js} +5 -3
- package/dist/dump-DPEAKub6.js.map +1 -0
- package/dist/errors-DOdL95kK.js.map +1 -1
- package/dist/{export-Bhbz90-z.js → export-BcuCLFFe.js} +6 -4
- package/dist/{export-Bhbz90-z.js.map → export-BcuCLFFe.js.map} +1 -1
- package/dist/{fsck-CPPZWt9p.js → fsck-RXgLOaJG.js} +23 -11
- package/dist/fsck-RXgLOaJG.js.map +1 -0
- package/dist/{http-Cw8p6y5b.js → http-Bd4byR4n.js} +45 -61
- package/dist/http-Bd4byR4n.js.map +1 -0
- package/dist/http.d.ts +15 -15
- package/dist/http.js +1 -1
- package/dist/{index-cUY-36AN.d.ts → index-BDceQQi-.d.ts} +20 -4
- package/dist/{index-C3JAH1Yo.d.ts → index-Cmsxx-ZN.d.ts} +9 -9
- package/dist/{index-DSvwEUeF.d.ts → index-DW7GT6M2.d.ts} +50 -42
- package/dist/{index-DwDTWPSU.d.ts → index-DnBGSeuU.d.ts} +10 -7
- package/dist/index.d.ts +6 -6
- package/dist/index.js +4 -4
- package/dist/{indexes-DAu2AkTW.d.ts → indexes-Cx7uMXm0.d.ts} +2 -2
- package/dist/{inspect-Bdbzvi-_.js → inspect-DhI49PSi.js} +16 -8
- package/dist/inspect-DhI49PSi.js.map +1 -0
- package/dist/{snapshot-SS8USDUF.js → log-tail-DXeDkWEp.js} +154 -83
- package/dist/log-tail-DXeDkWEp.js.map +1 -0
- package/dist/{maintenance-BRrThz8V.d.ts → maintenance-BkhUr72A.d.ts} +91 -26
- package/dist/{maintenance-ClzBC1Vv.js → maintenance-CWBQpZ2y.js} +368 -161
- package/dist/maintenance-CWBQpZ2y.js.map +1 -0
- package/dist/{maintenance-BvOv6BMM.js → maintenance-C_KSkVjd.js} +204 -82
- package/dist/maintenance-C_KSkVjd.js.map +1 -0
- package/dist/maintenance.d.ts +3 -2
- package/dist/maintenance.js +3 -2
- package/dist/node.d.ts +13 -8
- package/dist/node.js +1 -1
- package/dist/normalize-XWY25_sG.js.map +1 -1
- package/dist/{observability-CpOiEN0k.js → observability-BYd-RzEx.js} +63 -55
- package/dist/observability-BYd-RzEx.js.map +1 -0
- package/dist/observability.d.ts +3 -3
- package/dist/observability.js +1 -1
- package/dist/{plan-DOTl21vq.js → plan-DIu_B6fy.js} +7 -4
- package/dist/plan-DIu_B6fy.js.map +1 -0
- package/dist/{query-BmiQy328.js → query-sQNO5vU_.js} +1071 -1099
- package/dist/query-sQNO5vU_.js.map +1 -0
- package/dist/{rebuild-index-DC_nR6wP.js → rebuild-index-DP4CqSSs.js} +5 -4
- package/dist/rebuild-index-DP4CqSSs.js.map +1 -0
- package/dist/{restore-C6IcmLeA.js → restore-DpQYef6r.js} +362 -328
- package/dist/restore-DpQYef6r.js.map +1 -0
- package/dist/shared-secret-BJdSwpgw.js.map +1 -1
- package/dist/{src-QQ7jDeL2.js → src-CWpkSbvJ.js} +40 -20
- package/dist/src-CWpkSbvJ.js.map +1 -0
- package/dist/{src-DU1sCMlr.js → src-D24wDpzR.js} +269 -258
- package/dist/src-D24wDpzR.js.map +1 -0
- package/dist/{src-zhEAmmF7.js → src-Db4-qVtM.js} +36 -96
- package/dist/src-Db4-qVtM.js.map +1 -0
- package/dist/subcommand-CP9NY2J4.js +159 -0
- package/dist/subcommand-CP9NY2J4.js.map +1 -0
- package/dist/{usage-CLjirdD-.js → usage-CTfDq9HR.js} +3 -3
- package/dist/{usage-CLjirdD-.js.map → usage-CTfDq9HR.js.map} +1 -1
- package/dist/{validate-DCq_0DIn.js → validate-DtljsCh1.js} +51 -51
- package/dist/{validate-DCq_0DIn.js.map → validate-DtljsCh1.js.map} +1 -1
- package/package.json +40 -29
- package/dist/cloudflare-CINJPKCW.js.map +0 -1
- package/dist/config-DVfDGyw1.js +0 -278
- package/dist/config-DVfDGyw1.js.map +0 -1
- package/dist/cost-CQt1YRkA.js.map +0 -1
- package/dist/current-json-C-EyJqs0.js.map +0 -1
- package/dist/deploy-CrAbfgCq.js.map +0 -1
- package/dist/doctor-Db-hzPmE.js.map +0 -1
- package/dist/dump-BYA55NLP.js.map +0 -1
- package/dist/fsck-CPPZWt9p.js.map +0 -1
- package/dist/http-Cw8p6y5b.js.map +0 -1
- package/dist/inspect-Bdbzvi-_.js.map +0 -1
- package/dist/maintenance-BvOv6BMM.js.map +0 -1
- package/dist/maintenance-ClzBC1Vv.js.map +0 -1
- package/dist/observability-CpOiEN0k.js.map +0 -1
- package/dist/plan-DOTl21vq.js.map +0 -1
- package/dist/query-BmiQy328.js.map +0 -1
- package/dist/rebuild-index-DC_nR6wP.js.map +0 -1
- package/dist/restore-C6IcmLeA.js.map +0 -1
- package/dist/snapshot-SS8USDUF.js.map +0 -1
- package/dist/src-DU1sCMlr.js.map +0 -1
- package/dist/src-QQ7jDeL2.js.map +0 -1
- package/dist/src-zhEAmmF7.js.map +0 -1
- package/dist/subcommand-DZcHcsYp.js.map +0 -1
package/dist/src-QQ7jDeL2.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"src-QQ7jDeL2.js","names":["#root","#pathFor"],"sources":["../node_modules/.pnpm/picocolors@1.1.1/node_modules/picocolors/picocolors.browser.js","../packages/dev/src/dev-banner.ts","../packages/dev/src/dev-landing.ts","../packages/dev/src/ensure-table.ts","../packages/dev/src/local-fs.ts"],"sourcesContent":["var x=String;\nvar create=function() {return {isColorSupported:false,reset:x,bold:x,dim:x,italic:x,underline:x,inverse:x,hidden:x,strikethrough:x,black:x,red:x,green:x,yellow:x,blue:x,magenta:x,cyan:x,white:x,gray:x,bgBlack:x,bgRed:x,bgGreen:x,bgYellow:x,bgBlue:x,bgMagenta:x,bgCyan:x,bgWhite:x,blackBright:x,redBright:x,greenBright:x,yellowBright:x,blueBright:x,magentaBright:x,cyanBright:x,whiteBright:x,bgBlackBright:x,bgRedBright:x,bgGreenBright:x,bgYellowBright:x,bgBlueBright:x,bgMagentaBright:x,bgCyanBright:x,bgWhiteBright:x}};\nmodule.exports=create();\nmodule.exports.createColors = create;\n","import { createColors } from \"picocolors\";\n\nexport interface DevBannerHint {\n readonly key: string;\n readonly value: string;\n}\n\nexport interface DevBannerOpts {\n readonly name: string;\n readonly primaryUrl?: { readonly label: string; readonly url: string };\n readonly apiUrl?: { readonly label: string; readonly url: string; readonly note?: string };\n readonly hints?: ReadonlyArray<DevBannerHint>;\n /** Force plain-text output (no color, no `←`). Defaults to !isTTY || CI. */\n readonly plain?: boolean;\n /** Sink. Defaults to process.stderr. */\n readonly write?: (chunk: string) => void;\n}\n\nexport function printDevBanner(opts: DevBannerOpts): void {\n const isPlain =\n opts.plain !== undefined\n ? opts.plain\n : process.env[\"CI\"] !== undefined || !process.stderr.isTTY;\n const write = opts.write ?? ((chunk) => process.stderr.write(chunk));\n const pc = createColors(!isPlain);\n const hints = opts.hints ?? [];\n\n const lines: string[] = [];\n\n if (isPlain) {\n lines.push(`baerly · ${opts.name}`);\n\n if (opts.primaryUrl) {\n lines.push(`${opts.primaryUrl.label}: ${opts.primaryUrl.url}`);\n }\n if (opts.apiUrl) {\n const note = opts.apiUrl.note ? ` (${opts.apiUrl.note})` : \"\";\n lines.push(`${opts.apiUrl.label}: ${opts.apiUrl.url}${note}`);\n }\n for (const hint of hints) {\n lines.push(`${hint.key}: ${hint.value}`);\n }\n write(lines.join(\"\\n\") + \"\\n\");\n } else {\n lines.push(pc.bold(pc.cyan(`▎ baerly · ${opts.name}`)));\n lines.push(\"\");\n\n if (opts.primaryUrl) {\n const marker = ` ${pc.green(\"← open this\")}`;\n lines.push(` ${pc.dim(opts.primaryUrl.label)} → ${opts.primaryUrl.url}${marker}`);\n }\n if (opts.apiUrl) {\n const note = opts.apiUrl.note ? ` ${pc.dim(`(${opts.apiUrl.note})`)}` : \"\";\n lines.push(` ${pc.dim(opts.apiUrl.label)} → ${opts.apiUrl.url}${note}`);\n }\n if ((opts.primaryUrl || opts.apiUrl) && hints.length > 0) {\n lines.push(\"\");\n }\n if (hints.length > 0) {\n const maxKeyLen = Math.max(...hints.map((h) => h.key.length));\n for (const hint of hints) {\n lines.push(` ${pc.dim(hint.key.padEnd(maxKeyLen))} ${hint.value}`);\n }\n }\n lines.push(\"\");\n write(lines.join(\"\\n\"));\n }\n}\n","/**\n * Dev landing page for the API root (`GET /`).\n *\n * The HTTP surface is API-only: every path outside `/v1/*`\n * returns the {@link HttpErrorEnvelope} 404 shape. That's correct for\n * production but confusing in local dev — a user who clicks the\n * `http://localhost:3000` link in their terminal sees a JSON 404 and\n * assumes the server is broken.\n *\n * Adapters that wire the {@link DevLandingOptions} opt-in surface a\n * small HTML page on `GET /` instead: app label, a clickable link to\n * the UI, a `/v1/healthz` probe link, and a note that `/v1/c/*` is\n * auth-gated. `GET /favicon.ico` answers 204 so browsers don't pin a\n * second JSON 404 next to the landing page.\n *\n * Production deployments leave the option unset; the 404 falls\n * through to the existing envelope.\n */\n\n/** Options for {@link renderDevLanding}. */\nexport interface DevLandingOptions {\n /** Bucket-prefix / app name (typically passed through from the adapter's `app` option). */\n readonly app: string;\n /** URL of the human-facing UI (e.g., `\"http://localhost:5173\"`). */\n readonly uiUrl: string;\n}\n\n/**\n * Render the dev landing page HTML. Dependency-free; system fonts\n * only; no JS. All substitutions are HTML-escaped to keep the page\n * inert even when `app` / `uiUrl` come from env vars.\n */\nexport const renderDevLanding = (opts: DevLandingOptions): string => {\n const label = escapeHtml(opts.app);\n const app = escapeHtml(opts.app);\n const uiUrl = escapeHtml(opts.uiUrl);\n return `<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\">\n<title>${label} — baerly api</title>\n<style>\n body { font-family: ui-sans-serif, system-ui, -apple-system, sans-serif; max-width: 40rem; margin: 3rem auto; padding: 0 1.5rem; color: #222; line-height: 1.5; }\n h1 { font-size: 1.25rem; margin: 0 0 0.25rem; }\n p.tag { color: #666; margin: 0 0 1.5rem; font-size: 0.9rem; }\n a { color: #06c; }\n ul { padding-left: 1.25rem; }\n li { margin: 0.25rem 0; }\n code { background: #f3f3f3; padding: 0.1em 0.35em; border-radius: 3px; font-size: 0.9em; }\n</style>\n</head>\n<body>\n<h1>${label}</h1>\n<p class=\"tag\">baerly api server · app <code>${app}</code></p>\n<p>This is the API server. The UI lives at <a href=\"${uiUrl}\">${uiUrl}</a>.</p>\n<ul>\n <li>Open the UI: <a href=\"${uiUrl}\">${uiUrl}</a></li>\n <li>Health probe: <a href=\"/v1/healthz\">/v1/healthz</a></li>\n <li>CRUD routes under <code>/v1/c/*</code> require an auth header and aren't clickable from here.</li>\n</ul>\n</body>\n</html>\n`;\n};\n\nconst escapeHtml = (s: string): string =>\n s.replace(/[&<>\"']/g, (c) => {\n switch (c) {\n case \"&\": {\n return \"&\";\n }\n case \"<\": {\n return \"<\";\n }\n case \">\": {\n return \">\";\n }\n case '\"': {\n return \""\";\n }\n default: {\n return \"'\";\n }\n }\n });\n","import {\n BaerlyError,\n CURRENT_JSON_SCHEMA_VERSION,\n createCurrentJson,\n type Storage,\n} from \"@baerly/protocol\";\n\n/**\n * Optional pre-warm: idempotently create the `current.json` manifest\n * for a single `(app, tenant, table)` triple. The kernel auto-creates\n * this manifest on the first commit anyway (see `Db.create` and\n * `Writer.commit`), so calling `ensureTable` is **not required** for\n * correctness — it's a one-Class-A-PUT optimization for callers that\n * want the manifest in place before the first request lands (seed\n * scripts, deploy-time provisioning, CI fixtures that snapshot the\n * bucket between phases, etc.).\n *\n * Wraps {@link createCurrentJson} with the canonical key shape\n * (`app/<app>/tenant/<tenant>/manifests/<table>/current.json`) and\n * swallows `BaerlyError{code:\"Conflict\"}` so re-runs are safe. An\n * existing manifest is preserved verbatim — this function never\n * overwrites a populated manifest. The seed shape matches the\n * kernel's auto-create exactly, so a pre-warm and an\n * auto-provisioned bucket are byte-identical.\n *\n * @example\n * ```ts\n * import { LocalFsStorage, ensureTable } from \"@gusto/baerly-storage/dev\";\n *\n * const storage = new LocalFsStorage({ root: \"./.baerly-data\" });\n * // Pre-warm so the first request doesn't pay the bootstrap PUT.\n * await ensureTable(storage, { app: \"helpdesk\", tenant: \"demo\", table: \"tickets\" });\n * // …then `baerlyNode({ config, storage, verifier })`.\n * ```\n */\nexport const ensureTable = async (\n storage: Storage,\n args: { app: string; tenant: string; table: string },\n): Promise<void> => {\n const key = `app/${args.app}/tenant/${args.tenant}/manifests/${args.table}/current.json`;\n try {\n await createCurrentJson(storage, key, {\n schema_version: CURRENT_JSON_SCHEMA_VERSION,\n snapshot: null,\n next_seq: 0,\n log_seq_start: 0,\n writer_fence: { epoch: 0, owner: \"\", claimed_at: \"\" },\n tail_bytes: 0,\n snapshot_bytes: 0,\n snapshot_rows: 0,\n });\n } catch (error) {\n if (error instanceof BaerlyError && error.code === \"Conflict\") {\n return;\n }\n throw error;\n }\n};\n","import { createHash } from \"node:crypto\";\nimport { mkdir, readdir, readFile, rename, rm, writeFile } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { dirname, join, posix, relative, resolve, sep } from \"node:path\";\nimport {\n BaerlyError,\n type Storage,\n type StorageGetOptions,\n type StorageGetResult,\n type StorageListEntry,\n type StoragePutOptions,\n type StoragePutResult,\n} from \"@baerly/protocol\";\n\nexport interface LocalFsStorageOptions {\n /** Root directory; treated as \"the bucket\". */\n root: string;\n}\n\nconst utf8Encoder = new TextEncoder();\n\n/**\n * Compare two keys by their UTF-8 byte sequences — the order S3 and R2\n * use for `list`. JS's default string sort compares UTF-16 code units,\n * which diverges from UTF-8 byte order for supplementary-plane\n * characters; using this keeps `list` ordering faithful to the real\n * adapters. (All kernel keys are ASCII base-32, where both orders\n * coincide.)\n */\nconst compareKeysUtf8 = (a: string, b: string): number => {\n const ba = utf8Encoder.encode(a);\n const bb = utf8Encoder.encode(b);\n const n = Math.min(ba.length, bb.length);\n for (let i = 0; i < n; i++) {\n if (ba[i] !== bb[i]) {\n return ba[i]! - bb[i]!;\n }\n }\n return ba.length - bb.length;\n};\n\n/**\n * `Storage` backed by a directory tree. Keys may contain `/` and map\n * to nested directories on disk so `ls`/`cat` work as expected.\n *\n * ETags are content-addressed: `\"<sha-256-hex>\"` (the surrounding\n * double-quotes match S3's wire format for non-multipart objects).\n * Identical bodies share an ETag across runs — the property that\n * makes this adapter useful for fixture-based tests.\n *\n * Writes are atomic via `writeFile(temp) + rename(final)`; readers\n * never see a partially-written file. The adapter does NOT coordinate\n * cross-process `ifMatch`/`ifNoneMatch` checks (a TOCTOU race is\n * possible if two processes write the same key concurrently).\n * Single-process `baerlyDev()` is the design center; multi-process\n * scenarios use the S3 / Minio path.\n *\n * Node-only — imports `node:fs`, `node:path`, `node:crypto`. Lives in\n * `@baerly/dev` because the protocol kernel is pure-modules / no I/O\n * and must remain Worker-bundleable.\n */\nexport class LocalFsStorage implements Storage {\n readonly #root: string;\n\n constructor(opts: LocalFsStorageOptions) {\n this.#root = resolve(opts.root);\n }\n\n async get(key: string, opts?: StorageGetOptions): Promise<StorageGetResult | null> {\n opts?.signal?.throwIfAborted();\n const path = this.#pathFor(key);\n let body: Buffer;\n try {\n body = await readFile(path);\n } catch (error) {\n if (isErrnoException(error) && error.code === \"ENOENT\") {\n return null;\n }\n throw new BaerlyError(\n \"InvalidResponse\",\n `LocalFsStorage.get(${key}): ${(error as Error).message}`,\n error,\n );\n }\n const etag = etagOf(body);\n if (opts?.ifNoneMatch !== undefined && opts.ifNoneMatch === etag) {\n // 304 Not Modified — caller's cached copy is current.\n return null;\n }\n return { body: toUint8Array(body), etag };\n }\n\n async put(key: string, body: Uint8Array, opts?: StoragePutOptions): Promise<StoragePutResult> {\n opts?.signal?.throwIfAborted();\n const path = this.#pathFor(key);\n const newEtag = etagOf(body);\n\n if (opts?.ifMatch !== undefined || opts?.ifNoneMatch === \"*\") {\n // TOCTOU within a process — fine. Cross-process callers should\n // not rely on these guards (see class JSDoc).\n const existing = await readExisting(path);\n if (opts?.ifNoneMatch === \"*\" && existing !== null) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifNoneMatch=\"*\" but key exists)`,\n );\n }\n if (opts?.ifMatch !== undefined) {\n if (existing === null) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifMatch=${opts.ifMatch} but key does not exist)`,\n );\n }\n const currentEtag = etagOf(existing);\n if (currentEtag !== opts.ifMatch) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifMatch=${opts.ifMatch} but current ETag is ${currentEtag})`,\n );\n }\n }\n }\n\n await mkdir(dirname(path), { recursive: true });\n // Write to a unique temp path then rename for atomicity. Temp lives\n // in `os.tmpdir()` so a half-written file never appears under the\n // bucket root where `list` might see it. PID + timestamp + random\n // tail makes the name unique across concurrent writers in the same\n // process.\n const tmp = join(\n tmpdir(),\n `baerly-localfs-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}`,\n );\n await writeFile(tmp, body);\n try {\n await rename(tmp, path);\n } catch (error) {\n // Best-effort cleanup of the temp file; swallow any error there\n // so the original failure surfaces unchanged.\n await rm(tmp, { force: true }).catch(() => {});\n throw new BaerlyError(\n \"InvalidResponse\",\n `LocalFsStorage.put(${key}): ${(error as Error).message}`,\n error,\n );\n }\n return { etag: newEtag, serverDate: new Date() };\n }\n\n async delete(key: string, opts?: { signal?: AbortSignal }): Promise<void> {\n opts?.signal?.throwIfAborted();\n const path = this.#pathFor(key);\n try {\n await rm(path);\n } catch (error) {\n if (isErrnoException(error) && error.code === \"ENOENT\") {\n return;\n } // idempotent\n throw new BaerlyError(\n \"InvalidResponse\",\n `LocalFsStorage.delete(${key}): ${(error as Error).message}`,\n error,\n );\n }\n }\n\n async *list(\n prefix: string,\n opts?: {\n startAfter?: string;\n maxKeys?: number;\n signal?: AbortSignal;\n },\n ): AsyncIterable<StorageListEntry> {\n opts?.signal?.throwIfAborted();\n const startAfter = opts?.startAfter ?? \"\";\n const maxKeys = opts?.maxKeys ?? Infinity;\n const keys: string[] = [];\n await walk(this.#root, keys);\n keys.sort(compareKeysUtf8);\n let yielded = 0;\n for (const key of keys) {\n if (!key.startsWith(prefix)) {\n continue;\n }\n if (compareKeysUtf8(key, startAfter) <= 0) {\n continue;\n }\n if (yielded >= maxKeys) {\n return;\n }\n opts?.signal?.throwIfAborted();\n const buf = await readFile(this.#pathFor(key));\n yield { key, etag: etagOf(buf) };\n yielded += 1;\n }\n }\n\n /**\n * Map an S3-style key to a filesystem path under `#root`, rejecting\n * anything that could escape the root (path traversal, absolute\n * paths, empty segments, backslashes). All rejections throw\n * `BaerlyError(\"InvalidConfig\", …)`.\n */\n #pathFor(key: string): string {\n if (key.length === 0) {\n throw new BaerlyError(\"InvalidConfig\", \"LocalFsStorage: empty key\");\n }\n if (key.startsWith(\"/\")) {\n throw new BaerlyError(\"InvalidConfig\", `LocalFsStorage: leading \"/\" in key: ${key}`);\n }\n if (key.includes(\"\\\\\")) {\n throw new BaerlyError(\"InvalidConfig\", `LocalFsStorage: backslash in key: ${key}`);\n }\n const segments = key.split(\"/\");\n if (segments.some((s) => s === \"\" || s === \".\" || s === \"..\")) {\n throw new BaerlyError(\"InvalidConfig\", `LocalFsStorage: illegal segment in key: ${key}`);\n }\n const path = join(this.#root, ...segments);\n if (path !== this.#root && !path.startsWith(this.#root + sep)) {\n throw new BaerlyError(\"InvalidConfig\", `LocalFsStorage: resolved path escapes root: ${key}`);\n }\n return path;\n }\n}\n\nconst etagOf = (body: Uint8Array): string => {\n const h = createHash(\"sha256\").update(body).digest(\"hex\");\n return `\"${h}\"`;\n};\n\nconst toUint8Array = (buf: Buffer): Uint8Array =>\n new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);\n\nconst isErrnoException = (e: unknown): e is NodeJS.ErrnoException =>\n typeof e === \"object\" && e !== null && \"code\" in e;\n\nconst readExisting = async (path: string): Promise<Buffer | null> => {\n try {\n return await readFile(path);\n } catch (error) {\n if (isErrnoException(error) && error.code === \"ENOENT\") {\n return null;\n }\n throw error;\n }\n};\n\n/**\n * Recursive directory walk. Yields filesystem-relative paths in\n * forward-slash form so callers can use them as S3-style keys\n * regardless of the host's path separator.\n */\nconst walk = async (root: string, out: string[]): Promise<void> => {\n const stack: string[] = [root];\n while (stack.length > 0) {\n const dir = stack.pop()!;\n let entries;\n try {\n entries = await readdir(dir, { withFileTypes: true });\n } catch (error) {\n if (isErrnoException(error) && error.code === \"ENOENT\") {\n continue;\n }\n throw error;\n }\n for (const entry of entries) {\n const full = join(dir, entry.name);\n if (entry.isDirectory()) {\n stack.push(full);\n } else if (entry.isFile()) {\n out.push(relative(root, full).split(sep).join(posix.sep));\n }\n }\n }\n};\n"],"x_google_ignoreList":[0],"mappings":"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"}
|
package/dist/src-zhEAmmF7.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"src-zhEAmmF7.js","names":["#objects","#etagCounter","#nextEtag","#storage","#schemas","#indexes"],"sources":["../packages/protocol/src/storage/memory.ts","../packages/server/src/config.ts","../packages/server/src/auth/internal/none-verifier.ts","../packages/server/src/auth/internal/resolve-verifier.ts","../packages/server/src/collection.ts","../packages/server/src/db.ts"],"sourcesContent":["import { BaerlyError } from \"../errors.ts\";\nimport type {\n Storage,\n StorageGetOptions,\n StorageGetResult,\n StorageListEntry,\n StoragePutOptions,\n StoragePutResult,\n} from \"./types.ts\";\n\ninterface StoredObject {\n body: Uint8Array;\n etag: string;\n contentType?: string;\n}\n\nconst utf8Encoder = new TextEncoder();\n\n/**\n * Compare two keys by their UTF-8 byte sequences — the order S3 and\n * R2 use for `list`. JavaScript's default string sort compares UTF-16\n * code units, which diverges from UTF-8 byte order for supplementary-\n * plane characters (e.g. emoji sort before high-BMP characters under\n * UTF-16 but after them in UTF-8). Using this keeps the in-memory\n * reference backend faithful to the real adapters. (All kernel keys\n * are ASCII base-32, where the two orders coincide — this only\n * matters for adversarial / non-ASCII keys.)\n */\nconst compareKeysUtf8 = (a: string, b: string): number => {\n const ba = utf8Encoder.encode(a);\n const bb = utf8Encoder.encode(b);\n const n = Math.min(ba.length, bb.length);\n for (let i = 0; i < n; i++) {\n if (ba[i] !== bb[i]) {\n return ba[i]! - bb[i]!;\n }\n }\n return ba.length - bb.length;\n};\n\n/**\n * In-memory `Storage`. The randomized property test runs against\n * this; it must be deterministic — no clocks beyond the caller's,\n * no randomness, no I/O.\n *\n * ETags are a monotonically increasing hex counter formatted in the\n * `\"<hex>\"` shape S3 returns (the surrounding double-quotes are part\n * of the ETag header value). Keys are stored verbatim.\n *\n * **Test-confidence caveat:** every method resolves on the microtask\n * queue with no real concurrency, so `put` reads `existing` and writes\n * back with no interleaving. MemoryStorage therefore CANNOT exercise the\n * compare-and-swap race the writer-fence model depends on — two writers\n * contending on one `current.json` always serialize here, so a green run\n * is necessary but not sufficient. That race is covered only by the\n * randomized integration tests against real S3 / Minio\n * (`tests/integration/randomized.test.ts`, `node-minio` variant).\n * Relatedly, `serverDate` returns the local clock, not an independent\n * server clock (see the `put` return below).\n */\nexport class MemoryStorage implements Storage {\n readonly #objects = new Map<string, StoredObject>();\n #etagCounter = 0;\n\n #nextEtag(): string {\n this.#etagCounter += 1;\n return `\"${this.#etagCounter.toString(16)}\"`;\n }\n\n async get(key: string, opts?: StorageGetOptions): Promise<StorageGetResult | null> {\n opts?.signal?.throwIfAborted();\n const stored = this.#objects.get(key);\n if (stored === undefined) {\n return null;\n }\n if (opts?.ifNoneMatch !== undefined && opts.ifNoneMatch === stored.etag) {\n // 304 Not Modified — caller's cached copy is current.\n return null;\n }\n return { body: stored.body, etag: stored.etag };\n }\n\n async put(key: string, body: Uint8Array, opts?: StoragePutOptions): Promise<StoragePutResult> {\n opts?.signal?.throwIfAborted();\n const existing = this.#objects.get(key);\n\n if (opts?.ifNoneMatch === \"*\" && existing !== undefined) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifNoneMatch=\"*\" but key exists)`,\n );\n }\n if (opts?.ifMatch !== undefined) {\n if (existing === undefined) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifMatch=${opts.ifMatch} but key does not exist)`,\n );\n }\n if (existing.etag !== opts.ifMatch) {\n throw new BaerlyError(\n \"Conflict\",\n `PUT ${key}: precondition failed (ifMatch=${opts.ifMatch} but current ETag is ${existing.etag})`,\n );\n }\n }\n\n const etag = this.#nextEtag();\n this.#objects.set(key, {\n body,\n etag,\n // Stryker disable next-line ObjectLiteral,ConditionalExpression: contentType is stored in the internal StoredObject but never returned by get() — the Storage interface has no contentType on StorageGetResult, so any mutation of this spread is observable-equivalent\n ...(opts?.contentType !== undefined && { contentType: opts.contentType }),\n });\n // `serverDate` is intentionally returned — the kernel's adaptive\n // clock-skew loop consumes the write-time server clock. `list()`\n // deliberately omits `lastModified`: the in-memory impl has no\n // independent server clock, and its only consumer (GC's `due_at`\n // anchor) falls back to `now()` when it is absent, so omitting it\n // changes nothing.\n return { etag, serverDate: new Date() };\n }\n\n async delete(key: string, opts?: { signal?: AbortSignal }): Promise<void> {\n opts?.signal?.throwIfAborted();\n this.#objects.delete(key);\n }\n\n async *list(\n prefix: string,\n opts?: { startAfter?: string; maxKeys?: number; signal?: AbortSignal },\n ): AsyncIterable<StorageListEntry> {\n opts?.signal?.throwIfAborted();\n const startAfter = opts?.startAfter ?? \"\";\n const maxKeys = opts?.maxKeys ?? Infinity;\n const sorted = [...this.#objects.keys()]\n .filter((k) => k.startsWith(prefix) && compareKeysUtf8(k, startAfter) > 0)\n .toSorted(compareKeysUtf8);\n let yielded = 0;\n for (const key of sorted) {\n if (yielded >= maxKeys) {\n return;\n }\n opts?.signal?.throwIfAborted();\n const stored = this.#objects.get(key);\n // Stryker disable next-line ConditionalExpression,BlockStatement: unreachable guard — keys come from Map.keys() so the corresponding value is always present; this branch exists only to satisfy noUncheckedIndexedAccess\n if (stored === undefined) {\n continue;\n }\n yield { key, etag: stored.etag };\n yielded += 1;\n }\n }\n\n /**\n * Test-only: drop all objects.\n * @internal\n */\n _clear(): void {\n this.#objects.clear();\n this.#etagCounter = 0;\n }\n}\n\n// Process-singleton MemoryStorage map keyed by bucket. Tests that need\n// multiple `Db` / `Writer` instances to see each other's writes\n// against an in-memory backend reach for this via\n// {@link getOrCreateMemoryStorageForBucket}; {@link resetMemoryStorage}\n// drops every bucket between test cases.\nconst sharedPerBucket = new Map<string, MemoryStorage>();\n\n/**\n * Test isolation: drop every bucket's contents from the shared\n * memory storage used by {@link getOrCreateMemoryStorageForBucket}.\n * Direct `MemoryStorage` instances built via `new MemoryStorage()`\n * are unaffected — those are isolated by construction.\n */\nexport const resetMemoryStorage = (): void => {\n sharedPerBucket.clear();\n};\n\n/**\n * Get the process-singleton {@link MemoryStorage} for the named\n * bucket, creating one on first access. Use this when constructing\n * a `Storage` directly so multiple consumers in the same process\n * see each other's writes for the same bucket name.\n */\nexport const getOrCreateMemoryStorageForBucket = (bucket: string): MemoryStorage => {\n let s = sharedPerBucket.get(bucket);\n if (s === undefined) {\n s = new MemoryStorage();\n sharedPerBucket.set(bucket, s);\n }\n return s;\n};\n","/**\n * Runtime helpers for the `BaerlyConfig` shape.\n *\n * The type declarations (`BaerlyConfig`, `BaerlyAppConfig`,\n * `CollectionDefinition`, `CollectionNames`, `RowOf`, `UnboundConfig`,\n * `defineConfig`) live in `@baerly/protocol` — the cross-platform\n * package — so cross-platform consumers (client, scaffold\n * `baerly.config.ts`) can reference them without dragging the\n * Node-only server modules (`AsyncLocalStorage` etc.) into their\n * typecheck graph.\n *\n * This file keeps only the runtime helper `collectionsToMaps`, which\n * the Cloudflare and Node adapters call to flatten\n * `BaerlyConfig.collections` into the per-collection maps that\n * `Db.create` consumes.\n *\n * @see @baerly/protocol app-config.ts — type declarations.\n */\n\nimport type { BaerlyConfig, IndexDefinition, SchemaValidator } from \"@baerly/protocol\";\n\n/**\n * Flatten `BaerlyConfig.collections` into the per-collection\n * `schemas` and `indexes` maps that {@link Db.create} consumes at\n * runtime. Used by the Cloudflare and Node adapters to pipe a\n * single `config` object through to the writer/planner.\n *\n * Both adapters import this helper rather than inlining the loop\n * so the projection rule (drop empty index arrays; omit absent\n * schemas) stays in one place. Future `CollectionDefinition`\n * fields (lifecycle hooks, replica_identity) land here too.\n */\nexport const collectionsToMaps = (\n collections: BaerlyConfig[\"collections\"] | undefined,\n): {\n schemas: ReadonlyMap<string, SchemaValidator>;\n indexes: ReadonlyMap<string, ReadonlyArray<IndexDefinition>>;\n} => {\n const schemas = new Map<string, SchemaValidator>();\n const indexes = new Map<string, ReadonlyArray<IndexDefinition>>();\n if (collections === undefined) {\n return { schemas, indexes };\n }\n for (const [name, def] of Object.entries(collections)) {\n if (def.schema !== undefined) {\n schemas.set(name, def.schema);\n }\n if (def.indexes !== undefined && def.indexes.length > 0) {\n indexes.set(name, def.indexes);\n }\n }\n return { schemas, indexes };\n};\n","import type { Verifier } from \"@baerly/protocol\";\n\n/**\n * Internal helper backing `config.auth === \"none\"`. Returns a\n * `Verifier` that resolves every request to the supplied\n * `tenantPrefix` with `identity: { kind: \"none\" }`. The kernel\n * NEVER reads the `Authorization` header in this mode — the network\n * seam itself is the trust boundary.\n *\n * Discriminant note: `identity.kind === \"none\"` distinguishes the\n * \"operator opted into auth=none in baerly.config.ts\" branch from the\n * bearer-token paths (`kind: \"shared-secret\"`, `kind: \"jwt\"`, etc).\n *\n * Not part of the public surface. Consumed by `baerlyWorker` /\n * `baerlyNode` resolution; the operator-facing API is the typed\n * `auth: \"none\"` field on `BaerlyAppConfig`.\n *\n * @internal\n */\nexport const noAuthVerifier = (tenantPrefix: string): Verifier => {\n return async () => ({ tenantPrefix, identity: { kind: \"none\" } });\n};\n","import {\n type BaerlyAppConfig,\n BaerlyError,\n NO_AUTH_CONFIGURED_MESSAGE,\n SHARED_SECRET_MISSING_MESSAGE,\n type Verifier,\n} from \"@baerly/protocol\";\nimport { sharedSecret } from \"../presets/shared-secret.ts\";\nimport { noAuthVerifier } from \"./none-verifier.ts\";\n\n/**\n * Read env var lazily via a host-supplied accessor so the same\n * resolver works in CF Workers (env binding) and Node\n * (`process.env`). Returns `undefined` for an unset OR empty string —\n * both branches mean \"operator forgot to set it\".\n */\nexport type EnvAccessor = (name: string) => string | undefined;\n\n/**\n * Inputs to {@link resolveVerifier}. `factoryVerifier` is the\n * adapter-factory `verifier:` option (may be undefined). `config`\n * carries the typed `auth` posture + the `tenant` pin. `readEnv`\n * is the per-host env accessor.\n */\nexport interface ResolveVerifierInput {\n readonly factoryVerifier: Verifier | undefined;\n readonly config: BaerlyAppConfig;\n readonly readEnv: EnvAccessor;\n}\n\n/**\n * Resolve the per-request `Verifier` for an adapter factory using the\n * fixed order:\n *\n * 1. `factoryVerifier` set → use as-is (highest precedence; enables\n * env-aware construction via `cloudflareAccess(env)` etc).\n * 2. else `config.auth === \"shared-secret\"` → read `SHARED_SECRET`\n * via `readEnv`; throw `BaerlyError(\"InvalidConfig\",\n * SHARED_SECRET_MISSING_MESSAGE)` when unset/empty; else build\n * `sharedSecret({ secret, tenantPrefix: config.tenant })`.\n * 3. else `config.auth === \"none\"` → `noAuthVerifier(config.tenant)`.\n * 4. else → throw `BaerlyError(\"InvalidConfig\",\n * NO_AUTH_CONFIGURED_MESSAGE)`.\n *\n * Pure function — no I/O, no side effects beyond `sharedSecret`'s\n * own validation. Caller invokes once at adapter init time (or on\n * first fetch, depending on platform `await`-at-top-level\n * constraints).\n *\n * @throws BaerlyError code=\"InvalidConfig\" — branches 2 and 4 above.\n *\n * @internal\n */\nexport const resolveVerifier = (input: ResolveVerifierInput): Verifier => {\n if (input.factoryVerifier !== undefined) {\n return input.factoryVerifier;\n }\n if (input.config.auth === \"shared-secret\") {\n const secret = input.readEnv(\"SHARED_SECRET\");\n if (secret === undefined || secret.length === 0) {\n throw new BaerlyError(\"InvalidConfig\", SHARED_SECRET_MISSING_MESSAGE);\n }\n return sharedSecret({ secret, tenantPrefix: input.config.tenant });\n }\n if (input.config.auth === \"none\") {\n return noAuthVerifier(input.config.tenant);\n }\n // Exhaustiveness backstop. The AuthConfig union is locked to\n // [\"none\", \"shared-secret\"]; reaching this branch means the caller\n // passed a config that has neither the typed field nor a factory\n // override. Same operator remediation as the type-level error.\n throw new BaerlyError(\"InvalidConfig\", NO_AUTH_CONFIGURED_MESSAGE);\n};\n","/**\n * `Collection<T>` factory. `Db.collection(name)` returns the result of\n * `makeCollection(ctx)` — a cheap, no-I/O handle. By-id mutations route\n * through dedicated runners: `insert` → `runInsert`,\n * `replace(id, doc)` → `runReplaceById`. `update(id, patch)` and\n * `delete(id)` forward to the predicate-form runners via a `byId`\n * wire — those Query verbs are genuinely bulk, so the by-id case is\n * just a one-row predicate.\n *\n * `Collection.insert(doc)` is the public insert path. The locked\n * `Query<T>` interface (`@baerly/protocol/src/collection-api.ts`) intentionally\n * does NOT declare `insert` — chainable inserts are out of scope.\n * For an inserted doc whose predicate-bound shape matters,\n * `db.collection(...).insert(...)` is the path; predicates are a read-\n * side concern.\n */\n\nimport {\n type Collection,\n type DocumentData,\n type OrderSpec,\n type PredicateWire,\n} from \"@baerly/protocol\";\nimport { makeQuery, runInsert, runReplaceById, type CollectionReadContext } from \"./query.ts\";\n\n/**\n * Build a `Collection<T>` bound to one `(tenant, collection)` read context.\n * Cheap: zero I/O, allocates one closure. Each modifier call returns\n * a FRESH `Query<T>` — calling `.where(p1)` and `.where(p2)` on the\n * same `Collection<T>` produces two independent chains.\n *\n * `.count()` shorthand defers to the empty-state `Query<T>.count()`\n * so the fold logic lives in one place.\n *\n * @example\n * ```ts\n * const collection = makeCollection<Ticket>({\n * storage,\n * collectionPrefix: \"app/tickets/tenant/acme/manifests/tickets\",\n * collectionName: \"tickets\",\n * });\n * const open = await collection.where({ status: \"open\" }).all();\n * ```\n *\n * @internal\n */\nexport const makeCollection = <T extends DocumentData>(\n ctx: CollectionReadContext,\n): Collection<T> => {\n // Empty seed state. Every modifier merges into a frozen copy.\n const seed = {\n wire: undefined as PredicateWire | undefined,\n order: undefined as OrderSpec<T> | undefined,\n limit: undefined as number | undefined,\n };\n // Kernel-internal `_id`-shaped wire. Bypasses `validateWire`\n // (which rejects top-level `_id`) by construction — the wire is\n // never wire-submitted; it short-circuits to `Map.get` via\n // `singleIdFromPredicate` inside `runRead`.\n const byId = (id: string) => ({\n ...seed,\n wire: { clauses: [{ op: \"eq\" as const, field: \"_id\", value: id }] } as PredicateWire,\n });\n return {\n name: ctx.collectionName,\n first: () => makeQuery<T>(ctx, seed).first(),\n all: () => makeQuery<T>(ctx, seed).all(),\n count: () => makeQuery<T>(ctx, seed).count(),\n get: (id) => makeQuery<T>(ctx, byId(id)).first(),\n where: (p) => makeQuery<T>(ctx, seed).where(p),\n order: (s) => makeQuery<T>(ctx, { ...seed, order: s }),\n limit: (n) => makeQuery<T>(ctx, { ...seed, limit: n }),\n /**\n * Insert one document. UUIDv7 auto-id when `_id` is absent or\n * empty; otherwise the caller-supplied `_id` is honoured. A\n * pre-commit existence check against the materialised collection\n * surfaces `Conflict` on duplicate `_id` without round-tripping\n * to the writer — matches the locked `Collection.insert` throws\n * contract (`@baerly/protocol/src/collection-api.ts`).\n *\n * Single-attempt per call: CAS retries (up to 8 attempts) live\n * inside `Writer.commit()`. On retry-budget exhaustion the\n * writer throws `Conflict` and we surface unchanged.\n *\n * @throws BaerlyError code=\"Conflict\" — `_id` collision (pre-commit\n * check) or CAS retry budget exhausted.\n * @throws BaerlyError code=\"SchemaError\" — from the per-collection\n * `SchemaValidator` threaded via {@link Db.collectionReadContext}.\n */\n insert: (doc) => runInsert<T>(ctx, doc),\n update: (id, patch) => makeQuery<T>(ctx, byId(id)).update(patch),\n replace: (id, doc) => runReplaceById<T>(ctx, id, doc),\n delete: (id) => makeQuery<T>(ctx, byId(id)).delete(),\n };\n};\n","import {\n type BaerlyConfig,\n BaerlyError,\n type Collection,\n type CollectionNames,\n type CurrentJsonRead,\n decodeJsonBytes,\n type DocumentData,\n type IndexDefinition,\n LOG_KEY_PREFIX,\n type LogEntry,\n readCurrentJson,\n type RowOf,\n type SchemaValidator,\n type Storage,\n type UnboundConfig,\n} from \"@baerly/protocol\";\nimport { collectionsToMaps } from \"./config.ts\";\nimport { assertNameNotReserved } from \"./names.ts\";\nimport type { CollectionReadContext } from \"./query.ts\";\nimport { Writer, type CommitInput } from \"./writer.ts\";\nimport { makeCollection } from \"./collection.ts\";\n\n/**\n * In-memory buffer for a single in-flight {@link Db.transaction}\n * call. The `Collection<T>` instance passed to the transaction body holds\n * a reference to this object; every mutation verb appends to\n * `mutations` instead of calling `Writer.commit` directly.\n *\n * After the body resolves, `Db.transaction` performs ONE\n * `Writer.commitBatch(...)` to commit every buffered mutation\n * in a single CAS attempt.\n *\n * @internal — referenced by `collection.ts` and `query.ts`; not part of\n * the public API surface for app code.\n */\nexport interface TxContext {\n /**\n * The collection name the transaction is scoped to. Mutation verbs\n * runtime-assert that their `Collection<T>`'s `name` matches this\n * field before appending — the type system already prevents the\n * legitimate path, this catches the bug path (a stale `Query<T>`\n * re-attached to a different collection's transaction).\n */\n readonly collection: string;\n\n /**\n * Mutations buffered in order of issuance. The commit converts\n * each into one `CommitInput` (`Writer`'s single-mutation\n * shape) and passes the array to `Writer.commitBatch`.\n */\n readonly mutations: BufferedMutation[];\n}\n\n/**\n * One buffered mutation. Mirrors {@link CommitInput} minus\n * `collection` (which is constant per transaction and lives on\n * `TxContext.collection`).\n *\n * @internal — only used inside the `Db.transaction` path.\n */\nexport interface BufferedMutation {\n readonly op: \"I\" | \"U\" | \"D\";\n readonly docId: string;\n readonly body?: DocumentData;\n readonly origin?: string;\n}\n\n/**\n * Physical-key prefix for a `(app, tenant)` pair. Trailing slash is\n * part of the prefix so a caller's `list(\"\")` resolves to\n * `list(\"app/<app>/tenant/<tenant>/\")` and cannot enumerate a sibling\n * tenant whose name shares a prefix.\n */\nconst physicalPrefixFor = (app: string, tenant: string): string => `app/${app}/tenant/${tenant}/`;\n\n/**\n * Runtime entry point. One `Db` per `(app, tenant)` request.\n *\n * Construct via {@link Db.create} — the constructor is private so\n * callers don't accidentally bypass validation.\n *\n * **Collection provisioning.** `Db` provisions collections implicitly on\n * the first commit — the writer auto-creates the per-collection\n * `current.json` manifest with a zero-state seed, costing one extra\n * Class A PUT on the very first write per collection and zero\n * thereafter. There is no `ensureCollection` method on this class. For\n * eager pre-warm (seed scripts, deploy-time provisioning, CI fixtures\n * that want byte-identical bytes before the first request), use\n * {@link \"@gusto/baerly-storage/dev\".ensureTable}.\n *\n * @example\n * ```ts\n * import { Db } from \"@gusto/baerly-storage\";\n * import { MemoryStorage } from \"@gusto/baerly-storage\";\n *\n * const db = Db.create({\n * storage: new MemoryStorage(),\n * app: \"tickets\",\n * tenant: \"acme-co\",\n * });\n *\n * await db.collection(\"tickets\").insert({ title: \"first ticket\", status: \"open\" });\n * const open = await db.collection(\"tickets\").where({ status: \"open\" }).all();\n * ```\n *\n * @remarks\n * **Anti-patterns** (TS compile errors, not runtime rejections):\n * - `db.collection(name).insertOne({...})` / `.insert({...})` —\n * the Mongo verb. Use `.insert(row)` (returns `{ _id }`).\n * - `db.collection(name).findOne({...})` / `.find({...})` —\n * the Mongo read verbs. Use `.get(id)` for by-id reads and\n * `.where({...}).first()` / `.all()` for predicate reads.\n * - `db.collection(name).aggregate([...])` — no pipeline stage\n * model. Compose via `.where().order().limit()` modifiers.\n * - Raw SQL strings of any shape. The kernel has no SQL parser.\n */\nexport class Db<TConfig extends BaerlyConfig = UnboundConfig> {\n readonly app: string;\n readonly tenant: string;\n /**\n * Underlying `Storage`, captured so the collection API can issue reads\n * using physical keys directly.\n */\n readonly #storage: Storage;\n /**\n * Per-collection {@link SchemaValidator}s threaded onto every\n * {@link CollectionReadContext} this `Db` mints. Empty map means \"no\n * validation declared\" — every write proceeds at zero overhead.\n *\n * Derived from `config.collections[*].schema` via\n * {@link collectionsToMaps} at {@link Db.create} time.\n */\n readonly #schemas: ReadonlyMap<string, SchemaValidator>;\n /**\n * Per-collection {@link IndexDefinition}s threaded onto every\n * {@link CollectionReadContext} this `Db` mints. Empty map means \"no\n * indexes declared\" — every read falls through to the snapshot +\n * log fold path.\n *\n * Derived from `config.collections[*].indexes` via\n * {@link collectionsToMaps} at {@link Db.create} time.\n */\n readonly #indexes: ReadonlyMap<string, ReadonlyArray<IndexDefinition>>;\n\n private constructor(\n app: string,\n tenant: string,\n storage: Storage,\n schemas: ReadonlyMap<string, SchemaValidator>,\n indexes: ReadonlyMap<string, ReadonlyArray<IndexDefinition>>,\n ) {\n this.app = app;\n this.tenant = tenant;\n this.#storage = storage;\n this.#schemas = schemas;\n this.#indexes = indexes;\n }\n\n /**\n * Build a tenant-scoped `Db`. Throws\n * `BaerlyError{code:\"InvalidConfig\"}` if either `app` or `tenant`\n * is empty or contains `/` (the segment separator).\n *\n * @throws BaerlyError code=\"InvalidConfig\" when `app` or `tenant` is\n * empty or contains `/`.\n *\n * @example\n * ```ts\n * const db = Db.create({ storage, app: \"tickets\", tenant: \"acme\" });\n * await db.collection(\"tickets\").insert({ title: \"hi\" });\n * ```\n */\n static create<TConfig extends BaerlyConfig = UnboundConfig>(config: {\n storage: Storage;\n app: string;\n tenant: string;\n /**\n * Optional. Pass the value returned by {@link defineConfig} from\n * your `baerly.config.ts`. Two things happen:\n *\n * 1. **Types.** `db.collection(name)` narrows `name` to declared\n * collection names and infers the row type from\n * `collections[name].schema` via {@link RowOf}.\n * 2. **Runtime.** Schemas and indexes are derived from\n * `config.collections` via {@link collectionsToMaps}. Schema\n * validation and index routing are wired automatically — no\n * second hand-off step.\n *\n * @example\n * ```ts\n * import config from \"../baerly.config.ts\";\n * const db = Db.create({\n * storage: new MemoryStorage(),\n * app: \"helpdesk\",\n * tenant: \"test\",\n * config,\n * });\n * // db.collection(\"tickets\") is typed AND validates writes against\n * // the schema declared in baerly.config.ts.\n * ```\n */\n config?: TConfig;\n }): Db<TConfig> {\n const { storage, app, tenant } = config;\n assertKeySegment(app, \"app\", \"Db.create\");\n assertKeySegment(tenant, \"tenant\", \"Db.create\");\n // Always derive runtime maps from `config.collections`. Absent\n // config ⇒ empty maps (no schemas, no indexes); the kernel\n // behaves the same as a config with `collections: {}`.\n const derived =\n config.config !== undefined ? collectionsToMaps(config.config.collections) : undefined;\n return new Db<TConfig>(\n app,\n tenant,\n storage,\n derived?.schemas ?? new Map(),\n derived?.indexes ?? new Map(),\n );\n }\n\n /**\n * Typed handle for a single collection. Cheap; creates no I/O. Same\n * `name` returns a FRESH `Collection<T>` object on each call (chain\n * identity is intentional — modifiers return new objects).\n *\n * @throws BaerlyError code=\"InvalidConfig\" when `name` is empty or\n * contains `/`.\n *\n * @example\n * ```ts\n * // With a baerly.config.ts bound via Db.create({..., config}),\n * // db.collection(name) infers the row type from the declared schema —\n * // no <Ticket> generic needed.\n * const open = await db.collection(\"tickets\")\n * .where({ status: \"open\" })\n * .order({ commit_ts: \"desc\" })\n * .limit(50)\n * .all();\n * ```\n */\n // One signature. When `TConfig` extends `UnboundConfig`,\n // `CollectionNames<UnboundConfig>` widens to `string` so kernel-internal\n // paths against `Db<UnboundConfig>` still resolve without a separate\n // untyped overload. The impl signature stays widened (`Collection<any>`)\n // — the runtime never narrows; `makeCollection<DocumentData>` builds a\n // single row-agnostic handle and TypeScript handles the rest at the\n // call site.\n collection<N extends CollectionNames<TConfig>>(\n name: N,\n ): Collection<RowOf<TConfig, N> & DocumentData>;\n // eslint-disable-next-line @typescript-eslint/no-explicit-any -- impl signature must be wider than the public overload; with Predicate<T> typed, Collection<DocumentData> is no longer assignable to Collection<RowOf<...>&DocumentData> due to contravariance on where(). `any` widens correctly.\n collection(name: string): Collection<any> {\n return makeCollection<DocumentData>(this.collectionReadContext(name));\n }\n\n /**\n * Build a freshly-seeded {@link CollectionReadContext} for `name`. The\n * HTTP router uses this so it can drive `runAllWithMeta` directly\n * (the return shape carries the manifest-pointer cursor used to\n * pack `_meta` onto the read response envelope). Application\n * callers should keep using\n * {@link Db.collection}; the chainable terminals destructure the cursor\n * out and discard it to keep the locked `Query<T>` signature.\n *\n * Runs the same `name`-validation guard as {@link Db.collection}.\n *\n * @throws BaerlyError code=\"InvalidConfig\" when `name` is empty or\n * contains `/`.\n * @internal\n */\n collectionReadContext(name: string): CollectionReadContext {\n assertKeySegment(name, \"collection\", \"Db.collection\");\n const schema = this.#schemas.get(name);\n return {\n storage: this.#storage,\n collectionPrefix: `${physicalPrefixFor(this.app, this.tenant)}manifests/${name}`,\n collectionName: name,\n indexes: this.#indexes.get(name) ?? [],\n ...(schema !== undefined ? { schema } : {}),\n };\n }\n\n /**\n * Atomic mutation over a single collection. The callback receives a\n * `Collection<T>` (not a `Db`) so cross-collection writes inside a\n * transaction are a TypeScript error at compile time — not a\n * runtime trap. Mutation verbs (`insert`, `update`, `replace`,\n * `delete`) buffer; reads (`first`, `all`, `count`) go through\n * `Storage` live (no MVCC snapshot, no read-your-writes).\n *\n * Single-attempt: on CAS conflict throws\n * `BaerlyError{code:\"Conflict\"}`. The body MAY have already run its\n * read side-effects (no rollback of in-memory state); the write\n * side-effects either all landed or none did. Wrap in a retry\n * loop you wrote if you want one.\n *\n * Empty body (or a body that buffers nothing) resolves without\n * touching `current.json`.\n *\n * @throws BaerlyError code=\"Conflict\" — CAS lost on the collection's\n * `current.json`. Caller decides whether to re-run the body.\n * @throws Whatever the body throws — re-thrown as-is. The commit\n * is skipped when the body throws.\n * @throws BaerlyError code=\"InvalidConfig\" — `collection` is empty or\n * contains `/`.\n *\n * @remarks\n * Single-collection by design. Cross-collection 2PC was rejected on\n * cost grounds — multiple round-trips per commit, no native fencing\n * primitive on S3-compatible storage, no rollback to undo a\n * successful PUT — and because in-doubt-transaction recovery state\n * would contradict the stateless-writer model. Applications that\n * need cross-collection atomicity re-express it at the app layer: an\n * idempotent move keyed off source-row state, or a single\n * denormalized collection with a `status` column.\n *\n * @example\n * ```ts\n * await db.transaction(\"tickets\", async (tx) => {\n * const open = await tx.where({ status: \"open\" }).count();\n * if (open < 100) await tx.insert({ title: \"another\", status: \"open\" });\n * });\n * ```\n */\n async transaction<T extends DocumentData = DocumentData>(\n collection: string,\n body: (tx: Collection<T>) => Promise<void>,\n ): Promise<void> {\n assertKeySegment(collection, \"collection\", \"Db.transaction\");\n\n const txCtx: TxContext = { collection, mutations: [] };\n const collectionPrefix = `${physicalPrefixFor(this.app, this.tenant)}manifests/${collection}`;\n\n // Build a Collection<T> whose mutation verbs buffer onto `txCtx`. The\n // read path ignores `txCtx` entirely (locked: no MVCC, no\n // read-your-writes inside a transaction).\n const schema = this.#schemas.get(collection);\n const indexes = this.#indexes.get(collection) ?? [];\n const tx = makeCollection<T>({\n storage: this.#storage,\n collectionPrefix,\n collectionName: collection,\n txCtx,\n indexes,\n ...(schema !== undefined ? { schema } : {}),\n });\n\n // Run the body. Reads go through Storage live; mutations append\n // to txCtx.mutations. A throw here propagates AS-IS and skips\n // the commit (txCtx.mutations is discarded).\n await body(tx);\n\n // Empty buffer — nothing to commit, nothing to throw.\n if (txCtx.mutations.length === 0) {\n return;\n }\n\n // Map BufferedMutations -> CommitInputs and fire one\n // single-attempt commitBatch. On CAS loss commitBatch throws\n // `Conflict` and we surface it unchanged.\n const inputs: CommitInput[] = [];\n for (const m of txCtx.mutations) {\n const input: CommitInput = {\n op: m.op,\n collection,\n docId: m.docId,\n ...(m.body !== undefined ? { body: m.body } : {}),\n ...(m.origin !== undefined ? { origin: m.origin } : {}),\n };\n inputs.push(input);\n }\n\n const writer = new Writer({\n storage: this.#storage,\n currentJsonKey: `${collectionPrefix}/current.json`,\n options: { indexes },\n });\n await writer.commitBatch(inputs);\n }\n\n /**\n * Read + parse this `Db`'s `manifests/<collection>/current.json`. Returns\n * `null` when the collection has not been provisioned yet (no\n * `current.json` exists). Throws `BaerlyError{code:\"InvalidResponse\"}`\n * on a malformed body — same contract as the underlying\n * {@link readCurrentJson} helper in `@baerly/protocol`.\n *\n * Backs the `/v1/since` long-poll handler in\n * `packages/server/src/http/since.ts`; that handler needs the parsed\n * `CurrentJson` plus an ETag for the follow-up reads.\n *\n * @internal — typed seam for the HTTP handler; app code should use\n * the collection API.\n */\n async getCurrentJson(\n collection: string,\n opts?: { signal?: AbortSignal },\n ): Promise<CurrentJsonRead | null> {\n const key = `${physicalPrefixFor(this.app, this.tenant)}manifests/${collection}/current.json`;\n return readCurrentJson(this.#storage, key, opts);\n }\n\n /**\n * Read + parse one `LogEntry` by `seq` from\n * `manifests/<collection>/${LOG_KEY_PREFIX}/<seq>.json`. Returns `null`\n * when the entry is missing — this typically means the GC sweeper\n * deleted the entry between a `readCurrentJson` and this GET (the\n * `/v1/since` handler treats the race as silent and skips the\n * entry). Throws `BaerlyError{code:\"InvalidResponse\"}` on a body\n * that isn't valid JSON.\n *\n * @internal — typed seam for the HTTP handler; app code should use\n * the collection API.\n */\n async getLogEntry(\n collection: string,\n seq: number,\n opts?: { signal?: AbortSignal },\n ): Promise<LogEntry | null> {\n const key = `${physicalPrefixFor(this.app, this.tenant)}manifests/${collection}/${LOG_KEY_PREFIX}/${seq}.json`;\n const got = await this.#storage.get(key, opts);\n if (got === null) {\n return null;\n }\n let parsed: unknown;\n try {\n parsed = decodeJsonBytes(got.body);\n } catch (error) {\n throw new BaerlyError(\n \"InvalidResponse\",\n `log entry at ${key}: body is not valid JSON`,\n error,\n );\n }\n return parsed as LogEntry;\n }\n}\n\n/**\n * Guard a string used as a path-segment in the bucket-key encoding.\n * Rejects empty and `/`-containing values with\n * `BaerlyError{code:\"InvalidConfig\"}`. `role` and `verb` are baked\n * into the message so the caller doesn't need to format their own.\n *\n * Used by {@link Db.create} (twice — `app`, `tenant`),\n * {@link Db.collectionReadContext} (once — `name`), and\n * {@link Db.transaction} (once — `collection`).\n *\n * @internal\n */\nconst assertKeySegment = (value: string, role: string, verb: string): void => {\n if (value.length === 0) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `${verb}: ${role} must be non-empty (got ${JSON.stringify(value)})`,\n );\n }\n if (value.includes(\"/\")) {\n throw new BaerlyError(\n \"InvalidConfig\",\n `${verb}: \"/\" is reserved as the key-segment separator (got ${role}=${JSON.stringify(value)})`,\n );\n }\n // Applied to ALL key segments (app, tenant, collection) — one\n // consistent leading-`_` reservation (ADR-007).\n assertNameNotReserved(value, verb);\n};\n"],"mappings":"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"}
|