@prisma-next/ids 0.3.0-dev.86 → 0.3.0-dev.88

package/dist/index.d.mts

@@ -7,6 +7,10 @@ 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/generator-ids.d.ts
+declare const builtinGeneratorIds: readonly ["ulid", "nanoid", "uuidv7", "uuidv4", "cuid2", "ksuid"];
+type BuiltinGeneratorId = (typeof builtinGeneratorIds)[number];
+//#endregion
 //#region src/generators.d.ts
 type FirstArg<TFunction> = TFunction extends ((...args: infer TArgs) => unknown) ? TArgs extends [] ? undefined : TArgs[0] : never;
 type IdGeneratorOptionsById = {
@@ -19,6 +23,18 @@ type IdGeneratorOptionsById = {
 };
 //#endregion
 //#region src/index.d.ts
+type GeneratedColumnDescriptor = {
+  readonly type: ColumnTypeDescriptor;
+  readonly typeParams?: Record<string, unknown>;
+};
+declare const builtinGeneratorRegistryMetadata: ReadonlyArray<{
+  readonly id: BuiltinGeneratorId;
+  readonly applicableCodecIds: readonly string[];
+}>;
+declare function resolveBuiltinGeneratedColumnDescriptor(input: {
+  readonly id: BuiltinGeneratorId;
+  readonly params?: Record<string, unknown>;
+}): GeneratedColumnDescriptor;
 type GeneratedColumnSpec = {
   readonly type: ColumnTypeDescriptor;
   readonly nullable?: false;
@@ -32,5 +48,5 @@ declare const uuidv4: (options?: IdGeneratorOptionsById["uuidv4"]) => GeneratedC
 declare const cuid2: (options?: IdGeneratorOptionsById["cuid2"]) => GeneratedColumnSpec;
 declare const ksuid: (options?: IdGeneratorOptionsById["ksuid"]) => GeneratedColumnSpec;
 //#endregion
-export { GeneratedColumnSpec, cuid2, ksuid, nanoid, ulid, uuidv4, uuidv7 };
+export { GeneratedColumnDescriptor, GeneratedColumnSpec, builtinGeneratorIds, builtinGeneratorRegistryMetadata, cuid2, ksuid, nanoid, resolveBuiltinGeneratedColumnDescriptor, ulid, uuidv4, uuidv7 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +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;;cA6BT,iBAAkB,mCAAiC;ADjE3D,cCmEQ,MDnEA,EAAA,CAAA,OAGF,CAHgB,ECmEM,sBDhEtB,CAAA,QAAA,CAAA,EAAA,GCgEyD,mBDhEzD;AAGC,cC+DC,MD/DD,EAAsB,CAAA,OAAA,CAAA,EC+DD,sBD/DC,CAAA,QAAA,CAAA,EAAA,GC+DkC,mBD/DlC;AACD,cCgEpB,MDhEoB,EAAA,CAAA,OAAA,CAAA,ECgEA,sBDhEA,CAAA,QAAA,CAAA,EAAA,GCgEmC,mBDhEnC;AAAhB,cCkEJ,KDlEI,EAAA,CAAA,OAAA,CAAA,ECkEe,sBDlEf,CAAA,OAAA,CAAA,EAAA,GCkEiD,mBDlEjD;AACkB,cCmEtB,KDnEsB,EAAA,CAAA,OAAA,CAAA,ECmEH,sBDnEG,CAAA,OAAA,CAAA,EAAA,GCmE+B,mBDnE/B"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/generator-ids.ts","../src/generators.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAAa;KASD,kBAAA,WAA6B;;;KCDpC,sBAAsB,uFAGrB;KAGM,sBAAA;iBACK,gBAAgB;mBACd,gBAAgB;EDhBtB,SAAA,MAAA,ECiBM,QDVT,CAAA,OCUyB,QDVzB,CAAA;EAEE,SAAA,MAAA,ECSO,QDTW,CAAA,OCSK,QDTM,CAAA;kBCUvB,gBAAgB;kBAChB,gBAAgB;;;;KCZtB,yBAAA;iBACK;wBACO;;cA8EX,kCAAkC;EFxFlC,SAAA,EAAA,EEyFE,kBFlFL;EAEE,SAAA,kBAAkB,EAAA,SAAW,MAAA,EAAA;;iBEuFzB,uCAAA;eACD;EDzFV,SAAA,MAAQ,CAAA,EC0FO,MD1FP,CAAA,MAAA,EAAc,OAAA,CAAA;AAM3B,CAAA,CAAA,ECqFI,yBDrF8B;AACD,KC6FrB,mBAAA,GD7FqB;EAAhB,SAAA,IAAA,EC8FA,oBD9FA;EACkB,SAAA,QAAA,CAAA,EAAA,KAAA;EAAhB,SAAA,UAAA,CAAA,EC+FK,MD/FL,CAAA,MAAA,EAAA,OAAA,CAAA;EACgB,SAAA,SAAA,EC+Fb,6BD/Fa;CAAhB;AACgB,cCsHtB,IDtHsB,EAAA,CAAA,OAAA,CAAA,ECsHJ,sBDtHI,CAAA,MAAA,CAAA,EAAA,GCsH6B,mBDtH7B;AAAhB,cCwHN,MDxHM,EAAA,CAAA,OAAA,CAAA,ECwHc,sBDxHd,CAAA,QAAA,CAAA,EAAA,GCwHiD,mBDxHjD;AACe,cCyHrB,MDzHqB,EAAA,CAAA,OAAA,CAAA,ECyHD,sBDzHC,CAAA,QAAA,CAAA,EAAA,GCyHkC,mBDzHlC;AAAhB,cC2HL,MD3HK,EAAA,CAAA,OAAA,CAAA,EC2He,sBD3Hf,CAAA,QAAA,CAAA,EAAA,GC2HkD,mBD3HlD;AACgB,cC4HrB,KD5HqB,EAAA,CAAA,OAAA,CAAA,EC4HF,sBD5HE,CAAA,OAAA,CAAA,EAAA,GC4HgC,mBD5HhC;AAAhB,cC8HL,KD9HK,EAAA,CAAA,OAAA,CAAA,EC8Hc,sBD9Hd,CAAA,OAAA,CAAA,EAAA,GC8HgD,mBD9HhD"}

package/dist/index.mjs

@@ -1,58 +1,118 @@
 import { ifDefined } from "@prisma-next/utils/defined";
 
+//#region src/generator-ids.ts
+const builtinGeneratorIds = [
+	"ulid",
+	"nanoid",
+	"uuidv7",
+	"uuidv4",
+	"cuid2",
+	"ksuid"
+];
+
+//#endregion
 //#region src/index.ts
-const generatedColumnDescriptors = {
-	ulid: {
+function resolveNanoidColumnDescriptor(params) {
+	const rawSize = params?.["size"];
+	if (rawSize === void 0) return {
 		type: {
 			codecId: "sql/char@1",
 			nativeType: "character"
 		},
-		typeParams: { length: 26 }
-	},
-	nanoid: {
+		typeParams: { length: 21 }
+	};
+	if (typeof rawSize !== "number" || !Number.isInteger(rawSize) || rawSize < 2 || rawSize > 255) throw new Error("nanoid size must be an integer between 2 and 255");
+	return {
 		type: {
 			codecId: "sql/char@1",
 			nativeType: "character"
 		},
-		typeParams: { length: 21 }
+		typeParams: { length: rawSize }
+	};
+}
+const builtinGeneratorMetadataById = {
+	ulid: {
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 26 }
+		}
 	},
-	uuidv7: {
-		type: {
-			codecId: "sql/char@1",
-			nativeType: "character"
+	nanoid: {
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 21 }
 		},
-		typeParams: { length: 36 }
+		resolveGeneratedColumnDescriptor: resolveNanoidColumnDescriptor
+	},
+	uuidv7: {
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 36 }
+		}
 	},
 	uuidv4: {
-		type: {
-			codecId: "sql/char@1",
-			nativeType: "character"
-		},
-		typeParams: { length: 36 }
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 36 }
+		}
 	},
 	cuid2: {
-		type: {
-			codecId: "sql/char@1",
-			nativeType: "character"
-		},
-		typeParams: { length: 24 }
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 24 }
+		}
 	},
 	ksuid: {
-		type: {
-			codecId: "sql/char@1",
-			nativeType: "character"
-		},
-		typeParams: { length: 27 }
+		applicableCodecIds: ["pg/text@1", "sql/char@1"],
+		generatedColumnDescriptor: {
+			type: {
+				codecId: "sql/char@1",
+				nativeType: "character"
+			},
+			typeParams: { length: 27 }
+		}
 	}
 };
