@prisma-next/contract-authoring 0.3.0-dev.135 → 0.3.0-dev.146

package/src/table-builder.ts

@@ -1,330 +0,0 @@
-import type { ColumnDefault, ExecutionMutationDefaultValue } from '@prisma-next/contract/types';
-import { ifDefined } from '@prisma-next/utils/defined';
-import type {
-  ColumnBuilderState,
-  ColumnTypeDescriptor,
-  ForeignKeyDef,
-  ForeignKeyOptions,
-  IndexDef,
-  TableBuilderState,
-  UniqueConstraintDef,
-} from './builder-state';
-
-/**
- * Column options for nullable columns.
- */
-interface NullableColumnOptions<Descriptor extends ColumnTypeDescriptor> {
-  type: Descriptor;
-  nullable: true;
-  typeParams?: Record<string, unknown>;
-  default?: ColumnDefault;
-}
-
-/**
- * Column options for non-nullable columns.
- * Non-nullable columns can optionally have a default value.
- */
-interface NonNullableColumnOptions<Descriptor extends ColumnTypeDescriptor> {
-  type: Descriptor;
-  nullable?: false;
-  typeParams?: Record<string, unknown>;
-  default?: ColumnDefault;
-}
-
-type GeneratedColumnOptions<Descriptor extends ColumnTypeDescriptor> = Omit<
-  NonNullableColumnOptions<Descriptor>,
-  'default' | 'nullable'
-> & {
-  /**
-   * Generated columns are always non-nullable and use mutation-time defaults
-   * that the runtime injects when the column is omitted from insert input.
-   */
-  nullable?: false;
-  generated: ExecutionMutationDefaultValue;
-};
-
-/** Column options for any column nullability. */
-type ColumnOptions<Descriptor extends ColumnTypeDescriptor> =
-  | NullableColumnOptions<Descriptor>
-  | NonNullableColumnOptions<Descriptor>;
-
-type NullableFromOptions<TOptions> = TOptions extends { nullable: true } ? true : false;
-type IndexOptions = {
-  readonly name?: string;
-  readonly using?: string;
-  readonly config?: Record<string, unknown>;
-};
-
-function isIndexDef(value: readonly string[] | IndexDef): value is IndexDef {
-  return !Array.isArray(value);
-}
-
-interface TableBuilderInternalState<
-  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;
-  readonly primaryKeyName: string | undefined;
-  readonly uniques: readonly UniqueConstraintDef[];
-  readonly indexes: readonly IndexDef[];
-  readonly foreignKeys: readonly ForeignKeyDef[];
-}
-
-/**
- * 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.
- */
-export function createTable<Name extends string>(name: Name): TableBuilder<Name> {
-  return new TableBuilder(name, {}, undefined, undefined, [], [], []);
-}
-
-/**
- * Builder for defining table structure with type-safe chaining.
- * Use `createTable(name)` to create instances.
- */
-export 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 _state: TableBuilderInternalState<Name, Columns, PrimaryKey>;
-
-  /** @internal Use createTable() instead */
-  constructor(
-    name: Name,
-    columns: Columns,
-    primaryKey: PrimaryKey,
-    primaryKeyName: string | undefined,
-    uniques: readonly UniqueConstraintDef[],
-    indexes: readonly IndexDef[],
-    foreignKeys: readonly ForeignKeyDef[],
-  ) {
-    this._state = {
-      name,
-      columns,
-      primaryKey,
-      primaryKeyName,
-      uniques,
-      indexes,
-      foreignKeys,
-    };
-  }
-
-  private get _name(): Name {
-    return this._state.name;
-  }
-
-  private get _columns(): Columns {
-    return this._state.columns;
-  }
-
-  private get _primaryKey(): PrimaryKey {
-    return this._state.primaryKey;
-  }
-
-  /** Add a nullable column to the table. */
-  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(
-    name: ColName,
-    options: NullableColumnOptions<Descriptor>,
-  ): TableBuilder<
-    Name,
-    Columns & Record<ColName, ColumnBuilderState<ColName, true, Descriptor['codecId']>>,
-    PrimaryKey
-  >;
-
-  /**
-   * Add a non-nullable column to the table.
-   * Non-nullable columns can optionally have a default value.
-   */
-  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(
-    name: ColName,
-    options: NonNullableColumnOptions<Descriptor>,
-  ): TableBuilder<
-    Name,
-    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,
-    PrimaryKey
-  >;
-
-  /**
-   * Implementation of the column method.
-   */
-  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(
-    name: ColName,
-    options: ColumnOptions<Descriptor>,
-  ): TableBuilder<
-    Name,
-    Columns & Record<ColName, ColumnBuilderState<ColName, boolean, Descriptor['codecId']>>,
-    PrimaryKey
-  > {
-    return this.columnInternal(name, options);
-  }
-
-  generated<ColName extends string, Descriptor extends ColumnTypeDescriptor>(
-    name: ColName,
-    options: GeneratedColumnOptions<Descriptor>,
-  ): TableBuilder<
-    Name,
-    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,
-    PrimaryKey
-  > {
-    const { generated, ...columnOptions } = options;
-    return this.columnInternal(name, columnOptions, generated);
-  }
-
-  private columnInternal<
-    ColName extends string,
-    Descriptor extends ColumnTypeDescriptor,
-    Options extends ColumnOptions<Descriptor>,
-  >(
-    name: ColName,
-    options: Options,
-    executionDefault?: ExecutionMutationDefaultValue,
-  ): TableBuilder<
-    Name,
-    Columns &
-      Record<
-        ColName,
-        ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>
-      >,
-    PrimaryKey
-  > {
-    const nullable = options.nullable ?? false;
-    const { codecId, nativeType, typeParams: descriptorTypeParams, typeRef } = options.type;
-    const typeParams = options.typeParams ?? descriptorTypeParams;
-
-    const columnState = {
-      name,
-      nullable,
-      type: codecId,
-      nativeType,
-      ...ifDefined('typeParams', typeParams),
-      ...ifDefined('typeRef', typeRef),
-      ...ifDefined('default', 'default' in options ? options.default : undefined),
-      ...ifDefined('executionDefault', executionDefault),
-    } as ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>;
-    const newColumns = { ...this._columns, [name]: columnState } as Columns &
-      Record<
-        ColName,
-        ColumnBuilderState<ColName, NullableFromOptions<Options>, Descriptor['codecId']>
-      >;
-    return new TableBuilder(
-      this._state.name,
-      newColumns,
-      this._state.primaryKey,
-      this._state.primaryKeyName,
-      this._state.uniques,
-      this._state.indexes,
-      this._state.foreignKeys,
-    );
-  }
-
-  primaryKey<PK extends readonly string[]>(
-    columns: PK,
-    name?: string,
-  ): TableBuilder<Name, Columns, PK> {
-    return new TableBuilder(
-      this._state.name,
-      this._state.columns,
-      columns,
-      name,
-      this._state.uniques,
-      this._state.indexes,
-      this._state.foreignKeys,
-    );
-  }
-
-  unique(columns: readonly string[], name?: string): TableBuilder<Name, Columns, PrimaryKey> {
-    const constraint: UniqueConstraintDef = 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(columns: readonly string[], name?: string): TableBuilder<Name, Columns, PrimaryKey>;
-  index(
-    columns: readonly string[],
-    options?: IndexOptions,
-  ): TableBuilder<Name, Columns, PrimaryKey>;
-  index(indexDef: IndexDef): TableBuilder<Name, Columns, PrimaryKey>;
-  index(
-    columnsOrIndexDef: readonly string[] | IndexDef,
-    nameOrOptions?: string | IndexOptions,
-  ): TableBuilder<Name, Columns, PrimaryKey> {
-    const indexDef: IndexDef = isIndexDef(columnsOrIndexDef)
-      ? columnsOrIndexDef
-      : {
-          columns: columnsOrIndexDef,
-          ...(typeof nameOrOptions === 'string' ? { name: nameOrOptions } : {}),
-          ...(typeof nameOrOptions === 'object' && nameOrOptions !== null
-            ? {
-                ...(nameOrOptions.name !== undefined ? { name: nameOrOptions.name } : {}),
-                ...(nameOrOptions.using !== undefined ? { using: nameOrOptions.using } : {}),
-                ...(nameOrOptions.config !== undefined ? { 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: readonly string[],
-    references: { table: string; columns: readonly string[] },
-    opts?: string | (ForeignKeyOptions & { constraint?: boolean; index?: boolean }),
-  ): TableBuilder<Name, Columns, PrimaryKey> {
-    const resolved = typeof opts === 'string' ? { name: opts } : opts;
-    const fkDef: ForeignKeyDef = {
-      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(): TableBuilderState<Name, Columns, PrimaryKey> {
-    return {
-      name: this._name,
-      columns: this._columns,
-      ...(this._primaryKey !== undefined ? { primaryKey: this._primaryKey } : {}),
-      ...(this._state.primaryKeyName !== undefined
-        ? { primaryKeyName: this._state.primaryKeyName }
-        : {}),
-      uniques: this._state.uniques,
-      indexes: this._state.indexes,
-      foreignKeys: this._state.foreignKeys,
-    } as TableBuilderState<Name, Columns, PrimaryKey>;
-  }
-}

package/src/types.ts

@@ -1,119 +0,0 @@
-import type { ColumnDefault, DomainField, DomainRelation } from '@prisma-next/contract/types';
-import type {
-  ColumnBuilderState,
-  ModelBuilderState,
-  RelationDefinition,
-  TableBuilderState,
-} from './builder-state';
-
-export type BuildStorageColumn<Nullable extends boolean, Type extends string> = {
-  readonly nativeType: string;
-  readonly codecId: Type;
-  readonly nullable: Nullable;
-  readonly typeParams?: Record<string, unknown>;
-  readonly typeRef?: string;
-  readonly default?: ColumnDefault;
-};
-
-export 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;
-
-export 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;
-
-export 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;
-      };
-    };
-  };
-};
-
-export 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;
-    };
-  };
-};
-
-export type Mutable<T> = {
-  -readonly [K in keyof T]-?: T[K];
-};
-
-export type BuildModelFields<Fields extends Record<string, string>> = {
-  readonly [K in keyof Fields]: { readonly column: Fields[K] };
-};
-
-export 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;
-
-export 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]>>;
-    };
-    readonly fields: Record<string, DomainField>;
-    readonly relations: Record<string, DomainRelation>;
-  };
-};