@quereus/quereus 0.1.0

package/dist/src/vtab/best-access-plan.js

@@ -0,0 +1,156 @@
+/**
+ * Modern, type-safe replacement for xBestIndex API
+ * Provides better type safety, clearer intent, and extensibility for future optimizations
+ */
+import { quereusError } from '../common/errors.js';
+import { StatusCode } from '../common/types.js';
+/**
+ * Builder class for constructing access plan results
+ */
+export class AccessPlanBuilder {
+    result = {};
+    /**
+     * Create a full table scan access plan
+     */
+    static fullScan(estimatedRows) {
+        return new AccessPlanBuilder()
+            .setCost(estimatedRows * 1.0) // Sequential scan cost
+            .setRows(estimatedRows)
+            .setExplanation('Full table scan');
+    }
+    /**
+     * Create an equality match access plan (index seek)
+     */
+    static eqMatch(matchedRows, indexCost = 0.5) {
+        return new AccessPlanBuilder()
+            .setCost(indexCost + matchedRows * 0.3)
+            .setRows(matchedRows)
+            .setIsSet(matchedRows <= 1)
+            .setExplanation('Index equality seek');
+    }
+    /**
+     * Create a range scan access plan
+     */
+    static rangeScan(estimatedRows, indexCost = 0.3) {
+        return new AccessPlanBuilder()
+            .setCost(indexCost + estimatedRows * 0.5)
+            .setRows(estimatedRows)
+            .setExplanation('Index range scan');
+    }
+    /**
+     * Set the estimated cost of this access plan
+     */
+    setCost(cost) {
+        this.result.cost = cost;
+        return this;
+    }
+    /**
+     * Set the estimated number of rows
+     */
+    setRows(rows) {
+        this.result.rows = rows;
+        return this;
+    }
+    /**
+     * Set which filters are handled by this plan
+     */
+    setHandledFilters(handledFilters) {
+        this.result.handledFilters = handledFilters;
+        return this;
+    }
+    /**
+     * Set the ordering provided by this plan
+     */
+    setOrdering(ordering) {
+        this.result.providesOrdering = ordering;
+        return this;
+    }
+    /**
+     * Set whether this plan produces unique rows
+     */
+    setIsSet(isSet) {
+        this.result.isSet = isSet;
+        return this;
+    }
+    /**
+     * Set an explanation for debugging
+     */
+    setExplanation(explanation) {
+        this.result.explains = explanation;
+        return this;
+    }
+    /**
+     * Set a residual filter function
+     */
+    setResidualFilter(filter) {
+        this.result.residualFilter = filter;
+        return this;
+    }
+    /**
+     * Build the final access plan result
+     */
+    build() {
+        // Ensure required fields are set
+        if (this.result.cost === undefined) {
+            quereusError('Access plan cost must be set', StatusCode.INTERNAL);
+        }
+        if (this.result.handledFilters === undefined) {
+            this.result.handledFilters = [];
+        }
+        return this.result;
+    }
+}
+/**
+ * Validation function for access plan results
+ * Throws if the plan violates basic contracts
+ */
+export function validateAccessPlan(request, result) {
+    // Validate handledFilters array length
+    if (result.handledFilters.length !== request.filters.length) {
+        quereusError(`handledFilters length (${result.handledFilters.length}) must match filters length (${request.filters.length})`, StatusCode.FORMAT);
+    }
+    // Validate cost is non-negative
+    if (result.cost < 0) {
+        quereusError(`Access plan cost cannot be negative: ${result.cost}`, StatusCode.INTERNAL);
+    }
+    // Validate rows is non-negative if specified
+    if (result.rows !== undefined && result.rows < 0) {
+        quereusError(`Access plan rows cannot be negative: ${result.rows}`, StatusCode.INTERNAL);
+    }
+    // Validate ordering column indexes
+    if (result.providesOrdering) {
+        for (const order of result.providesOrdering) {
+            if (order.columnIndex < 0 || order.columnIndex >= request.columns.length) {
+                quereusError(`Invalid ordering column index ${order.columnIndex}, must be 0-${request.columns.length - 1}`, StatusCode.FORMAT);
+            }
+        }
+    }
+}
+/**
+ * Helper to convert old IndexConstraint to new PredicateConstraint
+ * @deprecated Use direct PredicateConstraint construction instead
+ */
+export function convertIndexConstraint(constraint, // Old IndexConstraint type
+value) {
+    // Map old constraint operators to new ones
+    const opMap = {
+        'EQ': '=',
+        'GT': '>',
+        'GE': '>=',
+        'LT': '<',
+        'LE': '<=',
+        'MATCH': 'MATCH',
+        'LIKE': 'LIKE',
+        'GLOB': 'GLOB',
+        'ISNULL': 'IS NULL',
+        'ISNOTNULL': 'IS NOT NULL'
+    };
+    const op = opMap[constraint.op] || '=';
+    return {
+        columnIndex: constraint.iColumn,
+        op,
+        value,
+        usable: constraint.usable
+    };
+}
+//# sourceMappingURL=best-access-plan.js.map

