@webiny/api-core 6.4.12-beta.4 → 6.5.0-beta.0

package/features/debugger/plugins.js

@@ -1,82 +0,0 @@
-import { Request, RequestId, createBeforeHandlerPlugin, createHandlerResultPlugin } from "@webiny/handler";
-import { Debugger } from "./abstractions.js";
-import { IdentityContext } from "../security/IdentityContext/index.js";
-import { parseNamespaceHeader } from "./matchNamespace.js";
-import { canCaptureDebugData } from "./permissions.js";
-import { GRAPHQL_TARGET } from "./GraphQLDebuggerTransport.js";
-const DEBUG_HEADER = "x-webiny-debug";
-const DEBUG_PERMISSION = "dev-tools.debug";
-const isPlainObject = (value)=>"object" == typeof value && null !== value && !Array.isArray(value);
-const isGraphQLResult = (value)=>isPlainObject(value) && ("data" in value || "errors" in value);
-const resolveTarget = (payload)=>{
-    const candidate = Array.isArray(payload) ? payload.at(-1) : payload;
-    return isGraphQLResult(candidate) ? candidate : void 0;
-};
-const readOperationNames = (body)=>{
-    const operations = Array.isArray(body) ? body : [
-        body
-    ];
-    return operations.map((operation)=>isPlainObject(operation) && "string" == typeof operation.operationName ? operation.operationName : void 0).filter((name)=>Boolean(name));
-};
-const createStartPlugin = ()=>createBeforeHandlerPlugin(async (context)=>{
-        try {
-            const request = context.container.resolve(Request);
-            const requested = parseNamespaceHeader(request.headers[DEBUG_HEADER]);
-            const namespaces = requested.length > 0 ? requested : [
-                "*"
-            ];
-            context.container.resolve(Debugger).start({
-                namespaces
-            });
-        } catch  {}
-    });
-const createFlushPlugin = ()=>createHandlerResultPlugin(async (context, payload)=>{
-        try {
-            const debuggerService = context.container.resolve(Debugger);
-            const identityContext = context.container.resolve(IdentityContext);
-            const result = resolveTarget(payload);
-            if (!result) {
-                debuggerService.discard();
-                return payload;
-            }
-            if (identityContext.getIdentity().isAnonymous()) {
-                debuggerService.discard();
-                return payload;
-            }
-            const isAuthorized = identityContext.isAuthorizationEnabled() && await canCaptureDebugData(identityContext);
-            if (!isAuthorized) {
-                debuggerService.discard();
-                return payload;
-            }
-            let operations = [];
-            let requestId = "";
-            let url = "";
-            try {
-                const request = context.container.resolve(Request);
-                operations = readOperationNames(request.body);
-                requestId = context.container.resolve(RequestId).value;
-                url = request.url || "";
-            } catch  {}
-            const target = {
-                type: GRAPHQL_TARGET,
-                result,
-                requestId,
-                operations,
-                url
-            };
-            await debuggerService.flush(target);
-        } catch (ex) {
-            console.error("Debugger failed to flush.", ex instanceof Error ? `${ex.name}: ${ex.message}` : "Unknown error.");
-            try {
-                context.container.resolve(Debugger).discard();
-            } catch  {}
-        }
-        return payload;
-    });
-const createDebuggerPlugins = ()=>[
-        createStartPlugin(),
-        createFlushPlugin()
-    ];
-export { DEBUG_HEADER, DEBUG_PERMISSION, createDebuggerPlugins };
-
-//# sourceMappingURL=plugins.js.map

