@prisma-next/emitter 0.1.0-dev.3 → 0.1.0-dev.30

package/README.md

@@ -21,7 +21,7 @@ Provide a deterministic, verifiable representation of the application's data con
 - **Validate**: Core structure validation plus family-specific type and structure validation via hooks
 - **Canonicalize**: Compute `coreHash` (schema meaning) and `profileHash` (capabilities/pins) from canonical JSON
 - **Emit**: Generate `contract.json` and `contract.d.ts` with family-specific type generation
-- **Manifest-Agnostic**: The emitter is completely manifest-agnostic. It receives pre-assembled `OperationRegistry`, `codecTypeImports`, `operationTypeImports`, and `extensionIds` from the CLI, not extension packs. Manifest parsing and assembly happens in family instances (e.g., `createSqlFamilyInstance` in `@prisma-next/family-sql`).
+- **Descriptor-Agnostic**: The emitter is completely agnostic to how descriptors are produced. It receives pre-assembled `OperationRegistry`, `codecTypeImports`, `operationTypeImports`, and `extensionIds` from the CLI or family helpers—no pack manifest parsing happens inside the emitter.
 
 **Note**: The emitter does NOT normalize contracts. Normalization must happen in the contract builder when the contract is created. The emitter assumes contracts are already normalized (all required fields present, including `schemaVersion`, `models`, `relations`, `storage`, `extensions`, `capabilities`, `meta`, and `sources`). All fields can be empty objects/arrays, but they must be present.
 
@@ -98,7 +98,7 @@ flowchart TD
 - Excludes `_generated` metadata field from canonicalization to ensure determinism
 - Sorts object keys, omits default values, and orders top-level fields consistently
 
-**Note**: Extension pack loading and manifest parsing are CLI-only responsibilities. The emitter does not export pack loading functions. Import `loadExtensionPacks` from `@prisma-next/cli` or use the CLI's `pack-loading.ts` module directly. Manifest types (`ExtensionPack`, `ExtensionPackManifest`, `OperationManifest`) are defined in `@prisma-next/control-plane/pack-manifest-types`.
+**Note**: Extension pack descriptor wiring happens in the CLI/family layer. The emitter only sees the resulting registry/type import arrays and extension IDs. Operation manifest types (`OperationManifest`) live in `@prisma-next/contract/types`.
 
 **Note**: `TargetFamilyHook`, `ValidationContext`, and `TypesImportSpec` types are defined in `@prisma-next/contract/types` (shared plane) to allow both migration-plane (emitter) and shared-plane (control-plane) packages to import them without violating dependency rules. These types are re-exported from this package for backward compatibility.
 
@@ -112,7 +112,7 @@ This package is part of the **framework domain**, **tooling layer**, **migration
 - **Domain**: framework (target-agnostic)
 - **Layer**: tooling
 - **Plane**: migration
-- **Path**: `packages/framework/tooling/emitter`
+- **Path**: `packages/1-framework/3-tooling/emitter`
 
 ## Related Subsystems
 
