@slack/bolt 3.8.0 → 3.8.1

package/dist/receivers/ExpressReceiver.d.ts

@@ -0,0 +1,77 @@
+/// <reference types="node" />
+import { Server, ServerOptions } from 'http';
+import { Server as HTTPSServer, ServerOptions as HTTPSServerOptions } from 'https';
+import { ListenOptions } from 'net';
+import { Request, Application, RequestHandler, IRouter } from 'express';
+import { Logger, LogLevel } from '@slack/logger';
+import { InstallProvider, CallbackOptions, InstallProviderOptions, InstallURLOptions } from '@slack/oauth';
+import App from '../App';
+import { AnyMiddlewareArgs, Receiver } from '../types';
+import { StringIndexed } from '../types/helpers';
+export declare const respondToSslCheck: RequestHandler;
+export declare const respondToUrlVerification: RequestHandler;
+export interface ExpressReceiverOptions {
+    signingSecret: string | (() => PromiseLike<string>);
+    logger?: Logger;
+    logLevel?: LogLevel;
+    endpoints?: string | {
+        [endpointType: string]: string;
+    };
+    signatureVerification?: boolean;
+    processBeforeResponse?: boolean;
+    clientId?: string;
+    clientSecret?: string;
+    stateSecret?: InstallProviderOptions['stateSecret'];
+    redirectUri?: string;
+    installationStore?: InstallProviderOptions['installationStore'];
+    scopes?: InstallURLOptions['scopes'];
+    installerOptions?: InstallerOptions;
+    app?: Application;
+    router?: IRouter;
+    customPropertiesExtractor?: (request: Request) => StringIndexed;
+}
+interface InstallerOptions {
+    stateStore?: InstallProviderOptions['stateStore'];
+    stateVerification?: InstallProviderOptions['stateVerification'];
+    authVersion?: InstallProviderOptions['authVersion'];
+    metadata?: InstallURLOptions['metadata'];
+    installPath?: string;
+    directInstall?: boolean;
+    renderHtmlForInstallPath?: (url: string) => string;
+    redirectUriPath?: string;
+    callbackOptions?: CallbackOptions;
+    userScopes?: InstallURLOptions['userScopes'];
+    clientOptions?: InstallProviderOptions['clientOptions'];
+    authorizationUrl?: InstallProviderOptions['authorizationUrl'];
+}
+/**
+ * Receives HTTP requests with Events, Slash Commands, and Actions
+ */
+export default class ExpressReceiver implements Receiver {
+    app: Application;
+    private server?;
+    private bolt;
+    private logger;
+    private processBeforeResponse;
+    private signatureVerification;
+    router: IRouter;
+    installer: InstallProvider | undefined;
+    installerOptions?: InstallerOptions;
+    private customPropertiesExtractor;
+    constructor({ signingSecret, logger, logLevel, endpoints, processBeforeResponse, signatureVerification, clientId, clientSecret, stateSecret, redirectUri, installationStore, scopes, installerOptions, app, router, customPropertiesExtractor, }: ExpressReceiverOptions);
+    private requestHandler;
+    init(bolt: App): void;
+    start(port: number): Promise<Server>;
+    start(portOrListenOptions: number | ListenOptions, serverOptions?: ServerOptions): Promise<Server>;
+    start(portOrListenOptions: number | ListenOptions, httpsServerOptions?: HTTPSServerOptions): Promise<HTTPSServer>;
+    stop(): Promise<void>;
+}
+export declare function verifySignatureAndParseRawBody(logger: Logger, signingSecret: string | (() => PromiseLike<string>)): RequestHandler;
+/**
+ * This request handler has two responsibilities:
+ * - Verify the request signature
+ * - Parse request.body and assign the successfully parsed object to it.
+ */
+export declare function verifySignatureAndParseBody(signingSecret: string, body: string, headers: Record<string, any>): AnyMiddlewareArgs['body'];
+export {};
+//# sourceMappingURL=ExpressReceiver.d.ts.map

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

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

package/dist/receivers/ExpressReceiver.js

