@vibesdotdev/localdb 0.0.2 → 1.0.0-rc.2

package/dist/driver/sqlite-driver.js

@@ -0,0 +1,103 @@
+/**
+ * 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 { CapabilityError, createRuntimeKind, isCapabilityError, RuntimeDescriptorSchema } from '@vibesdotdev/kernel';
+/** The kind id hosts register their driver under. */
+export 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 const SQLITE_DRIVER_REFUSALS = {
+    /** `INVALID_INPUT`: the open request is not an absolute path (or `:memory:`) with well-formed own options. */
+    openInvalid: 'sqlite-open-invalid',
+    /** `NOT_FOUND`: `create: false` and no file at the path. */
+    databaseMissing: 'sqlite-database-missing',
+    /** `UNAVAILABLE`: the host could not open the file. */
+    openFailed: 'sqlite-open-failed',
+    /** `CONFLICT`, retryable: `SQLITE_BUSY` or `SQLITE_LOCKED`. */
+    busy: 'sqlite-busy',
+    /** `INTERNAL`: any other SQLite failure of a statement. */
+    statementFailed: 'sqlite-statement-failed',
+    /** `INVALID_INPUT`: SQL text that is not a string. */
+    sqlInvalid: 'sqlite-sql-invalid',
+    /** `INVALID_INPUT`: a bound parameter is not a {@link SqliteBinding}. */
+    bindingInvalid: 'sqlite-binding-invalid',
+    /** `INVALID_INPUT`: a transaction body returned a Promise; it was rolled back. */
+    transactionAsync: 'sqlite-transaction-async',
+    /** `UNAVAILABLE`: a call on a connection after `close()`. */
+    connectionClosed: 'sqlite-connection-closed',
+    /** `INTERNAL`: the host refused to close the connection. */
+    closeFailed: 'sqlite-close-failed'
+};
+/**
+ * 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 const SQLITE_FAILURE_CONDITIONS = [
+    'unique-constraint',
+    'missing-table',
+    'missing-column',
+    'already-exists',
+    'syntax-error'
+];
+const SqliteFailureDetailsSchema = z.object({ condition: z.enum(SQLITE_FAILURE_CONDITIONS) });
+/** How many `cause` links {@link sqliteFailureCondition} follows to find the driver's refusal. */
+const CAUSE_DEPTH_LIMIT = 8;
+/**
+ * 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 function sqliteFailureCondition(failure) {
+    let current = failure;
+    for (let depth = 0; depth < CAUSE_DEPTH_LIMIT && current instanceof Error; depth++) {
+        if (current instanceof CapabilityError && current.reason === SQLITE_DRIVER_REFUSALS.statementFailed) {
+            return SqliteFailureDetailsSchema.safeParse(current.details).data?.condition;
+        }
+        current = current.cause;
+    }
+    return undefined;
+}
+/** A driver descriptor: which host implements it. */
+export const SqliteDriverDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal(LOCALDB_SQLITE_DRIVER_KIND),
+    host: z.string().regex(/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/, 'a host label is a kebab-case id')
+});
+/** The contract's shape: a host label and an `open` function. */
+const SqliteDriverMembersSchema = z.object({
+    host: z.string().min(1),
+    open: z.custom((open) => open instanceof Function)
+});
+/**
+ * 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 function isSqliteDriver(implementation) {
+    return SqliteDriverMembersSchema.safeParse(implementation).success;
+}
+/** The kind LocalDB registers; a loader whose implementation is not a driver is refused `implementation-invalid`. */
+export const sqliteDriverKind = createRuntimeKind({
+    id: LOCALDB_SQLITE_DRIVER_KIND,
+    descriptorSchema: SqliteDriverDescriptorSchema,
+    validateImplementation: isSqliteDriver
+});
+/** Whether `error` is a driver's `sqlite-busy` refusal: the only startup failure LocalDB retries. */
+export function isSqliteBusy(failure) {
+    return isCapabilityError(failure) && failure.reason === SQLITE_DRIVER_REFUSALS.busy;
+}
+//# sourceMappingURL=sqlite-driver.js.map

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

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

package/dist/index.d.ts

