@prisma-next/sql-lane 0.3.0-dev.3 → 0.3.0-dev.31

package/dist/sql/plan.d.ts

@@ -0,0 +1,4 @@
+import type { PlanMeta } from '@prisma-next/contract/types';
+import type { MetaBuildArgs } from '../types/internal';
+export declare function buildMeta(args: MetaBuildArgs): PlanMeta;
+//# sourceMappingURL=plan.d.ts.map

package/dist/sql/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/sql/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAU5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAqDvD,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,CAkOvD"}

package/dist/sql/predicate-builder.d.ts

@@ -0,0 +1,11 @@
+import type { ParamDescriptor } from '@prisma-next/contract/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { BinaryExpr } from '@prisma-next/sql-relational-core/ast';
+import type { BinaryBuilder } from '@prisma-next/sql-relational-core/types';
+export interface BuildWhereExprResult {
+    expr: BinaryExpr;
+    codecId: string | undefined;
+    paramName: string;
+}
+export declare function buildWhereExpr(contract: SqlContract<SqlStorage>, where: BinaryBuilder, paramsMap: Record<string, unknown>, descriptors: ParamDescriptor[], values: unknown[]): BuildWhereExprResult;
+//# sourceMappingURL=predicate-builder.d.ts.map

package/dist/sql/predicate-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-builder.d.ts","sourceRoot":"","sources":["../../src/sql/predicate-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAiB,MAAM,iCAAiC,CAAC;AAC9F,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,sCAAsC,CAAC;AAE7F,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,wCAAwC,CAAC;AAa9F,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,WAAW,EAAE,eAAe,EAAE,EAC9B,MAAM,EAAE,OAAO,EAAE,GAChB,oBAAoB,CAiGtB"}

package/dist/sql/projection.d.ts

@@ -0,0 +1,18 @@
+import type { TableRef } from '@prisma-next/sql-relational-core/ast';
+import type { AnyExpressionSource, NestedProjection } from '@prisma-next/sql-relational-core/types';
+import type { ProjectionInput } from '../types/internal';
+import type { IncludeState, ProjectionState } from '../utils/state';
+export declare function generateAlias(path: string[]): string;
+export declare class AliasTracker {
+    private readonly aliases;
+    private readonly aliasToPath;
+    register(path: string[]): string;
+    getPath(alias: string): string[] | undefined;
+    has(alias: string): boolean;
+}
+export declare function flattenProjection(projection: NestedProjection, tracker: AliasTracker, currentPath?: string[]): {
+    aliases: string[];
+    columns: AnyExpressionSource[];
+};
+export declare function buildProjectionState(_table: TableRef, projection: ProjectionInput, includes?: ReadonlyArray<IncludeState>): ProjectionState;
+//# sourceMappingURL=projection.d.ts.map

package/dist/sql/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/sql/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAEpG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AASzD,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEpE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAKpD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAE3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM;IAWhC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAI5C,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAG5B;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,YAAY,EACrB,WAAW,GAAE,MAAM,EAAO,GACzB;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAqBvD;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAChB,UAAU,EAAE,eAAe,EAC3B,QAAQ,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,GACrC,eAAe,CAwCjB"}

package/dist/sql/select-builder.d.ts

