@xpr/nestjs-slack 0.0.1 → 0.2.0

package/decorators.d.ts

@@ -1,10 +1,6 @@
-import { ActionConstraints, OptionsConstraints, ShortcutConstraints, ViewConstraints } from '@slack/bolt';
-export type Pattern = string | RegExp;
-export type ShortCutId = Pattern | ShortcutConstraints;
-export type ActionId = Pattern | ActionConstraints;
-export type ViewId = Pattern | ViewConstraints;
-export type OptionId = OptionsConstraints;
-export type AllConstraints = Pattern | ActionConstraints | ShortcutConstraints | ViewConstraints | OptionsConstraints;
+import { ActionConstraints, OptionsConstraints, ShortcutConstraints, ViewConstraints } from "@slack/bolt";
+import { type Pattern } from "./utils";
+export { Pattern };
 /**
  * @see https://tools.slack.dev/bolt-js/reference/
  */
@@ -24,6 +20,7 @@ export declare const EventTypes: {
  * @constructor
  */
 export declare function SlackEvent(event: string): MethodDecorator;
+export type ShortCutId = Pattern | ShortcutConstraints;
 /**
  * Decorator for shortcut events
  * @see guide https://tools.slack.dev/bolt-js/concepts/shortcuts
@@ -40,6 +37,7 @@ export declare function SlackShortcut(shortcutId: ShortCutId): MethodDecorator;
  * @constructor
  */
 export declare function SlackCommand(commandId: Pattern): MethodDecorator;
+export type ActionId = Pattern | ActionConstraints;
 /**
  * Decorator for action events
  * @see guide https://tools.slack.dev/bolt-js/concepts/actions
@@ -47,6 +45,7 @@ export declare function SlackCommand(commandId: Pattern): MethodDecorator;
  * @constructor
  */
 export declare function SlackAction(actionId: ActionId): MethodDecorator;
+export type ViewId = Pattern | ViewConstraints;
 /**
  * Decorator for view events
  * @see guide https://tools.slack.dev/bolt-js/concepts/view-submissions
@@ -54,6 +53,7 @@ export declare function SlackAction(actionId: ActionId): MethodDecorator;
  * @constructor
  */
 export declare function SlackView(viewId: ViewId): MethodDecorator;
+export type OptionId = OptionsConstraints;
 /**
  * Decorator for options events
  * @see guide https://tools.slack.dev/bolt-js/concepts/options
@@ -69,4 +69,4 @@ export declare function SlackOption(optionId: OptionId): MethodDecorator;
  * @param pattern
  * @constructor
  */
-export declare function SlackMessage(pattern?: string | RegExp): MethodDecorator;
+export declare function SlackMessage(pattern?: Pattern): MethodDecorator;

package/decorators.js

@@ -8,37 +8,17 @@ exports.SlackAction = SlackAction;
 exports.SlackView = SlackView;
 exports.SlackOption = SlackOption;
 exports.SlackMessage = SlackMessage;
-const microservices_1 = require("@nestjs/microservices");
-const normalizePattern = (pattern) => {
-    if (typeof pattern === 'string') {
-        return pattern;
-    }
-    if (pattern instanceof RegExp) {
-        return pattern.toString();
-    }
-    return JSON.stringify(pattern);
-};
-/**
- * Create method decorator
- * @param type type of listener
- * @param event how to identify the event
- */
-function eventDecorator(type, event) {
-    return (target, key, descriptor) => (0, microservices_1.EventPattern)(`${type}://${normalizePattern(event)}`, {
-        type,
-        event,
-    })(target, key, descriptor);
-}
+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",
 };
 /**
  * Decorator for event events
@@ -49,10 +29,7 @@ exports.EventTypes = {
  */
 function SlackEvent(event) {
     // todo input validation (types for event)
-    return (target, key, descriptor) => (0, microservices_1.EventPattern)(`${exports.EventTypes.Event}://${normalizePattern(event)}`, {
-        type: exports.EventTypes.Event,
-        event,
-    })(target, key, descriptor);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Event, event);
 }
 /**
  * Decorator for shortcut events
@@ -62,7 +39,7 @@ function SlackEvent(event) {
  * @constructor
  */
 function SlackShortcut(shortcutId) {
-    return eventDecorator(exports.EventTypes.Shortcut, shortcutId);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Shortcut, shortcutId);
 }
 /**
  * Decorator for command events
@@ -73,7 +50,7 @@ function SlackShortcut(shortcutId) {
  */
 function SlackCommand(commandId) {
     // todo input validation command must start with / etc.
-    return eventDecorator(exports.EventTypes.Command, commandId);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Command, commandId);
 }
 /**
  * Decorator for action events
@@ -82,7 +59,7 @@ function SlackCommand(commandId) {
  * @constructor
  */
 function SlackAction(actionId) {
-    return eventDecorator(exports.EventTypes.Action, actionId);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Action, actionId);
 }
 /**
  * Decorator for view events
@@ -91,7 +68,7 @@ function SlackAction(actionId) {
  * @constructor
  */
 function SlackView(viewId) {
-    return eventDecorator(exports.EventTypes.View, viewId);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.View, viewId);
 }
 /**
  * Decorator for options events
@@ -100,7 +77,7 @@ function SlackView(viewId) {
  * @constructor
  */
 function SlackOption(optionId) {
-    return eventDecorator(exports.EventTypes.Option, optionId);
+    return (0, utils_1.eventDecorator)(exports.EventTypes.Option, optionId);
 }
 /**
  * Decorator for message events
@@ -110,11 +87,6 @@ function SlackOption(optionId) {
  * @param pattern
  * @constructor
  */
