@quereus/quereus 0.7.3 → 0.7.5

package/src/runtime/emission-context.ts

@@ -1,319 +0,0 @@
-import type { Database } from '../core/database.js';
-import type { SchemaManager } from '../schema/manager.js';
-import type { TableSchema } from '../schema/table.js';
-import type { FunctionSchema } from '../schema/function.js';
-import type { AnyVirtualTableModule } from '../vtab/module.js';
-import { createLogger } from '../common/logger.js';
-import { QuereusError } from '../common/errors.js';
-import { StatusCode } from '../common/types.js';
-import type { CollationFunction } from '../util/comparison.js';
-
-const log = createLogger('runtime:emission-context');
-
-/**
- * Represents a dependency on a schema object that was resolved during emission.
- * Used for plan invalidation when schema changes.
- */
-export interface SchemaDependency {
-	readonly type: 'table' | 'function' | 'vtab_module' | 'collation';
-	readonly schemaName?: string; // undefined for functions, collations, and vtab modules
-	readonly objectName: string;
-	readonly objectVersion?: number; // For future versioning support
-}
-
-/**
- * Tracks schema dependencies and provides a unique identifier for a set of dependencies.
- */
-export class DependencyTracker {
-	private dependencies = new Set<string>();
-	private _fingerprint: string | null = null;
-
-	/**
-	 * Records a dependency on a schema object.
-	 */
-	addDependency(dep: SchemaDependency): void {
-		const key = this.dependencyKey(dep);
-		this.dependencies.add(key);
-		this._fingerprint = null; // Invalidate cached fingerprint
-	}
-
-	/**
-	 * Gets all tracked dependencies.
-	 */
-	getDependencies(): SchemaDependency[] {
-		return Array.from(this.dependencies).map(key => this.parseDependencyKey(key));
-	}
-
-	/**
-	 * Gets a fingerprint representing the current set of dependencies.
-	 * This can be used to quickly check if dependencies have changed.
-	 */
-	getFingerprint(): string {
-		if (this._fingerprint === null) {
-			const sorted = Array.from(this.dependencies).sort();
-			this._fingerprint = sorted.join('|');
-		}
-		return this._fingerprint;
-	}
-
-	/**
-	 * Checks if this tracker has any dependencies that overlap with the given dependency.
-	 */
-	dependsOn(dep: SchemaDependency): boolean {
-		const key = this.dependencyKey(dep);
-		return this.dependencies.has(key);
-	}
-
-	/**
-	 * Clears all tracked dependencies.
-	 */
-	clear(): void {
-		this.dependencies.clear();
-		this._fingerprint = null;
-	}
-
-	private dependencyKey(dep: SchemaDependency): string {
-		const schema = dep.schemaName || '';
-		const version = dep.objectVersion || 0;
-		return `${dep.type}:${schema}:${dep.objectName}:${version}`;
-	}
-
-	private parseDependencyKey(key: string): SchemaDependency {
-		const [type, schemaName, objectName, versionStr] = key.split(':');
-		return {
-			type: type as SchemaDependency['type'],
-			schemaName: schemaName || undefined,
-			objectName,
-			objectVersion: parseInt(versionStr) || undefined
-		};
-	}
-}
-
-type SchemaObject = TableSchema | FunctionSchema | { module: AnyVirtualTableModule, auxData?: unknown } | CollationFunction;
-
-/**
- * Context provided to emitters during plan emission.
- * Allows schema lookups and tracks dependencies for plan invalidation.
- * Also captures schema object references for runtime use.
- */
-export class EmissionContext {
-	private readonly schemaManager: SchemaManager;
-	private readonly dependencyTracker = new DependencyTracker();
-	/** Schema snapshot for table/view references during emission */
-	private readonly schemaSnapshot = new Map<string, SchemaObject>();
-	public readonly tracePlanStack: boolean;
-
-	constructor(
-		public readonly db: Database,
-	) {
-		const option = db.getOption('trace_plan_stack');
-		this.tracePlanStack = typeof option === 'object' && option !== null && 'value' in option
-			? Boolean((option as { value: unknown }).value)
-			: Boolean(option);
-		this.schemaManager = db.schemaManager;
-	}
-
-	/**
-	 * Looks up a table schema and records the dependency.
-	 * Also captures the table reference for runtime use.
-	 */
-	findTable(tableName: string, schemaName?: string): TableSchema | undefined {
-		const table = this.schemaManager.findTable(tableName, schemaName);
-		if (table) {
-			const key = `table:${table.schemaName}:${table.name}`;
-			this.schemaSnapshot.set(key, table);
-			this.dependencyTracker.addDependency({
-				type: 'table',
-				schemaName: table.schemaName,
-				objectName: table.name
-			});
-			log('Recorded table dependency: %s.%s', table.schemaName, table.name);
-		}
-		return table;
-	}
-
-	/**
-	 * Looks up a function schema and records the dependency.
-	 * Also captures the function reference for runtime use.
-	 */
-	findFunction(funcName: string, numArgs: number): FunctionSchema | undefined {
-		const func = this.schemaManager.findFunction(funcName, numArgs);
-		if (func) {
-			const key = `function:${func.name}/${func.numArgs}`;
-			this.schemaSnapshot.set(key, func);
-			this.dependencyTracker.addDependency({
-				type: 'function',
-				objectName: `${func.name}/${func.numArgs}`
-			});
-			log('Recorded function dependency: %s/%d', func.name, func.numArgs);
-		}
-		return func;
-	}
-
-	/**
-	 * Looks up a virtual table module and records the dependency.
-	 * Also captures the module reference for runtime use.
-	 */
-	getVtabModule(moduleName: string): { module: AnyVirtualTableModule, auxData?: unknown } | undefined {
-		const moduleInfo = this.schemaManager.getModule(moduleName);
-		if (moduleInfo) {
-			const key = `vtab_module:${moduleName}`;
-			this.schemaSnapshot.set(key, moduleInfo);
-			this.dependencyTracker.addDependency({
-				type: 'vtab_module',
-				objectName: moduleName
-			});
-			log('Recorded vtab module dependency: %s', moduleName);
-		}
-		return moduleInfo;
-	}
-
-	/**
-	 * Looks up a collation and records the dependency.
-	 * Also captures the collation reference for runtime use.
-	 */
-	getCollation(collationName: string): CollationFunction | undefined {
-		const collation = this.db._getCollation(collationName);
-		if (collation) {
-			const key = `collation:${collationName}`;
-			this.schemaSnapshot.set(key, collation);
-			this.dependencyTracker.addDependency({
-				type: 'collation',
-				objectName: collationName
-			});
-			log('Recorded collation dependency: %s', collationName);
-		}
-		return collation;
-	}
-
-	/**
-	 * Gets the dependency tracker for this emission context.
-	 */
-	getDependencyTracker(): DependencyTracker {
-		return this.dependencyTracker;
-	}
-
-	/**
-	 * Gets a snapshot of all dependencies recorded during emission.
-	 */
-	getDependencies(): SchemaDependency[] {
-		return this.dependencyTracker.getDependencies();
-	}
-
-	/**
-	 * Gets a fingerprint representing all dependencies.
-	 */
-	getDependencyFingerprint(): string {
-		return this.dependencyTracker.getFingerprint();
-	}
-
-	/**
-	 * Provides access to the database instance for cases where direct access is needed.
-	 * Use sparingly - prefer the specific lookup methods above.
-	 */
-	getDatabase(): Database {
-		return this.db;
-	}
-
-	/**
-	 * Provides access to the schema manager for cases where direct access is needed.
-	 * Use sparingly - prefer the specific lookup methods above.
-	 */
-	getSchemaManager(): SchemaManager {
-		return this.schemaManager;
-	}
-
-	/**
-	 * Retrieves a captured schema object by its key.
-	 * This allows runtime instructions to use the schema objects that were
-	 * captured at emission time, providing consistency even if the schema changes.
-	 */
-	getCapturedSchemaObject<T = SchemaObject>(key: string): T | undefined {
-		return this.schemaSnapshot.get(key) as T | undefined;
-	}
-
-	/**
-	 * Validates that all captured schema objects still exist in the current schema.
-	 * This can be called at the start of query execution to provide early error detection.
-	 * Only validates objects that were actually captured during emission.
-	 */
-	validateCapturedSchemaObjects(): void {
-		for (const [key, capturedObject] of this.schemaSnapshot.entries()) {
-			const [type, ...nameParts] = key.split(':');
-
-			switch (type) {
-				case 'table': {
-					const [schemaName, tableName] = nameParts;
-					const currentTable = this.schemaManager.findTable(tableName, schemaName);
-					if (!currentTable) {
-						throw new QuereusError(
-							`Table ${schemaName}.${tableName} was dropped after query was planned`,
-							StatusCode.ERROR
-						);
-					}
-					// Optionally check if it's the same object reference
-					if (currentTable !== capturedObject) {
-						log('Warning: Table %s.%s schema changed after query was planned', schemaName, tableName);
-					}
-					break;
-				}
-				case 'function': {
-					const funcKey = nameParts.join(':'); // Rejoin in case function name had colons
-					const [funcName, numArgsStr] = funcKey.split('/');
-					const numArgs = parseInt(numArgsStr);
-					const currentFunc = this.schemaManager.findFunction(funcName, numArgs);
-					if (!currentFunc) {
-						throw new QuereusError(
-							`Function ${funcName}/${numArgs} was removed after query was planned`,
-							StatusCode.ERROR
-						);
-					}
-					if (currentFunc !== capturedObject) {
-						log('Warning: Function %s/%d changed after query was planned', funcName, numArgs);
-					}
-					break;
-				}
-				case 'vtab_module': {
-					const moduleName = nameParts.join(':');
-					const currentModule = this.schemaManager.getModule(moduleName);
-					if (!currentModule) {
-						throw new QuereusError(
-							`Virtual table module ${moduleName} was unregistered after query was planned`,
-							StatusCode.ERROR
-						);
-					}
-					if (currentModule !== capturedObject) {
-						log('Warning: Virtual table module %s changed after query was planned', moduleName);
-					}
-					break;
-				}
-				case 'collation': {
-					const collationName = nameParts.join(':');
-					const currentCollation = this.db._getCollation(collationName);
-					if (!currentCollation) {
-						throw new QuereusError(
-							`Collation ${collationName} was removed after query was planned`,
-							StatusCode.ERROR
-						);
-					}
-					if (currentCollation !== capturedObject) {
-						log('Warning: Collation %s changed after query was planned', collationName);
-					}
-					break;
-				}
-				default:
-					log('Warning: Unknown schema object type in validation: %s', type);
-			}
-		}
-	}
-
-	/**
-	 * Gets the number of schema objects captured during emission.
-	 * Useful for debugging and testing.
-	 */
-	getCapturedObjectCount(): number {
-		return this.schemaSnapshot.size;
-	}
-}
-
-

