@seedcord/http 0.1.0-next.1 → 0.1.0-next.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -1,8 +1,9 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
2
- const require_edge_index = require('./edge.index-D-60VfMn.cjs');
2
+ const require_edge_index = require('./edge.index-Bd6sbr37.cjs');
3
3
  let _seedcord_errors_internal = require("@seedcord/errors/internal");
4
4
  let envapt = require("envapt");
5
5
  let _discordjs_rest = require("@discordjs/rest");
6
+ let _seedcord_core = require("@seedcord/core");
6
7
  let _seedcord_core_internal = require("@seedcord/core/internal");
7
8
  let _seedcord_logger = require("@seedcord/logger");
8
9
  let _seedcord_rate_limiter = require("@seedcord/rate-limiter");
@@ -16,14 +17,18 @@ let _seedcord_types_internal = require("@seedcord/types/internal");
16
17
  let _seedcord_core_hmr = require("@seedcord/core/hmr");
17
18
  let _seedcord_utils = require("@seedcord/utils");
18
19
  let _seedcord_utils_node = require("@seedcord/utils/node");
20
+ let chalk = require("chalk");
21
+ chalk = require_edge_index.__toESM(chalk, 1);
22
+ let _seedcord_core_plugin = require("@seedcord/core/plugin");
19
23
 
20
24
  //#region src/manifest/RouteManifest.ts
21
25
  /** @internal */
22
26
  const EMPTY_MANIFEST = {
23
- commands: [],
24
- components: [],
25
- autocomplete: [],
26
- subscribers: []
27
+ commandRoutes: [],
28
+ componentRoutes: [],
29
+ autocompleteRoutes: [],
30
+ subscriberRoutes: [],
31
+ middlewareRoutes: []
27
32
  };
28
33
 
29
34
  //#endregion
@@ -39,7 +44,7 @@ var InteractionDispatcher = class {
39
44
  maps;
40
45
  targets;
41
46
  /** @internal */
42
- logger = new _seedcord_logger.Logger("Interactions");
47
+ logger = new _seedcord_logger.Logger("Interactions", { channel: "interactions" });
43
48
  isInitialized = false;
44
49
  hmrHandler;
45
50
  rowOwners = /* @__PURE__ */ new Map();
@@ -72,7 +77,7 @@ var InteractionDispatcher = class {
72
77
  this.registerHandler(value, relativePath);
73
78
  this.hmrHandler?.trackHandler(fullPath, value);
74
79
  }
75
- }, this.logger);
80
+ });
76
81
  } finally {
77
82
  this.loading = false;
78
83
  }
@@ -82,6 +87,19 @@ var InteractionDispatcher = class {
82
87
  async onHmr(event) {
83
88
  await this.hmrHandler?.handle(event);
84
89
  }
90
+ warnUnhandledRoutes(commandLeaves) {
91
+ this.warnMissing(commandLeaves, this.maps.slash, "Slash route", "@SlashRoute");
92
+ }
93
+ warnUnhandledContextMenuRoutes(leaves) {
94
+ this.warnMissing(leaves.user, this.maps.userContextMenu, "User context menu", "@ContextMenuRoute");
95
+ this.warnMissing(leaves.message, this.maps.messageContextMenu, "Message context menu", "@ContextMenuRoute");
96
+ }
97
+ warnMissing(names, map, label, decorator) {
98
+ for (const name of names) {
99
+ if (map.has(name)) continue;
100
+ this.logger.warn(`${label} ${_seedcord_logger.paint.sky.bold(name)} has no registered ${chalk.default.bold(decorator)} handler.`);
101
+ }
102
+ }
85
103
  isHandler(value) {
86
104
  if (typeof value !== "function") return false;
87
105
  return (value.prototype instanceof require_edge_index.InteractionHandler || value.prototype instanceof require_edge_index.AutocompleteHandler) && Reflect.hasMetadata(_seedcord_core_internal.InteractionMetadataKey, value);
@@ -143,15 +161,17 @@ var InteractionDispatcher = class {
143
161
  };
144
162
  }
145
163
  registerHandler(ctor, relativePath) {
164
+ const from = (0, _seedcord_utils.formatFilePath)(relativePath);
146
165
  const writes = [];
147
166
  for (const [route, keys] of (0, _seedcord_core_internal.interactionRoutesOf)(ctor)) {
148
167
  const target = this.targetFor(route);
149
168
  for (const key of keys) {
150
- const existing = this.rowOwners.get(`${target.kind}:${key}`);
169
+ const routeId = `${target.kind}:${key}`;
170
+ const existing = this.rowOwners.get(routeId);
151
171
  if (existing && existing.ctor !== ctor) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.InteractionDuplicateRoute, [
152
- key,
153
- existing.ctor.name,
154
- ctor.name
172
+ routeId,
173
+ `${existing.ctor.name} (${existing.from})`,
174
+ `${ctor.name} (${from})`
155
175
  ]);
156
176
  writes.push([target, key]);
157
177
  }
@@ -162,15 +182,15 @@ var InteractionDispatcher = class {
162
182
  target.map.set(key, {
163
183
  kind: target.kind,
164
184
  routeId,
165
- load: () => Promise.resolve({ [ctor.name]: ctor })
185
+ load: () => Promise.resolve(ctor)
166
186
  });
167
187
  this.rowOwners.set(routeId, {
168
188
  ctor,
169
189
  target,
170
- key
190
+ key,
191
+ from
171
192
  });
172
193
  }
173
- const from = (0, _seedcord_utils.formatFilePath)(relativePath);
174
194
  if (this.loading) this.loadedHandlers.push({
175
195
  name: ctor.name,
176
196
  from
@@ -242,31 +262,45 @@ var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
242
262
  rest = new _discordjs_rest.REST();
243
263
  /** @see {@link IRateLimiter} */
244
264
  rateLimiter;
245
- /** @see {@link CoordinatedShutdown} */
246
- shutdown;
247
- /** @see {@link CoordinatedStartup} */
248
- startup;
265
+ /** @see {@link Bus} */
266
+ bus;
267
+ subscribers;
249
268
  interactions;
269
+ commandRegistry;
270
+ appId;
271
+ appIdPromise;
272
+ emojiInjector = new require_edge_index.EmojiInjector(this, () => this.applicationId());
250
273
  healthCheck;
251
274
  hmrManager;
252
- logger = new _seedcord_logger.Logger("Server");
275
+ logger = new _seedcord_logger.Logger("Server", { channel: "bot" });
253
276
  server;
254
277
  boundPort;
255
278
  requestedPort = DEFAULT_PORT;
256
279
  fetchedUsername;
257
280
  constructor(config) {
258
- const shutdown = new _seedcord_core_node_internal.CoordinatedShutdown();
259
- const startup = new _seedcord_core_node_internal.CoordinatedStartup();
260
- super(shutdown, startup);
281
+ super(new _seedcord_core_node_internal.CoordinatedShutdown(), new _seedcord_core_node_internal.CoordinatedStartup());
261
282
  this.config = config;
262
283
  (0, _seedcord_logger_node.installNodeDefaults)(config.logger);
263
284
  (0, _seedcord_core_internal.setBotColor)(config.botColor);
264
- this.shutdown = shutdown;
265
- this.startup = startup;
266
285
  this.hmrManager = new _seedcord_core_internal.HmrManager();
267
286
  this.hmrManager.init();
268
287
  if (this.config.bot.interactions.path) this.interactions = new InteractionDispatcher(this.config.bot.interactions.path);
288
+ const commandsDir = this.config.bot.commands.path;
289
+ if (commandsDir) {
290
+ const injector = new _seedcord_core_internal.CommandInjector();
291
+ const registry = new _seedcord_core_node_internal.CommandRegistry({
292
+ dir: commandsDir,
293
+ rest: this.rest,
294
+ applicationId: () => this.requireApplicationId(),
295
+ onDeployed: (result) => {
296
+ injector.inject(result, registry.allCommands());
297
+ }
298
+ });
299
+ this.commandRegistry = registry;
300
+ }
269
301
  this.rateLimiter = config.store ?? new _seedcord_rate_limiter.MemoryRateLimiter();
302
+ this.bus = new _seedcord_core.Bus(this);
303
+ this.subscribers = new _seedcord_core_node_internal.SubscriberLoader(this.bus, config.subscribers.path);
270
304
  this.healthCheck = config.runtime === "edge" ? void 0 : _seedcord_core_node_internal.HealthCheck.fromOption(this.shutdown, config.healthCheck);
271
305
  this.registerStartupTasks();
272
306
  }
@@ -278,17 +312,10 @@ var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
278
312
  get port() {
279
313
  return this.boundPort;
280
314
  }
281
- pluginCapabilities() {
282
- const token = envapt.Envapter.get("DISCORD_BOT_TOKEN");
283
- return {
284
- rest: this.rest,
285
- ...token !== void 0 && { token }
286
- };
287
- }
288
315
  /**
289
316
  * Starts the host and runs the startup tasks.
290
317
  *
291
- * @param port - The port the interaction server binds. {@default `3000`}
318
+ * @param port - The port the interaction server binds. {@default `3000` }
292
319
  */
293
320
  async start(port = DEFAULT_PORT) {
294
321
  this.requestedPort = port;
@@ -307,31 +334,60 @@ var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
307
334
  }
308
335
  registerStartupTasks() {
309
336
  if (envapt.Envapter.isDevelopment || envapt.Envapter.isTest) this.registerHmrAwareModules();
337
+ this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "bus-initialization", async () => {
338
+ this.bus.logger.utils.initialization("Subscribers", "start");
339
+ await this.subscribers.init();
340
+ this.bus.logger.utils.initialization("Subscribers", "end");
341
+ });
310
342
  const { interactions } = this;
311
- if (interactions) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "Interactions Initialization", async () => {
343
+ if (interactions) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "interactions-initialization", async () => {
312
344
  interactions.logger.utils.initialization("Interactions", "start");
313
345
  await interactions.init();
314
346
  interactions.logger.utils.initialization("Interactions", "end");
315
347
  });
316
- this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "Http Server", () => this.listen());
317
- if (!envapt.Envapter.isTest) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "Identity", () => this.fetchUsername());
348
+ this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "authenticate", () => {
349
+ this.authenticate();
350
+ return Promise.resolve();
351
+ });
352
+ this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Login, "emoji-injection", () => this.emojiInjector.init());
353
+ const { commandRegistry } = this;
354
+ if (commandRegistry) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Login, "command-deploy", async () => {
355
+ await commandRegistry.init();
356
+ this.appId = await this.applicationId();
357
+ await commandRegistry.setCommands();
358
+ interactions?.warnUnhandledRoutes(commandRegistry.routeLeaves());
359
+ interactions?.warnUnhandledContextMenuRoutes(commandRegistry.contextMenuLeaves());
360
+ });
361
+ this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "http-server", () => this.listen());
362
+ if (!envapt.Envapter.isTest) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "identity", () => this.fetchUsername());
318
363
  const { healthCheck } = this;
