@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/bot-runner.js

@@ -0,0 +1,363 @@
+/**
+ * Bot runner core shared by both entry points: Event-handler snapshots, the client lifetime and optional signal handling.
+ * Invariant: SIGINT and SIGTERM are handled only when the runner receives processSignals: true, which the default entry
+ * point passes unless the application sets false and the native entry point passes only when the application sets true.
+ * The listeners are removed after awaited cleanup, and the runner never terminates the consumer process. A requested stop drains running work for drainMs before
+ * the usual shutdown, while every other end shuts down at once. A failed run only sets process.exitCode, unless reportFailure is false. Implements [SDK contracts: Connection and recovery](/docs/SDK-CONTRACTS.md#connection-and-recovery)
+ */
+import * as Cause from "effect/Cause";
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Scope from "effect/Scope";
+import { CriticalWorkerStoppedError } from "#sdk/bot-runner";
+import { ClientClosedError, ConfigurationError } from "#sdk/errors";
+import { readCaller, readInput, suspendMarked } from "./defects.js";
+import { operationSignalError } from "./operation-signal.js";
+import { clientServices } from "./client-registry.js";
+import { ClientLogger, loggingConfiguration } from "./logging.js";
+import { missingTokenMessage, normalizeToken, validateConfiguration } from "./configuration.js";
+import { unsupportedKeyHint } from "./suggest.js";
+import { EventBus } from "./events.js";
+import { botCommandDeliveryKeys, routerSubscriptionOptions } from "./commands.js";
+import { shutdownDrainMs } from "./client/drain.js";
+/** Default delivery for runBot event handlers. Overflow drops the oldest waiting event rather than stopping the bot,
+ * and messageCreate handlers and partitioned handlers run up to eight at a time
+ */
+function botHandlerDefaults(event, partitioned = false) {
+    return { concurrency: event === "messageCreate" || partitioned ? 8 : 1, overflow: "dropOldest" };
+}
+const handlerOptionKeys = [
+    "handler",
+    "concurrency",
+    "partition",
+    "overflow",
+    "maxPendingMessages",
+    "maxPendingBytes",
+    "onError",
+];
+/** Check one event name and its delivery settings with the event bus's own rules, on a detached bus that no client
+ * owns. Opening and immediately stopping a subscription there has no side effects, so the names, suggestions and bounds
+ * stay identical to client.on without keeping a second list of event names
+ */
+function validateBotEvent(event, options, bus) {
+    const { onError, ...delivery } = options;
+    const opened = Effect.runSyncExit(bus.open(event, delivery));
+    if (Exit.isFailure(opened)) {
+        const reason = opened.cause.reasons.find((reason) => reason._tag === "Fail");
+        if (reason?._tag === "Fail" && reason.error instanceof ConfigurationError)
+            throw reason.error;
+        throw Cause.squash(opened.cause);
+    }
+    opened.value.stop();
+    if (onError !== undefined && typeof onError !== "function")
+        throw new ConfigurationError("onError", `The onError setting of the ${JSON.stringify(event)} handler must be a function`);
+}
+/** Read each configured handler once before any client exists, throwing ConfigurationError for a malformed entry,
+ * an unknown event name or invalid delivery settings. An omitted events object registers nothing
+ */
+export function snapshotBotEvents(events) {
+    if (events === undefined)
+        return [];
+    if (typeof events !== "object" || events === null || Array.isArray(events))
+        throw new ConfigurationError("configuration", 'The option "events" must be an object that maps event names to handlers');
+    const bus = new EventBus();
+    const entries = [];
+    for (const [event, entry] of Object.entries(events)) {
+        if (entry === undefined)
+            continue;
+        if (typeof entry === "function") {
+            const options = botHandlerDefaults(event);
+            validateBotEvent(event, options, bus);
+            entries.push({ event: event, handler: entry, options });
+            continue;
+        }
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry))
+            throw new ConfigurationError("handler", `The ${JSON.stringify(event)} entry in events must be a function or an object with a handler`);
+        const unknown = Object.keys(entry).find((key) => !handlerOptionKeys.includes(key));
+        if (unknown !== undefined)
+            throw new ConfigurationError("eventOptions", `Unsupported setting ${JSON.stringify(unknown)} for the ${JSON.stringify(event)} handler`, { hint: unsupportedKeyHint(unknown, handlerOptionKeys, "settings") });
+        const { handler, ...options } = entry;
+        if (typeof handler !== "function")
+            throw new ConfigurationError("handler", `The ${JSON.stringify(event)} handler must be a function`);
+        const settings = Object.freeze({
+            ...botHandlerDefaults(event, options.partition !== undefined),
+            ...Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined)),
+        });
+        validateBotEvent(event, settings, bus);
+        entries.push({ event: event, handler, options: settings });
+    }
+    return entries;
+}
+/** Read the delivery settings of a runBot commands object once before any client exists, and check them with the
+ * rules of the router's attach. Invalid settings throw ConfigurationError. The returned settings go to attach unchanged
+ */
+export function snapshotBotCommandDelivery(commands) {
+    const delivery = {};
+    for (const key of botCommandDeliveryKeys) {
+        const value = commands[key];
+        if (value !== undefined)
+            delivery[key] = value;
+    }
+    validateBotEvent("messageCreate", routerSubscriptionOptions(delivery), new EventBus());
+    return Object.freeze(delivery);
+}
+/** Read the runBot ignoreBots setting, true unless it is false. Any value other than a boolean is misuse */
+export function readIgnoreBots(ignoreBots) {
+    if (ignoreBots !== undefined && typeof ignoreBots !== "boolean")
+        throw new ConfigurationError("configuration", 'The option "ignoreBots" must be true or false');
+    return ignoreBots !== false;
+}
+/** Whether a runBot handler skips this event: A messageCreate or messageUpdate whose author is a bot, while ignoreBots is on */
+export function skipsBotMessage(event, payload, ignoreBots) {
+    return (ignoreBots &&
+        (event === "messageCreate" || event === "messageUpdate") &&
+        payload.author.isBot === true);
+}
+/** The runBot option keys that are not client options. Each entry point removes them before validating the client options,
+ * and the unknown-key hint lists them with the client keys
+ */
+export const botOptionKeys = [
+    "events",
+    "ignoreBots",
+    "commands",
+    "setup",
+    "signal",
+    "processSignals",
+    "reportFailure",
+    "drainMs",
+];
+/** How long a requested stop lets running work finish by default, within the 10 seconds Docker and similar tools wait */
+const defaultBotDrainMs = 5_000;
+/** Check the client settings with createClient's rules before the runner adds signal listeners or creates a client.
+ * Validation reads the settings without creating a logger, cache, socket or request. Misuse throws ConfigurationError,
+ * including for an option key that neither runBot nor createClient supports.
+ * A missing or empty token is returned instead, without a stack, once every other setting is valid, so runBot can
+ * report it like a failed run
+ */
+export function validateBotClientOptions(options, native) {
+    const failure = clientOptionsFailure(options, native);
+    if (failure === undefined)
+        return undefined;
+    if (!(failure instanceof ConfigurationError) ||
+        failure.field !== "token" ||
+        failure.message !== missingTokenMessage)
+        throw failure;
+    // Settings checked after the token, such as the cache, are checked again with a stand-in token
+    const other = clientOptionsFailure({ ...options, token: "stand-in" }, native);
+    if (other !== undefined)
+        throw other;
+    failure.stack = `${failure.name}: ${failure.message}`;
+    return failure;
+}
+function clientOptionsFailure(options, native) {
+    const validated = Effect.runSyncExit(validateConfiguration(options, native, botOptionKeys));
+    if (Exit.isSuccess(validated))
+        return undefined;
+    const reason = validated.cause.reasons.find((reason) => reason._tag === "Fail");
+    return reason?._tag === "Fail" ? reason.error : Cause.squash(validated.cause);
+}
+/** Validate the runner settings before any client exists. Invalid settings are misuse and throw ConfigurationError */
+export function validateRunOptions(options) {
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        throw new ConfigurationError("configuration", "The runBot options must be an object");
+    const { signal, processSignals, reportFailure, drainMs } = options;
+    const signalError = operationSignalError(signal);
+    if (signalError)
+        throw signalError;
+    if (processSignals !== undefined && typeof processSignals !== "boolean")
+        throw new ConfigurationError("configuration", 'The option "processSignals" must be true or false');
+    if (reportFailure !== undefined && typeof reportFailure !== "boolean")
+        throw new ConfigurationError("configuration", 'The option "reportFailure" must be true or false');
+    const drain = shutdownDrainMs({ drainMs });
+    if (drain instanceof ConfigurationError)
+        throw drain;
+}
+/**
+ * Report a finished run's failure once, unless the caller opted out: Log its primary error at Error, unless this logger
+ * already showed that error, and set process.exitCode to 1. The run's outcome is unchanged.
+ * Interruption reports nothing. The default API returns defects by rejecting, which Node reports itself, so only a
+ * native run reports a defect here
+ */
+export function reportBotFailure(exit, logger, options) {
+    return Effect.suspend(() => {
+        if (options.reportFailure === false || Exit.isSuccess(exit) || Cause.hasInterruptsOnly(exit.cause))
+            return Effect.void;
+        const failure = exit.cause.reasons.find((reason) => reason._tag === "Fail");
+        const defect = exit.cause.reasons.find((reason) => reason._tag === "Die");
+        const reported = failure?._tag === "Fail"
+            ? failure.error
+            : defect?._tag === "Die" && logger?.native
+                ? defect.defect
+                : undefined;
+        if (reported === undefined)
+            return Effect.void;
+        process.exitCode = 1;
+        if (logger === undefined || logger.loggedError(reported))
+            return Effect.void;
+        return logger.logEffect({
+            level: "error",
+            category: "lifecycle",
+            code: "lifecycle.botFailed",
+            message: "The bot stopped because of an error, and the process exit code is set to 1",
+            error: reported,
+            ...(logger.native ? { cause: exit.cause } : {}),
+        });
+    });
+}
+/**
+ * A logger for a run that failed before its client existed, built from the client logging settings. Settings that
+ * cannot be used, which may be the misuse being reported, fall back to the default logging, so the failure is still shown
+ */
+export function standaloneBotLogger(clientOptions, native) {
+    let logger;
+    try {
+        logger = loggingConfiguration(clientOptions.logging, native);
+    }
+    catch {
+        // allow-silent: A throwing logging getter is itself the misuse the caller reports through the default logger below
+    }
+    if (!(logger instanceof ClientLogger))
+        logger = loggingConfiguration(undefined, native);
+    const token = normalizeToken(clientOptions.token);
+    if (typeof token === "string")
+        logger.addSecret(token);
+    return logger;
+}
+/**
+ * Register the stop sources. The caller signal's aborted getter and listener methods are application input, so their
+ * throws are marked as application faults. Its listener is added before the process listeners and removed after them,
+ * so a throw from either method never leaves SIGINT or SIGTERM listeners installed
+ */
+function stopSignals(options) {
+    return Effect.acquireRelease(suspendMarked(() => {
+        const stopped = Deferred.makeUnsafe();
+        let requested = readCaller(() => options.signal?.aborted) ?? false;
+        let logger;
+        const stop = (source) => {
+            if (!requested || typeof source === "string")
+                logger?.log({
+                    level: "info",
+                    category: "lifecycle",
+                    code: "lifecycle.stopRequested",
+                    message: typeof source === "string"
+                        ? `Received ${source}, so the bot is shutting down`
+                        : "The signal passed to runBot was aborted, so the bot is shutting down",
+                    ...(typeof source === "string" ? { fields: { signal: source } } : {}),
+                });
+            requested = true;
+            Deferred.doneUnsafe(stopped, Effect.void);
+        };
+        const abort = () => stop();
+        readCaller(() => options.signal?.addEventListener("abort", abort, { once: true }));
+        if (options.processSignals === true) {
+            process.once("SIGINT", stop);
+            process.once("SIGTERM", stop);
+        }
+        if (requested)
+            stop();
+        return Effect.succeed({
+            value: Object.freeze({
+                requested: () => requested,
+                wait: Deferred.await(stopped),
+                attach: (value) => {
+                    logger = value;
+                },
+            }),
+            release: () => Effect.suspend(() => {
+                if (options.processSignals === true) {
+                    process.removeListener("SIGINT", stop);
+                    process.removeListener("SIGTERM", stop);
+                }
+                return readInput(() => options.signal?.removeEventListener("abort", abort));
+            }),
+        });
+    }), ({ release }) => release()).pipe(Effect.map(({ value }) => value));
+}
+function combine(exits) {
+    const combined = Exit.asVoidAll(exits);
+    return (Exit.isFailure(combined) ? Effect.failCause(combined.cause) : Effect.void);
+}
+function supervise(client, workers, stop, drainMs) {
+    return Effect.gen(function* () {
+        const runFiber = yield* Effect.forkScoped(client.run(), { startImmediately: true });
+        const workerFibers = yield* Effect.all(workers.map((worker) => Effect.forkScoped(worker.waitForClose())));
+        const fibers = [runFiber, ...workerFibers];
+        return yield* Effect.gen(function* () {
+            const first = yield* Effect.raceAllFirst([
+                stop.wait.pipe(Effect.as({ kind: "stop" })),
+                ...fibers.map((fiber, index) => Fiber.await(fiber).pipe(Effect.map((exit) => ({ kind: "task", index, exit })))),
+            ]);
+            let unexpected;
+            if (first.kind === "task" &&
+                first.index > 0 &&
+                Exit.isSuccess(first.exit) &&
+                !stop.requested() &&
+                client.state !== "Closing" &&
+                client.state !== "Closed")
+                unexpected = Exit.fail(new CriticalWorkerStoppedError(first.index - 1));
+            const runnerCanCloseRun = fibers[0].pollUnsafe() === undefined && client.state !== "Closing" && client.state !== "Closed";
+            // A requested stop drains running work first. The drained shutdown then ends the run itself, while any
+            // other end, such as a failed subscription, stops at once
+            const drain = first.kind === "stop" ? drainMs : 0;
+            if (runnerCanCloseRun && drain === 0)
+                yield* Fiber.interrupt(runFiber);
+            const shutdown = yield* Effect.exit(client.shutdown(drain === 0 ? undefined : { drainMs: drain }));
+            const outcomes = yield* Fiber.awaitAll(fibers);
+            const run = outcomes[0];
+            const reason = Exit.isFailure(run) && run.cause.reasons.length === 1 ? run.cause.reasons[0] : undefined;
+            const expectedClosure = runnerCanCloseRun && reason?._tag === "Fail" && reason.error instanceof ClientClosedError;
+            const expectedInterruption = runnerCanCloseRun && Exit.isFailure(run) && Cause.hasInterruptsOnly(run.cause);
+            const normalizedRun = expectedClosure || expectedInterruption ? Exit.void : run;
+            return yield* combine([normalizedRun, ...outcomes.slice(1), shutdown, ...(unexpected ? [unexpected] : [])]);
+        }).pipe(Effect.onInterrupt(() => Effect.gen(function* () {
+            const outcomes = yield* Effect.all(fibers.map((fiber) => Fiber.interrupt(fiber).pipe(Effect.andThen(Fiber.await(fiber)))));
+            const shutdown = yield* Effect.exit(client.shutdown());
+            // Interruption already belongs to the parent cause, so retain only additional child failures and defects
+            const retained = outcomes.filter((outcome) => Exit.isFailure(outcome) ? !Cause.hasInterruptsOnly(outcome.cause) : false);
+            return yield* combine([...retained, shutdown]);
+        })));
+    });
+}
+/** One lifetime algorithm for the default Result adapter and the native Effect entry point. A failure before the client
+ * exists is reported through fallbackLogger, when given
+ */
+export function runBotCore(create, install, options, fallbackLogger) {
+    return suspendMarked(() => {
+        if (readCaller(() => options.signal?.aborted))
+            return Effect.void;
+        let logger;
+        return Effect.scoped(Effect.gen(function* () {
+            const stop = yield* stopSignals(options);
+            const client = yield* create;
+            logger = client.logger ?? clientServices(client)?.logging;
+            stop.attach(logger);
+            yield* Effect.addFinalizer(() => client.shutdown());
+            const installation = yield* Effect.forkScoped(install(client));
+            const first = yield* Effect.raceFirst(Fiber.await(installation).pipe(Effect.map((exit) => ({ kind: "installed", exit }))), stop.wait.pipe(Effect.as({ kind: "stop" }))).pipe(Effect.onInterrupt(() => Effect.gen(function* () {
+                yield* Fiber.interrupt(installation);
+                const installed = yield* Fiber.await(installation);
+                const shutdown = yield* Effect.exit(client.shutdown());
+                const retained = Exit.isFailure(installed) && !Cause.hasInterruptsOnly(installed.cause)
+                    ? installed
+                    : Exit.void;
+                return yield* combine([retained, shutdown]);
+            })));
+            if (first.kind === "stop") {
+                yield* Fiber.interrupt(installation);
+                const installed = yield* Fiber.await(installation);
+                const shutdown = yield* Effect.exit(client.shutdown());
+                if (Exit.isFailure(installed) && Cause.hasInterruptsOnly(installed.cause))
+                    return yield* combine([shutdown]);
+                return yield* combine([installed, shutdown]);
+            }
+            if (Exit.isFailure(first.exit)) {
+                const shutdown = yield* Effect.exit(client.shutdown());
+                return yield* combine([first.exit, shutdown]);
+            }
+            return yield* supervise(client, first.exit.value, stop, options.drainMs ?? defaultBotDrainMs);
+        })).pipe(Effect.onExit((exit) => reportBotFailure(exit, logger ?? fallbackLogger?.(), options)));
+    });
+}
+//# sourceMappingURL=bot-runner.js.map

