@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/adapters/drizzle/persistence-factory.d.ts

@@ -0,0 +1,100 @@
+export { DrizzleMigrationJournalSchema, type DrizzleMigrationJournal } from '../../schemas/drizzle/persistence.ts';
+export { RawSqlBatchSchema, RawSqlStatementSchema, RawSqlValueSchema, type RawSqlBatch, type RawSqlRow, type RawSqlStatement, type RawSqlValue, type RawStatementArgs } from '../../schemas/drizzle/raw-sql.ts';
+export { DrizzleAuthTokenSchema, DrizzleConnectionContextSchema, DrizzleConnectionManifestSchema, type DrizzleAuthToken, type DrizzleConnectionManifest, type DrizzleConnectionSettings } from '../../schemas/drizzle/connection.ts';
+/**
+ * Drizzle Persistence Factory
+ *
+ * Shared factory for creating app database persistence:
+ * - a platform database binding, opened by a {@link DrizzlePlatformDriver} the
+ *   app composes from its platform's integration package (RC09);
+ * - libsql/file otherwise (local development, Turso).
+ *
+ * Storage owns this port and names no platform. A transient read failure is
+ * not retried here (D19): it reaches the caller, and a Workers job that needs a
+ * retry declares it in its retry policy.
+ */
+import type { RawSqlRow, RawSqlStatement } from '../../schemas/drizzle/raw-sql.ts';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { DrizzleDb, DrizzleSchemaRecord } from './contracts.ts';
+export type { WalCheckpointMode } from '../../schemas/drizzle/persistence.ts';
+export type { ObservedWalCheckpoint } from '../../schemas/drizzle/persistence.ts';
+export { observeLibsqlCheckpoint } from './persistence.client.ts';
+export interface RawSqlClient {
+    execute: (stmt: RawSqlStatement) => Promise<{
+        rows: RawSqlRow[];
+    }>;
+    batch: (stmts: RawSqlStatement[]) => Promise<Array<{
+        rows: RawSqlRow[];
+    }>>;
+}
+export type { DrizzleMigrationBundle } from '../../schemas/drizzle/persistence.ts';
+import type { DrizzleMigrationBundle } from '../../schemas/drizzle/persistence.ts';
+export type { DrizzleMigration } from '../../schemas/drizzle/persistence.ts';
+/** drizzle-kit's `meta/_journal.json`: the migrations in order, by tag and creation time. */
+export type { DrizzleMigrationBundleInput } from '../../schemas/drizzle/persistence.ts';
+import type { DrizzleMigrationBundleInput } from '../../schemas/drizzle/persistence.ts';
+/** What a platform driver opens: the drizzle database and, optionally, its raw SQL client. */
+export interface DrizzlePlatformConnection {
+    db: DrizzleDb;
+    rawClient?: RawSqlClient;
+    /** Release an owned connection; omitted for host-owned platform bindings. */
+    close?: () => void | Promise<void>;
+}
+/** Options a platform driver opens a binding with. */
+export interface DrizzlePlatformConnectOptions {
+    appName: string;
+    schema: DrizzleSchemaRecord;
+    /** Apply migrations while opening (see {@link DrizzlePersistenceConfig.migratePlatformOnInit}). */
+    migrate: boolean;
+    migrationBundle?: DrizzleMigrationBundle;
+    migrationsFolder: string;
+}
+/**
+ * The port a platform database integration implements. `bindingFrom` returns the
+ * platform's database binding, or `undefined` when this platform carries none.
+ */
+export interface DrizzlePlatformDriver<Binding = unknown> {
+    readonly id: string;
+    /** Where the driver looks for its binding, named in refusals (e.g. `platform.env.DB`). */
+    readonly binding: string;
+    /** The SQL dialect id the opened database speaks (the drizzle adapter's `dialect`). */
+    readonly dialect: string;
+    bindingFrom<Platform>(platform: Platform): Binding | undefined;
+    connect(binding: Binding, options: DrizzlePlatformConnectOptions): Promise<DrizzlePlatformConnection>;
+}
+export declare const STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID = "storage/drizzle-connection";
+export { DrizzlePersistenceConfigSchema, type DrizzlePersistenceConfig } from '../../schemas/drizzle/persistence-config.ts';
+import { type DrizzlePersistenceConfig } from '../../schemas/drizzle/persistence-config.ts';
+/**
+ * Persistence instance returned by createDrizzlePersistence.
+ *
+ * State belongs to the registered persistence client, which the root
+ * shares with every plugin-owned view of it (`RuntimeRef` handed to
+ * `onRegister`/`onActivate`), every reload generation and the generation
+ * dispatcher: any of them reads the database another initialized, and two
+ * roots never share one.
+ */
+export interface DrizzlePersistence {
+    /**
+     * Initialize the database (call from hooks.server.ts) with the host
+     * platform and handed runtime; a composed platform driver that finds its binding there opens it.
+     */
+    initPersistence<Platform>(platform: Platform, runtime: RuntimeRef): Promise<void>;
+    /** Get the drizzle database instance (sync) */
+    getDb(runtime: RuntimeRef): DrizzleDb;
+    /** Get the drizzle database instance (async) */
+    getDbAsync(runtime: RuntimeRef): Promise<DrizzleDb>;
+    /** Get persistence wrapper with db and optional raw client */
+    getPersistence(runtime: RuntimeRef): Promise<{
+        db: DrizzleDb;
+        client?: RawSqlClient;
+    }>;
+}
+/**
+ * `INVALID_INPUT persistence-config-invalid`: the declared persistence
+ * configuration is not the owned shape. Refused here, before any driver is
+ * consulted or resource opened; details name only the factory, never values.
+ */
+export declare function createDrizzlePersistence(input: DrizzlePersistenceConfig): DrizzlePersistence;
+export declare function createDrizzleMigrationBundle(input: DrizzleMigrationBundleInput): DrizzleMigrationBundle;
+//# sourceMappingURL=persistence-factory.d.ts.map

