@vibesdotdev/storage 0.0.1

package/dist/interfaces/schema/table-interface.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Storage Table Interface
+ *
+ * Defines the interface for CRUD operations on a single table within a schema.
+ * This is what gets returned when you access a table from a StorageSchema.
+ *
+ * @example
+ * ```typescript
+ * const schema = await runtime
+ *   .query('storage/schema')
+ *   .withId('session')
+ *   .resolve();
+ *
+ * const todosTable = schema.table('todos');
+ *
+ * // Create
+ * const todo = await todosTable.create({
+ *   sessionId: 'session-123',
+ *   title: 'Implement storage',
+ *   status: 'in_progress'
+ * });
+ *
+ * // List with relations to other tables in the schema
+ * const todos = await todosTable.list({
+ *   where: { sessionId: 'session-123' },
+ *   include: { session: true, parent: true }
+ * });
+ * ```
+ */
+import type { z } from 'zod/v4';
+import type { StorageRelation } from '../../schemas/record';
+import type { WhereFilter, QueryOptions, QueryResult, CreateInput, CreateManyOptions, UpdateInput, UpdateOptions, UpdateResult, DeleteOptions, DeleteResult, AggregationOptions, AggregationResult, StreamOptions } from '../record';
+/**
+ * Storage Table Interface
+ *
+ * Provides CRUD operations on a single table within a schema.
+ * Similar to StorageRecordInterface but scoped to a schema context.
+ */
+export interface StorageTableInterface<T = unknown, R extends Record<string, StorageRelation> = Record<string, StorageRelation>> {
+    /** Table name */
+    readonly tableName: string;
+    /** Primary key field */
+    readonly primaryKey: string;
+    /** Zod schema for validation */
+    readonly schema: z.ZodType<T>;
+    /** Available relations to other tables in the schema */
+    readonly relations: R;
+    /**
+     * Create a new record
+     *
+     * @param data - Record data
+     * @returns Created record
+     */
+    create(data: CreateInput<T>): Promise<T>;
+    /**
+     * Create multiple records
+     *
+     * @param data - Array of record data
+     * @param options - Create many options
+     * @returns Created records
+     */
+    createMany(data: CreateInput<T>[], options?: CreateManyOptions): Promise<T[]>;
+    /**
+     * Get a single record by ID
+     *
+     * @param id - Record ID
+     * @param options - Query options (include relations, select fields)
+     * @returns Record or null if not found
+     */
+    get(id: string, options?: Pick<QueryOptions<T, string & keyof R>, 'include' | 'select'>): Promise<T | null>;
+    /**
+     * Get a single record or throw if not found
+     *
+     * @param id - Record ID
+     * @param options - Query options
+     * @returns Record
+     * @throws Error if record not found
+     */
+    getOrThrow(id: string, options?: Pick<QueryOptions<T, string & keyof R>, 'include' | 'select'>): Promise<T>;
+    /**
+     * Get many records by IDs
+     *
+     * @param ids - Record IDs
+     * @param options - Query options
+     * @returns Records (may be fewer than requested if some not found)
+     */
+    getMany(ids: string[], options?: Pick<QueryOptions<T, string & keyof R>, 'include' | 'select'>): Promise<T[]>;
+    /**
+     * List records with filtering, pagination, and relations
+     *
+     * @param options - Query options
+     * @returns Query result with items and pagination metadata
+     */
+    list(options?: QueryOptions<T, string & keyof R>): Promise<QueryResult<T>>;
+    /**
+     * Find first record matching conditions
+     *
+     * @param options - Query options
+     * @returns First matching record or null
+     */
+    findFirst(options?: QueryOptions<T, string & keyof R>): Promise<T | null>;
+    /**
+     * Find first record or throw if not found
+     *
+     * @param options - Query options
+     * @returns First matching record
+     * @throws Error if no record found
+     */
+    findFirstOrThrow(options?: QueryOptions<T, string & keyof R>): Promise<T>;
+    /**
+     * Check if record exists
+     *
+     * @param id - Record ID
+     * @returns True if record exists
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * Count records matching conditions
+     *
+     * @param where - Filter conditions
+     * @returns Number of matching records
+     */
+    count(where?: WhereFilter<T>): Promise<number>;
+    /**
+     * Update a record by ID
+     *
+     * @param id - Record ID
+     * @param data - Update data
+     * @param options - Update options
+     * @returns Updated record
+     * @throws Error if record not found
+     */
+    update(id: string, data: UpdateInput<T>, options?: UpdateOptions): Promise<T>;
+    /**
+     * Update many records matching conditions
+     *
+     * @param where - Filter conditions
+     * @param data - Update data
+     * @param options - Update options
+     * @returns Update result with count
+     */
+    updateMany(where: WhereFilter<T>, data: UpdateInput<T>, options?: UpdateOptions): Promise<UpdateResult>;
+    /**
+     * Update or create a record
+     *
+     * @param id - Record ID
+     * @param create - Data to use if creating
+     * @param update - Data to use if updating
+     * @returns Created or updated record
+     */
+    upsert(id: string, create: CreateInput<T>, update: UpdateInput<T>): Promise<T>;
+    /**
+     * Delete a record by ID
+     *
+     * @param id - Record ID
+     * @param options - Delete options
+     * @returns Delete result
+     */
+    delete(id: string, options?: DeleteOptions): Promise<DeleteResult>;
+    /**
+     * Delete many records matching conditions
+     *
+     * @param where - Filter conditions
+     * @param options - Delete options
+     * @returns Delete result with count
+     */
+    deleteMany(where: WhereFilter<T>, options?: DeleteOptions): Promise<DeleteResult>;
+    /**
+     * Restore a soft-deleted record
+     *
+     * @param id - Record ID
+     * @returns Restored record
+     * @throws Error if record not found or not soft-deleted
+     */
+    restore(id: string): Promise<T>;
+    /**
+     * Count records
+     *
+     * @param options - Aggregation options
+     * @returns Aggregation results
+     */
+    aggregate(options: AggregationOptions<T> & {
+        function: 'count';
+    }): Promise<AggregationResult[]>;
+    /**
+     * Sum field values
+     *
+     * @param options - Aggregation options
+     * @returns Aggregation results
+     */
+    aggregate(options: AggregationOptions<T> & {
+        function: 'sum';
+        field: keyof T;
+    }): Promise<AggregationResult[]>;
+    /**
+     * Average field values
+     *
+     * @param options - Aggregation options
+     * @returns Aggregation results
+     */
+    aggregate(options: AggregationOptions<T> & {
+        function: 'avg';
+        field: keyof T;
+    }): Promise<AggregationResult[]>;
+    /**
+     * Get minimum field value
+     *
+     * @param options - Aggregation options
+     * @returns Aggregation results
+     */
+    aggregate(options: AggregationOptions<T> & {
+        function: 'min';
+        field: keyof T;
+    }): Promise<AggregationResult[]>;
+    /**
+     * Get maximum field value
+     *
+     * @param options - Aggregation options
+     * @returns Aggregation results
+     */
+    aggregate(options: AggregationOptions<T> & {
+        function: 'max';
+        field: keyof T;
+    }): Promise<AggregationResult[]>;
+    /**
+     * Stream records as async iterable
+     *
+     * @param options - Stream options
+     * @returns Async iterable of records
+     */
+    stream(options?: StreamOptions<T>): AsyncIterable<T>;
+    /**
+     * Validate record data against schema
+     *
+     * @param data - Record data
+     * @returns Validation result
+     */
+    validate(data: unknown): Promise<{
+        success: boolean;
+        data?: T;
+        errors?: z.ZodError;
+    }>;
+    /**
+     * Get database adapter being used
+     *
+     * @returns Adapter ID
+     */
+    getAdapterId(): string;
+}
+//# sourceMappingURL=table-interface.d.ts.map