package/dist/src/vtab/best-access-plan.js.map

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

package/dist/src/vtab/connection.d.ts

@@ -0,0 +1,27 @@
+import { MaybePromise } from "../common/types.js";
+/**
+ * Generic interface for VirtualTable connections that support transactions.
+ * This allows different vtab modules to implement their own connection strategies
+ * while providing a consistent interface for transaction operations.
+ */
+export interface VirtualTableConnection {
+    /** Unique identifier for this connection */
+    readonly connectionId: string;
+    /** Name of the table this connection is associated with */
+    readonly tableName: string;
+    /** Begins a transaction on this connection */
+    begin(): MaybePromise<void>;
+    /** Commits the current transaction */
+    commit(): MaybePromise<void>;
+    /** Rolls back the current transaction */
+    rollback(): MaybePromise<void>;
+    /** Creates a savepoint with the given index */
+    createSavepoint(index: number): MaybePromise<void>;
+    /** Releases a savepoint with the given index */
+    releaseSavepoint(index: number): MaybePromise<void>;
+    /** Rolls back to a savepoint with the given index */
+    rollbackToSavepoint(index: number): MaybePromise<void>;
+    /** Disconnects and cleans up this connection */
+    disconnect(): MaybePromise<void>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/vtab/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/vtab/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAG3B,8CAA8C;IAC9C,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE5B,sCAAsC;IACtC,MAAM,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE7B,yCAAyC;IACzC,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAE/B,+CAA+C;IAC/C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEnD,gDAAgD;IAChD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEpD,qDAAqD;IACrD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEvD,gDAAgD;IAChD,UAAU,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;CACjC"}

package/dist/src/vtab/connection.js

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

package/dist/src/vtab/connection.js.map

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

package/dist/src/vtab/filter-info.d.ts

@@ -0,0 +1,26 @@
+import type { SqlValue } from '../common/types.js';
+import type { IndexConstraint, IndexInfo } from './index-info.js';
+/**
+ * Structure to pass all necessary filter and planning information
+ * to a virtual table's xOpen method when cursors are not used.
+ */
+export interface FilterInfo {
+    /** The index number chosen by xBestIndex (output of xBestIndex) */
+    idxNum: number;
+    /** The index string chosen by xBestIndex (output of xBestIndex) */
+    idxStr: string | null;
+    /** Array of WHERE clause constraints (input to xBestIndex/xOpen) */
+    constraints: ReadonlyArray<{
+        constraint: IndexConstraint;
+        argvIndex: number;
+    }>;
+    /** Values for ?. argvIndex in constraints (input to xOpen) */
+    args: ReadonlyArray<SqlValue>;
+    /**
+     * The IndexInfo object AFTER xBestIndex has populated its output fields
+     * (aConstraintUsage, orderByConsumed, estimatedCost, estimatedRows, idxFlags).
+     * This is needed by xOpen to understand how constraints were used by the planner.
+     */
+    indexInfoOutput: IndexInfo;
+}
+//# sourceMappingURL=filter-info.d.ts.map

package/dist/src/vtab/filter-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-info.d.ts","sourceRoot":"","sources":["../../../src/vtab/filter-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,UAAU;IAC1B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,oEAAoE;IACpE,WAAW,EAAE,aAAa,CAAC;QAAE,UAAU,EAAE,eAAe,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,8DAA8D;IAC9D,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC9B;;;;OAIG;IACH,eAAe,EAAE,SAAS,CAAC;CAC3B"}

package/dist/src/vtab/filter-info.js

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

package/dist/src/vtab/filter-info.js.map

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

package/dist/src/vtab/index-info.d.ts

@@ -0,0 +1,69 @@
+import { IndexConstraintOp } from '../common/constants.js';
+/**
+ * Information about a specific constraint in the WHERE clause
+ */
+export interface IndexConstraint {
+    /** Column index constrained (0 based) */
+    iColumn: number;
+    /** Constraint operator (EQ, GT, etc.) */
+    op: IndexConstraintOp;
+    /** True if the constraint expression is usable */
+    usable: boolean;
+    /** Internal offset used by Quereus - ignore in xBestIndex */
+    iTermOffset?: number;
+}
+/**
+ * Information about a term in the ORDER BY clause
+ */
+export interface IndexOrderBy {
+    /** Column index */
+    iColumn: number;
+    /** True for DESC, False for ASC */
+    desc: boolean;
+}
+/**
+ * Usage information for a constraint, filled by xBestIndex
+ */
+export interface IndexConstraintUsage {
+    /** If >0, constraint value becomes the (argvIndex-1)-th arg to xFilter */
+    argvIndex: number;
+    /** If true, Quereus might skip re-checking this constraint */
+    omit: boolean;
+}
+/**
+ * Structure passed to xBestIndex method containing information about
+ * WHERE and ORDER BY clauses relevant to the virtual table.
+ * The xBestIndex method must fill the output fields to describe the chosen query plan.
+ */
+export interface IndexInfo {
+    /** Number of entries in aConstraint */
+    nConstraint: number;
+    /** Array of WHERE clause constraints */
+    aConstraint: ReadonlyArray<IndexConstraint>;
+    /** Number of terms in the ORDER BY clause */
+    nOrderBy: number;
+    /** Array of ORDER BY terms */
+    aOrderBy: ReadonlyArray<IndexOrderBy>;
+    /** Mask of columns used by the statement (bit N set if column N is used) */
+    colUsed: bigint;
+    /** Usage details for each constraint */
+    aConstraintUsage: IndexConstraintUsage[];
+    /** Number identifying the chosen index strategy (passed to xFilter) */
+    idxNum: number;
+    /** String identifying the chosen index strategy (passed to xFilter) */
+    idxStr: string | null;
+    /** True if output from xFilter/xNext will satisfy ORDER BY */
+    orderByConsumed: boolean;
+    /** Estimated cost of this strategy (lower is better) */
+    estimatedCost: number;
+    /** Estimated number of rows returned by this strategy */
+    estimatedRows: bigint;
+    /** Mask of SQLITE_INDEX_SCAN_* flags */
+    idxFlags: number;
+}
+/** Flags for IndexInfo.idxFlags */
+export declare enum IndexScanFlags {
+    /** Scan visits at most 1 row */
+    UNIQUE = 1
+}
+//# sourceMappingURL=index-info.d.ts.map

package/dist/src/vtab/index-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-info.d.ts","sourceRoot":"","sources":["../../../src/vtab/index-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,EAAE,EAAE,iBAAiB,CAAC;IACtB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IAGzB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAE5C,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IAEtC,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAIhB,wCAAwC;IACxC,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IAEzC,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,8DAA8D;IAC9D,eAAe,EAAE,OAAO,CAAC;IAEzB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IAEtB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,mCAAmC;AACnC,oBAAY,cAAc;IACzB,gCAAgC;IAChC,MAAM,IAAS;CACf"}

package/dist/src/vtab/index-info.js

@@ -0,0 +1,7 @@
+/** Flags for IndexInfo.idxFlags */
+export var IndexScanFlags;
+(function (IndexScanFlags) {
+    /** Scan visits at most 1 row */
+    IndexScanFlags[IndexScanFlags["UNIQUE"] = 1] = "UNIQUE";
+})(IndexScanFlags || (IndexScanFlags = {}));
+//# sourceMappingURL=index-info.js.map

package/dist/src/vtab/index-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-info.js","sourceRoot":"","sources":["../../../src/vtab/index-info.ts"],"names":[],"mappings":"AA+EA,mCAAmC;AACnC,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACzB,gCAAgC;IAChC,uDAAe,CAAA;AAChB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/dist/src/vtab/manifest.d.ts

@@ -0,0 +1,35 @@
+import type { SqlValue } from '../common/types.js';
+/**
+ * Configuration setting definition for a plugin
+ */
+export interface PluginSetting {
+    key: string;
+    label: string;
+    type: 'string' | 'number' | 'boolean' | 'select';
+    default?: SqlValue;
+    options?: SqlValue[];
+    help?: string;
+}
+/**
+ * Plugin manifest that describes the plugin's metadata and configuration options
+ */
+export interface PluginManifest {
+    name: string;
+    version: string;
+    author?: string;
+    description?: string;
+    pragmaPrefix?: string;
+    settings?: PluginSetting[];
+    capabilities?: string[];
+}
+/**
+ * Plugin record used for persistence across sessions
+ */
+export interface PluginRecord {
+    id: string;
+    url: string;
+    enabled: boolean;
+    manifest?: PluginManifest;
+    config: Record<string, SqlValue>;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/vtab/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/vtab/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACjD,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACjC"}

package/dist/src/vtab/manifest.js

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

package/dist/src/vtab/manifest.js.map

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

package/dist/src/vtab/memory/connection.d.ts

@@ -0,0 +1,29 @@
+import type { VirtualTableConnection } from '../connection.js';
+import type { MemoryTableConnection } from './layer/connection.js';
+/**
+ * VirtualTableConnection implementation for memory tables.
+ * Wraps the existing MemoryTableConnection to provide the generic interface.
+ */
+export declare class MemoryVirtualTableConnection implements VirtualTableConnection {
+    readonly connectionId: string;
+    readonly tableName: string;
+    private memoryConnection;
+    constructor(tableName: string, memoryConnection: MemoryTableConnection);
+    /** Begins a transaction on this connection */
+    begin(): void;
+    /** Commits the current transaction */
+    commit(): Promise<void>;
+    /** Rolls back the current transaction */
+    rollback(): void;
+    /** Creates a savepoint with the given index */
+    createSavepoint(index: number): void;
+    /** Releases a savepoint with the given index */
+    releaseSavepoint(index: number): void;
+    /** Rolls back to a savepoint with the given index */
+    rollbackToSavepoint(index: number): void;
+    /** Disconnects and cleans up this connection */
+    disconnect(): Promise<void>;
+    /** Gets the underlying MemoryTableConnection for internal use */
+    getMemoryConnection(): MemoryTableConnection;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/vtab/memory/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/vtab/memory/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAKnE;;;GAGG;AACH,qBAAa,4BAA6B,YAAW,sBAAsB;IAC1E,SAAgB,YAAY,EAAE,MAAM,CAAC;IACrC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,OAAO,CAAC,gBAAgB,CAAwB;gBAEpC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,qBAAqB;IAMtE,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAKb,sCAAsC;IAChC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,yCAAyC;IACzC,QAAQ,IAAI,IAAI;IAKhB,+CAA+C;IAC/C,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKpC,gDAAgD;IAChD,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKrC,qDAAqD;IACrD,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxC,gDAAgD;IAC1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,iEAAiE;IACjE,mBAAmB,IAAI,qBAAqB;CAG5C"}

package/dist/src/vtab/memory/connection.js

@@ -0,0 +1,61 @@
+import { createLogger } from '../../common/logger.js';
+const log = createLogger('vtab:memory:vtab-connection');
+/**
+ * VirtualTableConnection implementation for memory tables.
+ * Wraps the existing MemoryTableConnection to provide the generic interface.
+ */
+export class MemoryVirtualTableConnection {
+    connectionId;
+    tableName;
+    memoryConnection;
+    constructor(tableName, memoryConnection) {
+        this.connectionId = `memory-${tableName}-${memoryConnection.connectionId}`;
+        this.tableName = tableName;
+        this.memoryConnection = memoryConnection;
+    }
+    /** Begins a transaction on this connection */
+    begin() {
+        log(`BEGIN transaction on connection ${this.connectionId}`);
+        this.memoryConnection.begin();
+    }
+    /** Commits the current transaction */
+    async commit() {
+        log(`COMMIT transaction on connection ${this.connectionId}`);
+        await this.memoryConnection.commit();
+    }
+    /** Rolls back the current transaction */
+    rollback() {
+        log(`ROLLBACK transaction on connection ${this.connectionId}`);
+        this.memoryConnection.rollback();
+    }
+    /** Creates a savepoint with the given index */
+    createSavepoint(index) {
+        log(`CREATE SAVEPOINT ${index} on connection ${this.connectionId}`);
+        this.memoryConnection.createSavepoint(index);
+    }
+    /** Releases a savepoint with the given index */
+    releaseSavepoint(index) {
+        log(`RELEASE SAVEPOINT ${index} on connection ${this.connectionId}`);
+        this.memoryConnection.releaseSavepoint(index);
+    }
+    /** Rolls back to a savepoint with the given index */
+    rollbackToSavepoint(index) {
+        log(`ROLLBACK TO SAVEPOINT ${index} on connection ${this.connectionId}`);
+        this.memoryConnection.rollbackToSavepoint(index);
+    }
+    /** Disconnects and cleans up this connection */
+    async disconnect() {
+        log(`DISCONNECT connection ${this.connectionId}`);
+        // The MemoryTableConnection doesn't have a disconnect method,
+        // but we can clear any pending transaction state
+        if (this.memoryConnection.pendingTransactionLayer) {
+            log(`Rolling back pending transaction on disconnect for ${this.connectionId}`);
+            this.memoryConnection.rollback();
+        }
+    }
+    /** Gets the underlying MemoryTableConnection for internal use */
+    getMemoryConnection() {
+        return this.memoryConnection;
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/src/vtab/memory/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/vtab/memory/connection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,GAAG,GAAG,YAAY,CAAC,6BAA6B,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,OAAO,4BAA4B;IACxB,YAAY,CAAS;IACrB,SAAS,CAAS;IAC1B,gBAAgB,CAAwB;IAEhD,YAAY,SAAiB,EAAE,gBAAuC;QACrE,IAAI,CAAC,YAAY,GAAG,UAAU,SAAS,IAAI,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAC3E,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,KAAK;QACJ,GAAG,CAAC,mCAAmC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,MAAM;QACX,GAAG,CAAC,oCAAoC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;IACtC,CAAC;IAED,yCAAyC;IACzC,QAAQ;QACP,GAAG,CAAC,sCAAsC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IAED,+CAA+C;IAC/C,eAAe,CAAC,KAAa;QAC5B,GAAG,CAAC,oBAAoB,KAAK,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,gDAAgD;IAChD,gBAAgB,CAAC,KAAa;QAC7B,GAAG,CAAC,qBAAqB,KAAK,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,qDAAqD;IACrD,mBAAmB,CAAC,KAAa;QAChC,GAAG,CAAC,yBAAyB,KAAK,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,UAAU;QACf,GAAG,CAAC,yBAAyB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAClD,8DAA8D;QAC9D,iDAAiD;QACjD,IAAI,IAAI,CAAC,gBAAgB,CAAC,uBAAuB,EAAE,CAAC;YACnD,GAAG,CAAC,sDAAsD,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC;IACF,CAAC;IAED,iEAAiE;IACjE,mBAAmB;QAClB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC9B,CAAC;CACD"}

package/dist/src/vtab/memory/index.d.ts

@@ -0,0 +1,38 @@
+import { BTree } from 'inheritree';
+import { type Row } from '../../common/types.js';
+import type { BTreeKeyForPrimary, BTreeKeyForIndex, MemoryIndexEntry } from './types.js';
+import type { IndexColumnSchema as IndexColumnSpec } from '../../schema/table.js';
+import type { ColumnSchema } from '../../schema/column.js';
+/** Definition for creating a memory index (matches IndexSchema columns usually) */
+export interface IndexSpec {
+    name?: string;
+    columns: ReadonlyArray<IndexColumnSpec>;
+}
+/** Represents a secondary index within a MemoryTable */
+export declare class MemoryIndex {
+    readonly name: string | undefined;
+    readonly specColumns: ReadonlyArray<IndexColumnSpec>;
+    readonly keyFromRow: (row: Row) => BTreeKeyForIndex;
+    readonly compareKeys: (a: BTreeKeyForIndex, b: BTreeKeyForIndex) => number;
+    data: BTree<BTreeKeyForIndex, MemoryIndexEntry>;
+    constructor(spec: IndexSpec, allTableColumnsSchema: ReadonlyArray<ColumnSchema>, baseInheritreeTable?: BTree<BTreeKeyForIndex, MemoryIndexEntry>);
+    private validateColumnIndexes;
+    private createIndexKeyFunctions;
+    private createSingleColumnKeyFunctions;
+    private createCompositeColumnKeyFunctions;
+    private validateRowLength;
+    private createBTree;
+    /** Adds a mapping from index key to primary key */
+    addEntry(indexKey: BTreeKeyForIndex, primaryKey: BTreeKeyForPrimary): void;
+    /** Removes a mapping from index key to primary key */
+    removeEntry(indexKey: BTreeKeyForIndex, primaryKey: BTreeKeyForPrimary): void;
+    /** Returns the primary keys for a given index key */
+    getPrimaryKeys(indexKey: BTreeKeyForIndex): BTreeKeyForPrimary[];
+    /** Gets the count of unique index values */
+    get size(): number;
+    /** Clears all entries from the index */
+    clear(): void;
+    /** Clears the base inheritance for this index (used during layer collapse) */
+    clearBase(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/vtab/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/vtab/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAc,KAAK,GAAG,EAAiB,MAAM,uBAAuB,CAAC;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,iBAAiB,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;CACxC;AAQD,wDAAwD;AACxD,qBAAa,WAAW;IACvB,SAAgB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,SAAgB,WAAW,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC5D,SAAgB,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,gBAAgB,CAAC;IAC3D,SAAgB,WAAW,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC3E,IAAI,EAAE,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;gBAE3C,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC,EAAE,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAahJ,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,8BAA8B;IAkBtC,OAAO,CAAC,iCAAiC;IAgCzC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;IAQnB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAgB1E,sDAAsD;IACtD,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAa7E,qDAAqD;IACrD,cAAc,CAAC,QAAQ,EAAE,gBAAgB,GAAG,kBAAkB,EAAE;IAKhE,4CAA4C;IAC5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,wCAAwC;IACxC,KAAK,IAAI,IAAI;IAKb,8EAA8E;IAC9E,SAAS,IAAI,IAAI;CAKjB"}

package/dist/src/vtab/memory/index.js

@@ -0,0 +1,132 @@
+import { BTree } from 'inheritree';
+import { StatusCode } from '../../common/types.js';
+import { compareSqlValues } from '../../util/comparison.js';
+import { quereusError } from '../../common/errors.js';
+/** Represents a secondary index within a MemoryTable */
+export class MemoryIndex {
+    name;
+    specColumns;
+    keyFromRow;
+    compareKeys;
+    data;
+    constructor(spec, allTableColumnsSchema, baseInheritreeTable) {
+        this.name = spec.name;
+        this.specColumns = Object.freeze(spec.columns.map(c => ({ ...c })));
+        this.validateColumnIndexes(allTableColumnsSchema);
+        const keyFunctions = this.createIndexKeyFunctions();
+        this.keyFromRow = keyFunctions.keyFromRow;
+        this.compareKeys = keyFunctions.compareKeys;
+        this.data = this.createBTree(baseInheritreeTable);
+    }
+    validateColumnIndexes(allTableColumnsSchema) {
+        const hasInvalidIndex = this.specColumns.some(sc => sc.index < 0 || sc.index >= allTableColumnsSchema.length);
+        if (hasInvalidIndex) {
+            quereusError(`Invalid column index in index '${this.name ?? '(unnamed)'}'.`, StatusCode.INTERNAL);
+        }
+    }
+    createIndexKeyFunctions() {
+        if (this.specColumns.length === 1) {
+            return this.createSingleColumnKeyFunctions();
+        }
+        else {
+            return this.createCompositeColumnKeyFunctions();
+        }
+    }
+    createSingleColumnKeyFunctions() {
+        const specCol = this.specColumns[0];
+        const colSchemaIndex = specCol.index;
+        const collation = specCol.collation || 'BINARY';
+        const descMultiplier = specCol.desc ? -1 : 1;
+        const keyFromRow = (row) => {
+            this.validateRowLength(row, colSchemaIndex);
+            return row[colSchemaIndex];
+        };
+        const compareKeys = (a, b) => {
+            return compareSqlValues(a, b, collation) * descMultiplier;
+        };
+        return { keyFromRow, compareKeys };
+    }
+    createCompositeColumnKeyFunctions() {
+        const localSpecColumns = this.specColumns;
+        const keyFromRow = (row) => {
+            return localSpecColumns.map(sc => {
+                this.validateRowLength(row, sc.index);
+                return row[sc.index];
+            });
+        };
+        const compareKeys = (a, b) => {
+            const arrA = a;
+            const arrB = b;
+            for (let i = 0; i < localSpecColumns.length; i++) {
+                if (i >= arrA.length || i >= arrB.length) {
+                    return arrA.length - arrB.length;
+                }
+                const specCol = localSpecColumns[i];
+                const comparison = compareSqlValues(arrA[i], arrB[i], specCol.collation || 'BINARY');
+                if (comparison !== 0) {
+                    return specCol.desc ? -comparison : comparison;
+                }
+            }
+            return 0;
+        };
+        return { keyFromRow, compareKeys };
+    }
+    validateRowLength(row, columnIndex) {
+        if (columnIndex < 0 || columnIndex >= row.length) {
+            quereusError(`Index key col index ${columnIndex} OOB for row len ${row.length}`, StatusCode.INTERNAL);
+        }
+    }
+    createBTree(baseInheritreeTable) {
+        return new BTree((entry) => entry.indexKey, this.compareKeys, baseInheritreeTable);
+    }
+    /** Adds a mapping from index key to primary key */
+    addEntry(indexKey, primaryKey) {
+        const path = this.data.find(indexKey);
+        if (path.on) {
+            // Entry exists, add to the existing set of primary keys
+            const existingEntry = this.data.at(path);
+            existingEntry.primaryKeys.add(primaryKey);
+        }
+        else {
+            // Create new entry with a Set containing the primary key
+            const newEntry = {
+                indexKey,
+                primaryKeys: new Set([primaryKey])
+            };
+            this.data.insert(newEntry);
+        }
+    }
+    /** Removes a mapping from index key to primary key */
+    removeEntry(indexKey, primaryKey) {
+        const path = this.data.find(indexKey);
+        if (path.on) {
+            const entry = this.data.at(path);
+            entry.primaryKeys.delete(primaryKey);
+            // If no primary keys remain, remove the entire entry
+            if (entry.primaryKeys.size === 0) {
+                this.data.deleteAt(path);
+            }
+        }
+    }
+    /** Returns the primary keys for a given index key */
+    getPrimaryKeys(indexKey) {
+        const entry = this.data.get(indexKey);
+        return entry ? Array.from(entry.primaryKeys) : [];
+    }
+    /** Gets the count of unique index values */
+    get size() {
+        return this.data.getCount();
+    }
+    /** Clears all entries from the index */
+    clear() {
+        const base = this.data.baseTable;
+        this.data = this.createBTree(base);
+    }
+    /** Clears the base inheritance for this index (used during layer collapse) */
+    clearBase() {
+        if (typeof this.data.clearBase === 'function') {
+            this.data.clearBase();
+        }
+    }
+}
+//# sourceMappingURL=index.js.map