@prisma-next/sql-relational-core 0.3.0-dev.4 → 0.3.0-dev.41

package/src/utils/guards.ts

@@ -0,0 +1,193 @@
+import type { StorageColumn } from '@prisma-next/sql-contract/types';
+import type {
+  ColumnRef,
+  Expression,
+  ExpressionSource,
+  LiteralExpr,
+  OperationExpr,
+  ParamRef,
+} from '../ast/types';
+import type {
+  AnyColumnBuilder,
+  AnyExpressionSource,
+  ExpressionBuilder,
+  ParamPlaceholder,
+  ValueSource,
+} from '../types';
+
+/**
+ * Helper to extract columnMeta from a ColumnBuilder or ExpressionBuilder.
+ * Returns StorageColumn if present, undefined otherwise.
+ * Both ColumnBuilder and ExpressionBuilder have columnMeta property.
+ */
+export function getColumnMeta(expr: AnyExpressionSource): StorageColumn | undefined {
+  // Both ColumnBuilder and ExpressionBuilder have columnMeta: StorageColumn
+  // TypeScript should narrow the type after the 'in' check
+  if ('columnMeta' in expr) {
+    return expr.columnMeta;
+  }
+  return undefined;
+}
+
+/**
+ * Type predicate to check if a value is a ParamPlaceholder.
+ */
+export function isParamPlaceholder(value: unknown): value is ParamPlaceholder {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'kind' in value &&
+    (value as { kind: unknown }).kind === 'param-placeholder' &&
+    'name' in value &&
+    typeof (value as { name: unknown }).name === 'string'
+  );
+}
+
+/**
+ * Recursively extracts the base ColumnRef from an OperationExpr.
+ * If the expression is already a ColumnRef, it is returned directly.
+ */
+export function extractBaseColumnRef(expr: ColumnRef | OperationExpr): ColumnRef {
+  if (expr.kind === 'col') {
+    return expr;
+  }
+  return extractBaseColumnRef(expr.self);
+}
+
+/**
+ * Recursively collects all ColumnRef nodes from an expression tree.
+ * Handles nested OperationExpr structures by traversing both self and args.
+ */
+export function collectColumnRefs(
+  expr: ColumnRef | ParamRef | LiteralExpr | OperationExpr,
+): ColumnRef[] {
+  if (expr.kind === 'col') {
+    return [expr];
+  }
+  if (expr.kind === 'operation') {
+    const refs: ColumnRef[] = collectColumnRefs(expr.self);
+    for (const arg of expr.args) {
+      refs.push(...collectColumnRefs(arg));
+    }
+    return refs;
+  }
+  return [];
+}
+
+/**
+ * Type predicate to check if an expression is an OperationExpr.
+ */
+export function isOperationExpr(
+  expr: AnyExpressionSource | OperationExpr | Expression,
+): expr is OperationExpr {
+  return typeof expr === 'object' && expr !== null && 'kind' in expr && expr.kind === 'operation';
+}
+
+/**
+ * Helper to extract table and column from a ColumnBuilder, ExpressionBuilder, or OperationExpr.
+ * For ExpressionBuilder or OperationExpr, recursively unwraps to find the base ColumnRef.
+ */
+export function getColumnInfo(expr: AnyExpressionSource | OperationExpr): {
+  table: string;
+  column: string;
+} {
+  if (isOperationExpr(expr)) {
+    const baseCol = extractBaseColumnRef(expr);
+    return { table: baseCol.table, column: baseCol.column };
+  }
+  if (isExpressionBuilder(expr)) {
+    const baseCol = extractBaseColumnRef(expr.expr);
+    return { table: baseCol.table, column: baseCol.column };
+  }
+  // expr is ColumnBuilder - TypeScript can't narrow properly
+  const colBuilder = expr as unknown as { table: string; column: string };
+  return { table: colBuilder.table, column: colBuilder.column };
+}
+
+/**
+ * Type predicate to check if a value is a ColumnBuilder.
+ */
+export function isColumnBuilder(value: unknown): value is AnyColumnBuilder {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'kind' in value &&
+    (value as { kind: unknown }).kind === 'column'
+  );
+}
+
+/**
+ * Type predicate to check if a value is an ExpressionBuilder.
+ */
+export function isExpressionBuilder(value: unknown): value is ExpressionBuilder {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'kind' in value &&
+    (value as { kind: unknown }).kind === 'expression'
+  );
+}
+
+/**
+ * Type predicate to check if a value is an ExpressionSource (has toExpr method).
+ */
+export function isExpressionSource(value: unknown): value is ExpressionSource {
+  return (
+    typeof value === 'object' &&
+    value !== null &&
+    'toExpr' in value &&
+    typeof (value as ExpressionSource).toExpr === 'function'
+  );
+}
+
+/**
+ * Converts any ExpressionSource to an Expression.
+ * This is the canonical way to get an AST Expression from a builder.
+ *
+ * @param source - A ColumnBuilder or ExpressionBuilder
+ * @returns The corresponding Expression (ColumnRef or OperationExpr)
+ */
+export function toExpression(source: ExpressionSource): Expression {
+  return source.toExpr();
+}
+
+/**
+ * Converts an AnyExpressionSource to an Expression.
+ * Handles both ColumnBuilder and ExpressionBuilder.
+ *
+ * @param source - A ColumnBuilder or ExpressionBuilder
+ * @returns The corresponding Expression (ColumnRef or OperationExpr)
+ */
+export function expressionFromSource(source: AnyExpressionSource): Expression {
+  return source.toExpr();
+}
+
+/**
+ * Type predicate to check if a value is a ValueSource.
+ * ValueSource is either a ParamPlaceholder or an ExpressionSource.
+ */
+export function isValueSource(value: unknown): value is ValueSource {
+  return isParamPlaceholder(value) || isExpressionSource(value);
+}
+
+/**
+ * Extracts and returns an OperationExpr from a builder.
+ * Returns the OperationExpr if the builder is an OperationExpr or has an _operationExpr property,
+ * otherwise returns undefined.
+ *
+ * @deprecated Use isExpressionBuilder() instead. This function exists for backward compatibility
+ * with code that uses the hidden _operationExpr property pattern.
+ *
+ * @design-note: This function accesses the hidden `_operationExpr` property, which is a code smell.
+ * The ExpressionBuilder type (introduced in the operation-expr-refactoring) provides a cleaner
+ * approach by explicitly representing operation results as a distinct type.
+ */
+export function getOperationExpr(
+  builder: AnyColumnBuilder | OperationExpr,
+): OperationExpr | undefined {
+  if (isOperationExpr(builder)) {
+    return builder;
+  }
+  const builderWithExpr = builder as unknown as { _operationExpr?: OperationExpr };
+  return builderWithExpr._operationExpr;
+}

