@vibesdotdev/storage 0.0.1 → 1.0.0-rc.3

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

@@ -0,0 +1,57 @@
+/**
+ * Filesystem Object Storage Adapter Implementation
+ *
+ * `storage.filesystem` serves the `object` protocol over the filesystem
+ * service of the runtime that constructed it (`filesystem/adapter`, resolved
+ * with `resolveFileSystemAdapter`). It never touches `node:fs` itself and never
+ * guesses a location: every `objectStore(namespace, config)` needs an explicit
+ * absolute `config.basePath` the caller owns, and the store lives at
+ * `<basePath>/<namespace>`.
+ *
+ * Keys are `/`-separated relative paths. A key or namespace that is absolute,
+ * empty, contains `.`/`..`/empty segments, a backslash or a NUL byte is refused
+ * `INVALID_INPUT storage-filesystem-path-escape`, and every resolved path is
+ * checked to stay under the base path. A symlink is never followed for a read
+ * or a write.
+ *
+ * One instance per runtime: the storage/adapter kind constructs this class
+ * with the runtime's kind context.
+ */
+import { type KindContext } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import type { StorageAdapterCapabilities, StorageAdapterInterface, StorageHealthStatus } from '../../interfaces/adapter.ts';
+import type { StorageDocumentStoreInterface } from '../../interfaces/document-store.ts';
+import type { StorageKeyValueInterface } from '../../interfaces/key-value.ts';
+import type { StorageObjectStoreInterface } from '../../interfaces/object-store.ts';
+import type { StorageRecordInterface } from '../../interfaces/record/index.ts';
+import type { RepositoryOptions, StorageRepositoryInterface } from '../../interfaces/repository.ts';
+import type { StorageAdapterDescriptor } from '../../schemas/adapter-descriptor.ts';
+import type { StorageRecordDescriptor } from '../../schemas/record/index.ts';
+/** The adapter takes no adapter-level configuration: each `objectStore()` call brings its own. */
+export type FilesystemAdapterConfig = Record<string, never>;
+/** Validate a relative `/`-separated path and return its segments; refuses anything that could escape. */
+export declare function objectKeySegments(what: 'key' | 'namespace' | 'prefix', value: string): string[];
+export declare class FilesystemObjectStorageAdapter implements StorageAdapterInterface<FilesystemAdapterConfig> {
+    readonly id = "storage.filesystem";
+    readonly capabilities: StorageAdapterCapabilities;
+    private readonly runtime;
+    private service;
+    constructor(_descriptor: StorageAdapterDescriptor, context: KindContext);
+    /** The runtime's filesystem service (`filesystem/adapter`); a failed resolution propagates and is retried next call. */
+    private fileSystem;
+    configure(_config: FilesystemAdapterConfig): void;
+    isConfigured(): boolean;
+    objectStore<Config>(namespace?: string, config?: Config): StorageObjectStoreInterface;
+    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): StorageRepositoryInterface<T>;
+    record<T = unknown>(_descriptor: StorageRecordDescriptor): StorageRecordInterface<T>;
+    ensureReady(): Promise<void>;
+    getDatabaseConnection(): never;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    healthCheck(): Promise<StorageHealthStatus>;
+}
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<typeof FilesystemObjectStorageAdapter>;
+export default _default;
+//# sourceMappingURL=filesystem.adapter.impl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.adapter.impl.d.ts","sourceRoot":"","sources":["../../../src/adapters/filesystem/filesystem.adapter.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAgD,KAAK,WAAW,EAAmB,MAAM,qBAAqB,CAAC;AACtH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EACX,0BAA0B,EAC1B,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,KAAK,EAGX,2BAA2B,EAC3B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACpG,OAAO,KAAK,EACX,wBAAwB,EAKxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAS7E,kGAAkG;AAClG,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAyB5D,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,GAAG,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAS/F;AA4GD,qBAAa,8BAA+B,YAAW,uBAAuB,CAAC,uBAAuB,CAAC;IACtG,QAAQ,CAAC,EAAE,wBAAc;IACzB,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAa/C;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,OAAO,CAAkC;gBAErC,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,WAAW;IAIvE,wHAAwH;YAC1G,UAAU;IAOxB,SAAS,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAIjD,YAAY,IAAI,OAAO;IAIvB,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,2BAA2B;IAcrF,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,6BAA6B,CAAC,CAAC,CAAC;IAI7F,aAAa,CAAC,IAAI,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAC7B,wBAAwB,CAAC,IAAI,EAAE,MAAM,CAAC;IAIzC,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,0BAA0B,CAAC,CAAC,CAAC;IAIrH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,WAAW,EAAE,uBAAuB,GAAG,sBAAsB,CAAC,CAAC,CAAC;IAI9E,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,qBAAqB,IAAI,KAAK;IAQxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,WAAW,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAIjD;;AAED,wBAMG"}

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