package/dist/interfaces/schema/table-interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schema/table-interface.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/schema/table-interface.js

@@ -0,0 +1,31 @@
+/**
+ * Storage Table Interface
+ *
+ * Defines the interface for CRUD operations on a single table within a schema.
+ * This is what gets returned when you access a table from a StorageSchema.
+ *
+ * @example
+ * ```typescript
+ * const schema = await runtime
+ *   .query('storage/schema')
+ *   .withId('session')
+ *   .resolve();
+ *
+ * const todosTable = schema.table('todos');
+ *
+ * // Create
+ * const todo = await todosTable.create({
+ *   sessionId: 'session-123',
+ *   title: 'Implement storage',
+ *   status: 'in_progress'
+ * });
+ *
+ * // List with relations to other tables in the schema
+ * const todos = await todosTable.list({
+ *   where: { sessionId: 'session-123' },
+ *   include: { session: true, parent: true }
+ * });
+ * ```
+ */
+export {};
+//# sourceMappingURL=table-interface.js.map

package/dist/interfaces/schema/table-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-interface.js","sourceRoot":"","sources":["../../../src/interfaces/schema/table-interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG"}

package/dist/interfaces/storage-consumer-fs.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Storage Consumer File System Abstraction
+ *
+ * Consumer-scoped: provides access to host fs, crypto, and path primitives.
+ * Injected at runtime to avoid universal core importing Node.js built-ins.
+ *
+ * This enables `cli/context.consumer.ts` to operate in consumer hardware scope
+ * without polluting the universal core with Node.js imports.
+ *
+ * Usage:
+ * ```ts
+ * import { getConsumerFs } from './storage-consumer-fs';
+ *
+ * const fs = getConsumerFs();
+ * const data = await fs.readFile('/path/to/file', 'utf8');
+ * ```
+ */
+export interface ConsumerFileSystem {
+    existsSync(path: string): boolean;
+    mkdirSync(path: string, options?: {
+        recursive: boolean;
+    }): void;
+    watch(dir: string, listener: (eventType: string, filename: string | Buffer | null) => void): {
+        close(): void;
+    } | null;
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    writeFile(path: string, content: string | Uint8Array, options?: BufferEncoding | {
+        encoding?: BufferEncoding;
+        mode?: number;
+        flag?: string;
+    }): Promise<void>;
+    rename(oldPath: string, newPath: string): Promise<void>;
+    dirname(path: string): string;
+    basename(path: string, ext?: string): string;
+    join(...paths: string[]): string;
+    resolve(...paths: string[]): string;
+    randomUUID(): string;
+}
+export declare function getConsumerFs(): Promise<ConsumerFileSystem>;
+//# sourceMappingURL=storage-consumer-fs.d.ts.map