package/features/debugger/plugins.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"features/debugger/plugins.js","sources":["../../../src/features/debugger/plugins.ts"],"sourcesContent":["import {\n    createBeforeHandlerPlugin,\n    createHandlerResultPlugin,\n    Request,\n    RequestId\n} from \"@webiny/handler\";\nimport type { PluginCollection } from \"@webiny/plugins/types.js\";\nimport type { Context } from \"@webiny/handler/types.js\";\nimport { Debugger } from \"./abstractions.js\";\nimport { IdentityContext } from \"~/features/security/IdentityContext/index.js\";\nimport { parseNamespaceHeader } from \"./matchNamespace.js\";\nimport { canCaptureDebugData } from \"./permissions.js\";\nimport { GRAPHQL_TARGET, type IGraphQLDeliveryTarget } from \"./GraphQLDebuggerTransport.js\";\n\nexport const DEBUG_HEADER = \"x-webiny-debug\";\nexport const DEBUG_PERMISSION = \"dev-tools.debug\";\n\nconst isPlainObject = (value: unknown): value is Record<string, any> => {\n    return typeof value === \"object\" && value !== null && !Array.isArray(value);\n};\n\n/**\n * A GraphQL result carries `data` or `errors`. Anything else - asset delivery, a plain string body -\n * is not ours to write to.\n */\nconst isGraphQLResult = (value: unknown): value is Record<string, any> => {\n    return isPlainObject(value) && (\"data\" in value || \"errors\" in value);\n};\n\n/**\n * Batched requests produce an array of results. The session spans the whole HTTP request, so it is\n * attached once, to the last element - duplicating it per operation would multiply it against the\n * byte budget.\n */\nconst resolveTarget = (payload: unknown): Record<string, any> | undefined => {\n    const candidate = Array.isArray(payload) ? payload.at(-1) : payload;\n    return isGraphQLResult(candidate) ? candidate : undefined;\n};\n\nconst readOperationNames = (body: unknown): string[] => {\n    const operations = Array.isArray(body) ? body : [body];\n    return operations\n        .map(operation => {\n            return isPlainObject(operation) && typeof operation.operationName === \"string\"\n                ? operation.operationName\n                : undefined;\n        })\n        .filter((name): name is string => Boolean(name));\n};\n\n/**\n * Opens the capture session.\n *\n * Runs as a `BeforeHandlerPlugin`, so it is in place before the route handler and therefore before\n * any resolver. Note that `ContextPlugin`s run earlier still, so anything logged from one of those\n * is not captured.\n */\nconst createStartPlugin = () => {\n    return createBeforeHandlerPlugin<Context>(async context => {\n        /**\n         * Must never throw: `ProcessBeforeHandlerPlugins` rethrows, which would turn a malformed\n         * header into a 500 for the whole request.\n         */\n        try {\n            const request = context.container.resolve(Request);\n\n            /**\n             * A session starts on every request, and the permission check at flush decides whether\n             * anything is delivered or the whole thing is discarded.\n             *\n             * Nothing is required from the client. Asking for a request header would mean putting it\n             * on the CORS allow-list, which is cached in preflight responses at CloudFront and in\n             * the browser for a day - so rolling one out breaks requests intermittently until every\n             * cache entry expires.\n             *\n             * The header is still honoured when present, so a direct API client can narrow what it\n             * captures.\n             */\n            const requested = parseNamespaceHeader(request.headers[DEBUG_HEADER]);\n            const namespaces = requested.length > 0 ? requested : [\"*\"];\n\n            context.container.resolve(Debugger).start({ namespaces });\n        } catch {\n            // A debugger that cannot start is not a reason to fail the request.\n        }\n    });\n};\n\n/**\n * Performs the permission gate and hands the session to the transports.\n *\n * This runs once per HTTP response, in the `preSerialization` hook - deliberately not in\n * `graphql-after-query`, which also fires for the nested executions that CMS resolvers perform\n * internally and would attach the session to a result that is then discarded.\n */\nconst createFlushPlugin = () => {\n    return createHandlerResultPlugin<Context>(async (context, payload) => {\n        /**\n         * The whole body is guarded: `preSerialization` rethrows whatever a `HandlerResultPlugin`\n         * throws, so an error here would turn a working response into a 500 - and only for requests\n         * that asked for debugging.\n         */\n        try {\n            const debuggerService = context.container.resolve(Debugger);\n            const identityContext = context.container.resolve(IdentityContext);\n\n            const result = resolveTarget(payload);\n            if (!result) {\n                debuggerService.discard();\n                return payload;\n            }\n\n            /**\n             * Anonymous callers are rejected before permissions are resolved: `getPermission` runs\n             * every registered Authorizer, some of which hit the database.\n             */\n            if (identityContext.getIdentity().isAnonymous()) {\n                debuggerService.discard();\n                return payload;\n            }\n\n            /**\n             * `getPermission` returns a wildcard permission whenever authorization is disabled, so a\n             * flush occurring inside a `withoutAuthorization` scope would pass for anyone.\n             */\n            const isAuthorized =\n                identityContext.isAuthorizationEnabled() &&\n                (await canCaptureDebugData(identityContext));\n\n            if (!isAuthorized) {\n                /**\n                 * Nothing is written. Reporting the denial would tell every unauthorized caller that\n                 * the feature exists, and the Admin app already knows from the identity's own\n                 * permissions whether capture is available to it.\n                 */\n                debuggerService.discard();\n                return payload;\n            }\n\n            let operations: string[] = [];\n            let requestId = \"\";\n            let url = \"\";\n            try {\n                const request = context.container.resolve(Request);\n                operations = readOperationNames(request.body);\n                requestId = context.container.resolve(RequestId).value;\n                /**\n                 * Which endpoint this was. An Admin session talks to several - the main API and the\n                 * CMS manage, read and preview endpoints - and knowing which one produced an entry\n                 * is most of the context when reading a report.\n                 */\n                url = request.url || \"\";\n            } catch {\n                // All three are conveniences; their absence must not stop the flush.\n            }\n\n            const target: IGraphQLDeliveryTarget = {\n                type: GRAPHQL_TARGET,\n                result,\n                requestId,\n                operations,\n                url\n            };\n\n            await debuggerService.flush(target);\n        } catch (ex) {\n            /**\n             * Only the message - never the session or the payload.\n             */\n            console.error(\n                \"Debugger failed to flush.\",\n                ex instanceof Error ? `${ex.name}: ${ex.message}` : \"Unknown error.\"\n            );\n            try {\n                context.container.resolve(Debugger).discard();\n            } catch {\n                // Nothing further to do.\n            }\n        }\n\n        /**\n         * `preSerialization` ignores this return value and serializes the original payload object,\n         * so every write above mutates `result` in place.\n         */\n        return payload;\n    });\n};\n\nexport const createDebuggerPlugins = (): PluginCollection => {\n    return [createStartPlugin(), createFlushPlugin()];\n};\n"],"names":["DEBUG_HEADER","DEBUG_PERMISSION","isPlainObject","value","Array","isGraphQLResult","resolveTarget","payload","candidate","undefined","readOperationNames","body","operations","operation","name","Boolean","createStartPlugin","createBeforeHandlerPlugin","context","request","Request","requested","parseNamespaceHeader","namespaces","Debugger","createFlushPlugin","createHandlerResultPlugin","debuggerService","identityContext","IdentityContext","result","isAuthorized","canCaptureDebugData","requestId","url","RequestId","target","GRAPHQL_TARGET","ex","console","Error","createDebuggerPlugins"],"mappings":";;;;;;AAcO,MAAMA,eAAe;AACrB,MAAMC,mBAAmB;AAEhC,MAAMC,gBAAgB,CAACC,QACZ,AAAiB,YAAjB,OAAOA,SAAsBA,AAAU,SAAVA,SAAkB,CAACC,MAAM,OAAO,CAACD;AAOzE,MAAME,kBAAkB,CAACF,QACdD,cAAcC,UAAW,WAAUA,SAAS,YAAYA,KAAI;AAQvE,MAAMG,gBAAgB,CAACC;IACnB,MAAMC,YAAYJ,MAAM,OAAO,CAACG,WAAWA,QAAQ,EAAE,CAAC,MAAMA;IAC5D,OAAOF,gBAAgBG,aAAaA,YAAYC;AACpD;AAEA,MAAMC,qBAAqB,CAACC;IACxB,MAAMC,aAAaR,MAAM,OAAO,CAACO,QAAQA,OAAO;QAACA;KAAK;IACtD,OAAOC,WACF,GAAG,CAACC,CAAAA,YACMX,cAAcW,cAAc,AAAmC,YAAnC,OAAOA,UAAU,aAAa,GAC3DA,UAAU,aAAa,GACvBJ,QAET,MAAM,CAAC,CAACK,OAAyBC,QAAQD;AAClD;AASA,MAAME,oBAAoB,IACfC,0BAAmC,OAAMC;QAK5C,IAAI;YACA,MAAMC,UAAUD,QAAQ,SAAS,CAAC,OAAO,CAACE;YAc1C,MAAMC,YAAYC,qBAAqBH,QAAQ,OAAO,CAACnB,aAAa;YACpE,MAAMuB,aAAaF,UAAU,MAAM,GAAG,IAAIA,YAAY;gBAAC;aAAI;YAE3DH,QAAQ,SAAS,CAAC,OAAO,CAACM,UAAU,KAAK,CAAC;gBAAED;YAAW;QAC3D,EAAE,OAAM,CAER;IACJ;AAUJ,MAAME,oBAAoB,IACfC,0BAAmC,OAAOR,SAASX;QAMtD,IAAI;YACA,MAAMoB,kBAAkBT,QAAQ,SAAS,CAAC,OAAO,CAACM;YAClD,MAAMI,kBAAkBV,QAAQ,SAAS,CAAC,OAAO,CAACW;YAElD,MAAMC,SAASxB,cAAcC;YAC7B,IAAI,CAACuB,QAAQ;gBACTH,gBAAgB,OAAO;gBACvB,OAAOpB;YACX;YAMA,IAAIqB,gBAAgB,WAAW,GAAG,WAAW,IAAI;gBAC7CD,gBAAgB,OAAO;gBACvB,OAAOpB;YACX;YAMA,MAAMwB,eACFH,gBAAgB,sBAAsB,MACrC,MAAMI,oBAAoBJ;YAE/B,IAAI,CAACG,cAAc;gBAMfJ,gBAAgB,OAAO;gBACvB,OAAOpB;YACX;YAEA,IAAIK,aAAuB,EAAE;YAC7B,IAAIqB,YAAY;YAChB,IAAIC,MAAM;YACV,IAAI;gBACA,MAAMf,UAAUD,QAAQ,SAAS,CAAC,OAAO,CAACE;gBAC1CR,aAAaF,mBAAmBS,QAAQ,IAAI;gBAC5Cc,YAAYf,QAAQ,SAAS,CAAC,OAAO,CAACiB,WAAW,KAAK;gBAMtDD,MAAMf,QAAQ,GAAG,IAAI;YACzB,EAAE,OAAM,CAER;YAEA,MAAMiB,SAAiC;gBACnC,MAAMC;gBACNP;gBACAG;gBACArB;gBACAsB;YACJ;YAEA,MAAMP,gBAAgB,KAAK,CAACS;QAChC,EAAE,OAAOE,IAAI;YAITC,QAAQ,KAAK,CACT,6BACAD,cAAcE,QAAQ,GAAGF,GAAG,IAAI,CAAC,EAAE,EAAEA,GAAG,OAAO,EAAE,GAAG;YAExD,IAAI;gBACApB,QAAQ,SAAS,CAAC,OAAO,CAACM,UAAU,OAAO;YAC/C,EAAE,OAAM,CAER;QACJ;QAMA,OAAOjB;IACX;AAGG,MAAMkC,wBAAwB,IAC1B;QAACzB;QAAqBS;KAAoB"}

