@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/api/default/client.js

@@ -0,0 +1,301 @@
+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 Scope from "effect/Scope";
+import { ok, ResultAsync } from "neverthrow";
+import { causeReasons, defectReason, suspendInput } from "#sdk/internal/defects";
+import { shutdownDrainMs } from "#sdk/internal/client/drain";
+import { scheduleTiming } from "#sdk/internal/scheduled-tasks";
+import { promiseHook, throwIfErr } from "#sdk/internal/failures";
+import { fiberRejectionScope, inRejectionScope } from "#sdk/internal/rejection-scope";
+import { registerClientOwner } from "#sdk/internal/client-registry";
+import { CancelledError, ClientClosedError, ConfigurationError, SdkDefect, } from "#sdk/errors";
+import { makeClient } from "#sdk/internal/client";
+import { defaultMiddleware, waitForEvent } from "#sdk/internal/events";
+import {} from "#sdk/message-errors";
+import {} from "./events.js";
+import {} from "./attachments.js";
+import {} from "./messages.js";
+import {} from "./audit-logs.js";
+import {} from "./invites.js";
+import {} from "./emojis.js";
+import {} from "./stickers.js";
+import {} from "./discovery.js";
+import {} from "./guilds.js";
+import {} from "./channels.js";
+import {} from "./threads.js";
+import {} from "./members.js";
+import {} from "./permissions.js";
+import {} from "./roles.js";
+import {} from "./webhooks.js";
+import {} from "./cache.js";
+import {} from "./rest.js";
+import {} from "./gateway.js";
+import {} from "./logging.js";
+import {} from "./instance.js";
+import { bindDefault, defaultContext } from "#sdk/internal/binding/default";
+import { fromExit } from "#sdk/internal/binding/execute";
+import {} from "./presence.js";
+import {} from "./application.js";
+import {} from "./users.js";
+import {} from "./direct-messages.js";
+/**
+ * Create a bot client from a token, initially Disconnected
+ *
+ * Use `run` or `connect` to receive gateway events. HTTP requests work without connecting.
+ * Always finish with `shutdown` unless an accepted `run` already manages the client's full lifetime
+ *
+ * @remarks
+ * **Creation and configuration**
+ *
+ * Creation validates configuration synchronously without authenticating the token or opening sockets.
+ * No timers or process signal handlers are started.
+ * Invalid options throw `ConfigurationError` without the rejected value.
+ * An unsupported option key, such as a misspelled `logging`, throws with a hint naming the closest supported key.
+ * A missing or blank token, such as an unset environment variable, throws `ConfigurationError` with a hint naming that likely cause.
+ * Unexpected creation failures throw `SdkDefect`. An option getter that throws produces code `application.defect` with the thrown value as the cause
+ *
+ * **Instance and caching**
+ *
+ * Hosted Fluxer is selected by default.
+ * For a self-hosted instance, pass its root and let the SDK discover API, gateway and URL endpoints when first needed.
+ * HTTPS and WSS are required unless that explicit instance enables allowInsecure for HTTP and WS
+ *
+ * Caching is disabled by default.
+ * Cache settings are copied and validated without calling retention policies or reporters.
+ * Unknown cache or message-cache keys fail validation.
+ * The messageFields option selects received message fields once for this client's lifetime
+ *
+ * **Connection and sharding**
+ *
+ * Gateway startup defaults to a 30,000 ms overall budget and three total attempts per assigned shard.
+ * An explicit sharding plan fixes this client's assigned IDs for its lifetime, while automatic sharding and a client
+ * without sharding settings may move to a larger plan when Fluxer asks for more shards.
+ * Shard zero receives direct-message gateway traffic.
+ * Request and cache limits still apply across the whole client, not separately to each shard
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@neontechspace/fluxerly"
+ *
+ * export function shardingExample(token: string) {
+ *     return createClient({ token, sharding: { totalShards: 4, shardIds: [0, 2] } })
+ * }
+ * ```
+ *
+ * @category Client and lifecycle
+ */
+export function createClient(options) {
+    const scope = Scope.makeUnsafe();
+    const exit = Effect.runSyncExit(makeClient(options, scope));
+    if (Exit.isFailure(exit)) {
+        if (Cause.hasDies(exit.cause))
+            throw new SdkDefect("createClient", causeReasons(exit.cause));
+        const failure = exit.cause.reasons.find((reason) => reason._tag === "Fail");
+        if (failure?._tag === "Fail") {
+            // The configuration error was created inside validation, so its stack starts at the caller's line instead
+            Error.captureStackTrace(failure.error, createClient);
+            throw failure.error;
+        }
+        throw new SdkDefect("createClient", causeReasons(exit.cause));
+    }
+    const owner = exit.value;
+    const context = defaultContext(owner);
+    const { execute } = context;
+    const subscription = (source) => {
+        const waitForClose = (options) => execute(Deferred.await(source.closed), "subscription.waitForClose", options);
+        return Object.freeze({
+            id: source.id,
+            close: () => source.stop(),
+            waitForClose,
+            [Symbol.asyncDispose]: async () => {
+                source.stop();
+                // The overflow outcome stays readable through waitForClose, so disposal only awaits cleanup
+                await waitForClose();
+            },
+        });
+    };
+    // Registration misuse throws its ConfigurationError, as other local misuse does. A closing client is not misuse: the
+    // event bus returns an already-closed source for it
+    const register = (effect, operation) => {
+        const exit = Effect.runSyncExit(owner.logging.provide(effect));
+        if (Exit.isSuccess(exit))
+            return exit.value;
+        if (Cause.hasDies(exit.cause) || Cause.hasInterrupts(exit.cause))
+            throw new SdkDefect(operation, causeReasons(exit.cause));
+        const reason = exit.cause.reasons.find((reason) => reason._tag === "Fail");
+        if (reason?._tag === "Fail")
+            throw reason.error;
+        throw new SdkDefect(operation, causeReasons(exit.cause));
+    };
+    const shutdown = (options) => {
+        let drainMs;
+        try {
+            drainMs = shutdownDrainMs(options);
+        }
+        catch (error) {
+            // A throwing option getter is an application fault, reported like other default-API input faults
+            throw new SdkDefect("shutdown", [defectReason(error, "application")]);
+        }
+        if (drainMs instanceof ConfigurationError) {
+            Error.captureStackTrace(drainMs, shutdown);
+            throw drainMs;
+        }
+        return new ResultAsync(Effect.runPromiseExit(owner.logging.provide(owner.shutdown(drainMs).pipe(Effect.ensuring(Scope.close(scope, Exit.void))))).then((exit) => {
+            const result = fromExit(exit, "shutdown");
+            if (result.isErr())
+                throw new SdkDefect("shutdown", Exit.isFailure(exit) ? causeReasons(exit.cause) : []);
+            return ok(undefined);
+        }));
+    };
+    const schedule = (task, options) => {
+        if (typeof task !== "function")
+            throw new ConfigurationError("task", "The scheduled task must be a function");
+        let timing;
+        try {
+            timing = scheduleTiming(options);
+        }
+        catch (error) {
+            // A throwing option getter is an application fault, reported like other default-API input faults
+            throw new SdkDefect("schedule", [defectReason(error, "application")]);
+        }
+        if (timing instanceof ConfigurationError) {
+            Error.captureStackTrace(timing, schedule);
+            throw timing;
+        }
+        // @effect-diagnostics-next-line unknownInEffectCatch:off
+        const run = Effect.tryPromise({
+            try: (signal) => Promise.resolve(task(signal)).then(throwIfErr),
+            // Keep the thrown or rejected value itself for the failure report
+            catch: (error) => error,
+        });
+        const close = owner.tasks.start(run, timing, Effect.runSync(owner.logging.provide(Effect.context())));
+        return Object.freeze({ close });
+    };
+    const namespaces = bindDefault(context);
+    return registerClientOwner(Object.freeze({
+        // Listing namespaces instead of spreading them keeps the accessors below in declaration order
+        instance: namespaces.instance,
+        presence: namespaces.presence,
+        cache: namespaces.cache,
+        application: namespaces.application,
+        users: namespaces.users,
+        directMessages: namespaces.directMessages,
+        webhooks: namespaces.webhooks,
+        emojis: namespaces.emojis,
+        stickers: namespaces.stickers,
+        auditLogs: namespaces.auditLogs,
+        invites: namespaces.invites,
+        discovery: namespaces.discovery,
+        guilds: namespaces.guilds,
+        channels: namespaces.channels,
+        threads: namespaces.threads,
+        members: namespaces.members,
+        permissions: namespaces.permissions,
+        roles: namespaces.roles,
+        attachments: namespaces.attachments,
+        messages: namespaces.messages,
+        rest: namespaces.rest,
+        gateway: namespaces.gateway,
+        logging: namespaces.logging,
+        on: (event, handler, options) => {
+            return register(suspendInput(() => {
+                if (typeof handler !== "function")
+                    return Effect.fail(new ConfigurationError("handler", "The event handler must be a function"));
+                const reporter = options?.onError;
+                if (reporter !== undefined && typeof reporter !== "function")
+                    return Effect.fail(new ConfigurationError("onError", 'The option "onError" must be a function'));
+                return owner.events
+                    .on(event, (message, context) => Effect.withFiber((fiber) => {
+                    // Operations the handler starts hold their rejection records for its outcome
+                    const rejections = fiberRejectionScope(fiber.context);
+                    // @effect-diagnostics-next-line unknownInEffectCatch:off
+                    return Effect.tryPromise({
+                        try: (signal) => Promise.resolve(inRejectionScope(rejections, () => handler(message, signal, context))).then(throwIfErr),
+                        // Keep the thrown or rejected value itself for the failure report
+                        catch: (error) => error,
+                    });
+                }), options, reporter ? promiseHook(reporter) : undefined, scope)
+                    .pipe(Effect.map(subscription));
+            }), "on");
+        },
+        use: (middleware) => {
+            if (typeof middleware !== "function")
+                throw new ConfigurationError("middleware", "Event middleware must be a function");
+            if (owner.events.closed)
+                throw new ClientClosedError();
+            const remove = owner.events.addMiddleware(defaultMiddleware(middleware));
+            return Object.freeze({ close: remove, [Symbol.dispose]: remove });
+        },
+        schedule,
+        subscribe: (event, options) => register(owner.events.open(event, options).pipe(Effect.map((source) => Object.freeze({
+            ...subscription(source),
+            next: (options) => execute(source.next(), "next", options),
+        }))), "subscribe"),
+        waitFor: (event, options) => execute(waitForEvent(owner.events, event, options, true), "waitFor", options),
+        diagnostics: () => owner.diagnostics(),
+        get state() {
+            return owner.state;
+        },
+        get gatewayLatencyMs() {
+            return owner.gatewayLatencyMs;
+        },
+        get shards() {
+            return owner.shards;
+        },
+        shardIdForGuild: (guildId) => owner.ownedShardForGuild(guildId),
+        connect: (options) => execute(owner.connect(), "connect", options),
+        run: (options) => execute(owner.run(), "run", options),
+        waitForClose: (options) => execute(owner.waitForClose(), "waitForClose", options),
+        shutdown,
+        [Symbol.asyncDispose]: async () => {
+            await shutdown();
+        },
+        observeState: (listener) => {
+            let active = true;
+            let busy = false;
+            let pending;
+            const deliver = (state) => {
+                if (!active)
+                    return;
+                if (busy) {
+                    if (pending !== undefined)
+                        owner.logging.log({
+                            level: "debug",
+                            category: "lifecycle",
+                            code: "lifecycle.observerCoalesced",
+                            message: `A state observer was still running, so it skips the ${pending} state and receives ${state} next`,
+                            fields: { skipped: pending, next: state },
+                        });
+                    pending = state;
+                    return;
+                }
+                busy = true;
+                Promise.resolve()
+                    .then(() => (active ? listener(state) : undefined))
+                    .then(throwIfErr)
+                    .catch((error) => {
+                    // The report goes to onError or the log, never back into this observer
+                    owner.failures.report({ kind: "observer", error });
+                })
+                    .finally(() => {
+                    busy = false;
+                    if (pending !== undefined) {
+                        const next = pending;
+                        pending = undefined;
+                        deliver(next);
+                    }
+                });
+            };
+            const unsubscribe = owner.subscribe(deliver);
+            const close = () => {
+                active = false;
+                pending = undefined;
+                unsubscribe();
+            };
+            return Object.freeze({ close, [Symbol.dispose]: close });
+        },
+    }), owner);
+}
+//# sourceMappingURL=client.js.map

