@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/default-commands.js

@@ -0,0 +1,488 @@
+import { readCaller, thrownReason } from "#sdk/internal/defects";
+import { commandHelp, contextHelpOptions } from "#sdk/internal/command-help";
+import { parseQuotedPrefixCommand } from "#sdk/commands";
+import { ApplicationError, CancelledError, ConfigurationError, SdkDefect } from "#sdk/errors";
+import { configurationEffect, cooldownRequest, cooldownSuffix, createMemoryCooldownStore, snapshotClaimInput, dispatchCommand, PrefixCommandRegistry, rejectionReply, routerSubscriptionOptions, sameCommandPath, snapshotCommandDefinition, snapshotCommandCooldown, validateCommandShape, checkBotCommandKeys, } from "#sdk/internal/commands";
+import { convertCommandArguments } from "#sdk/internal/command-arguments";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { clientServices } from "#sdk/internal/client-registry";
+import { makeReport, messageReference, primaryError, promiseHook, throwIfErr } from "#sdk/internal/failures";
+import { currentRejectionScope, fiberRejectionScope, inRejectionScope, withRejectionScope, } from "#sdk/internal/rejection-scope";
+import { recordCommandFailure } from "#sdk/internal/events";
+import { errAsync } from "neverthrow";
+import { askerPageOptions } from "#sdk/internal/reaction-pages";
+/** Router option keys this API adds to the shared ones */
+const routerAdapterKeys = ["onUnmatched", "onReject", "use"];
+/** Default-API command tools exposed through the public `commands` namespace, with immediate creation and registration */
+export const defaultCommands = Object.freeze({
+    create: (options) => attempt(() => {
+        const registry = new PrefixCommandRegistry(options, routerAdapterKeys);
+        return freezeRouter(new DefaultPrefixCommandRouterOwner(registry, readCaller(() => snapshotRouterSettings(options))));
+    }),
+    parseQuoted: parseQuotedPrefixCommand,
+    memoryCooldowns: (options) => attempt(() => defaultMemoryCooldownStore(createMemoryCooldownStore(options))),
+});
+class DefaultPrefixCommandRouterOwner {
+    #registry;
+    #settings;
+    constructor(registry, settings) {
+        this.#registry = registry;
+        this.#settings = settings;
+    }
+    get commands() {
+        return this.#registry.commands;
+    }
+    get groups() {
+        return this.#registry.groups;
+    }
+    help(options) {
+        return attempt(() => commandHelp(this.#registry.visibleEntries, options));
+    }
+    register(command, options) {
+        return attempt(() => freezeRouter(new DefaultPrefixCommandRouterOwner(this.#registry.register(readCaller(() => snapshotDefaultCommand(command)), options), this.#settings)));
+    }
+    registerMany(commands, options) {
+        return attempt(() => {
+            const stored = readCaller(() => snapshotDefaultCommandBatch(commands));
+            return freezeRouter(new DefaultPrefixCommandRouterOwner(this.#registry.registerMany(stored, options), this.#settings));
+        });
+    }
+    registerGroup(group, options) {
+        return attempt(() => freezeRouter(new DefaultPrefixCommandRouterOwner(this.#registry.registerGroup(group, options), this.#settings)));
+    }
+    attach(client, options) {
+        const services = clientServices(client);
+        const onError = attempt(() => readCaller(() => options?.onError));
+        if (onError !== undefined && typeof onError !== "function")
+            throw new ConfigurationError("onError", 'The option "onError" must be a function');
+        // The router's own hook gets one bounded queue, so a failed command only enqueues its report and the hook
+        // never holds a command slot. client.on never sees onError, so no second queue can reorder the reports
+        const hooks = services && onError !== undefined
+            ? services.failures.subscriptionQueue(promiseHook(onError), undefined)
+            : undefined;
+        let subscriptionId;
+        const report = (services) => (message, name, cause) => Effect.withFiber((fiber) => {
+            recordCommandFailure(name, cause, fiber.context);
+            try {
+                const internal = makeReport({
+                    kind: "handler",
+                    cause,
+                    event: "messageCreate",
+                    command: name,
+                    subscriptionId,
+                    message: messageReference(message),
+                }, services.logging.secrets);
+                if (!hooks)
+                    services.failures.report(internal, fiber.context);
+                else {
+                    services.logging.count("handlerFailures");
+                    hooks.offer(internal);
+                }
+            }
+            catch (fault) {
+                services.logging.outputFailure(fault);
+            }
+            return Effect.void;
+        });
+        const registered = client.on("messageCreate", (message, signal) => this.dispatch(client, message, signal, services, services && report(services)), routerSubscriptionOptions(options));
+        subscriptionId = registered.id;
+        return registered;
+    }
+    dispatch(client, message, signal, services, report) {
+        const registry = this.#registry;
+        const settings = this.#settings;
+        const logger = services?.logging;
+        const operation = dispatchCommand(registry, message, {
+            logger,
+            ...(report === undefined
+                ? {}
+                : { failed: (name, cause) => report(message, name, cause) }),
+            prefix: (resolver, value) => defaultCallback(() => resolver(value)),
+            ...(services === undefined ? {} : { selfId: () => services.selfUserId() }),
+            context: (match) => Object.freeze({
+                client,
+                message,
+                prefix: match.prefix,
+                name: match.definition.name,
+                ...(match.path === undefined ? {} : { path: match.path }),
+                args: Object.freeze([...match.parse.args]),
+                rawArgs: match.parse.rawArgs,
+                signal,
+                reply: boundDefaultReply(client, message, signal),
+                help: (options) => this.help(contextHelpOptions(options, match.prefix)),
+                paginate: boundDefaultPaginate(client, message, signal),
+                sendHelp: (options) => {
+                    let pages;
+                    try {
+                        pages = this.help(contextHelpOptions(options, match.prefix));
+                    }
+                    catch (error) {
+                        if (error instanceof ConfigurationError)
+                            return errAsync(error);
+                        throw error;
+                    }
+                    return boundDefaultPaginate(client, message, signal)(pages);
+                },
+            }),
+            ...(settings.use.length === 0
+                ? {}
+                : {
+                    around: (context, rest) => aroundCommand(settings.use, context, rest, report && ((cause) => report(message, context.name, cause))),
+                }),
+            guard: (definition, context) => definition.guards.length === 0
+                ? Effect.succeed(true)
+                : defaultCallback(async () => {
+                    for (const guard of definition.guards) {
+                        const verdict = await guard(context);
+                        throwIfErr(verdict);
+                        if (verdict !== true)
+                            return verdict;
+                    }
+                    return true;
+                }),
+            convert: (definition, context) => convertCommandArguments(definition.arguments, context.args, { guildId: context.message.guildId }),
+            executionContext: (context, values) => Object.freeze({
+                ...context,
+                values: values,
+            }),
+            unmatched: settings.onUnmatched === undefined
+                ? undefined
+                : (match) => defaultCallback(() => settings.onUnmatched(Object.freeze({
+                    client,
+                    message,
+                    prefix: match.prefix,
+                    signal,
+                    reply: boundDefaultReply(client, message, signal),
+                }), match.unmatched)),
+            feedback: (definition) => {
+                const feedback = definition.onReject ?? settings.onReject;
+                return feedback === undefined || feedback === "silent"
+                    ? undefined
+                    : feedback === "reply"
+                        ? "reply"
+                        : "callback";
+            },
+            reject: (definition, context, rejection, now) => {
+                const feedback = definition.onReject ?? settings.onReject;
+                if (feedback === undefined || feedback === "silent")
+                    return Effect.void;
+                if (feedback === "reply") {
+                    const path = context.path ?? [context.name];
+                    const metadata = registry.commands.find((command) => sameCommandPath(command.path ?? [command.name], path));
+                    const text = rejectionReply(rejection, metadata, context.prefix, now);
+                    return text === undefined ? Effect.void : defaultCallback(() => context.reply(text));
+                }
+                return defaultCallback(() => feedback(context, rejection));
+            },
+            cooldown: (definition, context, routerStore) => defaultCooldown(definition, context, routerStore),
+            execute: (definition, context) => defaultCallback(() => definition.execute(context)),
+            active: () => !signal.aborted,
+        });
+        if (signal.aborted)
+            return Promise.resolve();
+        const controller = new AbortController();
+        const abort = () => controller.abort();
+        signal.addEventListener("abort", abort, { once: true });
+        // The router runs as a client.on handler, so its commands share that invocation's rejection records
+        return Effect.runPromise(withRejectionScope(operation, currentRejectionScope()), { signal: controller.signal })
+            .catch((error) => {
+            if (signal.aborted)
+                return;
+            throw error;
+        })
+            .finally(() => signal.removeEventListener("abort", abort));
+    }
+}
+/**
+ * Run middleware in order around the rest of a command. Each stage, including the rest, runs at most once: A repeated
+ * or concurrent `next()` returns the first call's promise, which rejects with the command's primary error.
+ * The command's failure is reported once with its command name whether middleware recovers from it, rethrows it or
+ * replaces it. A different middleware failure is reported after it, and interruption keeps an earlier command failure
+ */
+function aroundCommand(middleware, context, rest, report) {
+    const signal = context.signal;
+    return Effect.withFiber((fiber) => {
+        const rejections = fiberRejectionScope(fiber.context);
+        let outcome;
+        let restExit;
+        let restError;
+        const stages = [];
+        const step = (index) => {
+            const started = stages[index];
+            if (started !== undefined)
+                return started;
+            if (index < middleware.length) {
+                const stage = new Promise((resolve) => resolve(inRejectionScope(rejections, () => middleware[index](context, () => step(index + 1))))).then(throwIfErr);
+                stages[index] = stage;
+                return stage;
+            }
+            const stage = (outcome = Effect.runPromiseExit(withRejectionScope(rest, rejections), { signal })).then((exit) => {
+                restExit = exit;
+                if (Exit.isFailure(exit))
+                    throw (restError = primaryError(exit.cause));
+            });
+            // allow-silent: settleAround reports the saved command failure even when no middleware awaits this rejection
+            stage.catch(() => undefined);
+            stages[index] = stage;
+            return stage;
+        };
+        const settle = settleAround(() => restExit, (cause) => primaryError(cause) === restError, report);
+        // @effect-diagnostics-next-line unknownInEffectCatch:off
+        return Effect.tryPromise({ try: () => step(0), catch: (error) => error }).pipe(Effect.exit, 
+        // Middleware that did not await next still waits for the command, so its failure is not lost
+        Effect.tap(() => Effect.promise(() => outcome ?? Promise.resolve(undefined))), Effect.flatMap((exit) => settle.finish(Exit.isSuccess(exit)
+            ? undefined
+            : Cause.hasInterrupts(exit.cause)
+                ? exit.cause
+                : Cause.die(primaryError(exit.cause)))), Effect.onExit(() => settle.saved));
+    });
+}
+/**
+ * Settle a command wrapped by middleware. The command's own failure is reported once, with its command name, whether
+ * middleware succeeded, threw it again or failed differently. A different middleware failure is reported after it.
+ * The `saved` argument reports a command failure that nothing else settled, such as after interruption
+ */
+function settleAround(restExit, rethrown, report) {
+    let settled = false;
+    const commandFailure = () => {
+        const exit = restExit();
+        return exit !== undefined && Exit.isFailure(exit) ? exit.cause : undefined;
+    };
+    const saved = Effect.suspend(() => {
+        const failure = commandFailure();
+        if (settled || failure === undefined || report === undefined || Cause.hasInterrupts(failure))
+            return Effect.void;
+        settled = true;
+        return report(failure);
+    });
+    const finish = (middlewareFailure) => Effect.suspend(() => {
+        const failure = commandFailure();
+        if (failure === undefined)
+            return middlewareFailure === undefined ? Effect.void : Effect.failCause(middlewareFailure);
+        // Recovered or rethrown, the command's failure reaches the dispatcher's report once
+        if (middlewareFailure === undefined ||
+            (!Cause.hasInterrupts(middlewareFailure) && rethrown(middlewareFailure))) {
+            settled = true;
+            return Effect.failCause(failure);
+        }
+        // Without a separate report, one combined failure still carries both errors
+        if (report === undefined) {
+            settled = true;
+            return Effect.failCause(Cause.combine(failure, middlewareFailure));
+        }
+        return saved.pipe(Effect.andThen(Effect.failCause(middlewareFailure)));
+    });
+    return { finish, saved };
+}
+function snapshotRouterSettings(options) {
+    const { onUnmatched, onReject, use } = options;
+    if (onUnmatched !== undefined && typeof onUnmatched !== "function")
+        throw new ConfigurationError("commands", 'The option "onUnmatched" must be a function');
+    if (onReject !== undefined && onReject !== "reply" && onReject !== "silent" && typeof onReject !== "function")
+        throw new ConfigurationError("commands", 'The option "onReject" must be "reply", "silent" or a function');
+    return Object.freeze({
+        ...(onUnmatched === undefined ? {} : { onUnmatched }),
+        ...(onReject === undefined ? {} : { onReject }),
+        use: snapshotFunctions(use, 'The option "use" must be an array of middleware functions'),
+    });
+}
+function snapshotFunctions(value, message) {
+    if (value === undefined)
+        return Object.freeze([]);
+    if (!Array.isArray(value))
+        throw new ConfigurationError("commands", message);
+    const copied = [];
+    for (let index = 0; index < value.length; index += 1) {
+        if (!Object.hasOwn(value, index) || typeof value[index] !== "function")
+            throw new ConfigurationError("commands", message);
+        copied.push(value[index]);
+    }
+    return Object.freeze(copied);
+}
+function snapshotDefaultCommand(command, keyedName) {
+    validateCommandShape(command, [
+        "name",
+        "aliases",
+        "description",
+        "usage",
+        "hidden",
+        "arguments",
+        "guard",
+        "onReject",
+        "cooldown",
+        "execute",
+    ]);
+    const { execute, guard, onReject, cooldown: sourceCooldown } = command;
+    if (typeof execute !== "function")
+        throw new ConfigurationError("command", 'The command option "execute" must be a function');
+    const guards = guard === undefined
+        ? Object.freeze([])
+        : typeof guard === "function"
+            ? Object.freeze([guard])
+            : snapshotFunctions(guard, 'The option "guard" must be a function or an array of functions');
+    if (onReject !== undefined && onReject !== "reply" && onReject !== "silent" && typeof onReject !== "function")
+        throw new ConfigurationError("command", 'The option "onReject" must be "reply", "silent" or a function');
+    const cooldown = snapshotCommandCooldown(sourceCooldown);
+    const definition = snapshotCommandDefinition(command, keyedName);
+    return Object.freeze({
+        ...definition,
+        execute: execute,
+        guards: guards,
+        ...(onReject === undefined ? {} : { onReject }),
+        ...(cooldown === undefined ? {} : { cooldown: cooldown }),
+    });
+}
+function snapshotDefaultCommandBatch(commands) {
+    if (typeof commands !== "object" || commands === null || Array.isArray(commands))
+        throw new ConfigurationError("command", "A command batch must be an object");
+    for (const key of Reflect.ownKeys(commands))
+        if (typeof key === "symbol" && Object.prototype.propertyIsEnumerable.call(commands, key))
+            throw new ConfigurationError("command", "Command batch keys must be strings");
+    const names = Object.keys(commands);
+    if (names.length === 0)
+        throw new ConfigurationError("command", "A command batch must not be empty");
+    const stored = [];
+    for (const name of names) {
+        const value = commands[name];
+        if (typeof value !== "object" || value === null || Array.isArray(value))
+            throw new ConfigurationError("command", `The command batch entry ${JSON.stringify(name)} must be an object`);
+        if (Object.prototype.hasOwnProperty.call(value, "name"))
+            throw new ConfigurationError("command", `The command batch entry ${JSON.stringify(name)} must not set "name", because its object key is the name`);
+        stored.push(snapshotDefaultCommand(value, name));
+    }
+    return Object.freeze(stored);
+}
+/**
+ * Create the command tools a runBot commands option describes, registering its keyed commands or its register callback.
+ * Rejections are answered with `onReject: "reply"` unless the option selects other feedback.
+ * Bot-authored messages are skipped as the runBot ignoreBots setting says, unless the option sets its own ignoreBots.
+ * Misuse throws ConfigurationError. A register callback's own throw becomes ApplicationError naming `runBot commands`
+ */
+export function botRouter(options, ignoreBots) {
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        throw new ConfigurationError("commands", "The commands option must be an object");
+    checkBotCommandKeys(options, routerAdapterKeys);
+    // The onError hook and delivery settings belong to the router's attachment, which runBot makes with them
+    const { commands: definitions, onError: _onError, concurrency: _concurrency, partition: _partition, overflow: _overflow, maxPendingMessages: _maxPendingMessages, maxPendingBytes: _maxPendingBytes, ...settings } = options;
+    const router = defaultCommands.create({
+        ...settings,
+        ignoreBots: settings.ignoreBots ?? ignoreBots,
+        onReject: settings.onReject ?? "reply",
+    });
+    if (typeof definitions === "function") {
+        const registered = registerCallback(() => definitions(router));
+        if (typeof registered !== "object" ||
+            registered === null ||
+            !(registered instanceof DefaultPrefixCommandRouterOwner))
+            throw new ConfigurationError("commands", "A commands register callback must return the registered router");
+        return registered;
+    }
+    return router.registerMany(definitions);
+}
+/** Reply to one message with a string or message input, applying the handler's cancellation signal */
+export function boundDefaultReply(client, message, signal) {
+    return (input, options) => client.messages.reply(message, input, bindDefaultReplyOptions(options, signal));
+}
+function boundDefaultPaginate(client, message, signal) {
+    return (pages, options) => client.messages.paginate(message.channelId, pages, askerPageOptions(options, message.author.id, signal));
+}
+function bindDefaultReplyOptions(options, signal) {
+    if (options === undefined)
+        return { signal };
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        return options;
+    // Bind cancellation without reading getters before the operation's async validation and defect boundary
+    return new Proxy(Object.create(null), {
+        get: (_target, property) => (property === "signal" ? signal : Reflect.get(options, property, options)),
+        ownKeys: () => Reflect.ownKeys(options),
+        getOwnPropertyDescriptor: (_target, property) => {
+            const descriptor = Reflect.getOwnPropertyDescriptor(options, property);
+            return descriptor === undefined ? undefined : { ...descriptor, configurable: true };
+        },
+    });
+}
+function defaultCooldown(definition, context, routerStore) {
+    const cooldown = definition.cooldown;
+    if (cooldown === undefined)
+        return Effect.succeed(undefined);
+    return defaultCallback(() => cooldown.key?.(context) ?? cooldownSuffix(cooldown.per, context.message)).pipe(Effect.flatMap((key) => configurationEffect(() => cooldownRequest(context.path ?? definition.name, key, cooldown.durationMs))), Effect.flatMap((request) => {
+        const store = cooldown.store;
+        const claim = store !== undefined
+            ? defaultCallback(() => store.claim(request))
+            : configurationEffect(() => {
+                const claimed = routerStore.claim(request);
+                if (claimed._tag === "Failure")
+                    throw claimed.error;
+                return claimed.value;
+            });
+        return Effect.map(claim, (value) => ({ key: request.key, claim: value }));
+    }));
+}
+function defaultMemoryCooldownStore(owner) {
+    return Object.freeze({
+        maxEntries: owner.maxEntries,
+        get size() {
+            return owner.size;
+        },
+        claim: (input) => {
+            const result = attempt(() => owner.claim(readCaller(() => snapshotClaimInput(input))));
+            if (result._tag === "Success")
+                return result.value;
+            throw result.error;
+        },
+        sweep: () => owner.sweep(),
+        clear: () => owner.clear(),
+    });
+}
+function freezeRouter(router) {
+    return Object.freeze(router);
+}
+/** Run an application callback, treating a returned or resolved Err result like a throw of its error */
+function defaultCallback(callback) {
+    return Effect.withFiber((fiber) => {
+        // Operations the callback starts hold their rejection records for the command's outcome
+        const rejections = fiberRejectionScope(fiber.context);
+        return Effect.tryPromise({
+            try: () => Promise.resolve()
+                .then(() => inRejectionScope(rejections, callback))
+                .then((value) => {
+                throwIfErr(value);
+                return value;
+            }),
+            catch: (error) => {
+                throw error;
+            },
+        });
+    });
+}
+/**
+ * Run local command setup, keeping ConfigurationError for misuse. A throw from a marked read of caller definitions,
+ * options or claims is an application fault, and any other throw, such as from building the registry, is an SDK fault
+ */
+function attempt(create) {
+    try {
+        return create();
+    }
+    catch (error) {
+        if (error instanceof ConfigurationError)
+            throw error;
+        throw new SdkDefect("commands", [thrownReason(error)]);
+    }
+}
+/**
+ * Run a runBot register callback. Misuse and SDK defects from the registrations it makes keep their errors, and any
+ * other throw is the application's own failure, carried by ApplicationError naming `runBot commands`
+ */
+function registerCallback(register) {
+    try {
+        return register();
+    }
+    catch (error) {
+        if (error instanceof ConfigurationError || error instanceof SdkDefect)
+            throw error;
+        throw new ApplicationError("runBot commands", error);
+    }
+}
+//# sourceMappingURL=default-commands.js.map

package/dist/default-commands.js.map

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

package/dist/default-supervisor.d.ts

@@ -0,0 +1,111 @@
+import { ResultAsync } from "neverthrow";
+import type { ClientOptions } from "#sdk/client";
+import { CancelledError, ConfigurationError, type ConnectError } from "#sdk/errors";
+import { SupervisorChildError, type SupervisorAssignment, type SupervisorChildOptions, SupervisorError, type SupervisorOptions, type SupervisorStatus, type SupervisorWaitOptions } from "#sdk/supervisor";
+import type { Client } from "./index.js";
+/**
+ * Client and fixed shard assignment available to configure before the helper starts the gateway connection
+ *
+ * @category Sharding and supervision
+ */
+export interface DefaultSupervisorChildContext {
+    /** Client created and owned by child.run. Register application behavior here rather than starting or stopping this client */
+    readonly client: Client;
+    /** Fixed assignment for this child process. It cannot be changed during this run */
+    readonly assignment: SupervisorAssignment;
+    /** Signal aborted when the parent requests shutdown or its message channel disconnects.
+     * Setup work should check this signal and stop when it is aborted. The helper cannot forcibly cancel a JavaScript promise
+     */
+    readonly signal: AbortSignal;
+}
+/**
+ * Bot credentials, client settings and setup callback for a JavaScript module launched by a supervisor.
+ * Unknown option keys fail with ConfigurationError before waiting for the parent, with a suggested name when one is close
+ *
+ * @category Sharding and supervision
+ */
+export interface DefaultSupervisorChildOptions extends SupervisorChildOptions {
+    /** Register subscriptions and local application behavior before the helper calls client.run.
+     * Return when setup is finished, not when the bot stops. Do not call client.run, connect or shutdown here.
+     * A thrown error, rejected promise or returned Err rejects child.run with SdkDefect code application.defect, whose
+     * cause is an ApplicationError with source "supervisor child configure" and the original value as its cause.
+     * A parent stop can finish child.run without waiting for this promise. Setup must check context.signal to avoid continuing afterward
+     */
+    readonly configure: (context: DefaultSupervisorChildContext) => unknown;
+}
+/**
+ * Parent that starts and stops child processes for one fixed set of local shards.
+ * Methods start their asynchronous work when called and return ResultAsync for expected failures.
+ * Unexpected defects reject with SdkDefect instead of returning Err, and a throwing waitForReady option or signal getter
+ * uses code application.defect with the thrown value as its cause.
+ * Creating this parent starts no child. Call shutdown to release its owned processes
+ *
+ * @category Sharding and supervision
+ */
+export interface DefaultSupervisor {
+    /** Start the configured children and return Ok when each child accepts its shard assignment and finishes configure.
+     * This is setup completion, not gateway readiness. Use waitForReady to observe connected gateway sessions.
+     * Concurrent calls share startup. Calling again does not create extra children or await replacement startup.
+     * Failure returns SupervisorError only after owned processes exit. Start during or after shutdown returns reason closed.
+     * With totalShards "auto" it first counts the bot's communities, and a failed count returns reason shardCount.
+     * If a child remains alive after losing its message channel for shutdownTimeoutMs, pending startup fails with closed after cleanup
+     */
+    start(): ResultAsync<void, SupervisorError>;
+    /** Wait until the supervisor's lifetime ends and its owned child processes have exited.
+     * Returns Ok after normal shutdown or Err with the retained SupervisorError after failure, even on a later call.
+     * Does not start or stop the supervisor. Calling before start waits until a later shutdown or failure
+     */
+    waitForClose(): ResultAsync<void, SupervisorError>;
+    /** Return Ok when every current child has reported its aggregate gateway state as Connected.
+     * Start the supervisor first. This observes reports, not simultaneous cross-process health or lasting readiness.
+     * Losing a child's message channel clears its readiness immediately. A later call waits for current readiness again.
+     * A signal returns CancelledError only for this wait and never stops or restarts a child.
+     * An already-aborted signal takes precedence even when the children are ready.
+     * A malformed signal returns ConfigurationError with field signal without starting observation.
+     * Unknown option keys return ConfigurationError before observation, with a suggested name when one is close.
+     * An idle, stopping or closed supervisor returns SupervisorError with reason closed. A failed supervisor returns its retained failure
+     */
+    waitForReady(options?: SupervisorWaitOptions): ResultAsync<void, SupervisorError | CancelledError | ConfigurationError>;
+    /** Return one immutable safe local status snapshot without child output, environment, arguments or paths */
+    status(): SupervisorStatus;
+    /** Ask owned children to stop and return Ok only after their processes exit.
+     * After shutdownTimeoutMs, force-terminate an owned child that has not exited, then keep waiting for its exit.
+     * Concurrent and repeated calls share cleanup. Shutdown before start closes the parent without launching children.
+     * Returns Ok even after a supervisor failure or a child's message-channel loss. It does not erase waitForClose's retained failure
+     */
+    shutdown(): ResultAsync<void, never>;
+}
+/**
+ * Create a local parent supervisor or run its child module using the default API
+ *
+ * @category Sharding and supervision
+ */
+export interface DefaultSupervisorTools {
+    /** Validate and copy options now and return an idle supervisor. Invalid options throw ConfigurationError.
+     * Unknown keys in parent, assignment, restart and Identify options include a suggested name when one is close.
+     * Each option is read once. A throwing option getter throws SdkDefect with code application.defect and the thrown
+     * value as its cause, while another unexpected fault uses sdk.defect.
+     * Does not start a process or check whether the entry module can execute. Launch failures are reported by start
+     */
+    create(options: SupervisorOptions): DefaultSupervisor;
+    /** Child-module helper. Call run inside the module selected by the parent's entry option */
+    readonly child: {
+        /** Receive the parent's assignment, create a client, finish configure, then run the client until stop or failure.
+         * Owns client shutdown and removal of parent-message listeners before returning its result.
+         * A normal parent stop drains running handlers, queued handler events and REST requests for the parent's drain allowance before returning Ok.
+         * Failure stops the client without draining. Running outside a connected supervisor child returns SupervisorChildError with reason disconnected.
+         * Unknown child option keys return ConfigurationError before waiting for IPC, with a suggested name when one is close.
+         * Invalid client settings return ConfigurationError. Client execution can return ConnectError or CancelledError.
+         * Message-channel loss or invalid coordination data returns SupervisorChildError.
+         * A stop during configure never starts the client afterward.
+         * The helper cannot forcibly stop a configure promise that ignores cancellation and does not wait for it.
+         * The options are read once before waiting for the assignment, and a throwing option getter rejects with
+         * SdkDefect code application.defect and the thrown value as its cause.
+         * Defects reject with SdkDefect, retaining accompanying typed failures without private error text
+         */
+        run(options: DefaultSupervisorChildOptions): ResultAsync<void, ConfigurationError | ConnectError | CancelledError | SupervisorChildError>;
+    };
+}
+/** Build default-API supervisor tools around this entry point's client creator */
+export declare function makeDefaultSupervisor(createClient: (options: ClientOptions) => Client): DefaultSupervisorTools;
+//# sourceMappingURL=default-supervisor.d.ts.map

package/dist/default-supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-supervisor.d.ts","sourceRoot":"","sources":["../src/default-supervisor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAW,WAAW,EAAe,MAAM,YAAY,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,OAAO,EAEH,cAAc,EACd,kBAAkB,EAElB,KAAK,YAAY,EAEpB,MAAM,aAAa,CAAA;AAYpB,OAAO,EACH,oBAAoB,EACpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC7B,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC1C,6HAA6H;IAC7H,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IACzE;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAA;CAC1E;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;OAMG;IACH,KAAK,IAAI,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAC3C;;;OAGG;IACH,YAAY,IAAI,WAAW,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAClD;;;;;;;;OAQG;IACH,YAAY,CACR,OAAO,CAAC,EAAE,qBAAqB,GAChC,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC3E,4GAA4G;IAC5G,MAAM,IAAI,gBAAgB,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;CACvC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAA;IACrD,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,EAAE;QACZ;;;;;;;;;;;;WAYG;QACH,GAAG,CACC,OAAO,EAAE,6BAA6B,GACvC,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,GAAG,cAAc,GAAG,oBAAoB,CAAC,CAAA;KAClG,CAAA;CACJ;AAqID,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,GAAG,sBAAsB,CA2M9G"}