@xpr/nestjs-slack 1.0.0 → 1.0.2

package/decorators.d.ts

@@ -1,7 +1,8 @@
-import { ActionConstraints, OptionsConstraints, ShortcutConstraints, ViewConstraints } from '@slack/bolt';
-import { type Pattern } from './utils';
-export type { SlackActionMiddlewareArgs, SlackCommandMiddlewareArgs, SlackShortcutMiddlewareArgs, SlackEventMiddlewareArgs, SlackViewMiddlewareArgs, SlackOptionsMiddlewareArgs, AllMiddlewareArgs, } from '@slack/bolt/dist/types';
+import { ActionConstraints, OptionsConstraints, ShortcutConstraints, ViewConstraints } from "@slack/bolt";
+import { type Pattern } from "./utils";
+import type { AllMiddlewareArgs, AnyMiddlewareArgs, SlackActionMiddlewareArgs, SlackCommandMiddlewareArgs, SlackEventMiddlewareArgs, SlackOptionsMiddlewareArgs, SlackShortcutMiddlewareArgs, SlackViewMiddlewareArgs } from "@slack/bolt/dist/types";
 export { Pattern };
+export type EndpointArgs<T extends AnyMiddlewareArgs> = T & AllMiddlewareArgs;
 /**
  * @see https://tools.slack.dev/bolt-js/reference/
  */
@@ -12,11 +13,16 @@ export declare const EventTypes: {
     Action: string;
     View: string;
     Option: string;
+    Message: string;
 };
 /**
  * Decorator for Slack controller
  */
 export declare function SlackController(): ClassDecorator;
+/**
+ * Arguments for the slack event handler
+ */
+export type SlackEventArgs = EndpointArgs<SlackEventMiddlewareArgs>;
 /**
  * Decorator for event events
  * @see guide https://tools.slack.dev/bolt-js/concepts/event-listening
@@ -24,6 +30,13 @@ export declare function SlackController(): ClassDecorator;
  * @param event
  */
 export declare function SlackEvent(event: string): MethodDecorator;
+/**
+ * Arguments for the slack shortcut handler
+ */
+export type SlackShortcutArgs = EndpointArgs<SlackShortcutMiddlewareArgs>;
+/**
+ * Shortcut id
+ */
 export type ShortCutId = Pattern | ShortcutConstraints;
 /**
  * Decorator for shortcut events
@@ -32,6 +45,10 @@ export type ShortCutId = Pattern | ShortcutConstraints;
  * @param shortcutId
  */
 export declare function SlackShortcut(shortcutId: ShortCutId): MethodDecorator;
+/**
+ * Arguments for the slack command handler
+ */
+export type SlackCommandArgs = EndpointArgs<SlackCommandMiddlewareArgs>;
 /**
  * Decorator for command events
  * @see guide https://tools.slack.dev/bolt-js/concepts/commands
@@ -39,6 +56,13 @@ export declare function SlackShortcut(shortcutId: ShortCutId): MethodDecorator;
  * @param commandId
  */
 export declare function SlackCommand(commandId: Pattern): MethodDecorator;
+/**
+ * Arguments for the slack action handler
+ */
+export type SlackActionArgs = EndpointArgs<SlackActionMiddlewareArgs>;
+/**
+ * Action id
+ */
 export type ActionId = Pattern | ActionConstraints;
 /**
  * Decorator for action events
@@ -46,6 +70,13 @@ export type ActionId = Pattern | ActionConstraints;
  * @param actionId
  */
 export declare function SlackAction(actionId: ActionId): MethodDecorator;
+/**
+ * Arguments for the slack view handler
+ */
+export type SlackViewArgs = EndpointArgs<SlackViewMiddlewareArgs>;
+/**
+ * View id
+ */
 export type ViewId = Pattern | ViewConstraints;
 /**
  * Decorator for view events
@@ -53,6 +84,13 @@ export type ViewId = Pattern | ViewConstraints;
  * @param viewId
  */
 export declare function SlackView(viewId: ViewId): MethodDecorator;
+/**
+ * Arguments for the slack option handler
+ */
+export type SlackOptionArgs = EndpointArgs<SlackOptionsMiddlewareArgs>;
+/**
+ * Options id
+ */
 export type OptionId = OptionsConstraints;
 /**
  * Decorator for options events
@@ -60,6 +98,7 @@ export type OptionId = OptionsConstraints;
  * @param optionId
  */
 export declare function SlackOption(optionId: OptionId): MethodDecorator;
+export type SlackMessageArgs = EndpointArgs<SlackEventMiddlewareArgs<"message">>;
 /**
  * Decorator for message events
  *

package/decorators.js

@@ -15,12 +15,13 @@ const utils_1 = require("./utils");
  * @see https://tools.slack.dev/bolt-js/reference/
  */
 exports.EventTypes = {
-    Event: 'event',
-    Shortcut: 'shortcut',
-    Command: 'command',
-    Action: 'action',
-    View: 'view',
-    Option: 'option',
+    Event: "event",
+    Shortcut: "shortcut",
+    Command: "command",
+    Action: "action",
+    View: "view",
+    Option: "option",
+    Message: "message",
 };
 /**
  * Decorator for Slack controller
@@ -88,6 +89,6 @@ function SlackOption(optionId) {
  * @see reference https://api.slack.com/events/message
  * @param pattern
  */
-function SlackMessage(pattern = '*') {
-    return (0, utils_1.messageDecorator)('message', pattern);
+function SlackMessage(pattern = "*") {
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Message, pattern);
 }

