@slack/bolt 3.6.0 → 3.9.0-hermesBeta.2

package/dist/App.js

@@ -11,14 +11,23 @@ const axios_1 = __importDefault(require("axios"));
 const SocketModeReceiver_1 = __importDefault(require("./receivers/SocketModeReceiver"));
 const HTTPReceiver_1 = __importDefault(require("./receivers/HTTPReceiver"));
 const builtin_1 = require("./middleware/builtin");
-const process_1 = require("./middleware/process");
+const process_1 = __importDefault(require("./middleware/process"));
 const conversation_store_1 = require("./conversation-store");
+const Subscription_1 = require("./Subscription");
 const helpers_1 = require("./helpers");
 const errors_1 = require("./errors");
+const middleware_1 = require("./types/middleware");
 // eslint-disable-next-line import/order
 const allSettled = require("promise.allsettled"); // eslint-disable-line @typescript-eslint/no-require-imports
-// eslint-disable-next-line @typescript-eslint/no-require-imports
+// eslint-disable-next-line @typescript-eslint/no-require-imports, import/no-commonjs
 const packageJson = require('../package.json'); // eslint-disable-line @typescript-eslint/no-var-requires
+// ----------------------------
+// For listener registration methods
+const validViewTypes = ['view_closed', 'view_submission'];
+// ----------------------------
+// For the constructor
+const tokenUsage = 'Apps used in a single workspace can be initialized with a token. Apps used in many workspaces ' +
+    'should be initialized with oauth installer options or authorize.';
 var logger_2 = require("@slack/logger");
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_2.LogLevel; } });
 class WebClientPool {
@@ -39,10 +48,11 @@ class WebClientPool {
  * A Slack App
  */
 class App {
-    constructor({ signingSecret = undefined, endpoints = undefined, agent = undefined, clientTls = undefined, receiver = undefined, convoStore = undefined, token = undefined, appToken = undefined, botId = undefined, botUserId = undefined, authorize = undefined, logger = undefined, logLevel = undefined, ignoreSelf = true, clientOptions = undefined, processBeforeResponse = false, clientId = undefined, clientSecret = undefined, stateSecret = undefined, installationStore = undefined, scopes = undefined, installerOptions = undefined, socketMode = undefined, developerMode = false, tokenVerificationEnabled = true, } = {}) {
+    constructor({ signingSecret = undefined, endpoints = undefined, port = undefined, customRoutes = undefined, agent = undefined, clientTls = undefined, receiver = undefined, convoStore = undefined, token = undefined, appToken = undefined, botId = undefined, botUserId = undefined, authorize = undefined, logger = undefined, logLevel = undefined, ignoreSelf = true, clientOptions = undefined, processBeforeResponse = false, signatureVerification = true, clientId = undefined, clientSecret = undefined, stateSecret = undefined, redirectUri = undefined, installationStore = undefined, scopes = undefined, installerOptions = undefined, socketMode = undefined, developerMode = false, tokenVerificationEnabled = true, extendedErrorHandler = false, } = {}) {
+        // this.logLevel = logLevel;
         // Some payloads don't have teamId anymore. So we use EnterpriseId in those scenarios
         this.clients = {};
-        // this.logLevel = logLevel;
+        /* ------------------------ Developer mode ----------------------------- */
         this.developerMode = developerMode;
         if (developerMode) {
             // Set logLevel to Debug in Developer Mode if one wasn't passed in
@@ -56,6 +66,7 @@ class App {
             // Set logLevel to Info if one wasn't passed in
             this.logLevel = logLevel !== null && logLevel !== void 0 ? logLevel : logger_1.LogLevel.INFO;
         }
+        /* ------------------------ Set logger ----------------------------- */
         if (typeof logger === 'undefined') {
             // Initialize with the default logger
             const consoleLogger = new logger_1.ConsoleLogger();
@@ -68,7 +79,11 @@ class App {
         if (typeof this.logLevel !== 'undefined' && this.logger.getLevel() !== this.logLevel) {
             this.logger.setLevel(this.logLevel);
         }
+        // Error-related properties used to later determine args passed into the error handler
+        this.hasCustomErrorHandler = false;
         this.errorHandler = defaultErrorHandler(this.logger);
+        this.extendedErrorHandler = extendedErrorHandler;
+        /* ------------------------ Set client options ------------------------*/
         this.clientOptions = clientOptions !== undefined ? clientOptions : {};
         if (agent !== undefined && this.clientOptions.agent === undefined) {
             this.clientOptions.agent = agent;
@@ -81,11 +96,7 @@ class App {
             this.clientOptions.logLevel = logLevel;
         }
         else {
-            if (logLevel !== undefined) {
-                // If the constructor has both, logLevel is ignored
-                this.logger.warn("As `logger` is passed as well, `logLevel` argument won't be used. Set the log level to the `logger` instance instead.");
-            }
-            // Since v3.4, WebClient starts sharing loggger with App
+            // Since v3.4, WebClient starts sharing logger with App
             this.clientOptions.logger = this.logger;
         }
         // The public WebClient instance (app.client)
@@ -108,6 +119,11 @@ class App {
             clientOptions: this.clientOptions,
             ...installerOptions,
         };
+        if (socketMode && port !== undefined && this.installerOptions.port === undefined) {
+            // SocketModeReceiver only uses a custom port number  when listening for the OAuth flow.
+            // Therefore only installerOptions.port is available in the constructor arguments.
+            this.installerOptions.port = port;
+        }
         if (this.developerMode &&
             this.installerOptions &&
             (typeof this.installerOptions.callbackOptions === 'undefined' ||
@@ -123,43 +139,54 @@ class App {
                 },
             };
         }
-        // Check for required arguments of HTTPReceiver
+        /* --------------------- Initialize receiver ---------------------- */
         if (receiver !== undefined) {
+            // Custom receiver supplied
+            if (this.socketMode === true) {
+                // socketMode = true should result in SocketModeReceiver being used as receiver
+                // TODO: Add case for when socketMode = true and receiver = SocketModeReceiver
+                // as this should not result in an error
+                throw new errors_1.AppInitializationError('You cannot supply a custom receiver when socketMode is set to true.');
+            }
             this.receiver = receiver;
         }
-        else if (this.socketMode) {
+        else if (this.socketMode === true) {
             if (appToken === undefined) {
-                throw new errors_1.AppInitializationError('You must provide an appToken when using Socket Mode');
+                throw new errors_1.AppInitializationError('You must provide an appToken when socketMode is set to true. To generate an appToken see: https://api.slack.com/apis/connections/socket#token');
             }
             this.logger.debug('Initializing SocketModeReceiver');
-            // Create default SocketModeReceiver
             this.receiver = new SocketModeReceiver_1.default({
                 appToken,
                 clientId,
                 clientSecret,
                 stateSecret,
+                redirectUri,
                 installationStore,
                 scopes,
                 logger,
                 logLevel: this.logLevel,
                 installerOptions: this.installerOptions,
+                customRoutes,
             });
         }
-        else if (signingSecret === undefined) {
-            // No custom receiver
-            throw new errors_1.AppInitializationError('Signing secret not found, so could not initialize the default receiver. Set a signing secret or use a ' +
-                'custom receiver.');
+        else if (signatureVerification === true && signingSecret === undefined) {
+            // Using default receiver HTTPReceiver, signature verification enabled, missing signingSecret
+            throw new errors_1.AppInitializationError('signingSecret is required to initialize the default receiver. Set signingSecret or use a ' +
+                'custom receiver. You can find your Signing Secret in your Slack App Settings.');
         }
         else {
             this.logger.debug('Initializing HTTPReceiver');
-            // Create default HTTPReceiver
             this.receiver = new HTTPReceiver_1.default({
-                signingSecret,
+                signingSecret: signingSecret || '',
                 endpoints,
+                port,
+                customRoutes,
                 processBeforeResponse,
+                signatureVerification,
                 clientId,
                 clientSecret,
                 stateSecret,
+                redirectUri,
                 installationStore,
                 scopes,
                 logger,
@@ -167,16 +194,19 @@ class App {
                 installerOptions: this.installerOptions,
             });
         }
+        /* ------------------------ Set authorize ----------------------------- */
         let usingOauth = false;
-        if (this.receiver.installer !== undefined &&
-            this.receiver.installer.authorize !== undefined) {
+        const httpReceiver = this.receiver;
+        if (httpReceiver.installer !== undefined &&
+            httpReceiver.installer.authorize !== undefined) {
             // This supports using the built in HTTPReceiver, declaring your own HTTPReceiver
             // and theoretically, doing a fully custom (non express) receiver that implements OAuth
             usingOauth = true;
         }
         if (token !== undefined) {
-            if (authorize !== undefined || usingOauth) {
-                throw new errors_1.AppInitializationError(`token as well as authorize or oauth installer options were provided. ${tokenUsage}`);
+            // If a token is supplied, the app is installed in at least one workspace
+            if (usingOauth || authorize !== undefined) {
+                throw new errors_1.AppInitializationError(`You cannot provide a token along with either oauth installer options or authorize. ${tokenUsage}`);
             }
             this.authorize = singleAuthorization(this.client, {
                 botId,
@@ -185,31 +215,33 @@ class App {
             }, tokenVerificationEnabled);
         }
         else if (authorize === undefined && !usingOauth) {
-            throw new errors_1.AppInitializationError(`No token, no authorize, and no oauth installer options provided. ${tokenUsage}`);
+            throw new errors_1.AppInitializationError(`${tokenUsage} \n\nSince you have not provided a token or authorize, you might be missing one or more required oauth installer options. See https://slack.dev/bolt-js/concepts#authenticating-oauth for these required fields.\n`);
         }
         else if (authorize !== undefined && usingOauth) {
-            throw new errors_1.AppInitializationError(`Both authorize options and oauth installer options provided. ${tokenUsage}`);
+            throw new errors_1.AppInitializationError(`You cannot provide both authorize and oauth installer options. ${tokenUsage}`);
         }
         else if (authorize === undefined && usingOauth) {
-            this.authorize = this.receiver.installer.authorize;
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            this.authorize = httpReceiver.installer.authorize;
         }
         else if (authorize !== undefined && !usingOauth) {
             this.authorize = authorize;
         }
         else {
-            this.logger.error('Never should have reached this point, please report to the team');
-            helpers_1.assertNever();
+            this.logger.error('Something has gone wrong. Please report this issue to the maintainers. https://github.com/slackapi/bolt-js/issues');
+            (0, helpers_1.assertNever)();
         }
         // Conditionally use a global middleware that ignores events (including messages) that are sent from this app
         if (ignoreSelf) {
-            this.use(builtin_1.ignoreSelf());
+            this.use((0, builtin_1.ignoreSelf)());
         }
         // Use conversation state global middleware
         if (convoStore !== false) {
             // Use the memory store by default, or another store if provided
             const store = convoStore === undefined ? new conversation_store_1.MemoryStore() : convoStore;
-            this.use(conversation_store_1.conversationContext(store));
+            this.use((0, conversation_store_1.conversationContext)(store));
         }
+        /* ------------------------ Initialize receiver ------------------------ */
         // Should be last to avoid exposing partially initialized app
         this.receiver.init(this);
     }
@@ -243,9 +275,26 @@ class App {
         // TODO: HTTPReceiver['start'] should be the actual receiver's return type
         return this.receiver.start(...args);
     }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     stop(...args) {
         return this.receiver.stop(...args);
     }
+    /**
+     * Register subcription middleware
+     *
+     * @param listeners middleware that process and react to subscription payloads
+     */
+    subscription(options) {
+        /*
+         * TODO If it becomes possible for users to set a custom unique resource id,
+         * custom id should be supplied in place of the default.
+         * */
+        const defaultId = 'DEFAULTID';
+        const s = new Subscription_1.Subscription(defaultId, options);
+        const m = s.getMiddleware();
+        this.middleware.push(m);
+        return this;
+    }
     event(eventNameOrPattern, ...listeners) {
         let invalidEventName = false;
         if (typeof eventNameOrPattern === 'string') {
@@ -263,27 +312,27 @@ class App {
         }
         this.listeners.push([
             builtin_1.onlyEvents,
-            builtin_1.matchEventType(eventNameOrPattern),
+            (0, builtin_1.matchEventType)(eventNameOrPattern),
             ...listeners,
         ]);
     }
     message(...patternsOrMiddleware) {
         const messageMiddleware = patternsOrMiddleware.map((patternOrMiddleware) => {
             if (typeof patternOrMiddleware === 'string' || util_1.default.types.isRegExp(patternOrMiddleware)) {
-                return builtin_1.matchMessage(patternOrMiddleware);
+                return (0, builtin_1.matchMessage)(patternOrMiddleware);
             }
             return patternOrMiddleware;
         });
         this.listeners.push([
             builtin_1.onlyEvents,
-            builtin_1.matchEventType('message'),
+            (0, builtin_1.matchEventType)('message'),
             ...messageMiddleware,
         ]);
     }
     shortcut(callbackIdOrConstraints, ...listeners) {
-        const constraints = typeof callbackIdOrConstraints === 'string' || util_1.default.types.isRegExp(callbackIdOrConstraints)
-            ? { callback_id: callbackIdOrConstraints }
-            : callbackIdOrConstraints;
+        const constraints = typeof callbackIdOrConstraints === 'string' || util_1.default.types.isRegExp(callbackIdOrConstraints) ?
+            { callback_id: callbackIdOrConstraints } :
+            callbackIdOrConstraints;
         // Fail early if the constraints contain invalid keys
         const unknownConstraintKeys = Object.keys(constraints).filter((k) => k !== 'callback_id' && k !== 'type');
         if (unknownConstraintKeys.length > 0) {
@@ -292,37 +341,37 @@ class App {
         }
         this.listeners.push([
             builtin_1.onlyShortcuts,
-            builtin_1.matchConstraints(constraints),
+            (0, builtin_1.matchConstraints)(constraints),
             ...listeners,
         ]);
     }
     action(actionIdOrConstraints, ...listeners) {
         // Normalize Constraints
-        const constraints = typeof actionIdOrConstraints === 'string' || util_1.default.types.isRegExp(actionIdOrConstraints)
-            ? { action_id: actionIdOrConstraints }
-            : actionIdOrConstraints;
+        const constraints = typeof actionIdOrConstraints === 'string' || util_1.default.types.isRegExp(actionIdOrConstraints) ?
+            { action_id: actionIdOrConstraints } :
+            actionIdOrConstraints;
         // Fail early if the constraints contain invalid keys
         const unknownConstraintKeys = Object.keys(constraints).filter((k) => k !== 'action_id' && k !== 'block_id' && k !== 'callback_id' && k !== 'type');
         if (unknownConstraintKeys.length > 0) {
             this.logger.error(`Action listener cannot be attached using unknown constraint keys: ${unknownConstraintKeys.join(', ')}`);
             return;
         }
-        this.listeners.push([builtin_1.onlyActions, builtin_1.matchConstraints(constraints), ...listeners]);
+        this.listeners.push([builtin_1.onlyActions, (0, builtin_1.matchConstraints)(constraints), ...listeners]);
     }
     command(commandName, ...listeners) {
-        this.listeners.push([builtin_1.onlyCommands, builtin_1.matchCommandName(commandName), ...listeners]);
+        this.listeners.push([builtin_1.onlyCommands, (0, builtin_1.matchCommandName)(commandName), ...listeners]);
     }
     // TODO: reflect the type in constraits to Source
     options(actionIdOrConstraints, ...listeners) {
-        const constraints = typeof actionIdOrConstraints === 'string' || util_1.default.types.isRegExp(actionIdOrConstraints)
-            ? { action_id: actionIdOrConstraints }
-            : actionIdOrConstraints;
-        this.listeners.push([builtin_1.onlyOptions, builtin_1.matchConstraints(constraints), ...listeners]);
+        const constraints = typeof actionIdOrConstraints === 'string' || util_1.default.types.isRegExp(actionIdOrConstraints) ?
+            { action_id: actionIdOrConstraints } :
+            actionIdOrConstraints;
+        this.listeners.push([builtin_1.onlyOptions, (0, builtin_1.matchConstraints)(constraints), ...listeners]);
     }
     view(callbackIdOrConstraints, ...listeners) {
-        const constraints = typeof callbackIdOrConstraints === 'string' || util_1.default.types.isRegExp(callbackIdOrConstraints)
-            ? { callback_id: callbackIdOrConstraints, type: 'view_submission' }
-            : callbackIdOrConstraints;
+        const constraints = typeof callbackIdOrConstraints === 'string' || util_1.default.types.isRegExp(callbackIdOrConstraints) ?
+            { callback_id: callbackIdOrConstraints, type: 'view_submission' } :
+            callbackIdOrConstraints;
         // Fail early if the constraints contain invalid keys
         const unknownConstraintKeys = Object.keys(constraints).filter((k) => k !== 'callback_id' && k !== 'type');
         if (unknownConstraintKeys.length > 0) {
@@ -335,12 +384,13 @@ class App {
         }
         this.listeners.push([
             builtin_1.onlyViewActions,
-            builtin_1.matchConstraints(constraints),
+            (0, builtin_1.matchConstraints)(constraints),
             ...listeners,
         ]);
     }
     error(errorHandler) {
         this.errorHandler = errorHandler;
+        this.hasCustomErrorHandler = true;
     }
     /**
      * Handles events from the receiver
@@ -356,7 +406,7 @@ class App {
         // or even all of the args, as properties of the error. This would give error handling code some ability to deal
         // with "finally" type error situations.
         // Introspect the body to determine what type of incoming event is being handled, and any channel context
-        const { type, conversationId } = helpers_1.getTypeAndConversation(body);
+        const { type, conversationId } = (0, helpers_1.getTypeAndConversation)(body);
         // If the type could not be determined, warn and exit
         if (type === undefined) {
             this.logger.warn('Could not determine the type of an incoming event. No listeners will be called.');
@@ -377,9 +427,18 @@ class App {
             }
         }
         catch (error) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const e = error;
             this.logger.warn('Authorization of incoming event did not succeed. No listeners will be called.');
-            error.code = 'slack_bolt_authorization_error';
-            return this.handleError(error);
+            e.code = errors_1.ErrorCode.AuthorizationError;
+            // disabling due to https://github.com/typescript-eslint/typescript-eslint/issues/1277
+            // eslint-disable-next-line consistent-return
+            return this.handleError({
+                error: e,
+                logger: this.logger,
+                body: bodyArg,
+                context: {},
+            });
         }
         // Try to set teamId from AuthorizeResult before using one from source
         if (authorizeResult.teamId === undefined && source.teamId !== undefined) {
@@ -389,32 +448,60 @@ class App {
         if (authorizeResult.enterpriseId === undefined && source.enterpriseId !== undefined) {
             authorizeResult.enterpriseId = source.enterpriseId;
         }
-        const context = { ...authorizeResult };
+        if (typeof event.customProperties !== 'undefined') {
+            const customProps = event.customProperties;
+            const builtinKeyDetected = middleware_1.contextBuiltinKeys.find((key) => key in customProps);
+            if (typeof builtinKeyDetected !== 'undefined') {
+                throw new errors_1.InvalidCustomPropertyError('customProperties cannot have the same names with the built-in ones');
+            }
+        }
+        const context = {
+            ...authorizeResult,
+            ...event.customProperties,
+            retryNum: event.retryNum,
+            retryReason: event.retryReason,
+        };
         // Factory for say() utility
         const createSay = (channelId) => {
             const token = selectToken(context);
             return (message) => {
-                const postMessageArguments = typeof message === 'string'
-                    ? { token, text: message, channel: channelId }
-                    : { ...message, token, channel: channelId };
+                const postMessageArguments = typeof message === 'string' ?
+                    { token, text: message, channel: channelId } :
+                    { ...message, token, channel: channelId };
                 return this.client.chat.postMessage(postMessageArguments);
             };
         };
-        // Set body and payload (this value will eventually conform to AnyMiddlewareArgs)
+        // Set body and payload
+        // TODO: this value should eventually conform to AnyMiddlewareArgs
+        let payload;
+        switch (type) {
+            case helpers_1.IncomingEventType.Event:
+                payload = bodyArg.event;
+                break;
+            case helpers_1.IncomingEventType.ViewAction:
+                payload = bodyArg.view;
+                break;
+            case helpers_1.IncomingEventType.Shortcut:
+                payload = bodyArg;
+                break;
+            // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+            // @ts-ignore: Fallthrough case in switch
+            case helpers_1.IncomingEventType.Action:
+                if (isBlockActionOrInteractiveMessageBody(bodyArg)) {
+                    const { actions } = bodyArg;
+                    [payload] = actions;
+                    break;
+                }
+            // If above conditional does not hit, fall through to fallback payload in default block below
+            default:
+                payload = bodyArg;
+                break;
+        }
         // NOTE: the following doesn't work because... distributive?
         // const listenerArgs: Partial<AnyMiddlewareArgs> = {
         const listenerArgs = {
             body: bodyArg,
-            payload: type === helpers_1.IncomingEventType.Event
-                ? bodyArg.event
-                : type === helpers_1.IncomingEventType.ViewAction
-                    ? bodyArg.view
-                    : type === helpers_1.IncomingEventType.Shortcut
-                        ? bodyArg
-                        : type === helpers_1.IncomingEventType.Action &&
-                            isBlockActionOrInteractiveMessageBody(bodyArg)
-                            ? bodyArg.actions[0]
-                            : bodyArg,
+            payload,
         };
         // Set aliases
         if (type === helpers_1.IncomingEventType.Event) {
@@ -493,7 +580,7 @@ class App {
         }
         // Dispatch event through the global middleware chain
         try {
-            await process_1.processMiddleware(this.middleware, listenerArgs, context, client, this.logger, async () => {
+            await (0, process_1.default)(this.middleware, listenerArgs, context, client, this.logger, async () => {
                 // Dispatch the event through the listener middleware chains and aggregate their results
                 // TODO: change the name of this.middleware and this.listeners to help this make more sense
                 const listenerResults = this.listeners.map(async (origListenerMiddleware) => {
@@ -501,11 +588,19 @@ class App {
                     const listenerMiddleware = [...origListenerMiddleware];
                     // Don't process the last item in the listenerMiddleware array - it shouldn't get a next fn
                     const listener = listenerMiddleware.pop();
-                    if (listener !== undefined) {
-                        return process_1.processMiddleware(listenerMiddleware, listenerArgs, context, client, this.logger, async () => 
-                        // When the listener middleware chain is done processing, call the listener without a next fn
-                        listener({ ...listenerArgs, context, client, logger: this.logger }));
+                    if (listener === undefined) {
+                        return undefined;
                     }
+                    return (0, process_1.default)(listenerMiddleware, listenerArgs, context, client, this.logger, 
+                    // When all of the listener middleware are done processing,
+                    // `listener` here will be called without a `next` execution
+                    async () => listener({
+                        ...listenerArgs,
+                        context,
+                        client,
+                        logger: this.logger,
+                        // `next` is already set in the outer processMiddleware
+                    }));
                 });
                 const settledListenerResults = await allSettled(listenerResults);
                 const rejectedListenerResults = settledListenerResults.filter((lr) => lr.status === 'rejected');
@@ -518,21 +613,29 @@ class App {
             });
         }
         catch (error) {
-            return this.handleError(error);
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const e = error;
+            // disabling due to https://github.com/typescript-eslint/typescript-eslint/issues/1277
+            // eslint-disable-next-line consistent-return
+            return this.handleError({
+                context,
+                error: e,
+                logger: this.logger,
+                body: bodyArg,
+            });
         }
     }
     /**
      * Global error handler. The final destination for all errors (hopefully).
      */
-    handleError(error) {
-        return this.errorHandler(errors_1.asCodedError(error));
+    handleError(args) {
+        const { error, ...rest } = args;
+        return this.extendedErrorHandler && this.hasCustomErrorHandler ?
+            this.errorHandler({ error: (0, errors_1.asCodedError)(error), ...rest }) :
+            this.errorHandler((0, errors_1.asCodedError)(error));
     }
 }
 exports.default = App;
-// ----------------------------
-// For the constructor
-const tokenUsage = 'Apps used in one workspace should be initialized with a token. Apps used in many workspaces ' +
-    'should be initialized with oauth installer or authorize.';
 function defaultErrorHandler(logger) {
     return (error) => {
         logger.error(error);
@@ -543,14 +646,12 @@ function defaultErrorHandler(logger) {
 // singleAuthorization
 function runAuthTestForBotToken(client, authorization) {
     // TODO: warn when something needed isn't found
-    return authorization.botUserId !== undefined && authorization.botId !== undefined
-        ? Promise.resolve({ botUserId: authorization.botUserId, botId: authorization.botId })
-        : client.auth.test({ token: authorization.botToken }).then((result) => {
-            return {
-                botUserId: result.user_id,
-                botId: result.bot_id,
-            };
-        });
+    return authorization.botUserId !== undefined && authorization.botId !== undefined ?
+        Promise.resolve({ botUserId: authorization.botUserId, botId: authorization.botId }) :
+        client.auth.test({ token: authorization.botToken }).then((result) => ({
+            botUserId: result.user_id,
+            botId: result.bot_id,
+        }));
 }
 async function buildAuthorizeResult(isEnterpriseInstall, authTestResult, authorization) {
     return { isEnterpriseInstall, botToken: authorization.botToken, ...(await authTestResult) };
@@ -562,9 +663,7 @@ function singleAuthorization(client, authorization, tokenVerificationEnabled) {
     if (tokenVerificationEnabled) {
         // call auth.test immediately
         cachedAuthTestResult = runAuthTestForBotToken(client, authorization);
-        return async ({ isEnterpriseInstall }) => {
-            return buildAuthorizeResult(isEnterpriseInstall, cachedAuthTestResult, authorization);
-        };
+        return async ({ isEnterpriseInstall }) => buildAuthorizeResult(isEnterpriseInstall, cachedAuthTestResult, authorization);
     }
     return async ({ isEnterpriseInstall }) => {
         // hold off calling auth.test API until the first access to authorize function
@@ -593,6 +692,10 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
         if (type === helpers_1.IncomingEventType.Command) {
             return body.team_id;
         }
+        if (type === helpers_1.IncomingEventType.Subscription) {
+            const bodyAsSubscriptionInteraction = body;
+            return bodyAsSubscriptionInteraction.team.id;
+        }
         if (type === helpers_1.IncomingEventType.Action ||
             type === helpers_1.IncomingEventType.Options ||
             type === helpers_1.IncomingEventType.ViewAction ||
@@ -606,7 +709,7 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
             // This is the only place where this function might return undefined
             return bodyAsActionOrOptionsOrViewActionOrShortcut.user.team_id;
         }
-        return helpers_1.assertNever(type);
+        return (0, helpers_1.assertNever)(type);
     })();
     const enterpriseId = (() => {
         if (type === helpers_1.IncomingEventType.Event) {
@@ -621,6 +724,10 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
         if (type === helpers_1.IncomingEventType.Command) {
             return body.enterprise_id;
         }
+        if (type === helpers_1.IncomingEventType.Subscription) {
+            const bodyAsSubscriptionInteraction = body;
+            return bodyAsSubscriptionInteraction.team.enterprise_id;
+        }
         if (type === helpers_1.IncomingEventType.Action ||
             type === helpers_1.IncomingEventType.Options ||
             type === helpers_1.IncomingEventType.ViewAction ||
@@ -638,7 +745,7 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
             }
             return undefined;
         }
-        return helpers_1.assertNever(type);
+        return (0, helpers_1.assertNever)(type);
     })();
     const userId = (() => {
         if (type === helpers_1.IncomingEventType.Event) {
@@ -660,6 +767,10 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
             }
             return undefined;
         }
+        if (type === helpers_1.IncomingEventType.Subscription) {
+            const bodyAsSubscriptionInteraction = body;
+            return bodyAsSubscriptionInteraction.user.id;
+        }
         if (type === helpers_1.IncomingEventType.Action ||
             type === helpers_1.IncomingEventType.Options ||
             type === helpers_1.IncomingEventType.ViewAction ||
@@ -671,7 +782,7 @@ function buildSource(type, channelId, body, isEnterpriseInstall) {
         if (type === helpers_1.IncomingEventType.Command) {
             return body.user_id;
         }
-        return helpers_1.assertNever(type);
+        return (0, helpers_1.assertNever)(type);
     })();
     return {
         userId,
@@ -688,13 +799,18 @@ function isBodyWithTypeEnterpriseInstall(body, type) {
             return !!bodyAsEvent.authorizations[0].is_enterprise_install;
         }
     }
-    // command payloads have this property set as a string
-    if (typeof body.is_enterprise_install === 'string') {
-        return body.is_enterprise_install === 'true';
+    if (type === helpers_1.IncomingEventType.Subscription) {
+        return body.team.enterprise_id !== undefined;
     }
-    // all remaining types have a boolean property
-    if (body.is_enterprise_install !== undefined) {
-        return body.is_enterprise_install;
+    if ('is_enterprise_install' in body) {
+        // command payloads have this property set as a string
+        if (typeof body.is_enterprise_install === 'string') {
+            return body.is_enterprise_install === 'true';
+        }
+        // all remaining types have a boolean property
+        if (body.is_enterprise_install !== undefined) {
+            return body.is_enterprise_install;
+        }
     }
     // as a fallback we assume it's a single team installation (but this should never happen)
     return false;
@@ -706,17 +822,14 @@ function isBlockActionOrInteractiveMessageBody(body) {
 function selectToken(context) {
     return context.botToken !== undefined ? context.botToken : context.userToken;
 }
-function buildRespondFn(axiosInstance, response_url) {
+function buildRespondFn(axiosInstance, responseUrl) {
     return async (message) => {
         const normalizedArgs = typeof message === 'string' ? { text: message } : message;
-        return axiosInstance.post(response_url, normalizedArgs);
+        return axiosInstance.post(responseUrl, normalizedArgs);
     };
 }
 // ----------------------------
-// For listener registration methods
-const validViewTypes = ['view_closed', 'view_submission'];
-// ----------------------------
 // Instrumentation
 // Don't change the position of the following code
-web_api_1.addAppMetadata({ name: packageJson.name, version: packageJson.version });
+(0, web_api_1.addAppMetadata)({ name: packageJson.name, version: packageJson.version });
 //# sourceMappingURL=App.js.map