@seedcord/core 0.1.0-next.0 → 0.1.0-next.2

package/dist/internal.index.d.mts

@@ -1 +1,102 @@
-export { };
+import { C as BuilderComponent, a as CustomIdField, c as pickNotice, g as GateContextBase, h as Gate, i as prefixOf, l as GateFitsWith, n as CustomId, o as DecodedParams, p as Notice, r as decodeFor, t as AnyCustomId, x as CommandMeta } from "./CustomId-Ddwg48VY.mjs";
+import { BotColor, EpochMs, ReplyResponse } from "@seedcord/types";
+
+//#region src/components/botColorHolder.d.ts
+declare function setBotColor(color: BotColor | undefined): void;
+//#endregion
+//#region src/gates/runGates.d.ts
+/**
+ * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect
+ * gate's commit runs once the whole set passes.
+ */
+declare function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void>;
+declare function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void>;
+//#endregion
+//#region src/notices/index.d.ts
+declare abstract class GateNotice extends Notice {
+  render(): ReplyResponse;
+}
+declare class NotOwner extends GateNotice {
+  constructor(message?: string);
+}
+declare class NotInGuild extends GateNotice {
+  constructor(message?: string);
+}
+declare class NotInDm extends GateNotice {
+  constructor(message?: string);
+}
+declare class OnCooldown extends GateNotice {
+  readonly resetAt: EpochMs;
+  constructor(resetAt: EpochMs, message?: string);
+}
+declare class NotAllowed extends Notice {
+  constructor();
+  render(): ReplyResponse;
+}
+declare class NeedsAny extends Notice {
+  private readonly summaries;
+  constructor(summaries: readonly string[]);
+  render(): ReplyResponse;
+}
+//#endregion
+//#region src/metadataKeys.d.ts
+declare enum InteractionRoutes {
+  Slash = "slash",
+  Button = "button",
+  Modal = "modal",
+  StringMenu = "stringMenu",
+  UserMenu = "userMenu",
+  RoleMenu = "roleMenu",
+  ChannelMenu = "channelMenu",
+  MentionableMenu = "mentionableMenu",
+  MessageContextMenu = "messageContextMenu",
+  UserContextMenu = "userContextMenu",
+  Autocomplete = "autocomplete"
+}
+declare const InteractionMetadataKey: unique symbol;
+declare const InteractionRouteKeys: Record<InteractionRoutes, symbol>;
+declare const MiddlewareMetadataKey: unique symbol;
+declare const EventMetadataKey: unique symbol;
+declare const CommandMetadataKey: unique symbol;
+declare const GatedMetadataKey: unique symbol;
+declare const SubscribeMetadataKey: unique symbol;
+//#endregion
+//#region src/stops/NoticeCard.d.ts
+/**
+ * Built fresh inside a {@link Notice}'s `render` to back its ComponentsV2 reply. The title renders as
+ * an h3 line with the description on the next line.
+ */
+declare class NoticeCard extends BuilderComponent<'container'> {
+  constructor(description: string, title?: string);
+}
+//#endregion
+//#region src/customId/routing.d.ts
+/**
+ * The route decorators store a handler's customId definitions here so the component base can decode
+ * against them at runtime.
+ *
+ * @internal
+ */
+declare const ComponentDefsKey: unique symbol;
+/**
+ * The phantom a component handler base carries. A route decorator constrains its argument to this, so
+ * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.
+ *
+ * @internal
+ */
+interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {
+  readonly __componentDefs?: Defs;
+}
+//#endregion
+//#region src/pagination/cursor.d.ts
+declare const PAGE_MAX = 1000000;
+/** Page cursor for a paginator. */
+type PageCursor<Prefix extends string> = CustomId<Prefix, {
+  page: CustomIdField<number>;
+  slot: CustomIdField<number>;
+}>;
+/** Build the page cursor for a paginator. */
+declare function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix>;
+//#endregion
+export { type AnyCustomId, type CommandMeta, CommandMetadataKey, ComponentDefsKey, type DecodedParams, EventMetadataKey, type GateFitsWith, GateNotice, GatedMetadataKey, type HasComponentDefs, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, type PageCursor, SubscribeMetadataKey, decodeFor, pageCursor, pickNotice, prefixOf, runGates, runHandlerGates, setBotColor };
+//# sourceMappingURL=internal.index.d.mts.map

