@prisma-next/ids 0.0.1

package/README.md

@@ -0,0 +1,69 @@
+# @prisma-next/ids
+
+ID generator helpers for Prisma Next contracts. This package provides ergonomic helpers that
+produce contract-safe, JSON-serializable execution defaults for client-generated IDs, plus
+runtime generation utilities that Prisma Next uses before sending data to adapters.
+
+Each helper owns the column descriptor metadata associated with that generator, so callers only
+pass options supported by the underlying `uniku` generator.
+
+## Responsibilities
+
+- Provide ID helper functions (`ulid`, `nanoid`, `uuidv7`, `uuidv4`, `cuid2`, `ksuid`) for contract authoring.
+- Emit contract-safe execution defaults (no executable code stored in the contract).
+- Generate values at runtime using `uniku` when mutation defaults require them.
+
+## Dependencies
+
+- `@prisma-next/contract` for shared contract types (`ExecutionMutationDefaultValue`).
+- `uniku` for ID generator implementations.
+
+## Architecture
+
+```mermaid
+flowchart LR
+  Authoring[ContractAuthoring] --> IdsHelpers[ids_helpers]
+  IdsHelpers --> ContractJson[contract_json]
+  Runtime[orm_lane] --> IdsRuntime[ids_runtime]
+  IdsRuntime --> Uniku[uniku_generators]
+```
+
+## Usage
+
+```ts
+import { defineContract } from '@prisma-next/sql-contract-ts/contract-builder';
+import { uuidv4 } from '@prisma-next/ids';
+
+export const contract = defineContract()
+  .table('user', (t) =>
+    t.generated('id', uuidv4()).column('email', { type: { codecId: 'pg/text@1', nativeType: 'text' } }),
+  )
+  .build();
+```
+
+Pass generator options directly (for helpers whose `uniku` implementation supports them):
+
+```ts
+import { nanoid } from '@prisma-next/ids';
+
+const idSpec = nanoid({ size: 12 });
+```
+
+## Generator-owned codec mapping
+
+- Each helper binds its own descriptor internally (today all helpers map to `pg/text@1`).
+- Different helpers can move to different codecs independently (e.g. `ulid` binary and `nanoid` char/varchar).
+- Parameterized codec metadata can be added per helper when adapter-side parameterized codecs are available.
+
+Runtime usage:
+
+```ts
+import { generateId } from '@prisma-next/ids/runtime';
+
+const value = generateId({ id: 'uuidv4' });
+```
+
+## Related docs
+
+- [Data Contract](../../../docs/architecture%20docs/subsystems/1.%20Data%20Contract.md)
+- [Query Lanes](../../../docs/architecture%20docs/subsystems/3.%20Query%20Lanes.md)

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+import { cuid2 as cuid2$1 } from "uniku/cuid2";
+import { ksuid as ksuid$1 } from "uniku/ksuid";
+import { nanoid as nanoid$1 } from "uniku/nanoid";
+import { ulid as ulid$1 } from "uniku/ulid";
+import { uuidv4 as uuidv4$1 } from "uniku/uuid/v4";
+import { uuidv7 as uuidv7$1 } from "uniku/uuid/v7";
+import { ExecutionMutationDefaultValue } from "@prisma-next/contract/types";
+import { ColumnTypeDescriptor } from "@prisma-next/contract-authoring";
+
+//#region src/generators.d.ts
+type FirstArg<TFunction> = TFunction extends ((...args: infer TArgs) => unknown) ? TArgs extends [] ? undefined : TArgs[0] : never;
+type IdGeneratorOptionsById = {
+  readonly ulid: FirstArg<typeof ulid$1>;
+  readonly nanoid: FirstArg<typeof nanoid$1>;
+  readonly uuidv7: FirstArg<typeof uuidv7$1>;
+  readonly uuidv4: FirstArg<typeof uuidv4$1>;
+  readonly cuid2: FirstArg<typeof cuid2$1>;
+  readonly ksuid: FirstArg<typeof ksuid$1>;
+};
+//#endregion
+//#region src/index.d.ts
+type GeneratedColumnSpec = {
+  readonly type: ColumnTypeDescriptor;
+  readonly nullable?: false;
+  readonly typeParams?: Record<string, unknown>;
+  readonly generated: ExecutionMutationDefaultValue;
+};
+declare const ulid: (options?: IdGeneratorOptionsById["ulid"]) => GeneratedColumnSpec;
+declare const nanoid: (options?: IdGeneratorOptionsById["nanoid"]) => GeneratedColumnSpec;
+declare const uuidv7: (options?: IdGeneratorOptionsById["uuidv7"]) => GeneratedColumnSpec;
+declare const uuidv4: (options?: IdGeneratorOptionsById["uuidv4"]) => GeneratedColumnSpec;
+declare const cuid2: (options?: IdGeneratorOptionsById["cuid2"]) => GeneratedColumnSpec;
+declare const ksuid: (options?: IdGeneratorOptionsById["ksuid"]) => GeneratedColumnSpec;
+//#endregion
+export { GeneratedColumnSpec, cuid2, ksuid, nanoid, ulid, uuidv4, uuidv7 };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/generators.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;KAQK,sBAAsB,uFAGrB;KAGM,sBAAA;iBACK,gBAAgB;mBACd,gBAAgB;EAR9B,SAAA,MAAQ,EASM,QATN,CAAA,OASsB,QANxB,CAAA;EAGC,SAAA,MAAA,EAIO,QAJe,CAAA,OAIC,QAJD,CAAA;EACD,SAAA,KAAA,EAIf,QAJe,CAAA,OAIC,OAJD,CAAA;EAAhB,SAAA,KAAA,EAKC,QALD,CAAA,OAKiB,OALjB,CAAA;CACkB;;;KCwBvB,mBAAA;iBACK;;wBAEO;sBACF;;cAqBT,iBAAkB,mCAAiC;ADzD3D,cC2DQ,MD3DA,EAAA,CAAA,OAGF,CAHgB,EC2DM,sBDxDtB,CAAA,QAAA,CAAA,EAAA,GCwDyD,mBDxDzD;AAGC,cCuDC,MDvDD,EAAsB,CAAA,OAAA,CAAA,ECuDD,sBDvDC,CAAA,QAAA,CAAA,EAAA,GCuDkC,mBDvDlC;AACD,cCwDpB,MDxDoB,EAAA,CAAA,OAAA,CAAA,ECwDA,sBDxDA,CAAA,QAAA,CAAA,EAAA,GCwDmC,mBDxDnC;AAAhB,cC0DJ,KD1DI,EAAA,CAAA,OAAA,CAAA,EC0De,sBD1Df,CAAA,OAAA,CAAA,EAAA,GC0DiD,mBD1DjD;AACkB,cC2DtB,KD3DsB,EAAA,CAAA,OAAA,CAAA,EC2DH,sBD3DG,CAAA,OAAA,CAAA,EAAA,GC2D+B,mBD3D/B"}

