@forgeax/engine-pack 0.1.3 → 0.1.6

package/dist/material-cook.d.ts

@@ -0,0 +1,2 @@
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, type MaterialCookArtifact, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, } from './evidence/material-cook.js';
+//# sourceMappingURL=material-cook.d.ts.map

package/dist/material-cook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-cook.d.ts","sourceRoot":"","sources":["../src/material-cook.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACrB,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC"}

package/dist/material-cook.mjs

@@ -0,0 +1,193 @@
+import { MATERIAL_TEXTURE_SLOTS, ok, err } from '@forgeax/engine-types';
+import { sha256 } from '@noble/hashes/sha2.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
+
+// src/evidence/material-cook.ts
+function unique(values) {
+  return [...new Set(values)].sort();
+}
+function guidText(value) {
+  return typeof value === "string" ? value : Array.from(value, (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function cookGuidText(value) {
+  return typeof value === "number" ? void 0 : guidText(value);
+}
+function textureValues(values, textureFields) {
+  return Object.entries(values ?? {}).flatMap(([name, value]) => {
+    if (value === null) return [];
+    if (typeof value === "string") {
+      return textureFields.has(name) ? [{ texture: value }] : [];
+    }
+    return value !== null && typeof value === "object" && !Array.isArray(value) && "texture" in value ? [value] : [];
+  });
+}
+function collectMaterialCookRefs(material) {
+  const textureFields = material.parameters === void 0 ? new Set(MATERIAL_TEXTURE_SLOTS) : new Set(
+    material.parameters.filter((parameter) => parameter.type === "texture").map((parameter) => parameter.name)
+  );
+  const textures = textureValues(material.values, textureFields);
+  return {
+    parent: material.parent ? [guidText(material.parent)] : [],
+    textures: unique(
+      textures.flatMap((value) => {
+        const guid = cookGuidText(value.texture);
+        return guid === void 0 ? [] : [guid];
+      })
+    ),
+    samplers: unique(
+      textures.flatMap((value) => {
+        if (value.sampler === void 0) return [];
+        const guid = cookGuidText(value.sampler);
+        return guid === void 0 ? [] : [guid];
+      })
+    ),
+    modules: unique((material.passes ?? []).map((pass) => pass.program.module))
+  };
+}
+function createMaterialArtifactDigest(bytes) {
+  return `sha256:${bytesToHex(sha256(bytes))}`;
+}
+function jsonValue(value) {
+  if (value instanceof Uint8Array) return [...value];
+  if (Array.isArray(value)) return value.map(jsonValue);
+  if (value !== null && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).filter(([, entry]) => entry !== void 0).sort(([a], [b]) => a.localeCompare(b)).map(([key, entry]) => [key, jsonValue(entry)])
+    );
+  }
+  return value;
+}
+function serializeCookedMaterialRecord(record) {
+  return JSON.stringify(jsonValue(record));
+}
+function serializeMaterialCookReceipt(receipt) {
+  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));
+}
+function invalid(field) {
+  return err({
+    code: "material-cook-record-invalid",
+    expected: "a complete material-cook/2 record with derived layout identity",
+    hint: "re-cook the material and publish its record, artifact, references, and receipt together",
+    detail: { field }
+  });
+}
+function validateMaterialCookReceipt(value, expected = {}) {
+  if (value === null || typeof value !== "object") return invalid("receipt");
+  const candidate = value;
+  if (candidate.schemaVersion !== "material-cook/2") return invalid("receipt.schemaVersion");
+  if (typeof candidate.layoutIdentity !== "string" || candidate.layoutIdentity.length === 0) {
+    return invalid("receipt.layoutIdentity");
+  }
+  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== "object") {
+    return invalid("receipt.derivedInterface");
+  }
+  const derivedInterface = candidate.derivedInterface;
+  if (derivedInterface.layoutIdentity !== candidate.layoutIdentity) {
+    return invalid("receipt.derivedInterface.layoutIdentity");
+  }
+  for (const field of [
+    "sourceClosure",
+    "profile",
+    "compilerVersion",
+    "inputDigest",
+    "outputDigest"
+  ]) {
+    const fieldValue = candidate[field];
+    if (field === "sourceClosure" && !Array.isArray(fieldValue) || field !== "sourceClosure" && typeof fieldValue !== "string") {
+      return invalid(`receipt.${field}`);
+    }
+  }
+  const sourceClosure = candidate.sourceClosure;
+  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== "string")) {
+    return invalid("receipt.sourceClosure");
+  }
+  if (expected.layoutIdentity !== void 0 && candidate.layoutIdentity !== expected.layoutIdentity) {
+    return invalid("receipt.layoutIdentity");
+  }
+  if (expected.artifactDigest !== void 0 && candidate.outputDigest !== expected.artifactDigest) {
+    return invalid("receipt.outputDigest");
+  }
+  if (expected.inputDigest !== void 0 && candidate.inputDigest !== expected.inputDigest) {
+    return invalid("receipt.inputDigest");
+  }
+  if (candidate.publicationGeneration !== void 0 && (typeof candidate.publicationGeneration !== "number" || !Number.isSafeInteger(candidate.publicationGeneration) || candidate.publicationGeneration < 1)) {
+    return invalid("receipt.publicationGeneration");
+  }
+  return ok({
+    schemaVersion: "material-cook/2",
+    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 }
+  });
+}
+function validateCookedMaterialRecord(value) {
+  if (value === null || typeof value !== "object") return invalid("record");
+  const candidate = value;
+  if (candidate.schemaVersion !== "material-cook/2") return invalid("schemaVersion");
+  if (typeof candidate.guid !== "string" || !candidate.guid) return invalid("guid");
+  if (candidate.materialGuid !== void 0 && typeof candidate.materialGuid !== "string")
+    return invalid("materialGuid");
+  if (candidate.publicationGeneration !== void 0 && (typeof candidate.publicationGeneration !== "number" || !Number.isSafeInteger(candidate.publicationGeneration) || candidate.publicationGeneration < 1))
+    return invalid("publicationGeneration");
+  if (candidate.specializationKey !== void 0 && typeof candidate.specializationKey !== "string")
+    return invalid("specializationKey");
+  if (candidate.artifactDigest !== void 0 && typeof candidate.artifactDigest !== "string")
+    return invalid("artifactDigest");
+  if (candidate.sourceClosure !== void 0 && (!Array.isArray(candidate.sourceClosure) || candidate.sourceClosure.some((path) => typeof path !== "string")))
+    return invalid("sourceClosure");
+  if (candidate.parameterContract !== void 0) {
+    if (candidate.parameterContract === null || typeof candidate.parameterContract !== "object")
+      return invalid("parameterContract");
+    const parameterContract = candidate.parameterContract;
+    if (!Array.isArray(parameterContract.parameters))
+      return invalid("parameterContract.parameters");
+    if (parameterContract.values === null || typeof parameterContract.values !== "object" || Array.isArray(parameterContract.values))
+      return invalid("parameterContract.values");
+  }
+  if (candidate.resolved === null || typeof candidate.resolved !== "object")
+    return invalid("resolved");
+  if (candidate.refs === null || typeof candidate.refs !== "object") return invalid("refs");
+  if (candidate.artifact === null || typeof candidate.artifact !== "object")
+    return invalid("artifact");
+  if (candidate.receipt === null || typeof candidate.receipt !== "object")
+    return invalid("receipt");
+  const artifact = candidate.artifact;
+  if (typeof artifact.digest !== "string" || !Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes)) {
+    return invalid("artifact");
+  }
+  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {
+    artifactDigest: artifact.digest
+  });
+  if (!receiptResult.ok) return receiptResult;
+  if (candidate.artifactDigest !== void 0 && candidate.artifactDigest !== artifact.digest)
+    return invalid("artifactDigest");
+  if (candidate.publicationGeneration !== void 0 && receiptResult.value.publicationGeneration !== candidate.publicationGeneration)
+    return invalid("receipt.publicationGeneration");
+  const normalized = {
+    ...candidate,
+    artifact: {
+      ...artifact,
+      bytes: ArrayBuffer.isView(artifact.bytes) ? Uint8Array.from(artifact.bytes) : Uint8Array.from(artifact.bytes)
+    },
+    receipt: receiptResult.value
+  };
+  return ok(normalized);
+}
+function projectCookedMaterialRecord(record) {
+  return {
+    resolved: record.resolved,
+    refs: record.refs,
+    artifact: record.artifact,
+    receipt: record.receipt,
+    schemaVersion: record.schemaVersion
+  };
+}
+
+export { collectMaterialCookRefs, createMaterialArtifactDigest, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord };
+//# sourceMappingURL=material-cook.mjs.map
+//# sourceMappingURL=material-cook.mjs.map

