@seedcord/core 0.9.4 → 0.11.0-next.0

package/dist/internal.index.d.mts

@@ -1,18 +1,36 @@
-import { A as RegisteredCount, B as InteractionMetadataKey, C as AckState, D as AckTrace, E as sendTarget, F as CommandMetadataKey, G as WebhookUrlMetadataKey, H as InteractionRouteKeys, I as EventMetadataKey, K as Notice, L as EventMiddlewareMetadataKey, M as VerifyWebhooks, N as PublishDefault, O as RegisterDefaults, R as GatedMetadataKey, S as reportedWrite, T as checkAckLegality, U as MiddlewareKind, V as InteractionMiddlewareMetadataKey, W as SubscribeMetadataKey, a as StoredSubscriberCtor, c as registrationFor, d as DefaultSubscriptions, f as DispatchOutcome, i as Bus, j as UnregisterSubscriber, k as RegisterSubscriber, o as SubscriberRegistration, s as busLoggerOf, w as ReplyMethod, x as ReplyTelemetry, z as InteractionKind } from "./phases-D_zQBXga.mjs";
-import { A as serializeReply, B as AutocompleteRouteBrand, C as Gate, F as AnyMiddlewareCtor, G as MiddlewareKindsBrand, H as ComponentKindBrand, I as InteractionMiddlewareMetadata, K as SlashRouteBrand, M as EventDispatchResult, P as HandlerResult, U as ContextMenuKindBrand, V as ComponentDefsBrand, W as ContextMenuNamesBrand, X as BuilderComponent, _ as pickNotice, at as SlashRouteEntry, c as FocusedField, et as CacheFor, i as AutocompletableNames, it as SlashRegistry, j as DispatchResult, k as SerializedReply, lt as NamesFor, m as PermissionNames, n as PageCursor, nt as RouteCache, o as ChoiceValueOf, ot as ContextMenuKind, q as CommandMeta, r as pageCursor, rt as SlashOption, s as EntryFor, st as MenuCacheFor, t as PAGE_MAX, tt as OptionKind, v as GateFitsWith, w as GateContextBase, z as interactionMiddlewareMetaOf } from "./cursor-BTU5bGoo.mjs";
-import { n as DeployResult, t as CommandBuilder } from "./types-BG0BimVr.mjs";
-import { i as Initializeable, o as PluginArgs, s as PluginCtor } from "./Plugin-Dhx_ivqj.mjs";
-import { n as contextMenuLeaves, t as ContextMenuLeaves } from "./contextMenuLeaves-COzDYa6c.mjs";
+import { A as RegisteredCount, B as InteractionMetadataKey, C as AckState, D as AckTrace, E as sendTarget, F as CommandMetadataKey, G as WebhookUrlMetadataKey, H as InteractionRouteKeys, I as EventMetadataKey, K as Notice, L as EventMiddlewareMetadataKey, M as VerifyWebhooks, N as PublishDefault, O as RegisterDefaults, R as GatedMetadataKey, S as reportedWrite, T as checkAckLegality, U as MiddlewareKind, V as InteractionMiddlewareMetadataKey, W as SubscribeMetadataKey, a as StoredSubscriberCtor, c as registrationFor, d as DefaultSubscriptions, f as DispatchOutcome, i as Bus, j as UnregisterSubscriber, k as RegisterSubscriber, o as SubscriberRegistration, r as CoreBase, s as busLoggerOf, w as ReplyMethod, x as ReplyTelemetry, z as InteractionKind } from "./phases-FTM69J3a.mjs";
+import { $ as SlashRouteBrand, A as Gate, At as CacheFor, Ct as CommandMeta, Et as BuilderComponent, Ft as SlashRouteEntry, H as AnyMiddlewareCtor, I as SerializedReply, It as ContextMenuKind, J as ComponentDefsBrand, K as interactionMiddlewareMetaOf, L as serializeReply, Lt as MenuCacheFor, Mt as RouteCache, Nt as SlashOption, Pt as SlashRegistry, Q as MiddlewareKindsBrand, R as DispatchResult, St as resolveDeployTarget, T as GateFitsWith, U as InteractionMiddlewareMetadata, V as HandlerResult, X as ContextMenuKindBrand, Y as ComponentKindBrand, Z as ContextMenuNamesBrand, _t as ScopeId, bt as scopeIdsOf, c as PageCursor, ct as CommandRef, dt as commandRefOf, f as ChoiceValueOf, ft as indexById, gt as GLOBAL_ID, h as ResolvedEmoji, ht as DeployResult, j as GateContextBase, jt as OptionKind, l as pageCursor, lt as LinkedCommands, m as FocusedField, mt as CommandBuilder, ot as installLinks, p as EntryFor, pt as linkCommands, q as AutocompleteRouteBrand, s as PAGE_MAX, st as warnLinks, u as AutocompletableNames, ut as commandKey, vt as commandsRoute, w as pickNotice, x as PermissionNames, xt as skippedNote, yt as globalFirst, z as EventDispatchResult, zt as NamesFor } from "./index-Du71Xx69.mjs";
+import { a as FixedScope, c as PluginArgs, i as sealAttachments, l as PluginCtor, o as Initializeable, r as attachmentsOf, t as Attachment } from "./PluginHost-DB4j8unu.mjs";
+import { n as CoordinatedStartup, t as CoordinatedShutdown } from "./CoordinatedShutdown-H5YjZn8A.mjs";
 import "reflect-metadata";
 import { AnyCustomId, DecodedParams } from "@seedcord/custom-id";
 import { ContextMenuCommandBuilder, SlashCommandBuilder } from "@discordjs/builders";