package/features/debugger/serialize.d.ts

@@ -1,11 +0,0 @@
-import type { IDebuggerLimits } from "./limits.js";
-export interface ISerializeResult {
-    json: string;
-    bytes: number;
-    /** True if the value was replaced by the per-entry cap marker. */
-    truncated: boolean;
-}
-/**
- * Serializes a captured payload to JSON, never throwing and always producing valid JSON.
- */
-export declare const serialize: (value: unknown, limits: IDebuggerLimits) => ISerializeResult;

package/features/debugger/serialize.js

@@ -1,121 +0,0 @@
-const UNDEFINED = "#[Undefined value]";
-const CIRCULAR = "#[Circular]";
-const DEPTH_LIMIT = "#[Depth limit]";
-const isPlainValue = (value)=>{
-    const type = typeof value;
-    return "string" === type || "number" === type || "boolean" === type || null === value;
-};
-const describeBinary = (value)=>{
-    const name = value.constructor?.name || "TypedArray";
-    return `#[${name} ${value.byteLength} bytes]`;
-};
-const walk = (value, limits, seen, depth)=>{
-    if (void 0 === value) return UNDEFINED;
-    if (isPlainValue(value)) {
-        if ("string" == typeof value && value.length > limits.stringLength) {
-            const kept = value.slice(0, limits.stringLength);
-            return `${kept}…(${value.length - limits.stringLength} more)`;
-        }
-        if ("number" == typeof value && !Number.isFinite(value)) return String(value);
-        return value;
-    }
-    if ("bigint" == typeof value) return `${value.toString()}n`;
-    if ("symbol" == typeof value) return String(value);
-    if ("function" == typeof value) return `#[Function: ${value.name || "anonymous"}]`;
-    if (value instanceof Error) return {
-        name: value.name,
-        message: value.message,
-        stack: value.stack
-    };
-    if (value instanceof Date) return value.toISOString();
-    if (value instanceof RegExp) return value.toString();
-    if (ArrayBuffer.isView(value)) return describeBinary(value);
-    if (value instanceof ArrayBuffer) return `#[ArrayBuffer ${value.byteLength} bytes]`;
-    if (depth >= limits.depth) return DEPTH_LIMIT;
-    if ("object" != typeof value || null === value) return String(value);
-    if (seen.has(value)) return CIRCULAR;
-    seen.add(value);
-    try {
-        if (Array.isArray(value)) {
-            const kept = value.slice(0, limits.arrayLength).map((item)=>walk(item, limits, seen, depth + 1));
-            if (value.length > limits.arrayLength) kept.push(`…(${value.length - limits.arrayLength} more items)`);
-            return kept;
-        }
-        if (value instanceof Map) {
-            const entries = [];
-            for (const [key, item] of value.entries()){
-                if (entries.length >= limits.arrayLength) {
-                    entries.push(`…(${value.size - limits.arrayLength} more entries)`);
-                    break;
-                }
-                entries.push([
-                    walk(key, limits, seen, depth + 1),
-                    walk(item, limits, seen, depth + 1)
-                ]);
-            }
-            return {
-                __type: "Map",
-                entries
-            };
-        }
-        if (value instanceof Set) {
-            const items = [];
-            for (const item of value.values()){
-                if (items.length >= limits.arrayLength) {
-                    items.push(`…(${value.size - limits.arrayLength} more items)`);
-                    break;
-                }
-                items.push(walk(item, limits, seen, depth + 1));
-            }
-            return {
-                __type: "Set",
-                items
-            };
-        }
-        const result = {};
-        for (const key of Object.keys(value)){
-            let item;
-            try {
-                item = value[key];
-            } catch (ex) {
-                result[key] = `#[Throws: ${ex instanceof Error ? ex.message : String(ex)}]`;
-                continue;
-            }
-            if (void 0 !== item) result[key] = walk(item, limits, seen, depth + 1);
-        }
-        return result;
-    } finally{
-        seen.delete(value);
-    }
-};
-const serialize = (value, limits)=>{
-    let json;
-    try {
-        const walked = walk(value, limits, new WeakSet(), 0);
-        json = JSON.stringify(walked) ?? JSON.stringify(UNDEFINED);
-    } catch (ex) {
-        const message = ex instanceof Error ? ex.message : String(ex);
-        json = JSON.stringify({
-            __serializationFailed: true,
-            message
-        });
-    }
-    let bytes = Buffer.byteLength(json, "utf8");
-    let truncated = false;
-    if (bytes > limits.entryBytes) {
-        json = JSON.stringify({
-            truncated: true,
-            originalBytes: bytes
-        });
-        bytes = Buffer.byteLength(json, "utf8");
-        truncated = true;
-    }
-    return {
-        json,
-        bytes,
-        truncated
-    };
-};
-export { serialize };
-
-//# sourceMappingURL=serialize.js.map

