@quereus/quereus 0.1.0

package/dist/src/planner/framework/physical-utils.js.map

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

package/dist/src/planner/framework/registry.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Rule registration and management framework for the Titan optimizer
+ * Provides centralized rule registry with tracing and loop detection
+ */
+import type { PlanNode } from '../nodes/plan-node.js';
+import { PlanNodeType } from '../nodes/plan-node-type.js';
+import type { OptContext } from './context.js';
+/**
+ * Rule function signature for optimization transformations
+ */
+export type RuleFn = (node: PlanNode, context: OptContext) => PlanNode | null;
+/**
+ * Rule phases for categorizing optimization rules
+ */
+export type RulePhase = 'rewrite' | 'impl';
+/**
+ * Handle for registered optimization rules
+ */
+export interface RuleHandle {
+    /** Unique identifier for this rule */
+    id: string;
+    /** Node type this rule applies to */
+    nodeType: PlanNodeType;
+    /** Phase classification */
+    phase: RulePhase;
+    /** Rule implementation function */
+    fn: RuleFn;
+    /** Optional priority (lower numbers run first) */
+    priority?: number;
+}
+/**
+ * Register an optimization rule
+ */
+export declare function registerRule(handle: RuleHandle): void;
+/**
+ * Get rules for a specific node type
+ */
+export declare function rulesFor(nodeType: PlanNodeType): readonly RuleHandle[];
+/**
+ * Check if a rule has been applied to a node
+ */
+export declare function hasRuleBeenApplied(nodeId: string, ruleId: string): boolean;
+/**
+ * Mark a rule as applied to a node
+ */
+export declare function markRuleApplied(nodeId: string, ruleId: string): void;
+/**
+ * Clear all visited rule tracking
+ */
+export declare function clearVisitedRules(): void;
+/**
+ * Get registry statistics
+ */
+export declare function getRegistryStats(): {
+    totalRules: number;
+    nodesWithRules: number;
+    appliedRules: number;
+};
+/**
+ * Get all registered rules (for debugging/tooling)
+ */
+export declare function getAllRules(): Map<PlanNodeType, readonly RuleHandle[]>;
+/**
+ * Apply rules to a node with tracing and loop detection
+ */
+export declare function applyRules(node: PlanNode, context: OptContext): PlanNode;
+/**
+ * Convenience function to register multiple rules at once
+ */
+export declare function registerRules(rules: RuleHandle[]): void;
+/**
+ * Helper to create rule handles with common patterns
+ */
+export declare function createRule(id: string, nodeType: PlanNodeType, phase: RulePhase, fn: RuleFn, priority?: number): RuleHandle;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/planner/framework/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/planner/framework/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO/C;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,KAAK,QAAQ,GAAG,IAAI,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,2BAA2B;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AA2GD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,UAAU,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAEvG;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,GAAG,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,QAAQ,CAqDxE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAIvD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,EACV,QAAQ,CAAC,EAAE,MAAM,GACf,UAAU,CAEZ"}

package/dist/src/planner/framework/registry.js