@@ -0,0 +1,35 @@
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { TableRef } from '@prisma-next/sql-relational-core/ast';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { AnyBinaryBuilder, AnyOrderBuilder, BuildOptions, InferNestedProjectionRow, JoinOnBuilder, JoinOnPredicate, NestedProjection, SqlBuilderOptions } from '@prisma-next/sql-relational-core/types';
+import type { ProjectionInput } from '../types/internal';
+import type { BuilderState } from '../utils/state';
+import { type IncludeChildBuilder } from './include-builder';
+export declare class SelectBuilderImpl<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, Row = unknown, CodecTypes extends Record<string, {
+    readonly output: unknown;
+}> = Record<string, never>, Includes extends Record<string, unknown> = Record<string, never>> {
+    private readonly contract;
+    private readonly codecTypes;
+    private readonly context;
+    private state;
+    constructor(options: SqlBuilderOptions<TContract>, state?: BuilderState);
+    from(table: TableRef): SelectBuilderImpl<TContract, unknown, CodecTypes, Record<string, never>>;
+    innerJoin(table: TableRef, on: (on: JoinOnBuilder) => JoinOnPredicate): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    leftJoin(table: TableRef, on: (on: JoinOnBuilder) => JoinOnPredicate): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    rightJoin(table: TableRef, on: (on: JoinOnBuilder) => JoinOnPredicate): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    fullJoin(table: TableRef, on: (on: JoinOnBuilder) => JoinOnPredicate): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    includeMany<ChildProjection extends NestedProjection, ChildRow = InferNestedProjectionRow<ChildProjection, CodecTypes>, AliasName extends string = string>(childTable: TableRef, on: (on: JoinOnBuilder) => JoinOnPredicate, childBuilder: (child: IncludeChildBuilder<TContract, CodecTypes, unknown>) => IncludeChildBuilder<TContract, CodecTypes, ChildRow>, options?: {
+        alias?: AliasName;
+    }): SelectBuilderImpl<TContract, Row, CodecTypes, Includes & {
+        [K in AliasName]: ChildRow;
+    }>;
+    private _addJoin;
+    where(expr: AnyBinaryBuilder): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    select<P extends ProjectionInput>(projection: P): SelectBuilderImpl<TContract, InferNestedProjectionRow<P, CodecTypes, Includes>, CodecTypes, Includes>;
+    orderBy(order: AnyOrderBuilder): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    limit(count: number): SelectBuilderImpl<TContract, Row, CodecTypes, Includes>;
+    build(options?: BuildOptions): SqlQueryPlan<Row>;
+    private ensureFrom;
+    private ensureProjection;
+}
+//# sourceMappingURL=select-builder.d.ts.map

package/dist/sql/select-builder.d.ts.map

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

package/dist/types/internal.d.ts

@@ -0,0 +1,35 @@
+import type { ParamDescriptor } from '@prisma-next/contract/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { TableRef } from '@prisma-next/sql-relational-core/ast';
+import type { AnyBinaryBuilder, AnyExpressionSource, AnyOrderBuilder, NestedProjection } from '@prisma-next/sql-relational-core/types';
+import type { ProjectionState } from '../utils/state';
+export type ProjectionInput = Record<string, AnyExpressionSource | boolean | NestedProjection>;
+export interface MetaBuildArgs {
+    readonly contract: SqlContract<SqlStorage>;
+    readonly table: TableRef;
+    readonly projection: ProjectionState;
+    readonly joins?: ReadonlyArray<{
+        readonly joinType: 'inner' | 'left' | 'right' | 'full';
+        readonly table: TableRef;
+        readonly on: {
+            readonly left: unknown;
+            readonly right: unknown;
+        };
+    }>;
+    readonly includes?: ReadonlyArray<{
+        readonly alias: string;
+        readonly table: TableRef;
+        readonly on: {
+            readonly left: unknown;
+            readonly right: unknown;
+        };
+        readonly childProjection: ProjectionState;
+        readonly childWhere?: AnyBinaryBuilder;
+        readonly childOrderBy?: AnyOrderBuilder;
+    }>;
+    readonly where?: AnyBinaryBuilder;
+    readonly orderBy?: AnyOrderBuilder;
+    readonly paramDescriptors: ParamDescriptor[];
+    readonly paramCodecs?: Record<string, string>;
+}
+//# sourceMappingURL=internal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/types/internal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EACjB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,GAAG,gBAAgB,CAAC,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;QACvD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACzB,QAAQ,CAAC,EAAE,EAAE;YACX,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;YACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;SACzB,CAAC;KACH,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;QACzB,QAAQ,CAAC,EAAE,EAAE;YACX,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;YACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;SACzB,CAAC;QACF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;QAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;QACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;KACzC,CAAC,CAAC;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/C"}

package/dist/types/public.d.ts

