@quereus/quereus 0.1.0

package/dist/src/runtime/utils.js

@@ -0,0 +1,117 @@
+import { QuereusError } from '../common/errors.js';
+import { StatusCode } from '../common/types.js';
+import { createLogger } from '../common/logger.js';
+const log = createLogger('runtime:utils');
+const errorLog = log.extend('error');
+export const ctxLog = createLogger('runtime:context');
+export function isAsyncIterable(value) {
+    return typeof value === 'object' && value !== null && Symbol.asyncIterator in value;
+}
+export async function asyncIterableToArray(iterable) {
+    const result = [];
+    for await (const item of iterable) {
+        result.push(item);
+    }
+    return result;
+}
+/**
+ * Helper to get or create a VirtualTable connection for a given table.
+ * This ensures transaction consistency by reusing connections within the same context.
+ */
+export async function getVTableConnection(ctx, tableSchema) {
+    const tableName = tableSchema.name; // Use just the table name, not fully qualified
+    // Check if we already have an active connection for this table
+    const existingConnections = ctx.db.getConnectionsForTable(tableName);
+    if (existingConnections.length > 0) {
+        log(`Reusing existing connection for table ${tableName}`);
+        return existingConnections[0];
+    }
+    // Create a new VirtualTable instance
+    const vtab = await getVTable(ctx, tableSchema);
+    // Try to create a connection if the table supports it
+    let connection;
+    if (vtab.createConnection) {
+        connection = await vtab.createConnection();
+        log(`Created new connection ${connection.connectionId} for table ${tableName}`);
+    }
+    else if (vtab.getConnection) {
+        const existingConn = vtab.getConnection();
+        if (existingConn) {
+            connection = existingConn;
+            log(`Using existing internal connection ${connection.connectionId} for table ${tableName}`);
+        }
+        else {
+            throw new QuereusError(`Table '${tableName}' does not support connections`, StatusCode.INTERNAL);
+        }
+    }
+    else {
+        throw new QuereusError(`Table '${tableName}' does not support connections`, StatusCode.INTERNAL);
+    }
+    // Register the connection with the database
+    await ctx.db.registerConnection(connection);
+    // Set as the active connection in the runtime context if none is set
+    if (!ctx.activeConnection) {
+        ctx.activeConnection = connection;
+    }
+    return connection;
+}
+/**
+ * Helper to get the VirtualTable instance for a given TableReferenceNode.
+ * This is the legacy method that creates ephemeral instances.
+ * When reusing connections, this will also inject the existing connection into the VirtualTable.
+ */
+export async function getVTable(ctx, tableSchema) {
+    // All tables are virtual, so vtabModuleName should always be present.
+    if (!tableSchema.vtabModuleName) {
+        throw new QuereusError(`Table schema for '${tableSchema.name}' is missing vtabModuleName.`, StatusCode.INTERNAL);
+    }
+    const moduleInfo = ctx.db._getVtabModule(tableSchema.vtabModuleName);
+    if (!moduleInfo) {
+        throw new QuereusError(`Virtual table module '${tableSchema.vtabModuleName}' not found for table '${tableSchema.name}'`, StatusCode.ERROR);
+    }
+    const module = moduleInfo.module;
+    if (typeof module.xConnect !== 'function') {
+        throw new QuereusError(`Virtual table module '${tableSchema.vtabModuleName}' does not implement xConnect`, StatusCode.MISUSE);
+    }
+    const vtabArgs = tableSchema.vtabArgs || {};
+    const vtabInstance = module.xConnect(ctx.db, moduleInfo.auxData, tableSchema.vtabModuleName, tableSchema.schemaName, tableSchema.name, vtabArgs);
+    // If we have an active connection for this table, inject it into the VirtualTable
+    const tableName = tableSchema.name;
+    const existingConnections = ctx.db.getConnectionsForTable(tableName);
+    if (existingConnections.length > 0 && tableSchema.vtabModuleName === 'memory') {
+        const memoryConnection = existingConnections[0];
+        const memoryTable = vtabInstance;
+        if (memoryConnection.getMemoryConnection && memoryTable.setConnection) {
+            memoryTable.setConnection(memoryConnection.getMemoryConnection());
+            log(`Injected existing connection into VirtualTable for table ${tableName}`);
+        }
+    }
+    return vtabInstance;
+}
+/**
+ * Helper to properly disconnect and unregister a VirtualTable instance.
+ */
+export async function disconnectVTable(ctx, vtab) {
+    // Disconnect the VirtualTable instance
+    if (typeof vtab.xDisconnect === 'function') {
+        await vtab.xDisconnect().catch((e) => {
+            errorLog(`Error during xDisconnect for table '${vtab.tableName}': ${e}`);
+        });
+    }
+}
+/**
+ * Helper function to log context push operations
+ */
+export function logContextPush(descriptor, note, attributes) {
+    const attrs = Object.keys(descriptor).filter(k => descriptor[parseInt(k)] !== undefined);
+    const attrNames = attributes ? attributes.map(attr => `${attr.name}(#${attr.id})`).join(',') : 'unknown';
+    ctxLog('PUSH context %s: attrs=[%s] names=[%s]', note, attrs.join(','), attrNames);
+}
+/**
+ * Helper function to log context pop operations
+ */
+export function logContextPop(descriptor, note) {
+    const attrs = Object.keys(descriptor).filter(k => descriptor[parseInt(k)] !== undefined);
+    ctxLog('POP context %s: attrs=[%s]', note, attrs.join(','));
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/runtime/utils.js.map

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

package/dist/src/schema/change-events.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Represents a schema change event.
+ */
+export interface SchemaChangeEvent {
+    type: 'table_added' | 'table_removed' | 'table_modified' | 'function_added' | 'function_removed' | 'function_modified' | 'module_added' | 'module_removed' | 'collation_added' | 'collation_removed';
+    schemaName?: string;
+    objectName: string;
+    oldObject?: any;
+    newObject?: any;
+}
+/**
+ * Function that handles schema change events.
+ */
+export type SchemaChangeListener = (event: SchemaChangeEvent) => void;
+/**
+ * Manages schema change listeners and notifications.
+ */
+export declare class SchemaChangeNotifier {
+    private listeners;
+    /**
+     * Adds a schema change listener.
+     * @returns A function to unsubscribe the listener.
+     */
+    addListener(listener: SchemaChangeListener): () => void;
+    /**
+     * Removes a schema change listener.
+     */
+    removeListener(listener: SchemaChangeListener): void;
+    /**
+     * Notifies all listeners of a schema change event.
+     */
+    notifyChange(event: SchemaChangeEvent): void;
+    /**
+     * Gets the number of active listeners.
+     */
+    getListenerCount(): number;
+    /**
+     * Clears all listeners.
+     */
+    clearListeners(): void;
+}
+//# sourceMappingURL=change-events.d.ts.map

package/dist/src/schema/change-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-events.d.ts","sourceRoot":"","sources":["../../../src/schema/change-events.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,aAAa,GAAG,eAAe,GAAG,gBAAgB,GAClD,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,GAC3D,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,qBAAa,oBAAoB;IAChC,OAAO,CAAC,SAAS,CAAmC;IAEpD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAMvD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAOpD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAa5C;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,cAAc,IAAI,IAAI;CAKtB"}

package/dist/src/schema/change-events.js

@@ -0,0 +1,55 @@
+import { createLogger } from '../common/logger.js';
+const log = createLogger('schema:change-events');
+/**
+ * Manages schema change listeners and notifications.
+ */
+export class SchemaChangeNotifier {
+    listeners = new Set();
+    /**
+     * Adds a schema change listener.
+     * @returns A function to unsubscribe the listener.
+     */
+    addListener(listener) {
+        this.listeners.add(listener);
+        log('Added schema change listener, total listeners: %d', this.listeners.size);
+        return () => this.removeListener(listener);
+    }
+    /**
+     * Removes a schema change listener.
+     */
+    removeListener(listener) {
+        const removed = this.listeners.delete(listener);
+        if (removed) {
+            log('Removed schema change listener, total listeners: %d', this.listeners.size);
+        }
+    }
+    /**
+     * Notifies all listeners of a schema change event.
+     */
+    notifyChange(event) {
+        log('Notifying %d listeners of schema change: %s %s', this.listeners.size, event.type, event.objectName);
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                log('Error in schema change listener: %s', error);
+            }
+        }
+    }
+    /**
+     * Gets the number of active listeners.
+     */
+    getListenerCount() {
+        return this.listeners.size;
+    }
+    /**
+     * Clears all listeners.
+     */
+    clearListeners() {
+        const count = this.listeners.size;
+        this.listeners.clear();
+        log('Cleared all %d schema change listeners', count);
+    }
+}
+//# sourceMappingURL=change-events.js.map

