@seedcord/core 0.12.0-next.0 → 0.12.0-next.3

package/dist/{phases-Dojnr-ng.d.mts → phases-C2QCSqRu.d.mts}

@@ -34,7 +34,7 @@ import { Constructor, Jsonify, Simplify } from "type-fest";
  *         super(`balance ${balance} is below the cost`);
  *     }
  *
- *     render(_ctx: RenderContext): ReplyResponse {
+ *     override render(_ctx: RenderContext): ReplyResponse {
  *         return { components: [new TooPoorCard(this.balance).component] };
  *     }
  * }
@@ -59,7 +59,7 @@ declare abstract class Notice extends Error {
    */
   ephemeral: boolean;
   /**
-   * A short one-line reason. When every arm of an {@link or} gate refuses and each one sets this, `or`
+   * A short one-line reason. When every gate in an {@link or} refuses and each one sets this, `or`
    * throws a refusal listing them under `You need to meet at least one of these:`. Write a verb phrase that
    * finishes that line, for example, "be the bot owner".
    */
@@ -67,10 +67,27 @@ declare abstract class Notice extends Error {
   protected constructor(message: string, options?: ErrorOptions);
   /**
    * Builds what the user sees. Called fresh each time the denial is shown, so the builders are new
-   * and the bot color resolves at render time.
+   * and the bot color resolves at render time. By default it returns seedcord's refusal card with the message as
+   * its text. Override it to show your own components.
    */
-  abstract render(ctx: RenderContext): ReplyResponse;
+  render(_ctx: RenderContext): ReplyResponse;
 }
+/**
+ * A Notice class that seedcord constructs and throws in place of a default refusal. It passes the data that
+ * refusal carries, like the retry time for `Cooldown` or the subject and permission names for a permission check.
+ *
+ * @example
+ * ```ts
+ * class OwnersOnly extends Notice {
+ *     public constructor() {
+ *         super('Owners only.');
+ *     }
+ * }
+ *
+ * OwnerOnly({ notice: OwnersOnly });
+ * ```
+ */
+type NoticeConstructor<Args extends unknown[] = []> = Constructor<Notice, Args>;
 //#endregion
 //#region src/metadataKeys.d.ts
 /**
@@ -104,16 +121,42 @@ declare const WebhookUrlMetadataKey: unique symbol;
 declare const InteractionRouteKeys: Record<InteractionKind, symbol>;
 //#endregion
 //#region src/dispatch/DispatchContext.d.ts
-/** State shared by middleware and handlers during one dispatch. */
-declare class DispatchContext implements DispatchBag {
+type DispatchKind = `${InteractionKind}` | 'event';
+type InteractionDispatch = DispatchContext<InteractionKind>;
+/**
+ * State shared by middleware, gates, and handlers during one dispatch.
+ *
+ * @typeParam Kind - What started this dispatch, an interaction kind or `event`.
+ */
+declare class DispatchContext<Kind extends DispatchKind = DispatchKind> implements DispatchBag {
+  /** What started this dispatch, an interaction kind or `event`. */
+  readonly kind: Kind;
+  /**
+   * The slash path, context menu name, custom-ID prefix, or event name that started this dispatch.
+   * For a custom ID that seedcord didn't make, it can be empty or a cut-off piece of that ID.
+   */
+  readonly route: string;
+  /** True when this route doesn't have a registered handler. */
+  readonly fallback: boolean;
   private readonly state;
   readonly id: `${string}-${string}-${string}-${string}-${string}`;
+  constructor(
+  /** What started this dispatch, an interaction kind or `event`. */
+  kind: Kind,
+  /**
+   * The slash path, context menu name, custom-ID prefix, or event name that started this dispatch.
+   * For a custom ID that seedcord didn't make, it can be empty or a cut-off piece of that ID.
+   */
+  route: string,
+  /** True when this route doesn't have a registered handler. */
+  fallback?: boolean);
   /**
    * The dispatch identifier, such as `slash:search/docs`, `button:approve`, or `event:messageCreate`.
    * Component identifiers contain the custom-ID prefix without encoded params.
    */
-  readonly routeId: string;
-  constructor(routeId: string);
+  get routeId(): string;
+  /** The {@link routeId} of the handler's own route. It's `null` on an event and on the unhandled default. */
+  get declaredRoute(): string | null;
   set<Key extends keyof DispatchState>(key: Key, value: DispatchState[Key]): void;
   get<Key extends keyof DispatchState>(key: Key): DispatchState[Key] | undefined;
   /**
@@ -198,7 +241,7 @@ type ConfiguredDriver = NonNullable<Config['kv']>;
 type JsonSafe<TValue> = TValue extends string | number | boolean | null | undefined ? TValue : TValue extends {
   toJSON(): unknown;
 } ? TValue : TValue extends ((...args: never[]) => unknown) ? never : TValue extends ReadonlyMap<unknown, unknown> | ReadonlySet<unknown> ? never : TValue extends readonly (infer Item)[] ? readonly JsonSafe<Item>[] : TValue extends object ? { [K in keyof TValue]: JsonSafe<TValue[K]>; } : never;
-type CollectionName<TRecord> = unknown extends TRecord ? 'Pass the record type, like kv.collection<Profile>(name).' : [TRecord] extends [JsonSafe<TRecord>] ? string : 'This record type holds a value JSON cannot keep, like a function, Map, Set, or bigint.';
+type CollectionName<TRecord> = unknown extends TRecord ? 'Pass the record type, like kv.collection<Profile>(name).' : [TRecord] extends [JsonSafe<TRecord>] ? string : 'This record type holds a value that JSON cannot keep, like a function, Map, Set, or bigint.';
 /**
  * The bot's key-value store, or one prefixed slice of it. `core.kv` holds your handlers' records. A
  * plugin's `this.kv` holds the plugin's.
@@ -292,7 +335,7 @@ interface EventFaultSource {
   readonly raw: unknown;
 }
 /**
- * The fields both `responseAttempted` arms carry.
+ * The fields both `responseAttempted` shapes carry.
  */
 interface AttemptedWrite {
   /** The dispatch this write belongs to, for joining against every other key it published. */
@@ -436,42 +479,11 @@ type PublishableKey = TypedExclude<SubscriptionKey, keyof DefaultSubscriptions>;
 type SubscriptionData<KeyOfSubscribers extends SubscriptionKey> = AllSubscriptions[KeyOfSubscribers];
 type SubscriptionTuples = { [K in SubscriptionKey]: [AllSubscriptions[K]]; };
 //#endregion
-//#region src/subscribers/Subscriber.d.ts
-/**
- * Abstract base class for handling application subscribers.
- *
- * Provides type-safe access to subscribers data and the core framework instance.
- * Extend this class to create custom subscriber handlers.
- *
- * @typeParam KeyOfSubscribers - The specific subscriber type this handler processes
- * @typeParam TCore - The transport's Core
- */
-declare abstract class Subscriber<KeyOfSubscribers extends SubscriptionKey, TCore extends CoreBase> {
-  protected readonly data: AllSubscriptions[KeyOfSubscribers];
-  protected readonly core: TCore;
-  protected readonly logger: Logger;
-  /**
-   * Instantiates the subscriber with event data and core.
-   *
-   * @param data - The subscriber event data
-   * @param core - The core framework instance
-   */
-  constructor(data: AllSubscriptions[KeyOfSubscribers], core: TCore);
-  /**
-   * Executes the subscriber handler logic.
-   */
-  abstract execute(): Promise<void>;
-}
-//#endregion
 //#region src/subscribers/Bus.d.ts
 /** @internal */
-type StoredSubscriberCtor = Constructor<Subscriber<SubscriptionKey, CoreBase>, never[]>;
-/** @internal */
-interface SubscriberRegistration {
-  readonly keys: readonly SubscriptionKey[];
-  readonly frequency: EventFrequency;
-  readonly ctor: StoredSubscriberCtor;
-}
+type StoredSubscriberCtor = Constructor<{
+  execute(): Promise<void>;
+}, never[]>;
 declare const loggerSlot: unique symbol;
 /**
  * Registers and dispatches subscribers. Subscribers run on a programmatic or framework publish.
@@ -489,12 +501,12 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   /** @internal keep this inside start(). a bad webhook url thrown outside it never resets the singleton guard */
   [RegisterDefaults](): void;
   /** @internal */
-  [RegisterSubscriber](registration: SubscriberRegistration): void;
+  [RegisterSubscriber](ctor: StoredSubscriberCtor): void;
   /** @internal */
   [UnregisterSubscriber](ctor: StoredSubscriberCtor, keys?: readonly SubscriptionKey[]): void;
   /** @internal */
   get [RegisteredCount](): number;
-  /** @internal registration already dropped every reporter with no url set */
+  /** @internal registration already skipped every reporter with no url set */
   [VerifyWebhooks](): Promise<void>;
   private probeWebhook;
   /**
@@ -527,8 +539,6 @@ declare class Bus extends TypedEventEmitter<SubscriptionTuples> {
   private runSubscriber;
 }
 /** @internal */
-declare function registrationFor(ctor: StoredSubscriberCtor): SubscriberRegistration;
-/** @internal */
 declare function busLoggerOf(bus: Bus): Logger;
 //#endregion
 //#region src/interfaces/CoreBase.d.ts
@@ -587,5 +597,5 @@ declare enum ShutdownPhase {
 }
 type TaskShutdownPhase = Exclude<ShutdownPhase, ShutdownPhase.Release>;
 //#endregion
-export { RegisterSubscriber as A, EventMiddlewareMetadataKey as B, reportedWrite as C, sendTarget as D, checkAckLegality as E, Kv as F, InteractionRouteKeys as G, InteractionKind as H, KvCollection as I, WebhookUrlMetadataKey as J, MiddlewareKind as K, DispatchContext as L, UnregisterSubscriber as M, VerifyWebhooks as N, AckTrace as O, PublishDefault as P, CommandMetadataKey as R, ReplyTelemetry as S, ReplyMethod as T, InteractionMetadataKey as U, GatedMetadataKey as V, InteractionMiddlewareMetadataKey as W, Notice as Y, ResponseOutcome as _, Bus as a, SubscriptionKey as b, busLoggerOf as c, AttemptedWrite as d, DefaultSubscriptions as f, ResponseFailed as g, ResponseAttempt as h, CoreBase as i, RegisteredCount as j, RegisterDefaults as k, registrationFor as l, FaultSource as m, StartupPhase as n, StoredSubscriberCtor as o, DispatchOutcome as p, SubscribeMetadataKey as q, TaskShutdownPhase as r, SubscriberRegistration as s, ShutdownPhase as t, Subscriber as u, ResponseSent as v, AckState as w, Subscriptions as x, SubscriptionData as y, EventMetadataKey as z };
-//# sourceMappingURL=phases-Dojnr-ng.d.mts.map
+export { RegisteredCount as A, EventMiddlewareMetadataKey as B, AckState as C, AckTrace as D, sendTarget as E, KvCollection as F, InteractionRouteKeys as G, InteractionKind as H, DispatchContext as I, WebhookUrlMetadataKey as J, MiddlewareKind as K, InteractionDispatch as L, VerifyWebhooks as M, PublishDefault as N, RegisterDefaults as O, Kv as P, CommandMetadataKey as R, reportedWrite as S, checkAckLegality as T, InteractionMetadataKey as U, GatedMetadataKey as V, InteractionMiddlewareMetadataKey as W, NoticeConstructor as X, Notice as Y, ResponseSent as _, Bus as a, Subscriptions as b, AllSubscriptions as c, DispatchOutcome as d, FaultSource as f, ResponseOutcome as g, ResponseFailed as h, CoreBase as i, UnregisterSubscriber as j, RegisterSubscriber as k, AttemptedWrite as l, ResponseAttempt as m, StartupPhase as n, StoredSubscriberCtor as o, InteractionFaultSource as p, SubscribeMetadataKey as q, TaskShutdownPhase as r, busLoggerOf as s, ShutdownPhase as t, DefaultSubscriptions as u, SubscriptionData as v, ReplyMethod as w, ReplyTelemetry as x, SubscriptionKey as y, EventMetadataKey as z };
+//# sourceMappingURL=phases-C2QCSqRu.d.mts.map

package/dist/plugin.index.d.mts

@@ -1,4 +1,4 @@
 import { n as PluginTypes, t as Generated } from "./Generated-ByC53_A2.mjs";
-import { n as PluginHost, p as PluginLifecycleSpec, s as Plugin, u as PluginOptions } from "./PluginHost-DWBgBS6Q.mjs";
+import { n as PluginHost, p as PluginLifecycleSpec, s as Plugin, u as PluginOptions } from "./PluginHost-DFnkIldj.mjs";
 import { HmrAware, HmrUpdateEvent } from "@seedcord/types";
 export { type Generated, type HmrAware, type HmrUpdateEvent, Plugin, PluginHost, type PluginLifecycleSpec, type PluginOptions, type PluginTypes };

package/dist/plugin.index.mjs

@@ -1,3 +1,3 @@
-import { o as Plugin, t as PluginHost } from "./PluginHost-CYe-UVpp.mjs";
+import { s as Plugin, t as PluginHost } from "./PluginHost-DTtxWRiL.mjs";
 
 export { Plugin, PluginHost };