@forgeax/engine-pack 0.1.3 → 0.1.4

package/dist/artifact-path.mjs

@@ -0,0 +1,53 @@
+import { ok, err } from '@forgeax/engine-types';
+
+// src/artifact-path.ts
+var PATH_HINT = "use a normalized package-relative artifact path without traversal, absolute prefixes, or remote URLs";
+function validateArtifactPath(locator, context) {
+  const decoded = decodeLocator(locator);
+  if (!decoded.ok) return invalidPath(locator, context);
+  const normalized = normalizeRelativePath(decoded.value);
+  if (!normalized) return invalidPath(locator, context);
+  return ok(normalized);
+}
+function decodeLocator(locator) {
+  let decoded = locator;
+  try {
+    for (let pass = 0; pass < 3; pass += 1) {
+      const next = decodeURIComponent(decoded);
+      if (next === decoded) break;
+      decoded = next;
+    }
+  } catch {
+    return err(null);
+  }
+  return ok(decoded);
+}
+function normalizeRelativePath(locator) {
+  if (locator.length === 0 || locator.includes("://")) return null;
+  if (locator.startsWith("/") || /^[A-Za-z]:[\\/]/.test(locator)) return null;
+  const segments = locator.replaceAll("\\", "/").split("/");
+  const normalized = [];
+  for (const segment of segments) {
+    if (segment === "..") return null;
+    if (segment === "" || segment === ".") continue;
+    normalized.push(segment);
+  }
+  return normalized.length > 0 ? normalized.join("/") : null;
+}
+function invalidPath(locator, context) {
+  return err({
+    code: "asset-artifact-path-invalid",
+    expected: "a normalized package-relative artifact path",
+    hint: PATH_HINT,
+    detail: {
+      guid: context.guid,
+      artifactKey: context.artifactKey,
+      observed: locator,
+      expected: context.packageRoot
+    }
+  });
+}
+
+export { validateArtifactPath };
+//# sourceMappingURL=artifact-path.mjs.map
+//# sourceMappingURL=artifact-path.mjs.map

