@bjornpagen/bumbledb-log 1.3.0 → 1.3.1

package/dist/migrations/expr.js

@@ -1,257 +0,0 @@
-/**
- * Core `ScalarExpr` → canonical migration-plan expression data.
- * The generator SERIALIZES the core's typed scalar AST; it never evaluates
- * it — the native executor lowers the plan onto `bumbledb::ScalarExpr` and
- * the core `ScalarEvaluator` executes it with the core's exact numeric
- * semantics, and native plan compilation re-judges every node and type. The
- * walk below is a bounded structural check with the same depth fence as the
- * native codec (`MAX_EXPR_DEPTH = 128`); any node outside the frozen core
- * roster (closure, module path, unknown kind) is an unsupported-transform
- * refusal, never a fallback.
- * Literal payloads accept canonical wire values and the bigint, number,
- * and Uint8Array values retained by core SDK constructors. The serialized
- * form is checked again by the native migration-plan decoder.
- */
-import { Uuid } from "@bjornpagen/bumbledb";
-import { bytesHex, f64Bits } from "#migrations/canonical.ts";
-const MAX_DEPTH = 128;
-const MAX_NODES = 4096;
-const MAX_TEXT = 65536;
-function refuse(detail) {
-    return { ok: false, detail };
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null;
-}
-function isCanonicalHex(text, length) {
-    if (text.length !== length) {
-        return false;
-    }
-    for (let index = 0; index < text.length; index += 1) {
-        const code = text.charCodeAt(index);
-        if (!((code >= 48 && code <= 57) || (code >= 97 && code <= 102))) {
-            return false;
-        }
-    }
-    return true;
-}
-const U64_MAX = 0xffffffffffffffffn;
-const I64_MIN = -0x8000000000000000n;
-const I64_MAX = 0x7fffffffffffffffn;
-function decimalU64(value) {
-    if (typeof value === "bigint" && value >= 0n && value <= U64_MAX) {
-        return value.toString(10);
-    }
-    if (typeof value === "string" && value.length > 0 && value.length <= 20 && /^(0|[1-9][0-9]*)$/.test(value)) {
-        return BigInt(value) <= U64_MAX ? value : null;
-    }
-    return null;
-}
-function decimalI64(value) {
-    if (typeof value === "bigint" && value >= I64_MIN && value <= I64_MAX) {
-        return value.toString(10);
-    }
-    if (typeof value === "string" && value.length > 0 && value.length <= 21 && /^(0|-?[1-9][0-9]*)$/.test(value)) {
-        const parsed = BigInt(value);
-        return parsed >= I64_MIN && parsed <= I64_MAX ? value : null;
-    }
-    return null;
-}
-function bitsOf(value) {
-    if (typeof value === "number") {
-        return f64Bits(value);
-    }
-    if (typeof value === "string" && isCanonicalHex(value, 16)) {
-        return value;
-    }
-    return null;
-}
-function pairOf(value, one) {
-    if (!Array.isArray(value) || value.length !== 2) {
-        return null;
-    }
-    const start = one(value[0]);
-    const end = one(value[1]);
-    return start === null || end === null ? null : [start, end];
-}
-/**
- * Bounded structural check of one literal payload into the canonical
- * one-arm value spelling.
- */
-export function planValueOf(value) {
-    if (!isRecord(value)) {
-        return "a literal payload must be a one-arm tagged core value";
-    }
-    const keys = Object.keys(value);
-    if (keys.length !== 1) {
-        return "a literal payload must have exactly one value arm";
-    }
-    const arm = keys[0];
-    const body = value[arm];
-    switch (arm) {
-        case "bool":
-            return typeof body === "boolean" ? { bool: body } : "bool literal needs a boolean";
-        case "u64": {
-            const decimal = decimalU64(body);
-            return decimal === null ? "u64 literal needs a canonical in-range integer" : { u64: decimal };
-        }
-        case "i64": {
-            const decimal = decimalI64(body);
-            return decimal === null ? "i64 literal needs a canonical in-range integer" : { i64: decimal };
-        }
-        case "$f64":
-        case "f64": {
-            const bits = bitsOf(body);
-            return bits === null ? "f64 literal needs a number or 16 lowercase hex bits" : { $f64: bits };
-        }
-        case "uuid":
-            return Uuid.isUuid(body) ? { uuid: body } : "uuid literal needs a canonical UUID";
-        case "string":
-            return typeof body === "string" && body.length <= MAX_TEXT && body.isWellFormed()
-                ? { string: body }
-                : "string literal needs bounded well-formed text";
-        case "fixedBytes": {
-            if (body instanceof Uint8Array && body.length <= MAX_TEXT) {
-                return { fixedBytes: bytesHex(body) };
-            }
-            if (typeof body === "string" &&
-                body.length <= 2 * MAX_TEXT &&
-                body.length % 2 === 0 &&
-                isCanonicalHex(body, body.length)) {
-                return { fixedBytes: body };
-            }
-            return "fixedBytes literal needs a bounded Uint8Array or lowercase hex";
-        }
-        case "intervalU64": {
-            const pair = pairOf(body, decimalU64);
-            return pair === null ? "intervalU64 literal needs two canonical integers" : { intervalU64: pair };
-        }
-        case "intervalI64": {
-            const pair = pairOf(body, decimalI64);
-            return pair === null ? "intervalI64 literal needs two canonical integers" : { intervalI64: pair };
-        }
-        case "intervalF64": {
-            const pair = pairOf(body, bitsOf);
-            return pair === null ? "intervalF64 literal needs two float endpoints" : { intervalF64: pair };
-        }
-        default:
-            return `unknown literal arm ${arm}`;
-    }
-}
-const CASTS = ["toF64", "toF64Exact", "toI64Exact", "toU64Exact"];
-function walk(node, depth, budget, fields) {
-    if (depth > MAX_DEPTH) {
-        return `expression deeper than ${MAX_DEPTH}`;
-    }
-    budget.nodes += 1;
-    if (budget.nodes > MAX_NODES) {
-        return `expression larger than ${MAX_NODES} nodes`;
-    }
-    if (!isRecord(node) || typeof node.kind !== "string") {
-        return "an expression node must be a tagged core ScalarExpr value — functions, promises and plain hosts are not plan data";
-    }
-    const arms = {
-        field: ["name"],
-        literal: ["value"],
-        measure: ["expr"],
-        negate: ["expr"],
-        isNaN: ["expr"],
-        isFinite: ["expr"],
-        cast: ["cast", "expr"],
-        mulDiv: ["a", "b", "divisor", "rounding"],
-        add: ["left", "right"],
-        subtract: ["left", "right"],
-        multiply: ["left", "right"],
-        divide: ["left", "right"]
-    };
-    const required = Object.hasOwn(arms, node.kind) ? arms[node.kind] : undefined;
-    if (required === undefined)
-        return `unsupported expression node ${node.kind} — the finite supported grammar is ${Object.keys(arms).join("/")}`;
-    if (required.some((key) => !Object.hasOwn(node, key)) ||
-        Object.keys(node).some((key) => !["kind", "scope", "result", "depth", ...required].includes(key)))
-        return "unknown or missing expression field";
-    if (Object.hasOwn(node, "scope") && node.scope !== "source-field")
-        return "migration expressions read source fields";
-    switch (node.kind) {
-        case "field": {
-            if (typeof node.name !== "string" || node.name.length === 0 || node.name.length > 255) {
-                return "a field reference needs a bounded source field name";
-            }
-            fields.add(node.name);
-            return { kind: "field", name: node.name };
-        }
-        case "literal": {
-            const value = planValueOf(node.value);
-            return typeof value === "string" ? value : { kind: "literal", value };
-        }
-        case "measure":
-        case "negate":
-        case "isNaN":
-        case "isFinite": {
-            const inner = walk(node.expr, depth + 1, budget, fields);
-            if (typeof inner === "string") {
-                return inner;
-            }
-            return { kind: node.kind, expr: inner };
-        }
-        case "add":
-        case "subtract":
-        case "multiply":
-        case "divide": {
-            const left = walk(node.left, depth + 1, budget, fields);
-            if (typeof left === "string") {
-                return left;
-            }
-            const right = walk(node.right, depth + 1, budget, fields);
-            if (typeof right === "string") {
-                return right;
-            }
-            return { kind: node.kind, left, right };
-        }
-        case "mulDiv": {
-            const { rounding } = node;
-            if (rounding !== "towardZero" && rounding !== "nearestTiesAwayFromZero" && rounding !== "nearestTiesToEven")
-                return "unknown integer rounding mode";
-            const a = walk(node.a, depth + 1, budget, fields);
-            if (typeof a === "string")
-                return a;
-            const b = walk(node.b, depth + 1, budget, fields);
-            if (typeof b === "string")
-                return b;
-            const divisor = walk(node.divisor, depth + 1, budget, fields);
-            if (typeof divisor === "string")
-                return divisor;
-            return { kind: node.kind, a, b, divisor, rounding };
-        }
-        case "cast": {
-            const cast = CASTS.find((name) => name === node.cast);
-            if (cast === undefined) {
-                return `unknown cast ${String(node.cast)} — the checked roster is toF64/toF64Exact/toI64Exact/toU64Exact`;
-            }
-            const inner = walk(node.expr, depth + 1, budget, fields);
-            if (typeof inner === "string") {
-                return inner;
-            }
-            return { kind: "cast", cast, expr: inner };
-        }
-        default:
-            return `unsupported expression node ${node.kind}`;
-    }
-}
-/**
- * Serialize one core scalar expression into canonical plan data, collecting
- * the referenced source field names for loss accounting.
- */
-export function planExpressionOf(expression) {
-    const fields = new Set();
-    const outcome = walk(expression, 0, { nodes: 0 }, fields);
-    if (typeof outcome === "string") {
-        return refuse(outcome);
-    }
-    return { ok: true, expression: outcome, fields: [...fields] };
-}
-/** The identity projection every carried field lowers to. */
-export function fieldExpression(name) {
-    return { kind: "field", name };
-}
-//# sourceMappingURL=expr.js.map

