@quereus/store 0.3.6 → 0.3.7

package/dist/src/common/events.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Reactive event types and emitter for schema and data changes.
+ */
+import type { Row, SqlValue } from '@quereus/quereus';
+/**
+ * Schema change event types.
+ */
+export interface SchemaChangeEvent {
+    type: 'create' | 'alter' | 'drop';
+    objectType: 'table' | 'index';
+    schemaName: string;
+    objectName: string;
+    ddl?: string;
+    /** True if this event originated from sync (remote replica) or cross-tab. */
+    remote?: boolean;
+}
+/**
+ * Data change event types.
+ */
+export interface DataChangeEvent {
+    type: 'insert' | 'update' | 'delete';
+    schemaName: string;
+    tableName: string;
+    /** Primary key values. Alias: pk */
+    key?: SqlValue[];
+    /** Primary key values. Alias: key */
+    pk?: SqlValue[];
+    oldRow?: Row;
+    newRow?: Row;
+    /** Column names that were changed (for update events). */
+    changedColumns?: string[];
+    /** True if this event originated from sync (remote replica) or cross-tab. */
+    remote?: boolean;
+}
+/**
+ * Event listener types.
+ */
+export type SchemaChangeListener = (event: SchemaChangeEvent) => void;
+export type DataChangeListener = (event: DataChangeEvent) => void;
+/**
+ * Key for identifying a pending remote schema event.
+ */
+interface PendingRemoteSchemaEvent {
+    type: 'create' | 'alter' | 'drop';
+    objectType: 'table' | 'index';
+    schemaName: string;
+    objectName: string;
+}
+/**
+ * Simple event emitter for store events.
+ */
+export declare class StoreEventEmitter {
+    private schemaListeners;
+    private dataListeners;
+    private batchedDataEvents;
+    private isBatching;
+    /**
+     * Pending remote schema events that should be marked as remote when they arrive.
+     * Uses a Map with stringified key for O(1) lookup.
+     */
+    private pendingRemoteSchemaEvents;
+    /**
+     * Subscribe to schema change events.
+     * @returns Unsubscribe function.
+     */
+    onSchemaChange(listener: SchemaChangeListener): () => void;
+    /**
+     * Subscribe to data change events.
+     * @returns Unsubscribe function.
+     */
+    onDataChange(listener: DataChangeListener): () => void;
+    /**
+     * Emit a schema change event.
+     * If the event matches a pending remote event, it's automatically marked as remote.
+     */
+    emitSchemaChange(event: SchemaChangeEvent): void;
+    /**
+     * Create a unique key for a schema event signature.
+     */
+    private makeSchemaEventKey;
+    /**
+     * Register an expected remote schema event.
+     * When a matching event is emitted, it will be automatically marked as remote.
+     * Uses reference counting to handle concurrent applies of the same event type.
+     */
+    expectRemoteSchemaEvent(event: PendingRemoteSchemaEvent): void;
+    /**
+     * Clear an expected remote schema event (e.g., if the operation failed).
+     */
+    clearExpectedRemoteSchemaEvent(event: PendingRemoteSchemaEvent): void;
+    /**
+     * Emit a data change event.
+     * If batching is active, queues the event for later emission.
+     */
+    emitDataChange(event: DataChangeEvent): void;
+    /**
+     * Start batching data change events.
+     * Events will be queued until flush() or discard() is called.
+     */
+    startBatch(): void;
+    /**
+     * Flush batched data change events to listeners.
+     */
+    flushBatch(): void;
+    /**
+     * Discard batched data change events (e.g., on rollback).
+     */
+    discardBatch(): void;
+    /**
+     * Check if there are any listeners registered.
+     */
+    hasListeners(): boolean;
+    /**
+     * Remove all listeners.
+     */
+    removeAllListeners(): void;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/src/common/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/common/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC;IACjB,qCAAqC;IACrC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAElE;;GAEG;AACH,UAAU,wBAAwB;IAChC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAClC,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,iBAAiB,CAAyB;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B;;;OAGG;IACH,OAAO,CAAC,yBAAyB,CAAkC;IAEnE;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAK1D;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAKtD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAuBhD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;;;OAIG;IACH,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAM9D;;OAEG;IACH,8BAA8B,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAYrE;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAe5C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,UAAU,IAAI,IAAI;IAgBlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAM3B"}

package/dist/src/common/events.js

@@ -0,0 +1,158 @@
+/**
+ * Reactive event types and emitter for schema and data changes.
+ */
+/**
+ * Simple event emitter for store events.
+ */
+export class StoreEventEmitter {
+    schemaListeners = new Set();
+    dataListeners = new Set();
+    batchedDataEvents = [];
+    isBatching = false;
+    /**
+     * Pending remote schema events that should be marked as remote when they arrive.
+     * Uses a Map with stringified key for O(1) lookup.
+     */
+    pendingRemoteSchemaEvents = new Map();
+    /**
+     * Subscribe to schema change events.
+     * @returns Unsubscribe function.
+     */
+    onSchemaChange(listener) {
+        this.schemaListeners.add(listener);
+        return () => this.schemaListeners.delete(listener);
+    }
+    /**
+     * Subscribe to data change events.
+     * @returns Unsubscribe function.
+     */
+    onDataChange(listener) {
+        this.dataListeners.add(listener);
+        return () => this.dataListeners.delete(listener);
+    }
+    /**
+     * Emit a schema change event.
+     * If the event matches a pending remote event, it's automatically marked as remote.
+     */
+    emitSchemaChange(event) {
+        // Check if this event matches a pending remote event
+        const key = this.makeSchemaEventKey(event);
+        const pendingCount = this.pendingRemoteSchemaEvents.get(key);
+        if (pendingCount !== undefined && pendingCount > 0) {
+            // Mark as remote and decrement the pending count
+            event = { ...event, remote: true };
+            if (pendingCount === 1) {
+                this.pendingRemoteSchemaEvents.delete(key);
+            }
+            else {
+                this.pendingRemoteSchemaEvents.set(key, pendingCount - 1);
+            }
+        }
+        for (const listener of this.schemaListeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error('Schema change listener error:', e);
+            }
+        }
+    }
+    /**
+     * Create a unique key for a schema event signature.
+     */
+    makeSchemaEventKey(event) {
+        return `${event.type}:${event.objectType}:${event.schemaName.toLowerCase()}:${event.objectName.toLowerCase()}`;
+    }
+    /**
+     * Register an expected remote schema event.
+     * When a matching event is emitted, it will be automatically marked as remote.
+     * Uses reference counting to handle concurrent applies of the same event type.
+     */
+    expectRemoteSchemaEvent(event) {
+        const key = this.makeSchemaEventKey(event);
+        const current = this.pendingRemoteSchemaEvents.get(key) ?? 0;
+        this.pendingRemoteSchemaEvents.set(key, current + 1);
+    }
+    /**
+     * Clear an expected remote schema event (e.g., if the operation failed).
+     */
+    clearExpectedRemoteSchemaEvent(event) {
+        const key = this.makeSchemaEventKey(event);
+        const current = this.pendingRemoteSchemaEvents.get(key);
+        if (current !== undefined && current > 0) {
+            if (current === 1) {
+                this.pendingRemoteSchemaEvents.delete(key);
+            }
+            else {
+                this.pendingRemoteSchemaEvents.set(key, current - 1);
+            }
+        }
+    }
+    /**
+     * Emit a data change event.
+     * If batching is active, queues the event for later emission.
+     */
+    emitDataChange(event) {
+        if (this.isBatching) {
+            this.batchedDataEvents.push(event);
+            return;
+        }
+        for (const listener of this.dataListeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error('Data change listener error:', e);
+            }
+        }
+    }
+    /**
+     * Start batching data change events.
+     * Events will be queued until flush() or discard() is called.
+     */
+    startBatch() {
+        this.isBatching = true;
+        this.batchedDataEvents = [];
+    }
+    /**
+     * Flush batched data change events to listeners.
+     */
+    flushBatch() {
+        this.isBatching = false;
+        const events = this.batchedDataEvents;
+        this.batchedDataEvents = [];
+        for (const event of events) {
+            for (const listener of this.dataListeners) {
+                try {
+                    listener(event);
+                }
+                catch (e) {
+                    console.error('Data change listener error:', e);
+                }
+            }
+        }
+    }
+    /**
+     * Discard batched data change events (e.g., on rollback).
+     */
+    discardBatch() {
+        this.isBatching = false;
+        this.batchedDataEvents = [];
+    }
+    /**
+     * Check if there are any listeners registered.
+     */
+    hasListeners() {
+        return this.schemaListeners.size > 0 || this.dataListeners.size > 0;
+    }
+    /**
+     * Remove all listeners.
+     */
+    removeAllListeners() {
+        this.schemaListeners.clear();
+        this.dataListeners.clear();
+        this.batchedDataEvents = [];
+        this.isBatching = false;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/src/common/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/common/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoDH;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACpB,eAAe,GAA8B,IAAI,GAAG,EAAE,CAAC;IACvD,aAAa,GAA4B,IAAI,GAAG,EAAE,CAAC;IACnD,iBAAiB,GAAsB,EAAE,CAAC;IAC1C,UAAU,GAAG,KAAK,CAAC;IAC3B;;;OAGG;IACK,yBAAyB,GAAwB,IAAI,GAAG,EAAE,CAAC;IAEnE;;;OAGG;IACH,cAAc,CAAC,QAA8B;QAC3C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,QAA4B;QACvC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,KAAwB;QACvC,qDAAqD;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;YACnD,iDAAiD;YACjD,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACnC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAA+B;QACxD,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;IACjH,CAAC;IAED;;;;OAIG;IACH,uBAAuB,CAAC,KAA+B;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,8BAA8B,CAAC,KAA+B;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,KAAsB;QACnC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC;QACtC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAE5B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC1C,IAAI,CAAC;oBACH,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAClB,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,CAAC,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/dist/src/common/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Common utilities for the persistent store module.
+ */
+export type { KVStore, KVEntry, WriteBatch, BatchOp, IterateOptions, KVStoreFactory, KVStoreOptions, KVStoreProvider, } from './kv-store.js';
+export { encodeValue, encodeCompositeKey, decodeValue, decodeCompositeKey, registerCollationEncoder, getCollationEncoder, type CollationEncoder, type EncodeOptions, } from './encoding.js';
+export { serializeRow, deserializeRow, serializeValue, deserializeValue, serializeStats, deserializeStats, type TableStats, } from './serialization.js';
+export { KEY_PREFIX, buildDataKey, buildIndexKey, buildMetaKey, buildTablePrefix, buildTableScanBounds, buildIndexScanBounds, buildMetaScanBounds, } from './key-builder.js';
+export { StoreEventEmitter, type SchemaChangeEvent, type DataChangeEvent, type SchemaChangeListener, type DataChangeListener, } from './events.js';
+export { generateTableDDL, generateIndexDDL, } from './ddl-generator.js';
+export { TransactionCoordinator, type TransactionCallbacks, } from './transaction.js';
+export { InMemoryKVStore } from './memory-store.js';
+export { StoreTable, type StoreTableConfig, type StoreTableModule, } from './store-table.js';
+export { StoreConnection } from './store-connection.js';
+export { StoreModule, type StoreModuleConfig } from './store-module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,OAAO,EACP,OAAO,EACP,UAAU,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,EACL,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/common/index.js

@@ -0,0 +1,23 @@
+/**
+ * Common utilities for the persistent store module.
+ */
+// Key encoding
+export { encodeValue, encodeCompositeKey, decodeValue, decodeCompositeKey, registerCollationEncoder, getCollationEncoder, } from './encoding.js';
+// Row serialization
+export { serializeRow, deserializeRow, serializeValue, deserializeValue, serializeStats, deserializeStats, } from './serialization.js';
+// Key building
+export { KEY_PREFIX, buildDataKey, buildIndexKey, buildMetaKey, buildTablePrefix, buildTableScanBounds, buildIndexScanBounds, buildMetaScanBounds, } from './key-builder.js';
+// Events
+export { StoreEventEmitter, } from './events.js';
+// DDL generation
+export { generateTableDDL, generateIndexDDL, } from './ddl-generator.js';
+// Transaction support
+export { TransactionCoordinator, } from './transaction.js';
+// In-memory KV store
+export { InMemoryKVStore } from './memory-store.js';
+// Generic store table and connection
+export { StoreTable, } from './store-table.js';
+export { StoreConnection } from './store-connection.js';
+// Generic store module
+export { StoreModule } from './store-module.js';
+//# sourceMappingURL=index.js.map

package/dist/src/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,eAAe;AACf,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GAGpB,MAAM,eAAe,CAAC;AAEvB,oBAAoB;AACpB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GAEjB,MAAM,oBAAoB,CAAC;AAE5B,eAAe;AACf,OAAO,EACL,UAAU,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,SAAS;AACT,OAAO,EACL,iBAAiB,GAKlB,MAAM,aAAa,CAAC;AAErB,iBAAiB;AACjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,sBAAsB,GAEvB,MAAM,kBAAkB,CAAC;AAE1B,qBAAqB;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qCAAqC;AACrC,OAAO,EACL,UAAU,GAGX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,uBAAuB;AACvB,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAC"}

package/dist/src/common/key-builder.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Key builder utilities for constructing storage keys.
+ *
+ * Key prefixes:
+ *   d: - Data rows
+ *   i: - Secondary indexes
+ *   m: - Metadata (DDL, stats)
+ */
+import type { SqlValue } from '@quereus/quereus';
+import { type EncodeOptions } from './encoding.js';
+/** Key prefix bytes. */
+export declare const KEY_PREFIX: {
+    readonly DATA: Uint8Array<ArrayBuffer>;
+    readonly INDEX: Uint8Array<ArrayBuffer>;
+    readonly META: Uint8Array<ArrayBuffer>;
+};
+/**
+ * Build a data row key.
+ * Format: d:{schema}.{table}:{encoded_pk}
+ */
+export declare function buildDataKey(schemaName: string, tableName: string, pkValues: SqlValue[], options?: EncodeOptions): Uint8Array;
+/**
+ * Build a secondary index key.
+ * Format: i:{schema}.{table}.{indexName}:{encoded_index_cols}:{encoded_pk}
+ */
+export declare function buildIndexKey(schemaName: string, tableName: string, indexName: string, indexValues: SqlValue[], pkValues: SqlValue[], options?: EncodeOptions): Uint8Array;
+/**
+ * Build a metadata key.
+ * Format: m:{type}:{schema}.{name}
+ */
+export declare function buildMetaKey(metaType: 'ddl' | 'stats' | 'index', schemaName: string, objectName: string, subName?: string): Uint8Array;
+/**
+ * Build a table prefix for range scans.
+ * Format: {prefix}:{schema}.{table}
+ */
+export declare function buildTablePrefix(prefix: 'd' | 'i' | 'm', schemaName: string, tableName: string): Uint8Array;
+/**
+ * Build range bounds for scanning all rows of a table.
+ */
+export declare function buildTableScanBounds(schemaName: string, tableName: string): {
+    gte: Uint8Array;
+    lt: Uint8Array;
+};
+/**
+ * Build range bounds for scanning an index.
+ */
+export declare function buildIndexScanBounds(schemaName: string, tableName: string, indexName: string, prefixValues?: SqlValue[], options?: EncodeOptions): {
+    gte: Uint8Array;
+    lt: Uint8Array;
+};
+/**
+ * Build range bounds for scanning all metadata of a type.
+ */
+export declare function buildMetaScanBounds(metaType: 'ddl' | 'stats' | 'index', schemaName?: string): {
+    gte: Uint8Array;
+    lt: Uint8Array;
+};
+//# sourceMappingURL=key-builder.d.ts.map

package/dist/src/common/key-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-builder.d.ts","sourceRoot":"","sources":["../../../src/common/key-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAIvE,wBAAwB;AACxB,eAAO,MAAM,UAAU;;;;CAIb,CAAC;AAKX;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAAE,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,UAAU,CAKZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,EAAE,EACvB,QAAQ,EAAE,QAAQ,EAAE,EACpB,OAAO,CAAC,EAAE,aAAa,GACtB,UAAU,CAMZ;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,EACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,UAAU,CAMZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,UAAU,CAEZ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAMrC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,QAAQ,EAAE,EACzB,OAAO,CAAC,EAAE,aAAa,GACtB;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CAiBrC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,EACnC,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,UAAU,CAAA;CAAE,CASrC"}

package/dist/src/common/key-builder.js

@@ -0,0 +1,130 @@
+/**
+ * Key builder utilities for constructing storage keys.
+ *
+ * Key prefixes:
+ *   d: - Data rows
+ *   i: - Secondary indexes
+ *   m: - Metadata (DDL, stats)
+ */
+import { encodeCompositeKey } from './encoding.js';
+const encoder = new TextEncoder();
+/** Key prefix bytes. */
+export const KEY_PREFIX = {
+    DATA: encoder.encode('d:'),
+    INDEX: encoder.encode('i:'),
+    META: encoder.encode('m:'),
+};
+/** Separator between key components. */
+const SEPARATOR = encoder.encode(':');
+/**
+ * Build a data row key.
+ * Format: d:{schema}.{table}:{encoded_pk}
+ */
+export function buildDataKey(schemaName, tableName, pkValues, options) {
+    const tablePrefix = buildTablePrefix('d', schemaName, tableName);
+    const pkEncoded = encodeCompositeKey(pkValues, options);
+    return concatBytes(tablePrefix, SEPARATOR, pkEncoded);
+}
+/**
+ * Build a secondary index key.
+ * Format: i:{schema}.{table}.{indexName}:{encoded_index_cols}:{encoded_pk}
+ */
+export function buildIndexKey(schemaName, tableName, indexName, indexValues, pkValues, options) {
+    const prefix = encoder.encode(`i:${schemaName}.${tableName}.${indexName}:`);
+    const indexEncoded = encodeCompositeKey(indexValues, options);
+    const pkEncoded = encodeCompositeKey(pkValues, options);
+    return concatBytes(prefix, indexEncoded, SEPARATOR, pkEncoded);
+}
+/**
+ * Build a metadata key.
+ * Format: m:{type}:{schema}.{name}
+ */
+export function buildMetaKey(metaType, schemaName, objectName, subName) {
+    let key = `m:${metaType}:${schemaName}.${objectName}`;
+    if (subName) {
+        key += `#${subName}`;
+    }
+    return encoder.encode(key);
+}
+/**
+ * Build a table prefix for range scans.
+ * Format: {prefix}:{schema}.{table}
+ */
+export function buildTablePrefix(prefix, schemaName, tableName) {
+    return encoder.encode(`${prefix}:${schemaName}.${tableName}`);
+}
+/**
+ * Build range bounds for scanning all rows of a table.
+ */
+export function buildTableScanBounds(schemaName, tableName) {
+    const prefix = `d:${schemaName}.${tableName}:`;
+    return {
+        gte: encoder.encode(prefix),
+        lt: incrementLastByte(encoder.encode(prefix)),
+    };
+}
+/**
+ * Build range bounds for scanning an index.
+ */
+export function buildIndexScanBounds(schemaName, tableName, indexName, prefixValues, options) {
+    const prefix = `i:${schemaName}.${tableName}.${indexName}:`;
+    const prefixBytes = encoder.encode(prefix);
+    if (prefixValues && prefixValues.length > 0) {
+        const valueBytes = encodeCompositeKey(prefixValues, options);
+        const gte = concatBytes(prefixBytes, valueBytes);
+        return {
+            gte,
+            lt: incrementLastByte(gte),
+        };
+    }
+    return {
+        gte: prefixBytes,
+        lt: incrementLastByte(prefixBytes),
+    };
+}
+/**
+ * Build range bounds for scanning all metadata of a type.
+ */
+export function buildMetaScanBounds(metaType, schemaName) {
+    let prefix = `m:${metaType}:`;
+    if (schemaName) {
+        prefix += `${schemaName}.`;
+    }
+    return {
+        gte: encoder.encode(prefix),
+        lt: incrementLastByte(encoder.encode(prefix)),
+    };
+}
+/**
+ * Increment the last byte of a key to create an exclusive upper bound.
+ */
+function incrementLastByte(key) {
+    const result = new Uint8Array(key.length);
+    result.set(key);
+    // Increment from the end, handling overflow
+    for (let i = result.length - 1; i >= 0; i--) {
+        if (result[i] < 0xff) {
+            result[i]++;
+            return result;
+        }
+        result[i] = 0;
+    }
+    // All bytes were 0xff, append 0x00
+    const extended = new Uint8Array(result.length + 1);
+    extended.set(result);
+    return extended;
+}
+/**
+ * Concatenate multiple byte arrays.
+ */
+function concatBytes(...arrays) {
+    const totalLength = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
+}
+//# sourceMappingURL=key-builder.js.map

package/dist/src/common/key-builder.js.map

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