package/dist/internal/bot-runner.js.map

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

package/dist/internal/cache-changes.d.ts

@@ -0,0 +1,43 @@
+import * as Effect from "effect/Effect";
+import type * as Scope from "effect/Scope";
+import type { CacheChange, CacheObserverOptions } from "#sdk/cache";
+import type { CacheKind } from "#sdk/client";
+import type { MessageCore } from "#sdk/messages";
+import type { CacheObserver } from "#sdk/api/default/cache";
+import type { CacheObserver as NativeCacheObserver } from "#sdk/api/effect/cache";
+import type { ClientOwner } from "./client.js";
+/** One registered listener in either entry point's form */
+interface Observer {
+    /** Emission sequence number at registration. Only later records are delivered */
+    readonly since: number;
+    deliver(change: CacheChange): void;
+    close(): void;
+}
+/** Client-wide cache change fan-out. Caches call record after applying a change */
+export declare class CacheChangeHub {
+    #private;
+    /** Whether any listener is registered, so caches can skip building change records */
+    get active(): boolean;
+    /** Queue one applied change for the registered listeners. Never runs a listener inline and never throws */
+    record(kind: CacheKind, op: CacheChange["op"], key: string | null): void;
+    /** A new observer identifier, also given to registrations after closure */
+    nextId(): string;
+    /** Register an observer, or return undefined after client closure, when no further change can occur */
+    add(create: (since: number) => Observer): Observer | undefined;
+    remove(observer: Observer): void;
+    /** Close every observer once its owner client closes. Watching starts with the first registration */
+    watch(owner: Pick<ClientOwner<MessageCore>, "subscribe">): void;
+    /**
+     * Deliver the changes already recorded, including shutdown's final clears, then close every observer. A listener
+     * at its concurrency keeps them waiting, so its observer drops them with a Warn rather than holding shutdown
+     */
+    close(): void;
+}
+/** Default-API cache.onChange: Listeners run from a microtask, and returned promises are observed but not awaited */
+export declare const defaultCacheOnChange: <M extends MessageCore>({ owner }: {
+    readonly owner: ClientOwner<M>;
+}) => (listener: (change: CacheChange) => unknown, options?: CacheObserverOptions) => CacheObserver;
+/** Native cache.onChange: Each change forks the listener Effect with the registration services, closed with its Scope */
+export declare const nativeCacheOnChange: <M extends MessageCore>(owner: ClientOwner<M>) => <E = never, R = never>(listener: (change: CacheChange) => Effect.Effect<unknown, E, R>, options?: CacheObserverOptions) => Effect.Effect<NativeCacheObserver, never, R | Scope.Scope>;
+export {};
+//# sourceMappingURL=cache-changes.d.ts.map