package/dist/index.mjs

@@ -0,0 +1,71 @@
+import { ifDefined } from "@prisma-next/utils/defined";
+
+//#region src/index.ts
+const generatedColumnDescriptors = {
+	ulid: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 26 }
+	},
+	nanoid: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 21 }
+	},
+	uuidv7: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 36 }
+	},
+	uuidv4: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 36 }
+	},
+	cuid2: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 24 }
+	},
+	ksuid: {
+		type: {
+			codecId: "sql/char@1",
+			nativeType: "character"
+		},
+		typeParams: { length: 27 }
+	}
+};
+function createGeneratedSpec(id, options) {
+	const { type, typeParams } = generatedColumnDescriptors[id];
+	const params = options;
+	return {
+		type,
+		nullable: false,
+		...ifDefined("typeParams", typeParams),
+		generated: {
+			kind: "generator",
+			id,
+			...ifDefined("params", params)
+		}
+	};
+}
+const ulid = (options) => createGeneratedSpec("ulid", options);
+const nanoid = (options) => createGeneratedSpec("nanoid", options);
+const uuidv7 = (options) => createGeneratedSpec("uuidv7", options);
+const uuidv4 = (options) => createGeneratedSpec("uuidv4", options);
+const cuid2 = (options) => createGeneratedSpec("cuid2", options);
+const ksuid = (options) => createGeneratedSpec("ksuid", options);
+
+//#endregion
+export { cuid2, ksuid, nanoid, ulid, uuidv4, uuidv7 };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["generatedColumnDescriptors: Record<GeneratedValueSpec['id'], GeneratedColumnDescriptor>"],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  ExecutionMutationDefaultValue,\n  GeneratedValueSpec,\n} from '@prisma-next/contract/types';\nimport type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport type { IdGeneratorOptionsById } from './generators';\n\ntype GeneratedColumnDescriptor = {\n  readonly type: ColumnTypeDescriptor;\n  readonly typeParams?: Record<string, unknown>;\n};\n\nconst generatedColumnDescriptors: Record<GeneratedValueSpec['id'], GeneratedColumnDescriptor> = {\n  ulid: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 26 },\n  },\n  nanoid: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 21 },\n  },\n  uuidv7: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 36 },\n  },\n  uuidv4: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 36 },\n  },\n  cuid2: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 24 },\n  },\n  ksuid: {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: 27 },\n  },\n};\n\nexport type GeneratedColumnSpec = {\n  readonly type: ColumnTypeDescriptor;\n  readonly nullable?: false;\n  readonly typeParams?: Record<string, unknown>;\n  readonly generated: ExecutionMutationDefaultValue;\n};\n\nfunction createGeneratedSpec<TId extends GeneratedValueSpec['id']>(\n  id: TId,\n  options?: IdGeneratorOptionsById[TId],\n): GeneratedColumnSpec {\n  const { type, typeParams } = generatedColumnDescriptors[id];\n  const params = options as Record<string, unknown> | undefined;\n  return {\n    type,\n    nullable: false,\n    ...ifDefined('typeParams', typeParams),\n    generated: {\n      kind: 'generator',\n      id,\n      ...ifDefined('params', params),\n    },\n  };\n}\n\nexport const ulid = (options?: IdGeneratorOptionsById['ulid']): GeneratedColumnSpec =>\n  createGeneratedSpec('ulid', options);\nexport const nanoid = (options?: IdGeneratorOptionsById['nanoid']): GeneratedColumnSpec =>\n  createGeneratedSpec('nanoid', options);\nexport const uuidv7 = (options?: IdGeneratorOptionsById['uuidv7']): GeneratedColumnSpec =>\n  createGeneratedSpec('uuidv7', options);\nexport const uuidv4 = (options?: IdGeneratorOptionsById['uuidv4']): GeneratedColumnSpec =>\n  createGeneratedSpec('uuidv4', options);\nexport const cuid2 = (options?: IdGeneratorOptionsById['cuid2']): GeneratedColumnSpec =>\n  createGeneratedSpec('cuid2', options);\nexport const ksuid = (options?: IdGeneratorOptionsById['ksuid']): GeneratedColumnSpec =>\n  createGeneratedSpec('ksuid', options);\n"],"mappings":";;;AAaA,MAAMA,6BAA0F;CAC9F,MAAM;EACJ,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACD,QAAQ;EACN,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACD,QAAQ;EACN,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACD,QAAQ;EACN,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACD,OAAO;EACL,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACD,OAAO;EACL,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;CACF;AASD,SAAS,oBACP,IACA,SACqB;CACrB,MAAM,EAAE,MAAM,eAAe,2BAA2B;CACxD,MAAM,SAAS;AACf,QAAO;EACL;EACA,UAAU;EACV,GAAG,UAAU,cAAc,WAAW;EACtC,WAAW;GACT,MAAM;GACN;GACA,GAAG,UAAU,UAAU,OAAO;GAC/B;EACF;;AAGH,MAAa,QAAQ,YACnB,oBAAoB,QAAQ,QAAQ;AACtC,MAAa,UAAU,YACrB,oBAAoB,UAAU,QAAQ;AACxC,MAAa,UAAU,YACrB,oBAAoB,UAAU,QAAQ;AACxC,MAAa,UAAU,YACrB,oBAAoB,UAAU,QAAQ;AACxC,MAAa,SAAS,YACpB,oBAAoB,SAAS,QAAQ;AACvC,MAAa,SAAS,YACpB,oBAAoB,SAAS,QAAQ"}

