@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/adapters/drizzle/schemas/record-migration.js

@@ -0,0 +1,12 @@
+/** The options and result of `recordMigration`: one numbered migration for an app's descriptor-built record tables. */
+import * as z from 'zod/v4';
+import { DrizzleMigrationJournalSchema } from "../persistence-factory.js";
+export const RecordMigrationOptionsSchema = z.object({
+    /** The migration's name: the part of the tag after the number. */
+    name: z.string().regex(/^[a-z0-9_]+$/, 'lowercase letters, digits and underscores'),
+    /** The journal entry's creation time, in epoch milliseconds. */
+    when: z.number().int().nonnegative(),
+    /** The app's `meta/_journal.json`; absent for an app with no migrations yet. */
+    journal: DrizzleMigrationJournalSchema.default({ version: '7', dialect: 'sqlite', entries: [] })
+});
+//# sourceMappingURL=record-migration.js.map

package/dist/adapters/drizzle/schemas/record-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-migration.js","sourceRoot":"","sources":["../../../../src/adapters/drizzle/schemas/record-migration.ts"],"names":[],"mappings":"AAAA,uHAAuH;AACvH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAgC,MAAM,2BAA2B,CAAC;AAExG,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,kEAAkE;IAClE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,2CAA2C,CAAC;IACnF,gEAAgE;IAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,gFAAgF;IAChF,OAAO,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;CAChG,CAAC,CAAC"}

package/dist/adapters/drizzle/storage-adapter-drizzle.plugin.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Storage Adapter Drizzle Plugin
+ *
+ * Registers the generic `storage.drizzle` and `storage.drizzle.libsql` adapters
+ * with the runtime via the canonical `createRuntimePlugin` + `runtime.registerLoader`
+ * pattern (matching the other storage adapters: memory, json, localdb, cloud-api).
+ * A platform integration registers its own adapter id over the same engine with
+ * {@link registerDrizzleStorageAdapter} (Cloudflare D1's `storage.drizzle.d1`
+ * lives in its integration, RC09).
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage';
+import { DrizzleAdapterConfigSchema } from './contracts.ts';
+import { STORAGE_DRIZZLE_DB_CONTEXT_ID, type StorageDrizzleDbHost } from './storage-drizzle-db.context.ts';
+import canonicalDescriptor from './canonical.adapter.descriptor.ts';
+declare const libsqlDescriptor: StorageAdapterDescriptor;
+/**
+ * Register a storage adapter id over the generic Drizzle engine: its loader
+ * builds the adapter over the owner app's `storage/drizzle-db` host context.
+ * Platform integrations call this from their plugin's `onRegister`.
+ */
+export declare function registerDrizzleStorageAdapter(runtime: RuntimeRef, descriptor: StorageAdapterDescriptor): void;
+export declare const storageAdapterDrizzlePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default storageAdapterDrizzlePlugin;
+export { canonicalDescriptor, libsqlDescriptor, DrizzleAdapterConfigSchema, STORAGE_DRIZZLE_DB_CONTEXT_ID, type StorageDrizzleDbHost };
+//# sourceMappingURL=storage-adapter-drizzle.plugin.d.ts.map

package/dist/adapters/drizzle/storage-adapter-drizzle.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-drizzle.plugin.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/storage-adapter-drizzle.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAA8B,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAA0C,EACzC,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,mBAAmB,MAAM,mCAAmC,CAAC;AAGpE,QAAA,MAAM,gBAAgB,EAAE,wBAqBvB,CAAC;AAmBF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI,CAO7G;AAED,eAAO,MAAM,2BAA2B,6CAkBtC,CAAC;AAEH,eAAe,2BAA2B,CAAC;AAG3C,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,6BAA6B,EAC7B,KAAK,oBAAoB,EACzB,CAAC"}

package/dist/adapters/drizzle/storage-adapter-drizzle.plugin.js