319
- if (healthCheck) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "Health Check", async () => {
364
+ if (healthCheck) this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Ready, "health-check", async () => {
320
365
  healthCheck.logger.utils.initialization("HealthCheck", "start");
321
366
  await healthCheck.init();
322
367
  healthCheck.logger.utils.initialization("HealthCheck", "end");
323
368
  });
324
369
  }
325
370
  registerHmrAwareModules() {
326
- this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "HMR Registration", async () => {
371
+ this.startup.addTask(_seedcord_core_node_internal.StartupPhase.Configuration, "hmr-registration", async () => {
327
372
  if (this.interactions) this.hmrManager.register(this.interactions);
373
+ if (this.commandRegistry) this.hmrManager.register(this.commandRegistry);
374
+ this.hmrManager.register(this.subscribers);
328
375
  for (const plugin of this.plugins) this.hmrManager.register(plugin);
329
376
  await Promise.resolve();
330
377
  });
331
378
  }
379
+ authenticate() {
380
+ this.rest.setToken((0, _seedcord_errors_internal.validateDiscordToken)(envapt.Envapter.get("DISCORD_BOT_TOKEN")));
381
+ }
382
+ applicationId() {
383
+ this.appIdPromise ??= require_edge_index.fetchApplicationId(this.rest);
384
+ return this.appIdPromise;
385
+ }
386
+ requireApplicationId() {
387
+ if (!this.appId) throw new _seedcord_errors_internal.SeedcordError(_seedcord_errors.SeedcordErrorCode.CoreApplicationUnavailable);
388
+ return this.appId;
389
+ }
332
390
  async listen() {
333
- const token = (0, _seedcord_errors_internal.validateDiscordToken)(envapt.Envapter.get("DISCORD_BOT_TOKEN"));
334
- this.rest.setToken(token);
335
391
  const maps = this.interactions?.maps ?? require_edge_index.buildRouteMaps(EMPTY_MANIFEST);
336
392
  const { handle, inFlight } = require_edge_index.buildEngine(this, maps);
337
393
  const server = (0, node_http.createServer)((incoming, outgoing) => {
@@ -376,39 +432,64 @@ var Seedcord = class Seedcord extends _seedcord_core_node_internal.Pluggable {
376
432
  }
377
433
  };
378
434
 
435
+ //#endregion
436
+ //#region src/plugin.ts
437
+ /**
438
+ * Base class for an HTTP plugin, binding `this.core` to the HTTP {@link Core}.
439
+ *
440
+ * A plugin that runs on either transport extends the base from `@seedcord/core/plugin`, whose
441
+ * `this.core` is typed to the shared members only.
442
+ *
443
+ * @typeParam Opts - The transport and runtime the plugin declares.
444
+ */
445
+ var Plugin = class extends _seedcord_core_plugin.Plugin {};
446
+
379
447
  //#endregion
380
448
  //#region src/index.ts
381
449
  var src_exports = /* @__PURE__ */ require_edge_index.__exportAll({
450
+ ArraySource: () => require_edge_index.ArraySource,
382
451
  AutocompleteHandler: () => require_edge_index.AutocompleteHandler,
383
452
  ButtonHandler: () => require_edge_index.ButtonHandler,
384
453
  ComponentHandler: () => require_edge_index.ComponentHandler,
385
454
  ContextMenuHandler: () => require_edge_index.ContextMenuHandler,
455
+ CursorSource: () => require_edge_index.CursorSource,
456
+ Emojis: () => require_edge_index.Emojis,
386
457
  Gated: () => require_edge_index.Gated,
387
458
  InteractionHandler: () => require_edge_index.InteractionHandler,
388
459
  ModalHandler: () => require_edge_index.ModalHandler,
460
+ Paginator: () => require_edge_index.Paginator,
461
+ Plugin: () => Plugin,
389
462
  RepliableHandler: () => require_edge_index.RepliableHandler,
390
463
  Seedcord: () => Seedcord,
391
464
  SelectMenuHandler: () => require_edge_index.SelectMenuHandler,
392
465
  SlashHandler: () => require_edge_index.SlashHandler,
466
+ Subscriber: () => require_edge_index.Subscriber,
467
+ WebhookLog: () => require_edge_index.WebhookLog,
393
468
  createSeedcord: () => require_edge_index.createSeedcord,
394
469
  version: () => require_edge_index.version
395
470
  });
396
471
 
397
472
  //#endregion
473
+ exports.ArraySource = require_edge_index.ArraySource;
398
474
  exports.AutocompleteHandler = require_edge_index.AutocompleteHandler;
399
475
  exports.ButtonHandler = require_edge_index.ButtonHandler;
400
476
  exports.ComponentHandler = require_edge_index.ComponentHandler;
401
477
  exports.ContextMenuHandler = require_edge_index.ContextMenuHandler;
478
+ exports.CursorSource = require_edge_index.CursorSource;
479
+ exports.Emojis = require_edge_index.Emojis;
402
480
  exports.Gated = require_edge_index.Gated;
403
481
  exports.InteractionHandler = require_edge_index.InteractionHandler;
404
482
  exports.ModalHandler = require_edge_index.ModalHandler;
483
+ exports.Paginator = require_edge_index.Paginator;
484
+ exports.Plugin = Plugin;
405
485
  exports.RepliableHandler = require_edge_index.RepliableHandler;
406
486
  exports.Seedcord = Seedcord;
407
487
  exports.SelectMenuHandler = require_edge_index.SelectMenuHandler;
408
488
  exports.SlashHandler = require_edge_index.SlashHandler;
489
+ exports.Subscriber = require_edge_index.Subscriber;
490
+ exports.WebhookLog = require_edge_index.WebhookLog;
409
491
  exports.createSeedcord = require_edge_index.createSeedcord;
410
492
  exports.version = require_edge_index.version;
411
- var _seedcord_core = require("@seedcord/core");
412
493
  Object.keys(_seedcord_core).forEach(function (k) {
413
494
  if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
414
495
  enumerable: true,
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["Logger","buildRouteMaps","Envapter","HmrModuleHandler","InteractionHandler","AutocompleteHandler","InteractionMetadataKey","InteractionRoutes","SeedcordError","SeedcordErrorCode","Pluggable","SeedcordBrand","packageVersion","REST","Logger","CoordinatedShutdown","CoordinatedStartup","HmrManager","MemoryRateLimiter","HealthCheck","Envapter","StartupPhase","buildRouteMaps","buildEngine","paint","ShutdownPhase","Routes"],"sources":["../src/manifest/RouteManifest.ts","../src/node/InteractionDispatcher.ts","../src/node/webBridge.ts","../src/node/Seedcord.ts","../src/index.ts"],"sourcesContent":["import type { SelectMenuKind } from '@seedcord/core';\nimport type { ApplicationCommandType } from 'discord-api-types/v10';\n\n/** The command kinds a manifest row registers, the wire enum's other members have no handler base. */\ntype RegistrableCommandType =\n | ApplicationCommandType.ChatInput\n | ApplicationCommandType.User\n | ApplicationCommandType.Message;\n\n/**\n * A slash or context-menu command row. `type` picks the per-kind map, `name` is the lookup key. For a\n * chat-input command with subcommands, `name` is the full route path (`'config/set'`), the same key\n * `@SlashRoute` registers.\n */\ninterface CommandRoute {\n readonly name: string;\n readonly type: RegistrableCommandType;\n /** Lazy import of the handler module, evaluated on first hit. */\n readonly load: () => Promise<unknown>;\n}\n\n/**\n * A button, select, or modal row. `kind` picks the per-kind map, `prefix` is the stable customId prefix\n * the receiver routes by (the routeKey minus its layout hash).\n */\nexport interface ComponentRoute {\n readonly kind: 'button' | `${SelectMenuKind}Select` | 'modal';\n readonly prefix: string;\n /** Lazy import of the handler module, evaluated on first hit. */\n readonly load: () => Promise<unknown>;\n}\n\n/**\n * An autocomplete row, its own route keyed by the command's route path, separate from the slash row.\n */\ninterface AutocompleteRoute {\n readonly name: string;\n /** Lazy import of the handler module, evaluated on first hit. */\n readonly load: () => Promise<unknown>;\n}\n\n/**\n * A bus subscriber row. The Bus routes off it without importing the subscriber module. The HTTP engine\n * ignores these rows until the Bus ships on this transport.\n */\ninterface SubscriberRoute {\n /** The subscription keys this subscriber registers for. */\n readonly keys: readonly string[];\n /** Mirrors the `@Subscribe` frequency metadata. */\n readonly frequency: 'on' | 'once';\n /** Lazy import of the subscriber module. */\n readonly load: () => Promise<unknown>;\n}\n\n/**\n * The static route table the HTTP engine dispatches through, replacing the filesystem handler scan that\n * cannot run in a bundled isolate. `seedcord build` emits it, the mount path authors it by hand.\n */\nexport interface RouteManifest {\n readonly commands: readonly CommandRoute[];\n readonly components: readonly ComponentRoute[];\n readonly autocomplete: readonly AutocompleteRoute[];\n readonly subscribers: readonly SubscriberRoute[];\n}\n\n/** @internal */\nexport const EMPTY_MANIFEST: RouteManifest = { commands: [], components: [], autocomplete: [], subscribers: [] };\n","import { HmrModuleHandler } from '@seedcord/core/hmr';\nimport { interactionRoutesOf, InteractionMetadataKey, InteractionRoutes } from '@seedcord/core/internal';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport { Envapter } from 'envapt';\n\nimport { AutocompleteHandler } from '@handlers/interaction/AutocompleteHandler';\nimport { InteractionHandler } from '@handlers/interaction/InteractionHandler';\nimport { buildRouteMaps } from '@src/dispatch/resolve';\nimport { EMPTY_MANIFEST } from '@src/manifest/RouteManifest';\n\nimport type { HandlerConstructor } from '@handlers/constructors';\nimport type { Initializeable } from '@seedcord/core';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { ResolvedRoute, RouteMap, RouteMaps } from '@src/dispatch/resolve';\n\ninterface RouteTarget {\n readonly map: RouteMap;\n readonly kind: ResolvedRoute['kind'];\n}\n\n/**\n * Discovers interaction handlers from the filesystem into the engine's live route maps.\n *\n * The node host runs it at startup and dev HMR swaps map entries in place. The engine's `resolve`\n * reads `maps` per request. The edge path builds its maps from the generated manifest.\n */\nexport class InteractionDispatcher implements Initializeable, HmrAware {\n public readonly maps: RouteMaps;\n private readonly targets: Record<InteractionRoutes, RouteTarget>;\n\n /** @internal */\n public readonly logger = new Logger('Interactions');\n\n private isInitialized = false;\n private readonly hmrHandler?: HmrModuleHandler<HandlerConstructor, void, string[]>;\n // routeId -> owner row, the duplicate guard and the hmr unregister index\n private readonly rowOwners = new Map<string, { ctor: HandlerConstructor; target: RouteTarget; key: string }>();\n\n private loading = false;\n private readonly loadedHandlers: { name: string; from: string }[] = [];\n\n constructor(private readonly handlersDir: string) {\n this.maps = buildRouteMaps(EMPTY_MANIFEST);\n this.targets = this.buildTargets();\n\n if (!Envapter.isDevelopment && !Envapter.isTest) return;\n this.hmrHandler = new HmrModuleHandler({\n handlersDir,\n isHandler: this.isHandler.bind(this),\n registerHandler: this.registerHandler.bind(this),\n unregisterHandler: this.unregisterHandler.bind(this),\n getArtifacts: this.getArtifacts.bind(this),\n logger: this.logger\n });\n }\n\n /** @internal */\n public async init(): Promise<void> {\n if (this.isInitialized) return;\n this.isInitialized = true;\n\n this.loading = true;\n this.loadedHandlers.length = 0;\n try {\n await traverseDirectory(\n this.handlersDir,\n (fullPath, relativePath, imported) => {\n for (const value of Object.values(imported)) {\n if (!this.isHandler(value)) continue;\n this.registerHandler(value, relativePath);\n this.hmrHandler?.trackHandler(fullPath, value);\n }\n },\n this.logger\n );\n } finally {\n this.loading = false;\n }\n\n this.logger.utils.block('Loaded handlers', [\n ...this.logger.utils.entries(this.loadedHandlers),\n ...this.logger.utils.counts({ routes: this.rowOwners.size })\n ]);\n }\n\n /** @internal */\n public async onHmr(event: HmrUpdateEvent): Promise<void> {\n await this.hmrHandler?.handle(event);\n }\n\n private isHandler(value: unknown): value is HandlerConstructor {\n if (typeof value !== 'function') return false;\n // this package's own family bases. A gateway handler in the same dir stays unregistered\n return (\n (value.prototype instanceof InteractionHandler || value.prototype instanceof AutocompleteHandler) &&\n Reflect.hasMetadata(InteractionMetadataKey, value)\n );\n }\n\n private getArtifacts(ctor: HandlerConstructor): string[] {\n const routeIds: string[] = [];\n for (const [routeId, owner] of this.rowOwners) {\n if (owner.ctor === ctor) routeIds.push(routeId);\n }\n return routeIds;\n }\n\n private targetFor(route: InteractionRoutes): RouteTarget {\n return this.targets[route];\n }\n\n private buildTargets(): Record<InteractionRoutes, RouteTarget> {\n return {\n [InteractionRoutes.Slash]: { map: this.maps.slash, kind: 'slash' },\n [InteractionRoutes.UserContextMenu]: { map: this.maps.userContextMenu, kind: 'userContextMenu' },\n [InteractionRoutes.MessageContextMenu]: { map: this.maps.messageContextMenu, kind: 'messageContextMenu' },\n [InteractionRoutes.Autocomplete]: { map: this.maps.autocomplete, kind: 'autocomplete' },\n [InteractionRoutes.Button]: { map: this.maps.components.button, kind: 'button' },\n [InteractionRoutes.StringMenu]: { map: this.maps.components.stringSelect, kind: 'stringMenu' },\n [InteractionRoutes.UserMenu]: { map: this.maps.components.userSelect, kind: 'userMenu' },\n [InteractionRoutes.RoleMenu]: { map: this.maps.components.roleSelect, kind: 'roleMenu' },\n [InteractionRoutes.ChannelMenu]: { map: this.maps.components.channelSelect, kind: 'channelMenu' },\n [InteractionRoutes.MentionableMenu]: {\n map: this.maps.components.mentionableSelect,\n kind: 'mentionableMenu'\n },\n [InteractionRoutes.Modal]: { map: this.maps.components.modal, kind: 'modal' }\n };\n }\n\n private registerHandler(ctor: HandlerConstructor, relativePath: string): void {\n // a partial registration would orphan routes and break hmr rollback\n const writes: [RouteTarget, string][] = [];\n\n for (const [route, keys] of interactionRoutesOf(ctor)) {\n const target = this.targetFor(route);\n for (const key of keys) {\n const existing = this.rowOwners.get(`${target.kind}:${key}`);\n // a different class on the same route would silently shadow (last write wins), so this throws\n if (existing && existing.ctor !== ctor) {\n throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [\n key,\n existing.ctor.name,\n ctor.name\n ]);\n }\n writes.push([target, key]);\n }\n }\n\n if (writes.length === 0) return;\n for (const [target, key] of writes) {\n const routeId = `${target.kind}:${key}`;\n // a one-export module, the dispatch first-handler scan resolves exactly this row's class\n target.map.set(key, { kind: target.kind, routeId, load: () => Promise.resolve({ [ctor.name]: ctor }) });\n this.rowOwners.set(routeId, { ctor, target, key });\n }\n\n const from = formatFilePath(relativePath);\n if (this.loading) this.loadedHandlers.push({ name: ctor.name, from });\n else this.logger.utils.registration(ctor.name, from);\n }\n\n private unregisterHandler(ctor: HandlerConstructor, artifacts?: string[]): void {\n const routeIds = artifacts ?? this.getArtifacts(ctor);\n for (const routeId of routeIds) {\n const owner = this.rowOwners.get(routeId);\n if (owner?.ctor !== ctor) continue;\n this.rowOwners.delete(routeId);\n owner.target.map.delete(owner.key);\n }\n }\n}\n","import type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';\n\nfunction toHeaders(raw: IncomingHttpHeaders): Headers {\n const headers = new Headers();\n for (const [name, value] of Object.entries(raw)) {\n if (value === undefined) continue;\n if (Array.isArray(value)) {\n for (const item of value) headers.append(name, item);\n } else {\n headers.set(name, value);\n }\n }\n return headers;\n}\n\n// buffers the raw body before any parse so ed25519 verifies the exact signed bytes\nexport async function toWebRequest(request: IncomingMessage): Promise<Request> {\n const chunks: Buffer[] = [];\n // justified: the async iterator is typed any and IncomingMessage yields Buffer chunks\n for await (const chunk of request) chunks.push(chunk as Buffer);\n\n const method = request.method ?? 'GET';\n const body = method === 'GET' || method === 'HEAD' ? undefined : new Uint8Array(Buffer.concat(chunks));\n\n return new Request(`http://${request.headers.host ?? 'localhost'}${request.url ?? '/'}`, {\n method,\n headers: toHeaders(request.headers),\n ...(body !== undefined && { body })\n });\n}\n\nexport async function writeWebResponse(response: Response, out: ServerResponse): Promise<void> {\n const headers: Record<string, string | string[]> = Object.fromEntries(response.headers);\n // iterating Headers comma-joins same-name values, which corrupts Set-Cookie (a per-cookie header)\n const cookies = response.headers.getSetCookie();\n if (cookies.length > 0) headers['set-cookie'] = cookies;\n\n out.writeHead(response.status, headers);\n out.end(response.body === null ? undefined : Buffer.from(await response.arrayBuffer()));\n}\n","import { once } from 'node:events';\nimport { createServer } from 'node:http';\n\nimport { REST } from '@discordjs/rest';\nimport { HmrManager, setBotColor } from '@seedcord/core/internal';\nimport {\n CoordinatedShutdown,\n CoordinatedStartup,\n HealthCheck,\n Pluggable,\n ShutdownPhase,\n StartupPhase\n} from '@seedcord/core/node/internal';\nimport { validateDiscordToken } from '@seedcord/errors/internal';\nimport { Logger, LoggerChannelRegistry, paint } from '@seedcord/logger';\nimport { installNodeDefaults } from '@seedcord/logger/node';\nimport { MemoryRateLimiter } from '@seedcord/rate-limiter';\nimport { SeedcordBrand } from '@seedcord/types/internal';\nimport { Routes } from 'discord-api-types/v10';\nimport { Envapter } from 'envapt';\n\nimport { buildRouteMaps } from '@src/dispatch/resolve';\nimport { buildEngine } from '@src/engine';\nimport { EMPTY_MANIFEST } from '@src/manifest/RouteManifest';\n\nimport { InteractionDispatcher } from './InteractionDispatcher';\nimport { toWebRequest, writeWebResponse } from './webBridge';\nimport { version as packageVersion } from '../version';\n\nimport type { HttpConfig } from '@interfaces/Config';\nimport type { Core } from '@interfaces/Core';\nimport type { PluginCapabilities } from '@seedcord/core/node/internal';\nimport type { IRateLimiter } from '@seedcord/types';\nimport type { Server } from 'node:http';\nimport type { AddressInfo } from 'node:net';\n\nconst DEFAULT_PORT = 3000;\nconst SERVER_SHUTDOWN_TIMEOUT_MS = 5000;\nconst DRAIN_TIMEOUT_MS = 10_000;\n\n/**\n * The HTTP-interactions bot host, a long-running node server around the engine.\n *\n * Discovers handlers from `config.bot.interactions.path`, verifies and dispatches interactions on\n * `start(port)`, and runs coordinated shutdown with an in-flight drain. The edge deploy path calls\n * `createSeedcord` from a generated entry.\n */\nexport class Seedcord extends Pluggable implements Core {\n // the CLI reads these to detect and augment the instance\n /** @internal */\n public readonly [SeedcordBrand] = true;\n /** @internal */\n public readonly augmentTarget = '@seedcord/http';\n /** @internal */\n public readonly version: string = packageVersion;\n\n /** Workerd-compatible Discord REST client. `start()` sets the token. */\n public readonly rest = new REST();\n\n /** @see {@link IRateLimiter} */\n public readonly rateLimiter: IRateLimiter;\n\n /** @see {@link CoordinatedShutdown} */\n public override readonly shutdown: CoordinatedShutdown;\n\n /** @see {@link CoordinatedStartup} */\n public override readonly startup: CoordinatedStartup;\n\n private readonly interactions?: InteractionDispatcher;\n private readonly healthCheck?: HealthCheck | undefined;\n private readonly hmrManager: HmrManager;\n private readonly logger = new Logger('Server');\n\n private server?: Server;\n private boundPort?: number;\n private requestedPort = DEFAULT_PORT;\n private fetchedUsername?: string | undefined;\n\n constructor(public readonly config: HttpConfig) {\n const shutdown = new CoordinatedShutdown();\n const startup = new CoordinatedStartup();\n\n super(shutdown, startup);\n\n installNodeDefaults(config.logger);\n setBotColor(config.botColor);\n\n this.shutdown = shutdown;\n this.startup = startup;\n\n this.hmrManager = new HmrManager();\n this.hmrManager.init();\n\n if (this.config.bot.interactions.path) {\n this.interactions = new InteractionDispatcher(this.config.bot.interactions.path);\n }\n\n this.rateLimiter = config.store ?? new MemoryRateLimiter();\n // the edge arm types healthCheck never, and a dev run of an edge config needs no health server\n this.healthCheck =\n config.runtime === 'edge' ? undefined : HealthCheck.fromOption(this.shutdown, config.healthCheck);\n\n this.registerStartupTasks();\n }\n\n /** The bot's discord username, populated by the ready fetch. */\n public get username(): string | undefined {\n return this.fetchedUsername;\n }\n\n /** The bound server port, populated once `start()` is listening. */\n public get port(): number | undefined {\n return this.boundPort;\n }\n\n protected override pluginCapabilities(): PluginCapabilities {\n const token = Envapter.get('DISCORD_BOT_TOKEN');\n return { rest: this.rest, ...(token !== undefined && { token }) };\n }\n\n /**\n * Starts the host and runs the startup tasks.\n *\n * @param port - The port the interaction server binds. {@default `3000`}\n */\n public async start(port = DEFAULT_PORT): Promise<this> {\n this.requestedPort = port;\n try {\n await super.init();\n } catch (caught) {\n // shutdown releases any resource opened before the failure, then rethrow\n await this.shutdown.run(1, false);\n Seedcord.reset();\n throw caught;\n }\n return this;\n }\n\n protected static override reset(): void {\n super.reset();\n LoggerChannelRegistry.instance.reset();\n }\n\n private registerStartupTasks(): void {\n if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();\n\n const { interactions } = this;\n if (interactions) {\n this.startup.addTask(StartupPhase.Configuration, 'Interactions Initialization', async () => {\n interactions.logger.utils.initialization('Interactions', 'start');\n await interactions.init();\n interactions.logger.utils.initialization('Interactions', 'end');\n });\n }\n\n this.startup.addTask(StartupPhase.Ready, 'Http Server', () => this.listen());\n\n if (!Envapter.isTest) {\n this.startup.addTask(StartupPhase.Ready, 'Identity', () => this.fetchUsername());\n }\n\n const { healthCheck } = this;\n if (healthCheck) {\n this.startup.addTask(StartupPhase.Ready, 'Health Check', async () => {\n healthCheck.logger.utils.initialization('HealthCheck', 'start');\n await healthCheck.init();\n healthCheck.logger.utils.initialization('HealthCheck', 'end');\n });\n }\n }\n\n private registerHmrAwareModules(): void {\n this.startup.addTask(StartupPhase.Configuration, 'HMR Registration', async () => {\n if (this.interactions) this.hmrManager.register(this.interactions);\n for (const plugin of this.plugins) {\n this.hmrManager.register(plugin);\n }\n await Promise.resolve();\n });\n }\n\n private async listen(): Promise<void> {\n const token = validateDiscordToken(Envapter.get('DISCORD_BOT_TOKEN'));\n this.rest.setToken(token);\n\n const maps = this.interactions?.maps ?? buildRouteMaps(EMPTY_MANIFEST);\n const { handle, inFlight } = buildEngine(this, maps);\n\n const server = createServer((incoming, outgoing) => {\n void (async () => {\n const response = await handle(await toWebRequest(incoming));\n await writeWebResponse(response, outgoing);\n })().catch((error: unknown) => {\n // a swallowed throw would hang the client request with no cause\n outgoing.destroy(Error.isError(error) ? error : new Error(String(error)));\n });\n });\n this.server = server;\n\n server.listen(this.requestedPort);\n await once(server, 'listening');\n // justified: address() is AddressInfo once a TCP server is listening\n this.boundPort = (server.address() as AddressInfo).port;\n this.logger.info(`Interactions server listening on port ${paint.sky.bold(String(this.boundPort))}`);\n\n this.shutdown.addTask(\n ShutdownPhase.Unbind,\n 'stop-http-server',\n () => this.stopServer(),\n SERVER_SHUTDOWN_TIMEOUT_MS\n );\n // Unbind already ran, so every accepted request is in the in-flight set here\n this.shutdown.addTask(\n ShutdownPhase.Drain,\n 'drain-inflight',\n async () => {\n await Promise.allSettled(inFlight);\n },\n DRAIN_TIMEOUT_MS\n );\n }\n\n private async fetchUsername(): Promise<void> {\n try {\n // justified: the @me payload carries username per the discord api contract\n const me = (await this.rest.get(Routes.user('@me'))) as { username?: string };\n this.fetchedUsername = me.username;\n } catch (caught) {\n // a bad token errors on the first real send. The identity fetch stays non-fatal\n this.logger.warn('could not fetch the bot identity', caught);\n }\n }\n\n private stopServer(): Promise<void> {\n const server = this.server;\n if (!server?.listening) return Promise.resolve();\n\n return new Promise((resolveClose, rejectClose) => {\n server.close((err) => {\n if (err) {\n rejectClose(err);\n return;\n }\n this.logger.info(paint.coral.bold('Interactions server stopped'));\n resolveClose();\n });\n // idle keep-alive sockets would stall close() past the task timeout. Active responses\n // still flush, and the task timeout bounds a hung one\n server.closeIdleConnections();\n });\n }\n}\n","export * from './edge.index';\nexport { Seedcord } from '@src/node/Seedcord';\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["Logger","buildRouteMaps","Envapter","HmrModuleHandler","paint","InteractionHandler","AutocompleteHandler","InteractionMetadataKey","InteractionRoutes","SeedcordError","SeedcordErrorCode","Pluggable","SeedcordBrand","packageVersion","REST","EmojiInjector","Logger","CoordinatedShutdown","CoordinatedStartup","HmrManager","CommandInjector","CommandRegistry","MemoryRateLimiter","Bus","SubscriberLoader","HealthCheck","Envapter","StartupPhase","fetchApplicationId","SeedcordError","SeedcordErrorCode","buildRouteMaps","buildEngine","paint","ShutdownPhase","Routes","CorePlugin"],"sources":["../src/manifest/RouteManifest.ts","../src/node/InteractionDispatcher.ts","../src/node/webBridge.ts","../src/node/Seedcord.ts","../src/plugin.ts","../src/index.ts"],"sourcesContent":["import type { SelectMenuKind, SubscriptionKey } from '@seedcord/core';\nimport type { EventFrequency } from '@seedcord/types';\nimport type { ApplicationCommandType } from 'discord-api-types/v10';\n\n/** The command kinds a manifest row registers, the wire enum's other members have no handler base. */\ntype RegistrableCommandType =\n | ApplicationCommandType.ChatInput\n | ApplicationCommandType.User\n | ApplicationCommandType.Message;\n\n/** One file may export several handlers, so the row states which export it registers. */\nexport interface RouteModule {\n /** The exported binding inside the loaded module. */\n readonly exportName: string;\n /** The source file the row came from, reported when the export is missing. */\n readonly from: string;\n /** Lazy import of the module, evaluated on first hit. */\n readonly load: () => Promise<Record<string, unknown>>;\n}\n\n/**\n * A slash or context-menu command row. `type` picks the per-kind map, `name` is the lookup key. For a\n * chat-input command with subcommands, `name` is the full route path (`'config/set'`), the same key\n * `@SlashRoute` registers.\n */\ninterface CommandRoute extends RouteModule {\n readonly name: string;\n readonly type: RegistrableCommandType;\n}\n\n/**\n * A button, select, or modal row. `kind` picks the per-kind map, `prefix` is the stable customId prefix\n * the receiver routes by (the routeKey minus its layout hash).\n */\nexport interface ComponentRoute extends RouteModule {\n readonly kind: 'button' | `${SelectMenuKind}Select` | 'modal';\n readonly prefix: string;\n}\n\n/**\n * An autocomplete row, its own route keyed by the command's route path, separate from the slash row.\n */\ninterface AutocompleteRoute extends RouteModule {\n readonly name: string;\n}\n\n/**\n * A bus subscriber row. The Bus registers it without importing the subscriber module, and resolves the\n * class on the first publish of one of its keys.\n */\ninterface SubscriberRoute extends RouteModule {\n /** The subscription keys this subscriber registers for. */\n readonly keys: readonly SubscriptionKey[];\n /** Mirrors the `@Subscribe` frequency metadata. */\n readonly frequency: EventFrequency;\n}\n\n/** A middleware row. Middleware runs on every dispatch, so it carries no lookup key. */\ntype MiddlewareRoute = RouteModule;\n\n/**\n * The static route table the HTTP engine dispatches through, replacing the filesystem handler scan that\n * cannot run in a bundled isolate. `seedcord build` emits it, the mount path authors it by hand.\n */\nexport interface RouteManifest {\n readonly commandRoutes: readonly CommandRoute[];\n readonly componentRoutes: readonly ComponentRoute[];\n readonly autocompleteRoutes: readonly AutocompleteRoute[];\n readonly subscriberRoutes: readonly SubscriberRoute[];\n readonly middlewareRoutes: readonly MiddlewareRoute[];\n}\n\n/** @internal */\nexport const EMPTY_MANIFEST: RouteManifest = {\n commandRoutes: [],\n componentRoutes: [],\n autocompleteRoutes: [],\n subscriberRoutes: [],\n middlewareRoutes: []\n};\n","import { HmrModuleHandler } from '@seedcord/core/hmr';\nimport { interactionRoutesOf, InteractionMetadataKey, InteractionRoutes } from '@seedcord/core/internal';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError } from '@seedcord/errors/internal';\nimport { Logger, paint } from '@seedcord/logger';\nimport { formatFilePath } from '@seedcord/utils';\nimport { traverseDirectory } from '@seedcord/utils/node';\nimport chalk from 'chalk';\nimport { Envapter } from 'envapt';\n\nimport { AutocompleteHandler } from '@handlers/interaction/AutocompleteHandler';\nimport { InteractionHandler } from '@handlers/interaction/InteractionHandler';\nimport { buildRouteMaps } from '@src/dispatch/resolve';\nimport { EMPTY_MANIFEST } from '@src/manifest/RouteManifest';\n\nimport type { HandlerConstructor } from '@handlers/constructors';\nimport type { Initializeable } from '@seedcord/core';\nimport type { ContextMenuLeaves } from '@seedcord/core/internal';\nimport type { HmrAware, HmrUpdateEvent } from '@seedcord/types';\nimport type { ResolvedRoute, RouteMap, RouteMaps } from '@src/dispatch/resolve';\n\ninterface RouteTarget {\n readonly map: RouteMap;\n readonly kind: ResolvedRoute['kind'];\n}\n\n/**\n * Discovers interaction handlers from the filesystem into the engine's live route maps.\n *\n * The node host runs it at startup and dev HMR swaps map entries in place. The engine's `resolve`\n * reads `maps` per request. The edge path builds its maps from the generated manifest.\n */\nexport class InteractionDispatcher implements Initializeable, HmrAware {\n public readonly maps: RouteMaps;\n private readonly targets: Record<InteractionRoutes, RouteTarget>;\n\n /** @internal */\n public readonly logger = new Logger('Interactions', { channel: 'interactions' });\n\n private isInitialized = false;\n private readonly hmrHandler?: HmrModuleHandler<HandlerConstructor, void, string[]>;\n // routeId -> owner row, the duplicate guard and the hmr unregister index\n private readonly rowOwners = new Map<\n string,\n { ctor: HandlerConstructor; target: RouteTarget; key: string; from: string }\n >();\n\n private loading = false;\n private readonly loadedHandlers: { name: string; from: string }[] = [];\n\n constructor(private readonly handlersDir: string) {\n this.maps = buildRouteMaps(EMPTY_MANIFEST);\n this.targets = this.buildTargets();\n\n if (!Envapter.isDevelopment && !Envapter.isTest) return;\n this.hmrHandler = new HmrModuleHandler({\n handlersDir,\n isHandler: this.isHandler.bind(this),\n registerHandler: this.registerHandler.bind(this),\n unregisterHandler: this.unregisterHandler.bind(this),\n getArtifacts: this.getArtifacts.bind(this),\n logger: this.logger\n });\n }\n\n /** @internal */\n public async init(): Promise<void> {\n if (this.isInitialized) return;\n this.isInitialized = true;\n\n this.loading = true;\n this.loadedHandlers.length = 0;\n try {\n await traverseDirectory(this.handlersDir, (fullPath, relativePath, imported) => {\n for (const value of Object.values(imported)) {\n if (!this.isHandler(value)) continue;\n this.registerHandler(value, relativePath);\n this.hmrHandler?.trackHandler(fullPath, value);\n }\n });\n } finally {\n this.loading = false;\n }\n\n this.logger.utils.block('Loaded handlers', [\n ...this.logger.utils.entries(this.loadedHandlers),\n ...this.logger.utils.counts({ routes: this.rowOwners.size })\n ]);\n }\n\n /** @internal */\n public async onHmr(event: HmrUpdateEvent): Promise<void> {\n await this.hmrHandler?.handle(event);\n }\n\n public warnUnhandledRoutes(commandLeaves: Iterable<string>): void {\n this.warnMissing(commandLeaves, this.maps.slash, 'Slash route', '@SlashRoute');\n }\n\n public warnUnhandledContextMenuRoutes(leaves: ContextMenuLeaves): void {\n this.warnMissing(leaves.user, this.maps.userContextMenu, 'User context menu', '@ContextMenuRoute');\n this.warnMissing(leaves.message, this.maps.messageContextMenu, 'Message context menu', '@ContextMenuRoute');\n }\n\n private warnMissing(names: Iterable<string>, map: RouteMap, label: string, decorator: string): void {\n for (const name of names) {\n if (map.has(name)) continue;\n this.logger.warn(`${label} ${paint.sky.bold(name)} has no registered ${chalk.bold(decorator)} handler.`);\n }\n }\n\n private isHandler(value: unknown): value is HandlerConstructor {\n if (typeof value !== 'function') return false;\n // this package's own family bases. A gateway handler in the same dir stays unregistered\n return (\n (value.prototype instanceof InteractionHandler || value.prototype instanceof AutocompleteHandler) &&\n Reflect.hasMetadata(InteractionMetadataKey, value)\n );\n }\n\n private getArtifacts(ctor: HandlerConstructor): string[] {\n const routeIds: string[] = [];\n for (const [routeId, owner] of this.rowOwners) {\n if (owner.ctor === ctor) routeIds.push(routeId);\n }\n return routeIds;\n }\n\n private targetFor(route: InteractionRoutes): RouteTarget {\n return this.targets[route];\n }\n\n private buildTargets(): Record<InteractionRoutes, RouteTarget> {\n return {\n [InteractionRoutes.Slash]: { map: this.maps.slash, kind: 'slash' },\n [InteractionRoutes.UserContextMenu]: { map: this.maps.userContextMenu, kind: 'userContextMenu' },\n [InteractionRoutes.MessageContextMenu]: { map: this.maps.messageContextMenu, kind: 'messageContextMenu' },\n [InteractionRoutes.Autocomplete]: { map: this.maps.autocomplete, kind: 'autocomplete' },\n [InteractionRoutes.Button]: { map: this.maps.components.button, kind: 'button' },\n [InteractionRoutes.StringMenu]: { map: this.maps.components.stringSelect, kind: 'stringMenu' },\n [InteractionRoutes.UserMenu]: { map: this.maps.components.userSelect, kind: 'userMenu' },\n [InteractionRoutes.RoleMenu]: { map: this.maps.components.roleSelect, kind: 'roleMenu' },\n [InteractionRoutes.ChannelMenu]: { map: this.maps.components.channelSelect, kind: 'channelMenu' },\n [InteractionRoutes.MentionableMenu]: {\n map: this.maps.components.mentionableSelect,\n kind: 'mentionableMenu'\n },\n [InteractionRoutes.Modal]: { map: this.maps.components.modal, kind: 'modal' }\n };\n }\n\n private registerHandler(ctor: HandlerConstructor, relativePath: string): void {\n const from = formatFilePath(relativePath);\n // a partial registration would orphan routes and break hmr rollback\n const writes: [RouteTarget, string][] = [];\n\n for (const [route, keys] of interactionRoutesOf(ctor)) {\n const target = this.targetFor(route);\n for (const key of keys) {\n const routeId = `${target.kind}:${key}`;\n const existing = this.rowOwners.get(routeId);\n // a different class on the same route would silently shadow (last write wins), so this throws\n if (existing && existing.ctor !== ctor) {\n throw new SeedcordError(SeedcordErrorCode.InteractionDuplicateRoute, [\n routeId,\n `${existing.ctor.name} (${existing.from})`,\n `${ctor.name} (${from})`\n ]);\n }\n writes.push([target, key]);\n }\n }\n\n if (writes.length === 0) return;\n for (const [target, key] of writes) {\n const routeId = `${target.kind}:${key}`;\n target.map.set(key, { kind: target.kind, routeId, load: () => Promise.resolve(ctor) });\n this.rowOwners.set(routeId, { ctor, target, key, from });\n }\n\n if (this.loading) this.loadedHandlers.push({ name: ctor.name, from });\n else this.logger.utils.registration(ctor.name, from);\n }\n\n private unregisterHandler(ctor: HandlerConstructor, artifacts?: string[]): void {\n const routeIds = artifacts ?? this.getArtifacts(ctor);\n for (const routeId of routeIds) {\n const owner = this.rowOwners.get(routeId);\n if (owner?.ctor !== ctor) continue;\n this.rowOwners.delete(routeId);\n owner.target.map.delete(owner.key);\n }\n }\n}\n","import type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';\n\nfunction toHeaders(raw: IncomingHttpHeaders): Headers {\n const headers = new Headers();\n for (const [name, value] of Object.entries(raw)) {\n if (value === undefined) continue;\n if (Array.isArray(value)) {\n for (const item of value) headers.append(name, item);\n } else {\n headers.set(name, value);\n }\n }\n return headers;\n}\n\n// buffers the raw body before any parse so ed25519 verifies the exact signed bytes\nexport async function toWebRequest(request: IncomingMessage): Promise<Request> {\n const chunks: Buffer[] = [];\n // justified: the async iterator is typed any and IncomingMessage yields Buffer chunks\n for await (const chunk of request) chunks.push(chunk as Buffer);\n\n const method = request.method ?? 'GET';\n const body = method === 'GET' || method === 'HEAD' ? undefined : new Uint8Array(Buffer.concat(chunks));\n\n return new Request(`http://${request.headers.host ?? 'localhost'}${request.url ?? '/'}`, {\n method,\n headers: toHeaders(request.headers),\n ...(body !== undefined && { body })\n });\n}\n\nexport async function writeWebResponse(response: Response, out: ServerResponse): Promise<void> {\n const headers: Record<string, string | string[]> = Object.fromEntries(response.headers);\n // iterating Headers comma-joins same-name values, which corrupts Set-Cookie (a per-cookie header)\n const cookies = response.headers.getSetCookie();\n if (cookies.length > 0) headers['set-cookie'] = cookies;\n\n out.writeHead(response.status, headers);\n out.end(response.body === null ? undefined : Buffer.from(await response.arrayBuffer()));\n}\n","import { once } from 'node:events';\nimport { createServer } from 'node:http';\n\nimport { REST } from '@discordjs/rest';\nimport { Bus } from '@seedcord/core';\nimport { CommandInjector, HmrManager, setBotColor } from '@seedcord/core/internal';\nimport {\n CommandRegistry,\n CoordinatedShutdown,\n CoordinatedStartup,\n HealthCheck,\n Pluggable,\n ShutdownPhase,\n StartupPhase,\n SubscriberLoader\n} from '@seedcord/core/node/internal';\nimport { SeedcordErrorCode } from '@seedcord/errors';\nimport { SeedcordError, validateDiscordToken } from '@seedcord/errors/internal';\nimport { Logger, LoggerChannelRegistry, paint } from '@seedcord/logger';\nimport { installNodeDefaults } from '@seedcord/logger/node';\nimport { MemoryRateLimiter } from '@seedcord/rate-limiter';\nimport { SeedcordBrand } from '@seedcord/types/internal';\nimport { Routes } from 'discord-api-types/v10';\nimport { Envapter } from 'envapt';\n\nimport { fetchApplicationId } from '@src/applicationId';\nimport { buildRouteMaps } from '@src/dispatch/resolve';\nimport { EmojiInjector } from '@src/emojis/EmojiInjector';\nimport { buildEngine } from '@src/engine';\nimport { EMPTY_MANIFEST } from '@src/manifest/RouteManifest';\n\nimport { InteractionDispatcher } from './InteractionDispatcher';\nimport { toWebRequest, writeWebResponse } from './webBridge';\nimport { version as packageVersion } from '../version';\n\nimport type { HttpConfig } from '@interfaces/Config';\nimport type { Core } from '@interfaces/Core';\nimport type { IRateLimiter } from '@seedcord/types';\nimport type { SeedcordInstance } from '@seedcord/types/internal';\nimport type { Server } from 'node:http';\nimport type { AddressInfo } from 'node:net';\n\nconst DEFAULT_PORT = 3000;\nconst SERVER_SHUTDOWN_TIMEOUT_MS = 5000;\nconst DRAIN_TIMEOUT_MS = 10_000;\n\ntype RuntimeOfConfig<Cfg extends HttpConfig> = Cfg extends { runtime: 'edge' } ? 'edge' : 'server';\n\n/**\n * The HTTP-interactions bot host, a long-running node server around the engine.\n *\n * Discovers handlers from `config.bot.interactions.path`, verifies and dispatches interactions on\n * `start(port)`, and runs coordinated shutdown with an in-flight drain. The edge deploy path calls\n * `createSeedcord` from a generated entry.\n */\nexport class Seedcord<Cfg extends HttpConfig = HttpConfig>\n extends Pluggable<'http', RuntimeOfConfig<Cfg>>\n implements Core, SeedcordInstance\n{\n // the CLI reads these to detect and augment the instance\n /** @internal */\n public readonly [SeedcordBrand] = true;\n /** @internal */\n public readonly augmentTarget = '@seedcord/http';\n /** @internal */\n public readonly version: string = packageVersion;\n\n /** Workerd-compatible Discord REST client. `start()` sets the token. */\n public readonly rest = new REST();\n\n /** @see {@link IRateLimiter} */\n public readonly rateLimiter: IRateLimiter;\n\n /** @see {@link Bus} */\n public readonly bus: Bus;\n\n private readonly subscribers: SubscriberLoader;\n\n private readonly interactions?: InteractionDispatcher;\n private readonly commandRegistry?: CommandRegistry;\n private appId?: string;\n private appIdPromise?: Promise<string>;\n private readonly emojiInjector = new EmojiInjector(this, () => this.applicationId());\n private readonly healthCheck?: HealthCheck | undefined;\n private readonly hmrManager: HmrManager;\n private readonly logger = new Logger('Server', { channel: 'bot' });\n\n private server?: Server;\n private boundPort?: number;\n private requestedPort = DEFAULT_PORT;\n private fetchedUsername?: string | undefined;\n\n constructor(public readonly config: Cfg) {\n super(new CoordinatedShutdown(), new CoordinatedStartup());\n\n installNodeDefaults(config.logger);\n setBotColor(config.botColor);\n\n this.hmrManager = new HmrManager();\n this.hmrManager.init();\n\n if (this.config.bot.interactions.path) {\n this.interactions = new InteractionDispatcher(this.config.bot.interactions.path);\n }\n\n const commandsDir = this.config.bot.commands.path;\n if (commandsDir) {\n const injector = new CommandInjector();\n // onDeployed only fires at deploy time, so registry is assigned by then\n const registry: CommandRegistry = new CommandRegistry({\n dir: commandsDir,\n rest: this.rest,\n applicationId: () => this.requireApplicationId(),\n onDeployed: (result) => {\n injector.inject(result, registry.allCommands());\n }\n });\n this.commandRegistry = registry;\n }\n\n this.rateLimiter = config.store ?? new MemoryRateLimiter();\n this.bus = new Bus(this);\n this.subscribers = new SubscriberLoader(this.bus, config.subscribers.path);\n // the edge arm types healthCheck never, and a dev run of an edge config needs no health server\n this.healthCheck =\n config.runtime === 'edge' ? undefined : HealthCheck.fromOption(this.shutdown, config.healthCheck);\n\n this.registerStartupTasks();\n }\n\n /** The bot's discord username, populated by the ready fetch. */\n public get username(): string | undefined {\n return this.fetchedUsername;\n }\n\n /** The bound server port, populated once `start()` is listening. */\n public get port(): number | undefined {\n return this.boundPort;\n }\n\n /**\n * Starts the host and runs the startup tasks.\n *\n * @param port - The port the interaction server binds. {@default `3000` }\n */\n public async start(port = DEFAULT_PORT): Promise<this> {\n this.requestedPort = port;\n try {\n await super.init();\n } catch (caught) {\n // shutdown releases any resource opened before the failure, then rethrow\n await this.shutdown.run(1, false);\n Seedcord.reset();\n throw caught;\n }\n return this;\n }\n\n protected static override reset(): void {\n super.reset();\n LoggerChannelRegistry.instance.reset();\n }\n\n private registerStartupTasks(): void {\n if (Envapter.isDevelopment || Envapter.isTest) this.registerHmrAwareModules();\n\n this.startup.addTask(StartupPhase.Configuration, 'bus-initialization', async () => {\n this.bus.logger.utils.initialization('Subscribers', 'start');\n await this.subscribers.init();\n this.bus.logger.utils.initialization('Subscribers', 'end');\n });\n\n const { interactions } = this;\n if (interactions) {\n this.startup.addTask(StartupPhase.Configuration, 'interactions-initialization', async () => {\n interactions.logger.utils.initialization('Interactions', 'start');\n await interactions.init();\n interactions.logger.utils.initialization('Interactions', 'end');\n });\n }\n\n this.startup.addTask(StartupPhase.Configuration, 'authenticate', () => {\n this.authenticate();\n return Promise.resolve();\n });\n\n // needs the token from Configuration, and must finish before Ready opens the server to interactions\n this.startup.addTask(StartupPhase.Login, 'emoji-injection', () => this.emojiInjector.init());\n\n const { commandRegistry } = this;\n if (commandRegistry) {\n // one task, because tasks within a phase run concurrently and the deploy reads the id\n this.startup.addTask(StartupPhase.Login, 'command-deploy', async () => {\n await commandRegistry.init();\n this.appId = await this.applicationId();\n await commandRegistry.setCommands();\n interactions?.warnUnhandledRoutes(commandRegistry.routeLeaves());\n interactions?.warnUnhandledContextMenuRoutes(commandRegistry.contextMenuLeaves());\n });\n }\n\n this.startup.addTask(StartupPhase.Ready, 'http-server', () => this.listen());\n\n if (!Envapter.isTest) {\n this.startup.addTask(StartupPhase.Ready, 'identity', () => this.fetchUsername());\n }\n\n const { healthCheck } = this;\n if (healthCheck) {\n this.startup.addTask(StartupPhase.Ready, 'health-check', async () => {\n healthCheck.logger.utils.initialization('HealthCheck', 'start');\n await healthCheck.init();\n healthCheck.logger.utils.initialization('HealthCheck', 'end');\n });\n }\n }\n\n private registerHmrAwareModules(): void {\n this.startup.addTask(StartupPhase.Configuration, 'hmr-registration', async () => {\n if (this.interactions) this.hmrManager.register(this.interactions);\n if (this.commandRegistry) this.hmrManager.register(this.commandRegistry);\n this.hmrManager.register(this.subscribers);\n for (const plugin of this.plugins) {\n this.hmrManager.register(plugin);\n }\n await Promise.resolve();\n });\n }\n\n private authenticate(): void {\n this.rest.setToken(validateDiscordToken(Envapter.get('DISCORD_BOT_TOKEN')));\n }\n\n // the promise is stored, so two concurrent Login tasks share one fetch\n private applicationId(): Promise<string> {\n this.appIdPromise ??= fetchApplicationId(this.rest);\n return this.appIdPromise;\n }\n\n // the registry deploys on a hot reload too, after the startup task resolved this\n private requireApplicationId(): string {\n if (!this.appId) throw new SeedcordError(SeedcordErrorCode.CoreApplicationUnavailable);\n return this.appId;\n }\n\n private async listen(): Promise<void> {\n const maps = this.interactions?.maps ?? buildRouteMaps(EMPTY_MANIFEST);\n const { handle, inFlight } = buildEngine(this, maps);\n\n const server = createServer((incoming, outgoing) => {\n void (async () => {\n const response = await handle(await toWebRequest(incoming));\n await writeWebResponse(response, outgoing);\n })().catch((error: unknown) => {\n // a swallowed throw would hang the client request with no cause\n outgoing.destroy(Error.isError(error) ? error : new Error(String(error)));\n });\n });\n this.server = server;\n\n server.listen(this.requestedPort);\n await once(server, 'listening');\n // justified: address() is AddressInfo once a TCP server is listening\n this.boundPort = (server.address() as AddressInfo).port;\n this.logger.info(`Interactions server listening on port ${paint.sky.bold(String(this.boundPort))}`);\n\n this.shutdown.addTask(\n ShutdownPhase.Unbind,\n 'stop-http-server',\n () => this.stopServer(),\n SERVER_SHUTDOWN_TIMEOUT_MS\n );\n // Unbind already ran, so every accepted request is in the in-flight set here\n this.shutdown.addTask(\n ShutdownPhase.Drain,\n 'drain-inflight',\n async () => {\n await Promise.allSettled(inFlight);\n },\n DRAIN_TIMEOUT_MS\n );\n }\n\n private async fetchUsername(): Promise<void> {\n try {\n // justified: the @me payload carries username per the discord api contract\n const me = (await this.rest.get(Routes.user('@me'))) as { username?: string };\n this.fetchedUsername = me.username;\n } catch (caught) {\n // a bad token errors on the first real send. The identity fetch stays non-fatal\n this.logger.warn('could not fetch the bot identity', caught);\n }\n }\n\n private stopServer(): Promise<void> {\n const server = this.server;\n if (!server?.listening) return Promise.resolve();\n\n return new Promise((resolveClose, rejectClose) => {\n server.close((err) => {\n if (err) {\n rejectClose(err);\n return;\n }\n this.logger.info(paint.coral.bold('Interactions server stopped'));\n resolveClose();\n });\n // idle keep-alive sockets would stall close() past the task timeout. Active responses\n // still flush, and the task timeout bounds a hung one\n server.closeIdleConnections();\n });\n }\n}\n","import { Plugin as CorePlugin } from '@seedcord/core/plugin';\n\nimport type { Core } from '@interfaces/Core';\nimport type { PluginOptions } from '@seedcord/core/plugin';\nimport type { TypedOmit } from '@seedcord/types';\n\n/** The options an HTTP plugin declares, narrowed to the transports this base serves. */\nexport type HttpPluginOptions = TypedOmit<PluginOptions, 'transport'> & { transport?: 'http' | 'any' };\n\n/**\n * Base class for an HTTP plugin, binding `this.core` to the HTTP {@link Core}.\n *\n * A plugin that runs on either transport extends the base from `@seedcord/core/plugin`, whose\n * `this.core` is typed to the shared members only.\n *\n * @typeParam Opts - The transport and runtime the plugin declares.\n */\nexport abstract class Plugin<Opts extends HttpPluginOptions = {}> extends CorePlugin<Opts, Core> {}\n\nexport type { PluginLifecycleSpec, PluginOptions } from '@seedcord/core/plugin';\n","export * from './edge.index';\nexport { Seedcord } from '@src/node/Seedcord';\n\nexport { Plugin } from './plugin';\nexport type { HttpPluginOptions, PluginLifecycleSpec, PluginOptions } from './plugin';\n"],"mappings":"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"}
package/dist/index.d.mts CHANGED
@@ -1,12 +1,18 @@
1
- import { _ as createSeedcord, a as SelectMenuHandler, c as AutocompleteHandler, d as InteractionHandler, f as RepliableHandler, g as HttpServerConfig, h as HttpEdgeConfig, i as ModalHandler, l as ContextMenuHandler, m as HttpConfig, n as Gated, o as ButtonHandler, p as SlashOptions, r as InteractionGateContext, s as ComponentHandler, t as version, u as SlashHandler, v as EngineContext, y as Core } from "./edge.index-CTOyjsO4.mjs";
2
- import { t as RouteManifest } from "./RouteManifest-BHdAeyLG.mjs";
1
+ import { C as createSeedcord, D as HttpEdgeConfig, E as HttpConfig, O as HttpServerConfig, S as SlashOptions, T as Core, _ as InteractionHandler, a as CursorSource, b as InjectedEmojiMap, c as Subscriber, d as SelectMenuHandler, f as ButtonHandler, g as SlashHandler, h as ContextMenuHandler, i as ArraySource, l as WebhookLog, m as AutocompleteHandler, n as Gated, o as Paginator, p as ComponentHandler, r as InteractionGateContext, s as PageContext, t as version, u as ModalHandler, v as RepliableHandler, w as EngineContext, x as ResolvedEmoji, y as Emojis } from "./edge.index-atnWgXP-.mjs";
2
+ import { t as RouteManifest } from "./RouteManifest-DE-HCMwd.mjs";
3
3
  import { REST } from "@discordjs/rest";
4
- import { CoordinatedShutdown, CoordinatedStartup, Pluggable, PluginCapabilities } from "@seedcord/core/node/internal";
5
- import { SeedcordBrand } from "@seedcord/types/internal";
6
- import { IRateLimiter } from "@seedcord/types";
4
+ import { Bus } from "@seedcord/core";
5
+ import { Pluggable } from "@seedcord/core/node/internal";
6
+ import { SeedcordBrand, SeedcordInstance } from "@seedcord/types/internal";
7
+ import { Plugin as Plugin$1, PluginLifecycleSpec, PluginOptions, PluginOptions as PluginOptions$1 } from "@seedcord/core/plugin";
8
+ import { IRateLimiter, TypedOmit } from "@seedcord/types";
7
9
  export * from "@seedcord/core";
10
+ export * from "@seedcord/types";
8
11
 
9
12
  //#region src/node/Seedcord.d.ts
13
+ type RuntimeOfConfig<Cfg extends HttpConfig> = Cfg extends {
14
+ runtime: 'edge';
15
+ } ? 'edge' : 'server';
10
16
  /**
11
17
  * The HTTP-interactions bot host, a long-running node server around the engine.
12
18
  *
@@ -14,8 +20,8 @@ export * from "@seedcord/core";
14
20
  * `start(port)`, and runs coordinated shutdown with an in-flight drain. The edge deploy path calls
15
21
  * `createSeedcord` from a generated entry.
16
22
  */
17
- declare class Seedcord extends Pluggable implements Core {
18
- readonly config: HttpConfig;
23
+ declare class Seedcord<Cfg extends HttpConfig = HttpConfig> extends Pluggable<'http', RuntimeOfConfig<Cfg>> implements Core, SeedcordInstance {
24
+ readonly config: Cfg;
19
25
  /** @internal */
20
26
  readonly [SeedcordBrand] = true;
21
27
  /** @internal */
@@ -26,11 +32,14 @@ declare class Seedcord extends Pluggable implements Core {
26
32
  readonly rest: REST;
27
33
  /** @see {@link IRateLimiter} */
28
34
  readonly rateLimiter: IRateLimiter;
29
- /** @see {@link CoordinatedShutdown} */
30
- readonly shutdown: CoordinatedShutdown;
31
- /** @see {@link CoordinatedStartup} */
32
- readonly startup: CoordinatedStartup;
35
+ /** @see {@link Bus} */
36
+ readonly bus: Bus;
37
+ private readonly subscribers;
33
38
  private readonly interactions?;
39
+ private readonly commandRegistry?;
40
+ private appId?;
41
+ private appIdPromise?;
42
+ private readonly emojiInjector;
34
43
  private readonly healthCheck?;
35
44
  private readonly hmrManager;
36
45
  private readonly logger;
@@ -38,28 +47,45 @@ declare class Seedcord extends Pluggable implements Core {
38
47
  private boundPort?;
39
48
  private requestedPort;
40
49
  private fetchedUsername?;
41
- constructor(config: HttpConfig);
50
+ constructor(config: Cfg);
42
51
  /** The bot's discord username, populated by the ready fetch. */
43
52
  get username(): string | undefined;
44
53
  /** The bound server port, populated once `start()` is listening. */
45
54
  get port(): number | undefined;
46
- protected pluginCapabilities(): PluginCapabilities;
47
55
  /**
48
56
  * Starts the host and runs the startup tasks.
49
57
  *
50
- * @param port - The port the interaction server binds. {@default `3000`}
58
+ * @param port - The port the interaction server binds. {@default `3000` }
51
59
  */
52
60
  start(port?: number): Promise<this>;
53
61
  protected static reset(): void;
54
62
  private registerStartupTasks;
55
63
  private registerHmrAwareModules;
64
+ private authenticate;
65
+ private applicationId;
66
+ private requireApplicationId;
56
67
  private listen;
57
68
  private fetchUsername;
58
69
  private stopServer;
59
70
  }
71
+ //#endregion
72
+ //#region src/plugin.d.ts
73
+ /** The options an HTTP plugin declares, narrowed to the transports this base serves. */
74
+ type HttpPluginOptions = TypedOmit<PluginOptions$1, 'transport'> & {
75
+ transport?: 'http' | 'any';
76
+ };
77
+ /**
78
+ * Base class for an HTTP plugin, binding `this.core` to the HTTP {@link Core}.
79
+ *
80
+ * A plugin that runs on either transport extends the base from `@seedcord/core/plugin`, whose
81
+ * `this.core` is typed to the shared members only.
82
+ *
83
+ * @typeParam Opts - The transport and runtime the plugin declares.
84
+ */
85
+ declare abstract class Plugin<Opts extends HttpPluginOptions = {}> extends Plugin$1<Opts, Core> {}
60
86
  declare namespace index_d_exports {
61
- export { AutocompleteHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, Core, EngineContext, Gated, HttpConfig, HttpEdgeConfig, HttpServerConfig, InteractionGateContext, InteractionHandler, ModalHandler, RepliableHandler, RouteManifest, Seedcord, SelectMenuHandler, SlashHandler, SlashOptions, createSeedcord, version };
87
+ export { ArraySource, AutocompleteHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, Core, CursorSource, Emojis, EngineContext, Gated, HttpConfig, HttpEdgeConfig, HttpPluginOptions, HttpServerConfig, InjectedEmojiMap, InteractionGateContext, InteractionHandler, ModalHandler, PageContext, Paginator, Plugin, PluginLifecycleSpec, PluginOptions, RepliableHandler, ResolvedEmoji, RouteManifest, Seedcord, SelectMenuHandler, SlashHandler, SlashOptions, Subscriber, WebhookLog, createSeedcord, version };
62
88
  }
63
89
  //#endregion
64
- export { AutocompleteHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, type Core, type EngineContext, Gated, type HttpConfig, type HttpEdgeConfig, type HttpServerConfig, type InteractionGateContext, InteractionHandler, ModalHandler, RepliableHandler, type RouteManifest, Seedcord, SelectMenuHandler, SlashHandler, type SlashOptions, createSeedcord, version };
90
+ export { ArraySource, AutocompleteHandler, ButtonHandler, ComponentHandler, ContextMenuHandler, type Core, CursorSource, Emojis, type EngineContext, Gated, type HttpConfig, type HttpEdgeConfig, type HttpPluginOptions, type HttpServerConfig, type InjectedEmojiMap, type InteractionGateContext, InteractionHandler, ModalHandler, type PageContext, Paginator, Plugin, type PluginLifecycleSpec, type PluginOptions, RepliableHandler, type ResolvedEmoji, type RouteManifest, Seedcord, SelectMenuHandler, SlashHandler, type SlashOptions, Subscriber, WebhookLog, createSeedcord, version };
65
91
  //# sourceMappingURL=index.d.mts.map