package/dist/migrations/expr.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/migrations/expr.ts"],"names":[],"mappings":"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"}

package/dist/migrations/fail.d.ts

@@ -1,22 +0,0 @@
-/**
- * Migration failures use the shared `DbError | ProtocolError` vocabulary.
- * Reasons carry bounded structured detail; consumers never parse messages.
- */
-import { ProtocolError } from "../errors.js";
-/** One actionable generation refusal: what is required, about which subject. */
-export interface IntentRequirement {
-    readonly code: "ambiguous" | "destructive" | "missing-backfill" | "type-change" | "unsupported" | "stale-intent" | "conflicting-intent";
-    readonly relation: string;
-    readonly field: string | null;
-    readonly detail: string;
-}
-export declare function boundedDetail(detail: string): string;
-/** Generation refuses with the complete finite list of required typed intent. */
-export declare function intentRequired(operation: string, requirements: readonly IntentRequirement[]): ProtocolError;
-/** A recorded plan/manifest/snapshot no longer matches its recorded identity. */
-export declare function drift(operation: string, detail: string): ProtocolError;
-/** The finite supported grammar cannot express the authored input. */
-export declare function unsupported(operation: string, detail: string): ProtocolError;
-/** A malformed or unreadable repository artifact/layout. */
-export declare function repository(operation: string, path: string, detail: string): ProtocolError;
-//# sourceMappingURL=fail.d.ts.map

