@gloocan/cat-inspector 0.1.1

package/dist/ast/visit-node.js

@@ -0,0 +1,298 @@
+import ts from 'typescript';
+import { scanForReturns } from './scan-for-returns.js';
+import { scanForApiReturns, scanForThrows } from './scan-for-labels.js';
+import { expandTypeToShapeString } from './type-expand.js';
+function getFunctionLikeSignatureTypes(fn, checker, options) {
+    const sig = checker.getSignatureFromDeclaration(fn);
+    if (!sig)
+        return undefined;
+    const params = [];
+    for (let i = 0; i < fn.parameters.length; i++) {
+        const p = fn.parameters[i];
+        const paramName = ts.isIdentifier(p.name) ? p.name.text : `arg${i}`;
+        const t = checker.getTypeAtLocation(p);
+        const fileMeta = computeFileMetaForType(t, checker, 0, new Set());
+        params.push({
+            name: paramName,
+            type: options.expandParamTypes
+                ? expandTypeToShapeString(t, checker, p, {
+                    ...options.expandParamTypesOptions,
+                    program: options.program ?? options.expandParamTypesOptions?.program,
+                })
+                : checker.typeToString(t),
+            ...fileMeta,
+        });
+    }
+    const ret = checker.getReturnTypeOfSignature(sig);
+    const declaredReturn = checker.typeToString(ret);
+    return { params, declaredReturn };
+}
+const FILE_TYPE_NAMES = new Set(['File', 'Blob', 'Buffer']);
+function isFileLikeType(t, checker) {
+    const sym = t.getSymbol() ?? t.aliasSymbol;
+    const name = sym?.getName();
+    if (name && FILE_TYPE_NAMES.has(name))
+        return true;
+    // Fallback: typeToString() can include `File`/`Blob`/`Buffer` even when symbol names vary.
+    const s = checker.typeToString(t);
+    return s === 'File' || s === 'Blob' || s === 'Buffer';
+}
+function computeFileMetaForType(t, checker, depth, 
+// Track by type string to avoid obvious cycles without relying on private `id`.
+seen) {
+    if (depth > 6)
+        return {};
+    const key = checker.typeToString(t);
+    if (seen.has(key))
+        return {};
+    seen.add(key);
+    // Top-level single file
+    if (isFileLikeType(t, checker))
+        return { kind: 'file' };
+    // Top-level array of file
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const anyChecker = checker;
+    if (typeof anyChecker.isArrayType === 'function' && anyChecker.isArrayType(t)) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        const el = anyChecker.getElementTypeOfArrayType(t);
+        if (el && isFileLikeType(el, checker))
+            return { kind: 'files' };
+        // Arrays of objects might contain nested files; treat via recursive scan below.
+    }
+    // Nested paths inside object types
+    const filePaths = [];
+    const fileArrayPaths = [];
+    const collect = (subType, prefix) => {
+        if (isFileLikeType(subType, checker)) {
+            filePaths.push(prefix);
+            return;
+        }
+        if (typeof anyChecker.isArrayType === 'function' && anyChecker.isArrayType(subType)) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            const el = anyChecker.getElementTypeOfArrayType(subType);
+            if (el && isFileLikeType(el, checker)) {
+                fileArrayPaths.push(prefix);
+                return;
+            }
+            // Array of objects: record nested with a representative [0] path
+            if (el) {
+                const nested = computeFileMetaForType(el, checker, depth + 1, seen);
+                for (const p of nested.filePaths ?? [])
+                    filePaths.push(`${prefix}[0].${p}`);
+                for (const p of nested.fileArrayPaths ?? [])
+                    fileArrayPaths.push(`${prefix}[0].${p}`);
+            }
+            return;
+        }
+        const nested = computeFileMetaForType(subType, checker, depth + 1, seen);
+        for (const p of nested.filePaths ?? [])
+            filePaths.push(`${prefix}.${p}`);
+        for (const p of nested.fileArrayPaths ?? [])
+            fileArrayPaths.push(`${prefix}.${p}`);
+    };
+    // Only recurse into object-ish types (primitives will have no properties)
+    for (const prop of t.getProperties()) {
+        const decl = prop.valueDeclaration ?? prop.declarations?.[0];
+        if (!decl)
+            continue;
+        const propType = checker.getTypeOfSymbolAtLocation(prop, decl);
+        collect(propType, prop.getName());
+    }
+    const out = {};
+    if (filePaths.length)
+        out.filePaths = [...new Set(filePaths)];
+    if (fileArrayPaths.length)
+        out.fileArrayPaths = [...new Set(fileArrayPaths)];
+    return out;
+}
+function getStringLiteralText(node) {
+    if (!node)
+        return undefined;
+    if (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) {
+        return node.text;
+    }
+    return undefined;
+}
+function parseFnKeyLiteral(fnKey) {
+    const dot = fnKey.indexOf('.');
+    if (dot <= 0 || dot === fnKey.length - 1)
+        return undefined;
+    return { className: fnKey.slice(0, dot), fnName: fnKey.slice(dot + 1) };
+}
+function tryVisitFunctionalRegistrations(node, checker, results, options) {
+    if (!ts.isCallExpression(node))
+        return;
+    if (!ts.isIdentifier(node.expression))
+        return;
+    const callee = node.expression.text;
+    if (callee === 'cat') {
+        const fnKeyText = getStringLiteralText(node.arguments[0]);
+        const fnArg = node.arguments[1];
+        if (!fnKeyText || !fnArg)
+            return;
+        const parsed = parseFnKeyLiteral(fnKeyText);
+        if (!parsed)
+            return;
+        if (!ts.isFunctionExpression(fnArg) && !ts.isArrowFunction(fnArg))
+            return;
+        const signatureTypes = getFunctionLikeSignatureTypes(fnArg, checker, options);
+        const returns = [];
+        const throws = [];
+        const apiReturns = [];
+        // FunctionExpression always has a block body; ArrowFunction may be block or expression.
+        scanForReturns(fnArg.body, checker, returns);
+        scanForThrows(fnArg.body, checker, throws);
+        scanForApiReturns(fnArg.body, checker, apiReturns);
+        results.push({
+            fnName: parsed.fnName,
+            className: parsed.className,
+            returns,
+            throws,
+            apiReturns,
+            paramsFromAst: signatureTypes?.params,
+            declaredReturnFromAst: signatureTypes?.declaredReturn,
+        });
+        return;
+    }
+    if (callee === 'catModule') {
+        const moduleName = getStringLiteralText(node.arguments[0]);
+        const objArg = node.arguments[1];
+        if (!moduleName)
+            return;
+        if (!objArg || !ts.isObjectLiteralExpression(objArg))
+            return;
+        for (const prop of objArg.properties) {
+            if (ts.isMethodDeclaration(prop) && prop.name) {
+                const propName = ts.isIdentifier(prop.name)
+                    ? prop.name.text
+                    : ts.isStringLiteral(prop.name)
+                        ? prop.name.text
+                        : undefined;
+                if (!propName)
+                    continue;
+                const signatureTypes = getFunctionLikeSignatureTypes(prop, checker, options);
+                const returns = [];
+                const throws = [];
+                const apiReturns = [];
+                if (prop.body) {
+                    scanForReturns(prop.body, checker, returns);
+                    scanForThrows(prop.body, checker, throws);
+                    scanForApiReturns(prop.body, checker, apiReturns);
+                }
+                results.push({
+                    fnName: propName,
+                    className: moduleName,
+                    returns,
+                    throws,
+                    apiReturns,
+                    paramsFromAst: signatureTypes?.params,
+                    declaredReturnFromAst: signatureTypes?.declaredReturn,
+                });
+                continue;
+            }
+            if (ts.isPropertyAssignment(prop) && prop.name) {
+                const propName = ts.isIdentifier(prop.name)
+                    ? prop.name.text
+                    : ts.isStringLiteral(prop.name)
+                        ? prop.name.text
+                        : undefined;
+                if (!propName)
+                    continue;
+                const init = prop.initializer;
+                if (!ts.isArrowFunction(init) && !ts.isFunctionExpression(init))
+                    continue;
+                const signatureTypes = getFunctionLikeSignatureTypes(init, checker, options);
+                const returns = [];
+                const throws = [];
+                const apiReturns = [];
+                scanForReturns(init.body, checker, returns);
+                scanForThrows(init.body, checker, throws);
+                scanForApiReturns(init.body, checker, apiReturns);
+                results.push({
+                    fnName: propName,
+                    className: moduleName,
+                    returns,
+                    throws,
+                    apiReturns,
+                    paramsFromAst: signatureTypes?.params,
+                    declaredReturnFromAst: signatureTypes?.declaredReturn,
+                });
+            }
+        }
+    }
+}
+function getMethodSignatureTypes(member, checker, options) {
+    const sig = checker.getSignatureFromDeclaration(member);
+    if (!sig)
+        return undefined;
+    const params = [];
+    for (let i = 0; i < member.parameters.length; i++) {
+        const p = member.parameters[i];
+        const paramName = ts.isIdentifier(p.name) ? p.name.text : `arg${i}`;
+        const t = checker.getTypeAtLocation(p);
+        params.push({
+            name: paramName,
+            type: options.expandParamTypes
+                ? expandTypeToShapeString(t, checker, p, {
+                    ...options.expandParamTypesOptions,
+                    program: options.program ?? options.expandParamTypesOptions?.program,
+                })
+                : checker.typeToString(t),
+        });
+    }
+    const ret = checker.getReturnTypeOfSignature(sig);
+    const declaredReturn = checker.typeToString(ret);
+    return { params, declaredReturn };
+}
+function hasCatDecorator(member) {
+    const mods = member.modifiers;
+    if (!mods)
+        return false;
+    return mods.some((mod) => {
+        if (!ts.isDecorator(mod))
+            return false;
+        const expr = mod.expression;
+        if (ts.isIdentifier(expr) && expr.text === 'Cat')
+            return true;
+        if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {
+            return expr.expression.text === 'Cat';
+        }
+        return false;
+    });
+}
+export function visitNode(node, _source, checker, results, options) {
+    tryVisitFunctionalRegistrations(node, checker, results, options);
+    if (ts.isClassDeclaration(node) && node.name) {
+        const className = node.name.text;
+        for (const member of node.members) {
+            if (!ts.isMethodDeclaration(member))
+                continue;
+            if (!hasCatDecorator(member))
+                continue;
+            const name = member.name;
+            if (!ts.isIdentifier(name))
+                continue;
+            const fnName = name.text;
+            const returns = [];
+            const throws = [];
+            const apiReturns = [];
+            if (member.body) {
+                scanForReturns(member.body, checker, returns);
+                scanForThrows(member.body, checker, throws);
+                scanForApiReturns(member.body, checker, apiReturns);
+            }
+            const signatureTypes = getMethodSignatureTypes(member, checker, options);
+            results.push({
+                fnName,
+                className,
+                returns,
+                throws,
+                apiReturns,
+                paramsFromAst: signatureTypes?.params,
+                declaredReturnFromAst: signatureTypes?.declaredReturn,
+            });
+        }
+    }
+    ts.forEachChild(node, (child) => visitNode(child, _source, checker, results, options));
+}
+//# sourceMappingURL=visit-node.js.map

