@prisma-next/emitter 0.3.0-dev.14 → 0.3.0-dev.146

package/src/domain-type-generation.ts

@@ -0,0 +1,357 @@
+import type {
+  ContractField,
+  ContractModel,
+  ContractValueObject,
+} from '@prisma-next/contract/types';
+import type { CodecLookup } from '@prisma-next/framework-components/codec';
+import type { TypesImportSpec } from '@prisma-next/framework-components/emission';
+import { isSafeTypeExpression } from './type-expression-safety';
+
+export function serializeValue(value: unknown): string {
+  if (value === null) {
+    return 'null';
+  }
+  if (value === undefined) {
+    return 'undefined';
+  }
+  if (typeof value === 'string') {
+    const escaped = value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `'${escaped}'`;
+  }
+  if (typeof value === 'number' || typeof value === 'boolean') {
+    return String(value);
+  }
+  if (typeof value === 'bigint') {
+    return `${value}n`;
+  }
+  if (Array.isArray(value)) {
+    const items = value.map((v) => serializeValue(v)).join(', ');
+    return `readonly [${items}]`;
+  }
+  if (typeof value === 'object') {
+    const entries: string[] = [];
+    for (const [k, v] of Object.entries(value)) {
+      entries.push(`readonly ${serializeObjectKey(k)}: ${serializeValue(v)}`);
+    }
+    return `{ ${entries.join('; ')} }`;
+  }
+  return 'unknown';
+}
+
+export function serializeObjectKey(key: string): string {
+  if (/^[$A-Z_a-z][$\w]*$/.test(key)) {
+    return key;
+  }
+  return serializeValue(key);
+}
+
+export function generateRootsType(roots: Record<string, string> | undefined): string {
+  if (!roots || Object.keys(roots).length === 0) {
+    return 'Record<string, string>';
+  }
+  const entries = Object.entries(roots)
+    .map(([key, value]) => `readonly ${serializeObjectKey(key)}: ${serializeValue(value)}`)
+    .join('; ');
+  return `{ ${entries} }`;
+}
+
+function contractFieldModifierSuffix(field: ContractField): string {
+  const many = field.many === true ? '; readonly many: true' : '';
+  const dict = field.dict === true ? '; readonly dict: true' : '';
+  return many + dict;
+}
+
+export function generateModelFieldEntry(fieldName: string, field: ContractField): string {
+  const mods = contractFieldModifierSuffix(field);
+  const { nullable, type } = field;
+  if (type.kind === 'scalar') {
+    const typeParamsSpec =
+      type.typeParams && Object.keys(type.typeParams).length > 0
+        ? `; readonly typeParams: ${serializeValue(type.typeParams)}`
+        : '';
+    return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${nullable}; readonly type: { readonly kind: 'scalar'; readonly codecId: ${serializeValue(type.codecId)}${typeParamsSpec} }${mods} }`;
+  }
+  if (type.kind === 'valueObject') {
+    return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${nullable}; readonly type: { readonly kind: 'valueObject'; readonly name: ${serializeValue(type.name)} }${mods} }`;
+  }
+  return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${nullable}; readonly type: ${serializeValue(type)}${mods} }`;
+}
+
+export function generateModelFieldsType(fields: Record<string, ContractField>): string {
+  const fieldEntries: string[] = [];
+  for (const [fieldName, field] of Object.entries(fields)) {
+    fieldEntries.push(generateModelFieldEntry(fieldName, field));
+  }
+  return fieldEntries.length > 0 ? `{ ${fieldEntries.join('; ')} }` : 'Record<string, never>';
+}
+
+export function generateModelRelationsType(relations: Record<string, unknown>): string {
+  const relationEntries: string[] = [];
+
+  for (const [relName, rel] of Object.entries(relations)) {
+    if (typeof rel !== 'object' || rel === null) continue;
+    const relObj = rel as Record<string, unknown>;
+    const parts: string[] = [];
+
+    if (relObj['to']) parts.push(`readonly to: ${serializeValue(relObj['to'])}`);
+    if (relObj['cardinality'])
+      parts.push(`readonly cardinality: ${serializeValue(relObj['cardinality'])}`);
+
+    const on = relObj['on'] as { localFields?: string[]; targetFields?: string[] } | undefined;
+    if (on && (!on.localFields || !on.targetFields)) {
+      throw new Error(
+        `Relation "${relName}" has an "on" block but is missing localFields or targetFields`,
+      );
+    }
+    if (on?.localFields && on.targetFields) {
+      const localFields = on.localFields.map((f) => serializeValue(f)).join(', ');
+      const targetFields = on.targetFields.map((f) => serializeValue(f)).join(', ');
+      parts.push(
+        `readonly on: { readonly localFields: readonly [${localFields}]; readonly targetFields: readonly [${targetFields}] }`,
+      );
+    }
+
+    if (parts.length > 0) {
+      relationEntries.push(`readonly ${relName}: { ${parts.join('; ')} }`);
+    }
+  }
+
+  if (relationEntries.length === 0) {
+    return 'Record<string, never>';
+  }
+
+  return `{ ${relationEntries.join('; ')} }`;
+}
+
+export function generateModelsType(
+  models: Record<string, ContractModel>,
+  generateModelStorage: (modelName: string, model: ContractModel) => string,
+): string {
+  if (!models || Object.keys(models).length === 0) {
+    return 'Record<string, never>';
+  }
+
+  const modelTypes: string[] = [];
+  for (const [modelName, model] of Object.entries(models).sort(([a], [b]) => a.localeCompare(b))) {
+    const fieldsType = generateModelFieldsType(model.fields);
+    const relationsType = generateModelRelationsType(model.relations);
+    const storageType = generateModelStorage(modelName, model);
+
+    const modelParts: string[] = [
+      `readonly fields: ${fieldsType}`,
+      `readonly relations: ${relationsType}`,
+      `readonly storage: ${storageType}`,
+    ];
+
+    if (model.owner) {
+      modelParts.push(`readonly owner: ${serializeValue(model.owner)}`);
+    }
+    if (model.discriminator) {
+      modelParts.push(`readonly discriminator: ${serializeValue(model.discriminator)}`);
+    }
+    if (model.variants) {
+      modelParts.push(`readonly variants: ${serializeValue(model.variants)}`);
+    }
+    if (model.base) {
+      modelParts.push(`readonly base: ${serializeValue(model.base)}`);
+    }
+
+    modelTypes.push(`readonly ${modelName}: { ${modelParts.join('; ')} }`);
+  }
+
+  return `{ ${modelTypes.join('; ')} }`;
+}
+
+export function deduplicateImports(imports: TypesImportSpec[]): TypesImportSpec[] {
+  const seenKeys = new Set<string>();
+  const result: TypesImportSpec[] = [];
+  for (const imp of imports) {
+    const key = `${imp.package}::${imp.named}`;
+    if (!seenKeys.has(key)) {
+      seenKeys.add(key);
+      result.push(imp);
+    }
+  }
+  return result;
+}
+
+export function generateImportLines(imports: TypesImportSpec[]): string[] {
+  return imports.map((imp) => {
+    const importClause = imp.named === imp.alias ? imp.named : `${imp.named} as ${imp.alias}`;
+    return `import type { ${importClause} } from '${imp.package}';`;
+  });
+}
+
+export function generateCodecTypeIntersection(
+  imports: ReadonlyArray<TypesImportSpec>,
+  named: string,
+): string {
+  const aliases = imports.filter((imp) => imp.named === named).map((imp) => imp.alias);
+  return aliases.join(' & ') || 'Record<string, never>';
+}
+
+export function serializeExecutionType(execution: Record<string, unknown>): string {
+  const parts: string[] = ['readonly executionHash: ExecutionHash'];
+  for (const [key, value] of Object.entries(execution)) {
+    if (key === 'executionHash') continue;
+    parts.push(`readonly ${serializeObjectKey(key)}: ${serializeValue(value)}`);
+  }
+  return `{ ${parts.join('; ')} }`;
+}
+
+export function generateHashTypeAliases(hashes: {
+  readonly storageHash: string;
+  readonly executionHash?: string;
+  readonly profileHash: string;
+}): string {
+  const executionHashType = hashes.executionHash
+    ? `ExecutionHashBase<'${hashes.executionHash}'>`
+    : 'ExecutionHashBase<string>';
+
+  return [
+    `export type StorageHash = StorageHashBase<'${hashes.storageHash}'>;`,
+    `export type ExecutionHash = ${executionHashType};`,
+    `export type ProfileHash = ProfileHashBase<'${hashes.profileHash}'>;`,
+  ].join('\n');
+}
+
+export function generateFieldResolvedType(field: ContractField, codecLookup?: CodecLookup): string {
+  let baseType: string;
+  const { type } = field;
+
+  switch (type.kind) {
+    case 'scalar': {
+      let resolved: string | undefined;
+      if (codecLookup && type.typeParams && Object.keys(type.typeParams).length > 0) {
+        const codec = codecLookup.get(type.codecId);
+        if (codec?.renderOutputType) {
+          const rendered = codec.renderOutputType(type.typeParams);
+          if (rendered && isSafeTypeExpression(rendered)) {
+            resolved = rendered;
+          }
+        }
+      }
+      baseType = resolved ?? `CodecTypes[${serializeValue(type.codecId)}]['output']`;
+      break;
+    }
+    case 'valueObject':
+      baseType = type.name;
+      break;
+    case 'union': {
+      const memberTypes = type.members.map((m) => {
+        if (m.kind === 'scalar') return `CodecTypes[${serializeValue(m.codecId)}]['output']`;
+        return m.name;
+      });
+      baseType = memberTypes.join(' | ');
+      break;
+    }
+    default:
+      baseType = 'unknown';
+      break;
+  }
+
+  if (field.many === true) {
+    baseType = `ReadonlyArray<${baseType}>`;
+  }
+  if (field.dict === true) {
+    baseType = `Readonly<Record<string, ${baseType}>>`;
+  }
+  if (field.nullable) {
+    baseType = `${baseType} | null`;
+  }
+
+  return baseType;
+}
+
+export function generateFieldOutputTypesMap(
+  models: Record<string, ContractModel> | undefined,
+  codecLookup?: CodecLookup,
+): string {
+  if (!models || Object.keys(models).length === 0) {
+    return 'Record<string, never>';
+  }
+
+  const modelEntries: string[] = [];
+  for (const [modelName, model] of Object.entries(models).sort(([a], [b]) => a.localeCompare(b))) {
+    if (!model) continue;
+    const fieldEntries: string[] = [];
+    for (const [fieldName, field] of Object.entries(model.fields)) {
+      const resolvedType = generateFieldResolvedType(field, codecLookup);
+      fieldEntries.push(`readonly ${serializeObjectKey(fieldName)}: ${resolvedType}`);
+    }
+    const fieldsType =
+      fieldEntries.length > 0 ? `{ ${fieldEntries.join('; ')} }` : 'Record<string, never>';
+    modelEntries.push(`readonly ${serializeObjectKey(modelName)}: ${fieldsType}`);
+  }
+
+  return `{ ${modelEntries.join('; ')} }`;
+}
+
+export function generateValueObjectType(
+  _voName: string,
+  vo: ContractValueObject,
+  _valueObjects: Record<string, ContractValueObject>,
+): string {
+  const fieldEntries: string[] = [];
+  for (const [fieldName, field] of Object.entries(vo.fields)) {
+    const tsType = generateFieldResolvedType(field);
+    fieldEntries.push(`readonly ${serializeObjectKey(fieldName)}: ${tsType}`);
+  }
+  return fieldEntries.length > 0 ? `{ ${fieldEntries.join('; ')} }` : 'Record<string, never>';
+}
+
+export function generateContractFieldDescriptor(fieldName: string, field: ContractField): string {
+  const mods: string[] = [];
+  if (field.many === true) mods.push('; readonly many: true');
+  if (field.dict === true) mods.push('; readonly dict: true');
+  const modStr = mods.join('');
+
+  const { type } = field;
+  if (type.kind === 'scalar') {
+    const typeParamsSpec =
+      type.typeParams && Object.keys(type.typeParams).length > 0
+        ? `; readonly typeParams: ${serializeValue(type.typeParams)}`
+        : '';
+    return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${field.nullable}; readonly type: { readonly kind: 'scalar'; readonly codecId: ${serializeValue(type.codecId)}${typeParamsSpec} }${modStr} }`;
+  }
+  if (type.kind === 'valueObject') {
+    return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${field.nullable}; readonly type: { readonly kind: 'valueObject'; readonly name: ${serializeValue(type.name)} }${modStr} }`;
+  }
+  return `readonly ${serializeObjectKey(fieldName)}: { readonly nullable: ${field.nullable}; readonly type: ${serializeValue(type)}${modStr} }`;
+}
+
+export function generateValueObjectsDescriptorType(
+  valueObjects: Record<string, ContractValueObject> | undefined,
+): string {
+  if (!valueObjects || Object.keys(valueObjects).length === 0) {
+    return 'Record<string, never>';
+  }
+
+  const voEntries: string[] = [];
+  for (const [voName, vo] of Object.entries(valueObjects)) {
+    const fieldEntries: string[] = [];
+    for (const [fieldName, field] of Object.entries(vo.fields)) {
+      fieldEntries.push(generateContractFieldDescriptor(fieldName, field));
+    }
+    const fieldsType =
+      fieldEntries.length > 0 ? `{ ${fieldEntries.join('; ')} }` : 'Record<string, never>';
+    voEntries.push(`readonly ${serializeObjectKey(voName)}: { readonly fields: ${fieldsType} }`);
+  }
+
+  return `{ ${voEntries.join('; ')} }`;
+}
+
+export function generateValueObjectTypeAliases(
+  valueObjects: Record<string, ContractValueObject> | undefined,
+): string {
+  if (!valueObjects || Object.keys(valueObjects).length === 0) {
+    return '';
+  }
+
+  const aliases: string[] = [];
+  for (const [voName, vo] of Object.entries(valueObjects)) {
+    const voType = generateValueObjectType(voName, vo, valueObjects);
+    aliases.push(`export type ${voName} = ${voType};`);
+  }
+  return aliases.join('\n');
+}

package/src/emit-types.ts

@@ -0,0 +1,23 @@
+import type { CodecLookup } from '@prisma-next/framework-components/codec';
+import type { TypesImportSpec } from '@prisma-next/framework-components/emission';
+
+/**
+ * The subset of ControlStack that emit() reads.
+ * All fields are optional so tests can pass minimal objects.
+ * A full ControlStack satisfies this via structural typing.
+ */
+export interface EmitStackInput {
+  readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;
+  readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;
+  readonly queryOperationTypeImports?: ReadonlyArray<TypesImportSpec>;
+  readonly extensionIds?: ReadonlyArray<string>;
+  readonly codecLookup?: CodecLookup;
+}
+
+export interface EmitResult {
+  readonly contractJson: string;
+  readonly contractDts: string;
+  readonly storageHash: string;
+  readonly executionHash?: string;
+  readonly profileHash: string;
+}

package/src/emit.ts

@@ -0,0 +1,68 @@
+import { canonicalizeContractToObject } from '@prisma-next/contract/hashing';
+import type { Contract } from '@prisma-next/contract/types';
+import type { EmissionSpi } from '@prisma-next/framework-components/emission';
+import { ifDefined } from '@prisma-next/utils/defined';
+import { format } from 'prettier';
+import type { EmitResult, EmitStackInput } from './emit-types';
+import { generateContractDts } from './generate-contract-dts';
+
+const SCHEMA_VERSION = '1';
+
+export async function emit(
+  contract: Contract,
+  stack: EmitStackInput,
+  targetFamily: EmissionSpi,
+): Promise<EmitResult> {
+  const { codecTypeImports, operationTypeImports, queryOperationTypeImports } = stack;
+
+  const { storageHash } = contract.storage;
+  const executionHash = contract.execution?.executionHash;
+  const { profileHash } = contract;
+
+  const canonicalized = canonicalizeContractToObject(contract, {
+    schemaVersion: SCHEMA_VERSION,
+  });
+  const contractJsonString = JSON.stringify(
+    {
+      ...canonicalized,
+      _generated: {
+        warning: '⚠️  GENERATED FILE - DO NOT EDIT',
+        message: 'This file is automatically generated by "prisma-next contract emit".',
+        regenerate: 'To regenerate, run: prisma-next contract emit',
+      },
+    },
+    null,
+    2,
+  );
+
+  const generateOptions = queryOperationTypeImports ? { queryOperationTypeImports } : undefined;
+
+  const contractTypeHashes = {
+    storageHash,
+    ...ifDefined('executionHash', executionHash),
+    profileHash,
+  };
+  const contractDtsRaw = generateContractDts(
+    contract,
+    targetFamily,
+    codecTypeImports ?? [],
+    operationTypeImports ?? [],
+    contractTypeHashes,
+    generateOptions,
+    stack.codecLookup,
+  );
+  const contractDts = await format(contractDtsRaw, {
+    parser: 'typescript',
+    singleQuote: true,
+    semi: true,
+    printWidth: 100,
+  });
+
+  return {
+    contractJson: contractJsonString,
+    contractDts,
+    storageHash,
+    ...ifDefined('executionHash', executionHash),
+    profileHash,
+  };
+}

package/src/exports/index.ts

@@ -1,9 +1,14 @@
-// Re-export types from @prisma-next/contract for backward compatibility
-export type {
-  TargetFamilyHook,
-  TypesImportSpec,
-  ValidationContext,
-} from '@prisma-next/contract/types';
-export type { EmitOptions, EmitResult } from '@prisma-next/core-control-plane/emission';
-// Re-export emit function and types from core-control-plane
-export { emit } from '@prisma-next/core-control-plane/emission';
+export {
+  deduplicateImports,
+  generateCodecTypeIntersection,
+  generateFieldOutputTypesMap,
+  generateHashTypeAliases,
+  generateImportLines,
+  generateModelRelationsType,
+  generateRootsType,
+  serializeObjectKey,
+  serializeValue,
+} from '../domain-type-generation';
+export { emit } from '../emit';
+export type { EmitResult, EmitStackInput } from '../emit-types';
+export { generateContractDts } from '../generate-contract-dts';

package/src/generate-contract-dts.ts

@@ -0,0 +1,116 @@
+import type { Contract, ContractModel, ContractValueObject } from '@prisma-next/contract/types';
+import type { CodecLookup } from '@prisma-next/framework-components/codec';
+import type {
+  EmissionSpi,
+  GenerateContractTypesOptions,
+  TypesImportSpec,
+} from '@prisma-next/framework-components/emission';
+import {
+  deduplicateImports,
+  generateCodecTypeIntersection,
+  generateFieldOutputTypesMap,
+  generateHashTypeAliases,
+  generateImportLines,
+  generateModelsType,
+  generateRootsType,
+  generateValueObjectsDescriptorType,
+  generateValueObjectTypeAliases,
+  serializeExecutionType,
+  serializeValue,
+} from './domain-type-generation';
+
+export function generateContractDts(
+  contract: Contract,
+  emitter: EmissionSpi,
+  codecTypeImports: ReadonlyArray<TypesImportSpec>,
+  operationTypeImports: ReadonlyArray<TypesImportSpec>,
+  hashes: {
+    readonly storageHash: string;
+    readonly executionHash?: string;
+    readonly profileHash: string;
+  },
+  options?: GenerateContractTypesOptions,
+  codecLookup?: CodecLookup,
+): string {
+  const allImports: TypesImportSpec[] = [...codecTypeImports, ...operationTypeImports];
+  if (options?.queryOperationTypeImports) {
+    allImports.push(...options.queryOperationTypeImports);
+  }
+  const uniqueImports = deduplicateImports(allImports);
+  const importLines = generateImportLines(uniqueImports);
+
+  const familyImportLines = emitter.getFamilyImports();
+
+  const hashAliases = generateHashTypeAliases(hashes);
+
+  const codecTypes = generateCodecTypeIntersection(codecTypeImports, 'CodecTypes');
+  const operationTypes = generateCodecTypeIntersection(operationTypeImports, 'OperationTypes');
+
+  const familyTypeAliases = emitter.getFamilyTypeAliases(options);
+
+  const typeMapsExpr = emitter.getTypeMapsExpression();
+
+  const storageType = emitter.generateStorageType(contract, 'StorageHash');
+
+  const modelsType = generateModelsType(
+    contract.models as Record<string, ContractModel>,
+    (name, model) => emitter.generateModelStorageType(name, model),
+  );
+
+  const rootsType = generateRootsType(contract.roots);
+
+  const valueObjects = contract.valueObjects as Record<string, ContractValueObject> | undefined;
+  const valueObjectTypeAliases = generateValueObjectTypeAliases(valueObjects);
+  const valueObjectsDescriptor = generateValueObjectsDescriptorType(valueObjects);
+
+  const executionClause =
+    contract.execution !== undefined
+      ? `\n  readonly execution: ${serializeExecutionType(contract.execution)};`
+      : '';
+
+  const fieldOutputTypesMap = generateFieldOutputTypesMap(
+    contract.models as Record<string, ContractModel> | undefined,
+    codecLookup,
+  );
+
+  const contractWrapper = emitter.getContractWrapper('ContractBase', 'TypeMaps');
+
+  return `// ⚠️  GENERATED FILE - DO NOT EDIT
+// This file is automatically generated by 'prisma-next contract emit'.
+// To regenerate, run: prisma-next contract emit
+${importLines.join('\n')}
+
+${familyImportLines.join('\n')}
+import type {
+  Contract as ContractType,
+  ExecutionHashBase,
+  ProfileHashBase,
+  StorageHashBase,
+} from '@prisma-next/contract/types';
+
+${hashAliases}
+
+export type CodecTypes = ${codecTypes};
+export type OperationTypes = ${operationTypes};
+${familyTypeAliases}
+${valueObjectTypeAliases}
+export type FieldOutputTypes = ${fieldOutputTypesMap};
+export type TypeMaps = ${typeMapsExpr};
+
+type ContractBase = ContractType<
+${storageType},
+${modelsType}
+> & {
+  readonly target: ${serializeValue(contract.target)};
+  readonly targetFamily: ${serializeValue(contract.targetFamily)};
+  readonly roots: ${rootsType};
+  readonly capabilities: ${serializeValue(contract.capabilities)};
+  readonly extensionPacks: ${serializeValue(contract.extensionPacks)};${executionClause}
+  readonly meta: ${serializeValue(contract.meta)};
+  ${valueObjects ? `readonly valueObjects: ${valueObjectsDescriptor};` : ''}
+  readonly profileHash: ProfileHash;
+};
+
+${contractWrapper}
+`;
+}

package/src/type-expression-safety.ts

@@ -0,0 +1,3 @@
+export function isSafeTypeExpression(expr: string): boolean {
+  return !/import\s*\(|require\s*\(|declare\s|export\s|eval\s*\(/.test(expr);
+}