package/dist/src/schema/change-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-events.js","sourceRoot":"","sources":["../../../src/schema/change-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,GAAG,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC;AAoBjD;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACxB,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEpD;;;OAGG;IACH,WAAW,CAAC,QAA8B;QACzC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,GAAG,CAAC,mDAAmD,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9E,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAA8B;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,OAAO,EAAE,CAAC;YACb,GAAG,CAAC,qDAAqD,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAwB;QACpC,GAAG,CAAC,gDAAgD,EACnD,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAEpD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,IAAI,CAAC;gBACJ,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,GAAG,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;IACF,CAAC;IAED;;OAEG;IACH,gBAAgB;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,cAAc;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;CACD"}

package/dist/src/schema/column.d.ts

@@ -0,0 +1,33 @@
+import { SqlDataType } from '../common/types.js';
+import type { Expression } from '../parser/ast.js';
+/**
+ * Represents the schema definition of a single column in a table.
+ */
+export interface ColumnSchema {
+    /** Column name */
+    name: string;
+    /** Data type affinity (TEXT, INTEGER, REAL, BLOB, NUMERIC) */
+    affinity: SqlDataType;
+    /** Whether the column has a NOT NULL constraint */
+    notNull: boolean;
+    /** Whether the column is part of the primary key */
+    primaryKey: boolean;
+    /** Order within the primary key (1-based) or 0 if not PK */
+    pkOrder: number;
+    /** Default value expression */
+    defaultValue: Expression | null;
+    /** Declared collation sequence name (e.g., "BINARY", "NOCASE", "RTRIM") */
+    collation: string;
+    /** Is the column generated? */
+    generated: boolean;
+}
+/**
+ * Creates a default ColumnSchema with basic properties
+ * Following Third Manifesto principles, columns default to NOT NULL unless explicitly specified otherwise
+ *
+ * @param name The name for the column
+ * @param defaultNotNull Whether columns should be NOT NULL by default (defaults to true for Third Manifesto compliance)
+ * @returns A new column schema with default values
+ */
+export declare function createDefaultColumnSchema(name: string, defaultNotNull?: boolean): ColumnSchema;
+//# sourceMappingURL=column.d.ts.map