@@ -0,0 +1,445 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.verifySignatureAndParseBody = exports.verifySignatureAndParseRawBody = exports.respondToUrlVerification = exports.respondToSslCheck = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const http_1 = require("http");
+const https_1 = require("https");
+const express_1 = __importStar(require("express"));
+const raw_body_1 = __importDefault(require("raw-body"));
+const querystring_1 = __importDefault(require("querystring"));
+const crypto_1 = __importDefault(require("crypto"));
+const tsscmp_1 = __importDefault(require("tsscmp"));
+const logger_1 = require("@slack/logger");
+const oauth_1 = require("@slack/oauth");
+const errors_1 = require("../errors");
+const render_html_for_install_path_1 = __importDefault(require("./render-html-for-install-path"));
+const verify_redirect_opts_1 = require("./verify-redirect-opts");
+const http_utils_1 = require("./http-utils");
+// Option keys for tls.createServer() and tls.createSecureContext(), exclusive of those for http.createServer()
+const httpsOptionKeys = [
+    'ALPNProtocols',
+    'clientCertEngine',
+    'enableTrace',
+    'handshakeTimeout',
+    'rejectUnauthorized',
+    'requestCert',
+    'sessionTimeout',
+    'SNICallback',
+    'ticketKeys',
+    'pskCallback',
+    'pskIdentityHint',
+    'ca',
+    'cert',
+    'sigalgs',
+    'ciphers',
+    'clientCertEngine',
+    'crl',
+    'dhparam',
+    'ecdhCurve',
+    'honorCipherOrder',
+    'key',
+    'privateKeyEngine',
+    'privateKeyIdentifier',
+    'maxVersion',
+    'minVersion',
+    'passphrase',
+    'pfx',
+    'secureOptions',
+    'secureProtocol',
+    'sessionIdContext',
+];
+const missingServerErrorDescription = 'The receiver cannot be started because private state was mutated. Please report this to the maintainers.';
+const respondToSslCheck = (req, res, next) => {
+    if (req.body && req.body.ssl_check) {
+        res.send();
+        return;
+    }
+    next();
+};
+exports.respondToSslCheck = respondToSslCheck;
+const respondToUrlVerification = (req, res, next) => {
+    if (req.body && req.body.type && req.body.type === 'url_verification') {
+        res.json({ challenge: req.body.challenge });
+        return;
+    }
+    next();
+};
+exports.respondToUrlVerification = respondToUrlVerification;
+/**
+ * Receives HTTP requests with Events, Slash Commands, and Actions
+ */
+class ExpressReceiver {
+    constructor({ signingSecret = '', logger = undefined, logLevel = logger_1.LogLevel.INFO, endpoints = { events: '/slack/events' }, processBeforeResponse = false, signatureVerification = true, clientId = undefined, clientSecret = undefined, stateSecret = undefined, redirectUri = undefined, installationStore = undefined, scopes = undefined, installerOptions = {}, app = undefined, router = undefined, customPropertiesExtractor = (_req) => ({}), }) {
+        var _a;
+        this.installer = undefined;
+        this.app = app !== undefined ? app : (0, express_1.default)();
+        if (typeof logger !== 'undefined') {
+            this.logger = logger;
+        }
+        else {
+            this.logger = new logger_1.ConsoleLogger();
+            this.logger.setLevel(logLevel);
+        }
+        this.signatureVerification = signatureVerification;
+        const bodyParser = this.signatureVerification ?
+            buildVerificationBodyParserMiddleware(this.logger, signingSecret) :
+            buildBodyParserMiddleware(this.logger);
+        const expressMiddleware = [
+            bodyParser,
+            exports.respondToSslCheck,
+            exports.respondToUrlVerification,
+            this.requestHandler.bind(this),
+        ];
+        this.processBeforeResponse = processBeforeResponse;
+        const endpointList = typeof endpoints === 'string' ? [endpoints] : Object.values(endpoints);
+        this.router = router !== undefined ? router : (0, express_1.Router)();
+        endpointList.forEach((endpoint) => {
+            this.router.post(endpoint, ...expressMiddleware);
+        });
+        this.customPropertiesExtractor = customPropertiesExtractor;
+        // Verify redirect options if supplied, throws coded error if invalid
+        (0, verify_redirect_opts_1.verifyRedirectOpts)({ redirectUri, redirectUriPath: installerOptions.redirectUriPath });
+        if (clientId !== undefined &&
+            clientSecret !== undefined &&
+            (installerOptions.stateVerification === false || // state store not needed
+                stateSecret !== undefined ||
+                installerOptions.stateStore !== undefined) // user provided state store
+        ) {
+            this.installer = new oauth_1.InstallProvider({
+                clientId,
+                clientSecret,
+                stateSecret,
+                installationStore,
+                logLevel,
+                logger,
+                stateStore: installerOptions.stateStore,
+                stateVerification: installerOptions.stateVerification,
+                authVersion: (_a = installerOptions.authVersion) !== null && _a !== void 0 ? _a : 'v2',
+                clientOptions: installerOptions.clientOptions,
+                authorizationUrl: installerOptions.authorizationUrl,
+            });
+        }
+        // create install url options
+        const installUrlOptions = {
+            metadata: installerOptions.metadata,
+            scopes: scopes !== null && scopes !== void 0 ? scopes : [],
+            userScopes: installerOptions.userScopes,
+            redirectUri,
+        };
+        // Add OAuth routes to receiver
+        if (this.installer !== undefined) {
+            const redirectUriPath = installerOptions.redirectUriPath === undefined ?
+                '/slack/oauth_redirect' :
+                installerOptions.redirectUriPath;
+            const { callbackOptions, stateVerification } = installerOptions;
+            this.router.use(redirectUriPath, async (req, res) => {
+                if (stateVerification === false) {
+                    // when stateVerification is disabled pass install options directly to handler
+                    // since they won't be encoded in the state param of the generated url
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    await this.installer.handleCallback(req, res, callbackOptions, installUrlOptions);
+                }
+                else {
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    await this.installer.handleCallback(req, res, callbackOptions);
+                }
+            });
+            const installPath = installerOptions.installPath === undefined ? '/slack/install' : installerOptions.installPath;
+            this.router.get(installPath, async (_req, res, next) => {
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                    const url = await this.installer.generateInstallUrl(installUrlOptions, stateVerification);
+                    if (installerOptions.directInstall) {
+                        // If a Slack app sets "Direct Install URL" in the Slack app configuration,
+                        // the installation flow of the app should start with the Slack authorize URL.
+                        // See https://api.slack.com/start/distributing/directory#direct_install for more details.
+                        res.redirect(url);
+                    }
+                    else {
+                        // The installation starts from a landing page served by this app.
+                        const renderHtml = installerOptions.renderHtmlForInstallPath !== undefined ?
+                            installerOptions.renderHtmlForInstallPath :
+                            render_html_for_install_path_1.default;
+                        res.send(renderHtml(url));
+                    }
+                }
+                catch (error) {
+                    next(error);
+                }
+            });
+        }
+        this.app.use(this.router);
+    }
+    async requestHandler(req, res) {
+        var _a;
+        let isAcknowledged = false;
+        setTimeout(() => {
+            if (!isAcknowledged) {
+                this.logger.error('An incoming event was not acknowledged within 3 seconds. Ensure that the ack() argument is called in a listener.');
+            }
+        }, 3001);
+        let storedResponse;
+        const event = {
+            body: req.body,
+            ack: async (response) => {
+                this.logger.debug('ack() begin');
+                if (isAcknowledged) {
+                    throw new errors_1.ReceiverMultipleAckError();
+                }
+                isAcknowledged = true;
+                if (this.processBeforeResponse) {
+                    if (!response) {
+                        storedResponse = '';
+                    }
+                    else {
+                        storedResponse = response;
+                    }
+                    this.logger.debug('ack() response stored');
+                }
+                else {
+                    if (!response) {
+                        res.send('');
+                    }
+                    else if (typeof response === 'string') {
+                        res.send(response);
+                    }
+                    else {
+                        res.json(response);
+                    }
+                    this.logger.debug('ack() response sent');
+                }
+            },
+            retryNum: (0, http_utils_1.extractRetryNum)(req),
+            retryReason: (0, http_utils_1.extractRetryReason)(req),
+            customProperties: this.customPropertiesExtractor(req),
+        };
+        try {
+            await ((_a = this.bolt) === null || _a === void 0 ? void 0 : _a.processEvent(event));
+            if (storedResponse !== undefined) {
+                if (typeof storedResponse === 'string') {
+                    res.send(storedResponse);
+                }
+                else {
+                    res.json(storedResponse);
+                }
+                this.logger.debug('stored response sent');
+            }
+        }
+        catch (err) {
+            const e = err;
+            if ('code' in e) {
+                // CodedError has code: string
+                const errorCode = err.code;
+                if (errorCode === errors_1.ErrorCode.AuthorizationError) {
+                    // authorize function threw an exception, which means there is no valid installation data
+                    res.status(401).send();
+                    isAcknowledged = true;
+                    return;
+                }
+            }
+            res.status(500).send();
+            throw err;
+        }
+    }
+    init(bolt) {
+        this.bolt = bolt;
+    }
+    start(portOrListenOptions, serverOptions = {}) {
+        let createServerFn = http_1.createServer;
+        // Look for HTTPS-specific serverOptions to determine which factory function to use
+        if (Object.keys(serverOptions).filter((k) => httpsOptionKeys.includes(k)).length > 0) {
+            createServerFn = https_1.createServer;
+        }
+        if (this.server !== undefined) {
+            return Promise.reject(new errors_1.ReceiverInconsistentStateError('The receiver cannot be started because it was already started.'));
+        }
+        this.server = createServerFn(serverOptions, this.app);
+        return new Promise((resolve, reject) => {
+            if (this.server === undefined) {
+                throw new errors_1.ReceiverInconsistentStateError(missingServerErrorDescription);
+            }
+            this.server.on('error', (error) => {
+                if (this.server === undefined) {
+                    throw new errors_1.ReceiverInconsistentStateError(missingServerErrorDescription);
+                }
+                this.server.close();
+                // If the error event occurs before listening completes (like EADDRINUSE), this works well. However, if the
+                // error event happens some after the Promise is already resolved, the error would be silently swallowed up.
+                // The documentation doesn't describe any specific errors that can occur after listening has started, so this
+                // feels safe.
+                reject(error);
+            });
+            this.server.on('close', () => {
+                // Not removing all listeners because consumers could have added their own `close` event listener, and those
+                // should be called. If the consumer doesn't dispose of any references to the server properly, this would be
+                // a memory leak.
+                // this.server?.removeAllListeners();
+                this.server = undefined;
+            });
+            this.server.listen(portOrListenOptions, () => {
+                if (this.server === undefined) {
+                    return reject(new errors_1.ReceiverInconsistentStateError(missingServerErrorDescription));
+                }
+                return resolve(this.server);
+            });
+        });
+    }
+    // TODO: the arguments should be defined as the arguments to close() (which happen to be none), but for sake of
+    // generic types
+    stop() {
+        if (this.server === undefined) {
+            return Promise.reject(new errors_1.ReceiverInconsistentStateError('The receiver cannot be stopped because it was not started.'));
+        }
+        return new Promise((resolve, reject) => {
+            var _a;
+            (_a = this.server) === null || _a === void 0 ? void 0 : _a.close((error) => {
+                if (error !== undefined) {
+                    return reject(error);
+                }
+                this.server = undefined;
+                return resolve();
+            });
+        });
+    }
+}
+exports.default = ExpressReceiver;
+function verifySignatureAndParseRawBody(logger, signingSecret) {
+    return buildVerificationBodyParserMiddleware(logger, signingSecret);
+}
+exports.verifySignatureAndParseRawBody = verifySignatureAndParseRawBody;
+/**
+ * This request handler has two responsibilities:
+ * - Verify the request signature
+ * - Parse request.body and assign the successfully parsed object to it.
+ */
+function buildVerificationBodyParserMiddleware(logger, signingSecret) {
+    return async (req, res, next) => {
+        let stringBody;
+        // On some environments like GCP (Google Cloud Platform),
+        // req.body can be pre-parsed and be passed as req.rawBody here
+        const preparsedRawBody = req.rawBody;
+        if (preparsedRawBody !== undefined) {
+            stringBody = preparsedRawBody.toString();
+        }
+        else {
+            stringBody = (await (0, raw_body_1.default)(req)).toString();
+        }
+        // *** Parsing body ***
+        // As the verification passed, parse the body as an object and assign it to req.body
+        // Following middlewares can expect `req.body` is already a parsed one.
+        try {
+            // This handler parses `req.body` or `req.rawBody`(on Google Could Platform)
+            // and overwrites `req.body` with the parsed JS object.
+            req.body = verifySignatureAndParseBody(typeof signingSecret === 'string' ? signingSecret : await signingSecret(), stringBody, req.headers);
+        }
+        catch (error) {
+            if (error) {
+                if (error instanceof errors_1.ReceiverAuthenticityError) {
+                    logError(logger, 'Request verification failed', error);
+                    return res.status(401).send();
+                }
+                logError(logger, 'Parsing request body failed', error);
+                return res.status(400).send();
+            }
+        }
+        return next();
+    };
+}
+function logError(logger, message, error) {
+    const logMessage = 'code' in error ?
+        `${message} (code: ${error.code}, message: ${error.message})` :
+        `${message} (error: ${error})`;
+    logger.warn(logMessage);
+}
+function verifyRequestSignature(signingSecret, body, signature, requestTimestamp) {
+    if (signature === undefined || requestTimestamp === undefined) {
+        throw new errors_1.ReceiverAuthenticityError('Slack request signing verification failed. Some headers are missing.');
+    }
+    const ts = Number(requestTimestamp);
+    // eslint-disable-next-line no-restricted-globals
+    if (isNaN(ts)) {
+        throw new errors_1.ReceiverAuthenticityError('Slack request signing verification failed. Timestamp is invalid.');
+    }
+    // Divide current date to match Slack ts format
+    // Subtract 5 minutes from current time
+    const fiveMinutesAgo = Math.floor(Date.now() / 1000) - 60 * 5;
+    if (ts < fiveMinutesAgo) {
+        throw new errors_1.ReceiverAuthenticityError('Slack request signing verification failed. Timestamp is too old.');
+    }
+    const hmac = crypto_1.default.createHmac('sha256', signingSecret);
+    const [version, hash] = signature.split('=');
+    hmac.update(`${version}:${ts}:${body}`);
+    if (!(0, tsscmp_1.default)(hash, hmac.digest('hex'))) {
+        throw new errors_1.ReceiverAuthenticityError('Slack request signing verification failed. Signature mismatch.');
+    }
+}
+/**
+ * This request handler has two responsibilities:
+ * - Verify the request signature
+ * - Parse request.body and assign the successfully parsed object to it.
+ */
+function verifySignatureAndParseBody(signingSecret, body, headers) {
+    // *** Request verification ***
+    const { 'x-slack-signature': signature, 'x-slack-request-timestamp': requestTimestamp, 'content-type': contentType, } = headers;
+    verifyRequestSignature(signingSecret, body, signature, requestTimestamp);
+    return parseRequestBody(body, contentType);
+}
+exports.verifySignatureAndParseBody = verifySignatureAndParseBody;
+function buildBodyParserMiddleware(logger) {
+    return async (req, res, next) => {
+        let stringBody;
+        // On some environments like GCP (Google Cloud Platform),
+        // req.body can be pre-parsed and be passed as req.rawBody here
+        const preparsedRawBody = req.rawBody;
+        if (preparsedRawBody !== undefined) {
+            stringBody = preparsedRawBody.toString();
+        }
+        else {
+            stringBody = (await (0, raw_body_1.default)(req)).toString();
+        }
+        try {
+            const { 'content-type': contentType } = req.headers;
+            req.body = parseRequestBody(stringBody, contentType);
+        }
+        catch (error) {
+            if (error) {
+                logError(logger, 'Parsing request body failed', error);
+                return res.status(400).send();
+            }
+        }
+        return next();
+    };
+}
+function parseRequestBody(stringBody, contentType) {
+    if (contentType === 'application/x-www-form-urlencoded') {
+        const parsedBody = querystring_1.default.parse(stringBody);
+        if (typeof parsedBody.payload === 'string') {
+            return JSON.parse(parsedBody.payload);
+        }
+        return parsedBody;
+    }
+    return JSON.parse(stringBody);
+}
+//# sourceMappingURL=ExpressReceiver.js.map