@@ -4,9 +4,15 @@
  * Unified SQLite database management for vibes dev toolkit.
  * Provides connection pooling, migration management, and consistent configuration.
  */
-export type { LocaldbApi, LocaldbRawDatabase, LocalDatabase as LocalDatabaseInterface, Migration, MigrationFunction, ConnectionStats, ConnectionPoolApi, MigrationRegistryApi } from './schemas/api';
-export { LocalDatabase, localdb } from './core/database';
-export { connectionPool } from './core/connection-pool';
-export { migrationRegistry } from './core/migration-registry';
-export { loadMigrationSQL, loadMigrationSQLSync, listMigrationFiles, parseVersionFromFilename, parseMigrationName } from './migrations/load-sql';
+export type { LocaldbApi, LocaldbRawDatabase, LocalDatabase as LocalDatabaseInterface, Migration, MigrationDescriptor, MigrationFunction, NamespaceDatabaseLocation, ConnectionStats, ConnectionPoolApi, MigrationRegistryApi } from './schemas/api.ts';
+export type { SqliteBinding, SqliteConnection, SqliteRow, SqliteRunResult, SqliteStatement, SqliteTransactionOptions, SqliteValue } from './driver/sqlite-driver.ts';
+export { LocalDatabase, localdb, disposeLocalDatabaseConnections } from './core/database.ts';
+export { fileSystemOf, sqliteDriverOf } from './core/host-kinds.ts';
+export { LOCALDB_POOL_KIND, poolKind } from './core/connection-pool.ts';
+export type { WalCheckpointTrigger } from './core/connection-pool.ts';
+export { WAL_JOURNAL_SIZE_LIMIT_BYTES, WAL_MAINTENANCE_INTERVAL_MS, MAX_TRANSACTION_AGE_MS, checkpointWal, localDatabasePragmaStatements, type WalCheckpointOutcome, type WalCheckpointStatus } from './core/wal-policy.ts';
+export { migrationRegistry, migrationKind, MIGRATION_KIND, isMigrationNamespaceRegistered, MIGRATION_NAMESPACE_REGISTERED } from './core/migration-registry.ts';
+export { loadMigrationSQL, listMigrationFiles, parseVersionFromFilename, parseMigrationName } from './migrations/load-sql.ts';
+export { connectionPool } from './core/pool-api.ts';
+export { PoolDescriptorSchema, type PoolDescriptor } from './schemas/pool.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACX,UAAU,EACV,kBAAkB,EAClB,aAAa,IAAI,sBAAsB,EACvC,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACX,UAAU,EACV,kBAAkB,EAClB,aAAa,IAAI,sBAAsB,EACvC,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,WAAW,EACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,aAAa,EACb,OAAO,EACP,+BAA+B,EAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACN,iBAAiB,EACjB,QAAQ,EACR,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EACN,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,8BAA8B,EAC9B,8BAA8B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -4,8 +4,12 @@
  * Unified SQLite database management for vibes dev toolkit.
  * Provides connection pooling, migration management, and consistent configuration.
  */
-export { LocalDatabase, localdb } from './core/database.js';
-export { connectionPool } from './core/connection-pool.js';
-export { migrationRegistry } from './core/migration-registry.js';
-export { loadMigrationSQL, loadMigrationSQLSync, listMigrationFiles, parseVersionFromFilename, parseMigrationName } from './migrations/load-sql.js';
+export { LocalDatabase, localdb, disposeLocalDatabaseConnections } from "./core/database.js";
+export { fileSystemOf, sqliteDriverOf } from "./core/host-kinds.js";
+export { LOCALDB_POOL_KIND, poolKind } from "./core/connection-pool.js";
+export { WAL_JOURNAL_SIZE_LIMIT_BYTES, WAL_MAINTENANCE_INTERVAL_MS, MAX_TRANSACTION_AGE_MS, checkpointWal, localDatabasePragmaStatements } from "./core/wal-policy.js";
+export { migrationRegistry, migrationKind, MIGRATION_KIND, isMigrationNamespaceRegistered, MIGRATION_NAMESPACE_REGISTERED } from "./core/migration-registry.js";
+export { loadMigrationSQL, listMigrationFiles, parseVersionFromFilename, parseMigrationName } from "./migrations/load-sql.js";
+export { connectionPool } from "./core/pool-api.js";
+export { PoolDescriptorSchema } from "./schemas/pool.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH,OAAO,EACN,aAAa,EACb,OAAO,EACP,+BAA+B,EAC/B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EACN,iBAAiB,EACjB,QAAQ,EACR,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACN,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,aAAa,EACb,6BAA6B,EAG7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,8BAA8B,EAC9B,8BAA8B,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mBAAmB,CAAC"}

