@particle-academy/slack-js 0.1.3 → 0.2.1

package/dist/index.cjs

@@ -18,10 +18,73 @@ function fakeMessagePost({ config, fake }) {
     }
   };
 }
+function fakeMessageUpdate({ config, fake }) {
+  return {
+    "ok": true,
+    "channel": "C123ABC456",
+    "ts": "1787719200.000100",
+    "text": "Ticket #42 assigned to Rosa."
+  };
+}
+function fakeUserLookupByEmail({ config, fake }) {
+  return {
+    "ok": true,
+    "user": {
+      "id": "U2CERLKJA",
+      "team_id": "T1DC2JH3J",
+      "name": "rosa",
+      "real_name": "Rosa Diaz",
+      "deleted": false,
+      "is_bot": false
+    }
+  };
+}
+function fakeBlockActions({ config, fake }) {
+  return {
+    "type": "block_actions",
+    "team": {
+      "id": "T1DC2JH3J",
+      "domain": "testteamnow"
+    },
+    "enterprise": null,
+    "user": {
+      "id": "U2CERLKJA",
+      "username": "roadrunner",
+      "team_id": "T1DC2JH3J"
+    },
+    "channel": {
+      "id": "C0123ABCD",
+      "name": "support"
+    },
+    "message": {
+      "type": "message",
+      "ts": "1730070000.000100",
+      "text": "Ticket #42: Printer on fire"
+    },
+    "trigger_id": "398738663015.47445629121.803a0bc887a14d10d2c447fce8b6703c",
+    "response_url": "https://hooks.slack.com/actions/T1DC2JH3J/397700885554/96rGlfmibIGlgcZRskXaIFfN",
+    "actions": [
+      {
+        "action_id": "ticket_assign_me",
+        "block_id": "ticket_42",
+        "type": "button",
+        "value": "42",
+        "selected_option": null,
+        "action_ts": "1730070012.345678"
+      }
+    ]
+  };
+}
 var slackFaker = (operation, request) => {
   switch (operation) {
     case "message_post":
       return fakeMessagePost(request);
+    case "message_update":
+      return fakeMessageUpdate(request);
+    case "user_lookup_by_email":
+      return fakeUserLookupByEmail(request);
+    case "block_actions":
+      return fakeBlockActions(request);
     default:
       throw new Error(
         `slack: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
@@ -62,6 +125,13 @@ async function slackMessagePost(options) {
   if (config.text === void 0 || config.text === null || config.text === "") {
     throw new Error(`message_post: "text" is required (Message).`);
   }
+  if (typeof config.blocks === "string" && config.blocks !== "") {
+    try {
+      JSON.parse(config.blocks);
+    } catch (error) {
+      throw new Error(`message_post: "blocks" must be JSON: ${error.message}`);
+    }
+  }
   const result = await fancyConnectorCore.callConnector(SLACK, {
     operation: MESSAGE_POST_OPERATION,
     config,
@@ -76,7 +146,8 @@ async function slackMessagePost(options) {
       path: "/api/chat.postMessage",
       json: {
         "channel": String(config.channel),
-        "text": String(config.text)
+        "text": String(config.text),
+        ...config.blocks !== void 0 && config.blocks !== null && config.blocks !== "" ? { "blocks": typeof config.blocks === "string" ? JSON.parse(config.blocks) : config.blocks } : {}
       }
     }
   });
@@ -88,14 +159,139 @@ async function slackMessagePost(options) {
   }
   return result;
 }
+var MESSAGE_UPDATE_OPERATION = "message_update";
+async function slackMessageUpdate(options) {
+  const config = options.config ?? {};
+  if (config.channel === void 0 || config.channel === null || config.channel === "") {
+    throw new Error(`message_update: "channel" is required (Channel).`);
+  }
+  if (config.ts === void 0 || config.ts === null || config.ts === "") {
+    throw new Error(`message_update: "ts" is required (Message ts).`);
+  }
+  if (config.text === void 0 || config.text === null || config.text === "") {
+    throw new Error(`message_update: "text" is required (Message).`);
+  }
+  if (typeof config.blocks === "string" && config.blocks !== "") {
+    try {
+      JSON.parse(config.blocks);
+    } catch (error) {
+      throw new Error(`message_update: "blocks" must be JSON: ${error.message}`);
+    }
+  }
+  const result = await fancyConnectorCore.callConnector(SLACK, {
+    operation: MESSAGE_UPDATE_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "POST",
+      path: "/api/chat.update",
+      json: {
+        "channel": String(config.channel),
+        "ts": String(config.ts),
+        "text": String(config.text),
+        ...config.blocks !== void 0 && config.blocks !== null && config.blocks !== "" ? { "blocks": typeof config.blocks === "string" ? JSON.parse(config.blocks) : config.blocks } : {}
+      }
+    }
+  });
+  const data = result.data;
+  if (data?.ok === false) {
+    throw new Error(
+      `message_update: Slack rejected chat.update \u2014 ` + String(data.error ?? "no reason given")
+    );
+  }
+  return result;
+}
+var USER_LOOKUP_BY_EMAIL_OPERATION = "user_lookup_by_email";
+async function slackUserLookupByEmail(options) {
+  const config = options.config ?? {};
+  if (config.email === void 0 || config.email === null || config.email === "") {
+    throw new Error(`user_lookup_by_email: "email" is required (Email).`);
+  }
+  const result = await fancyConnectorCore.callConnector(SLACK, {
+    operation: USER_LOOKUP_BY_EMAIL_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    request: {
+      method: "GET",
+      path: "/api/users.lookupByEmail",
+      query: {
+        "email": String(config.email).trim()
+      }
+    }
+  });
+  const data = result.data;
+  if (data?.ok === false) {
+    throw new Error(
+      `user_lookup_by_email: Slack rejected users.lookupByEmail \u2014 ` + String(data.error ?? "no reason given")
+    );
+  }
+  return result;
+}
+var SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER = "X-Slack-Signature";
+var SLACK_BLOCK_ACTIONS_TOLERANCE = 300;
+var SLACK_BLOCK_ACTIONS_SCHEME = {
+  algorithm: "SHA-256",
+  payload: (raw, timestamp) => `v0:${timestamp}:${raw}`,
+  tolerance: SLACK_BLOCK_ACTIONS_TOLERANCE,
+  encoding: "hex"
+};
+function parseSlackSignature(raw) {
+  return raw.startsWith("v0=") ? { signature: raw.slice(3) } : {};
+}
+var SLACK_BLOCK_ACTIONS_DECODE = {
+  kind: "form-field-json",
+  field: "payload"
+};
+var SLACK_BLOCK_ACTIONS = {
+  service: "slack",
+  operation: "block_actions",
+  delivery: "webhook",
+  setup: "In the Slack app's Interactivity & Shortcuts settings, turn interactivity on and set the Request URL to the route your host mounts for this trigger, then put the app's signing secret (Basic Information) on the connection as `signingSecret`. Slack shows the user an error unless the request is answered with a 200 within 3 seconds, so the host must acknowledge FIRST and run the graph after.",
+  verification: {
+    signatureHeader: SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER,
+    scheme: SLACK_BLOCK_ACTIONS_SCHEME,
+    timestampHeader: "X-Slack-Request-Timestamp",
+    parse: parseSlackSignature
+  },
+  decode: SLACK_BLOCK_ACTIONS_DECODE,
+  faker: slackFaker
+};
+function verifySlackDelivery(delivery, signingSecret, now) {
+  return fancyConnectorCore.verifyDelivery(SLACK_BLOCK_ACTIONS, delivery, signingSecret, now);
+}
+function decodeSlackDelivery(raw) {
+  return fancyConnectorCore.decodeDelivery(SLACK_BLOCK_ACTIONS_DECODE, raw);
+}
 
 exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
 exports.MESSAGE_POST_OPERATION = MESSAGE_POST_OPERATION;
+exports.MESSAGE_UPDATE_OPERATION = MESSAGE_UPDATE_OPERATION;
 exports.SLACK = SLACK;
 exports.SLACK_BASE_URLS = SLACK_BASE_URLS;
+exports.SLACK_BLOCK_ACTIONS = SLACK_BLOCK_ACTIONS;
+exports.SLACK_BLOCK_ACTIONS_DECODE = SLACK_BLOCK_ACTIONS_DECODE;
+exports.SLACK_BLOCK_ACTIONS_SCHEME = SLACK_BLOCK_ACTIONS_SCHEME;
+exports.SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER = SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER;
+exports.SLACK_BLOCK_ACTIONS_TOLERANCE = SLACK_BLOCK_ACTIONS_TOLERANCE;
 exports.SLACK_REQUIRES = SLACK_REQUIRES;
+exports.USER_LOOKUP_BY_EMAIL_OPERATION = USER_LOOKUP_BY_EMAIL_OPERATION;
+exports.decodeSlackDelivery = decodeSlackDelivery;
+exports.parseSlackSignature = parseSlackSignature;
 exports.slackAuthorize = slackAuthorize;
 exports.slackFaker = slackFaker;
 exports.slackMessagePost = slackMessagePost;
+exports.slackMessageUpdate = slackMessageUpdate;
+exports.slackUserLookupByEmail = slackUserLookupByEmail;
+exports.verifySlackDelivery = verifySlackDelivery;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/message-post.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * The Slack faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Slack actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeMessagePost({ config, fake }: FakeRequest): unknown {\n  return {\n    \"ok\": true,\n    \"channel\": \"C123ABC456\",\n    \"ts\": \"1787719200.000100\",\n    \"message\": {\n      \"user\": \"U012AB3CDE\",\n      \"type\": \"message\",\n      \"ts\": \"1787719200.000100\",\n      \"text\": \"Deployment finished successfully.\",\n      \"app_id\": \"A012BC3DEF\",\n      \"bot_id\": \"B012AB3CD\",\n    },\n  };\n}\n\nexport const slackFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"message_post\":\n      return fakeMessagePost(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `slack: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Slack, as one service descriptor shared by every Slack operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Slack: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Install the app into a dedicated development workspace or Slack developer\n * sandbox. Messages are real inside that workspace, but its users and data are\n * separate from production. Developer sandboxes expire by default and have\n * feature and integration limits.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { slackFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const SLACK_BASE_URLS = {\n  \"live\": \"https://slack.com\",\n  \"sandbox\": \"https://slack.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const SLACK_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Slack's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function slackAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Slack service, for the TypeScript runtime. */\nexport const SLACK: ServiceDescriptor = {\n  service: \"slack\",\n  title: \"Slack\",\n  sandbox: \"separate-account\",\n  baseUrls: { ...SLACK_BASE_URLS },\n  requires: [...SLACK_REQUIRES],\n  authorize: slackAuthorize,\n  faker: slackFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-post.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-post.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Post a text message to a Slack channel or conversation.\n *\n * POST /api/chat.postMessage —\n * https://docs.slack.dev/reference/methods/chat.postMessage\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Slack or calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { SLACK } from \"../service.js\";\n\nexport const MESSAGE_POST_OPERATION = \"message_post\";\n\nexport type MessagePostOptions = {\n  /** The node's resolved config. Keys: channel, text. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function slackMessagePost(options: MessagePostOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.channel === undefined || config.channel === null || config.channel === \"\") {\n    throw new Error(`message_post: \"channel\" is required (Channel).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`message_post: \"text\" is required (Message).`);\n  }\n\n  const result = await callConnector(SLACK, {\n    operation: MESSAGE_POST_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/api/chat.postMessage\",\n      json: {\n        \"channel\": String(config.channel),\n        \"text\": String(config.text),\n      },\n    },\n  });\n\n  // Slack answers HTTP 200 with `{ok: false}` for an application-level\n  // failure. A status check alone reads that as success, so the call is\n  // reported as having worked and the next node receives a body that says\n  // otherwise.\n  const data = result.data as Record<string, unknown> | undefined;\n\n  if (data?.ok === false) {\n    throw new Error(\n      `message_post: Slack rejected chat.postMessage — ` +\n        String(data.error ?? \"no reason given\"),\n    );\n  }\n\n  return result;\n}\n"]}
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/message-post.ts","../src/actions/message-update.ts","../src/actions/user-lookup-by-email.ts","../src/triggers/block-actions.ts"],"names":["callConnector","verifyDelivery","decodeDelivery"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * The Slack faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Slack actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeMessagePost({ config, fake }: FakeRequest): unknown {\n  return {\n    \"ok\": true,\n    \"channel\": \"C123ABC456\",\n    \"ts\": \"1787719200.000100\",\n    \"message\": {\n      \"user\": \"U012AB3CDE\",\n      \"type\": \"message\",\n      \"ts\": \"1787719200.000100\",\n      \"text\": \"Deployment finished successfully.\",\n      \"app_id\": \"A012BC3DEF\",\n      \"bot_id\": \"B012AB3CD\",\n    },\n  };\n}\n\nfunction fakeMessageUpdate({ config, fake }: FakeRequest): unknown {\n  return {\n    \"ok\": true,\n    \"channel\": \"C123ABC456\",\n    \"ts\": \"1787719200.000100\",\n    \"text\": \"Ticket #42 assigned to Rosa.\",\n  };\n}\n\nfunction fakeUserLookupByEmail({ config, fake }: FakeRequest): unknown {\n  return {\n    \"ok\": true,\n    \"user\": {\n      \"id\": \"U2CERLKJA\",\n      \"team_id\": \"T1DC2JH3J\",\n      \"name\": \"rosa\",\n      \"real_name\": \"Rosa Diaz\",\n      \"deleted\": false,\n      \"is_bot\": false,\n    },\n  };\n}\n\nfunction fakeBlockActions({ config, fake }: FakeRequest): unknown {\n  return {\n    \"type\": \"block_actions\",\n    \"team\": {\n      \"id\": \"T1DC2JH3J\",\n      \"domain\": \"testteamnow\",\n    },\n    \"enterprise\": null,\n    \"user\": {\n      \"id\": \"U2CERLKJA\",\n      \"username\": \"roadrunner\",\n      \"team_id\": \"T1DC2JH3J\",\n    },\n    \"channel\": {\n      \"id\": \"C0123ABCD\",\n      \"name\": \"support\",\n    },\n    \"message\": {\n      \"type\": \"message\",\n      \"ts\": \"1730070000.000100\",\n      \"text\": \"Ticket #42: Printer on fire\",\n    },\n    \"trigger_id\": \"398738663015.47445629121.803a0bc887a14d10d2c447fce8b6703c\",\n    \"response_url\": \"https://hooks.slack.com/actions/T1DC2JH3J/397700885554/96rGlfmibIGlgcZRskXaIFfN\",\n    \"actions\": [\n      {\n        \"action_id\": \"ticket_assign_me\",\n        \"block_id\": \"ticket_42\",\n        \"type\": \"button\",\n        \"value\": \"42\",\n        \"selected_option\": null,\n        \"action_ts\": \"1730070012.345678\",\n      },\n    ],\n  };\n}\n\nexport const slackFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"message_post\":\n      return fakeMessagePost(request);\n\n    case \"message_update\":\n      return fakeMessageUpdate(request);\n\n    case \"user_lookup_by_email\":\n      return fakeUserLookupByEmail(request);\n\n    case \"block_actions\":\n      return fakeBlockActions(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `slack: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Slack, as one service descriptor shared by every Slack operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Slack: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Install the app into a dedicated development workspace or Slack developer\n * sandbox. Messages are real inside that workspace, but its users and data are\n * separate from production. Developer sandboxes expire by default and have\n * feature and integration limits.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { slackFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const SLACK_BASE_URLS = {\n  \"live\": \"https://slack.com\",\n  \"sandbox\": \"https://slack.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const SLACK_REQUIRES = [\n  \"accessToken\",\n  \"refreshToken\",\n  \"clientId\",\n  \"clientSecret\"\n] as const;\n\n/**\n * Apply Slack's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function slackAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers.Authorization = `Bearer ${credentials.accessToken ?? \"\"}`;\n}\n\n/** The Slack service, for the TypeScript runtime. */\nexport const SLACK: ServiceDescriptor = {\n  service: \"slack\",\n  title: \"Slack\",\n  sandbox: \"separate-account\",\n  baseUrls: { ...SLACK_BASE_URLS },\n  requires: [...SLACK_REQUIRES],\n  authorize: slackAuthorize,\n  faker: slackFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-post.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-post.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Post a text message to a Slack channel or conversation.\n *\n * POST /api/chat.postMessage —\n * https://docs.slack.dev/reference/methods/chat.postMessage\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Slack or calls the faker.\n *\n * sideEffects: unsafe-to-replay.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { SLACK } from \"../service.js\";\n\nexport const MESSAGE_POST_OPERATION = \"message_post\";\n\nexport type MessagePostOptions = {\n  /** The node's resolved config. Keys: channel, text, blocks. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function slackMessagePost(options: MessagePostOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.channel === undefined || config.channel === null || config.channel === \"\") {\n    throw new Error(`message_post: \"channel\" is required (Channel).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`message_post: \"text\" is required (Message).`);\n  }\n\n  if (typeof config.blocks === \"string\" && config.blocks !== \"\") {\n    try {\n      JSON.parse(config.blocks);\n    } catch (error) {\n      throw new Error(`message_post: \"blocks\" must be JSON: ${(error as Error).message}`);\n    }\n  }\n\n  const result = await callConnector(SLACK, {\n    operation: MESSAGE_POST_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/api/chat.postMessage\",\n      json: {\n        \"channel\": String(config.channel),\n        \"text\": String(config.text),\n        ...(config.blocks !== undefined && config.blocks !== null && config.blocks !== \"\" ? { \"blocks\": typeof config.blocks === \"string\" ? JSON.parse(config.blocks) : config.blocks } : {}),\n      },\n    },\n  });\n\n  // Slack answers HTTP 200 with `{ok: false}` for an application-level\n  // failure. A status check alone reads that as success, so the call is\n  // reported as having worked and the next node receives a body that says\n  // otherwise.\n  const data = result.data as Record<string, unknown> | undefined;\n\n  if (data?.ok === false) {\n    throw new Error(\n      `message_post: Slack rejected chat.postMessage — ` +\n        String(data.error ?? \"no reason given\"),\n    );\n  }\n\n  return result;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/message-update.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/message-update.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Replace the text and blocks of a Slack message the app posted.\n *\n * POST /api/chat.update — https://docs.slack.dev/reference/methods/chat.update\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Slack or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { SLACK } from \"../service.js\";\n\nexport const MESSAGE_UPDATE_OPERATION = \"message_update\";\n\nexport type MessageUpdateOptions = {\n  /** The node's resolved config. Keys: channel, ts, text, blocks. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function slackMessageUpdate(options: MessageUpdateOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.channel === undefined || config.channel === null || config.channel === \"\") {\n    throw new Error(`message_update: \"channel\" is required (Channel).`);\n  }\n\n  if (config.ts === undefined || config.ts === null || config.ts === \"\") {\n    throw new Error(`message_update: \"ts\" is required (Message ts).`);\n  }\n\n  if (config.text === undefined || config.text === null || config.text === \"\") {\n    throw new Error(`message_update: \"text\" is required (Message).`);\n  }\n\n  if (typeof config.blocks === \"string\" && config.blocks !== \"\") {\n    try {\n      JSON.parse(config.blocks);\n    } catch (error) {\n      throw new Error(`message_update: \"blocks\" must be JSON: ${(error as Error).message}`);\n    }\n  }\n\n  const result = await callConnector(SLACK, {\n    operation: MESSAGE_UPDATE_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"POST\",\n      path: \"/api/chat.update\",\n      json: {\n        \"channel\": String(config.channel),\n        \"ts\": String(config.ts),\n        \"text\": String(config.text),\n        ...(config.blocks !== undefined && config.blocks !== null && config.blocks !== \"\" ? { \"blocks\": typeof config.blocks === \"string\" ? JSON.parse(config.blocks) : config.blocks } : {}),\n      },\n    },\n  });\n\n  // Slack answers HTTP 200 with `{ok: false}` for an application-level\n  // failure. A status check alone reads that as success, so the call is\n  // reported as having worked and the next node receives a body that says\n  // otherwise.\n  const data = result.data as Record<string, unknown> | undefined;\n\n  if (data?.ok === false) {\n    throw new Error(\n      `message_update: Slack rejected chat.update — ` +\n        String(data.error ?? \"no reason given\"),\n    );\n  }\n\n  return result;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/user-lookup-by-email.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/user-lookup-by-email.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Find the Slack user in this workspace who has a given email address.\n *\n * GET /api/users.lookupByEmail —\n * https://docs.slack.dev/reference/methods/users.lookupByEmail\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Slack or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { SLACK } from \"../service.js\";\n\nexport const USER_LOOKUP_BY_EMAIL_OPERATION = \"user_lookup_by_email\";\n\nexport type UserLookupByEmailOptions = {\n  /** The node's resolved config. Keys: email. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function slackUserLookupByEmail(options: UserLookupByEmailOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.email === undefined || config.email === null || config.email === \"\") {\n    throw new Error(`user_lookup_by_email: \"email\" is required (Email).`);\n  }\n\n  const result = await callConnector(SLACK, {\n    operation: USER_LOOKUP_BY_EMAIL_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    request: {\n      method: \"GET\",\n      path: \"/api/users.lookupByEmail\",\n      query: {\n        \"email\": String(config.email).trim(),\n      },\n    },\n  });\n\n  // Slack answers HTTP 200 with `{ok: false}` for an application-level\n  // failure. A status check alone reads that as success, so the call is\n  // reported as having worked and the next node receives a body that says\n  // otherwise.\n  const data = result.data as Record<string, unknown> | undefined;\n\n  if (data?.ok === false) {\n    throw new Error(\n      `user_lookup_by_email: Slack rejected users.lookupByEmail — ` +\n        String(data.error ?? \"no reason given\"),\n    );\n  }\n\n  return result;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/triggers/block-actions.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/triggers/block-actions.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- slack\n */\n\n/**\n * Slack's webhook trigger — the delivery contract.\n *\n * Kept beside the service descriptor rather than inside a node, because a\n * signature scheme is a fact about SLACK. Two Slack triggers must not be able\n * to disagree about how a delivery is verified.\n */\n\nimport { decodeDelivery, verifyDelivery, type DeliveryDecode, type HmacScheme, type InboundDelivery, type TriggerDescriptor, type WebhookVerification } from \"@particle-academy/fancy-connector-core\";\nimport { slackFaker } from \"../faker.js\";\n\nexport const SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER = \"X-Slack-Signature\";\n/** The provider's documented replay window, in seconds. */\nexport const SLACK_BLOCK_ACTIONS_TOLERANCE = 300;\n\nexport const SLACK_BLOCK_ACTIONS_SCHEME: HmacScheme = {\n  algorithm: \"SHA-256\",\n  payload: (raw, timestamp) => `v0:${timestamp}:${raw}`,\n  tolerance: SLACK_BLOCK_ACTIONS_TOLERANCE,\n  encoding: \"hex\",\n};\n\n/** Strip the `v0=` prefix the provider sends. Without it, there is no signature. */\nexport function parseSlackSignature(raw: string): { signature?: string } {\n  return raw.startsWith(\"v0=\") ? { signature: raw.slice(3) } : {};\n}\n\nexport const SLACK_BLOCK_ACTIONS_DECODE: DeliveryDecode = {\n  kind: \"form-field-json\",\n  field: \"payload\",\n};\n\nexport const SLACK_BLOCK_ACTIONS: TriggerDescriptor = {\n  service: \"slack\",\n  operation: \"block_actions\",\n  delivery: \"webhook\",\n  setup:\n    \"In the Slack app's Interactivity & Shortcuts settings, turn interactivity on and set the Request URL to the route your host mounts for this trigger, then put the app's signing secret (Basic Information) on the connection as `signingSecret`. Slack shows the user an error unless the request is answered with a 200 within 3 seconds, so the host must acknowledge FIRST and run the graph after.\",\n  verification: {\n    signatureHeader: SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER,\n    scheme: SLACK_BLOCK_ACTIONS_SCHEME,\n    timestampHeader: \"X-Slack-Request-Timestamp\",\n    parse: parseSlackSignature,\n  },\n  decode: SLACK_BLOCK_ACTIONS_DECODE,\n  faker: slackFaker,\n};\n\n/**\n * Verify one inbound Slack delivery.\n *\n * The host calls this BEFORE starting a run, with the body exactly as\n * received. Re-serialised JSON changes key order and whitespace, and produces\n * a mismatch that looks precisely like a wrong secret — hours of debugging the\n * wrong thing.\n *\n * The secret is the connection's `signingSecret`.\n */\nexport function verifySlackDelivery(\n  delivery: InboundDelivery,\n  signingSecret: string | undefined,\n  now?: number,\n): Promise<WebhookVerification> {\n  return verifyDelivery(SLACK_BLOCK_ACTIONS, delivery, signingSecret, now);\n}\n\n/**\n * Read one VERIFIED Slack delivery.\n *\n * The body is not plain JSON: it is form-field-json, with the payload in the\n * `payload` field. The host calls this AFTER `verifySlackDelivery` has\n * accepted the delivery, with the SAME raw bytes, and starts the run with what\n * it returns. A body that cannot be read is refused by name, never passed on.\n */\nexport function decodeSlackDelivery(raw: Uint8Array | string): unknown {\n  return decodeDelivery(SLACK_BLOCK_ACTIONS_DECODE, raw);\n}\n"]}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult, TriggerDescriptor, DeliveryDecode, HmacScheme, InboundDelivery, WebhookVerification } from '@particle-academy/fancy-connector-core';
 
 /**
  * GENERATED FILE — do not edit.
@@ -101,7 +101,7 @@ declare const slackFaker: ConnectorFaker;
 
 declare const MESSAGE_POST_OPERATION = "message_post";
 type MessagePostOptions = {
-    /** The node's resolved config. Keys: channel, text. */
+    /** The node's resolved config. Keys: channel, text, blocks. */
     config: Record<string, unknown>;
     credentials?: Record<string, string | undefined>;
     mode?: RequestedMode;