-import { ChannelType } from "discord-api-types/v10";
+import { APIApplicationCommand, ChannelType, RESTGetCurrentApplicationResult, RESTPostAPIApplicationCommandsJSONBody } from "discord-api-types/v10";
 import { SeedcordErrorCode } from "@seedcord/errors";
-import { SeedcordError } from "@seedcord/errors/internal";
+import { BotToken, SeedcordError } from "@seedcord/errors/internal";
 import { Logger } from "@seedcord/logger";
-import { DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents } from "@seedcord/types/internal";
-import { BotColor, DeferOpts, EpochMs, HmrAware, ReplyResponse, SendOpts } from "@seedcord/types";
+import { REST } from "@discordjs/rest";
+import { DeployedHashes, DevChannel, SeedcordCliEvents, SeedcordFrameworkEvents, WireError } from "@seedcord/types/internal";
+import { BotColor, DeferOpts, EpochMs, ErrorsConfig, HmrAware, HmrUpdateEvent, ILogger, LogRecord, ReplyResponse, SendOpts } from "@seedcord/types";
 import { Constructor, IsNever, Promisable } from "type-fest";
+//#region src/subscribers/SubscriberLoader.d.ts
+export declare class SubscriberLoader implements Initializeable, HmrAware {
+  private readonly bus;
+  private readonly directory;
+  private isInitialized;
+  private readonly hmrHandler?;
+  constructor(bus: Bus, directory: string | null);
+  /** @internal */
+  init(): Promise<void>;
+  /** @internal */
+  onHmr(event: HmrUpdateEvent): Promise<void>;
+  private load;
+  private registerSubscriber;
+  private unregisterSubscriber;
+  private getArtifacts;
+  private isSubscriber;
+}
+//#endregion
 //#region src/dispatch/MiddlewareRegistry.d.ts
 /**
  * A decorated middleware reduced to what the registry orders and filters on. An absent `keys` puts the
@@ -49,8 +67,6 @@ export declare class MiddlewareRegistry<Ctor extends AnyMiddlewareCtor, Key exte
   /**
    * Adds a decorated middleware class and returns what it registered with. Returns `undefined` for an
    * undecorated class or one already registered.
-   *
-   * @throws A **SeedcordError** If another class with the same name is registered.
    */
   register(ctor: Ctor): MiddlewareRegistration<Key> | undefined;
   unregister(ctor: Ctor): void;
@@ -61,9 +77,33 @@ export declare class MiddlewareRegistry<Ctor extends AnyMiddlewareCtor, Key exte
 //#region src/components/botColorHolder.d.ts
 export declare function bindBotColor(read: () => BotColor | undefined): void;
 //#endregion
+//#region src/notices/logUnknownFault.d.ts
+export declare function logUnknownFault(logger: Logger, uuid: string, error: Error, errors: ErrorsConfig | undefined): void;
+//#endregion
+//#region src/lifecycle/PluginLifecycle.d.ts
+export declare class PluginLifecycle {
+  private readonly startup;
+  private readonly shutdown;
+  private readonly logger;
+  private readonly completedInits;
+  private readonly disposePhases;
+  private readonly timedOutInits;
+  private attachments;
+  private registered;
+  constructor(startup: Pick<CoordinatedStartup, 'addTask'>, shutdown: Pick<CoordinatedShutdown, 'addTask'>);
+  register(attachments: readonly Attachment[]): void;
+  rollback(): Promise<void>;
+  afterTimedOutInits(run: () => void): void;
+  private runInits;
+  private disposeWhenInitResolves;
+  private registerReadyTask;
+  private registerDisposeTask;
+  private runDisposals;
+  private disposeCompleted;
+}
+//#endregion
 //#region src/decorators/interactionRoutes.d.ts
 type RoutableConstructor = new (...args: never[]) => unknown;