package/dist/artifact-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/artifact-path.ts"],"names":[],"mappings":";;;AASA,IAAM,SAAA,GACJ,sGAAA;AAEK,SAAS,oBAAA,CACd,SACA,OAAA,EACoC;AACpC,EAAA,MAAM,OAAA,GAAU,cAAc,OAAO,CAAA;AACrC,EAAA,IAAI,CAAC,OAAA,CAAQ,EAAA,EAAI,OAAO,WAAA,CAAY,SAAS,OAAO,CAAA;AAEpD,EAAA,MAAM,UAAA,GAAa,qBAAA,CAAsB,OAAA,CAAQ,KAAK,CAAA;AACtD,EAAA,IAAI,CAAC,UAAA,EAAY,OAAO,WAAA,CAAY,SAAS,OAAO,CAAA;AAEpD,EAAA,OAAO,GAAG,UAAU,CAAA;AACtB;AAEA,SAAS,cAAc,OAAA,EAAuC;AAC5D,EAAA,IAAI,OAAA,GAAU,OAAA;AACd,EAAA,IAAI;AACF,IAAA,KAAA,IAAS,IAAA,GAAO,CAAA,EAAG,IAAA,GAAO,CAAA,EAAG,QAAQ,CAAA,EAAG;AACtC,MAAA,MAAM,IAAA,GAAO,mBAAmB,OAAO,CAAA;AACvC,MAAA,IAAI,SAAS,OAAA,EAAS;AACtB,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ;AAAA,EACF,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAI,IAAI,CAAA;AAAA,EACjB;AACA,EAAA,OAAO,GAAG,OAAO,CAAA;AACnB;AAEA,SAAS,sBAAsB,OAAA,EAAgC;AAC7D,EAAA,IAAI,QAAQ,MAAA,KAAW,CAAA,IAAK,QAAQ,QAAA,CAAS,KAAK,GAAG,OAAO,IAAA;AAC5D,EAAA,IAAI,OAAA,CAAQ,WAAW,GAAG,CAAA,IAAK,kBAAkB,IAAA,CAAK,OAAO,GAAG,OAAO,IAAA;AAEvE,EAAA,MAAM,WAAW,OAAA,CAAQ,UAAA,CAAW,MAAM,GAAG,CAAA,CAAE,MAAM,GAAG,CAAA;AACxD,EAAA,MAAM,aAAuB,EAAC;AAC9B,EAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,IAAA,IAAI,OAAA,KAAY,MAAM,OAAO,IAAA;AAC7B,IAAA,IAAI,OAAA,KAAY,EAAA,IAAM,OAAA,KAAY,GAAA,EAAK;AACvC,IAAA,UAAA,CAAW,KAAK,OAAO,CAAA;AAAA,EACzB;AACA,EAAA,OAAO,WAAW,MAAA,GAAS,CAAA,GAAI,UAAA,CAAW,IAAA,CAAK,GAAG,CAAA,GAAI,IAAA;AACxD;AAEA,SAAS,WAAA,CACP,SACA,OAAA,EACmC;AACnC,EAAA,OAAO,GAAA,CAAI;AAAA,IACT,IAAA,EAAM,6BAAA;AAAA,IACN,QAAA,EAAU,6CAAA;AAAA,IACV,IAAA,EAAM,SAAA;AAAA,IACN,MAAA,EAAQ;AAAA,MACN,MAAM,OAAA,CAAQ,IAAA;AAAA,MACd,aAAa,OAAA,CAAQ,WAAA;AAAA,MACrB,QAAA,EAAU,OAAA;AAAA,MACV,UAAU,OAAA,CAAQ;AAAA;AACpB,GACD,CAAA;AACH","file":"artifact-path.mjs","sourcesContent":["import type { AssetArtifactError } from '@forgeax/engine-types';\nimport { err, ok, type Result } from '@forgeax/engine-types';\n\nexport interface ArtifactPathContext {\n  readonly packageRoot: string;\n  readonly guid: string;\n  readonly artifactKey: string;\n}\n\nconst PATH_HINT =\n  'use a normalized package-relative artifact path without traversal, absolute prefixes, or remote URLs';\n\nexport function validateArtifactPath(\n  locator: string,\n  context: ArtifactPathContext,\n): Result<string, AssetArtifactError> {\n  const decoded = decodeLocator(locator);\n  if (!decoded.ok) return invalidPath(locator, context);\n\n  const normalized = normalizeRelativePath(decoded.value);\n  if (!normalized) return invalidPath(locator, context);\n\n  return ok(normalized);\n}\n\nfunction decodeLocator(locator: string): Result<string, null> {\n  let decoded = locator;\n  try {\n    for (let pass = 0; pass < 3; pass += 1) {\n      const next = decodeURIComponent(decoded);\n      if (next === decoded) break;\n      decoded = next;\n    }\n  } catch {\n    return err(null);\n  }\n  return ok(decoded);\n}\n\nfunction normalizeRelativePath(locator: string): string | null {\n  if (locator.length === 0 || locator.includes('://')) return null;\n  if (locator.startsWith('/') || /^[A-Za-z]:[\\\\/]/.test(locator)) return null;\n\n  const segments = locator.replaceAll('\\\\', '/').split('/');\n  const normalized: string[] = [];\n  for (const segment of segments) {\n    if (segment === '..') return null;\n    if (segment === '' || segment === '.') continue;\n    normalized.push(segment);\n  }\n  return normalized.length > 0 ? normalized.join('/') : null;\n}\n\nfunction invalidPath(\n  locator: string,\n  context: ArtifactPathContext,\n): Result<never, AssetArtifactError> {\n  return err({\n    code: 'asset-artifact-path-invalid',\n    expected: 'a normalized package-relative artifact path',\n    hint: PATH_HINT,\n    detail: {\n      guid: context.guid,\n      artifactKey: context.artifactKey,\n      observed: locator,\n      expected: context.packageRoot,\n    },\n  });\n}\n"]}

