cassetter 0.11.0

package/dist/intercept/fetch.js

@@ -0,0 +1,104 @@
+/**
+ * Intercepts the global `fetch` to record and replay HTTP traffic.
+ */
+import { NoMatchError } from "../cassette.js";
+import { bodyToBuffer } from "../types.js";
+import { isLocalhost } from "./base.js";
+const FETCH_PATCHES = new WeakMap();
+function activeFetch(candidate) {
+    let current = candidate;
+    let patch = FETCH_PATCHES.get(current);
+    while (patch && !patch.active) {
+        current = patch.previous;
+        patch = FETCH_PATCHES.get(current);
+    }
+    return current;
+}
+export class FetchInterceptor {
+    _patched = null;
+    /** Replace the global `fetch` with one backed by `cassette`. */
+    install(cassette) {
+        const patch = {
+            active: true,
+            previous: globalThis.fetch,
+        };
+        const patched = async (input, init) => {
+            if (!patch.active) {
+                return activeFetch(patch.previous)(input, init);
+            }
+            const request = new Request(input, init);
+            const { method, url: uri } = request;
+            if (cassette.ignoreLocalhost && isLocalhost(uri)) {
+                return patch.previous(input, init);
+            }
+            const headers = extractHeaders(request.headers);
+            const requestBody = method === "GET" || method === "HEAD"
+                ? null
+                : Buffer.from(await request.clone().arrayBuffer());
+            try {
+                return buildResponse(cassette.play(method, uri, headers, requestBody));
+            }
+            catch (e) {
+                if (!(e instanceof NoMatchError) || !cassette.canRecord)
+                    throw e;
+            }
+            // Claim the slot before going out: under concurrency the responses come
+            // back in whatever order they finish, and recording in that order would
+            // write a different cassette on every run.
+            const order = cassette.reserveRecordOrder();
+            const real = await patch.previous(request.clone());
+            const responseBody = Buffer.from(await real.clone().arrayBuffer());
+            cassette.record(method, uri, headers, requestBody, real.status, 
+            // `arrayBuffer()` hands back decoded bytes while the upstream encoding
+            // and length headers describe the compressed representation.
+            extractDecodedResponseHeaders(real.headers), responseBody, order);
+            return real;
+        };
+        FETCH_PATCHES.set(patched, patch);
+        this._patched = patched;
+        globalThis.fetch = patched;
+    }
+    /** Put the previous active `fetch` back if this interceptor owns the global. */
+    uninstall() {
+        if (!this._patched)
+            return;
+        const patch = FETCH_PATCHES.get(this._patched);
+        if (patch) {
+            patch.active = false;
+            if (globalThis.fetch === this._patched) {
+                globalThis.fetch = activeFetch(patch.previous);
+            }
+        }
+        this._patched = null;
+    }
+}
+function extractDecodedResponseHeaders(headers) {
+    const out = extractHeaders(headers);
+    delete out["content-encoding"];
+    delete out["content-length"];
+    return out;
+}
+/** Collect a `Headers` into name-to-values, lowercasing names. */
+function extractHeaders(headers) {
+    const out = {};
+    headers.forEach((value, key) => {
+        const lower = key.toLowerCase();
+        (out[lower] ??= []).push(value);
+    });
+    return out;
+}
+/** Turn a recorded response back into a `Response`. */
+function buildResponse(response) {
+    const headers = [];
+    for (const [key, values] of Object.entries(response.headers)) {
+        for (const value of values) {
+            headers.push([key, value]);
+        }
+    }
+    // 204/304 must not carry a body.
+    const body = response.status === 204 || response.status === 304
+        ? null
+        : bodyToBuffer(response.body);
+    return new Response(body, { status: response.status, headers });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/intercept/fetch.js.map

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

package/dist/intercept/index.d.ts

@@ -0,0 +1,4 @@
+export { FetchInterceptor } from "./fetch.js";
+export type { Interceptor } from "./base.js";
+export { isLocalhost } from "./base.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/intercept/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/intercept/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/intercept/index.js

@@ -0,0 +1,3 @@
+export { FetchInterceptor } from "./fetch.js";
+export { isLocalhost } from "./base.js";
+//# sourceMappingURL=index.js.map

package/dist/intercept/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/intercept/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/recording.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Record modes and duration parsing.
+ */
+export declare enum RecordMode {
+    /** Replay only. Throws if no match is found. */
+    NONE = "none",
+    /** Record if the cassette doesn't exist; replay if it does. */
+    ONCE = "once",
+    /** Replay existing interactions, record new ones. */
+    NEW_EPISODES = "new_episodes",
+    /** Record everything, overwriting the cassette. */
+    ALL = "all",
+    /** Delete the cassette, then record everything. */
+    REWRITE = "rewrite"
+}
+/** Modes that discard whatever the cassette already held. */
+export declare const DISCARDING_MODES: readonly RecordMode[];
+/** Parse a record mode name, accepting hyphens for underscores. */
+export declare function parseRecordMode(value: string): RecordMode;
+/** Parse a duration like `30d`, `24h`, or `4w` into milliseconds. */
+export declare function parseDuration(s: string): number;
+//# sourceMappingURL=recording.d.ts.map

package/dist/recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../src/recording.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oBAAY,UAAU;IACpB,gDAAgD;IAChD,IAAI,SAAS;IACb,+DAA+D;IAC/D,IAAI,SAAS;IACb,qDAAqD;IACrD,YAAY,iBAAiB;IAC7B,mDAAmD;IACnD,GAAG,QAAQ;IACX,mDAAmD;IACnD,OAAO,YAAY;CACpB;AAUD,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,EAAE,SAAS,UAAU,EAGjD,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQzD;AASD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/dist/recording.js

@@ -0,0 +1,51 @@
+/**
+ * Record modes and duration parsing.
+ */
+export var RecordMode;
+(function (RecordMode) {
+    /** Replay only. Throws if no match is found. */
+    RecordMode["NONE"] = "none";
+    /** Record if the cassette doesn't exist; replay if it does. */
+    RecordMode["ONCE"] = "once";
+    /** Replay existing interactions, record new ones. */
+    RecordMode["NEW_EPISODES"] = "new_episodes";
+    /** Record everything, overwriting the cassette. */
+    RecordMode["ALL"] = "all";
+    /** Delete the cassette, then record everything. */
+    RecordMode["REWRITE"] = "rewrite";
+})(RecordMode || (RecordMode = {}));
+const RECORD_MODES = {
+    none: RecordMode.NONE,
+    once: RecordMode.ONCE,
+    new_episodes: RecordMode.NEW_EPISODES,
+    all: RecordMode.ALL,
+    rewrite: RecordMode.REWRITE,
+};
+/** Modes that discard whatever the cassette already held. */
+export const DISCARDING_MODES = [
+    RecordMode.ALL,
+    RecordMode.REWRITE,
+];
+/** Parse a record mode name, accepting hyphens for underscores. */
+export function parseRecordMode(value) {
+    const mode = RECORD_MODES[value.toLowerCase().replace(/-/g, "_")];
+    if (mode === undefined) {
+        throw new Error(`unknown record mode: '${value}', expected one of ${Object.keys(RECORD_MODES).join(", ")}`);
+    }
+    return mode;
+}
+const DURATION_RE = /^(\d+)([dhw])$/;
+const UNIT_MS = {
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+    w: 7 * 24 * 60 * 60 * 1000,
+};
+/** Parse a duration like `30d`, `24h`, or `4w` into milliseconds. */
+export function parseDuration(s) {
+    const m = DURATION_RE.exec(s);
+    if (!m) {
+        throw new Error(`invalid duration string: '${s}' (expected <number><d|h|w>)`);
+    }
+    return parseInt(m[1], 10) * UNIT_MS[m[2]];
+}
+//# sourceMappingURL=recording.js.map

package/dist/recording.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.js","sourceRoot":"","sources":["../src/recording.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,gDAAgD;IAChD,2BAAa,CAAA;IACb,+DAA+D;IAC/D,2BAAa,CAAA;IACb,qDAAqD;IACrD,2CAA6B,CAAA;IAC7B,mDAAmD;IACnD,yBAAW,CAAA;IACX,mDAAmD;IACnD,iCAAmB,CAAA;AACrB,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB;AAED,MAAM,YAAY,GAA+B;IAC/C,IAAI,EAAE,UAAU,CAAC,IAAI;IACrB,IAAI,EAAE,UAAU,CAAC,IAAI;IACrB,YAAY,EAAE,UAAU,CAAC,YAAY;IACrC,GAAG,EAAE,UAAU,CAAC,GAAG;IACnB,OAAO,EAAE,UAAU,CAAC,OAAO;CAC5B,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAA0B;IACrD,UAAU,CAAC,GAAG;IACd,UAAU,CAAC,OAAO;CACnB,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,yBAAyB,KAAK,sBAAsB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,MAAM,OAAO,GAA2B;IACtC,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC3B,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,8BAA8B,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Data shapes exchanged with the native core.
+ *
+ * These mirror the cassette file format one-to-one, so what you see here is
+ * what is written to disk and what the Python binding produces. Binary bodies
+ * are hex strings (as in the file); use `bodyToBuffer` / `binaryBody` to move
+ * between hex and `Buffer`.
+ */
+export type BodyType = "json" | "text" | "binary" | "none";
+/** The matchers a `MatchConfig` may name. */
+export type Matcher = "method" | "uri" | "headers" | "body" | "json_body";
+export interface Body {
+    type: BodyType;
+    /** Parsed JSON for `json`, the string for `text`, hex for `binary`. */
+    content?: unknown;
+}
+export type HeaderMap = Record<string, string[]>;
+export interface HttpRequest {
+    method: string;
+    uri: string;
+    headers: HeaderMap;
+    body: Body;
+}
+export interface HttpResponse {
+    status: number;
+    headers: HeaderMap;
+    body: Body;
+}
+export interface HttpInteraction {
+    request: HttpRequest;
+    response: HttpResponse;
+    recordedAt: string;
+}
+export interface GrpcRequest {
+    method: string;
+    metadata: HeaderMap;
+    body: Body;
+}
+export interface GrpcResponse {
+    statusCode: number;
+    statusMessage: string;
+    metadata: HeaderMap;
+    body: Body;
+}
+export interface GrpcInteraction {
+    request: GrpcRequest;
+    response: GrpcResponse;
+    recordedAt: string;
+    jsonDebug?: unknown;
+}
+export interface WsFrame {
+    direction: "send" | "recv";
+    frameType: "text" | "binary" | "close";
+    body: Body;
+    offsetMs: number;
+}
+export interface WsInteraction {
+    uri: string;
+    headers: HeaderMap;
+    frames: WsFrame[];
+    recordedAt: string;
+}
+/** Fields to match a request on. Defaults to `["method", "uri"]`. */
+export interface MatchConfig {
+    matchOn?: Matcher[];
+    ignoreJsonPaths?: string[];
+}
+/**
+ * Security filtering.
+ *
+ * Each list **adds to** the built-in defaults rather than standing in for
+ * them, so naming one more header to scrub never starts recording the ones
+ * already covered. Read the built-ins with `defaultFilterHeaders()` and
+ * friends.
+ */
+export interface SecurityConfig {
+    filterHeaders?: string[];
+    filterQueryParameters?: string[];
+    bodyScrubPatterns?: string[];
+    replacement?: string;
+}
+export interface CassetteConfig extends MatchConfig, SecurityConfig {
+    recordMode?: string;
+    intercept?: string[];
+    maxAge?: string;
+    onExpiry?: "warn" | "fail" | "rerecord";
+    ignoreLocalhost?: boolean;
+}
+export declare const NONE_BODY: Body;
+/** Decode a body into raw bytes, whatever its type. */
+export declare function bodyToBuffer(body: Body): Buffer;
+/** Build a binary body from raw bytes (stored as hex, as in the cassette). */
+export declare function binaryBody(buf: Buffer): Body;
+/** Read a binary body's bytes. Throws if the body is not binary. */
+export declare function binaryBodyBytes(body: Body): Buffer;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,6CAA6C;AAC7C,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,QAAQ,CAAC;IACf,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW,EAAE,cAAc;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAID,eAAO,MAAM,SAAS,EAAE,IAAuB,CAAC;AAEhD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAW/C;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKlD"}

package/dist/types.js

@@ -0,0 +1,35 @@
+/**
+ * Data shapes exchanged with the native core.
+ *
+ * These mirror the cassette file format one-to-one, so what you see here is
+ * what is written to disk and what the Python binding produces. Binary bodies
+ * are hex strings (as in the file); use `bodyToBuffer` / `binaryBody` to move
+ * between hex and `Buffer`.
+ */
+// --- Body helpers ---
+export const NONE_BODY = { type: "none" };
+/** Decode a body into raw bytes, whatever its type. */
+export function bodyToBuffer(body) {
+    switch (body.type) {
+        case "json":
+            return Buffer.from(JSON.stringify(body.content ?? null));
+        case "text":
+            return Buffer.from(String(body.content ?? ""));
+        case "binary":
+            return Buffer.from(String(body.content ?? ""), "hex");
+        default:
+            return Buffer.alloc(0);
+    }
+}
+/** Build a binary body from raw bytes (stored as hex, as in the cassette). */
+export function binaryBody(buf) {
+    return { type: "binary", content: buf.toString("hex") };
+}
+/** Read a binary body's bytes. Throws if the body is not binary. */
+export function binaryBodyBytes(body) {
+    if (body.type !== "binary") {
+        throw new TypeError(`expected a binary body, got '${body.type}'`);
+    }
+    return Buffer.from(String(body.content ?? ""), "hex");
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiGH,uBAAuB;AAEvB,MAAM,CAAC,MAAM,SAAS,GAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAEhD,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;QAC3D,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QACjD,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACxD;YACE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3B,MAAM,IAAI,SAAS,CAAC,gCAAgC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}