@prisma-next/sql-relational-core 0.1.0-pr.44.2 → 0.1.0-pr.46.1

package/dist/{chunk-22YNNI6P.js → chunk-4FZM7S3U.js}

@@ -1,24 +1,37 @@
+import {
+  isParamPlaceholder
+} from "./chunk-UVB7347H.js";
+import {
+  createExpressionBuilder
+} from "./chunk-J6EORPAV.js";
+
 // src/operations-registry.ts
 import { hasAllCapabilities } from "@prisma-next/operations";
 import { planInvalid } from "@prisma-next/plan";
-function isParamPlaceholder(value) {
-  return typeof value === "object" && value !== null && "kind" in value && value.kind === "param-placeholder" && "name" in value && typeof value.name === "string";
-}
 function isColumnBuilder(value) {
   return typeof value === "object" && value !== null && "kind" in value && value.kind === "column";
 }
+function isExpressionBuilder(value) {
+  return typeof value === "object" && value !== null && "kind" in value && value.kind === "expression";
+}
+function extractExpression(builder) {
+  if (isExpressionBuilder(builder)) {
+    return builder.expr;
+  }
+  const colBuilder = builder;
+  return {
+    kind: "col",
+    table: colBuilder.table,
+    column: colBuilder.column
+  };
+}
 function executeOperation(signature, selfBuilder, args, columnMeta, operationRegistry, contractCapabilities) {
   if (args.length !== signature.args.length) {
     throw planInvalid(
       `Operation ${signature.method} expects ${signature.args.length} arguments, got ${args.length}`
     );
   }
-  const selfBuilderWithExpr = selfBuilder;
-  const selfExpr = selfBuilderWithExpr._operationExpr ? selfBuilderWithExpr._operationExpr : {
-    kind: "col",
-    table: selfBuilderWithExpr.table,
-    column: selfBuilderWithExpr.column
-  };
+  const selfExpr = extractExpression(selfBuilder);
   const operationArgs = [];
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -36,19 +49,10 @@ function executeOperation(signature, selfBuilder, args, columnMeta, operationReg
         name: arg.name
       });
     } else if (argSpec.kind === "typeId") {
-      if (!isColumnBuilder(arg)) {
-        throw planInvalid(`Argument ${i} must be a ColumnBuilder`);
-      }
-      const colBuilderWithExpr = arg;
-      if (colBuilderWithExpr._operationExpr) {
-        operationArgs.push(colBuilderWithExpr._operationExpr);
-      } else {
-        operationArgs.push({
-          kind: "col",
-          table: colBuilderWithExpr.table,
-          column: colBuilderWithExpr.column
-        });
+      if (!isColumnBuilder(arg) && !isExpressionBuilder(arg)) {
+        throw planInvalid(`Argument ${i} must be a ColumnBuilder or ExpressionBuilder`);
       }
+      operationArgs.push(extractExpression(arg));
     } else if (argSpec.kind === "literal") {
       operationArgs.push({
         kind: "literal",
@@ -70,51 +74,35 @@ function executeOperation(signature, selfBuilder, args, columnMeta, operationReg
     ...columnMeta,
     codecId: returnTypeId
   } : columnMeta;
-  const createComparisonMethod = (op) => (value) => Object.freeze({
-    kind: "binary",
-    op,
-    left: operationExpr,
-    right: value
-  });
-  const baseResult = {
-    kind: "column",
-    table: selfBuilderWithExpr.table,
-    column: selfBuilderWithExpr.column,
-    get columnMeta() {
-      return returnColumnMeta;
-    },
-    eq: createComparisonMethod("eq"),
-    neq: createComparisonMethod("neq"),
-    gt: createComparisonMethod("gt"),
-    lt: createComparisonMethod("lt"),
-    gte: createComparisonMethod("gte"),
-    lte: createComparisonMethod("lte"),
-    asc() {
-      return Object.freeze({
-        kind: "order",
-        expr: operationExpr,
-        dir: "asc"
-      });
-    },
-    desc() {
-      return Object.freeze({
-        kind: "order",
-        expr: operationExpr,
-        dir: "desc"
-      });
-    },
-    _operationExpr: operationExpr
-  };
+  let result = createExpressionBuilder(operationExpr, returnColumnMeta);
   if (returnTypeId && operationRegistry) {
-    const resultWithOps = attachOperationsToColumnBuilder(
-      baseResult,
-      returnColumnMeta,
-      operationRegistry,
-      contractCapabilities
-    );
-    return Object.freeze(resultWithOps);
+    const operations = operationRegistry.byType(returnTypeId);
+    if (operations.length > 0) {
+      const resultWithOps = { ...result };
+      for (const operation of operations) {
+        if (operation.capabilities && operation.capabilities.length > 0) {
+          if (!contractCapabilities) {
+            continue;
+          }
+          if (!hasAllCapabilities(operation.capabilities, contractCapabilities)) {
+            continue;
+          }
+        }
+        resultWithOps[operation.method] = function(...args2) {
+          return executeOperation(
+            operation,
+            this,
+            args2,
+            returnColumnMeta,
+            operationRegistry,
+            contractCapabilities
+          );
+        };
+      }
+      result = Object.freeze(resultWithOps);
+    }
   }
-  return Object.freeze(baseResult);
+  return result;
 }
 function attachOperationsToColumnBuilder(columnBuilder, columnMeta, registry, contractCapabilities) {
   if (!registry) {
@@ -155,4 +143,4 @@ function attachOperationsToColumnBuilder(columnBuilder, columnMeta, registry, co
 export {
   attachOperationsToColumnBuilder
 };
-//# sourceMappingURL=chunk-22YNNI6P.js.map
+//# sourceMappingURL=chunk-4FZM7S3U.js.map

package/dist/chunk-4FZM7S3U.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/operations-registry.ts"],"sourcesContent":["import type { OperationRegistry } from '@prisma-next/operations';\nimport { hasAllCapabilities } from '@prisma-next/operations';\nimport { planInvalid } from '@prisma-next/plan';\nimport type { StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { SqlOperationSignature } from '@prisma-next/sql-operations';\nimport type { ColumnRef, LiteralExpr, OperationExpr, ParamRef } from './ast/types';\nimport { createExpressionBuilder } from './expression-builder';\nimport type {\n  AnyColumnBuilder,\n  AnyExpressionBuilder,\n  ColumnBuilder,\n  OperationTypes,\n} from './types';\nimport { isParamPlaceholder } from './utils/guards';\n\nfunction isColumnBuilder(value: unknown): value is AnyColumnBuilder {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'kind' in value &&\n    (value as { kind: unknown }).kind === 'column'\n  );\n}\n\nfunction isExpressionBuilder(value: unknown): value is AnyExpressionBuilder {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'kind' in value &&\n    (value as { kind: unknown }).kind === 'expression'\n  );\n}\n\n/**\n * Extracts the expression from a ColumnBuilder or ExpressionBuilder.\n * If it's an ExpressionBuilder, returns its expr property.\n * If it's a ColumnBuilder, converts it to a ColumnRef.\n */\nfunction extractExpression(\n  builder: AnyColumnBuilder | AnyExpressionBuilder,\n): ColumnRef | OperationExpr {\n  if (isExpressionBuilder(builder)) {\n    return builder.expr;\n  }\n  // It's a ColumnBuilder - extract ColumnRef\n  const colBuilder = builder as { table: string; column: string };\n  return {\n    kind: 'col',\n    table: colBuilder.table,\n    column: colBuilder.column,\n  };\n}\n\n/**\n * Executes an operation and returns an ExpressionBuilder.\n * This is the canonical entrypoint for operation invocation, enabling\n * future enhancements like telemetry, caching, or tracing.\n *\n * @param signature - The operation signature from the registry\n * @param selfBuilder - The column builder or expression builder that the operation is called on\n * @param args - The arguments passed to the operation\n * @param columnMeta - The metadata of the column the operation is called on\n * @returns An ExpressionBuilder wrapping the operation expression\n */\nfunction executeOperation(\n  signature: SqlOperationSignature,\n  selfBuilder: AnyColumnBuilder | AnyExpressionBuilder,\n  args: unknown[],\n  columnMeta: StorageColumn,\n  operationRegistry?: OperationRegistry,\n  contractCapabilities?: Record<string, Record<string, boolean>>,\n): AnyExpressionBuilder {\n  if (args.length !== signature.args.length) {\n    throw planInvalid(\n      `Operation ${signature.method} expects ${signature.args.length} arguments, got ${args.length}`,\n    );\n  }\n\n  // Extract the expression from selfBuilder (handles both ColumnBuilder and ExpressionBuilder)\n  const selfExpr: ColumnRef | OperationExpr = extractExpression(selfBuilder);\n\n  const operationArgs: Array<ColumnRef | ParamRef | LiteralExpr | OperationExpr> = [];\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    const argSpec = signature.args[i];\n    if (!argSpec) {\n      throw planInvalid(`Missing argument spec for argument ${i}`);\n    }\n\n    if (argSpec.kind === 'param') {\n      if (!isParamPlaceholder(arg)) {\n        throw planInvalid(`Argument ${i} must be a parameter placeholder`);\n      }\n      operationArgs.push({\n        kind: 'param',\n        index: 0,\n        name: arg.name,\n      });\n    } else if (argSpec.kind === 'typeId') {\n      // Argument can be either ColumnBuilder or ExpressionBuilder\n      if (!isColumnBuilder(arg) && !isExpressionBuilder(arg)) {\n        throw planInvalid(`Argument ${i} must be a ColumnBuilder or ExpressionBuilder`);\n      }\n      // Extract expression from either type\n      operationArgs.push(extractExpression(arg));\n    } else if (argSpec.kind === 'literal') {\n      operationArgs.push({\n        kind: 'literal',\n        value: arg,\n      });\n    }\n  }\n\n  const operationExpr: OperationExpr = {\n    kind: 'operation',\n    method: signature.method,\n    forTypeId: signature.forTypeId,\n    self: selfExpr,\n    args: operationArgs,\n    returns: signature.returns,\n    lowering: signature.lowering,\n  };\n\n  const returnTypeId = signature.returns.kind === 'typeId' ? signature.returns.type : undefined;\n  const returnColumnMeta: StorageColumn = returnTypeId\n    ? {\n        ...columnMeta,\n        codecId: returnTypeId,\n      }\n    : columnMeta;\n\n  let result = createExpressionBuilder(operationExpr, returnColumnMeta);\n\n  // If the return type is a typeId, attach operations for that type to the ExpressionBuilder.\n  // This allows chaining operations (e.g., col.normalize().cosineDistance(otherVec)).\n  if (returnTypeId && operationRegistry) {\n    const operations = operationRegistry.byType(returnTypeId) as SqlOperationSignature[];\n    if (operations.length > 0) {\n      // Create an unfrozen copy to attach operations (result is frozen from createExpressionBuilder)\n      const resultWithOps = { ...result } as AnyExpressionBuilder & Record<string, unknown>;\n      for (const operation of operations) {\n        if (operation.capabilities && operation.capabilities.length > 0) {\n          if (!contractCapabilities) {\n            continue;\n          }\n          if (!hasAllCapabilities(operation.capabilities, contractCapabilities)) {\n            continue;\n          }\n        }\n        // Attach operation as a method on the expression builder\n        (resultWithOps as Record<string, unknown>)[operation.method] = function (\n          this: AnyExpressionBuilder,\n          ...args: unknown[]\n        ) {\n          return executeOperation(\n            operation,\n            this,\n            args,\n            returnColumnMeta,\n            operationRegistry,\n            contractCapabilities,\n          );\n        };\n      }\n      result = Object.freeze(resultWithOps) as AnyExpressionBuilder;\n    }\n  }\n\n  return result;\n}\n\nexport function attachOperationsToColumnBuilder<\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  JsType = unknown,\n  Operations extends OperationTypes = Record<string, never>,\n>(\n  columnBuilder: ColumnBuilder<ColumnName, ColumnMeta, JsType, Record<string, never>>,\n  columnMeta: ColumnMeta,\n  registry: OperationRegistry | undefined,\n  contractCapabilities?: Record<string, Record<string, boolean>>,\n): ColumnBuilder<ColumnName, ColumnMeta, JsType, Operations> {\n  if (!registry) {\n    return columnBuilder as ColumnBuilder<ColumnName, ColumnMeta, JsType, Operations>;\n  }\n\n  // Use codecId to look up operations registered for this column's type\n  const codecId = columnMeta.codecId;\n  if (!codecId) {\n    return columnBuilder as ColumnBuilder<ColumnName, ColumnMeta, JsType, Operations>;\n  }\n\n  const operations = registry.byType(codecId) as SqlOperationSignature[];\n  if (operations.length === 0) {\n    return columnBuilder as ColumnBuilder<ColumnName, ColumnMeta, JsType, Operations>;\n  }\n\n  const builderWithOps = columnBuilder as unknown as ColumnBuilder<\n    ColumnName,\n    ColumnMeta,\n    JsType,\n    Operations\n  >;\n\n  for (const operation of operations) {\n    if (operation.capabilities && operation.capabilities.length > 0) {\n      if (!contractCapabilities) {\n        continue;\n      }\n\n      if (!hasAllCapabilities(operation.capabilities, contractCapabilities)) {\n        continue;\n      }\n    }\n    // Method sugar: attach operation as a method on the column builder\n    (builderWithOps as Record<string, unknown>)[operation.method] = function (\n      this: ColumnBuilder<ColumnName, ColumnMeta, JsType, Record<string, never>>,\n      ...args: unknown[]\n    ) {\n      return executeOperation(\n        operation,\n        this as unknown as ColumnBuilder<string, StorageColumn, unknown>,\n        args,\n        columnMeta,\n        registry,\n        contractCapabilities,\n      );\n    };\n  }\n\n  return builderWithOps;\n}\n"],"mappings":";;;;;;;;AACA,SAAS,0BAA0B;AACnC,SAAS,mBAAmB;AAa5B,SAAS,gBAAgB,OAA2C;AAClE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS;AAE1C;AAEA,SAAS,oBAAoB,OAA+C;AAC1E,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS;AAE1C;AAOA,SAAS,kBACP,SAC2B;AAC3B,MAAI,oBAAoB,OAAO,GAAG;AAChC,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,aAAa;AACnB,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,WAAW;AAAA,IAClB,QAAQ,WAAW;AAAA,EACrB;AACF;AAaA,SAAS,iBACP,WACA,aACA,MACA,YACA,mBACA,sBACsB;AACtB,MAAI,KAAK,WAAW,UAAU,KAAK,QAAQ;AACzC,UAAM;AAAA,MACJ,aAAa,UAAU,MAAM,YAAY,UAAU,KAAK,MAAM,mBAAmB,KAAK,MAAM;AAAA,IAC9F;AAAA,EACF;AAGA,QAAM,WAAsC,kBAAkB,WAAW;AAEzE,QAAM,gBAA2E,CAAC;AAClF,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,UAAU,UAAU,KAAK,CAAC;AAChC,QAAI,CAAC,SAAS;AACZ,YAAM,YAAY,sCAAsC,CAAC,EAAE;AAAA,IAC7D;AAEA,QAAI,QAAQ,SAAS,SAAS;AAC5B,UAAI,CAAC,mBAAmB,GAAG,GAAG;AAC5B,cAAM,YAAY,YAAY,CAAC,kCAAkC;AAAA,MACnE;AACA,oBAAc,KAAK;AAAA,QACjB,MAAM;AAAA,QACN,OAAO;AAAA,QACP,MAAM,IAAI;AAAA,MACZ,CAAC;AAAA,IACH,WAAW,QAAQ,SAAS,UAAU;AAEpC,UAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,oBAAoB,GAAG,GAAG;AACtD,cAAM,YAAY,YAAY,CAAC,+CAA+C;AAAA,MAChF;AAEA,oBAAc,KAAK,kBAAkB,GAAG,CAAC;AAAA,IAC3C,WAAW,QAAQ,SAAS,WAAW;AACrC,oBAAc,KAAK;AAAA,QACjB,MAAM;AAAA,QACN,OAAO;AAAA,MACT,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,gBAA+B;AAAA,IACnC,MAAM;AAAA,IACN,QAAQ,UAAU;AAAA,IAClB,WAAW,UAAU;AAAA,IACrB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,SAAS,UAAU;AAAA,IACnB,UAAU,UAAU;AAAA,EACtB;AAEA,QAAM,eAAe,UAAU,QAAQ,SAAS,WAAW,UAAU,QAAQ,OAAO;AACpF,QAAM,mBAAkC,eACpC;AAAA,IACE,GAAG;AAAA,IACH,SAAS;AAAA,EACX,IACA;AAEJ,MAAI,SAAS,wBAAwB,eAAe,gBAAgB;AAIpE,MAAI,gBAAgB,mBAAmB;AACrC,UAAM,aAAa,kBAAkB,OAAO,YAAY;AACxD,QAAI,WAAW,SAAS,GAAG;AAEzB,YAAM,gBAAgB,EAAE,GAAG,OAAO;AAClC,iBAAW,aAAa,YAAY;AAClC,YAAI,UAAU,gBAAgB,UAAU,aAAa,SAAS,GAAG;AAC/D,cAAI,CAAC,sBAAsB;AACzB;AAAA,UACF;AACA,cAAI,CAAC,mBAAmB,UAAU,cAAc,oBAAoB,GAAG;AACrE;AAAA,UACF;AAAA,QACF;AAEA,QAAC,cAA0C,UAAU,MAAM,IAAI,YAE1DA,OACH;AACA,iBAAO;AAAA,YACL;AAAA,YACA;AAAA,YACAA;AAAA,YACA;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,eAAS,OAAO,OAAO,aAAa;AAAA,IACtC;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,gCAMd,eACA,YACA,UACA,sBAC2D;AAC3D,MAAI,CAAC,UAAU;AACb,WAAO;AAAA,EACT;AAGA,QAAM,UAAU,WAAW;AAC3B,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,SAAS,OAAO,OAAO;AAC1C,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,iBAAiB;AAOvB,aAAW,aAAa,YAAY;AAClC,QAAI,UAAU,gBAAgB,UAAU,aAAa,SAAS,GAAG;AAC/D,UAAI,CAAC,sBAAsB;AACzB;AAAA,MACF;AAEA,UAAI,CAAC,mBAAmB,UAAU,cAAc,oBAAoB,GAAG;AACrE;AAAA,MACF;AAAA,IACF;AAEA,IAAC,eAA2C,UAAU,MAAM,IAAI,YAE3D,MACH;AACA,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":["args"]}

package/dist/{chunk-6JM7ZPMQ.js → chunk-FVVCKAV6.js}

@@ -1,6 +1,6 @@
 import {
   isColumnBuilder
-} from "./chunk-R77KHJFH.js";
+} from "./chunk-QRJVCABZ.js";
 
 // src/ast/codec-types.ts
 var CodecRegistryImpl = class {
@@ -264,6 +264,13 @@ function createExistsExpr(not, subquery) {
     subquery
   };
 }
+function createNullCheckExpr(op, expr) {
+  return {
+    kind: "nullCheck",
+    op,
+    expr
+  };
+}
 
 // src/ast/select.ts
 function createSelectAst(options) {
@@ -313,8 +320,9 @@ export {
   createOrderByItem,
   createBinaryExpr,
   createExistsExpr,
+  createNullCheckExpr,
   createSelectAst,
   isOperationExpr,
   createUpdateAst
 };
-//# sourceMappingURL=chunk-6JM7ZPMQ.js.map
+//# sourceMappingURL=chunk-FVVCKAV6.js.map

package/dist/{chunk-6JM7ZPMQ.js.map → chunk-FVVCKAV6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/ast/codec-types.ts","../src/ast/util.ts","../src/ast/common.ts","../src/ast/delete.ts","../src/ast/insert.ts","../src/ast/join.ts","../src/ast/order.ts","../src/ast/predicate.ts","../src/ast/select.ts","../src/ast/types.ts","../src/ast/update.ts"],"sourcesContent":["import type { O } from 'ts-toolbelt';\n\n/**\n * Codec metadata for database-specific type information.\n * Used for schema introspection and verification.\n */\nexport interface CodecMeta {\n  readonly db?: {\n    readonly sql?: {\n      readonly postgres?: {\n        readonly nativeType: string; // e.g. 'integer', 'text', 'vector', 'timestamp with time zone'\n      };\n    };\n  };\n}\n\n/**\n * Codec interface for encoding/decoding values between wire format and JavaScript types.\n *\n * Codecs are pure, synchronous functions with no side effects or IO.\n * They provide deterministic conversion between database wire types and JS values.\n */\nexport interface Codec<Id extends string = string, TWire = unknown, TJs = unknown> {\n  /**\n   * Namespaced codec identifier in format 'namespace/name@version'\n   * Examples: 'pg/text@1', 'pg/uuid@1', 'pg/timestamptz@1'\n   */\n  readonly id: Id;\n\n  /**\n   * Contract scalar type IDs that this codec can handle.\n   * Examples: ['text'], ['int4', 'float8'], ['timestamp', 'timestamptz']\n   */\n  readonly targetTypes: readonly string[];\n\n  /**\n   * Optional metadata for database-specific type information.\n   * Used for schema introspection and verification.\n   */\n  readonly meta?: CodecMeta;\n\n  /**\n   * Decode a wire value (from database) to JavaScript type.\n   * Must be synchronous and pure (no side effects).\n   */\n  decode(wire: TWire): TJs;\n\n  /**\n   * Encode a JavaScript value to wire format (for database).\n   * Optional - if not provided, values pass through unchanged.\n   * Must be synchronous and pure (no side effects).\n   */\n  encode?(value: TJs): TWire;\n}\n\n/**\n * Registry interface for codecs organized by ID and by contract scalar type.\n *\n * The registry allows looking up codecs by their namespaced ID or by the\n * contract scalar types they handle. Multiple codecs may handle the same\n * scalar type; ordering in byScalar reflects preference (adapter first,\n * then packs, then app overrides).\n */\nexport interface CodecRegistry {\n  get(id: string): Codec<string> | undefined;\n  has(id: string): boolean;\n  getByScalar(scalar: string): readonly Codec<string>[];\n  getDefaultCodec(scalar: string): Codec<string> | undefined;\n  register(codec: Codec<string>): void;\n  [Symbol.iterator](): Iterator<Codec<string>>;\n  values(): IterableIterator<Codec<string>>;\n}\n\n/**\n * Implementation of CodecRegistry.\n */\nclass CodecRegistryImpl implements CodecRegistry {\n  private readonly _byId = new Map<string, Codec<string>>();\n  private readonly _byScalar = new Map<string, Codec<string>[]>();\n\n  /**\n   * Map-like interface for codec lookup by ID.\n   * Example: registry.get('pg/text@1')\n   */\n  get(id: string): Codec<string> | undefined {\n    return this._byId.get(id);\n  }\n\n  /**\n   * Check if a codec with the given ID is registered.\n   */\n  has(id: string): boolean {\n    return this._byId.has(id);\n  }\n\n  /**\n   * Get all codecs that handle a given scalar type.\n   * Returns an empty frozen array if no codecs are found.\n   * Example: registry.getByScalar('text') → [codec1, codec2, ...]\n   */\n  getByScalar(scalar: string): readonly Codec<string>[] {\n    return this._byScalar.get(scalar) ?? Object.freeze([]);\n  }\n\n  /**\n   * Get the default codec for a scalar type (first registered codec).\n   * Returns undefined if no codec handles this scalar type.\n   */\n  getDefaultCodec(scalar: string): Codec<string> | undefined {\n    const _codecs = this._byScalar.get(scalar);\n    return _codecs?.[0];\n  }\n\n  /**\n   * Register a codec in the registry.\n   * Throws an error if a codec with the same ID is already registered.\n   *\n   * @param codec - The codec to register\n   * @throws Error if a codec with the same ID already exists\n   */\n  register(codec: Codec<string>): void {\n    if (this._byId.has(codec.id)) {\n      throw new Error(`Codec with ID '${codec.id}' is already registered`);\n    }\n\n    this._byId.set(codec.id, codec);\n\n    // Update byScalar mapping\n    for (const scalarType of codec.targetTypes) {\n      const existing = this._byScalar.get(scalarType);\n      if (existing) {\n        existing.push(codec);\n      } else {\n        this._byScalar.set(scalarType, [codec]);\n      }\n    }\n  }\n\n  /**\n   * Returns an iterator over all registered codecs.\n   * Useful for iterating through codecs from another registry.\n   */\n  *[Symbol.iterator](): Iterator<Codec<string>> {\n    for (const codec of this._byId.values()) {\n      yield codec;\n    }\n  }\n\n  /**\n   * Returns an iterable of all registered codecs.\n   */\n  values(): IterableIterator<Codec<string>> {\n    return this._byId.values();\n  }\n}\n\n/**\n * Codec factory - creates a codec with typeId and encode/decode functions.\n */\nexport function codec<Id extends string, TWire, TJs>(config: {\n  typeId: Id;\n  targetTypes: readonly string[];\n  encode: (value: TJs) => TWire;\n  decode: (wire: TWire) => TJs;\n  meta?: CodecMeta;\n}): Codec<Id, TWire, TJs> {\n  return {\n    id: config.typeId,\n    targetTypes: config.targetTypes,\n    ...(config.meta ? { meta: config.meta } : {}),\n    encode: config.encode,\n    decode: config.decode,\n  };\n}\n\n/**\n * Type helpers to extract codec types.\n */\nexport type CodecId<T> = T extends Codec<infer Id, unknown, unknown>\n  ? Id\n  : T extends { readonly id: infer Id }\n    ? Id\n    : never;\nexport type CodecInput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;\nexport type CodecOutput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;\n\n/**\n * Type helper to extract codec types from builder instance.\n */\nexport type ExtractCodecTypes<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> = {\n  readonly [K in keyof ScalarNames as ScalarNames[K] extends Codec<infer Id, unknown, unknown>\n    ? Id\n    : never]: {\n    readonly input: CodecInput<ScalarNames[K]>;\n    readonly output: CodecOutput<ScalarNames[K]>;\n  };\n};\n\n/**\n * Type helper to extract data type IDs from builder instance.\n * Uses ExtractCodecTypes which preserves literal types as keys.\n * Since ExtractCodecTypes<Record<K, ScalarNames[K]>> has exactly one key (the Id),\n * we extract it by creating a mapped type that uses the Id as both key and value,\n * then extract the value type. This preserves literal types.\n */\nexport type ExtractDataTypes<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> },\n> = {\n  readonly [K in keyof ScalarNames]: {\n    readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n  }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n};\n\n/**\n * Builder interface for declaring codecs.\n */\nexport interface CodecDefBuilder<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> {\n  readonly CodecTypes: ExtractCodecTypes<ScalarNames>;\n\n  add<ScalarName extends string, CodecImpl extends Codec<string>>(\n    scalarName: ScalarName,\n    codecImpl: CodecImpl,\n  ): CodecDefBuilder<\n    O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>\n  >;\n\n  readonly codecDefinitions: {\n    readonly [K in keyof ScalarNames]: {\n      readonly typeId: ScalarNames[K] extends Codec<infer Id extends string, unknown, unknown>\n        ? Id\n        : never;\n      readonly scalar: K;\n      readonly codec: ScalarNames[K];\n      readonly input: CodecInput<ScalarNames[K]>;\n      readonly output: CodecOutput<ScalarNames[K]>;\n      readonly jsType: CodecOutput<ScalarNames[K]>;\n    };\n  };\n\n  readonly dataTypes: {\n    readonly [K in keyof ScalarNames]: {\n      readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n    }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n  };\n}\n\n/**\n * Implementation of CodecDefBuilder.\n */\nclass CodecDefBuilderImpl<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> implements CodecDefBuilder<ScalarNames>\n{\n  private readonly _codecs: ScalarNames;\n\n  public readonly CodecTypes: ExtractCodecTypes<ScalarNames>;\n  public readonly dataTypes: {\n    readonly [K in keyof ScalarNames]: {\n      readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n    }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n  };\n\n  constructor(codecs: ScalarNames) {\n    this._codecs = codecs;\n\n    // Populate CodecTypes from codecs\n    const codecTypes: Record<string, { readonly input: unknown; readonly output: unknown }> = {};\n    for (const [, codecImpl] of Object.entries(this._codecs)) {\n      const codecImplTyped = codecImpl as Codec<string>;\n      codecTypes[codecImplTyped.id] = {\n        input: undefined as unknown as CodecInput<typeof codecImplTyped>,\n        output: undefined as unknown as CodecOutput<typeof codecImplTyped>,\n      };\n    }\n    this.CodecTypes = codecTypes as ExtractCodecTypes<ScalarNames>;\n\n    // Populate dataTypes from codecs - extract id property from each codec\n    // Build object preserving keys from ScalarNames\n    // Type assertion is safe because we know ScalarNames structure matches the return type\n    // biome-ignore lint/suspicious/noExplicitAny: dynamic codec mapping requires any\n    const dataTypes = {} as any;\n    for (const key in this._codecs) {\n      if (Object.hasOwn(this._codecs, key)) {\n        const codec = this._codecs[key] as Codec<string>;\n        dataTypes[key] = codec.id;\n      }\n    }\n    this.dataTypes = dataTypes as {\n      readonly [K in keyof ScalarNames]: {\n        readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n      }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n    };\n  }\n\n  add<ScalarName extends string, CodecImpl extends Codec<string>>(\n    scalarName: ScalarName,\n    codecImpl: CodecImpl,\n  ): CodecDefBuilder<\n    O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>\n  > {\n    return new CodecDefBuilderImpl({\n      ...this._codecs,\n      [scalarName]: codecImpl,\n    } as O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>);\n  }\n\n  /**\n   * Derive codecDefinitions structure.\n   */\n  get codecDefinitions(): {\n    readonly [K in keyof ScalarNames]: {\n      readonly typeId: ScalarNames[K] extends Codec<infer Id, unknown, unknown> ? Id : never;\n      readonly scalar: K;\n      readonly codec: ScalarNames[K];\n      readonly input: CodecInput<ScalarNames[K]>;\n      readonly output: CodecOutput<ScalarNames[K]>;\n      readonly jsType: CodecOutput<ScalarNames[K]>;\n    };\n  } {\n    const result: Record<\n      string,\n      {\n        typeId: string;\n        scalar: string;\n        codec: Codec;\n        input: unknown;\n        output: unknown;\n        jsType: unknown;\n      }\n    > = {};\n\n    for (const [scalarName, codecImpl] of Object.entries(this._codecs)) {\n      const codec = codecImpl as Codec<string>;\n      result[scalarName] = {\n        typeId: codec.id,\n        scalar: scalarName,\n        codec: codec,\n        input: undefined as unknown as CodecInput<typeof codec>,\n        output: undefined as unknown as CodecOutput<typeof codec>,\n        jsType: undefined as unknown as CodecOutput<typeof codec>,\n      };\n    }\n\n    return result as {\n      readonly [K in keyof ScalarNames]: {\n        readonly typeId: ScalarNames[K] extends Codec<infer Id extends string, unknown, unknown>\n          ? Id\n          : never;\n        readonly scalar: K;\n        readonly codec: ScalarNames[K];\n        readonly input: CodecInput<ScalarNames[K]>;\n        readonly output: CodecOutput<ScalarNames[K]>;\n        readonly jsType: CodecOutput<ScalarNames[K]>;\n      };\n    };\n  }\n}\n\n/**\n * Create a new codec registry.\n */\nexport function createCodecRegistry(): CodecRegistry {\n  return new CodecRegistryImpl();\n}\n\n/**\n * Create a new codec definition builder.\n */\nexport function defineCodecs(): CodecDefBuilder<Record<never, never>> {\n  return new CodecDefBuilderImpl({});\n}\n","export function compact<T extends Record<string, unknown>>(o: T): T {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(o)) {\n    if (v === undefined || v === null) continue;\n    if (Array.isArray(v) && v.length === 0) continue;\n    out[k] = v;\n  }\n  return out as T;\n}\n","import type { ColumnRef, LiteralExpr, OperationExpr, ParamRef, TableRef } from './types';\nimport { compact } from './util';\n\nexport function createTableRef(name: string): TableRef {\n  return {\n    kind: 'table',\n    name,\n  };\n}\n\nexport function createColumnRef(table: string, column: string): ColumnRef {\n  return {\n    kind: 'col',\n    table,\n    column,\n  };\n}\n\nexport function createParamRef(index: number, name?: string): ParamRef {\n  return compact({\n    kind: 'param',\n    index,\n    name,\n  }) as ParamRef;\n}\n\nexport function createOperationExpr(operation: OperationExpr): OperationExpr {\n  return operation;\n}\n\nexport function createLiteralExpr(value: unknown): LiteralExpr {\n  return {\n    kind: 'literal',\n    value,\n  };\n}\n","import type { BinaryExpr, ColumnRef, DeleteAst, TableRef } from './types';\nimport { compact } from './util';\n\nexport interface CreateDeleteAstOptions {\n  readonly table: TableRef;\n  readonly where: BinaryExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createDeleteAst(options: CreateDeleteAstOptions): DeleteAst {\n  return compact({\n    kind: 'delete',\n    table: options.table,\n    where: options.where,\n    returning: options.returning,\n  }) as DeleteAst;\n}\n","import type { ColumnRef, InsertAst, ParamRef, TableRef } from './types';\nimport { compact } from './util';\n\nexport interface CreateInsertAstOptions {\n  readonly table: TableRef;\n  readonly values: Record<string, ColumnRef | ParamRef>;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createInsertAst(options: CreateInsertAstOptions): InsertAst {\n  return compact({\n    kind: 'insert',\n    table: options.table,\n    values: options.values,\n    returning: options.returning,\n  }) as InsertAst;\n}\n","import { planInvalid } from '@prisma-next/plan';\nimport type { AnyColumnBuilder, JoinOnBuilder, JoinOnPredicate } from '../types';\nimport { isColumnBuilder } from '../types';\nimport type { ColumnRef, JoinAst, JoinOnExpr, TableRef } from './types';\n\nexport function createJoin(\n  joinType: 'inner' | 'left' | 'right' | 'full',\n  table: TableRef,\n  on: JoinOnExpr,\n): JoinAst {\n  return {\n    kind: 'join',\n    joinType,\n    table,\n    on,\n  };\n}\n\nexport function createJoinOnExpr(left: ColumnRef, right: ColumnRef): JoinOnExpr {\n  return {\n    kind: 'eqCol',\n    left,\n    right,\n  };\n}\n\nclass JoinOnBuilderImpl implements JoinOnBuilder {\n  eqCol(left: AnyColumnBuilder, right: AnyColumnBuilder): JoinOnPredicate {\n    if (!left || !isColumnBuilder(left)) {\n      throw planInvalid('Join ON left operand must be a column');\n    }\n\n    if (!right || !isColumnBuilder(right)) {\n      throw planInvalid('Join ON right operand must be a column');\n    }\n\n    // TypeScript can't narrow ColumnBuilder properly, so we assert\n    const leftCol = left as unknown as { table: string; column: string };\n    const rightCol = right as unknown as { table: string; column: string };\n    if (leftCol.table === rightCol.table) {\n      throw planInvalid('Self-joins are not supported in MVP');\n    }\n\n    return {\n      kind: 'join-on',\n      left: left as AnyColumnBuilder,\n      right: right as AnyColumnBuilder,\n    };\n  }\n}\n\nexport function createJoinOnBuilder(): JoinOnBuilder {\n  return new JoinOnBuilderImpl();\n}\n","import type { ColumnRef, Direction, OperationExpr } from './types';\n\nexport function createOrderByItem(\n  expr: ColumnRef | OperationExpr,\n  dir: 'asc' | 'desc',\n): { expr: ColumnRef | OperationExpr; dir: Direction } {\n  return {\n    expr,\n    dir,\n  };\n}\n","import type {\n  BinaryExpr,\n  BinaryOp,\n  ColumnRef,\n  ExistsExpr,\n  OperationExpr,\n  ParamRef,\n  SelectAst,\n} from './types';\n\nexport function createBinaryExpr(\n  op: BinaryOp,\n  left: ColumnRef | OperationExpr,\n  right: ParamRef,\n): BinaryExpr {\n  return {\n    kind: 'bin',\n    op,\n    left,\n    right,\n  };\n}\n\nexport function createExistsExpr(not: boolean, subquery: SelectAst): ExistsExpr {\n  return {\n    kind: 'exists',\n    not,\n    subquery,\n  };\n}\n","import type {\n  BinaryExpr,\n  ColumnRef,\n  Direction,\n  ExistsExpr,\n  IncludeAst,\n  IncludeRef,\n  JoinAst,\n  OperationExpr,\n  SelectAst,\n  TableRef,\n} from './types';\nimport { compact } from './util';\n\nexport interface CreateSelectAstOptions {\n  readonly from: TableRef;\n  readonly joins?: ReadonlyArray<JoinAst>;\n  readonly includes?: ReadonlyArray<IncludeAst>;\n  readonly project: ReadonlyArray<{\n    alias: string;\n    expr: ColumnRef | IncludeRef | OperationExpr;\n  }>;\n  readonly where?: BinaryExpr | ExistsExpr;\n  readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n  readonly limit?: number;\n}\n\nexport function createSelectAst(options: CreateSelectAstOptions): SelectAst {\n  return compact({\n    kind: 'select',\n    from: options.from,\n    joins: options.joins,\n    includes: options.includes,\n    project: options.project,\n    where: options.where,\n    orderBy: options.orderBy,\n    limit: options.limit,\n  }) as SelectAst;\n}\n","import type { ReturnSpec } from '@prisma-next/operations';\nimport type { SqlLoweringSpec } from '@prisma-next/sql-operations';\n\n// SQL-specific AST types and supporting types\n// These types are needed by adapters and runtime for SQL query execution\n\nexport type Direction = 'asc' | 'desc';\n\nexport interface TableRef {\n  readonly kind: 'table';\n  readonly name: string;\n}\n\nexport interface ColumnRef {\n  readonly kind: 'col';\n  readonly table: string;\n  readonly column: string;\n}\n\nexport interface ParamRef {\n  readonly kind: 'param';\n  readonly index: number;\n  readonly name?: string;\n}\n\nexport interface LiteralExpr {\n  readonly kind: 'literal';\n  readonly value: unknown;\n}\n\nexport interface OperationExpr {\n  readonly kind: 'operation';\n  readonly method: string;\n  readonly forTypeId: string;\n  readonly self: ColumnRef | OperationExpr;\n  readonly args: ReadonlyArray<ColumnRef | ParamRef | LiteralExpr | OperationExpr>;\n  readonly returns: ReturnSpec;\n  readonly lowering: SqlLoweringSpec;\n}\n\nexport function isOperationExpr(expr: ColumnRef | OperationExpr): expr is OperationExpr {\n  return expr.kind === 'operation';\n}\n\nexport type BinaryOp = 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte';\n\nexport interface BinaryExpr {\n  readonly kind: 'bin';\n  readonly op: BinaryOp;\n  readonly left: ColumnRef | OperationExpr;\n  readonly right: ParamRef;\n}\n\nexport interface ExistsExpr {\n  readonly kind: 'exists';\n  readonly not: boolean;\n  readonly subquery: SelectAst;\n}\n\nexport type JoinOnExpr = {\n  readonly kind: 'eqCol';\n  readonly left: ColumnRef;\n  readonly right: ColumnRef;\n};\n\nexport interface JoinAst {\n  readonly kind: 'join';\n  readonly joinType: 'inner' | 'left' | 'right' | 'full';\n  readonly table: TableRef;\n  readonly on: JoinOnExpr;\n}\n\nexport interface IncludeRef {\n  readonly kind: 'includeRef';\n  readonly alias: string;\n}\n\nexport interface IncludeAst {\n  readonly kind: 'includeMany';\n  readonly alias: string;\n  readonly child: {\n    readonly table: TableRef;\n    readonly on: JoinOnExpr;\n    readonly where?: BinaryExpr | ExistsExpr;\n    readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n    readonly limit?: number;\n    readonly project: ReadonlyArray<{ alias: string; expr: ColumnRef | OperationExpr }>;\n  };\n}\n\nexport interface SelectAst {\n  readonly kind: 'select';\n  readonly from: TableRef;\n  readonly joins?: ReadonlyArray<JoinAst>;\n  readonly includes?: ReadonlyArray<IncludeAst>;\n  readonly project: ReadonlyArray<{\n    alias: string;\n    expr: ColumnRef | IncludeRef | OperationExpr | LiteralExpr;\n  }>;\n  readonly where?: BinaryExpr | ExistsExpr;\n  readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n  readonly limit?: number;\n}\n\nexport interface InsertAst {\n  readonly kind: 'insert';\n  readonly table: TableRef;\n  readonly values: Record<string, ColumnRef | ParamRef>;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport interface UpdateAst {\n  readonly kind: 'update';\n  readonly table: TableRef;\n  readonly set: Record<string, ColumnRef | ParamRef>;\n  readonly where: BinaryExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport interface DeleteAst {\n  readonly kind: 'delete';\n  readonly table: TableRef;\n  readonly where: BinaryExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport type QueryAst = SelectAst | InsertAst | UpdateAst | DeleteAst;\n\nexport interface LoweredStatement {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n  readonly annotations?: Record<string, unknown>;\n}\n","import type { BinaryExpr, ColumnRef, ParamRef, TableRef, UpdateAst } from './types';\nimport { compact } from './util';\n\nexport interface CreateUpdateAstOptions {\n  readonly table: TableRef;\n  readonly set: Record<string, ColumnRef | ParamRef>;\n  readonly where: BinaryExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createUpdateAst(options: CreateUpdateAstOptions): UpdateAst {\n  return compact({\n    kind: 'update',\n    table: options.table,\n    set: options.set,\n    where: options.where,\n    returning: options.returning,\n  }) as UpdateAst;\n}\n"],"mappings":"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","names":["codec"]}
+{"version":3,"sources":["../src/ast/codec-types.ts","../src/ast/util.ts","../src/ast/common.ts","../src/ast/delete.ts","../src/ast/insert.ts","../src/ast/join.ts","../src/ast/order.ts","../src/ast/predicate.ts","../src/ast/select.ts","../src/ast/types.ts","../src/ast/update.ts"],"sourcesContent":["import type { O } from 'ts-toolbelt';\n\n/**\n * Codec metadata for database-specific type information.\n * Used for schema introspection and verification.\n */\nexport interface CodecMeta {\n  readonly db?: {\n    readonly sql?: {\n      readonly postgres?: {\n        readonly nativeType: string; // e.g. 'integer', 'text', 'vector', 'timestamp with time zone'\n      };\n    };\n  };\n}\n\n/**\n * Codec interface for encoding/decoding values between wire format and JavaScript types.\n *\n * Codecs are pure, synchronous functions with no side effects or IO.\n * They provide deterministic conversion between database wire types and JS values.\n */\nexport interface Codec<Id extends string = string, TWire = unknown, TJs = unknown> {\n  /**\n   * Namespaced codec identifier in format 'namespace/name@version'\n   * Examples: 'pg/text@1', 'pg/uuid@1', 'pg/timestamptz@1'\n   */\n  readonly id: Id;\n\n  /**\n   * Contract scalar type IDs that this codec can handle.\n   * Examples: ['text'], ['int4', 'float8'], ['timestamp', 'timestamptz']\n   */\n  readonly targetTypes: readonly string[];\n\n  /**\n   * Optional metadata for database-specific type information.\n   * Used for schema introspection and verification.\n   */\n  readonly meta?: CodecMeta;\n\n  /**\n   * Decode a wire value (from database) to JavaScript type.\n   * Must be synchronous and pure (no side effects).\n   */\n  decode(wire: TWire): TJs;\n\n  /**\n   * Encode a JavaScript value to wire format (for database).\n   * Optional - if not provided, values pass through unchanged.\n   * Must be synchronous and pure (no side effects).\n   */\n  encode?(value: TJs): TWire;\n}\n\n/**\n * Registry interface for codecs organized by ID and by contract scalar type.\n *\n * The registry allows looking up codecs by their namespaced ID or by the\n * contract scalar types they handle. Multiple codecs may handle the same\n * scalar type; ordering in byScalar reflects preference (adapter first,\n * then packs, then app overrides).\n */\nexport interface CodecRegistry {\n  get(id: string): Codec<string> | undefined;\n  has(id: string): boolean;\n  getByScalar(scalar: string): readonly Codec<string>[];\n  getDefaultCodec(scalar: string): Codec<string> | undefined;\n  register(codec: Codec<string>): void;\n  [Symbol.iterator](): Iterator<Codec<string>>;\n  values(): IterableIterator<Codec<string>>;\n}\n\n/**\n * Implementation of CodecRegistry.\n */\nclass CodecRegistryImpl implements CodecRegistry {\n  private readonly _byId = new Map<string, Codec<string>>();\n  private readonly _byScalar = new Map<string, Codec<string>[]>();\n\n  /**\n   * Map-like interface for codec lookup by ID.\n   * Example: registry.get('pg/text@1')\n   */\n  get(id: string): Codec<string> | undefined {\n    return this._byId.get(id);\n  }\n\n  /**\n   * Check if a codec with the given ID is registered.\n   */\n  has(id: string): boolean {\n    return this._byId.has(id);\n  }\n\n  /**\n   * Get all codecs that handle a given scalar type.\n   * Returns an empty frozen array if no codecs are found.\n   * Example: registry.getByScalar('text') → [codec1, codec2, ...]\n   */\n  getByScalar(scalar: string): readonly Codec<string>[] {\n    return this._byScalar.get(scalar) ?? Object.freeze([]);\n  }\n\n  /**\n   * Get the default codec for a scalar type (first registered codec).\n   * Returns undefined if no codec handles this scalar type.\n   */\n  getDefaultCodec(scalar: string): Codec<string> | undefined {\n    const _codecs = this._byScalar.get(scalar);\n    return _codecs?.[0];\n  }\n\n  /**\n   * Register a codec in the registry.\n   * Throws an error if a codec with the same ID is already registered.\n   *\n   * @param codec - The codec to register\n   * @throws Error if a codec with the same ID already exists\n   */\n  register(codec: Codec<string>): void {\n    if (this._byId.has(codec.id)) {\n      throw new Error(`Codec with ID '${codec.id}' is already registered`);\n    }\n\n    this._byId.set(codec.id, codec);\n\n    // Update byScalar mapping\n    for (const scalarType of codec.targetTypes) {\n      const existing = this._byScalar.get(scalarType);\n      if (existing) {\n        existing.push(codec);\n      } else {\n        this._byScalar.set(scalarType, [codec]);\n      }\n    }\n  }\n\n  /**\n   * Returns an iterator over all registered codecs.\n   * Useful for iterating through codecs from another registry.\n   */\n  *[Symbol.iterator](): Iterator<Codec<string>> {\n    for (const codec of this._byId.values()) {\n      yield codec;\n    }\n  }\n\n  /**\n   * Returns an iterable of all registered codecs.\n   */\n  values(): IterableIterator<Codec<string>> {\n    return this._byId.values();\n  }\n}\n\n/**\n * Codec factory - creates a codec with typeId and encode/decode functions.\n */\nexport function codec<Id extends string, TWire, TJs>(config: {\n  typeId: Id;\n  targetTypes: readonly string[];\n  encode: (value: TJs) => TWire;\n  decode: (wire: TWire) => TJs;\n  meta?: CodecMeta;\n}): Codec<Id, TWire, TJs> {\n  return {\n    id: config.typeId,\n    targetTypes: config.targetTypes,\n    ...(config.meta ? { meta: config.meta } : {}),\n    encode: config.encode,\n    decode: config.decode,\n  };\n}\n\n/**\n * Type helpers to extract codec types.\n */\nexport type CodecId<T> = T extends Codec<infer Id, unknown, unknown>\n  ? Id\n  : T extends { readonly id: infer Id }\n    ? Id\n    : never;\nexport type CodecInput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;\nexport type CodecOutput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;\n\n/**\n * Type helper to extract codec types from builder instance.\n */\nexport type ExtractCodecTypes<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> = {\n  readonly [K in keyof ScalarNames as ScalarNames[K] extends Codec<infer Id, unknown, unknown>\n    ? Id\n    : never]: {\n    readonly input: CodecInput<ScalarNames[K]>;\n    readonly output: CodecOutput<ScalarNames[K]>;\n  };\n};\n\n/**\n * Type helper to extract data type IDs from builder instance.\n * Uses ExtractCodecTypes which preserves literal types as keys.\n * Since ExtractCodecTypes<Record<K, ScalarNames[K]>> has exactly one key (the Id),\n * we extract it by creating a mapped type that uses the Id as both key and value,\n * then extract the value type. This preserves literal types.\n */\nexport type ExtractDataTypes<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> },\n> = {\n  readonly [K in keyof ScalarNames]: {\n    readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n  }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n};\n\n/**\n * Builder interface for declaring codecs.\n */\nexport interface CodecDefBuilder<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> {\n  readonly CodecTypes: ExtractCodecTypes<ScalarNames>;\n\n  add<ScalarName extends string, CodecImpl extends Codec<string>>(\n    scalarName: ScalarName,\n    codecImpl: CodecImpl,\n  ): CodecDefBuilder<\n    O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>\n  >;\n\n  readonly codecDefinitions: {\n    readonly [K in keyof ScalarNames]: {\n      readonly typeId: ScalarNames[K] extends Codec<infer Id extends string, unknown, unknown>\n        ? Id\n        : never;\n      readonly scalar: K;\n      readonly codec: ScalarNames[K];\n      readonly input: CodecInput<ScalarNames[K]>;\n      readonly output: CodecOutput<ScalarNames[K]>;\n      readonly jsType: CodecOutput<ScalarNames[K]>;\n    };\n  };\n\n  readonly dataTypes: {\n    readonly [K in keyof ScalarNames]: {\n      readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n    }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n  };\n}\n\n/**\n * Implementation of CodecDefBuilder.\n */\nclass CodecDefBuilderImpl<\n  ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>,\n> implements CodecDefBuilder<ScalarNames>\n{\n  private readonly _codecs: ScalarNames;\n\n  public readonly CodecTypes: ExtractCodecTypes<ScalarNames>;\n  public readonly dataTypes: {\n    readonly [K in keyof ScalarNames]: {\n      readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n    }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n  };\n\n  constructor(codecs: ScalarNames) {\n    this._codecs = codecs;\n\n    // Populate CodecTypes from codecs\n    const codecTypes: Record<string, { readonly input: unknown; readonly output: unknown }> = {};\n    for (const [, codecImpl] of Object.entries(this._codecs)) {\n      const codecImplTyped = codecImpl as Codec<string>;\n      codecTypes[codecImplTyped.id] = {\n        input: undefined as unknown as CodecInput<typeof codecImplTyped>,\n        output: undefined as unknown as CodecOutput<typeof codecImplTyped>,\n      };\n    }\n    this.CodecTypes = codecTypes as ExtractCodecTypes<ScalarNames>;\n\n    // Populate dataTypes from codecs - extract id property from each codec\n    // Build object preserving keys from ScalarNames\n    // Type assertion is safe because we know ScalarNames structure matches the return type\n    // biome-ignore lint/suspicious/noExplicitAny: dynamic codec mapping requires any\n    const dataTypes = {} as any;\n    for (const key in this._codecs) {\n      if (Object.hasOwn(this._codecs, key)) {\n        const codec = this._codecs[key] as Codec<string>;\n        dataTypes[key] = codec.id;\n      }\n    }\n    this.dataTypes = dataTypes as {\n      readonly [K in keyof ScalarNames]: {\n        readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;\n      }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];\n    };\n  }\n\n  add<ScalarName extends string, CodecImpl extends Codec<string>>(\n    scalarName: ScalarName,\n    codecImpl: CodecImpl,\n  ): CodecDefBuilder<\n    O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>\n  > {\n    return new CodecDefBuilderImpl({\n      ...this._codecs,\n      [scalarName]: codecImpl,\n    } as O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>);\n  }\n\n  /**\n   * Derive codecDefinitions structure.\n   */\n  get codecDefinitions(): {\n    readonly [K in keyof ScalarNames]: {\n      readonly typeId: ScalarNames[K] extends Codec<infer Id, unknown, unknown> ? Id : never;\n      readonly scalar: K;\n      readonly codec: ScalarNames[K];\n      readonly input: CodecInput<ScalarNames[K]>;\n      readonly output: CodecOutput<ScalarNames[K]>;\n      readonly jsType: CodecOutput<ScalarNames[K]>;\n    };\n  } {\n    const result: Record<\n      string,\n      {\n        typeId: string;\n        scalar: string;\n        codec: Codec;\n        input: unknown;\n        output: unknown;\n        jsType: unknown;\n      }\n    > = {};\n\n    for (const [scalarName, codecImpl] of Object.entries(this._codecs)) {\n      const codec = codecImpl as Codec<string>;\n      result[scalarName] = {\n        typeId: codec.id,\n        scalar: scalarName,\n        codec: codec,\n        input: undefined as unknown as CodecInput<typeof codec>,\n        output: undefined as unknown as CodecOutput<typeof codec>,\n        jsType: undefined as unknown as CodecOutput<typeof codec>,\n      };\n    }\n\n    return result as {\n      readonly [K in keyof ScalarNames]: {\n        readonly typeId: ScalarNames[K] extends Codec<infer Id extends string, unknown, unknown>\n          ? Id\n          : never;\n        readonly scalar: K;\n        readonly codec: ScalarNames[K];\n        readonly input: CodecInput<ScalarNames[K]>;\n        readonly output: CodecOutput<ScalarNames[K]>;\n        readonly jsType: CodecOutput<ScalarNames[K]>;\n      };\n    };\n  }\n}\n\n/**\n * Create a new codec registry.\n */\nexport function createCodecRegistry(): CodecRegistry {\n  return new CodecRegistryImpl();\n}\n\n/**\n * Create a new codec definition builder.\n */\nexport function defineCodecs(): CodecDefBuilder<Record<never, never>> {\n  return new CodecDefBuilderImpl({});\n}\n","export function compact<T extends Record<string, unknown>>(o: T): T {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(o)) {\n    if (v === undefined || v === null) continue;\n    if (Array.isArray(v) && v.length === 0) continue;\n    out[k] = v;\n  }\n  return out as T;\n}\n","import type { ColumnRef, LiteralExpr, OperationExpr, ParamRef, TableRef } from './types';\nimport { compact } from './util';\n\nexport function createTableRef(name: string): TableRef {\n  return {\n    kind: 'table',\n    name,\n  };\n}\n\nexport function createColumnRef(table: string, column: string): ColumnRef {\n  return {\n    kind: 'col',\n    table,\n    column,\n  };\n}\n\nexport function createParamRef(index: number, name?: string): ParamRef {\n  return compact({\n    kind: 'param',\n    index,\n    name,\n  }) as ParamRef;\n}\n\nexport function createOperationExpr(operation: OperationExpr): OperationExpr {\n  return operation;\n}\n\nexport function createLiteralExpr(value: unknown): LiteralExpr {\n  return {\n    kind: 'literal',\n    value,\n  };\n}\n","import type { ColumnRef, DeleteAst, PredicateExpr, TableRef } from './types';\nimport { compact } from './util';\n\nexport interface CreateDeleteAstOptions {\n  readonly table: TableRef;\n  readonly where: PredicateExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createDeleteAst(options: CreateDeleteAstOptions): DeleteAst {\n  return compact({\n    kind: 'delete',\n    table: options.table,\n    where: options.where,\n    returning: options.returning,\n  }) as DeleteAst;\n}\n","import type { ColumnRef, InsertAst, ParamRef, TableRef } from './types';\nimport { compact } from './util';\n\nexport interface CreateInsertAstOptions {\n  readonly table: TableRef;\n  readonly values: Record<string, ColumnRef | ParamRef>;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createInsertAst(options: CreateInsertAstOptions): InsertAst {\n  return compact({\n    kind: 'insert',\n    table: options.table,\n    values: options.values,\n    returning: options.returning,\n  }) as InsertAst;\n}\n","import { planInvalid } from '@prisma-next/plan';\nimport type { AnyColumnBuilder, JoinOnBuilder, JoinOnPredicate } from '../types';\nimport { isColumnBuilder } from '../types';\nimport type { ColumnRef, JoinAst, JoinOnExpr, TableRef } from './types';\n\nexport function createJoin(\n  joinType: 'inner' | 'left' | 'right' | 'full',\n  table: TableRef,\n  on: JoinOnExpr,\n): JoinAst {\n  return {\n    kind: 'join',\n    joinType,\n    table,\n    on,\n  };\n}\n\nexport function createJoinOnExpr(left: ColumnRef, right: ColumnRef): JoinOnExpr {\n  return {\n    kind: 'eqCol',\n    left,\n    right,\n  };\n}\n\nclass JoinOnBuilderImpl implements JoinOnBuilder {\n  eqCol(left: AnyColumnBuilder, right: AnyColumnBuilder): JoinOnPredicate {\n    if (!left || !isColumnBuilder(left)) {\n      throw planInvalid('Join ON left operand must be a column');\n    }\n\n    if (!right || !isColumnBuilder(right)) {\n      throw planInvalid('Join ON right operand must be a column');\n    }\n\n    // TypeScript can't narrow ColumnBuilder properly, so we assert\n    const leftCol = left as unknown as { table: string; column: string };\n    const rightCol = right as unknown as { table: string; column: string };\n    if (leftCol.table === rightCol.table) {\n      throw planInvalid('Self-joins are not supported in MVP');\n    }\n\n    return {\n      kind: 'join-on',\n      left: left as AnyColumnBuilder,\n      right: right as AnyColumnBuilder,\n    };\n  }\n}\n\nexport function createJoinOnBuilder(): JoinOnBuilder {\n  return new JoinOnBuilderImpl();\n}\n","import type { ColumnRef, Direction, OperationExpr } from './types';\n\nexport function createOrderByItem(\n  expr: ColumnRef | OperationExpr,\n  dir: 'asc' | 'desc',\n): { expr: ColumnRef | OperationExpr; dir: Direction } {\n  return {\n    expr,\n    dir,\n  };\n}\n","import type {\n  BinaryExpr,\n  BinaryOp,\n  ColumnRef,\n  ExistsExpr,\n  NullCheckExpr,\n  NullCheckOp,\n  OperationExpr,\n  ParamRef,\n  SelectAst,\n} from './types';\n\nexport function createBinaryExpr(\n  op: BinaryOp,\n  left: ColumnRef | OperationExpr,\n  right: ColumnRef | ParamRef,\n): BinaryExpr {\n  return {\n    kind: 'bin',\n    op,\n    left,\n    right,\n  };\n}\n\nexport function createExistsExpr(not: boolean, subquery: SelectAst): ExistsExpr {\n  return {\n    kind: 'exists',\n    not,\n    subquery,\n  };\n}\n\nexport function createNullCheckExpr(\n  op: NullCheckOp,\n  expr: ColumnRef | OperationExpr,\n): NullCheckExpr {\n  return {\n    kind: 'nullCheck',\n    op,\n    expr,\n  };\n}\n","import type {\n  ColumnRef,\n  Direction,\n  IncludeAst,\n  IncludeRef,\n  JoinAst,\n  OperationExpr,\n  PredicateExpr,\n  SelectAst,\n  TableRef,\n} from './types';\nimport { compact } from './util';\n\nexport interface CreateSelectAstOptions {\n  readonly from: TableRef;\n  readonly joins?: ReadonlyArray<JoinAst>;\n  readonly includes?: ReadonlyArray<IncludeAst>;\n  readonly project: ReadonlyArray<{\n    alias: string;\n    expr: ColumnRef | IncludeRef | OperationExpr;\n  }>;\n  readonly where?: PredicateExpr;\n  readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n  readonly limit?: number;\n}\n\nexport function createSelectAst(options: CreateSelectAstOptions): SelectAst {\n  return compact({\n    kind: 'select',\n    from: options.from,\n    joins: options.joins,\n    includes: options.includes,\n    project: options.project,\n    where: options.where,\n    orderBy: options.orderBy,\n    limit: options.limit,\n  }) as SelectAst;\n}\n","import type { ReturnSpec } from '@prisma-next/operations';\nimport type { SqlLoweringSpec } from '@prisma-next/sql-operations';\n\n// SQL-specific AST types and supporting types\n// These types are needed by adapters and runtime for SQL query execution\n\nexport type Direction = 'asc' | 'desc';\n\nexport interface TableRef {\n  readonly kind: 'table';\n  readonly name: string;\n}\n\nexport interface ColumnRef {\n  readonly kind: 'col';\n  readonly table: string;\n  readonly column: string;\n}\n\nexport interface ParamRef {\n  readonly kind: 'param';\n  readonly index: number;\n  readonly name?: string;\n}\n\nexport interface LiteralExpr {\n  readonly kind: 'literal';\n  readonly value: unknown;\n}\n\nexport interface OperationExpr {\n  readonly kind: 'operation';\n  readonly method: string;\n  readonly forTypeId: string;\n  readonly self: ColumnRef | OperationExpr;\n  readonly args: ReadonlyArray<ColumnRef | ParamRef | LiteralExpr | OperationExpr>;\n  readonly returns: ReturnSpec;\n  readonly lowering: SqlLoweringSpec;\n}\n\nexport function isOperationExpr(expr: ColumnRef | OperationExpr): expr is OperationExpr {\n  return expr.kind === 'operation';\n}\n\nexport type BinaryOp = 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte';\n\nexport interface BinaryExpr {\n  readonly kind: 'bin';\n  readonly op: BinaryOp;\n  readonly left: ColumnRef | OperationExpr;\n  readonly right: ColumnRef | ParamRef;\n}\n\nexport type NullCheckOp = 'isNull' | 'isNotNull';\n\nexport interface NullCheckExpr {\n  readonly kind: 'nullCheck';\n  readonly op: NullCheckOp;\n  readonly expr: ColumnRef | OperationExpr;\n}\n\nexport interface ExistsExpr {\n  readonly kind: 'exists';\n  readonly not: boolean;\n  readonly subquery: SelectAst;\n}\n\nexport type PredicateExpr = BinaryExpr | ExistsExpr | NullCheckExpr;\n\nexport type JoinOnExpr = {\n  readonly kind: 'eqCol';\n  readonly left: ColumnRef;\n  readonly right: ColumnRef;\n};\n\nexport interface JoinAst {\n  readonly kind: 'join';\n  readonly joinType: 'inner' | 'left' | 'right' | 'full';\n  readonly table: TableRef;\n  readonly on: JoinOnExpr;\n}\n\nexport interface IncludeRef {\n  readonly kind: 'includeRef';\n  readonly alias: string;\n}\n\nexport interface IncludeAst {\n  readonly kind: 'includeMany';\n  readonly alias: string;\n  readonly child: {\n    readonly table: TableRef;\n    readonly on: JoinOnExpr;\n    readonly where?: PredicateExpr;\n    readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n    readonly limit?: number;\n    readonly project: ReadonlyArray<{ alias: string; expr: ColumnRef | OperationExpr }>;\n  };\n}\n\nexport interface SelectAst {\n  readonly kind: 'select';\n  readonly from: TableRef;\n  readonly joins?: ReadonlyArray<JoinAst>;\n  readonly includes?: ReadonlyArray<IncludeAst>;\n  readonly project: ReadonlyArray<{\n    alias: string;\n    expr: ColumnRef | IncludeRef | OperationExpr | LiteralExpr;\n  }>;\n  readonly where?: PredicateExpr;\n  readonly orderBy?: ReadonlyArray<{ expr: ColumnRef | OperationExpr; dir: Direction }>;\n  readonly limit?: number;\n}\n\nexport interface InsertAst {\n  readonly kind: 'insert';\n  readonly table: TableRef;\n  readonly values: Record<string, ColumnRef | ParamRef>;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport interface UpdateAst {\n  readonly kind: 'update';\n  readonly table: TableRef;\n  readonly set: Record<string, ColumnRef | ParamRef>;\n  readonly where: PredicateExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport interface DeleteAst {\n  readonly kind: 'delete';\n  readonly table: TableRef;\n  readonly where: PredicateExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport type QueryAst = SelectAst | InsertAst | UpdateAst | DeleteAst;\n\nexport interface LoweredStatement {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n  readonly annotations?: Record<string, unknown>;\n}\n","import type { ColumnRef, ParamRef, PredicateExpr, TableRef, UpdateAst } from './types';\nimport { compact } from './util';\n\nexport interface CreateUpdateAstOptions {\n  readonly table: TableRef;\n  readonly set: Record<string, ColumnRef | ParamRef>;\n  readonly where: PredicateExpr;\n  readonly returning?: ReadonlyArray<ColumnRef>;\n}\n\nexport function createUpdateAst(options: CreateUpdateAstOptions): UpdateAst {\n  return compact({\n    kind: 'update',\n    table: options.table,\n    set: options.set,\n    where: options.where,\n    returning: options.returning,\n  }) as UpdateAst;\n}\n"],"mappings":"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","names":["codec"]}

package/dist/chunk-J6EORPAV.js

@@ -0,0 +1,149 @@
+// src/expression-builder.ts
+import { planInvalid } from "@prisma-next/plan";
+function createExpressionBuilder(expr, columnMeta) {
+  const expressionBuilder = {
+    kind: "expression",
+    expr,
+    columnMeta,
+    eq(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "eq",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    neq(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "neq",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    gt(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "gt",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    lt(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "lt",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    gte(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "gte",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    lte(value) {
+      if (value == null) {
+        throw planInvalid(
+          "Parameter placeholder or column builder required for expression comparison"
+        );
+      }
+      if (value.kind === "param-placeholder" || value.kind === "column") {
+        return Object.freeze({
+          kind: "binary",
+          op: "lte",
+          left: expressionBuilder,
+          right: value
+        });
+      }
+      throw planInvalid(
+        "Parameter placeholder or column builder required for expression comparison"
+      );
+    },
+    asc() {
+      return Object.freeze({
+        kind: "order",
+        expr: expressionBuilder,
+        dir: "asc"
+      });
+    },
+    desc() {
+      return Object.freeze({
+        kind: "order",
+        expr: expressionBuilder,
+        dir: "desc"
+      });
+    },
+    get __jsType() {
+      return void 0;
+    }
+  };
+  return Object.freeze(expressionBuilder);
+}
+function columnToExpression(builder) {
+  const columnRef = {
+    kind: "col",
+    table: builder.table,
+    column: builder.column
+  };
+  return createExpressionBuilder(columnRef, builder.columnMeta);
+}
+
+export {
+  createExpressionBuilder,
+  columnToExpression
+};
+//# sourceMappingURL=chunk-J6EORPAV.js.map

package/dist/chunk-J6EORPAV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/expression-builder.ts"],"sourcesContent":["import { planInvalid } from '@prisma-next/plan';\nimport type { StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { BinaryOp, ColumnRef, OperationExpr } from './ast/types';\nimport type {\n  AnyColumnBuilderBase,\n  BinaryBuilder,\n  ExpressionBuilder,\n  OrderBuilder,\n  ParamPlaceholder,\n} from './types';\n\n/**\n * Creates an ExpressionBuilder from a ColumnRef or OperationExpr.\n * This is the factory function for creating expression nodes that can be used\n * in query building (projections, WHERE clauses, ORDER BY, etc.).\n */\nexport function createExpressionBuilder<\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  JsType = unknown,\n>(\n  expr: ColumnRef | OperationExpr,\n  columnMeta: ColumnMeta,\n): ExpressionBuilder<ColumnName, ColumnMeta, JsType> {\n  const expressionBuilder: ExpressionBuilder<ColumnName, ColumnMeta, JsType> = {\n    kind: 'expression' as const,\n    expr,\n    columnMeta,\n    eq(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'eq' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    neq(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'neq' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    gt(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'gt' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    lt(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'lt' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    gte(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'gte' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    lte(\n      value: ParamPlaceholder | AnyColumnBuilderBase,\n    ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n      if (value == null) {\n        throw planInvalid(\n          'Parameter placeholder or column builder required for expression comparison',\n        );\n      }\n      if (value.kind === 'param-placeholder' || value.kind === 'column') {\n        return Object.freeze({\n          kind: 'binary' as const,\n          op: 'lte' as BinaryOp,\n          left: expressionBuilder,\n          right: value,\n        }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n      throw planInvalid(\n        'Parameter placeholder or column builder required for expression comparison',\n      );\n    },\n    asc(): OrderBuilder<ColumnName, ColumnMeta, JsType> {\n      return Object.freeze({\n        kind: 'order' as const,\n        expr: expressionBuilder,\n        dir: 'asc' as const,\n      }) as OrderBuilder<ColumnName, ColumnMeta, JsType>;\n    },\n    desc(): OrderBuilder<ColumnName, ColumnMeta, JsType> {\n      return Object.freeze({\n        kind: 'order' as const,\n        expr: expressionBuilder,\n        dir: 'desc' as const,\n      }) as OrderBuilder<ColumnName, ColumnMeta, JsType>;\n    },\n    get __jsType(): JsType {\n      return undefined as unknown as JsType;\n    },\n  };\n\n  return Object.freeze(expressionBuilder);\n}\n\n/**\n * Converts a ColumnBuilder to an ExpressionBuilder.\n * This extracts the ColumnRef from the builder and wraps it in an ExpressionBuilder.\n */\nexport function columnToExpression<\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  JsType = unknown,\n>(builder: {\n  readonly table: string;\n  readonly column: ColumnName;\n  readonly columnMeta: ColumnMeta;\n}): ExpressionBuilder<ColumnName, ColumnMeta, JsType> {\n  const columnRef: ColumnRef = {\n    kind: 'col',\n    table: builder.table,\n    column: builder.column,\n  };\n  return createExpressionBuilder(columnRef, builder.columnMeta);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-R77KHJFH.js → chunk-QRJVCABZ.js}

@@ -6,4 +6,4 @@ function isColumnBuilder(value) {
 export {
   isColumnBuilder
 };
-//# sourceMappingURL=chunk-R77KHJFH.js.map
+//# sourceMappingURL=chunk-QRJVCABZ.js.map

package/dist/chunk-QRJVCABZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type {\n  ResultType as CoreResultType,\n  ExecutionPlan,\n  PlanRefs,\n} from '@prisma-next/contract/types';\nimport type { ArgSpec, ReturnSpec } from '@prisma-next/operations';\nimport type { SqlContract, SqlStorage, StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { SqlLoweringSpec } from '@prisma-next/sql-operations';\nimport type {\n  BinaryOp,\n  ColumnRef,\n  Direction,\n  NullCheckOp,\n  OperationExpr,\n  ParamRef,\n  QueryAst,\n} from './ast/types';\nimport type { SqlQueryPlan } from './plan';\nimport type { QueryLaneContext } from './query-lane-context';\n\nexport interface ParamPlaceholder {\n  readonly kind: 'param-placeholder';\n  readonly name: string;\n}\n\nexport interface OrderBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n> {\n  readonly kind: 'order';\n  readonly expr: ExpressionBuilder<ColumnName, ColumnMeta, JsType>;\n  readonly dir: Direction;\n}\n\n/**\n * ColumnBuilder with optional operation methods based on the column's typeId.\n * When Operations is provided and the column's typeId matches, operation methods are included.\n */\nexport type ColumnBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n  Operations extends OperationTypes = Record<string, never>,\n> = {\n  readonly kind: 'column';\n  readonly table: string;\n  readonly column: ColumnName;\n  readonly columnMeta: ColumnMeta;\n  eq(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  neq(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  gt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  lt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  gte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  lte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  asc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  desc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  // Helper property for type extraction (not used at runtime)\n  readonly __jsType: JsType;\n} & (ColumnMeta['codecId'] extends string\n  ? ColumnMeta['codecId'] extends keyof Operations\n    ? OperationMethods<\n        OperationsForTypeId<ColumnMeta['codecId'] & string, Operations>,\n        ColumnName,\n        StorageColumn,\n        JsType\n      >\n    : Record<string, never>\n  : Record<string, never>) & {\n    toExpression(): ExpressionBuilder<ColumnName, ColumnMeta, JsType>;\n  } & (ColumnMeta['nullable'] extends true\n    ? {\n        isNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType>;\n        isNotNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType>;\n      }\n    : Record<string, never>);\n\n/**\n * ExpressionBuilder represents an expression node (either a ColumnRef or OperationExpr).\n * This is the return type for operations, providing a clean separation between column handles\n * and expression nodes.\n */\nexport interface ExpressionBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n> {\n  readonly kind: 'expression';\n  readonly expr: ColumnRef | OperationExpr;\n  readonly columnMeta: ColumnMeta;\n  eq(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  neq(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  gt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  lt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  gte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  lte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n  asc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  desc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  // Helper property for type extraction (not used at runtime)\n  readonly __jsType: JsType;\n}\n\nexport type AnyExpressionBuilder = ExpressionBuilder<string, StorageColumn, unknown>;\n\nexport interface BinaryBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n> {\n  readonly kind: 'binary';\n  readonly op: BinaryOp;\n  readonly left: ExpressionBuilder<ColumnName, ColumnMeta, JsType>;\n  readonly right: ParamPlaceholder | AnyColumnBuilderBase;\n}\n\nexport interface NullCheckBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n> {\n  readonly kind: 'nullCheck';\n  readonly op: NullCheckOp;\n  readonly expr: ExpressionBuilder<ColumnName, ColumnMeta, JsType>;\n}\n\nexport type PredicateBuilder<\n  ColumnName extends string = string,\n  ColumnMeta extends StorageColumn = StorageColumn,\n  JsType = unknown,\n> =\n  | BinaryBuilder<ColumnName, ColumnMeta, JsType>\n  | NullCheckBuilder<ColumnName, ColumnMeta, JsType>;\n\n// Helper aliases for usage sites where the specific column parameters are irrelevant\n// Accepts any ColumnBuilder regardless of its Operations parameter\n// Note: We use `any` here because TypeScript's variance rules don't allow us to express\n// \"any type that extends OperationTypes\" in a way that works for assignment.\n// Contract-specific OperationTypes (e.g., PgVectorOperationTypes) are not assignable\n// to the base OperationTypes in generic parameter position, even though they extend it structurally.\n// Helper type that accepts any ColumnBuilder regardless of its generic parameters\n// This is needed because conditional types in ColumnBuilder create incompatible intersection types\n// when Operations differs, even though structurally they're compatible\nexport type AnyColumnBuilderBase = {\n  readonly kind: 'column';\n  readonly table: string;\n  readonly column: string;\n  readonly columnMeta: StorageColumn;\n  eq(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  neq(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  gt(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  lt(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  gte(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  lte(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;\n  asc(): AnyOrderBuilder;\n  desc(): AnyOrderBuilder;\n  readonly __jsType: unknown;\n  // Allow any operation methods (from conditional type)\n  readonly [key: string]: unknown;\n};\n\nexport type AnyColumnBuilder =\n  | ColumnBuilder<\n      string,\n      StorageColumn,\n      unknown,\n      // biome-ignore lint/suspicious/noExplicitAny: AnyColumnBuilder must accept column builders with any operation types\n      any\n    >\n  | AnyColumnBuilderBase;\nexport type AnyBinaryBuilder = BinaryBuilder<string, StorageColumn, unknown>;\nexport type AnyPredicateBuilder = PredicateBuilder<string, StorageColumn, unknown>;\nexport type AnyOrderBuilder = OrderBuilder<string, StorageColumn, unknown>;\n\nexport function isColumnBuilder(value: unknown): value is AnyColumnBuilder {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'kind' in value &&\n    (value as { kind: unknown }).kind === 'column'\n  );\n}\n\nexport interface JoinOnBuilder {\n  eqCol(left: AnyColumnBuilder, right: AnyColumnBuilder): JoinOnPredicate;\n}\n\nexport interface JoinOnPredicate {\n  readonly kind: 'join-on';\n  readonly left: AnyColumnBuilder;\n  readonly right: AnyColumnBuilder;\n}\n\nexport type Expr = ColumnRef | ParamRef;\n\n/**\n * Helper type to extract codec output type from CodecTypes.\n * Returns never if the codecId is not found in CodecTypes.\n */\ntype ExtractCodecOutputType<\n  CodecId extends string,\n  CodecTypes extends Record<string, { readonly output: unknown }>,\n> = CodecId extends keyof CodecTypes\n  ? CodecTypes[CodecId] extends { readonly output: infer Output }\n    ? Output\n    : never\n  : never;\n\n/**\n * Type-level operation signature.\n * Represents an operation at the type level, similar to OperationSignature at runtime.\n */\nexport type OperationTypeSignature = {\n  readonly args: ReadonlyArray<ArgSpec>;\n  readonly returns: ReturnSpec;\n  readonly lowering: SqlLoweringSpec;\n  readonly capabilities?: ReadonlyArray<string>;\n};\n\n/**\n * Type-level operation registry.\n * Maps typeId → operations, where operations is a record of method name → operation signature.\n *\n * Example:\n * ```typescript\n * type MyOperations: OperationTypes = {\n *   'pg/vector@1': {\n *     cosineDistance: {\n *       args: [{ kind: 'typeId'; type: 'pg/vector@1' }];\n *       returns: { kind: 'builtin'; type: 'number' };\n *       lowering: { targetFamily: 'sql'; strategy: 'function'; template: '...' };\n *     };\n *   };\n * };\n * ```\n */\nexport type OperationTypes = Record<string, Record<string, OperationTypeSignature>>;\n\n/**\n * CodecTypes represents a map of typeId to codec definitions.\n * Each codec definition must have an `output` property indicating the JavaScript type.\n *\n * Example:\n * ```typescript\n * type MyCodecTypes: CodecTypes = {\n *   'pg/int4@1': { output: number };\n *   'pg/text@1': { output: string };\n * };\n * ```\n */\nexport type CodecTypes = Record<string, { readonly output: unknown }>;\n\n/**\n * Extracts operations for a given typeId from the operation registry.\n * Returns an empty record if the typeId is not found.\n *\n * @example\n * ```typescript\n * type Ops = OperationsForTypeId<'pg/vector@1', MyOperations>;\n * // Ops = { cosineDistance: { ... }, l2Distance: { ... } }\n * ```\n */\nexport type OperationsForTypeId<\n  TypeId extends string,\n  Operations extends OperationTypes,\n> = Operations extends Record<string, never>\n  ? Record<string, never>\n  : TypeId extends keyof Operations\n    ? Operations[TypeId]\n    : Record<string, never>;\n\n/**\n * Maps operation signatures to method signatures on ColumnBuilder.\n * Each operation becomes a method that returns a ColumnBuilder or BinaryBuilder\n * based on the return type.\n */\ntype OperationMethods<\n  Ops extends Record<string, OperationTypeSignature>,\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  JsType,\n> = {\n  [K in keyof Ops]: Ops[K] extends OperationTypeSignature\n    ? (\n        ...args: OperationArgs<Ops[K]['args']>\n      ) => OperationReturn<Ops[K]['returns'], ColumnName, ColumnMeta, JsType>\n    : never;\n};\n\n/**\n * Maps operation argument specs to TypeScript argument types.\n * - typeId args: ColumnBuilder (accepts base columns or operation results)\n * - param args: ParamPlaceholder\n * - literal args: unknown (could be more specific in future)\n */\ntype OperationArgs<Args extends ReadonlyArray<ArgSpec>> = Args extends readonly [\n  infer First,\n  ...infer Rest,\n]\n  ? First extends ArgSpec\n    ? [ArgToType<First>, ...(Rest extends ReadonlyArray<ArgSpec> ? OperationArgs<Rest> : [])]\n    : []\n  : [];\n\ntype ArgToType<Arg extends ArgSpec> = Arg extends { kind: 'typeId' }\n  ? AnyColumnBuilder\n  : Arg extends { kind: 'param' }\n    ? ParamPlaceholder\n    : Arg extends { kind: 'literal' }\n      ? unknown\n      : never;\n\n/**\n * Maps operation return spec to return type.\n * - builtin types: ExpressionBuilder with appropriate JsType (matches runtime behavior)\n * - typeId types: ExpressionBuilder (for now, could be more specific in future)\n */\ntype OperationReturn<\n  Returns extends ReturnSpec,\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  _JsType,\n> = Returns extends { kind: 'builtin'; type: infer T }\n  ? T extends 'number'\n    ? ExpressionBuilder<ColumnName, ColumnMeta, number>\n    : T extends 'boolean'\n      ? ExpressionBuilder<ColumnName, ColumnMeta, boolean>\n      : T extends 'string'\n        ? ExpressionBuilder<ColumnName, ColumnMeta, string>\n        : ExpressionBuilder<ColumnName, ColumnMeta, unknown>\n  : Returns extends { kind: 'typeId' }\n    ? AnyExpressionBuilder\n    : ExpressionBuilder<ColumnName, ColumnMeta, unknown>;\n\n/**\n * Computes JavaScript type for a column at column creation time.\n *\n * Type inference:\n * - Read columnMeta.codecId as typeId string literal\n * - Look up CodecTypes[typeId].output\n * - Apply nullability: nullable ? Output | null : Output\n */\ntype ColumnMetaTypeId<ColumnMeta> = ColumnMeta extends { codecId: infer CodecId extends string }\n  ? CodecId\n  : ColumnMeta extends { type: infer TypeId extends string }\n    ? TypeId\n    : never;\n\nexport type ComputeColumnJsType<\n  _Contract extends SqlContract<SqlStorage>,\n  _TableName extends string,\n  _ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  CodecTypes extends Record<string, { readonly output: unknown }>,\n> = ColumnMeta extends { nullable: infer Nullable }\n  ? ColumnMetaTypeId<ColumnMeta> extends infer TypeId\n    ? TypeId extends string\n      ? ExtractCodecOutputType<TypeId, CodecTypes> extends infer CodecOutput\n        ? [CodecOutput] extends [never]\n          ? unknown // Codec not found in CodecTypes\n          : Nullable extends true\n            ? CodecOutput | null\n            : CodecOutput\n        : unknown\n      : unknown\n    : unknown\n  : unknown;\n\n/**\n * Infers Row type from a projection object.\n * Maps Record<string, ColumnBuilder> to Record<string, JSType>\n *\n * Extracts the pre-computed JsType from each ColumnBuilder in the projection.\n */\n/**\n * Extracts the inferred JsType carried by a ColumnBuilder.\n */\ntype ExtractJsTypeFromColumnBuilder<CB extends AnyColumnBuilder> = CB extends ColumnBuilder<\n  infer _ColumnName extends string,\n  infer _ColumnMeta extends StorageColumn,\n  infer JsType,\n  infer _Ops\n>\n  ? JsType\n  : never;\n\n/**\n * Extracts the inferred JsType carried by an ExpressionBuilder.\n */\ntype ExtractJsTypeFromExpressionBuilder<EB extends AnyExpressionBuilder> =\n  EB extends ExpressionBuilder<\n    infer _ColumnName extends string,\n    infer _ColumnMeta extends StorageColumn,\n    infer JsType\n  >\n    ? JsType\n    : never;\n\nexport type InferProjectionRow<P extends Record<string, AnyColumnBuilder>> = {\n  [K in keyof P]: ExtractJsTypeFromColumnBuilder<P[K]>;\n};\n\n/**\n * Nested projection type - allows recursive nesting of ColumnBuilder, ExpressionBuilder, or nested objects.\n */\nexport type NestedProjection = Record<\n  string,\n  | AnyColumnBuilder\n  | AnyExpressionBuilder\n  | Record<\n      string,\n      | AnyColumnBuilder\n      | AnyExpressionBuilder\n      | Record<\n          string,\n          | AnyColumnBuilder\n          | AnyExpressionBuilder\n          | Record<\n              string,\n              | AnyColumnBuilder\n              | AnyExpressionBuilder\n              | Record<string, AnyColumnBuilder | AnyExpressionBuilder>\n            >\n        >\n    >\n>;\n\n/**\n * Helper type to extract include type from Includes map.\n * Returns the value type if K is a key of Includes, otherwise returns unknown.\n */\ntype ExtractIncludeType<\n  K extends string,\n  Includes extends Record<string, unknown>,\n> = K extends keyof Includes ? Includes[K] : unknown;\n\n/**\n * Infers Row type from a nested projection object.\n * Recursively maps Record<string, ColumnBuilder | ExpressionBuilder | boolean | NestedProjection> to nested object types.\n *\n * Extracts the pre-computed JsType from each ColumnBuilder or ExpressionBuilder at leaves.\n * When a value is `true`, it represents an include reference and infers `Array<ChildShape>`\n * by looking up the include alias in the Includes type map.\n */\nexport type InferNestedProjectionRow<\n  P extends Record<string, AnyColumnBuilder | AnyExpressionBuilder | boolean | NestedProjection>,\n  CodecTypes extends Record<string, { readonly output: unknown }> = Record<string, never>,\n  Includes extends Record<string, unknown> = Record<string, never>,\n> = {\n  [K in keyof P]: P[K] extends AnyColumnBuilder\n    ? ExtractJsTypeFromColumnBuilder<P[K]>\n    : P[K] extends AnyExpressionBuilder\n      ? ExtractJsTypeFromExpressionBuilder<P[K]>\n      : P[K] extends true\n        ? Array<ExtractIncludeType<K & string, Includes>> // Include reference - infers Array<ChildShape> from Includes map\n        : P[K] extends NestedProjection\n          ? InferNestedProjectionRow<P[K], CodecTypes, Includes>\n          : never;\n};\n\n/**\n * Infers Row type from a tuple of ColumnBuilders used in returning() clause.\n * Extracts column name and JsType from each ColumnBuilder and creates a Record.\n */\nexport type InferReturningRow<Columns extends readonly AnyColumnBuilder[]> =\n  Columns extends readonly [infer First, ...infer Rest]\n    ? First extends ColumnBuilder<\n        infer Name,\n        infer _Meta,\n        infer JsType,\n        infer _Ops extends OperationTypes\n      >\n      ? Name extends string\n        ? Rest extends readonly AnyColumnBuilder[]\n          ? { [K in Name]: JsType } & InferReturningRow<Rest>\n          : { [K in Name]: JsType }\n        : never\n      : never\n    : Record<string, never>;\n\n/**\n * Utility type to check if a contract has the required capabilities for includeMany.\n * Requires both `lateral` and `jsonAgg` to be `true` in the contract's capabilities for the target.\n * Capabilities are nested by target: `{ [target]: { lateral: true, jsonAgg: true } }`\n */\nexport type HasIncludeManyCapabilities<TContract extends SqlContract<SqlStorage>> =\n  TContract extends { capabilities: infer C; target: infer T }\n    ? T extends string\n      ? C extends Record<string, Record<string, boolean>>\n        ? C extends { [K in T]: infer TargetCaps }\n          ? TargetCaps extends { lateral: true; jsonAgg: true }\n            ? true\n            : false\n          : false\n        : false\n      : false\n    : false;\n\n/**\n * SQL-specific Plan type that refines the ast field to use QueryAst.\n * This is the type used by SQL query builders.\n */\nexport type SqlPlan<Row = unknown> = ExecutionPlan<Row, QueryAst>;\n\n/**\n * Helper types for extracting contract structure.\n */\nexport type TablesOf<TContract> = TContract extends {\n  storage: { tables: infer U };\n}\n  ? U\n  : never;\n\nexport type TableKey<TContract> = Extract<keyof TablesOf<TContract>, string>;\n\n// Common types for contract.d.ts generation (SQL-specific)\n// These types are used by emitted contract.d.ts files to provide type-safe DSL/ORM types\n\n/**\n * Unique symbol for metadata property to avoid collisions with user-defined properties\n */\nexport declare const META: unique symbol;\n\n/**\n * Extracts metadata from a type that has a META property\n */\nexport type Meta<T extends { [META]: unknown }> = T[typeof META];\n\n/**\n * Metadata interface for table definitions\n */\nexport interface TableMetadata<Name extends string> {\n  name: Name;\n}\n\n/**\n * Metadata interface for model definitions\n */\nexport interface ModelMetadata<Name extends string> {\n  name: Name;\n}\n\n/**\n * Base interface for table definitions with metadata\n * Used in contract.d.ts to define storage-level table types\n */\nexport interface TableDef<Name extends string> {\n  readonly [META]: TableMetadata<Name>;\n}\n\n/**\n * Base interface for model definitions with metadata\n * Used in contract.d.ts to define application-level model types\n */\nexport interface ModelDef<Name extends string> {\n  readonly [META]: ModelMetadata<Name>;\n}\n\nexport type ColumnsOf<\n  TContract,\n  K extends TableKey<TContract>,\n> = K extends keyof TablesOf<TContract>\n  ? TablesOf<TContract>[K] extends { columns: infer C }\n    ? C\n    : never\n  : never;\n\nexport interface RawTemplateOptions {\n  readonly refs?: PlanRefs;\n  readonly annotations?: Record<string, unknown>;\n  readonly projection?: ReadonlyArray<string>;\n}\n\nexport interface RawFunctionOptions extends RawTemplateOptions {\n  readonly params: ReadonlyArray<unknown>;\n}\n\nexport type RawTemplateFactory = (\n  strings: TemplateStringsArray,\n  ...values: readonly unknown[]\n) => ExecutionPlan;\n\nexport interface RawFactory extends RawTemplateFactory {\n  (text: string, options: RawFunctionOptions): ExecutionPlan;\n  with(options: RawTemplateOptions): RawTemplateFactory;\n}\n\nexport type { RuntimeError } from '@prisma-next/plan';\n\nexport interface BuildParamsMap {\n  readonly [name: string]: unknown;\n}\n\nexport interface BuildOptions {\n  readonly params?: BuildParamsMap;\n}\n\nexport interface SqlBuilderOptions<\n  TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>,\n> {\n  readonly context: QueryLaneContext<TContract>;\n}\n\n/**\n * SQL-specific ResultType that works with both Plan and SqlQueryPlan.\n * This extends the core ResultType to also handle SqlQueryPlan.\n * Example: `type Row = ResultType<typeof plan>`\n */\nexport type ResultType<P> = P extends SqlQueryPlan<infer R> ? R : CoreResultType<P>;\n"],"mappings":";AAyLO,SAAS,gBAAgB,OAA2C;AACzE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS;AAE1C;","names":[]}

package/dist/chunk-UVB7347H.js

@@ -0,0 +1,16 @@
+// src/utils/guards.ts
+function getColumnMeta(expr) {
+  if ("columnMeta" in expr) {
+    return expr.columnMeta;
+  }
+  return void 0;
+}
+function isParamPlaceholder(value) {
+  return typeof value === "object" && value !== null && "kind" in value && value.kind === "param-placeholder" && "name" in value && typeof value.name === "string";
+}
+
+export {
+  getColumnMeta,
+  isParamPlaceholder
+};
+//# sourceMappingURL=chunk-UVB7347H.js.map

package/dist/chunk-UVB7347H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/guards.ts"],"sourcesContent":["import type { StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { AnyColumnBuilder, ParamPlaceholder } from '../types';\n\n/**\n * Helper to extract columnMeta from a ColumnBuilder.\n * Returns StorageColumn if present, undefined otherwise.\n * AnyColumnBuilder is a union that includes types with columnMeta property,\n * so we can safely access it after checking for existence.\n */\nexport function getColumnMeta(expr: AnyColumnBuilder): StorageColumn | undefined {\n  // AnyColumnBuilder includes AnyColumnBuilderBase which has columnMeta: StorageColumn\n  // and ColumnBuilder which has columnMeta: ColumnMeta extends StorageColumn\n  // TypeScript should narrow the type after the 'in' check\n  if ('columnMeta' in expr) {\n    return expr.columnMeta;\n  }\n  return undefined;\n}\n\n/**\n * Type predicate to check if a value is a ParamPlaceholder.\n */\nexport function isParamPlaceholder(value: unknown): value is ParamPlaceholder {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'kind' in value &&\n    (value as { kind: unknown }).kind === 'param-placeholder' &&\n    'name' in value &&\n    typeof (value as { name: unknown }).name === 'string'\n  );\n}\n"],"mappings":";AASO,SAAS,cAAc,MAAmD;AAI/E,MAAI,gBAAgB,MAAM;AACxB,WAAO,KAAK;AAAA,EACd;AACA,SAAO;AACT;AAKO,SAAS,mBAAmB,OAA2C;AAC5E,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS,uBACtC,UAAU,SACV,OAAQ,MAA4B,SAAS;AAEjD;","names":[]}