package/dist/localdb.client.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * LocalDB Runtime Client Descriptor
+ *
+ * The runtime-owned logical owner of LocalDB access. Pure data: the
+ * implementation loads lazily through `src/localdb.client.impl.consumer.ts`.
+ */
+import type { RuntimeClientDescriptor } from '@vibesdotdev/kernel/client';
+declare const descriptor: RuntimeClientDescriptor;
+export default descriptor;
+//# sourceMappingURL=localdb.client.descriptor.d.ts.map

package/dist/localdb.client.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localdb.client.descriptor.d.ts","sourceRoot":"","sources":["../src/localdb.client.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E,QAAA,MAAM,UAAU,EAAE,uBAIjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/localdb.client.descriptor.js

@@ -0,0 +1,13 @@
+/**
+ * LocalDB Runtime Client Descriptor
+ *
+ * The runtime-owned logical owner of LocalDB access. Pure data: the
+ * implementation loads lazily through `src/localdb.client.impl.consumer.ts`.
+ */
+const descriptor = {
+    kind: 'runtime/client',
+    id: 'localdb',
+    description: 'Runtime-owned logical LocalDB access — migrations, connections, status'
+};
+export default descriptor;
+//# sourceMappingURL=localdb.client.descriptor.js.map

package/dist/localdb.client.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localdb.client.descriptor.js","sourceRoot":"","sources":["../src/localdb.client.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA4B;IAC3C,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,SAAS;IACb,WAAW,EAAE,wEAAwE;CACrF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/localdb.client.impl.consumer.d.ts

@@ -0,0 +1,11 @@
+/**
+ * LocalDB Runtime Client Implementation (Consumer)
+ *
+ * The kernel instantiates this per runtime through the `runtime/client`
+ * `localdb` descriptor; callers resolve it with `getVibesClient` (async) or
+ * `tryGetVibesClient` (synchronously, once activation warmed the cache), or
+ * through the `dev/localdb` context which resolves to this same instance.
+ */
+import { LocalDBManager } from './core/database.ts';
+export default LocalDBManager;
+//# sourceMappingURL=localdb.client.impl.consumer.d.ts.map

package/dist/localdb.client.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localdb.client.impl.consumer.d.ts","sourceRoot":"","sources":["../src/localdb.client.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,eAAe,cAAc,CAAC"}

package/dist/localdb.client.impl.consumer.js

@@ -0,0 +1,11 @@
+/**
+ * LocalDB Runtime Client Implementation (Consumer)
+ *
+ * The kernel instantiates this per runtime through the `runtime/client`
+ * `localdb` descriptor; callers resolve it with `getVibesClient` (async) or
+ * `tryGetVibesClient` (synchronously, once activation warmed the cache), or
+ * through the `dev/localdb` context which resolves to this same instance.
+ */
+import { LocalDBManager } from "./core/database.js";
+export default LocalDBManager;
+//# sourceMappingURL=localdb.client.impl.consumer.js.map

package/dist/localdb.client.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localdb.client.impl.consumer.js","sourceRoot":"","sources":["../src/localdb.client.impl.consumer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,eAAe,cAAc,CAAC"}

package/dist/localdb.plugin.d.ts

@@ -3,6 +3,6 @@
  *
  * Local SQLite database management — migrations, connections, status.
  */
-declare const _default: import("@vibesdotdev/runtime").RuntimePlugin;
-export default _default;
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
 //# sourceMappingURL=localdb.plugin.d.ts.map