-function SlackMessage(pattern = '*') {
-    return (target, key, descriptor) => {
-        return (0, microservices_1.MessagePattern)(`message://${normalizePattern(pattern)}`, {
-            type: 'message',
-            pattern,
-        })(target, key, descriptor);
-    };
+function SlackMessage(pattern = "*") {
+    return (0, utils_1.messageDecorator)("message", pattern);
 }

package/index.d.ts

@@ -1,3 +1,3 @@
-import Slack from './slack';
-export * from './decorators';
+import Slack from "./slack";
+export * from "./decorators";
 export { Slack };

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@xpr/nestjs-slack",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "NestJS server implementation of the Slack Assistant",
   "main": "index.js",
   "scripts": {
-    "build": "tsc -p tsconfig.json && cp package.json ../../dist/nestjs-slack/. && cp readme.md ../../dist/nestjs-slack/."
+    "build": "tsc -p tsconfig-lib.json",
+    "postbuild": "cp package.json ../../dist/nestjs-slack/. && cp readme.md ../../dist/nestjs-slack/."
   },
   "author": "Ziv Perry",
   "license": "MIT",

package/slack.d.ts

@@ -1,6 +1,6 @@
-import { type CustomTransportStrategy, type MessageHandler, Server } from '@nestjs/microservices';
-import { App, type AppOptions } from '@slack/bolt';
-export type SlackAssistantOptions = {
+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
      * @see https://github.com/slackapi/bolt-js
@@ -9,8 +9,8 @@ export type SlackAssistantOptions = {
 };
 export default class Slack extends Server implements CustomTransportStrategy {
     #private;
-    readonly options: SlackAssistantOptions;
-    constructor(options: SlackAssistantOptions);
+    readonly options: SlackOptions;
+    constructor(options: SlackOptions);
     listen(callback: () => void): Promise<void>;
     close(): Promise<void>;
     on(): void;
@@ -22,7 +22,7 @@ export default class Slack extends Server implements CustomTransportStrategy {
      */
     protected register(handler: MessageHandler): void;
     /**
-     * Get the Bolt app instance
+     * Get/Create Bolt app instance
      * @protected
      */
     protected app(): App;

package/slack.js

@@ -13,20 +13,20 @@ class Slack extends microservices_1.Server {
     async listen(callback) {
         for (const handler of this.getHandlers().values()) {
             this.register(handler);
+            const { type, event } = handler.extras;
+            this.logger.log(`Handler [${type}] registered with (${event})`);
         }
         await this.app().start();
         callback();
     }
     async close() {
-        // this.#app && (await this.#app.stop());
+        this.#app && (await this.#app.stop());
     }
-    // todo web-client/WebClient events for better typing of the event argument
     on() {
-        throw new Error('Use SlackEvent decorator to register events');
+        throw new Error("Use SlackEvent decorator to register events");
     }
     unwrap() {
-        // return this.#app as T;
-        throw new Error('Use SlackEvent decorator to register events');
+        return this.#app;
     }
     /**
      * Register the handler for the event
@@ -50,13 +50,13 @@ class Slack extends microservices_1.Server {
         }
     }
     /**
-     * Get the Bolt app instance
+     * Get/Create Bolt app instance
      * @protected
      */
     app() {
         if (!this.#app) {
             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

@@ -0,0 +1,13 @@
+export type Pattern = string | RegExp;
+/**
+ * Create method decorator
+ * @param type type of listener
+ * @param event how to identify the event
+ */
+export declare function eventDecorator<T>(type: string, event: T): MethodDecorator;
+/**
+ * Create method decorator
+ * @param type type of listener
+ * @param pattern how to identify the message
+ */
+export declare function messageDecorator(type: string, pattern: Pattern): MethodDecorator;

package/utils.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eventDecorator = eventDecorator;
+exports.messageDecorator = messageDecorator;
+const microservices_1 = require("@nestjs/microservices");
+const normalizePattern = (pattern) => {
+    if (typeof pattern === "string") {
+        return pattern;
+    }
+    if (pattern instanceof RegExp) {
+        return pattern.toString();
+    }
+    return JSON.stringify(pattern);
+};
+/**
+ * Create method decorator
+ * @param type type of listener
+ * @param event how to identify the event
+ */
+function eventDecorator(type, event) {
+    return (target, key, descriptor) => (0, microservices_1.EventPattern)(`${type}://${normalizePattern(event)}`, {
+        type,
+        event,
+    })(target, key, descriptor);
+}
+/**
+ * Create method decorator
+ * @param type type of listener
+ * @param pattern how to identify the message
+ */
+function messageDecorator(type, pattern) {
+    return (target, key, descriptor) => (0, microservices_1.MessagePattern)(`${type}://${normalizePattern(pattern)}`, {
+        type,
+        pattern,
+    })(target, key, descriptor);
+}