@quereus/store 0.3.6 → 0.3.7

package/dist/src/common/store-module.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Generic Store Module for Quereus.
+ *
+ * A platform-agnostic VirtualTableModule that uses a KVStoreProvider
+ * to create StoreTable instances. This enables any storage backend
+ * (LevelDB, IndexedDB, React Native, etc.) to be used with the same
+ * table implementation.
+ */
+import type { Database, TableSchema, TableIndexSchema, VirtualTableModule, BaseModuleConfig, BestAccessPlanRequest, BestAccessPlanResult } from '@quereus/quereus';
+import type { KVStore, KVStoreProvider } from './kv-store.js';
+import type { StoreEventEmitter } from './events.js';
+import { TransactionCoordinator } from './transaction.js';
+import { StoreTable, type StoreTableConfig, type StoreTableModule } from './store-table.js';
+/**
+ * Configuration options for StoreModule tables.
+ */
+export interface StoreModuleConfig extends BaseModuleConfig {
+    /** Collation for text keys. Default: 'NOCASE'. */
+    collation?: 'BINARY' | 'NOCASE';
+    /** Additional platform-specific options. */
+    [key: string]: unknown;
+}
+/**
+ * Generic store module that works with any KVStoreProvider.
+ *
+ * Usage:
+ * ```typescript
+ * import { StoreModule } from '@quereus/plugin-store';
+ * import { createLevelDBProvider } from '@quereus/store-leveldb';
+ *
+ * const provider = createLevelDBProvider({ basePath: './data' });
+ * const module = new StoreModule(provider);
+ * db.registerVtabModule('store', module);
+ * ```
+ */
+export declare class StoreModule implements VirtualTableModule<StoreTable, StoreModuleConfig>, StoreTableModule {
+    private provider;
+    private stores;
+    private coordinators;
+    private tables;
+    private eventEmitter?;
+    constructor(provider: KVStoreProvider, eventEmitter?: StoreEventEmitter);
+    /**
+     * Get the event emitter for this module.
+     */
+    getEventEmitter(): StoreEventEmitter | undefined;
+    /**
+     * Get the KVStoreProvider used by this module.
+     */
+    getProvider(): KVStoreProvider;
+    /**
+     * Creates a new store-backed table.
+     * Called by CREATE TABLE.
+     */
+    create(db: Database, tableSchema: TableSchema): StoreTable;
+    /**
+     * Connects to an existing store-backed table.
+     * Called when loading schema from persistent storage.
+     */
+    connect(db: Database, _pAux: unknown, _moduleName: string, schemaName: string, tableName: string, options: StoreModuleConfig, importedTableSchema?: TableSchema): StoreTable;
+    /**
+     * Destroys a store table and its storage.
+     */
+    destroy(_db: Database, _pAux: unknown, _moduleName: string, schemaName: string, tableName: string): Promise<void>;
+    /**
+     * Creates an index on a store-backed table.
+     */
+    createIndex(_db: Database, schemaName: string, tableName: string, indexSchema: TableIndexSchema): Promise<void>;
+    /**
+     * Build index entries for all existing rows in a table.
+     */
+    private buildIndexEntries;
+    /**
+     * Modern access planning interface.
+     */
+    getBestAccessPlan(_db: Database, tableInfo: TableSchema, request: BestAccessPlanRequest): BestAccessPlanResult;
+    /**
+     * Get or create a store for a table.
+     */
+    getStore(tableKey: string, _config: StoreTableConfig): Promise<KVStore>;
+    /**
+     * Get or create a transaction coordinator for a table.
+     */
+    getCoordinator(tableKey: string, config: StoreTableConfig): Promise<TransactionCoordinator>;
+    /**
+     * Save table DDL to persistent storage (both table store and catalog).
+     */
+    saveTableDDL(tableSchema: TableSchema): Promise<void>;
+    /**
+     * Load all DDL statements from the catalog store.
+     * Used to restore persisted tables on startup.
+     */
+    loadAllDDL(): Promise<string[]>;
+    /**
+     * Remove DDL from the catalog store when a table is dropped.
+     */
+    removeTableDDL(schemaName: string, tableName: string): Promise<void>;
+    /**
+     * Parse module configuration from vtab args.
+     */
+    private parseConfig;
+    /**
+     * Close all stores.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get a table by schema and name.
+     */
+    getTable(schemaName: string, tableName: string): StoreTable | undefined;
+}
+//# sourceMappingURL=store-module.d.ts.map

