@n-dx/web 0.1.0

package/dist/viewer/loader.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Data loader for sourcevision viewer.
+ * Fetches and validates .sourcevision/ JSON files.
+ * Supports both server mode (fetch from /data/) and file drop mode.
+ *
+ * Memory-efficient strategies:
+ * - loadModules(): lazy-load data files on demand in parallel
+ * - Selective refresh: only reload files whose mtime changed
+ */
+import type { LoadedData } from "./types.js";
+type DataChangeHandler = (data: LoadedData) => void;
+export declare function getData(): LoadedData;
+export declare function onDataChange(handler: DataChangeHandler): void;
+/** Remove the current data-change handler (for cleanup on unmount). */
+export declare function clearOnChange(): void;
+/**
+ * Lazy-load multiple modules in parallel. Only fetches modules that
+ * are not already loaded. Returns the current data state.
+ */
+export declare function loadModules(keys: Array<keyof LoadedData>): Promise<LoadedData>;
+/** Load data from dropped files */
+export declare function loadFromFiles(files: FileList): Promise<LoadedData>;
+/** Check if we're running in server mode */
+export declare function detectMode(): Promise<"server" | "static">;
+/**
+ * Start polling for data changes (selective refresh — only changed files).
+ * Registers with the centralized polling manager for automatic
+ * suspend/resume based on tab visibility.
+ */
+export declare function startPolling(intervalMs?: number): void;
+/** Stop polling for data changes */
+export declare function stopPolling(): void;
+export {};

package/dist/viewer/loader.js