@@ -0,0 +1,203 @@
+/**
+ * Rule registration and management framework for the Titan optimizer
+ * Provides centralized rule registry with tracing and loop detection
+ */
+import { createLogger } from '../../common/logger.js';
+import { traceRuleStart, traceRuleEnd } from './trace.js';
+import { StatusCode } from '../../common/types.js';
+import { quereusError } from '../../common/errors.js';
+const log = createLogger('optimizer:framework:registry');
+/**
+ * Global rule registry
+ */
+class RuleRegistry {
+    rules = new Map();
+    visitedRules = new Map(); // nodeId -> ruleIds applied
+    /**
+     * Register a new optimization rule
+     */
+    registerRule(handle) {
+        if (!this.rules.has(handle.nodeType)) {
+            this.rules.set(handle.nodeType, []);
+        }
+        const nodeRules = this.rules.get(handle.nodeType);
+        // Check for duplicate rule IDs
+        if (nodeRules.some(r => r.id === handle.id)) {
+            quereusError(`Optimization rule '${handle.id}' already registered for node type ${handle.nodeType}`, StatusCode.INTERNAL);
+        }
+        // Insert rule maintaining priority order (lower priority first)
+        const priority = handle.priority ?? 100;
+        const insertIndex = nodeRules.findIndex(r => (r.priority ?? 100) > priority);
+        if (insertIndex === -1) {
+            nodeRules.push(handle);
+        }
+        else {
+            nodeRules.splice(insertIndex, 0, handle);
+        }
+        log('Registered rule %s for %s (phase: %s, priority: %d)', handle.id, handle.nodeType, handle.phase, priority);
+    }
+    /**
+     * Get all rules for a specific node type
+     */
+    rulesFor(nodeType) {
+        return this.rules.get(nodeType) ?? [];
+    }
+    /**
+     * Check if a rule has already been applied to a node
+     */
+    hasRuleBeenApplied(nodeId, ruleId) {
+        const nodeVisited = this.visitedRules.get(nodeId);
+        return nodeVisited?.has(ruleId) ?? false;
+    }
+    /**
+     * Mark a rule as applied to a node
+     */
+    markRuleApplied(nodeId, ruleId) {
+        if (!this.visitedRules.has(nodeId)) {
+            this.visitedRules.set(nodeId, new Set());
+        }
+        this.visitedRules.get(nodeId).add(ruleId);
+    }
+    /**
+     * Clear visited rules (typically called at start of optimization)
+     */
+    clearVisitedRules() {
+        this.visitedRules.clear();
+    }
+    /**
+     * Get all registered rules (for debugging)
+     */
+    getAllRules() {
+        const result = new Map();
+        for (const [nodeType, rules] of this.rules) {
+            result.set(nodeType, [...rules]);
+        }
+        return result;
+    }
+    /**
+     * Get statistics about rule application
+     */
+    getStats() {
+        let totalRules = 0;
+        for (const rules of this.rules.values()) {
+            totalRules += rules.length;
+        }
+        let appliedRules = 0;
+        for (const ruleSet of this.visitedRules.values()) {
+            appliedRules += ruleSet.size;
+        }
+        return {
+            totalRules,
+            nodesWithRules: this.visitedRules.size,
+            appliedRules
+        };
+    }
+}
+/**
+ * Global registry instance
+ */
+const globalRegistry = new RuleRegistry();
+/**
+ * Register an optimization rule
+ */
+export function registerRule(handle) {
+    globalRegistry.registerRule(handle);
+}
+/**
+ * Get rules for a specific node type
+ */
+export function rulesFor(nodeType) {
+    return globalRegistry.rulesFor(nodeType);
+}
+/**
+ * Check if a rule has been applied to a node
+ */
+export function hasRuleBeenApplied(nodeId, ruleId) {
+    return globalRegistry.hasRuleBeenApplied(nodeId, ruleId);
+}
+/**
+ * Mark a rule as applied to a node
+ */
+export function markRuleApplied(nodeId, ruleId) {
+    globalRegistry.markRuleApplied(nodeId, ruleId);
+}
+/**
+ * Clear all visited rule tracking
+ */
+export function clearVisitedRules() {
+    globalRegistry.clearVisitedRules();
+}
+/**
+ * Get registry statistics
+ */
+export function getRegistryStats() {
+    return globalRegistry.getStats();
+}
+/**
+ * Get all registered rules (for debugging/tooling)
+ */
+export function getAllRules() {
+    return globalRegistry.getAllRules();
+}
+/**
+ * Apply rules to a node with tracing and loop detection
+ */
+export function applyRules(node, context) {
+    const applicableRules = rulesFor(node.nodeType);
+    if (applicableRules.length === 0) {
+        return node;
+    }
+    let currentNode = node;
+    let appliedAnyRule = false;
+    for (const rule of applicableRules) {
+        // Skip if rule already applied to this node
+        if (hasRuleBeenApplied(currentNode.id, rule.id)) {
+            log('Skipping rule %s for node %s (already applied)', rule.id, currentNode.id);
+            continue;
+        }
+        try {
+            const ruleLog = createLogger(`optimizer:rule:${rule.id}`);
+            // Trace rule start
+            traceRuleStart(rule, currentNode);
+            ruleLog('Applying rule to node %s', currentNode.id);
+            const result = rule.fn(currentNode, context);
+            if (result && result !== currentNode) {
+                ruleLog('Rule transformed %s to %s', currentNode.nodeType, result.nodeType);
+                markRuleApplied(currentNode.id, rule.id);
+                // Trace successful transformation
+                traceRuleEnd(rule, currentNode, result);
+                currentNode = result;
+                appliedAnyRule = true;
+            }
+            else {
+                ruleLog('Rule not applicable to node %s', currentNode.id);
+                // Trace rule not applicable
+                traceRuleEnd(rule, currentNode, null);
+            }
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            log('Rule %s failed on node %s: %s', rule.id, currentNode.id, errorMsg);
+            // Continue with other rules rather than failing entire optimization
+        }
+    }
+    if (appliedAnyRule) {
+        log('Applied rules to node %s, result: %s', node.id, currentNode.nodeType);
+    }
+    return currentNode;
+}
+/**
+ * Convenience function to register multiple rules at once
+ */
+export function registerRules(rules) {
+    for (const rule of rules) {
+        registerRule(rule);
+    }
+}
+/**
+ * Helper to create rule handles with common patterns
+ */
+export function createRule(id, nodeType, phase, fn, priority) {
+    return { id, nodeType, phase, fn, priority };
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/planner/framework/registry.js.map

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

package/dist/src/planner/framework/trace.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Trace framework for Titan optimizer rule execution
+ * Provides debugging hooks and performance monitoring
+ */
+import type { PlanNode } from '../nodes/plan-node.js';
+import type { RuleHandle } from './registry.js';
+/**
+ * Trace hooks for optimizer rule execution
+ */
+export interface TraceHook {
+    /** Called when a rule starts execution */
+    onRuleStart?(handle: RuleHandle, node: PlanNode): void;
+    /** Called when a rule completes execution */
+    onRuleEnd?(handle: RuleHandle, before: PlanNode, after: PlanNode | null): void;
+    /** Called when optimizer starts processing a node */
+    onNodeStart?(node: PlanNode): void;
+    /** Called when optimizer finishes processing a node */
+    onNodeEnd?(before: PlanNode, after: PlanNode): void;
+    /** Called when optimization phase starts */
+    onPhaseStart?(phase: string): void;
+    /** Called when optimization phase ends */
+    onPhaseEnd?(phase: string): void;
+}
+/**
+ * Default trace hook that logs to debug channels
+ */
+export declare class DebugTraceHook implements TraceHook {
+    private readonly ruleLog;
+    private readonly nodeLog;
+    private readonly phaseLog;
+    onRuleStart(handle: RuleHandle, node: PlanNode): void;
+    onRuleEnd(handle: RuleHandle, before: PlanNode, after: PlanNode | null): void;
+    onNodeStart(node: PlanNode): void;
+    onNodeEnd(before: PlanNode, after: PlanNode): void;
+    onPhaseStart(phase: string): void;
+    onPhaseEnd(phase: string): void;
+}
+/**
+ * Performance monitoring trace hook
+ */
+export declare class PerformanceTraceHook implements TraceHook {
+    private readonly perfLog;
+    private ruleStartTimes;
+    private phaseStartTimes;
+    onRuleStart(handle: RuleHandle, node: PlanNode): void;
+    onRuleEnd(handle: RuleHandle, before: PlanNode, _after: PlanNode | null): void;
+    onPhaseStart(phase: string): void;
+    onPhaseEnd(phase: string): void;
+}
+/**
+ * Composite trace hook that combines multiple hooks
+ */
+export declare class CompositeTraceHook implements TraceHook {
+    private readonly hooks;
+    constructor(hooks: TraceHook[]);
+    onRuleStart(handle: RuleHandle, node: PlanNode): void;
+    onRuleEnd(handle: RuleHandle, before: PlanNode, after: PlanNode | null): void;
+    onNodeStart(node: PlanNode): void;
+    onNodeEnd(before: PlanNode, after: PlanNode): void;
+    onPhaseStart(phase: string): void;
+    onPhaseEnd(phase: string): void;
+}
+/**
+ * Set the global trace hook
+ */
+export declare function setTraceHook(hook: TraceHook | undefined): void;
+/**
+ * Get the current trace hook
+ */
+export declare function getCurrentTraceHook(): TraceHook | undefined;
+/**
+ * Set up default tracing based on environment
+ */
+export declare function setupDefaultTracing(): void;
+/**
+ * Helper functions for calling trace hooks
+ */
+export declare function traceRuleStart(handle: RuleHandle, node: PlanNode): void;
+export declare function traceRuleEnd(handle: RuleHandle, before: PlanNode, after: PlanNode | null): void;
+export declare function traceNodeStart(node: PlanNode): void;
+export declare function traceNodeEnd(before: PlanNode, after: PlanNode): void;
+export declare function tracePhaseStart(phase: string): void;
+export declare function tracePhaseEnd(phase: string): void;
+//# sourceMappingURL=trace.d.ts.map

package/dist/src/planner/framework/trace.d.ts.map

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

package/dist/src/planner/framework/trace.js

@@ -0,0 +1,198 @@
+/**
+ * Trace framework for Titan optimizer rule execution
+ * Provides debugging hooks and performance monitoring
+ */
+import { createLogger } from '../../common/logger.js';
+import { isDebugEnabled, isFeatureEnabled } from '../../util/environment.js';
+const log = createLogger('optimizer:framework:trace');
+/**
+ * Default trace hook that logs to debug channels
+ */
+export class DebugTraceHook {
+    ruleLog = createLogger('optimizer:trace:rules');
+    nodeLog = createLogger('optimizer:trace:nodes');
+    phaseLog = createLogger('optimizer:trace:phases');
+    onRuleStart(handle, node) {
+        this.ruleLog('→ %s starting on %s#%s', handle.id, node.nodeType, node.id);
+    }
+    onRuleEnd(handle, before, after) {
+        if (after && after !== before) {
+            this.ruleLog('✓ %s transformed %s#%s → %s#%s', handle.id, before.nodeType, before.id, after.nodeType, after.id);
+        }
+        else {
+            this.ruleLog('– %s not applicable to %s#%s', handle.id, before.nodeType, before.id);
+        }
+    }
+    onNodeStart(node) {
+        this.nodeLog('Processing node %s#%s', node.nodeType, node.id);
+    }
+    onNodeEnd(before, after) {
+        if (before !== after) {
+            this.nodeLog('Node %s#%s → %s#%s', before.nodeType, before.id, after.nodeType, after.id);
+        }
+    }
+    onPhaseStart(phase) {
+        this.phaseLog('Starting phase: %s', phase);
+    }
+    onPhaseEnd(phase) {
+        this.phaseLog('Completed phase: %s', phase);
+    }
+}
+/**
+ * Performance monitoring trace hook
+ */
+export class PerformanceTraceHook {
+    perfLog = createLogger('optimizer:trace:performance');
+    ruleStartTimes = new Map();
+    phaseStartTimes = new Map();
+    onRuleStart(handle, node) {
+        const key = `${handle.id}:${node.id}`;
+        this.ruleStartTimes.set(key, performance.now());
+    }
+    onRuleEnd(handle, before, _after) {
+        const key = `${handle.id}:${before.id}`;
+        const startTime = this.ruleStartTimes.get(key);
+        if (startTime !== undefined) {
+            const duration = performance.now() - startTime;
+            this.perfLog('Rule %s took %.2fms on %s#%s', handle.id, duration, before.nodeType, before.id);
+            this.ruleStartTimes.delete(key);
+        }
+    }
+    onPhaseStart(phase) {
+        this.phaseStartTimes.set(phase, performance.now());
+    }
+    onPhaseEnd(phase) {
+        const startTime = this.phaseStartTimes.get(phase);
+        if (startTime !== undefined) {
+            const duration = performance.now() - startTime;
+            this.perfLog('Phase %s took %.2fms', phase, duration);
+            this.phaseStartTimes.delete(phase);
+        }
+    }
+}
+/**
+ * Composite trace hook that combines multiple hooks
+ */
+export class CompositeTraceHook {
+    hooks;
+    constructor(hooks) {
+        this.hooks = hooks;
+    }
+    onRuleStart(handle, node) {
+        for (const hook of this.hooks) {
+            hook.onRuleStart?.(handle, node);
+        }
+    }
+    onRuleEnd(handle, before, after) {
+        for (const hook of this.hooks) {
+            hook.onRuleEnd?.(handle, before, after);
+        }
+    }
+    onNodeStart(node) {
+        for (const hook of this.hooks) {
+            hook.onNodeStart?.(node);
+        }
+    }
+    onNodeEnd(before, after) {
+        for (const hook of this.hooks) {
+            hook.onNodeEnd?.(before, after);
+        }
+    }
+    onPhaseStart(phase) {
+        for (const hook of this.hooks) {
+            hook.onPhaseStart?.(phase);
+        }
+    }
+    onPhaseEnd(phase) {
+        for (const hook of this.hooks) {
+            hook.onPhaseEnd?.(phase);
+        }
+    }
+}
+/**
+ * Global trace hook registry
+ */
+class TraceRegistry {
+    currentHook;
+    setTraceHook(hook) {
+        this.currentHook = hook;
+        if (hook) {
+            log('Trace hook activated');
+        }
+        else {
+            log('Trace hook deactivated');
+        }
+    }
+    getCurrentHook() {
+        return this.currentHook;
+    }
+    /**
+     * Set up default tracing based on environment variables
+     */
+    setupDefaultTracing() {
+        const hooks = [];
+        // Enable debug tracing if debug logging is enabled
+        if (isDebugEnabled('optimizer')) {
+            hooks.push(new DebugTraceHook());
+        }
+        // Enable performance tracing if requested
+        if (isFeatureEnabled('QUEREUS_OPTIMIZER_PERF')) {
+            hooks.push(new PerformanceTraceHook());
+        }
+        if (hooks.length > 0) {
+            this.setTraceHook(new CompositeTraceHook(hooks));
+        }
+    }
+}
+/**
+ * Global trace registry instance
+ */
+const globalTraceRegistry = new TraceRegistry();
+/**
+ * Set the global trace hook
+ */
+export function setTraceHook(hook) {
+    globalTraceRegistry.setTraceHook(hook);
+}
+/**
+ * Get the current trace hook
+ */
+export function getCurrentTraceHook() {
+    return globalTraceRegistry.getCurrentHook();
+}
+/**
+ * Set up default tracing based on environment
+ */
+export function setupDefaultTracing() {
+    globalTraceRegistry.setupDefaultTracing();
+}
+/**
+ * Helper functions for calling trace hooks
+ */
+export function traceRuleStart(handle, node) {
+    const hook = getCurrentTraceHook();
+    hook?.onRuleStart?.(handle, node);
+}
+export function traceRuleEnd(handle, before, after) {
+    const hook = getCurrentTraceHook();
+    hook?.onRuleEnd?.(handle, before, after);
+}
+export function traceNodeStart(node) {
+    const hook = getCurrentTraceHook();
+    hook?.onNodeStart?.(node);
+}
+export function traceNodeEnd(before, after) {
+    const hook = getCurrentTraceHook();
+    hook?.onNodeEnd?.(before, after);
+}
+export function tracePhaseStart(phase) {
+    const hook = getCurrentTraceHook();
+    hook?.onPhaseStart?.(phase);
+}
+export function tracePhaseEnd(phase) {
+    const hook = getCurrentTraceHook();
+    hook?.onPhaseEnd?.(phase);
+}
+// Initialize default tracing on module load
+setupDefaultTracing();
+//# sourceMappingURL=trace.js.map

package/dist/src/planner/framework/trace.js.map

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

package/dist/src/planner/nodes/add-constraint-node.d.ts

@@ -0,0 +1,23 @@
+import type { Scope } from '../scopes/scope.js';
+import { PlanNode, type VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { TableReferenceNode } from './reference.js';
+import type { VoidType } from '../../common/datatype.js';
+import type * as AST from '../../parser/ast.js';
+/**
+ * Represents adding a constraint to an existing table.
+ * This is a DDL operation that modifies the table schema at runtime.
+ */
+export declare class AddConstraintNode extends PlanNode implements VoidNode {
+    readonly table: TableReferenceNode;
+    readonly constraint: AST.TableConstraint;
+    readonly nodeType = PlanNodeType.AddConstraint;
+    constructor(scope: Scope, table: TableReferenceNode, constraint: AST.TableConstraint);
+    getType(): VoidType;
+    getRelations(): readonly [TableReferenceNode];
+    getChildren(): readonly PlanNode[];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=add-constraint-node.d.ts.map

package/dist/src/planner/nodes/add-constraint-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-constraint-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/add-constraint-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,QAAS,YAAW,QAAQ;aAK/C,KAAK,EAAE,kBAAkB;aACzB,UAAU,EAAE,GAAG,CAAC,eAAe;IALjD,SAAkB,QAAQ,8BAA8B;gBAGtD,KAAK,EAAE,KAAK,EACI,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,GAAG,CAAC,eAAe;IAKjD,OAAO,IAAI,QAAQ;IAInB,YAAY,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI7C,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAO/C,QAAQ,IAAI,MAAM;IAMlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUzD"}