package/dist/migrations/fail.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fail.d.ts","sourceRoot":"","sources":["../../src/migrations/fail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EACV,WAAW,GACX,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,cAAc,GACd,oBAAoB,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAKD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAWD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,iBAAiB,EAAE,GAAG,aAAa,CAU3G;AAED,iFAAiF;AACjF,wBAAgB,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAKtE;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAK5E;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAKzF"}

package/dist/migrations/fail.js

@@ -1,52 +0,0 @@
-/**
- * Migration failures use the shared `DbError | ProtocolError` vocabulary.
- * Reasons carry bounded structured detail; consumers never parse messages.
- */
-import { ProtocolError } from "#errors.ts";
-const MAX_REQUIREMENTS = 32;
-const MAX_DETAIL = 512;
-export function boundedDetail(detail) {
-    return detail.length > MAX_DETAIL ? `${detail.slice(0, MAX_DETAIL - 1)}…` : detail;
-}
-function boundedRequirement(requirement) {
-    return {
-        code: requirement.code,
-        relation: requirement.relation,
-        field: requirement.field,
-        detail: boundedDetail(requirement.detail)
-    };
-}
-/** Generation refuses with the complete finite list of required typed intent. */
-export function intentRequired(operation, requirements) {
-    const truncated = requirements.length > MAX_REQUIREMENTS;
-    return new ProtocolError({
-        operation,
-        reason: {
-            _tag: "MigrationIntentRequired",
-            requirements: requirements.slice(0, MAX_REQUIREMENTS).map(boundedRequirement),
-            truncated
-        }
-    });
-}
-/** A recorded plan/manifest/snapshot no longer matches its recorded identity. */
-export function drift(operation, detail) {
-    return new ProtocolError({
-        operation,
-        reason: { _tag: "MigrationDrift", detail: boundedDetail(detail) }
-    });
-}
-/** The finite supported grammar cannot express the authored input. */
-export function unsupported(operation, detail) {
-    return new ProtocolError({
-        operation,
-        reason: { _tag: "MigrationUnsupported", detail: boundedDetail(detail) }
-    });
-}
-/** A malformed or unreadable repository artifact/layout. */
-export function repository(operation, path, detail) {
-    return new ProtocolError({
-        operation,
-        reason: { _tag: "MigrationRepository", path: boundedDetail(path), detail: boundedDetail(detail) }
-    });
-}
-//# sourceMappingURL=fail.js.map

