@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/testing/harness.js

@@ -0,0 +1,280 @@
+/**
+ * Test client harness shared by the default and native testing entry points: Option handling, log capture and the
+ * in-memory transport pair.
+ * Invariant: A test client reaches no network. Its options always route HTTP and WebSocket traffic through the fake
+ * transport, its log records reach logs() and any caller sinks at the caller's level, its unhandled failures reach
+ * failures() and the shutdown check at any level, and closing the harness closes every fake socket and refuses later
+ * requests. This module has no Effect imports, so default declarations stay free of Effect.
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+// Real timers even when a test fakes the global ones, so idle can count quiet event loop turns
+import { clearTimeout, setTimeout } from "node:timers";
+import { ClientClosedError, ConfigurationError } from "#sdk/errors";
+import { clientOptionKeys } from "../configuration.js";
+import { unsupportedKeyHint } from "../suggest.js";
+import { createFixtures, fixtureToken } from "./fixtures.js";
+import { TestGateway } from "./gateway.js";
+import { TestHttp } from "./http.js";
+import { UnhandledTestFailuresError } from "./errors.js";
+import { timedWait, waitTimeout } from "./wait.js";
+const defaultHeartbeatIntervalMs = 41_250;
+const levels = ["trace", "debug", "info", "warn", "error", "fatal", "silent"];
+/** Consecutive quiet event loop turns after which idle treats the client as settled */
+const idleTurns = 3;
+/**
+ * Codes the failure reporter logs at Error for a handler, command, callback, scheduled task or onError hook failure, or
+ * a subscription stopped by overflow. The reported value can be any error, such as the Fluxer rejection of a failed
+ * reply a handler returned, so these records count whatever the error's origin
+ */
+const reportedFailureCodes = new Set([
+    "events.handlerFailed",
+    "events.hookFailed",
+    "events.overflow",
+    "commands.failed",
+    "collectors.callbackFailed",
+    "collectors.filterFailed",
+    "cleanup.progressFailed",
+    "cache.policyFailed",
+    "lifecycle.observerFailed",
+    "lifecycle.taskFailed",
+]);
+/**
+ * Whether a record reports a failure no application code handled: A failure the reporter logged at Error because no
+ * onError hook took it, or another application callback failure logged at Error or Fatal. Failures of the test's own
+ * response handlers are excluded, because they deliberately simulate network errors
+ */
+function unhandledFailure(record) {
+    if (record.level !== "error" && record.level !== "fatal")
+        return false;
+    if (reportedFailureCodes.has(record.code))
+        return true;
+    return record.error?.origin === "application" && !record.code.startsWith("testing.");
+}
+/** Whether a record at this level and category passes the caller's thresholds, as the SDK logger decides */
+function passes(logging, level, category) {
+    const threshold = logging?.categories?.[category] ?? logging?.level ?? "info";
+    return levels.indexOf(level) >= levels.indexOf(threshold);
+}
+/** Test settings that test clients accept besides the client options */
+const testSettingKeys = ["user", "heartbeatIntervalMs"];
+/**
+ * Reject option keys that a test client does not accept, before any client exists. Transport and instance get their
+ * own explanation, because the test client owns them. Any other unknown key gets createClient's closest-name hint,
+ * listing the client keys a test client accepts, the test settings and extraKeys, such as the runBot keys of createTestBot
+ */
+export function checkTestOptionKeys(options, extraKeys = []) {
+    const { transport, instance } = options;
+    if (transport !== undefined || instance !== undefined)
+        throw new ConfigurationError("configuration", "Test clients own the transport and instance options, so neither may be supplied", { hint: "Remove transport and instance. Test clients always use hosted Fluxer endpoints in memory" });
+    const supported = [
+        ...clientOptionKeys.filter((key) => key !== "transport" && key !== "instance"),
+        ...testSettingKeys,
+        ...extraKeys,
+    ];
+    const unsupported = Object.keys(options).find((key) => !supported.includes(key) && key !== "transport" && key !== "instance");
+    if (unsupported !== undefined)
+        throw new ConfigurationError("configuration", `Unsupported option ${JSON.stringify(unsupported)}`, {
+            hint: unsupportedKeyHint(unsupported, supported),
+        });
+}
+/** The in-memory transport, records and fixtures owned by one test client */
+export class TestHarness {
+    fixtures = createFixtures();
+    http;
+    gateway;
+    #records = [];
+    /** Every Error and Fatal record of the client, captured before its logging thresholds and deduplication */
+    #errors = [];
+    /** Unhandled failure records that failures() returned or shutdown already reported */
+    #observed = new WeakSet();
+    /** Pending idle waits, failed with ClientClosedError when the harness closes */
+    #idleWaits = new Set();
+    #callerSinks;
+    #logging;
+    #closed = false;
+    constructor(options) {
+        if (typeof options !== "object" || options === null)
+            throw new ConfigurationError("configuration", "Test client options must be an object");
+        checkTestOptionKeys(options);
+        const { user, heartbeatIntervalMs = defaultHeartbeatIntervalMs } = options;
+        if (!Number.isSafeInteger(heartbeatIntervalMs) ||
+            heartbeatIntervalMs < 1 ||
+            heartbeatIntervalMs > 2_147_483_647)
+            throw new ConfigurationError("configuration", "Test heartbeatIntervalMs must be an integer from 1 through 2,147,483,647");
+        if (user !== undefined && (typeof user !== "object" || user === null || typeof user.id !== "string"))
+            throw new ConfigurationError("configuration", "Test user must be a wire user object with a string id");
+        const logging = options.logging;
+        this.#logging = typeof logging === "object" && logging !== null ? logging : undefined;
+        const sink = this.#logging?.sink;
+        this.#callerSinks = typeof sink === "function" ? [sink] : Array.isArray(sink) ? sink : [];
+        const bot = user ?? this.fixtures.botUser();
+        this.http = new TestHttp((record) => this.#record(record), { fixtures: this.fixtures, author: bot });
+        this.gateway = new TestGateway({ user: bot, heartbeatIntervalMs });
+    }
+    /** Client options with the fake transport, a default token and log capture added to the caller's settings */
+    clientOptions(options) {
+        const { user: _, heartbeatIntervalMs: __, ...client } = options;
+        const logging = client.logging;
+        const capture = (record) => {
+            this.#records.push(record);
+        };
+        const sink = logging?.sink;
+        return {
+            ...client,
+            token: options.token ?? fixtureToken,
+            transport: { fetch: this.http.fetch, webSocket: this.gateway.webSocket },
+            // Malformed logging settings pass through unchanged, so client creation reports them as usual
+            logging: logging === undefined
+                ? { sink: capture }
+                : typeof logging !== "object" || logging === null
+                    ? logging
+                    : {
+                        ...logging,
+                        sink: sink === undefined
+                            ? capture
+                            : typeof sink === "function"
+                                ? [sink, capture]
+                                : Array.isArray(sink) && sink.length > 0
+                                    ? [...sink, capture]
+                                    : sink,
+                    },
+        };
+    }
+    /** Log records captured so far, in order */
+    logs() {
+        return Object.freeze([...this.#records]);
+    }
+    /**
+     * Record an Error or Fatal record of the client before its thresholds and deduplication. Each entry point sets
+     * this as the client logger's errorTap, so a quiet logging level cannot hide a failure from failures() or shutdown
+     */
+    captureError = (record) => {
+        this.#errors.push(record);
+    };
+    /** Unhandled failure records so far, in order. Returning them marks them as observed by the test */
+    failures() {
+        const failures = this.#errors.filter(unhandledFailure);
+        for (const record of failures)
+            this.#observed.add(record);
+        return Object.freeze(failures);
+    }
+    /** Throw UnhandledTestFailuresError for unhandled failures the test has not observed, then mark them observed */
+    checkFailures() {
+        const unobserved = this.#errors.filter((record) => unhandledFailure(record) && !this.#observed.has(record));
+        if (unobserved.length === 0)
+            return;
+        for (const record of unobserved)
+            this.#observed.add(record);
+        throw new UnhandledTestFailuresError(unobserved);
+    }
+    /**
+     * Resolve once the client has no running handler, scheduled task run, REST request or unanswered test request and
+     * produced no new log record, request or gateway command for several event loop turns. A scheduled task waiting for
+     * its time does not count, so a test advances its clock to run it
+     */
+    idle(work, options, signal) {
+        const timeoutMs = waitTimeout(options);
+        if (this.#closed)
+            return Promise.reject(new ClientClosedError());
+        const busy = () => {
+            const { diagnostics: { events, rest, gatewayRequests }, runningTasks, pendingHandlers, } = work();
+            return (events.activeHandlers +
+                pendingHandlers +
+                rest.activeRequests +
+                rest.queuedRequests +
+                gatewayRequests.activeRequests +
+                runningTasks >
+                0);
+        };
+        const activity = () => `${this.#records.length}:${this.http.requests().length}:${this.gateway.commands().length}`;
+        return timedWait("idle", timeoutMs, signal, (settle) => {
+            let quiet = 0;
+            let stalled = 0;
+            let last = activity();
+            let timer;
+            // Set by a global setImmediate callback, which Effect fibers also run on. A turn in which it did not run
+            // proves nothing, because fake timers that replace setImmediate stop every fiber, so it is never counted as quiet
+            let turned = false;
+            const turn = () => {
+                turned = true;
+            };
+            const fail = (error) => settle({ error });
+            // A zero-delay timer passes a whole event loop turn, including the immediate callbacks Effect fibers run on
+            const check = () => {
+                const now = activity();
+                quiet = turned && now === last && this.http.inFlight === 0 && !busy() ? quiet + 1 : 0;
+                stalled = turned ? 0 : stalled + 1;
+                last = now;
+                if (quiet >= idleTurns)
+                    return settle({ value: undefined });
+                if (stalled >= idleTurns)
+                    return fail(new ConfigurationError("configuration", "Test idle cannot settle while setImmediate is faked", {
+                        hint: 'The SDK runs on setImmediate. Leave it real, for example vi.useFakeTimers({ toFake: ["setTimeout", "clearTimeout", "setInterval", "clearInterval", "Date"] })',
+                    }));
+                turned = false;
+                globalThis.setImmediate(turn);
+                timer = setTimeout(check, 0);
+            };
+            globalThis.setImmediate(turn);
+            timer = setTimeout(check, 0);
+            this.#idleWaits.add(fail);
+            return () => {
+                clearTimeout(timer);
+                this.#idleWaits.delete(fail);
+            };
+        });
+    }
+    /**
+     * Deliver a MESSAGE_CREATE from a human author, wait until the client settles as idle does, then return the
+     * messages the client sent meanwhile. Misuse and emitting before ready throw synchronously, as idle and emit do
+     */
+    say(work, content, options, signal) {
+        if (typeof content !== "string")
+            throw new ConfigurationError("configuration", "Test say content must be a string");
+        waitTimeout(options);
+        const overrides = options?.message;
+        if (overrides !== undefined &&
+            (typeof overrides !== "object" || overrides === null || Array.isArray(overrides)))
+            throw new ConfigurationError("configuration", "Test say message overrides must be an object of wire fields");
+        if (this.#closed)
+            return Promise.reject(new ClientClosedError());
+        const before = this.http.requests().length;
+        this.gateway.emit("MESSAGE_CREATE", this.fixtures.message({ ...overrides, content }), undefined);
+        return this.idle(work, options, signal).then(() => this.http.sentMessages(this.http.requests().slice(before)));
+    }
+    /** Record a test transport event in logs() and in caller sinks, at the caller's thresholds */
+    #record(input) {
+        if (!passes(this.#logging, input.level, input.category))
+            return;
+        const record = Object.freeze({ time: new Date().toISOString(), ...input });
+        this.#records.push(record);
+        for (const sink of this.#callerSinks) {
+            try {
+                sink(record);
+            }
+            catch (error) {
+                // A failing caller sink stays visible in the test's own output, as it would for SDK records
+                console.error("Fluxerly test log sink failed:", error);
+            }
+        }
+    }
+    /** Close the fake transport after the client shut down. Reports sockets the client left open */
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.http.close();
+        for (const fail of this.#idleWaits)
+            fail(new ClientClosedError());
+        const open = this.gateway.close();
+        if (open > 0)
+            this.#record({
+                level: "warn",
+                category: "lifecycle",
+                code: "testing.socketsLeftOpen",
+                message: `The test client left ${open} gateway ${open === 1 ? "socket" : "sockets"} open after shutdown, so the test transport closed ${open === 1 ? "it" : "them"}`,
+                fields: { sockets: open },
+            });
+    }
+}
+//# sourceMappingURL=harness.js.map

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

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

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

@@ -0,0 +1,31 @@
+import type { LogRecord } from "#sdk/logging";
+import { type Fixtures, type WireMessage, type WireUser } from "./fixtures.js";
+import type { TestRequest, TestRequestMatcher, TestResponder, TestResponse, TestRest, TestRoute, TestWaitOptions } from "./types.js";
+/** A registered route with the abort signal the native entry point passes to next for interruption */
+export interface InternalTestRoute extends TestRoute {
+    next(options?: TestWaitOptions, signal?: AbortSignal): Promise<TestRequest>;
+}
+/** The fixtures and bot account that automatic message replies are built from */
+export interface TestReplies {
+    readonly fixtures: Fixtures;
+    readonly author: WireUser;
+}
+/** The fake HTTP side of one test client */
+export declare class TestHttp implements TestRest {
+    #private;
+    private readonly record;
+    private readonly replies;
+    constructor(record: (record: Omit<LogRecord, "time">) => void, replies: TestReplies);
+    /** Requests received but not yet answered, including ones whose response handler is still running */
+    get inFlight(): number;
+    respond(matcher: TestRequestMatcher, response: TestResponse | TestResponder): InternalTestRoute;
+    /** Requests received so far, in order, excluding the discovery bootstrap */
+    requests(): readonly TestRequest[];
+    /** The messages described by the message sends among these requests, in order */
+    sentMessages(requests: readonly TestRequest[]): readonly WireMessage[];
+    /** The fetch-compatible function passed to the client's transport option */
+    readonly fetch: (url: string, init: RequestInit) => Promise<Response>;
+    /** Refuse later requests and fail pending next calls with ClientClosedError */
+    close(): void;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/internal/testing/http.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAoB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAChG,OAAO,KAAK,EACR,WAAW,EAEX,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,eAAe,EAClB,MAAM,YAAY,CAAA;AAcnB,sGAAsG;AACtG,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAChD,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC9E;AAcD,iFAAiF;AACjF,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAA;CAC5B;AA+KD,4CAA4C;AAC5C,qBAAa,QAAS,YAAW,QAAQ;;IAWjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF5B,YACqB,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI,EACjD,OAAO,EAAE,WAAW,EACrC;IAEJ,qGAAqG;IACrG,IAAI,QAAQ,WAEX;IAED,OAAO,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,iBAAiB,CA0B9F;IAED,4EAA4E;IAC5E,QAAQ,IAAI,SAAS,WAAW,EAAE,CAEjC;IAED,iFAAiF;IACjF,YAAY,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,CAErE;IAQD,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,QAAe,MAAM,QAAQ,WAAW,KAAG,OAAO,CAAC,QAAQ,CAAC,CAOzE;IAoFD,+EAA+E;IAC/E,KAAK,SAGJ;CACJ"}