@visorcraft/mongreldb-kit 0.7.0

package/dist/db.js

@@ -0,0 +1,495 @@
+import { createHash } from 'node:crypto';
+import mongreldb from '@visorcraft/mongreldb';
+import { rowsToTsv, tsvToRows } from './tsv.js';
+import { rowFromRowJs } from './rows.js';
+import { internalTables, kitSchemaCatalog } from './internalTables.js';
+import { migrateSync as runMigrateSync } from './migrate.js';
+import { deleteGuardsForTable } from './constraints.js';
+import { KitError, isRetryableConflict } from './errors.js';
+/** Members of a set-valued cell: a JSON array, or a JSON string of one. */
+function parseStringSet(value) {
+    let arr = value;
+    if (typeof value === 'string') {
+        try {
+            arr = JSON.parse(value);
+        }
+        catch {
+            arr = null;
+        }
+    }
+    const out = new Set();
+    if (Array.isArray(arr)) {
+        for (const v of arr) {
+            if (typeof v === 'string')
+                out.add(v);
+            else if (typeof v === 'number' || typeof v === 'boolean')
+                out.add(String(v));
+        }
+    }
+    return out;
+}
+const addon = mongreldb;
+function toMongrelColumnType(storageType) {
+    switch (storageType) {
+        case 'bool':
+            return 0 /* addon.ColumnType.Bool */;
+        case 'int64':
+            return 1 /* addon.ColumnType.Int64 */;
+        case 'float64':
+            return 2 /* addon.ColumnType.Float64 */;
+        case 'text':
+        case 'timestamp':
+        case 'date':
+        case 'bytes':
+        case 'json':
+            return 5 /* addon.ColumnType.Bytes */;
+        case 'embedding':
+            return 6 /* addon.ColumnType.Embedding */;
+        case 'sparse':
+            // A sparse column is stored as bincoded bytes; the sparse index reads
+            // the tokens from those bytes.
+            return 5 /* addon.ColumnType.Bytes */;
+    }
+}
+function toMongrelSchema(table) {
+    const indexes = table.indexes.flatMap((idx) => idx.columns.map((colName) => {
+        const col = table.columns.find((c) => c.name === colName);
+        if (!col) {
+            throw new Error(`Index column "${colName}" not found in table "${table.name}"`);
+        }
+        return {
+            name: `${idx.name}_${colName}`,
+            columnId: col.id,
+            kind: idx.kind === 'fm'
+                ? 1 /* addon.IndexKindSpec.FmIndex */
+                : idx.kind === 'ann'
+                    ? 2 /* addon.IndexKindSpec.Ann */
+                    : idx.kind === 'sparse'
+                        ? 3 /* addon.IndexKindSpec.Sparse */
+                        : idx.kind === 'minhash'
+                            ? 4 /* addon.IndexKindSpec.MinHash */
+                            : 0 /* addon.IndexKindSpec.Bitmap */
+        };
+    }));
+    const indexedColumns = new Set(table.indexes.flatMap((idx) => idx.columns));
+    for (const pk of table.primaryKey) {
+        if (indexedColumns.has(pk))
+            continue;
+        const col = table.columns.find((c) => c.name === pk);
+        if (!col) {
+            throw new Error(`Primary key column "${pk}" not found in table "${table.name}"`);
+        }
+        indexes.push({
+            name: `pk_${pk}`,
+            columnId: col.id,
+            kind: 0 /* addon.IndexKindSpec.Bitmap */
+        });
+        indexedColumns.add(pk);
+    }
+    for (const fk of table.foreignKeys) {
+        for (const colName of fk.columns) {
+            if (indexedColumns.has(colName))
+                continue;
+            const col = table.columns.find((c) => c.name === colName);
+            if (!col) {
+                throw new Error(`Foreign key column "${colName}" not found in table "${table.name}"`);
+            }
+            indexes.push({
+                name: `fk_${fk.name}_${colName}`,
+                columnId: col.id,
+                kind: 0 /* addon.IndexKindSpec.Bitmap */
+            });
+            indexedColumns.add(colName);
+        }
+    }
+    return {
+        columns: table.columns.map((col) => ({
+            id: col.id,
+            name: col.name,
+            ty: toMongrelColumnType(col.storageType),
+            primaryKey: col.primaryKey,
+            nullable: col.nullable,
+            // A Kit sequence-default column maps to the engine's native
+            // AUTO_INCREMENT allocator (a per-table WAL-durable counter) instead
+            // of the legacy __kit_sequences hot row.
+            autoIncrement: col.default?.kind === 'sequence',
+            embeddingDim: col.embeddingDim,
+            encrypted: col.encrypted,
+            encryptedIndexable: col.encryptedIndexable
+        })),
+        indexes
+    };
+}
+function columnId(table, name) {
+    const col = table.columns.find((c) => c.name === name);
+    if (!col) {
+        throw new Error(`Column "${name}" not found in table "${table.name}"`);
+    }
+    return col.id;
+}
+function isoNow() {
+    return new Date().toISOString();
+}
+/**
+ * Run `fn` inside a fresh transaction, retrying bounded-exponentially on
+ * retryable conflicts. Exported so query builders and `KitDatabase` methods
+ * can share one implementation.
+ */
+export function runSyncTxn(kit, fn, opts = {}) {
+    const maxRetries = opts.maxRetries ?? 5;
+    const baseDelayMs = opts.baseDelayMs ?? 1;
+    let lastErr;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const txn = kit.begin();
+        try {
+            fn(txn);
+            txn.commit();
+            return;
+        }
+        catch (err) {
+            try {
+                txn.rollback();
+            }
+            catch {
+                // ignore rollback errors
+            }
+            lastErr = err;
+            if (attempt < maxRetries && isRetryableConflict(err)) {
+                const delay = baseDelayMs * (attempt + 1);
+                if (delay > 0) {
+                    const start = Date.now();
+                    while (Date.now() - start < delay) {
+                        // busy wait
+                    }
+                }
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw lastErr;
+}
+export class KitDatabase {
+    db;
+    schema;
+    constructor(db, schema) {
+        this.db = db;
+        this.schema = schema;
+    }
+    static async open(path, schema) {
+        let db;
+        try {
+            db = addon.Database.open(path);
+        }
+        catch {
+            db = addon.Database.withPath(path);
+        }
+        const kitDb = new KitDatabase(db, schema);
+        kitDb.ensureInternalTables();
+        for (const table of schema.tablesList()) {
+            kitDb.ensureAppTable(table);
+        }
+        kitDb.writeSchemaCatalog();
+        return kitDb;
+    }
+    static openSync(path, schema, options) {
+        if (options?.encryption?.passphrase) {
+            try {
+                return KitDatabase.openEncryptedSync(path, schema, options.encryption.passphrase);
+            }
+            catch {
+                return KitDatabase.createEncryptedSync(path, schema, options.encryption.passphrase);
+            }
+        }
+        let db;
+        try {
+            db = addon.Database.open(path);
+        }
+        catch {
+            db = addon.Database.withPath(path);
+        }
+        return KitDatabase.initialize(db, schema);
+    }
+    static createEncryptedSync(path, schema, passphrase) {
+        if (!passphrase) {
+            throw new Error('createEncryptedSync requires a non-empty passphrase');
+        }
+        const db = addon.Database.createEncrypted(path, passphrase);
+        return KitDatabase.initialize(db, schema);
+    }
+    static openEncryptedSync(path, schema, passphrase) {
+        if (!passphrase) {
+            throw new Error('openEncryptedSync requires a non-empty passphrase');
+        }
+        const db = addon.Database.openEncrypted(path, passphrase);
+        return KitDatabase.initialize(db, schema);
+    }
+    static initialize(db, schema) {
+        const kitDb = new KitDatabase(db, schema);
+        kitDb.ensureInternalTables();
+        for (const table of schema.tablesList()) {
+            kitDb.ensureAppTable(table);
+        }
+        kitDb.writeSchemaCatalog();
+        return kitDb;
+    }
+    ensureInternalTables() {
+        for (const table of internalTables) {
+            if (!this.db.tableNames().includes(table.name)) {
+                this.db.createTable(table.name, toMongrelSchema(table));
+            }
+        }
+    }
+    ensureAppTable(table) {
+        if (this.db.tableNames().includes(table.name))
+            return;
+        this.db.createTable(table.name, toMongrelSchema(table));
+    }
+    writeSchemaCatalog() {
+        const catalog = this.db.table('__kit_schema_catalog');
+        const schemaJson = JSON.stringify(this.schema.tablesList().map((t) => ({
+            tableId: t.tableId,
+            name: t.name,
+            columns: t.columns.map((c) => ({
+                id: c.id,
+                name: c.name,
+                storageType: c.storageType,
+                applicationType: c.applicationType,
+                nullable: c.nullable,
+                primaryKey: c.primaryKey,
+                enumValues: c.enumValues,
+                min: c.min,
+                max: c.max,
+                minLength: c.minLength,
+                maxLength: c.maxLength,
+                regex: c.regex?.source
+            })),
+            primaryKey: t.primaryKey,
+            indexes: t.indexes,
+            foreignKeys: t.foreignKeys,
+            unique: t.unique,
+            checks: t.checks.map((c) => ({ name: c.name }))
+        })));
+        const checksum = createHash('sha256').update(schemaJson).digest('hex');
+        catalog.put([
+            { columnId: columnId(kitSchemaCatalog, 'schema_version'), int64: 1n },
+            { columnId: columnId(kitSchemaCatalog, 'schema_json'), text: schemaJson },
+            { columnId: columnId(kitSchemaCatalog, 'checksum'), text: checksum },
+            { columnId: columnId(kitSchemaCatalog, 'written_at'), text: isoNow() }
+        ]);
+        catalog.commit();
+    }
+    migrateSync(schema, migrations) {
+        runMigrateSync(this, schema, migrations);
+    }
+    close() {
+        this.db.close();
+    }
+    get nativeDb() {
+        return this.db;
+    }
+    tableNames() {
+        return this.db.tableNames().filter((name) => !name.startsWith('__kit_'));
+    }
+    /** Verify run footer checksums; returns integrity issues grouped by table. */
+    check() {
+        return JSON.parse(this.db.check());
+    }
+    /** Drop corrupt runs; returns the doctor report. */
+    doctor() {
+        return JSON.parse(this.db.doctor());
+    }
+    /**
+     * Flush every table's in-memory writes to durable sorted runs. Besides
+     * durability, this empties the memtable, which enables the engine's
+     * incremental-aggregate fast path (see `incrementalAggregate`).
+     */
+    flush() {
+        for (const name of this.db.tableNames()) {
+            this.db.table(name).flush();
+        }
+    }
+    /** The current visible commit epoch (monotonically increasing version). */
+    snapshotEpoch() {
+        return this.db.snapshotEpoch();
+    }
+    /** Export every visible row of `table` as a TSV document. */
+    exportTsv(table) {
+        const spec = this.schema.table(table);
+        const rows = this.selectFrom(spec).executeSync();
+        return rowsToTsv(spec, rows);
+    }
+    /** Read every row of `table` visible at commit `epoch` (MVCC time-travel). */
+    rowsAtEpoch(table, epoch) {
+        const spec = this.schema.table(table);
+        return this.db
+            .table(table)
+            .rowsAtEpoch(epoch)
+            .map((rj) => rowFromRowJs(spec, rj));
+    }
+    /**
+     * Reservoir-sampled approximate aggregate (`count`/`sum`/`avg`) with a
+     * `z`-score confidence interval (default ~95%). Returns
+     * `{ point, ci_low, ci_high, n_population, n_sample_live, n_passing }`, or
+     * `null` when the reservoir is empty. `column` is required for `sum`/`avg`.
+     */
+    approxAggregate(table, agg, column, z = 1.96) {
+        const spec = this.schema.table(table);
+        let columnId;
+        if (column !== undefined) {
+            const col = spec.columns.find((c) => c.name === column);
+            if (!col)
+                throw new KitError(`unknown column '${column}'`);
+            columnId = col.id;
+        }
+        else if (agg !== 'count') {
+            throw new KitError(`approx ${agg} requires a column`);
+        }
+        const raw = this.db.table(table).approxAggregate(agg, columnId, z);
+        return raw === null ? null : JSON.parse(raw);
+    }
+    /**
+     * Stream `table` in batches of at most `batchSize` rows, invoking `cb` once
+     * per batch. Implemented with `limit`/`offset` pagination, so memory stays
+     * bounded to one batch. (Not snapshot-consistent across batches, and O(n·
+     * pages) — the Rust/Python kit's `scan_batched` uses the engine's native
+     * single-pass cursor.)
+     */
+    scanBatched(table, batchSize, cb) {
+        const spec = this.schema.table(table);
+        const size = Math.max(1, Math.floor(batchSize));
+        let offset = 0;
+        for (;;) {
+            const rows = this.selectFrom(spec)
+                .limit(size)
+                .offset(offset)
+                .executeSync();
+            if (rows.length === 0)
+                break;
+            cb(rows);
+            if (rows.length < size)
+                break;
+            offset += rows.length;
+        }
+    }
+    /**
+     * Rank rows of `table` by Jaccard set-similarity between `query` and the
+     * string set stored (as a JSON array) in `column`, returning the top `k`
+     * with similarity `> 0`, highest first. The set-similarity / dedup-join
+     * primitive the `MinHash` index kind is meant to serve; an exact linear scan
+     * (a sub-linear MinHash/LSH index remains engine future-work).
+     */
+    setSimilarity(table, column, query, k) {
+        const spec = this.schema.table(table);
+        const col = spec.columns.find((c) => c.name === column);
+        if (!col) {
+            throw new KitError(`unknown column '${column}' on table '${table}'`);
+        }
+        const q = new Set(query);
+        // Fast path: a MinHash index generates sub-linear candidates via LSH,
+        // which are then re-verified with exact Jaccard below.
+        const hasMinhash = (spec.indexes ?? []).some((idx) => idx.kind === 'minhash' && idx.columns.includes(column));
+        let rows;
+        if (hasMinhash) {
+            const candidateBudget = Math.max(k * 8, k + 64);
+            const cond = {
+                kind: 12 /* addon.ConditionKind.MinHashSimilar */,
+                columnId: col.id,
+                values: query,
+                k: candidateBudget
+            };
+            rows = this.db
+                .table(table)
+                .query([cond])
+                .map((rj) => rowFromRowJs(spec, rj));
+        }
+        else {
+            rows = this.selectFrom(spec).executeSync();
+        }
+        const scored = [];
+        for (const row of rows) {
+            const set = parseStringSet(row[column]);
+            let inter = 0;
+            for (const x of set)
+                if (q.has(x))
+                    inter++;
+            const union = set.size + q.size - inter;
+            const sim = union === 0 ? 0 : inter / union;
+            if (sim > 0)
+                scored.push({ row, similarity: sim });
+        }
+        scored.sort((a, b) => b.similarity - a.similarity);
+        return scored.slice(0, Math.max(0, k));
+    }
+    /** Import a TSV document into `table`; returns the number of rows inserted. */
+    importTsv(table, text) {
+        const spec = this.schema.table(table);
+        const rows = tsvToRows(spec, text);
+        if (rows.length === 0)
+            return 0;
+        this.insertInto(spec)
+            .valuesMany(rows)
+            .executeSync();
+        return rows.length;
+    }
+    /**
+     * Rename a live table from `oldName` to `newName`. The source must exist and
+     * be live; the target must not collide with an existing table (the engine
+     * enforces both). The rename is durable: it is logged to the WAL and applied
+     * again on reopen. The `table_id`, schema, and on-disk layout are unchanged,
+     * so outstanding handles and indexes remain valid.
+     *
+     * Internal `__kit_`-prefixed names are off-limits in both directions: an app
+     * table cannot be renamed to a `__kit_` name (it would vanish from
+     * {@link KitDatabase.tableNames}, which filters that prefix) and an internal
+     * table cannot be renamed away from its expected name (the Kit looks internal
+     * tables up by name). This keeps the internal-table namespace invariant
+     * intact without the engine needing to know about Kit conventions.
+     */
+    renameTable(oldName, newName) {
+        if (oldName.startsWith('__kit_') || newName.startsWith('__kit_')) {
+            throw new Error("renameTable: names beginning with '__kit_' are reserved for internal tables");
+        }
+        this.db.renameTable(oldName, newName);
+    }
+    begin() {
+        return this.db.begin();
+    }
+    /**
+     * Reserve (without inserting) the next engine-native AUTO_INCREMENT value for
+     * `tableName`, advancing the engine's per-table counter. Returns `null` when
+     * the table has no auto-increment column.
+     *
+     * This is the replacement for the legacy `allocateSequenceSync` hot-row
+     * scheme: it is a pure in-memory counter bump (no `__kit_sequences` row, no
+     * extra commit) that becomes durable when a row carrying the reserved id
+     * commits. An aborted reservation simply leaves a gap, which the never-reuse
+     * rule permits. Used by `prepareInsertRowSync` so a transaction can stage the
+     * row with an explicit id and still return it from `executeSync()`.
+     */
+    reserveAutoIncSync(tableName) {
+        const reserved = this.db.table(tableName).reserveAutoInc();
+        return reserved ?? null;
+    }
+    /**
+     * Remove every row from `tableName` and clear the Kit guard rows owned by
+     * that table. Throws when another table has a foreign key referencing it.
+     */
+    truncateTable(tableName) {
+        this.schema.table(tableName);
+        const references = this.schema
+            .tablesList()
+            .flatMap((t) => t.foreignKeys
+            .filter((fk) => fk.referencesTable === tableName)
+            .map((fk) => `${t.name}.${fk.name}`));
+        if (references.length > 0) {
+            throw new KitError(`table ${tableName} is referenced by foreign key(s): ${references.join(', ')}`, 'RESTRICT');
+        }
+        const kit = { db: this.nativeDb, schema: this.schema };
+        runSyncTxn(this, (txn) => {
+            txn.truncate(tableName);
+            deleteGuardsForTable(kit, txn, tableName);
+        });
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,26 @@
+import type { TableSpec } from './types.js';
+export type DefaultValue = {
+    kind: 'static';
+    value: unknown;
+} | {
+    kind: 'now';
+} | {
+    kind: 'uuid';
+} | {
+    kind: 'sequence';
+    name: string;
+} | {
+    kind: 'custom';
+    fn: () => unknown;
+};
+export interface DefaultContext {
+    now: string;
+    uuid: () => string;
+}
+export declare function staticDefault(value: unknown): DefaultValue;
+export declare function nowDefault(): DefaultValue;
+export declare function uuidDefault(): DefaultValue;
+export declare function sequenceDefault(name: string): DefaultValue;
+export declare function customDefault(fn: () => unknown): DefaultValue;
+export declare function applyDefaults(table: TableSpec, row: Record<string, unknown>, ctx: DefaultContext): Record<string, unknown>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,YAAY,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,OAAO,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAE1D;AAED,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,WAAW,IAAI,YAAY,CAE1C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAE1D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,OAAO,GAAG,YAAY,CAE7D;AAQD,wBAAgB,aAAa,CAC5B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,GAAG,EAAE,cAAc,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgCzB"}

package/dist/defaults.js

@@ -0,0 +1,56 @@
+export function staticDefault(value) {
+    return { kind: 'static', value };
+}
+export function nowDefault() {
+    return { kind: 'now' };
+}
+export function uuidDefault() {
+    return { kind: 'uuid' };
+}
+export function sequenceDefault(name) {
+    return { kind: 'sequence', name };
+}
+export function customDefault(fn) {
+    return { kind: 'custom', fn };
+}
+function generatedDefault(generated) {
+    if (generated === 'uuid')
+        return uuidDefault();
+    if (generated === 'now')
+        return nowDefault();
+    return null;
+}
+export function applyDefaults(table, row, ctx) {
+    const out = { ...row };
+    for (const col of table.columns) {
+        const value = out[col.name];
+        if (value !== undefined && value !== null)
+            continue;
+        const source = col.default ?? generatedDefault(col.generated);
+        if (!source)
+            continue;
+        switch (source.kind) {
+            case 'static':
+                out[col.name] = source.value;
+                break;
+            case 'now':
+                out[col.name] = col.storageType === 'date' ? ctx.now.slice(0, 10) : ctx.now;
+                break;
+            case 'uuid':
+                out[col.name] = ctx.uuid();
+                break;
+            // 'sequence' columns are engine-managed AUTO_INCREMENT: the caller
+            // (prepareInsertRowSync) reserves the id up front via reserveAutoIncSync,
+            // so the value is already present here. If it was somehow omitted, leave
+            // it unset — the engine assigns it on insert (and a null/undefined PK is
+            // caught by validation).
+            case 'sequence':
+                break;
+            case 'custom':
+                out[col.name] = source.fn();
+                break;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW;IAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAiB;IAC9C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAgC;IACzD,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,WAAW,EAAE,CAAC;IAC/C,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,UAAU,EAAE,CAAC;IAC7C,OAAO,IAAI,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAC5B,KAAgB,EAChB,GAA4B,EAC5B,GAAmB;IAEnB,MAAM,GAAG,GAA4B,EAAE,GAAG,GAAG,EAAE,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QAEpD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9D,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACZ,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC7B,MAAM;YACP,KAAK,KAAK;gBACT,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;gBAC5E,MAAM;YACR,KAAK,MAAM;gBACV,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC3B,MAAM;YACP,mEAAmE;YACnE,0EAA0E;YAC1E,yEAAyE;YACzE,yEAAyE;YACzE,yBAAyB;YACzB,KAAK,UAAU;gBACd,MAAM;YACP,KAAK,QAAQ;gBACX,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC;gBAC5B,MAAM;QACR,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,54 @@
+export type KitErrorCode = 'STORAGE' | 'VALIDATION' | 'NOT_FOUND' | 'DUPLICATE' | 'FOREIGN_KEY' | 'RESTRICT' | 'CONFLICT' | 'MIGRATION' | 'SCHEMA_DRIFT' | 'TIMEOUT' | 'UNSUPPORTED' | 'INTEGRITY';
+export declare class KitError extends Error {
+    readonly code: KitErrorCode;
+    constructor(message: string, code?: KitErrorCode);
+}
+export declare class KitValidationError extends KitError {
+    table?: string;
+    column?: string;
+    constructor(message: string, table?: string, column?: string);
+}
+export declare class KitNotFoundError extends KitError {
+    table: string;
+    pk: unknown;
+    constructor(table: string, pk: unknown);
+}
+export declare class KitDuplicateError extends KitError {
+    table: string;
+    constraint: string;
+    constructor(table: string, constraint: string);
+}
+export declare class KitForeignKeyError extends KitError {
+    table: string;
+    constraint: string;
+    constructor(table: string, constraint: string);
+}
+export declare class KitRestrictError extends KitError {
+    table: string;
+    constraint: string;
+    constructor(table: string, constraint: string);
+}
+export declare class KitConflictError extends KitError {
+    retryable: boolean;
+    constructor(message?: string);
+}
+export declare class KitMigrationError extends KitError {
+    constructor(message: string);
+}
+export declare class KitSchemaDriftError extends KitError {
+    constructor(message: string);
+}
+export declare class KitTimeoutError extends KitError {
+    constructor(message?: string);
+}
+export declare class KitUnsupportedError extends KitError {
+    constructor(message: string);
+}
+/**
+ * Returns true when the underlying error is a retryable MongrelDB write-write
+ * conflict. The native addon prefixes commit-time conflict errors with
+ * `__CONFLICT__:` so callers can detect them without instanceof checks against
+ * addon-owned classes that may not cross the require boundary cleanly.
+ */
+export declare function isRetryableConflict(err: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACrB,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,aAAa,GACb,UAAU,GACV,UAAU,GACV,WAAW,GACX,cAAc,GACd,SAAS,GACT,aAAa,GACb,WAAW,CAAC;AAEf,qBAAa,QAAS,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAwB;CAK3D;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;gBAEJ,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM5D;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;gBAEA,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO;CAMtC;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;gBAEP,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAM7C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;gBAEP,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAM7C;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;gBAEP,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAM7C;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC7C,SAAS,UAAQ;gBAEL,OAAO,SAAa;CAIhC;AAED,qBAAa,iBAAkB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAChC,OAAO,SAA0B;CAI7C;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACpC,OAAO,EAAE,MAAM;CAI3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAKzD"}