package/dist/interfaces/storage-consumer-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-consumer-fs.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage-consumer-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,kBAAkB;IAClC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAChE,KAAK,CACJ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,GACrE;QAAE,KAAK,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,SAAS,CACR,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACpF,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,UAAU,IAAI,MAAM,CAAC;CACrB;AAID,wBAAsB,aAAa,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAwBjE"}

package/dist/interfaces/storage-consumer-fs.js

@@ -0,0 +1,42 @@
+/**
+ * Storage Consumer File System Abstraction
+ *
+ * Consumer-scoped: provides access to host fs, crypto, and path primitives.
+ * Injected at runtime to avoid universal core importing Node.js built-ins.
+ *
+ * This enables `cli/context.consumer.ts` to operate in consumer hardware scope
+ * without polluting the universal core with Node.js imports.
+ *
+ * Usage:
+ * ```ts
+ * import { getConsumerFs } from './storage-consumer-fs.js';
+ *
+ * const fs = getConsumerFs();
+ * const data = await fs.readFile('/path/to/file', 'utf8');
+ * ```
+ */
+let _consumerFs = null;
+export async function getConsumerFs() {
+    if (_consumerFs)
+        return _consumerFs;
+    const [fs, crypto, path] = await Promise.all([
+        import('node:fs'),
+        import('node:crypto'),
+        import('node:path')
+    ]);
+    _consumerFs = {
+        existsSync: fs.existsSync,
+        mkdirSync: fs.mkdirSync,
+        watch: fs.watch.bind(fs),
+        readFile: (path, encoding) => fs.promises.readFile(path, encoding),
+        writeFile: (path, content, options) => fs.promises.writeFile(path, content, options),
+        rename: fs.promises.rename,
+        dirname: path.dirname,
+        basename: path.basename,
+        join: path.join,
+        resolve: path.resolve,
+        randomUUID: crypto.randomUUID
+    };
+    return _consumerFs;
+}
+//# sourceMappingURL=storage-consumer-fs.js.map

