@prisma-next/sql-relational-core 0.3.0-dev.5 → 0.3.0-dev.51

package/dist/query-lane-context-CgkPuKaR.d.mts

@@ -0,0 +1,259 @@
+import { Type } from "arktype";
+import { OperationRegistry } from "@prisma-next/operations";
+import { O } from "ts-toolbelt";
+import { SqlContract, SqlStorage } from "@prisma-next/sql-contract/types";
+
+//#region src/ast/codec-types.d.ts
+
+/**
+ * Descriptor for parameterized codecs that require type parameter validation.
+ * Shared between adapter (compile-time) and runtime layers to avoid duplication.
+ *
+ * @template TParams - The shape of the type parameters (e.g., `{ length: number }`)
+ * @template THelper - The type returned by the optional `init` hook
+ */
+interface CodecParamsDescriptor<TParams = Record<string, unknown>, THelper = unknown> {
+  /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */
+  readonly codecId: string;
+  /**
+   * Arktype schema for validating typeParams.
+   * Used to validate both storage.types entries and inline column typeParams.
+   */
+  readonly paramsSchema: Type<TParams>;
+  /**
+   * Optional init hook called during runtime context creation.
+   * Receives validated params and returns a helper object to be stored in context.types.
+   * If not provided, the validated params are stored directly.
+   */
+  readonly init?: (params: TParams) => THelper;
+}
+/**
+ * Codec metadata for database-specific type information.
+ * Used for schema introspection and verification.
+ */
+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.
+ */
+interface Codec<Id$1 extends string = string, TWire = unknown, TJs = unknown, TParams = Record<string, unknown>, THelper = unknown> {
+  /**
+   * Namespaced codec identifier in format 'namespace/name@version'
+   * Examples: 'pg/text@1', 'pg/uuid@1', 'pg/timestamptz@1'
+   */
+  readonly id: Id$1;
+  /**
+   * 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;
+  /**
+   * Optional params schema for parameterized codecs.
+   * If provided, typeParams are validated against this schema.
+   */
+  readonly paramsSchema?: Type<TParams>;
+  /**
+   * Optional init hook for building runtime helper state from validated params.
+   *
+   * Useful when parameterized types need derived data at runtime, for example:
+   * - normalize typeParams into a stable helper shape consumed by lanes/adapters
+   * - precompute reusable values once during context creation
+   * - avoid repeating typeParams parsing logic during query execution
+   *
+   * Example:
+   *   { length: 255 } -> { kind: 'variable', maxLength: 255 }
+   *
+   * **Convention for JSON/JSONB codecs**: When the helper includes a `validate`
+   * property of type `JsonSchemaValidateFn`, the runtime will use it to enforce
+   * JSON Schema conformance during encoding and decoding. The property is
+   * discovered via duck typing (`helper?.validate`) for flexibility across
+   * different codec types.
+   */
+  readonly init?: (params: TParams) => THelper;
+  /**
+   * 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).
+ */
+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.
+ */
+declare function codec<Id$1 extends string, TWire, TJs, TParams = Record<string, unknown>, THelper = unknown>(config: {
+  typeId: Id$1;
+  targetTypes: readonly string[];
+  encode: (value: TJs) => TWire;
+  decode: (wire: TWire) => TJs;
+  meta?: CodecMeta;
+  paramsSchema?: Type<TParams>;
+  init?: (params: TParams) => THelper;
+}): Codec<Id$1, TWire, TJs, TParams, THelper>;
+/**
+ * Type helpers to extract codec types.
+ */
+type CodecId<T> = T extends Codec<infer Id, unknown, unknown> ? Id : T extends {
+  readonly id: infer Id;
+} ? Id : never;
+type CodecInput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;
+type CodecOutput<T> = T extends Codec<string, unknown, infer JsT> ? JsT : never;
+/**
+ * Type helper to extract codec types from builder instance.
+ */
+type ExtractCodecTypes$1<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.
+ */
+type ExtractDataTypes<ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> }> = { readonly [K in keyof ScalarNames]: { readonly [Id in keyof ExtractCodecTypes$1<Record<K, ScalarNames[K]>>]: Id }[keyof ExtractCodecTypes$1<Record<K, ScalarNames[K]>>] };
+/**
+ * Builder interface for declaring codecs.
+ */
+interface CodecDefBuilder<ScalarNames extends { readonly [K in keyof ScalarNames]: Codec<string> } = Record<never, never>> {
+  readonly CodecTypes: ExtractCodecTypes$1<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$1<Record<K, ScalarNames[K]>>]: Id }[keyof ExtractCodecTypes$1<Record<K, ScalarNames[K]>>] };
+}
+/**
+ * Create a new codec registry.
+ */
+declare function createCodecRegistry(): CodecRegistry;
+/**
+ * Create a new codec definition builder.
+ */
+declare function defineCodecs(): CodecDefBuilder<Record<never, never>>;
+//#endregion
+//#region src/query-lane-context.d.ts
+/**
+ * Registry of initialized type helpers from storage.types.
+ * Each key is a type name from storage.types, and the value is:
+ * - The result of the codec's init hook (if provided), or
+ * - The full StorageTypeInstance metadata (codecId, nativeType, typeParams) if no init hook
+ */
+type TypeHelperRegistry = Record<string, unknown>;
+/**
+ * A single validation error from JSON Schema validation.
+ */
+interface JsonSchemaValidationError {
+  readonly path: string;
+  readonly message: string;
+  readonly keyword: string;
+}
+/**
+ * Result of a JSON Schema validation.
+ */
+type JsonSchemaValidationResult = {
+  readonly valid: true;
+} | {
+  readonly valid: false;
+  readonly errors: ReadonlyArray<JsonSchemaValidationError>;
+};
+/**
+ * A compiled JSON Schema validate function.
+ * Returns a structured result indicating whether the value conforms to the schema.
+ */
+type JsonSchemaValidateFn = (value: unknown) => JsonSchemaValidationResult;
+/**
+ * Registry of compiled JSON Schema validators for columns with typed JSON/JSONB.
+ *
+ * Built during context creation by scanning the contract for columns whose codec
+ * descriptor provides an `init` hook that returns a `{ validate }` helper.
+ * Keys are `"table.column"` (e.g., `"user.metadata"`).
+ */
+interface JsonSchemaValidatorRegistry {
+  /** Get the compiled validator for a column. Key format: "table.column". */
+  get(key: string): JsonSchemaValidateFn | undefined;
+  /** Number of registered validators. */
+  readonly size: number;
+}
+type MutationDefaultsOp = 'create' | 'update';
+type AppliedMutationDefault = {
+  readonly column: string;
+  readonly value: unknown;
+};
+type MutationDefaultsOptions = {
+  readonly op: MutationDefaultsOp;
+  readonly table: string;
+  readonly values: Record<string, unknown>;
+};
+/**
+ * Minimal context interface for SQL query lanes.
+ *
+ * Lanes only need contract, operations, and codecs to build typed ASTs and attach
+ * operation builders. This interface explicitly excludes runtime concerns like
+ * adapters, connection management, and transaction state.
+ */
+interface ExecutionContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>> {
+  readonly contract: TContract;
+  readonly operations: OperationRegistry;
+  readonly codecs: CodecRegistry;
+  /**
+   * Type helper registry for parameterized types.
+   * Schema builders expose these helpers via schema.types.
+   */
+  readonly types: TypeHelperRegistry;
+  /**
+   * Compiled JSON Schema validators for typed JSON/JSONB columns.
+   * Present only when the contract declares columns with JSON Schema typeParams.
+   */
+  readonly jsonSchemaValidators?: JsonSchemaValidatorRegistry;
+  /**
+   * Applies execution-time mutation defaults for the given table.
+   * Returns the applied defaults (caller-provided values always win).
+   */
+  applyMutationDefaults(options: MutationDefaultsOptions): ReadonlyArray<AppliedMutationDefault>;
+}
+//#endregion
+export { defineCodecs as S, CodecRegistry as _, JsonSchemaValidationResult as a, codec as b, MutationDefaultsOptions as c, CodecDefBuilder as d, CodecId as f, CodecParamsDescriptor as g, CodecOutput as h, JsonSchemaValidationError as i, TypeHelperRegistry as l, CodecMeta as m, ExecutionContext as n, JsonSchemaValidatorRegistry as o, CodecInput as p, JsonSchemaValidateFn as r, MutationDefaultsOp as s, AppliedMutationDefault as t, Codec as u, ExtractCodecTypes$1 as v, createCodecRegistry as x, ExtractDataTypes as y };
+//# sourceMappingURL=query-lane-context-CgkPuKaR.d.mts.map

