@bjornpagen/bumbledb 0.1.0

package/dist/native.d.ts

@@ -0,0 +1,532 @@
+import type { SchemaSpec, ValueSpec, ValueTypeSpec } from "#spec.ts";
+/**
+ * The complete typed surface of the bumbledb-node napi bridge. ALL FFI
+ * typing lives in this one file — no other module may know the `.node`
+ * artifact exists. The bridge is a dumb bridge (PRD-04): descriptor in as
+ * data, queries in as IR data, facts in/out as value rows, rejections out as
+ * structured violation sets; anything smart lives in the SDK or the engine.
+ *
+ * Marshaling law: fact rows cross as NATURAL JS values, schema-directed by
+ * the engine descriptor (`boolean ⇄ bool`, `bigint ⇄ u64/i64`,
+ * `string ⇄ str`, `Uint8Array ⇄ bytes<N>`, `{ start, end }` ⇄ interval);
+ * IR, spec, and query params cross as TAGGED plain objects mirroring the
+ * engine's own data enums 1:1. Every u64/i64 crosses as `bigint`, never
+ * `number`. Domain outcomes (schema errors, fingerprint mismatches,
+ * rejections, generation moves, IR errors) are DATA; marshaling/shape
+ * violations and use-after-close THROW.
+ */
+/** The opaque database handle (owns the LMDB environment + exclusive lock). */
+type DbHandle = {
+    readonly __brand: "bumbledb.db";
+};
+/** One live MVCC read snapshot. */
+type SnapshotHandle = {
+    readonly __brand: "bumbledb.snapshot";
+};
+/**
+ * One exhumed store — the read-only, theory-less open (engine 70-api.md
+ * § exhume). No close function exists for this handle anywhere on the
+ * bridge (the zero-closables law): the engine side is dropped when the
+ * handle is garbage-collected — reclamation only, never correctness.
+ */
+type ExhumeHandle = {
+    readonly __brand: "bumbledb.exhume";
+};
+/**
+ * One live write transaction — the submitted delta with the engine's
+ * final-state point-read view. Spent by `txCommit`/`txAbort`.
+ */
+type TxHandle = {
+    readonly __brand: "bumbledb.tx";
+};
+/** One prepared query/program (plan pinned at prepare). */
+type PreparedHandle = {
+    readonly __brand: "bumbledb.prepared";
+};
+/** A half-open interval `[start, end)` as it crosses the boundary. */
+interface IntervalValue {
+    readonly start: bigint;
+    readonly end: bigint;
+}
+/**
+ * One fact-row cell as a natural JS value. The expected engine type comes
+ * from the schema descriptor (marshaling is schema-directed, never guessed):
+ * `boolean` for bool, `bigint` for u64/i64, `string` for str, `Uint8Array`
+ * for bytes<N> (width-checked), `{ start, end }` for intervals.
+ */
+type FactValue = boolean | bigint | string | Uint8Array | IntervalValue;
+/**
+ * One tagged engine value — the 1:1 mirror of `bumbledb::Value` for the
+ * positions no schema field directs (IR literals, query params). The spec's
+ * `ValueSpec` vocabulary plus the bind-time-only Allen mask.
+ */
+type TaggedValue = ValueSpec | {
+    readonly kind: "allenMask";
+    readonly mask: number;
+};
+/**
+ * One positional execution argument: a tagged scalar, or a param SET
+ * (`Term.paramSet` positions) as `{ kind: "set", values }`.
+ */
+type QueryParam = TaggedValue | {
+    readonly kind: "set";
+    readonly values: readonly TaggedValue[];
+};
+/**
+ * The IR mirror (`bumbledb::ir`, 1:1): relations, fields, predicates, and
+ * params by NUMERIC id — the SDK resolves names through the manifest and
+ * sends ids; the bridge never sees names in queries. A plain query is sent
+ * as its degenerate one-predicate program.
+ */
+interface ProgramIr {
+    readonly predicates: readonly PredicateDefIr[];
+    readonly output: number;
+}
+/** One predicate: the head shape its rules align against, and the rules. */
+interface PredicateDefIr {
+    readonly head: readonly HeadTermIr[];
+    readonly rules: readonly RuleIr[];
+}
+/** One head position: a plain variable slot or an aggregate-op kind. */
+type HeadTermIr = {
+    readonly kind: "var";
+} | {
+    readonly kind: "aggregate";
+    readonly op: HeadOpIr;
+};
+/** The var-free aggregate-op kind at a head position. */
+type HeadOpIr = "sum" | "min" | "max" | "count" | "countDistinct" | "argMax" | "argMin" | "pack";
+/** One rule: conjunctive body, anti-join atoms, condition trees. */
+interface RuleIr {
+    readonly finds: readonly FindTermIr[];
+    readonly atoms: readonly AtomIr[];
+    readonly negated: readonly AtomIr[];
+    readonly conditions: readonly ConditionTreeIr[];
+}
+/** One find term (mirrors `ir::FindTerm`). */
+type FindTermIr = {
+    readonly kind: "var";
+    readonly var: number;
+} | {
+    readonly kind: "aggregate";
+    readonly op: AggOpIr;
+    readonly over?: number;
+} | {
+    readonly kind: "measure";
+    readonly var: number;
+} | {
+    readonly kind: "aggregateMeasure";
+    readonly op: AggOpIr;
+    readonly over: number;
+};
+/** One aggregate operator (mirrors `ir::AggOp`; Arg ops carry their key). */
+type AggOpIr = {
+    readonly kind: "sum";
+} | {
+    readonly kind: "min";
+} | {
+    readonly kind: "max";
+} | {
+    readonly kind: "count";
+} | {
+    readonly kind: "countDistinct";
+} | {
+    readonly kind: "argMax";
+    readonly key: number;
+} | {
+    readonly kind: "argMin";
+    readonly key: number;
+} | {
+    readonly kind: "pack";
+};
+/** Where an atom draws its facts: a stored relation or a program predicate. */
+type AtomSourceIr = {
+    readonly kind: "edb";
+    readonly relation: number;
+} | {
+    readonly kind: "idb";
+    readonly pred: number;
+};
+/**
+ * One atom: named-field bindings as `[fieldId, term]` pairs; absence of a
+ * field is the wildcard.
+ */
+interface AtomIr {
+    readonly source: AtomSourceIr;
+    readonly bindings: ReadonlyArray<readonly [number, TermIr]>;
+}
+/** One term of an atom binding or comparison (mirrors `ir::Term`). */
+type TermIr = {
+    readonly kind: "var";
+    readonly var: number;
+} | {
+    readonly kind: "param";
+    readonly param: number;
+} | {
+    readonly kind: "paramSet";
+    readonly param: number;
+} | {
+    readonly kind: "literal";
+    readonly value: TaggedValue;
+} | {
+    readonly kind: "measure";
+    readonly var: number;
+};
+/** The `Allen` comparison's mask position: a literal mask or a param. */
+type MaskTermIr = {
+    readonly kind: "literal";
+    readonly mask: number;
+} | {
+    readonly kind: "param";
+    readonly param: number;
+};
+/** One comparison operator (mirrors `ir::CmpOp`). */
+type CmpOpIr = {
+    readonly kind: "eq";
+} | {
+    readonly kind: "ne";
+} | {
+    readonly kind: "lt";
+} | {
+    readonly kind: "le";
+} | {
+    readonly kind: "gt";
+} | {
+    readonly kind: "ge";
+} | {
+    readonly kind: "allen";
+    readonly mask: MaskTermIr;
+} | {
+    readonly kind: "pointIn";
+};
+/** One comparison condition. */
+interface ComparisonIr {
+    readonly op: CmpOpIr;
+    readonly lhs: TermIr;
+    readonly rhs: TermIr;
+}
+/**
+ * The input condition grammar: any boolean combination of comparisons
+ * (validation distributes to DNF engine-side).
+ */
+type ConditionTreeIr = {
+    readonly kind: "leaf";
+    readonly cmp: ComparisonIr;
+} | {
+    readonly kind: "and";
+    readonly children: readonly ConditionTreeIr[];
+} | {
+    readonly kind: "or";
+    readonly children: readonly ConditionTreeIr[];
+};
+/** A statement's form tag. */
+type StatementKindTag = "functionality" | "containment" | "cardinality";
+/** One field's name, dense id, and structural type. */
+interface ManifestField {
+    readonly name: string;
+    readonly id: number;
+    readonly valueType: ValueTypeSpec;
+}
+/**
+ * One closed-relation ground axiom as manifest data: handle →
+ * declaration-order id → (column, value) pairs.
+ */
+interface ManifestRow {
+    readonly handle: string;
+    readonly id: bigint;
+    readonly values: ReadonlyArray<{
+        readonly name: string;
+        readonly value: FactValue;
+    }>;
+}
+/**
+ * One relation's names and ids; a closed relation's sealed field list opens
+ * with the synthetic (`id`, u64) handle field and carries its extension.
+ */
+interface ManifestRelation {
+    readonly name: string;
+    readonly id: number;
+    readonly fields: readonly ManifestField[];
+    readonly extension?: readonly ManifestRow[];
+}
+/** One statement's identity, form tag, and canonical spelling. */
+interface ManifestStatement {
+    readonly id: number;
+    readonly kind: StatementKindTag;
+    readonly spelling: string;
+}
+/**
+ * The theory's manifest: every name → id pairing as plain data (PRD-02's
+ * tables, one JS object) — called once per open by the SDK.
+ */
+interface Manifest {
+    readonly relations: readonly ManifestRelation[];
+    readonly statements: readonly ManifestStatement[];
+}
+/** One offending fact of a violation, decoded to named natural values. */
+interface ViolationFact {
+    readonly relation: string;
+    readonly fields: ReadonlyArray<{
+        readonly name: string;
+        readonly value: FactValue;
+    }>;
+}
+/**
+ * One violated statement of a rejected commit, rendered to plain data: the
+ * statement id (materialized order), form tag, CANONICAL spelling (the
+ * engine's one renderer — a bijection on legal statements, paste-back-able),
+ * the form's direction/count payloads, and the decoded offending facts.
+ */
+interface Violation {
+    readonly statementId: number;
+    readonly kind: StatementKindTag;
+    readonly canonical: string;
+    readonly direction?: "sourceUnsatisfied" | "targetRequired";
+    readonly count?: bigint;
+    readonly facts: readonly ViolationFact[];
+}
+/**
+ * `dbCreate`/`dbOpen`'s domain outcome. `schemaError` covers both spec
+ * resolution (unresolvable names, banned spellings — every issue in one
+ * message) and schema validation at the declaration boundary;
+ * `fingerprintMismatch` is `dbOpen`'s stored-theory refusal.
+ */
+type DbOpenResult = {
+    readonly ok: true;
+    readonly db: DbHandle;
+} | {
+    readonly ok: false;
+    readonly kind: "schemaError" | "fingerprintMismatch";
+    readonly message: string;
+};
+/**
+ * `dbExhume`'s domain outcome: the live exhume handle, or one of the three
+ * adoption-era refusals as data — `descriptorMissing` (the store predates
+ * self-describing stores and has not been adopted; the remedy is one
+ * fingerprint-matching `dbOpen` under the creating schema),
+ * `formatMismatch`, and `corruption` (the persisted descriptor fails its
+ * integrity gates). Genuine failures — a missing path, a held exclusive
+ * lock — throw.
+ */
+type ExhumeResult = {
+    readonly ok: true;
+    readonly exhume: ExhumeHandle;
+} | {
+    readonly ok: false;
+    readonly kind: "descriptorMissing" | "formatMismatch" | "corruption";
+    readonly message: string;
+};
+/**
+ * `dbWriteFrom`'s domain outcome: the live witnessed transaction, or the
+ * typed stale-premise verdict (a state-changing commit landed after the
+ * witness snapshot; retry policy is host-side).
+ */
+type WriteFromResult = {
+    readonly ok: true;
+    readonly tx: TxHandle;
+} | {
+    readonly ok: false;
+    readonly kind: "generationMoved";
+    readonly witnessed: bigint;
+    readonly current: bigint;
+};
+/**
+ * `txCommit`'s domain outcome: the committed generation, or the COMPLETE
+ * violation set (every violated statement cited once, per direction for a
+ * containment, in materialized statement order).
+ */
+type CommitResult = {
+    readonly ok: true;
+    readonly generation: bigint;
+} | {
+    readonly ok: false;
+    readonly violations: readonly Violation[];
+};
+/** `dbPrepare`'s domain outcome (IR roster errors are data). */
+type PrepareResult = {
+    readonly ok: true;
+    readonly prepared: PreparedHandle;
+} | {
+    readonly ok: false;
+    readonly kind: "irError";
+    readonly message: string;
+};
+/** One occurrence's plan drift (pinned vs live row counts). */
+interface OccurrenceDrift {
+    readonly relation: number;
+    readonly pinned: bigint;
+    readonly live: bigint;
+    readonly ratio: number;
+}
+/**
+ * The pull-based plan-drift report: engine-policy-free — no threshold
+ * exists engine-side; the host owns reprepare policy.
+ */
+interface Staleness {
+    readonly perOccurrence: readonly OccurrenceDrift[];
+    readonly maxRatio: number;
+}
+interface Native {
+    /**
+     * Proof-of-life export (PRD-03): a non-empty string naming the bridge
+     * crate version and the engine's storage format version — evidence the
+     * cargo path dependency compiled, linked, and loaded through Node-API.
+     */
+    engineVersion(): string;
+    /**
+     * Creates a fresh DURABLE store at `path` (frozen ruling 3: no ephemeral
+     * kind crosses this bridge). Refuses an already-initialized directory
+     * (throws); schema failures return as data.
+     */
+    dbCreate(path: string, spec: SchemaSpec): DbOpenResult;
+    /**
+     * Opens an existing durable store, verifying format version, store
+     * kind, and schema fingerprint (`fingerprintMismatch` as data).
+     */
+    dbOpen(path: string, spec: SchemaSpec): DbOpenResult;
+    /**
+     * Closes the handle. Dependent handles each hold the engine alive; the
+     * environment (and its exclusive lock) releases when the last closes.
+     */
+    dbClose(db: DbHandle): void;
+    /** The PRD-02 manifest — every name → id table, one plain object. */
+    dbManifest(db: DbHandle): Manifest;
+    /**
+     * The open store's schema fingerprint, 64 lowercase hex chars — the
+     * cross-host identity readback (`dbCreate` stored this exact value,
+     * `dbOpen` verified it). The engine computes; the bridge hex-encodes.
+     * Test-facing (the cross-host fingerprint lock); the SDK surface stays
+     * bijective with the Rust surface, which exposes no fingerprint
+     * accessor on `Db` — so no `Db` method wraps this.
+     */
+    dbFingerprint(db: DbHandle): string;
+    /**
+     * The current committed generation — diagnostics only. The write-side
+     * witness is always the SNAPSHOT handle (`dbWriteFrom`), never this
+     * integer: an integer witness would be a claim a caller could fabricate
+     * or stale-cache (the engine's recorded refusal).
+     */
+    dbGeneration(db: DbHandle): bigint;
+    /**
+     * Opens a store FROM ITS OWN PERSISTED DESCRIPTOR (the read-only,
+     * theory-less open; engine 70-api.md § exhume) — no schema crosses in.
+     * The three adoption-era refusals return as data ({@link ExhumeResult});
+     * genuine failures throw. The handle has no close anywhere on this
+     * bridge (zero closables): GC reclaims the engine side and releases the
+     * store's exclusive lock — reclamation only, never correctness.
+     */
+    dbExhume(path: string): ExhumeResult;
+    /**
+     * The exhumed store's persisted schema as manifest-shaped data — the
+     * engine's own manifest rendering of the STORED descriptor: relations
+     * in engine-id order, sealed field lists (a closed relation opens with
+     * the synthetic (`id`, u64) handle field) with structural value types,
+     * and closed-relation rosters.
+     */
+    exhumeDescriptor(exhume: ExhumeHandle): Manifest;
+    /**
+     * Full-relation export by NAME in row-id order, values marshaled per
+     * the STORED descriptor (str already resolved through `_dict` inside
+     * the engine; a closed relation scans its sealed roster). Each call is
+     * one self-contained snapshot read; an unknown relation name throws.
+     */
+    exhumeScan(exhume: ExhumeHandle, relationName: string): FactValue[][];
+    /** Opens one MVCC read snapshot as a live handle. */
+    dbSnapshot(db: DbHandle): SnapshotHandle;
+    /** Closes the snapshot, releasing its LMDB reader slot. */
+    snapshotClose(snap: SnapshotHandle): void;
+    /** Full-relation export in row-id order (one row per fact). */
+    snapshotScan(snap: SnapshotHandle, relationId: number): FactValue[][];
+    /** Committed-state membership of one fact (sealed field order). */
+    snapshotContains(snap: SnapshotHandle, relationId: number, values: readonly FactValue[]): boolean;
+    /**
+     * Committed-state point lookup through a key statement (`keyValues` in
+     * the statement's projection order); `null` on a miss.
+     */
+    snapshotGet(snap: SnapshotHandle, relationId: number, keyStatementId: number, keyValues: readonly FactValue[]): FactValue[] | null;
+    /**
+     * Begins a write transaction: the submitted delta. One write
+     * transaction may be open per db handle at a time (single-writer
+     * engine; a second begin throws rather than deadlocking the process).
+     */
+    dbWriteBegin(db: DbHandle): TxHandle;
+    /**
+     * Begins a WITNESSED write transaction: commits only if no
+     * state-changing commit landed since `snap` was taken —
+     * `generationMoved` as data otherwise (the optimistic
+     * read-compute-write loop's entry; retry policy stays host-side).
+     */
+    dbWriteFrom(db: DbHandle, snap: SnapshotHandle): WriteFromResult;
+    /**
+     * Records an insert into the delta; `true` iff the final state changed.
+     * Nothing is judged until commit; shape violations throw typed.
+     */
+    txInsert(tx: TxHandle, relationId: number, values: readonly FactValue[]): boolean;
+    /** Records a delete into the delta; `true` iff the final state changed. */
+    txDelete(tx: TxHandle, relationId: number, values: readonly FactValue[]): boolean;
+    /**
+     * Final-state membership (base + pending delta — the exact view the
+     * commit judgment judges; check-then-act is race-free by construction).
+     */
+    txContains(tx: TxHandle, relationId: number, values: readonly FactValue[]): boolean;
+    /** Final-state point lookup through a key statement; `null` on a miss. */
+    txGet(tx: TxHandle, relationId: number, keyStatementId: number, keyValues: readonly FactValue[]): FactValue[] | null;
+    /**
+     * Mints the next fresh value for `(relationId, fieldId)` and returns it
+     * — the engine's alloc-then-insert dyn-lane mint (there is no
+     * insert-with-omitted-fields spelling; include the minted id in the
+     * full row).
+     */
+    txAlloc(tx: TxHandle, relationId: number, fieldId: number): bigint;
+    /**
+     * Commits the delta: every dependency statement judged against the
+     * final state; a rejection carries the complete violation rendering.
+     * The handle is spent either way.
+     */
+    txCommit(tx: TxHandle): CommitResult;
+    /** Aborts the delta (LMDB was never touched). The handle is spent. */
+    txAbort(tx: TxHandle): void;
+    /**
+     * Prepares a program (IR as data, ids only; plan pinned at prepare).
+     * Roster errors return as data.
+     */
+    dbPrepare(db: DbHandle, program: ProgramIr): PrepareResult;
+    /**
+     * Executes against a snapshot with positional params. One-copy owned
+     * rows out, column order = the program's head order; answers are a set
+     * — the host sorts.
+     */
+    preparedExecute(prepared: PreparedHandle, snap: SnapshotHandle, params: readonly QueryParam[]): FactValue[][];
+    /** The pull-based plan-drift signal against a snapshot. */
+    preparedStaleness(prepared: PreparedHandle, snap: SnapshotHandle): Staleness;
+    /** Releases the prepared query. */
+    preparedClose(prepared: PreparedHandle): void;
+}
+/**
+ * Resolves and loads the native bridge from its per-platform binary package
+ * (`@bjornpagen/bumbledb-<platform>-<arch>`) — the Biome/esbuild/napi-rs
+ * pattern. npm/pnpm install ONLY the `optionalDependency` whose `os`/`cpu`
+ * match the host, so a matching host resolves the addon and every other host
+ * resolves nothing. The two failure modes are distinct and both typed:
+ *
+ *   - the platform package is ABSENT (the expected state on any
+ *     non-darwin-arm64 host, and on a foreign `platform`/`arch` passed under
+ *     test) — an actionable unsupported-platform error naming the running
+ *     `platform-arch` and the shipped set;
+ *   - the platform package is PRESENT but its `bumbledb.node` will not load
+ *     (a genuine ABI/corruption fault) — the wrapped loader error.
+ *
+ * Parameterized on `platform`/`arch` so the resolution law is exercised for
+ * foreign hosts as a unit, without spawning a foreign process.
+ */
+declare function loadNativeBinding(platform: string, arch: string): Native;
+/**
+ * The loaded bumbledb-node bridge for the running host. Import this object
+ * for every native call; the resolve-and-load happens once at module
+ * initialization and an absent or unloadable artifact fails fast here rather
+ * than at first use.
+ */
+declare const native: Native;
+export type { AggOpIr, AtomIr, AtomSourceIr, CmpOpIr, CommitResult, ComparisonIr, ConditionTreeIr, DbHandle, DbOpenResult, ExhumeHandle, ExhumeResult, FactValue, FindTermIr, HeadOpIr, HeadTermIr, IntervalValue, Manifest, ManifestField, ManifestRelation, ManifestRow, ManifestStatement, MaskTermIr, Native, OccurrenceDrift, PredicateDefIr, PreparedHandle, PrepareResult, ProgramIr, QueryParam, RuleIr, SnapshotHandle, Staleness, StatementKindTag, TaggedValue, TermIr, TxHandle, Violation, ViolationFact, WriteFromResult };
+export { loadNativeBinding, native };
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

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