package/features/debugger/serialize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"features/debugger/serialize.js","sources":["../../../src/features/debugger/serialize.ts"],"sourcesContent":["import type { IDebuggerLimits } from \"./limits.js\";\n\nexport interface ISerializeResult {\n    json: string;\n    bytes: number;\n    /** True if the value was replaced by the per-entry cap marker. */\n    truncated: boolean;\n}\n\n/**\n * Markers stand in for values that cannot be represented as JSON.\n *\n * They are prefixed with `#` so a reader can tell at a glance that a value was substituted by the\n * serializer rather than being what the code actually held - the previous `[undefined]` read as an\n * array literal in documents that are full of real arrays.\n */\nconst UNDEFINED = \"#[Undefined value]\";\nconst CIRCULAR = \"#[Circular]\";\nconst DEPTH_LIMIT = \"#[Depth limit]\";\n\nconst isPlainValue = (value: unknown): boolean => {\n    const type = typeof value;\n    return type === \"string\" || type === \"number\" || type === \"boolean\" || value === null;\n};\n\nconst describeBinary = (value: ArrayBufferView): string => {\n    const name = value.constructor?.name || \"TypedArray\";\n    return `#[${name} ${value.byteLength} bytes]`;\n};\n\n/**\n * Walks a value into a JSON-safe structure, applying depth, string and array caps as it goes.\n *\n * Caps are applied during the walk rather than by slicing the finished JSON string, so the output is\n * always parseable.\n *\n * A custom `toJSON` is never invoked - own properties are enumerated instead. That means an object\n * is reported as its internals rather than its intended representation, which is what you want when\n * debugging, and it removes a whole class of failure where a third-party `toJSON` throws.\n */\nconst walk = (\n    value: unknown,\n    limits: IDebuggerLimits,\n    seen: WeakSet<object>,\n    depth: number\n): unknown => {\n    if (value === undefined) {\n        /**\n         * Only reached for array elements and for a top-level payload. Object properties holding\n         * `undefined` are dropped before they get here, matching `JSON.stringify`.\n         *\n         * Inside an array the element cannot be dropped without shifting every later index, and\n         * `JSON.stringify` would turn it into `null` - which is a meaningful value in its own right.\n         */\n        return UNDEFINED;\n    }\n\n    if (isPlainValue(value)) {\n        if (typeof value === \"string\" && value.length > limits.stringLength) {\n            const kept = value.slice(0, limits.stringLength);\n            return `${kept}…(${value.length - limits.stringLength} more)`;\n        }\n        /**\n         * Infinity and NaN serialize to `null`, which silently loses the distinction. Keep them\n         * readable instead.\n         */\n        if (typeof value === \"number\" && !Number.isFinite(value)) {\n            return String(value);\n        }\n        return value;\n    }\n\n    if (typeof value === \"bigint\") {\n        return `${value.toString()}n`;\n    }\n\n    if (typeof value === \"symbol\") {\n        return String(value);\n    }\n\n    if (typeof value === \"function\") {\n        return `#[Function: ${value.name || \"anonymous\"}]`;\n    }\n\n    if (value instanceof Error) {\n        return {\n            name: value.name,\n            message: value.message,\n            stack: value.stack\n        };\n    }\n\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n\n    if (value instanceof RegExp) {\n        return value.toString();\n    }\n\n    if (ArrayBuffer.isView(value)) {\n        return describeBinary(value);\n    }\n\n    if (value instanceof ArrayBuffer) {\n        return `#[ArrayBuffer ${value.byteLength} bytes]`;\n    }\n\n    if (depth >= limits.depth) {\n        return DEPTH_LIMIT;\n    }\n\n    if (typeof value !== \"object\" || value === null) {\n        return String(value);\n    }\n\n    if (seen.has(value)) {\n        return CIRCULAR;\n    }\n    seen.add(value);\n\n    try {\n        if (Array.isArray(value)) {\n            const kept = value.slice(0, limits.arrayLength).map(item => {\n                return walk(item, limits, seen, depth + 1);\n            });\n            if (value.length > limits.arrayLength) {\n                kept.push(`…(${value.length - limits.arrayLength} more items)`);\n            }\n            return kept;\n        }\n\n        if (value instanceof Map) {\n            const entries: unknown[] = [];\n            for (const [key, item] of value.entries()) {\n                if (entries.length >= limits.arrayLength) {\n                    entries.push(`…(${value.size - limits.arrayLength} more entries)`);\n                    break;\n                }\n                entries.push([\n                    walk(key, limits, seen, depth + 1),\n                    walk(item, limits, seen, depth + 1)\n                ]);\n            }\n            return { __type: \"Map\", entries };\n        }\n\n        if (value instanceof Set) {\n            const items: unknown[] = [];\n            for (const item of value.values()) {\n                if (items.length >= limits.arrayLength) {\n                    items.push(`…(${value.size - limits.arrayLength} more items)`);\n                    break;\n                }\n                items.push(walk(item, limits, seen, depth + 1));\n            }\n            return { __type: \"Set\", items };\n        }\n\n        const result: Record<string, unknown> = {};\n        for (const key of Object.keys(value)) {\n            /**\n             * A getter can throw. One bad property must not take down the whole entry, let alone the\n             * request that is being observed.\n             */\n            let item: unknown;\n            try {\n                item = (value as Record<string, unknown>)[key];\n            } catch (ex) {\n                result[key] = `#[Throws: ${ex instanceof Error ? ex.message : String(ex)}]`;\n                continue;\n            }\n\n            /**\n             * Drop the key, as `JSON.stringify` does.\n             *\n             * Captured payloads are frequently copies of something that went over the wire, and the\n             * wire never carried these keys - keeping them would describe a request that was never\n             * made.\n             */\n            if (item === undefined) {\n                continue;\n            }\n\n            result[key] = walk(item, limits, seen, depth + 1);\n        }\n        return result;\n    } finally {\n        /**\n         * Only guard against cycles along the current branch. Without this, a value referenced twice\n         * as siblings would report the second one as circular.\n         */\n        seen.delete(value);\n    }\n};\n\n/**\n * Serializes a captured payload to JSON, never throwing and always producing valid JSON.\n */\nexport const serialize = (value: unknown, limits: IDebuggerLimits): ISerializeResult => {\n    let json: string;\n\n    try {\n        const walked = walk(value, limits, new WeakSet(), 0);\n        json = JSON.stringify(walked) ?? JSON.stringify(UNDEFINED);\n    } catch (ex) {\n        const message = ex instanceof Error ? ex.message : String(ex);\n        json = JSON.stringify({ __serializationFailed: true, message });\n    }\n\n    let bytes = Buffer.byteLength(json, \"utf8\");\n    let truncated = false;\n\n    if (bytes > limits.entryBytes) {\n        /**\n         * Slicing the string would produce invalid JSON, so the payload is replaced wholesale.\n         */\n        json = JSON.stringify({ truncated: true, originalBytes: bytes });\n        bytes = Buffer.byteLength(json, \"utf8\");\n        truncated = true;\n    }\n\n    return { json, bytes, truncated };\n};\n"],"names":["UNDEFINED","CIRCULAR","DEPTH_LIMIT","isPlainValue","value","type","describeBinary","name","walk","limits","seen","depth","undefined","kept","Number","String","Error","Date","RegExp","ArrayBuffer","Array","item","Map","entries","key","Set","items","result","Object","ex","serialize","json","walked","WeakSet","JSON","message","bytes","Buffer","truncated"],"mappings":"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"}