package/dist/src/schema/column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.d.ts","sourceRoot":"","sources":["../../../src/schema/column.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,QAAQ,EAAE,WAAW,CAAC;IACtB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,GAAE,OAAc,GAAG,YAAY,CAWpG"}

package/dist/src/schema/column.js

@@ -0,0 +1,22 @@
+import { SqlDataType } from '../common/types.js';
+/**
+ * Creates a default ColumnSchema with basic properties
+ * Following Third Manifesto principles, columns default to NOT NULL unless explicitly specified otherwise
+ *
+ * @param name The name for the column
+ * @param defaultNotNull Whether columns should be NOT NULL by default (defaults to true for Third Manifesto compliance)
+ * @returns A new column schema with default values
+ */
+export function createDefaultColumnSchema(name, defaultNotNull = true) {
+    return {
+        name: name,
+        affinity: SqlDataType.TEXT,
+        notNull: defaultNotNull, // Third Manifesto: default to NOT NULL
+        primaryKey: false,
+        pkOrder: 0,
+        defaultValue: null,
+        collation: 'BINARY', // SQLite's default
+        generated: false,
+    };
+}
+//# sourceMappingURL=column.js.map

package/dist/src/schema/column.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column.js","sourceRoot":"","sources":["../../../src/schema/column.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAyBjD;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,iBAA0B,IAAI;IACrF,OAAO;QACN,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,WAAW,CAAC,IAAI;QAC1B,OAAO,EAAE,cAAc,EAAE,uCAAuC;QAChE,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,IAAI;QAClB,SAAS,EAAE,QAAQ,EAAE,mBAAmB;QACxC,SAAS,EAAE,KAAK;KAChB,CAAC;AACH,CAAC"}