package/dist/migrations/fail.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fail.js","sourceRoot":"","sources":["../../src/migrations/fail.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAiB1C,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAC3B,MAAM,UAAU,GAAG,GAAG,CAAA;AAEtB,MAAM,UAAU,aAAa,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;AACnF,CAAC;AAED,SAAS,kBAAkB,CAAC,WAA8B;IACzD,OAAO;QACN,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC;KACzC,CAAA;AACF,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,YAA0C;IAC3F,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,GAAG,gBAAgB,CAAA;IACxD,OAAO,IAAI,aAAa,CAAC;QACxB,SAAS;QACT,MAAM,EAAE;YACP,IAAI,EAAE,yBAAyB;YAC/B,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC;YAC7E,SAAS;SACT;KACD,CAAC,CAAA;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,KAAK,CAAC,SAAiB,EAAE,MAAc;IACtD,OAAO,IAAI,aAAa,CAAC;QACxB,SAAS;QACT,MAAM,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;KACjE,CAAC,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,MAAc;IAC5D,OAAO,IAAI,aAAa,CAAC;QACxB,SAAS;QACT,MAAM,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;KACvE,CAAC,CAAA;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,UAAU,CAAC,SAAiB,EAAE,IAAY,EAAE,MAAc;IACzE,OAAO,IAAI,aAAa,CAAC;QACxB,SAAS;QACT,MAAM,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;KACjG,CAAC,CAAA;AACH,CAAC"}

package/dist/migrations/fsops.d.ts

