@quereus/quereus 0.1.0

package/dist/src/planner/nodes/reference.js

@@ -0,0 +1,258 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { relationTypeFromTableSchema } from '../type-utils.js';
+import { Cached } from '../../util/cached.js';
+import { isTableValuedFunctionSchema } from '../../schema/function.js';
+import { formatScalarType } from '../../util/plan-formatter.js';
+import { quereusError } from '../../common/errors.js';
+import { StatusCode } from '../../common/types.js';
+/** Represents a reference to a table in the global schema. */
+export class TableReferenceNode extends PlanNode {
+    tableSchema;
+    vtabModule;
+    vtabAuxData;
+    nodeType = PlanNodeType.TableReference;
+    typeCache;
+    attributesCache;
+    constructor(scope, tableSchema, vtabModule, vtabAuxData, estimatedCostOverride) {
+        super(scope, estimatedCostOverride ?? 1);
+        this.tableSchema = tableSchema;
+        this.vtabModule = vtabModule;
+        this.vtabAuxData = vtabAuxData;
+        this.typeCache = new Cached(() => relationTypeFromTableSchema(tableSchema));
+        this.attributesCache = new Cached(() => {
+            // Create attributes from table schema columns
+            return this.tableSchema.columns.map((column) => ({
+                id: PlanNode.nextAttrId(),
+                name: column.name,
+                type: {
+                    typeClass: 'scalar',
+                    affinity: column.affinity,
+                    nullable: !column.notNull,
+                    isReadOnly: false,
+                    collationName: column.collation
+                },
+                sourceRelation: `${this.tableSchema.schemaName}.${this.tableSchema.name}`
+            }));
+        });
+    }
+    getType() {
+        return this.typeCache.value;
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`TableReferenceNode expects 0 children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        return this; // No children, so no change
+    }
+    get estimatedRows() {
+        return this.tableSchema.estimatedRows;
+    }
+    toString() {
+        return `${this.tableSchema.schemaName}.${this.tableSchema.name}`;
+    }
+    getLogicalAttributes() {
+        return {
+            schema: this.tableSchema.schemaName,
+            table: this.tableSchema.name,
+            columns: this.tableSchema.columns.map(col => col.name),
+            estimates: {
+                rows: this.tableSchema.estimatedRows
+            }
+        };
+    }
+}
+export class TableFunctionReferenceNode extends PlanNode {
+    functionSchema;
+    nodeType = PlanNodeType.TableFunctionReference;
+    attributesCache;
+    constructor(scope, functionSchema, estimatedCostOverride) {
+        super(scope, estimatedCostOverride ?? 1);
+        this.functionSchema = functionSchema;
+        this.attributesCache = new Cached(() => {
+            // Create attributes from function schema return type
+            if (isTableValuedFunctionSchema(this.functionSchema)) {
+                return this.functionSchema.returnType.columns.map((column) => ({
+                    id: PlanNode.nextAttrId(),
+                    name: column.name,
+                    type: column.type,
+                    sourceRelation: `${this.functionSchema.name}()`
+                }));
+            }
+            return [];
+        });
+    }
+    getType() {
+        if (isTableValuedFunctionSchema(this.functionSchema)) {
+            return this.functionSchema.returnType;
+        }
+        quereusError(`Function ${this.functionSchema.name} is not a table-valued function`, StatusCode.INTERNAL);
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`TableFunctionReferenceNode expects 0 children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        return this; // No children, so no change
+    }
+    get estimatedRows() {
+        return 100; // Default estimate for table functions
+    }
+    toString() {
+        return `${this.functionSchema.name}()`;
+    }
+    getLogicalAttributes() {
+        const props = {
+            function: this.functionSchema.name,
+            numArgs: this.functionSchema.numArgs
+        };
+        if (isTableValuedFunctionSchema(this.functionSchema)) {
+            props.columns = this.functionSchema.returnType.columns.map(col => col.name);
+        }
+        return props;
+    }
+}
+/**
+ * Represents a reference to a column from a relational node.
+ * Uses attribute IDs for stable references across plan transformations.
+ */
+export class ColumnReferenceNode extends PlanNode {
+    expression;
+    columnType;
+    attributeId;
+    columnIndex;
+    nodeType = PlanNodeType.ColumnReference;
+    constructor(scope, expression, // Original AST expression for this reference
+    columnType, attributeId, // Stable attribute ID instead of node reference
+    columnIndex) {
+        super(scope, 0);
+        this.expression = expression;
+        this.columnType = columnType;
+        this.attributeId = attributeId;
+        this.columnIndex = columnIndex;
+    }
+    getType() {
+        return this.columnType;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`ColumnReferenceNode expects 0 children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        return this; // No children, so no change
+    }
+    toString() {
+        const columnName = this.expression.alias ??
+            (this.expression.schema ? this.expression.schema + '.' : '') + this.expression.name;
+        return columnName;
+    }
+    getLogicalAttributes() {
+        return {
+            column: this.expression.alias ?? this.expression.name,
+            schema: this.expression.schema,
+            attributeId: this.attributeId,
+            resultType: formatScalarType(this.columnType)
+        };
+    }
+}
+/**
+ * Represents a reference to a parameter (placeholder in a prepared statement).
+ * The actual value will be provided at execution time.
+ */
+export class ParameterReferenceNode extends PlanNode {
+    expression;
+    nameOrIndex;
+    targetType;
+    nodeType = PlanNodeType.ParameterReference;
+    constructor(scope, expression, // Original AST expression for this parameter
+    nameOrIndex, // Parameter name (e.g., ':foo') or 1-based index
+    targetType) {
+        super(scope, 0.01);
+        this.expression = expression;
+        this.nameOrIndex = nameOrIndex;
+        this.targetType = targetType;
+    }
+    getType() {
+        return this.targetType;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`ParameterReferenceNode expects 0 children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        return this; // No children, so no change
+    }
+    toString() {
+        return `:${this.nameOrIndex}`;
+    }
+    getLogicalAttributes() {
+        return {
+            parameter: this.nameOrIndex,
+            resultType: formatScalarType(this.targetType)
+        };
+    }
+}
+export class FunctionReferenceNode extends PlanNode {
+    functionSchema;
+    targetType;
+    nodeType = PlanNodeType.TableFunctionReference;
+    constructor(scope, functionSchema, targetType) {
+        super(scope);
+        this.functionSchema = functionSchema;
+        this.targetType = targetType;
+    }
+    // Type has to be determined by scalar or relation call node
+    getType() {
+        return this.targetType;
+    }
+    getChildren() {
+        return [];
+    }
+    getRelations() {
+        return [];
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== 0) {
+            quereusError(`FunctionReferenceNode expects 0 children, got ${newChildren.length}`, StatusCode.INTERNAL);
+        }
+        return this; // No children, so no change
+    }
+    toString() {
+        return `${this.functionSchema.name}`;
+    }
+    getLogicalAttributes() {
+        return {
+            function: this.functionSchema.name,
+            numArgs: this.functionSchema.numArgs,
+            targetType: this.targetType.typeClass
+        };
+    }
+}
+//# sourceMappingURL=reference.js.map

