@forgeax/engine-assets-runtime 0.0.0-dev.8d955ade1c79

package/dist/internal/artifact-cache.d.ts

@@ -0,0 +1,17 @@
+import type { AssetLoadError, Result } from '@forgeax/engine-types';
+export interface ArtifactCacheSnapshot {
+    readonly entries: number;
+    readonly pending: number;
+    readonly hits: number;
+    readonly misses: number;
+}
+export declare class ArtifactCache {
+    private readonly values;
+    private readonly pending;
+    private hits;
+    private misses;
+    read(contentAddress: string, reader: () => Promise<Result<Uint8Array, AssetLoadError>>): Promise<Result<Uint8Array, AssetLoadError>>;
+    clear(contentAddress?: string): void;
+    snapshot(): ArtifactCacheSnapshot;
+}
+//# sourceMappingURL=artifact-cache.d.ts.map

package/dist/internal/artifact-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-cache.d.ts","sourceRoot":"","sources":["../../src/internal/artifact-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkE;IAC1F,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IAEnB,IAAI,CACF,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,GACxD,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IA4B9C,KAAK,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IAUpC,QAAQ,IAAI,qBAAqB;CAQlC"}

package/dist/internal/asset-graph.d.ts

@@ -0,0 +1,70 @@
+import type { AssetLoadError, Result } from '@forgeax/engine-types';
+export interface AssetGraphValue<P> {
+    readonly value: P;
+    readonly refs: readonly string[];
+}
+export interface AssetGraphOptions<P extends {
+    readonly value: unknown;
+    readonly refs: readonly string[];
+}> {
+    readonly read: (guid: string, signal: AbortSignal) => Promise<Result<P, AssetLoadError>>;
+    readonly maxConcurrentReads?: number;
+}
+export interface AssetGraphCounters {
+    readonly loads: number;
+    readonly cacheHits: number;
+    readonly readErrors: number;
+    readonly noChange: number;
+    readonly listenerFailures: number;
+}
+export interface AssetGraphSnapshot {
+    readonly epoch: number;
+    readonly ready: readonly string[];
+    readonly pending: number;
+    readonly resources: number;
+    readonly sccs: readonly (readonly string[])[];
+    readonly counters: AssetGraphCounters;
+}
+type GraphResult<P> = Result<P, AssetLoadError>;
+type GraphListener = (snapshot: AssetGraphSnapshot) => void;
+export declare class AssetGraph<P extends {
+    readonly value: unknown;
+    readonly refs: readonly string[];
+}> {
+    private readonly read;
+    private readonly limit;
+    private readonly ready;
+    private readonly forward;
+    private readonly reverse;
+    private readonly reads;
+    private readonly requests;
+    private readonly listeners;
+    private readonly sccs;
+    private activeReads;
+    private readWaiters;
+    private disposed;
+    private epoch;
+    private counters;
+    private currentSnapshot;
+    constructor(options: AssetGraphOptions<P>);
+    load(guid: string, signal?: AbortSignal): Promise<GraphResult<P>>;
+    invalidate(guid: string): readonly string[];
+    invalidateForCatalogChange(guids?: readonly string[]): void;
+    subscribe(listener: GraphListener): () => void;
+    snapshot(): AssetGraphSnapshot;
+    lookup(guid: string): P['value'] | undefined;
+    guidOf(value: P['value']): string | undefined;
+    dispose(): void;
+    private loadClosure;
+    private visit;
+    private readOnce;
+    private withPermit;
+    private link;
+    private collectAffected;
+    private drop;
+    private promote;
+    private recordScc;
+    private publish;
+}
+export {};
+//# sourceMappingURL=asset-graph.d.ts.map

package/dist/internal/asset-graph.d.ts.map

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

package/dist/internal/catalog-session.d.ts

@@ -0,0 +1,60 @@
+import type { CatalogDiagnostic, ResourceRevision } from '@forgeax/engine-types';
+import { type AssetLoadError, type Result } from '@forgeax/engine-types';
+import type { CatalogSource } from '../catalog-source.js';
+import { type RuntimeCatalogRow } from './validate-runtime-row.js';
+export interface CatalogSessionOptions {
+    readonly scopeId?: string;
+    readonly generation?: number;
+}
+export interface CatalogSessionSnapshot {
+    readonly scopeId: string;
+    readonly generation: number;
+    readonly epoch: number;
+    readonly revision?: ResourceRevision;
+    readonly entries: readonly RuntimeCatalogRow[];
+    readonly changed: readonly string[];
+    readonly removed: readonly string[];
+    readonly diagnostics: readonly CatalogDiagnostic[];
+    readonly listenerFailures: number;
+    readonly stale: boolean;
+}
+type SessionResult = Result<CatalogSessionSnapshot, AssetLoadError>;
+type SessionListener = (snapshot: CatalogSessionSnapshot) => void;
+export declare class CatalogSession {
+    private readonly source;
+    private readonly scopeId;
+    private readonly generation;
+    private readonly entries;
+    private readonly listeners;
+    private unsubscribe;
+    private baselinePromise;
+    private reconcilePromise;
+    private pending;
+    private currentSnapshot;
+    private revision;
+    private diagnostics;
+    private listenerFailures;
+    private changed;
+    private removed;
+    private epoch;
+    private stale;
+    private staleGeneration;
+    private started;
+    private disposed;
+    constructor(source: CatalogSource, options?: CatalogSessionOptions);
+    start(): Promise<SessionResult>;
+    reconcile(): Promise<SessionResult>;
+    current(guid: string): RuntimeCatalogRow | undefined;
+    snapshot(): CatalogSessionSnapshot;
+    discontinuity(): AssetLoadError | undefined;
+    subscribe(listener: SessionListener): () => void;
+    dispose(): void;
+    private receive;
+    private fold;
+    private addDiagnostic;
+    private markStale;
+    private publish;
+    private disposedError;
+}
+export {};
+//# sourceMappingURL=catalog-session.d.ts.map

