@forgeax/engine-assets-runtime 0.1.3 → 0.1.6

package/dist/internal.d.ts

@@ -1,2 +1,3 @@
-export { type AssetRegistryResolver, getAssetRegistryResolver, } from './internal/load-asset.js';
+export { CatalogSession } from './internal/catalog-session.js';
+export { type AssetRegistry, type AssetRegistryResolver, getAssetRegistryResolver, } from './internal/load-asset.js';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,0BAA0B,CAAC"}

package/dist/internal.mjs

@@ -1,6 +1,320 @@
-import '@forgeax/engine-types';
+import { err, ok } from '@forgeax/engine-types';
 
-// src/internal/load-asset.ts
+// src/internal/catalog-session.ts
+function invalidRow(guid, reason) {
+  return err({
+    code: "asset-package-invalid",
+    expected: "one complete current runtime Catalog row",
+    hint: "rebuild the producer Catalog and publish one Pack v2 tuple",
+    detail: { guid, reason }
+  });
+}
+function validateRuntimeRow(row) {
+  if (row === null || typeof row !== "object") return invalidRow("", "row");
+  const candidate = row;
+  const guid = typeof candidate.guid === "string" ? candidate.guid : "";
+  if (guid.trim().length === 0) return invalidRow(guid, "guid");
+  if (typeof candidate.kind !== "string" || candidate.kind.trim().length === 0)
+    return invalidRow(guid, "kind");
+  if (typeof candidate.packageUrl !== "string" || candidate.packageUrl.trim().length === 0)
+    return invalidRow(guid, "packageUrl");
+  if (typeof candidate.sourcePath !== "string" || candidate.sourcePath.trim().length === 0)
+    return invalidRow(guid, "sourcePath");
+  if (!Number.isSafeInteger(candidate.publication?.generation))
+    return invalidRow(guid, "publication generation");
+  if (candidate.publication === void 0) return invalidRow(guid, "publication");
+  const publication = candidate.publication;
+  if (publication.schemaVersion !== "asset-publication/1" || typeof publication.sourcePath !== "string" || publication.sourcePath.trim().length === 0 || typeof publication.sourceRevision !== "string" || publication.sourceRevision.trim().length === 0 || publication.generation < 0 || typeof publication.digest !== "string" || publication.digest.trim().length === 0 || typeof publication.outputSetDigest !== "string" || publication.outputSetDigest.trim().length === 0 || !Array.isArray(publication.outputs) || publication.receipt === null || typeof publication.receipt !== "object" || !Array.isArray(publication.externalEvidence)) {
+    return invalidRow(guid, "publication tuple");
+  }
+  return ok(Object.freeze({ ...candidate, guid, publication }));
+}
+
+// src/internal/catalog-session.ts
+function runtimeError(code, guid, detail) {
+  if (code === "catalog-discontinuous") {
+    return {
+      code,
+      expected: "an ordered catalog revision window",
+      hint: "reconcile the current Catalog before consuming this delta",
+      detail: {
+        scopeId: String(detail.scopeId ?? "unknown"),
+        expectedGeneration: Number(detail.expectedGeneration ?? 0),
+        actualGeneration: Number(detail.actualGeneration ?? 0)
+      }
+    };
+  }
+  return {
+    code: "asset-package-invalid",
+    expected: "a verified Catalog source",
+    hint: "repair the producer Catalog and retry with the current publication",
+    detail: { guid, reason: String(detail.reason ?? "catalog source failed") }
+  };
+}
+function freezeSnapshot(snapshot) {
+  return Object.freeze({
+    ...snapshot,
+    entries: Object.freeze([...snapshot.entries]),
+    changed: Object.freeze([...snapshot.changed]),
+    removed: Object.freeze([...snapshot.removed]),
+    diagnostics: Object.freeze([...snapshot.diagnostics])
+  });
+}
+function sameEntry(left, right) {
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+function key(guid) {
+  return guid.toLowerCase();
+}
+var CatalogSession = class {
+  source;
+  scopeId;
+  generation;
+  entries = /* @__PURE__ */ new Map();
+  listeners = /* @__PURE__ */ new Set();
+  unsubscribe;
+  baselinePromise;
+  reconcilePromise;
+  pending = [];
+  currentSnapshot;
+  revision;
+  diagnostics = [];
+  listenerFailures = 0;
+  changed = /* @__PURE__ */ new Set();
+  removed = /* @__PURE__ */ new Set();
+  epoch = 0;
+  stale = false;
+  staleGeneration = 0;
+  started = false;
+  disposed = false;
+  constructor(source, options = {}) {
+    this.source = source;
+    this.scopeId = options.scopeId ?? source.expectedScope?.scopeId ?? "asset-runtime";
+    this.generation = options.generation ?? source.expectedScope?.generation ?? 0;
+    this.currentSnapshot = freezeSnapshot({
+      scopeId: this.scopeId,
+      generation: this.generation,
+      epoch: 0,
+      entries: [],
+      changed: [],
+      removed: [],
+      diagnostics: [],
+      listenerFailures: 0,
+      stale: false
+    });
+  }
+  start() {
+    if (this.baselinePromise !== void 0) return this.baselinePromise;
+    if (this.disposed) return Promise.resolve(err(this.disposedError()));
+    this.unsubscribe = this.source.subscribe((delta) => this.receive(delta));
+    const promise = this.source.enumerate().then((result) => {
+      if (!result.ok) {
+        this.markStale();
+        this.publish();
+        return err(runtimeError("asset-package-invalid", "", { reason: result.error.code }));
+      }
+      this.entries.clear();
+      for (const entry of result.value) {
+        const validated = validateRuntimeRow(entry);
+        if (!validated.ok) {
+          this.markStale();
+          this.publish();
+          return err(validated.error);
+        }
+        this.entries.set(key(validated.value.guid), validated.value);
+      }
+      this.started = true;
+      this.stale = false;
+      this.staleGeneration = this.generation;
+      this.diagnostics = [];
+      for (const delta of this.pending) this.fold(delta, false);
+      this.pending = [];
+      this.publish();
+      return ok(this.currentSnapshot);
+    }).catch((cause) => {
+      this.markStale();
+      this.addDiagnostic("catalog-degraded-rows", "Catalog enumeration must resolve a Result");
+      this.publish();
+      return err(
+        runtimeError("asset-package-invalid", "", {
+          reason: cause instanceof Error ? cause.message : String(cause)
+        })
+      );
+    });
+    this.baselinePromise = promise;
+    void promise.then(
+      (result) => {
+        if (!result.ok) this.baselinePromise = void 0;
+      },
+      () => {
+        this.baselinePromise = void 0;
+      }
+    );
+    return promise;
+  }
+  reconcile() {
+    if (this.disposed) return Promise.resolve(err(this.disposedError()));
+    if (this.reconcilePromise !== void 0) return this.reconcilePromise;
+    this.unsubscribe?.();
+    this.unsubscribe = void 0;
+    this.started = false;
+    this.pending = [];
+    this.baselinePromise = void 0;
+    this.epoch += 1;
+    const promise = this.start();
+    this.reconcilePromise = promise;
+    void promise.then(
+      () => {
+        if (this.reconcilePromise === promise) this.reconcilePromise = void 0;
+      },
+      () => {
+        if (this.reconcilePromise === promise) this.reconcilePromise = void 0;
+      }
+    );
+    return promise;
+  }
+  current(guid) {
+    return this.entries.get(key(guid));
+  }
+  snapshot() {
+    return this.currentSnapshot;
+  }
+  discontinuity() {
+    if (!this.stale) return void 0;
+    return {
+      code: "catalog-discontinuous",
+      expected: "an ordered, authoritative catalog revision window",
+      hint: "reconcile the Catalog source and retry the current publication",
+      detail: {
+        scopeId: this.scopeId,
+        expectedGeneration: this.generation,
+        actualGeneration: this.staleGeneration
+      }
+    };
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => this.listeners.delete(listener);
+  }
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.unsubscribe?.();
+    this.unsubscribe = void 0;
+    this.pending = [];
+    this.listeners.clear();
+  }
+  receive(delta) {
+    if (this.disposed) return;
+    if (!this.started) {
+      this.pending.push(delta);
+      return;
+    }
+    this.fold(delta, true);
+  }
+  fold(delta, publish) {
+    if (delta.scopeId !== void 0 && delta.scopeId !== this.scopeId || delta.generation !== void 0 && delta.generation !== this.generation) {
+      this.markStale(delta.generation);
+      this.addDiagnostic("catalog-scope-mismatch", "delta scope does not match the session");
+      if (publish) this.publish();
+      return;
+    }
+    if (delta.authority === "degraded") {
+      this.markStale(delta.generation);
+      this.addDiagnostic("catalog-degraded-rows", "degraded rows are not identity-bearing");
+      if (publish) this.publish();
+      return;
+    }
+    if (delta.revisions !== void 0) {
+      const baseline = delta.revisions.baseline;
+      const current = delta.revisions.current;
+      const valid = baseline.length === current.length && current.every((point) => {
+        const prior = baseline.find((item) => item.rootId === point.rootId);
+        return prior !== void 0 && point.revision === prior.revision + 1;
+      });
+      if (!valid) {
+        this.markStale(delta.generation);
+        this.addDiagnostic("catalog-gap", "delta revision window is not contiguous");
+        if (publish) this.publish();
+        return;
+      }
+    }
+    let changed = false;
+    for (const entry of [...delta.added, ...delta.changed]) {
+      const validated = validateRuntimeRow(entry);
+      if (!validated.ok) {
+        this.markStale(delta.generation);
+        this.addDiagnostic("catalog-degraded-rows", "delta contains an invalid runtime row");
+        if (publish) this.publish();
+        return;
+      }
+      const entryKey = key(validated.value.guid);
+      const prior = this.entries.get(entryKey);
+      if (prior === void 0 || !sameEntry(prior, validated.value)) {
+        this.entries.set(entryKey, validated.value);
+        this.changed.add(entryKey);
+        changed = true;
+        if (validated.value.revision !== void 0) this.revision = validated.value.revision;
+      }
+    }
+    for (const guid of delta.removed) {
+      const entryKey = key(guid);
+      if (this.entries.delete(entryKey)) {
+        this.removed.add(entryKey);
+        changed = true;
+      }
+    }
+    if (changed) this.epoch += 1;
+    if (publish) this.publish();
+  }
+  addDiagnostic(code, expected) {
+    if (this.diagnostics.some((diagnostic) => diagnostic.code === code)) return;
+    this.diagnostics.push({
+      code,
+      severity: "blocking",
+      expected,
+      hint: "reconcile the Catalog before loading the affected publication",
+      authority: "catalog"
+    });
+  }
+  markStale(actualGeneration = this.generation) {
+    this.stale = true;
+    this.staleGeneration = actualGeneration;
+    this.epoch += 1;
+  }
+  publish() {
+    this.currentSnapshot = freezeSnapshot({
+      scopeId: this.scopeId,
+      generation: this.generation,
+      epoch: this.epoch,
+      ...this.revision === void 0 ? {} : { revision: this.revision },
+      entries: [...this.entries.values()].sort(
+        (left, right) => key(left.guid).localeCompare(key(right.guid))
+      ),
+      changed: [...this.changed].sort(),
+      removed: [...this.removed].sort(),
+      diagnostics: this.diagnostics,
+      listenerFailures: this.listenerFailures,
+      stale: this.stale
+    });
+    this.changed.clear();
+    this.removed.clear();
+    for (const listener of [...this.listeners]) {
+      try {
+        listener(this.currentSnapshot);
+      } catch {
+        this.listenerFailures = Math.min(1024, this.listenerFailures + 1);
+        this.currentSnapshot = freezeSnapshot({
+          ...this.currentSnapshot,
+          listenerFailures: this.listenerFailures
+        });
+      }
+    }
+  }
+  disposedError() {
+    return runtimeError("asset-runtime-disposed", "", { scopeId: this.scopeId });
+  }
+};
 var REGISTRY_RESOLVER = /* @__PURE__ */ Symbol.for("forgeax.assets-runtime.registry-resolver");
 function getAssetRegistryResolver(registry) {
   const resolver = registry[REGISTRY_RESOLVER];
@@ -10,6 +324,6 @@ function getAssetRegistryResolver(registry) {
   return resolver;
 }
 
-export { getAssetRegistryResolver };
+export { CatalogSession, getAssetRegistryResolver };
 //# sourceMappingURL=internal.mjs.map
 //# sourceMappingURL=internal.mjs.map

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/internal/load-asset.ts"],"names":[],"mappings":";;;AA+DA,IAAM,iBAAA,mBAAoB,MAAA,CAAO,GAAA,CAAI,0CAA0C,CAAA;AAKxE,SAAS,yBAAyB,QAAA,EAAgD;AACvF,EAAA,MAAM,QAAA,GAAY,SAAkC,iBAAiB,CAAA;AACrE,EAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,IAAA,MAAM,IAAI,UAAU,2DAA2D,CAAA;AAAA,EACjF;AACA,EAAA,OAAO,QAAA;AACT","file":"internal.mjs","sourcesContent":["import type {\n  Asset,\n  AssetArtifactReader,\n  AssetDecoder,\n  AssetDecoderInput,\n  AssetDecoderLease,\n  AssetKind,\n  AssetLoadError,\n  BuiltinAssetKind,\n  BuiltinAssetPayload,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\nimport type { CatalogSource } from '../catalog-source.js';\nimport { ArtifactCache } from './artifact-cache.js';\nimport { AssetGraph, type AssetGraphSnapshot } from './asset-graph.js';\nimport { CatalogSession, type CatalogSessionOptions } from './catalog-session.js';\nimport { DecoderRegistry } from './decoder-registry.js';\nimport { freezeRuntimePayload } from './immutable-payload.js';\nimport { PackReader } from './pack-reader.js';\nimport { validateRuntimeRow } from './validate-runtime-row.js';\n\nexport interface AssetRegistryOptions extends CatalogSessionOptions {\n  readonly catalog: CatalogSource;\n  readonly fetcher?: typeof globalThis.fetch;\n  readonly maxConcurrentReads?: number;\n}\n\nexport interface AssetLoadOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport type AssetRegistrySnapshot = AssetGraphSnapshot;\n\nexport type AssetRegistrySnapshotCounters = AssetRegistrySnapshot['counters'];\n\nexport interface AssetRegistry {\n  installDecoder<P, K extends string>(\n    kind: AssetKind<P, K>,\n    decoder: AssetDecoder<P>,\n  ): AssetDecoderLease;\n  load<K extends BuiltinAssetKind>(\n    guid: string,\n    kind: K,\n    options?: AssetLoadOptions,\n  ): Promise<Result<BuiltinAssetPayload<K>, AssetLoadError>>;\n  load<P, K extends string>(\n    guid: string,\n    kind: AssetKind<P, K>,\n    options?: AssetLoadOptions,\n  ): Promise<Result<P, AssetLoadError>>;\n  snapshot(): AssetRegistrySnapshot;\n  subscribe(listener: (snapshot: AssetRegistrySnapshot) => void): () => void;\n  dispose(): void;\n}\n\n/** Internal render projection; the root Registry keeps only its five actions. */\nexport interface AssetRegistryResolver {\n  readonly epoch: number;\n  lookup<T extends Asset>(guid: string): T | undefined;\n  guidOf(asset: Asset): string | undefined;\n}\n\nconst REGISTRY_RESOLVER = Symbol.for('forgeax.assets-runtime.registry-resolver');\ntype RegistryWithResolver = AssetRegistry & {\n  [REGISTRY_RESOLVER]?: AssetRegistryResolver;\n};\n\nexport function getAssetRegistryResolver(registry: AssetRegistry): AssetRegistryResolver {\n  const resolver = (registry as RegistryWithResolver)[REGISTRY_RESOLVER];\n  if (resolver === undefined) {\n    throw new TypeError('AssetRegistry resolver is not owned by this asset runtime');\n  }\n  return resolver;\n}\n\nfunction missing(guid: string): AssetLoadError {\n  return {\n    code: 'asset-not-found',\n    expected: `the current Catalog to contain GUID \"${guid}\"`,\n    hint: 'inspect the producer Catalog and rebuild the missing publication',\n    detail: { guid },\n  };\n}\n\nfunction mismatch(guid: string, expectedKind: string, actualKind: string): AssetLoadError {\n  return {\n    code: 'asset-kind-mismatch',\n    expected: `Catalog kind \"${actualKind}\" to match \"${expectedKind}\"`,\n    hint: 'pass the Catalog kind or the matching custom AssetKind token',\n    detail: { guid, expectedKind, actualKind },\n  };\n}\n\nfunction artifactError(guid: string, reason: string): AssetLoadError {\n  return {\n    code: 'asset-integrity-failed',\n    expected: 'the verified artifact byte length and digest',\n    hint: 'verify the artifact digest and recook the Pack',\n    detail: {\n      guid,\n      artifactKey: reason,\n      expectedDigest: 'descriptor integrity',\n      actualDigest: reason,\n    },\n  };\n}\n\nconst ASSET_GUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction invalidGuid(guid: string): AssetLoadError {\n  return {\n    code: 'asset-guid-invalid',\n    expected: 'a 36-character dash-form asset GUID',\n    hint: 'pass the producer GUID from the current Catalog row',\n    detail: { guid },\n  };\n}\n\nexport function createAssetRegistry(options: AssetRegistryOptions): AssetRegistry {\n  const session = new CatalogSession(options.catalog, options);\n  const reader = new PackReader(options.fetcher === undefined ? {} : { fetcher: options.fetcher });\n  const cache = new ArtifactCache();\n  const decoders = new DecoderRegistry(\n    options.scopeId === undefined ? {} : { scopeId: options.scopeId },\n  );\n  const graph = new AssetGraph<{ readonly value: unknown; readonly refs: readonly string[] }>({\n    ...(options.maxConcurrentReads === undefined\n      ? {}\n      : { maxConcurrentReads: options.maxConcurrentReads }),\n    read: async (guid, signal) => {\n      const row = session.current(guid);\n      if (row === undefined) return err(missing(guid));\n      const validated = validateRuntimeRow(row);\n      if (!validated.ok) return validated;\n      const publication = validated.value.publication;\n      const tuple = {\n        scopeId: session.snapshot().scopeId,\n        generation: publication.generation,\n        digest: publication.digest,\n        outputSetDigest: publication.outputSetDigest,\n      };\n      const pack = await reader.read(row.packageUrl, tuple, signal);\n      if (!pack.ok) return pack;\n      const envelope = pack.value.assets.find(\n        (asset) => asset.guid.toLowerCase() === guid.toLowerCase(),\n      );\n      if (envelope === undefined) return err(missing(guid));\n      const artifacts: AssetArtifactReader = {\n        read: (descriptor) => {\n          const integrity = descriptor.integrity;\n          if (integrity === undefined)\n            return Promise.resolve(err(artifactError(guid, descriptor.path)));\n          const key = `${tuple.scopeId}:${tuple.generation}:${tuple.outputSetDigest}:${integrity.digest}`;\n          return cache.read(key, async () => {\n            const url = resolveArtifactUrl(row.packageUrl, descriptor.path);\n            let response: Response;\n            try {\n              response = await (options.fetcher ?? globalThis.fetch)(url, { signal });\n            } catch {\n              return err(artifactError(guid, descriptor.path));\n            }\n            if (!response.ok) return err(artifactError(guid, descriptor.path));\n            const bytes = new Uint8Array(await response.arrayBuffer());\n            if (descriptor.byteLength === undefined || bytes.byteLength !== descriptor.byteLength) {\n              return err(artifactError(guid, descriptor.path));\n            }\n            const actualDigest = await sha256(bytes);\n            if (actualDigest !== descriptor.integrity?.digest.toLowerCase()) {\n              return err(artifactError(guid, `${descriptor.path}:${actualDigest}`));\n            }\n            return ok(bytes);\n          });\n        },\n      };\n      const input: AssetDecoderInput<unknown> = { envelope, artifacts, signal };\n      const decoded = await decoders.loadByKind(envelope.kind, input);\n      if (!decoded.ok) return decoded;\n      return ok({ value: freezeRuntimePayload(decoded.value), refs: envelope.refs });\n    },\n  });\n\n  let catalogEpoch = session.snapshot().epoch;\n  const unsubscribeCatalog = session.subscribe((snapshot) => {\n    if (snapshot.epoch === catalogEpoch) return;\n    catalogEpoch = snapshot.epoch;\n    graph.invalidateForCatalogChange(\n      snapshot.stale ? undefined : [...snapshot.changed, ...snapshot.removed],\n    );\n  });\n\n  const registry: AssetRegistry = {\n    installDecoder: (kind, decoder) => decoders.install(kind, decoder),\n    load: (async (\n      guid: string,\n      kind: BuiltinAssetKind | AssetKind<unknown, string>,\n      loadOptions: AssetLoadOptions = {},\n    ): Promise<Result<unknown, AssetLoadError>> => {\n      if (!ASSET_GUID_PATTERN.test(guid)) return err(invalidGuid(guid));\n      const expectedKind = typeof kind === 'string' ? kind : kind.kind;\n      const started = await session.start();\n      if (!started.ok) return err(started.error);\n      if (session.snapshot().stale) {\n        const reconciled = await session.reconcile();\n        if (!reconciled.ok) return err(reconciled.error);\n        const discontinuity = session.discontinuity();\n        if (discontinuity !== undefined) return err(discontinuity);\n      }\n      const row = session.current(guid);\n      if (row === undefined) return err(missing(guid));\n      if (row.kind !== expectedKind) return err(mismatch(guid, expectedKind, row.kind));\n      const result = await graph.load(guid, loadOptions.signal);\n      return result.ok ? ok(result.value.value) : result;\n    }) as AssetRegistry['load'],\n    snapshot: () => graph.snapshot(),\n    subscribe: (listener) => graph.subscribe(listener),\n    dispose: () => {\n      graph.dispose();\n      unsubscribeCatalog();\n      decoders.dispose();\n      cache.clear();\n      session.dispose();\n    },\n  };\n  const resolver: AssetRegistryResolver = {\n    get epoch() {\n      return graph.snapshot().epoch;\n    },\n    lookup: <T extends Asset>(guid: string) => graph.lookup(guid) as T | undefined,\n    guidOf: (asset: Asset) => graph.guidOf(asset),\n  };\n  Object.defineProperty(registry, REGISTRY_RESOLVER, {\n    value: resolver,\n    enumerable: false,\n  });\n  return registry;\n}\n\nasync function sha256(bytes: Uint8Array): Promise<string> {\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes as unknown as BufferSource);\n  return `sha256:${Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('')}`;\n}\n\nfunction resolveArtifactUrl(packageUrl: string, path: string): string {\n  const separator = packageUrl.lastIndexOf('/');\n  const packageDirectory = separator < 0 ? '' : packageUrl.slice(0, separator + 1);\n  try {\n    return new URL(path, packageDirectory).toString();\n  } catch {\n    return `${packageDirectory}${path.replace(/^\\//, '')}`;\n  }\n}\n"]}
+{"version":3,"sources":["../src/internal/validate-runtime-row.ts","../src/internal/catalog-session.ts","../src/internal/load-asset.ts"],"names":["err","ok"],"mappings":"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","file":"internal.mjs","sourcesContent":["import type { CatalogEntry } from '@forgeax/engine-types';\nimport { type AssetLoadError, err, ok, type Result } from '@forgeax/engine-types';\n\nexport interface RuntimeCatalogRow extends CatalogEntry {\n  readonly publication: NonNullable<CatalogEntry['publication']>;\n}\n\nfunction invalidRow(guid: string, reason: string): Result<never, AssetLoadError> {\n  return err({\n    code: 'asset-package-invalid',\n    expected: 'one complete current runtime Catalog row',\n    hint: 'rebuild the producer Catalog and publish one Pack v2 tuple',\n    detail: { guid, reason },\n  });\n}\n\nexport function validateRuntimeRow(row: CatalogEntry): Result<RuntimeCatalogRow, AssetLoadError> {\n  if (row === null || typeof row !== 'object') return invalidRow('', 'row');\n  const candidate = row as Partial<CatalogEntry>;\n  const guid = typeof candidate.guid === 'string' ? candidate.guid : '';\n  if (guid.trim().length === 0) return invalidRow(guid, 'guid');\n  if (typeof candidate.kind !== 'string' || candidate.kind.trim().length === 0)\n    return invalidRow(guid, 'kind');\n  if (typeof candidate.packageUrl !== 'string' || candidate.packageUrl.trim().length === 0)\n    return invalidRow(guid, 'packageUrl');\n  if (typeof candidate.sourcePath !== 'string' || candidate.sourcePath.trim().length === 0)\n    return invalidRow(guid, 'sourcePath');\n  if (!Number.isSafeInteger(candidate.publication?.generation))\n    return invalidRow(guid, 'publication generation');\n  if (candidate.publication === undefined) return invalidRow(guid, 'publication');\n  const publication = candidate.publication;\n  if (\n    publication.schemaVersion !== 'asset-publication/1' ||\n    typeof publication.sourcePath !== 'string' ||\n    publication.sourcePath.trim().length === 0 ||\n    typeof publication.sourceRevision !== 'string' ||\n    publication.sourceRevision.trim().length === 0 ||\n    publication.generation < 0 ||\n    typeof publication.digest !== 'string' ||\n    publication.digest.trim().length === 0 ||\n    typeof publication.outputSetDigest !== 'string' ||\n    publication.outputSetDigest.trim().length === 0 ||\n    !Array.isArray(publication.outputs) ||\n    publication.receipt === null ||\n    typeof publication.receipt !== 'object' ||\n    !Array.isArray(publication.externalEvidence)\n  ) {\n    return invalidRow(guid, 'publication tuple');\n  }\n  return ok(Object.freeze({ ...candidate, guid, publication }) as RuntimeCatalogRow);\n}\n","import type {\n  CatalogDelta,\n  CatalogDiagnostic,\n  CatalogEntry,\n  ResourceRevision,\n} from '@forgeax/engine-types';\nimport { type AssetLoadError, err, ok, type Result } from '@forgeax/engine-types';\nimport type { CatalogSource } from '../catalog-source.js';\nimport { type RuntimeCatalogRow, validateRuntimeRow } from './validate-runtime-row.js';\n\nexport interface CatalogSessionOptions {\n  readonly scopeId?: string;\n  readonly generation?: number;\n}\n\nexport interface CatalogSessionSnapshot {\n  readonly scopeId: string;\n  readonly generation: number;\n  readonly epoch: number;\n  readonly revision?: ResourceRevision;\n  readonly entries: readonly RuntimeCatalogRow[];\n  readonly changed: readonly string[];\n  readonly removed: readonly string[];\n  readonly diagnostics: readonly CatalogDiagnostic[];\n  readonly listenerFailures: number;\n  readonly stale: boolean;\n}\n\ntype SessionResult = Result<CatalogSessionSnapshot, AssetLoadError>;\ntype SessionListener = (snapshot: CatalogSessionSnapshot) => void;\n\nfunction runtimeError(\n  code: AssetLoadError['code'],\n  guid: string,\n  detail: Record<string, unknown>,\n): AssetLoadError {\n  if (code === 'catalog-discontinuous') {\n    return {\n      code,\n      expected: 'an ordered catalog revision window',\n      hint: 'reconcile the current Catalog before consuming this delta',\n      detail: {\n        scopeId: String(detail.scopeId ?? 'unknown'),\n        expectedGeneration: Number(detail.expectedGeneration ?? 0),\n        actualGeneration: Number(detail.actualGeneration ?? 0),\n      },\n    };\n  }\n  return {\n    code: 'asset-package-invalid',\n    expected: 'a verified Catalog source',\n    hint: 'repair the producer Catalog and retry with the current publication',\n    detail: { guid, reason: String(detail.reason ?? 'catalog source failed') },\n  };\n}\n\nfunction freezeSnapshot(snapshot: CatalogSessionSnapshot): CatalogSessionSnapshot {\n  return Object.freeze({\n    ...snapshot,\n    entries: Object.freeze([...snapshot.entries]),\n    changed: Object.freeze([...snapshot.changed]),\n    removed: Object.freeze([...snapshot.removed]),\n    diagnostics: Object.freeze([...snapshot.diagnostics]),\n  });\n}\n\nfunction sameEntry(left: CatalogEntry, right: CatalogEntry): boolean {\n  return JSON.stringify(left) === JSON.stringify(right);\n}\n\nfunction key(guid: string): string {\n  return guid.toLowerCase();\n}\n\nexport class CatalogSession {\n  private readonly source: CatalogSource;\n  private readonly scopeId: string;\n  private readonly generation: number;\n  private readonly entries = new Map<string, RuntimeCatalogRow>();\n  private readonly listeners = new Set<SessionListener>();\n  private unsubscribe: (() => void) | undefined;\n  private baselinePromise: Promise<SessionResult> | undefined;\n  private reconcilePromise: Promise<SessionResult> | undefined;\n  private pending: CatalogDelta[] = [];\n  private currentSnapshot: CatalogSessionSnapshot;\n  private revision: ResourceRevision | undefined;\n  private diagnostics: CatalogDiagnostic[] = [];\n  private listenerFailures = 0;\n  private changed = new Set<string>();\n  private removed = new Set<string>();\n  private epoch = 0;\n  private stale = false;\n  private staleGeneration = 0;\n  private started = false;\n  private disposed = false;\n\n  constructor(source: CatalogSource, options: CatalogSessionOptions = {}) {\n    this.source = source;\n    this.scopeId = options.scopeId ?? source.expectedScope?.scopeId ?? 'asset-runtime';\n    this.generation = options.generation ?? source.expectedScope?.generation ?? 0;\n    this.currentSnapshot = freezeSnapshot({\n      scopeId: this.scopeId,\n      generation: this.generation,\n      epoch: 0,\n      entries: [],\n      changed: [],\n      removed: [],\n      diagnostics: [],\n      listenerFailures: 0,\n      stale: false,\n    });\n  }\n\n  start(): Promise<SessionResult> {\n    if (this.baselinePromise !== undefined) return this.baselinePromise;\n    if (this.disposed) return Promise.resolve(err(this.disposedError()));\n    this.unsubscribe = this.source.subscribe((delta) => this.receive(delta));\n    const promise = this.source\n      .enumerate()\n      .then((result) => {\n        if (!result.ok) {\n          this.markStale();\n          this.publish();\n          return err(runtimeError('asset-package-invalid', '', { reason: result.error.code }));\n        }\n        this.entries.clear();\n        for (const entry of result.value) {\n          const validated = validateRuntimeRow(entry);\n          if (!validated.ok) {\n            this.markStale();\n            this.publish();\n            return err(validated.error);\n          }\n          this.entries.set(key(validated.value.guid), validated.value);\n        }\n        this.started = true;\n        this.stale = false;\n        this.staleGeneration = this.generation;\n        this.diagnostics = [];\n        for (const delta of this.pending) this.fold(delta, false);\n        this.pending = [];\n        this.publish();\n        return ok(this.currentSnapshot);\n      })\n      .catch((cause: unknown) => {\n        this.markStale();\n        this.addDiagnostic('catalog-degraded-rows', 'Catalog enumeration must resolve a Result');\n        this.publish();\n        return err(\n          runtimeError('asset-package-invalid', '', {\n            reason: cause instanceof Error ? cause.message : String(cause),\n          }),\n        );\n      });\n    this.baselinePromise = promise;\n    void promise.then(\n      (result) => {\n        if (!result.ok) this.baselinePromise = undefined;\n      },\n      () => {\n        this.baselinePromise = undefined;\n      },\n    );\n    return promise;\n  }\n\n  reconcile(): Promise<SessionResult> {\n    if (this.disposed) return Promise.resolve(err(this.disposedError()));\n    if (this.reconcilePromise !== undefined) return this.reconcilePromise;\n    this.unsubscribe?.();\n    this.unsubscribe = undefined;\n    this.started = false;\n    this.pending = [];\n    this.baselinePromise = undefined;\n    this.epoch += 1;\n    const promise = this.start();\n    this.reconcilePromise = promise;\n    void promise.then(\n      () => {\n        if (this.reconcilePromise === promise) this.reconcilePromise = undefined;\n      },\n      () => {\n        if (this.reconcilePromise === promise) this.reconcilePromise = undefined;\n      },\n    );\n    return promise;\n  }\n\n  current(guid: string): RuntimeCatalogRow | undefined {\n    return this.entries.get(key(guid));\n  }\n\n  snapshot(): CatalogSessionSnapshot {\n    return this.currentSnapshot;\n  }\n\n  discontinuity(): AssetLoadError | undefined {\n    if (!this.stale) return undefined;\n    return {\n      code: 'catalog-discontinuous',\n      expected: 'an ordered, authoritative catalog revision window',\n      hint: 'reconcile the Catalog source and retry the current publication',\n      detail: {\n        scopeId: this.scopeId,\n        expectedGeneration: this.generation,\n        actualGeneration: this.staleGeneration,\n      },\n    };\n  }\n\n  subscribe(listener: SessionListener): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    this.unsubscribe?.();\n    this.unsubscribe = undefined;\n    this.pending = [];\n    this.listeners.clear();\n  }\n\n  private receive(delta: CatalogDelta): void {\n    if (this.disposed) return;\n    if (!this.started) {\n      this.pending.push(delta);\n      return;\n    }\n    this.fold(delta, true);\n  }\n\n  private fold(delta: CatalogDelta, publish: boolean): void {\n    if (\n      (delta.scopeId !== undefined && delta.scopeId !== this.scopeId) ||\n      (delta.generation !== undefined && delta.generation !== this.generation)\n    ) {\n      this.markStale(delta.generation);\n      this.addDiagnostic('catalog-scope-mismatch', 'delta scope does not match the session');\n      if (publish) this.publish();\n      return;\n    }\n    if (delta.authority === 'degraded') {\n      this.markStale(delta.generation);\n      this.addDiagnostic('catalog-degraded-rows', 'degraded rows are not identity-bearing');\n      if (publish) this.publish();\n      return;\n    }\n    if (delta.revisions !== undefined) {\n      const baseline = delta.revisions.baseline;\n      const current = delta.revisions.current;\n      const valid =\n        baseline.length === current.length &&\n        current.every((point) => {\n          const prior = baseline.find((item) => item.rootId === point.rootId);\n          return prior !== undefined && point.revision === prior.revision + 1;\n        });\n      if (!valid) {\n        this.markStale(delta.generation);\n        this.addDiagnostic('catalog-gap', 'delta revision window is not contiguous');\n        if (publish) this.publish();\n        return;\n      }\n    }\n    let changed = false;\n    for (const entry of [...delta.added, ...delta.changed]) {\n      const validated = validateRuntimeRow(entry);\n      if (!validated.ok) {\n        this.markStale(delta.generation);\n        this.addDiagnostic('catalog-degraded-rows', 'delta contains an invalid runtime row');\n        if (publish) this.publish();\n        return;\n      }\n      const entryKey = key(validated.value.guid);\n      const prior = this.entries.get(entryKey);\n      if (prior === undefined || !sameEntry(prior, validated.value)) {\n        this.entries.set(entryKey, validated.value);\n        this.changed.add(entryKey);\n        changed = true;\n        if (validated.value.revision !== undefined) this.revision = validated.value.revision;\n      }\n    }\n    for (const guid of delta.removed) {\n      const entryKey = key(guid);\n      if (this.entries.delete(entryKey)) {\n        this.removed.add(entryKey);\n        changed = true;\n      }\n    }\n    if (changed) this.epoch += 1;\n    if (publish) this.publish();\n  }\n\n  private addDiagnostic(code: CatalogDiagnostic['code'], expected: string): void {\n    if (this.diagnostics.some((diagnostic) => diagnostic.code === code)) return;\n    this.diagnostics.push({\n      code,\n      severity: 'blocking',\n      expected,\n      hint: 'reconcile the Catalog before loading the affected publication',\n      authority: 'catalog',\n    });\n  }\n\n  private markStale(actualGeneration = this.generation): void {\n    this.stale = true;\n    this.staleGeneration = actualGeneration;\n    this.epoch += 1;\n  }\n\n  private publish(): void {\n    this.currentSnapshot = freezeSnapshot({\n      scopeId: this.scopeId,\n      generation: this.generation,\n      epoch: this.epoch,\n      ...(this.revision === undefined ? {} : { revision: this.revision }),\n      entries: [...this.entries.values()].sort((left, right) =>\n        key(left.guid).localeCompare(key(right.guid)),\n      ),\n      changed: [...this.changed].sort(),\n      removed: [...this.removed].sort(),\n      diagnostics: this.diagnostics,\n      listenerFailures: this.listenerFailures,\n      stale: this.stale,\n    });\n    this.changed.clear();\n    this.removed.clear();\n    for (const listener of [...this.listeners]) {\n      try {\n        listener(this.currentSnapshot);\n      } catch {\n        this.listenerFailures = Math.min(1024, this.listenerFailures + 1);\n        this.currentSnapshot = freezeSnapshot({\n          ...this.currentSnapshot,\n          listenerFailures: this.listenerFailures,\n        });\n      }\n    }\n  }\n\n  private disposedError(): AssetLoadError {\n    return runtimeError('asset-runtime-disposed', '', { scopeId: this.scopeId });\n  }\n}\n","import type {\n  Asset,\n  AssetArtifactReader,\n  AssetDecoder,\n  AssetDecoderInput,\n  AssetDecoderLease,\n  AssetKind,\n  AssetLoadError,\n  BuiltinAssetKind,\n  BuiltinAssetPayload,\n  Result,\n} from '@forgeax/engine-types';\nimport { err, ok } from '@forgeax/engine-types';\nimport type { CatalogSource } from '../catalog-source.js';\nimport { ArtifactCache } from './artifact-cache.js';\nimport { AssetGraph, type AssetGraphSnapshot } from './asset-graph.js';\nimport { CatalogSession, type CatalogSessionOptions } from './catalog-session.js';\nimport { DecoderRegistry } from './decoder-registry.js';\nimport { freezeRuntimePayload } from './immutable-payload.js';\nimport { PackReader } from './pack-reader.js';\nimport { validateRuntimeRow } from './validate-runtime-row.js';\n\nexport interface AssetRegistryOptions extends CatalogSessionOptions {\n  readonly catalog: CatalogSource;\n  readonly fetcher?: typeof globalThis.fetch;\n  readonly maxConcurrentReads?: number;\n}\n\nexport interface AssetLoadOptions {\n  readonly signal?: AbortSignal;\n}\n\nexport type AssetRegistrySnapshot = AssetGraphSnapshot;\n\nexport type AssetRegistrySnapshotCounters = AssetRegistrySnapshot['counters'];\n\nexport interface AssetRegistry {\n  installDecoder<P, K extends string>(\n    kind: AssetKind<P, K>,\n    decoder: AssetDecoder<P>,\n  ): AssetDecoderLease;\n  load<K extends BuiltinAssetKind>(\n    guid: string,\n    kind: K,\n    options?: AssetLoadOptions,\n  ): Promise<Result<BuiltinAssetPayload<K>, AssetLoadError>>;\n  load<P, K extends string>(\n    guid: string,\n    kind: AssetKind<P, K>,\n    options?: AssetLoadOptions,\n  ): Promise<Result<P, AssetLoadError>>;\n  snapshot(): AssetRegistrySnapshot;\n  subscribe(listener: (snapshot: AssetRegistrySnapshot) => void): () => void;\n  dispose(): void;\n}\n\n/** Internal render projection; the root Registry keeps only its five actions. */\nexport interface AssetRegistryResolver {\n  readonly epoch: number;\n  lookup<T extends Asset>(guid: string): T | undefined;\n  guidOf(asset: Asset): string | undefined;\n}\n\nconst REGISTRY_RESOLVER = Symbol.for('forgeax.assets-runtime.registry-resolver');\ntype RegistryWithResolver = AssetRegistry & {\n  [REGISTRY_RESOLVER]?: AssetRegistryResolver;\n};\n\nexport function getAssetRegistryResolver(registry: AssetRegistry): AssetRegistryResolver {\n  const resolver = (registry as RegistryWithResolver)[REGISTRY_RESOLVER];\n  if (resolver === undefined) {\n    throw new TypeError('AssetRegistry resolver is not owned by this asset runtime');\n  }\n  return resolver;\n}\n\nfunction missing(guid: string): AssetLoadError {\n  return {\n    code: 'asset-not-found',\n    expected: `the current Catalog to contain GUID \"${guid}\"`,\n    hint: 'inspect the producer Catalog and rebuild the missing publication',\n    detail: { guid },\n  };\n}\n\nfunction mismatch(guid: string, expectedKind: string, actualKind: string): AssetLoadError {\n  return {\n    code: 'asset-kind-mismatch',\n    expected: `Catalog kind \"${actualKind}\" to match \"${expectedKind}\"`,\n    hint: 'pass the Catalog kind or the matching custom AssetKind token',\n    detail: { guid, expectedKind, actualKind },\n  };\n}\n\nfunction artifactError(guid: string, reason: string): AssetLoadError {\n  return {\n    code: 'asset-integrity-failed',\n    expected: 'the verified artifact byte length and digest',\n    hint: 'verify the artifact digest and recook the Pack',\n    detail: {\n      guid,\n      artifactKey: reason,\n      expectedDigest: 'descriptor integrity',\n      actualDigest: reason,\n    },\n  };\n}\n\nconst ASSET_GUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n\nfunction invalidGuid(guid: string): AssetLoadError {\n  return {\n    code: 'asset-guid-invalid',\n    expected: 'a 36-character dash-form asset GUID',\n    hint: 'pass the producer GUID from the current Catalog row',\n    detail: { guid },\n  };\n}\n\nexport function createAssetRegistry(options: AssetRegistryOptions): AssetRegistry {\n  const session = new CatalogSession(options.catalog, options);\n  const reader = new PackReader(options.fetcher === undefined ? {} : { fetcher: options.fetcher });\n  const cache = new ArtifactCache();\n  const decoders = new DecoderRegistry(\n    options.scopeId === undefined ? {} : { scopeId: options.scopeId },\n  );\n  const graph = new AssetGraph<{ readonly value: unknown; readonly refs: readonly string[] }>({\n    ...(options.maxConcurrentReads === undefined\n      ? {}\n      : { maxConcurrentReads: options.maxConcurrentReads }),\n    read: async (guid, signal) => {\n      const row = session.current(guid);\n      if (row === undefined) return err(missing(guid));\n      const validated = validateRuntimeRow(row);\n      if (!validated.ok) return validated;\n      const publication = validated.value.publication;\n      const tuple = {\n        scopeId: session.snapshot().scopeId,\n        generation: publication.generation,\n        digest: publication.digest,\n        outputSetDigest: publication.outputSetDigest,\n      };\n      const pack = await reader.read(row.packageUrl, tuple, signal);\n      if (!pack.ok) return pack;\n      const envelope = pack.value.assets.find(\n        (asset) => asset.guid.toLowerCase() === guid.toLowerCase(),\n      );\n      if (envelope === undefined) return err(missing(guid));\n      const artifacts: AssetArtifactReader = {\n        read: (descriptor) => {\n          const integrity = descriptor.integrity;\n          if (integrity === undefined)\n            return Promise.resolve(err(artifactError(guid, descriptor.path)));\n          const key = `${tuple.scopeId}:${tuple.generation}:${tuple.outputSetDigest}:${integrity.digest}`;\n          return cache.read(key, async () => {\n            const url = resolveArtifactUrl(row.packageUrl, descriptor.path);\n            let response: Response;\n            try {\n              response = await (options.fetcher ?? globalThis.fetch)(url, { signal });\n            } catch {\n              return err(artifactError(guid, descriptor.path));\n            }\n            if (!response.ok) return err(artifactError(guid, descriptor.path));\n            const bytes = new Uint8Array(await response.arrayBuffer());\n            if (descriptor.byteLength === undefined || bytes.byteLength !== descriptor.byteLength) {\n              return err(artifactError(guid, descriptor.path));\n            }\n            const actualDigest = await sha256(bytes);\n            if (actualDigest !== descriptor.integrity?.digest.toLowerCase()) {\n              return err(artifactError(guid, `${descriptor.path}:${actualDigest}`));\n            }\n            return ok(bytes);\n          });\n        },\n      };\n      const input: AssetDecoderInput<unknown> = { envelope, artifacts, signal };\n      const decoded = await decoders.loadByKind(envelope.kind, input);\n      if (!decoded.ok) return decoded;\n      return ok({ value: freezeRuntimePayload(decoded.value), refs: envelope.refs });\n    },\n  });\n\n  let catalogEpoch = session.snapshot().epoch;\n  const unsubscribeCatalog = session.subscribe((snapshot) => {\n    if (snapshot.epoch === catalogEpoch) return;\n    catalogEpoch = snapshot.epoch;\n    graph.invalidateForCatalogChange(\n      snapshot.stale ? undefined : [...snapshot.changed, ...snapshot.removed],\n    );\n  });\n\n  const registry: AssetRegistry = {\n    installDecoder: (kind, decoder) => decoders.install(kind, decoder),\n    load: (async (\n      guid: string,\n      kind: BuiltinAssetKind | AssetKind<unknown, string>,\n      loadOptions: AssetLoadOptions = {},\n    ): Promise<Result<unknown, AssetLoadError>> => {\n      if (!ASSET_GUID_PATTERN.test(guid)) return err(invalidGuid(guid));\n      const expectedKind = typeof kind === 'string' ? kind : kind.kind;\n      const started = await session.start();\n      if (!started.ok) return err(started.error);\n      if (session.snapshot().stale) {\n        const reconciled = await session.reconcile();\n        if (!reconciled.ok) return err(reconciled.error);\n        const discontinuity = session.discontinuity();\n        if (discontinuity !== undefined) return err(discontinuity);\n      }\n      const row = session.current(guid);\n      if (row === undefined) return err(missing(guid));\n      if (row.kind !== expectedKind) return err(mismatch(guid, expectedKind, row.kind));\n      const result = await graph.load(guid, loadOptions.signal);\n      return result.ok ? ok(result.value.value) : result;\n    }) as AssetRegistry['load'],\n    snapshot: () => graph.snapshot(),\n    subscribe: (listener) => graph.subscribe(listener),\n    dispose: () => {\n      graph.dispose();\n      unsubscribeCatalog();\n      decoders.dispose();\n      cache.clear();\n      session.dispose();\n    },\n  };\n  const resolver: AssetRegistryResolver = {\n    get epoch() {\n      return graph.snapshot().epoch;\n    },\n    lookup: <T extends Asset>(guid: string) => graph.lookup(guid) as T | undefined,\n    guidOf: (asset: Asset) => graph.guidOf(asset),\n  };\n  Object.defineProperty(registry, REGISTRY_RESOLVER, {\n    value: resolver,\n    enumerable: false,\n  });\n  return registry;\n}\n\nasync function sha256(bytes: Uint8Array): Promise<string> {\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', bytes as unknown as BufferSource);\n  return `sha256:${Array.from(new Uint8Array(digest), (byte) =>\n    byte.toString(16).padStart(2, '0'),\n  ).join('')}`;\n}\n\nfunction resolveArtifactUrl(packageUrl: string, path: string): string {\n  const separator = packageUrl.lastIndexOf('/');\n  const packageDirectory = separator < 0 ? '' : packageUrl.slice(0, separator + 1);\n  try {\n    return new URL(path, packageDirectory).toString();\n  } catch {\n    return `${packageDirectory}${path.replace(/^\\//, '')}`;\n  }\n}\n"]}

package/dist/loader-registry.d.ts

@@ -0,0 +1,63 @@
+import type { ArtifactDescriptor, LoadContext, Loader } from '@forgeax/engine-types';
+export interface PackArtifactInput {
+    readonly descriptor: ArtifactDescriptor;
+    readonly bytes: Uint8Array;
+}
+export interface PackLoaderInput {
+    readonly guid: string;
+    readonly kind: string;
+    readonly payload: Record<string, unknown>;
+    readonly refs: readonly string[];
+    readonly artifacts: Readonly<Record<string, PackArtifactInput>>;
+}
+export interface PackLoader {
+    readonly kind: string;
+    load(input: PackLoaderInput, ctx: LoadContext): unknown;
+}
+export type PackLoadResult = {
+    readonly ok: true;
+    readonly value: unknown;
+} | {
+    readonly ok: false;
+    readonly error: unknown;
+};
+/**
+ * Injectable `asset.kind` -> {@link Loader} table held by `AssetRegistry`.
+ *
+ * @example Wire + dispatch (host side)
+ * ```ts
+ * import { LoaderRegistry, wireDefaultLoaders } from '@forgeax/engine-assets-runtime';
+ * const loaders = new LoaderRegistry();
+ * wireDefaultLoaders(loaders);
+ * const meshLoader = loaders.get('mesh'); // Loader | undefined
+ * ```
+ */
+export declare class LoaderRegistry {
+    private readonly loaders;
+    private readonly packLoaders;
+    /**
+     * Register a loader for its `loader.kind`. Fail-fast on a malformed loader
+     * (charter P3); rejects a repeated kind so the canonical owner cannot be replaced.
+     *
+     * @param loader the `{ kind, load }` object to register.
+     * @throws TypeError when `loader.kind` is empty or `loader.load` is not a
+     *   function — a wire-time misconfiguration the host must fix.
+     */
+    register(loader: Loader<unknown>): () => void;
+    registerPackLoader(loader: PackLoader): () => void;
+    loadPack(input: PackLoaderInput, ctx: LoadContext): Promise<PackLoadResult>;
+    /**
+     * Look up the loader registered for `kind`. Returns `undefined` when no
+     * loader is wired — the `AssetRegistry` consumer maps that to a structured
+     * `AssetError(code='loader-not-registered')` with the registered kinds in
+     * `.detail` (charter P3).
+     */
+    get(kind: string): Loader<unknown> | undefined;
+    /**
+     * The kinds currently wired, in insertion order. Fed into the
+     * `loader-not-registered` error `.detail.registeredKinds` so AI users see
+     * exactly what is injectable.
+     */
+    registeredKinds(): readonly string[];
+}
+//# sourceMappingURL=loader-registry.d.ts.map

package/dist/loader-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader-registry.d.ts","sourceRoot":"","sources":["../src/loader-registry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;CACzD;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IAIzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAE7D;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAI;IAoB7C,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IAoB5C,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IAqBjF;;;;;OAKG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS;IAI9C;;;;OAIG;IACH,eAAe,IAAI,SAAS,MAAM,EAAE;CAGrC"}

package/dist/loaders/inline-pack.d.ts

@@ -0,0 +1,72 @@
+import type { Loader } from '@forgeax/engine-types';
+/** mesh loader — Float32Array / Uint16Array | Uint32Array normalisation -> MeshAsset.
+ *
+ * feat-20260611: skinIndex (Uint16Array) and skinWeight (Float32Array) accept
+ * both their native typed-array shape (in-memory: dawn smoke / direct
+ * `register` test) AND `number[]` (post-`JSON.stringify` shape produced by the
+ * dev-server / build-mode pack-body round-trip — `JSON.stringify(pack) -> fetch
+ * -> JSON.parse` flattens every typed array to a plain Array). Same dual
+ * contract `skeletonLoader` / `animationClipLoader` already honour (PR #350);
+ * without the array arm, every Fox.glb / Khronos skinned glTF surfaces as
+ * `asset-parse-failed` on the browser path while dawn smoke stays green.
+ */
+export declare const meshLoader: Loader;
+/** scene loader — delegates to parseScenePayload; routes structured ref error via ctx. */
+export declare const sceneLoader: Loader;
+/** material loader — passes + values + serialized parent GUID -> parentGuid. */
+export declare const materialLoader: Loader;
+/** sampler loader — preserve the serialised SamplerAsset descriptor. */
+export declare const samplerLoader: Loader;
+/** skeleton loader — inverseBindMatrices stride validation.
+ *
+ * bug-20260611: accept both `Float32Array` (in-memory: dawn smoke / direct
+ * `register` test) AND `number[]` (post-`JSON.stringify` shape: `normaliseForPack`
+ * in @forgeax/engine-import flattens every typed array to a plain Array so
+ * `JSON.stringify(pack)` survives the dev-server / build-mode round-trip --
+ * the same dual contract `meshLoader` already honours). Without the array arm
+ * the .pack.json -> fetch -> JSON.parse path lands a plain object whose
+ * `instanceof Float32Array` check fails, surfacing as `asset-parse-failed`
+ * for any glTF carrying a Skin (e.g. Khronos Fox.glb).
+ */
+export declare const skeletonLoader: Loader;
+/** skin loader — skeletonGuid + jointPaths validation. */
+export declare const skinLoader: Loader;
+/** animation-clip loader — channels / sampler validation.
+ *
+ * bug-20260611: sampler.input / sampler.output accept both `Float32Array`
+ * (in-memory) and `number[]` (post-`JSON.stringify` shape produced by
+ * `normaliseForPack`). Same dual contract as `skeletonLoader` /
+ * `meshLoader`; without it the dev `.pack.json` round-trip surfaces every
+ * skinned-with-animation glTF as `asset-parse-failed`.
+ */
+export declare const animationClipLoader: Loader;
+/** animation-graph loader — pack payload -> AnimationGraph POD.
+ *
+ * feat-20260713-animation-state-machine-plugin M4 / w30 (plan D-4 landing (3)):
+ * the inverse of `serializeAnimationGraph` (runtime). Each Clip leaf's `clip`
+ * field arrives as a `refs[]` index (small int); the loader resolves it back to
+ * the GUID string verbatim, leaving GUID -> handle re-resolution to the ECS/use
+ * time (the same "GUID at load, handle at use" contract materialLoader honours
+ * for parentGuid / values texture fields, asset-registry D-19). Blend/Add
+ * node references + `root` are intra-graph node indices, validated against the
+ * node count. A malformed payload (out-of-range refs / node index, bad node
+ * shape, non-finite weight) returns `undefined` so the load-by-guid path
+ * surfaces the existing `asset-parse-failed` error code (AC-14).
+ *
+ * OOS-7: reconstructs only an engine-authored graph's topology; no DCC-import
+ * metadata is consumed.
+ */
+export declare const animationGraphLoader: Loader;
+/** audio loader -- restore the durable descriptor; host decode stays elsewhere. */
+export declare const audioLoader: Loader;
+/** particle loader -- restore the complete cooked program without a GPU device. */
+export declare const particleEffectLoader: Loader;
+export { renderPipelineLoader, tilesetLoader } from './pack-artifact';
+/**
+ * The eight inline pack-payload loaders, in the historical `if`-chain order
+ * (the animation-graph loader, feat-20260713 M4 / w30, appends after the clip
+ * loader). `wireDefaultLoaders` (w5) registers these plus the texture / font /
+ * equirect loaders (w6) and the audio placeholder (w8).
+ */
+export declare const INLINE_PACK_LOADERS: readonly Loader[];
+//# sourceMappingURL=inline-pack.d.ts.map

package/dist/loaders/inline-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-pack.d.ts","sourceRoot":"","sources":["../../src/loaders/inline-pack.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAWV,MAAM,EAOP,MAAM,uBAAuB,CAAC;AAoB/B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,MA8OxB,CAAC;AAEF,0FAA0F;AAC1F,eAAO,MAAM,WAAW,EAAE,MAazB,CAAC;AAiFF,gFAAgF;AAChF,eAAO,MAAM,cAAc,EAAE,MAsI5B,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,MAiE3B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,MAoB5B,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,MAcxB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,MA0DjC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAgDlC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,WAAW,EAAE,MAqBzB,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,MASlC,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAahD,CAAC"}

package/dist/loaders/mesh-bin.d.ts

@@ -0,0 +1,21 @@
+import { type VertexLayoutProjection } from '@forgeax/engine-geometry';
+import { type Result, type VertexAttributeMap } from '@forgeax/engine-types';
+import { MeshBinAssetError } from '../errors/asset';
+export interface UnpackedMeshBin {
+    readonly version: 4;
+    readonly projection: VertexLayoutProjection;
+    readonly vertices: Float32Array;
+    readonly attributes: VertexAttributeMap;
+    readonly indices?: Uint16Array | Uint32Array;
+    readonly submeshes: ReadonlyArray<Record<string, unknown>>;
+    readonly materialSlots: readonly {
+        readonly slotName: string;
+        readonly sourceKey?: string;
+        readonly defaultMaterialRef?: number;
+    }[];
+    readonly aabb?: Float32Array;
+    readonly morphTargets?: ReadonlyArray<Record<string, Float32Array>>;
+    readonly morphWeights?: Float32Array;
+}
+export declare function unpackMeshBinV4(bytes: Uint8Array, sourceKey: string): Result<UnpackedMeshBin, MeshBinAssetError>;
+//# sourceMappingURL=mesh-bin.d.ts.map

package/dist/loaders/mesh-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-bin.d.ts","sourceRoot":"","sources":["../../src/loaders/mesh-bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAMlC,OAAO,EAAW,KAAK,MAAM,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,aAAa,EAAE,SAAS;QAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACtC,EAAE,CAAC;IACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAmDD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAAC,eAAe,EAAE,iBAAiB,CAAC,CA8N5C"}

package/dist/loaders/pack-artifact.d.ts

@@ -0,0 +1,20 @@
+import type { Loader } from '@forgeax/engine-types';
+export type CodecContextFailure = {
+    readonly code: 'basis-profile-unsupported';
+    readonly detail: {
+        readonly profile: string;
+    };
+} | {
+    readonly code: 'ktx2-color-space-mismatch';
+    readonly detail: {
+        readonly authoredColorSpace: 'srgb' | 'linear';
+        readonly dfdColorSpace: 'srgb' | 'linear' | 'unknown';
+    };
+};
+export declare const textureLoader: Loader;
+export declare const equirectLoader: Loader;
+export declare const fontLoader: Loader;
+export declare const renderPipelineLoader: Loader;
+export declare const tilesetLoader: Loader;
+export declare const PACK_ARTIFACT_LOADERS: readonly Loader[];
+//# sourceMappingURL=pack-artifact.d.ts.map

package/dist/loaders/pack-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-artifact.d.ts","sourceRoot":"","sources":["../../src/loaders/pack-artifact.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAMV,MAAM,EAKP,MAAM,uBAAuB,CAAC;AA+L/B,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,CAAC;QAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;KACvD,CAAC;CACH,CAAC;AAyXN,eAAO,MAAM,aAAa,EAAE,MAI3B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,MAI5B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAIxB,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAkBlC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MA0B3B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAMlD,CAAC"}