@forgeax/engine-pack 0.1.4 → 0.1.7

package/dist/build.mjs

@@ -1,5 +1,5 @@
-import { ok, err, catalogOperationsFor, authoringCapabilityForAssetKind, MATERIAL_TEXTURE_SLOTS, projectCookProductEvidence, projectAssetEvidence, validateSourceOverrideMap, catalogEntryDigest, PACK_ERROR_HINTS, AssetError, ImportError } from '@forgeax/engine-types';
-import { join, basename, dirname, resolve, relative, posix, extname } from 'path';
+import { ok, err, catalogOperationsFor, authoringCapabilityForAssetKind, PACK_ERROR_HINTS, MATERIAL_TEXTURE_SLOTS, projectCookProductEvidence, projectAssetEvidence, validateSourceOverrideMap, catalogEntryDigest, AssetError, ImportError } from '@forgeax/engine-types';
+import { join, dirname, resolve, posix, basename, relative, extname } from 'path';
 import { uuidv7obj } from 'uuidv7';
 import { readFileSync, existsSync } from 'fs';
 import { createHash } from 'crypto';
@@ -9547,77 +9547,112 @@ function serializeCookedMaterialRecord(record) {
 function serializeMaterialCookReceipt(receipt) {
   return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));
 }
-function invalid2(field) {
+function invalid2(field, actual2) {
   return err({
     code: "material-cook-record-invalid",
-    expected: "a complete material-cook/2 record with derived layout identity",
+    expected: "a complete material-cook/3 record with layered identity and provenance",
     hint: "re-cook the material and publish its record, artifact, references, and receipt together",
-    detail: { field }
+    detail: {
+      field,
+      ...actual2 === void 0 ? {} : { actual: actual2 },
+      action: "inspect the named field and recook the material generation"
+    }
+  });
+}
+var IDENTITY_FIELDS = [
+  "materialContractDigest",
+  "sourceRevision",
+  "sourceClosureDigest",
+  "layoutIdentity",
+  "programIdentity",
+  "pipelineIdentity",
+  "materialPublicationIdentity",
+  "cookIdentity",
+  "compilerFingerprint",
+  "artifactDigest"
+];
+function isGeneration(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 1;
+}
+function validateIdentity(value) {
+  if (value === null || typeof value !== "object") return invalid2("receipt.identity", value);
+  const candidate = value;
+  for (const field of IDENTITY_FIELDS) {
+    if (typeof candidate[field] !== "string" || candidate[field].length === 0) {
+      return invalid2(`receipt.identity.${field}`, candidate[field]);
+    }
+  }
+  if (candidate.wasm === null || typeof candidate.wasm !== "object") {
+    return invalid2("receipt.identity.wasm", candidate.wasm);
+  }
+  const wasm = candidate.wasm;
+  for (const field of ["sourceContentKey", "artifactSha256", "glueSha256"]) {
+    if (typeof wasm[field] !== "string" || wasm[field].length === 0) {
+      return invalid2(`receipt.identity.wasm.${field}`, wasm[field]);
+    }
+  }
+  for (const field of ["valueGeneration", "dependencyGeneration", "cookGeneration"]) {
+    if (!isGeneration(candidate[field]))
+      return invalid2(`receipt.identity.${field}`, candidate[field]);
+  }
+  return ok({
+    ...candidate,
+    wasm
   });
 }
 function validateMaterialCookReceipt(value, expected = {}) {
   if (value === null || typeof value !== "object") return invalid2("receipt");
   const candidate = value;
-  if (candidate.schemaVersion !== "material-cook/2") return invalid2("receipt.schemaVersion");
-  if (typeof candidate.layoutIdentity !== "string" || candidate.layoutIdentity.length === 0) {
-    return invalid2("receipt.layoutIdentity");
-  }
+  if (candidate.schemaVersion !== "material-cook/3")
+    return invalid2("receipt.schemaVersion", candidate.schemaVersion);
+  const identityResult = validateIdentity(candidate.identity);
+  if (!identityResult.ok) return identityResult;
+  const identity = identityResult.value;
   if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== "object") {
-    return invalid2("receipt.derivedInterface");
+    return invalid2("receipt.derivedInterface", candidate.derivedInterface);
   }
   const derivedInterface = candidate.derivedInterface;
-  if (derivedInterface.layoutIdentity !== candidate.layoutIdentity) {
-    return invalid2("receipt.derivedInterface.layoutIdentity");
-  }
-  for (const field of [
-    "sourceClosure",
-    "profile",
-    "compilerVersion",
-    "inputDigest",
-    "outputDigest"
-  ]) {
+  if (derivedInterface.layoutIdentity !== identity.layoutIdentity) {
+    return invalid2("receipt.derivedInterface.layoutIdentity", derivedInterface.layoutIdentity);
+  }
+  for (const field of ["sourceClosure", "profile", "compilerVersion"]) {
     const fieldValue = candidate[field];
     if (field === "sourceClosure" && !Array.isArray(fieldValue) || field !== "sourceClosure" && typeof fieldValue !== "string") {
-      return invalid2(`receipt.${field}`);
+      return invalid2(`receipt.${field}`, fieldValue);
     }
   }
   const sourceClosure = candidate.sourceClosure;
   if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== "string")) {
-    return invalid2("receipt.sourceClosure");
+    return invalid2("receipt.sourceClosure", sourceClosure);
   }