package/license

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2025 to Ziv Perry.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to delal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpr/nestjs-slack",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "NestJS server implementation of the Slack Assistant",
   "main": "index.js",
   "scripts": {
@@ -42,7 +42,8 @@
   "files": [
     "*.js",
     "*.d.ts",
-    "readme.md"
+    "readme.md",
+    "license"
   ],
   "release": {
     "extends": "semantic-release-monorepo",

package/readme.md

@@ -1,6 +1,7 @@
 # @xpr/nestjs-slack
 
-A NestJS microservice transport and decorators for [Slack Bolt Apps](https://github.com/slackapi/bolt-js).
+A NestJS microservice transport and decorators for
+[Slack Bolt Apps](https://github.com/slackapi/bolt-js).
 
 ### Usage
 
@@ -31,27 +32,22 @@ await app.listen();
 Example of a Slack controller with listener for action and a command.
 
 ```ts
-import {
-  SlackAction,
-  SlackCommand,
-  SlackController,
-} from '@xpr/nestjs-slack';
+import { SlackAction, SlackCommand, SlackController } from "@xpr/nestjs-slack";
 
 @SlackController()
 export class MyController {
-
-  @SlackAction('button-action')
+  @SlackAction("button-action")
   async onAction({ ack, respond, payload }: SlackActionMiddlewareArgs) {
     await ack();
     await respond(`Button clicked! with payload ${JSON.stringify(payload)}`);
   }
 
-  @SlackCommand('/ping')
+  @SlackCommand("/ping")
   async onPing({ ack, respond }: SlackCommandMiddlewareArgs) {
     await ack();
     await respond({
-      text: 'pong!',
-      response_type: 'in_channel',
+      text: "pong!",
+      response_type: "in_channel",
     });
   }
 }
@@ -63,4 +59,4 @@ export class MyController {
 
 ## Decorators
 
-See [source file](./decorators.ts).
+See [source file](./decorators.ts).

package/slack.d.ts

@@ -1,5 +1,5 @@
-import { type CustomTransportStrategy, type MessageHandler, Server } from '@nestjs/microservices';
-import { App, type AppOptions } from '@slack/bolt';
+import { type CustomTransportStrategy, type MessageHandler, Server } from "@nestjs/microservices";
+import { App, type AppOptions } from "@slack/bolt";
 export type SlackOptions = {
     /**
      * Slack application options with required types

package/slack.js

@@ -22,7 +22,7 @@ class Slack extends microservices_1.Server {
         this.#app && (await this.#app.stop());
     }
     on() {
-        throw new Error('Use SlackEvent decorator to register events');
+        throw new Error("Use SlackEvent decorator to register events");
     }
     unwrap() {
         return this.#app;
@@ -35,6 +35,9 @@ class Slack extends microservices_1.Server {
     register(handler) {
         const { type, event } = handler.extras;
         switch (type) {
+            case decorators_1.EventTypes.Message:
+                this.app().message(event, handler);
+                break;
             case decorators_1.EventTypes.Shortcut:
                 this.app().shortcut(event, handler);
                 break;
@@ -42,7 +45,6 @@ class Slack extends microservices_1.Server {
                 this.app().action(event, handler);
                 break;
             case decorators_1.EventTypes.Event:
-                // todo improve by providing types for events names
                 this.app().event(event, handler);
                 break;
             case decorators_1.EventTypes.Command:
@@ -67,7 +69,7 @@ class Slack extends microservices_1.Server {
                 this.options.slack.logger = (0, utils_1.adjustLogger)(this.logger);
             }
             this.#app = new bolt_1.App(this.options.slack);
-            this.logger.log('Bolt app created');
+            this.logger.log("Bolt app created");
         }
         return this.#app;
     }

package/utils.d.ts

@@ -1,4 +1,4 @@
-import { type Logger } from '@slack/bolt';
+import { type Logger } from "@slack/bolt";
 export type Pattern = string | RegExp;
 /**
  * Create method decorator

package/utils.js

@@ -6,7 +6,7 @@ exports.adjustLogger = adjustLogger;
 const microservices_1 = require("@nestjs/microservices");
 const bolt_1 = require("@slack/bolt");
 const normalizePattern = (pattern) => {
-    if (typeof pattern === 'string') {
+    if (typeof pattern === "string") {
         return pattern;
     }
     if (pattern instanceof RegExp) {
@@ -39,29 +39,29 @@ function messageDecorator(type, pattern) {
 function adjustLogger(logger) {
     // this patch required to support NestJS logger that not use the standard "info"
     // and use "log" instead
-    if (logger['log'] && !logger['info']) {
-        logger['info'] = logger['log'].bind(logger);
+    if (logger["log"] && !logger["info"]) {
+        logger["info"] = logger["log"].bind(logger);
     }
     // minimal logger interface required by @slack/bolt library
-    for (const method of ['debug', 'info', 'warn', 'error']) {
-        if (typeof logger[method] !== 'function') {
+    for (const method of ["debug", "info", "warn", "error"]) {
+        if (typeof logger[method] !== "function") {
             throw new Error(`Logger must implement "${method}" method`);
         }
     }
     // add compatibility with @slack/bolt library
-    if (!logger['setLevel']) {
+    if (!logger["setLevel"]) {
         logger.setLevel = () => {
             // don't allow library to set the level
         };
     }
-    if (!logger['getLevel']) {
+    if (!logger["getLevel"]) {
         logger.getLevel = () => {
             // always return the lowest supported level (by library, not real logger)
             // to avoid filtering log messages by library instead of real logger
             return bolt_1.LogLevel.DEBUG;
         };
     }
-    if (!logger['setName']) {
+    if (!logger["setName"]) {
         logger.setName = (name) => {
             // search for all possible setName/setContext methods, use "noop" if none
             (logger.setName ?? logger.setContext ?? ((i) => i))(name);