package/dist/api/default/client.js.map

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

package/dist/api/default/collectors.d.ts

@@ -0,0 +1,76 @@
+import type { ResultAsync } from "neverthrow";
+import type { OperationOptions } from "#sdk/client";
+import type { CancelledError, ConfigurationError } from "#sdk/errors";
+import type { ReactionCollectorResult, CollectorFailure, CollectorResult } from "#sdk/collectors";
+import type { Message, MessageCore } from "#sdk/messages";
+/**
+ * Wait for the bounded message collection created by messages.collect.
+ * Use close to end intake early and result to obtain its final result.
+ * Use `await using` to close the collector and wait for its cleanup when the enclosing block ends
+ *
+ * @category Events and collectors
+ */
+export interface Collector<M extends MessageCore = Message> {
+    /**
+     * Stop accepting messages now, keeping accepted messages for a successful partial result.
+     * Repeated calls preserve whichever terminal outcome was recorded first.
+     * Use result to await callback cleanup and read the collection
+     *
+     * @remarks
+     * Returns immediately
+     */
+    close(): void;
+    /**
+     * Wait for the final frozen collection result after timer, queue, filter, listener and callback cleanup.
+     * Idle, timeout or stop can succeed with no messages or a partial collection.
+     * Collection cancellation, filter or callback failure, overflow, gateway loss and client closure fail without partial messages.
+     * Multiple or later waiters receive the same collection outcome.
+     * Cancelling this wait affects only the waiter, not collection.
+     * Keeping the handle or successful result keeps its message snapshots in memory
+     *
+     * @remarks
+     * Unexpected SDK failures reject with SdkDefect
+     */
+    result(options?: OperationOptions): ResultAsync<CollectorResult<M>, CollectorFailure | CancelledError | ConfigurationError>;
+    /**
+     * Close this collector and wait for its cleanup, as `await using` does at the end of a block.
+     * The collection outcome is not rethrown here. Read it from result when it matters
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Wait for the reaction-addition collection created by messages.collectReactions.
+ * Use close to end intake early and result to obtain the observations.
+ * Collected additions are observations, not current votes
+ *
+ * @category Events and collectors
+ */
+export interface ReactionCollector {
+    /**
+     * Stop accepting additions now and keep accepted observations for a successful partial result.
+     * Repeated calls preserve the first recorded outcome.
+     * Use result to await callback cleanup and read the observations
+     *
+     * @remarks
+     * Returns immediately
+     */
+    close(): void;
+    /**
+     * Wait for the final frozen reaction result after queue, timer, filter, listener and callback cleanup.
+     * Idle, timeout or stop can succeed with empty or partial observations.
+     * Collection cancellation, filter or callback failure, overflow, gateway loss and client shutdown fail without partial observations.
+     * Multiple or later waiters receive the same outcome.
+     * Cancelling this wait affects only the waiter, not collection.
+     * Keeping the handle or successful result retains its snapshots in memory
+     *
+     * @remarks
+     * Unexpected failures reject with SdkDefect
+     */
+    result(options?: OperationOptions): ResultAsync<ReactionCollectorResult, CollectorFailure | CancelledError | ConfigurationError>;
+    /**
+     * Close this collector and wait for its cleanup, as `await using` does at the end of a block.
+     * The collection outcome is not rethrown here. Read it from result when it matters
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=collectors.d.ts.map

package/dist/api/default/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../../src/api/default/collectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjG,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO;IACtD;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI,CAAA;IACb;;;;;;;;;;OAUG;IACH,MAAM,CACF,OAAO,CAAC,EAAE,gBAAgB,GAC3B,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,gBAAgB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC1F;;;OAGG;IACH,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI,CAAA;IACb;;;;;;;;;;OAUG;IACH,MAAM,CACF,OAAO,CAAC,EAAE,gBAAgB,GAC3B,WAAW,CAAC,uBAAuB,EAAE,gBAAgB,GAAG,cAAc,GAAG,kBAAkB,CAAC,CAAA;IAC/F;;;OAGG;IACH,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC"}

package/dist/api/default/collectors.js

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

package/dist/api/default/collectors.js.map

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

package/dist/api/default/commands.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Route prefixed messages such as !ping to registered handlers.
+ * The simplest route is runBot's commands option. For an existing client, create a router, register commands and
+ * attach it
+ *
+ * @remarks
+ * Nothing listens until attach, which uses one bounded messageCreate subscription and does not connect the client.
+ * Command handlers send replies and decide access, with optional guards, cooldowns and middleware.
+ * The router does not retry failed handlers, and a handler that returns an Err result is reported like a throw
+ *
+ * Optional groups organize names and help text, but a protected command still needs its own guard.
+ * A guard decides whether a matched command may run, and the built-in `guards` cover common checks
+ *
+ * Optional argument schemas convert raw args into frozen typed values after the guards.
+ * Conversion rejection gives rejection feedback without consuming a cooldown.
+ * The original args remain available
+ *
+ * Help pages are strings the application can send.
+ * Hiding a command in help is not an access check
+ *
+ * Creation, registration and help throw ConfigurationError for misuse, so a misconfigured router fails at startup
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ * export function commandGroupExample(client: Client) {
+ *     return commands
+ *         .create({ prefix: "!" })
+ *         .registerGroup({ name: "tools", aliases: ["t"] })
+ *         .register({ name: "ping", execute: ({ reply }) => reply("Pong") }, { group: ["tools"] })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ *
+ * export function installPing(client: Client) {
+ *     return commands
+ *         .create({
+ *             prefix: "!",
+ *             parse: commands.parseQuoted,
+ *             onUnmatched: ({ reply }, unmatched) => {
+ *                 if (unmatched._tag !== "CommandUnknownName") return undefined
+ *                 const hint = unmatched.suggestion === undefined ? "" : `. Closest known command: ${unmatched.suggestion}`
+ *                 return reply(`Unknown command: ${unmatched.name}${hint}`)
+ *             },
+ *         })
+ *         .register({ name: "ping", execute: ({ reply }) => reply("Pong") })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ *
+ * export function typedCommandExample(client: Client) {
+ *     return commands
+ *         .create({ prefix: "!", parse: commands.parseQuoted, onReject: "reply" })
+ *         .register({
+ *             name: "repeat",
+ *             arguments: {
+ *                 mode: { type: "choice", choices: ["fast", "slow"] },
+ *                 count: { type: "integer", min: 1, max: 5, default: 1 },
+ *                 note: { type: "text", optional: true, rest: true },
+ *             },
+ *             cooldown: { durationMs: 10_000, per: "user" },
+ *             execute: ({ reply, values }) => reply(`${values.count} / ${values.mode} / ${values.note ?? "No note"}`),
+ *         })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { orThrow, type Client, type DefaultPrefixCommandRouter } from "@neontechspace/fluxerly"
+ *
+ * export async function commandHelpExample(client: Client, router: DefaultPrefixCommandRouter, channelId: string) {
+ *     const pages = router.help({ prefix: "!", maxLength: 1_000, include: (command) => command.name !== "admin" })
+ *     // Visibility is not authorization. Each command still needs its own policy
+ *     for (const content of pages) orThrow(await client.messages.send(channelId, { content, allowedMentions: {} }))
+ *     // Earlier pages remain sent if a later send fails. This example never retries
+ * }
+ * ```
+ *
+ * @category Commands
+ */
+export declare const commands: import("#sdk/default-commands").DefaultCommands;
+//# sourceMappingURL=commands.d.ts.map

package/dist/api/default/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/api/default/commands.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFG;AACH,eAAO,MAAM,QAAQ,iDAAkB,CAAA"}

package/dist/api/default/commands.js

@@ -0,0 +1,92 @@
+import { defaultCommands } from "#sdk/default-commands";
+/**
+ * Route prefixed messages such as !ping to registered handlers.
+ * The simplest route is runBot's commands option. For an existing client, create a router, register commands and
+ * attach it
+ *
+ * @remarks
+ * Nothing listens until attach, which uses one bounded messageCreate subscription and does not connect the client.
+ * Command handlers send replies and decide access, with optional guards, cooldowns and middleware.
+ * The router does not retry failed handlers, and a handler that returns an Err result is reported like a throw
+ *
+ * Optional groups organize names and help text, but a protected command still needs its own guard.
+ * A guard decides whether a matched command may run, and the built-in `guards` cover common checks
+ *
+ * Optional argument schemas convert raw args into frozen typed values after the guards.
+ * Conversion rejection gives rejection feedback without consuming a cooldown.
+ * The original args remain available
+ *
+ * Help pages are strings the application can send.
+ * Hiding a command in help is not an access check
+ *
+ * Creation, registration and help throw ConfigurationError for misuse, so a misconfigured router fails at startup
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ * export function commandGroupExample(client: Client) {
+ *     return commands
+ *         .create({ prefix: "!" })
+ *         .registerGroup({ name: "tools", aliases: ["t"] })
+ *         .register({ name: "ping", execute: ({ reply }) => reply("Pong") }, { group: ["tools"] })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ *
+ * export function installPing(client: Client) {
+ *     return commands
+ *         .create({
+ *             prefix: "!",
+ *             parse: commands.parseQuoted,
+ *             onUnmatched: ({ reply }, unmatched) => {
+ *                 if (unmatched._tag !== "CommandUnknownName") return undefined
+ *                 const hint = unmatched.suggestion === undefined ? "" : `. Closest known command: ${unmatched.suggestion}`
+ *                 return reply(`Unknown command: ${unmatched.name}${hint}`)
+ *             },
+ *         })
+ *         .register({ name: "ping", execute: ({ reply }) => reply("Pong") })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { commands, type Client } from "@neontechspace/fluxerly"
+ *
+ * export function typedCommandExample(client: Client) {
+ *     return commands
+ *         .create({ prefix: "!", parse: commands.parseQuoted, onReject: "reply" })
+ *         .register({
+ *             name: "repeat",
+ *             arguments: {
+ *                 mode: { type: "choice", choices: ["fast", "slow"] },
+ *                 count: { type: "integer", min: 1, max: 5, default: 1 },
+ *                 note: { type: "text", optional: true, rest: true },
+ *             },
+ *             cooldown: { durationMs: 10_000, per: "user" },
+ *             execute: ({ reply, values }) => reply(`${values.count} / ${values.mode} / ${values.note ?? "No note"}`),
+ *         })
+ *         .attach(client)
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * import { orThrow, type Client, type DefaultPrefixCommandRouter } from "@neontechspace/fluxerly"
+ *
+ * export async function commandHelpExample(client: Client, router: DefaultPrefixCommandRouter, channelId: string) {
+ *     const pages = router.help({ prefix: "!", maxLength: 1_000, include: (command) => command.name !== "admin" })
+ *     // Visibility is not authorization. Each command still needs its own policy
+ *     for (const content of pages) orThrow(await client.messages.send(channelId, { content, allowedMentions: {} }))
+ *     // Earlier pages remain sent if a later send fails. This example never retries
+ * }
+ * ```
+ *
+ * @category Commands
+ */
+export const commands = defaultCommands;
+//# sourceMappingURL=commands.js.map

package/dist/api/default/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../../src/api/default/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAA"}