@tinqerjs/tinqer 0.0.21

package/dist/visitors/take-skip/skip.js

@@ -0,0 +1,209 @@
+/**
+ * SKIP operation visitor
+ * Handles .skip() and .offset() operations
+ */
+import { createAutoParam } from "../types.js";
+/**
+ * Visit SKIP operation
+ */
+export function visitSkipOperation(ast, source, _methodName, visitorContext) {
+    // SKIP expects a numeric argument: skip(10) or skip(p.offset)
+    if (!ast.arguments || ast.arguments.length === 0) {
+        return null;
+    }
+    const arg = ast.arguments[0];
+    if (!arg)
+        return null;
+    const autoParams = {};
+    // Handle numeric literal
+    if (arg.type === "NumericLiteral" || arg.type === "Literal") {
+        const value = arg.type === "NumericLiteral"
+            ? arg.value
+            : arg.value;
+        // Auto-parameterize the offset value with field context
+        const paramName = createAutoParam(visitorContext, value, {
+            fieldName: "OFFSET",
+        });
+        autoParams[paramName] = value;
+        return {
+            operation: {
+                type: "queryOperation",
+                operationType: "skip",
+                source,
+                count: { type: "param", param: paramName },
+            },
+            autoParams,
+        };
+    }
+    // Handle external parameter (e.g., p.offset)
+    if (arg.type === "MemberExpression") {
+        const memberExpr = arg;
+        if (memberExpr.object.type === "Identifier" && memberExpr.property.type === "Identifier") {
+            const objectName = memberExpr.object.name;
+            const propertyName = memberExpr.property.name;
+            // Check if it's a query parameter
+            if (visitorContext.queryParams.has(objectName)) {
+                return {
+                    operation: {
+                        type: "queryOperation",
+                        operationType: "skip",
+                        source,
+                        count: { type: "param", param: objectName, property: propertyName },
+                    },
+                    autoParams: {},
+                };
+            }
+        }
+    }
+    // Handle direct identifier (e.g., offset)
+    if (arg.type === "Identifier") {
+        const name = arg.name;
+        // Check if it's a query parameter
+        if (visitorContext.queryParams.has(name)) {
+            return {
+                operation: {
+                    type: "queryOperation",
+                    operationType: "skip",
+                    source,
+                    count: { type: "param", param: name },
+                },
+                autoParams: {},
+            };
+        }
+    }
+    // Handle arithmetic expressions (e.g., skip((p.page - 1) * p.pageSize))
+    // Also handle parenthesized expressions
+    if (arg.type === "BinaryExpression" || arg.type === "ParenthesizedExpression") {
+        const result = visitValueExpression(arg, visitorContext);
+        if (result && result.value) {
+            // Merge any auto-params created
+            for (const [key, value] of Object.entries(result.autoParams)) {
+                autoParams[key] = value;
+            }
+            return {
+                operation: {
+                    type: "queryOperation",
+                    operationType: "skip",
+                    source,
+                    count: result.value,
+                },
+                autoParams,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Visit a value expression for SKIP/TAKE context
+ * Returns the expression and any auto-params created
+ */
+function visitValueExpression(node, context) {
+    const autoParams = {};
+    switch (node.type) {
+        case "BinaryExpression": {
+            const binary = node;
+            // Arithmetic expression
+            if (["+", "-", "*", "/", "%"].includes(binary.operator)) {
+                // Recursively visit left and right
+                const leftResult = visitValueExpression(binary.left, context);
+                const rightResult = visitValueExpression(binary.right, context);
+                if (!leftResult?.value || !rightResult?.value)
+                    return null;
+                // Merge auto-params
+                Object.assign(autoParams, leftResult.autoParams, rightResult.autoParams);
+                return {
+                    value: {
+                        type: "arithmetic",
+                        operator: binary.operator,
+                        left: leftResult.value,
+                        right: rightResult.value,
+                    },
+                    autoParams,
+                };
+            }
+            return null;
+        }
+        case "MemberExpression": {
+            const memberExpr = node;
+            if (memberExpr.object.type === "Identifier" && memberExpr.property.type === "Identifier") {
+                const objectName = memberExpr.object.name;
+                const propertyName = memberExpr.property.name;
+                // Check if it's a query parameter
+                if (context.queryParams.has(objectName)) {
+                    return {
+                        value: {
+                            type: "param",
+                            param: objectName,
+                            property: propertyName,
+                        },
+                        autoParams: {},
+                    };
+                }
+            }
+            return null;
+        }
+        case "NumericLiteral":
+        case "Literal": {
+            const value = node.type === "NumericLiteral"
+                ? node.value
+                : node.value;
+            // Auto-parameterize with OFFSET context
+            const paramName = createAutoParam(context, value, {
+                fieldName: "OFFSET",
+            });
+            autoParams[paramName] = value;
+            return {
+                value: {
+                    type: "param",
+                    param: paramName,
+                },
+                autoParams,
+            };
+        }
+        case "Identifier": {
+            const name = node.name;
+            // Check if it's a query parameter
+            if (context.queryParams.has(name)) {
+                return {
+                    value: {
+                        type: "param",
+                        param: name,
+                    },
+                    autoParams: {},
+                };
+            }
+            return null;
+        }
+        case "ParenthesizedExpression": {
+            // Unwrap parentheses
+            const paren = node;
+            return visitValueExpression(paren.expression, context);
+        }
+        case "UnaryExpression": {
+            const unary = node;
+            // Handle negative numbers
+            if (unary.operator === "-" &&
+                (unary.argument.type === "NumericLiteral" || unary.argument.type === "Literal")) {
+                const lit = unary.argument;
+                if (typeof lit.value === "number") {
+                    const value = -lit.value;
+                    const paramName = createAutoParam(context, value, {
+                        fieldName: "OFFSET",
+                    });
+                    autoParams[paramName] = value;
+                    return {
+                        value: {
+                            type: "param",
+                            param: paramName,
+                        },
+                        autoParams,
+                    };
+                }
+            }
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=skip.js.map

package/dist/visitors/take-skip/skip.js.map

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

package/dist/visitors/take-skip/take.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TAKE operation visitor
+ * Handles .take() and .limit() operations
+ */
+import type { TakeOperation, QueryOperation } from "../../query-tree/operations.js";
+import type { CallExpression as ASTCallExpression } from "../../parser/ast-types.js";
+import type { VisitorContext } from "../types.js";
+/**
+ * Visit TAKE operation
+ */
+export declare function visitTakeOperation(ast: ASTCallExpression, source: QueryOperation, _methodName: string, visitorContext: VisitorContext): {
+    operation: TakeOperation;
+    autoParams: Record<string, unknown>;
+} | null;
+//# sourceMappingURL=take.d.ts.map

package/dist/visitors/take-skip/take.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.d.ts","sourceRoot":"","sources":["../../../src/visitors/take-skip/take.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAY,MAAM,gCAAgC,CAAC;AAC9F,OAAO,KAAK,EACV,cAAc,IAAI,iBAAiB,EAKpC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,cAAc,GAC7B;IAAE,SAAS,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CA4E1E"}

package/dist/visitors/take-skip/take.js

@@ -0,0 +1,76 @@
+/**
+ * TAKE operation visitor
+ * Handles .take() and .limit() operations
+ */
+import { createAutoParam } from "../types.js";
+/**
+ * Visit TAKE operation
+ */
+export function visitTakeOperation(ast, source, _methodName, visitorContext) {
+    // TAKE expects a numeric argument: take(10) or take(p.limit)
+    if (!ast.arguments || ast.arguments.length === 0) {
+        return null;
+    }
+    const arg = ast.arguments[0];
+    if (!arg)
+        return null;
+    const autoParams = {};
+    // Handle numeric literal
+    if (arg.type === "NumericLiteral" || arg.type === "Literal") {
+        const value = arg.type === "NumericLiteral"
+            ? arg.value
+            : arg.value;
+        // Auto-parameterize the limit value with field context
+        const paramName = createAutoParam(visitorContext, value, {
+            fieldName: "LIMIT",
+        });
+        autoParams[paramName] = value;
+        return {
+            operation: {
+                type: "queryOperation",
+                operationType: "take",
+                source,
+                count: { type: "param", param: paramName },
+            },
+            autoParams,
+        };
+    }
+    // Handle external parameter (e.g., p.limit)
+    if (arg.type === "MemberExpression") {
+        const memberExpr = arg;
+        if (memberExpr.object.type === "Identifier" && memberExpr.property.type === "Identifier") {
+            const objectName = memberExpr.object.name;
+            const propertyName = memberExpr.property.name;
+            // Check if it's a query parameter
+            if (visitorContext.queryParams.has(objectName)) {
+                return {
+                    operation: {
+                        type: "queryOperation",
+                        operationType: "take",
+                        source,
+                        count: { type: "param", param: objectName, property: propertyName },
+                    },
+                    autoParams: {},
+                };
+            }
+        }
+    }
+    // Handle direct identifier (e.g., limit)
+    if (arg.type === "Identifier") {
+        const name = arg.name;
+        // Check if it's a query parameter
+        if (visitorContext.queryParams.has(name)) {
+            return {
+                operation: {
+                    type: "queryOperation",
+                    operationType: "take",
+                    source,
+                    count: { type: "param", param: name },
+                },
+                autoParams: {},
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=take.js.map

package/dist/visitors/take-skip/take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"take.js","sourceRoot":"","sources":["../../../src/visitors/take-skip/take.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAsB,EACtB,MAAsB,EACtB,WAAmB,EACnB,cAA8B;IAE9B,6DAA6D;IAC7D,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,yBAAyB;IACzB,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,KAAK,GACT,GAAG,CAAC,IAAI,KAAK,gBAAgB;YAC3B,CAAC,CAAE,GAAsB,CAAC,KAAK;YAC/B,CAAC,CAAG,GAAe,CAAC,KAAgB,CAAC;QAEzC,uDAAuD;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,cAAc,EAAE,KAAK,EAAE;YACvD,SAAS,EAAE,OAAO;SACnB,CAAC,CAAC;QACH,UAAU,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QAE9B,OAAO;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,gBAAgB;gBACtB,aAAa,EAAE,MAAM;gBACrB,MAAM;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;aAC3C;YACD,UAAU;SACX,CAAC;IACJ,CAAC;IAED,4CAA4C;IAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,GAAuB,CAAC;QAC3C,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACzF,MAAM,UAAU,GAAI,UAAU,CAAC,MAAqB,CAAC,IAAI,CAAC;YAC1D,MAAM,YAAY,GAAI,UAAU,CAAC,QAAuB,CAAC,IAAI,CAAC;YAE9D,kCAAkC;YAClC,IAAI,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,SAAS,EAAE;wBACT,IAAI,EAAE,gBAAgB;wBACtB,aAAa,EAAE,MAAM;wBACrB,MAAM;wBACN,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAc;qBAChF;oBACD,UAAU,EAAE,EAAE;iBACf,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAI,GAAkB,CAAC,IAAI,CAAC;QAEtC,kCAAkC;QAClC,IAAI,cAAc,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,SAAS,EAAE;oBACT,IAAI,EAAE,gBAAgB;oBACtB,aAAa,EAAE,MAAM;oBACrB,MAAM;oBACN,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAc;iBAClD;gBACD,UAAU,EAAE,EAAE;aACf,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/visitors/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Core visitor types and context definitions
+ *
+ * Visitors are pure functions that transform AST nodes into expressions
+ * Context provides environment information needed during traversal
+ */
+import type { Expression, BooleanExpression, ValueExpression, ObjectExpression, ArrayExpression } from "../expressions/expression.js";
+import type { ASTNode, Expression as ASTExpression } from "../parser/ast-types.js";
+import type { ObjectShapeNode } from "../query-tree/operations.js";
+/**
+ * Base visitor function signature
+ * Pure function that transforms an AST node to a result type
+ */
+export type Visitor<TNode = ASTNode, TContext = VisitorContext, TResult = Expression | null> = (node: TNode, context: TContext) => TResult;
+/**
+ * Specialized visitor types for different contexts
+ */
+export type BooleanVisitor = Visitor<ASTExpression, BooleanContext, BooleanExpression | null>;
+export type ValueVisitor = Visitor<ASTExpression, ValueContext, ValueExpression | null>;
+export type ObjectVisitor = Visitor<ASTExpression, ObjectContext, ObjectExpression | null>;
+export type ArrayVisitor = Visitor<ASTExpression, ArrayContext, ArrayExpression | null>;
+export type ExpressionVisitor = Visitor<ASTExpression, VisitorContext, Expression | null>;
+/**
+ * Enhanced auto-parameter information with field context
+ */
+export interface AutoParamInfo {
+    value: string | number | boolean | null;
+    fieldName?: string;
+    tableName?: string;
+    sourceTable?: number;
+}
+/**
+ * Base visitor context with common information
+ */
+export interface VisitorContext {
+    queryBuilderParam?: string;
+    tableParams: Set<string>;
+    queryParams: Set<string>;
+    helpersParam?: string;
+    groupingParams?: Set<string>;
+    autoParams: Map<string, unknown>;
+    autoParamCounter: number;
+    autoParamInfos?: Map<string, AutoParamInfo>;
+    joinParams?: Map<string, number>;
+    joinResultParam?: string;
+    currentResultShape?: ObjectShapeNode;
+    currentTable?: string;
+    inSelectProjection?: boolean;
+    hasTableParam?: boolean;
+    expectedType?: "boolean" | "value" | "object" | "array" | "any";
+}
+/**
+ * Context for boolean expressions (WHERE, JOIN ON, etc.)
+ */
+export interface BooleanContext extends VisitorContext {
+    expectedType: "boolean";
+}
+/**
+ * Context for value expressions (arithmetic, column access, etc.)
+ */
+export interface ValueContext extends VisitorContext {
+    expectedType: "value";
+}
+/**
+ * Context for object expressions (SELECT projections)
+ */
+export interface ObjectContext extends VisitorContext {
+    expectedType: "object";
+}
+/**
+ * Context for array expressions
+ */
+export interface ArrayContext extends VisitorContext {
+    expectedType: "array";
+}
+/**
+ * Context for GROUP BY key selection
+ */
+export interface KeyContext extends VisitorContext {
+    expectedType: "value";
+    allowComposite?: boolean;
+}
+/**
+ * Context for aggregate expressions
+ */
+export interface AggregateContext extends VisitorContext {
+    expectedType: "value";
+    inAggregate: true;
+}
+/**
+ * Registry of visitors for different AST node types
+ * Each context can have its own set of visitors
+ */
+export interface VisitorRegistry {
+    common: Map<string, ExpressionVisitor>;
+    boolean: Map<string, BooleanVisitor>;
+    value: Map<string, ValueVisitor>;
+    object: Map<string, ObjectVisitor>;
+    array: Map<string, ArrayVisitor>;
+}
+/**
+ * Create a base context with common properties
+ */
+export declare function createBaseContext(): VisitorContext;
+/**
+ * Create a boolean context from a base context
+ */
+export declare function toBooleanContext(context: VisitorContext): BooleanContext;
+/**
+ * Create a value context from a base context
+ */
+export declare function toValueContext(context: VisitorContext): ValueContext;
+/**
+ * Create an object context from a base context
+ */
+export declare function toObjectContext(context: VisitorContext): ObjectContext;
+/**
+ * Create an array context from a base context
+ */
+export declare function toArrayContext(context: VisitorContext): ArrayContext;
+/**
+ * Create an auto-parameterized parameter
+ */
+export declare function createAutoParam(context: VisitorContext, value: unknown, options?: {
+    fieldName?: string;
+    tableName?: string;
+    sourceTable?: number;
+}): string;
+interface SerializedColumnShapeNode {
+    type: "column";
+    sourceTable: number;
+    columnName: string;
+}
+interface SerializedObjectShapeNode {
+    type: "object";
+    properties: Array<{
+        key: string;
+        value: SerializedShapeNode;
+    }>;
+}
+interface SerializedReferenceShapeNode {
+    type: "reference";
+    sourceTable: number;
+}
+interface SerializedArrayShapeNode {
+    type: "array";
+    element: SerializedShapeNode;
+}
+type SerializedShapeNode = SerializedColumnShapeNode | SerializedObjectShapeNode | SerializedReferenceShapeNode | SerializedArrayShapeNode;
+export interface VisitorContextSnapshot {
+    queryBuilderParam?: string;
+    tableParams: string[];
+    queryParams: string[];
+    helpersParam?: string;
+    groupingParams?: string[];
+    autoParams: Array<[string, unknown]>;
+    autoParamCounter: number;
+    autoParamInfos?: Array<[string, AutoParamInfo]>;
+    joinParams?: Array<[string, number]>;
+    joinResultParam?: string;
+    currentResultShape?: SerializedShapeNode;
+    currentTable?: string;
+    inSelectProjection?: boolean;
+    hasTableParam?: boolean;
+    expectedType?: "boolean" | "value" | "object" | "array" | "any";
+}
+export declare function snapshotVisitorContext(context: VisitorContext): VisitorContextSnapshot;
+export declare function restoreVisitorContext(snapshot: VisitorContextSnapshot): VisitorContext;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/visitors/types.d.ts.map

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