@@ -1,37 +0,0 @@
-import { Effect } from "effect";
-import type { LogError } from "../errors.js";
-/**
- * Join every in-flight filesystem promise. Uninterruptible: the repository
- * lock must outlive canceled I/O.
- */
-export declare const joinPendingIo: Effect.Effect<void>;
-/**
- * Read one UTF-8 file through a single descriptor in bounded chunks.
- * Invalid UTF-8 is fatal. A growing file stops at the aggregate cap.
- * Absent files are `null`, never an invented empty artifact. Yields between
- * chunks so concurrent growth is observable.
- */
-export declare function readBounded(operation: string, filePath: string, maxBytes: number): Effect.Effect<string | null, LogError>;
-/** Create the directory (and parents). Idempotent. */
-export declare function ensureDirectory(operation: string, directory: string): Effect.Effect<void, LogError>;
-/**
- * Publish one uniquely owned immutable artifact. No-clobber: an existing
- * file is accepted only when its bytes are identical. Uninterruptible.
- */
-export declare function writeImmutable(operation: string, filePath: string, text: string): Effect.Effect<void, LogError>;
-/**
- * Atomically durably replace the sole authoritative manifest. Last commit
- * of a generation. Uninterruptible.
- */
-export declare function writeManifest(operation: string, filePath: string, text: string): Effect.Effect<void, LogError>;
-/**
- * Repair a derived index/contract file idempotently (temp + fsync + rename).
- * Uninterruptible.
- */
-export declare function writeDerived(operation: string, filePath: string, text: string): Effect.Effect<void, LogError>;
-/**
- * Remove one file (idempotent). Used ONLY for unrecorded interrupted-
- * generation leftovers; recorded history files are never removed.
- */
-export declare function removeFile(operation: string, filePath: string): Effect.Effect<void, LogError>;
-//# sourceMappingURL=fsops.d.ts.map

package/dist/migrations/fsops.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fsops.d.ts","sourceRoot":"","sources":["../../src/migrations/fsops.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAqC1C;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAG7C,CAAA;AA2BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,CAAC,CAqCxC;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAInG;AAyDD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAI/G;AAoBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAE9G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAE7G;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAI7F"}

package/dist/migrations/fsops.js