package/dist/src/schema/function.d.ts

@@ -0,0 +1,109 @@
+import type { MaybePromise, Row, SqlValue } from '../common/types.js';
+import { FunctionFlags } from '../common/constants.js';
+import { SqlDataType } from '../common/types.js';
+import type { Database } from '../core/database.js';
+import type { BaseType, ScalarType, RelationType } from '../common/datatype.js';
+/**
+ * Type for a scalar function implementation.
+ */
+export type ScalarFunc = (...args: SqlValue[]) => MaybePromise<SqlValue>;
+/**
+ * Type for a table-valued function implementation.
+ */
+export type TableValuedFunc = (...args: SqlValue[]) => MaybePromise<AsyncIterable<Row>>;
+/**
+ * Type for a database-aware table-valued function implementation.
+ * Takes a database instance and SQL values, returns an async iterable of rows.
+ */
+export type IntegratedTableValuedFunc = (db: Database, ...args: SqlValue[]) => MaybePromise<AsyncIterable<Row>>;
+/**
+ * Type for aggregate step function.
+ */
+export type AggregateReducer<T = any> = (accumulator: T, ...args: SqlValue[]) => T;
+/**
+ * Type for aggregate finalizer function.
+ */
+export type AggregateFinalizer<T = any> = (accumulator: T) => SqlValue;
+/**
+ * Base interface for all function schemas with common properties.
+ */
+interface BaseFunctionSchema {
+    /** Function name (lowercase for consistent lookup) */
+    name: string;
+    /** Number of arguments (-1 for variable) */
+    numArgs: number;
+    /** Combination of FunctionFlags */
+    flags: FunctionFlags;
+    /** User data pointer passed during registration */
+    userData?: unknown;
+    /** Return type information */
+    returnType: BaseType;
+}
+/**
+ * Schema for scalar functions that return a single value.
+ */
+export interface ScalarFunctionSchema extends BaseFunctionSchema {
+    returnType: ScalarType;
+    /** Direct scalar function implementation */
+    implementation: ScalarFunc;
+}
+/**
+ * Schema for table-valued functions that return rows.
+ */
+export interface TableValuedFunctionSchema extends BaseFunctionSchema {
+    returnType: RelationType;
+    /** Table-valued function implementation */
+    implementation: TableValuedFunc | IntegratedTableValuedFunc;
+    /** Whether this TVF requires database access as first parameter */
+    isIntegrated?: boolean;
+}
+/**
+ * Schema for aggregate functions.
+ */
+export interface AggregateFunctionSchema extends BaseFunctionSchema {
+    returnType: ScalarType;
+    /** Aggregate step function */
+    stepFunction: AggregateReducer;
+    /** Aggregate finalizer function */
+    finalizeFunction: AggregateFinalizer;
+    /** Initial accumulator value for aggregates */
+    initialValue?: any;
+}
+/**
+ * Schema for window functions (for future use).
+ */
+export interface WindowFunctionSchema extends BaseFunctionSchema {
+    returnType: ScalarType;
+    /** Window function implementation */
+    implementation: (...args: any[]) => any;
+}
+/**
+ * Union type representing all possible function schemas.
+ */
+export type FunctionSchema = ScalarFunctionSchema | TableValuedFunctionSchema | AggregateFunctionSchema | WindowFunctionSchema;
+/**
+ * Type guards for function schema types.
+ */
+export declare function isScalarFunctionSchema(schema: FunctionSchema): schema is ScalarFunctionSchema;
+export declare function isTableValuedFunctionSchema(schema: FunctionSchema): schema is TableValuedFunctionSchema;
+export declare function isAggregateFunctionSchema(schema: FunctionSchema): schema is AggregateFunctionSchema;
+export declare function isWindowFunctionSchema(schema: FunctionSchema): schema is WindowFunctionSchema;
+/**
+ * Creates a consistent key for storing/looking up functions
+ *
+ * @param name Function name
+ * @param numArgs Number of arguments (-1 for variable argument count)
+ * @returns A string key in the format "name/numArgs"
+ */
+export declare function getFunctionKey(name: string, numArgs: number): string;
+/**
+ * @deprecated Use RelationType.columns instead
+ * Column information for table-valued functions.
+ */
+export interface TVFColumnInfo {
+    name: string;
+    type: SqlDataType;
+    nullable?: boolean;
+}
+export {};
+//# sourceMappingURL=function.d.ts.map