package/dist/internal.index.mjs

@@ -1 +1,43 @@
-export {  };
+import { C as EventMetadataKey, D as InteractionRoutes, E as InteractionRouteKeys, O as MiddlewareMetadataKey, S as CommandMetadataKey, T as InteractionMetadataKey, _ as NoticeCard, a as discardCommits, b as setBotColor, c as runCheck, d as NeedsAny, f as NotAllowed, g as OnCooldown, h as NotOwner, i as pickNotice, k as SubscribeMetadataKey, l as runCommits, m as NotInGuild, n as decodeFor, p as NotInDm, r as prefixOf, t as CustomId, u as GateNotice, w as GatedMetadataKey } from "./CustomId-Bq6WagiA.mjs";
+
+//#region src/gates/runGates.ts
+/**
+* Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect
+* gate's commit runs once the whole set passes.
+*/
+async function runGates(gates, ctx) {
+	try {
+		for (const gate of gates) await runCheck(gate, ctx);
+		await runCommits(ctx);
+	} finally {
+		discardCommits(ctx);
+	}
+}
+async function runHandlerGates(handlerCtor, ctx) {
+	const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor);
+	if (!gates) return;
+	await runGates(gates, ctx);
+}
+
+//#endregion
+//#region src/customId/routing.ts
+/**
+* The route decorators store a handler's customId definitions here so the component base can decode
+* against them at runtime.
+*
+* @internal
+*/
+const ComponentDefsKey = Symbol("seedcord:customId:componentDefs");
+
+//#endregion
+//#region src/pagination/cursor.ts
+const PAGE_MAX = 1e6;
+const SLOT_MAX = 4;
+/** Build the page cursor for a paginator. */
+function pageCursor(prefix) {
+	return new CustomId(prefix).int("page", 0, PAGE_MAX).int("slot", 0, SLOT_MAX);
+}
+
+//#endregion
+export { CommandMetadataKey, ComponentDefsKey, EventMetadataKey, GateNotice, GatedMetadataKey, InteractionMetadataKey, InteractionRouteKeys, InteractionRoutes, MiddlewareMetadataKey, NeedsAny, NotAllowed, NotInDm, NotInGuild, NotOwner, NoticeCard, OnCooldown, PAGE_MAX, SubscribeMetadataKey, decodeFor, pageCursor, pickNotice, prefixOf, runGates, runHandlerGates, setBotColor };
+//# sourceMappingURL=internal.index.mjs.map