@@ -1,222 +0,0 @@
-/**
- * Bounded, interruption-safe repository filesystem work. Generation holds
- * the native kernel lock (see `#migrations/lock.ts`) before any read or
- * cleanup. Reads use one open file descriptor, bounded chunks, fatal UTF-8
- * and an aggregate byte cap — never stat then whole-file read. Immutable
- * plan/snapshot artifacts are uniquely owned (O_EXCL / no-clobber); matching
- * existing content is verified, never overwritten. The sole authoritative
- * manifest is replaced last by a uniquely named temp + fsync + rename +
- * directory sync. Derived index/contract files are repairable the same way.
- *
- * Every promise I/O is tracked. Cancellation joins pending work before the
- * caller releases the repository lock. No PID liveness, stale-file unlink,
- * or lock-token guessing lives here.
- */
-import { randomUUID } from "node:crypto";
-import { mkdir, open, rename, rm } from "node:fs/promises";
-import * as path from "node:path";
-import { Effect } from "effect";
-import { repository } from "#migrations/fail.ts";
-const CHUNK = 64 * 1024;
-const decoder = new TextDecoder("utf-8", { fatal: true });
-const pending = new Set();
-function track(work) {
-    pending.add(work);
-    return work.finally(() => {
-        pending.delete(work);
-    });
-}
-function ioDetail(cause) {
-    if (typeof cause === "object" && cause !== null && "code" in cause && typeof cause.code === "string") {
-        return cause.code;
-    }
-    if (cause instanceof TypeError) {
-        return "invalid UTF-8";
-    }
-    return "io failure";
-}
-function ioError(operation, filePath, cause) {
-    return repository(operation, filePath, ioDetail(cause));
-}
-function isMissing(cause) {
-    return typeof cause === "object" && cause !== null && "code" in cause && cause.code === "ENOENT";
-}
-function isExists(cause) {
-    return typeof cause === "object" && cause !== null && "code" in cause && cause.code === "EEXIST";
-}
-/**
- * Join every in-flight filesystem promise. Uninterruptible: the repository
- * lock must outlive canceled I/O.
- */
-export const joinPendingIo = Effect.promise(() => Promise.allSettled([...pending])).pipe(Effect.asVoid, Effect.uninterruptible);
-function tryIo(operation, filePath, work) {
-    return Effect.tryPromise({
-        try: () => track(work()),
-        catch: (cause) => ioError(operation, filePath, cause)
-    });
-}
-async function openExisting(filePath) {
-    try {
-        return await open(filePath, "r");
-    }
-    catch (cause) {
-        if (isMissing(cause)) {
-            return null;
-        }
-        throw cause;
-    }
-}
-function decodeBytes(operation, filePath, pieces) {
-    return Effect.try({
-        try: () => decoder.decode(pieces.length === 0 ? new Uint8Array() : Buffer.concat(pieces)),
-        catch: (cause) => ioError(operation, filePath, cause)
-    });
-}
-/**
- * Read one UTF-8 file through a single descriptor in bounded chunks.
- * Invalid UTF-8 is fatal. A growing file stops at the aggregate cap.
- * Absent files are `null`, never an invented empty artifact. Yields between
- * chunks so concurrent growth is observable.
- */
-export function readBounded(operation, filePath, maxBytes) {
-    return Effect.gen(function* () {
-        const opened = yield* tryIo(operation, filePath, () => openExisting(filePath));
-        if (opened === null) {
-            return null;
-        }
-        return yield* Effect.acquireUseRelease(Effect.succeed(opened), (handle) => Effect.gen(function* () {
-            const pieces = [];
-            let total = 0;
-            const buffer = Buffer.alloc(CHUNK);
-            for (;;) {
-                const bytesRead = yield* tryIo(operation, filePath, async () => {
-                    const result = await handle.read(buffer, 0, buffer.length, null);
-                    return result.bytesRead;
-                });
-                if (bytesRead === 0) {
-                    break;
-                }
-                total += bytesRead;
-                if (total > maxBytes) {
-                    return yield* Effect.fail(repository(operation, filePath, `file exceeds the ${maxBytes}-byte bound`));
-                }
-                pieces.push(Buffer.from(buffer.subarray(0, bytesRead)));
-                yield* Effect.yieldNow;
-            }
-            return yield* decodeBytes(operation, filePath, pieces);
-        }), (handle) => tryIo(operation, filePath, () => handle.close()).pipe(Effect.catch(() => Effect.void), Effect.asVoid));
-    });
-}
-/** Create the directory (and parents). Idempotent. */
-export function ensureDirectory(operation, directory) {
-    return tryIo(operation, directory, async () => {
-        await mkdir(directory, { recursive: true });
-    });
-}
-async function syncDirectory(directory) {
-    const dir = await open(directory, "r");
-    try {
-        await dir.sync();
-    }
-    finally {
-        await dir.close();
-    }
-}
-async function writeExclusive(filePath, text) {
-    try {
-        const handle = await open(filePath, "wx");
-        try {
-            await handle.writeFile(text, "utf8");
-            await handle.sync();
-        }
-        finally {
-            await handle.close();
-        }
-        await syncDirectory(path.dirname(filePath));
-        return "created";
-    }
-    catch (cause) {
-        if (!isExists(cause)) {
-            throw cause;
-        }
-        const existingHandle = await openExisting(filePath);
-        if (existingHandle === null) {
-            throw { code: "immutable artifact vanished during identical-content check" };
-        }
-        try {
-            const pieces = [];
-            let total = 0;
-            const cap = Math.max(Buffer.byteLength(text, "utf8"), 1);
-            const buffer = Buffer.alloc(CHUNK);
-            for (;;) {
-                const { bytesRead } = await existingHandle.read(buffer, 0, buffer.length, null);
-                if (bytesRead === 0) {
-                    break;
-                }
-                total += bytesRead;
-                if (total > cap) {
-                    throw { code: "immutable artifact exists with different content" };
-                }
-                pieces.push(Buffer.from(buffer.subarray(0, bytesRead)));
-            }
-            const existing = decoder.decode(pieces.length === 0 ? new Uint8Array() : Buffer.concat(pieces));
-            if (existing === text) {
-                return "identical";
-            }
-        }
-        finally {
-            await existingHandle.close();
-        }
-        throw { code: "immutable artifact exists with different content" };
-    }
-}
-/**
- * Publish one uniquely owned immutable artifact. No-clobber: an existing
- * file is accepted only when its bytes are identical. Uninterruptible.
- */
-export function writeImmutable(operation, filePath, text) {
-    return tryIo(operation, filePath, () => writeExclusive(filePath, text).then(() => undefined)).pipe(Effect.uninterruptible);
-}
-async function replaceFile(filePath, text) {
-    const temporary = `${filePath}.tmp-${randomUUID()}`;
-    try {
-        const handle = await open(temporary, "wx");
-        try {
-            await handle.writeFile(text, "utf8");
-            await handle.sync();
-        }
-        finally {
-            await handle.close();
-        }
-        await rename(temporary, filePath);
-    }
-    catch (cause) {
-        await rm(temporary, { force: true }).catch(() => undefined);
-        throw cause;
-    }
-    await syncDirectory(path.dirname(filePath));
-}
-/**
- * Atomically durably replace the sole authoritative manifest. Last commit
- * of a generation. Uninterruptible.
- */
-export function writeManifest(operation, filePath, text) {
-    return tryIo(operation, filePath, () => replaceFile(filePath, text)).pipe(Effect.uninterruptible);
-}
-/**
- * Repair a derived index/contract file idempotently (temp + fsync + rename).
- * Uninterruptible.
- */
-export function writeDerived(operation, filePath, text) {
-    return tryIo(operation, filePath, () => replaceFile(filePath, text)).pipe(Effect.uninterruptible);
-}
-/**
- * Remove one file (idempotent). Used ONLY for unrecorded interrupted-
- * generation leftovers; recorded history files are never removed.
- */
-export function removeFile(operation, filePath) {
-    return tryIo(operation, filePath, async () => {
-        await rm(filePath, { force: true });
-    });
-}
-//# sourceMappingURL=fsops.js.map