package/dist/src/planner/nodes/reference.js.map

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

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

@@ -0,0 +1,37 @@
+import type { Scope } from '../scopes/scope.js';
+import { PlanNode, type RelationalPlanNode, type Attribute } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import type { ScalarPlanNode } from './plan-node.js';
+import type { RelationType } from '../../common/datatype.js';
+export interface ReturningProjection {
+    node: ScalarPlanNode;
+    alias?: string;
+    /** Optional predefined attribute ID to preserve during optimization */
+    attributeId?: number;
+}
+/**
+ * Represents a RETURNING clause that projects rows from a DML operation.
+ * The executor performs the DML operation and yields the affected rows.
+ */
+export declare class ReturningNode extends PlanNode implements RelationalPlanNode {
+    readonly executor: RelationalPlanNode;
+    readonly projections: ReadonlyArray<ReturningProjection>;
+    readonly nodeType = PlanNodeType.Returning;
+    private outputTypeCache;
+    private attributesCache;
+    constructor(scope: Scope, executor: RelationalPlanNode, // The DML operation that yields affected rows
+    projections: ReadonlyArray<ReturningProjection>, 
+    /** Optional predefined attributes for preserving IDs during optimization */
+    predefinedAttributes?: Attribute[]);
+    private buildOutputType;
+    private buildAttributes;
+    getType(): RelationType;
+    getAttributes(): Attribute[];
+    getRelations(): readonly RelationalPlanNode[];
+    getChildren(): readonly ScalarPlanNode[];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    get estimatedRows(): number | undefined;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=returning-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"returning-node.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/returning-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,KAAK,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK7D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,aAAc,SAAQ,QAAS,YAAW,kBAAkB;aAQrD,QAAQ,EAAE,kBAAkB;aAC5B,WAAW,EAAE,aAAa,CAAC,mBAAmB,CAAC;IARjE,SAAkB,QAAQ,0BAA0B;IAEpD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,eAAe,CAAsB;gBAG3C,KAAK,EAAE,KAAK,EACI,QAAQ,EAAE,kBAAkB,EAAE,8CAA8C;IAC5E,WAAW,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAC/D,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,SAAS,EAAE;IAepC,OAAO,CAAC,eAAe;IAwDvB,OAAO,CAAC,eAAe;IAqCvB,OAAO,IAAI,YAAY;IAIvB,aAAa,IAAI,SAAS,EAAE;IAI5B,YAAY,IAAI,SAAS,kBAAkB,EAAE;IAK7C,WAAW,IAAI,SAAS,cAAc,EAAE;IAIxC,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAqCxD,IAAI,aAAa,IAAI,MAAM,GAAG,SAAS,CAEtC;IAEQ,QAAQ,IAAI,MAAM;IAOlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUzD"}

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