package/dist/native.js

@@ -0,0 +1,64 @@
+import { createRequire } from "node:module";
+import * as errors from "@superbuilders/errors";
+/**
+ * The sole platform this release ships (PRD-03 ruling 1: prebuilt-only,
+ * darwin-arm64). The per-platform-package structure below makes adding
+ * `darwin-x64`/`linux-*`/`win32-*` pure addition — one more `os`/`cpu`-gated
+ * package plus a CI matrix — never a redesign, so this string is the only
+ * place the shipped set is named for the unsupported-platform message.
+ */
+const SHIPPED_PLATFORMS = "darwin-arm64";
+/**
+ * CommonJS require anchored to this module, the only mechanism ESM has for
+ * loading a Node-API addon without an experimental flag (static `import` of
+ * `.node` files still sits behind `--experimental-addon-modules` on Node 24).
+ * It resolves the per-platform binary package by name (see
+ * {@link loadNativeBinding}); the addon never crosses as a relative path.
+ * createRequire is the only unflagged Node-API addon loader in ESM, and this
+ * file is the package's single sanctioned FFI boundary
+ * (docs/road-to-1.0.0/prd-03-arch-split-packaging.md).
+ */
+const requireNative = createRequire(import.meta.url);
+/**
+ * Resolves and loads the native bridge from its per-platform binary package
+ * (`@bjornpagen/bumbledb-<platform>-<arch>`) — the Biome/esbuild/napi-rs
+ * pattern. npm/pnpm install ONLY the `optionalDependency` whose `os`/`cpu`
+ * match the host, so a matching host resolves the addon and every other host
+ * resolves nothing. The two failure modes are distinct and both typed:
+ *
+ *   - the platform package is ABSENT (the expected state on any
+ *     non-darwin-arm64 host, and on a foreign `platform`/`arch` passed under
+ *     test) — an actionable unsupported-platform error naming the running
+ *     `platform-arch` and the shipped set;
+ *   - the platform package is PRESENT but its `bumbledb.node` will not load
+ *     (a genuine ABI/corruption fault) — the wrapped loader error.
+ *
+ * Parameterized on `platform`/`arch` so the resolution law is exercised for
+ * foreign hosts as a unit, without spawning a foreign process.
+ */
+function loadNativeBinding(platform, arch) {
+    const platformPackage = `@bjornpagen/bumbledb-${platform}-${arch}`;
+    // Presence probe: the platform package's OWN manifest resolves iff the
+    // matching optional dependency was installed. Its absence is the
+    // expected, benign "unsupported platform" — never a corruption signal.
+    const present = errors.trySync(() => requireNative.resolve(`${platformPackage}/package.json`));
+    if (present.error) {
+        throw errors.wrap(present.error, `no native binary for ${platform}-${arch}: @bjornpagen/bumbledb ships ${SHIPPED_PLATFORMS} only`);
+    }
+    // The package is present; load its addon (its `main` is `bumbledb.node`).
+    // A failure HERE is corruption or an ABI mismatch, not an absent platform.
+    const loaded = errors.trySync(() => requireNative(platformPackage));
+    if (loaded.error) {
+        throw errors.wrap(loaded.error, `load the ${platformPackage} native binary (package present but unloadable)`);
+    }
+    return loaded.data;
+}
+/**
+ * The loaded bumbledb-node bridge for the running host. Import this object
+ * for every native call; the resolve-and-load happens once at module
+ * initialization and an absent or unloadable artifact fails fast here rather
+ * than at first use.
+ */
+const native = loadNativeBinding(process.platform, process.arch);
+export { loadNativeBinding, native };
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAA;AAgd/C;;;;;;GAMG;AACH,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAExC;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAS,iBAAiB,CAAC,QAAgB,EAAE,IAAY;IACxD,MAAM,eAAe,GAAG,wBAAwB,QAAQ,IAAI,IAAI,EAAE,CAAA;IAElE,uEAAuE;IACvE,iEAAiE;IACjE,uEAAuE;IACvE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,eAAe,eAAe,CAAC,CAAC,CAAA;IAC9F,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,MAAM,CAAC,IAAI,CAChB,OAAO,CAAC,KAAK,EACb,wBAAwB,QAAQ,IAAI,IAAI,gCAAgC,iBAAiB,OAAO,CAChG,CAAA;IACF,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAA;IACnE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,eAAe,iDAAiD,CAAC,CAAA;IAC9G,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAA;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,MAAM,GAAW,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;AA2CxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,CAAA"}