@@ -0,0 +1,18 @@
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { TableRef } from '@prisma-next/sql-relational-core/ast';
+import type { ParamPlaceholder, RawFactory } from '@prisma-next/sql-relational-core/types';
+import type { DeleteBuilder, InsertBuilder, UpdateBuilder } from '../sql/mutation-builder';
+import type { SelectBuilderImpl } from '../sql/select-builder';
+export type { TableRef } from '@prisma-next/sql-relational-core/ast';
+export type { AnyColumnBuilder, BuildOptions, InferReturningRow, ParamPlaceholder, RawFactory, SqlBuilderOptions, } from '@prisma-next/sql-relational-core/types';
+export type SelectBuilder<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, Row = unknown, CodecTypes extends Record<string, {
+    readonly output: unknown;
+}> = Record<string, never>, Includes extends Record<string, unknown> = Record<string, never>> = SelectBuilderImpl<TContract, Row, CodecTypes, Includes> & {
+    readonly raw: RawFactory;
+    insert(table: TableRef, values: Record<string, ParamPlaceholder>): InsertBuilder<TContract, CodecTypes>;
+    update(table: TableRef, set: Record<string, ParamPlaceholder>): UpdateBuilder<TContract, CodecTypes>;
+    delete(table: TableRef): DeleteBuilder<TContract, CodecTypes>;
+};
+export type { IncludeChildBuilder } from '../sql/include-builder';
+export type { DeleteBuilder, InsertBuilder, UpdateBuilder } from '../sql/mutation-builder';
+//# sourceMappingURL=public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/types/public.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,YAAY,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,GAClB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,MAAM,aAAa,CACvB,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,EACnE,GAAG,GAAG,OAAO,EACb,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACvF,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC9D,iBAAiB,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,GAAG;IAC5D,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,MAAM,CACJ,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACvC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,CACJ,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GACpC,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;CAC/D,CAAC;AAEF,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/utils/assertions.d.ts

@@ -0,0 +1,28 @@
+import type { AnyColumnBuilder } from '@prisma-next/sql-relational-core/types';
+/**
+ * Asserts that a ColumnBuilder has table and column properties.
+ */
+export declare function assertColumnBuilder(col: unknown, context: string): AnyColumnBuilder;
+/**
+ * Asserts that a JoinOnPredicate has valid left and right columns.
+ */
+export declare function assertJoinOnPredicate(on: {
+    left?: {
+        table?: string;
+        column?: string;
+    };
+    right?: {
+        table?: string;
+        column?: string;
+    };
+}): asserts on is {
+    left: {
+        table: string;
+        column: string;
+    };
+    right: {
+        table: string;
+        column: string;
+    };
+};
+//# sourceMappingURL=assertions.d.ts.map

package/dist/utils/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/utils/assertions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAYnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE;IACxC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C,GAAG,OAAO,CAAC,EAAE,IAAI;IAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAIA"}

package/dist/utils/capabilities.d.ts

@@ -0,0 +1,4 @@
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+export declare function checkIncludeCapabilities(contract: SqlContract<SqlStorage>): void;
+export declare function checkReturningCapability(contract: SqlContract<SqlStorage>): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/utils/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/utils/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAQ/E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,IAAI,CAkBhF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,IAAI,CAUhF"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,30 @@
+export declare function errorAliasPathEmpty(): never;
+export declare function errorAliasCollision(path: string[], alias: string, existingPath?: string[]): never;
+export declare function errorLimitMustBeNonNegativeInteger(): never;
+export declare function errorChildProjectionMustBeSpecified(): never;
+export declare function errorIncludeRequiresCapabilities(target?: string): never;
+export declare function errorIncludeCapabilitiesNotTrue(target?: string, values?: {
+    lateral?: unknown;
+    jsonAgg?: unknown;
+}): never;
+export declare function errorUnknownTable(tableName: string): never;
+export declare function errorSelfJoinNotSupported(): never;
+export declare function errorChildProjectionEmpty(): never;
+export declare function errorIncludeAliasCollision(alias: string, type: 'projection' | 'include'): never;
+export declare function errorMissingColumnForAlias(alias: string, index: number): never;
+export declare function errorMissingAlias(index: number): never;
+export declare function errorInvalidColumnForAlias(alias: string, index: number): never;
+export declare function errorFromMustBeCalled(): never;
+export declare function errorSelectMustBeCalled(): never;
+export declare function errorMissingParameter(paramName: string): never;
+export declare function errorInvalidProjectionValue(path: string[]): never;
+export declare function errorIncludeAliasNotFound(alias: string): never;
+export declare function errorInvalidProjectionKey(key: string): never;
+export declare function errorProjectionEmpty(): never;
+export declare function errorReturningRequiresCapability(target?: string): never;
+export declare function errorReturningCapabilityNotTrue(target?: string, value?: unknown): never;
+export declare function errorUnknownColumn(columnName: string, tableName: string): never;
+export declare function errorWhereMustBeCalledForUpdate(): never;
+export declare function errorFailedToBuildWhereClause(): never;
+export declare function errorWhereMustBeCalledForDelete(): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,KAAK,CAE3C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAIjG;AAED,wBAAgB,kCAAkC,IAAI,KAAK,CAE1D;AAED,wBAAgB,mCAAmC,IAAI,KAAK,CAE3D;AAED,wBAAgB,gCAAgC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAevE;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAChD,KAAK,CAcP;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAE1D;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAEjD;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAEjD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,KAAK,CAI/F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAE9E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAEtD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAE9E;AAED,wBAAgB,qBAAqB,IAAI,KAAK,CAE7C;AAED,wBAAgB,uBAAuB,IAAI,KAAK,CAE/C;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,CAE9D;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAIjE;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAI9D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAI5D;AAED,wBAAgB,oBAAoB,IAAI,KAAK,CAE5C;AAED,wBAAgB,gCAAgC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAevE;AAED,wBAAgB,+BAA+B,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAcvF;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAE/E;AAED,wBAAgB,+BAA+B,IAAI,KAAK,CAEvD;AAED,wBAAgB,6BAA6B,IAAI,KAAK,CAErD;AAED,wBAAgB,+BAA+B,IAAI,KAAK,CAEvD"}

