@quereus/quereus 0.1.0

package/dist/src/vtab/memory/layer/interface.d.ts

@@ -0,0 +1,41 @@
+import type { BTree } from 'inheritree';
+import type { TableSchema } from '../../../schema/table.js';
+import type { BTreeKeyForPrimary, BTreeKeyForIndex, MemoryIndexEntry } from '../types.js';
+import type { Row } from '../../../common/types.js';
+/**
+ * Represents a snapshot or a set of changes in the MemoryTable MVCC model.
+ * Layers form a chain, starting from a BaseLayer.
+ */
+export interface Layer {
+    /** Returns the layer ID (unique identifier, potentially timestamp or sequence) */
+    getLayerId(): number;
+    /** Returns the parent layer in the chain, or null for the BaseLayer */
+    getParent(): Layer | null;
+    /**
+     * Gets the BTree containing modifications specific to this layer for a given index.
+     * For BaseLayer, this returns the main data BTree.
+     * For TransactionLayer, this returns the inherited BTree for that index.
+     *
+     * @param indexName The name of the secondary index, or 'primary' for the primary key index.
+     * @returns The BTree containing modifications/data for the index in this layer, or null if no modifications exist for that index in this layer.
+     */
+    getModificationTree(indexName: string | 'primary'): BTree<BTreeKeyForPrimary, Row> | null;
+    /**
+     * Returns the table schema as it existed when this layer was created or relevant.
+     * This is important for interpreting modifications during layer collapse, especially
+     * if schema changes occurred after this layer was created.
+     */
+    getSchema(): TableSchema;
+    /** Indicates if this layer represents a committed transaction state */
+    isCommitted(): boolean;
+    /** Helper to get the specific BTree for a secondary index's underlying data */
+    getSecondaryIndexTree?(indexName: string): BTree<BTreeKeyForIndex, MemoryIndexEntry> | null;
+    /**
+     * This method provides PK extractor and comparator based on a given schema (usually its own)
+     */
+    getPkExtractorsAndComparators(schema: TableSchema): {
+        primaryKeyExtractorFromRow: (row: Row) => BTreeKeyForPrimary;
+        primaryKeyComparator: (a: BTreeKeyForPrimary, b: BTreeKeyForPrimary) => number;
+    };
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/src/vtab/memory/layer/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../../../src/vtab/memory/layer/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACrB,kFAAkF;IAClF,UAAU,IAAI,MAAM,CAAC;IAErB,uEAAuE;IACvE,SAAS,IAAI,KAAK,GAAG,IAAI,CAAC;IAE1B;;;;;;;OAOG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC,kBAAkB,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAE1F;;;;OAIG;IACH,SAAS,IAAI,WAAW,CAAC;IAEzB,uEAAuE;IACvE,WAAW,IAAI,OAAO,CAAC;IAEvB,+EAA+E;IAC/E,qBAAqB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,IAAI,CAAC;IAE5F;;OAEG;IACH,6BAA6B,CAAC,MAAM,EAAE,WAAW,GAAG;QACnD,0BAA0B,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,kBAAkB,CAAC;QAC7D,oBAAoB,EAAE,CAAC,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,kBAAkB,KAAK,MAAM,CAAC;KAC/E,CAAC;CACF"}

package/dist/src/vtab/memory/layer/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/src/vtab/memory/layer/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../../../src/vtab/memory/layer/interface.ts"],"names":[],"mappings":""}

package/dist/src/vtab/memory/layer/manager.d.ts

@@ -0,0 +1,68 @@
+import type { Database } from '../../../core/database.js';
+import { type TableSchema, type IndexSchema } from '../../../schema/table.js';
+import { type BTreeKey, type BTreeKeyForPrimary } from '../types.js';
+import { type Row } from '../../../common/types.js';
+import type { Layer } from './interface.js';
+import { MemoryTableConnection } from './connection.js';
+import type { ColumnDef as ASTColumnDef } from '../../../parser/ast.js';
+import type { ScanPlan } from './scan-plan.js';
+export declare class MemoryTableManager {
+    readonly managerId: number;
+    readonly db: Database;
+    readonly schemaName: string;
+    private _tableName;
+    get tableName(): string;
+    private baseLayer;
+    private _currentCommittedLayer;
+    private connections;
+    readonly isReadOnly: boolean;
+    tableSchema: TableSchema;
+    private primaryKeyFunctions;
+    constructor(db: Database, _moduleName: string, schemaName: string, tableName: string, initialSchema: TableSchema, readOnly?: boolean);
+    private initializePrimaryKeyFunctions;
+    private get primaryKeyFromRow();
+    private get comparePrimaryKeys();
+    get currentCommittedLayer(): Layer;
+    connect(): MemoryTableConnection;
+    disconnect(connectionId: number): Promise<void>;
+    commitTransaction(connection: MemoryTableConnection): Promise<void>;
+    tryCollapseLayers(): Promise<void>;
+    /**
+     * Checks if a layer is currently in use by any connections.
+     * This includes checking if any connection is reading from the layer,
+     * has it as a pending transaction layer, or has it as a savepoint.
+     */
+    private isLayerInUse;
+    /**
+     * Performs garbage collection of layers that are no longer referenced
+     * by any connections or the current committed layer chain.
+     */
+    private cleanupUnreferencedLayers;
+    lookupEffectiveRow(primaryKey: BTreeKeyForPrimary, startLayer: Layer): Row | null;
+    lookupEffectiveValue(key: BTreeKeyForPrimary, indexName: string | 'primary', startLayer: Layer): Row | null;
+    performMutation(connection: MemoryTableConnection, operation: 'insert' | 'update' | 'delete', values: Row | undefined, oldKeyValues?: Row): Promise<Row | undefined>;
+    private validateMutationPermissions;
+    private ensureTransactionLayer;
+    private extractConflictResolution;
+    private shouldSkipPkCheck;
+    private cleanConflictResolutionFromValues;
+    private performInsert;
+    private performUpdate;
+    private performUpdateWithPrimaryKeyChange;
+    private performDelete;
+    renameTable(newName: string): void;
+    addColumn(columnDefAst: ASTColumnDef): Promise<void>;
+    dropColumn(columnName: string): Promise<void>;
+    renameColumn(oldName: string, newColumnDefAst: ASTColumnDef): Promise<void>;
+    createIndex(newIndexSchemaEntry: IndexSchema, ifNotExistsFromAst?: boolean): Promise<void>;
+    dropIndex(indexName: string, ifExists?: boolean): Promise<void>;
+    planAppliesToKey(plan: ScanPlan, key: BTreeKey, keyComparator: (a: BTreeKey, b: BTreeKey) => number): boolean;
+    destroy(): Promise<void>;
+    private ensureSchemaChangeSafety;
+    /** Consolidates all transaction data into the base layer for schema changes */
+    private consolidateToBaseLayer;
+    /** Copies all data from a transaction layer to the base layer */
+    private copyTransactionDataToBase;
+    scanLayer(layer: Layer, plan: ScanPlan): AsyncIterable<Row>;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/vtab/memory/layer/manager.d.ts.map

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