package/dist/query-lane-context-CgkPuKaR.d.mts.map

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

package/dist/schema-Bi5p4aAc.mjs

@@ -0,0 +1,175 @@
+import { t as attachOperationsToColumnBuilder } from "./operations-registry-DPZ5aElH.mjs";
+import { planInvalid } from "@prisma-next/plan";
+
+//#region src/schema.ts
+var ColumnBuilderImpl = class {
+	kind = "column";
+	constructor(table, column, storageColumn) {
+		this.table = table;
+		this.column = column;
+		this.storageColumn = storageColumn;
+	}
+	get columnMeta() {
+		return this.storageColumn;
+	}
+	get __jsType() {}
+	/**
+	* Converts this column builder to a ColumnRef expression.
+	* This is the canonical way to get an AST node from a builder.
+	*/
+	toExpr() {
+		return Object.freeze({
+			kind: "col",
+			table: this.table,
+			column: this.column
+		});
+	}
+	createBinaryBuilder(op, value) {
+		if (value == null) throw planInvalid("Parameter placeholder or expression source required for column comparison");
+		if ("toExpr" in value && typeof value.toExpr === "function") return Object.freeze({
+			kind: "binary",
+			op,
+			left: this.toExpr(),
+			right: value
+		});
+		if ("kind" in value && value.kind === "param-placeholder") return Object.freeze({
+			kind: "binary",
+			op,
+			left: this.toExpr(),
+			right: value
+		});
+		throw planInvalid("Parameter placeholder or expression source 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.toExpr(),
+			dir: "asc"
+		});
+	}
+	desc() {
+		return Object.freeze({
+			kind: "order",
+			expr: this.toExpr(),
+			dir: "desc"
+		});
+	}
+	/**
+	* Creates an IS NULL check for this column.
+	* Available on all columns at runtime, but typed to only be visible on nullable columns.
+	*/
+	isNull() {
+		return Object.freeze({
+			kind: "nullCheck",
+			expr: this.toExpr(),
+			isNull: true
+		});
+	}
+	/**
+	* Creates an IS NOT NULL check for this column.
+	* Available on all columns at runtime, but typed to only be visible on nullable columns.
+	*/
+	isNotNull() {
+		return Object.freeze({
+			kind: "nullCheck",
+			expr: this.toExpr(),
+			isNull: false
+		});
+	}
+};
+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) => {
+		result[columnName] = attachOperationsToColumnBuilder(new ColumnBuilderImpl(tableName, columnName, columnDef), columnDef, operationRegistry, contractCapabilities);
+	};
+	for (const columnName of Object.keys(tableColumns)) {
+		const columnDef = tableColumns[columnName];
+		if (!columnDef) continue;
+		assignColumn(columnName, columnDef);
+	}
+	return result;
+}
+/**
+* Creates a Proxy that enables accessing table columns directly on the table object,
+* in addition to the standard `table.columns.columnName` syntax.
+*
+* This allows both access patterns:
+* - `tables.user.columns.id` (standard access)
+* - `tables.user.id` (convenience access via proxy)
+*
+* The proxy intercepts property access and routes column name lookups to
+* `table.columns[prop]`, while preserving direct access to table properties
+* like `name`, `kind`, and `columns`.
+*/
+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];
+	} });
+}
+/**
+* Creates a schema handle for building SQL queries.
+*
+* @param context - Query lane context containing contract, codec and operation registries
+* @returns A schema handle with typed table builders and type helpers
+*
+* @example
+* ```typescript
+* const schemaHandle = schema<Contract>(context);
+* const userTable = schemaHandle.tables.user;
+* const vectorType = schemaHandle.types.Vector1536;
+* ```
+*/
+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 proxiedTable = createTableProxy(new TableBuilderImpl(tableName, buildColumns(tableName, storage, contract, operationRegistry, contractCapabilities)));
+		tables[tableName] = Object.freeze(proxiedTable);
+	}
+	const types = context.types;
+	return Object.freeze({
+		tables,
+		types
+	});
+}
+
+//#endregion
+export { TableBuilderImpl as n, schema as r, ColumnBuilderImpl as t };
+//# sourceMappingURL=schema-Bi5p4aAc.mjs.map