-  if (expected.layoutIdentity !== void 0 && candidate.layoutIdentity !== expected.layoutIdentity) {
-    return invalid2("receipt.layoutIdentity");
+  if (expected.layoutIdentity !== void 0 && identity.layoutIdentity !== expected.layoutIdentity) {
+    return invalid2("receipt.identity.layoutIdentity", identity.layoutIdentity);
   }
-  if (expected.artifactDigest !== void 0 && candidate.outputDigest !== expected.artifactDigest) {
-    return invalid2("receipt.outputDigest");
+  if (expected.artifactDigest !== void 0 && identity.artifactDigest !== expected.artifactDigest) {
+    return invalid2("receipt.identity.artifactDigest", identity.artifactDigest);
   }
-  if (expected.inputDigest !== void 0 && candidate.inputDigest !== expected.inputDigest) {
-    return invalid2("receipt.inputDigest");
-  }
-  if (candidate.publicationGeneration !== void 0 && (typeof candidate.publicationGeneration !== "number" || !Number.isSafeInteger(candidate.publicationGeneration) || candidate.publicationGeneration < 1)) {
-    return invalid2("receipt.publicationGeneration");
+  if (expected.inputDigest !== void 0 && identity.cookIdentity !== expected.inputDigest) {
+    return invalid2("receipt.identity.cookIdentity", identity.cookIdentity);
   }
   return ok({
-    schemaVersion: "material-cook/2",
+    schemaVersion: "material-cook/3",
     sourceClosure: candidate.sourceClosure,
     profile: candidate.profile,
     compilerVersion: candidate.compilerVersion,
-    inputDigest: candidate.inputDigest,
-    outputDigest: candidate.outputDigest,
-    layoutIdentity: candidate.layoutIdentity,
-    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity },
-    ...candidate.publicationGeneration === void 0 ? {} : { publicationGeneration: candidate.publicationGeneration }
+    identity,
+    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity }
   });
 }
 function validateCookedMaterialRecord(value) {
   if (value === null || typeof value !== "object") return invalid2("record");
   const candidate = value;
-  if (candidate.schemaVersion !== "material-cook/2") return invalid2("schemaVersion");
+  if (candidate.schemaVersion !== "material-cook/3")
+    return invalid2("schemaVersion", candidate.schemaVersion);
   if (typeof candidate.guid !== "string" || !candidate.guid) return invalid2("guid");
   if (candidate.materialGuid !== void 0 && typeof candidate.materialGuid !== "string")
     return invalid2("materialGuid");
-  if (candidate.publicationGeneration !== void 0 && (typeof candidate.publicationGeneration !== "number" || !Number.isSafeInteger(candidate.publicationGeneration) || candidate.publicationGeneration < 1))
-    return invalid2("publicationGeneration");
+  if (candidate.publicationGeneration !== void 0 && !isGeneration(candidate.publicationGeneration))
+    return invalid2("publicationGeneration", candidate.publicationGeneration);
   if (candidate.specializationKey !== void 0 && typeof candidate.specializationKey !== "string")
     return invalid2("specializationKey");
   if (candidate.artifactDigest !== void 0 && typeof candidate.artifactDigest !== "string")
@@ -9649,9 +9684,9 @@ function validateCookedMaterialRecord(value) {
   });
   if (!receiptResult.ok) return receiptResult;
   if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== artifact.digest)
