@gramio/composer 0.3.3 → 0.3.4

package/dist/index.cjs

@@ -386,6 +386,31 @@ class Composer {
       return info;
     });
   }
+  /**
+   * Returns a Set of all event names registered via `.on()` and event-specific `.derive()`.
+   *
+   * Useful for introspecting which update types the middleware chain handles,
+   * e.g. to auto-derive `allowed_updates` for the Telegram Bot API.
+   *
+   * @example
+   * ```typescript
+   * composer.on("message", handler);
+   * composer.on(["callback_query", "inline_query"], handler);
+   * composer.registeredEvents(); // Set {"message", "callback_query", "inline_query"}
+   * ```
+   */
+  registeredEvents() {
+    const events = /* @__PURE__ */ new Set();
+    for (const mw of this["~"].middlewares) {
+      if ((mw.type === "on" || mw.type === "derive") && mw.name) {
+        for (const part of mw.name.split("|")) {
+          const eventPart = part.includes(":") ? part.split(":")[0] : part;
+          if (eventPart) events.add(eventPart);
+        }
+      }
+    }
+    return events;
+  }
   trace(handler) {
     this["~"].tracer = handler;
     this.invalidate();

package/dist/index.d.cts

@@ -191,6 +191,20 @@ declare class Composer<TIn extends object = {}, TOut extends TIn = TIn, TExposed
     group(fn: (composer: Composer<TOut, TOut, {}>) => void): Composer<TIn, TOut, TExposed>;
     extend<UIn extends object, UOut extends UIn, UExposed extends object, UMacros extends MacroDefinitions = {}>(other: Composer<UIn, UOut, UExposed, UMacros>): Composer<TIn, TOut & UExposed, TExposed, TMacros & UMacros>;
     inspect(): MiddlewareInfo[];
+    /**
+     * Returns a Set of all event names registered via `.on()` and event-specific `.derive()`.
+     *
+     * Useful for introspecting which update types the middleware chain handles,
+     * e.g. to auto-derive `allowed_updates` for the Telegram Bot API.
+     *
+     * @example
+     * ```typescript
+     * composer.on("message", handler);
+     * composer.on(["callback_query", "inline_query"], handler);
+     * composer.registeredEvents(); // Set {"message", "callback_query", "inline_query"}
+     * ```
+     */
+    registeredEvents(): Set<string>;
     trace(handler: TraceHandler): this;
     compose(): ComposedMiddleware<TIn>;
     run(context: TIn, next?: Next): Promise<void>;
@@ -301,6 +315,7 @@ interface EventComposer<TBase extends object, TEventMap extends Record<string, T
     /** Register multiple macros at once */
     macro<const TDefs extends Record<string, MacroDef<any, any>>>(definitions: TDefs): EventComposer<TBase, TEventMap, TIn, TOut, TExposed, TDerives, TMethods, TMacros & TDefs> & TMethods;
     inspect(): MiddlewareInfo[];
+    registeredEvents(): Set<string>;
     trace(handler: TraceHandler): this;
     compose(): ComposedMiddleware<TIn>;
     run(context: TIn, next?: Next): Promise<void>;

package/dist/index.d.ts

@@ -191,6 +191,20 @@ declare class Composer<TIn extends object = {}, TOut extends TIn = TIn, TExposed
     group(fn: (composer: Composer<TOut, TOut, {}>) => void): Composer<TIn, TOut, TExposed>;
     extend<UIn extends object, UOut extends UIn, UExposed extends object, UMacros extends MacroDefinitions = {}>(other: Composer<UIn, UOut, UExposed, UMacros>): Composer<TIn, TOut & UExposed, TExposed, TMacros & UMacros>;
     inspect(): MiddlewareInfo[];
+    /**
+     * Returns a Set of all event names registered via `.on()` and event-specific `.derive()`.
+     *
+     * Useful for introspecting which update types the middleware chain handles,
+     * e.g. to auto-derive `allowed_updates` for the Telegram Bot API.
+     *
+     * @example
+     * ```typescript
+     * composer.on("message", handler);
+     * composer.on(["callback_query", "inline_query"], handler);
+     * composer.registeredEvents(); // Set {"message", "callback_query", "inline_query"}
+     * ```
+     */
+    registeredEvents(): Set<string>;
     trace(handler: TraceHandler): this;
     compose(): ComposedMiddleware<TIn>;
     run(context: TIn, next?: Next): Promise<void>;
@@ -301,6 +315,7 @@ interface EventComposer<TBase extends object, TEventMap extends Record<string, T
     /** Register multiple macros at once */
     macro<const TDefs extends Record<string, MacroDef<any, any>>>(definitions: TDefs): EventComposer<TBase, TEventMap, TIn, TOut, TExposed, TDerives, TMethods, TMacros & TDefs> & TMethods;
     inspect(): MiddlewareInfo[];
+    registeredEvents(): Set<string>;
     trace(handler: TraceHandler): this;
     compose(): ComposedMiddleware<TIn>;
     run(context: TIn, next?: Next): Promise<void>;

package/dist/index.js

@@ -383,6 +383,31 @@ class Composer {
       return info;
     });
   }
+  /**
+   * Returns a Set of all event names registered via `.on()` and event-specific `.derive()`.
+   *
+   * Useful for introspecting which update types the middleware chain handles,
+   * e.g. to auto-derive `allowed_updates` for the Telegram Bot API.
+   *
+   * @example
+   * ```typescript
+   * composer.on("message", handler);
+   * composer.on(["callback_query", "inline_query"], handler);
+   * composer.registeredEvents(); // Set {"message", "callback_query", "inline_query"}
+   * ```
+   */
+  registeredEvents() {
+    const events = /* @__PURE__ */ new Set();
+    for (const mw of this["~"].middlewares) {
+      if ((mw.type === "on" || mw.type === "derive") && mw.name) {
+        for (const part of mw.name.split("|")) {
+          const eventPart = part.includes(":") ? part.split(":")[0] : part;
+          if (eventPart) events.add(eventPart);
+        }
+      }
+    }
+    return events;
+  }
   trace(handler) {
     this["~"].tracer = handler;
     this.invalidate();

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gramio/composer",
-	"version": "0.3.3",
+	"version": "0.3.4",
 	"description": "General-purpose, type-safe middleware composition library for TypeScript",
 	"main": "dist/index.cjs",
 	"module": "dist/index.js",