package/dist/internal/catalog-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-session.d.ts","sourceRoot":"","sources":["../../src/internal/catalog-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EAEjB,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,cAAc,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,KAAK,iBAAiB,EAAsB,MAAM,2BAA2B,CAAC;AAEvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,KAAK,aAAa,GAAG,MAAM,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC;AACpE,KAAK,eAAe,GAAG,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;AA6ClE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,eAAe,CAAqC;IAC5D,OAAO,CAAC,gBAAgB,CAAqC;IAC7D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,aAAa,EAAE,OAAO,GAAE,qBAA0B;IAiBtE,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAqD/B,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAsBnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIpD,QAAQ,IAAI,sBAAsB;IAIlC,aAAa,IAAI,cAAc,GAAG,SAAS;IAc3C,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAKhD,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,IAAI;IA6DZ,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,OAAO;IA8Bf,OAAO,CAAC,aAAa;CAGtB"}

package/dist/internal/decoder-registry.d.ts

@@ -0,0 +1,19 @@
+import type { AssetDecoder, AssetDecoderInput, AssetDecoderLease, AssetKind, AssetLoadError, Result } from '@forgeax/engine-types';
+export interface DecoderRegistryOptions {
+    readonly scopeId?: string;
+}
+export declare class DecoderRegistry {
+    private readonly dispatch;
+    private readonly scopeId;
+    private disposed;
+    constructor(options?: DecoderRegistryOptions);
+    install<P, K extends string>(kind: AssetKind<P, K>, decoder: AssetDecoder<P>): AssetDecoderLease;
+    private createLease;
+    has<P, K extends string>(kind: AssetKind<P, K>): boolean;
+    load<P, K extends string>(kind: AssetKind<P, K>, input: AssetDecoderInput<P>): Promise<Result<P, AssetLoadError>>;
+    loadByKind(kind: string, input: AssetDecoderInput<unknown>): Promise<Result<unknown, AssetLoadError>>;
+    decode<P, K extends string>(kind: AssetKind<P, K>, input: AssetDecoderInput<P>): Promise<Result<P, AssetLoadError>>;
+    private decodeEntry;
+    dispose(): void;
+}
+//# sourceMappingURL=decoder-registry.d.ts.map

package/dist/internal/decoder-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-registry.d.ts","sourceRoot":"","sources":["../../src/internal/decoder-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,MAAM,EACP,MAAM,uBAAuB,CAAC;AAW/B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,sBAA2B;IAIhD,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,iBAAiB;IAuBhG,OAAO,CAAC,WAAW;IAenB,GAAG,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO;IAIxD,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EACtB,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAIrC,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAgBrC,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAC9B,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,KAAK,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAevB,WAAW;IAyBzB,OAAO,IAAI,IAAI;CAKhB"}

package/dist/internal/immutable-payload.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Decoder output becomes an owner fact at this boundary. Freeze the ordinary
+ * POD graph so a caller cannot mutate the cached payload between loads.
+ * Typed-array storage is deliberately left as an opaque byte/vector carrier:
+ * JavaScript cannot freeze a non-empty typed array without changing its public
+ * engine type, so owners must treat those carriers as read-only by contract.
+ */
+export declare function freezeRuntimePayload<T>(value: T): T;
+//# sourceMappingURL=immutable-payload.d.ts.map

package/dist/internal/immutable-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-payload.d.ts","sourceRoot":"","sources":["../../src/internal/immutable-payload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAGnD"}

package/dist/internal/load-asset.d.ts