@@ -0,0 +1,90 @@
+/**
+ * Storage Adapter Drizzle Plugin
+ *
+ * Registers the generic `storage.drizzle` and `storage.drizzle.libsql` adapters
+ * with the runtime via the canonical `createRuntimePlugin` + `runtime.registerLoader`
+ * pattern (matching the other storage adapters: memory, json, localdb, cloud-api).
+ * A platform integration registers its own adapter id over the same engine with
+ * {@link registerDrizzleStorageAdapter} (Cloudflare D1's `storage.drizzle.d1`
+ * lives in its integration, RC09).
+ */
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import { persistenceClientPlugin } from "./persistence.client.js";
+import { DrizzleAdapterConfigSchema } from "./contracts.js";
+import storageAdaptersDrizzleDocsDescriptor from "./docs/storage.adapters.drizzle.docs.descriptor.js";
+import { drizzleJournalMigrationFormatPlugin } from "./drizzle-journal.migration-format.plugin.js";
+import storageDrizzleDbContextDescriptor, { STORAGE_DRIZZLE_DB_CONTEXT_ID } from "./storage-drizzle-db.context.js";
+import canonicalDescriptor from "./canonical.adapter.descriptor.js";
+// libsql adapter descriptor
+const libsqlDescriptor = {
+    id: 'storage.drizzle.libsql',
+    kind: 'storage/adapter',
+    name: 'Drizzle libsql Storage Adapter',
+    description: 'Drizzle-backed storage engine for libsql/Turso/file-URL backends',
+    tags: ['storage', 'drizzle', 'sql', 'adapter', 'libsql'],
+    enabled: true,
+    protocols: ['document', 'record'],
+    basePathSemantics: 'unused',
+    capabilities: ['read', 'write'],
+    requiresPairSchema: false,
+    supportsTransactions: true,
+    supportsTTL: false,
+    supportsSearch: false,
+    supportsFTS: false,
+    persistent: true,
+    supportsSubscription: false,
+    supportsHierarchy: false,
+    supportsComputedFields: true,
+    supportsSideEffects: true,
+    supportsRawQueries: false
+};
+function descriptorCapabilities(descriptor) {
+    return {
+        protocols: [...descriptor.protocols],
+        capabilities: descriptor.capabilities ? [...descriptor.capabilities] : [],
+        requiresPairSchema: descriptor.requiresPairSchema,
+        supportsTransactions: descriptor.supportsTransactions,
+        supportsTTL: descriptor.supportsTTL,
+        supportsFTS: descriptor.supportsFTS,
+        persistent: descriptor.persistent,
+        supportsSubscription: descriptor.supportsSubscription,
+        supportsHierarchy: descriptor.supportsHierarchy,
+        supportsComputedFields: descriptor.supportsComputedFields,
+        supportsSideEffects: descriptor.supportsSideEffects,
+        supportsRawQueries: descriptor.supportsRawQueries
+    };
+}
+/**
+ * Register a storage adapter id over the generic Drizzle engine: its loader
+ * builds the adapter over the owner app's `storage/drizzle-db` host context.
+ * Platform integrations call this from their plugin's `onRegister`.
+ */
+export function registerDrizzleStorageAdapter(runtime, descriptor) {
+    const capabilities = descriptorCapabilities(descriptor);
+    runtime.registerLoader('storage/adapter', descriptor.id, async () => {
+        const { createDrizzleAdapter } = await import("./drizzle.adapter.impl.js");
+        const host = await runtime.context(STORAGE_DRIZZLE_DB_CONTEXT_ID);
+        return createDrizzleAdapter(descriptor.id, host, runtime, capabilities);
+    });
+}
+export const storageAdapterDrizzlePlugin = createRuntimePlugin({
+    id: '@vibesdotdev/storage/adapters/drizzle',
+    name: 'Storage Adapter Drizzle',
+    description: 'Drizzle-backed storage adapters. Registers `storage.drizzle` and `storage.drizzle.libsql`; platform integrations register their own ids with registerDrizzleStorageAdapter.',
+    dependencies: ['storage'],
+    descriptors: [
+        libsqlDescriptor,
+        storageDrizzleDbContextDescriptor,
+        storageAdaptersDrizzleDocsDescriptor
+    ],
+    onRegister: async (runtime) => {
+        await runtime.registerPlugin(persistenceClientPlugin);
+        await runtime.registerPlugin(drizzleJournalMigrationFormatPlugin);
+        registerDrizzleStorageAdapter(runtime, canonicalDescriptor);
+        registerDrizzleStorageAdapter(runtime, libsqlDescriptor);
+    }
+});
+export default storageAdapterDrizzlePlugin;
+// Re-export descriptors and the loader-time validator for explicit registration if needed.
+export { canonicalDescriptor, libsqlDescriptor, DrizzleAdapterConfigSchema, STORAGE_DRIZZLE_DB_CONTEXT_ID };
+//# sourceMappingURL=storage-adapter-drizzle.plugin.js.map

