@prisma-next/emitter 0.4.0-dev.9 → 0.4.1

package/dist/exports/index.d.mts

@@ -3,8 +3,14 @@ import { Contract } from "@prisma-next/contract/types";
 import { CodecLookup } from "@prisma-next/framework-components/codec";
 import { EmissionSpi, GenerateContractTypesOptions, TypesImportSpec } from "@prisma-next/framework-components/emission";
 
+//#region src/artifact-paths.d.ts
+interface EmittedArtifactPaths {
+  readonly jsonPath: string;
+  readonly dtsPath: string;
+}
+declare function getEmittedArtifactPaths(outputJsonPath: string): EmittedArtifactPaths;
+//#endregion
 //#region src/emit-types.d.ts
-
 /**
  * The subset of ControlStack that emit() reads.
  * All fields are optional so tests can pass minimal objects.
@@ -17,6 +23,9 @@ interface EmitStackInput {
   readonly extensionIds?: ReadonlyArray<string>;
   readonly codecLookup?: CodecLookup;
 }
+interface EmitOptions {
+  readonly outputJsonPath?: string;
+}
 interface EmitResult {
   readonly contractJson: string;
   readonly contractDts: string;
@@ -26,7 +35,7 @@ interface EmitResult {
 }
 //#endregion
 //#region src/emit.d.ts
-declare function emit(contract: Contract, stack: EmitStackInput, targetFamily: EmissionSpi): Promise<EmitResult>;
+declare function emit(contract: Contract, stack: EmitStackInput, targetFamily: EmissionSpi, options?: EmitOptions): Promise<EmitResult>;
 //#endregion
 //#region src/generate-contract-dts.d.ts
 declare function generateContractDts(contract: Contract, emitter: EmissionSpi, codecTypeImports: ReadonlyArray<TypesImportSpec>, operationTypeImports: ReadonlyArray<TypesImportSpec>, hashes: {
@@ -35,5 +44,5 @@ declare function generateContractDts(contract: Contract, emitter: EmissionSpi, c
   readonly profileHash: string;
 }, options?: GenerateContractTypesOptions, codecLookup?: CodecLookup): string;
 //#endregion
-export { type EmitResult, type EmitStackInput, deduplicateImports, emit, generateCodecTypeIntersection, generateContractDts, generateFieldOutputTypesMap, generateHashTypeAliases, generateImportLines, generateModelRelationsType, generateRootsType, serializeObjectKey, serializeValue };
+export { type EmitResult, type EmitStackInput, type EmittedArtifactPaths, deduplicateImports, emit, generateCodecTypeIntersection, generateContractDts, generateFieldOutputTypesMap, generateHashTypeAliases, generateImportLines, generateModelRelationsType, generateRootsType, getEmittedArtifactPaths, serializeObjectKey, serializeValue };
 //# sourceMappingURL=index.d.mts.map

package/dist/exports/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/emit-types.ts","../../src/emit.ts","../../src/generate-contract-dts.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAQA;AAC4C,UAD3B,cAAA,CAC2B;EAAd,SAAA,gBAAA,CAAA,EAAA,aAAA,CAAc,eAAd,CAAA;EACkB,SAAA,oBAAA,CAAA,EAAd,aAAc,CAAA,eAAA,CAAA;EAAd,SAAA,yBAAA,CAAA,EACK,aADL,CACmB,eADnB,CAAA;EACmB,SAAA,YAAA,CAAA,EAC3B,aAD2B,CAAA,MAAA,CAAA;EAAd,SAAA,WAAA,CAAA,EAEd,WAFc;;AAEd,UAGR,UAAA,CAHQ;EAAW,SAAA,YAAA,EAAA,MAAA;EAGnB,SAAA,WAAU,EAAA,MAAA;;;;ACN3B;;;iBAAsB,IAAA,WACV,iBACH,8BACO,cACb,QAAQ;;;iBCOK,mBAAA,WACJ,mBACD,+BACS,cAAc,wCACV,cAAc;;;EFjBrB,SAAA,WAAc,EAAA,MAAA;CACa,EAAA,OAAA,CAAA,EEsBhC,4BFtBgC,EAAA,WAAA,CAAA,EEuB5B,WFvB4B,CAAA,EAAA,MAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/artifact-paths.ts","../../src/emit-types.ts","../../src/emit.ts","../../src/generate-contract-dts.ts"],"sourcesContent":[],"mappings":";;;;;;UAEiB,oBAAA;;;;iBAKD,uBAAA,0BAAiD;;;;;;;AALjE;AAKgB,UCCC,cAAA,CDDsB;8BCET,cAAc;kCACV,cAAc;uCACT,cAAc;EAHpC,SAAA,YAAc,CAAA,EAIL,aAJK,CAAA,MAAA,CAAA;EACa,SAAA,WAAA,CAAA,EAInB,WAJmB;;AACI,UAM/B,WAAA,CAN+B;EAAd,SAAA,cAAA,CAAA,EAAA,MAAA;;AACK,UAStB,UAAA,CATsB;EACb,SAAA,YAAA,EAAA,MAAA;EACD,SAAA,WAAA,EAAA,MAAA;EAAW,SAAA,WAAA,EAAA,MAAA;EAGnB,SAAA,aAAW,CAAA,EAAA,MAAA;EAIX,SAAA,WAAU,EAAA,MAAA;;;;iBCTL,IAAA,WACV,iBACH,8BACO,uBACJ,cACT,QAAQ;;;iBCKK,mBAAA,WACJ,mBACD,+BACS,cAAc,wCACV,cAAc;;;EHvBrB,SAAA,WAAA,EAAA,MAAoB;AAKrC,CAAA,EAAA,OAAuC,CAAvB,EGwBJ,4BHxB2B,EAA0B,WAAoB,CAApB,EGyBjD,WHzBqE,CAAA,EAAA,MAAA"}

package/dist/exports/index.mjs

@@ -3,6 +3,17 @@ import { canonicalizeContractToObject } from "@prisma-next/contract/hashing";
 import { ifDefined } from "@prisma-next/utils/defined";
 import { format } from "prettier";
 
+//#region src/artifact-paths.ts
+const JSON_EXTENSION = ".json";
+function getEmittedArtifactPaths(outputJsonPath) {
+	if (!outputJsonPath.endsWith(JSON_EXTENSION)) throw new Error("Contract output path must end with .json");
+	return {
+		jsonPath: outputJsonPath,
+		dtsPath: `${outputJsonPath.slice(0, -5)}.d.ts`
+	};
+}
+
+//#endregion
 //#region src/generate-contract-dts.ts
 function generateContractDts(contract, emitter, codecTypeImports, operationTypeImports, hashes, options, codecLookup) {
 	const allImports = [...codecTypeImports, ...operationTypeImports];
@@ -67,7 +78,8 @@ ${contractWrapper}
 //#endregion
 //#region src/emit.ts
 const SCHEMA_VERSION = "1";
-async function emit(contract, stack, targetFamily) {
+async function emit(contract, stack, targetFamily, options) {
+	if (options?.outputJsonPath !== void 0) getEmittedArtifactPaths(options.outputJsonPath);
 	const { codecTypeImports, operationTypeImports, queryOperationTypeImports } = stack;
 	const { storageHash } = contract.storage;
 	const executionHash = contract.execution?.executionHash;
@@ -102,5 +114,5 @@ async function emit(contract, stack, targetFamily) {
 }
 
 //#endregion
-export { deduplicateImports, emit, generateCodecTypeIntersection, generateContractDts, generateFieldOutputTypesMap, generateHashTypeAliases, generateImportLines, generateModelRelationsType, generateRootsType, serializeObjectKey, serializeValue };
+export { deduplicateImports, emit, generateCodecTypeIntersection, generateContractDts, generateFieldOutputTypesMap, generateHashTypeAliases, generateImportLines, generateModelRelationsType, generateRootsType, getEmittedArtifactPaths, serializeObjectKey, serializeValue };
 //# sourceMappingURL=index.mjs.map

package/dist/exports/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["allImports: TypesImportSpec[]"],"sources":["../../src/generate-contract-dts.ts","../../src/emit.ts"],"sourcesContent":["import type { Contract, ContractModel, ContractValueObject } from '@prisma-next/contract/types';\nimport type { CodecLookup } from '@prisma-next/framework-components/codec';\nimport type {\n  EmissionSpi,\n  GenerateContractTypesOptions,\n  TypesImportSpec,\n} from '@prisma-next/framework-components/emission';\nimport {\n  deduplicateImports,\n  generateBothFieldTypesMaps,\n  generateCodecTypeIntersection,\n  generateHashTypeAliases,\n  generateImportLines,\n  generateModelsType,\n  generateRootsType,\n  generateValueObjectsDescriptorType,\n  generateValueObjectTypeAliases,\n  serializeExecutionType,\n  serializeValue,\n} from './domain-type-generation';\n\nexport function generateContractDts(\n  contract: Contract,\n  emitter: EmissionSpi,\n  codecTypeImports: ReadonlyArray<TypesImportSpec>,\n  operationTypeImports: ReadonlyArray<TypesImportSpec>,\n  hashes: {\n    readonly storageHash: string;\n    readonly executionHash?: string;\n    readonly profileHash: string;\n  },\n  options?: GenerateContractTypesOptions,\n  codecLookup?: CodecLookup,\n): string {\n  const allImports: TypesImportSpec[] = [...codecTypeImports, ...operationTypeImports];\n  if (options?.queryOperationTypeImports) {\n    allImports.push(...options.queryOperationTypeImports);\n  }\n  const uniqueImports = deduplicateImports(allImports);\n  const importLines = generateImportLines(uniqueImports);\n\n  const familyImportLines = emitter.getFamilyImports();\n\n  const hashAliases = generateHashTypeAliases(hashes);\n\n  const codecTypes = generateCodecTypeIntersection(codecTypeImports, 'CodecTypes');\n  const operationTypes = generateCodecTypeIntersection(operationTypeImports, 'OperationTypes');\n\n  const familyTypeAliases = emitter.getFamilyTypeAliases(options);\n\n  const typeMapsExpr = emitter.getTypeMapsExpression();\n\n  const storageType = emitter.generateStorageType(contract, 'StorageHash');\n\n  const modelsType = generateModelsType(\n    contract.models as Record<string, ContractModel>,\n    (name, model) => emitter.generateModelStorageType(name, model),\n  );\n\n  const rootsType = generateRootsType(contract.roots);\n\n  const valueObjects = contract.valueObjects as Record<string, ContractValueObject> | undefined;\n  const valueObjectTypeAliases = generateValueObjectTypeAliases(valueObjects, codecLookup);\n  const valueObjectsDescriptor = generateValueObjectsDescriptorType(valueObjects);\n\n  const executionClause =\n    contract.execution !== undefined\n      ? `\\n  readonly execution: ${serializeExecutionType(contract.execution)};`\n      : '';\n\n  const fieldTypesMaps = generateBothFieldTypesMaps(\n    contract.models as Record<string, ContractModel> | undefined,\n    codecLookup,\n  );\n\n  const contractWrapper = emitter.getContractWrapper('ContractBase', 'TypeMaps');\n\n  return `// ⚠️  GENERATED FILE - DO NOT EDIT\n// This file is automatically generated by 'prisma-next contract emit'.\n// To regenerate, run: prisma-next contract emit\n${importLines.join('\\n')}\n\n${familyImportLines.join('\\n')}\nimport type {\n  Contract as ContractType,\n  ExecutionHashBase,\n  ProfileHashBase,\n  StorageHashBase,\n} from '@prisma-next/contract/types';\n\n${hashAliases}\n\nexport type CodecTypes = ${codecTypes};\nexport type OperationTypes = ${operationTypes};\n${familyTypeAliases}\n${valueObjectTypeAliases}\nexport type FieldOutputTypes = ${fieldTypesMaps.output};\nexport type FieldInputTypes = ${fieldTypesMaps.input};\nexport type TypeMaps = ${typeMapsExpr};\n\ntype ContractBase = ContractType<\n${storageType},\n${modelsType}\n> & {\n  readonly target: ${serializeValue(contract.target)};\n  readonly targetFamily: ${serializeValue(contract.targetFamily)};\n  readonly roots: ${rootsType};\n  readonly capabilities: ${serializeValue(contract.capabilities)};\n  readonly extensionPacks: ${serializeValue(contract.extensionPacks)};${executionClause}\n  readonly meta: ${serializeValue(contract.meta)};\n  ${valueObjects ? `readonly valueObjects: ${valueObjectsDescriptor};` : ''}\n  readonly profileHash: ProfileHash;\n};\n\n${contractWrapper}\n`;\n}\n","import { canonicalizeContractToObject } from '@prisma-next/contract/hashing';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { EmissionSpi } from '@prisma-next/framework-components/emission';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { format } from 'prettier';\nimport type { EmitResult, EmitStackInput } from './emit-types';\nimport { generateContractDts } from './generate-contract-dts';\n\nconst SCHEMA_VERSION = '1';\n\nexport async function emit(\n  contract: Contract,\n  stack: EmitStackInput,\n  targetFamily: EmissionSpi,\n): Promise<EmitResult> {\n  const { codecTypeImports, operationTypeImports, queryOperationTypeImports } = stack;\n\n  const { storageHash } = contract.storage;\n  const executionHash = contract.execution?.executionHash;\n  const { profileHash } = contract;\n\n  const canonicalized = canonicalizeContractToObject(contract, {\n    schemaVersion: SCHEMA_VERSION,\n  });\n  const contractJsonString = JSON.stringify(\n    {\n      ...canonicalized,\n      _generated: {\n        warning: '⚠️  GENERATED FILE - DO NOT EDIT',\n        message: 'This file is automatically generated by \"prisma-next contract emit\".',\n        regenerate: 'To regenerate, run: prisma-next contract emit',\n      },\n    },\n    null,\n    2,\n  );\n\n  const generateOptions = queryOperationTypeImports ? { queryOperationTypeImports } : undefined;\n\n  const contractTypeHashes = {\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n  const contractDtsRaw = generateContractDts(\n    contract,\n    targetFamily,\n    codecTypeImports ?? [],\n    operationTypeImports ?? [],\n    contractTypeHashes,\n    generateOptions,\n    stack.codecLookup,\n  );\n  const contractDts = await format(contractDtsRaw, {\n    parser: 'typescript',\n    singleQuote: true,\n    semi: true,\n    printWidth: 100,\n  });\n\n  return {\n    contractJson: contractJsonString,\n    contractDts,\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n}\n"],"mappings":";;;;;;AAqBA,SAAgB,oBACd,UACA,SACA,kBACA,sBACA,QAKA,SACA,aACQ;CACR,MAAMA,aAAgC,CAAC,GAAG,kBAAkB,GAAG,qBAAqB;AACpF,KAAI,SAAS,0BACX,YAAW,KAAK,GAAG,QAAQ,0BAA0B;CAGvD,MAAM,cAAc,oBADE,mBAAmB,WAAW,CACE;CAEtD,MAAM,oBAAoB,QAAQ,kBAAkB;CAEpD,MAAM,cAAc,wBAAwB,OAAO;CAEnD,MAAM,aAAa,8BAA8B,kBAAkB,aAAa;CAChF,MAAM,iBAAiB,8BAA8B,sBAAsB,iBAAiB;CAE5F,MAAM,oBAAoB,QAAQ,qBAAqB,QAAQ;CAE/D,MAAM,eAAe,QAAQ,uBAAuB;CAEpD,MAAM,cAAc,QAAQ,oBAAoB,UAAU,cAAc;CAExE,MAAM,aAAa,mBACjB,SAAS,SACR,MAAM,UAAU,QAAQ,yBAAyB,MAAM,MAAM,CAC/D;CAED,MAAM,YAAY,kBAAkB,SAAS,MAAM;CAEnD,MAAM,eAAe,SAAS;CAC9B,MAAM,yBAAyB,+BAA+B,cAAc,YAAY;CACxF,MAAM,yBAAyB,mCAAmC,aAAa;CAE/E,MAAM,kBACJ,SAAS,cAAc,SACnB,2BAA2B,uBAAuB,SAAS,UAAU,CAAC,KACtE;CAEN,MAAM,iBAAiB,2BACrB,SAAS,QACT,YACD;CAED,MAAM,kBAAkB,QAAQ,mBAAmB,gBAAgB,WAAW;AAE9E,QAAO;;;EAGP,YAAY,KAAK,KAAK,CAAC;;EAEvB,kBAAkB,KAAK,KAAK,CAAC;;;;;;;;EAQ7B,YAAY;;2BAEa,WAAW;+BACP,eAAe;EAC5C,kBAAkB;EAClB,uBAAuB;iCACQ,eAAe,OAAO;gCACvB,eAAe,MAAM;yBAC5B,aAAa;;;EAGpC,YAAY;EACZ,WAAW;;qBAEQ,eAAe,SAAS,OAAO,CAAC;2BAC1B,eAAe,SAAS,aAAa,CAAC;oBAC7C,UAAU;2BACH,eAAe,SAAS,aAAa,CAAC;6BACpC,eAAe,SAAS,eAAe,CAAC,GAAG,gBAAgB;mBACrE,eAAe,SAAS,KAAK,CAAC;IAC7C,eAAe,0BAA0B,uBAAuB,KAAK,GAAG;;;;EAI1E,gBAAgB;;;;;;AC1GlB,MAAM,iBAAiB;AAEvB,eAAsB,KACpB,UACA,OACA,cACqB;CACrB,MAAM,EAAE,kBAAkB,sBAAsB,8BAA8B;CAE9E,MAAM,EAAE,gBAAgB,SAAS;CACjC,MAAM,gBAAgB,SAAS,WAAW;CAC1C,MAAM,EAAE,gBAAgB;CAExB,MAAM,gBAAgB,6BAA6B,UAAU,EAC3D,eAAe,gBAChB,CAAC;CACF,MAAM,qBAAqB,KAAK,UAC9B;EACE,GAAG;EACH,YAAY;GACV,SAAS;GACT,SAAS;GACT,YAAY;GACb;EACF,EACD,MACA,EACD;CAED,MAAM,kBAAkB,4BAA4B,EAAE,2BAA2B,GAAG;CAEpF,MAAM,qBAAqB;EACzB;EACA,GAAG,UAAU,iBAAiB,cAAc;EAC5C;EACD;AAiBD,QAAO;EACL,cAAc;EACd,aATkB,MAAM,OATH,oBACrB,UACA,cACA,oBAAoB,EAAE,EACtB,wBAAwB,EAAE,EAC1B,oBACA,iBACA,MAAM,YACP,EACgD;GAC/C,QAAQ;GACR,aAAa;GACb,MAAM;GACN,YAAY;GACb,CAAC;EAKA;EACA,GAAG,UAAU,iBAAiB,cAAc;EAC5C;EACD"}
+{"version":3,"file":"index.mjs","names":["allImports: TypesImportSpec[]"],"sources":["../../src/artifact-paths.ts","../../src/generate-contract-dts.ts","../../src/emit.ts"],"sourcesContent":["const JSON_EXTENSION = '.json';\n\nexport interface EmittedArtifactPaths {\n  readonly jsonPath: string;\n  readonly dtsPath: string;\n}\n\nexport function getEmittedArtifactPaths(outputJsonPath: string): EmittedArtifactPaths {\n  if (!outputJsonPath.endsWith(JSON_EXTENSION)) {\n    throw new Error('Contract output path must end with .json');\n  }\n\n  return {\n    jsonPath: outputJsonPath,\n    dtsPath: `${outputJsonPath.slice(0, -JSON_EXTENSION.length)}.d.ts`,\n  };\n}\n","import type { Contract, ContractModel, ContractValueObject } from '@prisma-next/contract/types';\nimport type { CodecLookup } from '@prisma-next/framework-components/codec';\nimport type {\n  EmissionSpi,\n  GenerateContractTypesOptions,\n  TypesImportSpec,\n} from '@prisma-next/framework-components/emission';\nimport {\n  deduplicateImports,\n  generateBothFieldTypesMaps,\n  generateCodecTypeIntersection,\n  generateHashTypeAliases,\n  generateImportLines,\n  generateModelsType,\n  generateRootsType,\n  generateValueObjectsDescriptorType,\n  generateValueObjectTypeAliases,\n  serializeExecutionType,\n  serializeValue,\n} from './domain-type-generation';\n\nexport function generateContractDts(\n  contract: Contract,\n  emitter: EmissionSpi,\n  codecTypeImports: ReadonlyArray<TypesImportSpec>,\n  operationTypeImports: ReadonlyArray<TypesImportSpec>,\n  hashes: {\n    readonly storageHash: string;\n    readonly executionHash?: string;\n    readonly profileHash: string;\n  },\n  options?: GenerateContractTypesOptions,\n  codecLookup?: CodecLookup,\n): string {\n  const allImports: TypesImportSpec[] = [...codecTypeImports, ...operationTypeImports];\n  if (options?.queryOperationTypeImports) {\n    allImports.push(...options.queryOperationTypeImports);\n  }\n  const uniqueImports = deduplicateImports(allImports);\n  const importLines = generateImportLines(uniqueImports);\n\n  const familyImportLines = emitter.getFamilyImports();\n\n  const hashAliases = generateHashTypeAliases(hashes);\n\n  const codecTypes = generateCodecTypeIntersection(codecTypeImports, 'CodecTypes');\n  const operationTypes = generateCodecTypeIntersection(operationTypeImports, 'OperationTypes');\n\n  const familyTypeAliases = emitter.getFamilyTypeAliases(options);\n\n  const typeMapsExpr = emitter.getTypeMapsExpression();\n\n  const storageType = emitter.generateStorageType(contract, 'StorageHash');\n\n  const modelsType = generateModelsType(\n    contract.models as Record<string, ContractModel>,\n    (name, model) => emitter.generateModelStorageType(name, model),\n  );\n\n  const rootsType = generateRootsType(contract.roots);\n\n  const valueObjects = contract.valueObjects as Record<string, ContractValueObject> | undefined;\n  const valueObjectTypeAliases = generateValueObjectTypeAliases(valueObjects, codecLookup);\n  const valueObjectsDescriptor = generateValueObjectsDescriptorType(valueObjects);\n\n  const executionClause =\n    contract.execution !== undefined\n      ? `\\n  readonly execution: ${serializeExecutionType(contract.execution)};`\n      : '';\n\n  const fieldTypesMaps = generateBothFieldTypesMaps(\n    contract.models as Record<string, ContractModel> | undefined,\n    codecLookup,\n  );\n\n  const contractWrapper = emitter.getContractWrapper('ContractBase', 'TypeMaps');\n\n  return `// ⚠️  GENERATED FILE - DO NOT EDIT\n// This file is automatically generated by 'prisma-next contract emit'.\n// To regenerate, run: prisma-next contract emit\n${importLines.join('\\n')}\n\n${familyImportLines.join('\\n')}\nimport type {\n  Contract as ContractType,\n  ExecutionHashBase,\n  ProfileHashBase,\n  StorageHashBase,\n} from '@prisma-next/contract/types';\n\n${hashAliases}\n\nexport type CodecTypes = ${codecTypes};\nexport type OperationTypes = ${operationTypes};\n${familyTypeAliases}\n${valueObjectTypeAliases}\nexport type FieldOutputTypes = ${fieldTypesMaps.output};\nexport type FieldInputTypes = ${fieldTypesMaps.input};\nexport type TypeMaps = ${typeMapsExpr};\n\ntype ContractBase = ContractType<\n${storageType},\n${modelsType}\n> & {\n  readonly target: ${serializeValue(contract.target)};\n  readonly targetFamily: ${serializeValue(contract.targetFamily)};\n  readonly roots: ${rootsType};\n  readonly capabilities: ${serializeValue(contract.capabilities)};\n  readonly extensionPacks: ${serializeValue(contract.extensionPacks)};${executionClause}\n  readonly meta: ${serializeValue(contract.meta)};\n  ${valueObjects ? `readonly valueObjects: ${valueObjectsDescriptor};` : ''}\n  readonly profileHash: ProfileHash;\n};\n\n${contractWrapper}\n`;\n}\n","import { canonicalizeContractToObject } from '@prisma-next/contract/hashing';\nimport type { Contract } from '@prisma-next/contract/types';\nimport type { EmissionSpi } from '@prisma-next/framework-components/emission';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { format } from 'prettier';\nimport { getEmittedArtifactPaths } from './artifact-paths';\nimport type { EmitOptions, EmitResult, EmitStackInput } from './emit-types';\nimport { generateContractDts } from './generate-contract-dts';\n\nconst SCHEMA_VERSION = '1';\n\nexport async function emit(\n  contract: Contract,\n  stack: EmitStackInput,\n  targetFamily: EmissionSpi,\n  options?: EmitOptions,\n): Promise<EmitResult> {\n  if (options?.outputJsonPath !== undefined) {\n    getEmittedArtifactPaths(options.outputJsonPath);\n  }\n\n  const { codecTypeImports, operationTypeImports, queryOperationTypeImports } = stack;\n\n  const { storageHash } = contract.storage;\n  const executionHash = contract.execution?.executionHash;\n  const { profileHash } = contract;\n\n  const canonicalized = canonicalizeContractToObject(contract, {\n    schemaVersion: SCHEMA_VERSION,\n  });\n  const contractJsonString = JSON.stringify(\n    {\n      ...canonicalized,\n      _generated: {\n        warning: '⚠️  GENERATED FILE - DO NOT EDIT',\n        message: 'This file is automatically generated by \"prisma-next contract emit\".',\n        regenerate: 'To regenerate, run: prisma-next contract emit',\n      },\n    },\n    null,\n    2,\n  );\n\n  const generateOptions = queryOperationTypeImports ? { queryOperationTypeImports } : undefined;\n\n  const contractTypeHashes = {\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n  const contractDtsRaw = generateContractDts(\n    contract,\n    targetFamily,\n    codecTypeImports ?? [],\n    operationTypeImports ?? [],\n    contractTypeHashes,\n    generateOptions,\n    stack.codecLookup,\n  );\n  const contractDts = await format(contractDtsRaw, {\n    parser: 'typescript',\n    singleQuote: true,\n    semi: true,\n    printWidth: 100,\n  });\n\n  return {\n    contractJson: contractJsonString,\n    contractDts,\n    storageHash,\n    ...ifDefined('executionHash', executionHash),\n    profileHash,\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/emitter",
-  "version": "0.4.0-dev.9",
+  "version": "0.4.1",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -11,18 +11,18 @@
   "dependencies": {
     "arktype": "^2.0.0",
     "prettier": "^3.3.3",
-    "@prisma-next/operations": "0.4.0-dev.9",
-    "@prisma-next/utils": "0.4.0-dev.9",
-    "@prisma-next/framework-components": "0.4.0-dev.9",
-    "@prisma-next/contract": "0.4.0-dev.9"
+    "@prisma-next/contract": "0.4.1",
+    "@prisma-next/framework-components": "0.4.1",
+    "@prisma-next/operations": "0.4.1",
+    "@prisma-next/utils": "0.4.1"
   },
   "devDependencies": {
     "@types/node": "24.10.4",
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
-    "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsdown": "0.0.0"
   },
   "exports": {

package/src/artifact-paths.ts

@@ -0,0 +1,17 @@
+const JSON_EXTENSION = '.json';
+
+export interface EmittedArtifactPaths {
+  readonly jsonPath: string;
+  readonly dtsPath: string;
+}
+
+export function getEmittedArtifactPaths(outputJsonPath: string): EmittedArtifactPaths {
+  if (!outputJsonPath.endsWith(JSON_EXTENSION)) {
+    throw new Error('Contract output path must end with .json');
+  }
+
+  return {
+    jsonPath: outputJsonPath,
+    dtsPath: `${outputJsonPath.slice(0, -JSON_EXTENSION.length)}.d.ts`,
+  };
+}

package/src/emit-types.ts

@@ -14,6 +14,10 @@ export interface EmitStackInput {
   readonly codecLookup?: CodecLookup;
 }
 
+export interface EmitOptions {
+  readonly outputJsonPath?: string;
+}
+
 export interface EmitResult {
   readonly contractJson: string;
   readonly contractDts: string;

package/src/emit.ts

@@ -3,7 +3,8 @@ 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 { getEmittedArtifactPaths } from './artifact-paths';
+import type { EmitOptions, EmitResult, EmitStackInput } from './emit-types';
 import { generateContractDts } from './generate-contract-dts';
 
 const SCHEMA_VERSION = '1';
@@ -12,7 +13,12 @@ export async function emit(
   contract: Contract,
   stack: EmitStackInput,
   targetFamily: EmissionSpi,
+  options?: EmitOptions,
 ): Promise<EmitResult> {
+  if (options?.outputJsonPath !== undefined) {
+    getEmittedArtifactPaths(options.outputJsonPath);
+  }
+
   const { codecTypeImports, operationTypeImports, queryOperationTypeImports } = stack;
 
   const { storageHash } = contract.storage;

package/src/exports/index.ts

@@ -1,3 +1,5 @@
+export type { EmittedArtifactPaths } from '../artifact-paths';
+export { getEmittedArtifactPaths } from '../artifact-paths';
 export {
   deduplicateImports,
   generateCodecTypeIntersection,

package/test/emitter.test.ts

@@ -2,13 +2,44 @@ import type { TypesImportSpec } from '@prisma-next/framework-components/emission
 import { timeouts } from '@prisma-next/test-utils';
 import { describe, expect, it } from 'vitest';
 import type { EmitStackInput } from '../src/exports';
-import { emit } from '../src/exports';
+import { emit, getEmittedArtifactPaths } from '../src/exports';
 import { createMockSpi } from './mock-spi';
 import { createTestContract } from './utils';
 
 const mockSqlHook = createMockSpi();
 
 describe('emitter', () => {
+  it('derives colocated artifact paths from contract.json output', () => {
+    expect(getEmittedArtifactPaths('/abs/contract.json')).toEqual({
+      jsonPath: '/abs/contract.json',
+      dtsPath: '/abs/contract.d.ts',
+    });
+  });
+
+  it('rejects non-json output paths when deriving artifact paths', () => {
+    expect(() => getEmittedArtifactPaths('/abs/contract.ts')).toThrow(
+      'Contract output path must end with .json',
+    );
+  });
+
+  it(
+    'rejects non-json output paths when emit receives an output path',
+    async () => {
+      const ir = createTestContract();
+      const options: EmitStackInput = {
+        codecTypeImports: [],
+        operationTypeImports: [],
+      };
+
+      await expect(
+        emit(ir, options, mockSqlHook, {
+          outputJsonPath: '/abs/contract.ts',
+        }),
+      ).rejects.toThrow('Contract output path must end with .json');
+    },
+    timeouts.typeScriptCompilation,
+  );
+
   it(
     'emits contract.json and contract.d.ts',
     async () => {
@@ -182,23 +213,27 @@ describe('emitter', () => {
     expect(result.contractDts).toBeDefined();
   });
 
-  it('omits sources from emitted contract artifact', async () => {
-    const ir = createTestContract({
-      sources: {
-        schema: { sourceId: 'schema.prisma' },
-      },
-    });
+  it(
+    'omits sources from emitted contract artifact',
+    async () => {
+      const ir = createTestContract({
+        sources: {
+          schema: { sourceId: 'schema.prisma' },
+        },
+      });
 
-    const options: EmitStackInput = {
-      codecTypeImports: [],
-      operationTypeImports: [],
-      extensionIds: [],
-    };
+      const options: EmitStackInput = {
+        codecTypeImports: [],
+        operationTypeImports: [],
+        extensionIds: [],
+      };
 
-    const result = await emit(ir, options, mockSqlHook);
-    const contractJson = JSON.parse(result.contractJson) as Record<string, unknown>;
-    expect(contractJson).not.toHaveProperty('sources');
-  });
+      const result = await emit(ir, options, mockSqlHook);
+      const contractJson = JSON.parse(result.contractJson) as Record<string, unknown>;
+      expect(contractJson).not.toHaveProperty('sources');
+    },
+    timeouts.typeScriptCompilation,
+  );
 
   it('accepts meta keys when family validation allows them', async () => {
     const ir = createTestContract({