package/dist/utils/state.d.ts

@@ -0,0 +1,30 @@
+import type { TableRef } from '@prisma-next/sql-relational-core/ast';
+import type { AnyBinaryBuilder, AnyExpressionSource, AnyOrderBuilder, JoinOnPredicate } from '@prisma-next/sql-relational-core/types';
+export interface ProjectionState {
+    readonly aliases: string[];
+    readonly columns: AnyExpressionSource[];
+}
+export interface JoinState {
+    readonly joinType: 'inner' | 'left' | 'right' | 'full';
+    readonly table: TableRef;
+    readonly on: JoinOnPredicate;
+}
+export interface IncludeState {
+    readonly alias: string;
+    readonly table: TableRef;
+    readonly on: JoinOnPredicate;
+    readonly childProjection: ProjectionState;
+    readonly childWhere?: AnyBinaryBuilder;
+    readonly childOrderBy?: AnyOrderBuilder;
+    readonly childLimit?: number;
+}
+export interface BuilderState {
+    from?: TableRef;
+    joins?: ReadonlyArray<JoinState>;
+    includes?: ReadonlyArray<IncludeState>;
+    projection?: ProjectionState;
+    where?: AnyBinaryBuilder;
+    orderBy?: AnyOrderBuilder;
+    limit?: number;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/utils/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/utils/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,EAChB,MAAM,wCAAwC,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,mBAAmB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACvD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/package.json

@@ -1,29 +1,29 @@
 {
   "name": "@prisma-next/sql-lane",
-  "version": "0.3.0-dev.3",
+  "version": "0.3.0-dev.31",
   "type": "module",
   "sideEffects": false,
   "description": "Relational DSL and raw SQL helpers for Prisma Next",
   "dependencies": {
-    "@prisma-next/plan": "0.3.0-dev.3",
-    "@prisma-next/contract": "0.3.0-dev.3",
-    "@prisma-next/sql-contract": "0.3.0-dev.3",
-    "@prisma-next/sql-relational-core": "0.3.0-dev.3"
+    "@prisma-next/contract": "0.3.0-dev.31",
+    "@prisma-next/plan": "0.3.0-dev.31",
+    "@prisma-next/sql-contract": "0.3.0-dev.31",
+    "@prisma-next/sql-relational-core": "0.3.0-dev.31"
   },
   "devDependencies": {
-    "@types/pg": "^8.11.10",
-    "@vitest/coverage-v8": "^4.0.0",
-    "pg": "^8.11.5",
-    "tsup": "^8.3.0",
-    "typescript": "^5.9.3",
-    "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.16",
-    "@prisma-next/sql-contract-ts": "0.3.0-dev.3",
-    "@prisma-next/sql-runtime": "0.3.0-dev.3",
+    "@types/pg": "8.16.0",
+    "pg": "8.16.3",
+    "tsup": "8.5.1",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
+    "@prisma-next/sql-contract-ts": "0.3.0-dev.31",
+    "@prisma-next/sql-runtime": "0.3.0-dev.31",
+    "@prisma-next/tsconfig": "0.0.0",
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "exports": {
     ".": {
@@ -36,13 +36,13 @@
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
-    "lint": "biome check . --config-path ../../../../biome.json --error-on-warnings",
-    "lint:fix": "biome check --write . --config-path ../../../../biome.json",
-    "lint:fix:unsafe": "biome check --write --unsafe . --config-path ../../../../biome.json",
-    "clean": "node ../../../../scripts/clean.mjs"
+    "lint": "biome check . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
   }
 }

package/src/exports/sql.ts

@@ -0,0 +1,12 @@
+export type {
+  ColumnsOf,
+  RawFactory,
+  RawFunctionOptions,
+  RawTemplateOptions,
+  SqlBuilderOptions,
+  TableKey,
+  TablesOf,
+} from '@prisma-next/sql-relational-core/types';
+export { rawOptions } from '../raw';
+export type { SelectBuilder } from '../sql/builder';
+export { createJoinOnBuilder, sql } from '../sql/builder';

package/src/index.ts

@@ -0,0 +1,13 @@
+export type {
+  ColumnsOf,
+  JoinOnBuilder,
+  RawFactory,
+  RawFunctionOptions,
+  RawTemplateOptions,
+  SqlBuilderOptions,
+  TableKey,
+  TablesOf,
+} from '@prisma-next/sql-relational-core/types';
+export { rawOptions } from './raw';
+export type { IncludeChildBuilder, SelectBuilder } from './sql/builder';
+export { createJoinOnBuilder, sql } from './sql/builder';

package/src/raw.ts

@@ -0,0 +1,230 @@
+import type {
+  ExecutionPlan,
+  ParamDescriptor,
+  PlanMeta,
+  PlanRefs,
+} from '@prisma-next/contract/types';
+import { planInvalid } from '@prisma-next/plan';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type {
+  RawFactory,
+  RawFunctionOptions,
+  RawTemplateFactory,
+  RawTemplateOptions,
+} from '@prisma-next/sql-relational-core/types';
+
+const RAW_OPTIONS_SENTINEL = Symbol('rawOptions');
+
+type TemplateInvocation = {
+  readonly sql: string;
+  readonly params: readonly unknown[];
+  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;
+};
+
+interface RawPlanBuildArgs {
+  readonly contract: SqlContract<SqlStorage>;
+  readonly sql: string;
+  readonly params: readonly unknown[];
+  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;
+  readonly options?: RawTemplateOptions;
+}
+
+export function createRawFactory(contract: SqlContract<SqlStorage>): RawFactory {
+  const factory = ((first: TemplateStringsArray | string, ...rest: unknown[]) => {
+    if (isTemplateInvocation(first)) {
+      const { values, options } = splitTemplateValues(rest);
+      const compiled = compileTemplateToPositional(first, values);
+      return buildRawPlan({
+        contract,
+        sql: compiled.sql,
+        params: compiled.params,
+        paramDescriptors: compiled.paramDescriptors,
+        ...(options ? { options } : {}),
+      });
+    }
+
+    const text = first;
+    const [options] = rest as [RawFunctionOptions | undefined];
+
+    if (!options) {
+      throw planInvalid('Function form requires params option');
+    }
+
+    if (!Array.isArray(options.params)) {
+      throw planInvalid('Function form params must be an array');
+    }
+
+    const paramDescriptors = buildSequentialDescriptors(options.params.length);
+
+    return buildRawPlan({
+      contract,
+      sql: text,
+      params: options.params,
+      paramDescriptors,
+      options,
+    });
+  }) as RawFactory;
+
+  factory.with = (options: RawTemplateOptions) => {
+    return ((strings: TemplateStringsArray, ...values: readonly unknown[]) => {
+      const compiled = compileTemplateToPositional(strings, values);
+      return buildRawPlan({
+        contract,
+        sql: compiled.sql,
+        params: compiled.params,
+        paramDescriptors: compiled.paramDescriptors,
+        options,
+      });
+    }) as RawTemplateFactory;
+  };
+
+  return factory;
+}
+
+function compileTemplateToPositional(
+  strings: TemplateStringsArray,
+  values: readonly unknown[],
+): TemplateInvocation {
+  let sql = '';
+  const params: unknown[] = [];
+  const paramDescriptors: ParamDescriptor[] = [];
+
+  strings.forEach((part, index) => {
+    sql += part;
+
+    if (index < values.length) {
+      const value = values[index];
+      const placeholderIndex = params.push(value);
+      sql += `$${placeholderIndex}`;
+      paramDescriptors.push({
+        index: placeholderIndex,
+        name: `p${placeholderIndex}`,
+        source: 'raw',
+      });
+    }
+  });
+
+  return {
+    sql,
+    params,
+    paramDescriptors,
+  };
+}
+
+function buildRawPlan(args: RawPlanBuildArgs): ExecutionPlan {
+  const params = Array.from(args.params);
+  const descriptors = args.paramDescriptors.map((descriptor) =>
+    Object.freeze({ ...descriptor, source: 'raw' as const }),
+  );
+
+  const meta = buildRawMeta({
+    contract: args.contract,
+    paramDescriptors: descriptors,
+    ...(args.options ? { options: args.options } : {}),
+  });
+
+  return Object.freeze({
+    sql: args.sql,
+    params: Object.freeze(params),
+    meta,
+  });
+}
+
+interface RawMetaBuildArgs {
+  readonly contract: SqlContract<SqlStorage>;
+  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;
+  readonly options?: RawTemplateOptions;
+}
+
+function buildRawMeta(args: RawMetaBuildArgs): PlanMeta {
+  const { contract, paramDescriptors, options } = args;
+
+  const meta: PlanMeta = {
+    target: contract.target,
+    targetFamily: contract.targetFamily,
+    coreHash: contract.coreHash,
+    ...(contract.profileHash !== undefined ? { profileHash: contract.profileHash } : {}),
+    lane: 'raw',
+    paramDescriptors: Object.freeze([...paramDescriptors]),
+    ...(options?.annotations ? { annotations: Object.freeze({ ...options.annotations }) } : {}),
+    ...(options?.refs ? { refs: freezeRefs(options.refs) } : {}),
+    ...(options?.projection ? { projection: Object.freeze([...options.projection]) } : {}),
+  };
+
+  return Object.freeze(meta);
+}
+
+function freezeRefs(refs: PlanRefs): PlanRefs {
+  return Object.freeze({
+    ...(refs.tables ? { tables: Object.freeze([...refs.tables]) } : {}),
+    ...(refs.columns
+      ? {
+          columns: Object.freeze(
+            refs.columns.map((col: { table: string; column: string }) => Object.freeze({ ...col })),
+          ),
+        }
+      : {}),
+    ...(refs.indexes
+      ? {
+          indexes: Object.freeze(
+            refs.indexes.map(
+              (index: { table: string; columns: ReadonlyArray<string>; name?: string }) =>
+                Object.freeze({
+                  ...index,
+                  columns: Object.freeze([...index.columns]),
+                }),
+            ),
+          ),
+        }
+      : {}),
+  });
+}
+
+function buildSequentialDescriptors(count: number): ReadonlyArray<ParamDescriptor> {
+  return Array.from({ length: count }, (_, idx) =>
+    Object.freeze({
+      index: idx + 1,
+      name: `p${idx + 1}`,
+      source: 'raw' as const,
+    }),
+  );
+}
+
+function isTemplateInvocation(value: unknown): value is TemplateStringsArray {
+  return Array.isArray(value) && Object.hasOwn(value, 'raw');
+}
+
+interface RawTemplateOptionsSentinel {
+  readonly [RAW_OPTIONS_SENTINEL]: true;
+  readonly value: RawTemplateOptions;
+}
+
+export function rawOptions(options: RawTemplateOptions): RawTemplateOptionsSentinel {
+  return Object.freeze({
+    [RAW_OPTIONS_SENTINEL]: true as const,
+    value: options,
+  });
+}
+
+function splitTemplateValues(values: readonly unknown[]): {
+  readonly values: readonly unknown[];
+  readonly options?: RawTemplateOptions;
+} {
+  if (values.length === 0) {
+    return { values };
+  }
+
+  const last = values[values.length - 1];
+  if (!isOptionsSentinel(last)) {
+    return { values };
+  }
+
+  return {
+    values: values.slice(0, values.length - 1),
+    options: last.value,
+  };
+}
+
+function isOptionsSentinel(value: unknown): value is RawTemplateOptionsSentinel {
+  return typeof value === 'object' && value !== null && RAW_OPTIONS_SENTINEL in value;
+}