@prisma-next/sql-relational-core 0.3.0-pr.93.5 → 0.3.0-pr.94.2

package/src/types.ts

@@ -10,6 +10,8 @@ import type {
   BinaryOp,
   ColumnRef,
   Direction,
+  Expression,
+  ExpressionSource,
   OperationExpr,
   ParamRef,
   QueryAst,
@@ -22,13 +24,21 @@ export interface ParamPlaceholder {
   readonly name: string;
 }
 
+/**
+ * ValueSource represents any value that can appear in a comparison or as an argument.
+ * This includes:
+ * - ParamPlaceholder: A parameter placeholder (e.g., `param('userId')`)
+ * - ExpressionSource: Something that can be converted to an Expression (ColumnBuilder, ExpressionBuilder)
+ */
+export type ValueSource = ParamPlaceholder | ExpressionSource;
+
 export interface OrderBuilder<
-  ColumnName extends string = string,
-  ColumnMeta extends StorageColumn = StorageColumn,
-  JsType = unknown,
+  _ColumnName extends string = string,
+  _ColumnMeta extends StorageColumn = StorageColumn,
+  _JsType = unknown,
 > {
   readonly kind: 'order';
-  readonly expr: ColumnBuilder<ColumnName, ColumnMeta, JsType> | OperationExpr;
+  readonly expr: Expression;
   readonly dir: Direction;
 }
 
@@ -45,6 +55,7 @@ export function createOrderBuilder(
 /**
  * ColumnBuilder with optional operation methods based on the column's typeId.
  * When Operations is provided and the column's typeId matches, operation methods are included.
+ * Implements ExpressionSource to provide type-safe conversion to ColumnRef.
  */
 export type ColumnBuilder<
   ColumnName extends string = string,
@@ -56,20 +67,17 @@ export type ColumnBuilder<
   readonly table: string;
   readonly column: ColumnName;
   readonly columnMeta: ColumnMeta;
-  eq(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
-  neq(
-    value: ParamPlaceholder | AnyColumnBuilderBase,
-  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
-  gt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
-  lt(value: ParamPlaceholder | AnyColumnBuilderBase): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
-  gte(
-    value: ParamPlaceholder | AnyColumnBuilderBase,
-  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
-  lte(
-    value: ParamPlaceholder | AnyColumnBuilderBase,
-  ): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  // Methods accept ValueSource (ParamPlaceholder or ExpressionSource)
+  eq(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  neq(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  gt(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  lt(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  gte(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  lte(value: ValueSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
   asc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;
   desc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;
+  /** Converts this column builder to a ColumnRef expression */
+  toExpr(): ColumnRef;
   // Helper property for type extraction (not used at runtime)
   readonly __jsType: JsType;
 } & (ColumnMeta['codecId'] extends string
@@ -84,14 +92,47 @@ export type ColumnBuilder<
   : Record<string, never>);
 
 export interface BinaryBuilder<
-  ColumnName extends string = string,
-  ColumnMeta extends StorageColumn = StorageColumn,
-  JsType = unknown,
+  _ColumnName extends string = string,
+  _ColumnMeta extends StorageColumn = StorageColumn,
+  _JsType = unknown,
 > {
   readonly kind: 'binary';
   readonly op: BinaryOp;
-  readonly left: ColumnBuilder<ColumnName, ColumnMeta, JsType> | OperationExpr;
-  readonly right: ParamPlaceholder | AnyColumnBuilderBase;
+  readonly left: Expression;
+  readonly right: ValueSource;
+}
+
+// Forward declare AnyBinaryBuilder and AnyOrderBuilder for use in ExpressionBuilder
+export type AnyBinaryBuilder = BinaryBuilder;
+export type AnyOrderBuilder = OrderBuilder;
+
+/**
+ * ExpressionBuilder represents the result of an operation (e.g., col.distance(...)).
+ * Unlike ColumnBuilder (which represents a column), ExpressionBuilder represents
+ * an operation expression and provides the same DSL methods for chaining.
+ *
+ * Implements ExpressionSource to provide type-safe conversion to OperationExpr.
+ */
+export interface ExpressionBuilder<JsType = unknown> extends ExpressionSource {
+  readonly kind: 'expression';
+  readonly expr: OperationExpr;
+  readonly columnMeta: StorageColumn;
+
+  // Methods accept ValueSource (ParamPlaceholder or ExpressionSource)
+  eq(value: ValueSource): AnyBinaryBuilder;
+  neq(value: ValueSource): AnyBinaryBuilder;
+  gt(value: ValueSource): AnyBinaryBuilder;
+  lt(value: ValueSource): AnyBinaryBuilder;
+  gte(value: ValueSource): AnyBinaryBuilder;
+  lte(value: ValueSource): AnyBinaryBuilder;
+  asc(): AnyOrderBuilder;
+  desc(): AnyOrderBuilder;
+
+  /** Converts this expression builder to the underlying OperationExpr */
+  toExpr(): OperationExpr;
+
+  // Helper property for type extraction (not used at runtime)
+  readonly __jsType: JsType;
 }
 
 // Helper aliases for usage sites where the specific column parameters are irrelevant
@@ -108,14 +149,16 @@ export type AnyColumnBuilderBase = {
   readonly table: string;
   readonly column: string;
   readonly columnMeta: StorageColumn;
-  eq(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
-  neq(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
-  gt(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
-  lt(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
-  gte(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
-  lte(value: ParamPlaceholder | AnyColumnBuilderBase): AnyBinaryBuilder;
+  // Methods accept ValueSource (ParamPlaceholder or ExpressionSource)
+  eq(value: ValueSource): AnyBinaryBuilder;
+  neq(value: ValueSource): AnyBinaryBuilder;
+  gt(value: ValueSource): AnyBinaryBuilder;
+  lt(value: ValueSource): AnyBinaryBuilder;
+  gte(value: ValueSource): AnyBinaryBuilder;
+  lte(value: ValueSource): AnyBinaryBuilder;
   asc(): AnyOrderBuilder;
   desc(): AnyOrderBuilder;
+  toExpr(): ColumnRef;
   readonly __jsType: unknown;
   // Allow any operation methods (from conditional type)
   readonly [key: string]: unknown;
@@ -130,8 +173,12 @@ export type AnyColumnBuilder =
       any
     >
   | AnyColumnBuilderBase;
-export type AnyBinaryBuilder = BinaryBuilder<string, StorageColumn, unknown>;
-export type AnyOrderBuilder = OrderBuilder<string, StorageColumn, unknown>;
+
+/**
+ * Union type for any builder that can produce an Expression.
+ * Used in DSL method signatures where either a column or operation result can be passed.
+ */
+export type AnyExpressionSource = AnyColumnBuilder | ExpressionBuilder;
 
 export function isColumnBuilder(value: unknown): value is AnyColumnBuilder {
   return (
@@ -264,7 +311,7 @@ type OperationArgs<Args extends ReadonlyArray<ArgSpec>> = Args extends readonly
   : [];
 
 type ArgToType<Arg extends ArgSpec> = Arg extends { kind: 'typeId' }
-  ? AnyColumnBuilder
+  ? AnyExpressionSource
   : Arg extends { kind: 'param' }
     ? ParamPlaceholder
     : Arg extends { kind: 'literal' }
@@ -273,25 +320,25 @@ type ArgToType<Arg extends ArgSpec> = Arg extends { kind: 'typeId' }
 
 /**
  * Maps operation return spec to return type.
- * - builtin types: ColumnBuilder with appropriate JsType (matches runtime behavior)
- * - typeId types: ColumnBuilder (for now, could be more specific in future)
+ * Operations return ExpressionBuilder, not ColumnBuilder, because the result
+ * represents an expression (OperationExpr) rather than a column reference.
  */
 type OperationReturn<
   Returns extends ReturnSpec,
-  ColumnName extends string,
-  ColumnMeta extends StorageColumn,
+  _ColumnName extends string,
+  _ColumnMeta extends StorageColumn,
   _JsType,
 > = Returns extends { kind: 'builtin'; type: infer T }
   ? T extends 'number'
-    ? ColumnBuilder<ColumnName, ColumnMeta, number>
+    ? ExpressionBuilder<number>
     : T extends 'boolean'
-      ? ColumnBuilder<ColumnName, ColumnMeta, boolean>
+      ? ExpressionBuilder<boolean>
       : T extends 'string'
-        ? ColumnBuilder<ColumnName, ColumnMeta, string>
-        : ColumnBuilder<ColumnName, ColumnMeta, unknown>
+        ? ExpressionBuilder<string>
+        : ExpressionBuilder<unknown>
   : Returns extends { kind: 'typeId' }
-    ? AnyColumnBuilder
-    : ColumnBuilder<ColumnName, ColumnMeta, unknown>;
+    ? ExpressionBuilder<unknown>
+    : ExpressionBuilder<unknown>;
 
 /**
  * Computes JavaScript type for a column at column creation time.
@@ -351,17 +398,18 @@ export type InferProjectionRow<P extends Record<string, AnyColumnBuilder>> = {
 };
 
 /**
- * Nested projection type - allows recursive nesting of ColumnBuilder or nested objects.
+ * Nested projection type - allows recursive nesting of ColumnBuilder, ExpressionBuilder, or nested objects.
  */
 export type NestedProjection = Record<
   string,
-  | AnyColumnBuilder
+  | AnyExpressionSource
   | Record<
       string,
-      | AnyColumnBuilder
+      | AnyExpressionSource
       | Record<
           string,
-          AnyColumnBuilder | Record<string, AnyColumnBuilder | Record<string, AnyColumnBuilder>>
+          | AnyExpressionSource
+          | Record<string, AnyExpressionSource | Record<string, AnyExpressionSource>>
         >
     >
 >;
@@ -384,17 +432,19 @@ type ExtractIncludeType<
  * by looking up the include alias in the Includes type map.
  */
 export type InferNestedProjectionRow<
-  P extends Record<string, AnyColumnBuilder | boolean | NestedProjection>,
+  P extends Record<string, AnyExpressionSource | boolean | NestedProjection>,
   CodecTypes extends Record<string, { readonly output: unknown }> = Record<string, never>,
   Includes extends Record<string, unknown> = Record<string, never>,
 > = {
-  [K in keyof P]: P[K] extends AnyColumnBuilder
-    ? ExtractJsTypeFromColumnBuilder<P[K]>
-    : P[K] extends true
-      ? Array<ExtractIncludeType<K & string, Includes>> // Include reference - infers Array<ChildShape> from Includes map
-      : P[K] extends NestedProjection
-        ? InferNestedProjectionRow<P[K], CodecTypes, Includes>
-        : never;
+  [K in keyof P]: P[K] extends ExpressionBuilder<infer JsType>
+    ? JsType
+    : P[K] extends AnyColumnBuilder
+      ? ExtractJsTypeFromColumnBuilder<P[K]>
+      : P[K] extends true
+        ? Array<ExtractIncludeType<K & string, Includes>> // Include reference - infers Array<ChildShape> from Includes map
+        : P[K] extends NestedProjection
+          ? InferNestedProjectionRow<P[K], CodecTypes, Includes>
+          : never;
 };
 
 /**

package/src/utils/guards.ts

@@ -1,16 +1,27 @@
 import type { StorageColumn } from '@prisma-next/sql-contract/types';
-import type { ColumnRef, LiteralExpr, OperationExpr, ParamRef } from '../ast/types';
-import type { AnyColumnBuilder, ParamPlaceholder } from '../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.
+ * Helper to extract columnMeta from a ColumnBuilder or ExpressionBuilder.
  * Returns StorageColumn if present, undefined otherwise.
- * AnyColumnBuilder is a union that includes types with columnMeta property,
- * so we can safely access it after checking for existence.
+ * Both ColumnBuilder and ExpressionBuilder have columnMeta property.
  */
-export function getColumnMeta(expr: AnyColumnBuilder): StorageColumn | undefined {
-  // AnyColumnBuilder includes AnyColumnBuilderBase which has columnMeta: StorageColumn
-  // and ColumnBuilder which has columnMeta: ColumnMeta extends StorageColumn
+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;
@@ -66,15 +77,17 @@ export function collectColumnRefs(
 /**
  * Type predicate to check if an expression is an OperationExpr.
  */
-export function isOperationExpr(expr: AnyColumnBuilder | OperationExpr): expr is 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 or OperationExpr.
- * For OperationExpr, recursively unwraps to find the base ColumnRef.
+ * 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: AnyColumnBuilder | OperationExpr): {
+export function getColumnInfo(expr: AnyExpressionSource | OperationExpr): {
   table: string;
   column: string;
 } {
@@ -82,6 +95,10 @@ export function getColumnInfo(expr: AnyColumnBuilder | OperationExpr): {
     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 };
@@ -99,18 +116,71 @@ export function isColumnBuilder(value: unknown): value is AnyColumnBuilder {
   );
 }
 
+/**
+ * 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 issue is that `executeOperation()` in relational-core returns a ColumnBuilder-shaped object
- * with a hidden `_operationExpr` property, creating coupling between lanes and relational-core
- * implementation details. A cleaner design would be to have operation results be a separate
- * type (e.g., `OperationResultBuilder`) that properly represents expression nodes rather than
- * pretending to be a ColumnBuilder. This would require refactoring the operation execution
- * system in relational-core to return proper expression types.
+ * 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,

package/dist/ast/adapter-types.d.ts

@@ -1,28 +0,0 @@
-import type { CodecRegistry } from './codec-types';
-export type AdapterTarget = string;
-export interface AdapterProfile<TTarget extends AdapterTarget = AdapterTarget> {
-    readonly id: string;
-    readonly target: TTarget;
-    readonly capabilities: Record<string, unknown>;
-    /**
-     * Returns the adapter's default codec registry.
-     * The registry contains codecs provided by the adapter for converting
-     * between wire types and JavaScript types.
-     */
-    codecs(): CodecRegistry;
-}
-export interface LoweredPayload<TBody = unknown> {
-    readonly profileId?: string;
-    readonly body: TBody;
-    readonly annotations?: Record<string, unknown>;
-}
-export interface LowererContext<TContract = unknown> {
-    readonly contract: TContract;
-    readonly params?: readonly unknown[];
-}
-export type Lowerer<Ast = unknown, TContract = unknown, TBody = unknown> = (ast: Ast, context: LowererContext<TContract>) => LoweredPayload<TBody>;
-export interface Adapter<Ast = unknown, TContract = unknown, TBody = unknown> {
-    readonly profile: AdapterProfile;
-    lower(ast: Ast, context: LowererContext<TContract>): LoweredPayload<TBody>;
-}
-//# sourceMappingURL=adapter-types.d.ts.map

package/dist/ast/adapter-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter-types.d.ts","sourceRoot":"","sources":["../../src/ast/adapter-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa;IAC3E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C;;;;OAIG;IACH,MAAM,IAAI,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,OAAO;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,cAAc,CAAC,SAAS,GAAG,OAAO;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,MAAM,OAAO,CAAC,GAAG,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,IAAI,CACzE,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,KAC/B,cAAc,CAAC,KAAK,CAAC,CAAC;AAE3B,MAAM,WAAW,OAAO,CAAC,GAAG,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO;IAC1E,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,KAAK,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;CAC5E"}

package/dist/ast/codec-types.d.ts

@@ -1,141 +0,0 @@
-import type { O } from 'ts-toolbelt';
-/**
- * Codec metadata for database-specific type information.
- * Used for schema introspection and verification.
- */
-export interface CodecMeta {
-    readonly db?: {
-        readonly sql?: {
-            readonly postgres?: {
-                readonly nativeType: string;
-            };
-        };
-    };
-}
-/**
- * Codec interface for encoding/decoding values between wire format and JavaScript types.
- *
- * Codecs are pure, synchronous functions with no side effects or IO.
- * They provide deterministic conversion between database wire types and JS values.
- */
-export interface Codec<Id extends string = string, TWire = unknown, TJs = unknown> {
-    /**
-     * Namespaced codec identifier in format 'namespace/name@version'
-     * Examples: 'pg/text@1', 'pg/uuid@1', 'pg/timestamptz@1'
-     */
-    readonly id: Id;
-    /**
-     * Contract scalar type IDs that this codec can handle.
-     * Examples: ['text'], ['int4', 'float8'], ['timestamp', 'timestamptz']
-     */
-    readonly targetTypes: readonly string[];
-    /**
-     * Optional metadata for database-specific type information.
-     * Used for schema introspection and verification.
-     */
-    readonly meta?: CodecMeta;
-    /**
-     * Decode a wire value (from database) to JavaScript type.
-     * Must be synchronous and pure (no side effects).
-     */
-    decode(wire: TWire): TJs;
-    /**
-     * Encode a JavaScript value to wire format (for database).
-     * Optional - if not provided, values pass through unchanged.
-     * Must be synchronous and pure (no side effects).
-     */
-    encode?(value: TJs): TWire;
-}
-/**
- * Registry interface for codecs organized by ID and by contract scalar type.
- *
- * The registry allows looking up codecs by their namespaced ID or by the
- * contract scalar types they handle. Multiple codecs may handle the same
- * scalar type; ordering in byScalar reflects preference (adapter first,
- * then packs, then app overrides).
- */
-export interface CodecRegistry {
-    get(id: string): Codec<string> | undefined;
-    has(id: string): boolean;
-    getByScalar(scalar: string): readonly Codec<string>[];
-    getDefaultCodec(scalar: string): Codec<string> | undefined;
-    register(codec: Codec<string>): void;
-    [Symbol.iterator](): Iterator<Codec<string>>;
-    values(): IterableIterator<Codec<string>>;
-}
-/**
- * Codec factory - creates a codec with typeId and encode/decode functions.
- */
-export declare function codec<Id extends string, TWire, TJs>(config: {
-    typeId: Id;
-    targetTypes: readonly string[];
-    encode: (value: TJs) => TWire;
-    decode: (wire: TWire) => TJs;
-    meta?: CodecMeta;
-}): Codec<Id, TWire, TJs>;
-/**
- * Type helpers to extract codec types.
- */
-export type CodecId<T> = T extends Codec<infer Id, unknown, unknown> ? Id : T extends {
-    readonly id: infer Id;
-} ? Id : never;
-export type CodecInput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;
-export type CodecOutput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;
-/**
- * Type helper to extract codec types from builder instance.
- */
-export type ExtractCodecTypes<ScalarNames extends {
-    readonly [K in keyof ScalarNames]: Codec<string>;
-} = Record<never, never>> = {
-    readonly [K in keyof ScalarNames as ScalarNames[K] extends Codec<infer Id, unknown, unknown> ? Id : never]: {
-        readonly input: CodecInput<ScalarNames[K]>;
-        readonly output: CodecOutput<ScalarNames[K]>;
-    };
-};
-/**
- * Type helper to extract data type IDs from builder instance.
- * Uses ExtractCodecTypes which preserves literal types as keys.
- * Since ExtractCodecTypes<Record<K, ScalarNames[K]>> has exactly one key (the Id),
- * we extract it by creating a mapped type that uses the Id as both key and value,
- * then extract the value type. This preserves literal types.
- */
-export type ExtractDataTypes<ScalarNames extends {
-    readonly [K in keyof ScalarNames]: Codec<string>;
-}> = {
-    readonly [K in keyof ScalarNames]: {
-        readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;
-    }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];
-};
-/**
- * Builder interface for declaring codecs.
- */
-export interface CodecDefBuilder<ScalarNames extends {
-    readonly [K in keyof ScalarNames]: Codec<string>;
-} = Record<never, never>> {
-    readonly CodecTypes: ExtractCodecTypes<ScalarNames>;
-    add<ScalarName extends string, CodecImpl extends Codec<string>>(scalarName: ScalarName, codecImpl: CodecImpl): CodecDefBuilder<O.Overwrite<ScalarNames, Record<ScalarName, CodecImpl>> & Record<ScalarName, CodecImpl>>;
-    readonly codecDefinitions: {
-        readonly [K in keyof ScalarNames]: {
-            readonly typeId: ScalarNames[K] extends Codec<infer Id extends string, unknown, unknown> ? Id : never;
-            readonly scalar: K;
-            readonly codec: ScalarNames[K];
-            readonly input: CodecInput<ScalarNames[K]>;
-            readonly output: CodecOutput<ScalarNames[K]>;
-            readonly jsType: CodecOutput<ScalarNames[K]>;
-        };
-    };
-    readonly dataTypes: {
-        readonly [K in keyof ScalarNames]: {
-            readonly [Id in keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>]: Id;
-        }[keyof ExtractCodecTypes<Record<K, ScalarNames[K]>>];
-    };
-}
-/**
- * Create a new codec registry.
- */
-export declare function createCodecRegistry(): CodecRegistry;
-/**
- * Create a new codec definition builder.
- */
-export declare function defineCodecs(): CodecDefBuilder<Record<never, never>>;
-//# sourceMappingURL=codec-types.d.ts.map

package/dist/ast/codec-types.d.ts.map

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

package/dist/ast/common.d.ts

@@ -1,7 +0,0 @@
-import type { ColumnRef, LiteralExpr, OperationExpr, ParamRef, TableRef } from './types';
-export declare function createTableRef(name: string): TableRef;
-export declare function createColumnRef(table: string, column: string): ColumnRef;
-export declare function createParamRef(index: number, name?: string): ParamRef;
-export declare function createOperationExpr(operation: OperationExpr): OperationExpr;
-export declare function createLiteralExpr(value: unknown): LiteralExpr;
-//# sourceMappingURL=common.d.ts.map

package/dist/ast/common.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/ast/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAKrD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAMxE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAMrE;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,CAE3E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAK7D"}

package/dist/ast/delete.d.ts

@@ -1,8 +0,0 @@
-import type { BinaryExpr, ColumnRef, DeleteAst, TableRef } from './types';
-export interface CreateDeleteAstOptions {
-    readonly table: TableRef;
-    readonly where: BinaryExpr;
-    readonly returning?: ReadonlyArray<ColumnRef>;
-}
-export declare function createDeleteAst(options: CreateDeleteAstOptions): DeleteAst;
-//# sourceMappingURL=delete.d.ts.map

package/dist/ast/delete.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/ast/delete.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG1E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC/C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAO1E"}

package/dist/ast/driver-types.d.ts

@@ -1,20 +0,0 @@
-export interface SqlExecuteRequest {
-    readonly sql: string;
-    readonly params?: readonly unknown[];
-}
-export interface SqlQueryResult<Row = Record<string, unknown>> {
-    readonly rows: ReadonlyArray<Row>;
-    readonly rowCount?: number | null;
-    readonly [key: string]: unknown;
-}
-export interface SqlExplainResult<Row = Record<string, unknown>> {
-    readonly rows: ReadonlyArray<Row>;
-}
-export interface SqlDriver {
-    connect(): Promise<void>;
-    execute<Row = Record<string, unknown>>(request: SqlExecuteRequest): AsyncIterable<Row>;
-    explain?(request: SqlExecuteRequest): Promise<SqlExplainResult>;
-    query<Row = Record<string, unknown>>(sql: string, params?: readonly unknown[]): Promise<SqlQueryResult<Row>>;
-    close(): Promise<void>;
-}
-//# sourceMappingURL=driver-types.d.ts.map

package/dist/ast/driver-types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver-types.d.ts","sourceRoot":"","sources":["../../src/ast/driver-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACvF,OAAO,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChE,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAC1B,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/ast/insert.d.ts

@@ -1,8 +0,0 @@
-import type { ColumnRef, InsertAst, ParamRef, TableRef } from './types';
-export interface CreateInsertAstOptions {
-    readonly table: TableRef;
-    readonly values: Record<string, ColumnRef | ParamRef>;
-    readonly returning?: ReadonlyArray<ColumnRef>;
-}
-export declare function createInsertAst(options: CreateInsertAstOptions): InsertAst;
-//# sourceMappingURL=insert.d.ts.map

package/dist/ast/insert.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"insert.d.ts","sourceRoot":"","sources":["../../src/ast/insert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGxE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CAC/C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAO1E"}