package/dist/material-cook.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evidence/material-cook.ts"],"names":[],"mappings":"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","file":"material-cook.mjs","sourcesContent":["import type {\n  MaterialAsset,\n  MaterialParameter,\n  MaterialPass,\n  MaterialTextureReference,\n  MaterialTextureValue,\n  MaterialValue,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, MATERIAL_TEXTURE_SLOTS, ok } from '@forgeax/engine-types';\nimport { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex } from '@noble/hashes/utils.js';\n\nexport interface MaterialCookRefs {\n  readonly parent: readonly string[];\n  readonly textures: readonly string[];\n  readonly samplers: readonly string[];\n  readonly modules: readonly string[];\n}\n\nexport interface MaterialCookArtifact {\n  readonly mediaType: string;\n  readonly path: string;\n  readonly digest: string;\n  readonly bytes: Uint8Array;\n}\n\nexport interface MaterialCookReceipt {\n  readonly schemaVersion: 'material-cook/2';\n  readonly sourceClosure: readonly string[];\n  readonly profile: string;\n  readonly compilerVersion: string;\n  readonly inputDigest: string;\n  readonly outputDigest: string;\n  readonly layoutIdentity: string;\n  readonly derivedInterface: { readonly layoutIdentity: string };\n  readonly publicationGeneration?: number;\n}\n\nexport interface MaterialParameterContract {\n  readonly parameters: readonly MaterialParameter[];\n  readonly values: Readonly<Record<string, MaterialValue | null>>;\n}\n\nexport interface CookedMaterialRecord {\n  readonly schemaVersion: 'material-cook/2';\n  readonly guid: string;\n  readonly authored?: MaterialAsset;\n  readonly materialGuid?: string;\n  readonly publicationGeneration?: number;\n  readonly specializationKey?: string;\n  readonly artifactDigest?: string;\n  readonly sourceClosure?: readonly string[];\n  readonly parameterContract?: MaterialParameterContract;\n  readonly resolved: {\n    readonly passes: readonly MaterialPass[];\n    readonly parameters: readonly MaterialParameter[];\n    readonly values: Readonly<Record<string, MaterialValue | null>>;\n  };\n  readonly refs: MaterialCookRefs;\n  readonly artifact: MaterialCookArtifact;\n  readonly receipt: MaterialCookReceipt;\n}\n\nexport interface MaterialCookRecordError {\n  readonly code: 'material-cook-record-invalid';\n  readonly expected: string;\n  readonly hint: string;\n  readonly detail: { readonly field: string };\n}\n\nexport interface MaterialCookIdentityExpectation {\n  readonly layoutIdentity?: string;\n  readonly artifactDigest?: string;\n  readonly inputDigest?: string;\n}\n\nfunction unique(values: readonly string[]): readonly string[] {\n  return [...new Set(values)].sort();\n}\n\nfunction guidText(value: string | Uint8Array): string {\n  return typeof value === 'string'\n    ? value\n    : Array.from(value, (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\nfunction cookGuidText(value: MaterialTextureReference): string | undefined {\n  return typeof value === 'number' ? undefined : guidText(value);\n}\n\nfunction textureValues(\n  values: Readonly<Record<string, MaterialValue | null>> | undefined,\n  textureFields: ReadonlySet<string>,\n): readonly MaterialTextureValue[] {\n  return Object.entries(values ?? {}).flatMap(([name, value]) => {\n    if (value === null) return [];\n    if (typeof value === 'string') {\n      return textureFields.has(name) ? [{ texture: value }] : [];\n    }\n    return value !== null &&\n      typeof value === 'object' &&\n      !Array.isArray(value) &&\n      'texture' in value\n      ? [value as MaterialTextureValue]\n      : [];\n  });\n}\n\nexport function collectMaterialCookRefs(material: Partial<MaterialAsset>): MaterialCookRefs {\n  const textureFields =\n    material.parameters === undefined\n      ? new Set<string>(MATERIAL_TEXTURE_SLOTS)\n      : new Set(\n          material.parameters\n            .filter((parameter) => parameter.type === 'texture')\n            .map((parameter) => parameter.name),\n        );\n  const textures = textureValues(material.values, textureFields);\n  return {\n    parent: material.parent ? [guidText(material.parent)] : [],\n    textures: unique(\n      textures.flatMap((value) => {\n        const guid = cookGuidText(value.texture);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    samplers: unique(\n      textures.flatMap((value) => {\n        if (value.sampler === undefined) return [];\n        const guid = cookGuidText(value.sampler);\n        return guid === undefined ? [] : [guid];\n      }),\n    ),\n    modules: unique((material.passes ?? []).map((pass) => pass.program.module)),\n  };\n}\n\nexport function createMaterialArtifactDigest(bytes: Uint8Array): string {\n  return `sha256:${bytesToHex(sha256(bytes))}`;\n}\n\nfunction jsonValue(value: unknown): unknown {\n  if (value instanceof Uint8Array) return [...value];\n  if (Array.isArray(value)) return value.map(jsonValue);\n  if (value !== null && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value)\n        .filter(([, entry]) => entry !== undefined)\n        .sort(([a], [b]) => a.localeCompare(b))\n        .map(([key, entry]) => [key, jsonValue(entry)]),\n    );\n  }\n  return value;\n}\n\nexport function serializeCookedMaterialRecord(record: CookedMaterialRecord): string {\n  return JSON.stringify(jsonValue(record));\n}\n\nexport function serializeMaterialCookReceipt(receipt: MaterialCookReceipt): string {\n  return JSON.stringify(jsonValue({ ...receipt, sourceClosure: unique(receipt.sourceClosure) }));\n}\n\nfunction invalid(field: string): Result<never, MaterialCookRecordError> {\n  return err({\n    code: 'material-cook-record-invalid',\n    expected: 'a complete material-cook/2 record with derived layout identity',\n    hint: 're-cook the material and publish its record, artifact, references, and receipt together',\n    detail: { field },\n  });\n}\n\nexport function validateMaterialCookReceipt(\n  value: unknown,\n  expected: MaterialCookIdentityExpectation = {},\n): Result<MaterialCookReceipt, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('receipt');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/2') return invalid('receipt.schemaVersion');\n  if (typeof candidate.layoutIdentity !== 'string' || candidate.layoutIdentity.length === 0) {\n    return invalid('receipt.layoutIdentity');\n  }\n  if (candidate.derivedInterface === null || typeof candidate.derivedInterface !== 'object') {\n    return invalid('receipt.derivedInterface');\n  }\n  const derivedInterface = candidate.derivedInterface as Record<string, unknown>;\n  if (derivedInterface.layoutIdentity !== candidate.layoutIdentity) {\n    return invalid('receipt.derivedInterface.layoutIdentity');\n  }\n  for (const field of [\n    'sourceClosure',\n    'profile',\n    'compilerVersion',\n    'inputDigest',\n    'outputDigest',\n  ]) {\n    const fieldValue = candidate[field];\n    if (\n      (field === 'sourceClosure' && !Array.isArray(fieldValue)) ||\n      (field !== 'sourceClosure' && typeof fieldValue !== 'string')\n    ) {\n      return invalid(`receipt.${field}`);\n    }\n  }\n  const sourceClosure = candidate.sourceClosure;\n  if (Array.isArray(sourceClosure) && sourceClosure.some((path) => typeof path !== 'string')) {\n    return invalid('receipt.sourceClosure');\n  }\n  if (\n    expected.layoutIdentity !== undefined &&\n    candidate.layoutIdentity !== expected.layoutIdentity\n  ) {\n    return invalid('receipt.layoutIdentity');\n  }\n  if (expected.artifactDigest !== undefined && candidate.outputDigest !== expected.artifactDigest) {\n    return invalid('receipt.outputDigest');\n  }\n  if (expected.inputDigest !== undefined && candidate.inputDigest !== expected.inputDigest) {\n    return invalid('receipt.inputDigest');\n  }\n  if (\n    candidate.publicationGeneration !== undefined &&\n    (typeof candidate.publicationGeneration !== 'number' ||\n      !Number.isSafeInteger(candidate.publicationGeneration) ||\n      candidate.publicationGeneration < 1)\n  ) {\n    return invalid('receipt.publicationGeneration');\n  }\n  return ok({\n    schemaVersion: 'material-cook/2',\n    sourceClosure: candidate.sourceClosure as string[],\n    profile: candidate.profile as string,\n    compilerVersion: candidate.compilerVersion as string,\n    inputDigest: candidate.inputDigest as string,\n    outputDigest: candidate.outputDigest as string,\n    layoutIdentity: candidate.layoutIdentity,\n    derivedInterface: { layoutIdentity: derivedInterface.layoutIdentity as string },\n    ...(candidate.publicationGeneration === undefined\n      ? {}\n      : { publicationGeneration: candidate.publicationGeneration as number }),\n  });\n}\n\nexport function validateCookedMaterialRecord(\n  value: unknown,\n): Result<CookedMaterialRecord, MaterialCookRecordError> {\n  if (value === null || typeof value !== 'object') return invalid('record');\n  const candidate = value as Record<string, unknown>;\n  if (candidate.schemaVersion !== 'material-cook/2') return invalid('schemaVersion');\n  if (typeof candidate.guid !== 'string' || !candidate.guid) return invalid('guid');\n  if (candidate.materialGuid !== undefined && typeof candidate.materialGuid !== 'string')\n    return invalid('materialGuid');\n  if (\n    candidate.publicationGeneration !== undefined &&\n    (typeof candidate.publicationGeneration !== 'number' ||\n      !Number.isSafeInteger(candidate.publicationGeneration) ||\n      candidate.publicationGeneration < 1)\n  )\n    return invalid('publicationGeneration');\n  if (candidate.specializationKey !== undefined && typeof candidate.specializationKey !== 'string')\n    return invalid('specializationKey');\n  if (candidate.artifactDigest !== undefined && typeof candidate.artifactDigest !== 'string')\n    return invalid('artifactDigest');\n  if (\n    candidate.sourceClosure !== undefined &&\n    (!Array.isArray(candidate.sourceClosure) ||\n      candidate.sourceClosure.some((path) => typeof path !== 'string'))\n  )\n    return invalid('sourceClosure');\n  if (candidate.parameterContract !== undefined) {\n    if (candidate.parameterContract === null || typeof candidate.parameterContract !== 'object')\n      return invalid('parameterContract');\n    const parameterContract = candidate.parameterContract as Record<string, unknown>;\n    if (!Array.isArray(parameterContract.parameters))\n      return invalid('parameterContract.parameters');\n    if (\n      parameterContract.values === null ||\n      typeof parameterContract.values !== 'object' ||\n      Array.isArray(parameterContract.values)\n    )\n      return invalid('parameterContract.values');\n  }\n  if (candidate.resolved === null || typeof candidate.resolved !== 'object')\n    return invalid('resolved');\n  if (candidate.refs === null || typeof candidate.refs !== 'object') return invalid('refs');\n  if (candidate.artifact === null || typeof candidate.artifact !== 'object')\n    return invalid('artifact');\n  if (candidate.receipt === null || typeof candidate.receipt !== 'object')\n    return invalid('receipt');\n  const artifact = candidate.artifact as Record<string, unknown>;\n  if (\n    typeof artifact.digest !== 'string' ||\n    (!Array.isArray(artifact.bytes) && !ArrayBuffer.isView(artifact.bytes))\n  ) {\n    return invalid('artifact');\n  }\n  const receiptResult = validateMaterialCookReceipt(candidate.receipt, {\n    artifactDigest: artifact.digest as string,\n  });\n  if (!receiptResult.ok) return receiptResult;\n  if (candidate.artifactDigest !== undefined && candidate.artifactDigest !== artifact.digest)\n    return invalid('artifactDigest');\n  if (\n    candidate.publicationGeneration !== undefined &&\n    receiptResult.value.publicationGeneration !== candidate.publicationGeneration\n  )\n    return invalid('receipt.publicationGeneration');\n  const normalized = {\n    ...candidate,\n    artifact: {\n      ...artifact,\n      bytes: ArrayBuffer.isView(artifact.bytes)\n        ? Uint8Array.from(artifact.bytes as Uint8Array)\n        : Uint8Array.from(artifact.bytes as number[]),\n    },\n    receipt: receiptResult.value,\n  } as CookedMaterialRecord;\n  return ok(normalized);\n}\n\nexport function projectCookedMaterialRecord(\n  record: CookedMaterialRecord,\n): Omit<CookedMaterialRecord, 'guid' | 'authored'> {\n  return {\n    resolved: record.resolved,\n    refs: record.refs,\n    artifact: record.artifact,\n    receipt: record.receipt,\n    schemaVersion: record.schemaVersion,\n  };\n}\n"]}

package/dist/mesh-bin-contract.mjs

@@ -0,0 +1,96 @@
+// src/mesh-bin-contract.ts
+var MESH_BIN_VERSION = 4;
+var MESH_BIN_PROJECTION_VERSION = 1;
+var MESH_BIN_HEADER_V4_BYTES = 80;
+var MESH_BIN_DIGEST_BYTES = 32;
+function failure(code, sourceKey, expected, actual) {
+  return {
+    ok: false,
+    error: {
+      code,
+      subject: "mesh-bin",
+      sourceKey,
+      expected,
+      actual,
+      recovery: "re-cook the source with its Meta sidecar through the build-time importer"
+    }
+  };
+}
+function digestBytes(digest) {
+  const bytes = new Uint8Array(MESH_BIN_DIGEST_BYTES);
+  bytes.set(new TextEncoder().encode(digest).subarray(0, MESH_BIN_DIGEST_BYTES));
+  return bytes;
+}
+function readDigest(bytes) {
+  return new TextDecoder().decode(bytes).replace(/\0+$/u, "");
+}
+function writeMeshBinHeader(header, out) {
+  if (out.byteLength < MESH_BIN_HEADER_V4_BYTES) {
+    throw new RangeError("mesh-bin v4 header output is truncated");
+  }
+  const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
+  view.setUint32(0, header.version, true);
+  view.setUint32(4, header.projectionVersion, true);
+  view.setUint32(8, header.mask, true);
+  view.setUint32(12, header.stride, true);
+  view.setUint32(16, header.vertexCount, true);
+  view.setUint32(20, header.vertexBytes, true);
+  view.setUint32(24, header.indexCount, true);
+  view.setUint32(28, header.indexWidth, true);
+  view.setUint32(32, header.indexBytes, true);
+  view.setUint32(36, header.jsonBytes, true);
+  out.set(digestBytes(header.digest), 48);
+}
+function decodeMeshBinHeader(bytes, sourceKey = "<unknown mesh source>") {
+  if (bytes.byteLength < MESH_BIN_HEADER_V4_BYTES) {
+    return failure(
+      "mesh-bin-header-truncated",
+      sourceKey,
+      `mesh-bin v4 header (${MESH_BIN_HEADER_V4_BYTES} bytes)`,
+      `${bytes.byteLength} bytes`
+    );
+  }
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const version = view.getUint32(0, true);
+  if (version !== MESH_BIN_VERSION) {
+    return failure("mesh-bin-version-unsupported", sourceKey, "mesh-bin v4", `version ${version}`);
+  }
+  const projectionVersion = view.getUint32(4, true);
+  const mask = view.getUint32(8, true);
+  const stride = view.getUint32(12, true);
+  const vertexCount = view.getUint32(16, true);
+  const vertexBytes = view.getUint32(20, true);
+  const indexCount = view.getUint32(24, true);
+  const indexWidth = view.getUint32(28, true);
+  const indexBytes = view.getUint32(32, true);
+  const jsonBytes = view.getUint32(36, true);
+  const digest = readDigest(bytes.subarray(48, 48 + MESH_BIN_DIGEST_BYTES));
+  if (projectionVersion !== MESH_BIN_PROJECTION_VERSION || mask === 0 || stride === 0 || !Number.isSafeInteger(vertexCount) || !Number.isSafeInteger(vertexBytes) || !Number.isSafeInteger(indexCount) || !Number.isSafeInteger(indexBytes) || !Number.isSafeInteger(jsonBytes) || indexCount === 0 && indexWidth !== 0 || indexCount > 0 && indexWidth !== 2 && indexWidth !== 4 || indexBytes !== indexCount * indexWidth || vertexBytes !== vertexCount * stride || digest.length === 0) {
+    return failure(
+      "mesh-bin-header-invalid",
+      sourceKey,
+      "safe v4 projection, stride, cardinality, and payload byte lengths",
+      `projection=${projectionVersion}; mask=${mask}; stride=${stride}; vertexBytes=${vertexBytes}; indexBytes=${indexBytes}; digest=${digest}`
+    );
+  }
+  return {
+    ok: true,
+    value: {
+      version: 4,
+      projectionVersion: 1,
+      mask,
+      digest,
+      stride,
+      vertexCount,
+      vertexBytes,
+      indexCount,
+      indexWidth,
+      indexBytes,
+      jsonBytes
+    }
+  };
+}
+
+export { MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, decodeMeshBinHeader, writeMeshBinHeader };
+//# sourceMappingURL=mesh-bin-contract.mjs.map
+//# sourceMappingURL=mesh-bin-contract.mjs.map

package/dist/mesh-bin-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mesh-bin-contract.ts"],"names":[],"mappings":"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","file":"mesh-bin-contract.mjs","sourcesContent":["/** Canonical mesh binary wire facts shared by build-time and runtime owners. */\n\nexport const MESH_BIN_VERSION = 4 as const;\nexport const MESH_BIN_PROJECTION_VERSION = 1 as const;\nexport const MESH_BIN_HEADER_V4_BYTES = 80;\nexport const MESH_BIN_DIGEST_BYTES = 32;\n\nexport interface MeshBinHeaderV4 {\n  readonly version: 4;\n  readonly projectionVersion: 1;\n  readonly mask: number;\n  readonly digest: string;\n  readonly stride: number;\n  readonly vertexCount: number;\n  readonly vertexBytes: number;\n  readonly indexCount: number;\n  readonly indexWidth: 0 | 2 | 4;\n  readonly indexBytes: number;\n  readonly jsonBytes: number;\n}\n\nexport interface MeshBinContractError {\n  readonly code:\n    | 'mesh-bin-header-truncated'\n    | 'mesh-bin-version-unsupported'\n    | 'mesh-bin-header-invalid';\n  readonly subject: 'mesh-bin';\n  readonly sourceKey: string;\n  readonly expected: string;\n  readonly actual: string;\n  readonly recovery: string;\n}\n\nexport type MeshBinHeaderResult =\n  | { readonly ok: true; readonly value: MeshBinHeaderV4 }\n  | { readonly ok: false; readonly error: MeshBinContractError };\n\nfunction failure(\n  code: MeshBinContractError['code'],\n  sourceKey: string,\n  expected: string,\n  actual: string,\n): MeshBinHeaderResult {\n  return {\n    ok: false,\n    error: {\n      code,\n      subject: 'mesh-bin',\n      sourceKey,\n      expected,\n      actual,\n      recovery: 're-cook the source with its Meta sidecar through the build-time importer',\n    },\n  };\n}\n\nfunction digestBytes(digest: string): Uint8Array {\n  const bytes = new Uint8Array(MESH_BIN_DIGEST_BYTES);\n  bytes.set(new TextEncoder().encode(digest).subarray(0, MESH_BIN_DIGEST_BYTES));\n  return bytes;\n}\n\nfunction readDigest(bytes: Uint8Array): string {\n  return new TextDecoder().decode(bytes).replace(/\\0+$/u, '');\n}\n\nexport function writeMeshBinHeader(header: MeshBinHeaderV4, out: Uint8Array): void {\n  if (out.byteLength < MESH_BIN_HEADER_V4_BYTES) {\n    throw new RangeError('mesh-bin v4 header output is truncated');\n  }\n  const view = new DataView(out.buffer, out.byteOffset, out.byteLength);\n  view.setUint32(0, header.version, true);\n  view.setUint32(4, header.projectionVersion, true);\n  view.setUint32(8, header.mask, true);\n  view.setUint32(12, header.stride, true);\n  view.setUint32(16, header.vertexCount, true);\n  view.setUint32(20, header.vertexBytes, true);\n  view.setUint32(24, header.indexCount, true);\n  view.setUint32(28, header.indexWidth, true);\n  view.setUint32(32, header.indexBytes, true);\n  view.setUint32(36, header.jsonBytes, true);\n  out.set(digestBytes(header.digest), 48);\n}\n\nexport function decodeMeshBinHeader(\n  bytes: Uint8Array,\n  sourceKey = '<unknown mesh source>',\n): MeshBinHeaderResult {\n  if (bytes.byteLength < MESH_BIN_HEADER_V4_BYTES) {\n    return failure(\n      'mesh-bin-header-truncated',\n      sourceKey,\n      `mesh-bin v4 header (${MESH_BIN_HEADER_V4_BYTES} bytes)`,\n      `${bytes.byteLength} bytes`,\n    );\n  }\n  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);\n  const version = view.getUint32(0, true);\n  if (version !== MESH_BIN_VERSION) {\n    return failure('mesh-bin-version-unsupported', sourceKey, 'mesh-bin v4', `version ${version}`);\n  }\n  const projectionVersion = view.getUint32(4, true);\n  const mask = view.getUint32(8, true);\n  const stride = view.getUint32(12, true);\n  const vertexCount = view.getUint32(16, true);\n  const vertexBytes = view.getUint32(20, true);\n  const indexCount = view.getUint32(24, true);\n  const indexWidth = view.getUint32(28, true);\n  const indexBytes = view.getUint32(32, true);\n  const jsonBytes = view.getUint32(36, true);\n  const digest = readDigest(bytes.subarray(48, 48 + MESH_BIN_DIGEST_BYTES));\n  if (\n    projectionVersion !== MESH_BIN_PROJECTION_VERSION ||\n    mask === 0 ||\n    stride === 0 ||\n    !Number.isSafeInteger(vertexCount) ||\n    !Number.isSafeInteger(vertexBytes) ||\n    !Number.isSafeInteger(indexCount) ||\n    !Number.isSafeInteger(indexBytes) ||\n    !Number.isSafeInteger(jsonBytes) ||\n    (indexCount === 0 && indexWidth !== 0) ||\n    (indexCount > 0 && indexWidth !== 2 && indexWidth !== 4) ||\n    indexBytes !== indexCount * indexWidth ||\n    vertexBytes !== vertexCount * stride ||\n    digest.length === 0\n  ) {\n    return failure(\n      'mesh-bin-header-invalid',\n      sourceKey,\n      'safe v4 projection, stride, cardinality, and payload byte lengths',\n      `projection=${projectionVersion}; mask=${mask}; stride=${stride}; vertexBytes=${vertexBytes}; indexBytes=${indexBytes}; digest=${digest}`,\n    );\n  }\n  return {\n    ok: true,\n    value: {\n      version: 4,\n      projectionVersion: 1,\n      mask,\n      digest,\n      stride,\n      vertexCount,\n      vertexBytes,\n      indexCount,\n      indexWidth: indexWidth as 0 | 2 | 4,\n      indexBytes,\n      jsonBytes,\n    },\n  };\n}\n"]}

package/dist/native-cooker-registry.d.ts

@@ -16,6 +16,24 @@ export interface NativeCooker<P = unknown, I = unknown> {
     readonly discover?: (input: unknown) => I | Promise<I>;
     cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;
 }
+export interface NativeCookTransactionSnapshot<P = unknown> {
+    readonly draft: NativeCookDraft<P>;
+    readonly generation: number;
+}
+export interface NativeCookTransactionOptions<P = unknown, I = unknown> {
+    readonly key: string;
+    readonly input: I;
+    readonly previous?: NativeCookTransactionSnapshot<P>;
+    readonly validate?: (draft: NativeCookDraft<P>) => string | undefined;
+    readonly publish?: (draft: NativeCookDraft<P>, generation: number) => void | Promise<void>;
+}
+export interface NativeCookTransactionResult<P = unknown> extends NativeCookTransactionSnapshot<P> {
+    readonly status: 'committed' | 'recovered';
+    readonly lastKnownGood: NativeCookDraft<P>;
+    readonly candidateGeneration: number;
+    readonly lastKnownGoodGeneration: number;
+    readonly recoveryHint?: string;
+}
 /** Injectable build-time table for native authored Pack producers. */
 export declare class NativeCookerRegistry {
     private readonly cookers;
@@ -24,5 +42,6 @@ export declare class NativeCookerRegistry {
     registeredCookers(): readonly string[];
     runDraft<P = unknown, I = unknown>(key: string, input: I): Promise<Result<NativeCookDraft<P>, AssetStageError>>;
     run<P = unknown, I = unknown>(key: string, input: I): Promise<Result<CookProduct<P>, AssetStageError>>;
+    runTransaction<P = unknown, I = unknown>(options: NativeCookTransactionOptions<P, I>): Promise<Result<NativeCookTransactionResult<P>, AssetStageError>>;
 }
 //# sourceMappingURL=native-cooker-registry.d.ts.map

package/dist/native-cooker-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-cooker-registry.d.ts","sourceRoot":"","sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,UAAU,EACV,eAAe,EACf,WAAW,EACX,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAClE;AAyCD,sEAAsE;AACtE,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAUpC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI1C,iBAAiB,IAAI,SAAS,MAAM,EAAE;IAIhC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;IAkCjD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EAChC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;CA+BpD"}
+{"version":3,"file":"native-cooker-registry.d.ts","sourceRoot":"","sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"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"}

package/dist/native-cooker.mjs

@@ -31,6 +31,19 @@ function failure(key, detail) {
     recovery: { action: `rerun native cooker ${key}`, retryable: true }
   });
 }
+function transactionFailure(key, reason) {
+  return failure(key, { guid: "unknown", producer: reason });
+}
+function recovered(key, previous) {
+  return {
+    ...previous,
+    status: "recovered",
+    lastKnownGood: previous.draft,
+    candidateGeneration: previous.generation + 1,
+    lastKnownGoodGeneration: previous.generation,
+    recoveryHint: `repair ${key} and submit a new candidate generation`
+  };
+}
 var NativeCookerRegistry = class {
   cookers = /* @__PURE__ */ new Map();
   register(cooker) {
@@ -98,6 +111,30 @@ var NativeCookerRegistry = class {
     };
     return ok(product);
   }
+  async runTransaction(options) {
+    const candidate = await this.runDraft(options.key, options.input);
+    if (!candidate.ok) {
+      return options.previous === void 0 ? candidate : ok(recovered(options.key, options.previous));
+    }
+    const invalidReason = options.validate?.(candidate.value);
+    if (invalidReason !== void 0) {
+      return options.previous === void 0 ? transactionFailure(options.key, invalidReason) : ok(recovered(options.key, options.previous));
+    }
+    const generation = (options.previous?.generation ?? 0) + 1;
+    try {
+      await options.publish?.(candidate.value, generation);
+    } catch {
+      return options.previous === void 0 ? transactionFailure(options.key, "atomic producer publication failed") : ok(recovered(options.key, options.previous));
+    }
+    return ok({
+      draft: candidate.value,
+      generation,
+      status: "committed",
+      lastKnownGood: candidate.value,
+      candidateGeneration: generation,
+      lastKnownGoodGeneration: generation
+    });
+  }
 };
 
 export { NativeCookerRegistry };

package/dist/native-cooker.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"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","file":"native-cooker.mjs","sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n  ArtifactDescriptor,\n  AssetCodec,\n  AssetStageError,\n  CookProduct,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\n\nexport interface NativeCookArtifact {\n  readonly mediaType: string;\n  readonly assetCodec?: AssetCodec;\n  readonly bytes: Uint8Array;\n}\n\nexport interface NativeCookDraft<P = unknown> {\n  readonly guid: string;\n  readonly payload: P;\n  readonly refs: readonly string[];\n  readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;\n  readonly inputFingerprint: string;\n}\n\nexport interface NativeCooker<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly discover?: (input: unknown) => I | Promise<I>;\n  cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;\n}\n\nfunction canonicalize(value: unknown): unknown {\n  if (value instanceof Uint8Array) return Buffer.from(value).toString('base64');\n  if (Array.isArray(value)) return value.map(canonicalize);\n  if (typeof value !== 'object' || value === null) return value;\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nested]) => [key, canonicalize(nested)]),\n  );\n}\n\nfunction digestDraft<P>(draft: NativeCookDraft<P>): string {\n  const bytes = JSON.stringify(\n    canonicalize({\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts: draft.artifacts,\n    }),\n  );\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\ntype NativeCookErrorDetail = Extract<\n  AssetStageError['detail'],\n  { readonly guid: string; readonly producer: string }\n>;\n\nfunction failure(key: string, detail: NativeCookErrorDetail): Result<never, AssetStageError> {\n  return err({\n    stage: 'native-cook',\n    code: 'native-cook-failed',\n    expected: 'a registered native cooker to produce a complete draft',\n    hint: 'register the cooker or repair its draft, then rerun recovery',\n    detail,\n    recovery: { action: `rerun native cooker ${key}`, retryable: true },\n  });\n}\n\n/** Injectable build-time table for native authored Pack producers. */\nexport class NativeCookerRegistry {\n  private readonly cookers = new Map<string, NativeCooker>();\n\n  register(cooker: NativeCooker): void {\n    if (typeof cooker.key !== 'string' || cooker.key.length === 0) {\n      throw new TypeError('NativeCookerRegistry.register: key must be a non-empty string');\n    }\n    if (typeof cooker.cook !== 'function') {\n      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);\n    }\n    this.cookers.set(cooker.key, cooker);\n  }\n\n  get(key: string): NativeCooker | undefined {\n    return this.cookers.get(key);\n  }\n\n  registeredCookers(): readonly string[] {\n    return [...this.cookers.keys()];\n  }\n\n  async runDraft<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<NativeCookDraft<P>, AssetStageError>> {\n    const cooker = this.cookers.get(key) as NativeCooker<P, I> | undefined;\n    if (cooker === undefined) {\n      return failure(key, { guid: 'unknown', producer: key });\n    }\n    let draft: NativeCookDraft<P>;\n    try {\n      const typedInput = cooker.discover === undefined ? input : await cooker.discover(input);\n      draft = await cooker.cook(typedInput);\n    } catch (error) {\n      return failure(key, { guid: 'unknown', producer: String(error) });\n    }\n    if (\n      draft.guid.length === 0 ||\n      draft.inputFingerprint.length === 0 ||\n      !Array.isArray(draft.refs) ||\n      typeof draft.payload !== 'object' ||\n      draft.payload === null ||\n      typeof draft.artifacts !== 'object' ||\n      draft.artifacts === null ||\n      Object.entries(draft.artifacts).some(\n        ([, artifact]) =>\n          artifact === null ||\n          typeof artifact !== 'object' ||\n          typeof artifact.mediaType !== 'string' ||\n          artifact.mediaType.length === 0 ||\n          !(artifact.bytes instanceof Uint8Array),\n      )\n    ) {\n      return failure(key, { guid: draft.guid || 'unknown', producer: key });\n    }\n    return ok(draft);\n  }\n\n  async run<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<CookProduct<P>, AssetStageError>> {\n    const draftResult = await this.runDraft<P, I>(key, input);\n    if (!draftResult.ok) return draftResult;\n    const draft = draftResult.value;\n    const digest = digestDraft(draft);\n    const artifacts: Record<string, ArtifactDescriptor> = {};\n    for (const [path, artifact] of Object.entries(draft.artifacts)) {\n      artifacts[path] = {\n        path,\n        mediaType: artifact.mediaType,\n        ...(artifact.assetCodec === undefined ? {} : { assetCodec: artifact.assetCodec }),\n        byteLength: artifact.bytes.byteLength,\n      };\n    }\n    const receipt = {\n      guid: draft.guid,\n      origin: 'authoredPack' as const,\n      status: 'succeeded' as const,\n      inputFingerprint: draft.inputFingerprint,\n      outputDigest: digest,\n    };\n    const product: CookProduct<P> = {\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts,\n      digest,\n      receipt,\n    };\n    return ok(product);\n  }\n}\n"]}
+{"version":3,"sources":["../src/native-cooker-registry.ts"],"names":[],"mappings":"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","file":"native-cooker.mjs","sourcesContent":["import { createHash } from 'node:crypto';\nimport type {\n  ArtifactDescriptor,\n  AssetCodec,\n  AssetStageError,\n  CookProduct,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\n\nexport interface NativeCookArtifact {\n  readonly mediaType: string;\n  readonly assetCodec?: AssetCodec;\n  readonly bytes: Uint8Array;\n}\n\nexport interface NativeCookDraft<P = unknown> {\n  readonly guid: string;\n  readonly payload: P;\n  readonly refs: readonly string[];\n  readonly artifacts: Readonly<Record<string, NativeCookArtifact>>;\n  readonly inputFingerprint: string;\n}\n\nexport interface NativeCooker<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly discover?: (input: unknown) => I | Promise<I>;\n  cook(input: I): NativeCookDraft<P> | Promise<NativeCookDraft<P>>;\n}\n\nexport interface NativeCookTransactionSnapshot<P = unknown> {\n  readonly draft: NativeCookDraft<P>;\n  readonly generation: number;\n}\n\nexport interface NativeCookTransactionOptions<P = unknown, I = unknown> {\n  readonly key: string;\n  readonly input: I;\n  readonly previous?: NativeCookTransactionSnapshot<P>;\n  readonly validate?: (draft: NativeCookDraft<P>) => string | undefined;\n  readonly publish?: (draft: NativeCookDraft<P>, generation: number) => void | Promise<void>;\n}\n\nexport interface NativeCookTransactionResult<P = unknown> extends NativeCookTransactionSnapshot<P> {\n  readonly status: 'committed' | 'recovered';\n  readonly lastKnownGood: NativeCookDraft<P>;\n  readonly candidateGeneration: number;\n  readonly lastKnownGoodGeneration: number;\n  readonly recoveryHint?: string;\n}\n\nfunction canonicalize(value: unknown): unknown {\n  if (value instanceof Uint8Array) return Buffer.from(value).toString('base64');\n  if (Array.isArray(value)) return value.map(canonicalize);\n  if (typeof value !== 'object' || value === null) return value;\n  return Object.fromEntries(\n    Object.entries(value)\n      .sort(([left], [right]) => left.localeCompare(right))\n      .map(([key, nested]) => [key, canonicalize(nested)]),\n  );\n}\n\nfunction digestDraft<P>(draft: NativeCookDraft<P>): string {\n  const bytes = JSON.stringify(\n    canonicalize({\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts: draft.artifacts,\n    }),\n  );\n  return `sha256:${createHash('sha256').update(bytes).digest('hex')}`;\n}\n\ntype NativeCookErrorDetail = Extract<\n  AssetStageError['detail'],\n  { readonly guid: string; readonly producer: string }\n>;\n\nfunction failure(key: string, detail: NativeCookErrorDetail): Result<never, AssetStageError> {\n  return err({\n    stage: 'native-cook',\n    code: 'native-cook-failed',\n    expected: 'a registered native cooker to produce a complete draft',\n    hint: 'register the cooker or repair its draft, then rerun recovery',\n    detail,\n    recovery: { action: `rerun native cooker ${key}`, retryable: true },\n  });\n}\n\nfunction transactionFailure(key: string, reason: string): Result<never, AssetStageError> {\n  return failure(key, { guid: 'unknown', producer: reason });\n}\n\nfunction recovered<P>(\n  key: string,\n  previous: NativeCookTransactionSnapshot<P>,\n): NativeCookTransactionResult<P> {\n  return {\n    ...previous,\n    status: 'recovered',\n    lastKnownGood: previous.draft,\n    candidateGeneration: previous.generation + 1,\n    lastKnownGoodGeneration: previous.generation,\n    recoveryHint: `repair ${key} and submit a new candidate generation`,\n  };\n}\n\n/** Injectable build-time table for native authored Pack producers. */\nexport class NativeCookerRegistry {\n  private readonly cookers = new Map<string, NativeCooker>();\n\n  register(cooker: NativeCooker): void {\n    if (typeof cooker.key !== 'string' || cooker.key.length === 0) {\n      throw new TypeError('NativeCookerRegistry.register: key must be a non-empty string');\n    }\n    if (typeof cooker.cook !== 'function') {\n      throw new TypeError(`NativeCookerRegistry.register: cooker ${cooker.key} must expose cook`);\n    }\n    this.cookers.set(cooker.key, cooker);\n  }\n\n  get(key: string): NativeCooker | undefined {\n    return this.cookers.get(key);\n  }\n\n  registeredCookers(): readonly string[] {\n    return [...this.cookers.keys()];\n  }\n\n  async runDraft<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<NativeCookDraft<P>, AssetStageError>> {\n    const cooker = this.cookers.get(key) as NativeCooker<P, I> | undefined;\n    if (cooker === undefined) {\n      return failure(key, { guid: 'unknown', producer: key });\n    }\n    let draft: NativeCookDraft<P>;\n    try {\n      const typedInput = cooker.discover === undefined ? input : await cooker.discover(input);\n      draft = await cooker.cook(typedInput);\n    } catch (error) {\n      return failure(key, { guid: 'unknown', producer: String(error) });\n    }\n    if (\n      draft.guid.length === 0 ||\n      draft.inputFingerprint.length === 0 ||\n      !Array.isArray(draft.refs) ||\n      typeof draft.payload !== 'object' ||\n      draft.payload === null ||\n      typeof draft.artifacts !== 'object' ||\n      draft.artifacts === null ||\n      Object.entries(draft.artifacts).some(\n        ([, artifact]) =>\n          artifact === null ||\n          typeof artifact !== 'object' ||\n          typeof artifact.mediaType !== 'string' ||\n          artifact.mediaType.length === 0 ||\n          !(artifact.bytes instanceof Uint8Array),\n      )\n    ) {\n      return failure(key, { guid: draft.guid || 'unknown', producer: key });\n    }\n    return ok(draft);\n  }\n\n  async run<P = unknown, I = unknown>(\n    key: string,\n    input: I,\n  ): Promise<Result<CookProduct<P>, AssetStageError>> {\n    const draftResult = await this.runDraft<P, I>(key, input);\n    if (!draftResult.ok) return draftResult;\n    const draft = draftResult.value;\n    const digest = digestDraft(draft);\n    const artifacts: Record<string, ArtifactDescriptor> = {};\n    for (const [path, artifact] of Object.entries(draft.artifacts)) {\n      artifacts[path] = {\n        path,\n        mediaType: artifact.mediaType,\n        ...(artifact.assetCodec === undefined ? {} : { assetCodec: artifact.assetCodec }),\n        byteLength: artifact.bytes.byteLength,\n      };\n    }\n    const receipt = {\n      guid: draft.guid,\n      origin: 'authoredPack' as const,\n      status: 'succeeded' as const,\n      inputFingerprint: draft.inputFingerprint,\n      outputDigest: digest,\n    };\n    const product: CookProduct<P> = {\n      guid: draft.guid,\n      payload: draft.payload,\n      refs: draft.refs,\n      artifacts,\n      digest,\n      receipt,\n    };\n    return ok(product);\n  }\n\n  async runTransaction<P = unknown, I = unknown>(\n    options: NativeCookTransactionOptions<P, I>,\n  ): Promise<Result<NativeCookTransactionResult<P>, AssetStageError>> {\n    const candidate = await this.runDraft<P, I>(options.key, options.input);\n    if (!candidate.ok) {\n      return options.previous === undefined\n        ? candidate\n        : ok(recovered(options.key, options.previous));\n    }\n    const invalidReason = options.validate?.(candidate.value);\n    if (invalidReason !== undefined) {\n      return options.previous === undefined\n        ? transactionFailure(options.key, invalidReason)\n        : ok(recovered(options.key, options.previous));\n    }\n    const generation = (options.previous?.generation ?? 0) + 1;\n    try {\n      await options.publish?.(candidate.value, generation);\n    } catch {\n      return options.previous === undefined\n        ? transactionFailure(options.key, 'atomic producer publication failed')\n        : ok(recovered(options.key, options.previous));\n    }\n    return ok({\n      draft: candidate.value,\n      generation,\n      status: 'committed',\n      lastKnownGood: candidate.value,\n      candidateGeneration: generation,\n      lastKnownGoodGeneration: generation,\n    });\n  }\n}\n"]}

package/dist/package-finalizer.d.ts

@@ -0,0 +1,121 @@
+import type { AssetCodec, AssetRelation, CookReceipt } from '@forgeax/engine-types';
+export interface PackageArtifactBody {
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly bytes: Uint8Array;
+}
+export interface PackageProductAsset {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly payload: Readonly<Record<string, unknown>>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackageArtifactBody>>;
+}
+export interface PackageProduct {
+    readonly assets: readonly PackageProductAsset[];
+    readonly receipts: readonly CookReceipt[];
+    readonly diagnostics: readonly unknown[];
+    readonly sourceRevision: string;
+    readonly sourceKey?: string;
+}
+/** Minimal authored Pack v1/v2 shape consumed by the file transport seam. */
+export interface AuthoredPackAssetInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly execution?: 'direct' | 'cooked';
+    readonly sourceKey?: string;
+    readonly sourceIndex?: number;
+    readonly relations?: readonly AssetRelation[];
+    readonly payload: Record<string, unknown>;
+    readonly refs?: readonly string[];
+    readonly artifacts?: Readonly<Record<string, unknown>>;
+}
+export interface AuthoredPackInput {
+    readonly schemaVersion?: string;
+    readonly assets?: readonly AuthoredPackAssetInput[];
+}
+export interface PackageDocumentArtifact {
+    readonly path: string;
+    readonly mediaType: string;
+    readonly assetCodec?: AssetCodec;
+    readonly byteLength: number;
+    readonly integrity: {
+        readonly algorithm: 'sha256';
+        readonly digest: string;
+    };
+}
+export interface PackageDocumentAsset {
+    readonly guid: string;
+    readonly kind: string;
+    readonly name?: string;
+    readonly payload: Record<string, unknown>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackageDocumentArtifact>>;
+}
+export interface PackageDocument {
+    readonly schemaVersion: '2.0.0';
+    readonly kind: 'internal-text-package';
+    readonly assets: readonly PackageDocumentAsset[];
+}
+/** Upgrade the legacy authored Pack envelope at the Pack schema boundary. */
+export declare function upgradeLegacyAuthoredPack(pack: AuthoredPackInput): AuthoredPackInput;
+export interface PackageFinalizePolicy {
+    readonly base: string;
+    readonly packagePath: string;
+    readonly artifactPath: (guid: string, localKey: string) => string;
+    readonly sink?: (path: string, bytes: Uint8Array) => void | Promise<void>;
+}
+export interface FinalizedPackageProduct {
+    readonly pack: PackageDocument;
+    readonly packageUrl: string;
+    readonly digest: string;
+    readonly receipts: readonly CookReceipt[];
+    readonly diagnostics: readonly unknown[];
+    readonly sourceRevision: string;
+    readonly sourceKey?: string;
+}
+interface PackageTransportSource {
+    readonly assets: readonly PackageProduct['assets'][number][];
+    readonly receipts?: readonly CookReceipt[];
+    readonly diagnostics?: readonly unknown[];
+    readonly sourceKey?: string;
+}
+export interface PackageFinalizerError {
+    readonly code: 'duplicate-guid' | 'missing-source-revision' | 'missing-receipt' | 'invalid-artifact';
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail: {
+        readonly guid?: string;
+        readonly key?: string;
+    };
+}
+export type PackageFinalizeResult = {
+    readonly ok: true;
+    readonly value: FinalizedPackageProduct;
+} | {
+    readonly ok: false;
+    readonly error: PackageFinalizerError;
+};
+/** Finalize a complete producer product without owning producer-specific policy. */
+export declare function finalizePackageProduct(product: PackageProduct, policy: PackageFinalizePolicy): Promise<PackageFinalizeResult>;
+/** Finalize a product-shaped source with the deterministic transport revision. */
+export declare function finalizePackageTransportSource(input: PackageTransportSource, policy: PackageFinalizePolicy): Promise<{
+    pack: PackageDocument;
+    packageUrl: string;
+    artifacts: {
+        bytes: Uint8Array<ArrayBufferLike>;
+        assetCodec?: AssetCodec;
+        guid: string;
+        localKey: string;
+        path: string;
+        mediaType: string;
+    }[];
+    digest: string;
+    sourceRevision: string;
+    semantic: string;
+}>;
+export declare function packageTransportRevision(value: unknown): string;
+export {};
+//# sourceMappingURL=package-finalizer.d.ts.map