package/dist/adapters/drizzle/storage-adapter-drizzle.plugin.js.map

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

package/dist/adapters/drizzle/storage-drizzle-db.context.d.ts

@@ -0,0 +1,53 @@
+import type { DrizzleDialect } from './contracts.ts';
+export declare const STORAGE_DRIZZLE_DB_CONTEXT_ID = "storage/drizzle-db";
+/** Structural floor shared by every Drizzle database without requiring an index signature. */
+export type StorageDrizzleDbInstance = object;
+/** Raw SQL over the owner's database: rows for a query, a change count for a mutation. */
+export interface StorageDrizzleRawSql {
+    allSql<T = unknown>(sqlText: string, params?: unknown[]): Promise<T[]>;
+    runSql(sqlText: string, params?: unknown[]): Promise<{
+        changes: number;
+    }>;
+}
+/** Request-safe host capability supplied by the app that owns the physical database. */
+export interface StorageDrizzleDbHost {
+    /** Explicit SQL grammar; authoritative over adapter config when supplied. */
+    readonly dialect?: DrizzleDialect;
+    getDatabase(): StorageDrizzleDbInstance;
+    /**
+     * Raw SQL over the same database, when the owner offers it. Consumers that
+     * need raw SQL (maintenance pruning) read it here instead of reaching into a
+     * driver's internals.
+     */
+    getRawSql?(): StorageDrizzleRawSql;
+}
+declare const _default: {
+    id: string;
+    kind: "context";
+    name?: string | undefined;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    priority?: number | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+    valueKind?: "data" | "service" | undefined;
+    valueSchema?: unknown;
+    config?: {
+        sources: ("literal" | "workspace" | "floor")[];
+        subset?: true | undefined;
+    } | undefined;
+};
+export default _default;
+//# sourceMappingURL=storage-drizzle-db.context.d.ts.map

package/dist/adapters/drizzle/storage-drizzle-db.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-drizzle-db.context.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/storage-drizzle-db.context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,6BAA6B,uBAAuB,CAAC;AAElE,8FAA8F;AAC9F,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE9C,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAED,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,WAAW,IAAI,wBAAwB,CAAC;IACxC;;;;OAIG;IACH,SAAS,CAAC,IAAI,oBAAoB,CAAC;CACnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,wBAIG"}

package/dist/adapters/drizzle/storage-drizzle-db.context.js

@@ -0,0 +1,8 @@
+import { createContextDescriptor } from '@vibesdotdev/kernel/factory/context';
+export const STORAGE_DRIZZLE_DB_CONTEXT_ID = 'storage/drizzle-db';
+export default createContextDescriptor({
+    id: STORAGE_DRIZZLE_DB_CONTEXT_ID,
+    description: 'Owner-app database access for the generic Drizzle storage adapter.',
+    hardware: ['cloud']
+});
+//# sourceMappingURL=storage-drizzle-db.context.js.map

package/dist/adapters/drizzle/storage-drizzle-db.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-drizzle-db.context.js","sourceRoot":"","sources":["../../../src/adapters/drizzle/storage-drizzle-db.context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAC;AAwBlE,eAAe,uBAAuB,CAAC;IACtC,EAAE,EAAE,6BAA6B;IACjC,WAAW,EAAE,oEAAoE;IACjF,QAAQ,EAAE,CAAC,OAAO,CAAC;CACnB,CAAC,CAAC"}

package/dist/adapters/drizzle/test.d.ts

