@vibesdotdev/localdb 0.0.2 → 1.0.0-rc.2

package/dist/driver/sqlite-driver.base.js

@@ -0,0 +1,426 @@
+/**
+ * The shared provider side of LocalDB's SQLite driver kind
+ * (`localdb/sqlite-driver`, `./sqlite-driver`): the base each host's driver
+ * composes (`./sqlite-driver/base`).
+ *
+ * Every untrusted input a driver reads (the open request, bound parameters,
+ * SQL text) goes through one guard here, and every host failure is classified
+ * here into a typed `CapabilityError`, so every host refuses alike. The
+ * transaction runner is here too. Nothing here reads a host API: a host lends
+ * its path rules and file facts (`SqliteDriverHost`) to the two guards that
+ * need them, and each host package keeps its own SQLite binding.
+ */
+import { CapabilityError, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { SQLITE_DRIVER_REFUSALS } from "./sqlite-driver.js";
+export { LOCALDB_SQLITE_DRIVER_KIND, SQLITE_DRIVER_REFUSALS, sqliteDriverKind } from "./sqlite-driver.js";
+/** The in-memory database name SQLite reserves. */
+export const SQLITE_MEMORY_PATH = ':memory:';
+/** Put a redacted failure's bounded facts in public details without retaining the thrown value. */
+export function sqliteFailureFacts(prefix, failure) {
+    return {
+        [`${prefix}Name`]: failure.name,
+        [`${prefix}Code`]: failure.code ?? 'unspecified',
+        [`${prefix}Reason`]: failure.reason ?? 'unspecified'
+    };
+}
+/** A driver refusal containing only the contract's fixed, bounded facts. */
+export class SqliteDriverFailure extends CapabilityError {
+    constructor(failure) {
+        super(failure.message, failure.code, {
+            reason: failure.reason,
+            retryable: failure.retryable,
+            details: failure.details
+        });
+        this.name = 'SqliteDriverFailure';
+    }
+}
+/** Construct a cause-free driver refusal from the contract's fixed facts. */
+export function sqliteDriverFailure(failure) {
+    return new CapabilityError(failure.message, failure.code, {
+        reason: failure.reason,
+        retryable: failure.retryable,
+        details: failure.details
+    });
+}
+function guardedRead(read) {
+    try {
+        return { ok: true, value: read() };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+const OPEN_INVALID = {
+    message: 'The SQLite open request is not an absolute path (or `:memory:`) with boolean `create`/`readonly` options.',
+    code: 'INVALID_INPUT',
+    reason: SQLITE_DRIVER_REFUSALS.openInvalid,
+    retryable: false
+};
+/** A path SQLite may open, before the host's absolute check: `:memory:`, or non-blank text without NUL bytes. */
+const SqlitePathSchema = z
+    .string()
+    .refine((path) => path === SQLITE_MEMORY_PATH || (path.trim().length > 0 && !path.includes('\0')));
+const SqliteOpenOptionsSchema = z
+    .object({ create: z.boolean().optional(), readonly: z.boolean().optional() })
+    .optional();
+/**
+ * Read an open request once. `path` is `:memory:` or a path the host calls
+ * absolute (`host.isAbsolutePath`); `options` is absent or an object whose
+ * `create`/`readonly` fields are booleans when present. Any other value — a
+ * throwing getter, a Proxy (revoked included), a non-string path, or Zod
+ * failing while it reads — refuses the fixed `INVALID_INPUT
+ * sqlite-open-invalid` without retaining the hostile value or thrown error.
+ */
+export function readSqliteOpenRequest(host, path, options) {
+    const read = guardedRead(() => ({
+        path: SqlitePathSchema.safeParse(path),
+        options: SqliteOpenOptionsSchema.safeParse(options)
+    }));
+    if (!read.ok) {
+        throw sqliteDriverFailure({ ...OPEN_INVALID, details: sqliteFailureFacts('inputReadFailure', read.failure) });
+    }
+    const parsedPath = read.value.path;
+    const parsedOptions = read.value.options;
+    if (!parsedPath.success)
+        throw sqliteDriverFailure(OPEN_INVALID);
+    if (parsedPath.data !== SQLITE_MEMORY_PATH && !host.isAbsolutePath(parsedPath.data))
+        throw sqliteDriverFailure(OPEN_INVALID);
+    if (!parsedOptions.success)
+        throw sqliteDriverFailure(OPEN_INVALID);
+    return {
+        path: parsedPath.data,
+        memory: parsedPath.data === SQLITE_MEMORY_PATH,
+        create: parsedOptions.data?.create ?? true,
+        readonly: parsedOptions.data?.readonly ?? false
+    };
+}
+/** One bindable value; a boolean binds as 1 or 0, and bytes are copied, so a later write by the caller cannot change what binds. */
+const SqliteBindingSchema = z.union([
+    z.string(),
+    z.number(),
+    z.bigint(),
+    z.null(),
+    z.boolean().transform((flag) => (flag ? 1 : 0)),
+    z.instanceof(Uint8Array).transform((bytes) => Uint8Array.prototype.slice.call(bytes))
+]);
+function bindingInvalid(index) {
+    return {
+        message: `SQLite parameter ${index + 1} is not a string, finite number, bigint, boolean, null or Uint8Array.`,
+        code: 'INVALID_INPUT',
+        reason: SQLITE_DRIVER_REFUSALS.bindingInvalid,
+        retryable: false,
+        details: { index }
+    };
+}
+/**
+ * Read positional parameters once. Each is a {@link SqliteBinding} (numbers
+ * finite; booleans bind as 1 or 0); bytes are copied (a Proxy over a `Uint8Array` passes `instanceof`
+ * but cannot be copied, and refuses). Anything else refuses `INVALID_INPUT
+ * sqlite-binding-invalid` naming the position.
+ */
+export function readSqliteParams(params) {
+    const read = [];
+    for (let index = 0; index < params.length; index++) {
+        const parsedRead = guardedRead(() => SqliteBindingSchema.safeParse(params[index]));
+        if (!parsedRead.ok) {
+            const invalid = bindingInvalid(index);
+            throw sqliteDriverFailure({
+                ...invalid,
+                details: { ...invalid.details, ...sqliteFailureFacts('inputReadFailure', parsedRead.failure) }
+            });
+        }
+        const parsed = parsedRead.value;
+        if (!parsed.success)
+            throw sqliteDriverFailure(bindingInvalid(index));
+        read.push(parsed.data);
+    }
+    return read;
+}
+const SQL_INVALID = {
+    message: 'SQL text must be a string.',
+    code: 'INVALID_INPUT',
+    reason: SQLITE_DRIVER_REFUSALS.sqlInvalid,
+    retryable: false
+};
+const SqlTextSchema = z.string();
+/** Read SQL text once: a string, or `INVALID_INPUT sqlite-sql-invalid`. */
+export function readSqliteSql(sql) {
+    const read = guardedRead(() => SqlTextSchema.safeParse(sql));
+    if (!read.ok) {
+        throw sqliteDriverFailure({ ...SQL_INVALID, details: sqliteFailureFacts('inputReadFailure', read.failure) });
+    }
+    const parsed = read.value;
+    if (!parsed.success)
+        throw sqliteDriverFailure(SQL_INVALID);
+    return parsed.data;
+}
+/** SQLite's primary result codes the drivers classify. */
+const SQLITE_ERROR = 1;
+const SQLITE_CONSTRAINT = 19;
+const SQLITE_BUSY = 5;
+const SQLITE_LOCKED = 6;
+/** The primary result code of an (extended) SQLite result code. */
+export function primaryResultCode(errcode) {
+    return errcode & 0xff;
+}
+function codeDetails(primary) {
+    return primary === undefined ? {} : { errcode: primary };
+}
+/** SQLite's extended result codes for a unique or primary-key collision. */
+const SQLITE_CONSTRAINT_PRIMARYKEY = 1555;
+const SQLITE_CONSTRAINT_UNIQUE = 2067;
+/** The most host text classification will inspect; no host text is returned. */
+const SQLITE_HOST_TEXT_LIMIT = 4_096;
+/** The text a host SQLite error carries: bounded, read only to classify it, never repeated. */
+export const SqliteHostErrorSchema = z.object({ message: z.string().max(SQLITE_HOST_TEXT_LIMIT) });
+const NodeSqliteHostCodeSchema = z.object({ errcode: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER) });
+const BunSqliteHostCodeSchema = z.object({ errno: z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER) });
+function readSqliteHostCode(failure, codeField) {
+    try {
+        if (codeField === 'errcode') {
+            const parsed = NodeSqliteHostCodeSchema.safeParse(failure);
+            return { ok: true, value: parsed.success ? parsed.data.errcode : undefined };
+        }
+        const parsed = BunSqliteHostCodeSchema.safeParse(failure);
+        return { ok: true, value: parsed.success ? parsed.data.errno : undefined };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+function readSqliteHostMessage(failure) {
+    try {
+        const parsed = SqliteHostErrorSchema.safeParse(failure);
+        return { ok: true, value: parsed.success ? parsed.data.message : undefined };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/**
+ * Read a host SQLite error once without trusting its prototype, getters or
+ * message. Only an integer result code and bounded text used for fixed
+ * classification leave this function; the host error itself never does.
+ */
+export function readSqliteHostFailure(failure, codeField) {
+    const code = readSqliteHostCode(failure, codeField);
+    const message = readSqliteHostMessage(failure);
+    const errcode = code.ok ? code.value : undefined;
+    const text = message.ok ? message.value : undefined;
+    if (!code.ok && !message.ok) {
+        return { errcode, message: text, errcodeReadFailure: code.failure, messageReadFailure: message.failure };
+    }
+    if (!code.ok)
+        return { errcode, message: text, errcodeReadFailure: code.failure };
+    if (!message.ok)
+        return { errcode, message: text, messageReadFailure: message.failure };
+    return { errcode, message: text };
+}
+/** Merge any failure encountered while reading host fields into bounded refusal details. */
+export function sqliteHostFailureDetails(host, details) {
+    if (host.errcodeReadFailure === undefined && host.messageReadFailure === undefined)
+        return details;
+    let merged = details;
+    if (host.errcodeReadFailure !== undefined) {
+        merged = { ...merged, ...sqliteFailureFacts('errcodeReadFailure', host.errcodeReadFailure) };
+    }
+    if (host.messageReadFailure !== undefined) {
+        merged = { ...merged, ...sqliteFailureFacts('messageReadFailure', host.messageReadFailure) };
+    }
+    return merged;
+}
+/**
+ * The fixed condition a failed statement hit, from SQLite's extended result
+ * code and (only to classify it) SQLite's text; the text itself is dropped.
+ */
+export function sqliteFailureConditionOf(errcode, sqliteText) {
+    if (errcode === undefined)
+        return undefined;
+    const primary = primaryResultCode(errcode);
+    const text = sqliteText ?? '';
+    // A collision is a constraint result (19); its extended code or SQLite's own wording names
+    // a unique or primary-key index. A trigger's RAISE is a constraint too, but never these.
+    if (primary === SQLITE_CONSTRAINT) {
+        const keyed = errcode === SQLITE_CONSTRAINT_UNIQUE || errcode === SQLITE_CONSTRAINT_PRIMARYKEY;
+        // SQLite's wording counts only when the host reports no extended code (a bare 19).
+        return keyed || (errcode === SQLITE_CONSTRAINT && /^UNIQUE constraint failed/i.test(text)) ? 'unique-constraint' : undefined;
+    }
+    // Schema conditions are generic errors (1) in SQLite's own wording; any other result code,
+    // whatever its text (a trigger message, a constraint name), is not one of them.
+    if (primary !== SQLITE_ERROR)
+        return undefined;
+    if (/^no such table/i.test(text))
+        return 'missing-table';
+    if (/^no such column/i.test(text))
+        return 'missing-column';
+    if (/^(table|index|view|trigger) \S+ already exists$/i.test(text))
+        return 'already-exists';
+    if (/syntax error|incomplete input|unrecognized token/i.test(text))
+        return 'syntax-error';
+    return undefined;
+}
+/**
+ * Describe a failed statement by its SQLite result code (`undefined` when the
+ * host error carries none) and SQLite's text, read only to classify it into a
+ * fixed `details.condition`: `SQLITE_BUSY`/`SQLITE_LOCKED` are `CONFLICT
+ * sqlite-busy` (retryable), anything else `INTERNAL sqlite-statement-failed`;
+ * `details.errcode` is the primary code.
+ */
+export function describeStatementFailure(errcode, sqliteText) {
+    const primary = errcode === undefined ? undefined : primaryResultCode(errcode);
+    const condition = sqliteFailureConditionOf(errcode, sqliteText);
+    if (primary === SQLITE_BUSY || primary === SQLITE_LOCKED) {
+        return {
+            message: 'SQLite is busy: another connection holds the lock.',
+            code: 'CONFLICT',
+            reason: SQLITE_DRIVER_REFUSALS.busy,
+            retryable: true,
+            details: codeDetails(primary)
+        };
+    }
+    return {
+        message: 'A SQLite statement failed.',
+        code: 'INTERNAL',
+        reason: SQLITE_DRIVER_REFUSALS.statementFailed,
+        retryable: false,
+        details: condition === undefined ? codeDetails(primary) : { ...codeDetails(primary), condition }
+    };
+}
+/**
+ * Describe a failed host open: busy is `sqlite-busy`; anything else is
+ * `UNAVAILABLE sqlite-open-failed`. Only the filesystem preflight below may
+ * classify a path as `sqlite-database-missing`.
+ */
+export function describeOpenFailure(_request, errcode) {
+    const primary = errcode === undefined ? undefined : primaryResultCode(errcode);
+    if (primary === SQLITE_BUSY || primary === SQLITE_LOCKED)
+        return describeStatementFailure(errcode);
+    return {
+        message: 'The SQLite database could not be opened.',
+        code: 'UNAVAILABLE',
+        reason: SQLITE_DRIVER_REFUSALS.openFailed,
+        retryable: false,
+        details: codeDetails(primary)
+    };
+}
+/** `NOT_FOUND sqlite-database-missing`: the request did not allow creating a missing file. */
+export const DATABASE_MISSING = {
+    message: 'No SQLite database exists at the path, and the open does not create one.',
+    code: 'NOT_FOUND',
+    reason: SQLITE_DRIVER_REFUSALS.databaseMissing,
+    retryable: false
+};
+/**
+ * Prove a non-creating open names an existing filesystem entry, through the
+ * host's `statPath`. Only the filesystem's missing-path conditions (ENOENT,
+ * ENOTDIR) become `sqlite-database-missing`;
+ * denied, malformed and I/O failures remain `sqlite-open-failed`.
+ */
+export function requireExistingSqliteFile(host, request) {
+    if (request.memory || request.create)
+        return;
+    try {
+        host.statPath(request.path);
+    }
+    catch (error) {
+        const errno = valueFreeFailure(CaughtFailureSchema.parse(error)).code;
+        if (errno === 'ENOENT' || errno === 'ENOTDIR')
+            throw sqliteDriverFailure(DATABASE_MISSING);
+        throw sqliteDriverFailure({
+            message: 'The SQLite database could not be opened.',
+            code: 'UNAVAILABLE',
+            reason: SQLITE_DRIVER_REFUSALS.openFailed,
+            retryable: false,
+            details: errno === undefined ? undefined : { errno }
+        });
+    }
+}
+/** `UNAVAILABLE sqlite-connection-closed`. */
+export const CONNECTION_CLOSED = {
+    message: 'The SQLite connection is closed.',
+    code: 'UNAVAILABLE',
+    reason: SQLITE_DRIVER_REFUSALS.connectionClosed,
+    retryable: false
+};
+/** `INTERNAL sqlite-close-failed`. */
+export const CLOSE_FAILED = {
+    message: 'The SQLite connection could not be closed.',
+    code: 'INTERNAL',
+    reason: SQLITE_DRIVER_REFUSALS.closeFailed,
+    retryable: true
+};
+const TRANSACTION_ASYNC = {
+    message: 'A SQLite transaction body must be synchronous.',
+    code: 'INVALID_INPUT',
+    reason: SQLITE_DRIVER_REFUSALS.transactionAsync,
+    retryable: false
+};
+const TRANSACTION_ROLLBACK_FAILED = {
+    message: 'The SQLite transaction failed and could not be rolled back.',
+    code: 'INTERNAL',
+    reason: SQLITE_DRIVER_REFUSALS.statementFailed,
+    retryable: false,
+    details: { bodyFailed: 1, rollbackFailed: 1 }
+};
+/** A row the host returned, as a plain object (Node returns null-prototype rows). */
+export function plainRow(row) {
+    return { ...row };
+}
+/** A body's result that stands for work still running: a Promise (what an async body returns). */
+const PendingWorkSchema = z.instanceof(Promise);
+/** Undo the work of a failed body: to the savepoint when nested, else the whole transaction when SQLite still holds it open. */
+function rollBack(target, nested, savepoint) {
+    if (nested) {
+        target.exec(`ROLLBACK TO ${savepoint}`);
+        target.exec(`RELEASE ${savepoint}`);
+    }
+    else if (target.inTransaction) {
+        target.exec('ROLLBACK');
+    }
+}
+function tryRollBack(target, nested, savepoint) {
+    try {
+        rollBack(target, nested, savepoint);
+        return { ok: true };
+    }
+    catch (error) {
+        return { ok: false, failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/**
+ * The one transaction runner every host uses: BEGIN (IMMEDIATE when asked), run, COMMIT; ROLLBACK and
+ * rethrow when `run` throws or SQLite refuses the COMMIT. Inside an open
+ * transaction it uses a savepoint (`SAVEPOINT`, `RELEASE`; `ROLLBACK TO` then
+ * `RELEASE` on a throw). `run` is synchronous: a Promise result is rolled
+ * back and refused `INVALID_INPUT sqlite-transaction-async`, because the work
+ * it stands for would run after the commit. A rollback that itself fails is
+ * reported as one fixed, cause-free refusal; neither host failure escapes.
+ */
+export function runSqliteTransaction(target, savepoint, run, options = {}) {
+    const nested = target.inTransaction;
+    target.exec(nested ? `SAVEPOINT ${savepoint}` : options.immediate === true ? 'BEGIN IMMEDIATE' : 'BEGIN');
+    try {
+        const value = run();
+        if (PendingWorkSchema.safeParse(value).success)
+            throw sqliteDriverFailure(TRANSACTION_ASYNC);
+        // A COMMIT SQLite refuses (busy) leaves the transaction open: it is rolled back below like a failed body.
+        target.exec(nested ? `RELEASE ${savepoint}` : 'COMMIT');
+        return value;
+    }
+    catch (error) {
+        const rolledBack = tryRollBack(target, nested, savepoint);
+        if (!rolledBack.ok) {
+            throw sqliteDriverFailure({
+                ...TRANSACTION_ROLLBACK_FAILED,
+                details: {
+                    ...TRANSACTION_ROLLBACK_FAILED.details,
+                    ...sqliteFailureFacts('bodyFailure', valueFreeFailure(CaughtFailureSchema.parse(error))),
+                    ...sqliteFailureFacts('rollbackFailure', rolledBack.failure)
+                }
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=sqlite-driver.base.js.map

package/dist/driver/sqlite-driver.base.js.map

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

package/dist/driver/sqlite-driver.d.ts

@@ -0,0 +1,154 @@
+/**
+ * The SQLite driver kind (`localdb/sqlite-driver`): LocalDB's contract with the
+ * host that opens SQLite files (#011 ruling 2026-10-03).
+ *
+ * LocalDB owns this contract and the policy above it (pragmas, WAL
+ * maintenance, startup retry, migrations); each host package implements it
+ * with its own SQLite binding (`bun:sqlite` in runtime-environment-bun,
+ * `node:sqlite` in runtime-environment-node) and registers the implementation
+ * on the runtimes it builds. LocalDB resolves it from the runtime each call is
+ * handed and never reads a host error shape: hosts classify every failure into
+ * the typed refusals below.
+ *
+ * Calls are synchronous, as SQLite's are. See SPEC "SQLite driver kind".
+ */
+import * as z from 'zod/v4';
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** The kind id hosts register their driver under. */
+export declare const LOCALDB_SQLITE_DRIVER_KIND = "localdb/sqlite-driver";
+/** Every refusal a driver raises, by reason. Host errors are classified into bounded details and never attached as `cause`. */
+export declare const SQLITE_DRIVER_REFUSALS: {
+    /** `INVALID_INPUT`: the open request is not an absolute path (or `:memory:`) with well-formed own options. */
+    readonly openInvalid: "sqlite-open-invalid";
+    /** `NOT_FOUND`: `create: false` and no file at the path. */
+    readonly databaseMissing: "sqlite-database-missing";
+    /** `UNAVAILABLE`: the host could not open the file. */
+    readonly openFailed: "sqlite-open-failed";
+    /** `CONFLICT`, retryable: `SQLITE_BUSY` or `SQLITE_LOCKED`. */
+    readonly busy: "sqlite-busy";
+    /** `INTERNAL`: any other SQLite failure of a statement. */
+    readonly statementFailed: "sqlite-statement-failed";
+    /** `INVALID_INPUT`: SQL text that is not a string. */
+    readonly sqlInvalid: "sqlite-sql-invalid";
+    /** `INVALID_INPUT`: a bound parameter is not a {@link SqliteBinding}. */
+    readonly bindingInvalid: "sqlite-binding-invalid";
+    /** `INVALID_INPUT`: a transaction body returned a Promise; it was rolled back. */
+    readonly transactionAsync: "sqlite-transaction-async";
+    /** `UNAVAILABLE`: a call on a connection after `close()`. */
+    readonly connectionClosed: "sqlite-connection-closed";
+    /** `INTERNAL`: the host refused to close the connection. */
+    readonly closeFailed: "sqlite-close-failed";
+};
+export type SqliteDriverRefusal = (typeof SQLITE_DRIVER_REFUSALS)[keyof typeof SQLITE_DRIVER_REFUSALS];
+/**
+ * What a failed statement hit, as a fixed word the host reads from SQLite's
+ * result code and text: owners branch on it (a missing table is an empty
+ * store, a unique collision a lost race) without SQLite's text — which quotes
+ * the statement's literals and names — ever reaching a message. Carried as
+ * `details.condition` on `sqlite-statement-failed`.
+ */
+export declare const SQLITE_FAILURE_CONDITIONS: readonly ["unique-constraint", "missing-table", "missing-column", "already-exists", "syntax-error"];
+export type SqliteFailureCondition = (typeof SQLITE_FAILURE_CONDITIONS)[number];
+/**
+ * The condition a driver's `sqlite-statement-failed` refusal carries, found on
+ * `failure` or along its `cause` chain (an owner may wrap it), or `undefined`.
+ * It reads only the typed refusal, never a host error's text.
+ */
+export declare function sqliteFailureCondition(failure: CaughtFailure): SqliteFailureCondition | undefined;
+/** One value SQLite stores and returns in a row cell. */
+export type SqliteValue = string | number | bigint | null | Uint8Array;
+/** One positional parameter: a {@link SqliteValue}, or a boolean, which binds as 1 or 0 (as SQLite stores it). */
+export type SqliteBinding = SqliteValue | boolean;
+/** One result row: a plain object of column name to cell. */
+export type SqliteRow = Readonly<Record<string, SqliteValue>>;
+/** What a statement that writes reports. */
+export interface SqliteRunResult {
+    readonly changes: number;
+    readonly lastInsertRowid: number | bigint;
+}
+/**
+ * A prepared statement. Parameters are positional. `TRow` is the row type the
+ * caller's SQL selects (a typed query, as `bun:sqlite`'s statements are typed);
+ * it defaults to {@link SqliteRow}.
+ */
+export interface SqliteStatement<TRow extends object = SqliteRow> {
+    all(...params: SqliteBinding[]): TRow[];
+    /** The first row, or `null` (never `undefined`) when there is none. */
+    get(...params: SqliteBinding[]): TRow | null;
+    run(...params: SqliteBinding[]): SqliteRunResult;
+}
+/** How a transaction begins. */
+export interface SqliteTransactionOptions {
+    /** `BEGIN IMMEDIATE`: take the write lock at the start (default: deferred `BEGIN`). Ignored when nested. */
+    readonly immediate?: boolean;
+}
+/** One open SQLite connection. */
+export interface SqliteConnection {
+    /** The path it was opened with. */
+    readonly path: string;
+    /** Whether the connection is inside a transaction. */
+    readonly inTransaction: boolean;
+    /** Run one or more statements that return no rows. */
+    exec(sql: string): void;
+    prepare<TRow extends object = SqliteRow>(sql: string): SqliteStatement<TRow>;
+    /**
+     * Run `run` inside BEGIN/COMMIT (ROLLBACK on a throw or a refused COMMIT; a
+     * nested call uses a savepoint) and return its value. `run` is synchronous:
+     * a Promise result is rolled back and refused `sqlite-transaction-async`.
+     */
+    transaction<T>(run: () => T, options?: SqliteTransactionOptions): T;
+    /** Close the connection; closing a closed connection does nothing. */
+    close(): void;
+}
+/** How a file is opened. */
+export interface SqliteOpenOptions {
+    /** Create a missing file (default `true`); `false` refuses `sqlite-database-missing`. */
+    readonly create?: boolean;
+    /** Open read-only (default `false`). */
+    readonly readonly?: boolean;
+}
+/** The driver a host registers. */
+export interface SqliteDriver {
+    /** The host label (`bun`, `node`). */
+    readonly host: string;
+    /** Open `path` (an absolute file path, or `:memory:`). */
+    open(path: string, options?: SqliteOpenOptions): SqliteConnection;
+}
+/** A driver descriptor: which host implements it. */
+export declare const SqliteDriverDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"localdb/sqlite-driver">;
+    host: z.ZodString;
+}, z.core.$strip>;
+export type SqliteDriverDescriptor = z.infer<typeof SqliteDriverDescriptorSchema>;
+/**
+ * Whether an implementation a loader produced honors the driver contract's
+ * shape: a non-empty host label and an `open` function. A getter or Proxy
+ * trap that throws while it is read propagates to the resolving call, which
+ * rejects; it is never answered as a driver.
+ */
+export declare function isSqliteDriver(implementation: SqliteDriver): boolean;
+/** The kind LocalDB registers; a loader whose implementation is not a driver is refused `implementation-invalid`. */
+export declare const sqliteDriverKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<SqliteDriver>;
+/** Whether `error` is a driver's `sqlite-busy` refusal: the only startup failure LocalDB retries. */
+export declare function isSqliteBusy(failure: CaughtFailure): boolean;
+//# sourceMappingURL=sqlite-driver.d.ts.map

package/dist/driver/sqlite-driver.d.ts.map

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