package/dist/localdb.plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localdb.plugin.d.ts","sourceRoot":"","sources":["../src/localdb.plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;AAeH,wBAuBG"}
+{"version":3,"file":"localdb.plugin.d.ts","sourceRoot":"","sources":["../src/localdb.plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,QAAA,MAAM,aAAa,6CA2DjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/localdb.plugin.js

@@ -3,7 +3,9 @@
  *
  * Local SQLite database management — migrations, connections, status.
  */
-import { createRuntimePlugin, loader } from '@vibesdotdev/runtime';
+import { migrationKind, MIGRATION_KIND } from "./core/migration-registry.js";
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
 // CLI
 import localdbGroup from "./dev.localdb.cli-group.descriptor.js";
 import localdbMigrate from "./cli/commands/migrate/dev.localdb.migrate.cli-command.descriptor.js";
@@ -13,10 +15,21 @@ import localdbQuery from "./cli/commands/query/dev.localdb.query.cli-command.des
 import localdbStatus from "./cli/commands/status/dev.localdb.status.cli-command.descriptor.js";
 // Context
 import localdbContextDescriptor from "./dev.localdb.context.descriptor.js";
-export default createRuntimePlugin({
+// Runtime-owned logical owner (resolved through the kernel, warmed on activation)
+import localdbClientDescriptor from "./localdb.client.descriptor.js";
+import { clearDirectPluginDisposal, markDirectPluginDisposal } from "./core/database.js";
+// The SQLite driver kind the hosts implement (SPEC "SQLite driver kind")
+import { LOCALDB_SQLITE_DRIVER_KIND, sqliteDriverKind } from "./driver/sqlite-driver.js";
+// The physical pool kind (SPEC "Connection pool"): the plugin registers the
+// kind and a runtime-owned default pool, so single-runtime processes share one
+// connection per path with no further composition.
+import { ensureDefaultPool } from "./core/connection-pool.js";
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
     id: 'localdb',
     name: 'LocalDB',
     description: 'Local SQLite database management — migrations, connections, status',
+    optionalDependencies: ['logging'],
     descriptors: [
         localdbGroup,
         localdbMigrate,
@@ -24,15 +37,50 @@ export default createRuntimePlugin({
         localdbPools,
         localdbQuery,
         localdbStatus,
-        localdbContextDescriptor
+        localdbContextDescriptor,
+        localdbClientDescriptor
     ],
     loaders: [
-        loader('dev.localdb.migrate', 'consumer', () => import('./cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.js')),
-        loader('dev.localdb.namespaces', () => import('./cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.js')),
-        loader('dev.localdb.pools', () => import('./cli/commands/pools/dev.localdb.pools.cli-command.impl.js')),
-        loader('dev.localdb.query', 'consumer', () => import('./cli/commands/query/dev.localdb.query.cli-command.impl.consumer.js')),
-        loader('dev.localdb.status', 'consumer', () => import('./cli/commands/status/dev.localdb.status.cli-command.impl.consumer.js')),
-        loader('dev/localdb', 'consumer', () => import('./dev.localdb.context.impl.consumer.js'))
-    ]
+        loader('dev.localdb.migrate', 'consumer', () => import("./cli/commands/migrate/dev.localdb.migrate.cli-command.impl.consumer.js")),
+        loader('dev.localdb.namespaces', () => import("./cli/commands/namespaces/dev.localdb.namespaces.cli-command.impl.js")),
+        loader('dev.localdb.pools', () => import("./cli/commands/pools/dev.localdb.pools.cli-command.impl.js")),
+        loader('dev.localdb.query', 'consumer', () => import("./cli/commands/query/dev.localdb.query.cli-command.impl.consumer.js")),
+        loader('dev.localdb.status', 'consumer', () => import("./cli/commands/status/dev.localdb.status.cli-command.impl.consumer.js")),
+        loader('dev/localdb', 'consumer', () => import("./dev.localdb.context.impl.consumer.js")),
+        loader('localdb', 'consumer', () => import("./localdb.client.impl.consumer.js"))
+    ],
+    // The host environment registers the driver kind with its driver; a runtime
+    // composed without one still gets the kind, and resolving it then refuses typed.
+    onRegister(runtime) {
+        if (!runtime.hasKind(MIGRATION_KIND))
+            runtime.registerKind(migrationKind);
+        if (!runtime.hasKind(LOCALDB_SQLITE_DRIVER_KIND))
+            runtime.registerKind(sqliteDriverKind);
+        ensureDefaultPool(runtime);
+        markDirectPluginDisposal(runtime);
+    },
+    // Warm the runtime-owned client and its physical pool, so synchronous
+    // callers can use `tryGetVibesClient('localdb', runtime)` and pool
+    // statistics right after activation.
+    onActivate: async (runtime) => {
+        const client = await getVibesClient('localdb', runtime);
+        await client.ensurePool();
+    },
+    // Each connection's WAL maintenance tick (D-WAL) runs on the lifecycle of a
+    // persistent runtime that holds it and ends with that runtime; finite hosts
+    // checkpoint on release and close instead. Disposal gives back what the
+    // disposing runtime holds, reported on it. A reload retiring this plugin from a
+    // runtime that lives on disposes it on a live lifecycle (and never again): the
+    // release then runs as that lifecycle's own work at the runtime's disposal.
+    async onDispose(runtime) {
+        clearDirectPluginDisposal(runtime);
+        const { releaseAtDisposal, localdb } = await import("./core/database.js");
+        if (runtime.lifecycle.phase === 'live') {
+            releaseAtDisposal(runtime, localdb);
+            return;
+        }
+        await localdb.closeAll(runtime);
+    }
 });
+export default defaultExport;
 //# sourceMappingURL=localdb.plugin.js.map

package/dist/localdb.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"localdb.plugin.js","sourceRoot":"","sources":["../src/localdb.plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnE,MAAM;AACN,OAAO,YAAY,MAAM,uCAAuC,CAAC;AACjE,OAAO,cAAc,MAAM,sEAAsE,CAAC;AAClG,OAAO,iBAAiB,MAAM,4EAA4E,CAAC;AAC3G,OAAO,YAAY,MAAM,kEAAkE,CAAC;AAC5F,OAAO,YAAY,MAAM,kEAAkE,CAAC;AAC5F,OAAO,aAAa,MAAM,oEAAoE,CAAC;AAE/F,UAAU;AACV,OAAO,wBAAwB,MAAM,qCAAqC,CAAC;AAE3E,eAAe,mBAAmB,CAAC;IAClC,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,oEAAoE;IAEjF,WAAW,EAAE;QACZ,YAAY;QACZ,cAAc;QACd,iBAAiB;QACjB,YAAY;QACZ,YAAY;QACZ,aAAa;QACb,wBAAwB;KACxB;IAED,OAAO,EAAE;QACR,MAAM,CAAC,qBAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,yEAAyE,CAAC,CAAC;QAClI,MAAM,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sEAAsE,CAAC,CAAC;QACtH,MAAM,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4DAA4D,CAAC,CAAC;QACvG,MAAM,CAAC,mBAAmB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,qEAAqE,CAAC,CAAC;QAC5H,MAAM,CAAC,oBAAoB,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,uEAAuE,CAAC,CAAC;QAC/H,MAAM,CAAC,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wCAAwC,CAAC,CAAC;KACzF;CACD,CAAC,CAAC"}
+{"version":3,"file":"localdb.plugin.js","sourceRoot":"","sources":["../src/localdb.plugin.ts"],"names":[],"mappings":"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"}

package/dist/location.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import { type NamespaceDatabaseLocation } from './core/migration-registry.ts';
+export type { NamespaceDatabaseLocation };
+/** Resolve a namespace's owner-declared database location without guessing. */
+export declare function resolveDatabaseLocationForNamespace(runtime: RuntimeRef, namespace: string): NamespaceDatabaseLocation | undefined;
+//# sourceMappingURL=location.d.ts.map

package/dist/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAqB,KAAK,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAEjG,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAE1C,+EAA+E;AAC/E,wBAAgB,mCAAmC,CAClD,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,MAAM,GACf,yBAAyB,GAAG,SAAS,CAEvC"}

package/dist/location.js

@@ -0,0 +1,6 @@
+import { migrationRegistry } from "./core/migration-registry.js";
+/** Resolve a namespace's owner-declared database location without guessing. */
+export function resolveDatabaseLocationForNamespace(runtime, namespace) {
+    return migrationRegistry.getNamespaceLocation(runtime, namespace);
+}
+//# sourceMappingURL=location.js.map

package/dist/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../src/location.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAkC,MAAM,8BAA8B,CAAC;AAIjG,+EAA+E;AAC/E,MAAM,UAAU,mCAAmC,CAClD,OAAmB,EACnB,SAAiB;IAEjB,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AACnE,CAAC"}

package/dist/migrations/load-sql.d.ts

@@ -1,45 +1,49 @@
 /**
  * SQL Migration Loader
  *
- * Utility for loading SQL migration files from the filesystem.
- * Uses Bun's file API for fast synchronous reads.
+ * Reads an owner's migration SQL files from the absolute directory the owner
+ * passes (PM and Workspace pass their own `migrations/<namespace>` directory),
+ * through the runtime's filesystem (`filesystem/adapter`). LocalDB ships no SQL
+ * of its own, so there is no package-relative lookup.
  */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
 /**
- * Load a SQL migration file by namespace and filename (async)
+ * Load a SQL migration file from an owner's migration directory, through the
+ * runtime's filesystem.
  *
- * @param namespace - The migration namespace (atlas, session, external)
+ * @param runtime - The runtime the owner was handed
+ * @param directory - The owner's absolute migration directory
  * @param filename - The SQL filename (e.g., '001-initial-schema.sql')
- * @returns Promise resolving to the SQL content as a string
+ * @returns The SQL content; every failure rejects (`INVALID_INPUT
+ *   migration-directory-relative`, `NOT_FOUND migration-file-missing`, or the
+ *   filesystem's own refusal)
  */
-export declare function loadMigrationSQL(namespace: string, filename: string): Promise<string>;
+export declare function loadMigrationSQL(runtime: RuntimeRef, directory: string, filename: string): Promise<string>;
 /**
- * Synchronously load a SQL migration file
- * Uses Node's fs.readFileSync for truly synchronous reads
+ * List the SQL files in an owner's migration directory, sorted by version,
+ * through the runtime's filesystem. A directory that does not exist lists
+ * nothing.
  *
- * @param namespace - The migration namespace (atlas, session, external)
- * @param filename - The SQL filename (e.g., '001-initial-schema.sql')
- * @returns The SQL content as a string
- */
-export declare function loadMigrationSQLSync(namespace: string, filename: string): string;
-/**
- * List all SQL files in a namespace directory
- *
- * @param namespace - The migration namespace (atlas, session, external)
- * @returns Array of SQL filenames sorted by version number
+ * @param runtime - The runtime the owner was handed
+ * @param directory - The owner's absolute migration directory
+ * @returns SQL filenames sorted by their numeric version prefix
  */
-export declare function listMigrationFiles(namespace: string): string[];
+export declare function listMigrationFiles(runtime: RuntimeRef, directory: string): Promise<string[]>;
 /**
  * Parse version number from a migration filename
  *
  * @param filename - The SQL filename (e.g., '001-initial-schema.sql')
- * @returns The version number
+ * @returns The version number; a filename without a leading `<digits>-`, or
+ *   whose version is not a safe integer, refuses `INVALID_INPUT
+ *   migration-filename-invalid`
  */
 export declare function parseVersionFromFilename(filename: string): number;
 /**
  * Parse migration name from a filename
  *
  * @param filename - The SQL filename (e.g., '001-initial-schema.sql')
- * @returns The migration name (e.g., 'initial_schema')
+ * @returns The migration name (e.g., 'initial_schema'); a filename that is not
+ *   a string refuses `INVALID_INPUT migration-filename-invalid`
  */
 export declare function parseMigrationName(filename: string): string;
 //# sourceMappingURL=load-sql.d.ts.map

package/dist/migrations/load-sql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-sql.d.ts","sourceRoot":"","sources":["../../src/migrations/load-sql.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAarF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAahF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB9D;AAkBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3D"}
+{"version":3,"file":"load-sql.d.ts","sourceRoot":"","sources":["../../src/migrations/load-sql.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAkBvE;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUhH;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWlG;AAuCD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3D"}