package/dist/chunk-2F7DSEOU.js

@@ -1,8 +0,0 @@
-// src/errors.ts
-import { planInvalid, planUnsupported } from "@prisma-next/plan";
-
-export {
-  planInvalid,
-  planUnsupported
-};
-//# sourceMappingURL=chunk-2F7DSEOU.js.map

package/dist/chunk-2F7DSEOU.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["export { planInvalid, planUnsupported } from '@prisma-next/plan';\n"],"mappings":";AAAA,SAAS,aAAa,uBAAuB;","names":[]}

package/dist/chunk-36WJWNHT.js

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-36WJWNHT.js.map

package/dist/chunk-36WJWNHT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-5N34PNVZ.js

@@ -1,62 +0,0 @@
-// 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";
-}
-function extractBaseColumnRef(expr) {
-  if (expr.kind === "col") {
-    return expr;
-  }
-  return extractBaseColumnRef(expr.self);
-}
-function collectColumnRefs(expr) {
-  if (expr.kind === "col") {
-    return [expr];
-  }
-  if (expr.kind === "operation") {
-    const refs = collectColumnRefs(expr.self);
-    for (const arg of expr.args) {
-      refs.push(...collectColumnRefs(arg));
-    }
-    return refs;
-  }
-  return [];
-}
-function isOperationExpr(expr) {
-  return typeof expr === "object" && expr !== null && "kind" in expr && expr.kind === "operation";
-}
-function getColumnInfo(expr) {
-  if (isOperationExpr(expr)) {
-    const baseCol = extractBaseColumnRef(expr);
-    return { table: baseCol.table, column: baseCol.column };
-  }
-  const colBuilder = expr;
-  return { table: colBuilder.table, column: colBuilder.column };
-}
-function isColumnBuilder(value) {
-  return typeof value === "object" && value !== null && "kind" in value && value.kind === "column";
-}
-function getOperationExpr(builder) {
-  if (isOperationExpr(builder)) {
-    return builder;
-  }
-  const builderWithExpr = builder;
-  return builderWithExpr._operationExpr;
-}
-
-export {
-  getColumnMeta,
-  isParamPlaceholder,
-  extractBaseColumnRef,
-  collectColumnRefs,
-  isOperationExpr,
-  getColumnInfo,
-  isColumnBuilder,
-  getOperationExpr
-};
-//# sourceMappingURL=chunk-5N34PNVZ.js.map

