manager-stream

Purpose

Free-function implementation of PackedResourceManager.loadStream, factored out of manager.ts so the class stays under the CLAUDE.md §3 300-line hard cap. The function drives the loader's streaming iterator, inserts each decoded entry into the manager's cache, and emits a load event before yielding the entry to the caller — so streaming consumers see exactly the same cache-priming behaviour as batch consumers.

Features

Threads the manager's default MessageResolver and feature-flag provider through every loader call via buildLoaderOptions.
Inserts each yielded entry into the cache before yielding so a consumer that calls manager.load(inputUrl) immediately after receiving an entry hits the cache (no second fetch).
AbortSignal propagation is honoured at entry time (via manager._checkAbortedExt) and re-honoured by the underlying loader.loadStream iterator at each yield.
Per-entry options (StreamLoadEntry.options) override the manager- level options, so a single stream can mix verifyKeys, keyrings, and mime allow-lists.

Usage: Basic Example

import { createPackedResourceManager } from "@suaveplan/packer-browser";

const manager = createPackedResourceManager();
for await (const entry of manager.loadStream([
    "/asset-a.packed",
    "/asset-b.packed",
])) {
    console.info("decoded", entry.inputUrl, "→", entry.url);
}

Usage: Advanced Example

import {
    createPackedResourceManager,
    MemoryKeyring,
} from "@suaveplan/packer-browser";

const manager = createPackedResourceManager();
const keyring = new MemoryKeyring({ "v1": new Uint8Array(32).fill(7) });
const ac = new AbortController();

for await (const entry of manager.loadStream(
    [
        { url: "/plain.packed" },
        { url: "/encrypted.packed", options: { keyring } },
    ],
    { signal: ac.signal }
)) {
    if (entry.inputUrl === "/plain.packed") ac.abort();
    process(entry);
}

API Reference

managerLoadStream(manager, opts, inputs) — internal entrypoint used by PackedResourceManager.loadStream. Not part of the package barrel.
ManagerStreamedEntry — { url, inputUrl, metadata }.

Implementation Notes

The function takes the inputs array as the trailing parameter so the manager can pass opts early; this keeps the method signature in manager.ts to a single line and avoids type-juggling in the delegation.
_streamInsert, _getDefaultResolver, and _checkAbortedExt on the manager are intentionally _-prefixed: they exist only to give this free function access to the manager's internals without exposing cache/resolver/abort plumbing on the public surface. They are not in the package barrel.
The manager's cacheHit / cacheMiss events are NOT emitted from the streaming path — every streamed entry is, by definition, a fresh load. Consumers that need pre-stream cache lookups should combine cache.has(...) with a batch load.

2.9 KiB Raw Blame History