package/src/runtime/emit/add-constraint.ts

@@ -1,78 +0,0 @@
-import type { AddConstraintNode } from '../../planner/nodes/add-constraint-node.js';
-import type { Instruction, RuntimeContext, InstructionRun } from '../types.js';
-import type { EmissionContext } from '../emission-context.js';
-import { QuereusError } from '../../common/errors.js';
-import { SqlValue, StatusCode } from '../../common/types.js';
-import { createLogger } from '../../common/logger.js';
-import type { RowConstraintSchema, TableSchema } from '../../schema/table.js';
-import { opsToMask } from '../../schema/table.js';
-
-const log = createLogger('runtime:emit:add-constraint');
-
-export function emitAddConstraint(plan: AddConstraintNode, _ctx: EmissionContext): Instruction {
-	const tableSchema = plan.table.tableSchema;
-
-	async function run(rctx: RuntimeContext): Promise<SqlValue> {
-		// Convert the AST constraint to a schema constraint object
-		const constraint = plan.constraint;
-
-		if (constraint.type !== 'check') {
-			throw new QuereusError(
-				`ADD CONSTRAINT ${constraint.type} is not yet implemented`,
-				StatusCode.UNSUPPORTED
-			);
-		}
-
-		if (!constraint.expr) {
-			throw new QuereusError(
-				'CHECK constraint requires an expression',
-				StatusCode.ERROR
-			);
-		}
-
-		// Create the constraint schema object
-		// Note: We don't validate determinism here because constraints may reference NEW/OLD
-		// which require special scoping. Determinism is validated at INSERT/UPDATE plan time
-		// in constraint-builder.ts when the constraint is actually checked.
-		const constraintSchema: RowConstraintSchema = {
-			name: constraint.name || `check_${tableSchema.checkConstraints.length}`,
-			expr: constraint.expr,
-			operations: opsToMask(constraint.operations), // Convert operations array to bitmask
-			deferrable: constraint.deferrable ?? false,
-			initiallyDeferred: constraint.initiallyDeferred,
-		};
-
-		// Create a new table schema with the additional constraint (honor immutability)
-		const updatedConstraints = [...tableSchema.checkConstraints, constraintSchema];
-		const updatedTableSchema: TableSchema = {
-			...tableSchema,
-			checkConstraints: Object.freeze(updatedConstraints),
-		};
-
-		// Replace the table schema in the database
-		const schemaManager = rctx.db.schemaManager;
-		const schema = schemaManager.getSchemaOrFail(tableSchema.schemaName);
-
-		// Replace the table schema (addTable overwrites existing)
-		schema.addTable(updatedTableSchema);
-
-		// Notify schema change listeners that the table was modified
-		schemaManager.getChangeNotifier().notifyChange({
-			type: 'table_modified',
-			schemaName: tableSchema.schemaName,
-			objectName: tableSchema.name,
-			oldObject: tableSchema,
-			newObject: updatedTableSchema
-		});
-
-		log('Added constraint %s to table %s.%s', constraintSchema.name, tableSchema.schemaName, tableSchema.name);
-
-		return null;
-	}
-
-	return {
-		params: [],
-		run: run as InstructionRun,
-		note: `addConstraint(${plan.table.tableSchema.name}, ${plan.constraint.name || 'unnamed'})`
-	};
-}