package/dist/migrations/fsops.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fsops.js","sourceRoot":"","sources":["../../src/migrations/fsops.ts"],"names":[],"mappings":"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"}

package/dist/migrations/generate.d.ts

@@ -1,11 +0,0 @@
-import type { NativeRuntime, SchemaRelations } from "@bjornpagen/bumbledb";
-import { Effect } from "effect";
-import type { LogError } from "../errors.js";
-import type { MigrationCodec } from "./codec.js";
-import type { RepositoryExclusion } from "./lock.js";
-import type { CheckOptions, CheckReport, GenerateOptions, GenerationReport } from "./types.js";
-export declare function makeGenerator(codec: MigrationCodec, exclusion: RepositoryExclusion): {
-    generateMigrations: <Rels extends SchemaRelations>(options: GenerateOptions<Rels>) => Effect.Effect<GenerationReport, LogError, NativeRuntime>;
-    checkMigrations: <Rels extends SchemaRelations>(options: CheckOptions<Rels>) => Effect.Effect<CheckReport, LogError, NativeRuntime>;
-};
-//# sourceMappingURL=generate.d.ts.map

package/dist/migrations/generate.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/migrations/generate.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAY,aAAa,EAAE,eAAe,EAAc,MAAM,sBAAsB,CAAA;AAIhG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG1C,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAcxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAc9D,OAAO,KAAK,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAMhB,MAAM,sBAAsB,CAAA;AAiL7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,mBAAmB;yBAqIC,IAAI,SAAS,eAAe;sBA8IlC,IAAI,SAAS,eAAe;EAgEzG"}