@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/adapters/fixture/fixture.adapter.impl.js

@@ -0,0 +1,162 @@
+/**
+ * Fixture Storage Adapter Implementation
+ *
+ * Browse-only adapter backed by a deterministic in-memory tree. Implements the
+ * `browse` capability (`listDrives` / `list`); non-browse protocols throw, since
+ * this adapter exists to exercise the browse path (pickers, StorageBrowser,
+ * casework /files) without external credentials. The tree models a cabinet
+ * shop's SharePoint-like layout so create-job-from-folder flows have realistic
+ * folders to act on.
+ */
+import { CapabilityError, createRuntimeImplementation } from '@vibesdotdev/kernel';
+const SITES = [
+    { id: 'woodshop', name: 'Woodshop Cabinetry', kind: 'site' },
+    { id: 'henderson', name: 'Henderson Construction', kind: 'site' }
+];
+/**
+ * drive → folder path (relative, no leading/trailing slash) → child nodes.
+ * Maps, so a drive id or folder path naming an Object.prototype member
+ * (`constructor`, `__proto__`) finds nothing rather than a prototype value.
+ */
+const TREE = new Map([
+    [
+        'woodshop',
+        new Map([
+            [
+                '',
+                [
+                    { name: 'Projects', kind: 'directory' },
+                    { name: 'Shop Drawings', kind: 'directory' },
+                    { name: 'README.txt', kind: 'file', sizeBytes: 184 }
+                ]
+            ],
+            [
+                'Projects',
+                [
+                    { name: 'Henderson Kitchen', kind: 'directory' },
+                    { name: 'Oak Ave Vanity', kind: 'directory' }
+                ]
+            ],
+            [
+                'Projects/Henderson Kitchen',
+                [
+                    { name: 'elevation.pdf', kind: 'file', sizeBytes: 412_000 },
+                    { name: 'cutlist.xlsx', kind: 'file', sizeBytes: 22_400 }
+                ]
+            ],
+            ['Projects/Oak Ave Vanity', [{ name: 'spec.pdf', kind: 'file', sizeBytes: 98_000 }]],
+            ['Shop Drawings', [{ name: 'standard-base.pdf', kind: 'file', sizeBytes: 256_000 }]]
+        ])
+    ],
+    [
+        'henderson',
+        new Map([
+            [
+                '',
+                [
+                    { name: 'Cabinetry', kind: 'directory' },
+                    { name: 'Contracts', kind: 'directory' }
+                ]
+            ],
+            ['Cabinetry', [{ name: 'Kitchen Remodel', kind: 'directory' }]],
+            ['Cabinetry/Kitchen Remodel', [{ name: 'drawings.pdf', kind: 'file', sizeBytes: 720_000 }]],
+            ['Contracts', [{ name: 'agreement.pdf', kind: 'file', sizeBytes: 64_000 }]]
+        ])
+    ]
+]);
+const normalizePath = (path) => (path ?? '').replace(/^\/+|\/+$/g, '');
+/** Stable id for an entry — `${driveId}:${fullPath}` (deterministic across calls). */
+const entryId = (driveId, fullPath) => `${driveId}:${fullPath}`;
+/** The browse-only refusal: a protocol this adapter does not serve. */
+function unsupportedProtocol(adapterId, protocol) {
+    return new CapabilityError(`The fixture adapter is browse-only; it does not support the ${protocol} protocol.`, 'UNAVAILABLE', {
+        reason: 'storage-protocol-unsupported',
+        retryable: false,
+        details: { adapterId, protocol }
+    });
+}
+/**
+ * Stateless and browse-only. The storage/adapter kind constructs one per
+ * runtime from the exported class (with the runtime's kind context, which the
+ * fixture does not need), so no instance is shared between runtimes.
+ */
+export class FixtureStorageAdapter {
+    id;
+    capabilities;
+    constructor(descriptor) {
+        this.id = descriptor.id;
+        this.capabilities = {
+            protocols: descriptor.protocols ?? ['document'],
+            capabilities: descriptor.capabilities ?? ['list', 'read', 'browse'],
+            requiresPairSchema: false,
+            supportsTransactions: false,
+            supportsTTL: false,
+            supportsFTS: false,
+            persistent: false,
+            supportsSubscription: false,
+            supportsHierarchy: true,
+            supportsComputedFields: false,
+            supportsSideEffects: false,
+            supportsRawQueries: false
+        };
+    }
+    configure(_config) { }
+    isConfigured() {
+        return true;
+    }
+    // Browse (canonical `storage/adapter` browse interface)
+    async listDrives() {
+        return SITES.map((site) => ({ ...site }));
+    }
+    async list(driveId, path) {
+        const folder = normalizePath(path);
+        const nodes = TREE.get(driveId)?.get(folder) ?? [];
+        const prefix = folder ? `${folder}/` : '';
+        return nodes.map((node) => {
+            const fullPath = `${prefix}${node.name}`;
+            const entry = {
+                id: entryId(driveId, fullPath),
+                name: node.name,
+                path: fullPath,
+                kind: node.kind
+            };
+            if (node.kind === 'file' && node.sizeBytes !== undefined)
+                entry.sizeBytes = node.sizeBytes;
+            return entry;
+        });
+    }
+    // Not supported — fixture adapter is browse-only.
+    documentStore(_namespace, _schema) {
+        throw unsupportedProtocol(this.id, 'document');
+    }
+    keyValueStore(_namespace, _keySchema, _valueSchema) {
+        throw unsupportedProtocol(this.id, 'key-value');
+    }
+    repository(_tableName, _schema, _options) {
+        throw unsupportedProtocol(this.id, 'repository');
+    }
+    record(_descriptor) {
+        throw unsupportedProtocol(this.id, 'record');
+    }
+    // Lifecycle
+    async ensureReady() { }
+    getDatabaseConnection() {
+        throw new CapabilityError('The fixture adapter does not provide a database connection; use list or listDrives.', 'UNAVAILABLE', {
+            reason: 'storage-database-connection-unsupported',
+            retryable: false,
+            details: { adapterId: this.id }
+        });
+    }
+    async initialize() { }
+    async close() { }
+    async healthCheck() {
+        return { healthy: true };
+    }
+}
+export default createRuntimeImplementation({
+    id: 'storage.fixture',
+    kind: 'storage/adapter',
+    // A class: the storage/adapter kind constructs one per runtime with its kind context.
+    implementation: FixtureStorageAdapter
+});
+//# sourceMappingURL=fixture.adapter.impl.js.map