package/dist/chunk-5N34PNVZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/utils/guards.ts"],"sourcesContent":["import type { StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { ColumnRef, LiteralExpr, OperationExpr, ParamRef } from '../ast/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\n/**\n * Recursively extracts the base ColumnRef from an OperationExpr.\n * If the expression is already a ColumnRef, it is returned directly.\n */\nexport function extractBaseColumnRef(expr: ColumnRef | OperationExpr): ColumnRef {\n  if (expr.kind === 'col') {\n    return expr;\n  }\n  return extractBaseColumnRef(expr.self);\n}\n\n/**\n * Recursively collects all ColumnRef nodes from an expression tree.\n * Handles nested OperationExpr structures by traversing both self and args.\n */\nexport function collectColumnRefs(\n  expr: ColumnRef | ParamRef | LiteralExpr | OperationExpr,\n): ColumnRef[] {\n  if (expr.kind === 'col') {\n    return [expr];\n  }\n  if (expr.kind === 'operation') {\n    const refs: ColumnRef[] = collectColumnRefs(expr.self);\n    for (const arg of expr.args) {\n      refs.push(...collectColumnRefs(arg));\n    }\n    return refs;\n  }\n  return [];\n}\n\n/**\n * Type predicate to check if an expression is an OperationExpr.\n */\nexport function isOperationExpr(expr: AnyColumnBuilder | OperationExpr): expr is OperationExpr {\n  return typeof expr === 'object' && expr !== null && 'kind' in expr && expr.kind === 'operation';\n}\n\n/**\n * Helper to extract table and column from a ColumnBuilder or OperationExpr.\n * For OperationExpr, recursively unwraps to find the base ColumnRef.\n */\nexport function getColumnInfo(expr: AnyColumnBuilder | OperationExpr): {\n  table: string;\n  column: string;\n} {\n  if (isOperationExpr(expr)) {\n    const baseCol = extractBaseColumnRef(expr);\n    return { table: baseCol.table, column: baseCol.column };\n  }\n  // expr is ColumnBuilder - TypeScript can't narrow properly\n  const colBuilder = expr as unknown as { table: string; column: string };\n  return { table: colBuilder.table, column: colBuilder.column };\n}\n\n/**\n * Type predicate to check if a value is a ColumnBuilder.\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\n/**\n * Extracts and returns an OperationExpr from a builder.\n * Returns the OperationExpr if the builder is an OperationExpr or has an _operationExpr property,\n * otherwise returns undefined.\n *\n * @design-note: This function accesses the hidden `_operationExpr` property, which is a code smell.\n * The issue is that `executeOperation()` in relational-core returns a ColumnBuilder-shaped object\n * with a hidden `_operationExpr` property, creating coupling between lanes and relational-core\n * implementation details. A cleaner design would be to have operation results be a separate\n * type (e.g., `OperationResultBuilder`) that properly represents expression nodes rather than\n * pretending to be a ColumnBuilder. This would require refactoring the operation execution\n * system in relational-core to return proper expression types.\n */\nexport function getOperationExpr(\n  builder: AnyColumnBuilder | OperationExpr,\n): OperationExpr | undefined {\n  if (isOperationExpr(builder)) {\n    return builder;\n  }\n  const builderWithExpr = builder as unknown as { _operationExpr?: OperationExpr };\n  return builderWithExpr._operationExpr;\n}\n"],"mappings":";AAUO,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;AAMO,SAAS,qBAAqB,MAA4C;AAC/E,MAAI,KAAK,SAAS,OAAO;AACvB,WAAO;AAAA,EACT;AACA,SAAO,qBAAqB,KAAK,IAAI;AACvC;AAMO,SAAS,kBACd,MACa;AACb,MAAI,KAAK,SAAS,OAAO;AACvB,WAAO,CAAC,IAAI;AAAA,EACd;AACA,MAAI,KAAK,SAAS,aAAa;AAC7B,UAAM,OAAoB,kBAAkB,KAAK,IAAI;AACrD,eAAW,OAAO,KAAK,MAAM;AAC3B,WAAK,KAAK,GAAG,kBAAkB,GAAG,CAAC;AAAA,IACrC;AACA,WAAO;AAAA,EACT;AACA,SAAO,CAAC;AACV;AAKO,SAAS,gBAAgB,MAA+D;AAC7F,SAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU,QAAQ,KAAK,SAAS;AACtF;AAMO,SAAS,cAAc,MAG5B;AACA,MAAI,gBAAgB,IAAI,GAAG;AACzB,UAAM,UAAU,qBAAqB,IAAI;AACzC,WAAO,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO;AAAA,EACxD;AAEA,QAAM,aAAa;AACnB,SAAO,EAAE,OAAO,WAAW,OAAO,QAAQ,WAAW,OAAO;AAC9D;AAKO,SAAS,gBAAgB,OAA2C;AACzE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAA4B,SAAS;AAE1C;AAeO,SAAS,iBACd,SAC2B;AAC3B,MAAI,gBAAgB,OAAO,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,QAAM,kBAAkB;AACxB,SAAO,gBAAgB;AACzB;","names":[]}