package/dist/adapters/drizzle/persistence-factory.d.ts.map

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

package/dist/adapters/drizzle/persistence-factory.js

@@ -0,0 +1,391 @@
+import { DrizzleJournalModulesSchema, DrizzleJournalSourceSchema, DrizzleMigrationBundleInputSchema, DrizzleMigrationJournalSchema } from "../../schemas/drizzle/persistence.js";
+export { DrizzleMigrationJournalSchema } from "../../schemas/drizzle/persistence.js";
+import { RawSqlBatchSchema, RawSqlStatementSchema } from "../../schemas/drizzle/raw-sql.js";
+export { RawSqlBatchSchema, RawSqlStatementSchema, RawSqlValueSchema } from "../../schemas/drizzle/raw-sql.js";
+import { DrizzleConnectionContextSchema, DrizzleConnectionManifestSchema } from "../../schemas/drizzle/connection.js";
+export { DrizzleAuthTokenSchema, DrizzleConnectionContextSchema, DrizzleConnectionManifestSchema } from "../../schemas/drizzle/connection.js";
+import { CapabilityError, readCompositionConfig, rootIdentityOf } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { getLogger } from '@vibesdotdev/logging';
+import { parseAdapterInput } from "../parse-adapter-input.js";
+import { migrateLibsqlResilient } from "./libsql-migrator.js";
+import { createLibsqlDrizzleConnection } from "./libsql.js";
+import { registerPlatformProviders } from "./providers.js";
+import { hasExecutableSql } from "./migration-statements.js";
+export { observeLibsqlCheckpoint } from "./persistence.client.js";
+import { resolvePersistenceClient, holdDatabase, stateOf, createCheckpointSchedule } from "./persistence.client.js";
+export const STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID = 'storage/drizzle-connection';
+export { DrizzlePersistenceConfigSchema } from "../../schemas/drizzle/persistence-config.js";
+import { DrizzlePersistenceConfigSchema } from "../../schemas/drizzle/persistence-config.js";
+/** `UNAVAILABLE persistence-driver-unavailable`: nothing the host declared can open the database. */
+function persistenceDriverUnavailable(appName, stage, declared, missing) {
+    const what = declared.length > 0 ? `declared ${declared.join(', ')}` : 'declared no database driver';
+    return new CapabilityError(`${appName} persistence cannot open a database: it ${what}, and ${missing.join('; ')}.`, 'UNAVAILABLE', {
+        reason: 'persistence-driver-unavailable',
+        retryable: false,
+        details: { appName, stage, declared, missing },
+        recoveryHint: 'Compose the platform driver whose binding this host carries (platformDrivers), or declare a libsql URL (defaultLocalUrl / configManifestId / url).'
+    });
+}
+/** `INVALID_INPUT persistence-connection-config-invalid`: declared connection settings are not the declared shape. */
+function connectionSettingsInvalid(appName, source) {
+    return {
+        message: 'Declared database connection settings are malformed.',
+        code: 'INVALID_INPUT',
+        reason: 'persistence-connection-config-invalid',
+        details: { appName, source }
+    };
+}
+function isText(value) {
+    return typeof value === 'string';
+}
+/**
+ * A raw client that parses every statement — and the complete batch — through
+ * the owned schemas before the inner client dispatches it. Delegation calls
+ * the inner client's own methods, so its receiver is preserved; argument
+ * values (scalars and binaries) pass through untouched, and no resource
+ * lifetime changes: this wrapper opens, holds, and closes nothing.
+ */
+function validatingRawClient(inner) {
+    const refusal = {
+        message: 'The raw SQL statement is malformed.',
+        code: 'INVALID_INPUT',
+        reason: 'drizzle-raw-statement-invalid'
+    };
+    return {
+        async execute(stmt) {
+            return inner.execute(parseAdapterInput(RawSqlStatementSchema, stmt, refusal));
+        },
+        async batch(stmts) {
+            return inner.batch(parseAdapterInput(RawSqlBatchSchema, stmts, refusal));
+        }
+    };
+}
+/** `UNAVAILABLE persistence-not-initialized`: the database is read before `initPersistence` opened it. */
+function persistenceNotInitialized(appName) {
+    return new CapabilityError('Database not initialized. Call initPersistence(platform, runtime) in hooks.server.ts first.', 'UNAVAILABLE', { reason: 'persistence-not-initialized', retryable: false, details: { appName } });
+}
+/**
+ * `INVALID_INPUT persistence-config-invalid`: the declared persistence
+ * configuration is not the owned shape. Refused here, before any driver is
+ * consulted or resource opened; details name only the factory, never values.
+ */
+export function createDrizzlePersistence(input) {
+    const config = parseAdapterInput(DrizzlePersistenceConfigSchema, input, {
+        message: 'Declared Drizzle persistence configuration is malformed.',
+        code: 'INVALID_INPUT',
+        reason: 'persistence-config-invalid',
+        details: { source: 'createDrizzlePersistence' }
+    });
+    const factory = Symbol(config.appName);
+    function validateRuntime(runtime) {
+        if (!runtime) {
+            throw new CapabilityError('createDrizzlePersistence requires a runtime instance', 'UNAVAILABLE', {
+                reason: 'runtime-unavailable',
+                retryable: false,
+                details: { appName: config.appName }
+            });
+        }
+        // The kernel's answer, never the runtime's own property: a Proxy or a
+        // double answering another root's identity names no root here.
+        const identity = rootIdentityOf(runtime);
+        if (!identity) {
+            throw new CapabilityError(`${config.appName} persistence is root-scoped; this runtime is not one the kernel constructed or viewed, so it names no root.`, 'INVALID_INPUT', {
+                reason: 'persistence-runtime-unidentified',
+                retryable: false,
+                details: { appName: config.appName },
+                recoveryHint: 'Hand the booted root, a plugin view, a reload generation or the generation dispatcher; a runtime double cannot stand in.'
+            });
+        }
+    }
+    const defaultLocalUrl = config.defaultLocalUrl?.trim() || undefined;
+    const declaresLibsql = config.url !== undefined || defaultLocalUrl !== undefined || config.configManifestId !== undefined;
+    const migrationsFolder = config.migrationsFolder ?? './drizzle';
+    const migratePlatformOnInit = config.migratePlatformOnInit ?? false;
+    const platformDrivers = config.platformDrivers ?? [];
+    // Refuse at compose when nothing is declared at all.
+    if (platformDrivers.length === 0 && !declaresLibsql && !config.configManifestId) {
+        throw persistenceDriverUnavailable(config.appName, 'compose', [], [
+            'no platform driver is composed',
+            'no libsql URL is declared (url is empty and there is no defaultLocalUrl)'
+        ]);
+    }
+    const enableRawClient = config.enableRawClient ?? false;
+    async function resolveConnectionConfig(effectiveRuntime) {
+        let url = config.url;
+        let rawAuthToken = config.authToken;
+        // 1. The runtime's declared 'storage/drizzle-connection' context.
+        if (effectiveRuntime.hasKind('context')) {
+            let declared;
+            try {
+                declared = parseAdapterInput(DrizzleConnectionContextSchema, await effectiveRuntime.context(STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID), connectionSettingsInvalid(config.appName, STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID));
+            }
+            catch (error) {
+                // Absence of the context is the only tolerated failure.
+                if (!(error instanceof Error && CapabilityError.isAbsenceOf(error, 'context', STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID)))
+                    throw error;
+                getLogger('storage:drizzle', effectiveRuntime).debug('Drizzle connection context not declared', {
+                    contextId: STORAGE_DRIZZLE_CONNECTION_CONTEXT_ID
+                });
+            }
+            if (declared?.url)
+                url = declared.url;
+            if (declared?.authToken !== undefined)
+                rawAuthToken = declared.authToken;
+        }
+        // 2. The runtime config manifest. `readCompositionConfig` returns `undefined`
+        // for a confirmed absence and throws every other failure; none is swallowed here.
+        const manifestId = config.configManifestId ?? 'storage.drizzle';
+        const manifestSettings = (await readCompositionConfig(effectiveRuntime, manifestId)) ??
+            (await readCompositionConfig(effectiveRuntime, config.appName));
+        if (manifestSettings) {
+            const settings = parseAdapterInput(DrizzleConnectionManifestSchema, manifestSettings, connectionSettingsInvalid(config.appName, manifestId));
+            const manifestUrl = settings.url ?? settings.databaseUrl;
+            if (manifestUrl !== undefined)
+                url = manifestUrl;
+            // A declared `null` token clears an inherited one.
+            if (settings.authToken !== undefined)
+                rawAuthToken = settings.authToken ?? undefined;
+        }
+        // 3. A credential reference resolves through the runtime (RC05); a string token is used as given.
+        let authToken;
+        if (rawAuthToken !== undefined && isText(rawAuthToken)) {
+            authToken = rawAuthToken || undefined;
+        }
+        else if (rawAuthToken !== undefined) {
+            const resolution = await effectiveRuntime.resolveCredential(rawAuthToken);
+            if (!resolution.ok) {
+                throw resolution.error;
+            }
+            authToken = resolution.value;
+        }
+        return {
+            url: url?.trim() || defaultLocalUrl,
+            authToken
+        };
+    }
+    /**
+     * Initialize persistence with libsql
+     */
+    async function initFromLibsql(state, url, authToken, runtime) {
+        const { client, db } = await createLibsqlDrizzleConnection({
+            url, authToken, schema: { tables: config.schema, relations: {}, extensions: [] }
+        }, runtime);
+        state.client = client;
+        state.close = () => client.close();
+        // The file-database policy is localdb's; only `file:` URLs load it (localdb is an optional peer).
+        const walPolicy = url.startsWith('file:') ? await import('@vibesdotdev/localdb/wal-policy') : undefined;
+        if (walPolicy) {
+            await client.execute('PRAGMA busy_timeout = 30000;');
+            for (const pragma of walPolicy.localDatabasePragmaStatements()) {
+                await client.execute(pragma);
+            }
+        }
+        await migrateLibsqlResilient(db, { migrationsFolder, runtime });
+        state.db = db;
+        // A file database checkpoints on a live persistent holder's lifecycle tick,
+        // moving with the root's holders; a finite host checkpoints nothing on a timer.
+        if (walPolicy && runtime.scope.lifecycle !== 'finite') {
+            state.checkpoint = createCheckpointSchedule(client, walPolicy.WAL_MAINTENANCE_INTERVAL_MS);
+        }
+    }
+    /**
+     * Initialize the database. Call once with the platform binding and handed runtime.
+     */
+    async function initPersistence(platform, runtime) {
+        if (!runtime) {
+            throw new CapabilityError(`${config.appName} persistence requires a runtime to initialize`, 'UNAVAILABLE', {
+                reason: 'runtime-unavailable',
+                retryable: false,
+                details: { appName: config.appName }
+            });
+        }
+        validateRuntime(runtime);
+        const owner = await resolvePersistenceClient(runtime);
+        await owner.initialize(factory, runtime, async (pending) => {
+            let selected;
+            try {
+                const group = owner.nextProviderGroup();
+                registerPlatformProviders(runtime, group, platformDrivers, platform);
+                const providers = runtime.query('storage/drizzle-provider')
+                    .filter(descriptor => descriptor.group === group && descriptor.available);
+                if (providers.descriptors().length)
+                    selected = await providers.resolve();
+                const connectionConfig = selected ? undefined : await resolveConnectionConfig(runtime);
+                const libsqlUrl = connectionConfig?.url;
+                if (!selected && !libsqlUrl) {
+                    const declared = [
+                        ...platformDrivers.map((driver) => driver.id),
+                        ...(declaresLibsql ? ['libsql'] : [])
+                    ];
+                    const missing = [
+                        ...platformDrivers.map((driver) => `${driver.id}: ${driver.binding} is absent on this platform`),
+                        declaresLibsql
+                            ? 'libsql: no database URL is configured or resolved from runtime config'
+                            : 'no libsql URL is declared'
+                    ];
+                    throw persistenceDriverUnavailable(config.appName, 'init', declared, missing);
+                }
+                if (selected) {
+                    const connection = await selected.connect({
+                        appName: config.appName, schema: config.schema, migrate: migratePlatformOnInit,
+                        migrationBundle: config.platformMigrationBundle, migrationsFolder
+                    });
+                    if (connection.close)
+                        pending.close = () => connection.close?.();
+                    pending.platformRawClient = connection.rawClient;
+                    pending.db = connection.db;
+                }
+                else if (libsqlUrl) {
+                    await initFromLibsql(pending, libsqlUrl, connectionConfig?.authToken, runtime);
+                }
+            }
+            catch (error) {
+                if (error instanceof CapabilityError)
+                    throw error;
+                throw new CapabilityError(`${config.appName} database initialization failed.`, 'UNAVAILABLE', {
+                    reason: 'persistence-init-failed',
+                    retryable: false,
+                    details: { appName: config.appName, driver: selected ? selected.id : 'libsql' },
+                    cause: error
+                });
+            }
+        });
+    }
+    function getDb(runtime) {
+        validateRuntime(runtime);
+        // Root identity answers for every lifecycle of the root — a plugin view,
+        // a cold reload generation, the dispatcher — without warm-up (drizzle SPEC).
+        const state = stateOf(runtime, factory);
+        if (!state.db)
+            throw persistenceNotInitialized(config.appName);
+        holdDatabase(state, runtime);
+        return state.db;
+    }
+    async function getDbAsync(runtime) {
+        validateRuntime(runtime);
+        await resolvePersistenceClient(runtime);
+        return getDb(runtime);
+    }
+    async function getPersistence(runtime) {
+        validateRuntime(runtime);
+        const state = (await resolvePersistenceClient(runtime)).state(factory);
+        if (!state?.db)
+            throw persistenceNotInitialized(config.appName);
+        holdDatabase(state, runtime);
+        if (!enableRawClient) {
+            return { db: state.db };
+        }
+        if (state.platformRawClient) {
+            return { db: state.db, client: validatingRawClient(state.platformRawClient) };
+        }
+        if (state.client) {
+            const client = state.client;
+            return {
+                db: state.db,
+                client: validatingRawClient({
+                    async execute(stmt) {
+                        const result = await client.execute({
+                            sql: stmt.sql,
+                            args: stmt.args ?? []
+                        });
+                        return { rows: result.rows };
+                    },
+                    async batch(stmts) {
+                        const results = await client.batch(stmts.map((stmt) => ({
+                            sql: stmt.sql,
+                            args: stmt.args ?? []
+                        })), 'write');
+                        return results.map((result) => ({
+                            rows: result.rows
+                        }));
+                    }
+                })
+            };
+        }
+        return { db: state.db };
+    }
+    return {
+        initPersistence,
+        getDb,
+        getDbAsync,
+        getPersistence
+    };
+}
+export function createDrizzleMigrationBundle(input) {
+    // The complete input is parsed through the owning schema before any
+    // journal normalization, Object.entries, hashing, or SQL string handling:
+    // a bundle that is not the declared shape (e.g. non-string SQL values)
+    // refuses typed instead of throwing a TypeError downstream.
+    const parsed = parseAdapterInput(DrizzleMigrationBundleInputSchema, input, {
+        message: 'The Drizzle migration bundle is malformed.',
+        code: 'INVALID_INPUT',
+        reason: 'drizzle-migration-bundle-invalid'
+    });
+    const journal = normalizeJournal(parsed.journal);
+    return {
+        migrations: journal.entries.map((entry) => {
+            const sqlText = findMigrationSql(parsed.migrations, entry.tag);
+            return {
+                tag: entry.tag,
+                when: entry.when,
+                hash: hashMigration(sqlText),
+                statements: splitMigrationStatements(sqlText)
+            };
+        })
+    };
+}
+function normalizeJournal(journal) {
+    const direct = DrizzleJournalSourceSchema.safeParse(journal);
+    const modules = direct.success ? undefined : DrizzleJournalModulesSchema.safeParse(journal);
+    const value = direct.success ? direct.data : modules?.success ? Object.values(modules.data)[0] : undefined;
+    if (value === undefined) {
+        throw new CapabilityError('Drizzle migration bundle is missing meta/_journal.json.', 'INVALID_INPUT', {
+            reason: 'drizzle-migration-journal-missing',
+            retryable: false
+        });
+    }
+    if (!isText(value))
+        return value;
+    let parsed;
+    try {
+        parsed = JsonValueSchema.parse(JSON.parse(value));
+    }
+    catch (error) {
+        throw new CapabilityError('Drizzle migration journal is not JSON.', 'INVALID_INPUT', {
+            reason: 'drizzle-migration-journal-invalid',
+            retryable: false,
+            cause: error
+        });
+    }
+    return parseAdapterInput(DrizzleMigrationJournalSchema, parsed, {
+        message: 'Drizzle migration journal does not list its migrations.',
+        code: 'INVALID_INPUT',
+        reason: 'drizzle-migration-journal-invalid'
+    });
+}
+function findMigrationSql(migrations, tag) {
+    const match = Object.entries(migrations).find(([path]) => path.endsWith(`/${tag}.sql`));
+    if (!match) {
+        throw new CapabilityError('Drizzle migration bundle is missing a journaled migration file.', 'INVALID_INPUT', {
+            reason: 'drizzle-migration-sql-missing',
+            retryable: false,
+            details: { tag }
+        });
+    }
+    return match[1];
+}
+function splitMigrationStatements(sqlText) {
+    return sqlText
+        .split('--> statement-breakpoint')
+        .map((statement) => statement.trim())
+        .filter(hasExecutableSql);
+}
+function hashMigration(sqlText) {
+    let hash = 5381;
+    for (let index = 0; index < sqlText.length; index += 1) {
+        hash = (hash * 33) ^ sqlText.charCodeAt(index);
+    }
+    return `djb2:${(hash >>> 0).toString(16)}`;
+}
+//# sourceMappingURL=persistence-factory.js.map

