@neontechspace/fluxerly 1000.0.0-nightly.12

package/dist/internal/command-guards.js

@@ -0,0 +1,81 @@
+/**
+ * Built-in command guard rules shared by both API styles: Deny reasons, owner and permission-name validation, the
+ * application owner behind ownerOnly without IDs, the private-channel confirmation behind dmOnly and the cache-first
+ * permission reads behind requirePermissions.
+ * Invariant: Guards read at most the guild, member, roles, channel and a thread's parent channel once per invocation,
+ * using enabled caches before a request, never allow on an unconfirmed channel kind, and never retain a decision. The
+ * only retained read is the application owner ID, kept per client after its first successful read
+ * Implements [SDK contracts: Delivery, requests and caches](/docs/SDK-CONTRACTS.md#delivery-requests-and-caches)
+ */
+import { isThreadChannel } from "#sdk/channels";
+import { ConfigurationError } from "#sdk/errors";
+import { Permissions } from "#sdk/guilds";
+import { UserOperationError } from "#sdk/users";
+/** Deny reasons the built-in guards return, written for a reply to the invoking user */
+export const guardDenials = Object.freeze({
+    guildOnly: "This command works only in a community",
+    dmOnly: "This command works only in direct messages",
+    ownerOnly: "This command is restricted to the bot owner",
+    missing: (names) => `Using this command requires these permissions: ${names.join(", ")}`,
+    unconfirmedChannel: "This command cannot check permissions in this kind of channel",
+});
+/** Validate owner IDs when the guard is created, so a misconfigured guard fails at startup rather than per message */
+export function ownerIds(value) {
+    const list = typeof value === "string" ? [value] : value;
+    if (!Array.isArray(list) || list.length === 0)
+        throw new ConfigurationError("command", "The ownerOnly guard needs one or more owner user IDs");
+    for (const id of list)
+        if (typeof id !== "string" || !/^[1-9]\d*$/.test(id))
+            throw new ConfigurationError("command", "The ownerOnly guard needs each owner user ID as a decimal string");
+    return new Set(list);
+}
+/**
+ * Application owner IDs that ownerOnly without IDs has read, keyed by the public client object passed to the guard.
+ * An ID stays for the client's lifetime, so an ownership transfer applies to a new client, and a failed read is never stored
+ */
+export const applicationOwners = new WeakMap();
+/** Validate permission names when the guard is created */
+export function permissionNames(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        throw new ConfigurationError("command", "The requirePermissions guard needs one or more permission names");
+    for (const name of value)
+        if (typeof name !== "string" || !Object.hasOwn(Permissions, name))
+            throw new ConfigurationError("command", typeof name === "string" && name.length <= 64
+                ? `The requirePermissions guard got an unknown permission name ${JSON.stringify(name)}`
+                : "The requirePermissions guard needs permission names as strings", { hint: "Use names from Permissions, such as ManageMessages or BanMembers" });
+    return Object.freeze([...value]);
+}
+/** Permission names absent from calculated bits, in the order they were required */
+export function missingPermissions(bits, names) {
+    return names.filter((name) => (bits & Permissions[name]) !== Permissions[name]);
+}
+/** Whether a gateway message came from a guild. Gateway messages carry their guild ID, unlike HTTP message responses */
+export const inGuild = (message) => typeof message.guildId === "string";
+/**
+ * Whether a failed private-channel read proved that the channel is not a private conversation.
+ * Fluxer answered, but not with a one-to-one or group conversation, for example with a guild channel.
+ * Other failures, such as network errors, timeouts or rejections, leave the channel unconfirmed and fail the command
+ */
+export const notPrivateChannel = (error) => error instanceof UserOperationError && error.reason === "response";
+/**
+ * A cached channel observation usable for permission calculation, or undefined when it must be read.
+ * A thread needs only its parent ID, because it takes its permissions from its parent channel, which is read
+ * separately. A cached channel without its overwrite list is read again, because calculating without unknown overwrites
+ * could grant a permission that the channel denies
+ */
+export const cachedPermissionChannel = (channel) => isThreadChannel(channel) || channel?.permissionOverwrites !== undefined ? channel : undefined;
+/**
+ * A freshly read channel prepared for permission calculation, or undefined when its permissions cannot be confirmed.
+ * A thread is used as read, because its permissions come from its parent channel. Fluxer's own response is
+ * authoritative for a channel that holds its own overwrites, so a read without an overwrite list has no channel
+ * overwrites and the member's role permissions apply unchanged. A channel of a type this SDK version does not know may
+ * take its permissions from elsewhere, so a missing list there leaves them unknown
+ */
+export const fetchedPermissionChannel = (channel) => {
+    if (isThreadChannel(channel) || channel.permissionOverwrites !== undefined)
+        return channel;
+    if (channel.type === "unknown")
+        return undefined;
+    return Object.freeze({ ...channel, permissionOverwrites: Object.freeze([]) });
+};
+//# sourceMappingURL=command-guards.js.map