@@ -0,0 +1,257 @@
+/**
+ * Filesystem Object Storage Adapter Implementation
+ *
+ * `storage.filesystem` serves the `object` protocol over the filesystem
+ * service of the runtime that constructed it (`filesystem/adapter`, resolved
+ * with `resolveFileSystemAdapter`). It never touches `node:fs` itself and never
+ * guesses a location: every `objectStore(namespace, config)` needs an explicit
+ * absolute `config.basePath` the caller owns, and the store lives at
+ * `<basePath>/<namespace>`.
+ *
+ * Keys are `/`-separated relative paths. A key or namespace that is absolute,
+ * empty, contains `.`/`..`/empty segments, a backslash or a NUL byte is refused
+ * `INVALID_INPUT storage-filesystem-path-escape`, and every resolved path is
+ * checked to stay under the base path. A symlink is never followed for a read
+ * or a write.
+ *
+ * One instance per runtime: the storage/adapter kind constructs this class
+ * with the runtime's kind context.
+ */
+import { CapabilityError, createRuntimeImplementation } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+import { parseAdapterInput } from "../parse-adapter-input.js";
+const ADAPTER_ID = 'storage.filesystem';
+const DEFAULT_LIST_LIMIT = 1000;
+/** One `objectStore()` call's configuration: the absolute base path the caller owns. */
+const ObjectStoreConfigSchema = z.object({
+    basePath: z.string().refine((path) => path.startsWith('/'), 'basePath must be absolute')
+});
+/** A key, prefix or namespace that would leave the base path. The value stays out of the message and details. */
+function pathEscape(what) {
+    return new CapabilityError(`The ${what} would leave the object store's base path.`, 'INVALID_INPUT', {
+        reason: 'storage-filesystem-path-escape',
+        retryable: false,
+        details: { field: what }
+    });
+}
+/** A protocol this adapter does not serve: filesystem object storage is object-only. */
+function unsupportedProtocol(protocol) {
+    return new CapabilityError(`The filesystem adapter does not support the ${protocol} protocol; it serves object storage only.`, 'UNAVAILABLE', {
+        reason: 'storage-protocol-unsupported',
+        retryable: false,
+        details: { adapterId: ADAPTER_ID, protocol }
+    });
+}
+/** Validate a relative `/`-separated path and return its segments; refuses anything that could escape. */
+export function objectKeySegments(what, value) {
+    if (value.length === 0 || value.includes('\\') || value.includes('\0') || value.startsWith('/')) {
+        throw pathEscape(what);
+    }
+    const segments = value.split('/');
+    for (const segment of segments) {
+        if (segment === '' || segment === '.' || segment === '..')
+            throw pathEscape(what);
+    }
+    return segments;
+}
+async function toBytes(body) {
+    if (body instanceof ArrayBuffer)
+        return new Uint8Array(body);
+    if (body instanceof Blob)
+        return new Uint8Array(await body.arrayBuffer());
+    return new Uint8Array(await new Response(body).arrayBuffer());
+}
+class FilesystemObjectStore {
+    fs;
+    basePath;
+    root;
+    constructor(fs, basePath, root) {
+        this.fs = fs;
+        this.basePath = basePath;
+        this.root = root;
+    }
+    /** Absolute path of `segments` under the store root, proven to stay under the base path. */
+    async resolve(what, value) {
+        const fs = await this.fs();
+        const segments = value === '' && what === 'prefix' ? [] : objectKeySegments(what, value);
+        const rootPath = fs.join(this.basePath, ...this.root);
+        const path = fs.normalize(fs.join(rootPath, ...segments));
+        const relative = fs.relative(this.basePath, path);
+        if (relative.startsWith('..') || fs.isAbsolute(relative))
+            throw pathEscape(what);
+        return { fs, path, rootPath };
+    }
+    /** Refuse to read or write through a symlink (it could point outside the base path). */
+    async refuseSymlink(fs, path) {
+        if ((await fs.stat(path)).isSymlink)
+            throw pathEscape('key');
+    }
+    async put(key, body, opts) {
+        const { fs, path } = await this.resolve('key', key);
+        if (await fs.exists(path))
+            await this.refuseSymlink(fs, path);
+        const bytes = await toBytes(body);
+        await fs.mkdir(fs.dirname(path), { recursive: true });
+        await fs.writeFile(path, bytes);
+        return { key, size: bytes.byteLength, contentType: opts?.contentType ?? 'application/octet-stream' };
+    }
+    async get(key) {
+        const { fs, path } = await this.resolve('key', key);
+        if (!(await fs.exists(path)))
+            return null;
+        await this.refuseSymlink(fs, path);
+        const data = await fs.readFile(path);
+        const bytes = data instanceof Uint8Array ? data : new TextEncoder().encode(data);
+        return new ReadableStream({
+            start(controller) {
+                controller.enqueue(bytes);
+                controller.close();
+            }
+        });
+    }
+    async head(key) {
+        const { fs, path } = await this.resolve('key', key);
+        if (!(await fs.exists(path)))
+            return null;
+        const stat = await fs.stat(path);
+        if (stat.isSymlink)
+            throw pathEscape('key');
+        if (stat.kind !== 'file')
+            return null;
+        return { key, size: stat.size, lastModified: stat.mtime };
+    }
+    async delete(key) {
+        const { fs, path } = await this.resolve('key', key);
+        // Confirmed absence: deleting an absent key resolves cleanly.
+        if (!(await fs.exists(path)))
+            return;
+        await fs.remove(path);
+    }
+    async list(prefix, opts) {
+        const { fs, rootPath } = await this.resolve('prefix', '');
+        const keyPrefix = prefix ? objectKeySegments('prefix', prefix.replace(/\/+$/, '')).join('/') : '';
+        const keys = [];
+        const walk = async (dir, relative) => {
+            for (const entry of await fs.list(dir)) {
+                const childPath = fs.join(dir, entry.name);
+                const childKey = [...relative, entry.name];
+                if (entry.kind === 'directory') {
+                    await walk(childPath, childKey);
+                }
+                else if (entry.kind === 'file') {
+                    const key = childKey.join('/');
+                    if (keyPrefix && key !== keyPrefix && !key.startsWith(`${keyPrefix}/`))
+                        continue;
+                    const stat = await fs.stat(childPath);
+                    keys.push({ key, size: stat.size, lastModified: stat.mtime });
+                }
+            }
+        };
+        if (await fs.exists(rootPath))
+            await walk(rootPath, []);
+        keys.sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
+        const after = opts?.cursor;
+        const remaining = after ? keys.filter((entry) => entry.key > after) : keys;
+        const limit = opts?.limit && opts.limit > 0 ? opts.limit : DEFAULT_LIST_LIMIT;
+        const page = remaining.slice(0, limit);
+        const hasMore = remaining.length > page.length;
+        const result = { objects: page, hasMore };
+        const last = page.at(-1);
+        if (hasMore && last)
+            result.cursor = last.key;
+        return result;
+    }
+    async url(key) {
+        await this.resolve('key', key);
+        // No direct URL for a local file: the app proxies the bytes through get().
+        return { kind: 'proxy', url: key };
+    }
+}
+export class FilesystemObjectStorageAdapter {
+    id = ADAPTER_ID;
+    capabilities = {
+        protocols: ['object'],
+        capabilities: ['list', 'read', 'write'],
+        requiresPairSchema: false,
+        supportsTransactions: false,
+        supportsTTL: false,
+        supportsFTS: false,
+        persistent: true,
+        supportsSubscription: false,
+        supportsHierarchy: false,
+        supportsComputedFields: false,
+        supportsSideEffects: false,
+        supportsRawQueries: false
+    };
+    runtime;
+    service = null;
+    constructor(_descriptor, context) {
+        this.runtime = context.runtime;
+    }
+    /** The runtime's filesystem service (`filesystem/adapter`); a failed resolution propagates and is retried next call. */
+    async fileSystem() {
+        if (this.service)
+            return this.service;
+        const { resolveFileSystemAdapter } = await import('@vibesdotdev/filesystem/client/resolve-adapter');
+        this.service = await resolveFileSystemAdapter(this.runtime);
+        return this.service;
+    }
+    configure(_config) {
+        // Per-call config only: objectStore() takes its basePath with each call.
+    }
+    isConfigured() {
+        return true;
+    }
+    objectStore(namespace, config) {
+        // The caller's configuration is read once, through the adapters' guard:
+        // a missing, relative or unreadable basePath is the same typed refusal.
+        const { basePath } = parseAdapterInput(ObjectStoreConfigSchema, config, {
+            message: 'storage.filesystem needs an explicit absolute basePath the caller owns; it never guesses one.',
+            code: 'INVALID_INPUT',
+            reason: 'storage-filesystem-base-path-required'
+        });
+        const root = namespace ? objectKeySegments('namespace', namespace) : [];
+        return new FilesystemObjectStore(() => this.fileSystem(), basePath, root);
+    }
+    // Unsupported protocols — filesystem object storage is object-only.
+    documentStore(_namespace, _schema) {
+        throw unsupportedProtocol('document');
+    }
+    keyValueStore(_namespace, _keySchema, _valueSchema) {
+        throw unsupportedProtocol('key-value');
+    }
+    repository(_tableName, _schema, _options) {
+        throw unsupportedProtocol('repository');
+    }
+    record(_descriptor) {
+        throw unsupportedProtocol('record');
+    }
+    async ensureReady() {
+        await this.fileSystem();
+    }
+    getDatabaseConnection() {
+        throw new CapabilityError('The filesystem adapter does not provide a database connection.', 'UNAVAILABLE', {
+            reason: 'storage-database-connection-unsupported',
+            retryable: false,
+            details: { adapterId: ADAPTER_ID }
+        });
+    }
+    async initialize() {
+        await this.fileSystem();
+    }
+    async close() {
+        this.service = null;
+    }
+    async healthCheck() {
+        await this.fileSystem();
+        return { healthy: true };
+    }
+}
+export default createRuntimeImplementation({
+    id: ADAPTER_ID,
+    kind: 'storage/adapter',
+    constraint: { hardware: ['consumer'] },
+    // A class: the storage/adapter kind constructs one per runtime with its kind context.
+    implementation: FilesystemObjectStorageAdapter
+});
+//# sourceMappingURL=filesystem.adapter.impl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.adapter.impl.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/filesystem.adapter.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,eAAe,EAAE,2BAA2B,EAAqC,MAAM,qBAAqB,CAAC;AACtH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAyB9D,MAAM,UAAU,GAAG,oBAAoB,CAAC;AACxC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAQhC,wFAAwF;AACxF,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,2BAA2B,CAAC;CACxF,CAAC,CAAC;AAEH,iHAAiH;AACjH,SAAS,UAAU,CAAC,IAAoC;IACvD,OAAO,IAAI,eAAe,CAAC,OAAO,IAAI,4CAA4C,EAAE,eAAe,EAAE;QACpG,MAAM,EAAE,gCAAgC;QACxC,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;KACxB,CAAC,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,SAAS,mBAAmB,CAAC,QAAgB;IAC5C,OAAO,IAAI,eAAe,CAAC,+CAA+C,QAAQ,2CAA2C,EAAE,aAAa,EAAE;QAC7I,MAAM,EAAE,8BAA8B;QACtC,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE;KAC5C,CAAC,CAAC;AACJ,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,IAAoC,EAAE,KAAa;IACpF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI;YAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,IAAyC;IAC/D,IAAI,IAAI,YAAY,WAAW;QAAE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,IAAI,YAAY,IAAI;QAAE,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1E,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,qBAAqB;IAER;IACA;IACA;IAHlB,YACkB,EAAoC,EACpC,QAAgB,EAChB,IAAc;QAFd,OAAE,GAAF,EAAE,CAAkC;QACpC,aAAQ,GAAR,QAAQ,CAAQ;QAChB,SAAI,GAAJ,IAAI,CAAU;IAC7B,CAAC;IAEJ,4FAA4F;IACpF,KAAK,CAAC,OAAO,CAAC,IAAsB,EAAE,KAAa;QAC1D,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,KAAK,EAAE,IAAI,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QACjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED,wFAAwF;IAChF,KAAK,CAAC,aAAa,CAAC,EAAqB,EAAE,IAAY;QAC9D,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAAE,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,IAAyC,EAAE,IAA8B;QAC/F,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,0BAA0B,EAAE,CAAC;IACtG,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACpB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,YAAY,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjF,OAAO,IAAI,cAAc,CAAa;YACrC,KAAK,CAAC,UAAU;gBACf,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBAC1B,UAAU,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACrB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,SAAS;YAAE,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACvB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,8DAA8D;QAC9D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO;QACrC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe,EAAE,IAA+B;QAC1D,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,MAAM,IAAI,GAAgE,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAE,QAAkB,EAAiB,EAAE;YACrE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,SAAS,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3C,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAChC,MAAM,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBACjC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC/B,IAAI,SAAS,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC;wBAAE,SAAS;oBACjF,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACtC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACF,CAAC;QACF,CAAC,CAAC;QACF,IAAI,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAC9E,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/C,MAAM,MAAM,GAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,OAAO,IAAI,IAAI;YAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;QAC9C,OAAO,MAAM,CAAC;IACf,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACpB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,2EAA2E;QAC3E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;CACD;AAED,MAAM,OAAO,8BAA8B;IACjC,EAAE,GAAG,UAAU,CAAC;IAChB,YAAY,GAA+B;QACnD,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACvC,kBAAkB,EAAE,KAAK;QACzB,oBAAoB,EAAE,KAAK;QAC3B,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,IAAI;QAChB,oBAAoB,EAAE,KAAK;QAC3B,iBAAiB,EAAE,KAAK;QACxB,sBAAsB,EAAE,KAAK;QAC7B,mBAAmB,EAAE,KAAK;QAC1B,kBAAkB,EAAE,KAAK;KACzB,CAAC;IAEe,OAAO,CAAa;IAC7B,OAAO,GAA6B,IAAI,CAAC;IAEjD,YAAY,WAAqC,EAAE,OAAoB;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAED,wHAAwH;IAChH,KAAK,CAAC,UAAU;QACvB,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC;QACtC,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,gDAAgD,CAAC,CAAC;QACpG,IAAI,CAAC,OAAO,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,OAAgC;QACzC,yEAAyE;IAC1E,CAAC;IAED,YAAY;QACX,OAAO,IAAI,CAAC;IACb,CAAC;IAED,WAAW,CAAS,SAAkB,EAAE,MAAe;QACtD,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,EAAE,QAAQ,EAAE,GAAG,iBAAiB,CAAC,uBAAuB,EAAE,MAAM,EAAE;YACvE,OAAO,EAAE,+FAA+F;YACxG,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,uCAAuC;SAC/C,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,IAAI,qBAAqB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,oEAAoE;IAEpE,aAAa,CAAI,UAAkB,EAAE,OAAqB;QACzD,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,aAAa,CACZ,UAAkB,EAClB,UAA2B,EAC3B,YAA+B;QAE/B,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,UAAU,CAAI,UAAkB,EAAE,OAAqB,EAAE,QAA4B;QACpF,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAc,WAAoC;QACvD,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;IAED,qBAAqB;QACpB,MAAM,IAAI,eAAe,CAAC,gEAAgE,EAAE,aAAa,EAAE;YAC1G,MAAM,EAAE,yCAAyC;YACjD,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE;SAClC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU;QACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,WAAW;QAChB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;CACD;AAED,eAAe,2BAA2B,CAAC;IAC1C,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,iBAAiB;IACvB,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;IACtC,sFAAsF;IACtF,cAAc,EAAE,8BAA8B;CAC9C,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @vibesdotdev/storage/adapters/filesystem
+ *
+ * `storage.filesystem`: object storage under an explicit owned base path on the
+ * runtime's filesystem service.
+ */
+export { default as storageAdapterFilesystemPlugin } from './storage-adapter-filesystem.plugin.ts';
+export { default as filesystemAdapterDescriptor } from './filesystem.adapter.descriptor.ts';
+export { FilesystemObjectStorageAdapter, objectKeySegments } from './filesystem.adapter.impl.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/adapters/filesystem/index.js