+const builtinGeneratorRegistryMetadata = builtinGeneratorIds.map((id) => ({
+	id,
+	applicableCodecIds: builtinGeneratorMetadataById[id].applicableCodecIds
+}));
+function resolveBuiltinGeneratedColumnDescriptor(input) {
+	const metadata = builtinGeneratorMetadataById[input.id];
+	const resolver = metadata.resolveGeneratedColumnDescriptor;
+	if (resolver) return resolver(input.params);
+	return metadata.generatedColumnDescriptor;
+}
 function createGeneratedSpec(id, options) {
-	const { type } = generatedColumnDescriptors[id];
-	const typeParams = id === "nanoid" && typeof options === "object" && options !== null && "size" in options && typeof options.size === "number" ? { length: options.size } : generatedColumnDescriptors[id].typeParams;
 	const params = options;
+	const resolvedDescriptor = resolveBuiltinGeneratedColumnDescriptor({
+		id,
+		...ifDefined("params", params)
+	});
 	return {
-		type,
+		type: resolvedDescriptor.type,
 		nullable: false,
-		...ifDefined("typeParams", typeParams),
+		...ifDefined("typeParams", resolvedDescriptor.typeParams),
 		generated: {
 			kind: "generator",
 			id,
@@ -68,5 +128,5 @@ const cuid2 = (options) => createGeneratedSpec("cuid2", options);
 const ksuid = (options) => createGeneratedSpec("ksuid", options);
 
 //#endregion
-export { cuid2, ksuid, nanoid, ulid, uuidv4, uuidv7 };
+export { builtinGeneratorIds, builtinGeneratorRegistryMetadata, cuid2, ksuid, nanoid, resolveBuiltinGeneratedColumnDescriptor, ulid, uuidv4, uuidv7 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +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 } = generatedColumnDescriptors[id];\n  const typeParams =\n    id === 'nanoid' &&\n    typeof options === 'object' &&\n    options !== null &&\n    'size' in options &&\n    typeof options.size === 'number'\n      ? { length: options.size }\n      : generatedColumnDescriptors[id].typeParams;\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,SAAS,2BAA2B;CAC5C,MAAM,aACJ,OAAO,YACP,OAAO,YAAY,YACnB,YAAY,QACZ,UAAU,WACV,OAAO,QAAQ,SAAS,WACpB,EAAE,QAAQ,QAAQ,MAAM,GACxB,2BAA2B,IAAI;CACrC,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"}
+{"version":3,"file":"index.mjs","names":["builtinGeneratorMetadataById: Record<BuiltinGeneratorId, BuiltinGeneratorMetadata>","builtinGeneratorRegistryMetadata: ReadonlyArray<{\n  readonly id: BuiltinGeneratorId;\n  readonly applicableCodecIds: readonly string[];\n}>"],"sources":["../src/generator-ids.ts","../src/index.ts"],"sourcesContent":["export const builtinGeneratorIds = [\n  'ulid',\n  'nanoid',\n  'uuidv7',\n  'uuidv4',\n  'cuid2',\n  'ksuid',\n] as const;\n\nexport type BuiltinGeneratorId = (typeof builtinGeneratorIds)[number];\n","import type { ExecutionMutationDefaultValue } from '@prisma-next/contract/types';\nimport type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { type BuiltinGeneratorId, builtinGeneratorIds } from './generator-ids';\nimport type { IdGeneratorOptionsById } from './generators';\n\nexport { builtinGeneratorIds };\n\nexport type GeneratedColumnDescriptor = {\n  readonly type: ColumnTypeDescriptor;\n  readonly typeParams?: Record<string, unknown>;\n};\n\ntype BuiltinGeneratorMetadata = {\n  readonly applicableCodecIds: readonly string[];\n  readonly generatedColumnDescriptor: GeneratedColumnDescriptor;\n  readonly resolveGeneratedColumnDescriptor?: (\n    params?: Record<string, unknown>,\n  ) => GeneratedColumnDescriptor;\n};\n\nfunction resolveNanoidColumnDescriptor(\n  params?: Record<string, unknown>,\n): GeneratedColumnDescriptor {\n  const rawSize = params?.['size'];\n  if (rawSize === undefined) {\n    return {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 21 },\n    };\n  }\n\n  if (typeof rawSize !== 'number' || !Number.isInteger(rawSize) || rawSize < 2 || rawSize > 255) {\n    throw new Error('nanoid size must be an integer between 2 and 255');\n  }\n\n  return {\n    type: { codecId: 'sql/char@1', nativeType: 'character' },\n    typeParams: { length: rawSize },\n  };\n}\n\nconst builtinGeneratorMetadataById: Record<BuiltinGeneratorId, BuiltinGeneratorMetadata> = {\n  ulid: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 26 },\n    },\n  },\n  nanoid: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 21 },\n    },\n    resolveGeneratedColumnDescriptor: resolveNanoidColumnDescriptor,\n  },\n  uuidv7: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 36 },\n    },\n  },\n  uuidv4: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 36 },\n    },\n  },\n  cuid2: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 24 },\n    },\n  },\n  ksuid: {\n    applicableCodecIds: ['pg/text@1', 'sql/char@1'],\n    generatedColumnDescriptor: {\n      type: { codecId: 'sql/char@1', nativeType: 'character' },\n      typeParams: { length: 27 },\n    },\n  },\n};\n\nexport const builtinGeneratorRegistryMetadata: ReadonlyArray<{\n  readonly id: BuiltinGeneratorId;\n  readonly applicableCodecIds: readonly string[];\n}> = builtinGeneratorIds.map((id) => ({\n  id,\n  applicableCodecIds: builtinGeneratorMetadataById[id].applicableCodecIds,\n}));\n\nexport function resolveBuiltinGeneratedColumnDescriptor(input: {\n  readonly id: BuiltinGeneratorId;\n  readonly params?: Record<string, unknown>;\n}): GeneratedColumnDescriptor {\n  const metadata = builtinGeneratorMetadataById[input.id];\n  const resolver = metadata.resolveGeneratedColumnDescriptor;\n  if (resolver) {\n    return resolver(input.params);\n  }\n  return metadata.generatedColumnDescriptor;\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 BuiltinGeneratorId>(\n  id: TId,\n  options?: IdGeneratorOptionsById[TId],\n): GeneratedColumnSpec {\n  const params = options as Record<string, unknown> | undefined;\n  const resolvedDescriptor = resolveBuiltinGeneratedColumnDescriptor({\n    id,\n    ...ifDefined('params', params),\n  });\n  return {\n    type: resolvedDescriptor.type,\n    nullable: false,\n    ...ifDefined('typeParams', resolvedDescriptor.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,MAAa,sBAAsB;CACjC;CACA;CACA;CACA;CACA;CACA;CACD;;;;ACcD,SAAS,8BACP,QAC2B;CAC3B,MAAM,UAAU,SAAS;AACzB,KAAI,YAAY,OACd,QAAO;EACL,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,IAAI;EAC3B;AAGH,KAAI,OAAO,YAAY,YAAY,CAAC,OAAO,UAAU,QAAQ,IAAI,UAAU,KAAK,UAAU,IACxF,OAAM,IAAI,MAAM,mDAAmD;AAGrE,QAAO;EACL,MAAM;GAAE,SAAS;GAAc,YAAY;GAAa;EACxD,YAAY,EAAE,QAAQ,SAAS;EAChC;;AAGH,MAAMA,+BAAqF;CACzF,MAAM;EACJ,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACF;CACD,QAAQ;EACN,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACD,kCAAkC;EACnC;CACD,QAAQ;EACN,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACF;CACD,QAAQ;EACN,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACF;CACD,OAAO;EACL,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACF;CACD,OAAO;EACL,oBAAoB,CAAC,aAAa,aAAa;EAC/C,2BAA2B;GACzB,MAAM;IAAE,SAAS;IAAc,YAAY;IAAa;GACxD,YAAY,EAAE,QAAQ,IAAI;GAC3B;EACF;CACF;AAED,MAAaC,mCAGR,oBAAoB,KAAK,QAAQ;CACpC;CACA,oBAAoB,6BAA6B,IAAI;CACtD,EAAE;AAEH,SAAgB,wCAAwC,OAG1B;CAC5B,MAAM,WAAW,6BAA6B,MAAM;CACpD,MAAM,WAAW,SAAS;AAC1B,KAAI,SACF,QAAO,SAAS,MAAM,OAAO;AAE/B,QAAO,SAAS;;AAUlB,SAAS,oBACP,IACA,SACqB;CACrB,MAAM,SAAS;CACf,MAAM,qBAAqB,wCAAwC;EACjE;EACA,GAAG,UAAU,UAAU,OAAO;EAC/B,CAAC;AACF,QAAO;EACL,MAAM,mBAAmB;EACzB,UAAU;EACV,GAAG,UAAU,cAAc,mBAAmB,WAAW;EACzD,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.map

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

package/dist/runtime.mjs

@@ -21,9 +21,12 @@ const idGenerators = {
 
 //#endregion
 //#region src/runtime.ts
+function isBuiltinGeneratorId(id) {
+	return Object.hasOwn(idGenerators, id);
+}
 function generateId(spec) {
-	const generator = idGenerators[spec.id];
-	return generator(spec.params);
+	if (!isBuiltinGeneratorId(spec.id)) throw new Error(`Unknown built-in ID generator "${spec.id}".`);
+	return idGenerators[spec.id](spec.params);
 }
 
 //#endregion

package/dist/runtime.mjs.map

@@ -1 +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"}
+{"version":3,"file":"runtime.mjs","names":["ulidGenerator","nanoidGenerator","uuidv7Generator","uuidv4Generator","cuid2Generator","ksuidGenerator"],"sources":["../src/generators.ts","../src/runtime.ts"],"sourcesContent":["import { 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';\nimport type { BuiltinGeneratorId } from './generator-ids';\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<BuiltinGeneratorId, IdGenerator>;\n","import type { GeneratedValueSpec } from '@prisma-next/contract/types';\nimport type { BuiltinGeneratorId } from './generator-ids';\nimport { idGenerators } from './generators';\n\nfunction isBuiltinGeneratorId(id: string): id is BuiltinGeneratorId {\n  return Object.hasOwn(idGenerators, id);\n}\n\nexport function generateId(spec: GeneratedValueSpec): string {\n  if (!isBuiltinGeneratorId(spec.id)) {\n    throw new Error(`Unknown built-in ID generator \"${spec.id}\".`);\n  }\n  return idGenerators[spec.id](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;;;;ACtCD,SAAS,qBAAqB,IAAsC;AAClE,QAAO,OAAO,OAAO,cAAc,GAAG;;AAGxC,SAAgB,WAAW,MAAkC;AAC3D,KAAI,CAAC,qBAAqB,KAAK,GAAG,CAChC,OAAM,IAAI,MAAM,kCAAkC,KAAK,GAAG,IAAI;AAEhE,QAAO,aAAa,KAAK,IAAI,KAAK,OAAO"}

package/package.json

@@ -1,21 +1,21 @@
 {
   "name": "@prisma-next/ids",
-  "version": "0.3.0-dev.86",
+  "version": "0.3.0-dev.88",
   "type": "module",
   "sideEffects": false,
   "description": "ID generator helpers for Prisma Next contracts",
   "dependencies": {
     "uniku": "^0.0.12",
-    "@prisma-next/contract": "0.3.0-dev.86",
-    "@prisma-next/contract-authoring": "0.3.0-dev.86",
-    "@prisma-next/utils": "0.3.0-dev.86"
+    "@prisma-next/contract": "0.3.0-dev.88",
+    "@prisma-next/contract-authoring": "0.3.0-dev.88",
+    "@prisma-next/utils": "0.3.0-dev.88"
   },
   "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"
+    "@prisma-next/tsdown": "0.0.0",
+    "@prisma-next/tsconfig": "0.0.0"
   },
   "files": [
     "dist",

package/src/generator-ids.ts

@@ -0,0 +1,10 @@
+export const builtinGeneratorIds = [
+  'ulid',
+  'nanoid',
+  'uuidv7',
+  'uuidv4',
+  'cuid2',
+  'ksuid',
+] as const;
+
+export type BuiltinGeneratorId = (typeof builtinGeneratorIds)[number];

package/src/generators.ts

@@ -1,10 +1,10 @@
-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';
+import type { BuiltinGeneratorId } from './generator-ids';
 
 type FirstArg<TFunction> = TFunction extends (...args: infer TArgs) => unknown
   ? TArgs extends []
@@ -40,4 +40,4 @@ export const idGenerators = {
   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>;
+} as const satisfies Record<BuiltinGeneratorId, IdGenerator>;

package/src/index.ts

@@ -1,43 +1,111 @@
-import type {
-  ExecutionMutationDefaultValue,
-  GeneratedValueSpec,
-} from '@prisma-next/contract/types';
+import type { ExecutionMutationDefaultValue } from '@prisma-next/contract/types';
 import type { ColumnTypeDescriptor } from '@prisma-next/contract-authoring';
 import { ifDefined } from '@prisma-next/utils/defined';
+import { type BuiltinGeneratorId, builtinGeneratorIds } from './generator-ids';
 import type { IdGeneratorOptionsById } from './generators';
 
-type GeneratedColumnDescriptor = {
+export { builtinGeneratorIds };
+
+export type GeneratedColumnDescriptor = {
   readonly type: ColumnTypeDescriptor;
   readonly typeParams?: Record<string, unknown>;
 };
 
-const generatedColumnDescriptors: Record<GeneratedValueSpec['id'], GeneratedColumnDescriptor> = {
-  ulid: {
+type BuiltinGeneratorMetadata = {
+  readonly applicableCodecIds: readonly string[];
+  readonly generatedColumnDescriptor: GeneratedColumnDescriptor;
+  readonly resolveGeneratedColumnDescriptor?: (
+    params?: Record<string, unknown>,
+  ) => GeneratedColumnDescriptor;
+};
+
+function resolveNanoidColumnDescriptor(
+  params?: Record<string, unknown>,
+): GeneratedColumnDescriptor {
+  const rawSize = params?.['size'];
+  if (rawSize === undefined) {
+    return {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 21 },
+    };
+  }
+
+  if (typeof rawSize !== 'number' || !Number.isInteger(rawSize) || rawSize < 2 || rawSize > 255) {
+    throw new Error('nanoid size must be an integer between 2 and 255');
+  }
+
+  return {
     type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 26 },
+    typeParams: { length: rawSize },
+  };
+}
+
+const builtinGeneratorMetadataById: Record<BuiltinGeneratorId, BuiltinGeneratorMetadata> = {
+  ulid: {
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 26 },
+    },
   },
   nanoid: {
-    type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 21 },
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 21 },
+    },
+    resolveGeneratedColumnDescriptor: resolveNanoidColumnDescriptor,
   },
   uuidv7: {
-    type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 36 },
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 36 },
+    },
   },
   uuidv4: {
-    type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 36 },
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 36 },
+    },
   },
   cuid2: {
-    type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 24 },
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 24 },
+    },
   },
   ksuid: {
-    type: { codecId: 'sql/char@1', nativeType: 'character' },
-    typeParams: { length: 27 },
+    applicableCodecIds: ['pg/text@1', 'sql/char@1'],
+    generatedColumnDescriptor: {
+      type: { codecId: 'sql/char@1', nativeType: 'character' },
+      typeParams: { length: 27 },
+    },
   },
 };
 