package/dist/chunk-7I3EMQID.js

@@ -1,16 +0,0 @@
-// src/param.ts
-import { planInvalid } from "@prisma-next/plan";
-function param(name) {
-  if (typeof name !== "string" || name.length === 0) {
-    throw planInvalid("Parameter name must be a non-empty string");
-  }
-  return Object.freeze({
-    kind: "param-placeholder",
-    name
-  });
-}
-
-export {
-  param
-};
-//# sourceMappingURL=chunk-7I3EMQID.js.map

package/dist/chunk-7I3EMQID.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/param.ts"],"sourcesContent":["import { planInvalid } from '@prisma-next/plan';\nimport type { ParamPlaceholder } from './types';\n\nexport type Parameter = ParamPlaceholder;\n\nexport function param(name: string): Parameter {\n  if (typeof name !== 'string' || name.length === 0) {\n    throw planInvalid('Parameter name must be a non-empty string');\n  }\n\n  return Object.freeze({\n    kind: 'param-placeholder' as const,\n    name,\n  }) satisfies Parameter;\n}\n"],"mappings":";AAAA,SAAS,mBAAmB;AAKrB,SAAS,MAAM,MAAyB;AAC7C,MAAI,OAAO,SAAS,YAAY,KAAK,WAAW,GAAG;AACjD,UAAM,YAAY,2CAA2C;AAAA,EAC/D;AAEA,SAAO,OAAO,OAAO;AAAA,IACnB,MAAM;AAAA,IACN;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/chunk-CBTYMOX2.js