package/dist/src/schema/function.d.ts.map

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

package/dist/src/schema/function.js

@@ -0,0 +1,26 @@
+/**
+ * Type guards for function schema types.
+ */
+export function isScalarFunctionSchema(schema) {
+    return schema.returnType.typeClass === 'scalar' && 'implementation' in schema && typeof schema.implementation === 'function';
+}
+export function isTableValuedFunctionSchema(schema) {
+    return schema.returnType.typeClass === 'relation';
+}
+export function isAggregateFunctionSchema(schema) {
+    return 'stepFunction' in schema && 'finalizeFunction' in schema;
+}
+export function isWindowFunctionSchema(schema) {
+    return 'implementation' in schema && schema.returnType.typeClass === 'scalar' && !isScalarFunctionSchema(schema) && !isAggregateFunctionSchema(schema);
+}
+/**
+ * Creates a consistent key for storing/looking up functions
+ *
+ * @param name Function name
+ * @param numArgs Number of arguments (-1 for variable argument count)
+ * @returns A string key in the format "name/numArgs"
+ */
+export function getFunctionKey(name, numArgs) {
+    return `${name.toLowerCase()}/${numArgs}`;
+}
+//# sourceMappingURL=function.js.map

package/dist/src/schema/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../src/schema/function.ts"],"names":[],"mappings":"AAmGA;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsB;IAC5D,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,KAAK,QAAQ,IAAI,gBAAgB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU,CAAC;AAC9H,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,MAAsB;IACjE,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,KAAK,UAAU,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAsB;IAC/D,OAAO,cAAc,IAAI,MAAM,IAAI,kBAAkB,IAAI,MAAM,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAsB;IAC5D,OAAO,gBAAgB,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;AACxJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAe;IAC3D,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;AAC3C,CAAC"}

package/dist/src/schema/manager.d.ts

