@prisma-next/contract-authoring 0.0.1

package/README.md

@@ -0,0 +1,47 @@
+# @prisma-next/contract-authoring
+
+**Status:** Phase 2 - Target-agnostic contract authoring core extracted
+
+This package contains the target-agnostic contract authoring builder core for Prisma Next.
+
+## Overview
+
+This package provides generic builder primitives that can be composed with target-family specific types (e.g., SQL) to create contract authoring surfaces. It is part of the authoring ring and depends only on `@prisma-next/contract` and core packages.
+
+## Responsibilities
+
+- **Generic Builder Core**: Provides target-agnostic builder state types and builder classes (`TableBuilder`, `ModelBuilder`, `ContractBuilder`)
+- **State Management**: Manages builder state for tables, columns, models, and relations without target-specific logic
+- **Type Helpers**: Provides generic type-level helpers for transforming builder states into contract structures
+- **Composition Surface**: Enables target-family specific packages (e.g., `@prisma-next/sql-contract-ts`) to compose generic core with family-specific types
+
+## Package Status
+
+This package was created in Phase 2 of the contract authoring extraction. It contains the extracted target-neutral builder core from `@prisma-next/sql-contract-ts`. The SQL layer (`@prisma-next/sql-contract-ts`) composes this generic core with SQL-specific types.
+
+## Architecture
+
+- **Builder state types**: Generic state types (`ColumnBuilderState`, `TableBuilderState`, `ModelBuilderState`, `ContractBuilderState`) that don't reference any target-family specific types
+- **Builder classes**: Generic builder classes (`TableBuilder`, `ModelBuilder`, `ContractBuilder`) that handle state management
+- **Type helpers**: Generic type-level helpers for transforming builder states into contract structures
+- **No target-specific logic**: This package must remain target-family agnostic and cannot import from `@prisma-next/sql-*` or other family-specific modules
+
+## Dependencies
+
+- `@prisma-next/contract` - Core contract types
+- `ts-toolbelt` - Type utilities
+
+## Exports
+
+- Builder state types: `ColumnBuilderState`, `TableBuilderState`, `ModelBuilderState`, `ContractBuilderState`, `RelationDefinition`, `ColumnBuilder`
+- Builder classes: `TableBuilder`, `ModelBuilder`, `ContractBuilder`
+- Type helpers: `BuildStorageColumn`, `BuildStorage`, `BuildModels`, `BuildRelations`, extract helpers, `Mutable`
+- Factory function: `defineContract()` (generic)
+
+## Usage
+
+This package is intended for use by target-family specific authoring packages (e.g., `@prisma-next/sql-contract-ts`). End users should import from the target-family specific packages, not directly from this package.
+
+## See Also
+
+- `@prisma-next/sql-contract-ts` - SQL-specific contract authoring surface that composes this generic core

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+interface ColumnBuilderState<Name extends string, Nullable extends boolean, Type extends string> {
+    readonly name: Name;
+    readonly nullable: Nullable;
+    readonly type: Type;
+}
+interface TableBuilderState<Name extends string, Columns extends Record<string, ColumnBuilderState<string, boolean, string>>, PrimaryKey extends readonly string[] | undefined> {
+    readonly name: Name;
+    readonly columns: Columns;
+    readonly primaryKey?: PrimaryKey;
+}
+type RelationDefinition = {
+    readonly to: string;
+    readonly cardinality: '1:1' | '1:N' | 'N:1' | 'N:M';
+    readonly on: {
+        readonly parentCols: readonly string[];
+        readonly childCols: readonly string[];
+    };
+    readonly through?: {
+        readonly table: string;
+        readonly parentCols: readonly string[];
+        readonly childCols: readonly string[];
+    };
+};
+interface ModelBuilderState<Name extends string, Table extends string, Fields extends Record<string, string>, Relations extends Record<string, RelationDefinition>> {
+    readonly name: Name;
+    readonly table: Table;
+    readonly fields: Fields;
+    readonly relations: Relations;
+}
+interface ContractBuilderState<Target extends string | undefined = string | undefined, Tables extends Record<string, TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>> = Record<never, TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>>, Models extends Record<string, ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>> = Record<never, ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>>, CoreHash extends string | undefined = string | undefined, Extensions extends Record<string, unknown> | undefined = undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined> {
+    readonly target?: Target;
+    readonly tables: Tables;
+    readonly models: Models;
+    readonly coreHash?: CoreHash;
+    readonly extensions?: Extensions;
+    readonly capabilities?: Capabilities;
+}
+interface ColumnBuilder<Name extends string, Nullable extends boolean, Type extends string> {
+    nullable<Value extends boolean>(value?: Value): ColumnBuilder<Name, Value, Type>;
+    type<Id extends string>(id: Id): ColumnBuilder<Name, Nullable, Id>;
+    build(): ColumnBuilderState<Name, Nullable, Type>;
+}
+
+declare class ModelBuilder<Name extends string, Table extends string, Fields extends Record<string, string> = Record<never, never>, Relations extends Record<string, RelationDefinition> = Record<never, never>> {
+    private readonly _name;
+    private readonly _table;
+    private readonly _fields;
+    private readonly _relations;
+    constructor(name: Name, table: Table, fields?: Fields, relations?: Relations);
+    field<FieldName extends string, ColumnName extends string>(fieldName: FieldName, columnName: ColumnName): ModelBuilder<Name, Table, Fields & Record<FieldName, ColumnName>, Relations>;
+    relation<RelationName extends string, ToModel extends string, ToTable extends string>(name: RelationName, options: {
+        toModel: ToModel;
+        toTable: ToTable;
+        cardinality: '1:1' | '1:N' | 'N:1';
+        on: {
+            parentTable: Table;
+            parentColumns: readonly string[];
+            childTable: ToTable;
+            childColumns: readonly string[];
+        };
+    }): ModelBuilder<Name, Table, Fields, Relations & Record<RelationName, RelationDefinition>>;
+    relation<RelationName extends string, ToModel extends string, ToTable extends string, JunctionTable extends string>(name: RelationName, options: {
+        toModel: ToModel;
+        toTable: ToTable;
+        cardinality: 'N:M';
+        through: {
+            table: JunctionTable;
+            parentColumns: readonly string[];
+            childColumns: readonly string[];
+        };
+        on: {
+            parentTable: Table;
+            parentColumns: readonly string[];
+            childTable: JunctionTable;
+            childColumns: readonly string[];
+        };
+    }): ModelBuilder<Name, Table, Fields, Relations & Record<RelationName, RelationDefinition>>;
+    build(): ModelBuilderState<Name, Table, Fields, Relations>;
+}
+
+declare class TableBuilder<Name extends string, Columns extends Record<string, ColumnBuilderState<string, boolean, string>> = Record<never, ColumnBuilderState<string, boolean, string>>, PrimaryKey extends readonly string[] | undefined = undefined> {
+    private readonly _name;
+    private readonly _columns;
+    private readonly _primaryKey;
+    constructor(name: Name, columns?: Columns, primaryKey?: PrimaryKey);
+    column<ColName extends string, TypeId extends string, Nullable extends boolean | undefined = undefined>(name: ColName, options: {
+        type: TypeId;
+        nullable?: Nullable;
+    }): TableBuilder<Name, Columns & Record<ColName, ColumnBuilderState<ColName, Nullable extends true ? true : false, TypeId>>, PrimaryKey>;
+    primaryKey<PK extends readonly string[]>(columns: PK, _name?: string): TableBuilder<Name, Columns, PK>;
+    unique(_columns: readonly string[], _name?: string): TableBuilder<Name, Columns, PrimaryKey>;
+    index(_columns: readonly string[], _name?: string): TableBuilder<Name, Columns, PrimaryKey>;
+    foreignKey(_columns: readonly string[], _references: {
+        table: string;
+        columns: readonly string[];
+    }, _name?: string): TableBuilder<Name, Columns, PrimaryKey>;
+    build(): TableBuilderState<Name, Columns, PrimaryKey>;
+}
+
+declare class ContractBuilder<Target extends string | undefined = undefined, Tables extends Record<string, TableBuilderState<string, Record<string, {
+    readonly name: string;
+    readonly nullable: boolean;
+    readonly type: string;
+}>, readonly string[] | undefined>> = Record<never, never>, Models extends Record<string, ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>> = Record<never, never>, CoreHash extends string | undefined = undefined, Extensions extends Record<string, unknown> | undefined = undefined, Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined> {
+    protected readonly state: ContractBuilderState<Target, Tables, Models, CoreHash, Extensions, Capabilities>;
+    constructor(state?: ContractBuilderState<Target, Tables, Models, CoreHash, Extensions, Capabilities>);
+    target<T extends string>(target: T): ContractBuilder<T, Tables, Models, CoreHash, Extensions, Capabilities>;
+    extensions<E extends Record<string, unknown>>(extensions: E): ContractBuilder<Target, Tables, Models, CoreHash, E, Capabilities>;
+    capabilities<C extends Record<string, Record<string, boolean>>>(capabilities: C): ContractBuilder<Target, Tables, Models, CoreHash, Extensions, C>;
+    table<TableName extends string, T extends TableBuilder<TableName, Record<string, {
+        readonly name: string;
+        readonly nullable: boolean;
+        readonly type: string;
+    }>, readonly string[] | undefined>>(name: TableName, callback: (t: TableBuilder<TableName>) => T | undefined): ContractBuilder<Target, Tables & Record<TableName, ReturnType<T['build']>>, Models, CoreHash, Extensions, Capabilities>;
+    model<ModelName extends string, TableName extends string, M extends ModelBuilder<ModelName, TableName, Record<string, string>, Record<string, RelationDefinition>>>(name: ModelName, table: TableName, callback: (m: ModelBuilder<ModelName, TableName, Record<string, string>, Record<never, never>>) => M | undefined): ContractBuilder<Target, Tables, Models & Record<ModelName, ReturnType<M['build']>>, CoreHash, Extensions, Capabilities>;
+    coreHash<H extends string>(hash: H): ContractBuilder<Target, Tables, Models, H, Extensions, Capabilities>;
+}
+declare function defineContract(): ContractBuilder;
+
+type BuildStorageColumn<Nullable extends boolean, Type extends string> = {
+    readonly type: Type;
+    readonly nullable: Nullable;
+};
+type ExtractColumns<T extends TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>> = T extends TableBuilderState<string, infer C, readonly string[] | undefined> ? C : never;
+type ExtractPrimaryKey<T extends TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>> = T extends TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, infer PK> ? PK : never;
+type BuildStorage<Tables extends Record<string, TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>>> = {
+    readonly tables: {
+        readonly [K in keyof Tables]: {
+            readonly columns: {
+                readonly [ColK in keyof ExtractColumns<Tables[K]>]: ExtractColumns<Tables[K]>[ColK] extends ColumnBuilderState<string, infer Null, infer TType> ? BuildStorageColumn<Null & boolean, TType> : never;
+            };
+        };
+    };
+};
+type BuildStorageTables<Tables extends Record<string, TableBuilderState<string, Record<string, ColumnBuilderState<string, boolean, string>>, readonly string[] | undefined>>> = {
+    readonly [K in keyof Tables]: {
+        readonly columns: {
+            readonly [ColK in keyof ExtractColumns<Tables[K]>]: ExtractColumns<Tables[K]>[ColK] extends ColumnBuilderState<string, infer Null, infer TType> ? BuildStorageColumn<Null & boolean, TType> : never;
+        };
+    };
+};
+type Mutable<T> = {
+    -readonly [K in keyof T]-?: T[K];
+};
+type BuildModelFields<Fields extends Record<string, string>> = {
+    readonly [K in keyof Fields]: {
+        readonly column: Fields[K];
+    };
+};
+type ExtractModelFields<T extends ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>> = T extends ModelBuilderState<string, string, infer F, Record<string, RelationDefinition>> ? F : never;
+type ExtractModelRelations<T extends ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>> = T extends ModelBuilderState<string, string, Record<string, string>, infer R> ? R : never;
+type BuildModels<Models extends Record<string, ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>>> = {
+    readonly [K in keyof Models]: {
+        readonly storage: {
+            readonly table: Models[K]['table'];
+        };
+        readonly fields: BuildModelFields<ExtractModelFields<Models[K]>>;
+    };
+};
+type BuildRelations<Models extends Record<string, ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>>> = {
+    readonly [K in keyof Models as Models[K]['table']]: ExtractModelRelations<Models[K]>;
+};
+
+export { type BuildModelFields, type BuildModels, type BuildRelations, type BuildStorage, type BuildStorageColumn, type BuildStorageTables, type ColumnBuilder, type ColumnBuilderState, ContractBuilder, type ContractBuilderState, type ExtractColumns, type ExtractModelFields, type ExtractModelRelations, type ExtractPrimaryKey, ModelBuilder, type ModelBuilderState, type Mutable, type RelationDefinition, TableBuilder, type TableBuilderState, defineContract };