package/dist/adapters/drizzle/persistence-factory.js.map

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

package/dist/adapters/drizzle/persistence.client.d.ts

@@ -0,0 +1,73 @@
+/** Root-owned Drizzle connections, atomic initialization and lifecycle maintenance. */
+import type { Client } from '@libsql/client';
+import { RootHolders, type RuntimeRef } from '@vibesdotdev/kernel';
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+import type { DrizzleDb } from './contracts.ts';
+import type { RawSqlClient } from './persistence-factory.ts';
+import type { RawSqlRow } from '../../schemas/drizzle/raw-sql.ts';
+import type { WalCheckpointMode, ObservedWalCheckpoint } from '../../schemas/drizzle/persistence.ts';
+/**
+ * One `PRAGMA wal_checkpoint(<mode>)` on a libsql client, observed: the
+ * `(busy, log, checkpointed)` row is returned, never discarded. A missing row
+ * throws (the checkpoint did not run).
+ */
+export declare function observeLibsqlCheckpoint(client: {
+    execute(sql: string): Promise<{
+        rows: ReadonlyArray<RawSqlRow>;
+    }>;
+}, mode: WalCheckpointMode): Promise<ObservedWalCheckpoint>;
+export interface PersistenceState {
+    db?: DrizzleDb;
+    client?: Client;
+    /** The raw SQL client a platform driver opened with its database. */
+    platformRawClient?: RawSqlClient;
+    initPromise?: Promise<void>;
+    close?: () => void | Promise<void>;
+    /** The WAL checkpoint of a local file database (libsql `file:`), owned by a live holder of the root. */
+    checkpoint?: WalCheckpointSchedule;
+}
+/**
+ * The periodic WAL checkpoint of one root's local file database. The database
+ * lives as long as its root, so the tick runs on the lifecycle of a live,
+ * persistent runtime of that root that reached it (initialized it or read it),
+ * and moves to the next such holder when that lifecycle ends: a retired reload
+ * generation, or the generation the dispatcher served. With no live
+ * persistent holder there is no tick until one reaches the database again.
+ */
+interface WalCheckpointSchedule {
+    readonly client: Client;
+    readonly intervalMs: number;
+    readonly holders: RootHolders;
+    /** The next attempt's mode: TRUNCATE, alternating with RESTART while attempts come back busy. */
+    mode: WalCheckpointMode;
+    /** The running tick and the lifecycle signal of the runtime it runs on. */
+    tick?: {
+        readonly signal: AbortSignal;
+        readonly stop: () => void;
+    };
+}
+/**
+ * `runtime` reached the database: it holds the checkpoint, which resumes on it
+ * if no live holder runs it. A finite host starts no background work
+ * (`lifecycle.interval` refuses it), so it holds nothing.
+ */
+export declare function holdDatabase(state: PersistenceState, runtime: RuntimeRef): void;
+export declare function createCheckpointSchedule(client: Client, intervalMs: number): WalCheckpointSchedule;
+export declare class DrizzlePersistenceClient extends BaseRuntimeClient {
+    private retired;
+    private providerGroup;
+    nextProviderGroup(): string;
+    private readonly cleanupFailures;
+    private assertAvailable;
+    state(factory: symbol): PersistenceState | undefined;
+    initialize(factory: symbol, runtime: RuntimeRef, open: (pending: PersistenceState) => Promise<void>): Promise<void>;
+    protected onDispose(): Promise<void>;
+}
+/** The root's state for `factory`, created empty on first use. */
+export declare function stateOf(runtime: RuntimeRef, factory: symbol): PersistenceState;
+/** Register a lazy semantic client; the kernel retains its ownership across forks. */
+export declare const persistenceClientPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export declare function persistenceClient(runtime: RuntimeRef): DrizzlePersistenceClient | undefined;
+export declare function resolvePersistenceClient(runtime: RuntimeRef): Promise<DrizzlePersistenceClient>;
+export {};
+//# sourceMappingURL=persistence.client.d.ts.map

package/dist/adapters/drizzle/persistence.client.d.ts.map

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