@@ -0,0 +1,195 @@
+/**
+ * Data loader for sourcevision viewer.
+ * Fetches and validates .sourcevision/ JSON files.
+ * Supports both server mode (fetch from /data/) and file drop mode.
+ *
+ * Memory-efficient strategies:
+ * - loadModules(): lazy-load data files on demand in parallel
+ * - Selective refresh: only reload files whose mtime changed
+ */
+import { validateManifest, validateInventory, validateImports, validateZones, validateComponents, validateCallGraph, } from "./validate.js";
+import { DATA_FILES } from "./external.js";
+import { migrateData } from "./schema-compat.js";
+import { registerPoller, unregisterPoller } from "./polling/polling-manager.js";
+const MODULE_DEFS = [
+    { key: "manifest", file: DATA_FILES.manifest, validate: validateManifest },
+    { key: "inventory", file: DATA_FILES.inventory, validate: validateInventory },
+    { key: "imports", file: DATA_FILES.imports, validate: validateImports },
+    { key: "zones", file: DATA_FILES.zones, validate: validateZones },
+    { key: "components", file: DATA_FILES.components, validate: validateComponents },
+    { key: "callGraph", file: DATA_FILES.callGraph, validate: validateCallGraph },
+];
+/** Map from data filename to its module key, for selective refresh. */
+const FILE_TO_KEY = {};
+for (const mod of MODULE_DEFS) {
+    FILE_TO_KEY[mod.file] = mod.key;
+}
+let currentData = {
+    manifest: null,
+    inventory: null,
+    imports: null,
+    zones: null,
+    components: null,
+    callGraph: null,
+};
+let onChange = null;
+let pollingActive = false;
+let lastMtimes = {};
+export function getData() {
+    return currentData;
+}
+export function onDataChange(handler) {
+    onChange = handler;
+}
+/** Remove the current data-change handler (for cleanup on unmount). */
+export function clearOnChange() {
+    onChange = null;
+}
+function notifyChange() {
+    if (onChange)
+        onChange(currentData);
+}
+/** Fetch, validate, and store a single module. Returns true on success. */
+async function fetchModule(mod) {
+    try {
+        const res = await fetch(`/data/${mod.file}`);
+        if (!res.ok)
+            return false;
+        const raw = await res.json();
+        const migrated = migrateData(mod.key, raw);
+        const result = mod.validate(migrated);
+        if (result.ok) {
+            currentData[mod.key] = result.data;
+            return true;
+        }
+        console.warn(`Validation failed for ${mod.file}:`, result);
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lazy-load multiple modules in parallel. Only fetches modules that
+ * are not already loaded. Returns the current data state.
+ */
+export async function loadModules(keys) {
+    const toLoad = keys
+        .filter((key) => currentData[key] === null)
+        .map((key) => MODULE_DEFS.find((m) => m.key === key))
+        .filter((mod) => mod !== undefined);
+    if (toLoad.length > 0) {
+        await Promise.allSettled(toLoad.map((mod) => fetchModule(mod)));
+        notifyChange();
+    }
+    return currentData;
+}
+/** Load data from dropped files */
+export async function loadFromFiles(files) {
+    const fileMap = new Map();
+    for (const f of files) {
+        fileMap.set(f.name, f);
+    }
+    for (const mod of MODULE_DEFS) {
+        const file = fileMap.get(mod.file);
+        if (!file)
+            continue;
+        try {
+            const text = await file.text();
+            const raw = JSON.parse(text);
+            const migrated = migrateData(mod.key, raw);
+            const result = mod.validate(migrated);
+            if (result.ok) {
+                currentData[mod.key] = result.data;
+            }
+            else {
+                console.warn(`Validation failed for ${mod.file}:`, result);
+            }
+        }
+        catch (err) {
+            console.warn(`Failed to parse ${mod.file}:`, err);
+        }
+    }
+    notifyChange();
+    return currentData;
+}
+/** Check if we're running in server mode */
+export async function detectMode() {
+    try {
+        const res = await fetch("/data");
+        if (res.ok)
+            return "server";
+    }
+    catch {
+        // Not in server mode
+    }
+    return "static";
+}
+/**
+ * Selectively reload only the data files whose mtime has changed.
+ * More memory-efficient than reloading all files on every change.
+ */
+async function refreshChangedModules(newMtimes) {
+    const changedKeys = [];
+    for (const [file, mtime] of Object.entries(newMtimes)) {
+        if (lastMtimes[file] !== mtime) {
+            const key = FILE_TO_KEY[file];
+            if (key) {
+                changedKeys.push(key);
+            }
+        }
+    }
+    if (changedKeys.length === 0)
+        return;
+    lastMtimes = newMtimes;
+    // Only fetch the modules that actually changed
+    const toLoad = changedKeys
+        .map((key) => MODULE_DEFS.find((m) => m.key === key))
+        .filter((mod) => mod !== undefined);
+    if (toLoad.length > 0) {
+        await Promise.allSettled(toLoad.map((mod) => fetchModule(mod)));
+        notifyChange();
+    }
+}
+/** The polling callback, extracted for registration with the polling manager. */
+async function pollForChanges() {
+    try {
+        const res = await fetch("/data/status");
+        if (!res.ok)
+            return;
+        const status = await res.json();
+        // Check if any file changed
+        let changed = false;
+        for (const [file, mtime] of Object.entries(status.mtimes)) {
+            if (lastMtimes[file] !== mtime) {
+                changed = true;
+                break;
+            }
+        }
+        if (changed) {
+            await refreshChangedModules(status.mtimes);
+        }
+    }
+    catch {
+        // Server may be down — ignore
+    }
+}
+/**
+ * Start polling for data changes (selective refresh — only changed files).
+ * Registers with the centralized polling manager for automatic
+ * suspend/resume based on tab visibility.
+ */
+export function startPolling(intervalMs = 5000) {
+    if (pollingActive)
+        return;
+    pollingActive = true;
+    registerPoller("loader:data-status", pollForChanges, intervalMs);
+}
+/** Stop polling for data changes */
+export function stopPolling() {
+    if (!pollingActive)
+        return;
+    pollingActive = false;
+    unregisterPoller("loader:data-status");
+}
+//# sourceMappingURL=loader.js.map

package/dist/viewer/loader.js.map

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

package/dist/viewer/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/viewer/main.js

@@ -0,0 +1,121 @@
+import { h, render, Fragment } from "preact";
+import { useState, useEffect, useMemo, useCallback } from "preact/hooks";
+import { ALL_DATA_FILES } from "./external.js";
+import { Sidebar, DetailPanel, Guide, Breadcrumb, updateFavicon, MemoryWarningBanner, CrashRecoveryBanner, DegradationBanner, RefreshQueueStatus, PollingSuspensionIndicator, SearchOverlay, useSearchOverlay, } from "./components/index.js";
+import { useRouteState, useAppData, useMemoryMonitor, useCrashRecovery, useGracefulDegradation, useRefreshThrottle, usePollingSuspension, } from "./hooks/index.js";
+import { bootstrap } from "./bootstrap.js";
+import { renderActiveView, buildValidViews } from "./views/view-registry.js";
+bootstrap();
+/** Fetch viewer scope from the server config endpoint. */
+async function fetchScope() {
+    try {
+        const res = await fetch("/api/config");
+        if (!res.ok)
+            return null;
+        const config = await res.json();
+        return config.scope ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+const SIDEBAR_COLLAPSED_KEY = "sidebar-collapsed";
+function getInitialSidebarCollapsed() {
+    try {
+        return localStorage.getItem(SIDEBAR_COLLAPSED_KEY) === "true";
+    }
+    catch {
+        return false;
+    }
+}
+function App({ scope }) {
+    const validViews = useMemo(() => buildValidViews(scope), [scope]);
+    const { view, selectedFile, setSelectedFile, selectedZone, selectedRunId, selectedTaskId, navigateTo, handleSidebarNav, } = useRouteState(validViews);
+    const { snapshot: memorySnapshot, level: memoryLevel, showWarning: showMemoryWarning, dismiss: dismissMemoryWarning } = useMemoryMonitor();
+    const { tier: degradationTier, isDegraded, summary: degradationSummary, disabledFeatures, isDisabled: isFeatureDisabled, } = useGracefulDegradation();
+    const { state: refreshQueueState } = useRefreshThrottle();
+    const { isSuspended: pollingSuspended, suspendedCount: pollingSuspendedCount } = usePollingSuspension();
+    const [searchOpen, , closeSearch] = useSearchOverlay();
+    const { data, loading, refreshToast, showDrop } = useAppData({ pausePolling: isFeatureDisabled("autoRefresh") });
+    const { showRecovery, crashLoop, recentCrashCount, recoveredState, dismiss: dismissRecovery, restore: restoreCrashState, } = useCrashRecovery({ view, selectedFile, selectedZone, selectedRunId, selectedTaskId });
+    const [detail, setDetail] = useState(null);
+    const [degradationDismissed, setDegradationDismissed] = useState(false);
+    const [sidebarCollapsed, setSidebarCollapsed] = useState(getInitialSidebarCollapsed);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const [prdDetailContent, setPrdDetailContent] = useState(null);
+    const handleRestore = () => {
+        const state = restoreCrashState();
+        if (state) {
+            navigateTo(state.view, {
+                file: state.selectedFile ?? undefined,
+                zone: state.selectedZone ?? undefined,
+                runId: state.selectedRunId ?? undefined,
+                taskId: state.selectedTaskId ?? undefined,
+            });
+        }
+    };
+    const handleManualRefresh = useCallback(() => {
+        window.location.reload();
+    }, []);
+    const handleToggleSidebar = () => {
+        setSidebarCollapsed((prev) => {
+            const next = !prev;
+            try {
+                localStorage.setItem(SIDEBAR_COLLAPSED_KEY, String(next));
+            }
+            catch { /* noop */ }
+            return next;
+        });
+    };
+    // Re-show degradation banner when tier escalates
+    useEffect(() => {
+        if (isDegraded)
+            setDegradationDismissed(false);
+    }, [degradationTier]);
+    // Toggle CSS animation suppression class when animations are degraded
+    useEffect(() => {
+        const el = document.documentElement;
+        if (isFeatureDisabled("animations")) {
+            el.classList.add("degradation-no-animations");
+        }
+        else {
+            el.classList.remove("degradation-no-animations");
+        }
+        return () => { el.classList.remove("degradation-no-animations"); };
+    }, [isFeatureDisabled]);
+    // Scroll to top on view change
+    useEffect(() => {
+        document.getElementById("main-content")?.scrollTo(0, 0);
+    }, [view]);
+    // Update browser favicon to match the active product section
+    useEffect(() => {
+        updateFavicon(view);
+    }, [view]);
+    const hasData = data.manifest || data.inventory || data.imports || data.zones;
+    // Show degradation banner when degraded and not already showing the memory warning (avoid stacking)
+    const showDegradationBanner = isDegraded && !degradationDismissed && !showMemoryWarning;
+    return h(Fragment, null, h(CrashRecoveryBanner, { visible: showRecovery, crashLoop, recentCrashCount, recoveredState, onDismiss: dismissRecovery, onRestore: handleRestore }), h(MemoryWarningBanner, { snapshot: memorySnapshot, level: memoryLevel, visible: showMemoryWarning, onDismiss: dismissMemoryWarning }), h(DegradationBanner, { tier: degradationTier, isDegraded, summary: degradationSummary, disabledFeatures, visible: showDegradationBanner, onDismiss: () => setDegradationDismissed(true) }), h("a", { href: "#main-content", class: "skip-link" }, "Skip to main content"), h(Sidebar, { view, onNavigate: handleSidebarNav, manifest: data.manifest, zones: data.zones, sidebarCollapsed, onToggleSidebar: handleToggleSidebar, scope }), h("main", {
+        id: "main-content",
+        class: "main",
+        role: "main",
+        "aria-label": "Main content",
+    }, 
+    // Page-context bar: breadcrumb navigation + help buttons
+    h("div", { class: "page-context-bar", role: "group", "aria-label": "Page navigation and help" }, h(Breadcrumb, { view, navigateTo, scope }), h("div", { class: "page-context-actions" }, h(Guide, { view }))), loading
+        ? h("div", { class: "loading", role: "status", "aria-live": "polite" }, "Loading...")
+        : renderActiveView(view, { data, setDetail, setPrdDetailContent, selectedFile, setSelectedFile, selectedZone, selectedRunId, selectedTaskId, navigateTo, isFeatureDisabled })), !isFeatureDisabled("detailPanel")
+        ? h(DetailPanel, { detail, data, navigateTo, onClose: () => { setDetail(null); setPrdDetailContent(null); }, prdDetailContent })
+        : null, (refreshToast && !isFeatureDisabled("autoRefresh"))
+        ? h("div", { class: "refresh-toast", role: "status", "aria-live": "polite" }, "Data updated")
+        : null, h(RefreshQueueStatus, { state: refreshQueueState, visible: !isFeatureDisabled("autoRefresh") }), h(PollingSuspensionIndicator, { isSuspended: pollingSuspended, suspendedCount: pollingSuspendedCount, onRefresh: handleManualRefresh }), (showDrop && !hasData)
+        ? h("div", { class: "drop-overlay", role: "dialog", "aria-label": "File drop zone" }, h("div", { class: "drop-box" }, h("h2", null, "Drop .sourcevision files"), h("p", null, `Drag and drop ${ALL_DATA_FILES.join(", ")}`)))
+        : null, h(SearchOverlay, { visible: searchOpen, onClose: closeSearch, navigateTo }));
+}
+const root = document.getElementById("app");
+if (root) {
+    // Fetch scope before first render to avoid flash of unscoped content
+    fetchScope().then((scope) => {
+        render(h(App, { scope }), root);
+    });
+}
+//# sourceMappingURL=main.js.map

package/dist/viewer/main.js.map

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

package/dist/viewer/messaging/call-rate-limiter.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Call-level rate limiter with queue deduplication.
+ *
+ * Enforces a minimum interval between execution starts. Calls arriving
+ * within the cooldown window are queued (deduplicated: only one pending
+ * call exists at a time — subsequent callers share its promise).
+ *
+ * Designed to sit in front of `createRequestDedup`: the rate limiter
+ * controls *when* calls happen, while the dedup handles concurrent
+ * in-flight request sharing.
+ *
+ * Standalone module with zero framework dependencies.
+ * Preact integration lives in the consumer (views/prd.ts).
+ */
+export interface CallRateLimiterConfig {
+    /**
+     * Minimum milliseconds between execution starts.
+     * Default: 500 (allows max 2 calls per second).
+     */
+    minIntervalMs?: number;
+}
+/** A rate-limited, queue-deduplicated wrapper around an async function. */
+export interface CallRateLimiter<T = void> {
+    /**
+     * Schedule execution. If within the rate limit cooldown, the call is
+     * queued. Multiple callers hitting the queue share one promise (dedup).
+     */
+    execute(): Promise<T>;
+    /** Whether the underlying function is currently executing. */
+    isExecuting(): boolean;
+    /** Whether a call is queued waiting for the rate limit cooldown. */
+    isPending(): boolean;
+    /** Clean up timers and pending state. Safe to call multiple times. */
+    dispose(): void;
+}
+/**
+ * Create a rate-limited, queue-deduplicated wrapper for an async function.
+ *
+ * Usage:
+ * ```ts
+ * const rateLimited = createCallRateLimiter(() => fetchData(), { minIntervalMs: 500 });
+ *
+ * rateLimited.execute(); // executes immediately (first call)
+ * rateLimited.execute(); // queued — shares the same pending promise
+ * rateLimited.execute(); // deduped to the already-queued call
+ *
+ * // After 500ms the queued call fires.
+ * ```
+ */
+export declare function createCallRateLimiter<T = void>(fn: () => Promise<T>, config?: CallRateLimiterConfig): CallRateLimiter<T>;

package/dist/viewer/messaging/call-rate-limiter.js

@@ -0,0 +1,103 @@
+/**
+ * Call-level rate limiter with queue deduplication.
+ *
+ * Enforces a minimum interval between execution starts. Calls arriving
+ * within the cooldown window are queued (deduplicated: only one pending
+ * call exists at a time — subsequent callers share its promise).
+ *
+ * Designed to sit in front of `createRequestDedup`: the rate limiter
+ * controls *when* calls happen, while the dedup handles concurrent
+ * in-flight request sharing.
+ *
+ * Standalone module with zero framework dependencies.
+ * Preact integration lives in the consumer (views/prd.ts).
+ */
+/** Default minimum interval — 500ms ≈ 2 calls/sec. */
+const DEFAULT_MIN_INTERVAL_MS = 500;
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a rate-limited, queue-deduplicated wrapper for an async function.
+ *
+ * Usage:
+ * ```ts
+ * const rateLimited = createCallRateLimiter(() => fetchData(), { minIntervalMs: 500 });
+ *
+ * rateLimited.execute(); // executes immediately (first call)
+ * rateLimited.execute(); // queued — shares the same pending promise
+ * rateLimited.execute(); // deduped to the already-queued call
+ *
+ * // After 500ms the queued call fires.
+ * ```
+ */
+export function createCallRateLimiter(fn, config) {
+    const minIntervalMs = config?.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    let lastExecutionStartMs = 0;
+    let executing = false;
+    let pendingTimer = null;
+    let pendingResolve = null;
+    let pendingReject = null;
+    let pendingPromise = null;
+    let disposed = false;
+    function executeNow() {
+        lastExecutionStartMs = Date.now();
+        executing = true;
+        return fn().then((value) => {
+            executing = false;
+            return value;
+        }, (err) => {
+            executing = false;
+            throw err;
+        });
+    }
+    function execute() {
+        if (disposed) {
+            return Promise.reject(new Error("CallRateLimiter has been disposed"));
+        }
+        const now = Date.now();
+        const elapsed = now - lastExecutionStartMs;
+        if (elapsed >= minIntervalMs) {
+            // Enough time since last execution start — fire immediately.
+            return executeNow();
+        }
+        // Within rate limit cooldown — queue (deduplicated).
+        if (pendingPromise !== null) {
+            // Already queued — return the existing promise (dedup).
+            return pendingPromise;
+        }
+        // Create a new queued execution.
+        pendingPromise = new Promise((resolve, reject) => {
+            pendingResolve = resolve;
+            pendingReject = reject;
+        });
+        const delay = minIntervalMs - elapsed;
+        pendingTimer = setTimeout(() => {
+            const resolve = pendingResolve;
+            const reject = pendingReject;
+            pendingTimer = null;
+            pendingResolve = null;
+            pendingReject = null;
+            pendingPromise = null;
+            executeNow().then(resolve, reject);
+        }, delay);
+        return pendingPromise;
+    }
+    function isExecuting() {
+        return executing;
+    }
+    function isPending() {
+        return pendingPromise !== null;
+    }
+    function dispose() {
+        disposed = true;
+        if (pendingTimer !== null) {
+            clearTimeout(pendingTimer);
+            pendingTimer = null;
+        }
+        pendingResolve = null;
+        pendingReject = null;
+        pendingPromise = null;
+        executing = false;
+    }
+    return { execute, isExecuting, isPending, dispose };
+}
+//# sourceMappingURL=call-rate-limiter.js.map

package/dist/viewer/messaging/call-rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-rate-limiter.js","sourceRoot":"","sources":["../../../src/viewer/messaging/call-rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/viewer/messaging/fetch-pipeline.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Fetch pipeline — composed request dedup + call rate limiter.
+ *
+ * Wraps an async function with two layers of protection:
+ *   1. **Rate limiter** — caps execution frequency (e.g. max 2 calls/sec).
+ *   2. **Request dedup** — concurrent callers share one in-flight request.
+ *
+ * This module captures the pattern used by `usePRDData` for both PRD and
+ * task-usage fetching, reducing the coupling surface from two individual
+ * messaging imports to one composed import.
+ *
+ * Standalone module with zero framework dependencies.
+ */
+/** Configuration for the fetch pipeline. */
+export interface FetchPipelineConfig {
+    /**
+     * Minimum milliseconds between execution starts.
+     * Default: 500 (allows max 2 calls per second).
+     */
+    minIntervalMs?: number;
+}
+/** A composed fetch pipeline (rate limiter + request dedup). */
+export interface FetchPipeline<T = void> {
+    /**
+     * Execute the wrapped function. Rate-limited and deduplicated:
+     * - If within the rate limit cooldown, the call is queued.
+     * - If a request is already in-flight, returns the existing promise.
+     */
+    execute(): Promise<T>;
+    /** Whether the underlying function is currently executing. */
+    isExecuting(): boolean;
+    /** Whether a call is queued waiting for the rate limit cooldown. */
+    isPending(): boolean;
+    /** Whether a request is currently in-flight (dedup layer). */
+    isInFlight(): boolean;
+    /** Clean up timers and pending state. Safe to call multiple times. */
+    dispose(): void;
+}
+/**
+ * Create a fetch pipeline that rate-limits and deduplicates an async function.
+ *
+ * Usage:
+ * ```ts
+ * const fetchPRD = createFetchPipeline(
+ *   async () => {
+ *     const res = await fetch("/data/prd.json");
+ *     return res.json();
+ *   },
+ *   { minIntervalMs: 500 },
+ * );
+ *
+ * // All three calls resolve to the same result — one actual fetch:
+ * fetchPRD.execute();
+ * fetchPRD.execute();
+ * fetchPRD.execute();
+ * ```
+ */
+export declare function createFetchPipeline<T = void>(fn: () => Promise<T>, config?: FetchPipelineConfig): FetchPipeline<T>;

package/dist/viewer/messaging/fetch-pipeline.js

@@ -0,0 +1,58 @@
+/**
+ * Fetch pipeline — composed request dedup + call rate limiter.
+ *
+ * Wraps an async function with two layers of protection:
+ *   1. **Rate limiter** — caps execution frequency (e.g. max 2 calls/sec).
+ *   2. **Request dedup** — concurrent callers share one in-flight request.
+ *
+ * This module captures the pattern used by `usePRDData` for both PRD and
+ * task-usage fetching, reducing the coupling surface from two individual
+ * messaging imports to one composed import.
+ *
+ * Standalone module with zero framework dependencies.
+ */
+import { createCallRateLimiter } from "./call-rate-limiter.js";
+import { createRequestDedup } from "./request-dedup.js";
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Create a fetch pipeline that rate-limits and deduplicates an async function.
+ *
+ * Usage:
+ * ```ts
+ * const fetchPRD = createFetchPipeline(
+ *   async () => {
+ *     const res = await fetch("/data/prd.json");
+ *     return res.json();
+ *   },
+ *   { minIntervalMs: 500 },
+ * );
+ *
+ * // All three calls resolve to the same result — one actual fetch:
+ * fetchPRD.execute();
+ * fetchPRD.execute();
+ * fetchPRD.execute();
+ * ```
+ */
+export function createFetchPipeline(fn, config) {
+    const dedup = createRequestDedup(fn);
+    const rateLimiter = createCallRateLimiter(() => dedup.execute(), { minIntervalMs: config?.minIntervalMs });
+    return {
+        execute() {
+            return rateLimiter.execute();
+        },
+        isExecuting() {
+            return rateLimiter.isExecuting();
+        },
+        isPending() {
+            return rateLimiter.isPending();
+        },
+        isInFlight() {
+            return dedup.isInFlight();
+        },
+        dispose() {
+            rateLimiter.dispose();
+            dedup.dispose();
+        },
+    };
+}
+//# sourceMappingURL=fetch-pipeline.js.map

package/dist/viewer/messaging/fetch-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-pipeline.js","sourceRoot":"","sources":["../../../src/viewer/messaging/fetch-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAoD,MAAM,wBAAwB,CAAC;AACjH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAmC3E,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CACjC,EAAoB,EACpB,MAA4B;IAE5B,MAAM,KAAK,GAAoB,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACtD,MAAM,WAAW,GAAuB,qBAAqB,CAC3D,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EACrB,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAkC,CACzE,CAAC;IAEF,OAAO;QACL,OAAO;YACL,OAAO,WAAW,CAAC,OAAO,EAAE,CAAC;QAC/B,CAAC;QAED,WAAW;YACT,OAAO,WAAW,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC;QAED,SAAS;YACP,OAAO,WAAW,CAAC,SAAS,EAAE,CAAC;QACjC,CAAC;QAED,UAAU;YACR,OAAO,KAAK,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO;YACL,WAAW,CAAC,OAAO,EAAE,CAAC;YACtB,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}