package/dist/internal/command-guards.js.map

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

package/dist/internal/command-help.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Prefix-command help rendering from snapshotted command metadata.
+ * Invariant: Rendering reads only snapshotted metadata and never runs command handlers or sends messages.
+ * Implements [SDK contracts: User-handler failures](/docs/SDK-CONTRACTS.md#user-handler-failures)
+ */
+import type { CommandContextHelpOptions, CommandHelpOptions } from "#sdk/command-help";
+import type { PrefixCommandMetadata } from "#sdk/commands";
+/**
+ * Help options for a command context's help function, filling the matched prefix and one message's length.
+ * Getters defer each read to commandHelp, so a throwing caller getter is still marked as application input there
+ */
+export declare function contextHelpOptions(options: CommandContextHelpOptions | undefined, prefix: string): CommandHelpOptions;
+/** Render only snapshotted metadata. Facades own immediate versus lazy execution and defect translation */
+export declare function commandHelp(commands: readonly PrefixCommandMetadata[], options: CommandHelpOptions): readonly string[];
+//# sourceMappingURL=command-help.d.ts.map

package/dist/internal/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../src/internal/command-help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAU1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAyBrH;AAED,2GAA2G;AAC3G,wBAAgB,WAAW,CACvB,QAAQ,EAAE,SAAS,qBAAqB,EAAE,EAC1C,OAAO,EAAE,kBAAkB,GAC5B,SAAS,MAAM,EAAE,CAuDnB"}

package/dist/internal/command-help.js

@@ -0,0 +1,121 @@
+import { ConfigurationError } from "#sdk/errors";
+import { readCaller } from "./defects.js";
+import { splitText } from "#sdk/text";
+import { copyCommandGroupPath, sameCommandPath } from "./commands.js";
+import { unsupportedKeyHint } from "./suggest.js";
+/** Default page length of a command context's help, which fits one message */
+const contextHelpLength = 2_000;
+/**
+ * Help options for a command context's help function, filling the matched prefix and one message's length.
+ * Getters defer each read to commandHelp, so a throwing caller getter is still marked as application input there
+ */
+export function contextHelpOptions(options, prefix) {
+    // Malformed options and unknown fields go to commandHelp unchanged, which rejects them as router.help does
+    if (options !== undefined &&
+        (typeof options !== "object" ||
+            options === null ||
+            Reflect.ownKeys(options).some((key) => typeof key !== "string" || !["prefix", "maxLength", "include", "group"].includes(key))))
+        return options;
+    return {
+        get prefix() {
+            return options?.prefix ?? prefix;
+        },
+        get maxLength() {
+            return options?.maxLength ?? contextHelpLength;
+        },
+        get group() {
+            return options?.group;
+        },
+        get include() {
+            return options?.include;
+        },
+    };
+}
+/** Render only snapshotted metadata. Facades own immediate versus lazy execution and defect translation */
+export function commandHelp(commands, options) {
+    // Only reading the caller options is marked as application input, not building the help pages
+    const { prefix, maxLength, include, parent } = readCaller(() => helpOptions(options));
+    const selected = [];
+    for (let depth = 1; depth <= parent.length; depth += 1) {
+        const path = parent.slice(0, depth);
+        const group = commands.find((entry) => entry.kind === "group" && entry.path !== undefined && sameCommandPath(entry.path, path));
+        if (group === undefined)
+            throw new ConfigurationError("help", 'The help option "group" must be the path of a registered group, using group names rather than aliases');
+        if (include !== undefined && !included(include, group))
+            return Object.freeze([]);
+        if (depth === parent.length)
+            selected.push(group);
+    }
+    for (const entry of commands) {
+        const path = entry.path ?? [entry.name];
+        if (!sameCommandPath(path.slice(0, -1), parent))
+            continue;
+        if (include === undefined || included(include, entry))
+            selected.push(entry);
+    }
+    const entries = [];
+    for (const command of selected) {
+        const path = command.path ?? [command.name];
+        const namespace = path.slice(0, -1);
+        const usage = command.usage ??
+            command.arguments
+                ?.map((argument) => {
+                const name = argument.name + (argument.rest ? "..." : "");
+                return argument.optional ? `[${name}]` : `<${name}>`;
+            })
+                .join(" ") ??
+            "";
+        const aliases = command.aliases?.length
+            ? ` (Aliases: ${command.aliases.map((alias) => prefix + [...namespace, alias].join(" ")).join(", ")})`
+            : "";
+        entries.push(prefix +
+            path.join(" ") +
+            (command.kind === "group" ? " (Group)" : "") +
+            (usage ? " " + usage : "") +
+            aliases +
+            (command.description ? "\n" + command.description : ""));
+    }
+    const pages = splitText(entries.join("\n\n"), { maxLength });
+    if (pages.isErr())
+        throw new ConfigurationError("help", 'Help text must be well-formed, and the help option "maxLength" must fit each Unicode code point');
+    // Fluxer trims message edges. Return sendable pages rather than whitespace-only separator pieces
+    return Object.freeze(pages.value.map((page) => page.trim()).filter((page) => page.length > 0));
+}
+const helpKeys = ["prefix", "maxLength", "include", "group"];
+/** Read and validate help options once, before any help text is built */
+function helpOptions(options) {
+    if (typeof options !== "object" || options === null || Array.isArray(options))
+        throw new ConfigurationError("help", "Help options must be an object");
+    for (const key of Reflect.ownKeys(options))
+        if (typeof key !== "string" || !helpKeys.includes(key))
+            throw new ConfigurationError("help", typeof key === "string"
+                ? `Unsupported help option ${JSON.stringify(key)}`
+                : "Help options must not have symbol keys", { hint: unsupportedKeyHint(typeof key === "string" ? key : "", helpKeys) });
+    const { prefix, maxLength, include, group } = options;
+    if (typeof prefix !== "string" || prefix.length === 0 || !prefix.isWellFormed())
+        throw new ConfigurationError("help", 'The help option "prefix" must be nonempty well-formed text');
+    if (!Number.isSafeInteger(maxLength) || maxLength <= 0)
+        throw new ConfigurationError("help", 'The help option "maxLength" must be a positive safe integer in UTF-16 code units');
+    if (include !== undefined && typeof include !== "function")
+        throw new ConfigurationError("help", 'The help option "include" must be a function that returns true or false');
+    const parent = group === undefined ? Object.freeze([]) : copyCommandGroupPath(group, "help");
+    return { prefix, maxLength, include, parent };
+}
+function included(include, command) {
+    let accepted;
+    try {
+        accepted = include(command);
+    }
+    catch (error) {
+        throw new ConfigurationError("help", 'The help option "include" threw. The thrown value is this error\'s cause', {
+            cause: error,
+        });
+    }
+    if (typeof accepted === "boolean")
+        return accepted;
+    // Observe an invalid asynchronous result without awaiting or retrying application work
+    // allow-silent: The invalid asynchronous result already produced a ConfigurationError
+    void Promise.resolve(accepted).catch(() => undefined);
+    throw new ConfigurationError("help", 'The help option "include" must return true or false synchronously');
+}
+//# sourceMappingURL=command-help.js.map

package/dist/internal/command-help.js.map

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

package/dist/internal/commands.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Prefix-command registry, matching, cooldowns and dispatch over existing message subscriptions.
+ * Invariant: Commands use existing subscriptions without owning delivery, and every command failure is reported with the command name.
+ * Implements [SDK contracts: User-handler failures](/docs/SDK-CONTRACTS.md#user-handler-failures)
+ */
+import type { CommandCooldownClaim, CommandCooldownPer, CommandCooldownRequest, PrefixCommandDefinition, PrefixCommandGroupDefinition, PrefixCommandGroupMetadata, PrefixCommandMetadata, PrefixCommandParse, PrefixCommandParsing, PrefixCommandRejection, PrefixCommandRegistrationOptions, PrefixCommandUnmatched } from "#sdk/commands";
+import { type CommandArgumentConversion } from "#sdk/internal/command-arguments";
+import { ConfigurationError } from "#sdk/errors";
+import { type Message, type MessageCore } from "#sdk/messages";
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import type { ClientLogger } from "./logging.js";
+export interface PrefixCommandMatch<D extends PrefixCommandDefinition> {
+    readonly definition: D;
+    readonly prefix: string;
+    readonly parse: PrefixCommandParse;
+    readonly path?: readonly string[];
+}
+/** Prefix and frozen unmatched result retained only while an attached router dispatches one message */
+export interface PrefixCommandUnmatchedMatch {
+    readonly prefix: string;
+    readonly unmatched: PrefixCommandUnmatched;
+}
+/** Validated router settings shared by both adapters. The prefix may be a resolver that each adapter runs its own way */
+export interface RouterSettings<M extends MessageCore> extends PrefixCommandParsing<M> {
+    readonly prefix: string | readonly string[] | ((message: M) => unknown);
+}
+/** Shared immutable command lookup state. Entry-point adapters own callback and error boundaries */
+export declare class PrefixCommandRegistry<D extends PrefixCommandDefinition, M extends MessageCore = Message> {
+    #private;
+    /** The router-owned cooldown store for commands that do not supply their own, shared by every router derived from one create */
+    readonly cooldowns: LocalMemoryCooldownStore;
+    /** Keys whose `onReject: "reply"` feedback was already sent, shared like the cooldown store and bounded by the same limit */
+    readonly feedback: ExpiringKeys;
+    constructor(options: unknown, adapterKeys: readonly string[], definitions?: ReadonlyMap<string, D>, commands?: readonly PrefixCommandMetadata[], groups?: readonly PrefixCommandGroupMetadata[], groupLookup?: ReadonlyMap<string, PrefixCommandGroupMetadata>, entries?: readonly PrefixCommandMetadata[], shared?: {
+        readonly cooldowns: LocalMemoryCooldownStore;
+        readonly feedback: ExpiringKeys;
+    });
+    /** The configured prefix or resolver, for the adapter that runs a resolver in its own way */
+    get prefix(): RouterSettings<M>["prefix"];
+    /** Whether a mention of the bot also acts as a prefix */
+    get mentionPrefix(): boolean;
+    /**
+     * Whether the router skips a message before any prefix work: One from a bot unless `ignoreBots` is false, or one a person did not type.
+     * Only Default and Reply messages carry typed text. Every other type is a notice Fluxer posts itself, such as a new thread's name, so an allow-list keeps future types out too.
+     * Fluxer always sends a type, so a message without one, such as a hand-written test payload, counts as typed rather than being dropped silently
+     */
+    ignores(message: M): boolean;
+    private derive;
+    /** Immutable registration-order help metadata with no callbacks or local storage references */
+    get commands(): readonly PrefixCommandMetadata[];
+    get groups(): readonly PrefixCommandGroupMetadata[];
+    get entries(): readonly PrefixCommandMetadata[];
+    /**
+     * Commands and groups that help and unknown-name suggestions may reveal, in registration order.
+     * Leaves out entries registered with `hidden: true` and every entry inside a hidden group
+     */
+    get visibleEntries(): readonly PrefixCommandMetadata[];
+    /** Retain an adapter-validated owned definition in a separate registry. Existing routers and subscriptions keep their previous definitions */
+    register(stored: D, options?: PrefixCommandRegistrationOptions): PrefixCommandRegistry<D, M>;
+    /** Register an already snapshotted batch into one new registry, leaving this registry unchanged if any entry fails */
+    registerMany(stored: readonly D[], options?: PrefixCommandRegistrationOptions): PrefixCommandRegistry<D, M>;
+    private registerAtParent;
+    registerGroup(value: PrefixCommandGroupDefinition, options?: PrefixCommandRegistrationOptions): PrefixCommandRegistry<D, M>;
+    /** Match a message against the prefixes the adapter resolved for it, then consume groups and parse the command */
+    resolve(message: M, prefixes: unknown): PrefixCommandMatch<D> | PrefixCommandUnmatchedMatch | undefined;
+    private registrationParent;
+    private registrationKeys;
+    private lookupKey;
+    /**
+     * The visible registered command or group name in this parent closest to an unknown name, within a bounded edit
+     * distance: At most one edit for names up to four characters and two edits for longer names, preferring the earliest
+     * registration. Hidden entries and entries inside hidden groups are never suggested
+     */
+    private closestName;
+    private matchPrefix;
+    private normalize;
+}
+/** A local cooldown outcome with configuration failures kept as data for the public adapter */
+type LocalMemoryResult<A> = {
+    readonly _tag: "Success";
+    readonly value: A;
+} | {
+    readonly _tag: "Failure";
+    readonly error: ConfigurationError;
+};
+/** Process-local cooldown state shared by default and native adapters */
+export interface LocalMemoryCooldownStore {
+    readonly maxEntries: number;
+    readonly size: number;
+    claim(input: unknown, now?: number): LocalMemoryResult<CommandCooldownClaim>;
+    sweep(now?: number): number;
+    clear(): void;
+}
+/**
+ * Create one bounded local cooldown store after validating only its retention limit.
+ * Used for `commands.memoryCooldowns(options)` and for a router's own store from its `cooldowns` option
+ */
+export declare function createMemoryCooldownStore(options: unknown): LocalMemoryCooldownStore;
+/** Copy a caller claim once, so the validated key and duration are the ones claimed. Other values pass unchanged */
+export declare function snapshotClaimInput(input: unknown): unknown;
+/**
+ * Keys with expiry times in one process, bounded without ever refusing a new key.
+ * Making room removes expired keys first and then the key that expires soonest
+ */
+export declare class ExpiringKeys {
+    #private;
+    readonly maxEntries: number;
+    constructor(maxEntries: number);
+    get size(): number;
+    /** The expiry of an unexpired key, or undefined after removing an expired one */
+    active(key: string, now: number): number | undefined;
+    /** Keep a key until expiry, making room first when a new key would exceed the limit */
+    set(key: string, expiry: number, now: number): void;
+    /**
+     * Report whether a key is already active. Otherwise keep it until `until` and report false, so the caller acts once
+     * per active key. A time that has already passed is not kept
+     */
+    suppress(key: string, until: number, now: number): boolean;
+    /** Remove expired keys and return how many were removed */
+    sweep(now: number): number;
+    clear(): void;
+}
+/** A command's validated cooldown: The store to claim from, the reservation length and how invocations share a key */
+export interface StoredCooldown {
+    /** Application store, or undefined for the router-owned memory store */
+    readonly store?: unknown;
+    readonly durationMs: number;
+    readonly per: CommandCooldownPer;
+    readonly key?: unknown;
+}
+/** Snapshot cooldown fields before validation, retaining only the intentional store and key references */
+export declare function snapshotCommandCooldown(value: unknown): StoredCooldown | undefined;
+/** The default cooldown key suffix for one invocation, selected by per */
+export declare function cooldownSuffix(per: CommandCooldownPer, message: MessageCore): string;
+/** Validate and copy the shared definition fields once before an adapter adds its callback and cooldown references */
+export declare function snapshotCommandDefinition(value: PrefixCommandDefinition, keyedName?: string): PrefixCommandDefinition;
+/** Validate a finite adapter command object before reading its selected public fields */
+export declare function validateCommandShape(value: unknown, keys: readonly string[]): void;
+/** Validate and namespace a caller-selected cooldown key before a store sees it */
+export declare function cooldownRequest(commandName: string | readonly string[], key: unknown, durationMs: number): CommandCooldownRequest;
+/** Convert only expected configuration exceptions into the Effect error channel. Other exceptions remain defects */
+export declare function configurationEffect<A>(thunk: () => A): Effect.Effect<A, ConfigurationError>;
+/** Adapter callbacks for one shared Effect dispatcher */
+export interface CommandDispatchAdapter<D extends PrefixCommandDefinition, C, X = C, E = never, R = never, M extends MessageCore = Message> {
+    /** Run a prefix resolver for one message in the adapter's style, producing its raw value for validation */
+    readonly prefix: (resolver: (message: M) => unknown, message: M) => Effect.Effect<unknown, E, R>;
+    /** The bot's user ID for mentionPrefix, or undefined when it is not available yet */
+    readonly selfId?: () => Effect.Effect<string | undefined>;
+    readonly context: (match: PrefixCommandMatch<D>) => C;
+    /** Evaluate the command's guards, producing a boolean or `{ deny }` verdict */
+    readonly guard: (definition: D, context: C) => Effect.Effect<unknown, E, R>;
+    /** Run router middleware around the rest of a matched command. The rest never runs if middleware does not call it */
+    readonly around?: (context: C, rest: Effect.Effect<void, ConfigurationError | E, R>) => Effect.Effect<void, ConfigurationError | E, R>;
+    /** Local synchronous conversion after a successful guard and before a cooldown claim */
+    readonly convert?: (definition: D, context: C) => CommandArgumentConversion;
+    readonly executionContext?: (context: C, values: Readonly<Record<string, unknown>>) => X;
+    /**
+     * Claim the command's cooldown, producing the namespaced key and the store's unvalidated claim, or undefined when
+     * the command has no cooldown
+     */
+    readonly cooldown?: (definition: D, context: X, routerStore: LocalMemoryCooldownStore) => Effect.Effect<{
+        readonly key: string;
+        readonly claim: unknown;
+    } | undefined, E, R>;
+    /** The command's effective rejection feedback: The router's reply, an application callback or none */
+    readonly feedback?: (definition: D) => "reply" | "callback" | undefined;
+    /**
+     * Contextual rejection feedback, called only when feedback is selected and not suppressed.
+     * The time comes from the dispatch Clock. It runs through the existing subscription error boundary
+     */
+    readonly reject?: (definition: D, context: C, rejection: PrefixCommandRejection, now: number) => Effect.Effect<unknown, E, R>;
+    /** Optional application-owned feedback for a parser decline or unregistered parsed name */
+    readonly unmatched?: ((match: PrefixCommandUnmatchedMatch) => Effect.Effect<unknown, E, R>) | undefined;
+    readonly execute: (definition: D, context: X) => Effect.Effect<unknown, E, R>;
+    /** Return false after default cancellation so a later callback never starts */
+    readonly active?: () => boolean;
+    /** Client logger for rejected, unmatched and executed command records */
+    readonly logger?: ClientLogger | undefined;
+    /** Report a failed dispatch: A command callback with its command name, or an unmatched callback, prefix or parser
+     * failure without one. Interruption is never reported. When omitted, the failure fails the dispatch
+     */
+    readonly failed?: (name: string | undefined, cause: Cause.Cause<unknown>) => Effect.Effect<void>;
+}
+/** Subscription options for an attached router: Its defaults, then each defined caller setting. An explicit undefined
+ * keeps the default. The onError option is removed because the router reports command failures through its own hook queue.
+ * A non-object value passes through unchanged so client.on rejects it with its usual ConfigurationError
+ */
+export declare function routerSubscriptionOptions(options: unknown): unknown;
+/** Dispatch one resolved command through the caller's Effect runtime without a queue, send or retry */
+export declare function dispatchCommand<D extends PrefixCommandDefinition, C, X, E, R, M extends MessageCore>(registry: PrefixCommandRegistry<D, M>, message: M, adapter: CommandDispatchAdapter<D, C, X, E, R, M>): Effect.Effect<void, ConfigurationError | E, R>;
+/**
+ * Impersonal reply text for a rejected command, used by `onReject: "reply"`.
+ * A guard denial without a reason returns undefined, so a false verdict has no generic reply.
+ * Argument rejections name the argument, what was expected and the command's usage.
+ * Cooldown replies measure the remaining time from `now`, the dispatch Clock's wall time
+ */
+export declare function rejectionReply(rejection: PrefixCommandRejection, command: PrefixCommandMetadata | undefined, prefix: string, now: number): string | undefined;
+/** Subscription delivery settings that a runBot commands option passes to the router's attach unchanged */
+export declare const botCommandDeliveryKeys: readonly ["concurrency", "partition", "overflow", "maxPendingMessages", "maxPendingBytes"];
+/**
+ * Check the keys of a runBot commands option before its router is created, so the hint also lists commands and onError.
+ * A key whose value looks like a command definition is explained as a command placed one level too high.
+ * Values are read through property descriptors, so no getter runs here
+ */
+export declare function checkBotCommandKeys(options: object, adapterKeys: readonly string[]): void;
+/** Validate a canonical group selector without retaining rejected caller values */
+export declare function copyCommandGroupPath(value: unknown, field: "command" | "help"): readonly string[];
+/** Exact canonical path comparison, independent of alias matching policy */
+export declare function sameCommandPath(left: readonly string[], right: readonly string[]): boolean;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/internal/commands.d.ts.map

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