@@ -113,4 +113,122 @@ type MessagePostOptions = {
 };
 declare function slackMessagePost(options: MessagePostOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, type MessagePostOptions, SLACK, SLACK_BASE_URLS, SLACK_REQUIRES, slackAuthorize, slackFaker, slackMessagePost };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/message-update.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/message-update.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Replace the text and blocks of a Slack message the app posted.
+ *
+ * POST /api/chat.update — https://docs.slack.dev/reference/methods/chat.update
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Slack or calls the faker.
+ */
+
+declare const MESSAGE_UPDATE_OPERATION = "message_update";
+type MessageUpdateOptions = {
+    /** The node's resolved config. Keys: channel, ts, text, blocks. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function slackMessageUpdate(options: MessageUpdateOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/user-lookup-by-email.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/user-lookup-by-email.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Find the Slack user in this workspace who has a given email address.
+ *
+ * GET /api/users.lookupByEmail —
+ * https://docs.slack.dev/reference/methods/users.lookupByEmail
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Slack or calls the faker.
+ */
+
+declare const USER_LOOKUP_BY_EMAIL_OPERATION = "user_lookup_by_email";
+type UserLookupByEmailOptions = {
+    /** The node's resolved config. Keys: email. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function slackUserLookupByEmail(options: UserLookupByEmailOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/triggers/block-actions.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/triggers/block-actions.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Slack's webhook trigger — the delivery contract.
+ *
+ * Kept beside the service descriptor rather than inside a node, because a
+ * signature scheme is a fact about SLACK. Two Slack triggers must not be able
+ * to disagree about how a delivery is verified.
+ */
+
+declare const SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER = "X-Slack-Signature";
+/** The provider's documented replay window, in seconds. */
+declare const SLACK_BLOCK_ACTIONS_TOLERANCE = 300;
+declare const SLACK_BLOCK_ACTIONS_SCHEME: HmacScheme;
+/** Strip the `v0=` prefix the provider sends. Without it, there is no signature. */
+declare function parseSlackSignature(raw: string): {
+    signature?: string;
+};
+declare const SLACK_BLOCK_ACTIONS_DECODE: DeliveryDecode;
+declare const SLACK_BLOCK_ACTIONS: TriggerDescriptor;
+/**
+ * Verify one inbound Slack delivery.
+ *
+ * The host calls this BEFORE starting a run, with the body exactly as
+ * received. Re-serialised JSON changes key order and whitespace, and produces
+ * a mismatch that looks precisely like a wrong secret — hours of debugging the
+ * wrong thing.
+ *
+ * The secret is the connection's `signingSecret`.
+ */
+declare function verifySlackDelivery(delivery: InboundDelivery, signingSecret: string | undefined, now?: number): Promise<WebhookVerification>;
+/**
+ * Read one VERIFIED Slack delivery.
+ *
+ * The body is not plain JSON: it is form-field-json, with the payload in the
+ * `payload` field. The host calls this AFTER `verifySlackDelivery` has
+ * accepted the delivery, with the SAME raw bytes, and starts the run with what
+ * it returns. A body that cannot be read is refused by name, never passed on.
+ */
+declare function decodeSlackDelivery(raw: Uint8Array | string): unknown;
+
+export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, MESSAGE_UPDATE_OPERATION, type MessagePostOptions, type MessageUpdateOptions, SLACK, SLACK_BASE_URLS, SLACK_BLOCK_ACTIONS, SLACK_BLOCK_ACTIONS_DECODE, SLACK_BLOCK_ACTIONS_SCHEME, SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER, SLACK_BLOCK_ACTIONS_TOLERANCE, SLACK_REQUIRES, USER_LOOKUP_BY_EMAIL_OPERATION, type UserLookupByEmailOptions, decodeSlackDelivery, parseSlackSignature, slackAuthorize, slackFaker, slackMessagePost, slackMessageUpdate, slackUserLookupByEmail, verifySlackDelivery };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult, TriggerDescriptor, DeliveryDecode, HmacScheme, InboundDelivery, WebhookVerification } from '@particle-academy/fancy-connector-core';
 
 /**
  * GENERATED FILE — do not edit.
@@ -101,7 +101,7 @@ declare const slackFaker: ConnectorFaker;
 
 declare const MESSAGE_POST_OPERATION = "message_post";
 type MessagePostOptions = {
-    /** The node's resolved config. Keys: channel, text. */
+    /** The node's resolved config. Keys: channel, text, blocks. */
     config: Record<string, unknown>;
     credentials?: Record<string, string | undefined>;
     mode?: RequestedMode;