package/dist/index.js

@@ -0,0 +1,187 @@
+// src/model-builder.ts
+var ModelBuilder = class _ModelBuilder {
+  _name;
+  _table;
+  _fields;
+  _relations;
+  constructor(name, table, fields = {}, relations = {}) {
+    this._name = name;
+    this._table = table;
+    this._fields = fields;
+    this._relations = relations;
+  }
+  field(fieldName, columnName) {
+    return new _ModelBuilder(
+      this._name,
+      this._table,
+      {
+        ...this._fields,
+        [fieldName]: columnName
+      },
+      this._relations
+    );
+  }
+  relation(name, options) {
+    if (options.on.parentTable !== this._table) {
+      throw new Error(
+        `Relation "${name}" parentTable "${options.on.parentTable}" does not match model table "${this._table}"`
+      );
+    }
+    if (options.cardinality === "N:M") {
+      if (!options.through) {
+        throw new Error(`Relation "${name}" with cardinality "N:M" requires through field`);
+      }
+      if (options.on.childTable !== options.through.table) {
+        throw new Error(
+          `Relation "${name}" childTable "${options.on.childTable}" does not match through.table "${options.through.table}"`
+        );
+      }
+    } else {
+      if (options.on.childTable !== options.toTable) {
+        throw new Error(
+          `Relation "${name}" childTable "${options.on.childTable}" does not match toTable "${options.toTable}"`
+        );
+      }
+    }
+    const relationDef = {
+      to: options.toModel,
+      cardinality: options.cardinality,
+      on: {
+        parentCols: options.on.parentColumns,
+        childCols: options.on.childColumns
+      },
+      ...options.through ? {
+        through: {
+          table: options.through.table,
+          parentCols: options.through.parentColumns,
+          childCols: options.through.childColumns
+        }
+      } : void 0
+    };
+    return new _ModelBuilder(this._name, this._table, this._fields, {
+      ...this._relations,
+      [name]: relationDef
+    });
+  }
+  build() {
+    return {
+      name: this._name,
+      table: this._table,
+      fields: this._fields,
+      relations: this._relations
+    };
+  }
+};
+
+// src/table-builder.ts
+var TableBuilder = class _TableBuilder {
+  _name;
+  _columns;
+  _primaryKey;
+  constructor(name, columns = {}, primaryKey) {
+    this._name = name;
+    this._columns = columns;
+    this._primaryKey = primaryKey;
+  }
+  column(name, options) {
+    if (!options.type || typeof options.type !== "string" || !options.type.includes("@")) {
+      throw new Error(`type must be in format "namespace/name@version", got "${options.type}"`);
+    }
+    const nullable = options.nullable ?? false;
+    const type = options.type;
+    const columnState = {
+      name,
+      nullable,
+      type
+    };
+    return new _TableBuilder(
+      this._name,
+      { ...this._columns, [name]: columnState },
+      this._primaryKey
+    );
+  }
+  primaryKey(columns, _name) {
+    return new _TableBuilder(this._name, this._columns, columns);
+  }
+  unique(_columns, _name) {
+    return this;
+  }
+  index(_columns, _name) {
+    return this;
+  }
+  foreignKey(_columns, _references, _name) {
+    return this;
+  }
+  build() {
+    return {
+      name: this._name,
+      columns: this._columns,
+      ...this._primaryKey !== void 0 ? { primaryKey: this._primaryKey } : {}
+    };
+  }
+};
+
+// src/contract-builder.ts
+var ContractBuilder = class _ContractBuilder {
+  state;
+  constructor(state) {
+    this.state = state ?? {
+      tables: {},
+      models: {}
+    };
+  }
+  target(target) {
+    return new _ContractBuilder({
+      ...this.state,
+      target
+    });
+  }
+  extensions(extensions) {
+    return new _ContractBuilder({
+      ...this.state,
+      extensions
+    });
+  }
+  capabilities(capabilities) {
+    return new _ContractBuilder({
+      ...this.state,
+      capabilities
+    });
+  }
+  table(name, callback) {
+    const tableBuilder = new TableBuilder(name);
+    const result = callback(tableBuilder);
+    const finalBuilder = result instanceof TableBuilder ? result : tableBuilder;
+    const tableState = finalBuilder.build();
+    return new _ContractBuilder({
+      ...this.state,
+      tables: { ...this.state.tables, [name]: tableState }
+    });
+  }
+  model(name, table, callback) {
+    const modelBuilder = new ModelBuilder(name, table);
+    const result = callback(modelBuilder);
+    const finalBuilder = result instanceof ModelBuilder ? result : modelBuilder;
+    const modelState = finalBuilder.build();
+    return new _ContractBuilder({
+      ...this.state,
+      models: { ...this.state.models, [name]: modelState }
+    });
+  }
+  coreHash(hash) {
+    return new _ContractBuilder({
+      ...this.state,
+      coreHash: hash
+    });
+  }
+};
+function defineContract() {
+  return new ContractBuilder();
+}
+export {
+  ContractBuilder,
+  ModelBuilder,
+  TableBuilder,
+  defineContract
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/model-builder.ts","../src/table-builder.ts","../src/contract-builder.ts"],"sourcesContent":["import type { ModelBuilderState, RelationDefinition } from './builder-state';\n\nexport class ModelBuilder<\n  Name extends string,\n  Table extends string,\n  Fields extends Record<string, string> = Record<never, never>,\n  Relations extends Record<string, RelationDefinition> = Record<never, never>,\n> {\n  private readonly _name: Name;\n  private readonly _table: Table;\n  private readonly _fields: Fields;\n  private readonly _relations: Relations;\n\n  constructor(\n    name: Name,\n    table: Table,\n    fields: Fields = {} as Fields,\n    relations: Relations = {} as Relations,\n  ) {\n    this._name = name;\n    this._table = table;\n    this._fields = fields;\n    this._relations = relations;\n  }\n\n  field<FieldName extends string, ColumnName extends string>(\n    fieldName: FieldName,\n    columnName: ColumnName,\n  ): ModelBuilder<Name, Table, Fields & Record<FieldName, ColumnName>, Relations> {\n    return new ModelBuilder(\n      this._name,\n      this._table,\n      {\n        ...this._fields,\n        [fieldName]: columnName,\n      } as Fields & Record<FieldName, ColumnName>,\n      this._relations,\n    );\n  }\n\n  relation<RelationName extends string, ToModel extends string, ToTable extends string>(\n    name: RelationName,\n    options: {\n      toModel: ToModel;\n      toTable: ToTable;\n      cardinality: '1:1' | '1:N' | 'N:1';\n      on: {\n        parentTable: Table;\n        parentColumns: readonly string[];\n        childTable: ToTable;\n        childColumns: readonly string[];\n      };\n    },\n  ): ModelBuilder<Name, Table, Fields, Relations & Record<RelationName, RelationDefinition>>;\n  relation<\n    RelationName extends string,\n    ToModel extends string,\n    ToTable extends string,\n    JunctionTable extends string,\n  >(\n    name: RelationName,\n    options: {\n      toModel: ToModel;\n      toTable: ToTable;\n      cardinality: 'N:M';\n      through: {\n        table: JunctionTable;\n        parentColumns: readonly string[];\n        childColumns: readonly string[];\n      };\n      on: {\n        parentTable: Table;\n        parentColumns: readonly string[];\n        childTable: JunctionTable;\n        childColumns: readonly string[];\n      };\n    },\n  ): ModelBuilder<Name, Table, Fields, Relations & Record<RelationName, RelationDefinition>>;\n  relation<\n    RelationName extends string,\n    ToModel extends string,\n    ToTable extends string,\n    JunctionTable extends string = never,\n  >(\n    name: RelationName,\n    options: {\n      toModel: ToModel;\n      toTable: ToTable;\n      cardinality: '1:1' | '1:N' | 'N:1' | 'N:M';\n      through?: {\n        table: JunctionTable;\n        parentColumns: readonly string[];\n        childColumns: readonly string[];\n      };\n      on: {\n        parentTable: Table;\n        parentColumns: readonly string[];\n        childTable: ToTable | JunctionTable;\n        childColumns: readonly string[];\n      };\n    },\n  ): ModelBuilder<Name, Table, Fields, Relations & Record<RelationName, RelationDefinition>> {\n    // Validate parentTable matches model's table\n    if (options.on.parentTable !== this._table) {\n      throw new Error(\n        `Relation \"${name}\" parentTable \"${options.on.parentTable}\" does not match model table \"${this._table}\"`,\n      );\n    }\n\n    // Validate childTable matches toTable (for non-N:M) or through.table (for N:M)\n    if (options.cardinality === 'N:M') {\n      if (!options.through) {\n        throw new Error(`Relation \"${name}\" with cardinality \"N:M\" requires through field`);\n      }\n      if (options.on.childTable !== options.through.table) {\n        throw new Error(\n          `Relation \"${name}\" childTable \"${options.on.childTable}\" does not match through.table \"${options.through.table}\"`,\n        );\n      }\n    } else {\n      if (options.on.childTable !== options.toTable) {\n        throw new Error(\n          `Relation \"${name}\" childTable \"${options.on.childTable}\" does not match toTable \"${options.toTable}\"`,\n        );\n      }\n    }\n\n    const relationDef: RelationDefinition = {\n      to: options.toModel,\n      cardinality: options.cardinality,\n      on: {\n        parentCols: options.on.parentColumns,\n        childCols: options.on.childColumns,\n      },\n      ...(options.through\n        ? {\n            through: {\n              table: options.through.table,\n              parentCols: options.through.parentColumns,\n              childCols: options.through.childColumns,\n            },\n          }\n        : undefined),\n    };\n\n    return new ModelBuilder(this._name, this._table, this._fields, {\n      ...this._relations,\n      [name]: relationDef,\n    } as Relations & Record<RelationName, RelationDefinition>);\n  }\n\n  build(): ModelBuilderState<Name, Table, Fields, Relations> {\n    return {\n      name: this._name,\n      table: this._table,\n      fields: this._fields,\n      relations: this._relations,\n    };\n  }\n}\n","import type { ColumnBuilderState, TableBuilderState } from './builder-state';\n\nexport class TableBuilder<\n  Name extends string,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>> = Record<\n    never,\n    ColumnBuilderState<string, boolean, string>\n  >,\n  PrimaryKey extends readonly string[] | undefined = undefined,\n> {\n  private readonly _name: Name;\n  private readonly _columns: Columns;\n  private readonly _primaryKey: PrimaryKey;\n\n  constructor(name: Name, columns: Columns = {} as Columns, primaryKey?: PrimaryKey) {\n    this._name = name;\n    this._columns = columns;\n    this._primaryKey = primaryKey as PrimaryKey;\n  }\n\n  column<\n    ColName extends string,\n    TypeId extends string,\n    Nullable extends boolean | undefined = undefined,\n  >(\n    name: ColName,\n    options: {\n      type: TypeId;\n      nullable?: Nullable;\n    },\n  ): TableBuilder<\n    Name,\n    Columns &\n      Record<ColName, ColumnBuilderState<ColName, Nullable extends true ? true : false, TypeId>>,\n    PrimaryKey\n  > {\n    if (!options.type || typeof options.type !== 'string' || !options.type.includes('@')) {\n      throw new Error(`type must be in format \"namespace/name@version\", got \"${options.type}\"`);\n    }\n    const nullable = (options.nullable ?? false) as Nullable extends true ? true : false;\n    const type = options.type;\n    const columnState = {\n      name,\n      nullable,\n      type,\n    } as ColumnBuilderState<ColName, Nullable extends true ? true : false, TypeId>;\n    return new TableBuilder(\n      this._name,\n      { ...this._columns, [name]: columnState } as Columns &\n        Record<ColName, ColumnBuilderState<ColName, Nullable extends true ? true : false, TypeId>>,\n      this._primaryKey,\n    );\n  }\n\n  primaryKey<PK extends readonly string[]>(\n    columns: PK,\n    _name?: string,\n  ): TableBuilder<Name, Columns, PK> {\n    return new TableBuilder(this._name, this._columns, columns);\n  }\n\n  unique(_columns: readonly string[], _name?: string): TableBuilder<Name, Columns, PrimaryKey> {\n    return this;\n  }\n\n  index(_columns: readonly string[], _name?: string): TableBuilder<Name, Columns, PrimaryKey> {\n    return this;\n  }\n\n  foreignKey(\n    _columns: readonly string[],\n    _references: { table: string; columns: readonly string[] },\n    _name?: string,\n  ): TableBuilder<Name, Columns, PrimaryKey> {\n    return this;\n  }\n\n  build(): TableBuilderState<Name, Columns, PrimaryKey> {\n    return {\n      name: this._name,\n      columns: this._columns,\n      ...(this._primaryKey !== undefined ? { primaryKey: this._primaryKey } : {}),\n    } as TableBuilderState<Name, Columns, PrimaryKey>;\n  }\n}\n","import type {\n  ContractBuilderState,\n  ModelBuilderState,\n  RelationDefinition,\n  TableBuilderState,\n} from './builder-state';\nimport { ModelBuilder } from './model-builder';\nimport { TableBuilder } from './table-builder';\n\nexport class ContractBuilder<\n  Target extends string | undefined = undefined,\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, { readonly name: string; readonly nullable: boolean; readonly type: string }>,\n      readonly string[] | undefined\n    >\n  > = Record<never, never>,\n  Models extends Record<\n    string,\n    ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>\n  > = Record<never, never>,\n  CoreHash extends string | undefined = undefined,\n  Extensions extends Record<string, unknown> | undefined = undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n> {\n  protected readonly state: ContractBuilderState<\n    Target,\n    Tables,\n    Models,\n    CoreHash,\n    Extensions,\n    Capabilities\n  >;\n\n  constructor(\n    state?: ContractBuilderState<Target, Tables, Models, CoreHash, Extensions, Capabilities>,\n  ) {\n    this.state =\n      state ??\n      ({\n        tables: {},\n        models: {},\n      } as ContractBuilderState<Target, Tables, Models, CoreHash, Extensions, Capabilities>);\n  }\n\n  target<T extends string>(\n    target: T,\n  ): ContractBuilder<T, Tables, Models, CoreHash, Extensions, Capabilities> {\n    return new ContractBuilder<T, Tables, Models, CoreHash, Extensions, Capabilities>({\n      ...this.state,\n      target,\n    });\n  }\n\n  extensions<E extends Record<string, unknown>>(\n    extensions: E,\n  ): ContractBuilder<Target, Tables, Models, CoreHash, E, Capabilities> {\n    return new ContractBuilder<Target, Tables, Models, CoreHash, E, Capabilities>({\n      ...this.state,\n      extensions,\n    });\n  }\n\n  capabilities<C extends Record<string, Record<string, boolean>>>(\n    capabilities: C,\n  ): ContractBuilder<Target, Tables, Models, CoreHash, Extensions, C> {\n    return new ContractBuilder<Target, Tables, Models, CoreHash, Extensions, C>({\n      ...this.state,\n      capabilities,\n    });\n  }\n\n  table<\n    TableName extends string,\n    T extends TableBuilder<\n      TableName,\n      Record<string, { readonly name: string; readonly nullable: boolean; readonly type: string }>,\n      readonly string[] | undefined\n    >,\n  >(\n    name: TableName,\n    callback: (t: TableBuilder<TableName>) => T | undefined,\n  ): ContractBuilder<\n    Target,\n    Tables & Record<TableName, ReturnType<T['build']>>,\n    Models,\n    CoreHash,\n    Extensions,\n    Capabilities\n  > {\n    const tableBuilder = new TableBuilder<TableName>(name);\n    const result = callback(tableBuilder);\n    const finalBuilder = result instanceof TableBuilder ? result : tableBuilder;\n    const tableState = finalBuilder.build();\n\n    return new ContractBuilder<\n      Target,\n      Tables & Record<TableName, ReturnType<T['build']>>,\n      Models,\n      CoreHash,\n      Extensions,\n      Capabilities\n    >({\n      ...this.state,\n      tables: { ...this.state.tables, [name]: tableState } as Tables &\n        Record<TableName, ReturnType<T['build']>>,\n    });\n  }\n\n  model<\n    ModelName extends string,\n    TableName extends string,\n    M extends ModelBuilder<\n      ModelName,\n      TableName,\n      Record<string, string>,\n      Record<string, RelationDefinition>\n    >,\n  >(\n    name: ModelName,\n    table: TableName,\n    callback: (\n      m: ModelBuilder<ModelName, TableName, Record<string, string>, Record<never, never>>,\n    ) => M | undefined,\n  ): ContractBuilder<\n    Target,\n    Tables,\n    Models & Record<ModelName, ReturnType<M['build']>>,\n    CoreHash,\n    Extensions,\n    Capabilities\n  > {\n    const modelBuilder = new ModelBuilder<ModelName, TableName>(name, table);\n    const result = callback(modelBuilder);\n    const finalBuilder = result instanceof ModelBuilder ? result : modelBuilder;\n    const modelState = finalBuilder.build();\n\n    return new ContractBuilder<\n      Target,\n      Tables,\n      Models & Record<ModelName, ReturnType<M['build']>>,\n      CoreHash,\n      Extensions,\n      Capabilities\n    >({\n      ...this.state,\n      models: { ...this.state.models, [name]: modelState } as Models &\n        Record<ModelName, ReturnType<M['build']>>,\n    });\n  }\n\n  coreHash<H extends string>(\n    hash: H,\n  ): ContractBuilder<Target, Tables, Models, H, Extensions, Capabilities> {\n    return new ContractBuilder<Target, Tables, Models, H, Extensions, Capabilities>({\n      ...this.state,\n      coreHash: hash,\n    });\n  }\n}\n\nexport function defineContract(): ContractBuilder {\n  return new ContractBuilder();\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@prisma-next/contract-authoring",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "Target-agnostic contract authoring builder core for Prisma Next",
+  "dependencies": {
+    "ts-toolbelt": "^9.6.0",
+    "@prisma-next/contract": "0.0.1"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^2.1.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.1"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "lint": "biome check . --config-path ../../../../biome.json --error-on-warnings",
+    "clean": "node ../../../../scripts/clean.mjs"
+  }
+}