@quereus/quereus 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/cache-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAIhD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,QAAS,YAAW,mBAAmB;aAKpD,MAAM,EAAE,kBAAkB;aAC1B,QAAQ,EAAE,aAAa;aACvB,SAAS,EAAE,MAAM;IANlC,QAAQ,CAAC,QAAQ,sBAAsB;gBAGtC,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,GAAE,aAAwB,EAClC,SAAS,GAAE,MAAc,EAAG,wCAAwC;IACpF,qBAAqB,CAAC,EAAE,MAAM;IAM/B,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAUvB,WAAW,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI5C,YAAY,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI7C,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IA0BxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOxD"}

package/dist/src/planner/nodes/cache-node.js

@@ -0,0 +1,73 @@
+import { PlanNodeType } from './plan-node-type.js';
+import { PlanNode } from './plan-node.js';
+import { StatusCode } from '../../common/types.js';
+import { quereusError } from '../../common/errors.js';
+/**
+ * CacheNode provides smart caching for any relational input.
+ *
+ * This node materializes its input on first iteration and serves
+ * subsequent iterations from the cached result. It implements
+ * smart threshold-based policies to avoid excessive memory usage.
+ */
+export class CacheNode extends PlanNode {
+    source;
+    strategy;
+    threshold;
+    nodeType = PlanNodeType.Cache;
+    constructor(scope, source, strategy = 'memory', threshold = 10000, // Rows before switching to pass-through
+    estimatedCostOverride) {
+        super(scope, estimatedCostOverride);
+        this.source = source;
+        this.strategy = strategy;
+        this.threshold = threshold;
+    }
+    // Cache preserves source attributes exactly
+    getAttributes() {
+        return this.source.getAttributes();
+    }
+    getType() {
+        const sourceType = this.source.getType();
+        // Cache preserves all properties of the source relation
+        return {
+            ...sourceType,
+            // Note: Caching doesn't change the logical properties
+            // but may affect physical properties like ordering
+        };
+    }
+    getChildren() {
+        return [this.source];
+    }
+    getRelations() {
+        return [this.source];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 1) {
+            quereusError(`CacheNode expects 1 child, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        const [newSource] = newChildren;
+        // Type check
+        if (!('getAttributes' in newSource) || typeof newSource.getAttributes !== 'function') {
+            quereusError('CacheNode: child must be a RelationalPlanNode', StatusCode.INTERNAL);
+        }
+        // Return same instance if nothing changed
+        if (newSource === this.source) {
+            return this;
+        }
+        // Create new instance preserving attributes (cache preserves source attributes exactly)
+        return new CacheNode(this.scope, newSource, this.strategy, this.threshold);
+    }
+    get estimatedRows() {
+        return this.source.estimatedRows;
+    }
+    toString() {
+        return `CACHE (${this.strategy}, threshold=${this.threshold})`;
+    }
+    getLogicalAttributes() {
+        return {
+            strategy: this.strategy,
+            threshold: this.threshold,
+            sourceNodeType: this.source.nodeType
+        };
+    }
+}
+//# sourceMappingURL=cache-node.js.map

package/dist/src/planner/nodes/cache-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/cache-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAqE,MAAM,gBAAgB,CAAC;AAG7G,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD;;;;;;GAMG;AACH,MAAM,OAAO,SAAU,SAAQ,QAAQ;IAKrB;IACA;IACA;IANR,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC;IAEvC,YACC,KAAY,EACI,MAA0B,EAC1B,WAA0B,QAAQ,EAClC,YAAoB,KAAK,EAAG,wCAAwC;IACpF,qBAA8B;QAE9B,KAAK,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAC;QALpB,WAAM,GAAN,MAAM,CAAoB;QAC1B,aAAQ,GAAR,QAAQ,CAA0B;QAClC,cAAS,GAAT,SAAS,CAAgB;IAI1C,CAAC;IAED,4CAA4C;IAC5C,aAAa;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,OAAO;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACzC,wDAAwD;QACxD,OAAO;YACN,GAAG,UAAU;YACb,sDAAsD;YACtD,mDAAmD;SACnD,CAAC;IACH,CAAC;IAED,WAAW;QACV,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,YAAY;QACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,WAAgC;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,YAAY,CAAC,kCAAkC,WAAW,CAAC,MAAM,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;QAEhC,aAAa;QACb,IAAI,CAAC,CAAC,eAAe,IAAI,SAAS,CAAC,IAAI,OAAQ,SAAiB,CAAC,aAAa,KAAK,UAAU,EAAE,CAAC;YAC/F,YAAY,CAAC,+CAA+C,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpF,CAAC;QAED,0CAA0C;QAC1C,IAAI,SAAS,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACb,CAAC;QAED,wFAAwF;QACxF,OAAO,IAAI,SAAS,CACnB,IAAI,CAAC,KAAK,EACV,SAA+B,EAC/B,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CACd,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;IAClC,CAAC;IAEQ,QAAQ;QAChB,OAAO,UAAU,IAAI,CAAC,QAAQ,eAAe,IAAI,CAAC,SAAS,GAAG,CAAC;IAChE,CAAC;IAEQ,oBAAoB;QAC5B,OAAO;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SACpC,CAAC;IACH,CAAC;CACD"}

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

@@ -0,0 +1,28 @@
+import type { Scope } from '../scopes/scope.js';
+import { PlanNode, type RelationalPlanNode, type Attribute, type RowDescriptor } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { TableReferenceNode } from './reference.js';
+import type { RelationType } from '../../common/datatype.js';
+import type { RowOp } from '../../schema/table.js';
+/**
+ * Represents constraint checking for DML operations.
+ * This node validates constraints against rows flowing through it.
+ */
+export declare class ConstraintCheckNode extends PlanNode implements RelationalPlanNode {
+    readonly source: RelationalPlanNode;
+    readonly table: TableReferenceNode;
+    readonly operation: RowOp;
+    readonly oldRowDescriptor?: RowDescriptor | undefined;
+    readonly newRowDescriptor?: RowDescriptor | undefined;
+    readonly nodeType = PlanNodeType.ConstraintCheck;
+    constructor(scope: Scope, source: RelationalPlanNode, table: TableReferenceNode, operation: RowOp, oldRowDescriptor?: RowDescriptor | undefined, newRowDescriptor?: RowDescriptor | undefined);
+    getType(): RelationType;
+    getAttributes(): Attribute[];
+    getRelations(): readonly [RelationalPlanNode, TableReferenceNode];
+    getChildren(): readonly PlanNode[];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    get estimatedRows(): number | undefined;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=constraint-check-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-check-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/constraint-check-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,QAAS,YAAW,kBAAkB;aAK3D,MAAM,EAAE,kBAAkB;aAC1B,KAAK,EAAE,kBAAkB;aACzB,SAAS,EAAE,KAAK;aAChB,gBAAgB,CAAC,EAAE,aAAa;aAChC,gBAAgB,CAAC,EAAE,aAAa;IARlD,SAAkB,QAAQ,gCAAgC;gBAGxD,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,KAAK,EAChB,gBAAgB,CAAC,EAAE,aAAa,YAAA,EAChC,gBAAgB,CAAC,EAAE,aAAa,YAAA;IAKlD,OAAO,IAAI,YAAY;IAIvB,aAAa,IAAI,SAAS,EAAE;IAK5B,YAAY,IAAI,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAIjE,WAAW,IAAI,SAAS,QAAQ,EAAE;IAIlC,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IA4BxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAOlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAazD"}

package/dist/src/planner/nodes/constraint-check-node.js

@@ -0,0 +1,73 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+/**
+ * Represents constraint checking for DML operations.
+ * This node validates constraints against rows flowing through it.
+ */
+export class ConstraintCheckNode extends PlanNode {
+    source;
+    table;
+    operation;
+    oldRowDescriptor;
+    newRowDescriptor;
+    nodeType = PlanNodeType.ConstraintCheck;
+    constructor(scope, source, table, operation, oldRowDescriptor, newRowDescriptor) {
+        super(scope);
+        this.source = source;
+        this.table = table;
+        this.operation = operation;
+        this.oldRowDescriptor = oldRowDescriptor;
+        this.newRowDescriptor = newRowDescriptor;
+    }
+    getType() {
+        return this.source.getType();
+    }
+    getAttributes() {
+        // ConstraintCheck passes through the same attributes as its source
+        return this.source.getAttributes();
+    }
+    getRelations() {
+        return [this.source, this.table];
+    }
+    getChildren() {
+        return [this.source];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 1) {
+            throw new Error(`ConstraintCheckNode expects 1 child, got ${newChildren.length}`);
+        }
+        const [newSource] = newChildren;
+        // Type check
+        if (!('getAttributes' in newSource) || typeof newSource.getAttributes !== 'function') {
+            throw new Error('ConstraintCheckNode: child must be a RelationalPlanNode');
+        }
+        // Return same instance if nothing changed
+        if (newSource === this.source) {
+            return this;
+        }
+        // Create new instance
+        return new ConstraintCheckNode(this.scope, newSource, this.table, this.operation, this.oldRowDescriptor, this.newRowDescriptor);
+    }
+    get estimatedRows() {
+        return this.source.estimatedRows;
+    }
+    toString() {
+        const opName = this.operation === 1 ? 'INSERT' :
+            this.operation === 2 ? 'UPDATE' :
+                this.operation === 4 ? 'DELETE' : 'UNKNOWN';
+        return `CHECK CONSTRAINTS ON ${opName}`;
+    }
+    getLogicalAttributes() {
+        const opName = this.operation === 1 ? 'INSERT' :
+            this.operation === 2 ? 'UPDATE' :
+                this.operation === 4 ? 'DELETE' : 'UNKNOWN';
+        return {
+            table: this.table.tableSchema.name,
+            schema: this.table.tableSchema.schemaName,
+            operation: opName,
+            hasOldDescriptor: !!this.oldRowDescriptor,
+            hasNewDescriptor: !!this.newRowDescriptor,
+        };
+    }
+}
+//# sourceMappingURL=constraint-check-node.js.map

package/dist/src/planner/nodes/constraint-check-node.js.map

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

package/dist/src/planner/nodes/create-index-node.d.ts

@@ -0,0 +1,15 @@
+import type * as AST from '../../parser/ast.js';
+import type { Scope } from '../scopes/scope.js';
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+/**
+ * Represents a CREATE INDEX statement in the logical query plan.
+ */
+export declare class CreateIndexNode extends VoidNode {
+    readonly statementAst: AST.CreateIndexStmt;
+    readonly nodeType = PlanNodeType.CreateIndex;
+    constructor(scope: Scope, statementAst: AST.CreateIndexStmt);
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=create-index-node.d.ts.map

package/dist/src/planner/nodes/create-index-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-index-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/create-index-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;aAKzB,YAAY,EAAE,GAAG,CAAC,eAAe;IAJnD,SAAkB,QAAQ,4BAA4B;gBAGpD,KAAK,EAAE,KAAK,EACI,YAAY,EAAE,GAAG,CAAC,eAAe;IAK1C,QAAQ,IAAI,MAAM;IAKlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYzD"}

package/dist/src/planner/nodes/create-index-node.js

@@ -0,0 +1,31 @@
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { expressionToString } from '../../util/ast-stringify.js';
+/**
+ * Represents a CREATE INDEX statement in the logical query plan.
+ */
+export class CreateIndexNode extends VoidNode {
+    statementAst;
+    nodeType = PlanNodeType.CreateIndex;
+    constructor(scope, statementAst) {
+        super(scope);
+        this.statementAst = statementAst;
+    }
+    toString() {
+        const uniquePrefix = this.statementAst.isUnique ? 'UNIQUE ' : '';
+        return `CREATE ${uniquePrefix}INDEX ${this.statementAst.index.name} ON ${this.statementAst.table.name}`;
+    }
+    getLogicalAttributes() {
+        return {
+            index: this.statementAst.index.name,
+            table: this.statementAst.table.name,
+            schema: this.statementAst.table.schema,
+            isUnique: this.statementAst.isUnique,
+            ifNotExists: this.statementAst.ifNotExists,
+            columns: this.statementAst.columns.map(col => col.name || expressionToString(col.expr)),
+            hasWhereClause: !!this.statementAst.where,
+            statement: expressionToString(this.statementAst) // Convert AST to string
+        };
+    }
+}
+//# sourceMappingURL=create-index-node.js.map

package/dist/src/planner/nodes/create-index-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-index-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/create-index-node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAKzB;IAJA,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC;IAEtD,YACE,KAAY,EACI,YAAiC;QAEjD,KAAK,CAAC,KAAK,CAAC,CAAC;QAFG,iBAAY,GAAZ,YAAY,CAAqB;IAGnD,CAAC;IAEQ,QAAQ;QACf,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,UAAU,YAAY,SAAS,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1G,CAAC;IAEQ,oBAAoB;QAC3B,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI;YACnC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI;YACnC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM;YACtC,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ;YACpC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW;YAC1C,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAK,CAAC,CAAC;YACxF,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK;YACzC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,YAAmB,CAAC,CAAC,wBAAwB;SACjF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/planner/nodes/create-table-node.d.ts

@@ -0,0 +1,15 @@
+import type * as AST from '../../parser/ast.js';
+import type { Scope } from '../scopes/scope.js';
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+/**
+ * Represents a CREATE TABLE statement in the logical query plan.
+ */
+export declare class CreateTableNode extends VoidNode {
+    readonly statementAst: AST.CreateTableStmt;
+    readonly nodeType = PlanNodeType.CreateTable;
+    constructor(scope: Scope, statementAst: AST.CreateTableStmt);
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=create-table-node.d.ts.map

package/dist/src/planner/nodes/create-table-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-table-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/create-table-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;aAK3B,YAAY,EAAE,GAAG,CAAC,eAAe;IAJjD,SAAkB,QAAQ,4BAA4B;gBAGpD,KAAK,EAAE,KAAK,EACE,YAAY,EAAE,GAAG,CAAC,eAAe;IAKxC,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOzD"}

package/dist/src/planner/nodes/create-table-node.js

@@ -0,0 +1,25 @@
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { expressionToString } from '../../util/ast-stringify.js';
+/**
+ * Represents a CREATE TABLE statement in the logical query plan.
+ */
+export class CreateTableNode extends VoidNode {
+    statementAst;
+    nodeType = PlanNodeType.CreateTable;
+    constructor(scope, statementAst) {
+        super(scope);
+        this.statementAst = statementAst;
+    }
+    toString() {
+        return `CREATE TABLE ${this.statementAst.table.name}`;
+    }
+    getLogicalAttributes() {
+        return {
+            table: this.statementAst.table.name,
+            schema: this.statementAst.table.schema,
+            statement: expressionToString(this.statementAst) // Convert AST to string
+        };
+    }
+}
+//# sourceMappingURL=create-table-node.js.map

package/dist/src/planner/nodes/create-table-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-table-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/create-table-node.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAK3B;IAJE,QAAQ,GAAG,YAAY,CAAC,WAAW,CAAC;IAEtD,YACE,KAAY,EACE,YAAiC;QAE/C,KAAK,CAAC,KAAK,CAAC,CAAC;QAFC,iBAAY,GAAZ,YAAY,CAAqB;IAGjD,CAAC;IAEQ,QAAQ;QACf,OAAO,gBAAgB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAEQ,oBAAoB;QAC3B,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI;YACnC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM;YACtC,SAAS,EAAE,kBAAkB,CAAC,IAAI,CAAC,YAAmB,CAAC,CAAC,wBAAwB;SACjF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/planner/nodes/create-view-node.d.ts

@@ -0,0 +1,21 @@
+import type * as AST from '../../parser/ast.js';
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { Scope } from '../scopes/scope.js';
+/**
+ * Plan node for CREATE VIEW statements.
+ * Creates a new view definition in the schema.
+ */
+export declare class CreateViewNode extends VoidNode {
+    readonly viewName: string;
+    readonly schemaName: string;
+    readonly ifNotExists: boolean;
+    readonly columns: string[] | undefined;
+    readonly selectStmt: AST.SelectStmt;
+    readonly sql: string;
+    readonly nodeType = PlanNodeType.CreateView;
+    constructor(scope: Scope, viewName: string, schemaName: string, ifNotExists: boolean, columns: string[] | undefined, selectStmt: AST.SelectStmt, sql: string);
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=create-view-node.d.ts.map

package/dist/src/planner/nodes/create-view-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-view-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/create-view-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,QAAQ;aAK1B,QAAQ,EAAE,MAAM;aAChB,UAAU,EAAE,MAAM;aAClB,WAAW,EAAE,OAAO;aACpB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS;aAC7B,UAAU,EAAE,GAAG,CAAC,UAAU;aAC1B,GAAG,EAAE,MAAM;IAT5B,QAAQ,CAAC,QAAQ,2BAA2B;gBAG3C,KAAK,EAAE,KAAK,EACI,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,UAAU,EAAE,GAAG,CAAC,UAAU,EAC1B,GAAG,EAAE,MAAM;IAKnB,QAAQ,IAAI,MAAM;IAMlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASxD"}

package/dist/src/planner/nodes/create-view-node.js

@@ -0,0 +1,39 @@
+import { VoidNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+/**
+ * Plan node for CREATE VIEW statements.
+ * Creates a new view definition in the schema.
+ */
+export class CreateViewNode extends VoidNode {
+    viewName;
+    schemaName;
+    ifNotExists;
+    columns;
+    selectStmt;
+    sql;
+    nodeType = PlanNodeType.CreateView;
+    constructor(scope, viewName, schemaName, ifNotExists, columns, selectStmt, sql) {
+        super(scope, 1); // Low cost for DDL operations
+        this.viewName = viewName;
+        this.schemaName = schemaName;
+        this.ifNotExists = ifNotExists;
+        this.columns = columns;
+        this.selectStmt = selectStmt;
+        this.sql = sql;
+    }
+    toString() {
+        const ifNotExistsClause = this.ifNotExists ? 'IF NOT EXISTS ' : '';
+        const columnsClause = this.columns ? `(${this.columns.join(', ')})` : '';
+        return `CREATE VIEW ${ifNotExistsClause}${this.schemaName}.${this.viewName}${columnsClause}`;
+    }
+    getLogicalAttributes() {
+        return {
+            viewName: this.viewName,
+            schemaName: this.schemaName,
+            ifNotExists: this.ifNotExists,
+            columns: this.columns,
+            selectSql: this.sql
+        };
+    }
+}
+//# sourceMappingURL=create-view-node.js.map

package/dist/src/planner/nodes/create-view-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-view-node.js","sourceRoot":"","sources":["../../../../src/planner/nodes/create-view-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGnD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAK1B;IACA;IACA;IACA;IACA;IACA;IATR,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC;IAE5C,YACC,KAAY,EACI,QAAgB,EAChB,UAAkB,EAClB,WAAoB,EACpB,OAA6B,EAC7B,UAA0B,EAC1B,GAAW;QAE3B,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,8BAA8B;QAP/B,aAAQ,GAAR,QAAQ,CAAQ;QAChB,eAAU,GAAV,UAAU,CAAQ;QAClB,gBAAW,GAAX,WAAW,CAAS;QACpB,YAAO,GAAP,OAAO,CAAsB;QAC7B,eAAU,GAAV,UAAU,CAAgB;QAC1B,QAAG,GAAH,GAAG,CAAQ;IAG5B,CAAC;IAEQ,QAAQ;QAChB,MAAM,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,OAAO,eAAe,iBAAiB,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,GAAG,aAAa,EAAE,CAAC;IAC9F,CAAC;IAEQ,oBAAoB;QAC5B,OAAO;YACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,GAAG;SACnB,CAAC;IACH,CAAC;CACD"}

package/dist/src/planner/nodes/cte-node.d.ts

@@ -0,0 +1,40 @@
+import { PlanNode, type UnaryRelationalNode, type RelationalPlanNode, type Attribute, type TableDescriptor } from './plan-node.js';
+import type { RelationType } from '../../common/datatype.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { Scope } from '../scopes/scope.js';
+/**
+ * Common interface for all CTE nodes (regular and recursive)
+ */
+export interface CTEPlanNode extends UnaryRelationalNode {
+    readonly cteName: string;
+    readonly columns: string[] | undefined;
+    readonly materializationHint: 'materialized' | 'not_materialized' | undefined;
+    readonly isRecursive: boolean;
+    readonly tableDescriptor: TableDescriptor;
+}
+/**
+ * Plan node for Common Table Expressions (CTEs).
+ * This represents a single CTE definition within a WITH clause.
+ */
+export declare class CTENode extends PlanNode implements CTEPlanNode {
+    readonly cteName: string;
+    readonly columns: string[] | undefined;
+    readonly source: RelationalPlanNode;
+    readonly materializationHint: 'materialized' | 'not_materialized' | undefined;
+    readonly isRecursive: boolean;
+    readonly nodeType = PlanNodeType.CTE;
+    readonly tableDescriptor: TableDescriptor;
+    private attributesCache;
+    private typeCache;
+    constructor(scope: Scope, cteName: string, columns: string[] | undefined, source: RelationalPlanNode, materializationHint: 'materialized' | 'not_materialized' | undefined, isRecursive?: boolean);
+    private buildAttributes;
+    private buildType;
+    getAttributes(): Attribute[];
+    getType(): RelationType;
+    getChildren(): readonly [];
+    getRelations(): readonly [RelationalPlanNode];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=cte-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cte-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/cte-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,cAAc,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC9E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,OAAQ,SAAQ,QAAS,YAAW,WAAW;aAS1C,OAAO,EAAE,MAAM;aACf,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS;aAC7B,MAAM,EAAE,kBAAkB;aAC1B,mBAAmB,EAAE,cAAc,GAAG,kBAAkB,GAAG,SAAS;aACpE,WAAW,EAAE,OAAO;IAZrC,QAAQ,CAAC,QAAQ,oBAAoB;IACrC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAM;IAE/C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAAuB;gBAGvC,KAAK,EAAE,KAAK,EACI,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,MAAM,EAAE,kBAAkB,EAC1B,mBAAmB,EAAE,cAAc,GAAG,kBAAkB,GAAG,SAAS,EACpE,WAAW,GAAE,OAAe;IAO7C,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,SAAS;IAejB,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAIvB,WAAW,IAAI,SAAS,EAAE;IAI1B,YAAY,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI7C,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAO/C,QAAQ,IAAI,MAAM;IAOlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASxD"}

package/dist/src/planner/nodes/cte-node.js

@@ -0,0 +1,88 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { Cached } from '../../util/cached.js';
+/**
+ * Plan node for Common Table Expressions (CTEs).
+ * This represents a single CTE definition within a WITH clause.
+ */
+export class CTENode extends PlanNode {
+    cteName;
+    columns;
+    source;
+    materializationHint;
+    isRecursive;
+    nodeType = PlanNodeType.CTE;
+    tableDescriptor = {}; // Identity object for table context lookup
+    attributesCache;
+    typeCache;
+    constructor(scope, cteName, columns, source, materializationHint, isRecursive = false) {
+        super(scope, source.getTotalCost() + 10); // Add small overhead for CTE materialization
+        this.cteName = cteName;
+        this.columns = columns;
+        this.source = source;
+        this.materializationHint = materializationHint;
+        this.isRecursive = isRecursive;
+        this.attributesCache = new Cached(() => this.buildAttributes());
+        this.typeCache = new Cached(() => this.buildType());
+    }
+    buildAttributes() {
+        const queryAttributes = this.source.getAttributes();
+        // Use explicit column names if provided, otherwise use query output column names
+        const queryType = this.source.getType();
+        const columnNames = this.columns || queryType.columns.map((c) => c.name);
+        return queryAttributes.map((attr, index) => ({
+            id: PlanNode.nextAttrId(),
+            name: columnNames[index] || attr.name,
+            type: attr.type,
+            sourceRelation: `cte:${this.cteName}`
+        }));
+    }
+    buildType() {
+        const queryType = this.source.getType();
+        return {
+            typeClass: 'relation',
+            isReadOnly: false,
+            isSet: queryType.isSet, // CTEs preserve the set/bag nature of their query
+            columns: this.getAttributes().map((attr) => ({
+                name: attr.name,
+                type: attr.type
+            })),
+            keys: [], // CTEs don't have inherent keys
+            rowConstraints: []
+        };
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getType() {
+        return this.typeCache.value;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [this.source];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            throw new Error(`CTENode expects 0 children, got ${newChildren.length}`);
+        }
+        return this; // No children in getChildren(), source is accessed via getRelations()
+    }
+    toString() {
+        const recursiveText = this.isRecursive ? 'RECURSIVE ' : '';
+        const columnsText = this.columns ? `(${this.columns.join(', ')})` : '';
+        const materializationText = this.materializationHint ? ` ${this.materializationHint.toUpperCase()}` : '';
+        return `${recursiveText}CTE ${this.cteName}${columnsText}${materializationText}`;
+    }
+    getLogicalAttributes() {
+        return {
+            cteName: this.cteName,
+            columns: this.columns,
+            materializationHint: this.materializationHint,
+            isRecursive: this.isRecursive,
+            queryType: this.getType()
+        };
+    }
+}
+//# sourceMappingURL=cte-node.js.map

package/dist/src/planner/nodes/cte-node.js.map

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

package/dist/src/planner/nodes/cte-reference-node.d.ts

@@ -0,0 +1,27 @@
+import { PlanNode, type UnaryRelationalNode, type RelationalPlanNode, type Attribute } from './plan-node.js';
+import type { RelationType } from '../../common/datatype.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { Scope } from '../scopes/scope.js';
+import type { CTEPlanNode } from './cte-node.js';
+/**
+ * Plan node for referencing a CTE in a FROM clause.
+ * This points to a materialized CTE result.
+ */
+export declare class CTEReferenceNode extends PlanNode implements UnaryRelationalNode {
+    readonly source: CTEPlanNode;
+    readonly alias?: string | undefined;
+    readonly nodeType = PlanNodeType.CTEReference;
+    private attributesCache;
+    private typeCache;
+    constructor(scope: Scope, source: CTEPlanNode, alias?: string | undefined);
+    private buildAttributes;
+    private buildType;
+    getAttributes(): Attribute[];
+    getType(): RelationType;
+    getChildren(): readonly [];
+    getRelations(): readonly [RelationalPlanNode];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=cte-reference-node.d.ts.map

package/dist/src/planner/nodes/cte-reference-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cte-reference-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/cte-reference-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,QAAS,YAAW,mBAAmB;aAQ3D,MAAM,EAAE,WAAW;aACnB,KAAK,CAAC,EAAE,MAAM;IAR/B,QAAQ,CAAC,QAAQ,6BAA6B;IAE9C,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAAuB;gBAGvC,KAAK,EAAE,KAAK,EACI,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,MAAM,YAAA;IAO/B,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,SAAS;IAejB,aAAa,IAAI,SAAS,EAAE;IAI5B,OAAO,IAAI,YAAY;IAIvB,WAAW,IAAI,SAAS,EAAE;IAI1B,YAAY,IAAI,SAAS,CAAC,kBAAkB,CAAC;IAI7C,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAO/C,QAAQ,IAAI,MAAM;IAKlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOxD"}

package/dist/src/planner/nodes/cte-reference-node.js

@@ -0,0 +1,75 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { Cached } from '../../util/cached.js';
+/**
+ * Plan node for referencing a CTE in a FROM clause.
+ * This points to a materialized CTE result.
+ */
+export class CTEReferenceNode extends PlanNode {
+    source;
+    alias;
+    nodeType = PlanNodeType.CTEReference;
+    attributesCache;
+    typeCache;
+    constructor(scope, source, alias) {
+        super(scope, 5); // Low cost since CTEs are materialized
+        this.source = source;
+        this.alias = alias;
+        this.attributesCache = new Cached(() => this.buildAttributes());
+        this.typeCache = new Cached(() => this.buildType());
+    }
+    buildAttributes() {
+        // Preserve original attribute IDs from the CTE to ensure proper context resolution
+        // especially important for recursive CTEs where working table substitution occurs
+        return this.source.getAttributes().map((attr) => ({
+            id: attr.id, // Preserve original ID instead of creating new one
+            name: attr.name,
+            type: attr.type,
+            sourceRelation: `cte_ref:${this.source.cteName}`
+        }));
+    }
+    buildType() {
+        const cteType = this.source.getType();
+        return {
+            typeClass: 'relation',
+            isReadOnly: false,
+            isSet: cteType.isSet,
+            columns: this.getAttributes().map((attr) => ({
+                name: attr.name,
+                type: attr.type
+            })),
+            keys: [], // CTE references don't have inherent keys
+            rowConstraints: []
+        };
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getType() {
+        return this.typeCache.value;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [this.source];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            throw new Error(`CTEReferenceNode expects 0 children, got ${newChildren.length}`);
+        }
+        return this; // No children in getChildren(), source is accessed via getRelations()
+    }
+    toString() {
+        const aliasText = this.alias ? ` AS ${this.alias}` : '';
+        return `CTE_REF ${this.source.cteName}${aliasText}`;
+    }
+    getLogicalAttributes() {
+        return {
+            cteName: this.source.cteName,
+            alias: this.alias,
+            materializationHint: this.source.materializationHint
+        };
+    }
+}
+//# sourceMappingURL=cte-reference-node.js.map

package/dist/src/planner/nodes/cte-reference-node.js.map

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