@vibesdotdev/storage 0.0.1

package/dist/interfaces/record/interface.js

@@ -0,0 +1,49 @@
+/**
+ * Storage Record Interface
+ *
+ * Defines the interface for CRUD operations on a single table.
+ * This is what gets resolved when you query for a storage/record descriptor.
+ *
+ * @example
+ * ```typescript
+ * const todos = await runtime
+ *   .query('storage/record')
+ *   .withId('session.todos')
+ *   .resolve();
+ *
+ * // Create
+ * const todo = await todos.create({
+ *   sessionId: 'session-123',
+ *   title: 'Implement storage',
+ *   status: 'in_progress'
+ * });
+ *
+ * // Get
+ * const todo = await todos.get('todo-123');
+ *
+ * // List with filters
+ * const todos = await todos.list({
+ *   where: { sessionId: 'session-123', status: 'pending' },
+ *   include: { session: true },
+ *   orderBy: { createdAt: 'desc' },
+ *   limit: 50
+ * });
+ *
+ * // Full-text search
+ * const results = await todos.search('implement storage', {
+ *   where: { sessionId: 'session-123' },
+ *   highlight: true
+ * });
+ *
+ * // Get todo tree
+ * const tree = await todos.getTree({ where: { sessionId: 'session-123' } });
+ *
+ * // Update
+ * await todos.update('todo-123', { status: 'completed' });
+ *
+ * // Delete
+ * await todos.delete('todo-123');
+ * ```
+ */
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/interfaces/record/interface.js.map

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