package/dist/internal.index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.index.mjs","names":[],"sources":["../src/gates/runGates.ts","../src/customId/routing.ts","../src/pagination/cursor.ts"],"sourcesContent":["import { GatedMetadataKey } from '@src/metadataKeys';\n\nimport { discardCommits, runCheck, runCommits } from './effects';\n\nimport type { Gate, GateContextBase } from './Gate';\n\n/**\n * Runs each gate's check in order, so the first refusal propagates to the dispatcher boundary. An effect\n * gate's commit runs once the whole set passes.\n */\nexport async function runGates(gates: readonly Gate<GateContextBase>[], ctx: GateContextBase): Promise<void> {\n    try {\n        for (const gate of gates) {\n            await runCheck(gate, ctx);\n        }\n        await runCommits(ctx);\n    } finally {\n        discardCommits(ctx);\n    }\n}\n\n// dispatchers call this before execute, inside the boundary, so a refusal renders or drops\nexport async function runHandlerGates(handlerCtor: object, ctx: GateContextBase): Promise<void> {\n    // justified: getMetadata returns any, and this key only ever stores the @Gated gate array\n    const gates = Reflect.getMetadata(GatedMetadataKey, handlerCtor) as readonly Gate<GateContextBase>[] | undefined;\n    if (!gates) return;\n    await runGates(gates, ctx);\n}\n","import type { AnyCustomId } from './CustomId';\n\n/**\n * The route decorators store a handler's customId definitions here so the component base can decode\n * against them at runtime.\n *\n * @internal\n */\nexport const ComponentDefsKey = Symbol('seedcord:customId:componentDefs');\n\n/**\n * The phantom a component handler base carries. A route decorator constrains its argument to this, so\n * passing different definitions to the decorator and the handler's generic is a compile error. Never set at runtime.\n *\n * @internal\n */\nexport interface HasComponentDefs<Defs extends readonly AnyCustomId[]> {\n    readonly __componentDefs?: Defs;\n}\n","import { CustomId } from '@customId/CustomId';\n\nimport type { CustomIdField } from '@customId/Field';\n\n// Included in the layout hash so it is fixed per prefix. Reducing it marks every active button as StaleCustomId.\n// @internal\nexport const PAGE_MAX = 1_000_000;\n\n// Discord rejects a message with duplicate custom_ids, and two controls can target the same page (first and\n// prev both hit 0), so each control uses a distinct slot.\n// @internal\nconst SLOT_MAX = 4;\n\n/** Page cursor for a paginator. */\nexport type PageCursor<Prefix extends string> = CustomId<\n    Prefix,\n    { page: CustomIdField<number>; slot: CustomIdField<number> }\n>;\n\n/** Build the page cursor for a paginator. */\nexport function pageCursor<Prefix extends string>(prefix: Prefix): PageCursor<Prefix> {\n    return new CustomId(prefix).int('page', 0, PAGE_MAX).int('slot', 0, SLOT_MAX);\n}\n"],"mappings":";;;;;;;AAUA,eAAsB,SAAS,OAAyC,KAAqC;CACzG,IAAI;EACA,KAAK,MAAM,QAAQ,OACf,MAAM,SAAS,MAAM,GAAG;EAE5B,MAAM,WAAW,GAAG;CACxB,UAAU;EACN,eAAe,GAAG;CACtB;AACJ;AAGA,eAAsB,gBAAgB,aAAqB,KAAqC;CAE5F,MAAM,QAAQ,QAAQ,YAAY,kBAAkB,WAAW;CAC/D,IAAI,CAAC,OAAO;CACZ,MAAM,SAAS,OAAO,GAAG;AAC7B;;;;;;;;;;ACnBA,MAAa,mBAAmB,OAAO,iCAAiC;;;;ACFxE,MAAa,WAAW;AAKxB,MAAM,WAAW;;AASjB,SAAgB,WAAkC,QAAoC;CAClF,OAAO,IAAI,SAAS,MAAM,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,GAAG,QAAQ;AAChF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@seedcord/core",
   "type": "module",
-  "version": "0.1.0-next.0",
+  "version": "0.1.0-next.2",
   "description": "Transport-agnostic core for Seedcord bots",
   "repository": {
     "type": "git",
@@ -38,10 +38,21 @@
     "LICENSE"
   ],
   "peerDependencies": {
+    "reflect-metadata": "^0.2.2",
     "typescript": "^6.0.3"
   },
+  "dependencies": {
+    "@discordjs/builders": "^1.14.1",
+    "discord-api-types": "^0.38.49",
+    "@seedcord/errors": "0.3.0-next.2",
+    "@seedcord/types": "0.8.0-next.3",
+    "@seedcord/utils": "0.8.0-next.3"
+  },
   "devDependencies": {
-    "@seedcord/eslint-config": "1.5.0-next.0",
+    "reflect-metadata": "^0.2.2",
+    "type-fest": "^5.7.0",
+    "@seedcord/eslint-config": "1.5.0-next.2",
+    "@seedcord/rate-limiter": "0.1.0-next.0",
     "@seedcord/tsconfig": "2.0.1",
     "@seedcord/tsdown-config": "2.0.1"
   },