@slack/bolt 3.12.0 → 4.0.0-nextGen.2

package/dist/types/subscription/index.d.ts

@@ -0,0 +1,80 @@
+import { ViewsOpenResponse } from '@slack/web-api';
+import { View } from '@slack/types';
+import { Middleware } from '../middleware';
+import { SayFn, AckFn } from '../utilities';
+export interface NotificationSubscription<T extends string = string> {
+    type: T;
+    token: string;
+    action_ts: string;
+    action_id: string;
+    user: {
+        id: string;
+        name: string;
+    };
+    team: {
+        id: string;
+        domain: string;
+        enterprise_id?: string;
+        enterprise_name?: string;
+    };
+}
+export interface SubscriptionCreateRequested extends NotificationSubscription<'notification_subscription_create_requested'> {
+    channel: {
+        id: string;
+    };
+    notification_subscription_action_trigger_id: string;
+    notification_subscription: {
+        resource_link: string;
+    };
+}
+export interface SubscriptionConfigureRequested extends NotificationSubscription<'notification_subscription_configure_requested'> {
+    notification_subscription_action_trigger_id: string;
+    notification_subscription: {
+        id: string;
+    };
+}
+export interface SubscriptionDeleted extends NotificationSubscription<'notification_subscription_deleted'> {
+    notification_subscription: {
+        id: string;
+    };
+}
+export declare type SubscriptionInteraction = SubscriptionCreateRequested | SubscriptionConfigureRequested | SubscriptionDeleted;
+/**
+  * Utility mixin for middlewares to open a configuration modal view (views.open)
+*/
+export interface UseConfigure {
+    configure: {
+        (params: View): Promise<ViewsOpenResponse>;
+    };
+}
+/**
+ * Utility mixin for middlewares which can be used to send a message to the user
+ * */
+export interface UseSay {
+    say: SayFn;
+}
+/**
+ * Values and utilities middlewares receive in order to process incoming notification
+ * subscription interactive payloads.
+ * */
+export interface SubscriptionMiddlewareArgs<S extends SubscriptionInteraction = SubscriptionInteraction> {
+    payload: S;
+    body: S;
+    ack: AckFn<void>;
+}
+export interface SubscriptionOnCreateMiddlewareArgs extends SubscriptionMiddlewareArgs, UseConfigure, UseSay {
+}
+export interface SubscriptionOnConfigureMiddlewareArgs extends SubscriptionMiddlewareArgs, UseConfigure {
+}
+export declare type SlackSubscriptionMiddlewareArgs = SubscriptionMiddlewareArgs | SubscriptionOnCreateMiddlewareArgs | SubscriptionOnConfigureMiddlewareArgs;
+/**
+ * Types for middleware which handle notification subscription interaction
+ * payloads defined above
+ * */
+export declare type SubscriptionOnCreateMiddleware = Middleware<SubscriptionOnCreateMiddlewareArgs>;
+export declare type SubscriptionOnConfigureMiddleware = Middleware<SubscriptionOnConfigureMiddlewareArgs>;
+export declare type SubscriptionOnDeletedMiddleware = Middleware<SubscriptionMiddlewareArgs>;
+export interface SubConfigureFn {
+    (params: View): Promise<ViewsOpenResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/subscription/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/subscription/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACjE,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAGD,MAAM,WAAW,2BAA4B,SAAQ,wBAAwB,CAAC,4CAA4C,CAAC;IACzH,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,2CAA2C,EAAE,MAAM,CAAC;IACpD,yBAAyB,EAAE;QACzB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAGD,MAAM,WAAW,8BAA+B,SAAQ,wBAAwB,CAAC,+CAA+C,CAAC;IAC/H,2CAA2C,EAAE,MAAM,CAAC;IACpD,yBAAyB,EAAE;QACzB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAGD,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB,CAAC,mCAAmC,CAAC;IACxG,yBAAyB,EAAE;QACzB,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;CACH;AAED,oBAAY,uBAAuB,GACjC,2BAA2B,GAC3B,8BAA8B,GAC9B,mBAAmB,CAAC;AAEtB;;EAEE;AACF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QACT,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;KAC3C,CAAC;CACH;AACD;;KAEK;AACL,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,KAAK,CAAC;CACZ;AACD;;;KAGK;AACL,MAAM,WAAW,0BAA0B,CAAC,CAAC,SAAS,uBAAuB,GAAG,uBAAuB;IACrG,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,CAAC,CAAC;IAGR,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CAClB;AACD,MAAM,WAAW,kCAAmC,SAAQ,0BAA0B,EAAE,YAAY,EAAE,MAAM;CAAG;AAC/G,MAAM,WAAW,qCAAsC,SAAQ,0BAA0B,EAAE,YAAY;CAAG;AAC1G,oBAAY,+BAA+B,GAC3C,0BAA0B,GAC1B,kCAAkC,GAClC,qCAAqC,CAAC;AAEtC;;;KAGK;AACL,oBAAY,8BAA8B,GAAG,UAAU,CAAC,kCAAkC,CAAC,CAAC;AAC5F,oBAAY,iCAAiC,GAAG,UAAU,CAAC,qCAAqC,CAAC,CAAC;AAClG,oBAAY,+BAA+B,GAAG,UAAU,CAAC,0BAA0B,CAAC,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC5C"}

package/dist/types/subscription/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/subscription/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/subscription/index.ts"],"names":[],"mappings":""}

package/dist/types/view/index.d.ts

@@ -1,5 +1,6 @@
 import { Block, KnownBlock, PlainTextElement, View } from '@slack/types';
 import { AckFn, RespondFn } from '../utilities';
+import { FunctionContext } from '../functions';
 /**
  * Known view action types
  */
@@ -30,7 +31,7 @@ export interface ViewResponseUrl {
  *
  * This describes the entire JSON-encoded body of a view_submission event.
  */
-export interface ViewSubmitAction {
+export interface ViewSubmitAction extends FunctionContext {
     type: 'view_submission';
     team: {
         id: string;
@@ -45,8 +46,8 @@ export interface ViewSubmitAction {
     };
     view: ViewOutput;
     api_app_id: string;
-    token: string;
-    trigger_id: string;
+    token?: string;
+    trigger_id?: string;
     is_enterprise_install?: boolean;
     enterprise?: {
         id: string;
@@ -59,7 +60,7 @@ export interface ViewSubmitAction {
  *
  * This describes the entire JSON-encoded body of a view_closed event.
  */
-export interface ViewClosedAction {
+export interface ViewClosedAction extends FunctionContext {
     type: 'view_closed';
     team: {
         id: string;
@@ -173,7 +174,7 @@ export interface ViewErrorsResponseAction {
 export declare type ViewResponseAction = ViewUpdateResponseAction | ViewPushResponseAction | ViewClearResponseAction | ViewErrorsResponseAction;
 /**
  * Type function which given a view action `VA` returns a corresponding type for the `ack()` function. The function is
- * used to acknowledge the receipt (and possibly signal failure) of an view submission or closure from a listener or
+ * used to acknowledge the receipt (and possibly signal failure) of a view submission or closure from a listener or
  * middleware.
  */
 declare type ViewAckFn<VA extends SlackViewAction = SlackViewAction> = VA extends ViewSubmitAction ? AckFn<ViewResponseAction> : AckFn<void>;

package/dist/types/view/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@slack/bolt",
-  "version": "3.12.0",
+  "version": "4.0.0-nextGen.2",
   "description": "A framework for building Slack apps, fast.",
   "author": "Slack Technologies, LLC",
   "license": "MIT",
@@ -29,29 +29,38 @@
     "build": "tsc",
     "build:clean": "shx rm -rf ./dist ./coverage ./.nyc_output",
     "lint": "eslint --fix --ext .ts src",
-    "mocha": "TS_NODE_PROJECT=tsconfig.json nyc mocha --config .mocharc.json \"src/**/*.spec.ts\"",
+    "mocha": "TS_NODE_PROJECT=tsconfig.json nyc mocha --config .mocharc.json \"src/**/*.spec.ts\" \"src/**/*.spec.js\"",
     "test": "npm run lint && npm run mocha && npm run test:types",
     "test:types": "tsd",
     "coverage": "codecov",
     "watch": "npx nodemon --watch 'src' --ext 'ts' --exec npm run build"
   },
+  "bin": {
+    "slack-cli-get-hooks": "./src/cli/get-hooks.js",
+    "slack-cli-get-manifest": "./src/cli/get-manifest.js",
+    "slack-cli-start": "./src/cli/start.js",
+    "slack-cli-hook-utils": "./src/cli/hook-utils/manifest.js"
+  },
   "repository": "slackapi/bolt",
   "homepage": "https://slack.dev/bolt-js",
   "bugs": {
     "url": "https://github.com/slackapi/bolt-js/issues"
   },
   "dependencies": {
+    "@slack/deno-slack-sdk": "^1.0.0",
     "@slack/logger": "^3.0.0",
     "@slack/oauth": "^2.5.1",
     "@slack/socket-mode": "^1.3.0",
     "@slack/types": "^2.7.0",
     "@slack/web-api": "^6.7.1",
     "@types/express": "^4.16.1",
-    "@types/node": ">=12",
+    "@types/node": "18.7.15",
     "@types/promise.allsettled": "^1.0.3",
     "@types/tsscmp": "^1.0.0",
     "axios": "^0.26.1",
+    "deepmerge": "^4.2.2",
     "express": "^4.16.4",
+    "fs": "0.0.1-security",
     "please-upgrade-node": "^3.2.0",
     "promise.allsettled": "^1.0.2",
     "raw-body": "^2.3.3",
@@ -74,15 +83,17 @@
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-react": "^7.29.3",
     "eslint-plugin-react-hooks": "^4.3.0",
+    "memfs": "^3.4.6",
     "mocha": "^9.1.3",
+    "mock-fs": "^5.1.2",
     "nyc": "^15.1.0",
     "rewiremock": "^3.13.4",
     "shx": "^0.3.2",
     "sinon": "^7.3.1",
     "source-map-support": "^0.5.12",
     "ts-node": "^8.1.0",
-    "tsd": "^0.13.1",
-    "typescript": "^4.1.0"
+    "tsd": "^0.22.0",
+    "typescript": "4.7.4"
   },
   "tsd": {
     "directory": "types-tests"

package/src/cli/get-hooks.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+console.log(JSON.stringify({
+  hooks: {
+    'get-manifest': 'npx -q --no-install -p @slack/bolt slack-cli-get-manifest',
+    start: 'npx -q --no-install -p @slack/bolt slack-cli-start',
+  },
+  config: {
+    watch: {
+      'filter-regex': '^manifest\\.(ts|js|json)$',
+      paths: [
+        '.',
+      ],
+    },
+    'sdk-managed-connection-enabled': true,
+  },
+}));

package/src/cli/get-manifest.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+const { getManifestData } = require('./hook-utils/manifest');
+
+/** 
+ * Implements the get-manifest script hook required by the Slack CLI
+ * Returns a manifest JSON string to stdout.
+ * Looks for a manifest.ts, .js and .json files. If multiple are found 
+ * Then any manifest.ts (or missing that, manifest.js) defined
+ * properties will merge into any manifest.json
+*/
+(function _(cwd) {
+  let manifest = getManifestData(cwd);
+    
+  // write manifest to stdout
+  console.log(JSON.stringify(manifest));
+}(process.cwd()));

package/src/cli/hook-utils/manifest.js

@@ -0,0 +1,114 @@
+const fs = require('fs');
+const path = require('path');
+const merge = require('deepmerge');
+
+// helper array merge function
+function unionMerge(array1, array2) {
+  return [...new Set(array1.concat(array2))];
+}
+
+// look for manifest.json in the current working directory
+function readManifestJSONFile(searchDir, filename) {
+  let jsonFilePath, manifestJSON;
+  try {
+    jsonFilePath = find(searchDir, filename);
+    if (fs.existsSync(jsonFilePath)) {
+      manifestJSON = JSON.parse(fs.readFileSync(jsonFilePath, 'utf8'));
+    }
+  } catch (error) {
+    return;
+  }
+  return manifestJSON;
+}
+
+// look for a manifest file in the current working directory
+function readImportedManifestFile(searchDir, filename) {
+  let importedManifestFilePath, manifestImported;
+
+  try {
+    importedManifestFilePath = find(searchDir, filename);
+    if (fs.existsSync(importedManifestFilePath)) {
+      manifestImported = require(`${importedManifestFilePath}`);
+      
+      // if a default key is provided, assumes default export contains manifest
+      if (manifestImported["default"]) {
+        manifestImported = manifestImported["default"]
+      }
+    }
+  } catch (error) {
+    console.log(error);
+    return;
+  }
+  return manifestImported;
+}
+
+// true if any non empty manifest has been supplied
+function hasManifest(...entries) {
+  for (let ent of entries) {
+    if (ent && (Object.keys(ent).length > 0)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+// recursive search for provided path and return full path when filename is found
+// TODO: Cache searched paths and check that they haven't been explored already
+// This guards against rare edge case of a subdir in the file tree which is 
+// symlinked back to root or in such a way that creates a cycle. Can also implement
+// max depth check. 
+function find(currentPath, targetFilename) {
+  if (currentPath.endsWith(`/${targetFilename}`)) {
+    return currentPath;
+  }
+
+  if (fs.existsSync(currentPath) && fs.lstatSync(currentPath).isDirectory()) {
+    let foundEntry;
+    let dirents = fs.readdirSync(currentPath);
+    for (let entry of dirents) {
+      if (entry !== 'node_modules') {
+        let newPath = path.resolve(currentPath, entry);
+        foundEntry = find(newPath, targetFilename);
+        if (foundEntry) {
+          return foundEntry;
+        }
+      }
+    }
+    return null;
+  }
+}
+
+function getManifestData(searchDir) {
+  const file = 'manifest';
+  let manifest = {};
+
+  // look for a manifest JSON
+  const manifestJSON = readManifestJSONFile(searchDir, `${file}.json`);
+  
+  // look for manifest.js
+  // stringify and parses the JSON in order to ensure that objects with .toJSON() functions
+  // resolve properly. This is a known behavior for CustomType
+  const manifestJS = JSON.parse(JSON.stringify(readImportedManifestFile(searchDir, `${file}.js`)));
+
+  if (!hasManifest(manifestJS, manifestJSON)) {
+    throw new Error('Unable to find a manifest file in this project');
+  }
+
+  // manage manifest merge
+  if (manifestJSON) {
+    manifest = merge(manifest, manifestJSON, { arrayMerge: unionMerge});
+  }  
+  if (manifestJS) {
+    manifest = merge(manifest, manifestJS, { arrayMerge: unionMerge });
+  }
+  return manifest;
+} 
+
+module.exports = {
+  getManifestData,
+  unionMerge,
+  readManifestJSONFile,
+  readImportedManifestFile,
+  hasManifest,
+  find,
+}

package/src/cli/start.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const { main: pkgJSONMain } = JSON.parse(fs.readFileSync('./package.json', 'utf-8'));
+
+// Run script hook verifies that requirements for running an App in
+// in developerMode (via Socket Mode) are met
+(function _(cwd, customPath) {
+  // TODO - Format so that its less miss-able in output
+  console.log('Preparing local run in developer mode (Socket Mode)');
+  // Check required local run tokens
+  validate();
+
+  // tries the provided path, then package.json main, then defaults to index.js in the current 
+  // working directory
+  const pkgJSONDefault = 'index.js';
+  const fullPath = path.resolve(cwd, customPath ? customPath : pkgJSONMain ? pkgJSONMain : pkgJSONDefault);
+  console.log(fullPath);
+
+  // Kick off a subprocess to run the app in development mode
+  const app = spawn('node', [`${fullPath}`]);
+  app.stdout.setEncoding('utf-8');
+  app.stdout.on('data', (data) => {
+    process.stdout.write(data);
+  });
+  app.stderr.on('data', (data) => {
+    process.stderr.write(data);
+  });
+
+  app.on('close', (code) => {
+    console.log(`bolt-app local run exited with code ${code}`);
+  });
+}(process.cwd(), process.env.SLACK_CLI_CUSTOM_FILE_PATH));
+
+function validate() {
+  if (!process.env.SLACK_CLI_XOXB) {
+    throw new Error('Missing local run bot token. Please see slack-cli maintainers to troubleshoot.');
+  }
+  if (!process.env.SLACK_CLI_XAPP) {
+    throw new Error('Missing local run app token. Please see slack-cli maintainers to troubleshoot');
+  }
+}