package/dist/atlas/shelf-pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shelf-pack.d.ts","sourceRoot":"","sources":["../../src/atlas/shelf-pack.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,CAAC;IACpF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AAS3D,wBAAgB,SAAS,CACvB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtC,gBAAgB,CAiFlB"}
+{"version":3,"file":"shelf-pack.d.ts","sourceRoot":"","sources":["../../src/atlas/shelf-pack.ts"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,cAAc,EAAE,mBAAmB,GAAG,qBAAqB,CAAC,CAAC;IACpF,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAAE,CAAC;AA2B3D,wBAAgB,SAAS,CACvB,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,IAAI,EAAE;IAAE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACtC,gBAAgB,CA2DlB"}

package/dist/build.d.ts

@@ -0,0 +1,17 @@
+export type { AnimationClip, AnimationGraph, Asset, AudioClipAsset, EquirectAsset, FontAsset, MaterialAsset, MeshAsset, PackV2, PackV2Error, ParticleEffectAsset, RenderPipelineAsset, SamplerAsset, SceneAsset, SkeletonAsset, SkinAsset, TextureAsset, TilesetAsset, VideoAsset, } from '@forgeax/engine-types';
+export type { ArtifactPathContext } from './artifact-path.js';
+export { validateArtifactPath } from './artifact-path.js';
+export { buildCatalogProjection, type CatalogAuthority, type CatalogBuildError, type CatalogBuildErrorCode, type CatalogBuildProjectionOptions, type CatalogBuildResult, type CatalogImporterPolicy, type CatalogProducerVisibility, metaPathForGuid, } from './catalog-builder.js';
+export { calculateCatalogDelta } from './catalog-delta.js';
+export { type CatalogOutputDeclaration, type CatalogProducerMeta, type CookedPackageProjection, catalogProjectionFor, currentProjectionFor, findReservedAssetKindConflict, type PackageCatalogInput, projectCookedPackageEntry, projectExternalCatalogEntries, projectPackageCatalog, projectRuntimeCatalogRow, type RuntimeCatalogRowInput, } from './catalog-projection.js';
+export { type CookedMaterialRecord, collectMaterialCookRefs, createMaterialArtifactDigest, type MaterialCookArtifact, type MaterialCookIdentityExpectation, type MaterialCookReceipt, type MaterialCookRecordError, type MaterialCookRefs, projectCookedMaterialRecord, serializeCookedMaterialRecord, serializeMaterialCookReceipt, validateCookedMaterialRecord, validateMaterialCookReceipt, } from './evidence/material-cook.js';
+export { buildOfflineAssetEvidence, packageVerification } from './evidence/offline-evidence.js';
+export { decodeMeshBinHeader, MESH_BIN_DIGEST_BYTES, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_PROJECTION_VERSION, MESH_BIN_VERSION, type MeshBinContractError, type MeshBinHeaderResult, type MeshBinHeaderV4, writeMeshBinHeader, } from './mesh-bin-contract.js';
+export { type AuthoredPackAssetInput, type AuthoredPackInput, type FinalizedPackageProduct, finalizePackageProduct, finalizePackageTransportSource, type PackageArtifactBody, type PackageFinalizePolicy, type PackageFinalizeResult, type PackageFinalizerError, type PackageProduct, type PackageProductAsset, packageTransportRevision, upgradeLegacyAuthoredPack, } from './package-finalizer.js';
+export { validateProducerContract, validateProducerOutputs } from './producer-contract.js';
+export { parsePackV2, validateMeta, validatePack, validatePackV2 } from './runtime.js';
+export { createRuntimePackPublication, type RuntimePackAssetInput, type RuntimePackEnvelope, type RuntimePackInput, type RuntimePackPublication, type RuntimePackPublicationInput, } from './runtime-publication.js';
+export { type InventoryDeclaration, type ScanInventory, type ScanOptions, type ScriptablePackInventoryDeclaration, type ScriptablePackScanOptions, STANDARD_SCRIPTABLE_PACK_SCAN_OPTIONS, scanInventory, } from './scanner.js';
+export { type AssetReader, isScriptablePackAssetKind, projectScriptablePackMeta, projectScriptablePackSceneComponents, SCRIPTABLE_PACK_ASSET_KINDS, SCRIPTABLE_PACK_CAPABILITY_MANIFEST, type ScriptablePackAssetDeclaration, type ScriptablePackAssetDeclarations, type ScriptablePackAssetFor, type ScriptablePackAssetKind, type ScriptablePackDefinition, type ScriptablePackError, type ScriptablePackExternalAssets, type ScriptablePackMetaJson, type ScriptablePackOutputs, type ScriptablePackPublicationEnvelope, type ScriptablePackReadError, type ScriptablePackSceneComponent, type ScriptablePackSceneComponentInput, type ScriptablePackSourceClosureEntry, validateScriptablePackDefinition, } from './scriptable-pack.js';
+export { calculateTopologyDiff, diffTopology } from './topology.js';
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"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"}