@@ -1,152 +0,0 @@
-import {
-  attachOperationsToColumnBuilder
-} from "./chunk-M23L3JHG.js";
-import {
-  isColumnBuilder
-} from "./chunk-MM74SVJ4.js";
-
-// src/schema.ts
-import { planInvalid } from "@prisma-next/plan";
-var ColumnBuilderImpl = class {
-  constructor(table, column, storageColumn) {
-    this.table = table;
-    this.column = column;
-    this.storageColumn = storageColumn;
-  }
-  kind = "column";
-  get columnMeta() {
-    return this.storageColumn;
-  }
-  // Type-level helper property (not used at runtime)
-  get __jsType() {
-    return void 0;
-  }
-  createBinaryBuilder(op, value) {
-    if (value == null) {
-      throw planInvalid("Parameter placeholder or column builder required for column comparison");
-    }
-    if (value.kind === "param-placeholder" || isColumnBuilder(value)) {
-      return Object.freeze({
-        kind: "binary",
-        op,
-        left: this,
-        right: value
-      });
-    }
-    throw planInvalid("Parameter placeholder or column builder required for column comparison");
-  }
-  eq(value) {
-    return this.createBinaryBuilder("eq", value);
-  }
-  neq(value) {
-    return this.createBinaryBuilder("neq", value);
-  }
-  gt(value) {
-    return this.createBinaryBuilder("gt", value);
-  }
-  lt(value) {
-    return this.createBinaryBuilder("lt", value);
-  }
-  gte(value) {
-    return this.createBinaryBuilder("gte", value);
-  }
-  lte(value) {
-    return this.createBinaryBuilder("lte", value);
-  }
-  asc() {
-    return Object.freeze({
-      kind: "order",
-      expr: this,
-      dir: "asc"
-    });
-  }
-  desc() {
-    return Object.freeze({
-      kind: "order",
-      expr: this,
-      dir: "desc"
-    });
-  }
-};
-var TableBuilderImpl = class {
-  kind = "table";
-  columns;
-  _name;
-  constructor(name, columns) {
-    this._name = name;
-    this.columns = columns;
-  }
-  get name() {
-    return this._name;
-  }
-};
-function buildColumns(tableName, storage, _contract, operationRegistry, contractCapabilities) {
-  const table = storage.tables[tableName];
-  if (!table) {
-    throw planInvalid(`Unknown table ${tableName}`);
-  }
-  const tableColumns = table.columns;
-  const result = {};
-  const assignColumn = (columnName, columnDef) => {
-    const columnBuilder = new ColumnBuilderImpl(
-      tableName,
-      columnName,
-      columnDef
-    );
-    const builderWithOps = attachOperationsToColumnBuilder(
-      columnBuilder,
-      columnDef,
-      operationRegistry,
-      contractCapabilities
-    );
-    result[columnName] = builderWithOps;
-  };
-  for (const columnName of Object.keys(tableColumns)) {
-    const columnDef = tableColumns[columnName];
-    if (!columnDef) continue;
-    assignColumn(columnName, columnDef);
-  }
-  return result;
-}
-function createTableProxy(table) {
-  return new Proxy(table, {
-    get(target, prop) {
-      if (prop === "name" || prop === "kind" || prop === "columns") {
-        return Reflect.get(target, prop);
-      }
-      if (typeof prop === "string" && prop in target.columns) {
-        return target.columns[prop];
-      }
-      return void 0;
-    }
-  });
-}
-function schema(context) {
-  const contract = context.contract;
-  const storage = contract.storage;
-  const tables = {};
-  const contractCapabilities = contract.capabilities;
-  const operationRegistry = context.operations;
-  for (const tableName of Object.keys(storage.tables)) {
-    const columns = buildColumns(
-      tableName,
-      storage,
-      contract,
-      operationRegistry,
-      contractCapabilities
-    );
-    const table = new TableBuilderImpl(tableName, columns);
-    const proxiedTable = createTableProxy(table);
-    tables[tableName] = Object.freeze(
-      proxiedTable
-    );
-  }
-  return Object.freeze({ tables });
-}
-
-export {
-  ColumnBuilderImpl,
-  TableBuilderImpl,
-  schema
-};
-//# sourceMappingURL=chunk-CBTYMOX2.js.map