package/dist/schema-Bi5p4aAc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-Bi5p4aAc.mjs","names":["table: string","column: ColumnName","storageColumn: ColumnMeta"],"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, ColumnRef, ExpressionSource, TableRef } from './ast/types';\nimport { attachOperationsToColumnBuilder } from './operations-registry';\nimport type { ExecutionContext } from './query-lane-context';\nimport type {\n  BinaryBuilder,\n  CodecTypes as CodecTypesType,\n  ColumnBuilder,\n  ComputeColumnJsType,\n  NullCheckBuilder,\n  OperationTypeSignature,\n  OperationTypes,\n  OrderBuilder,\n  ParamPlaceholder,\n} 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> implements ExpressionSource\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  /**\n   * Converts this column builder to a ColumnRef expression.\n   * This is the canonical way to get an AST node from a builder.\n   */\n  toExpr(): ColumnRef {\n    return Object.freeze({\n      kind: 'col' as const,\n      table: this.table,\n      column: this.column,\n    });\n  }\n\n  private createBinaryBuilder(\n    op: BinaryOp,\n    value: ParamPlaceholder | ExpressionSource,\n  ): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    if (value == null) {\n      throw planInvalid(\n        'Parameter placeholder or expression source required for column comparison',\n      );\n    }\n    // Check for ExpressionSource first (has toExpr method)\n    if ('toExpr' in value && typeof value.toExpr === 'function') {\n      return Object.freeze({\n        kind: 'binary' as const,\n        op,\n        left: this.toExpr(),\n        right: value,\n      }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n    }\n    // Must be a ParamPlaceholder\n    if ('kind' in value && value.kind === 'param-placeholder') {\n      return Object.freeze({\n        kind: 'binary' as const,\n        op,\n        left: this.toExpr(),\n        right: value,\n      }) as BinaryBuilder<ColumnName, ColumnMeta, JsType>;\n    }\n    throw planInvalid('Parameter placeholder or expression source required for column comparison');\n  }\n\n  eq(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('eq', value);\n  }\n\n  neq(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('neq', value);\n  }\n\n  gt(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('gt', value);\n  }\n\n  lt(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('lt', value);\n  }\n\n  gte(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType> {\n    return this.createBinaryBuilder('gte', value);\n  }\n\n  lte(value: ParamPlaceholder | ExpressionSource): 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.toExpr(),\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.toExpr(),\n      dir: 'desc' as const,\n    }) as OrderBuilder<ColumnName, ColumnMeta, JsType>;\n  }\n\n  /**\n   * Creates an IS NULL check for this column.\n   * Available on all columns at runtime, but typed to only be visible on nullable columns.\n   */\n  isNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType> {\n    return Object.freeze({\n      kind: 'nullCheck' as const,\n      expr: this.toExpr(),\n      isNull: true,\n    }) as NullCheckBuilder<ColumnName, ColumnMeta, JsType>;\n  }\n\n  /**\n   * Creates an IS NOT NULL check for this column.\n   * Available on all columns at runtime, but typed to only be visible on nullable columns.\n   */\n  isNotNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType> {\n    return Object.freeze({\n      kind: 'nullCheck' as const,\n      expr: this.toExpr(),\n      isNull: false,\n    }) as NullCheckBuilder<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\n/**\n * Extracts the types registry shape from a contract.\n * Each key is a type name from storage.types, and the value preserves the\n * literal type from the contract (including codecId, nativeType, and typeParams).\n * Returns an empty object type {} when storage.types is undefined.\n */\ntype ExtractSchemaTypes<Contract extends SqlContract<SqlStorage>> =\n  Contract['storage']['types'] extends infer Types\n    ? Types extends Record<string, unknown>\n      ? { readonly [TypeName in keyof Types]: Types[TypeName] }\n      : Record<string, never>\n    : Record<string, never>;\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   * Initialized type helpers from storage.types.\n   * Each entry corresponds to a named type instance in the contract's storage.types.\n   */\n  readonly types: ExtractSchemaTypes<Contract>;\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 and type helpers\n *\n * @example\n * ```typescript\n * const schemaHandle = schema<Contract>(context);\n * const userTable = schemaHandle.tables.user;\n * const vectorType = schemaHandle.types.Vector1536;\n * ```\n */\nexport function schema<Contract extends SqlContract<SqlStorage>>(\n  context: ExecutionContext<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  // Get type helpers from context (populated by runtime context creation)\n  const types = context.types as ExtractSchemaTypes<Contract>;\n\n  return Object.freeze({ tables, types }) as SchemaReturnType<Contract>;\n}\n\nexport type { ColumnBuilderImpl as Column, TableBuilderImpl as Table };\n"],"mappings":"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"}

