@slack/bolt 3.10.0 → 3.11.0

package/dist/receivers/HTTPModuleFunctions.js

@@ -0,0 +1,197 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPModuleFunctions = void 0;
+/* eslint-disable import/prefer-default-export */
+const querystring_1 = require("querystring");
+const raw_body_1 = __importDefault(require("raw-body"));
+const errors_1 = require("../errors");
+const verify_request_1 = require("./verify-request");
+const verifyErrorPrefix = 'Failed to verify authenticity';
+class HTTPModuleFunctions {
+    // ------------------------------------------
+    // Request header extraction
+    // ------------------------------------------
+    static extractRetryNumFromHTTPRequest(req) {
+        let retryNum;
+        const retryNumHeaderValue = req.headers['x-slack-retry-num'];
+        if (retryNumHeaderValue === undefined) {
+            retryNum = undefined;
+        }
+        else if (typeof retryNumHeaderValue === 'string') {
+            retryNum = parseInt(retryNumHeaderValue, 10);
+        }
+        else if (Array.isArray(retryNumHeaderValue) && retryNumHeaderValue.length > 0) {
+            retryNum = parseInt(retryNumHeaderValue[0], 10);
+        }
+        return retryNum;
+    }
+    static extractRetryReasonFromHTTPRequest(req) {
+        let retryReason;
+        const retryReasonHeaderValue = req.headers['x-slack-retry-reason'];
+        if (retryReasonHeaderValue === undefined) {
+            retryReason = undefined;
+        }
+        else if (typeof retryReasonHeaderValue === 'string') {
+            retryReason = retryReasonHeaderValue;
+        }
+        else if (Array.isArray(retryReasonHeaderValue) && retryReasonHeaderValue.length > 0) {
+            // eslint-disable-next-line prefer-destructuring
+            retryReason = retryReasonHeaderValue[0];
+        }
+        return retryReason;
+    }
+    // ------------------------------------------
+    // HTTP request parsing and verification
+    // ------------------------------------------
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static parseHTTPRequestBody(req) {
+        const bodyAsString = req.rawBody.toString();
+        const contentType = req.headers['content-type'];
+        if (contentType === 'application/x-www-form-urlencoded') {
+            const parsedQs = (0, querystring_1.parse)(bodyAsString);
+            const { payload } = parsedQs;
+            if (typeof payload === 'string') {
+                return JSON.parse(payload);
+            }
+            return parsedQs;
+        }
+        return JSON.parse(bodyAsString);
+    }
+    static async parseAndVerifyHTTPRequest(options, req, _res) {
+        const { signingSecret } = options;
+        // Consume the readable stream (or use the previously consumed readable stream)
+        const bufferedReq = await HTTPModuleFunctions.bufferIncomingMessage(req);
+        if (options.enabled !== undefined && !options.enabled) {
+            // As the validation is disabled, immediately return the bufferred reuest
+            return bufferedReq;
+        }
+        const textBody = bufferedReq.rawBody.toString();
+        const contentType = req.headers['content-type'];
+        if (contentType === 'application/x-www-form-urlencoded') {
+            // `ssl_check=1` requests do not require x-slack-signature verification
+            const parsedQs = (0, querystring_1.parse)(textBody);
+            if (parsedQs && parsedQs.ssl_check) {
+                return bufferedReq;
+            }
+        }
+        // Find the relevant request headers
+        const signature = HTTPModuleFunctions.getHeader(req, 'x-slack-signature');
+        const requestTimestampSec = Number(HTTPModuleFunctions.getHeader(req, 'x-slack-request-timestamp'));
+        (0, verify_request_1.verifySlackRequest)({
+            signingSecret,
+            body: textBody,
+            headers: {
+                'x-slack-signature': signature,
+                'x-slack-request-timestamp': requestTimestampSec,
+            },
+            logger: options.logger,
+        });
+        // Checks have passed! Return the value that has a side effect (the buffered request)
+        return bufferedReq;
+    }
+    static isBufferedIncomingMessage(req) {
+        return Buffer.isBuffer(req.rawBody);
+    }
+    static getHeader(req, header) {
+        const value = req.headers[header];
+        if (value === undefined || Array.isArray(value)) {
+            throw new Error(`${verifyErrorPrefix}: header ${header} did not have the expected type (received ${typeof value}, expected string)`);
+        }
+        return value;
+    }
+    static async bufferIncomingMessage(req) {
+        if (HTTPModuleFunctions.isBufferedIncomingMessage(req)) {
+            return req;
+        }
+        const bufferedRequest = req;
+        bufferedRequest.rawBody = await (0, raw_body_1.default)(req);
+        return bufferedRequest;
+    }
+    // ------------------------------------------
+    // HTTP response builder methods
+    // ------------------------------------------
+    static buildNoBodyResponse(res, status) {
+        res.writeHead(status);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static buildUrlVerificationResponse(res, body) {
+        res.writeHead(200, { 'content-type': 'application/json' });
+        res.end(JSON.stringify({ challenge: body.challenge }));
+    }
+    static buildSSLCheckResponse(res) {
+        res.writeHead(200);
+        res.end();
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static buildContentResponse(res, body) {
+        if (!body) {
+            res.writeHead(200);
+            res.end();
+        }
+        else if (typeof body === 'string') {
+            res.writeHead(200);
+            res.end(body);
+        }
+        else {
+            res.writeHead(200, { 'content-type': 'application/json' });
+            res.end(JSON.stringify(body));
+        }
+    }
+    // ------------------------------------------
+    // Error handlers for event processing
+    // ------------------------------------------
+    // The default dispathErrorHandler implementation:
+    // Developers can customize this behavior by passing dispatchErrorHandler to the constructor
+    // Note that it was not possible to make this function async due to the limitation of http module
+    static defaultDispatchErrorHandler(args) {
+        const { error, logger, request, response } = args;
+        if ('code' in error) {
+            if (error.code === errors_1.ErrorCode.HTTPReceiverDeferredRequestError) {
+                logger.info(`Unhandled HTTP request (${request.method}) made to ${request.url}`);
+                response.writeHead(404);
+                response.end();
+                return;
+            }
+        }
+        logger.error(`An unexpected error occurred during a request (${request.method}) made to ${request.url}`);
+        logger.debug(`Error details: ${error}`);
+        response.writeHead(500);
+        response.end();
+    }
+    static async defaultAsyncDispatchErrorHandler(args) {
+        return HTTPModuleFunctions.defaultDispatchErrorHandler(args);
+    }
+    // The default processEventErrorHandler implementation:
+    // Developers can customize this behavior by passing processEventErrorHandler to the constructor
+    static async defaultProcessEventErrorHandler(args) {
+        const { error, response, logger, storedResponse } = args;
+        if ('code' in error) {
+            // CodedError has code: string
+            const errorCode = error.code;
+            if (errorCode === errors_1.ErrorCode.AuthorizationError) {
+                // authorize function threw an exception, which means there is no valid installation data
+                response.writeHead(401);
+                response.end();
+                return true;
+            }
+        }
+        logger.error('An unhandled error occurred while Bolt processed an event');
+        logger.debug(`Error details: ${error}, storedResponse: ${storedResponse}`);
+        response.writeHead(500);
+        response.end();
+        return false;
+    }
+    // The default unhandledRequestHandler implementation:
+    // Developers can customize this behavior by passing unhandledRequestHandler to the constructor
+    // Note that this method cannot be an async function to align with the implementation using setTimeout
+    static defaultUnhandledRequestHandler(args) {
+        const { logger } = args;
+        logger.error('An incoming event was not acknowledged within 3 seconds. ' +
+            'Ensure that the ack() argument is called in a listener.');
+    }
+}
+exports.HTTPModuleFunctions = HTTPModuleFunctions;
+//# sourceMappingURL=HTTPModuleFunctions.js.map

package/dist/receivers/HTTPModuleFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPModuleFunctions.js","sourceRoot":"","sources":["../../src/receivers/HTTPModuleFunctions.ts"],"names":[],"mappings":"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"}

package/dist/receivers/HTTPReceiver.d.ts

@@ -1,15 +1,15 @@
 /// <reference types="node" />
-import { Server, ServerOptions, RequestListener, IncomingMessage, ServerResponse } from 'http';
+import { Server, ServerOptions, RequestListener } from 'http';
 import { Server as HTTPSServer, ServerOptions as HTTPSServerOptions } from 'https';
 import { ListenOptions } from 'net';
 import { Logger, LogLevel } from '@slack/logger';
-import { InstallProvider, CallbackOptions, InstallProviderOptions, InstallURLOptions } from '@slack/oauth';
-import { BufferedIncomingMessage } from './verify-request';
+import { InstallProvider, CallbackOptions, InstallProviderOptions, InstallURLOptions, InstallPathOptions } from '@slack/oauth';
 import App from '../App';
 import { Receiver } from '../types';
-import { CodedError } from '../errors';
 import { CustomRoute } from './custom-routes';
 import { StringIndexed } from '../types/helpers';
+import { BufferedIncomingMessage } from './BufferedIncomingMessage';
+import { ReceiverDispatchErrorHandlerArgs, ReceiverProcessEventErrorHandlerArgs, ReceiverUnhandledRequestHandlerArgs } from './HTTPModuleFunctions';
 export interface HTTPReceiverOptions {
     signingSecret: string;
     endpoints?: string | string[];
@@ -27,47 +27,30 @@ export interface HTTPReceiverOptions {
     scopes?: InstallURLOptions['scopes'];
     installerOptions?: HTTPReceiverInstallerOptions;
     customPropertiesExtractor?: (request: BufferedIncomingMessage) => StringIndexed;
-    dispatchErrorHandler?: (args: HTTPReceiverDispatchErrorHandlerArgs) => void;
-    processEventErrorHandler?: (args: HTTPReceiverProcessEventErrorHandlerArgs) => Promise<boolean>;
-    unhandledRequestHandler?: (args: HTTPReceiverUnhandledRequestHandlerArgs) => void;
+    dispatchErrorHandler?: (args: ReceiverDispatchErrorHandlerArgs) => void;
+    processEventErrorHandler?: (args: ReceiverProcessEventErrorHandlerArgs) => Promise<boolean>;
+    unhandledRequestHandler?: (args: ReceiverUnhandledRequestHandlerArgs) => void;
     unhandledRequestTimeoutMillis?: number;
 }
 export interface HTTPReceiverInstallerOptions {
     installPath?: string;
-    directInstall?: boolean;
-    renderHtmlForInstallPath?: (url: string) => string;
+    directInstall?: InstallProviderOptions['directInstall'];
+    renderHtmlForInstallPath?: InstallProviderOptions['renderHtmlForInstallPath'];
     redirectUriPath?: string;
     stateStore?: InstallProviderOptions['stateStore'];
     stateVerification?: InstallProviderOptions['stateVerification'];
+    legacyStateVerification?: InstallProviderOptions['legacyStateVerification'];
+    stateCookieName?: InstallProviderOptions['stateCookieName'];
+    stateCookieExpirationSeconds?: InstallProviderOptions['stateCookieExpirationSeconds'];
     authVersion?: InstallProviderOptions['authVersion'];
     clientOptions?: InstallProviderOptions['clientOptions'];
     authorizationUrl?: InstallProviderOptions['authorizationUrl'];
     metadata?: InstallURLOptions['metadata'];
     userScopes?: InstallURLOptions['userScopes'];
+    installPathOptions?: InstallPathOptions;
     callbackOptions?: CallbackOptions;
     port?: number;
 }
-export interface HTTPReceiverDispatchErrorHandlerArgs {
-    error: Error | CodedError;
-    logger: Logger;
-    request: IncomingMessage;
-    response: ServerResponse;
-}
-export declare function defaultDispatchErrorHandler(args: HTTPReceiverDispatchErrorHandlerArgs): void;
-export interface HTTPReceiverProcessEventErrorHandlerArgs {
-    error: Error | CodedError;
-    logger: Logger;
-    request: IncomingMessage;
-    response: ServerResponse;
-    storedResponse: any;
-}
-export declare function defaultProcessEventErrorHandler(args: HTTPReceiverProcessEventErrorHandlerArgs): Promise<boolean>;
-export interface HTTPReceiverUnhandledRequestHandlerArgs {
-    logger: Logger;
-    request: IncomingMessage;
-    response: ServerResponse;
-}
-export declare function defaultUnhandledRequestHandler(args: HTTPReceiverUnhandledRequestHandlerArgs): void;
 /**
  * Receives HTTP requests with Events, Slash Commands, and Actions
  */
@@ -83,10 +66,9 @@ export default class HTTPReceiver implements Receiver {
     private server?;
     installer?: InstallProvider;
     private installPath?;
-    private directInstall?;
-    private renderHtmlForInstallPath;
     private installRedirectUriPath?;
     private installUrlOptions?;
+    private installPathOptions?;
     private installCallbackOptions?;
     private stateVerification?;
     private logger;

package/dist/receivers/HTTPReceiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HTTPReceiver.d.ts","sourceRoot":"","sources":["../../src/receivers/HTTPReceiver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HTTPReceiver.d.ts","sourceRoot":"","sources":["../../src/receivers/HTTPReceiver.ts"],"names":[],"mappings":"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"}