package/dist/runtime.d.mts

@@ -0,0 +1,7 @@
+import { GeneratedValueSpec } from "@prisma-next/contract/types";
+
+//#region src/runtime.d.ts
+declare function generateId(spec: GeneratedValueSpec): string;
+//#endregion
+export { generateId };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime.ts"],"sourcesContent":[],"mappings":";;;iBAGgB,UAAA,OAAiB"}

package/dist/runtime.mjs

@@ -0,0 +1,31 @@
+import { cuid2 } from "uniku/cuid2";
+import { ksuid } from "uniku/ksuid";
+import { nanoid } from "uniku/nanoid";
+import { ulid } from "uniku/ulid";
+import { uuidv4 } from "uniku/uuid/v4";
+import { uuidv7 } from "uniku/uuid/v7";
+
+//#region src/generators.ts
+function invokeGenerator(generator, params) {
+	if (params === void 0) return generator();
+	return generator(params);
+}
+const idGenerators = {
+	ulid: (params) => invokeGenerator(ulid, params),
+	nanoid: (params) => invokeGenerator(nanoid, params),
+	uuidv7: (params) => invokeGenerator(uuidv7, params),
+	uuidv4: (params) => invokeGenerator(uuidv4, params),
+	cuid2: (params) => invokeGenerator(cuid2, params),
+	ksuid: (params) => invokeGenerator(ksuid, params)
+};
+
+//#endregion
+//#region src/runtime.ts
+function generateId(spec) {
+	const generator = idGenerators[spec.id];
+	return generator(spec.params);
+}
+
+//#endregion
+export { generateId };
+//# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":["ulidGenerator","nanoidGenerator","uuidv7Generator","uuidv4Generator","cuid2Generator","ksuidGenerator"],"sources":["../src/generators.ts","../src/runtime.ts"],"sourcesContent":["import type { GeneratedValueSpec } from '@prisma-next/contract/types';\nimport { cuid2 as cuid2Generator } from 'uniku/cuid2';\nimport { ksuid as ksuidGenerator } from 'uniku/ksuid';\nimport { nanoid as nanoidGenerator } from 'uniku/nanoid';\nimport { ulid as ulidGenerator } from 'uniku/ulid';\nimport { uuidv4 as uuidv4Generator } from 'uniku/uuid/v4';\nimport { uuidv7 as uuidv7Generator } from 'uniku/uuid/v7';\n\ntype FirstArg<TFunction> = TFunction extends (...args: infer TArgs) => unknown\n  ? TArgs extends []\n    ? undefined\n    : TArgs[0]\n  : never;\n\nexport type IdGeneratorOptionsById = {\n  readonly ulid: FirstArg<typeof ulidGenerator>;\n  readonly nanoid: FirstArg<typeof nanoidGenerator>;\n  readonly uuidv7: FirstArg<typeof uuidv7Generator>;\n  readonly uuidv4: FirstArg<typeof uuidv4Generator>;\n  readonly cuid2: FirstArg<typeof cuid2Generator>;\n  readonly ksuid: FirstArg<typeof ksuidGenerator>;\n};\n\ntype IdGenerator = (params?: Record<string, unknown>) => string;\n\nfunction invokeGenerator<TOptions>(\n  generator: (options?: TOptions) => string,\n  params?: Record<string, unknown>,\n): string {\n  if (params === undefined) {\n    return generator();\n  }\n  return generator(params as TOptions);\n}\n\nexport const idGenerators = {\n  ulid: (params?: Record<string, unknown>) => invokeGenerator(ulidGenerator, params),\n  nanoid: (params?: Record<string, unknown>) => invokeGenerator(nanoidGenerator, params),\n  uuidv7: (params?: Record<string, unknown>) => invokeGenerator(uuidv7Generator, params),\n  uuidv4: (params?: Record<string, unknown>) => invokeGenerator(uuidv4Generator, params),\n  cuid2: (params?: Record<string, unknown>) => invokeGenerator(cuid2Generator, params),\n  ksuid: (params?: Record<string, unknown>) => invokeGenerator(ksuidGenerator, params),\n} as const satisfies Record<GeneratedValueSpec['id'], IdGenerator>;\n","import type { GeneratedValueSpec } from '@prisma-next/contract/types';\nimport { idGenerators } from './generators';\n\nexport function generateId(spec: GeneratedValueSpec): string {\n  const generator = idGenerators[spec.id];\n  return generator(spec.params);\n}\n"],"mappings":";;;;;;;;AAyBA,SAAS,gBACP,WACA,QACQ;AACR,KAAI,WAAW,OACb,QAAO,WAAW;AAEpB,QAAO,UAAU,OAAmB;;AAGtC,MAAa,eAAe;CAC1B,OAAO,WAAqC,gBAAgBA,MAAe,OAAO;CAClF,SAAS,WAAqC,gBAAgBC,QAAiB,OAAO;CACtF,SAAS,WAAqC,gBAAgBC,QAAiB,OAAO;CACtF,SAAS,WAAqC,gBAAgBC,QAAiB,OAAO;CACtF,QAAQ,WAAqC,gBAAgBC,OAAgB,OAAO;CACpF,QAAQ,WAAqC,gBAAgBC,OAAgB,OAAO;CACrF;;;;ACvCD,SAAgB,WAAW,MAAkC;CAC3D,MAAM,YAAY,aAAa,KAAK;AACpC,QAAO,UAAU,KAAK,OAAO"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@prisma-next/ids",
+  "version": "0.0.1",
+  "type": "module",
+  "sideEffects": false,
+  "description": "ID generator helpers for Prisma Next contracts",
+  "dependencies": {
+    "uniku": "^0.0.12",
+    "@prisma-next/contract": "0.0.1",
+    "@prisma-next/utils": "0.0.1",
+    "@prisma-next/contract-authoring": "0.0.1"
+  },
+  "devDependencies": {
+    "tsdown": "0.18.4",
+    "typescript": "5.9.3",
+    "vitest": "4.0.17",
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./runtime": "./dist/runtime.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/ids"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "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/generators.ts

@@ -0,0 +1,43 @@
+import type { GeneratedValueSpec } from '@prisma-next/contract/types';
+import { cuid2 as cuid2Generator } from 'uniku/cuid2';
+import { ksuid as ksuidGenerator } from 'uniku/ksuid';
+import { nanoid as nanoidGenerator } from 'uniku/nanoid';
+import { ulid as ulidGenerator } from 'uniku/ulid';
+import { uuidv4 as uuidv4Generator } from 'uniku/uuid/v4';
+import { uuidv7 as uuidv7Generator } from 'uniku/uuid/v7';
+
+type FirstArg<TFunction> = TFunction extends (...args: infer TArgs) => unknown
+  ? TArgs extends []
+    ? undefined
+    : TArgs[0]
+  : never;
+
+export type IdGeneratorOptionsById = {
+  readonly ulid: FirstArg<typeof ulidGenerator>;
+  readonly nanoid: FirstArg<typeof nanoidGenerator>;
+  readonly uuidv7: FirstArg<typeof uuidv7Generator>;
+  readonly uuidv4: FirstArg<typeof uuidv4Generator>;
+  readonly cuid2: FirstArg<typeof cuid2Generator>;
+  readonly ksuid: FirstArg<typeof ksuidGenerator>;
+};
+
+type IdGenerator = (params?: Record<string, unknown>) => string;
+
+function invokeGenerator<TOptions>(
+  generator: (options?: TOptions) => string,
+  params?: Record<string, unknown>,
+): string {
+  if (params === undefined) {
+    return generator();
+  }
+  return generator(params as TOptions);
+}
+
+export const idGenerators = {
+  ulid: (params?: Record<string, unknown>) => invokeGenerator(ulidGenerator, params),
+  nanoid: (params?: Record<string, unknown>) => invokeGenerator(nanoidGenerator, params),
+  uuidv7: (params?: Record<string, unknown>) => invokeGenerator(uuidv7Generator, params),
+  uuidv4: (params?: Record<string, unknown>) => invokeGenerator(uuidv4Generator, params),
+  cuid2: (params?: Record<string, unknown>) => invokeGenerator(cuid2Generator, params),
+  ksuid: (params?: Record<string, unknown>) => invokeGenerator(ksuidGenerator, params),
+} as const satisfies Record<GeneratedValueSpec['id'], IdGenerator>;

package/src/index.ts

@@ -0,0 +1,77 @@
+import type {
+  ExecutionMutationDefaultValue,
+  GeneratedValueSpec,
+} from '@prisma-next/contract/types';
+import type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';
+import { ifDefined } from '@prisma-next/utils/defined';
+import type { IdGeneratorOptionsById } from './generators';
+
+type GeneratedColumnDescriptor = {
+  readonly type: ColumnTypeDescriptor;
+  readonly typeParams?: Record<string, unknown>;
+};
+
+const generatedColumnDescriptors: Record<GeneratedValueSpec['id'], GeneratedColumnDescriptor> = {
+  ulid: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 26 },
+  },
+  nanoid: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 21 },
+  },
+  uuidv7: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 36 },
+  },
+  uuidv4: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 36 },
+  },
+  cuid2: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 24 },
+  },
+  ksuid: {
+    type: { codecId: 'sql/char@1', nativeType: 'character' },
+    typeParams: { length: 27 },
+  },
+};
+
+export type GeneratedColumnSpec = {
+  readonly type: ColumnTypeDescriptor;
+  readonly nullable?: false;
+  readonly typeParams?: Record<string, unknown>;
+  readonly generated: ExecutionMutationDefaultValue;
+};
+
+function createGeneratedSpec<TId extends GeneratedValueSpec['id']>(
+  id: TId,
+  options?: IdGeneratorOptionsById[TId],
+): GeneratedColumnSpec {
+  const { type, typeParams } = generatedColumnDescriptors[id];
+  const params = options as Record<string, unknown> | undefined;
+  return {
+    type,
+    nullable: false,
+    ...ifDefined('typeParams', typeParams),
+    generated: {
+      kind: 'generator',
+      id,
+      ...ifDefined('params', params),
+    },
+  };
+}
+
+export const ulid = (options?: IdGeneratorOptionsById['ulid']): GeneratedColumnSpec =>
+  createGeneratedSpec('ulid', options);
+export const nanoid = (options?: IdGeneratorOptionsById['nanoid']): GeneratedColumnSpec =>
+  createGeneratedSpec('nanoid', options);
+export const uuidv7 = (options?: IdGeneratorOptionsById['uuidv7']): GeneratedColumnSpec =>
+  createGeneratedSpec('uuidv7', options);
+export const uuidv4 = (options?: IdGeneratorOptionsById['uuidv4']): GeneratedColumnSpec =>
+  createGeneratedSpec('uuidv4', options);
+export const cuid2 = (options?: IdGeneratorOptionsById['cuid2']): GeneratedColumnSpec =>
+  createGeneratedSpec('cuid2', options);
+export const ksuid = (options?: IdGeneratorOptionsById['ksuid']): GeneratedColumnSpec =>
+  createGeneratedSpec('ksuid', options);

package/src/runtime.ts

@@ -0,0 +1,7 @@
+import type { GeneratedValueSpec } from '@prisma-next/contract/types';
+import { idGenerators } from './generators';
+
+export function generateId(spec: GeneratedValueSpec): string {
+  const generator = idGenerators[spec.id];
+  return generator(spec.params);
+}