package/dist/adapters/fixture/fixture.adapter.impl.js.map

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

package/dist/adapters/fixture/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @vibesdotdev/storage/adapters/fixture
+ *
+ * Deterministic, browse-capable storage adapter for local dev + tests.
+ */
+export { default as storageAdapterFixturePlugin } from './storage-adapter-fixture.plugin.ts';
+export { default as fixtureAdapterDescriptor } from './fixture.adapter.descriptor.ts';
+export { default as fixtureAdapterImpl, FixtureStorageAdapter, type FixtureAdapterConfig } from './fixture.adapter.impl.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/fixture/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/fixture/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EACN,OAAO,IAAI,kBAAkB,EAC7B,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,MAAM,2BAA2B,CAAC"}

package/dist/adapters/fixture/index.js

@@ -0,0 +1,9 @@
+/**
+ * @vibesdotdev/storage/adapters/fixture
+ *
+ * Deterministic, browse-capable storage adapter for local dev + tests.
+ */
+export { default as storageAdapterFixturePlugin } from "./storage-adapter-fixture.plugin.js";
+export { default as fixtureAdapterDescriptor } from "./fixture.adapter.descriptor.js";
+export { default as fixtureAdapterImpl, FixtureStorageAdapter } from "./fixture.adapter.impl.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/fixture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/fixture/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAC7F,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AACtF,OAAO,EACN,OAAO,IAAI,kBAAkB,EAC7B,qBAAqB,EAErB,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * Storage Adapter Fixture Plugin
+ *
+ * Registers the `storage.fixture` browse-capable adapter. Apps compose this in
+ * their dev/test profile (NOT production) so the storage-browse path can be
+ * exercised against deterministic data with no external credentials.
+ */
+export declare const storageAdapterFixturePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default storageAdapterFixturePlugin;
+//# sourceMappingURL=storage-adapter-fixture.plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-fixture.plugin.d.ts","sourceRoot":"","sources":["../../../src/adapters/fixture/storage-adapter-fixture.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,2BAA2B,6CActC,CAAC;AAEH,eAAe,2BAA2B,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Storage Adapter Fixture Plugin
+ *
+ * Registers the `storage.fixture` browse-capable adapter. Apps compose this in
+ * their dev/test profile (NOT production) so the storage-browse path can be
+ * exercised against deterministic data with no external credentials.
+ */
+import { createRuntimePlugin } from '@vibesdotdev/kernel';
+import fixtureAdapterDescriptor from "./fixture.adapter.descriptor.js";
+export const storageAdapterFixturePlugin = createRuntimePlugin({
+    id: '@vibesdotdev/storage/adapters/fixture',
+    name: 'Storage Adapter Fixture',
+    description: 'Deterministic browse-capable storage adapter for local dev + tests. No external credentials.',
+    dependencies: ['storage'],
+    descriptors: [fixtureAdapterDescriptor],
+    onRegister: async (runtime) => {
+        runtime.registerLoader('storage/adapter', fixtureAdapterDescriptor.id, async () => (await import("./fixture.adapter.impl.js")).default);
+    }
+});
+export default storageAdapterFixturePlugin;
+//# sourceMappingURL=storage-adapter-fixture.plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-fixture.plugin.js","sourceRoot":"","sources":["../../../src/adapters/fixture/storage-adapter-fixture.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,wBAAwB,MAAM,iCAAiC,CAAC;AAEvE,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;IAC9D,EAAE,EAAE,uCAAuC;IAC3C,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACV,8FAA8F;IAC/F,YAAY,EAAE,CAAC,SAAS,CAAC;IAEzB,WAAW,EAAE,CAAC,wBAAwB,CAAC;IAEvC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,wBAAwB,CAAC,EAAE,EAAE,KAAK,IAAI,EAAE,CACjF,CAAC,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC,CAAC,OAAO,CACnD,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,2BAA2B,CAAC"}