@@ -0,0 +1,60 @@
+/**
+ * In-memory libsql + Drizzle test fixture.
+ *
+ * Spins up a `:memory:` libsql client, optionally applies CREATE TABLE /
+ * seed SQL, and returns a Drizzle instance bound to the caller's schema.
+ *
+ * USAGE — integration-style server test that exercises real SQL:
+ *
+ *   import { createTestDrizzleDb } from '@vibesdotdev/storage/adapters/drizzle/test';
+ *   import * as schema from '$server/db/tables';
+ *
+ *   const { db, close } = await createTestDrizzleDb(schema, {
+ *     sql: ['CREATE TABLE activity_logs (...)']
+ *   });
+ *   await db.insert(schema.activityLogs).values([...]);
+ *   const result = await computeRetentionMatrix({ db, ... });
+ *   close();
+ *
+ * Use this in place of hand-rolled `vi.fn().mockReturnValue(...)` chains
+ * over `.select().from().where()` — the mocks return whatever the test
+ * supplies regardless of SQL semantics, so they can't verify WHERE / GROUP
+ * BY / ORDER BY correctness. A real libsql `:memory:` DB does.
+ *
+ * This explicit test-only entrypoint owns its disposable vendor fixtures.
+ * Production callers compose a libSQL integration and hand their runtime to
+ * createLibsqlDrizzleConnection instead.
+ */
+import { type Client } from '@libsql/client';
+import { type LibSQLDatabase } from 'drizzle-orm/libsql';
+import type { DrizzleSchemaRecord } from './contracts.ts';
+export interface CreateTestDrizzleDbOptions {
+    /**
+     * SQL statement(s) to execute against the in-memory DB before returning.
+     * Use this to materialize the schema (CREATE TABLE / CREATE INDEX) and
+     * any baseline seed data. When omitted, the DB is empty — callers can
+     * still issue `client.execute(...)` afterwards.
+     *
+     * IMPORTANT: libsql's `client.execute(sql)` runs ONE statement per call.
+     * Pass an array (one statement per entry, no trailing semicolons needed)
+     * when applying multi-table schemas — a single string with multiple
+     * `CREATE TABLE …;` statements only executes the first one.
+     */
+    sql?: string | string[];
+}
+export interface TestDrizzleDb<TSchema extends DrizzleSchemaRecord> {
+    /** Drizzle ORM instance bound to the in-memory libsql client and your schema. */
+    db: LibSQLDatabase<TSchema>;
+    /** Underlying libsql client. Use for raw SQL setup or teardown beyond the helper's `sql` option. */
+    client: Client;
+    /** Close the underlying client. Call in `afterEach` / `afterAll` to free resources. */
+    close: () => void;
+}
+/**
+ * Create an in-memory libsql DB drizzle-bound to `schema`.
+ *
+ * Each call returns a fresh, isolated DB — there is no shared connection
+ * pool. Caller is responsible for `close()` in teardown.
+ */
+export declare function createTestDrizzleDb<TSchema extends DrizzleSchemaRecord>(schema: TSchema, options?: CreateTestDrizzleDbOptions): Promise<TestDrizzleDb<TSchema>>;
+//# sourceMappingURL=test.d.ts.map

package/dist/adapters/drizzle/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAW,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IAC1C;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,mBAAmB;IACjE,iFAAiF;IACjF,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAC5B,oGAAoG;IACpG,MAAM,EAAE,MAAM,CAAC;IACf,uFAAuF;IACvF,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,SAAS,mBAAmB,EAC5E,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,0BAA+B,GACtC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAajC"}

package/dist/adapters/drizzle/test.js