package/dist/interfaces/storage-consumer-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-consumer-fs.js","sourceRoot":"","sources":["../../src/interfaces/storage-consumer-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuBH,IAAI,WAAW,GAA8B,IAAI,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,aAAa;IAClC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC;QACjB,MAAM,CAAC,aAAa,CAAC;QACrB,MAAM,CAAC,WAAW,CAAC;KACnB,CAAC,CAAC;IAEH,WAAW,GAAG;QACb,UAAU,EAAE,EAAE,CAAC,UAAU;QACzB,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,QAAQ,EAAE,CAAC,IAAY,EAAE,QAAwB,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC1F,SAAS,EAAE,CAAC,IAAY,EAAE,OAA4B,EAAE,OAAsF,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;QAChM,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC7B,CAAC;IAEF,OAAO,WAAW,CAAC;AACpB,CAAC"}

package/dist/manifest/base.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Storage Manifest Base Class
+ *
+ * Base class for working with stored data. Modules can extend this
+ * for custom methods while getting load/save for free.
+ *
+ * Uses runtime query API to resolve the appropriate adapter.
+ */
+import type { z } from 'zod/v4';
+import type { KindContext } from '@vibesdotdev/runtime/schemas/kind';
+import type { StorageAdapterInterface } from '../interfaces/adapter';
+import type { StorageManifestDescriptor } from '../schemas/manifest-descriptor';
+import type { Unsubscribe } from '../interfaces/document-store';
+/**
+ * Base class for storage manifests.
+ *
+ * Provides document-style operations (load, save, exists, delete) using
+ * the runtime to resolve the appropriate adapter based on scope and configuration.
+ *
+ * Includes caching and subscription support for reactive updates.
+ *
+ * @template T - The type of data being stored
+ *
+ * @example
+ * ```ts
+ * // Runtime instantiation (via descriptor)
+ * // The runtime will instantiate this with the descriptor
+ *
+ * // Manual instantiation by ID
+ * const storage = StorageManifest.fromId<AIProvider[]>('ai.providers');
+ * const providers = await storage.load();
+ *
+ * // Extended class with custom methods
+ * class AIProvidersStorage extends StorageManifest<AIProvider[]> {
+ *   async getEnabled(): Promise<AIProvider[]> {
+ *     const all = await this.load() ?? [];
+ *     return all.filter(p => p.enabled);
+ *   }
+ * }
+ * ```
+ */
+export declare class StorageManifest<T> {
+    protected descriptor: StorageManifestDescriptor;
+    protected context: KindContext;
+    private adapterCache;
+    private pendingId;
+    private pendingContext;
+    private resolved;
+    private cachedData;
+    private cacheValid;
+    private subscribers;
+    private storeUnsubscribe;
+    private subscriptionStarted;
+    private getRuntime;
+    /**
+     * Create a storage manifest instance.
+     *
+     * @param descriptorOrId - Either the full descriptor (for runtime instantiation)
+     *                         or the manifest ID string (for manual instantiation)
+     * @param context - Runtime context (optional for manual instantiation, required for runtime)
+     */
+    constructor(descriptorOrId: StorageManifestDescriptor | string, context?: KindContext);
+    /**
+     * Resolve the descriptor from the runtime on first data access.
+     * No-op if already resolved or constructed with a direct descriptor.
+     */
+    private ensureResolved;
+    /**
+     * Create a storage manifest by looking up its ID.
+     * Convenience static method for manual instantiation.
+     */
+    static fromId<T>(manifestId: string): StorageManifest<T>;
+    /**
+     * Get the schema for this manifest.
+     */
+    get schema(): z.ZodType<T>;
+    /**
+     * Get the namespace for this manifest.
+     */
+    get namespace(): string;
+    /**
+     * Resolve the adapter for this manifest using runtime query API.
+     *
+     * Uses the manifest's allowed adapters list and current scope to
+     * select the best available adapter.
+     */
+    protected getAdapter(): Promise<StorageAdapterInterface>;
+    /**
+     * Get adapter configuration based on manifest scope.
+     * Override in subclasses for custom configuration.
+     */
+    protected getAdapterConfig(adapterId?: string): Record<string, unknown>;
+    private getCloudApiEndpoint;
+    private hasCloudEndpointRegistrar;
+    /**
+     * Get base path for storage based on scope.
+     * Uses descriptor's scopePaths if provided, otherwise defaults.
+     */
+    protected getBasePath(workspacePath?: string): string;
+    /**
+     * Invalidate the cache, forcing the next load to hit storage.
+     */
+    invalidateCache(): void;
+    /**
+     * Get cached data if available.
+     * @returns Cached data or undefined if not cached
+     */
+    getCachedData(): T | undefined;
+    /**
+     * Check if data is currently cached.
+     */
+    isCached(): boolean;
+    /**
+     * Load data from storage.
+     *
+     * @returns The stored data, or null if not found
+     */
+    load(): Promise<T | null>;
+    /**
+     * Save data to storage.
+     *
+     * @param data - The data to save
+     */
+    save(data: T): Promise<void>;
+    /**
+     * Trigger a non-blocking cloud push after save.
+     * Only fires if the manifest has cloud-api in allowedAdapters.
+     *
+     * Consumer modules are loaded via opaque dynamic import to prevent Vite
+     * from tracing them into the client bundle — they contain Node.js APIs
+     * and must only run server-side.
+     */
+    private triggerCloudSync;
+    /**
+     * Check if data exists in storage.
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Delete data from storage.
+     */
+    delete(): Promise<void>;
+    /**
+     * Load data or return default value.
+     *
+     * @param defaultValue - Value to return if no data exists
+     */
+    loadOrDefault(defaultValue: T): Promise<T>;
+    /**
+     * Update data using a transform function.
+     *
+     * @param transform - Function that receives current data and returns updated data
+     */
+    update(transform: (current: T | null) => T): Promise<void>;
+    /**
+     * Validate data against the manifest's schema.
+     */
+    validate(data: unknown): z.ZodSafeParseResult<T>;
+    /**
+     * Subscribe to changes for this manifest.
+     * Returns an unsubscribe function.
+     *
+     * @param callback - Function called when data changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: (data: T | null) => void): Unsubscribe;
+    /**
+     * Initialize subscription to storage adapter.
+     */
+    private initSubscription;
+    /**
+     * Start subscription with the given subscribe function.
+     */
+    private startSubscription;
+    /**
+     * Stop storage-level subscription.
+     */
+    private stopSubscription;
+    /**
+     * Notify all subscribers of a change.
+     */
+    protected notifySubscribers(data: T | null): void;
+    /**
+     * Get the number of active subscribers.
+     */
+    getSubscriberCount(): number;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/manifest/base.d.ts.map

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