@seedcord/core 0.9.4 → 0.11.0-next.0

package/dist/Pluggable-CwKbLui3.d.mts

@@ -1,162 +0,0 @@
-import { i as Bus, n as StartupPhase, r as CoreBase, t as ShutdownPhase } from "./phases-D_zQBXga.mjs";
-import { c as PluginLike, d as Transport, n as AttachableCtor, o as PluginArgs, r as Attached, s as PluginCtor, t as AttachKeyAssert, u as Runtime } from "./Plugin-Dhx_ivqj.mjs";
-import { Logger } from "@seedcord/logger";
-import { REST } from "@discordjs/rest";
-import { HostPluginKeys, HostShutdown, HostStartup } from "@seedcord/types/internal";
-import { Config, IRateLimiter } from "@seedcord/types";
-//#region src/node/Lifecycle/LifecycleTypes.d.ts
-interface LifecycleTask {
-  name: string;
-  task: () => Promise<void>;
-  timeout: number;
-}
-//#endregion
-//#region src/node/Lifecycle/CoordinatedLifecycle.d.ts
-declare abstract class CoordinatedLifecycle<TPhase extends number> {
-  protected readonly phaseOrder: TPhase[];
-  protected readonly phaseEnum: Record<number, string>;
-  protected readonly logger: Logger;
-  protected readonly tasksMap: Map<TPhase, LifecycleTask[]>;
-  protected constructor(loggerName: string, phaseOrder: TPhase[], phaseEnum: Record<number, string>);
-  addTask(phase: TPhase, taskName: string, task: () => Promise<void>, timeoutMs: number): void;
-  removeTask(phase: TPhase, taskName: string): boolean;
-  protected runPhase(phase: TPhase): Promise<void>;
-  protected runTaskWithTimeout(phase: TPhase, task: LifecycleTask): Promise<void>;
-  protected isAborted(): boolean;
-  protected abstract canAddTask(): boolean;
-  protected abstract canRemoveTask(): boolean;
-  protected abstract getTaskType(): string;
-  protected abstract executeTasksInPhase(phase: TPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-}
-//#endregion
-//#region src/node/Lifecycle/CoordinatedShutdown.d.ts
-declare class CoordinatedShutdown extends CoordinatedLifecycle<ShutdownPhase> {
-  private isShuttingDown;
-  private hasShutdown;
-  private exitCode;
-  private onSigTerm;
-  private onSigInt;
-  private startupGate?;
-  private deadlineMs;
-  private phasesExpireAt;
-  private runningPhase;
-  constructor(deadlineMs?: number);
-  /** @internal */
-  setDeadline(deadlineMs: number): void;
-  private runPhases;
-  protected canAddTask(): boolean;
-  protected canRemoveTask(): boolean;
-  protected getTaskType(): string;
-  protected executeTasksInPhase(phase: ShutdownPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-  private registerSignalHandlers;
-  /** @internal */
-  removeSignalHandlers(): void;
-  /** @internal run() awaits this so boot finishes registering its dispose tasks first */
-  gateOnStartup(settled: Promise<void>): void;
-  addTask(phase: ShutdownPhase, taskName: string, task: () => Promise<void>, timeoutMs?: number): void;
-  /** @internal */
-  removeTask(phase: ShutdownPhase, taskName: string): boolean;
-  /** @internal */
-  run(exitCode?: number, exitProcess?: boolean): Promise<void>;
-}
-//#endregion
-//#region src/node/Lifecycle/CoordinatedStartup.d.ts
-declare class CoordinatedStartup extends CoordinatedLifecycle<StartupPhase> {
-  private isStartingUp;
-  private hasStarted;
-  constructor();
-  addTask(phase: StartupPhase, taskName: string, task: () => Promise<void>, timeoutMs?: number): void;
-  protected canAddTask(): boolean;
-  protected canRemoveTask(): boolean;
-  protected getTaskType(): string;
-  protected executeTasksInPhase(phase: StartupPhase, tasks: LifecycleTask[]): Promise<PromiseSettledResult<void>[]>;
-  /** @internal */
-  run(): Promise<void>;
-  protected isAborted(): boolean;
-  /** @internal */
-  abort(): void;
-  /** @internal */
-  get isReady(): boolean;
-}
-//#endregion
-//#region src/node/Pluggable.d.ts
-/**
- * Base class for a plugin host, a transport `Seedcord` class.
- *
- * You attach plugins while configuring the bot. Within one startup phase, their `init()` calls run
- * one after another in attach order.
- */
-declare abstract class Pluggable<BotT extends Transport, BotRt extends Runtime> implements CoreBase {
-  abstract readonly config: Config;
-  abstract readonly rest: REST;
-  abstract readonly applicationId: string;
-  abstract readonly rateLimiter: IRateLimiter;
-  abstract readonly bus: Bus;
-  /** @internal */
-  readonly [HostShutdown]: CoordinatedShutdown;
-  /** @internal */
-  readonly [HostStartup]: CoordinatedStartup;
-  /** Add a task that runs while the bot shuts down. */
-  readonly shutdown: Pick<CoordinatedShutdown, 'addTask'>;
-  /** Add a task that runs while the bot starts. */
-  readonly startup: Pick<CoordinatedStartup, 'addTask'>;
-  protected isInitialized: boolean;
-  protected startFailed: boolean;
-  protected readonly plugins: PluginLike[];
-  private readonly groups;
-  private readonly pluginLogger;
-  private readonly attachments;
-  private readonly completedInits;
-  private readonly disposePhases;
-  private pluginTasksRegistered;
-  private initPromise?;
-  private static isInstantiated;
-  private static liveHost?;
-  private static liveShutdown?;
-  private static liveProcessErrors?;
-  constructor(shutdown: CoordinatedShutdown, startup: CoordinatedStartup);
-  /** @internal */
-  protected init(): Promise<this>;
-  private runInit;
-  /** @internal codegen reads this to emit the `Core` augmentation */
-  get [HostPluginKeys](): readonly string[];
-  /** @internal */
-  protected static reset(host?: object): boolean;
-  /**
-   * Attaches a plugin under `key`. Read the instance back as `core[key]`. `seedcord codegen`
-   * writes the `Core` augmentation that types it there.
-   *
-   * Put one dot in the key to nest the plugin under a group, so `'services.users'` reads back as
-   * `core.services.users`. Each name holds one plugin or one group.
-   *
-   * Startup runs each plugin's `init()` in attach order within its phase.
-   *
-   * Attaching a plugin whose `transport` or `runtime` differs from this host fails to compile.
-   * Your constructor takes `CoreBase` as its first parameter (you don't need to pass it though).
-   * A narrower one fails to compile here.
-   *
-   * @param key - Also the channel the plugin logs on, dots included. Reserved channel names throw.
-   * @param args - Whatever your constructor takes after the host.
-   * @throws A **SeedcordError** if you attach after the bot has started. A taken or reserved key throws too.
-   * So does a plugin that extends `Plugin` from another copy of `@seedcord/core`.
-   * @example
-   * ```ts
-   * seedcord.attach('db', Mongoose, { uri: 'mongodb://...', name: 'seedcord', dir: ... });
-   * ```
-   */
-  attach<Key extends string, Ctor extends PluginCtor>(this: this, key: AttachKeyAssert<Key, this>, Plugin: AttachableCtor<Ctor, BotT, BotRt>, ...args: PluginArgs<Ctor>): this & Attached<Key, InstanceType<Ctor>>;
-  private assertFree;
-  private groupFor;
-  private registerPluginTasks;
-  private runInits;
-  private disposeWhenInitResolves;
-  private registerReadyTask;
-  private registerDisposeTask;
-  private runDisposals;
-  private disposeCompleted;
-  private rollback;
-}
-declare function shutdownOf(host: Pick<Pluggable<Transport, Runtime>, typeof HostShutdown>): CoordinatedShutdown;
-//#endregion
-export { LifecycleTask as a, CoordinatedShutdown as i, shutdownOf as n, CoordinatedStartup as r, Pluggable as t };
-//# sourceMappingURL=Pluggable-CwKbLui3.d.mts.map

package/dist/Plugin-CmNW5n6a.mjs

@@ -1,122 +0,0 @@
-import { n as StartupPhase, t as ShutdownPhase } from "./phases-BauKJOTT.mjs";
-import { t as getDevChannel } from "./devChannel-CQU7hq7Q.mjs";
-import { SeedcordErrorCode } from "@seedcord/errors";
-import { SeedcordError, SeedcordRangeError } from "@seedcord/errors/internal";
-import { Logger } from "@seedcord/logger";
-
-//#region src/plugin/lifecycle.ts
-const DEFAULT_INIT_TIMEOUT_MS = 15e3;
-const DEFAULT_READY_TIMEOUT_MS = 15e3;
-const DEFAULT_DISPOSE_TIMEOUT_MS = 1e4;
-function timeoutOf(field, declared, fallback, pluginName) {
-	if (declared === void 0) return fallback;
-	if (!Number.isFinite(declared) || declared <= 0) throw new SeedcordRangeError(SeedcordErrorCode.PluginInvalidLifecycleTimeout, [
-		pluginName,
-		field,
-		declared
-	]);
-	return declared;
-}
-/** @internal */
-function resolveLifecycleSpec(spec, pluginName) {
-	return {
-		init: {
-			phase: spec?.init?.phase ?? 1,
-			timeout: timeoutOf("init", spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)
-		},
-		ready: { timeout: timeoutOf("ready", spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName) },
-		dispose: {
-			phase: spec?.dispose?.phase ?? 3,
-			timeout: timeoutOf("dispose", spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)
-		}
-	};
-}
-
-//#endregion
-//#region src/plugin/Plugin.ts
-/** @internal */
-const resolvedSpecSlot = Symbol("seedcord:plugin:spec");
-/** @internal */
-const loggerSlot = Symbol("seedcord:plugin:logger");
-/**
-* Base class for a seedcord plugin. Extend it and implement `init()`. `this.core` is the running
-* bot.
-*
-* Your constructor takes the host first and passes it to `super()`. Add your own parameters after
-* it. `attach()` types them at the call site.
-*
-* @typeParam Opts - Where this plugin may attach, checked only at compile time.
-* @typeParam TCore - The `Core` each transport binds `this.core` to.
-*
-* @example
-* ```ts
-* class Analytics extends Plugin<{ transport: 'gateway' }> {
-*     constructor(
-*         host: CoreBase,
-*         private readonly apiKey: string
-*     ) {
-*         super(host, { init: { phase: StartupPhase.Login } });
-*     }
-*
-*     public async init(): Promise<void> {
-*         await this.connect(this.apiKey);
-*     }
-* }
-*
-* seedcord.attach('analytics', Analytics, apiKey);
-* ```
-*/
-var Plugin = class {
-	host;
-	/** @internal */
-	[resolvedSpecSlot];
-	/** @internal */
-	[loggerSlot];
-	/** Logs under the plugin's class name, on the channel its attach key sets. */
-	logger;
-	constructor(host, spec) {
-		this.host = host;
-		this.logger = new Logger(this.constructor.name);
-		this[loggerSlot] = this.logger;
-		this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);
-	}
-	/** The host, typed to the transport whose `Plugin` base this class extends. */
-	get core() {
-		return this.host;
-	}
-	/**
-	* Throws a `SeedcordError` that contains the plugin class name and the reason.
-	*
-	* @param reason - Why the options are invalid.
-	*/
-	rejectOptions(reason) {
-		throw new SeedcordError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);
-	}
-	/** Override to reload plugin state on an HMR update. */
-	onHmr(_event) {
-		return Promise.resolve();
-	}
-	/**
-	* Registers critical file patterns that should trigger a full restart when changed in Dev HMR.
-	* @param patterns - Glob patterns relative to the project root
-	*/
-	registerCriticalFiles(patterns) {
-		getDevChannel()?.send("seedcord:register-critical-files", { patterns });
-	}
-};
-/** @internal */
-function resolvedLifecycleSpecOf(plugin) {
-	return plugin[resolvedSpecSlot];
-}
-/** @internal */
-function extendsThisCorePlugin(ctor) {
-	return ctor.prototype instanceof Plugin;
-}
-/** @internal */
-function pluginLoggerOf(plugin) {
-	return plugin[loggerSlot];
-}
-
-//#endregion
-export { resolvedLifecycleSpecOf as i, extendsThisCorePlugin as n, pluginLoggerOf as r, Plugin as t };
-//# sourceMappingURL=Plugin-CmNW5n6a.mjs.map