-    return invalid2("artifactDigest");
-  if (candidate.publicationGeneration !== void 0 && receiptResult.value.publicationGeneration !== candidate.publicationGeneration)
-    return invalid2("receipt.publicationGeneration");
+    return invalid2("artifactDigest", candidate.artifactDigest);
+  if (candidate.publicationGeneration !== void 0 && receiptResult.value.identity.cookGeneration !== candidate.publicationGeneration)
+    return invalid2("receipt.identity.cookGeneration", receiptResult.value.identity.cookGeneration);
   const normalized = {
     ...candidate,
     artifact: {
@@ -10163,6 +10198,6 @@ function createRuntimePackPublication(input) {
   };
 }
 
-export { MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, SCRIPTABLE_PACK_ASSET_KINDS, SCRIPTABLE_PACK_CAPABILITY_MANIFEST, STANDARD_SCRIPTABLE_PACK_SCAN_OPTIONS, buildCatalogProjection, buildOfflineAssetEvidence, calculateCatalogDelta, calculateTopologyDiff, catalogProjectionFor, collectMaterialCookRefs, createMaterialArtifactDigest, createRuntimePackPublication, currentProjectionFor, decodeMeshBinHeader, diffTopology, finalizePackageProduct, finalizePackageTransportSource, findReservedAssetKindConflict, isScriptablePackAssetKind, metaPathForGuid, packageTransportRevision, packageVerification, parsePackV2, projectCookedMaterialRecord, projectCookedPackageEntry, projectExternalCatalogEntries, projectPackageCatalog, projectRuntimeCatalogRow, projectScriptablePackMeta, projectScriptablePackSceneComponents, scanInventory, serializeCookedMaterialRecord, serializeMaterialCookReceipt, upgradeLegacyAuthoredPack, validateArtifactPath, validateCookedMaterialRecord, validateMaterialCookReceipt, validateMeta, validatePack, validatePackV2, validateProducerContract, validateProducerOutputs, validateScriptablePackDefinition, writeMeshBinHeader };
+export { MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, SCRIPTABLE_PACK_ASSET_KINDS, SCRIPTABLE_PACK_CAPABILITY_MANIFEST, STANDARD_SCRIPTABLE_PACK_SCAN_OPTIONS, buildCatalogProjection, buildOfflineAssetEvidence, calculateCatalogDelta, calculateTopologyDiff, catalogProjectionFor, collectMaterialCookRefs, createMaterialArtifactDigest, createRuntimePackPublication, currentProjectionFor, decodeMeshBinHeader, diffTopology, finalizePackageProduct, finalizePackageTransportSource, findReservedAssetKindConflict, isScriptablePackAssetKind, loadAssetConfig, metaPathForGuid, packageTransportRevision, packageVerification, parsePackV2, projectCookedMaterialRecord, projectCookedPackageEntry, projectExternalCatalogEntries, projectPackageCatalog, projectRuntimeCatalogRow, projectScriptablePackMeta, projectScriptablePackSceneComponents, resolveAssetSource, scanInventory, serializeCookedMaterialRecord, serializeMaterialCookReceipt, upgradeLegacyAuthoredPack, validateArtifactPath, validateCookedMaterialRecord, validateMaterialCookReceipt, validateMeta, validatePack, validatePackV2, validateProducerContract, validateProducerOutputs, validateScriptablePackDefinition, writeMeshBinHeader };
 //# sourceMappingURL=build.mjs.map
 //# sourceMappingURL=build.mjs.map