@@ -0,0 +1,10 @@
+/**
+ * @vibesdotdev/storage/adapters/filesystem
+ *
+ * `storage.filesystem`: object storage under an explicit owned base path on the
+ * runtime's filesystem service.
+ */
+export { default as storageAdapterFilesystemPlugin } from "./storage-adapter-filesystem.plugin.js";
+export { default as filesystemAdapterDescriptor } from "./filesystem.adapter.descriptor.js";
+export { FilesystemObjectStorageAdapter, objectKeySegments } from "./filesystem.adapter.impl.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Storage Adapter Filesystem Plugin
+ *
+ * Registers `storage.filesystem` — the `object` protocol over the runtime's
+ * filesystem service, rooted at an explicit owned `basePath` per call. It
+ * depends on the `filesystem` plugin, whose `filesystem/adapter` (e.g. the Bun
+ * adapter) does the I/O. The implementation loads lazily.
+ */
+export declare const storageAdapterFilesystemPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default storageAdapterFilesystemPlugin;
+//# sourceMappingURL=storage-adapter-filesystem.plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-filesystem.plugin.d.ts","sourceRoot":"","sources":["../../../src/adapters/filesystem/storage-adapter-filesystem.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,eAAO,MAAM,8BAA8B,6CAYzC,CAAC;AAEH,eAAe,8BAA8B,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Storage Adapter Filesystem Plugin
+ *
+ * Registers `storage.filesystem` — the `object` protocol over the runtime's
+ * filesystem service, rooted at an explicit owned `basePath` per call. It
+ * depends on the `filesystem` plugin, whose `filesystem/adapter` (e.g. the Bun
+ * adapter) does the I/O. The implementation loads lazily.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel/factory';
+import filesystemAdapterDescriptor from "./filesystem.adapter.descriptor.js";
+export const storageAdapterFilesystemPlugin = createRuntimePlugin({
+    id: '@vibesdotdev/storage/adapters/filesystem',
+    name: 'Storage Adapter Filesystem',
+    description: "Key-addressed object storage under an explicit base path on the runtime's filesystem service.",
+    dependencies: ['storage', 'filesystem'],
+    descriptors: [filesystemAdapterDescriptor],
+    loaders: [
+        loader(filesystemAdapterDescriptor.id, { kind: 'storage/adapter', scope: { hardware: ['consumer'] } }, async () => {
+            const mod = await import("./filesystem.adapter.impl.js");
+            return mod.default;
+        })
+    ]
+});
+export default storageAdapterFilesystemPlugin;
+//# sourceMappingURL=storage-adapter-filesystem.plugin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter-filesystem.plugin.js","sourceRoot":"","sources":["../../../src/adapters/filesystem/storage-adapter-filesystem.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,2BAA2B,MAAM,oCAAoC,CAAC;AAE7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,mBAAmB,CAAC;IACjE,EAAE,EAAE,0CAA0C;IAC9C,IAAI,EAAE,4BAA4B;IAClC,WAAW,EAAE,+FAA+F;IAC5G,YAAY,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC;IACvC,WAAW,EAAE,CAAC,2BAA2B,CAAC;IAC1C,OAAO,EAAE;QACR,MAAM,CAAC,2BAA2B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,IAAI,EAAE;YACjH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YACzD,OAAO,GAAG,CAAC,OAAO,CAAC;QACpB,CAAC,CAAC;KACF;CACD,CAAC,CAAC;AAEH,eAAe,8BAA8B,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Fixture Storage Adapter Descriptor
+ *
+ * A deterministic, browse-capable storage adapter for local dev + tests. Returns
+ * canned sites/folders/files so the generic storage-browse path (and consumers
+ * like the StorageBrowser surface + casework /files + create-job-from-folder)
+ * can be exercised end-to-end with NO external credentials (no SharePoint /
+ * Microsoft account). Real adapters (e.g. `sharepoint`) are the production path;
+ * this stands in for them under a dev/test profile via the same `browse` contract.
+ */
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+declare const descriptor: StorageAdapterDescriptor;
+export default descriptor;
+//# sourceMappingURL=fixture.adapter.descriptor.d.ts.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * Fixture Storage Adapter Descriptor
+ *
+ * A deterministic, browse-capable storage adapter for local dev + tests. Returns
+ * canned sites/folders/files so the generic storage-browse path (and consumers
+ * like the StorageBrowser surface + casework /files + create-job-from-folder)
+ * can be exercised end-to-end with NO external credentials (no SharePoint /
+ * Microsoft account). Real adapters (e.g. `sharepoint`) are the production path;
+ * this stands in for them under a dev/test profile via the same `browse` contract.
+ */
+const descriptor = {
+    id: 'storage.fixture',
+    kind: 'storage/adapter',
+    name: 'Fixture Storage',
+    description: 'Deterministic browse-capable storage for local dev + tests. Canned sites/folders/files; no external credentials.',
+    tags: ['storage', 'fixture', 'testing', 'browse'],
+    hardware: ['consumer', 'cloud'],
+    enabled: true,
+    protocols: ['document'],
+    basePathSemantics: 'unused',
+    capabilities: ['list', 'read', 'browse'],
+    requiresPairSchema: false,
+    supportsTransactions: false,
+    supportsTTL: false,
+    supportsSearch: false,
+    supportsFTS: false,
+    persistent: false,
+    supportsSubscription: false,
+    supportsHierarchy: true,
+    supportsComputedFields: false,
+    supportsSideEffects: false,
+    supportsRawQueries: false
+};
+export default descriptor;
+//# sourceMappingURL=fixture.adapter.descriptor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.adapter.descriptor.js","sourceRoot":"","sources":["../../../src/adapters/fixture/fixture.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,UAAU,GAA6B;IAC5C,EAAE,EAAE,iBAAiB;IACrB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACV,kHAAkH;IACnH,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;IACjD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,IAAI;IAEb,SAAS,EAAE,CAAC,UAAU,CAAC;IACvB,iBAAiB,EAAE,QAAQ;IAC3B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;IACxC,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,KAAK;IACrB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,KAAK;IACjB,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;CACzB,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * 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 type { z } from 'zod/v4';
+import type { StorageAdapterInterface, StorageAdapterCapabilities, StorageDocumentStoreInterface, StorageHealthStatus, RepositoryOptions } from '@vibesdotdev/storage/interfaces';
+import type { StorageAdapterDescriptor, StorageDrive, StorageEntry } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+import type { StorageRecordDescriptor } from '@vibesdotdev/storage/schemas/record';
+export type FixtureAdapterConfig = Record<string, never>;
+/**
+ * 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 declare class FixtureStorageAdapter implements StorageAdapterInterface<FixtureAdapterConfig> {
+    readonly id: string;
+    readonly capabilities: StorageAdapterCapabilities;
+    constructor(descriptor: StorageAdapterDescriptor);
+    configure(_config: FixtureAdapterConfig): void;
+    isConfigured(): boolean;
+    listDrives(): Promise<StorageDrive[]>;
+    list(driveId: string, path?: string): Promise<StorageEntry[]>;
+    documentStore<T>(_namespace: string, _schema: z.ZodType<T>): StorageDocumentStoreInterface<T>;
+    keyValueStore<TKey, TValue>(_namespace: string, _keySchema: z.ZodType<TKey>, _valueSchema: z.ZodType<TValue>): never;
+    repository<T>(_tableName: string, _schema: z.ZodType<T>, _options?: RepositoryOptions): never;
+    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 FixtureStorageAdapter>;
+export default _default;
+//# sourceMappingURL=fixture.adapter.impl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.adapter.impl.d.ts","sourceRoot":"","sources":["../../../src/adapters/fixture/fixture.adapter.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACX,uBAAuB,EACvB,0BAA0B,EAC1B,6BAA6B,EAC7B,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACX,wBAAwB,EACxB,YAAY,EACZ,YAAY,EACZ,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AA2EzD;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,uBAAuB,CAAC,oBAAoB,CAAC;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,0BAA0B,CAAC;gBAEtC,UAAU,EAAE,wBAAwB;IAkBhD,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAE9C,YAAY,IAAI,OAAO;IAMjB,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAIrC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBnE,aAAa,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,6BAA6B,CAAC,CAAC,CAAC;IAI7F,aAAa,CAAC,IAAI,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAC7B,KAAK;IAIR,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,KAAK;IAI7F,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"}