package/dist/ast/visit-node.js.map

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

package/dist/bootstrap.d.ts

@@ -0,0 +1,105 @@
+import type { CompilerOptions } from 'typescript';
+import { type GetAllTsFilesOptions } from './ast/get-all-ts-files.js';
+import type { ExpandTypeOptions } from './ast/type-expand.js';
+import type { Logger } from './logger.js';
+import type { FetchFileUrlOptions } from './upload/fetch-file-url.js';
+import type { QaFileWireMode, QaMediaUploadTarget, RegistryEntry } from './types.js';
+import { type InspectorWebSocketHandle } from './transport/ws-server.js';
+import { type RpcSerializationOptions } from './serialize-rpc-result.js';
+/** Host-provided object storage wiring (secrets read inside adapter from env / vault). */
+export interface StorageAdapter {
+    createPresignedPut(input: {
+        key: string;
+        contentType?: string;
+        sizeBytes?: number;
+    }): Promise<{
+        uploadUrl: string;
+        objectKey: string;
+        expiresAt?: string;
+    }>;
+}
+export interface BootstrapStorageOptions {
+    adapter?: StorageAdapter;
+    /** When set and positive, `adapter` is required (fail-fast `QA_STORAGE_NOT_CONFIGURED`). */
+    artifactThresholdBytes?: number;
+}
+export declare function validateBootstrapStorage(storage: BootstrapStorageOptions | undefined): void;
+/** S3-compatible store (e.g. Minio). Never serialize to BOOTSTRAP / catalog JSON. */
+export interface HostMinioOptions {
+    endpoint: string;
+    region?: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+    forcePathStyle?: boolean;
+}
+export declare function validateBootstrapFileWire(options: {
+    qaFileWire?: {
+        mode?: QaFileWireMode;
+    };
+    fileUrl?: FetchFileUrlOptions | null;
+}): void;
+export interface BootstrapOptions {
+    /** Directories scanned for `.ts` sources (AST + optional discovery) */
+    scanRoots: string[];
+    /** WebSocket listen port */
+    wsPort: number;
+    wsHost?: string;
+    /** Start embedded WebSocket server (default true) */
+    enableWebSocket?: boolean;
+    authToken?: string;
+    /** Absolute file URLs or paths dynamically imported before AST (compiled `.js` or ESM entry) */
+    importEntryUrls?: string[];
+    getAllTsFilesOptions?: GetAllTsFilesOptions;
+    compilerOptions?: CompilerOptions;
+    expandParamTypes?: boolean;
+    expandParamTypesOptions?: ExpandTypeOptions;
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    logger?: Logger;
+    /** Install SIGINT / SIGTERM handlers that close the WebSocket server */
+    registerSignalHandlers?: boolean;
+    /** Redact `RegistryEntry.body` from returned/transported registry (GDPR-safe). Default: true. */
+    redactBodies?: boolean;
+    /** Optional post-invoke JSON normalization for `executeRPC` `result` (BigInt, Date, plain objects, size cap). */
+    rpcSerialization?: RpcSerializationOptions;
+    /** Optional large-payload / presign wiring; validated with `artifactThresholdBytes`. */
+    storage?: BootstrapStorageOptions;
+    /** When embedded WebSocket is enabled, token bucket per connection id. */
+    invokeRateLimit?: {
+        maxInvokesPerWindow: number;
+        windowMs: number;
+    };
+    /** When set, `executeRPC` rejects handler hangs after this many ms (best-effort; handler may still run). */
+    invokeTimeoutMs?: number;
+    /** Wire mode for file RPC params. Default `ref`. */
+    qaFileWire?: {
+        mode?: QaFileWireMode;
+    };
+    /** Catalog hint: where tenant web uploads before `__qaFileUrl` (no secrets). */
+    qaMediaUpload?: {
+        target: QaMediaUploadTarget;
+    };
+    /** Invoke-time URL fetch policy for `__qaFileUrl`. Required when `qaFileWire.mode` is `url`. */
+    fileUrl?: FetchFileUrlOptions;
+    /** HTTPS URL for host-only upload route (no credentials). */
+    qaMediaUploadHostUploadUrl?: string;
+    /**
+     * Host-held Minio/S3 credentials (process memory only). Never sent on BOOTSTRAP.
+     * Used by host HTTP upload routes implemented outside this package.
+     */
+    hostMinio?: HostMinioOptions;
+    /** In-memory QA uploads for `__qaFileRef`; enable when `qaFileWire.mode` is `ref` or alongside URL mode. */
+    upload?: {
+        enabled?: boolean;
+        maxSizeBytes?: number;
+        idleTimeoutMs?: number;
+    };
+}
+export interface BootstrapResult {
+    registry: Record<string, RegistryEntry>;
+    tree: object[];
+    ws: InspectorWebSocketHandle | undefined;
+    shutdown: () => Promise<void>;
+}
+export declare function bootstrap(options: BootstrapOptions): Promise<BootstrapResult>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

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