@@ -0,0 +1,31 @@
+import type { Asset, AssetDecoder, AssetDecoderLease, AssetKind, AssetLoadError, BuiltinAssetKind, BuiltinAssetPayload, Result } from '@forgeax/engine-types';
+import type { CatalogSource } from '../catalog-source.js';
+import { type AssetGraphSnapshot } from './asset-graph.js';
+import { type CatalogSessionOptions } from './catalog-session.js';
+export interface AssetRegistryOptions extends CatalogSessionOptions {
+    readonly catalog: CatalogSource;
+    readonly fetcher?: typeof globalThis.fetch;
+    readonly maxConcurrentReads?: number;
+}
+export interface AssetLoadOptions {
+    readonly signal?: AbortSignal;
+}
+export type AssetRegistrySnapshot = AssetGraphSnapshot;
+export type AssetRegistrySnapshotCounters = AssetRegistrySnapshot['counters'];
+export interface AssetRegistry {
+    installDecoder<P, K extends string>(kind: AssetKind<P, K>, decoder: AssetDecoder<P>): AssetDecoderLease;
+    load<K extends BuiltinAssetKind>(guid: string, kind: K, options?: AssetLoadOptions): Promise<Result<BuiltinAssetPayload<K>, AssetLoadError>>;
+    load<P, K extends string>(guid: string, kind: AssetKind<P, K>, options?: AssetLoadOptions): Promise<Result<P, AssetLoadError>>;
+    snapshot(): AssetRegistrySnapshot;
+    subscribe(listener: (snapshot: AssetRegistrySnapshot) => void): () => void;
+    dispose(): void;
+}
+/** Internal render projection; the root Registry keeps only its five actions. */
+export interface AssetRegistryResolver {
+    readonly epoch: number;
+    lookup<T extends Asset>(guid: string): T | undefined;
+    guidOf(asset: Asset): string | undefined;
+}
+export declare function getAssetRegistryResolver(registry: AssetRegistry): AssetRegistryResolver;
+export declare function createAssetRegistry(options: AssetRegistryOptions): AssetRegistry;
+//# sourceMappingURL=load-asset.d.ts.map

package/dist/internal/load-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-asset.d.ts","sourceRoot":"","sources":["../../src/internal/load-asset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EAEL,YAAY,EAEZ,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,MAAM,EACP,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAMlF,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEvD,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAChC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,iBAAiB,CAAC;IACrB,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IACtC,QAAQ,IAAI,qBAAqB,CAAC;IAClC,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACrD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;CAC1C;AAOD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG,qBAAqB,CAMvF;AA6CD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAqHhF"}

package/dist/internal/pack-reader.d.ts

@@ -0,0 +1,18 @@
+import type { AssetLoadError, AssetPublicationTuple, PackV2, Result } from '@forgeax/engine-types';
+export interface PackReaderOptions {
+    readonly fetcher?: typeof globalThis.fetch;
+}
+export type VerifiedPack = PackV2<unknown>;
+export declare class PackReader {
+    private readonly fetcher;
+    private readonly verified;
+    private readonly pending;
+    constructor(options?: PackReaderOptions);
+    read(packageUrl: string, expected: AssetPublicationTuple, signal: AbortSignal): Promise<Result<VerifiedPack, AssetLoadError>>;
+    private fetchAndVerify;
+    private key;
+    verify(value: unknown, expected: AssetPublicationTuple): Result<VerifiedPack, AssetLoadError>;
+    private validArtifact;
+    private cancelled;
+}
+//# sourceMappingURL=pack-reader.d.ts.map

package/dist/internal/pack-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-reader.d.ts","sourceRoot":"","sources":["../../src/internal/pack-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,qBAAqB,EACrB,MAAM,EACN,MAAM,EACP,MAAM,uBAAuB,CAAC;AAG/B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AA4B3C,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoE;gBAEhF,OAAO,GAAE,iBAAsB;IAOrC,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,qBAAqB,EAC/B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;YAelC,cAAc;IAmC5B,OAAO,CAAC,GAAG;IAIX,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC;IA0C7F,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,SAAS;CAQlB"}

package/dist/internal/validate-runtime-row.d.ts

@@ -0,0 +1,7 @@
+import type { CatalogEntry } from '@forgeax/engine-types';
+import { type AssetLoadError, type Result } from '@forgeax/engine-types';
+export interface RuntimeCatalogRow extends CatalogEntry {
+    readonly publication: NonNullable<CatalogEntry['publication']>;
+}
+export declare function validateRuntimeRow(row: CatalogEntry): Result<RuntimeCatalogRow, AssetLoadError>;
+//# sourceMappingURL=validate-runtime-row.d.ts.map

package/dist/internal/validate-runtime-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-runtime-row.d.ts","sourceRoot":"","sources":["../../src/internal/validate-runtime-row.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,KAAK,cAAc,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC;CAChE;AAWD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAkC/F"}

package/dist/internal.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,329 @@
+import { err, ok } from '@forgeax/engine-types';
+
+// 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];
+  if (resolver === void 0) {
+    throw new TypeError("AssetRegistry resolver is not owned by this asset runtime");
+  }
+  return resolver;
+}
+
+export { CatalogSession, getAssetRegistryResolver };
+//# sourceMappingURL=internal.mjs.map
+//# sourceMappingURL=internal.mjs.map