+export const builtinGeneratorRegistryMetadata: ReadonlyArray<{
+  readonly id: BuiltinGeneratorId;
+  readonly applicableCodecIds: readonly string[];
+}> = builtinGeneratorIds.map((id) => ({
+  id,
+  applicableCodecIds: builtinGeneratorMetadataById[id].applicableCodecIds,
+}));
+
+export function resolveBuiltinGeneratedColumnDescriptor(input: {
+  readonly id: BuiltinGeneratorId;
+  readonly params?: Record<string, unknown>;
+}): GeneratedColumnDescriptor {
+  const metadata = builtinGeneratorMetadataById[input.id];
+  const resolver = metadata.resolveGeneratedColumnDescriptor;
+  if (resolver) {
+    return resolver(input.params);
+  }
+  return metadata.generatedColumnDescriptor;
+}
+
 export type GeneratedColumnSpec = {
   readonly type: ColumnTypeDescriptor;
   readonly nullable?: false;
@@ -45,24 +113,19 @@ export type GeneratedColumnSpec = {
   readonly generated: ExecutionMutationDefaultValue;
 };
 
-function createGeneratedSpec<TId extends GeneratedValueSpec['id']>(
+function createGeneratedSpec<TId extends BuiltinGeneratorId>(
   id: TId,
   options?: IdGeneratorOptionsById[TId],
 ): GeneratedColumnSpec {
-  const { type } = generatedColumnDescriptors[id];
-  const typeParams =
-    id === 'nanoid' &&
-    typeof options === 'object' &&
-    options !== null &&
-    'size' in options &&
-    typeof options.size === 'number'
-      ? { length: options.size }
-      : generatedColumnDescriptors[id].typeParams;
   const params = options as Record<string, unknown> | undefined;
+  const resolvedDescriptor = resolveBuiltinGeneratedColumnDescriptor({
+    id,
+    ...ifDefined('params', params),
+  });
   return {
-    type,
+    type: resolvedDescriptor.type,
     nullable: false,
-    ...ifDefined('typeParams', typeParams),
+    ...ifDefined('typeParams', resolvedDescriptor.typeParams),
     generated: {
       kind: 'generator',
       id,

package/src/runtime.ts

@@ -1,7 +1,14 @@
 import type { GeneratedValueSpec } from '@prisma-next/contract/types';
+import type { BuiltinGeneratorId } from './generator-ids';
 import { idGenerators } from './generators';
 
+function isBuiltinGeneratorId(id: string): id is BuiltinGeneratorId {
+  return Object.hasOwn(idGenerators, id);
+}
+
 export function generateId(spec: GeneratedValueSpec): string {
-  const generator = idGenerators[spec.id];
-  return generator(spec.params);
+  if (!isBuiltinGeneratorId(spec.id)) {
+    throw new Error(`Unknown built-in ID generator "${spec.id}".`);
+  }
+  return idGenerators[spec.id](spec.params);
 }