@vibesdotdev/storage 0.0.1

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

@@ -0,0 +1,516 @@
+/**
+ * Storage Schema Interface
+ *
+ * Defines the interface for multi-table schemas with relations.
+ * This is what gets resolved when you query for a storage/schema descriptor.
+ *
+ * @example
+ * ```typescript
+ * const schema = await runtime
+ *   .query('storage/schema')
+ *   .withId('session')
+ *   .resolve();
+ *
+ * // Access individual tables
+ * const sessions = schema.table('sessions');
+ * const todos = schema.table('todos');
+ *
+ * // Cross-table operations
+ * const sessionWithTodos = await schema.getTransaction(async (tx) => {
+ *   const session = await sessions.create({ ... });
+ *   await todos.create({ sessionId: session.id, title: 'First todo' });
+ *   return session;
+ * });
+ *
+ * // Schema-level operations
+ * await schema.migrate();
+ * await schema.backup();
+ * ```
+ */
+import type { z } from 'zod/v4';
+import type { StorageRelation } from '../../schemas/record';
+import type { StorageTableDefinition } from '../../schemas/schema';
+import type { StorageTableInterface } from './table-interface';
+import type { TransactionFn, TransactionContext } from '../record';
+/**
+ * Migration status
+ */
+export interface MigrationStatus {
+    /** Current schema version */
+    currentVersion: number;
+    /** Latest available version */
+    latestVersion: number;
+    /** Whether migrations are pending */
+    pending: boolean;
+    /** List of applied migrations */
+    applied: Array<{
+        version: number;
+        name?: string;
+        appliedAt: Date;
+    }>;
+    /** List of pending migrations */
+    pendingMigrations: Array<{
+        version: number;
+        name?: string;
+    }>;
+}
+/**
+ * Migration options
+ */
+export interface MigrationOptions {
+    /** Target version (default: latest) */
+    targetVersion?: number;
+    /** Dry run (don't actually apply migrations) */
+    dryRun?: boolean;
+    /** Skip migrations that fail */
+    skipFailures?: boolean;
+    /** Force apply even if already applied */
+    force?: boolean;
+}
+/**
+ * Migration result
+ */
+export interface MigrationResult {
+    /** Whether migration was successful */
+    success: boolean;
+    /** Applied migrations */
+    applied: Array<{
+        version: number;
+        name?: string;
+        duration: number;
+    }>;
+    /** Failed migrations */
+    failed: Array<{
+        version: number;
+        name?: string;
+        error: Error;
+    }>;
+    /** Total duration */
+    duration: number;
+}
+/**
+ * Backup options
+ */
+export interface BackupOptions {
+    /** Backup name/identifier */
+    name?: string;
+    /** Tables to include (default: all) */
+    tables?: string[];
+    /** Tables to exclude */
+    excludeTables?: string[];
+    /** Include schema definition */
+    includeSchema?: boolean;
+    /** Compression algorithm */
+    compression?: 'none' | 'gzip' | 'brotli';
+    /** Output path */
+    path?: string;
+}
+/**
+ * Backup result
+ */
+export interface BackupResult {
+    /** Backup ID */
+    id: string;
+    /** Backup name */
+    name: string;
+    /** Backup path */
+    path: string;
+    /** Backup size in bytes */
+    size: number;
+    /** Tables included */
+    tables: string[];
+    /** Backup timestamp */
+    createdAt: Date;
+    /** Checksum for verification */
+    checksum: string;
+}
+/**
+ * Restore options
+ */
+export interface RestoreOptions {
+    /** Backup ID or path */
+    backup: string;
+    /** Tables to restore (default: all in backup) */
+    tables?: string[];
+    /** Drop existing tables before restore */
+    dropExisting?: boolean;
+    /** Verify checksum before restore */
+    verifyChecksum?: boolean;
+    /** Continue on errors */
+    continueOnError?: boolean;
+}
+/**
+ * Restore result
+ */
+export interface RestoreResult {
+    /** Whether restore was successful */
+    success: boolean;
+    /** Restored tables */
+    tables: string[];
+    /** Number of records restored per table */
+    recordCounts: Record<string, number>;
+    /** Errors encountered */
+    errors: Array<{
+        table: string;
+        error: Error;
+    }>;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Sync status
+ */
+export interface SyncStatus {
+    /** Whether sync is enabled */
+    enabled: boolean;
+    /** Last sync time */
+    lastSync?: Date;
+    /** Sync direction */
+    direction: 'bidirectional' | 'to-cloud' | 'from-cloud';
+    /** Whether sync is in progress */
+    inProgress: boolean;
+    /** Number of pending changes */
+    pendingChanges: number;
+    /** Sync errors */
+    errors: Array<{
+        table: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+}
+/**
+ * Sync options
+ */
+export interface SyncOptions {
+    /** Force sync even if already in progress */
+    force?: boolean;
+    /** Tables to sync (default: all) */
+    tables?: string[];
+    /** Direction override */
+    direction?: 'bidirectional' | 'to-cloud' | 'from-cloud';
+    /** Dry run (don't actually sync) */
+    dryRun?: boolean;
+}
+/**
+ * Sync result
+ */
+export interface SyncResult {
+    /** Whether sync was successful */
+    success: boolean;
+    /** Number of changes pushed */
+    pushed: number;
+    /** Number of changes pulled */
+    pulled: number;
+    /** Conflicts detected */
+    conflicts: Array<{
+        table: string;
+        id: string;
+        local: unknown;
+        remote: unknown;
+    }>;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/**
+ * Cross-table query options
+ */
+export interface CrossTableQueryOptions {
+    /** Tables to include */
+    tables: string[];
+    /** Join conditions */
+    joins: Array<{
+        from: {
+            table: string;
+            field: string;
+        };
+        to: {
+            table: string;
+            field: string;
+        };
+        type?: 'inner' | 'left' | 'right' | 'full';
+    }>;
+    /** Filter conditions */
+    where?: Record<string, unknown>;
+    /** Order by */
+    orderBy?: Array<{
+        table: string;
+        field: string;
+        direction: 'asc' | 'desc';
+    }>;
+    /** Limit */
+    limit?: number;
+    /** Offset */
+    offset?: number;
+}
+/**
+ * Schema statistics
+ */
+export interface SchemaStatistics {
+    /** Table statistics */
+    tables: Record<string, {
+        /** Number of records */
+        recordCount: number;
+        /** Table size in bytes */
+        size: number;
+        /** Index size in bytes */
+        indexSize: number;
+        /** Last modified */
+        lastModified?: Date;
+    }>;
+    /** Total database size */
+    totalSize: number;
+    /** Database file path */
+    path: string;
+}
+/**
+ * Schema health status
+ */
+export interface SchemaHealthStatus {
+    /** Whether schema is healthy */
+    healthy: boolean;
+    /** Database connection status */
+    connected: boolean;
+    /** Migration status */
+    migrations: MigrationStatus;
+    /** Integrity check result */
+    integrity: {
+        valid: boolean;
+        errors: string[];
+    };
+    /** Performance metrics */
+    performance: {
+        averageQueryTime: number;
+        slowQueries: number;
+        cacheHitRate: number;
+    };
+}
+/**
+ * Storage Schema Interface
+ *
+ * Provides access to multiple tables with cross-table operations.
+ */
+export interface StorageSchemaInterface<TTables extends Record<string, StorageTableDefinition> = Record<string, StorageTableDefinition>> {
+    /** Schema ID */
+    readonly id: string;
+    /** Schema name */
+    readonly name: string;
+    /** Database name */
+    readonly dbName: string;
+    /** Available table names */
+    readonly tableNames: Extract<keyof TTables, string>[];
+    /** Zod schemas for all tables */
+    readonly schemas: {
+        [K in keyof TTables]: z.ZodType;
+    };
+    /** Relations between tables */
+    readonly relations: Record<string, Record<string, StorageRelation>>;
+    /**
+     * Get a table interface for operations
+     *
+     * @param tableName - Table name
+     * @returns Table interface
+     */
+    table<K extends Extract<keyof TTables, string>>(tableName: K): StorageTableInterface<z.infer<TTables[K]['schema']>, TTables[K]['relations'] extends Record<string, StorageRelation> ? TTables[K]['relations'] : Record<string, StorageRelation>>;
+    /**
+     * Check if table exists
+     *
+     * @param tableName - Table name
+     * @returns True if table exists
+     */
+    hasTable(tableName: string): boolean;
+    /**
+     * Get all table interfaces
+     *
+     * @returns Map of table name to interface
+     */
+    getTables(): Map<string, StorageTableInterface>;
+    /**
+     * Execute operations in a transaction
+     *
+     * @param fn - Transaction function
+     * @returns Transaction result
+     */
+    transaction<T>(fn: TransactionFn<T>): Promise<T>;
+    /**
+     * Begin a transaction explicitly
+     *
+     * @returns Transaction context
+     */
+    beginTransaction(): Promise<TransactionContext>;
+    /**
+     * Commit a transaction
+     *
+     * @param tx - Transaction context
+     */
+    commitTransaction(tx: TransactionContext): Promise<void>;
+    /**
+     * Rollback a transaction
+     *
+     * @param tx - Transaction context
+     */
+    rollbackTransaction(tx: TransactionContext): Promise<void>;
+    /**
+     * Execute a cross-table query with joins
+     *
+     * @param options - Query options
+     * @returns Query results
+     */
+    query(options: CrossTableQueryOptions): Promise<Record<string, unknown>[]>;
+    /**
+     * Batch operations across multiple tables
+     *
+     * @param operations - Array of operations
+     * @returns Array of results
+     */
+    batch(operations: Array<{
+        table: string;
+        operation: 'create' | 'update' | 'delete';
+        data?: unknown;
+        id?: string;
+    }>): Promise<unknown[]>;
+    /**
+     * Truncate multiple tables
+     *
+     * @param tables - Table names (default: all tables)
+     * @param options - Truncate options
+     */
+    truncate(tables?: string[], options?: {
+        restartIdentity?: boolean;
+        cascade?: boolean;
+    }): Promise<void>;
+    /**
+     * Run migrations
+     *
+     * @param options - Migration options
+     * @returns Migration result
+     */
+    migrate(options?: MigrationOptions): Promise<MigrationResult>;
+    /**
+     * Rollback migrations
+     *
+     * @param steps - Number of migrations to rollback (default: 1)
+     * @returns Migration result
+     */
+    rollback(steps?: number): Promise<MigrationResult>;
+    /**
+     * Get migration status
+     *
+     * @returns Migration status
+     */
+    getMigrationStatus(): Promise<MigrationStatus>;
+    /**
+     * Reset schema (drop all tables and re-run migrations)
+     *
+     * @param options - Reset options
+     */
+    reset(options?: {
+        seed?: boolean;
+    }): Promise<void>;
+    /**
+     * Create a backup
+     *
+     * @param options - Backup options
+     * @returns Backup result
+     */
+    backup(options?: BackupOptions): Promise<BackupResult>;
+    /**
+     * Restore from a backup
+     *
+     * @param options - Restore options
+     * @returns Restore result
+     */
+    restore(options: RestoreOptions): Promise<RestoreResult>;
+    /**
+     * List available backups
+     *
+     * @returns List of backups
+     */
+    listBackups(): Promise<Array<{
+        id: string;
+        name: string;
+        createdAt: Date;
+        size: number;
+        tables: string[];
+    }>>;
+    /**
+     * Delete a backup
+     *
+     * @param backupId - Backup ID
+     */
+    deleteBackup(backupId: string): Promise<void>;
+    /**
+     * Sync with remote storage
+     *
+     * @param options - Sync options
+     * @returns Sync result
+     */
+    sync(options?: SyncOptions): Promise<SyncResult>;
+    /**
+     * Get sync status
+     *
+     * @returns Sync status
+     */
+    getSyncStatus(): Promise<SyncStatus>;
+    /**
+     * Enable sync
+     */
+    enableSync(): Promise<void>;
+    /**
+     * Disable sync
+     */
+    disableSync(): Promise<void>;
+    /**
+     * Get schema statistics
+     *
+     * @returns Schema statistics
+     */
+    getStatistics(): Promise<SchemaStatistics>;
+    /**
+     * Get health status
+     *
+     * @returns Health status
+     */
+    getHealth(): Promise<SchemaHealthStatus>;
+    /**
+     * Check database integrity
+     *
+     * @returns Integrity check result
+     */
+    checkIntegrity(): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+    /**
+     * Optimize database (vacuum, analyze, etc.)
+     */
+    optimize(): Promise<void>;
+    /**
+     * Get adapter ID
+     *
+     * @returns Adapter ID
+     */
+    getAdapterId(): string;
+    /**
+     * Export schema definition
+     *
+     * @returns Schema definition
+     */
+    exportSchema(): Record<string, unknown>;
+    /**
+     * Validate data against table schema
+     *
+     * @param tableName - Table name
+     * @param data - Data to validate
+     * @returns Validation result
+     */
+    validate<K extends Extract<keyof TTables, string>>(tableName: K, data: unknown): Promise<{
+        success: boolean;
+        data?: unknown;
+        errors?: z.ZodError;
+    }>;
+    /**
+     * Close all connections and cleanup
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=schema-interface.d.ts.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Storage Schema Interface
+ *
+ * Defines the interface for multi-table schemas with relations.
+ * This is what gets resolved when you query for a storage/schema descriptor.
+ *
+ * @example
+ * ```typescript
+ * const schema = await runtime
+ *   .query('storage/schema')
+ *   .withId('session')
+ *   .resolve();
+ *
+ * // Access individual tables
+ * const sessions = schema.table('sessions');
+ * const todos = schema.table('todos');
+ *
+ * // Cross-table operations
+ * const sessionWithTodos = await schema.getTransaction(async (tx) => {
+ *   const session = await sessions.create({ ... });
+ *   await todos.create({ sessionId: session.id, title: 'First todo' });
+ *   return session;
+ * });
+ *
+ * // Schema-level operations
+ * await schema.migrate();
+ * await schema.backup();
+ * ```
+ */
+export {};
+//# sourceMappingURL=schema-interface.js.map

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

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