package/dist/internal/cache-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-changes.d.ts","sourceRoot":"","sources":["../../src/internal/cache-changes.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAO9C,2DAA2D;AAC3D,UAAU,QAAQ;IACd,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,KAAK,IAAI,IAAI,CAAA;CAChB;AAID,mFAAmF;AACnF,qBAAa,cAAc;;IASvB,qFAAqF;IACrF,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,2GAA2G;IAC3G,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAMvE;IAaD,2EAA2E;IAC3E,MAAM,IAAI,MAAM,CAEf;IAED,uGAAuG;IACvG,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAK7D;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,QAGxB;IAED,qGAAqG;IACrG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,QAMvD;IAED;;;OAGG;IACH,KAAK,SAOJ;CACJ;AA6ID,qHAAqH;AACrH,eAAO,MAAM,oBAAoB,GAC5B,CAAC,SAAS,WAAW,aAAa;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,gBAC1D,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,YAAY,oBAAoB,KAAG,aA2C7E,CAAA;AAEL,yHAAyH;AACzH,eAAO,MAAM,mBAAmB,GAC3B,CAAC,SAAS,WAAW,SAAS,WAAW,CAAC,CAAC,CAAC,MAC5C,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,YACP,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,YACrD,oBAAoB,KAC/B,MAAM,CAAC,MAAM,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAoDtD,CAAA"}