@@ -187,5 +187,4 @@ This ensures all required fields are present with sensible defaults. See `.curso
 ## Exports
 
 - `.`: Main emitter API (`emit`, types)
-- **Note**: Pack loading functions (`loadExtensionPacks`, `loadExtensionPackManifest`) are CLI-only and not exported from the emitter. Import them from `@prisma-next/cli` or use the CLI's `pack-loading.ts` module directly.
 

package/dist/test/utils.d.ts

@@ -0,0 +1,16 @@
+import { ContractIR } from '@prisma-next/contract/ir';
+
+/**
+ * Factory function for creating ContractIR objects in tests.
+ * Provides sensible defaults and allows overriding specific fields.
+ * Uses the emitter factories internally for consistency.
+ *
+ * If a field is explicitly set to `undefined` in overrides, it will be omitted
+ * from the result (useful for testing validation of missing fields).
+ */
+declare function createContractIR(overrides?: Partial<ContractIR> & {
+    coreHash?: string;
+    profileHash?: string;
+}): ContractIR;
+
+export { createContractIR };

package/dist/test/utils.js

@@ -0,0 +1,78 @@
+// test/utils.ts
+import { irHeader, irMeta } from "@prisma-next/contract/ir";
+function createContractIR(overrides = {}) {
+  const hasTarget = "target" in overrides;
+  const hasTargetFamily = "targetFamily" in overrides;
+  const hasCoreHash = "coreHash" in overrides;
+  const hasSchemaVersion = "schemaVersion" in overrides;
+  const hasModels = "models" in overrides;
+  const hasRelations = "relations" in overrides;
+  const hasStorage = "storage" in overrides;
+  const hasCapabilities = "capabilities" in overrides;
+  const hasExtensionPacks = "extensionPacks" in overrides;
+  const hasMeta = "meta" in overrides;
+  const hasSources = "sources" in overrides;
+  const headerOpts = {};
+  if (hasTarget && overrides.target !== void 0) {
+    headerOpts.target = overrides.target;
+  } else if (!hasTarget) {
+    headerOpts.target = "postgres";
+  }
+  if (hasTargetFamily && overrides.targetFamily !== void 0) {
+    headerOpts.targetFamily = overrides.targetFamily;
+  } else if (!hasTargetFamily) {
+    headerOpts.targetFamily = "sql";
+  }
+  if (hasCoreHash && overrides.coreHash !== void 0) {
+    headerOpts.coreHash = overrides.coreHash;
+  } else if (!hasCoreHash) {
+    headerOpts.coreHash = "sha256:test";
+  }
+  if (overrides.profileHash !== void 0) {
+    headerOpts.profileHash = overrides.profileHash;
+  }
+  const header = irHeader(
+    headerOpts
+  );
+  const metaOpts = {};
+  if (hasCapabilities && overrides.capabilities !== void 0) {
+    metaOpts.capabilities = overrides.capabilities;
+  } else if (!hasCapabilities) {
+    metaOpts.capabilities = {};
+  }
+  if (hasExtensionPacks && overrides.extensionPacks !== void 0) {
+    metaOpts.extensionPacks = overrides.extensionPacks;
+  } else if (!hasExtensionPacks) {
+    metaOpts.extensionPacks = {};
+  }
+  if (hasMeta && overrides.meta !== void 0) {
+    metaOpts.meta = overrides.meta;
+  } else if (!hasMeta) {
+    metaOpts.meta = {};
+  }
+  if (hasSources && overrides.sources !== void 0) {
+    metaOpts.sources = overrides.sources;
+  } else if (!hasSources) {
+    metaOpts.sources = {};
+  }
+  const meta = irMeta(Object.keys(metaOpts).length > 0 ? metaOpts : void 0);
+  const result = {
+    schemaVersion: hasSchemaVersion && overrides.schemaVersion !== void 0 ? overrides.schemaVersion : hasSchemaVersion && overrides.schemaVersion === void 0 ? void 0 : header.schemaVersion,
+    target: header.target,
+    targetFamily: header.targetFamily,
+    // Only include meta fields if they're not explicitly undefined
+    capabilities: hasCapabilities && overrides.capabilities === void 0 ? void 0 : !hasCapabilities || overrides.capabilities !== void 0 ? meta.capabilities : {},
+    extensionPacks: hasExtensionPacks && overrides.extensionPacks === void 0 ? void 0 : !hasExtensionPacks || overrides.extensionPacks !== void 0 ? meta.extensionPacks : {},
+    meta: hasMeta && overrides.meta === void 0 ? void 0 : !hasMeta || overrides.meta !== void 0 ? meta.meta : {},
+    sources: hasSources && overrides.sources === void 0 ? void 0 : !hasSources || overrides.sources !== void 0 ? meta.sources : {},
+    // Only include family sections if they're not explicitly undefined
+    storage: hasStorage && overrides.storage === void 0 ? void 0 : hasStorage && overrides.storage !== void 0 ? overrides.storage : !hasStorage ? { tables: {} } : {},
+    models: hasModels && overrides.models === void 0 ? void 0 : hasModels && overrides.models !== void 0 ? overrides.models : !hasModels ? {} : {},
+    relations: hasRelations && overrides.relations === void 0 ? void 0 : hasRelations && overrides.relations !== void 0 ? overrides.relations : !hasRelations ? {} : {}
+  };
+  return result;
+}
+export {
+  createContractIR
+};
+//# sourceMappingURL=utils.js.map

package/dist/test/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../test/utils.ts"],"sourcesContent":["import { type ContractIR, irHeader, irMeta } from '@prisma-next/contract/ir';\n\n/**\n * Factory function for creating ContractIR objects in tests.\n * Provides sensible defaults and allows overriding specific fields.\n * Uses the emitter factories internally for consistency.\n *\n * If a field is explicitly set to `undefined` in overrides, it will be omitted\n * from the result (useful for testing validation of missing fields).\n */\nexport function createContractIR(\n  overrides: Partial<ContractIR> & { coreHash?: string; profileHash?: string } = {},\n): ContractIR {\n  // Check if fields are explicitly undefined (not just missing)\n  const hasTarget = 'target' in overrides;\n  const hasTargetFamily = 'targetFamily' in overrides;\n  const hasCoreHash = 'coreHash' in overrides;\n  const hasSchemaVersion = 'schemaVersion' in overrides;\n  const hasModels = 'models' in overrides;\n  const hasRelations = 'relations' in overrides;\n  const hasStorage = 'storage' in overrides;\n  const hasCapabilities = 'capabilities' in overrides;\n  const hasExtensionPacks = 'extensionPacks' in overrides;\n  const hasMeta = 'meta' in overrides;\n  const hasSources = 'sources' in overrides;\n\n  // Build header, omitting fields that are explicitly undefined\n  const headerOpts: {\n    target?: string;\n    targetFamily?: string;\n    coreHash?: string;\n    profileHash?: string;\n  } = {};\n\n  if (hasTarget && overrides.target !== undefined) {\n    headerOpts.target = overrides.target;\n  } else if (!hasTarget) {\n    headerOpts.target = 'postgres';\n  }\n\n  if (hasTargetFamily && overrides.targetFamily !== undefined) {\n    headerOpts.targetFamily = overrides.targetFamily;\n  } else if (!hasTargetFamily) {\n    headerOpts.targetFamily = 'sql';\n  }\n\n  if (hasCoreHash && overrides.coreHash !== undefined) {\n    headerOpts.coreHash = overrides.coreHash;\n  } else if (!hasCoreHash) {\n    headerOpts.coreHash = 'sha256:test';\n  }\n\n  // profileHash is not part of ContractIR, but we can accept it for header creation\n  if (overrides.profileHash !== undefined) {\n    headerOpts.profileHash = overrides.profileHash;\n  }\n\n  const header = irHeader(\n    headerOpts as {\n      target: string;\n      targetFamily: string;\n      coreHash: string;\n      profileHash?: string;\n    },\n  );\n\n  // Build meta, handling explicitly undefined fields\n  // If a field is explicitly undefined, we'll omit it from the result later\n  const metaOpts: {\n    capabilities?: Record<string, Record<string, boolean>>;\n    extensionPacks?: Record<string, unknown>;\n    meta?: Record<string, unknown>;\n    sources?: Record<string, unknown>;\n  } = {};\n\n  if (hasCapabilities && overrides.capabilities !== undefined) {\n    metaOpts.capabilities = overrides.capabilities;\n  } else if (!hasCapabilities) {\n    metaOpts.capabilities = {};\n  }\n\n  if (hasExtensionPacks && overrides.extensionPacks !== undefined) {\n    metaOpts.extensionPacks = overrides.extensionPacks;\n  } else if (!hasExtensionPacks) {\n    metaOpts.extensionPacks = {};\n  }\n\n  if (hasMeta && overrides.meta !== undefined) {\n    metaOpts.meta = overrides.meta;\n  } else if (!hasMeta) {\n    metaOpts.meta = {};\n  }\n\n  if (hasSources && overrides.sources !== undefined) {\n    metaOpts.sources = overrides.sources;\n  } else if (!hasSources) {\n    metaOpts.sources = {};\n  }\n\n  const meta = irMeta(Object.keys(metaOpts).length > 0 ? metaOpts : undefined);\n\n  // Build result by constructing the object directly (ContractIR doesn't include coreHash/profileHash)\n  // When fields are explicitly undefined, include them as undefined (tests use type assertions to bypass TS)\n  const result = {\n    schemaVersion:\n      hasSchemaVersion && overrides.schemaVersion !== undefined\n        ? overrides.schemaVersion\n        : hasSchemaVersion && overrides.schemaVersion === undefined\n          ? (undefined as unknown as string)\n          : header.schemaVersion,\n    target: header.target,\n    targetFamily: header.targetFamily,\n    // Only include meta fields if they're not explicitly undefined\n    capabilities:\n      hasCapabilities && overrides.capabilities === undefined\n        ? (undefined as unknown as Record<string, Record<string, boolean>>)\n        : !hasCapabilities || overrides.capabilities !== undefined\n          ? meta.capabilities\n          : ({} as Record<string, Record<string, boolean>>),\n    extensionPacks:\n      hasExtensionPacks && overrides.extensionPacks === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : !hasExtensionPacks || overrides.extensionPacks !== undefined\n          ? meta.extensionPacks\n          : ({} as Record<string, unknown>),\n    meta:\n      hasMeta && overrides.meta === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : !hasMeta || overrides.meta !== undefined\n          ? meta.meta\n          : ({} as Record<string, unknown>),\n    sources:\n      hasSources && overrides.sources === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : !hasSources || overrides.sources !== undefined\n          ? meta.sources\n          : ({} as Record<string, unknown>),\n    // Only include family sections if they're not explicitly undefined\n    storage:\n      hasStorage && overrides.storage === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : hasStorage && overrides.storage !== undefined\n          ? (overrides.storage as Record<string, unknown>)\n          : !hasStorage\n            ? ({ tables: {} } as Record<string, unknown>)\n            : ({} as Record<string, unknown>),\n    models:\n      hasModels && overrides.models === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : hasModels && overrides.models !== undefined\n          ? (overrides.models as Record<string, unknown>)\n          : !hasModels\n            ? {}\n            : ({} as Record<string, unknown>),\n    relations:\n      hasRelations && overrides.relations === undefined\n        ? (undefined as unknown as Record<string, unknown>)\n        : hasRelations && overrides.relations !== undefined\n          ? (overrides.relations as Record<string, unknown>)\n          : !hasRelations\n            ? {}\n            : ({} as Record<string, unknown>),\n  } as ContractIR;\n\n  return result;\n}\n"],"mappings":";AAAA,SAA0B,UAAU,cAAc;AAU3C,SAAS,iBACd,YAA+E,CAAC,GACpE;AAEZ,QAAM,YAAY,YAAY;AAC9B,QAAM,kBAAkB,kBAAkB;AAC1C,QAAM,cAAc,cAAc;AAClC,QAAM,mBAAmB,mBAAmB;AAC5C,QAAM,YAAY,YAAY;AAC9B,QAAM,eAAe,eAAe;AACpC,QAAM,aAAa,aAAa;AAChC,QAAM,kBAAkB,kBAAkB;AAC1C,QAAM,oBAAoB,oBAAoB;AAC9C,QAAM,UAAU,UAAU;AAC1B,QAAM,aAAa,aAAa;AAGhC,QAAM,aAKF,CAAC;AAEL,MAAI,aAAa,UAAU,WAAW,QAAW;AAC/C,eAAW,SAAS,UAAU;AAAA,EAChC,WAAW,CAAC,WAAW;AACrB,eAAW,SAAS;AAAA,EACtB;AAEA,MAAI,mBAAmB,UAAU,iBAAiB,QAAW;AAC3D,eAAW,eAAe,UAAU;AAAA,EACtC,WAAW,CAAC,iBAAiB;AAC3B,eAAW,eAAe;AAAA,EAC5B;AAEA,MAAI,eAAe,UAAU,aAAa,QAAW;AACnD,eAAW,WAAW,UAAU;AAAA,EAClC,WAAW,CAAC,aAAa;AACvB,eAAW,WAAW;AAAA,EACxB;AAGA,MAAI,UAAU,gBAAgB,QAAW;AACvC,eAAW,cAAc,UAAU;AAAA,EACrC;AAEA,QAAM,SAAS;AAAA,IACb;AAAA,EAMF;AAIA,QAAM,WAKF,CAAC;AAEL,MAAI,mBAAmB,UAAU,iBAAiB,QAAW;AAC3D,aAAS,eAAe,UAAU;AAAA,EACpC,WAAW,CAAC,iBAAiB;AAC3B,aAAS,eAAe,CAAC;AAAA,EAC3B;AAEA,MAAI,qBAAqB,UAAU,mBAAmB,QAAW;AAC/D,aAAS,iBAAiB,UAAU;AAAA,EACtC,WAAW,CAAC,mBAAmB;AAC7B,aAAS,iBAAiB,CAAC;AAAA,EAC7B;AAEA,MAAI,WAAW,UAAU,SAAS,QAAW;AAC3C,aAAS,OAAO,UAAU;AAAA,EAC5B,WAAW,CAAC,SAAS;AACnB,aAAS,OAAO,CAAC;AAAA,EACnB;AAEA,MAAI,cAAc,UAAU,YAAY,QAAW;AACjD,aAAS,UAAU,UAAU;AAAA,EAC/B,WAAW,CAAC,YAAY;AACtB,aAAS,UAAU,CAAC;AAAA,EACtB;AAEA,QAAM,OAAO,OAAO,OAAO,KAAK,QAAQ,EAAE,SAAS,IAAI,WAAW,MAAS;AAI3E,QAAM,SAAS;AAAA,IACb,eACE,oBAAoB,UAAU,kBAAkB,SAC5C,UAAU,gBACV,oBAAoB,UAAU,kBAAkB,SAC7C,SACD,OAAO;AAAA,IACf,QAAQ,OAAO;AAAA,IACf,cAAc,OAAO;AAAA;AAAA,IAErB,cACE,mBAAmB,UAAU,iBAAiB,SACzC,SACD,CAAC,mBAAmB,UAAU,iBAAiB,SAC7C,KAAK,eACJ,CAAC;AAAA,IACV,gBACE,qBAAqB,UAAU,mBAAmB,SAC7C,SACD,CAAC,qBAAqB,UAAU,mBAAmB,SACjD,KAAK,iBACJ,CAAC;AAAA,IACV,MACE,WAAW,UAAU,SAAS,SACzB,SACD,CAAC,WAAW,UAAU,SAAS,SAC7B,KAAK,OACJ,CAAC;AAAA,IACV,SACE,cAAc,UAAU,YAAY,SAC/B,SACD,CAAC,cAAc,UAAU,YAAY,SACnC,KAAK,UACJ,CAAC;AAAA;AAAA,IAEV,SACE,cAAc,UAAU,YAAY,SAC/B,SACD,cAAc,UAAU,YAAY,SACjC,UAAU,UACX,CAAC,aACE,EAAE,QAAQ,CAAC,EAAE,IACb,CAAC;AAAA,IACZ,QACE,aAAa,UAAU,WAAW,SAC7B,SACD,aAAa,UAAU,WAAW,SAC/B,UAAU,SACX,CAAC,YACC,CAAC,IACA,CAAC;AAAA,IACZ,WACE,gBAAgB,UAAU,cAAc,SACnC,SACD,gBAAgB,UAAU,cAAc,SACrC,UAAU,YACX,CAAC,eACC,CAAC,IACA,CAAC;AAAA,EACd;AAEA,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prisma-next/emitter",
-  "version": "0.1.0-dev.3",
+  "version": "0.1.0-dev.30",
   "type": "module",
   "sideEffects": false,
   "files": [
@@ -8,21 +8,26 @@
   ],
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/contract": "0.1.0-dev.3",
-    "@prisma-next/core-control-plane": "0.1.0-dev.3"
+    "@prisma-next/contract": "0.1.0-dev.30",
+    "@prisma-next/core-control-plane": "0.1.0-dev.30"
   },
   "devDependencies": {
-    "@types/node": "^20.0.0",
+    "@types/node": "24.10.4",
+    "@vitest/coverage-v8": "^4.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.9.3",
-    "vitest": "^2.1.1",
-    "@prisma-next/operations": "0.1.0-dev.3",
+    "vitest": "^4.0.16",
+    "@prisma-next/operations": "0.1.0-dev.30",
     "@prisma-next/test-utils": "0.0.1"
   },
   "exports": {
     ".": {
       "types": "./dist/exports/index.d.ts",
       "import": "./dist/exports/index.js"
+    },
+    "./test/utils": {
+      "types": "./dist/test/utils.d.ts",
+      "import": "./dist/test/utils.js"
     }
   },
   "scripts": {
@@ -31,6 +36,8 @@
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
     "lint": "biome check . --config-path ../../../../biome.json --error-on-warnings",
+    "lint:fix": "biome check --write . --config-path ../../../../biome.json",
+    "lint:fix:unsafe": "biome check --write --unsafe . --config-path ../../../../biome.json",
     "clean": "node ../../../../scripts/clean.mjs"
   }
 }