package/dist/chunk-CBTYMOX2.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/schema.ts"],"sourcesContent":["import type { OperationRegistry } from '@prisma-next/operations';\nimport { planInvalid } from '@prisma-next/plan';\nimport type {\n  ExtractCodecTypes,\n  ExtractOperationTypes,\n  SqlContract,\n  SqlStorage,\n  StorageColumn,\n} from '@prisma-next/sql-contract/types';\nimport type { BinaryOp, TableRef } from './ast/types';\nimport { attachOperationsToColumnBuilder } from './operations-registry';\nimport type { QueryLaneContext } from './query-lane-context';\nimport type {\n  AnyColumnBuilderBase,\n  BinaryBuilder,\n  CodecTypes as CodecTypesType,\n  ColumnBuilder,\n  ComputeColumnJsType,\n  OperationTypeSignature,\n  OperationTypes,\n  OrderBuilder,\n  ParamPlaceholder,\n} from './types';\nimport { isColumnBuilder } from './types';\n\ntype TableColumns<Table extends { columns: Record<string, StorageColumn> }> = Table['columns'];\n\ntype ColumnBuilders<\n  Contract extends SqlContract<SqlStorage>,\n  TableName extends string,\n  Columns extends Record<string, StorageColumn>,\n  CodecTypes extends CodecTypesType,\n  Operations extends OperationTypes,\n> = {\n  readonly [K in keyof Columns]: ColumnBuilder<\n    K & string,\n    Columns[K],\n    ComputeColumnJsType<Contract, TableName, K & string, Columns[K], CodecTypes>,\n    Operations\n  >;\n};\n\nexport class ColumnBuilderImpl<\n  ColumnName extends string,\n  ColumnMeta extends StorageColumn,\n  JsType = unknown,\n> {\n  readonly kind = 'column' as const;\n\n  constructor(\n    readonly table: string,\n    readonly column: ColumnName,\n    private readonly storageColumn: ColumnMeta,\n  ) {}\n\n  get columnMeta(): ColumnMeta {\n    return this.storageColumn;\n  }\n\n  // Type-level helper property (not used at runtime)\n  get __jsType(): JsType {\n    return undefined as unknown as JsType;\n  }\n\n  private createBinaryBuilder(\n    op: BinaryOp,\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    if (value == null) {\n      throw planInvalid('Parameter placeholder or column builder required for column comparison');\n    }\n    if (value.kind === 'param-placeholder' || isColumnBuilder(value)) {\n      return Object.freeze({\n        kind: 'binary' as const,\n        op,\n        left: this as unknown as ColumnBuilder<ColumnName, ColumnMeta, JsType>,\n        right: value,\n      }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n    }\n    throw planInvalid('Parameter placeholder or column builder required for column comparison');\n  }\n\n  eq(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('eq', value);\n  }\n\n  neq(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('neq', value);\n  }\n\n  gt(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('gt', value);\n  }\n\n  lt(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('lt', value);\n  }\n\n  gte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('gte', value);\n  }\n\n  lte(\n    value: ParamPlaceholder | AnyColumnBuilderBase,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('lte', value);\n  }\n\n  asc(): OrderBuilder<ColumnName, ColumnMeta, JsType> {\n    return Object.freeze({\n      kind: 'order' as const,\n      expr: this as unknown as ColumnBuilder<ColumnName, ColumnMeta, JsType>,\n      dir: 'asc' as const,\n    }) as OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  }\n\n  desc(): OrderBuilder<ColumnName, ColumnMeta, JsType> {\n    return Object.freeze({\n      kind: 'order' as const,\n      expr: this as unknown as ColumnBuilder<ColumnName, ColumnMeta, JsType>,\n      dir: 'desc' as const,\n    }) as OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  }\n}\n\nexport class TableBuilderImpl<\n  Contract extends SqlContract<SqlStorage>,\n  TableName extends string,\n  Columns extends Record<string, StorageColumn>,\n  CodecTypes extends CodecTypesType,\n  Operations extends OperationTypes,\n> implements TableRef\n{\n  readonly kind = 'table' as const;\n  readonly columns: ColumnBuilders<Contract, TableName, Columns, CodecTypes, Operations>;\n  private readonly _name: TableName;\n\n  constructor(\n    name: TableName,\n    columns: ColumnBuilders<Contract, TableName, Columns, CodecTypes, Operations>,\n  ) {\n    this._name = name;\n    this.columns = columns;\n  }\n\n  get name(): string {\n    return this._name;\n  }\n}\n\nfunction buildColumns<\n  Contract extends SqlContract<SqlStorage>,\n  TableName extends keyof Contract['storage']['tables'] & string,\n  CodecTypes extends CodecTypesType,\n  Operations extends OperationTypes,\n>(\n  tableName: TableName,\n  storage: SqlStorage,\n  _contract: Contract,\n  operationRegistry?: OperationRegistry,\n  contractCapabilities?: Record<string, Record<string, boolean>>,\n): ColumnBuilders<\n  Contract,\n  TableName,\n  Contract['storage']['tables'][TableName]['columns'],\n  CodecTypes,\n  Operations\n> {\n  const table = storage.tables[tableName];\n\n  if (!table) {\n    throw planInvalid(`Unknown table ${tableName}`);\n  }\n\n  type Columns = Contract['storage']['tables'][TableName]['columns'];\n  const tableColumns = table.columns as Columns;\n\n  const result = {} as {\n    [K in keyof Columns]: ColumnBuilder<\n      K & string,\n      Columns[K],\n      ComputeColumnJsType<Contract, TableName, K & string, Columns[K], CodecTypes>,\n      Operations\n    >;\n  };\n\n  const assignColumn = <ColumnKey extends keyof Columns & string>(\n    columnName: ColumnKey,\n    columnDef: Columns[ColumnKey],\n  ) => {\n    type JsType = ComputeColumnJsType<\n      Contract,\n      TableName,\n      ColumnKey,\n      Columns[ColumnKey],\n      CodecTypes\n    >;\n\n    const columnBuilder = new ColumnBuilderImpl<ColumnKey, Columns[ColumnKey], JsType>(\n      tableName,\n      columnName,\n      columnDef,\n    );\n\n    const builderWithOps = attachOperationsToColumnBuilder<\n      ColumnKey,\n      Columns[ColumnKey],\n      JsType,\n      Operations\n    >(\n      columnBuilder as unknown as ColumnBuilder<\n        ColumnKey,\n        Columns[ColumnKey],\n        JsType,\n        Record<string, never>\n      >,\n      columnDef,\n      operationRegistry,\n      contractCapabilities,\n    );\n\n    (result as Record<string, unknown>)[columnName] = builderWithOps;\n  };\n\n  for (const columnName of Object.keys(tableColumns) as Array<keyof Columns & string>) {\n    const columnDef = tableColumns[columnName];\n    if (!columnDef) continue;\n    assignColumn(columnName, columnDef);\n  }\n\n  return result as ColumnBuilders<Contract, TableName, Columns, CodecTypes, Operations>;\n}\n\n/**\n * Creates a Proxy that enables accessing table columns directly on the table object,\n * in addition to the standard `table.columns.columnName` syntax.\n *\n * This allows both access patterns:\n * - `tables.user.columns.id` (standard access)\n * - `tables.user.id` (convenience access via proxy)\n *\n * The proxy intercepts property access and routes column name lookups to\n * `table.columns[prop]`, while preserving direct access to table properties\n * like `name`, `kind`, and `columns`.\n */\nfunction createTableProxy<\n  Contract extends SqlContract<SqlStorage>,\n  TableName extends string,\n  Columns extends Record<string, StorageColumn>,\n  CodecTypes extends CodecTypesType,\n  Operations extends OperationTypes,\n>(\n  table: TableBuilderImpl<Contract, TableName, Columns, CodecTypes, Operations>,\n): TableBuilderImpl<Contract, TableName, Columns, CodecTypes, Operations> {\n  return new Proxy(table, {\n    get(target, prop) {\n      if (prop === 'name' || prop === 'kind' || prop === 'columns') {\n        return Reflect.get(target, prop);\n      }\n      if (typeof prop === 'string' && prop in target.columns) {\n        return target.columns[prop as keyof typeof target.columns];\n      }\n      return undefined;\n    },\n  });\n}\n\ntype ExtractSchemaTables<\n  Contract extends SqlContract<SqlStorage>,\n  CodecTypes extends CodecTypesType,\n  Operations extends OperationTypes,\n> = {\n  readonly [TableName in keyof Contract['storage']['tables']]: TableBuilderImpl<\n    Contract,\n    TableName & string,\n    TableColumns<Contract['storage']['tables'][TableName]>,\n    CodecTypes,\n    Operations\n  > &\n    TableRef;\n};\n\nexport type SchemaHandle<\n  Contract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>,\n  CodecTypes extends CodecTypesType = CodecTypesType,\n  Operations extends OperationTypes = Record<string, never>,\n> = {\n  readonly tables: ExtractSchemaTables<Contract, CodecTypes, Operations>;\n};\n\ntype SchemaReturnType<Contract extends SqlContract<SqlStorage>> = SchemaHandle<\n  Contract,\n  ExtractCodecTypes<Contract>,\n  ToOperationTypes<ExtractOperationTypes<Contract>>\n>;\n\ntype NormalizeOperationTypes<T> = {\n  [TypeId in keyof T]: {\n    [Method in keyof T[TypeId]]: T[TypeId][Method] extends OperationTypeSignature\n      ? T[TypeId][Method]\n      : OperationTypeSignature;\n  };\n};\n\ntype ToOperationTypes<T> = T extends OperationTypes ? T : NormalizeOperationTypes<T>;\n\n/**\n * Creates a schema handle for building SQL queries.\n *\n * @param context - Query lane context containing contract, codec and operation registries\n * @returns A schema handle with typed table builders\n *\n * @example\n * ```typescript\n * const schemaHandle = schema<Contract>(context);\n * const userTable = schemaHandle.tables.user;\n * ```\n */\nexport function schema<Contract extends SqlContract<SqlStorage>>(\n  context: QueryLaneContext<Contract>,\n): SchemaReturnType<Contract> {\n  const contract = context.contract;\n  const storage = contract.storage;\n  type CodecTypes = ExtractCodecTypes<Contract>;\n  type Operations = ToOperationTypes<ExtractOperationTypes<Contract>>;\n  const tables = {} as ExtractSchemaTables<Contract, CodecTypes, Operations>;\n  const contractCapabilities = contract.capabilities;\n\n  const operationRegistry = context.operations;\n\n  for (const tableName of Object.keys(storage.tables) as Array<\n    keyof Contract['storage']['tables'] & string\n  >) {\n    const columns = buildColumns<Contract, typeof tableName, CodecTypes, Operations>(\n      tableName,\n      storage,\n      contract,\n      operationRegistry,\n      contractCapabilities,\n    );\n    const table = new TableBuilderImpl<\n      Contract,\n      typeof tableName & string,\n      Contract['storage']['tables'][typeof tableName]['columns'],\n      CodecTypes,\n      Operations\n    >(tableName, columns);\n    const proxiedTable = createTableProxy<\n      Contract,\n      typeof tableName & string,\n      Contract['storage']['tables'][typeof tableName]['columns'],\n      CodecTypes,\n      Operations\n    >(table);\n    (tables as Record<string, unknown>)[tableName] = Object.freeze(\n      proxiedTable,\n    ) as ExtractSchemaTables<Contract, CodecTypes, Operations>[typeof tableName];\n  }\n\n  return Object.freeze({ tables }) as SchemaReturnType<Contract>;\n}\n\nexport type { ColumnBuilderImpl as Column, TableBuilderImpl as Table };\n"],"mappings":"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","names":[]}

package/dist/chunk-G52ENULI.js

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-G52ENULI.js.map

package/dist/chunk-G52ENULI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-KYSP7L5C.js

@@ -1,16 +0,0 @@
-// src/plan.ts
-function augmentDescriptorWithColumnMeta(descriptors, columnMeta) {
-  const descriptor = descriptors[descriptors.length - 1];
-  if (descriptor && columnMeta) {
-    descriptors[descriptors.length - 1] = {
-      ...descriptor,
-      codecId: columnMeta.codecId,
-      nativeType: columnMeta.nativeType
-    };
-  }
-}
-
-export {
-  augmentDescriptorWithColumnMeta
-};
-//# sourceMappingURL=chunk-KYSP7L5C.js.map

package/dist/chunk-KYSP7L5C.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/plan.ts"],"sourcesContent":["import type { ExecutionPlan, ParamDescriptor } from '@prisma-next/contract/types';\nimport type { StorageColumn } from '@prisma-next/sql-contract/types';\nimport type { QueryAst } from './ast/types';\n\n/**\n * SQL query plan produced by lanes before lowering.\n *\n * Lanes build ASTs and metadata but do not perform SQL lowering.\n * The `sql` field is absent - lowering happens in the runtime executor.\n *\n * Structurally aligns with ExecutionPlan<Row, QueryAst> (without sql field) to maintain\n * compatibility with ExecutionPlan/Plan-based utilities.\n * The generic parameter `_Row` is preserved for type extraction via ResultType.\n */\nexport interface SqlQueryPlan<_Row = unknown>\n  extends Pick<ExecutionPlan<_Row, QueryAst>, 'params' | 'meta'> {\n  readonly ast: QueryAst;\n  // Phantom property to preserve generic parameter for type extraction\n  // This allows ResultType to extract _Row for SqlQueryPlan values.\n  readonly _Row?: _Row;\n}\n\n/**\n * Augments the last ParamDescriptor in the array with codecId and nativeType from columnMeta.\n * This is used when building WHERE expressions to ensure param descriptors have type information.\n */\nexport function augmentDescriptorWithColumnMeta(\n  descriptors: ParamDescriptor[],\n  columnMeta: StorageColumn | undefined,\n): void {\n  const descriptor = descriptors[descriptors.length - 1];\n  if (descriptor && columnMeta) {\n    descriptors[descriptors.length - 1] = {\n      ...descriptor,\n      codecId: columnMeta.codecId,\n      nativeType: columnMeta.nativeType,\n    };\n  }\n}\n"],"mappings":";AA0BO,SAAS,gCACd,aACA,YACM;AACN,QAAM,aAAa,YAAY,YAAY,SAAS,CAAC;AACrD,MAAI,cAAc,YAAY;AAC5B,gBAAY,YAAY,SAAS,CAAC,IAAI;AAAA,MACpC,GAAG;AAAA,MACH,SAAS,WAAW;AAAA,MACpB,YAAY,WAAW;AAAA,IACzB;AAAA,EACF;AACF;","names":[]}