package/dist/src/common/store-module.d.ts.map

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

package/dist/src/common/store-module.js

@@ -0,0 +1,331 @@
+/**
+ * Generic Store Module for Quereus.
+ *
+ * A platform-agnostic VirtualTableModule that uses a KVStoreProvider
+ * to create StoreTable instances. This enables any storage backend
+ * (LevelDB, IndexedDB, React Native, etc.) to be used with the same
+ * table implementation.
+ */
+import { AccessPlanBuilder, QuereusError, StatusCode } from '@quereus/quereus';
+import { TransactionCoordinator } from './transaction.js';
+import { StoreTable } from './store-table.js';
+import { buildMetaKey, buildMetaScanBounds, buildIndexKey, buildTableScanBounds } from './key-builder.js';
+import { serializeRow, deserializeRow } from './serialization.js';
+import { generateTableDDL } from './ddl-generator.js';
+/**
+ * Generic store module that works with any KVStoreProvider.
+ *
+ * Usage:
+ * ```typescript
+ * import { StoreModule } from '@quereus/plugin-store';
+ * import { createLevelDBProvider } from '@quereus/store-leveldb';
+ *
+ * const provider = createLevelDBProvider({ basePath: './data' });
+ * const module = new StoreModule(provider);
+ * db.registerVtabModule('store', module);
+ * ```
+ */
+export class StoreModule {
+    provider;
+    stores = new Map();
+    coordinators = new Map();
+    tables = new Map();
+    eventEmitter;
+    constructor(provider, eventEmitter) {
+        this.provider = provider;
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Get the event emitter for this module.
+     */
+    getEventEmitter() {
+        return this.eventEmitter;
+    }
+    /**
+     * Get the KVStoreProvider used by this module.
+     */
+    getProvider() {
+        return this.provider;
+    }
+    /**
+     * Creates a new store-backed table.
+     * Called by CREATE TABLE.
+     */
+    create(db, tableSchema) {
+        const tableKey = `${tableSchema.schemaName}.${tableSchema.name}`.toLowerCase();
+        if (this.tables.has(tableKey)) {
+            throw new QuereusError(`Store table '${tableSchema.name}' already exists in schema '${tableSchema.schemaName}'`, StatusCode.ERROR);
+        }
+        const config = this.parseConfig(tableSchema.vtabArgs);
+        const table = new StoreTable(db, this, tableSchema, config, this.eventEmitter);
+        this.tables.set(tableKey, table);
+        // Emit schema change event for table creation
+        this.eventEmitter?.emitSchemaChange({
+            type: 'create',
+            objectType: 'table',
+            schemaName: tableSchema.schemaName,
+            objectName: tableSchema.name,
+            ddl: generateTableDDL(tableSchema),
+        });
+        return table;
+    }
+    /**
+     * Connects to an existing store-backed table.
+     * Called when loading schema from persistent storage.
+     */
+    connect(db, _pAux, _moduleName, schemaName, tableName, options, importedTableSchema) {
+        const tableKey = `${schemaName}.${tableName}`.toLowerCase();
+        // Check if we already have this table connected
+        const existing = this.tables.get(tableKey);
+        if (existing) {
+            return existing;
+        }
+        // Convert options to Record<string, SqlValue> for vtabArgs
+        const vtabArgs = {};
+        if (options?.collation !== undefined)
+            vtabArgs.collation = options.collation;
+        // Use the imported schema if provided, otherwise create a minimal one
+        const tableSchema = importedTableSchema ?? {
+            name: tableName,
+            schemaName: schemaName,
+            columns: Object.freeze([]),
+            columnIndexMap: new Map(),
+            primaryKeyDefinition: [],
+            checkConstraints: Object.freeze([]),
+            isTemporary: false,
+            isView: false,
+            vtabModuleName: 'store',
+            vtabArgs,
+            vtabModule: this,
+            estimatedRows: 0,
+        };
+        const config = this.parseConfig(vtabArgs);
+        const table = new StoreTable(db, this, tableSchema, config, this.eventEmitter, true // isConnected - DDL already exists in storage
+        );
+        this.tables.set(tableKey, table);
+        return table;
+    }
+    /**
+     * Destroys a store table and its storage.
+     */
+    async destroy(_db, _pAux, _moduleName, schemaName, tableName) {
+        const tableKey = `${schemaName}.${tableName}`.toLowerCase();
+        const table = this.tables.get(tableKey);
+        if (table) {
+            await table.disconnect();
+            this.tables.delete(tableKey);
+        }
+        // Close the store via provider
+        await this.provider.closeStore(schemaName, tableName);
+        this.stores.delete(tableKey);
+        this.coordinators.delete(tableKey);
+        // Emit schema change event for table drop
+        this.eventEmitter?.emitSchemaChange({
+            type: 'drop',
+            objectType: 'table',
+            schemaName,
+            objectName: tableName,
+        });
+    }
+    /**
+     * Creates an index on a store-backed table.
+     */
+    async createIndex(_db, schemaName, tableName, indexSchema) {
+        const tableKey = `${schemaName}.${tableName}`.toLowerCase();
+        const table = this.tables.get(tableKey);
+        if (!table) {
+            throw new QuereusError(`Store table '${tableName}' not found in schema '${schemaName}'`, StatusCode.NOTFOUND);
+        }
+        const store = await this.getStore(tableKey, table.getConfig());
+        const tableSchema = table.getSchema();
+        // Store index metadata
+        const indexMetaKey = buildMetaKey('index', schemaName, tableName, indexSchema.name);
+        const indexMetaValue = serializeRow([
+            indexSchema.name,
+            JSON.stringify(indexSchema.columns),
+        ]);
+        await store.put(indexMetaKey, indexMetaValue);
+        // Build index entries for existing rows
+        await this.buildIndexEntries(store, tableSchema, indexSchema);
+        // Emit schema change event
+        this.eventEmitter?.emitSchemaChange({
+            type: 'create',
+            objectType: 'index',
+            schemaName,
+            objectName: indexSchema.name,
+        });
+    }
+    /**
+     * Build index entries for all existing rows in a table.
+     */
+    async buildIndexEntries(store, tableSchema, indexSchema) {
+        const encodeOptions = { collation: 'NOCASE' };
+        // Scan all data rows
+        const bounds = buildTableScanBounds(tableSchema.schemaName, tableSchema.name);
+        const batch = store.batch();
+        for await (const entry of store.iterate(bounds)) {
+            const row = deserializeRow(entry.value);
+            // Extract PK values
+            const pkValues = tableSchema.primaryKeyDefinition.map(pk => row[pk.index]);
+            // Extract index column values
+            const indexValues = indexSchema.columns.map(col => row[col.index]);
+            // Build and store index key
+            const indexKey = buildIndexKey(tableSchema.schemaName, tableSchema.name, indexSchema.name, indexValues, pkValues, encodeOptions);
+            batch.put(indexKey, new Uint8Array(0)); // Index value is empty
+        }
+        await batch.write();
+    }
+    /**
+     * Modern access planning interface.
+     */
+    getBestAccessPlan(_db, tableInfo, request) {
+        const estimatedRows = request.estimatedRows ?? 1000;
+        // Check for primary key equality constraints
+        const pkColumns = tableInfo.primaryKeyDefinition.map(pk => pk.index);
+        const pkFilters = request.filters.filter(f => f.columnIndex !== undefined &&
+            pkColumns.includes(f.columnIndex) &&
+            f.op === '=');
+        if (pkFilters.length === pkColumns.length && pkColumns.length > 0) {
+            // Full PK match - point lookup
+            const handledFilters = request.filters.map(f => pkFilters.some(pf => pf.columnIndex === f.columnIndex && pf.op === f.op));
+            return AccessPlanBuilder
+                .eqMatch(1, 0.1)
+                .setHandledFilters(handledFilters)
+                .setIsSet(true)
+                .setExplanation('Store primary key lookup')
+                .build();
+        }
+        // Check for range constraints on PK
+        const rangeOps = ['<', '<=', '>', '>='];
+        const rangeFilters = request.filters.filter(f => f.columnIndex !== undefined &&
+            pkColumns.includes(f.columnIndex) &&
+            rangeOps.includes(f.op));
+        if (rangeFilters.length > 0) {
+            // Range scan on PK
+            const handledFilters = request.filters.map(f => rangeFilters.some(rf => rf.columnIndex === f.columnIndex && rf.op === f.op));
+            const rangeRows = Math.max(1, Math.floor(estimatedRows * 0.3));
+            return AccessPlanBuilder
+                .rangeScan(rangeRows, 0.2)
+                .setHandledFilters(handledFilters)
+                .setExplanation('Store primary key range scan')
+                .build();
+        }
+        // Check for secondary index usage
+        const indexes = tableInfo.indexes || [];
+        for (const index of indexes) {
+            const indexColumns = index.columns.map(c => c.index);
+            const indexFilters = request.filters.filter(f => f.columnIndex !== undefined &&
+                indexColumns.includes(f.columnIndex) &&
+                f.op === '=');
+            if (indexFilters.length > 0) {
+                const handledFilters = request.filters.map(f => indexFilters.some(idf => idf.columnIndex === f.columnIndex && idf.op === f.op));
+                const matchedRows = Math.max(1, Math.floor(estimatedRows * 0.1));
+                return AccessPlanBuilder
+                    .eqMatch(matchedRows, 0.3)
+                    .setHandledFilters(handledFilters)
+                    .setExplanation(`Store index scan on ${index.name}`)
+                    .build();
+            }
+        }
+        // Fallback to full scan
+        return AccessPlanBuilder
+            .fullScan(estimatedRows)
+            .setHandledFilters(new Array(request.filters.length).fill(false))
+            .setExplanation('Store full table scan')
+            .build();
+    }
+    // --- StoreTableModule interface implementation ---
+    /**
+     * Get or create a store for a table.
+     */
+    async getStore(tableKey, _config) {
+        let store = this.stores.get(tableKey);
+        if (!store) {
+            const [schemaName, tableName] = tableKey.split('.');
+            store = await this.provider.getStore(schemaName, tableName);
+            this.stores.set(tableKey, store);
+        }
+        return store;
+    }
+    /**
+     * Get or create a transaction coordinator for a table.
+     */
+    async getCoordinator(tableKey, config) {
+        let coordinator = this.coordinators.get(tableKey);
+        if (!coordinator) {
+            const store = await this.getStore(tableKey, config);
+            coordinator = new TransactionCoordinator(store, this.eventEmitter);
+            this.coordinators.set(tableKey, coordinator);
+        }
+        return coordinator;
+    }
+    /**
+     * Save table DDL to persistent storage (both table store and catalog).
+     */
+    async saveTableDDL(tableSchema) {
+        const tableKey = `${tableSchema.schemaName}.${tableSchema.name}`.toLowerCase();
+        const ddl = generateTableDDL(tableSchema);
+        const metaKey = buildMetaKey('ddl', tableSchema.schemaName, tableSchema.name);
+        const encoder = new TextEncoder();
+        const encodedDDL = encoder.encode(ddl);
+        // Save to table's own store
+        const store = this.stores.get(tableKey);
+        if (store) {
+            await store.put(metaKey, encodedDDL);
+        }
+        // Also save to catalog store for discovery
+        const catalogStore = await this.provider.getCatalogStore();
+        await catalogStore.put(metaKey, encodedDDL);
+    }
+    /**
+     * Load all DDL statements from the catalog store.
+     * Used to restore persisted tables on startup.
+     */
+    async loadAllDDL() {
+        const catalogStore = await this.provider.getCatalogStore();
+        const bounds = buildMetaScanBounds('ddl');
+        const decoder = new TextDecoder();
+        const ddlStatements = [];
+        for await (const entry of catalogStore.iterate(bounds)) {
+            const ddl = decoder.decode(entry.value);
+            ddlStatements.push(ddl);
+        }
+        return ddlStatements;
+    }
+    /**
+     * Remove DDL from the catalog store when a table is dropped.
+     */
+    async removeTableDDL(schemaName, tableName) {
+        const metaKey = buildMetaKey('ddl', schemaName, tableName);
+        const catalogStore = await this.provider.getCatalogStore();
+        await catalogStore.delete(metaKey);
+    }
+    /**
+     * Parse module configuration from vtab args.
+     */
+    parseConfig(args) {
+        return {
+            collation: args?.collation || 'NOCASE',
+        };
+    }
+    /**
+     * Close all stores.
+     */
+    async closeAll() {
+        for (const table of this.tables.values()) {
+            await table.disconnect();
+        }
+        this.tables.clear();
+        this.coordinators.clear();
+        await this.provider.closeAll();
+        this.stores.clear();
+    }
+    /**
+     * Get a table by schema and name.
+     */
+    getTable(schemaName, tableName) {
+        const tableKey = `${schemaName}.${tableName}`.toLowerCase();
+        return this.tables.get(tableKey);
+    }
+}
+//# sourceMappingURL=store-module.js.map

package/dist/src/common/store-module.js.map

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

package/dist/src/common/store-table.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Generic KVStore-backed Virtual Table implementation.
+ *
+ * This is a platform-agnostic table implementation that works with any
+ * KVStore implementation (LevelDB, IndexedDB, or custom stores).
+ */
+import { VirtualTable, IndexConstraintOp, type Database, type TableSchema, type Row, type FilterInfo, type SqlValue, type VirtualTableConnection, type UpdateArgs } from '@quereus/quereus';
+import type { KVStore } from './kv-store.js';
+import type { StoreEventEmitter } from './events.js';
+import type { TransactionCoordinator } from './transaction.js';
+import { StoreConnection } from './store-connection.js';
+import { type TableStats } from './serialization.js';
+import type { EncodeOptions } from './encoding.js';
+/**
+ * Configuration for a store table.
+ */
+export interface StoreTableConfig {
+    /** Collation for text keys. Default: 'NOCASE'. */
+    collation?: 'BINARY' | 'NOCASE';
+    /** Additional platform-specific options. */
+    [key: string]: unknown;
+}
+/**
+ * Interface for the store module that manages this table.
+ * Provides access to stores and coordinators.
+ */
+export interface StoreTableModule {
+    /** Get a store for a table. */
+    getStore(tableKey: string, config: StoreTableConfig): Promise<KVStore>;
+    /** Get a coordinator for a table. */
+    getCoordinator(tableKey: string, config: StoreTableConfig): Promise<TransactionCoordinator>;
+    /** Save table DDL to persistent storage. */
+    saveTableDDL(tableSchema: TableSchema): Promise<void>;
+}
+/**
+ * Generic KVStore-backed virtual table.
+ *
+ * This class provides the core table functionality shared across all
+ * storage backends. Platform-specific behavior is delegated to the
+ * StoreTableModule.
+ */
+export declare class StoreTable extends VirtualTable {
+    protected storeModule: StoreTableModule;
+    protected config: StoreTableConfig;
+    protected store: KVStore | null;
+    protected coordinator: TransactionCoordinator | null;
+    protected connection: StoreConnection | null;
+    protected eventEmitter?: StoreEventEmitter;
+    protected encodeOptions: EncodeOptions;
+    protected ddlSaved: boolean;
+    protected cachedStats: TableStats | null;
+    protected pendingStatsDelta: number;
+    protected mutationCount: number;
+    protected statsFlushPending: boolean;
+    constructor(db: Database, storeModule: StoreTableModule, tableSchema: TableSchema, config: StoreTableConfig, eventEmitter?: StoreEventEmitter, isConnected?: boolean);
+    /** Get the table configuration. */
+    getConfig(): StoreTableConfig;
+    /** Get the table schema. */
+    getSchema(): TableSchema;
+    /**
+     * Ensure the store is open and DDL is persisted.
+     */
+    protected ensureStore(): Promise<KVStore>;
+    /**
+     * Ensure the coordinator is available and connection is registered.
+     */
+    protected ensureCoordinator(): Promise<TransactionCoordinator>;
+    /** Apply pending stats on commit. */
+    protected applyPendingStats(): void;
+    /** Discard pending stats on rollback. */
+    protected discardPendingStats(): void;
+    /** Flush statistics to persistent storage. */
+    protected flushStats(): Promise<void>;
+    /** Create a new connection for transaction support. */
+    createConnection(): Promise<VirtualTableConnection>;
+    /** Get the current connection. */
+    getConnection(): VirtualTableConnection | undefined;
+    /** Extract primary key values from a row. */
+    protected extractPK(row: Row): SqlValue[];
+    /** Query the table with optional filters. */
+    query(filterInfo: FilterInfo): AsyncIterable<Row>;
+    /** Analyze filter info to determine PK access pattern. */
+    protected analyzePKAccess(filterInfo: FilterInfo): PKAccessPattern;
+    /** Scan a range of PK values. */
+    protected scanPKRange(store: KVStore, _access: PKAccessPattern, filterInfo: FilterInfo): AsyncIterable<Row>;
+    /** Check if a row matches the filter constraints. */
+    protected matchesFilters(row: Row, filterInfo: FilterInfo): boolean;
+    /** Compare two values according to an operator. */
+    protected compareValues(a: SqlValue, op: IndexConstraintOp, b: SqlValue): boolean;
+    /** Perform an update operation (INSERT, UPDATE, DELETE). */
+    update(args: UpdateArgs): Promise<Row | undefined>;
+    /** Update secondary indexes after a row change. */
+    protected updateSecondaryIndexes(coordinator: TransactionCoordinator, inTransaction: boolean, oldRow: Row | null, newRow: Row | null, pk: SqlValue[]): Promise<void>;
+    /** Check if two PK arrays are equal. */
+    protected keysEqual(a: SqlValue[], b: SqlValue[]): boolean;
+    /** Disconnect from the store. */
+    disconnect(): Promise<void>;
+    /** Get the current estimated row count. */
+    getEstimatedRowCount(): Promise<number>;
+    /** Track a mutation and schedule lazy stats persistence. */
+    protected trackMutation(delta: number, inTransaction?: boolean): void;
+}
+/** PK access pattern analysis result. */
+interface PKAccessPattern {
+    type: 'point' | 'range' | 'scan';
+    values?: SqlValue[];
+    columnIndex?: number;
+    constraints?: Array<{
+        columnIndex: number;
+        op: IndexConstraintOp;
+        value?: SqlValue;
+    }>;
+}
+export {};
+//# sourceMappingURL=store-table.d.ts.map

package/dist/src/common/store-table.d.ts.map

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