@@ -0,0 +1,49 @@
+/**
+ * In-memory libsql + Drizzle test fixture.
+ *
+ * Spins up a `:memory:` libsql client, optionally applies CREATE TABLE /
+ * seed SQL, and returns a Drizzle instance bound to the caller's schema.
+ *
+ * USAGE — integration-style server test that exercises real SQL:
+ *
+ *   import { createTestDrizzleDb } from '@vibesdotdev/storage/adapters/drizzle/test';
+ *   import * as schema from '$server/db/tables';
+ *
+ *   const { db, close } = await createTestDrizzleDb(schema, {
+ *     sql: ['CREATE TABLE activity_logs (...)']
+ *   });
+ *   await db.insert(schema.activityLogs).values([...]);
+ *   const result = await computeRetentionMatrix({ db, ... });
+ *   close();
+ *
+ * Use this in place of hand-rolled `vi.fn().mockReturnValue(...)` chains
+ * over `.select().from().where()` — the mocks return whatever the test
+ * supplies regardless of SQL semantics, so they can't verify WHERE / GROUP
+ * BY / ORDER BY correctness. A real libsql `:memory:` DB does.
+ *
+ * This explicit test-only entrypoint owns its disposable vendor fixtures.
+ * Production callers compose a libSQL integration and hand their runtime to
+ * createLibsqlDrizzleConnection instead.
+ */
+import { createClient } from '@libsql/client';
+import { drizzle } from 'drizzle-orm/libsql';
+/**
+ * Create an in-memory libsql DB drizzle-bound to `schema`.
+ *
+ * Each call returns a fresh, isolated DB — there is no shared connection
+ * pool. Caller is responsible for `close()` in teardown.
+ */
+export async function createTestDrizzleDb(schema, options = {}) {
+    const client = createClient({ url: ':memory:' });
+    const statements = options.sql === undefined ? [] : Array.isArray(options.sql) ? options.sql : [options.sql];
+    for (const stmt of statements) {
+        await client.execute(stmt);
+    }
+    const db = drizzle(client, { schema });
+    return {
+        db,
+        client,
+        close: () => client.close()
+    };
+}
+//# sourceMappingURL=test.js.map

package/dist/adapters/drizzle/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/adapters/drizzle/test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,YAAY,EAAe,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAuB,MAAM,oBAAoB,CAAC;AA2BlE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAe,EACf,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,GACf,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3F,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,OAAO;QACN,EAAE;QACF,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC3B,CAAC;AACH,CAAC"}

package/dist/adapters/drizzle/transforms.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Default Database Transforms
+ *
+ * Provides default Zod transforms for common DB ↔ Schema conversions:
+ * - camelCase ↔ snake_case field names
+ * - Date objects ↔ ISO string timestamps
+ * - Boolean ↔ 1/0 integers
+ * - Objects/Arrays ↔ JSON strings
+ *
+ * These transforms use only Zod (universal), no Drizzle imports.
+ * Safe to use in storage descriptors.
+ */
+import * as z from 'zod/v4';
+/** A database row or a record on its way to one: field names to field values. */
+declare const DbRowSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+type DbRow = z.infer<typeof DbRowSchema>;
+/**
+ * Create default database transforms for a schema.
+ *
+ * Returns toDb and fromDb transforms that handle:
+ * - Field name conversion (camelCase ↔ snake_case)
+ * - Type conversion (Date, boolean, JSON)
+ * - Array handling (transforms each item)
+ */
+export declare function createDefaultDbTransforms<T extends z.ZodType>(_schema: T): {
+    toDb: z.ZodPipe<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>, z.ZodTransform<Record<string, unknown> | Record<string, unknown>[], Record<string, unknown> | Record<string, unknown>[]>>;
+    fromDb: z.ZodPipe<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>, z.ZodTransform<Record<string, unknown> | Record<string, unknown>[], Record<string, unknown> | Record<string, unknown>[]>>;
+};
+/**
+ * Common field mappings for specific use cases.
+ * Can be composed with default transforms.
+ */
+export declare const commonFieldMappings: {
+    ensureArrayDefaults: (fieldNames: string[]) => z.ZodPipe<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>, z.ZodTransform<Record<string, unknown> | {
+        [x: string]: unknown;
+    }[], Record<string, unknown> | Record<string, unknown>[]>>;
+    ensureObjectDefaults: (fieldDefaults: DbRow) => z.ZodPipe<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>]>, z.ZodTransform<Record<string, unknown> | {
+        [x: string]: unknown;
+    }[], Record<string, unknown> | Record<string, unknown>[]>>;
+};
+export {};
+//# sourceMappingURL=transforms.d.ts.map

