@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/testing/http.js

@@ -0,0 +1,347 @@
+/**
+ * In-memory HTTP transport for test clients: Instance discovery, registered REST responses and the request record.
+ * Invariant: No request leaves the process. The hosted discovery bootstrap is answered directly, every other request is
+ * recorded without its Authorization header or webhook token and answered by the newest matching registration. An
+ * unmatched message send or edit receives an echoed bot message, and any other unmatched request receives a
+ * Fluxer-shaped 404 together with a Warn record. Cancellation settles a pending handler's request at once with the
+ * signal's reason.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { ClientClosedError, ConfigurationError } from "#sdk/errors";
+import { hostedDiscoveryDocument, hostedDiscoveryUrl } from "./discovery.js";
+import { fixtureTimestamp } from "./fixtures.js";
+import { timedWait, waitTimeout } from "./wait.js";
+const apiBase = `${hostedDiscoveryDocument.endpoints.api_public}/v1`;
+/** Hosted discovery with presigned uploads off, so an attachment upload arrives as one recorded multipart request */
+const testDiscoveryDocument = Object.freeze({
+    ...hostedDiscoveryDocument,
+    features: Object.freeze({ presigned_attachment_uploads: false }),
+});
+const nullBodyStatuses = new Set([204, 205, 304]);
+function redactWebhookToken(text) {
+    return text.replace(/(\/webhooks\/\d+\/)[^/?#]+/g, "$1[redacted]");
+}
+const isMessageSend = (request) => request.method === "POST" && pathPattern("/channels/:channel/messages")(request.path);
+const isMessageEdit = (request) => request.method === "PATCH" && pathPattern("/channels/:channel/messages/:message")(request.path);
+/** Turn a request embed into the response shape, which adds the rich type, media flags and field inline defaults */
+function echoedEmbed(embed) {
+    if (typeof embed !== "object" || embed === null)
+        return embed;
+    const object = (value, defaults) => typeof value === "object" && value !== null ? { ...defaults, ...value } : value;
+    const { image, thumbnail, fields, ...rest } = embed;
+    return {
+        type: "rich",
+        ...rest,
+        ...(image === undefined ? {} : { image: object(image, { flags: 0 }) }),
+        ...(thumbnail === undefined ? {} : { thumbnail: object(thumbnail, { flags: 0 }) }),
+        ...(Array.isArray(fields) ? { fields: fields.map((field) => object(field, { inline: false })) } : {}),
+    };
+}
+/** Build the message a send or edit request describes, echoing the fields a bot usually sets */
+function echoedMessage(replies, request, edit) {
+    const [, , channelId, , messageId] = request.path.split("/");
+    const body = typeof request.body === "object" && request.body !== null ? request.body : {};
+    const { guild_id: _, ...message } = replies.fixtures.message({
+        id: edit ? messageId : replies.fixtures.nextId(),
+        channel_id: channelId,
+        author: replies.author,
+        content: typeof body.content === "string" ? body.content : "",
+        embeds: Array.isArray(body.embeds) ? body.embeds.map(echoedEmbed) : [],
+        flags: typeof body.flags === "number" ? body.flags : 0,
+        tts: body.tts === true,
+        edited_timestamp: edit ? fixtureTimestamp : null,
+    });
+    return Object.freeze(message);
+}
+/** Compile a string path pattern, where :name matches one segment */
+function pathPattern(pattern) {
+    if (/^https?:\/\//.test(pattern))
+        return (path) => path === pattern;
+    if (!pattern.startsWith("/"))
+        throw new ConfigurationError("configuration", "Test request paths must start with / or be absolute http URLs");
+    const expected = pattern.split("/");
+    return (path) => {
+        const actual = path.split("/");
+        return (actual.length === expected.length &&
+            expected.every((segment, index) => segment.startsWith(":") && segment.length > 1 ? actual[index] !== "" : segment === actual[index]));
+    };
+}
+function methodPattern(method) {
+    if (method === undefined)
+        return undefined;
+    if (typeof method !== "string" || !/^[A-Za-z]+$/.test(method))
+        throw new ConfigurationError("configuration", "Test request methods must be HTTP method names such as GET");
+    const expected = method.toUpperCase();
+    return (request) => request.method === expected;
+}
+function compileMatcher(matcher) {
+    if (typeof matcher === "function")
+        return (request) => matcher(request) === true;
+    if (matcher instanceof RegExp)
+        return (request) => new RegExp(matcher.source, matcher.flags).test(request.path);
+    let method;
+    let path;
+    if (typeof matcher === "string") {
+        const parts = matcher.trim().split(/\s+/);
+        if (parts.length > 2 || parts[0] === "")
+            throw new ConfigurationError("configuration", 'Test request matchers must read "METHOD /path" or "/path"');
+        [method, path] = parts.length === 2 ? parts : [undefined, parts[0]];
+    }
+    else if (typeof matcher === "object" && matcher !== null) {
+        method = matcher.method;
+        path = matcher.path;
+    }
+    else
+        throw new ConfigurationError("configuration", "Test request matchers must be a string, RegExp, { method, path } object or function");
+    const methodMatches = methodPattern(method);
+    const pathMatches = path instanceof RegExp
+        ? (value) => new RegExp(path.source, path.flags).test(value)
+        : typeof path === "string"
+            ? pathPattern(path)
+            : undefined;
+    if (!pathMatches)
+        throw new ConfigurationError("configuration", "Test request matcher paths must be strings or RegExps");
+    return (request) => (methodMatches?.(request) ?? true) && pathMatches(request.path);
+}
+function validateResponse(response) {
+    if (typeof response === "function")
+        return;
+    if (response instanceof Response) {
+        if (response.bodyUsed)
+            throw new ConfigurationError("configuration", "A registered test Response must not have a consumed body");
+        return;
+    }
+    if (typeof response !== "object" || response === null)
+        throw new ConfigurationError("configuration", "Test responses must be an object, a Response or a handler function");
+    checkDescription(response);
+}
+function checkDescription(response) {
+    const { status, headers, body } = response;
+    if (status !== undefined && (!Number.isSafeInteger(status) || status < 200 || status > 599))
+        throw new ConfigurationError("configuration", "Test response status must be an integer from 200 through 599");
+    if (status !== undefined && nullBodyStatuses.has(status) && body !== undefined)
+        throw new ConfigurationError("configuration", `Test response status ${status} cannot have a body`);
+    if (headers !== undefined &&
+        (typeof headers !== "object" ||
+            headers === null ||
+            Object.values(headers).some((value) => typeof value !== "string")))
+        throw new ConfigurationError("configuration", "Test response headers must be an object of strings");
+}
+function toResponse(response) {
+    if (response instanceof Response)
+        return response;
+    if (typeof response !== "object" || response === null)
+        throw new TypeError("A test response handler must return a response object or a Response");
+    checkDescription(response);
+    const { body, headers } = response;
+    const status = response.status ?? (body === undefined ? 204 : 200);
+    return new Response(body === undefined ? null : JSON.stringify(body), {
+        status,
+        headers: body === undefined ? { ...headers } : { "content-type": "application/json", ...headers },
+    });
+}
+/** Read the recorded body and attachment parts of one request, consuming any streamed body */
+async function readBody(request) {
+    if (request.body === null)
+        return { body: undefined, files: [] };
+    const type = request.headers.get("content-type") ?? "";
+    if (type.startsWith("multipart/form-data")) {
+        const form = await request.formData();
+        let body;
+        const files = [];
+        for (const [field, value] of form) {
+            if (typeof value === "string") {
+                if (field === "payload_json")
+                    body = parseJson(value);
+            }
+            else
+                files.push({ field, filename: value.name, contentType: value.type, size: value.size });
+        }
+        return { body, files };
+    }
+    const text = await request.text();
+    if (text === "")
+        return { body: undefined, files: [] };
+    return { body: type.includes("json") ? parseJson(text) : text, files: [] };
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        // allow-silent: A body that is not valid JSON stays visible to the test as its text
+        return text;
+    }
+}
+function aborted(signal) {
+    if (!signal)
+        return undefined;
+    return new Promise((_resolve, reject) => {
+        if (signal.aborted)
+            reject(signal.reason);
+        else
+            signal.addEventListener("abort", () => reject(signal.reason), { once: true });
+    });
+}
+/** The fake HTTP side of one test client */
+export class TestHttp {
+    record;
+    replies;
+    #routes = [];
+    #requests = [];
+    /** Pending next calls of every route, failed with ClientClosedError when the transport closes */
+    #waits = new Set();
+    /** Messages described by recorded sends, built once when the automatic reply or sentMessages first needs them */
+    #sent = new WeakMap();
+    #inFlight = 0;
+    #closed = false;
+    constructor(record, replies) {
+        this.record = record;
+        this.replies = replies;
+    }
+    /** Requests received but not yet answered, including ones whose response handler is still running */
+    get inFlight() {
+        return this.#inFlight;
+    }
+    respond(matcher, response) {
+        const matches = compileMatcher(matcher);
+        validateResponse(response);
+        const route = { matches, response, answered: [], taken: 0, waiters: new Set(), active: true };
+        this.#routes.push(route);
+        return Object.freeze({
+            requests: () => Object.freeze([...route.answered]),
+            next: (options, signal) => {
+                const timeoutMs = waitTimeout(options);
+                if (route.taken < route.answered.length)
+                    return Promise.resolve(route.answered[route.taken++]);
+                if (this.#closed)
+                    return Promise.reject(new ClientClosedError());
+                return timedWait("next", timeoutMs, signal, (settle) => {
+                    const deliver = (request) => settle({ value: request });
+                    const fail = (error) => settle({ error });
+                    route.waiters.add(deliver);
+                    this.#waits.add(fail);
+                    return () => {
+                        route.waiters.delete(deliver);
+                        this.#waits.delete(fail);
+                    };
+                });
+            },
+            remove: () => {
+                route.active = false;
+            },
+        });
+    }
+    /** Requests received so far, in order, excluding the discovery bootstrap */
+    requests() {
+        return Object.freeze([...this.#requests]);
+    }
+    /** The messages described by the message sends among these requests, in order */
+    sentMessages(requests) {
+        return Object.freeze(requests.filter(isMessageSend).map((request) => this.#sentMessage(request)));
+    }
+    #sentMessage(request) {
+        let message = this.#sent.get(request);
+        if (!message)
+            this.#sent.set(request, (message = echoedMessage(this.replies, request, false)));
+        return message;
+    }
+    /** The fetch-compatible function passed to the client's transport option */
+    fetch = async (url, init) => {
+        this.#inFlight++;
+        try {
+            return await this.#answer(url, init);
+        }
+        finally {
+            this.#inFlight--;
+        }
+    };
+    #answer = async (url, init) => {
+        if (this.#closed)
+            throw new Error("The test client has shut down, so its transport accepts no requests");
+        const cancelled = aborted(init.signal);
+        // A cancelled request must settle even while a handler or body read is still pending
+        const settle = (work) => (cancelled ? Promise.race([work, cancelled]) : work);
+        cancelled?.catch(() => {
+            // allow-silent: The same rejection is observed through the race below when cancellation wins
+        });
+        if (url === hostedDiscoveryUrl)
+            return Response.json(testDiscoveryDocument);
+        const request = new Request(url, init);
+        const { body, files } = await settle(readBody(request));
+        const target = new URL(url);
+        const headers = {};
+        request.headers.forEach((value, name) => {
+            if (name !== "authorization")
+                headers[name] = value;
+        });
+        const withoutQuery = `${target.origin}${target.pathname}`;
+        const recordedUrl = redactWebhookToken(url);
+        const path = redactWebhookToken(withoutQuery.startsWith(`${apiBase}/`) ? withoutQuery.slice(apiBase.length) : withoutQuery);
+        const base = {
+            method: request.method.toUpperCase(),
+            url: recordedUrl,
+            path,
+            query: Object.freeze(Object.fromEntries(target.searchParams)),
+            headers: Object.freeze(headers),
+            body,
+            files: Object.freeze(files),
+        };
+        const route = this.#routes.findLast((candidate) => candidate.active && candidate.matches({ ...base, matched: true }));
+        const recorded = Object.freeze({ ...base, matched: route !== undefined });
+        this.#requests.push(recorded);
+        if (!route && isMessageSend(recorded))
+            return Response.json(this.#sentMessage(recorded));
+        if (!route && isMessageEdit(recorded))
+            return Response.json(echoedMessage(this.replies, recorded, true));
+        if (!route) {
+            this.record({
+                level: "warn",
+                category: "rest",
+                code: "testing.unmatchedRequest",
+                message: `No test response matches ${recorded.method} ${recorded.path}, so the request received HTTP 404. Register a matching response with rest.respond`,
+                status: 404,
+                fields: { method: recorded.method, path: recorded.path },
+            });
+            return Response.json({ code: "NOT_FOUND", message: `No test response matches ${recorded.method} ${recorded.path}` }, { status: 404 });
+        }
+        route.answered.push(recorded);
+        const waiter = route.waiters.values().next().value;
+        if (waiter) {
+            route.taken++;
+            waiter(recorded);
+        }
+        const { response } = route;
+        // A registered Response answers every match, so each request receives its own unread copy
+        if (typeof response !== "function")
+            return response instanceof Response ? response.clone() : toResponse(response);
+        try {
+            return toResponse(await settle(Promise.resolve(response(recorded))));
+        }
+        catch (error) {
+            if (init.signal?.aborted && error === init.signal.reason)
+                throw error;
+            this.record({
+                level: "error",
+                category: "rest",
+                code: "testing.responderFailed",
+                message: `The test response handler for ${recorded.method} ${recorded.path} failed, so the request failed as a network error`,
+                fields: { method: recorded.method, path: recorded.path },
+                error: {
+                    origin: "application",
+                    name: error instanceof Error ? error.name : "Error",
+                    message: error instanceof Error ? error.message : String(error),
+                    ...(error instanceof Error && error.stack !== undefined ? { stack: error.stack } : {}),
+                },
+            });
+            throw error;
+        }
+    };
+    /** Refuse later requests and fail pending next calls with ClientClosedError */
+    close() {
+        this.#closed = true;
+        for (const fail of this.#waits)
+            fail(new ClientClosedError());
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/internal/testing/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/internal/testing/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEnE,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC5E,OAAO,EAAE,gBAAgB,EAAkD,MAAM,eAAe,CAAA;AAWhG,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAkBlD,MAAM,OAAO,GAAG,GAAG,uBAAuB,CAAC,SAAS,CAAC,UAAU,KAAK,CAAA;AACpE,qHAAqH;AACrH,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,GAAG,uBAAuB;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,4BAA4B,EAAE,KAAK,EAAE,CAAC;CACnE,CAAC,CAAA;AACF,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAEjD,SAAS,kBAAkB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,6BAA6B,EAAE,cAAc,CAAC,CAAA;AACtE,CAAC;AAQD,MAAM,aAAa,GAAG,CAAC,OAA6C,EAAE,EAAE,CACpE,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,WAAW,CAAC,6BAA6B,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AACzF,MAAM,aAAa,GAAG,CAAC,OAA6C,EAAE,EAAE,CACpE,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,WAAW,CAAC,sCAAsC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AAEnG,oHAAoH;AACpH,SAAS,WAAW,CAAC,KAAc;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,QAAgB,EAAE,EAAE,CAChD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IACnF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAgC,CAAA;IAC9E,OAAO;QACH,IAAI,EAAE,MAAM;QACZ,GAAG,IAAI;QACP,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxG,CAAA;AACL,CAAC;AAED,gGAAgG;AAChG,SAAS,aAAa,CAAC,OAAoB,EAAE,OAAoB,EAAE,IAAa;IAC5E,MAAM,CAAC,EAAE,AAAD,EAAG,SAAS,EAAE,AAAD,EAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC5D,MAAM,IAAI,GACN,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAE,OAAO,CAAC,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9G,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzD,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,SAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;QACjD,UAAU,EAAE,SAAU;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAC7D,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;QACtE,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtD,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,IAAI;QACtB,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;KACnD,CAAC,CAAA;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,qEAAqE;AACrE,SAAS,WAAW,CAAC,OAAe;IAChC,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,OAAO,CAAA;IACnE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QACxB,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,+DAA+D,CAAC,CAAA;IAClH,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnC,OAAO,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC9B,OAAO,CACH,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YACjC,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAC9B,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,CACnG,CACJ,CAAA;IACL,CAAC,CAAA;AACL,CAAC;AAED,SAAS,aAAa,CAAC,MAAe;IAClC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;QACzD,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,4DAA4D,CAAC,CAAA;IAC/G,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IACrC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAA;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,OAA2B;IAC/C,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IAChF,IAAI,OAAO,YAAY,MAAM;QAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/G,IAAI,MAAe,CAAA;IACnB,IAAI,IAAa,CAAA;IACjB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACzC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;YACnC,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,2DAA2D,CAAC,CAC7G;QAAA,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IACxE,CAAC;SAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACzD,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QACvB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACvB,CAAC;;QACG,MAAM,IAAI,kBAAkB,CACxB,eAAe,EACf,qFAAqF,CACxF,CAAA;IACL,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3C,MAAM,WAAW,GACb,IAAI,YAAY,MAAM;QAClB,CAAC,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;QACpE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;YACxB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;YACnB,CAAC,CAAC,SAAS,CAAA;IACrB,IAAI,CAAC,WAAW;QACZ,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,uDAAuD,CAAC,CAAA;IAC1G,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;AACvF,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAiB;IACvC,IAAI,OAAO,QAAQ,KAAK,UAAU;QAAE,OAAM;IAC1C,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,CAAC,QAAQ;YACjB,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,0DAA0D,CAAC,CAAA;QAC7G,OAAM;IACV,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;QACjD,MAAM,IAAI,kBAAkB,CACxB,eAAe,EACf,oEAAoE,CACvE,CAAA;IACL,gBAAgB,CAAC,QAA2C,CAAC,CAAA;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAyC;IAC/D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAA;IAC1C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG,IAAI,MAAM,GAAG,GAAG,CAAC;QACvF,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,8DAA8D,CAAC,CAAA;IACjH,IAAI,MAAM,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,SAAS;QAC1E,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,wBAAwB,MAAM,qBAAqB,CAAC,CAAA;IACtG,IACI,OAAO,KAAK,SAAS;QACrB,CAAC,OAAO,OAAO,KAAK,QAAQ;YACxB,OAAO,KAAK,IAAI;YAChB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;QAEtE,MAAM,IAAI,kBAAkB,CAAC,eAAe,EAAE,oDAAoD,CAAC,CAAA;AAC3G,CAAC;AAED,SAAS,UAAU,CAAC,QAAsB;IACtC,IAAI,QAAQ,YAAY,QAAQ;QAAE,OAAO,QAAQ,CAAA;IACjD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;QACjD,MAAM,IAAI,SAAS,CAAC,qEAAqE,CAAC,CAAA;IAC9F,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAClE,OAAO,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QAClE,MAAM;QACN,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE;KACpG,CAAC,CAAA;AACN,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,QAAQ,CAAC,OAAgB;IACpC,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;IACtD,IAAI,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;QACrC,IAAI,IAAa,CAAA;QACjB,MAAM,KAAK,GAAsB,EAAE,CAAA;QACnC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,IAAI,KAAK,KAAK,cAAc;oBAAE,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;YACzD,CAAC;;gBAAM,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACjG,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IAC1B,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAA;IACjC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IACtD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC3B,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACL,oFAAoF;QACpF,OAAO,IAAI,CAAA;IACf,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,MAAsC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,OAAO,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;;YACpC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACtF,CAAC,CAAC,CAAA;AACN,CAAC;AAED,4CAA4C;AAC5C,MAAM,OAAO,QAAQ;IAWI,MAAM;IACN,OAAO;IAXnB,OAAO,GAAY,EAAE,CAAA;IACrB,SAAS,GAAkB,EAAE,CAAA;IACtC,iGAAiG;IACxF,MAAM,GAAG,IAAI,GAAG,EAA4B,CAAA;IACrD,iHAAiH;IACxG,KAAK,GAAG,IAAI,OAAO,EAA4B,CAAA;IACxD,SAAS,GAAG,CAAC,CAAA;IACb,OAAO,GAAG,KAAK,CAAA;IAEf,YACqB,MAAiD,EACjD,OAAoB;sBADpB,MAAM;uBACN,OAAO;IACzB,CAAC;IAEJ,qGAAqG;IACrG,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAA;IACzB,CAAC;IAED,OAAO,CAAC,OAA2B,EAAE,QAAsC;QACvE,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAA;QACvC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC1B,MAAM,KAAK,GAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;QACpG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC;YACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,EAAE,CAAC,OAAyB,EAAE,MAAoB,EAAE,EAAE;gBACtD,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;gBACtC,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM;oBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAE,CAAC,CAAA;gBAC/F,IAAI,IAAI,CAAC,OAAO;oBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAA;gBAChE,OAAO,SAAS,CAAc,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;oBAChE,MAAM,OAAO,GAAG,CAAC,OAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;oBACpE,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;oBAClD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;oBAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;oBACrB,OAAO,GAAG,EAAE;wBACR,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;wBAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;oBAC5B,CAAC,CAAA;gBACL,CAAC,CAAC,CAAA;YACN,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACT,KAAK,CAAC,MAAM,GAAG,KAAK,CAAA;YACxB,CAAC;SACJ,CAAC,CAAA;IACN,CAAC;IAED,4EAA4E;IAC5E,QAAQ;QACJ,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7C,CAAC;IAED,iFAAiF;IACjF,YAAY,CAAC,QAAgC;QACzC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACrG,CAAC;IAED,YAAY,CAAC,OAAoB;QAC7B,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACrC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;QAC9F,OAAO,OAAO,CAAA;IAClB,CAAC;IAED,4EAA4E;IACnE,KAAK,GAAG,KAAK,EAAE,GAAW,EAAE,IAAiB,EAAqB,EAAE;QACzE,IAAI,CAAC,SAAS,EAAE,CAAA;QAChB,IAAI,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACxC,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,SAAS,EAAE,CAAA;QACpB,CAAC;IACL,CAAC,CAAA;IAEQ,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,IAAiB,EAAqB,EAAE;QAC3E,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;QACxG,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACtC,qFAAqF;QACrF,MAAM,MAAM,GAAG,CAAI,IAAgB,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QAC5F,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE;YAClB,6FAA6F;QACjG,CAAC,CAAC,CAAA;QACF,IAAI,GAAG,KAAK,kBAAkB;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QAC3E,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,MAAM,OAAO,GAA2B,EAAE,CAAA;QAC1C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpC,IAAI,IAAI,KAAK,eAAe;gBAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QACvD,CAAC,CAAC,CAAA;QACF,MAAM,YAAY,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;QACzD,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAC3C,MAAM,IAAI,GAAG,kBAAkB,CAC3B,YAAY,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAC7F,CAAA;QACD,MAAM,IAAI,GAAG;YACT,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE;YACpC,GAAG,EAAE,WAAW;YAChB,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YAC/B,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9B,CAAA;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAC/B,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CACnF,CAAA;QACD,MAAM,QAAQ,GAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC,CAAA;QACtF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC7B,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAA;QACxF,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,QAAQ,CAAC;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;QACxG,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,IAAI,CAAC,MAAM,CAAC;gBACR,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,oFAAoF;gBACzJ,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;aAC3D,CAAC,CAAA;YACF,OAAO,QAAQ,CAAC,IAAI,CAChB,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,4BAA4B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,EAC9F,EAAE,MAAM,EAAE,GAAG,EAAE,CAClB,CAAA;QACL,CAAC;QACD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;QAClD,IAAI,MAAM,EAAE,CAAC;YACT,KAAK,CAAC,KAAK,EAAE,CAAA;YACb,MAAM,CAAC,QAAQ,CAAC,CAAA;QACpB,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAA;QAC1B,0FAA0F;QAC1F,IAAI,OAAO,QAAQ,KAAK,UAAU;YAC9B,OAAO,QAAQ,YAAY,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;QACjF,IAAI,CAAC;YACD,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QACxE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,MAAM,KAAK,CAAA;YACrE,IAAI,CAAC,MAAM,CAAC;gBACR,KAAK,EAAE,OAAO;gBACd,QAAQ,EAAE,MAAM;gBAChB,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,iCAAiC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,mDAAmD;gBAC7H,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;gBACxD,KAAK,EAAE;oBACH,MAAM,EAAE,aAAa;oBACrB,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;oBACnD,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC/D,GAAG,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzF;aACJ,CAAC,CAAA;YACF,MAAM,KAAK,CAAA;QACf,CAAC;IACL,CAAC,CAAA;IAED,+EAA+E;IAC/E,KAAK;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAA;IACjE,CAAC;CACJ"}

package/dist/internal/testing/types.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Public types of the testing entry points, shared by the default and native test clients.
+ * Invariant: This module declares types only and imports nothing that needs Node.js or Effect declarations, so both
+ * testing entry points compile in consumers that lack those type packages, as their main entry points do.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import type { WireMessage, WireOverrides, WireUser } from "./fixtures.js";
+/**
+ * Settings that only test clients accept, alongside the usual client options
+ *
+ * @category Testing
+ */
+export interface TestSettings {
+    /** Token passed to the client, default the fixture token. The fake transport never sends it anywhere */
+    readonly token?: string;
+    /** Bot account the test gateway reports in READY, default the test client's fixtures.botUser() */
+    readonly user?: WireUser;
+    /**
+     * Heartbeat interval in milliseconds sent in HELLO, default 41,250 as on hosted Fluxer.
+     * The client heartbeats on its own timer, which shutdown stops
+     */
+    readonly heartbeatIntervalMs?: number;
+}
+/**
+ * Choose the shard that receives an emitted dispatch
+ *
+ * @category Testing
+ */
+export interface TestEmitOptions {
+    /**
+     * Local shard ID that receives the dispatch.
+     * By default a payload with a guild_id goes to the shard Fluxer routes that community to, (guild_id >> 22) % totalShards,
+     * and any other payload goes to shard 0, which receives direct-message traffic
+     */
+    readonly shardId?: number;
+}
+/**
+ * Choose how the test gateway ends one shard's connection
+ *
+ * @category Testing
+ */
+export interface TestDisconnectOptions {
+    /** Local shard ID whose connection closes, default 0 */
+    readonly shardId?: number;
+    /**
+     * WebSocket or gateway close code the client receives, default 4000 (unknown error), after which the SDK reconnects
+     * and resumes. A fatal code such as 4004 ends the client's connection lifetime instead
+     */
+    readonly code?: number;
+}
+/**
+ * One gateway command a client sent to the test gateway, in send order.
+ * Identify and Resume carry "[redacted]" in place of the token
+ *
+ * @category Testing
+ */
+export interface TestGatewayCommand {
+    /** Shard that sent the command, or null when it came before the socket identified or resumed */
+    readonly shardId: number | null;
+    /** Gateway opcode, such as 2 for Identify, 3 for Presence Update or 8 for Request Guild Members */
+    readonly op: number;
+    /** Command data as sent, parsed from JSON */
+    readonly d: unknown;
+}
+/**
+ * One attachment part of a recorded multipart request
+ *
+ * @category Testing
+ */
+export interface TestRequestFile {
+    /** Form field name, such as files[0] */
+    readonly field: string;
+    /** Uploaded file name */
+    readonly filename: string;
+    /** Declared content type */
+    readonly contentType: string;
+    /** Size in bytes */
+    readonly size: number;
+}
+/**
+ * One HTTP request a test client sent, as recorded by the test transport and passed to response handlers.
+ * The record never contains the Authorization header, and a webhook token in the path reads "[redacted]"
+ *
+ * @category Testing
+ */
+export interface TestRequest {
+    /** Upper-case HTTP method */
+    readonly method: string;
+    /** Absolute request URL, including the query string */
+    readonly url: string;
+    /**
+     * Fluxer API path after the /v1 prefix and without the query string, such as /channels/1/messages.
+     * Requests to other origins, such as media downloads, use the absolute URL without its query string
+     */
+    readonly path: string;
+    /** Query parameters. A repeated parameter keeps its last value */
+    readonly query: Readonly<Record<string, string>>;
+    /** Request headers with lower-case names, without authorization */
+    readonly headers: Readonly<Record<string, string>>;
+    /**
+     * Request body: Parsed JSON for JSON requests, the parsed payload_json part of a multipart upload, the text of any
+     * other body, or undefined when the request has none
+     */
+    readonly body: unknown;
+    /** Attachment parts of a multipart upload, empty for other requests */
+    readonly files: readonly TestRequestFile[];
+    /**
+     * Whether a registered response answered the request. False means the test transport answered it itself, with the
+     * automatic reply to a message send or edit, or otherwise with the default 404
+     */
+    readonly matched: boolean;
+}
+/**
+ * Select the requests a registered response answers.
+ * A string is "METHOD /path" or "/path" for any method, where a :name segment matches any single path segment, such as
+ * "POST /channels/:id/messages". A string starting with http matches an absolute URL on another origin.
+ * A RegExp is tested against the path. An object combines an optional method with a string or RegExp path,
+ * and a function decides from the whole request
+ *
+ * @category Testing
+ */
+export type TestRequestMatcher = string | RegExp | {
+    /** HTTP method to match, case-insensitive. Omit it to match every method */
+    readonly method?: string;
+    /** Path pattern with the string or RegExp rules above */
+    readonly path: string | RegExp;
+} | ((request: TestRequest) => boolean);
+/**
+ * A response description. Omitted fields default to status 200 with a JSON body, or status 204 when body is omitted.
+ * A Response object is used unchanged for bodies that are not JSON
+ *
+ * @category Testing
+ */
+export type TestResponse = {
+    /** HTTP status from 200 through 599 */
+    readonly status?: number;
+    /** Response headers, such as Retry-After or X-RateLimit-Bucket */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Value sent as the JSON response body, usually a wire fixture. Omit it for an empty body */
+    readonly body?: unknown;
+} | Response;
+/**
+ * Compute a response from the recorded request. A returned promise may settle later, and a handler that throws or
+ * rejects makes the request fail as a network error, which the client reports like any transport failure
+ *
+ * @category Testing
+ */
+export type TestResponder = (request: TestRequest) => TestResponse | Promise<TestResponse>;
+/**
+ * One registered response. Registrations are searched newest first, so a later registration overrides an earlier one
+ * for the requests both match
+ *
+ * @category Testing
+ */
+export interface TestRoute {
+    /** Requests this registration answered so far, in order */
+    requests(): readonly TestRequest[];
+    /**
+     * Resolve with the next request this registration answers. Each call returns a different request, in order, so
+     * a request that arrived before the call is returned at once.
+     * Without timeoutMs the wait has no SDK deadline, so the test runner's own timeout ends a test whose request never
+     * arrives. With timeoutMs the promise rejects with TestTimeoutError when no request arrives in time.
+     * It rejects with ClientClosedError when the test client shuts down first. Invalid options throw ConfigurationError
+     */
+    next(options?: TestWaitOptions): Promise<TestRequest>;
+    /** Stop answering requests. Earlier matching registrations and the default 404 apply again */
+    remove(): void;
+}
+/**
+ * Limit how long a test wait, such as TestRoute.next, idle or say, may take
+ *
+ * @category Testing
+ */
+export interface TestWaitOptions {
+    /**
+     * Milliseconds before the wait fails with TestTimeoutError, an integer from 1 through 2,147,483,647.
+     * Omit it to wait without an SDK deadline, so the test runner's own timeout bounds a wait that never settles.
+     * The timeout uses real timers, so it still fires when a test fakes timers
+     */
+    readonly timeoutMs?: number;
+}
+/**
+ * Choose the message a test bot's say delivers and how long say waits for the bot to settle
+ *
+ * @category Testing
+ */
+export interface TestSayOptions extends TestWaitOptions {
+    /**
+     * Wire fields that replace the defaults of the delivered MESSAGE_CREATE payload, as in fixtures.message.
+     * By default the message comes from the fixture set's human author in its default channel and community
+     */
+    readonly message?: WireOverrides<WireMessage>;
+}
+/**
+ * Register fake Fluxer HTTP API responses for a test client.
+ * Without a registration, message sends (POST /channels/:id/messages) and edits (PATCH /channels/:id/messages/:id)
+ * receive an automatic reply: A message by the bot account that echoes the request's content, embeds, flags and tts,
+ * with a new fixture ID for a send and the edited ID for an edit. Other unmatched requests receive a Fluxer-shaped 404
+ *
+ * @category Testing
+ */
+export interface TestRest {
+    /**
+     * Answer matching requests with a fixed response or a handler's response until the registration is removed.
+     * The newest matching registration wins, including over the automatic message replies.
+     * Invalid matchers or responses throw ConfigurationError
+     *
+     * @example
+     * ```ts
+     * import { createTestClient } from "@neontechspace/fluxerly/testing"
+     * export function respondExample() {
+     *     const test = createTestClient()
+     *     test.rest.respond("GET /users/@me", { body: test.fixtures.botUser() })
+     *     return test.rest.respond("POST /channels/:id/messages", (request) => ({
+     *         body: test.fixtures.message({ content: String((request.body as { content?: unknown }).content) }),
+     *     }))
+     * }
+     * ```
+     */
+    respond(matcher: TestRequestMatcher, response: TestResponse | TestResponder): TestRoute;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/internal/testing/types.d.ts.map

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

package/dist/internal/testing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/internal/testing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internal/testing/types.ts"],"names":[],"mappings":""}

package/dist/internal/testing/wait.d.ts

@@ -0,0 +1,16 @@
+import { TestTimeoutError } from "./errors.js";
+import type { TestWaitOptions } from "./types.js";
+/** Settle a pending wait with a value or a failure */
+export type WaitOutcome<A> = {
+    readonly value: A;
+} | {
+    readonly error: unknown;
+};
+/** Read and check a wait's timeout option, undefined when the wait has no deadline. Misuse throws ConfigurationError */
+export declare function waitTimeout(options: TestWaitOptions | undefined): number | undefined;
+/**
+ * Start a wait and fail it with TestTimeoutError after timeoutMs when one is set, or with the signal's reason when
+ * aborted. The start function receives the settle callback and returns its own cleanup
+ */
+export declare function timedWait<A>(wait: TestTimeoutError["wait"], timeoutMs: number | undefined, signal: AbortSignal | undefined, start: (settle: (outcome: WaitOutcome<A>) => void) => () => void): Promise<A>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/internal/testing/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../src/internal/testing/wait.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,sDAAsD;AACtD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAEhF,wHAAwH;AACxH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAUpF;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACvB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,GACjE,OAAO,CAAC,CAAC,CAAC,CAwBZ"}