@prisma-next/contract-authoring 0.3.0-dev.9 → 0.3.0-dev.91

package/dist/index.mjs

@@ -0,0 +1,237 @@
+import { ifDefined } from "@prisma-next/utils/defined";
+
+//#region 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
+		};
+	}
+};
+
+//#endregion
+//#region src/table-builder.ts
+function isIndexDef(value) {
+	return !Array.isArray(value);
+}
+/**
+* Creates a new table builder with the given name.
+* This is the preferred way to create a TableBuilder - it ensures
+* type parameters are inferred correctly without unsafe casts.
+*/
+function createTable(name) {
+	return new TableBuilder(name, {}, void 0, void 0, [], [], []);
+}
+/**
+* Builder for defining table structure with type-safe chaining.
+* Use `createTable(name)` to create instances.
+*/
+var TableBuilder = class TableBuilder {
+	_state;
+	/** @internal Use createTable() instead */
+	constructor(name, columns, primaryKey, primaryKeyName, uniques, indexes, foreignKeys) {
+		this._state = {
+			name,
+			columns,
+			primaryKey,
+			primaryKeyName,
+			uniques,
+			indexes,
+			foreignKeys
+		};
+	}
+	get _name() {
+		return this._state.name;
+	}
+	get _columns() {
+		return this._state.columns;
+	}
+	get _primaryKey() {
+		return this._state.primaryKey;
+	}
+	/**
+	* Implementation of the column method.
+	*/
+	column(name, options) {
+		return this.columnInternal(name, options);
+	}
+	generated(name, options) {
+		const { generated, ...columnOptions } = options;
+		return this.columnInternal(name, columnOptions, generated);
+	}
+	columnInternal(name, options, executionDefault) {
+		const nullable = options.nullable ?? false;
+		const { codecId, nativeType, typeParams: descriptorTypeParams, typeRef } = options.type;
+		const columnState = {
+			name,
+			nullable,
+			type: codecId,
+			nativeType,
+			...ifDefined("typeParams", options.typeParams ?? descriptorTypeParams),
+			...ifDefined("typeRef", typeRef),
+			...ifDefined("default", "default" in options ? options.default : void 0),
+			...ifDefined("executionDefault", executionDefault)
+		};
+		const newColumns = {
+			...this._columns,
+			[name]: columnState
+		};
+		return new TableBuilder(this._state.name, newColumns, this._state.primaryKey, this._state.primaryKeyName, this._state.uniques, this._state.indexes, this._state.foreignKeys);
+	}
+	primaryKey(columns, name) {
+		return new TableBuilder(this._state.name, this._state.columns, columns, name, this._state.uniques, this._state.indexes, this._state.foreignKeys);
+	}
+	unique(columns, name) {
+		const constraint = name ? {
+			columns,
+			name
+		} : { columns };
+		return new TableBuilder(this._state.name, this._state.columns, this._state.primaryKey, this._state.primaryKeyName, [...this._state.uniques, constraint], this._state.indexes, this._state.foreignKeys);
+	}
+	index(columnsOrIndexDef, nameOrOptions) {
+		const indexDef = isIndexDef(columnsOrIndexDef) ? columnsOrIndexDef : {
+			columns: columnsOrIndexDef,
+			...typeof nameOrOptions === "string" ? { name: nameOrOptions } : {},
+			...typeof nameOrOptions === "object" && nameOrOptions !== null ? {
+				...nameOrOptions.name !== void 0 ? { name: nameOrOptions.name } : {},
+				...nameOrOptions.using !== void 0 ? { using: nameOrOptions.using } : {},
+				...nameOrOptions.config !== void 0 ? { config: nameOrOptions.config } : {}
+			} : {}
+		};
+		return new TableBuilder(this._state.name, this._state.columns, this._state.primaryKey, this._state.primaryKeyName, this._state.uniques, [...this._state.indexes, indexDef], this._state.foreignKeys);
+	}
+	foreignKey(columns, references, opts) {
+		const resolved = typeof opts === "string" ? { name: opts } : opts;
+		const fkDef = {
+			columns,
+			references,
+			...ifDefined("name", resolved?.name),
+			...ifDefined("onDelete", resolved?.onDelete),
+			...ifDefined("onUpdate", resolved?.onUpdate),
+			...ifDefined("constraint", resolved?.constraint),
+			...ifDefined("index", resolved?.index)
+		};
+		return new TableBuilder(this._state.name, this._state.columns, this._state.primaryKey, this._state.primaryKeyName, this._state.uniques, this._state.indexes, [...this._state.foreignKeys, fkDef]);
+	}
+	build() {
+		return {
+			name: this._name,
+			columns: this._columns,
+			...this._primaryKey !== void 0 ? { primaryKey: this._primaryKey } : {},
+			...this._state.primaryKeyName !== void 0 ? { primaryKeyName: this._state.primaryKeyName } : {},
+			uniques: this._state.uniques,
+			indexes: this._state.indexes,
+			foreignKeys: this._state.foreignKeys
+		};
+	}
+};
+
+//#endregion
+//#region src/contract-builder.ts
+var ContractBuilder = class ContractBuilder {
+	state;
+	constructor(state) {
+		this.state = state ?? {
+			tables: {},
+			models: {}
+		};
+	}
+	target(packRef) {
+		return new ContractBuilder({
+			...this.state,
+			target: packRef.targetId
+		});
+	}
+	capabilities(capabilities) {
+		return new ContractBuilder({
+			...this.state,
+			capabilities
+		});
+	}
+	table(name, callback) {
+		const tableBuilder = createTable(name);
+		const result = callback(tableBuilder);
+		const tableState = (result instanceof TableBuilder ? result : tableBuilder).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 modelState = (result instanceof ModelBuilder ? result : modelBuilder).build();
+		return new ContractBuilder({
+			...this.state,
+			models: {
+				...this.state.models,
+				[name]: modelState
+			}
+		});
+	}
+	storageHash(hash) {
+		return new ContractBuilder({
+			...this.state,
+			storageHash: hash
+		});
+	}
+	foreignKeyDefaults(config) {
+		return new ContractBuilder({
+			...this.state,
+			foreignKeyDefaults: config
+		});
+	}
+};
+function defineContract() {
+	return new ContractBuilder();
+}
+
+//#endregion
+export { ContractBuilder, ModelBuilder, TableBuilder, createTable, defineContract };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["relationDef: RelationDefinition","constraint: UniqueConstraintDef","indexDef: IndexDef","fkDef: ForeignKeyDef"],"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 { ColumnDefault, ExecutionMutationDefaultValue } from '@prisma-next/contract/types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type {\n  ColumnBuilderState,\n  ColumnTypeDescriptor,\n  ForeignKeyDef,\n  ForeignKeyOptions,\n  IndexDef,\n  TableBuilderState,\n  UniqueConstraintDef,\n} from './builder-state';\n\n/**\n * Column options for nullable columns.\n */\ninterface NullableColumnOptions<Descriptor extends ColumnTypeDescriptor> {\n  type: Descriptor;\n  nullable: true;\n  typeParams?: Record<string, unknown>;\n  default?: ColumnDefault;\n}\n\n/**\n * Column options for non-nullable columns.\n * Non-nullable columns can optionally have a default value.\n */\ninterface NonNullableColumnOptions<Descriptor extends ColumnTypeDescriptor> {\n  type: Descriptor;\n  nullable?: false;\n  typeParams?: Record<string, unknown>;\n  default?: ColumnDefault;\n}\n\ntype GeneratedColumnOptions<Descriptor extends ColumnTypeDescriptor> = Omit<\n  NonNullableColumnOptions<Descriptor>,\n  'default' | 'nullable'\n> & {\n  /**\n   * Generated columns are always non-nullable and use mutation-time defaults\n   * that the runtime injects when the column is omitted from insert input.\n   */\n  nullable?: false;\n  generated: ExecutionMutationDefaultValue;\n};\n\n/** Column options for any column nullability. */\ntype ColumnOptions<Descriptor extends ColumnTypeDescriptor> =\n  | NullableColumnOptions<Descriptor>\n  | NonNullableColumnOptions<Descriptor>;\n\ntype NullableFromOptions<TOptions> = TOptions extends { nullable: true } ? true : false;\ntype IndexOptions = {\n  readonly name?: string;\n  readonly using?: string;\n  readonly config?: Record<string, unknown>;\n};\n\nfunction isIndexDef(value: readonly string[] | IndexDef): value is IndexDef {\n  return !Array.isArray(value);\n}\n\ninterface TableBuilderInternalState<\n  Name extends string,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>>,\n  PrimaryKey extends readonly string[] | undefined,\n> {\n  readonly name: Name;\n  readonly columns: Columns;\n  readonly primaryKey: PrimaryKey;\n  readonly primaryKeyName: string | undefined;\n  readonly uniques: readonly UniqueConstraintDef[];\n  readonly indexes: readonly IndexDef[];\n  readonly foreignKeys: readonly ForeignKeyDef[];\n}\n\n/**\n * Creates a new table builder with the given name.\n * This is the preferred way to create a TableBuilder - it ensures\n * type parameters are inferred correctly without unsafe casts.\n */\nexport function createTable<Name extends string>(name: Name): TableBuilder<Name> {\n  return new TableBuilder(name, {}, undefined, undefined, [], [], []);\n}\n\n/**\n * Builder for defining table structure with type-safe chaining.\n * Use `createTable(name)` to create instances.\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 _state: TableBuilderInternalState<Name, Columns, PrimaryKey>;\n\n  /** @internal Use createTable() instead */\n  constructor(\n    name: Name,\n    columns: Columns,\n    primaryKey: PrimaryKey,\n    primaryKeyName: string | undefined,\n    uniques: readonly UniqueConstraintDef[],\n    indexes: readonly IndexDef[],\n    foreignKeys: readonly ForeignKeyDef[],\n  ) {\n    this._state = {\n      name,\n      columns,\n      primaryKey,\n      primaryKeyName,\n      uniques,\n      indexes,\n      foreignKeys,\n    };\n  }\n\n  private get _name(): Name {\n    return this._state.name;\n  }\n\n  private get _columns(): Columns {\n    return this._state.columns;\n  }\n\n  private get _primaryKey(): PrimaryKey {\n    return this._state.primaryKey;\n  }\n\n  /** Add a nullable column to the table. */\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: NullableColumnOptions<Descriptor>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, true, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n\n  /**\n   * Add a non-nullable column to the table.\n   * Non-nullable columns can optionally have a default value.\n   */\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: NonNullableColumnOptions<Descriptor>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n\n  /**\n   * Implementation of the column method.\n   */\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: ColumnOptions<Descriptor>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, boolean, Descriptor['codecId']>>,\n    PrimaryKey\n  > {\n    return this.columnInternal(name, options);\n  }\n\n  generated<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: GeneratedColumnOptions<Descriptor>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  > {\n    const { generated, ...columnOptions } = options;\n    return this.columnInternal(name, columnOptions, generated);\n  }\n\n  private columnInternal<\n    ColName extends string,\n    Descriptor extends ColumnTypeDescriptor,\n    Options extends ColumnOptions<Descriptor>,\n  >(\n    name: ColName,\n    options: Options,\n    executionDefault?: ExecutionMutationDefaultValue,\n  ): TableBuilder<\n    Name,\n    Columns &\n      Record<\n        ColName,\n        ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>\n      >,\n    PrimaryKey\n  > {\n    const nullable = options.nullable ?? false;\n    const { codecId, nativeType, typeParams: descriptorTypeParams, typeRef } = options.type;\n    const typeParams = options.typeParams ?? descriptorTypeParams;\n\n    const columnState = {\n      name,\n      nullable,\n      type: codecId,\n      nativeType,\n      ...ifDefined('typeParams', typeParams),\n      ...ifDefined('typeRef', typeRef),\n      ...ifDefined('default', 'default' in options ? options.default : undefined),\n      ...ifDefined('executionDefault', executionDefault),\n    } as ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>;\n    const newColumns = { ...this._columns, [name]: columnState } as Columns &\n      Record<\n        ColName,\n        ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>\n      >;\n    return new TableBuilder(\n      this._state.name,\n      newColumns,\n      this._state.primaryKey,\n      this._state.primaryKeyName,\n      this._state.uniques,\n      this._state.indexes,\n      this._state.foreignKeys,\n    );\n  }\n\n  primaryKey<PK extends readonly string[]>(\n    columns: PK,\n    name?: string,\n  ): TableBuilder<Name, Columns, PK> {\n    return new TableBuilder(\n      this._state.name,\n      this._state.columns,\n      columns,\n      name,\n      this._state.uniques,\n      this._state.indexes,\n      this._state.foreignKeys,\n    );\n  }\n\n  unique(columns: readonly string[], name?: string): TableBuilder<Name, Columns, PrimaryKey> {\n    const constraint: UniqueConstraintDef = name ? { columns, name } : { columns };\n    return new TableBuilder(\n      this._state.name,\n      this._state.columns,\n      this._state.primaryKey,\n      this._state.primaryKeyName,\n      [...this._state.uniques, constraint],\n      this._state.indexes,\n      this._state.foreignKeys,\n    );\n  }\n\n  index(columns: readonly string[], name?: string): TableBuilder<Name, Columns, PrimaryKey>;\n  index(\n    columns: readonly string[],\n    options?: IndexOptions,\n  ): TableBuilder<Name, Columns, PrimaryKey>;\n  index(indexDef: IndexDef): TableBuilder<Name, Columns, PrimaryKey>;\n  index(\n    columnsOrIndexDef: readonly string[] | IndexDef,\n    nameOrOptions?: string | IndexOptions,\n  ): TableBuilder<Name, Columns, PrimaryKey> {\n    const indexDef: IndexDef = isIndexDef(columnsOrIndexDef)\n      ? columnsOrIndexDef\n      : {\n          columns: columnsOrIndexDef,\n          ...(typeof nameOrOptions === 'string' ? { name: nameOrOptions } : {}),\n          ...(typeof nameOrOptions === 'object' && nameOrOptions !== null\n            ? {\n                ...(nameOrOptions.name !== undefined ? { name: nameOrOptions.name } : {}),\n                ...(nameOrOptions.using !== undefined ? { using: nameOrOptions.using } : {}),\n                ...(nameOrOptions.config !== undefined ? { config: nameOrOptions.config } : {}),\n              }\n            : {}),\n        };\n\n    return new TableBuilder(\n      this._state.name,\n      this._state.columns,\n      this._state.primaryKey,\n      this._state.primaryKeyName,\n      this._state.uniques,\n      [...this._state.indexes, indexDef],\n      this._state.foreignKeys,\n    );\n  }\n\n  foreignKey(\n    columns: readonly string[],\n    references: { table: string; columns: readonly string[] },\n    opts?: string | (ForeignKeyOptions & { constraint?: boolean; index?: boolean }),\n  ): TableBuilder<Name, Columns, PrimaryKey> {\n    const resolved = typeof opts === 'string' ? { name: opts } : opts;\n    const fkDef: ForeignKeyDef = {\n      columns,\n      references,\n      ...ifDefined('name', resolved?.name),\n      ...ifDefined('onDelete', resolved?.onDelete),\n      ...ifDefined('onUpdate', resolved?.onUpdate),\n      ...ifDefined('constraint', resolved?.constraint),\n      ...ifDefined('index', resolved?.index),\n    };\n    return new TableBuilder(\n      this._state.name,\n      this._state.columns,\n      this._state.primaryKey,\n      this._state.primaryKeyName,\n      this._state.uniques,\n      this._state.indexes,\n      [...this._state.foreignKeys, fkDef],\n    );\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      ...(this._state.primaryKeyName !== undefined\n        ? { primaryKeyName: this._state.primaryKeyName }\n        : {}),\n      uniques: this._state.uniques,\n      indexes: this._state.indexes,\n      foreignKeys: this._state.foreignKeys,\n    } as TableBuilderState<Name, Columns, PrimaryKey>;\n  }\n}\n","import type { TargetPackRef } from '@prisma-next/contract/framework-components';\nimport type {\n  ColumnBuilderState,\n  ContractBuilderState,\n  ForeignKeyDefaultsState,\n  ModelBuilderState,\n  RelationDefinition,\n  TableBuilderState,\n} from './builder-state';\nimport { ModelBuilder } from './model-builder';\nimport { createTable, 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, ColumnBuilderState<string, boolean, 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  StorageHash extends string | undefined = undefined,\n  ExtensionPacks 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    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  >;\n\n  constructor(\n    state?: ContractBuilderState<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>,\n  ) {\n    this.state =\n      state ??\n      ({\n        tables: {},\n        models: {},\n      } as ContractBuilderState<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>);\n  }\n\n  target<T extends string>(\n    packRef: TargetPackRef<string, T>,\n  ): ContractBuilder<T, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {\n    return new ContractBuilder<T, Tables, Models, StorageHash, ExtensionPacks, Capabilities>({\n      ...this.state,\n      target: packRef.targetId,\n    });\n  }\n\n  capabilities<C extends Record<string, Record<string, boolean>>>(\n    capabilities: C,\n  ): ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, C> {\n    return new ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, C>({\n      ...this.state,\n      capabilities,\n    });\n  }\n\n  table<\n    TableName extends string,\n    T extends TableBuilder<\n      TableName,\n      Record<string, ColumnBuilderState<string, boolean, 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    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    const tableBuilder = createTable(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      StorageHash,\n      ExtensionPacks,\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<never, never>, Record<never, never>>,\n    ) => M | undefined,\n  ): ContractBuilder<\n    Target,\n    Tables,\n    Models & Record<ModelName, ReturnType<M['build']>>,\n    StorageHash,\n    ExtensionPacks,\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      StorageHash,\n      ExtensionPacks,\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  storageHash<H extends string>(\n    hash: H,\n  ): ContractBuilder<Target, Tables, Models, H, ExtensionPacks, Capabilities> {\n    return new ContractBuilder<Target, Tables, Models, H, ExtensionPacks, Capabilities>({\n      ...this.state,\n      storageHash: hash,\n    });\n  }\n\n  foreignKeyDefaults(\n    config: ForeignKeyDefaultsState,\n  ): ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {\n    return new ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>({\n      ...this.state,\n      foreignKeyDefaults: config,\n    });\n  }\n}\n\nexport function defineContract(): ContractBuilder {\n  return new ContractBuilder();\n}\n"],"mappings":"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"}

