@forgeax/engine-pack 0.1.6 → 0.1.19

package/dist/build.mjs

@@ -1,5 +1,5 @@
 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 { join, dirname, resolve, isAbsolute, posix, relative, basename, extname } from 'path';
 import { uuidv7obj } from 'uuidv7';
 import { readFileSync, existsSync } from 'fs';
 import { createHash } from 'crypto';
@@ -8552,7 +8552,7 @@ function buildTimeoutFailure(sourcePath, timeoutMs) {
   };
 }
 async function loadScriptablePack(sourcePath, options = {}) {
-  const timeoutMs = options.timeoutMs ?? 5e3;
+  const timeoutMs = options.timeoutMs ?? 15e3;
   const buildTimeoutMs = options.buildTimeoutMs ?? 5e3;
   const executor = options.executor ?? new WorkerScriptablePackExecutor();
   let disposeReason;
@@ -9047,6 +9047,11 @@ async function scanInventory(roots, opts = {}) {
 function sourcePathFor(cwd, path) {
   return relative(cwd, path).replace(/\\/g, "/");
 }
+function catalogSourcePathFor(cwd, path, sourceIdentityFor) {
+  const projected = sourceIdentityFor?.(path);
+  const catalogPath = projected === void 0 || isAbsolute(projected) ? sourcePathFor(cwd, path) : projected;
+  return catalogPath.replaceAll("\\", "/").replace(/^\.\//, "");
+}
 function metaPathForGuid(declarations, guid) {
   const lower = guid.toLowerCase();
   for (const [path, declaration] of declarations) {
@@ -9065,7 +9070,7 @@ function unsupportedPolicyError(path, importer, policy) {
     subjects: [path]
   };
 }
-function projectMeta(rawPath, cwd, base, assetPaths, importerPolicy, sourceDeclaration) {
+function projectMeta(rawPath, cwd, base, assetPaths, importerPolicy, sourceDeclaration, sourceIdentityFor) {
   const meta = sourceDeclaration.value;
   const policy = importerPolicy(meta.importer);
   if (policy.disposition !== "publish") {
@@ -9082,7 +9087,7 @@ function projectMeta(rawPath, cwd, base, assetPaths, importerPolicy, sourceDecla
       }
     };
   }
-  const sourcePath = sourcePathFor(cwd, resolved.value);
+  const sourcePath = catalogSourcePathFor(cwd, resolved.value, sourceIdentityFor);
   const packageUrl2 = `${base}/__forgeax-ddc/${meta.subAssets[0]?.guid?.toLowerCase() ?? "pack"}.pack.json`;
   const declaration = {
     importer: meta.importer,
@@ -9124,14 +9129,14 @@ function projectMeta(rawPath, cwd, base, assetPaths, importerPolicy, sourceDecla
     )
   };
 }
-function projectSource(path, cwd, base, assetPaths, importerPolicy, visibility, sourceDeclaration, declarations) {
+function projectSource(path, cwd, base, assetPaths, importerPolicy, visibility, sourceDeclaration, declarations, sourceIdentityFor) {
   if (sourceDeclaration.format === "pack.ts") {
     const meta = { ...sourceDeclaration.meta, source: sourcePathFor(cwd, path) };
     const anchorGuid = meta.subAssets.map((asset) => asset.guid.toLowerCase()).sort()[0];
     return anchorGuid === void 0 ? { entries: [] } : {
       entries: projectExternalCatalogEntries(
         meta,
-        sourcePathFor(cwd, path),
+        catalogSourcePathFor(cwd, path, sourceIdentityFor),
         `${base}/__forgeax-ddc/${anchorGuid}.pack.json`,
         meta.subAssets,
         (output) => deriveAssetName(path, meta.subAssets.length, output.name)
@@ -9147,12 +9152,20 @@ function projectSource(path, cwd, base, assetPaths, importerPolicy, visibility,
     }) === false) {
       return { entries: [] };
     }
-    const projected = projectMeta(path, cwd, base, assetPaths, importerPolicy, sourceDeclaration);
+    const projected = projectMeta(
+      path,
+      cwd,
+      base,
+      assetPaths,
+      importerPolicy,
+      sourceDeclaration,
+      sourceIdentityFor
+    );
     if (projected.declaration !== void 0) declarations.set(path, projected.declaration);
     return projected;
   }
   const parsed = sourceDeclaration.value;
-  const sourcePath = sourcePathFor(cwd, path);
+  const sourcePath = catalogSourcePathFor(cwd, path, sourceIdentityFor);
   const provenance = parsed.provenance ?? { provider: "pack", version: parsed.schemaVersion };
   return {
     entries: projectPackageCatalog(
@@ -9218,7 +9231,8 @@ async function buildCatalogProjection(roots, options) {
       options.importerPolicy,
       options.visibility,
       sourceDeclaration,
-      declarations
+      declarations,
+      options.sourceIdentityFor
     );
     entries.push(...projected.entries);
     if (projected.error !== void 0) errors.push(projected.error);
@@ -9547,77 +9561,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");
-  }
-  if (expected.layoutIdentity !== void 0 && candidate.layoutIdentity !== expected.layoutIdentity) {
-    return invalid2("receipt.layoutIdentity");
+    return invalid2("receipt.sourceClosure", sourceClosure);
   }
-  if (expected.artifactDigest !== void 0 && candidate.outputDigest !== expected.artifactDigest) {
-    return invalid2("receipt.outputDigest");
+  if (expected.layoutIdentity !== void 0 && identity.layoutIdentity !== expected.layoutIdentity) {
+    return invalid2("receipt.identity.layoutIdentity", identity.layoutIdentity);
   }
-  if (expected.inputDigest !== void 0 && candidate.inputDigest !== expected.inputDigest) {
-    return invalid2("receipt.inputDigest");
+  if (expected.artifactDigest !== void 0 && identity.artifactDigest !== expected.artifactDigest) {
+    return invalid2("receipt.identity.artifactDigest", identity.artifactDigest);
   }
-  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 +9698,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 +10212,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, 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 };
+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, catalogSourcePathFor, 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