@@ -0,0 +1,183 @@
+import { PlanNode } from './plan-node.js';
+import { PlanNodeType } from './plan-node-type.js';
+import { ColumnReferenceNode } from './reference.js';
+import { expressionToString } from '../../util/ast-stringify.js';
+import { Cached } from '../../util/cached.js';
+/**
+ * Represents a RETURNING clause that projects rows from a DML operation.
+ * The executor performs the DML operation and yields the affected rows.
+ */
+export class ReturningNode extends PlanNode {
+    executor;
+    projections;
+    nodeType = PlanNodeType.Returning;
+    outputTypeCache;
+    attributesCache;
+    constructor(scope, executor, // The DML operation that yields affected rows
+    projections, 
+    /** Optional predefined attributes for preserving IDs during optimization */
+    predefinedAttributes) {
+        super(scope);
+        this.executor = executor;
+        this.projections = projections;
+        this.outputTypeCache = new Cached(() => this.buildOutputType());
+        this.attributesCache = new Cached(() => {
+            // If predefined attributes are provided, use them (for optimization)
+            if (predefinedAttributes) {
+                return predefinedAttributes.slice(); // Return a copy
+            }
+            return this.buildAttributes();
+        });
+    }
+    buildOutputType() {
+        // Return type is based on the projections, similar to ProjectNode
+        // Build column names with proper duplicate handling
+        const columnNames = [];
+        const nameCount = new Map();
+        const columns = this.projections.map((proj) => {
+            // Determine base column name
+            let baseName;
+            if (proj.alias) {
+                baseName = proj.alias.toLowerCase();
+            }
+            else if (proj.node instanceof ColumnReferenceNode) {
+                // For column references, check if there's a table qualifier (like NEW or OLD)
+                const expr = proj.node.expression;
+                if (expr.table) {
+                    // Use qualified name for NEW.id, OLD.id, etc., normalized to lowercase
+                    baseName = `${expr.table.toLowerCase()}.${expr.name.toLowerCase()}`;
+                }
+                else {
+                    // Use the unqualified column name, normalized to lowercase
+                    baseName = expr.name.toLowerCase();
+                }
+            }
+            else {
+                // For expressions, use the string representation
+                baseName = expressionToString(proj.node.expression);
+            }
+            // Handle duplicate names
+            let finalName;
+            const currentCount = nameCount.get(baseName) || 0;
+            if (currentCount === 0) {
+                // First occurrence - use the base name
+                finalName = baseName;
+            }
+            else {
+                // Subsequent occurrences - add numbered suffix
+                finalName = `${baseName}:${currentCount}`;
+            }
+            nameCount.set(baseName, currentCount + 1);
+            columnNames.push(finalName);
+            return {
+                name: finalName,
+                type: proj.node.getType(),
+                nullable: true // Conservative assumption
+            };
+        });
+        return {
+            typeClass: 'relation',
+            columns,
+            isSet: this.executor.getType().isSet, // Preserve set/bag semantics
+            isReadOnly: false,
+            keys: [], // No known keys for returning results
+            rowConstraints: [], // No row constraints for returning results
+        };
+    }
+    buildAttributes() {
+        // Create attributes for the projected columns
+        // Get the computed column names from the type
+        const outputType = this.getType();
+        // For each projection, preserve attribute ID if it's a simple column reference
+        return this.projections.map((proj, index) => {
+            // Check if projection has a predefined attribute ID
+            if (proj.attributeId !== undefined) {
+                return {
+                    id: proj.attributeId,
+                    name: outputType.columns[index].name,
+                    type: proj.node.getType(),
+                    sourceRelation: `${this.nodeType}:${this.id}`
+                };
+            }
+            // If this projection is a simple column reference, preserve its attribute ID
+            if (proj.node instanceof ColumnReferenceNode) {
+                return {
+                    id: proj.node.attributeId,
+                    name: outputType.columns[index].name, // Use the deduplicated name
+                    type: proj.node.getType(),
+                    sourceRelation: `${this.nodeType}:${this.id}`
+                };
+            }
+            else {
+                // For computed expressions, generate new attribute ID
+                return {
+                    id: PlanNode.nextAttrId(),
+                    name: outputType.columns[index].name, // Use the deduplicated name
+                    type: proj.node.getType(),
+                    sourceRelation: `${this.nodeType}:${this.id}`
+                };
+            }
+        });
+    }
+    getType() {
+        return this.outputTypeCache.value;
+    }
+    getAttributes() {
+        return this.attributesCache.value;
+    }
+    getRelations() {
+        // Return the executor which is now a RelationalPlanNode
+        return [this.executor];
+    }
+    getChildren() {
+        return this.projections.map(proj => proj.node);
+    }
+    withChildren(newChildren) {
+        if (newChildren.length !== this.projections.length) {
+            throw new Error(`ReturningNode expects ${this.projections.length} children, got ${newChildren.length}`);
+        }
+        // Type check
+        for (const child of newChildren) {
+            if (!('expression' in child)) {
+                throw new Error('ReturningNode: all children must be ScalarPlanNodes');
+            }
+        }
+        // Check if anything changed
+        const childrenChanged = newChildren.some((child, i) => child !== this.projections[i].node);
+        if (!childrenChanged) {
+            return this;
+        }
+        // **CRITICAL**: Preserve original attribute IDs to maintain column reference stability
+        const originalAttributes = this.getAttributes();
+        // Create new projections with preserved attribute IDs
+        const newProjections = this.projections.map((proj, i) => ({
+            node: newChildren[i],
+            alias: proj.alias,
+            attributeId: originalAttributes[i].id // Preserve original attribute ID
+        }));
+        // Create new instance with preserved attributes
+        return new ReturningNode(this.scope, this.executor, // Executor doesn't change via withChildren
+        newProjections, originalAttributes // Pass original attributes to preserve IDs
+        );
+    }
+    get estimatedRows() {
+        return this.executor.estimatedRows;
+    }
+    toString() {
+        const projList = this.projections.length > 3
+            ? `${this.projections.length} columns`
+            : this.projections.map(p => p.alias || 'expr').join(', ');
+        return `RETURNING ${projList}`;
+    }
+    getLogicalAttributes() {
+        return {
+            executor: this.executor.nodeType,
+            projectionCount: this.projections.length,
+            projections: this.projections.map(proj => ({
+                alias: proj.alias,
+                expression: proj.node.toString()
+            }))
+        };
+    }
+}
+//# sourceMappingURL=returning-node.js.map

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

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