package/dist/schema-CgrEMqEd.d.mts

@@ -0,0 +1,86 @@
+import { n as ExecutionContext } from "./query-lane-context-CgkPuKaR.mjs";
+import { D as TableRef, f as ExpressionSource, s as ColumnRef } from "./plan-BhSWuTfw.mjs";
+import { A as OperationTypes, D as NullCheckBuilder, M as OrderBuilder, N as ParamPlaceholder, d as ColumnBuilder, k as OperationTypeSignature, p as ComputeColumnJsType, s as BinaryBuilder, u as CodecTypes } from "./types-CEUzDuDC.mjs";
+import { ExtractCodecTypes, ExtractOperationTypes, SqlContract, SqlStorage, StorageColumn } from "@prisma-next/sql-contract/types";
+
+//#region src/schema.d.ts
+type TableColumns<Table extends {
+  columns: Record<string, StorageColumn>;
+}> = Table['columns'];
+type ColumnBuilders<Contract extends SqlContract<SqlStorage>, TableName$1 extends string, Columns extends Record<string, StorageColumn>, CodecTypes$1 extends CodecTypes, Operations extends OperationTypes> = { readonly [K in keyof Columns]: ColumnBuilder<K & string, Columns[K], ComputeColumnJsType<Contract, TableName$1, K & string, Columns[K], CodecTypes$1>, Operations> };
+declare class ColumnBuilderImpl<ColumnName extends string, ColumnMeta extends StorageColumn, JsType = unknown> implements ExpressionSource {
+  readonly table: string;
+  readonly column: ColumnName;
+  private readonly storageColumn;
+  readonly kind: "column";
+  constructor(table: string, column: ColumnName, storageColumn: ColumnMeta);
+  get columnMeta(): ColumnMeta;
+  get __jsType(): JsType;
+  /**
+   * Converts this column builder to a ColumnRef expression.
+   * This is the canonical way to get an AST node from a builder.
+   */
+  toExpr(): ColumnRef;
+  private createBinaryBuilder;
+  eq(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  neq(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  gt(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  lt(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  gte(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  lte(value: ParamPlaceholder | ExpressionSource): BinaryBuilder<ColumnName, ColumnMeta, JsType>;
+  asc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;
+  desc(): OrderBuilder<ColumnName, ColumnMeta, JsType>;
+  /**
+   * Creates an IS NULL check for this column.
+   * Available on all columns at runtime, but typed to only be visible on nullable columns.
+   */
+  isNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType>;
+  /**
+   * Creates an IS NOT NULL check for this column.
+   * Available on all columns at runtime, but typed to only be visible on nullable columns.
+   */
+  isNotNull(): NullCheckBuilder<ColumnName, ColumnMeta, JsType>;
+}
+declare class TableBuilderImpl<Contract extends SqlContract<SqlStorage>, TableName$1 extends string, Columns extends Record<string, StorageColumn>, CodecTypes$1 extends CodecTypes, Operations extends OperationTypes> implements TableRef {
+  readonly kind: "table";
+  readonly columns: ColumnBuilders<Contract, TableName$1, Columns, CodecTypes$1, Operations>;
+  private readonly _name;
+  constructor(name: TableName$1, columns: ColumnBuilders<Contract, TableName$1, Columns, CodecTypes$1, Operations>);
+  get name(): string;
+}
+type ExtractSchemaTables<Contract extends SqlContract<SqlStorage>, CodecTypes$1 extends CodecTypes, Operations extends OperationTypes> = { readonly [TableName in keyof Contract['storage']['tables']]: TableBuilderImpl<Contract, TableName & string, TableColumns<Contract['storage']['tables'][TableName]>, CodecTypes$1, Operations> & TableRef };
+/**
+ * Extracts the types registry shape from a contract.
+ * Each key is a type name from storage.types, and the value preserves the
+ * literal type from the contract (including codecId, nativeType, and typeParams).
+ * Returns an empty object type {} when storage.types is undefined.
+ */
+type ExtractSchemaTypes<Contract extends SqlContract<SqlStorage>> = Contract['storage']['types'] extends infer Types ? Types extends Record<string, unknown> ? { readonly [TypeName in keyof Types]: Types[TypeName] } : Record<string, never> : Record<string, never>;
+type SchemaHandle<Contract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, CodecTypes$1 extends CodecTypes = CodecTypes, Operations extends OperationTypes = Record<string, never>> = {
+  readonly tables: ExtractSchemaTables<Contract, CodecTypes$1, Operations>;
+  /**
+   * Initialized type helpers from storage.types.
+   * Each entry corresponds to a named type instance in the contract's storage.types.
+   */
+  readonly types: ExtractSchemaTypes<Contract>;
+};
+type SchemaReturnType<Contract extends SqlContract<SqlStorage>> = SchemaHandle<Contract, ExtractCodecTypes<Contract>, ToOperationTypes<ExtractOperationTypes<Contract>>>;
+type NormalizeOperationTypes<T> = { [TypeId in keyof T]: { [Method in keyof T[TypeId]]: T[TypeId][Method] extends OperationTypeSignature ? T[TypeId][Method] : OperationTypeSignature } };
+type ToOperationTypes<T> = T extends OperationTypes ? T : NormalizeOperationTypes<T>;
+/**
+ * Creates a schema handle for building SQL queries.
+ *
+ * @param context - Query lane context containing contract, codec and operation registries
+ * @returns A schema handle with typed table builders and type helpers
+ *
+ * @example
+ * ```typescript
+ * const schemaHandle = schema<Contract>(context);
+ * const userTable = schemaHandle.tables.user;
+ * const vectorType = schemaHandle.types.Vector1536;
+ * ```
+ */
+declare function schema<Contract extends SqlContract<SqlStorage>>(context: ExecutionContext<Contract>): SchemaReturnType<Contract>;
+//#endregion
+export { schema as i, SchemaHandle as n, TableBuilderImpl as r, ColumnBuilderImpl as t };
+//# sourceMappingURL=schema-CgrEMqEd.d.mts.map

package/dist/schema-CgrEMqEd.d.mts.map

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