package/dist/receivers/ExpressReceiver.js.map

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

package/dist/receivers/HTTPReceiver.d.ts

@@ -0,0 +1,109 @@
+/// <reference types="node" />
+import { Server, ServerOptions, RequestListener, IncomingMessage, ServerResponse } 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 App from '../App';
+import { Receiver } from '../types';
+import { CodedError } from '../errors';
+import { CustomRoute } from './custom-routes';
+import { StringIndexed } from '../types/helpers';
+export interface HTTPReceiverOptions {
+    signingSecret: string;
+    endpoints?: string | string[];
+    port?: number;
+    customRoutes?: CustomRoute[];
+    logger?: Logger;
+    logLevel?: LogLevel;
+    processBeforeResponse?: boolean;
+    signatureVerification?: boolean;
+    clientId?: string;
+    clientSecret?: string;
+    stateSecret?: InstallProviderOptions['stateSecret'];
+    redirectUri?: string;
+    installationStore?: InstallProviderOptions['installationStore'];
+    scopes?: InstallURLOptions['scopes'];
+    installerOptions?: HTTPReceiverInstallerOptions;
+    customPropertiesExtractor?: (request: BufferedIncomingMessage) => StringIndexed;
+    dispatchErrorHandler?: (args: HTTPReceiverDispatchErrorHandlerArgs) => void;
+    processEventErrorHandler?: (args: HTTPReceiverProcessEventErrorHandlerArgs) => Promise<boolean>;
+    unhandledRequestHandler?: (args: HTTPReceiverUnhandledRequestHandlerArgs) => void;
+    unhandledRequestTimeoutMillis?: number;
+}
+export interface HTTPReceiverInstallerOptions {
+    installPath?: string;
+    directInstall?: boolean;
+    renderHtmlForInstallPath?: (url: string) => string;
+    redirectUriPath?: string;
+    stateStore?: InstallProviderOptions['stateStore'];
+    stateVerification?: InstallProviderOptions['stateVerification'];
+    authVersion?: InstallProviderOptions['authVersion'];
+    clientOptions?: InstallProviderOptions['clientOptions'];
+    authorizationUrl?: InstallProviderOptions['authorizationUrl'];
+    metadata?: InstallURLOptions['metadata'];
+    userScopes?: InstallURLOptions['userScopes'];
+    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
+ */
+export default class HTTPReceiver implements Receiver {
+    private endpoints;
+    private port;
+    private routes;
+    private signingSecret;
+    private processBeforeResponse;
+    private signatureVerification;
+    private app?;
+    requestListener: RequestListener;
+    private server?;
+    installer?: InstallProvider;
+    private installPath?;
+    private directInstall?;
+    private renderHtmlForInstallPath;
+    private installRedirectUriPath?;
+    private installUrlOptions?;
+    private installCallbackOptions?;
+    private stateVerification?;
+    private logger;
+    private customPropertiesExtractor;
+    private dispatchErrorHandler;
+    private processEventErrorHandler;
+    private unhandledRequestHandler;
+    private unhandledRequestTimeoutMillis;
+    constructor({ signingSecret, endpoints, port, customRoutes, logger, logLevel, processBeforeResponse, signatureVerification, clientId, clientSecret, stateSecret, redirectUri, installationStore, scopes, installerOptions, customPropertiesExtractor, dispatchErrorHandler, processEventErrorHandler, unhandledRequestHandler, unhandledRequestTimeoutMillis, }: HTTPReceiverOptions);
+    init(app: App): void;
+    start(port: number): Promise<Server>;
+    start(portOrListenOptions: number | ListenOptions, serverOptions?: ServerOptions): Promise<Server>;
+    start(portOrListenOptions: number | ListenOptions, httpsServerOptions?: HTTPSServerOptions): Promise<HTTPSServer>;
+    stop(): Promise<void>;
+    private unboundRequestListener;
+    private handleIncomingEvent;
+    private handleInstallPathRequest;
+    private handleInstallRedirectRequest;
+}
+//# sourceMappingURL=HTTPReceiver.d.ts.map