@@ -0,0 +1,222 @@
+import { Schema } from './schema.js';
+import type { Database } from '../core/database.js';
+import type { TableSchema } from './table.js';
+import type { FunctionSchema } from './function.js';
+import { type SqlValue } from '../common/types.js';
+import type { VirtualTableModule, BaseModuleConfig } from '../vtab/module.js';
+import type { ViewSchema } from './view.js';
+import type * as AST from '../parser/ast.js';
+import { SchemaChangeNotifier } from './change-events.js';
+/**
+ * Generic options passed to VTab modules during CREATE TABLE.
+ * Modules are responsible for interpreting these.
+ */
+export interface GenericModuleCallOptions extends BaseModuleConfig {
+    moduleArgs?: readonly string[];
+    statementColumns?: readonly AST.ColumnDef[];
+    statementConstraints?: readonly AST.TableConstraint[];
+    isTemporary?: boolean;
+}
+/**
+ * Manages all schemas associated with a database connection (main, temp, attached).
+ * Handles lookup resolution according to SQLite's rules.
+ */
+export declare class SchemaManager {
+    private schemas;
+    private currentSchemaName;
+    private modules;
+    private defaultVTabModuleName;
+    private defaultVTabModuleArgs;
+    private db;
+    private changeNotifier;
+    /**
+     * Creates a new schema manager
+     *
+     * @param db Reference to the parent Database instance
+     */
+    constructor(db: Database);
+    /**
+     * Sets the current default schema for unqualified names
+     *
+     * @param name Schema name to set as current
+     */
+    setCurrentSchema(name: string): void;
+    /**
+     * Gets the name of the current default schema
+     *
+     * @returns Current schema name
+     */
+    getCurrentSchemaName(): string;
+    /**
+     * Registers a virtual table module
+     *
+     * @param name Module name
+     * @param module Module implementation
+     * @param auxData Optional client data associated with the module registration
+     */
+    registerModule(name: string, module: VirtualTableModule<any, any>, auxData?: unknown): void;
+    /**
+     * Retrieves a registered virtual table module by name
+     *
+     * @param name Module name to look up
+     * @returns The module and its auxData, or undefined if not found
+     */
+    getModule(name: string): {
+        module: VirtualTableModule<any, any>;
+        auxData?: unknown;
+    } | undefined;
+    /**
+     * Sets the default virtual table module to use when USING is omitted
+     *
+     * @param name Module name. Must be a registered module.
+     * @throws QuereusError if the module name is not registered
+     */
+    setDefaultVTabModuleName(name: string): void;
+    /**
+     * Gets the currently configured default virtual table module name
+     *
+     * @returns The default module name
+     */
+    getDefaultVTabModuleName(): string;
+    /**
+     * Gets the default virtual table module arguments.
+     * @returns A copy of the default arguments array.
+     */
+    getDefaultVTabArgs(): Record<string, SqlValue>;
+    /**
+     * Gets the default virtual table module name and arguments.
+     * @returns An object containing the module name and arguments.
+     */
+    getDefaultVTabModule(): {
+        name: string;
+        args: Record<string, SqlValue>;
+    };
+    /**
+     * Gets a specific schema by name
+     *
+     * @param name Schema name to retrieve
+     * @returns The schema or undefined if not found
+     */
+    getSchema(name: string): Schema | undefined;
+    /**
+     * Gets the 'main' schema
+     *
+     * @returns The main schema
+     */
+    getMainSchema(): Schema;
+    /**
+     * Gets the 'temp' schema
+     *
+     * @returns The temp schema
+     */
+    getTempSchema(): Schema;
+    /**
+     * Gets the schema change notifier for listening to schema changes
+     */
+    getChangeNotifier(): SchemaChangeNotifier;
+    /**
+     * Adds a new schema (e.g., for ATTACH)
+     *
+     * @param name Name of the schema to add
+     * @returns The newly created schema
+     * @throws QuereusError if the name conflicts with an existing schema
+     */
+    addSchema(name: string): Schema;
+    /**
+     * Removes a schema (e.g., for DETACH)
+     *
+     * @param name Name of the schema to remove
+     * @returns true if found and removed, false otherwise
+     * @throws QuereusError if attempting to remove 'main' or 'temp'
+     */
+    removeSchema(name: string): boolean;
+    /**
+     * Finds a table by name, searching schemas according to SQLite rules
+     *
+     * @param tableName Name of the table
+     * @param dbName Optional specific schema name to search
+     * @returns The TableSchema or undefined if not found
+     */
+    findTable(tableName: string, dbName?: string): TableSchema | undefined;
+    /**
+     * Finds a function by name and arg count, searching schemas
+     *
+     * @param funcName Name of the function
+     * @param nArg Number of arguments
+     * @returns The FunctionSchema or undefined if not found
+     */
+    findFunction(funcName: string, nArg: number): FunctionSchema | undefined;
+    /**
+     * Retrieves a view schema definition
+     *
+     * @param schemaName The name of the schema ('main', 'temp', etc.). Defaults to current schema
+     * @param viewName The name of the view
+     * @returns The ViewSchema or undefined if not found
+     */
+    getView(schemaName: string | null, viewName: string): ViewSchema | undefined;
+    /**
+     * Retrieves any schema item (table or view) by name. Checks views first
+     *
+     * @param schemaName The name of the schema ('main', 'temp', etc.). Defaults to current schema
+     * @param itemName The name of the table or view
+     * @returns The TableSchema or ViewSchema, or undefined if not found
+     */
+    getSchemaItem(schemaName: string | null, itemName: string): TableSchema | ViewSchema | undefined;
+    /**
+     * Drops a table from the specified schema
+     *
+     * @param schemaName The name of the schema
+     * @param tableName The name of the table to drop
+     * @param ifExists If true, do not throw an error if the table does not exist.
+     * @returns True if the table was found and dropped, false otherwise.
+     */
+    dropTable(schemaName: string, tableName: string, ifExists?: boolean): boolean;
+    /**
+     * Drops a view from the specified schema
+     *
+     * @param schemaName The name of the schema
+     * @param viewName The name of the view to drop
+     * @returns True if the view was found and dropped, false otherwise
+     */
+    dropView(schemaName: string, viewName: string): boolean;
+    /**
+     * Clears all schema items (tables, functions, views)
+     */
+    clearAll(): void;
+    /**
+     * Retrieves a schema object, throwing if it doesn't exist
+     *
+     * @param name Schema name ('main', 'temp', or custom). Case-insensitive
+     * @returns The Schema object
+     * @throws QuereusError if the schema does not exist
+     */
+    getSchemaOrFail(name: string): Schema;
+    /**
+     * Retrieves a table from the specified schema
+     *
+     * @param schemaName The name of the schema ('main', 'temp', etc.). Defaults to current schema
+     * @param tableName The name of the table
+     * @returns The TableSchema or undefined if not found
+     */
+    getTable(schemaName: string | undefined, tableName: string): TableSchema | undefined;
+    /**
+     * Creates a new index on an existing table based on an AST.CreateIndexStmt.
+     * This method validates the index definition and calls the virtual table's xCreateIndex method.
+     *
+     * @param stmt The AST node for the CREATE INDEX statement.
+     * @returns A Promise that resolves when the index is created.
+     * @throws QuereusError on errors (e.g., table not found, column not found, xCreateIndex fails).
+     */
+    createIndex(stmt: AST.CreateIndexStmt): Promise<void>;
+    /**
+     * Defines a new table in the schema based on an AST.CreateTableStmt.
+     * This method encapsulates the logic for interacting with VTab modules (xCreate)
+     * and registering the new table schema.
+     *
+     * @param stmt The AST node for the CREATE TABLE statement.
+     * @returns A Promise that resolves to the created TableSchema.
+     * @throws QuereusError on errors (e.g., module not found, xCreate fails, table exists).
+     */
+    createTable(stmt: AST.CreateTableStmt): Promise<TableSchema>;
+}
+//# sourceMappingURL=manager.d.ts.map