package/dist/adapters/idb/idb-backend.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Key/value backend behind the IndexedDB storage adapter.
+ *
+ * The adapter's document + key-value logic is written against this small
+ * interface, so it's fully unit-testable in-memory (no browser, no giant IDB
+ * mock). The real `createIdbBackend()` is a thin IndexedDB wrapper exercised in
+ * a browser; `createMemoryBackend()` backs tests and SSR fallbacks.
+ *
+ * The backend is generic over the values it holds: it stores and returns
+ * structured clones and never interprets them. A reader that knows the shape
+ * (the adapter, with its schema) parses what it reads.
+ */
+export interface KvBackend<Value> {
+    get(key: string): Promise<Value | null>;
+    put(key: string, value: Value): Promise<void>;
+    /** Atomically replace one value while serializing concurrent writers. */
+    update(key: string, transform: (current: Value | null) => Value | Promise<Value>): Promise<Value>;
+    delete(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    /** All keys, optionally filtered to those starting with `prefix`. */
+    keys(prefix?: string): Promise<string[]>;
+}
+/** In-memory backend — tests, and the SSR fallback when IndexedDB is absent. */
+export declare function createMemoryBackend<Value>(): KvBackend<Value>;
+/**
+ * IndexedDB-backed `KvBackend`. Browser-only (uses `globalThis.indexedDB`);
+ * refuses `UNAVAILABLE` `idb-unavailable` when IndexedDB is absent. Thin by
+ * design — verified in a browser, not in the adapter unit tests (those use
+ * {@link createMemoryBackend}). What it reads back is whatever the database
+ * holds, so its values are unknown until the reader parses them.
+ */
+export declare function createIdbBackend(dbName?: string, storeName?: string): KvBackend<unknown>;
+//# sourceMappingURL=idb-backend.d.ts.map

package/dist/adapters/idb/idb-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-backend.d.ts","sourceRoot":"","sources":["../../../src/adapters/idb/idb-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,WAAW,SAAS,CAAC,KAAK;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACxC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,yEAAyE;IACzE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAClG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,qEAAqE;IACrE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC;AAoBD,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,KAAK,KAAK,SAAS,CAAC,KAAK,CAAC,CAyC7D;AAUD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,GAAE,MAAmB,EAC3B,SAAS,GAAE,MAAsB,GAC/B,SAAS,CAAC,OAAO,CAAC,CAkIpB"}

package/dist/adapters/idb/idb-backend.js

@@ -0,0 +1,217 @@
+/**
+ * Key/value backend behind the IndexedDB storage adapter.
+ *
+ * The adapter's document + key-value logic is written against this small
+ * interface, so it's fully unit-testable in-memory (no browser, no giant IDB
+ * mock). The real `createIdbBackend()` is a thin IndexedDB wrapper exercised in
+ * a browser; `createMemoryBackend()` backs tests and SSR fallbacks.
+ *
+ * The backend is generic over the values it holds: it stores and returns
+ * structured clones and never interprets them. A reader that knows the shape
+ * (the adapter, with its schema) parses what it reads.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+/**
+ * A structured clone of `value`, as IndexedDB takes one on store. A value
+ * IndexedDB could not store (a function, a symbol, a class with private state)
+ * is refused `INVALID_INPUT` `idb-value-not-cloneable`, as IndexedDB refuses it,
+ * never kept by reference.
+ */
+function cloneValue(value) {
+    try {
+        return structuredClone(value);
+    }
+    catch (error) {
+        throw new CapabilityError('The value cannot be stored: IndexedDB stores only structured-cloneable values.', 'INVALID_INPUT', {
+            reason: 'idb-value-not-cloneable',
+            retryable: false,
+            cause: error
+        });
+    }
+}
+/** In-memory backend — tests, and the SSR fallback when IndexedDB is absent. */
+export function createMemoryBackend() {
+    const map = new Map();
+    const updateTails = new Map();
+    return {
+        async get(key) {
+            const entry = map.get(key);
+            return entry ? cloneValue(entry.value) : null;
+        },
+        async put(key, value) {
+            map.set(key, { value: cloneValue(value) });
+        },
+        async update(key, transform) {
+            const previous = updateTails.get(key) ?? Promise.resolve();
+            let release;
+            const current = new Promise((resolve) => {
+                release = resolve;
+            });
+            const tail = previous.then(() => current);
+            updateTails.set(key, tail);
+            await previous;
+            try {
+                const entry = map.get(key);
+                const next = await transform(entry ? cloneValue(entry.value) : null);
+                map.set(key, { value: cloneValue(next) });
+                return cloneValue(next);
+            }
+            finally {
+                release();
+                if (updateTails.get(key) === tail)
+                    updateTails.delete(key);
+            }
+        },
+        async delete(key) {
+            map.delete(key);
+        },
+        async has(key) {
+            return map.has(key);
+        },
+        async keys(prefix) {
+            const all = [...map.keys()];
+            return prefix ? all.filter((k) => k.startsWith(prefix)) : all;
+        }
+    };
+}
+const DEFAULT_DB = 'vibes-storage';
+const DEFAULT_STORE = 'kv';
+/** An IndexedDB request or transaction that failed: the event (its target holds the DOMException) is the cause. */
+function idbFailure(message, reason, event) {
+    return new CapabilityError(message, 'UNAVAILABLE', { reason, retryable: true, cause: event });
+}
+/**
+ * IndexedDB-backed `KvBackend`. Browser-only (uses `globalThis.indexedDB`);
+ * refuses `UNAVAILABLE` `idb-unavailable` when IndexedDB is absent. Thin by
+ * design — verified in a browser, not in the adapter unit tests (those use
+ * {@link createMemoryBackend}). What it reads back is whatever the database
+ * holds, so its values are unknown until the reader parses them.
+ */
+export function createIdbBackend(dbName = DEFAULT_DB, storeName = DEFAULT_STORE) {
+    function idb() {
+        const factory = globalThis.indexedDB;
+        if (!factory) {
+            throw new CapabilityError('IndexedDB is not available in this environment.', 'UNAVAILABLE', {
+                reason: 'idb-unavailable',
+                retryable: false
+            });
+        }
+        return factory;
+    }
+    let dbPromise = null;
+    function openDb() {
+        if (dbPromise)
+            return dbPromise;
+        dbPromise = new Promise((resolve, reject) => {
+            const req = idb().open(dbName, 1);
+            req.onupgradeneeded = () => {
+                const db = req.result;
+                if (!db.objectStoreNames.contains(storeName))
+                    db.createObjectStore(storeName);
+            };
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = (event) => reject(new CapabilityError('IndexedDB could not be opened.', 'UNAVAILABLE', {
+                reason: 'idb-open-failed',
+                retryable: true,
+                cause: event
+            }));
+        });
+        return dbPromise;
+    }
+    async function tx(mode, run) {
+        const db = await openDb();
+        return new Promise((resolve, reject) => {
+            const transaction = db.transaction(storeName, mode);
+            const request = run(transaction.objectStore(storeName));
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = (event) => reject(new CapabilityError('An IndexedDB request failed.', 'UNAVAILABLE', {
+                reason: 'idb-request-failed',
+                retryable: true,
+                cause: event
+            }));
+        });
+    }
+    return {
+        async get(key) {
+            const value = await tx('readonly', (s) => s.get(key));
+            return value === undefined ? null : value;
+        },
+        async put(key, value) {
+            await tx('readwrite', (s) => s.put(value, key));
+        },
+        async update(key, transform) {
+            const db = await openDb();
+            return new Promise((resolve, reject) => {
+                const transaction = db.transaction(storeName, 'readwrite');
+                const store = transaction.objectStore(storeName);
+                let next;
+                const request = store.get(key);
+                request.onsuccess = () => {
+                    try {
+                        const transformed = transform(request.result === undefined ? null : request.result);
+                        if (!(transformed instanceof Promise)) {
+                            next = transformed;
+                            store.put(next, key);
+                            return;
+                        }
+                        // A transform that settles later keeps the transaction alive with
+                        // reads until it does; a rejected transform aborts it and is the
+                        // update's failure.
+                        let settled = false;
+                        let transformFailed = false;
+                        transformed.then((value) => {
+                            next = value;
+                            settled = true;
+                        }, (error) => {
+                            transformFailed = true;
+                            settled = true;
+                            reject(error);
+                        });
+                        const keepAlive = () => {
+                            const keepAliveRequest = store.get(key);
+                            keepAliveRequest.onsuccess = () => {
+                                if (!settled) {
+                                    keepAlive();
+                                    return;
+                                }
+                                if (transformFailed) {
+                                    transaction.abort();
+                                    return;
+                                }
+                                store.put(next, key);
+                            };
+                            keepAliveRequest.onerror = (event) => reject(idbFailure('IndexedDB atomic update could not hold its transaction.', 'idb-update-failed', event));
+                        };
+                        keepAlive();
+                    }
+                    catch (error) {
+                        transaction.abort();
+                        reject(error);
+                    }
+                };
+                request.onerror = (event) => reject(idbFailure('IndexedDB atomic update could not read the current value.', 'idb-update-failed', event));
+                transaction.oncomplete = () => resolve(next);
+                transaction.onerror = (event) => reject(idbFailure('IndexedDB atomic update failed.', 'idb-update-failed', event));
+                transaction.onabort = () => {
+                    reject(new CapabilityError('IndexedDB atomic update aborted.', 'UNAVAILABLE', {
+                        reason: 'idb-update-aborted',
+                        retryable: true,
+                        cause: transaction.error
+                    }));
+                };
+            });
+        },
+        async delete(key) {
+            await tx('readwrite', (s) => s.delete(key));
+        },
+        async has(key) {
+            const count = await tx('readonly', (s) => s.count(key));
+            return count > 0;
+        },
+        async keys(prefix) {
+            const all = (await tx('readonly', (s) => s.getAllKeys())).map(String);
+            return prefix ? all.filter((k) => k.startsWith(prefix)) : all;
+        }
+    };
+}
+//# sourceMappingURL=idb-backend.js.map

package/dist/adapters/idb/idb-backend.js.map

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

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

@@ -0,0 +1,14 @@
+/**
+ * IndexedDB Storage Adapter Descriptor.
+ *
+ * Browser-tier persistence for the offline-first vision: document + key-value
+ * protocols on IndexedDB. Registered only in the browser runtime
+ * (ensureBrowserRuntime); `hardware: ['consumer']` keeps it off cloud workers.
+ * Does NOT advertise the record protocol — `StorageRecord` is SQL-coupled
+ * (adapter.getDatabaseConnection), so browser-offline records are a separate
+ * sqlite.wasm effort.
+ */
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+declare const descriptor: StorageAdapterDescriptor;
+export default descriptor;
+//# sourceMappingURL=idb.adapter.descriptor.d.ts.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * IndexedDB Storage Adapter Descriptor.
+ *
+ * Browser-tier persistence for the offline-first vision: document + key-value
+ * protocols on IndexedDB. Registered only in the browser runtime
+ * (ensureBrowserRuntime); `hardware: ['consumer']` keeps it off cloud workers.
+ * Does NOT advertise the record protocol — `StorageRecord` is SQL-coupled
+ * (adapter.getDatabaseConnection), so browser-offline records are a separate
+ * sqlite.wasm effort.
+ */
+const descriptor = {
+    id: 'storage.idb',
+    kind: 'storage/adapter',
+    name: 'IndexedDB Storage',
+    description: 'Browser IndexedDB storage (document + key-value) for offline-first data.',
+    tags: ['storage', 'indexeddb', 'browser', 'offline'],
+    hardware: ['consumer'],
+    enabled: true,
+    protocols: ['document', 'keyvalue'],
+    basePathSemantics: 'unused',
+    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=idb.adapter.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idb.adapter.descriptor.js","sourceRoot":"","sources":["../../../src/adapters/idb/idb.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,GAA6B;IAC5C,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,0EAA0E;IACvF,IAAI,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC;IACpD,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IAEb,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;IACnC,iBAAiB,EAAE,QAAQ;IAC3B,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"}

package/dist/adapters/idb/idb.adapter.impl.d.ts

@@ -0,0 +1,56 @@
+/**
+ * IndexedDB Storage Adapter Implementation.
+ *
+ * Document + key-value persistence on a {@link KvBackend} (IndexedDB in the
+ * browser; in-memory for tests/SSR). The adapter logic is backend-agnostic, so
+ * it's fully unit-testable without a browser. Record/repository protocols throw
+ * — those are SQL-coupled (`StorageRecord` via getDatabaseConnection) and belong
+ * to a future sqlite.wasm browser adapter.
+ */
+import { type KindContext } from '@vibesdotdev/kernel';
+import type { z } from 'zod/v4';
+import type { StorageAdapterInterface, StorageAdapterCapabilities, StorageDocumentStoreInterface, StorageKeyValueInterface, StorageHealthStatus, RepositoryOptions } from '@vibesdotdev/storage/interfaces';
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+import type { StorageRecordDescriptor } from '@vibesdotdev/storage/schemas/record';
+import { type KvBackend } from './idb-backend.ts';
+export type IdbAdapterConfig = Record<string, never>;
+export interface IndexedDbStorageAdapterOptions {
+    /**
+     * Inject a backend (tests pass an in-memory one); defaults to IndexedDB.
+     * The adapter holds documents and key-value entries of many schemas in one
+     * backend and parses every read with the caller's schema.
+     */
+    backend?: KvBackend<unknown>;
+}
+/**
+ * One instance per runtime: the storage/adapter kind constructs this class
+ * with `(descriptor, kindContext)`, so no backend is shared between runtimes.
+ * A direct caller passes `(descriptor, options?)` to inject a backend.
+ */
+export declare class IndexedDbStorageAdapter implements StorageAdapterInterface<IdbAdapterConfig> {
+    readonly id: string;
+    readonly capabilities: StorageAdapterCapabilities;
+    private backendInstance?;
+    constructor(descriptor: StorageAdapterDescriptor, optionsOrContext?: IndexedDbStorageAdapterOptions | KindContext);
+    /** Lazily create the IndexedDB backend (kept out of construction so module
+     *  load doesn't touch IndexedDB in non-browser contexts). Where IndexedDB is
+     *  absent its first use refuses typed (idb-unavailable): a persistent adapter
+     *  never turns into an ephemeral one. Tests hand in a backend; a host without
+     *  IndexedDB composes another adapter. */
+    private backend;
+    configure(_config: IdbAdapterConfig): void;
+    isConfigured(): boolean;
+    documentStore<T>(namespace: string, _schema: z.ZodType<T>): StorageDocumentStoreInterface<T>;
+    keyValueStore<TKey, TValue>(namespace: string, _keySchema: z.ZodType<TKey>, _valueSchema: z.ZodType<TValue>): StorageKeyValueInterface<TKey, TValue>;
+    repository<T>(_tableName: string, _schema: z.ZodType<T>, _options?: RepositoryOptions): never;
+    /** StorageRecord is SQL-coupled: offline records belong to a sqlite.wasm browser adapter. */
+    record(_descriptor: StorageRecordDescriptor): never;
+    ensureReady(): Promise<void>;
+    getDatabaseConnection(): never;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    healthCheck(): Promise<StorageHealthStatus>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof IndexedDbStorageAdapter>;
+export default _default;
+//# sourceMappingURL=idb.adapter.impl.d.ts.map

package/dist/adapters/idb/idb.adapter.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb.adapter.impl.d.ts","sourceRoot":"","sources":["../../../src/adapters/idb/idb.adapter.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrG,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGpE,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAErD,MAAM,WAAW,8BAA8B;IAC9C;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;CAC7B;AAcD;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,uBAAuB,CAAC,gBAAgB,CAAC;IACxF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;IAElD,OAAO,CAAC,eAAe,CAAC,CAAqB;gBAEjC,UAAU,EAAE,wBAAwB,EAAE,gBAAgB,GAAE,8BAA8B,GAAG,WAAgB;IAoBrH;;;;8CAI0C;IAC1C,OAAO,CAAC,OAAO;IAKf,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAE1C,YAAY,IAAI,OAAO;IAMvB,aAAa,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,6BAA6B,CAAC,CAAC,CAAC;IAoD5F,aAAa,CAAC,IAAI,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAC7B,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC;IAiFzC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,KAAK;IAI7F,6FAA6F;IAC7F,MAAM,CAAC,WAAW,EAAE,uBAAuB,GAAG,KAAK;IAM7C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAElC,qBAAqB,IAAI,KAAK;IAQxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAGjD;;AAED,wBAKG"}