package/package.json

@@ -1,37 +1,45 @@
 {
   "name": "@prisma-next/contract-authoring",
-  "version": "0.3.0-dev.9",
+  "version": "0.3.0-dev.91",
   "type": "module",
   "sideEffects": false,
   "description": "Target-agnostic contract authoring builder core for Prisma Next",
   "dependencies": {
     "ts-toolbelt": "^9.6.0",
-    "@prisma-next/contract": "0.3.0-dev.9"
+    "@prisma-next/contract": "0.3.0-dev.91",
+    "@prisma-next/utils": "0.3.0-dev.91"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "4.0.16",
-    "tsup": "8.5.1",
+    "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16"
+    "vitest": "4.0.17",
+    "@prisma-next/tsdown": "0.0.0",
+    "@prisma-next/tsconfig": "0.0.0"
   },
   "files": [
     "dist",
     "src"
   ],
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/1-framework/2-authoring/contract"
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
+    "build": "tsdown",
     "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/builder-state.ts

@@ -1,21 +1,106 @@
+import type { ColumnDefault, ExecutionMutationDefaultValue } from '@prisma-next/contract/types';
+
+/**
+ * Duplicated from sql-contract to avoid cross-layer dependency
+ * (framework authoring cannot depend on the SQL domain's contract package).
+ */
+export type ReferentialAction = 'noAction' | 'restrict' | 'cascade' | 'setNull' | 'setDefault';
+
 /**
  * Column type descriptor containing both codec ID and native type.
  * Used when defining columns with descriptor objects instead of string IDs.
+ *
+ * For parameterized types (e.g., `vector(1536)`), the `typeParams` field
+ * carries codec-owned parameters that affect both TypeScript type generation
+ * and native DDL output.
  */
 export type ColumnTypeDescriptor = {
   readonly codecId: string;
   readonly nativeType: string;
+  readonly typeParams?: Record<string, unknown>;
+  readonly typeRef?: string;
 };
 
-export interface ColumnBuilderState<
-  Name extends string,
-  Nullable extends boolean,
-  Type extends string,
-> {
+/**
+ * Base column properties shared by all column states.
+ */
+type ColumnBuilderStateBase<Name extends string, Type extends string> = {
   readonly name: Name;
-  readonly nullable: Nullable;
   readonly type: Type;
   readonly nativeType: string;
+  readonly typeParams?: Record<string, unknown>;
+  readonly typeRef?: string;
+};
+
+export type StorageTypeInstanceState = {
+  readonly codecId: string;
+  readonly nativeType: string;
+  readonly typeParams: Record<string, unknown>;
+};
+
+/**
+ * Column builder state.
+ *
+ * Both nullable and non-nullable columns can define defaults to match database behavior.
+ */
+export type ColumnBuilderState<
+  Name extends string,
+  Nullable extends boolean,
+  Type extends string,
+> = ColumnBuilderStateBase<Name, Type> &
+  (Nullable extends true
+    ? { readonly nullable: true; readonly default?: ColumnDefault }
+    : {
+        readonly nullable: false;
+        readonly default?: ColumnDefault;
+        readonly executionDefault?: ExecutionMutationDefaultValue;
+      });
+
+/**
+ * Unique constraint definition for table builder.
+ */
+export interface UniqueConstraintDef {
+  readonly columns: readonly string[];
+  readonly name?: string;
+}
+
+/**
+ * Index definition for table builder.
+ */
+export interface IndexDef {
+  readonly columns: readonly string[];
+  readonly name?: string;
+  /**
+   * Optional index access method. Extension-specific methods are represented
+   * as strings and interpreted by the owning extension package.
+   */
+  readonly using?: string;
+  /**
+   * Optional extension-owned index configuration payload.
+   */
+  readonly config?: Record<string, unknown>;
+}
+
+/**
+ * Options for configuring a foreign key's name and referential actions.
+ */
+export type ForeignKeyOptions = {
+  readonly name?: string;
+  readonly onDelete?: ReferentialAction;
+  readonly onUpdate?: ReferentialAction;
+};
+
+/**
+ * Foreign key definition for table builder.
+ */
+export interface ForeignKeyDef extends ForeignKeyOptions {
+  readonly columns: readonly string[];
+  readonly references: {
+    readonly table: string;
+    readonly columns: readonly string[];
+  };
+  readonly constraint?: boolean;
+  readonly index?: boolean;
 }
 
 export interface TableBuilderState<
@@ -26,6 +111,10 @@ export interface TableBuilderState<
   readonly name: Name;
   readonly columns: Columns;
   readonly primaryKey?: PrimaryKey;
+  readonly primaryKeyName?: string;
+  readonly uniques: readonly UniqueConstraintDef[];
+  readonly indexes: readonly IndexDef[];
+  readonly foreignKeys: readonly ForeignKeyDef[];
 }
 
 export type RelationDefinition = {
@@ -54,6 +143,11 @@ export interface ModelBuilderState<
   readonly relations: Relations;
 }
 
+export interface ForeignKeyDefaultsState {
+  readonly constraint: boolean;
+  readonly index: boolean;
+}
+
 export interface ContractBuilderState<
   Target extends string | undefined = string | undefined,
   Tables extends Record<
@@ -78,16 +172,18 @@ export interface ContractBuilderState<
     never,
     ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>
   >,
-  CoreHash extends string | undefined = string | undefined,
+  StorageHash extends string | undefined = string | undefined,
   ExtensionPacks 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 storageHash?: StorageHash;
   readonly extensionPacks?: ExtensionPacks;
   readonly capabilities?: Capabilities;
+  readonly storageTypes?: Record<string, StorageTypeInstanceState>;
+  readonly foreignKeyDefaults?: ForeignKeyDefaultsState;
   /**
    * Array of extension pack namespace identifiers (e.g., ['pgvector', 'postgis']).
    * Populated when extension packs are registered during contract building.

package/src/contract-builder.ts

@@ -2,12 +2,13 @@ import type { TargetPackRef } from '@prisma-next/contract/framework-components';
 import type {
   ColumnBuilderState,
   ContractBuilderState,
+  ForeignKeyDefaultsState,
   ModelBuilderState,
   RelationDefinition,
   TableBuilderState,
 } from './builder-state';
 import { ModelBuilder } from './model-builder';
-import { TableBuilder } from './table-builder';
+import { createTable, TableBuilder } from './table-builder';
 
 export class ContractBuilder<
   Target extends string | undefined = undefined,
@@ -23,7 +24,7 @@ export class ContractBuilder<
     string,
     ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>
   > = Record<never, never>,
-  CoreHash extends string | undefined = undefined,
+  StorageHash extends string | undefined = undefined,
   ExtensionPacks extends Record<string, unknown> | undefined = undefined,
   Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,
 > {
@@ -31,26 +32,26 @@ export class ContractBuilder<
     Target,
     Tables,
     Models,
-    CoreHash,
+    StorageHash,
     ExtensionPacks,
     Capabilities
   >;
 
   constructor(
-    state?: ContractBuilderState<Target, Tables, Models, CoreHash, ExtensionPacks, Capabilities>,
+    state?: ContractBuilderState<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>,
   ) {
     this.state =
       state ??
       ({
         tables: {},
         models: {},
-      } as ContractBuilderState<Target, Tables, Models, CoreHash, ExtensionPacks, Capabilities>);
+      } as ContractBuilderState<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>);
   }
 
   target<T extends string>(
     packRef: TargetPackRef<string, T>,
-  ): ContractBuilder<T, Tables, Models, CoreHash, ExtensionPacks, Capabilities> {
-    return new ContractBuilder<T, Tables, Models, CoreHash, ExtensionPacks, Capabilities>({
+  ): ContractBuilder<T, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {
+    return new ContractBuilder<T, Tables, Models, StorageHash, ExtensionPacks, Capabilities>({
       ...this.state,
       target: packRef.targetId,
     });
@@ -58,8 +59,8 @@ export class ContractBuilder<
 
   capabilities<C extends Record<string, Record<string, boolean>>>(
     capabilities: C,
-  ): ContractBuilder<Target, Tables, Models, CoreHash, ExtensionPacks, C> {
-    return new ContractBuilder<Target, Tables, Models, CoreHash, ExtensionPacks, C>({
+  ): ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, C> {
+    return new ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, C>({
       ...this.state,
       capabilities,
     });
@@ -79,11 +80,11 @@ export class ContractBuilder<
     Target,
     Tables & Record<TableName, ReturnType<T['build']>>,
     Models,
-    CoreHash,
+    StorageHash,
     ExtensionPacks,
     Capabilities
   > {
-    const tableBuilder = new TableBuilder<TableName>(name);
+    const tableBuilder = createTable(name);
     const result = callback(tableBuilder);
     const finalBuilder = result instanceof TableBuilder ? result : tableBuilder;
     const tableState = finalBuilder.build();
@@ -92,7 +93,7 @@ export class ContractBuilder<
       Target,
       Tables & Record<TableName, ReturnType<T['build']>>,
       Models,
-      CoreHash,
+      StorageHash,
       ExtensionPacks,
       Capabilities
     >({
@@ -115,13 +116,13 @@ export class ContractBuilder<
     name: ModelName,
     table: TableName,
     callback: (
-      m: ModelBuilder<ModelName, TableName, Record<string, string>, Record<never, never>>,
+      m: ModelBuilder<ModelName, TableName, Record<never, never>, Record<never, never>>,
     ) => M | undefined,
   ): ContractBuilder<
     Target,
     Tables,
     Models & Record<ModelName, ReturnType<M['build']>>,
-    CoreHash,
+    StorageHash,
     ExtensionPacks,
     Capabilities
   > {
@@ -134,7 +135,7 @@ export class ContractBuilder<
       Target,
       Tables,
       Models & Record<ModelName, ReturnType<M['build']>>,
-      CoreHash,
+      StorageHash,
       ExtensionPacks,
       Capabilities
     >({
@@ -144,12 +145,21 @@ export class ContractBuilder<
     });
   }
 
-  coreHash<H extends string>(
+  storageHash<H extends string>(
     hash: H,
   ): ContractBuilder<Target, Tables, Models, H, ExtensionPacks, Capabilities> {
     return new ContractBuilder<Target, Tables, Models, H, ExtensionPacks, Capabilities>({
       ...this.state,
-      coreHash: hash,
+      storageHash: hash,
+    });
+  }
+
+  foreignKeyDefaults(
+    config: ForeignKeyDefaultsState,
+  ): ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {
+    return new ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities>({
+      ...this.state,
+      foreignKeyDefaults: config,
     });
   }
 }

package/src/index.ts

@@ -3,14 +3,19 @@ export type {
   ColumnBuilderState,
   ColumnTypeDescriptor,
   ContractBuilderState,
+  ForeignKeyDef,
+  ForeignKeyDefaultsState,
+  ForeignKeyOptions,
+  IndexDef,
   ModelBuilderState,
   RelationDefinition,
   TableBuilderState,
+  UniqueConstraintDef,
 } from './builder-state';
 
 export { ContractBuilder, defineContract } from './contract-builder';
 export { ModelBuilder } from './model-builder';
-export { TableBuilder } from './table-builder';
+export { createTable, TableBuilder } from './table-builder';
 
 export type {
   BuildModelFields,