package/dist/Plugin-CmNW5n6a.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"Plugin-CmNW5n6a.mjs","names":[],"sources":["../src/plugin/lifecycle.ts","../src/plugin/Plugin.ts"],"sourcesContent":["import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordRangeError } from '@seedcord/errors/internal';\n\nimport { ShutdownPhase, StartupPhase } from '#src/lifecycle/phases';\n\n/**\n * Sets when a plugin's lifecycle methods run. Pass it as the second argument to `super()`. Omit a\n * field to keep its default.\n *\n * @see {@link StartupPhase}\n * @see {@link ShutdownPhase}\n * @example\n * ```ts\n * super(host, { init: { phase: StartupPhase.Login }, dispose: { timeout: 30_000 } });\n * ```\n */\nexport interface PluginLifecycleSpec {\n    /**\n     * Defaults to `StartupPhase.Configuration` and 15000ms. Set the phase to `Ready` and `init()`\n     * runs ahead of every plugin's `ready()`.\n     */\n    init?: { phase?: StartupPhase; timeout?: number };\n    /** `ready()` always runs in `StartupPhase.Ready`. Defaults to a 15000ms timeout. */\n    ready?: { timeout?: number };\n    /** Defaults to `ShutdownPhase.Disconnect` and 10000ms. */\n    dispose?: { phase?: ShutdownPhase; timeout?: number };\n}\n\n/** @internal */\nexport interface ResolvedPluginLifecycleSpec {\n    readonly init: { readonly phase: StartupPhase; readonly timeout: number };\n    readonly ready: { readonly timeout: number };\n    readonly dispose: { readonly phase: ShutdownPhase; readonly timeout: number };\n}\n\nconst DEFAULT_INIT_TIMEOUT_MS = 15_000;\nconst DEFAULT_READY_TIMEOUT_MS = 15_000;\nconst DEFAULT_DISPOSE_TIMEOUT_MS = 10_000;\n\nfunction timeoutOf(\n    field: 'init' | 'ready' | 'dispose',\n    declared: number | undefined,\n    fallback: number,\n    pluginName: string\n): number {\n    if (declared === undefined) return fallback;\n    if (!Number.isFinite(declared) || declared <= 0) {\n        throw new SeedcordRangeError(SeedcordErrorCode.PluginInvalidLifecycleTimeout, [pluginName, field, declared]);\n    }\n    return declared;\n}\n\n/** @internal */\nexport function resolveLifecycleSpec(\n    spec: PluginLifecycleSpec | undefined,\n    pluginName: string\n): ResolvedPluginLifecycleSpec {\n    return {\n        init: {\n            phase: spec?.init?.phase ?? StartupPhase.Configuration,\n            timeout: timeoutOf('init', spec?.init?.timeout, DEFAULT_INIT_TIMEOUT_MS, pluginName)\n        },\n        ready: {\n            timeout: timeoutOf('ready', spec?.ready?.timeout, DEFAULT_READY_TIMEOUT_MS, pluginName)\n        },\n        dispose: {\n            phase: spec?.dispose?.phase ?? ShutdownPhase.Disconnect,\n            timeout: timeoutOf('dispose', spec?.dispose?.timeout, DEFAULT_DISPOSE_TIMEOUT_MS, pluginName)\n        }\n    };\n}\n","import { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\n\nimport { getDevChannel } from '#hmr/devChannel';\n\nimport { RuntimeBrand, TransportBrand } from './brands';\nimport { resolveLifecycleSpec } from './lifecycle';\n\nimport type { CoreBase } from '#interfaces/CoreBase';\nimport type { ResolvedPluginLifecycleSpec, PluginLifecycleSpec } from './lifecycle';\nimport type {\n    TransportOf,\n    PluginOptions,\n    RuntimeOf,\n    Runtime,\n    RuntimeAssert,\n    Transport,\n    TransportAssert\n} from './options';\nimport type { Tail, FrameworkChannel, HmrAware, HmrUpdateEvent } from '@seedcord/types';\n\nexport interface Initializeable {\n    init(): Promise<void>;\n}\n\n/** @internal */\nconst resolvedSpecSlot = Symbol('seedcord:plugin:spec');\n/** @internal */\nconst loggerSlot = Symbol('seedcord:plugin:logger');\n\n/**\n * Base class for a seedcord plugin. Extend it and implement `init()`. `this.core` is the running\n * bot.\n *\n * Your constructor takes the host first and passes it to `super()`. Add your own parameters after\n * it. `attach()` types them at the call site.\n *\n * @typeParam Opts - Where this plugin may attach, checked only at compile time.\n * @typeParam TCore - The `Core` each transport binds `this.core` to.\n *\n * @example\n * ```ts\n * class Analytics extends Plugin<{ transport: 'gateway' }> {\n *     constructor(\n *         host: CoreBase,\n *         private readonly apiKey: string\n *     ) {\n *         super(host, { init: { phase: StartupPhase.Login } });\n *     }\n *\n *     public async init(): Promise<void> {\n *         await this.connect(this.apiKey);\n *     }\n * }\n *\n * seedcord.attach('analytics', Analytics, apiKey);\n * ```\n */\nexport abstract class Plugin<Opts extends PluginOptions = {}, TCore extends CoreBase = CoreBase>\n    implements Initializeable, HmrAware\n{\n    // phantom, never set at runtime.\n    /** @internal */\n    declare readonly [TransportBrand]?: TransportOf<Opts>;\n    /** @internal */\n    declare readonly [RuntimeBrand]?: RuntimeOf<Opts>;\n\n    /** @internal */\n    readonly [resolvedSpecSlot]: ResolvedPluginLifecycleSpec;\n    /** @internal */\n    readonly [loggerSlot]: Logger;\n\n    /** Logs under the plugin's class name, on the channel its attach key sets. */\n    protected readonly logger: Logger;\n\n    // CoreBase here keeps the augmented Core out of ConstructorParameters, which attach reads\n    constructor(\n        private readonly host: CoreBase,\n        spec?: PluginLifecycleSpec\n    ) {\n        this.logger = new Logger(this.constructor.name);\n        this[loggerSlot] = this.logger;\n        this[resolvedSpecSlot] = resolveLifecycleSpec(spec, this.constructor.name);\n    }\n\n    /** The host, typed to the transport whose `Plugin` base this class extends. */\n    protected get core(): TCore {\n        // justified: each transport binds TCore to the Core its own host satisfies\n        return this.host as TCore;\n    }\n\n    /**\n     * Runs in `StartupPhase.Configuration` by default.\n     * Move it to a different phase with the {@link PluginLifecycleSpec}.\n     */\n    abstract init(): Promise<void>;\n\n    /**\n     * Runs in the Ready phase, after every attached plugin's `init()` has resolved. The other Ready\n     * tasks run alongside it, including the http server binding its port.\n     *\n     * Override it when your work needs a logged-in client or a resolved application id.\n     */\n    ready?(): Promise<void>;\n\n    /**\n     * Runs during teardown, in `ShutdownPhase.Disconnect` by default. seedcord skips it when `init()`\n     * has thrown.\n     *\n     * When `init()` outlasts its timeout, seedcord calls this once that `init()` resolves, outside any\n     * shutdown phase. The process must still be alive for that call to happen.\n     */\n    dispose?(): Promise<void>;\n\n    /**\n     * Throws a `SeedcordError` that contains the plugin class name and the reason.\n     *\n     * @param reason - Why the options are invalid.\n     */\n    protected rejectOptions(reason: string): never {\n        throw new SeedcordError(SeedcordErrorCode.PluginOptionsRejected, [this.constructor.name, reason]);\n    }\n\n    /** Override to reload plugin state on an HMR update. */\n    public onHmr(_event: HmrUpdateEvent): Promise<void> {\n        return Promise.resolve();\n    }\n\n    /**\n     * Registers critical file patterns that should trigger a full restart when changed in Dev HMR.\n     * @param patterns - Glob patterns relative to the project root\n     */\n    protected registerCriticalFiles(patterns: string[]): void {\n        getDevChannel()?.send('seedcord:register-critical-files', { patterns });\n    }\n}\n\n/** @internal */\nexport function resolvedLifecycleSpecOf(plugin: PluginLike): ResolvedPluginLifecycleSpec {\n    return plugin[resolvedSpecSlot];\n}\n\n/** @internal */\nexport function extendsThisCorePlugin(ctor: PluginCtor): boolean {\n    return ctor.prototype instanceof Plugin;\n}\n\n/** @internal */\nexport function pluginLoggerOf(plugin: PluginLike): Logger {\n    return plugin[loggerSlot];\n}\n\nexport type { PluginLifecycleSpec } from './lifecycle';\nexport type { PluginOptions } from './options';\n\n// a bound of Plugin<{}> rejects every plugin that declares an option, since Plugin<A> and Plugin<B>\n// are mutually unassignable. every member here must stay Opts-independent.\n/** @internal */\nexport type PluginLike = Pick<\n    Plugin,\n    'init' | 'ready' | 'dispose' | 'onHmr' | typeof resolvedSpecSlot | typeof loggerSlot\n>;\n\n// a `CoreBase` first parameter rejects a narrowing ctor on its own, and it also collapses\n// `InstanceType<Ctor>` to `PluginLike` at every attach call. CoreParamAssert checks it instead.\n/** @internal */\nexport type PluginCtor<TPlugin extends PluginLike = PluginLike> = new (...args: any[]) => TPlugin;\n\n/** @internal */\nexport type PluginArgs<Ctor extends PluginCtor> = Tail<ConstructorParameters<Ctor>>;\n\n/** @internal */\nexport type Attached<Key extends string, Instance> = Key extends `${infer Group}.${infer Leaf}`\n    ? Record<Group, Record<Leaf, Instance>>\n    : Record<Key, Instance>;\n\n// attach writes the key onto the host, so a key like toString would shadow the one on Object.prototype\n// eslint-disable-next-line @typescript-eslint/no-wrapper-object-types -- lint:fix swaps this for `keyof object`, which is never\ntype HostMember<Host> = keyof Host | keyof Object;\n\n// a string argument against an object type renders only as `string is not assignable`\n/** @internal */\nexport type AttachKeyAssert<Key extends string, Host> = Key extends ''\n    ? 'A plugin key needs a name.'\n    : Key extends `${infer Group}.${infer Leaf}`\n      ? Leaf extends `${string}.${string}`\n          ? `'${Key}' has more than one dot. A plugin key takes one dot at most.`\n          : '' extends Group | Leaf\n            ? `'${Key}' has an empty part. Write a group and a plugin name around the dot, like 'services.users'.`\n            : Group extends FrameworkChannel\n              ? `'${Group}' is a channel the framework logs on. Pick another group name.`\n              : Group extends keyof Host\n                ? Host[Group] extends PluginLike\n                    ? `'${Group}' already holds a plugin, so '${Leaf}' cannot nest inside it.`\n                    : Host[Group] extends Record<string, PluginLike>\n                      ? Leaf extends keyof Host[Group]\n                          ? `'${Key}' is already attached.`\n                          : Key\n                      : `'${Group}' is already a member on the bot. Pick another group name.`\n                : Group extends HostMember<Host>\n                  ? `'${Group}' is already a member on the bot. Pick another group name.`\n                  : Key\n      : Key extends FrameworkChannel\n        ? `'${Key}' is a channel the framework logs on. Pick another plugin key.`\n        : Key extends keyof Host\n          ? Host[Key] extends PluginLike\n              ? `'${Key}' is already attached.`\n              : Host[Key] extends Record<string, PluginLike>\n                ? `'${Key}' already holds a group of plugins. Attach this one under a name of its own.`\n                : `'${Key}' is already a member on the bot. Pick another plugin key.`\n          : Key extends HostMember<Host>\n            ? `'${Key}' is already a member on the bot. Pick another plugin key.`\n            : Key;\n\ntype CoreParamTooNarrow = Record<\n    'this plugin constructor must take CoreBase as its first parameter and read the transport Core off this.core',\n    never\n>;\n\n// a narrowed first parameter fails `CoreBase extends Param`\ntype CoreParamAssert<Ctor extends PluginCtor> = CoreBase extends ConstructorParameters<Ctor>[0]\n    ? unknown\n    : CoreParamTooNarrow;\n\ntype AttachAsserts<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> = TransportAssert<\n    InstanceType<Ctor>,\n    BotT\n> &\n    RuntimeAssert<InstanceType<Ctor>, BotRt> &\n    CoreParamAssert<Ctor>;\n\n// typescript can't infer Ctor from a generic class through `Ctor & AttachAsserts`. every assert returns unknown to pass.\n/** @internal */\nexport type AttachableCtor<Ctor extends PluginCtor, BotT extends Transport, BotRt extends Runtime> =\n    unknown extends AttachAsserts<Ctor, BotT, BotRt> ? Ctor : AttachAsserts<Ctor, BotT, BotRt>;\n"],"mappings":";;;;;;;AAmCA,MAAM,0BAA0B;AAChC,MAAM,2BAA2B;AACjC,MAAM,6BAA6B;AAEnC,SAAS,UACL,OACA,UACA,UACA,YACM;CACN,IAAI,aAAa,QAAW,OAAO;CACnC,IAAI,CAAC,OAAO,SAAS,QAAQ,KAAK,YAAY,GAC1C,MAAM,IAAI,mBAAmB,kBAAkB,+BAA+B;EAAC;EAAY;EAAO;CAAQ,CAAC;CAE/G,OAAO;AACX;;AAGA,SAAgB,qBACZ,MACA,YAC2B;CAC3B,OAAO;EACH,MAAM;GACF,OAAO,MAAM,MAAM;GACnB,SAAS,UAAU,QAAQ,MAAM,MAAM,SAAS,yBAAyB,UAAU;EACvF;EACA,OAAO,EACH,SAAS,UAAU,SAAS,MAAM,OAAO,SAAS,0BAA0B,UAAU,EAC1F;EACA,SAAS;GACL,OAAO,MAAM,SAAS;GACtB,SAAS,UAAU,WAAW,MAAM,SAAS,SAAS,4BAA4B,UAAU;EAChG;CACJ;AACJ;;;;;AC3CA,MAAM,mBAAmB,OAAO,sBAAsB;;AAEtD,MAAM,aAAa,OAAO,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BlD,IAAsB,SAAtB,MAEA;CAiByB;;CATrB,CAAU;;CAEV,CAAU;;CAGV,AAAmB;CAGnB,YACI,AAAiB,MACjB,MACF;EAFmB;EAGjB,KAAK,SAAS,IAAI,OAAO,KAAK,YAAY,IAAI;EAC9C,KAAK,cAAc,KAAK;EACxB,KAAK,oBAAoB,qBAAqB,MAAM,KAAK,YAAY,IAAI;CAC7E;;CAGA,IAAc,OAAc;EAExB,OAAO,KAAK;CAChB;;;;;;CA8BA,AAAU,cAAc,QAAuB;EAC3C,MAAM,IAAI,cAAc,kBAAkB,uBAAuB,CAAC,KAAK,YAAY,MAAM,MAAM,CAAC;CACpG;;CAGA,AAAO,MAAM,QAAuC;EAChD,OAAO,QAAQ,QAAQ;CAC3B;;;;;CAMA,AAAU,sBAAsB,UAA0B;EACtD,cAAc,CAAC,EAAE,KAAK,oCAAoC,EAAE,SAAS,CAAC;CAC1E;AACJ;;AAGA,SAAgB,wBAAwB,QAAiD;CACrF,OAAO,OAAO;AAClB;;AAGA,SAAgB,sBAAsB,MAA2B;CAC7D,OAAO,KAAK,qBAAqB;AACrC;;AAGA,SAAgB,eAAe,QAA4B;CACvD,OAAO,OAAO;AAClB"}

package/dist/contextMenuLeaves-COzDYa6c.d.mts

@@ -1,17 +0,0 @@
-import { ContextMenuCommandBuilder, SlashCommandBuilder } from "@discordjs/builders";
-//#region src/commands/contextMenuLeaves.d.ts
-/** @internal */
-interface ContextMenuLeaves {
-  readonly user: Set<string>;
-  readonly message: Set<string>;
-}
-/**
- * dedupes names across builders, since the same builder repeats once per guild.
- * a user and a message command can share a name.
- *
- * @internal
- */
-declare function contextMenuLeaves(commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>): ContextMenuLeaves;
-//#endregion
-export { contextMenuLeaves as n, ContextMenuLeaves as t };
-//# sourceMappingURL=contextMenuLeaves-COzDYa6c.d.mts.map