package/dist/bootstrap.js

@@ -0,0 +1,121 @@
+import { pathToFileURL } from 'node:url';
+import { getAllTsFiles } from './ast/get-all-ts-files.js';
+import { mergeASTIntoRegistry } from './ast/merge-ast.js';
+import { runASTScanner } from './ast/run-ast-scanner.js';
+import { analyzeRelationships, buildTree, resolveRelationships, } from './graph/relationships.js';
+import { createLogger } from './logger.js';
+import { Registry } from './registry-state.js';
+import { startInspectorWebSocket, } from './transport/ws-server.js';
+import { configureInvokeRateLimit } from './invoke-policy.js';
+import { setInvokeTimeoutMs } from './invoke-runtime-config.js';
+import { resetRpcSerializationConfig, setRpcSerializationConfig, } from './serialize-rpc-result.js';
+export function validateBootstrapStorage(storage) {
+    if (!storage)
+        return;
+    const t = storage.artifactThresholdBytes;
+    if (t !== undefined && t > 0 && !storage.adapter) {
+        throw new Error('QA_STORAGE_NOT_CONFIGURED: artifactThresholdBytes requires bootstrap.storage.adapter');
+    }
+}
+export function validateBootstrapFileWire(options) {
+    const mode = options.qaFileWire?.mode ?? 'ref';
+    if (mode === 'url') {
+        const hosts = options.fileUrl?.allowedHosts;
+        if (!hosts || hosts.length === 0) {
+            throw new Error('bootstrap: qaFileWire.mode "url" requires fileUrl.allowedHosts (non-empty)');
+        }
+    }
+}
+function toRegistryRecord() {
+    return Object.fromEntries(Registry);
+}
+function redactRegistryBodies(registry) {
+    return Object.fromEntries(Object.entries(registry).map(([k, v]) => [k, { ...v, body: '' }]));
+}
+export async function bootstrap(options) {
+    const log = options.logger ?? createLogger(options.logLevel ?? 'info');
+    const enableWs = options.enableWebSocket ?? true;
+    const redactBodies = options.redactBodies ?? true;
+    validateBootstrapStorage(options.storage);
+    validateBootstrapFileWire(options);
+    for (const entry of options.importEntryUrls ?? []) {
+        const href = entry.startsWith('file:')
+            ? entry
+            : pathToFileURL(entry).href;
+        log.info('dynamic import', href);
+        await import(href);
+    }
+    const roots = options.scanRoots;
+    if (roots.length === 0) {
+        throw new Error('bootstrap: scanRoots must include at least one directory');
+    }
+    const scanRoot = roots[0];
+    const files = [...new Set(roots.flatMap((r) => getAllTsFiles(r, options.getAllTsFilesOptions)))];
+    const runOpts = {
+        files,
+        getAllTsFilesOptions: options.getAllTsFilesOptions,
+        compilerOptions: options.compilerOptions,
+        expandParamTypes: options.expandParamTypes,
+        expandParamTypesOptions: options.expandParamTypesOptions,
+    };
+    log.info('AST scan', files.length, 'files');
+    const ast = runASTScanner(scanRoot, runOpts);
+    mergeASTIntoRegistry(ast);
+    await new Promise((resolve) => {
+        setImmediate(() => {
+            resolveRelationships();
+            resolve();
+        });
+    });
+    const { roots: rootKeys } = analyzeRelationships();
+    const tree = rootKeys.map((k) => buildTree(k));
+    const registryRaw = toRegistryRecord();
+    const registry = redactBodies ? redactRegistryBodies(registryRaw) : registryRaw;
+    log.info('registry size', Registry.size, 'roots', rootKeys.length);
+    let ws;
+    async function shutdown() {
+        if (ws)
+            await ws.close();
+    }
+    if (options.rpcSerialization !== undefined) {
+        if (options.rpcSerialization.enabled) {
+            setRpcSerializationConfig(options.rpcSerialization);
+        }
+        else {
+            resetRpcSerializationConfig();
+        }
+    }
+    setInvokeTimeoutMs(options.invokeTimeoutMs);
+    if (enableWs) {
+        configureInvokeRateLimit(options.invokeRateLimit ?? null);
+        ws = await startInspectorWebSocket(registry, tree, {
+            port: options.wsPort,
+            host: options.wsHost,
+            authToken: options.authToken,
+            scanRoots: options.scanRoots,
+            rpcSerialization: options.rpcSerialization,
+            invokeRateLimit: options.invokeRateLimit,
+            invokeTimeoutMs: options.invokeTimeoutMs,
+            upload: options.upload,
+            qaFileWire: options.qaFileWire,
+            qaMediaUpload: options.qaMediaUpload,
+            fileUrl: options.fileUrl,
+            qaMediaUploadHostUploadUrl: options.qaMediaUploadHostUploadUrl,
+        });
+        log.info('WebSocket listening', `${options.wsHost ?? '127.0.0.1'}:${ws.port}`);
+    }
+    if (options.registerSignalHandlers && enableWs && ws) {
+        const onSignal = () => {
+            void shutdown()
+                .then(() => process.exit(0))
+                .catch((err) => {
+                log.error('shutdown error', err);
+                process.exit(1);
+            });
+        };
+        process.once('SIGINT', onSignal);
+        process.once('SIGTERM', onSignal);
+    }
+    return { registry, tree, ws, shutdown };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/catalog-bootstrap-cache.d.ts

@@ -0,0 +1,23 @@
+export type CatalogBootstrapPayload = {
+    event: 'BOOTSTRAP';
+    protocolVersion: number;
+    catalogHash: string;
+    registry: Record<string, unknown>;
+    tree: object[];
+};
+export type CatalogBootstrapCache = {
+    get: () => Promise<CatalogBootstrapPayload>;
+    refresh: () => Promise<CatalogBootstrapPayload>;
+};
+/**
+ * Small in-memory cache for catalog bootstrap payloads, gated by a fingerprint.
+ *
+ * - `get()` computes and caches on first call.
+ * - `refresh()` recomputes the fingerprint and only rebuilds when it changed.
+ * - concurrent callers share a single in-flight promise.
+ */
+export declare function createCatalogBootstrapCache(input: {
+    computeFingerprint: () => string;
+    computePayload: (catalogHash: string) => Promise<CatalogBootstrapPayload>;
+}): CatalogBootstrapCache;
+//# sourceMappingURL=catalog-bootstrap-cache.d.ts.map

package/dist/catalog-bootstrap-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-bootstrap-cache.d.ts","sourceRoot":"","sources":["../src/catalog-bootstrap-cache.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,WAAW,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,IAAI,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,CAAA;CAC/C,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,kBAAkB,EAAE,MAAM,MAAM,CAAA;IAChC,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACzE,GAAG,qBAAqB,CA8CxB"}

package/dist/catalog-bootstrap-cache.js

@@ -0,0 +1,54 @@
+/**
+ * Small in-memory cache for catalog bootstrap payloads, gated by a fingerprint.
+ *
+ * - `get()` computes and caches on first call.
+ * - `refresh()` recomputes the fingerprint and only rebuilds when it changed.
+ * - concurrent callers share a single in-flight promise.
+ */
+export function createCatalogBootstrapCache(input) {
+    let lastPayload = null;
+    let lastFingerprint = null;
+    let inFlight = null;
+    async function runBuild(fingerprint) {
+        return await input.computePayload(fingerprint);
+    }
+    return {
+        get: async () => {
+            if (lastPayload)
+                return lastPayload;
+            if (!inFlight) {
+                const fingerprint = input.computeFingerprint();
+                inFlight = runBuild(fingerprint)
+                    .then((p) => {
+                    lastPayload = p;
+                    lastFingerprint = fingerprint;
+                    return p;
+                })
+                    .finally(() => {
+                    inFlight = null;
+                });
+            }
+            return await inFlight;
+        },
+        refresh: async () => {
+            const fingerprint = input.computeFingerprint();
+            if (lastPayload && lastFingerprint === fingerprint)
+                return lastPayload;
+            lastPayload = null;
+            lastFingerprint = null;
+            if (!inFlight) {
+                inFlight = runBuild(fingerprint)
+                    .then((p) => {
+                    lastPayload = p;
+                    lastFingerprint = fingerprint;
+                    return p;
+                })
+                    .finally(() => {
+                    inFlight = null;
+                });
+            }
+            return await inFlight;
+        },
+    };
+}
+//# sourceMappingURL=catalog-bootstrap-cache.js.map

package/dist/catalog-bootstrap-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-bootstrap-cache.js","sourceRoot":"","sources":["../src/catalog-bootstrap-cache.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAG3C;IACA,IAAI,WAAW,GAAmC,IAAI,CAAA;IACtD,IAAI,eAAe,GAAkB,IAAI,CAAA;IACzC,IAAI,QAAQ,GAA4C,IAAI,CAAA;IAE5D,KAAK,UAAU,QAAQ,CAAC,WAAmB;QAC1C,OAAO,MAAM,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO;QACN,GAAG,EAAE,KAAK,IAAI,EAAE;YACf,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAA;YACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAA;gBAC9C,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC;qBAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,WAAW,GAAG,CAAC,CAAA;oBACf,eAAe,GAAG,WAAW,CAAA;oBAC7B,OAAO,CAAC,CAAA;gBACT,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACb,QAAQ,GAAG,IAAI,CAAA;gBAChB,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,QAAQ,CAAA;QACtB,CAAC;QACD,OAAO,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,WAAW,GAAG,KAAK,CAAC,kBAAkB,EAAE,CAAA;YAC9C,IAAI,WAAW,IAAI,eAAe,KAAK,WAAW;gBAAE,OAAO,WAAW,CAAA;YAEtE,WAAW,GAAG,IAAI,CAAA;YAClB,eAAe,GAAG,IAAI,CAAA;YACtB,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC;qBAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;oBACX,WAAW,GAAG,CAAC,CAAA;oBACf,eAAe,GAAG,WAAW,CAAA;oBAC7B,OAAO,CAAC,CAAA;gBACT,CAAC,CAAC;qBACD,OAAO,CAAC,GAAG,EAAE;oBACb,QAAQ,GAAG,IAAI,CAAA;gBAChB,CAAC,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,MAAM,QAAQ,CAAA;QACtB,CAAC;KACD,CAAA;AACF,CAAC"}