package/dist/adapters/drizzle/transforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transforms.d.ts","sourceRoot":"","sources":["../../../src/adapters/drizzle/transforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,iFAAiF;AACjF,QAAA,MAAM,WAAW,wCAAoC,CAAC;AACtD,KAAK,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AA6FzC;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;;;EAUxE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;sCACG,MAAM,EAAE;;;0CAcJ,KAAK;;;CAY3C,CAAC"}

package/dist/adapters/drizzle/transforms.js

@@ -0,0 +1,147 @@
+/**
+ * Default Database Transforms
+ *
+ * Provides default Zod transforms for common DB ↔ Schema conversions:
+ * - camelCase ↔ snake_case field names
+ * - Date objects ↔ ISO string timestamps
+ * - Boolean ↔ 1/0 integers
+ * - Objects/Arrays ↔ JSON strings
+ *
+ * These transforms use only Zod (universal), no Drizzle imports.
+ * Safe to use in storage descriptors.
+ */
+import * as z from 'zod/v4';
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+/** A database row or a record on its way to one: field names to field values. */
+const DbRowSchema = z.record(z.string(), z.unknown());
+/** One row, or a batch of rows, as the transforms accept them. */
+const DbRowsSchema = DbRowSchema.or(z.array(DbRowSchema));
+/** Whether a field value is an object (an array, plain object or class instance): stored as JSON text. */
+function isObjectValue(value) {
+    return typeof value === 'object' && value !== null;
+}
+function isBooleanValue(value) {
+    return typeof value === 'boolean';
+}
+function isStringValue(value) {
+    return typeof value === 'string';
+}
+function isNumberValue(value) {
+    return typeof value === 'number';
+}
+/**
+ * Stored text decoded as the JSON it was written as, or the parse failure when
+ * it is not JSON (the column then holds plain text that merely opens like JSON).
+ */
+function decodeStoredJson(text) {
+    try {
+        return { value: JsonValueSchema.parse(JSON.parse(text)) };
+    }
+    catch (failure) {
+        return { failure: CaughtFailureSchema.parse(failure) };
+    }
+}
+function camelToSnake(str) {
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
+}
+function snakeToCamel(str) {
+    return str.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+function transformToDb(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        const dbKey = camelToSnake(key);
+        if (value === null) {
+            result[dbKey] = null;
+        }
+        else if (value instanceof Date) {
+            result[dbKey] = value.toISOString();
+        }
+        else if (isBooleanValue(value)) {
+            result[dbKey] = value ? 1 : 0;
+        }
+        else if (isObjectValue(value)) {
+            result[dbKey] = JSON.stringify(value);
+        }
+        else {
+            result[dbKey] = value;
+        }
+    }
+    return result;
+}
+function transformFromDb(row) {
+    const result = {};
+    for (const [key, value] of Object.entries(row)) {
+        if (value === undefined)
+            continue;
+        const objKey = snakeToCamel(key);
+        if (value === null) {
+            result[objKey] = null;
+        }
+        else if (isStringValue(value)) {
+            // Text that opens like JSON and parses is a stored object or array; any other text stays text.
+            const stored = value.startsWith('{') || value.startsWith('[') ? decodeStoredJson(value) : undefined;
+            result[objKey] = stored && 'value' in stored ? stored.value : value;
+        }
+        else if (isNumberValue(value)) {
+            if (key.endsWith('_at')) {
+                result[objKey] = new Date(value);
+            }
+            else if (key === 'enabled' || key.startsWith('is_') || key.startsWith('has_')) {
+                result[objKey] = Boolean(value);
+            }
+            else {
+                result[objKey] = value;
+            }
+        }
+        else {
+            result[objKey] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Create default database transforms for a schema.
+ *
+ * Returns toDb and fromDb transforms that handle:
+ * - Field name conversion (camelCase ↔ snake_case)
+ * - Type conversion (Date, boolean, JSON)
+ * - Array handling (transforms each item)
+ */
+export function createDefaultDbTransforms(_schema) {
+    const toDb = DbRowsSchema.transform((data) => Array.isArray(data) ? data.map((item) => transformToDb(item)) : transformToDb(data));
+    const fromDb = DbRowsSchema.transform((data) => Array.isArray(data) ? data.map((row) => transformFromDb(row)) : transformFromDb(data));
+    return { toDb, fromDb };
+}
+/**
+ * Common field mappings for specific use cases.
+ * Can be composed with default transforms.
+ */
+export const commonFieldMappings = {
+    ensureArrayDefaults: (fieldNames) => DbRowsSchema.transform((data) => {
+        if (Array.isArray(data)) {
+            return data.map((item) => {
+                const result = { ...item };
+                for (const field of fieldNames) {
+                    if (!result[field])
+                        result[field] = [];
+                }
+                return result;
+            });
+        }
+        return data;
+    }),
+    ensureObjectDefaults: (fieldDefaults) => DbRowsSchema.transform((data) => {
+        if (Array.isArray(data)) {
+            return data.map((item) => ({
+                ...item,
+                ...Object.fromEntries(Object.entries(fieldDefaults).map(([key, defaultValue]) => [key, item[key] ?? defaultValue]))
+            }));
+        }
+        return data;
+    })
+};
+//# sourceMappingURL=transforms.js.map

package/dist/adapters/drizzle/transforms.js.map

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

package/dist/adapters/filesystem/filesystem.adapter.descriptor.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Filesystem Object Storage Adapter Descriptor
+ *
+ * `storage.filesystem`: the `object` protocol over the runtime's filesystem
+ * service (`filesystem/adapter`, e.g. the Bun adapter on a consumer host).
+ * The local-filesystem backend of `platform.storage`: every object store is
+ * rooted at an explicit, caller-owned absolute `basePath` from config, and a
+ * key can never address anything outside it.
+ */
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+declare const descriptor: StorageAdapterDescriptor;
+export default descriptor;
+//# sourceMappingURL=filesystem.adapter.descriptor.d.ts.map

package/dist/adapters/filesystem/filesystem.adapter.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.adapter.descriptor.d.ts","sourceRoot":"","sources":["../../../src/adapters/filesystem/filesystem.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAEhG,QAAA,MAAM,UAAU,EAAE,wBAwBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/adapters/filesystem/filesystem.adapter.descriptor.js

@@ -0,0 +1,34 @@
+/**
+ * Filesystem Object Storage Adapter Descriptor
+ *
+ * `storage.filesystem`: the `object` protocol over the runtime's filesystem
+ * service (`filesystem/adapter`, e.g. the Bun adapter on a consumer host).
+ * The local-filesystem backend of `platform.storage`: every object store is
+ * rooted at an explicit, caller-owned absolute `basePath` from config, and a
+ * key can never address anything outside it.
+ */
+const descriptor = {
+    id: 'storage.filesystem',
+    kind: 'storage/adapter',
+    name: 'Filesystem Object Storage',
+    description: "Key-addressed blobs under an explicit, owned base path on the runtime's filesystem service. Refuses keys that escape the base path.",
+    tags: ['storage', 'filesystem', 'local', 'blob'],
+    hardware: ['consumer'],
+    enabled: true,
+    protocols: ['object'],
+    basePathSemantics: 'filesystem',
+    capabilities: ['list', 'read', 'write'],
+    requiresPairSchema: false,
+    supportsTransactions: false,
+    supportsTTL: false,
+    supportsSearch: false,
+    supportsFTS: false,
+    persistent: true,
+    supportsSubscription: false,
+    supportsHierarchy: false,
+    supportsComputedFields: false,
+    supportsSideEffects: false,
+    supportsRawQueries: false
+};
+export default descriptor;
+//# sourceMappingURL=filesystem.adapter.descriptor.js.map

package/dist/adapters/filesystem/filesystem.adapter.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.adapter.descriptor.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/filesystem.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,UAAU,GAA6B;IAC5C,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACV,qIAAqI;IACtI,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC;IAChD,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IAEb,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,iBAAiB,EAAE,YAAY;IAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACvC,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,KAAK;IACrB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,IAAI;IAChB,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,KAAK;IACxB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;CACzB,CAAC;AAEF,eAAe,UAAU,CAAC"}