package/dist/interfaces/repository.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Storage Repository Interface
+ *
+ * Repository pattern for structured record storage with queries.
+ * Supports CRUD operations, filtering, sorting, pagination.
+ */
+import type { z } from 'zod/v4';
+/**
+ * Repository for structured record storage
+ *
+ * @example
+ * ```ts
+ * const repo = adapter.repository('providers', providerSchema);
+ * const provider = await repo.create({ name: 'OpenAI', ... });
+ * const all = await repo.list({ limit: 10 });
+ * const found = await repo.find({ where: { type: 'cloud' } });
+ * ```
+ */
+export interface StorageRepositoryInterface<T> {
+    /**
+     * Create a new record
+     * @param data The record data (id auto-generated if not provided)
+     * @returns The created record with id
+     */
+    create(data: RepositoryCreateInput<T>): Promise<T>;
+    /**
+     * Create multiple records
+     * @param data Array of record data
+     * @returns The created records
+     */
+    createMany(data: RepositoryCreateInput<T>[]): Promise<T[]>;
+    /**
+     * Get a record by id
+     * @param id The record id
+     * @returns The record or null if not found
+     */
+    get(id: string): Promise<T | null>;
+    /**
+     * Get a record by id or throw
+     * @param id The record id
+     * @throws Error if not found
+     */
+    getOrThrow(id: string): Promise<T>;
+    /**
+     * Get multiple records by ids
+     * @param ids The record ids
+     * @returns Map of id to record (missing ids omitted)
+     */
+    getMany(ids: string[]): Promise<Map<string, T>>;
+    /**
+     * List records with pagination
+     * @param options List options
+     */
+    list(options?: RepositoryListOptions<T>): Promise<RepositoryPage<T>>;
+    /**
+     * Find records matching a query
+     * @param query The query
+     * @param options Additional options
+     */
+    find(query: RepositoryQuery<T>, options?: RepositoryFindOptions<T>): Promise<T[]>;
+    /**
+     * Find first record matching a query
+     * @param query The query
+     */
+    findOne(query: RepositoryQuery<T>): Promise<T | null>;
+    /**
+     * Count records matching a query
+     * @param query The query (optional, counts all if omitted)
+     */
+    count(query?: RepositoryQuery<T>): Promise<number>;
+    /**
+     * Check if a record exists
+     * @param id The record id
+     */
+    exists(id: string): Promise<boolean>;
+    /**
+     * Check if any record matches a query
+     * @param query The query
+     */
+    existsWhere(query: RepositoryQuery<T>): Promise<boolean>;
+    /**
+     * Update a record
+     * @param id The record id
+     * @param data The fields to update
+     * @returns The updated record or null if not found
+     */
+    update(id: string, data: RepositoryUpdateInput<T>): Promise<T | null>;
+    /**
+     * Update a record or throw
+     * @param id The record id
+     * @param data The fields to update
+     * @throws Error if not found
+     */
+    updateOrThrow(id: string, data: RepositoryUpdateInput<T>): Promise<T>;
+    /**
+     * Update multiple records matching a query
+     * @param query The query to match
+     * @param data The fields to update
+     * @returns Number of records updated
+     */
+    updateMany(query: RepositoryQuery<T>, data: RepositoryUpdateInput<T>): Promise<number>;
+    /**
+     * Upsert a record (create or update)
+     * @param data The record data
+     * @param uniqueKey The field to match for update (defaults to 'id')
+     * @returns The upserted record
+     */
+    upsert(data: RepositoryCreateInput<T>, uniqueKey?: keyof T): Promise<T>;
+    /**
+     * Delete a record by id
+     * @param id The record id
+     * @returns true if deleted, false if not found
+     */
+    delete(id: string): Promise<boolean>;
+    /**
+     * Delete multiple records by ids
+     * @param ids The record ids
+     * @returns Number of records deleted
+     */
+    deleteMany(ids: string[]): Promise<number>;
+    /**
+     * Delete records matching a query
+     * @param query The query
+     * @returns Number of records deleted
+     */
+    deleteWhere(query: RepositoryQuery<T>): Promise<number>;
+    /**
+     * Get repository metadata
+     */
+    meta(): RepositoryMeta<T>;
+}
+/**
+ * Input for creating a record
+ * All fields except auto-generated ones (id, createdAt, updatedAt)
+ */
+export type RepositoryCreateInput<T> = Omit<T, 'id' | 'createdAt' | 'updatedAt'> & {
+    id?: string;
+};
+/**
+ * Input for updating a record
+ * Partial fields (id cannot be updated)
+ */
+export type RepositoryUpdateInput<T> = Partial<Omit<T, 'id' | 'createdAt' | 'updatedAt'>>;
+/**
+ * Query for finding records
+ */
+export interface RepositoryQuery<T> {
+    /** Field conditions (AND) */
+    where?: Partial<Record<keyof T, QueryCondition<T[keyof T]>>>;
+    /** OR conditions */
+    or?: RepositoryQuery<T>[];
+    /** AND conditions */
+    and?: RepositoryQuery<T>[];
+}
+/**
+ * Condition for a field
+ */
+export type QueryCondition<TField> = TField | {
+    eq: TField;
+} | {
+    ne: TField;
+} | {
+    gt: TField;
+} | {
+    gte: TField;
+} | {
+    lt: TField;
+} | {
+    lte: TField;
+} | {
+    in: TField[];
+} | {
+    notIn: TField[];
+} | {
+    like: string;
+} | {
+    ilike: string;
+} | {
+    isNull: boolean;
+} | {
+    contains: string;
+} | {
+    startsWith: string;
+} | {
+    endsWith: string;
+};
+/**
+ * Options for list operations
+ */
+export interface RepositoryListOptions<T> {
+    /** Maximum records to return */
+    limit?: number;
+    /** Records to skip */
+    offset?: number;
+    /** Cursor for pagination (alternative to offset) */
+    cursor?: string;
+    /** Sort order */
+    orderBy?: RepositoryOrderBy<T>;
+}
+/**
+ * Options for find operations
+ */
+export interface RepositoryFindOptions<T> extends RepositoryListOptions<T> {
+    /** Fields to select (default: all) */
+    select?: (keyof T)[];
+}
+/**
+ * Sort specification
+ */
+export type RepositoryOrderBy<T> = keyof T | {
+    field: keyof T;
+    direction: 'asc' | 'desc';
+} | Array<keyof T | {
+    field: keyof T;
+    direction: 'asc' | 'desc';
+}>;
+/**
+ * Paginated result
+ */
+export interface RepositoryPage<T> {
+    /** Records in this page */
+    data: T[];
+    /** Total count (if available) */
+    total?: number;
+    /** Cursor for next page (if using cursor pagination) */
+    nextCursor?: string;
+    /** Whether more records exist */
+    hasMore: boolean;
+}
+/**
+ * Repository metadata
+ */
+export interface RepositoryMeta<T> {
+    /** Table/collection name */
+    tableName: string;
+    /** Zod schema */
+    schema: z.ZodType<T>;
+    /** Primary key field */
+    primaryKey: string;
+    /** Auto-generated fields */
+    autoFields: {
+        id: boolean;
+        createdAt: boolean;
+        updatedAt: boolean;
+    };
+}
+/**
+ * Factory type for creating repositories
+ */
+export type RepositoryFactory<T> = (tableName: string, schema: z.ZodType<T>, options?: RepositoryOptions) => StorageRepositoryInterface<T>;
+/**
+ * Options for repository creation
+ */
+export interface RepositoryOptions {
+    /** Custom primary key field (default: 'id') */
+    primaryKey?: string;
+    /** Whether to auto-generate id (default: true) */
+    autoId?: boolean;
+    /** Whether to auto-manage createdAt/updatedAt (default: true) */
+    autoTimestamps?: boolean;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/interfaces/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/interfaces/repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,0BAA0B,CAAC,CAAC;IAG5C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnD;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAI3D;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnC;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhD;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAErE;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAElF;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEtD;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnD;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtE;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEvF;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAIxE;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAErC;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAIxD;;OAEG;IACH,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;CAC1B;AAID;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG;IAClF,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC;AAI1F;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,oBAAoB;IACpB,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1B,qBAAqB;IACrB,GAAG,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,MAAM,IAC9B,MAAM,GACN;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACd;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GACf;IAAE,EAAE,EAAE,MAAM,EAAE,CAAA;CAAE,GAChB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAIxB;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACvC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,OAAO,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,qBAAqB,CAAC,CAAC,CAAC;IACzE,sCAAsC;IACtC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAC5B,MAAM,CAAC,GACP;IAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,GAC7C,KAAK,CAAC,MAAM,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAAE,CAAC,CAAC;AAIlE;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,2BAA2B;IAC3B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAChC,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB;IACjB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,EAAE;QACX,EAAE,EAAE,OAAO,CAAC;QACZ,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;KACnB,CAAC;CACF;AAID;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,CAAC,EAAE,iBAAiB,KACvB,0BAA0B,CAAC,CAAC,CAAC,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/interfaces/repository.js

@@ -0,0 +1,8 @@
+/**
+ * Storage Repository Interface
+ *
+ * Repository pattern for structured record storage with queries.
+ * Supports CRUD operations, filtering, sorting, pagination.
+ */
+export {};
+//# sourceMappingURL=repository.js.map

package/dist/interfaces/repository.js.map

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

package/dist/interfaces/schema/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Storage Schema Interface Exports
+ *
+ * Exports all types and interfaces for storage/schema operations.
+ */
+export { type StorageTableInterface } from './table-interface';
+export { type StorageSchemaInterface, type MigrationStatus, type MigrationOptions, type MigrationResult, type BackupOptions, type BackupResult, type RestoreOptions, type RestoreResult, type SyncStatus, type SyncOptions, type SyncResult, type CrossTableQueryOptions, type SchemaStatistics, type SchemaHealthStatus } from './schema-interface';
+//# sourceMappingURL=index.d.ts.map

package/dist/interfaces/schema/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAEN,KAAK,sBAAsB,EAG3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAGpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAGlB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,UAAU,EAGf,KAAK,sBAAsB,EAG3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,MAAM,oBAAoB,CAAC"}

package/dist/interfaces/schema/index.js

@@ -0,0 +1,10 @@
+/**
+ * Storage Schema Interface Exports
+ *
+ * Exports all types and interfaces for storage/schema operations.
+ */
+// Table interface
+export {} from './table-interface.js';
+// Schema interface and types
+export {} from './schema-interface.js';
+//# sourceMappingURL=index.js.map

package/dist/interfaces/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/schema/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAA8B,MAAM,mBAAmB,CAAC;AAE/D,6BAA6B;AAC7B,OAAO,EA0BN,MAAM,oBAAoB,CAAC"}