@@ -113,4 +113,122 @@ type MessagePostOptions = {
 };
 declare function slackMessagePost(options: MessagePostOptions): Promise<ConnectorResult>;
 
-export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, type MessagePostOptions, SLACK, SLACK_BASE_URLS, SLACK_REQUIRES, slackAuthorize, slackFaker, slackMessagePost };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/message-update.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/message-update.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Replace the text and blocks of a Slack message the app posted.
+ *
+ * POST /api/chat.update — https://docs.slack.dev/reference/methods/chat.update
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Slack or calls the faker.
+ */
+
+declare const MESSAGE_UPDATE_OPERATION = "message_update";
+type MessageUpdateOptions = {
+    /** The node's resolved config. Keys: channel, ts, text, blocks. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function slackMessageUpdate(options: MessageUpdateOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/user-lookup-by-email.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/user-lookup-by-email.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Find the Slack user in this workspace who has a given email address.
+ *
+ * GET /api/users.lookupByEmail —
+ * https://docs.slack.dev/reference/methods/users.lookupByEmail
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Slack or calls the faker.
+ */
+
+declare const USER_LOOKUP_BY_EMAIL_OPERATION = "user_lookup_by_email";
+type UserLookupByEmailOptions = {
+    /** The node's resolved config. Keys: email. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function slackUserLookupByEmail(options: UserLookupByEmailOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/triggers/block-actions.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/triggers/block-actions.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- slack
+ */
+/**
+ * Slack's webhook trigger — the delivery contract.
+ *
+ * Kept beside the service descriptor rather than inside a node, because a
+ * signature scheme is a fact about SLACK. Two Slack triggers must not be able
+ * to disagree about how a delivery is verified.
+ */
+
+declare const SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER = "X-Slack-Signature";
+/** The provider's documented replay window, in seconds. */
+declare const SLACK_BLOCK_ACTIONS_TOLERANCE = 300;
+declare const SLACK_BLOCK_ACTIONS_SCHEME: HmacScheme;
+/** Strip the `v0=` prefix the provider sends. Without it, there is no signature. */
+declare function parseSlackSignature(raw: string): {
+    signature?: string;
+};
+declare const SLACK_BLOCK_ACTIONS_DECODE: DeliveryDecode;
+declare const SLACK_BLOCK_ACTIONS: TriggerDescriptor;
+/**
+ * Verify one inbound Slack delivery.
+ *
+ * The host calls this BEFORE starting a run, with the body exactly as
+ * received. Re-serialised JSON changes key order and whitespace, and produces
+ * a mismatch that looks precisely like a wrong secret — hours of debugging the
+ * wrong thing.
+ *
+ * The secret is the connection's `signingSecret`.
+ */
+declare function verifySlackDelivery(delivery: InboundDelivery, signingSecret: string | undefined, now?: number): Promise<WebhookVerification>;
+/**
+ * Read one VERIFIED Slack delivery.
+ *
+ * The body is not plain JSON: it is form-field-json, with the payload in the
+ * `payload` field. The host calls this AFTER `verifySlackDelivery` has
+ * accepted the delivery, with the SAME raw bytes, and starts the run with what
+ * it returns. A body that cannot be read is refused by name, never passed on.
+ */
+declare function decodeSlackDelivery(raw: Uint8Array | string): unknown;
+
+export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, MESSAGE_UPDATE_OPERATION, type MessagePostOptions, type MessageUpdateOptions, SLACK, SLACK_BASE_URLS, SLACK_BLOCK_ACTIONS, SLACK_BLOCK_ACTIONS_DECODE, SLACK_BLOCK_ACTIONS_SCHEME, SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER, SLACK_BLOCK_ACTIONS_TOLERANCE, SLACK_REQUIRES, USER_LOOKUP_BY_EMAIL_OPERATION, type UserLookupByEmailOptions, decodeSlackDelivery, parseSlackSignature, slackAuthorize, slackFaker, slackMessagePost, slackMessageUpdate, slackUserLookupByEmail, verifySlackDelivery };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, SLACK, SLACK_BASE_URLS, SLACK_REQUIRES, slackAuthorize, slackFaker, slackMessagePost } from './chunk-SWUB2VUX.js';
+export { CONNECTOR_API_VERSION, MESSAGE_POST_OPERATION, MESSAGE_UPDATE_OPERATION, SLACK, SLACK_BASE_URLS, SLACK_BLOCK_ACTIONS, SLACK_BLOCK_ACTIONS_DECODE, SLACK_BLOCK_ACTIONS_SCHEME, SLACK_BLOCK_ACTIONS_SIGNATURE_HEADER, SLACK_BLOCK_ACTIONS_TOLERANCE, SLACK_REQUIRES, USER_LOOKUP_BY_EMAIL_OPERATION, decodeSlackDelivery, parseSlackSignature, slackAuthorize, slackFaker, slackMessagePost, slackMessageUpdate, slackUserLookupByEmail, verifySlackDelivery } from './chunk-77FLOHBR.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/slack-js",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Slack for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
   "repository": {
     "type": "git",
@@ -38,6 +38,7 @@
   },
   "files": [
     "dist",
+    "art",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -49,11 +50,11 @@
     "prepublishOnly": "tsup"
   },
   "dependencies": {
-    "@particle-academy/fancy-connector-core": ">=0.4.0 <2.0"
+    "@particle-academy/fancy-connector-core": ">=0.11.0 <2.0"
   },
   "peerDependencies": {
     "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
-    "@particle-academy/slack-ui": ">=0.1.0 <0.2.0"
+    "@particle-academy/slack-ui": ">=0.2.0 <0.3.0"
   },
   "peerDependenciesMeta": {
     "@particle-academy/fancy-flow": {