package/dist/src/planner/nodes/scalar.d.ts

@@ -0,0 +1,106 @@
+import type { ScalarType } from "../../common/datatype.js";
+import { OutputValue } from "../../common/types.js";
+import { PlanNode, type ScalarPlanNode, type UnaryScalarNode, type NaryScalarNode, type ZeroAryScalarNode, type BinaryScalarNode, PhysicalProperties, type ConstantNode } from "./plan-node.js";
+import type * as AST from "../../parser/ast.js";
+import type { Scope } from "../scopes/scope.js";
+import { PlanNodeType } from "./plan-node-type.js";
+export declare class UnaryOpNode extends PlanNode implements UnaryScalarNode {
+    readonly scope: Scope;
+    readonly expression: AST.UnaryExpr;
+    readonly operand: ScalarPlanNode;
+    readonly nodeType = PlanNodeType.UnaryOp;
+    private cachedType;
+    constructor(scope: Scope, expression: AST.UnaryExpr, operand: ScalarPlanNode);
+    generateType: () => ScalarType;
+    getType(): ScalarType;
+    getChildren(): readonly [ScalarPlanNode];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+export declare class BinaryOpNode extends PlanNode implements BinaryScalarNode {
+    readonly scope: Scope;
+    readonly expression: AST.BinaryExpr;
+    readonly left: ScalarPlanNode;
+    readonly right: ScalarPlanNode;
+    readonly nodeType = PlanNodeType.BinaryOp;
+    private cachedType;
+    constructor(scope: Scope, expression: AST.BinaryExpr, left: ScalarPlanNode, right: ScalarPlanNode);
+    generateType: () => ScalarType;
+    getType(): ScalarType;
+    getChildren(): readonly [ScalarPlanNode, ScalarPlanNode];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+export declare class LiteralNode extends PlanNode implements ZeroAryScalarNode, ConstantNode {
+    readonly scope: Scope;
+    readonly expression: AST.LiteralExpr;
+    readonly nodeType = PlanNodeType.Literal;
+    constructor(scope: Scope, expression: AST.LiteralExpr);
+    getType(): ScalarType;
+    getValue(): OutputValue;
+    getChildren(): readonly [];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+    computePhysical(): Partial<PhysicalProperties>;
+}
+export declare class CaseExprNode extends PlanNode implements NaryScalarNode {
+    readonly scope: Scope;
+    readonly expression: AST.CaseExpr;
+    readonly baseExpr: ScalarPlanNode | undefined;
+    readonly whenThenClauses: {
+        when: ScalarPlanNode;
+        then: ScalarPlanNode;
+    }[];
+    readonly elseExpr: ScalarPlanNode | undefined;
+    readonly nodeType = PlanNodeType.CaseExpr;
+    private cachedType;
+    constructor(scope: Scope, expression: AST.CaseExpr, baseExpr: ScalarPlanNode | undefined, whenThenClauses: {
+        when: ScalarPlanNode;
+        then: ScalarPlanNode;
+    }[], elseExpr: ScalarPlanNode | undefined);
+    getType(): ScalarType;
+    generateType: () => ScalarType;
+    get operands(): readonly ScalarPlanNode[];
+    getChildren(): readonly ScalarPlanNode[];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+export declare class CastNode extends PlanNode implements UnaryScalarNode {
+    readonly scope: Scope;
+    readonly expression: AST.CastExpr;
+    readonly operand: ScalarPlanNode;
+    readonly nodeType = PlanNodeType.Cast;
+    private cachedType;
+    constructor(scope: Scope, expression: AST.CastExpr, operand: ScalarPlanNode);
+    getType(): ScalarType;
+    generateType: () => ScalarType;
+    getChildren(): readonly [ScalarPlanNode];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+export declare class CollateNode extends PlanNode implements UnaryScalarNode {
+    readonly scope: Scope;
+    readonly expression: AST.CollateExpr;
+    readonly operand: ScalarPlanNode;
+    readonly nodeType = PlanNodeType.Collate;
+    private cachedType;
+    constructor(scope: Scope, expression: AST.CollateExpr, operand: ScalarPlanNode);
+    getType(): ScalarType;
+    generateType: () => ScalarType;
+    getChildren(): readonly [ScalarPlanNode];
+    getRelations(): readonly [];
+    withChildren(newChildren: readonly PlanNode[]): PlanNode;
+    toString(): string;
+    getLogicalAttributes(): Record<string, unknown>;
+}
+//# sourceMappingURL=scalar.d.ts.map

package/dist/src/planner/nodes/scalar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scalar.d.ts","sourceRoot":"","sources":["../../../../src/planner/nodes/scalar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAe,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChM,OAAO,KAAK,KAAK,GAAG,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMnD,qBAAa,WAAY,SAAQ,QAAS,YAAW,eAAe;aAKlD,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,SAAS;aACzB,OAAO,EAAE,cAAc;IANxC,QAAQ,CAAC,QAAQ,wBAAwB;IACzC,OAAO,CAAC,UAAU,CAAqB;gBAGtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,SAAS,EACzB,OAAO,EAAE,cAAc;IAMxC,YAAY,QAAO,UAAU,CAmC5B;IAED,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,SAAS,CAAC,cAAc,CAAC;IAIxC,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAyB/C,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASxD;AAED,qBAAa,YAAa,SAAQ,QAAS,YAAW,gBAAgB;aAKpD,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,UAAU;aAC1B,IAAI,EAAE,cAAc;aACpB,KAAK,EAAE,cAAc;IAPtC,QAAQ,CAAC,QAAQ,yBAAyB;IAC1C,OAAO,CAAC,UAAU,CAAqB;gBAGtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,UAAU,EAC1B,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,cAAc;IAOtC,YAAY,QAAO,UAAU,CA2C5B;IAED,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,SAAS,CAAC,cAAc,EAAE,cAAc,CAAC;IAIxD,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IA0B/C,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUxD;AAED,qBAAa,WAAY,SAAQ,QAAS,YAAW,iBAAiB,EAAE,YAAY;aAIlE,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,WAAW;IAJ5C,QAAQ,CAAC,QAAQ,wBAAwB;gBAGxB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,WAAW;IAK5C,OAAO,IAAI,UAAU;IA2DrB,QAAQ,IAAI,WAAW;IAIvB,WAAW,IAAI,SAAS,EAAE;IAI1B,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAO/C,QAAQ,IAAI,MAAM;IAQlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAO/C,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAKvD;AAED,qBAAa,YAAa,SAAQ,QAAS,YAAW,cAAc;aAKlD,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,QAAQ;aACxB,QAAQ,EAAE,cAAc,GAAG,SAAS;aACpC,eAAe,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,EAAE;aACjE,QAAQ,EAAE,cAAc,GAAG,SAAS;IARrD,QAAQ,CAAC,QAAQ,yBAAyB;IAC1C,OAAO,CAAC,UAAU,CAAqB;gBAGtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,QAAQ,EACxB,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,eAAe,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,EAAE,EACjE,QAAQ,EAAE,cAAc,GAAG,SAAS;IAMrD,OAAO,IAAI,UAAU;IAIrB,YAAY,QAAO,UAAU,CAgE5B;IAED,IAAI,QAAQ,IAAI,SAAS,cAAc,EAAE,CAgBxC;IAED,WAAW,IAAI,SAAS,cAAc,EAAE;IAIxC,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAmD/C,QAAQ,IAAI,MAAM;IASlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAmBxD;AAED,qBAAa,QAAS,SAAQ,QAAS,YAAW,eAAe;aAK/C,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,QAAQ;aACxB,OAAO,EAAE,cAAc;IANxC,QAAQ,CAAC,QAAQ,qBAAqB;IACtC,OAAO,CAAC,UAAU,CAAqB;gBAGtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,QAAQ,EACxB,OAAO,EAAE,cAAc;IAMxC,OAAO,IAAI,UAAU;IAIrB,YAAY,QAAO,UAAU,CAkE5B;IAED,WAAW,IAAI,SAAS,CAAC,cAAc,CAAC;IAIxC,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAyB/C,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOxD;AAED,qBAAa,WAAY,SAAQ,QAAS,YAAW,eAAe;aAKlD,KAAK,EAAE,KAAK;aACZ,UAAU,EAAE,GAAG,CAAC,WAAW;aAC3B,OAAO,EAAE,cAAc;IANxC,QAAQ,CAAC,QAAQ,wBAAwB;IACzC,OAAO,CAAC,UAAU,CAAqB;gBAGtB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,GAAG,CAAC,WAAW,EAC3B,OAAO,EAAE,cAAc;IAMxC,OAAO,IAAI,UAAU;IAIrB,YAAY,QAAO,UAAU,CAY5B;IAED,WAAW,IAAI,SAAS,CAAC,cAAc,CAAC;IAIxC,YAAY,IAAI,SAAS,EAAE;IAI3B,YAAY,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ;IAyB/C,QAAQ,IAAI,MAAM;IAIlB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOxD"}