-export declare function areRoutes(routes: unknown): routes is string[];
 export declare function interactionRoutesOf(constructor: RoutableConstructor): [InteractionKind, string[]][];
 export declare function storeInteractionRoute(route: InteractionKind, routes: string | readonly string[], constructor: RoutableConstructor): void;
 export declare function storeComponentRoute(route: InteractionKind, defs: readonly AnyCustomId[], constructor: RoutableConstructor): void;
@@ -93,6 +133,124 @@ export declare function guardedAccessor<Value>(accessor: string, storage: Record
 //#region src/miscellaneous/emojiConfig.d.ts
 export declare function isEmojiTuple(value: unknown): value is readonly [string, string];
 //#endregion
+//#region src/miscellaneous/currentApplication.d.ts
+export declare function currentApplication(rest: Pick<REST, 'get'>): Promise<RESTGetCurrentApplicationResult>;
+//#endregion
+//#region src/miscellaneous/readBotToken.d.ts
+export declare function readBotToken(): BotToken;
+//#endregion
+//#region src/miscellaneous/resolveEmojis.d.ts
+type EmojiRest = Pick<REST, 'get'>;
+export declare function resolveEmojis(rest: EmojiRest, applicationId: string, configured: Readonly<Record<string, unknown>>): Promise<Record<string, ResolvedEmoji>>;
+//#endregion
+//#region src/bakedIds.d.ts
+export declare const BAKED_IDS_KEY = "seedcord:core:baked-ids";
+interface BakedIds {
+  readonly publicKey: string;
+  readonly emojis: Readonly<Record<string, Pick<ResolvedEmoji, 'name' | 'id' | 'animated'>>>;
+  readonly commands: LinkedCommands['commands'];
+  readonly contextMenus: LinkedCommands['contextMenus'];
+}
+//#endregion
+//#region src/commands/contextMenuLeaves.d.ts
+interface ContextMenuLeaves {
+  readonly user: Set<string>;
+  readonly message: Set<string>;
+}
+export declare function contextMenuLeaves(commands: Iterable<RESTPostAPIApplicationCommandsJSONBody>): ContextMenuLeaves;
+//#endregion
+//#region src/commands/CommandRegistry.d.ts
+interface RouteWarnings {
+  warnUnhandledRoutes(leaves: Iterable<string>): void;
+  warnUnhandledContextMenuRoutes(leaves: ContextMenuLeaves): void;
+}
+interface DeployHooks {
+  routes?: RouteWarnings | undefined;
+  check?: (commands: CommandBuilder[]) => void;
+}
+export declare const COMMAND_DEPLOY_TIMEOUT_MS = 75000;
+/**
+ * Scans the command directory, builds each command, and PUTs the global and guild scopes to Discord.
+ *
+ * @internal
+ */
+export declare class CommandRegistry implements Initializeable, HmrAware {
+  private readonly core;
+  private readonly logger;
+  private isInitialised;
+  readonly scopedCommands: Map<ScopeId, CommandBuilder[]>;
+  private readonly ctorToCommand;
+  private loading;
+  private readonly loadedCommands;
+  private readonly hmrHandler?;
+  private readonly pendingEvents;
+  private readonly injector;
+  private readonly lastDeploy;
+  private readonly reporter;
+  private readonly dir;
+  private readonly configuredGuilds;
+  constructor(core: CoreBase);
+  private getArtifacts;
+  /** @internal */
+  init(): Promise<void>;
+  private reportLoad;
+  /** @internal */
+  refresh(shouldRefresh?: boolean): Promise<void>;
+  /** @internal */
+  onHmr(event: HmrUpdateEvent): Promise<void>;
+  private loadCommands;
+  private registerCommand;
+  private unregisterCommand;
+  /** @internal */
+  deploy(signal: AbortSignal, { routes, check }: DeployHooks): Promise<void>;
+  /** @internal */
+  setCommands(signal?: AbortSignal): Promise<DeployResult>;
+  private commandBodies;
+  private allCommands;
+  private routeLeaves;
+  private contextMenuLeaves;
+}
+//#endregion
+//#region src/commands/putCommands.d.ts
+type CommandBody = RESTPostAPIApplicationCommandsJSONBody;
+type CommandScopes = ReadonlyMap<ScopeId, readonly CommandBody[]>;
+interface PutCommandsOptions {
+  readonly rest: Pick<REST, 'put' | 'on' | 'off'>;
+  readonly applicationId: string;
+  readonly logger: Pick<ILogger, 'warn'>;
+  readonly signal?: AbortSignal | undefined;
+  readonly onDeployed?: (scope: ScopeId, commands: readonly CommandBody[]) => void;
+}
+export declare function putCommands(scopes: CommandScopes, options: PutCommandsOptions): Promise<DeployResult>;
+//#endregion
+//#region src/commands/readCommands.d.ts
+interface ReadCommandsOptions {
+  readonly rest: Pick<REST, 'get'>;
+  readonly applicationId: string;
+  readonly signal?: AbortSignal | undefined;
+}
+export declare function readCommandsAt(scope: ScopeId, { rest, applicationId, signal }: ReadCommandsOptions): Promise<Map<string, APIApplicationCommand>>;
+export declare function readCommands(scopes: Iterable<ScopeId>, options: ReadCommandsOptions): Promise<DeployResult>;
+//#endregion
+//#region src/commands/planDeploy.d.ts
+type ScopeHashes = DeployedHashes['scopes'];
+interface DeployPlan {
+  hashes: ScopeHashes;
+  skippedHashes: ScopeHashes;
+  toPut: CommandScopes;
+  skipped: ScopeId[];
+  onDiscord: DeployResult;
+}
+export declare function planDeploy(scopes: CommandScopes, last: ScopeHashes | undefined, readUnchanged: (scopes: ScopeId[]) => Promise<DeployResult>): Promise<DeployPlan>;
+//#endregion
+//#region src/commands/guildSummaries.d.ts
+interface GuildSummary {
+  id: string;
+  name: string;
+}
+type ReadRest = Pick<REST, 'get'>;
+export declare function guildSummaries(rest: ReadRest, guildIds: Iterable<string>, knownNames?: ReadonlyMap<string, string>): Promise<GuildSummary[]>;
+//#endregion
 //#region src/commands/isCommandClass.d.ts
 /** @internal */
 type CommandCtor = Constructor<BuilderComponent<'command' | 'context_menu'>, never[]>;
@@ -110,18 +268,18 @@ export declare function isCommandClass(value: unknown): value is CommandCtor;
 export declare function slashRouteLeaves(commands: Iterable<SlashCommandBuilder | ContextMenuCommandBuilder>): Set<string>;
 //#endregion
 //#region src/hmr/devChannel.d.ts
+type CliChannel = DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents>;
 /** @internal */
-export declare function setDevChannel(next: DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined): void;
+export declare function setDevChannel(next: CliChannel | undefined): void;
 /** @internal */
-export declare function getDevChannel(): DevChannel<SeedcordFrameworkEvents, SeedcordCliEvents> | undefined;
+export declare function getDevChannel(): CliChannel | undefined;
 //#endregion
 //#region src/hmr/HmrManager.d.ts
+export declare function connectDevChannel(): CliChannel | undefined;
 export declare class HmrManager {
   private readonly logger;
   private readonly listeners;
-  /** @internal */
-  init(): void;
-  /** @internal */
+  init(channel: CliChannel | undefined): void;
   register(listener: HmrAware): void;
   private handleUpdate;
 }
@@ -130,10 +288,19 @@ export declare class HmrManager {
 interface RawHot {
   send(event: string, data?: unknown): void;
   on(event: string, cb: (data: unknown) => void): void;
+  off(event: string, cb: (data: unknown) => void): void;
 }
 /** @internal */
 export declare function wrapHot<TSend, TRecv>(hot: RawHot): DevChannel<TSend, TRecv>;
 //#endregion
+//#region src/hmr/wire.d.ts
+export declare function toWireError(thrown: unknown): WireError;
+export declare function fromWireError({ name, message, stack, code, cause, errors }: WireError): Error;
+export declare function fromDevLogLine(line: string): LogRecord | undefined;
+//#endregion
+//#region src/hmr/forwardLogsToCli.d.ts
+export declare function forwardLogsToCli(): void;
+//#endregion
 //#region src/notices/index.d.ts
 export declare abstract class GateNotice extends Notice {
   render(): ReplyResponse;
@@ -178,10 +345,6 @@ export declare class HasDangerousPermissions extends Notice {
   render(): ReplyResponse;
 }
 //#endregion
-//#region src/stops/asError.d.ts
-/** @internal */
-export declare function asError(caught: unknown): Error;
-//#endregion
 //#region src/stops/NoticeCard.d.ts
 export declare class NoticeCard extends BuilderComponent<'container'> {
   constructor(description: string, title?: string);
@@ -347,5 +510,5 @@ export declare function eventResultFor(stopped: {
  */
 export declare function runAfter<Result>(ran: readonly Afterable<Result>[], result: Result, logger: Logger): Promise<void>;
 //#endregion
-export { type AckState, AckTrace, type AutocompletableNames, AutocompleteRouteBrand, type CacheFor, type ChoiceValueOf, type CommandBuilder, type CommandCtor, type CommandMeta, CommandMetadataKey, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, type ContextMenuLeaves, ContextMenuNamesBrand, type DecodedComponentRoute, type DefaultSubscriptions, type DeployResult, type EntryFor, EventMetadataKey, EventMiddlewareMetadataKey, type FocusedField, type GateFitsWith, type GateObserver, GatedMetadataKey, type HasComponentDefs, type Initializeable, InteractionMetadataKey, type InteractionMiddlewareMetadata, InteractionMiddlewareMetadataKey, InteractionRouteKeys, type MatchArms, type MenuCacheFor, MiddlewareKindsBrand, type MiddlewareRegistration, type MiddlewareRegistrationOf, type NamesFor, type OptionKind, type OptionLens, PAGE_MAX, type PageCursor, PermissionNames, type PluginArgs, type PluginCtor, PublishDefault, RegisterDefaults, RegisterSubscriber, RegisteredCount, type ReplyMethod, type ReplyTelemetry, type RoutableConstructor, type RouteCache, type SerializedReply, type SingleParams, type SlashOption, type SlashOptions, SlashRouteBrand, type SlashRouteEntry, type SlowGateMonitor, type StoredSubscriberCtor, SubscribeMetadataKey, type SubscriberRegistration, UnregisterSubscriber, VerifyWebhooks, WebhookUrlMetadataKey, busLoggerOf, checkAckLegality, contextMenuLeaves, interactionMiddlewareMetaOf, pageCursor, pickNotice, registrationFor, reportedWrite, sendTarget, serializeReply };
+export { type AckState, AckTrace, type AutocompletableNames, AutocompleteRouteBrand, type BakedIds, type CacheFor, type ChoiceValueOf, type CommandBody, type CommandBuilder, type CommandCtor, type CommandMeta, CommandMetadataKey, type CommandRef, type CommandScopes, ComponentDefsBrand, ComponentKindBrand, ContextMenuKindBrand, type ContextMenuLeaves, ContextMenuNamesBrand, CoordinatedStartup, type DecodedComponentRoute, type DefaultSubscriptions, type DeployResult, type EntryFor, EventMetadataKey, EventMiddlewareMetadataKey, FixedScope, type FocusedField, GLOBAL_ID, type GateFitsWith, type GateObserver, GatedMetadataKey, type GuildSummary, type HasComponentDefs, type Initializeable, InteractionMetadataKey, type InteractionMiddlewareMetadata, InteractionMiddlewareMetadataKey, InteractionRouteKeys, type LinkedCommands, type MatchArms, type MenuCacheFor, MiddlewareKindsBrand, type MiddlewareRegistration, type MiddlewareRegistrationOf, type NamesFor, type OptionKind, type OptionLens, PAGE_MAX, type PageCursor, PermissionNames, type PluginArgs, type PluginCtor, PublishDefault, RegisterDefaults, RegisterSubscriber, RegisteredCount, type ReplyMethod, type ReplyTelemetry, type RoutableConstructor, type RouteCache, type ScopeId, type SerializedReply, type SingleParams, type SlashOption, type SlashOptions, SlashRouteBrand, type SlashRouteEntry, type SlowGateMonitor, type StoredSubscriberCtor, SubscribeMetadataKey, type SubscriberRegistration, UnregisterSubscriber, VerifyWebhooks, WebhookUrlMetadataKey, attachmentsOf, busLoggerOf, checkAckLegality, commandKey, commandRefOf, commandsRoute, globalFirst, indexById, installLinks, interactionMiddlewareMetaOf, linkCommands, pageCursor, pickNotice, registrationFor, reportedWrite, resolveDeployTarget, scopeIdsOf, sealAttachments, sendTarget, serializeReply, skippedNote, warnLinks };
 //# sourceMappingURL=internal.index.d.mts.map