@objectstack/connector-slack 7.4.0

package/.turbo/turbo-build.log

@@ -0,0 +1,22 @@
+
+> @objectstack/connector-slack@7.4.0 build /home/runner/work/framework/framework/packages/connectors/connector-slack
+> tsup --config ../../../tsup.config.ts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/framework/framework/tsup.config.ts
+CLI Target: es2020
+CLI Cleaning output folder
+ESM Build start
+CJS Build start
+ESM dist/index.mjs     5.34 KB
+ESM dist/index.mjs.map 15.18 KB
+ESM ⚡️ Build success in 137ms
+CJS dist/index.js     6.42 KB
+CJS dist/index.js.map 16.33 KB
+CJS ⚡️ Build success in 148ms
+DTS Build start
+DTS ⚡️ Build success in 14590ms
+DTS dist/index.d.mts 4.81 KB
+DTS dist/index.d.ts  4.81 KB

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# @objectstack/connector-slack
+
+## 7.4.0
+
+### Patch Changes
+
+- Updated dependencies [23c7107]
+- Updated dependencies [c72daad]
+- Updated dependencies [f115182]
+- Updated dependencies [2faf9f2]
+- Updated dependencies [2faf9f2]
+- Updated dependencies [2faf9f2]
+- Updated dependencies [58b450b]
+- Updated dependencies [82eb6cf]
+- Updated dependencies [13d8653]
+- Updated dependencies [ff3d006]
+- Updated dependencies [5e831de]
+  - @objectstack/spec@7.4.0
+  - @objectstack/core@7.4.0

package/LICENSE

@@ -0,0 +1,93 @@
+License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Parameters
+
+Licensor:             ObjectStack AI LLC
+Licensed Work:        ObjectStack Runtime: the BSL-licensed packages
+                      of the ObjectStack monorepo as listed in LICENSING.md.
+                      Copyright (c) 2026 ObjectStack AI LLC.
+Additional Use Grant: You may make production use of the Licensed Work, provided
+                      Your use does not include offering the Licensed Work to third
+                      parties on a hosted or embedded basis in order to compete with 
+                      ObjectStack AI LLC's paid version(s) of the Licensed Work. For purposes 
+                      of this license:
+
+                      A "competitive offering" is a Product that is offered to third
+                      parties on a paid basis, including through paid support 
+                      arrangements, that significantly overlaps with the capabilities 
+                      of ObjectStack AI LLC's paid version(s) of the Licensed Work. If Your 
+                      Product is not a competitive offering when You first make it 
+                      generally available, it will not become a competitive offering
+                      later due to ObjectStack AI LLC releasing a new version of the Licensed 
+                      Work with additional capabilities. In addition, Products that 
+                      are not provided on a paid basis are not competitive.
+
+                      "Product" means software that is offered to end users to manage 
+                      in their own environments or offered as a service on a hosted 
+                      basis.
+
+                      "Embedded" means including the source code or executable code 
+                      from the Licensed Work in a competitive offering. "Embedded" 
+                      also means packaging the competitive offering in such a way 
+                      that the Licensed Work must be accessed or downloaded for the 
+                      competitive offering to operate.
+
+                      Hosting or using the Licensed Work(s) for internal purposes 
+                      within an organization is not considered a competitive 
+                      offering. ObjectStack AI LLC considers your organization to include all 
+                      of your affiliates under common control.
+
+                      For binding interpretive guidance on using ObjectStack AI LLC products 
+                      under the Business Source License, please visit our FAQ. 
+                      (see LICENSING.md in this repository)
+Change Date:          Four years from the date the Licensed Work is published.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact licensing@objectstack.dev.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.

package/dist/index.d.mts

@@ -0,0 +1,105 @@
+import { Connector } from '@objectstack/spec/integration';
+import { Plugin, PluginContext } from '@objectstack/core';
+
+/**
+ * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second
+ * reference implementation after `@objectstack/connector-rest`. It produces a
+ * {@link Connector} definition plus handlers for a small set of Slack Web API
+ * actions, which the baseline `connector_action` node dispatches to.
+ *
+ * Scope (ADR-0022 "raw API call" path): this is the *integration mechanism*
+ * for talking to Slack's API — "post this exact text to this channel". It is
+ * deliberately **not** the human-notification layer: there is no preference
+ * matrix, inbox, outbox, or thread/session semantics here. Those belong to a
+ * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport
+ * to this connector.
+ *
+ * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),
+ * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,
+ * credential vaulting, and multi-tenant connection lifecycle are the enterprise
+ * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.
+ *
+ * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the
+ * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers
+ * therefore surface `ok` from the payload, not from the HTTP status, and never
+ * throw on a logical failure — the flow author branches on `${node.ok}`.
+ */
+interface SlackConnectorOptions {
+    /** Connector machine name (snake_case). Defaults to `slack`. */
+    name?: string;
+    /** Human-readable label. Defaults to `Slack`. */
+    label?: string;
+    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */
+    token: string;
+    /** Web API base URL. Defaults to `https://slack.com/api`. */
+    baseUrl?: string;
+    /** Headers merged into every request (request-level headers win). */
+    defaultHeaders?: Record<string, string>;
+    /** Injected for tests; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/** Input accepted by `chat.postMessage`. */
+interface SlackPostMessageInput {
+    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */
+    channel: string;
+    /** Message text (fallback when `blocks` are present). */
+    text?: string;
+    /** Thread root `ts` to reply into an existing thread. */
+    thread_ts?: string;
+    /** Block Kit blocks. */
+    blocks?: unknown[];
+    [key: string]: unknown;
+}
+/** Generic Slack Web API result envelope. */
+interface SlackResult {
+    /** Slack's logical success flag (from the JSON body, not the HTTP status). */
+    ok: boolean;
+    /** HTTP status (almost always 200 for the Slack Web API). */
+    status: number;
+    /** Full parsed Slack payload. */
+    body: Record<string, unknown>;
+    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */
+    error?: string;
+}
+/** A connector definition paired with its action handlers, ready for registerConnector(). */
+interface SlackConnectorBundle {
+    def: Connector;
+    handlers: Record<string, (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>>;
+}
+declare function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle;
+
+/**
+ * Minimal surface of the automation engine this plugin depends on — the
+ * connector registry from ADR-0018 §Addendum. Kept structural so the plugin
+ * needs no runtime dependency on `@objectstack/service-automation`.
+ */
+interface ConnectorRegistrySurface {
+    registerConnector(def: Connector, handlers: Record<string, (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>>): void;
+    unregisterConnector(name: string): void;
+}
+interface ConnectorSlackPluginOptions extends SlackConnectorOptions {
+}
+/**
+ * ConnectorSlackPlugin — registers a Slack Web API connector on the automation
+ * engine. The second reference concrete connector (ADR-0018 §Addendum); it
+ * enables the ADR-0022 "raw API call" path — a flow's `connector_action` step
+ * can dispatch to `slack.chat.postMessage` without the messaging stack.
+ *
+ * If no automation engine is present the plugin logs and skips — the connector
+ * has nowhere to register, which is not an error.
+ */
+declare class ConnectorSlackPlugin implements Plugin {
+    name: string;
+    version: string;
+    type: "standard";
+    dependencies: string[];
+    private readonly options;
+    private connectorName?;
+    private automation?;
+    constructor(options: ConnectorSlackPluginOptions);
+    init(_ctx: PluginContext): Promise<void>;
+    start(ctx: PluginContext): Promise<void>;
+    stop(_ctx: PluginContext): Promise<void>;
+}
+
+export { type ConnectorRegistrySurface, ConnectorSlackPlugin, type ConnectorSlackPluginOptions, type SlackConnectorBundle, type SlackConnectorOptions, type SlackPostMessageInput, type SlackResult, createSlackConnector };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import { Connector } from '@objectstack/spec/integration';
+import { Plugin, PluginContext } from '@objectstack/core';
+
+/**
+ * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second
+ * reference implementation after `@objectstack/connector-rest`. It produces a
+ * {@link Connector} definition plus handlers for a small set of Slack Web API
+ * actions, which the baseline `connector_action` node dispatches to.
+ *
+ * Scope (ADR-0022 "raw API call" path): this is the *integration mechanism*
+ * for talking to Slack's API — "post this exact text to this channel". It is
+ * deliberately **not** the human-notification layer: there is no preference
+ * matrix, inbox, outbox, or thread/session semantics here. Those belong to a
+ * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport
+ * to this connector.
+ *
+ * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),
+ * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,
+ * credential vaulting, and multi-tenant connection lifecycle are the enterprise
+ * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.
+ *
+ * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the
+ * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers
+ * therefore surface `ok` from the payload, not from the HTTP status, and never
+ * throw on a logical failure — the flow author branches on `${node.ok}`.
+ */
+interface SlackConnectorOptions {
+    /** Connector machine name (snake_case). Defaults to `slack`. */
+    name?: string;
+    /** Human-readable label. Defaults to `Slack`. */
+    label?: string;
+    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */
+    token: string;
+    /** Web API base URL. Defaults to `https://slack.com/api`. */
+    baseUrl?: string;
+    /** Headers merged into every request (request-level headers win). */
+    defaultHeaders?: Record<string, string>;
+    /** Injected for tests; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/** Input accepted by `chat.postMessage`. */
+interface SlackPostMessageInput {
+    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */
+    channel: string;
+    /** Message text (fallback when `blocks` are present). */
+    text?: string;
+    /** Thread root `ts` to reply into an existing thread. */
+    thread_ts?: string;
+    /** Block Kit blocks. */
+    blocks?: unknown[];
+    [key: string]: unknown;
+}
+/** Generic Slack Web API result envelope. */
+interface SlackResult {
+    /** Slack's logical success flag (from the JSON body, not the HTTP status). */
+    ok: boolean;
+    /** HTTP status (almost always 200 for the Slack Web API). */
+    status: number;
+    /** Full parsed Slack payload. */
+    body: Record<string, unknown>;
+    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */
+    error?: string;
+}
+/** A connector definition paired with its action handlers, ready for registerConnector(). */
+interface SlackConnectorBundle {
+    def: Connector;
+    handlers: Record<string, (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>>;
+}
+declare function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle;
+
+/**
+ * Minimal surface of the automation engine this plugin depends on — the
+ * connector registry from ADR-0018 §Addendum. Kept structural so the plugin
+ * needs no runtime dependency on `@objectstack/service-automation`.
+ */
+interface ConnectorRegistrySurface {
+    registerConnector(def: Connector, handlers: Record<string, (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>>): void;
+    unregisterConnector(name: string): void;
+}
+interface ConnectorSlackPluginOptions extends SlackConnectorOptions {
+}
+/**
+ * ConnectorSlackPlugin — registers a Slack Web API connector on the automation
+ * engine. The second reference concrete connector (ADR-0018 §Addendum); it
+ * enables the ADR-0022 "raw API call" path — a flow's `connector_action` step
+ * can dispatch to `slack.chat.postMessage` without the messaging stack.
+ *
+ * If no automation engine is present the plugin logs and skips — the connector
+ * has nowhere to register, which is not an error.
+ */
+declare class ConnectorSlackPlugin implements Plugin {
+    name: string;
+    version: string;
+    type: "standard";
+    dependencies: string[];
+    private readonly options;
+    private connectorName?;
+    private automation?;
+    constructor(options: ConnectorSlackPluginOptions);
+    init(_ctx: PluginContext): Promise<void>;
+    start(ctx: PluginContext): Promise<void>;
+    stop(_ctx: PluginContext): Promise<void>;
+}
+
+export { type ConnectorRegistrySurface, ConnectorSlackPlugin, type ConnectorSlackPluginOptions, type SlackConnectorBundle, type SlackConnectorOptions, type SlackPostMessageInput, type SlackResult, createSlackConnector };

package/dist/index.js

@@ -0,0 +1,194 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ConnectorSlackPlugin: () => ConnectorSlackPlugin,
+  createSlackConnector: () => createSlackConnector
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/slack-connector.ts
+function createSlackConnector(opts) {
+  const name = opts.name ?? "slack";
+  const baseUrl = (opts.baseUrl ?? "https://slack.com/api").replace(/\/+$/, "");
+  const doFetch = opts.fetchImpl ?? fetch;
+  const def = {
+    name,
+    label: opts.label ?? "Slack",
+    type: "api",
+    description: "Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.",
+    icon: "slack",
+    authentication: { type: "bearer", token: opts.token },
+    // Defaulted by ConnectorSchema; set explicitly so the literal satisfies
+    // the (post-parse) Connector output type.
+    status: "active",
+    enabled: true,
+    connectionTimeoutMs: 3e4,
+    requestTimeoutMs: 3e4,
+    actions: [
+      {
+        key: "chat.postMessage",
+        label: "Post Message",
+        description: "Post a message to a channel, DM, or thread (Slack chat.postMessage).",
+        inputSchema: {
+          type: "object",
+          required: ["channel"],
+          properties: {
+            channel: { type: "string", description: "Channel id, user id, or #name" },
+            text: { type: "string", description: "Message text" },
+            thread_ts: { type: "string", description: "Thread root ts to reply into" },
+            blocks: { type: "array", description: "Block Kit blocks" }
+          }
+        },
+        outputSchema: slackOutputSchema()
+      },
+      {
+        key: "chat.update",
+        label: "Update Message",
+        description: "Edit an existing message (Slack chat.update).",
+        inputSchema: {
+          type: "object",
+          required: ["channel", "ts"],
+          properties: {
+            channel: { type: "string", description: "Channel id" },
+            ts: { type: "string", description: "Timestamp of the message to update" },
+            text: { type: "string", description: "New message text" },
+            blocks: { type: "array", description: "New Block Kit blocks" }
+          }
+        },
+        outputSchema: slackOutputSchema()
+      },
+      {
+        key: "call",
+        label: "Call Web API Method",
+        description: "Escape hatch \u2014 call any Slack Web API method with arbitrary params.",
+        inputSchema: {
+          type: "object",
+          required: ["method"],
+          properties: {
+            method: { type: "string", description: "Web API method, e.g. conversations.list" },
+            params: { type: "object", description: "Method parameters (JSON body)" }
+          }
+        },
+        outputSchema: slackOutputSchema()
+      }
+    ]
+  };
+  async function callSlack(method, params) {
+    const headers = {
+      "Content-Type": "application/json; charset=utf-8",
+      ...opts.defaultHeaders,
+      Authorization: `Bearer ${opts.token}`
+    };
+    const response = await doFetch(`${baseUrl}/${method}`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(params)
+    });
+    const body = await response.json();
+    const ok = body.ok === true;
+    return {
+      ok,
+      status: response.status,
+      body,
+      error: ok ? void 0 : body.error
+    };
+  }
+  async function postMessage(input) {
+    return toRecord(await callSlack("chat.postMessage", input));
+  }
+  async function update(input) {
+    return toRecord(await callSlack("chat.update", input));
+  }
+  async function call(input) {
+    const method = String(input.method ?? "");
+    if (!method) throw new Error("slack 'call' action: 'method' is required");
+    const params = input.params ?? {};
+    return toRecord(await callSlack(method, params));
+  }
+  return {
+    def,
+    handlers: {
+      "chat.postMessage": postMessage,
+      "chat.update": update,
+      call
+    }
+  };
+}
+function toRecord(r) {
+  return { ok: r.ok, status: r.status, body: r.body, error: r.error };
+}
+function slackOutputSchema() {
+  return {
+    type: "object",
+    properties: {
+      ok: { type: "boolean", description: "Slack's logical success flag" },
+      status: { type: "number", description: "HTTP status" },
+      body: { type: "object", description: "Full Slack response payload" },
+      error: { type: "string", description: "Slack error code when ok is false" }
+    }
+  };
+}
+
+// src/connector-slack-plugin.ts
+var ConnectorSlackPlugin = class {
+  constructor(options) {
+    this.name = "com.objectstack.connector.slack";
+    this.version = "1.0.0";
+    this.type = "standard";
+    // Ensure the automation engine (and its connector registry) is started first.
+    this.dependencies = ["com.objectstack.service-automation"];
+    this.options = options;
+  }
+  async init(_ctx) {
+  }
+  async start(ctx) {
+    let automation;
+    try {
+      automation = ctx.getService("automation");
+    } catch {
+      automation = void 0;
+    }
+    if (!automation || typeof automation.registerConnector !== "function") {
+      ctx.logger.info("ConnectorSlackPlugin: no automation engine \u2014 Slack connector not registered");
+      return;
+    }
+    const { def, handlers } = createSlackConnector(this.options);
+    automation.registerConnector(def, handlers);
+    this.automation = automation;
+    this.connectorName = def.name;
+    ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);
+  }
+  async stop(_ctx) {
+    if (this.automation && this.connectorName) {
+      try {
+        this.automation.unregisterConnector(this.connectorName);
+      } catch {
+      }
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConnectorSlackPlugin,
+  createSlackConnector
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/slack-connector.ts","../src/connector-slack-plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/connector-slack\n *\n * Slack Web API connector — a concrete connector (ADR-0018 §Addendum) and the\n * second reference implementation after `@objectstack/connector-rest`. The\n * baseline automation engine ships the `connector_action` dispatch node + an\n * empty connector registry; this plugin populates it with a `slack` connector\n * exposing `chat.postMessage`, `chat.update`, and a generic `call` action.\n *\n * This is the integration mechanism (ADR-0022 \"raw API call\" path), not the\n * human-notification layer. Static bot-token auth only; OAuth2 install/refresh,\n * credential vaulting, and multi-tenant lifecycle are the enterprise tier.\n */\n\nexport {\n    createSlackConnector,\n    type SlackConnectorOptions,\n    type SlackConnectorBundle,\n    type SlackPostMessageInput,\n    type SlackResult,\n} from './slack-connector.js';\nexport {\n    ConnectorSlackPlugin,\n    type ConnectorSlackPluginOptions,\n    type ConnectorRegistrySurface,\n} from './connector-slack-plugin.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Connector } from '@objectstack/spec/integration';\n\n/**\n * Slack connector — a *concrete* connector (ADR-0018 §Addendum) and the second\n * reference implementation after `@objectstack/connector-rest`. It produces a\n * {@link Connector} definition plus handlers for a small set of Slack Web API\n * actions, which the baseline `connector_action` node dispatches to.\n *\n * Scope (ADR-0022 \"raw API call\" path): this is the *integration mechanism*\n * for talking to Slack's API — \"post this exact text to this channel\". It is\n * deliberately **not** the human-notification layer: there is no preference\n * matrix, inbox, outbox, or thread/session semantics here. Those belong to a\n * `MessagingChannel` (ADR-0012/0013), which may itself delegate its transport\n * to this connector.\n *\n * Open-source scope: **static** auth only — a Slack **bot token** (`xoxb-…`),\n * supplied by the caller and sent as a bearer credential. OAuth2 install/refresh,\n * credential vaulting, and multi-tenant connection lifecycle are the enterprise\n * tier (see `../cloud/docs/design/connector-tiering.md`) and are out of scope.\n *\n * Slack quirk: the Web API returns HTTP `200` even on logical failure, with the\n * real outcome in the JSON body's `ok` field (and `error` on failure). Handlers\n * therefore surface `ok` from the payload, not from the HTTP status, and never\n * throw on a logical failure — the flow author branches on `${node.ok}`.\n */\n\nexport interface SlackConnectorOptions {\n    /** Connector machine name (snake_case). Defaults to `slack`. */\n    name?: string;\n    /** Human-readable label. Defaults to `Slack`. */\n    label?: string;\n    /** Slack bot token (`xoxb-…`), sent as `Authorization: Bearer <token>`. */\n    token: string;\n    /** Web API base URL. Defaults to `https://slack.com/api`. */\n    baseUrl?: string;\n    /** Headers merged into every request (request-level headers win). */\n    defaultHeaders?: Record<string, string>;\n    /** Injected for tests; defaults to the global `fetch`. */\n    fetchImpl?: typeof fetch;\n}\n\n/** Input accepted by `chat.postMessage`. */\nexport interface SlackPostMessageInput {\n    /** Channel id (`C…`), user id (`U…`), or channel name (`#general`). */\n    channel: string;\n    /** Message text (fallback when `blocks` are present). */\n    text?: string;\n    /** Thread root `ts` to reply into an existing thread. */\n    thread_ts?: string;\n    /** Block Kit blocks. */\n    blocks?: unknown[];\n    [key: string]: unknown;\n}\n\n/** Generic Slack Web API result envelope. */\nexport interface SlackResult {\n    /** Slack's logical success flag (from the JSON body, not the HTTP status). */\n    ok: boolean;\n    /** HTTP status (almost always 200 for the Slack Web API). */\n    status: number;\n    /** Full parsed Slack payload. */\n    body: Record<string, unknown>;\n    /** Slack error code when `ok` is false (e.g. `channel_not_found`). */\n    error?: string;\n}\n\n/** A connector definition paired with its action handlers, ready for registerConnector(). */\nexport interface SlackConnectorBundle {\n    def: Connector;\n    handlers: Record<\n        string,\n        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n    >;\n}\n\nexport function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {\n    const name = opts.name ?? 'slack';\n    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\\/+$/, '');\n    const doFetch = opts.fetchImpl ?? fetch;\n\n    const def: Connector = {\n        name,\n        label: opts.label ?? 'Slack',\n        type: 'api',\n        description: 'Slack Web API connector (static bot-token auth). Post and update messages, or call any Web API method.',\n        icon: 'slack',\n        authentication: { type: 'bearer', token: opts.token },\n        // Defaulted by ConnectorSchema; set explicitly so the literal satisfies\n        // the (post-parse) Connector output type.\n        status: 'active',\n        enabled: true,\n        connectionTimeoutMs: 30000,\n        requestTimeoutMs: 30000,\n        actions: [\n            {\n                key: 'chat.postMessage',\n                label: 'Post Message',\n                description: 'Post a message to a channel, DM, or thread (Slack chat.postMessage).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id, user id, or #name' },\n                        text: { type: 'string', description: 'Message text' },\n                        thread_ts: { type: 'string', description: 'Thread root ts to reply into' },\n                        blocks: { type: 'array', description: 'Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'chat.update',\n                label: 'Update Message',\n                description: 'Edit an existing message (Slack chat.update).',\n                inputSchema: {\n                    type: 'object',\n                    required: ['channel', 'ts'],\n                    properties: {\n                        channel: { type: 'string', description: 'Channel id' },\n                        ts: { type: 'string', description: 'Timestamp of the message to update' },\n                        text: { type: 'string', description: 'New message text' },\n                        blocks: { type: 'array', description: 'New Block Kit blocks' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n            {\n                key: 'call',\n                label: 'Call Web API Method',\n                description: 'Escape hatch — call any Slack Web API method with arbitrary params.',\n                inputSchema: {\n                    type: 'object',\n                    required: ['method'],\n                    properties: {\n                        method: { type: 'string', description: 'Web API method, e.g. conversations.list' },\n                        params: { type: 'object', description: 'Method parameters (JSON body)' },\n                    },\n                },\n                outputSchema: slackOutputSchema(),\n            },\n        ],\n    };\n\n    /** POST a JSON body to a Slack Web API method and normalise the result. */\n    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {\n        const headers: Record<string, string> = {\n            'Content-Type': 'application/json; charset=utf-8',\n            ...opts.defaultHeaders,\n            Authorization: `Bearer ${opts.token}`,\n        };\n\n        const response = await doFetch(`${baseUrl}/${method}`, {\n            method: 'POST',\n            headers,\n            body: JSON.stringify(params),\n        });\n\n        // The Slack Web API always answers with JSON; `ok` is the real outcome.\n        const body = (await response.json()) as Record<string, unknown>;\n        const ok = body.ok === true;\n        return {\n            ok,\n            status: response.status,\n            body,\n            error: ok ? undefined : (body.error as string | undefined),\n        };\n    }\n\n    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.postMessage', input));\n    }\n\n    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        return toRecord(await callSlack('chat.update', input));\n    }\n\n    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {\n        const method = String(input.method ?? '');\n        if (!method) throw new Error(\"slack 'call' action: 'method' is required\");\n        const params = (input.params as Record<string, unknown>) ?? {};\n        return toRecord(await callSlack(method, params));\n    }\n\n    return {\n        def,\n        handlers: {\n            'chat.postMessage': postMessage,\n            'chat.update': update,\n            call,\n        },\n    };\n}\n\nfunction toRecord(r: SlackResult): Record<string, unknown> {\n    return { ok: r.ok, status: r.status, body: r.body, error: r.error };\n}\n\nfunction slackOutputSchema(): Record<string, unknown> {\n    return {\n        type: 'object',\n        properties: {\n            ok: { type: 'boolean', description: \"Slack's logical success flag\" },\n            status: { type: 'number', description: 'HTTP status' },\n            body: { type: 'object', description: 'Full Slack response payload' },\n            error: { type: 'string', description: 'Slack error code when ok is false' },\n        },\n    };\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { Connector } from '@objectstack/spec/integration';\nimport { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';\n\n/**\n * Minimal surface of the automation engine this plugin depends on — the\n * connector registry from ADR-0018 §Addendum. Kept structural so the plugin\n * needs no runtime dependency on `@objectstack/service-automation`.\n */\nexport interface ConnectorRegistrySurface {\n    registerConnector(\n        def: Connector,\n        handlers: Record<\n            string,\n            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>\n        >,\n    ): void;\n    unregisterConnector(name: string): void;\n}\n\nexport interface ConnectorSlackPluginOptions extends SlackConnectorOptions {}\n\n/**\n * ConnectorSlackPlugin — registers a Slack Web API connector on the automation\n * engine. The second reference concrete connector (ADR-0018 §Addendum); it\n * enables the ADR-0022 \"raw API call\" path — a flow's `connector_action` step\n * can dispatch to `slack.chat.postMessage` without the messaging stack.\n *\n * If no automation engine is present the plugin logs and skips — the connector\n * has nowhere to register, which is not an error.\n */\nexport class ConnectorSlackPlugin implements Plugin {\n    name = 'com.objectstack.connector.slack';\n    version = '1.0.0';\n    type = 'standard' as const;\n    // Ensure the automation engine (and its connector registry) is started first.\n    dependencies = ['com.objectstack.service-automation'];\n\n    private readonly options: ConnectorSlackPluginOptions;\n    private connectorName?: string;\n    private automation?: ConnectorRegistrySurface;\n\n    constructor(options: ConnectorSlackPluginOptions) {\n        this.options = options;\n    }\n\n    async init(_ctx: PluginContext): Promise<void> {\n        // No services to register; the connector is registered in start() once\n        // the automation engine is available.\n    }\n\n    async start(ctx: PluginContext): Promise<void> {\n        let automation: ConnectorRegistrySurface | undefined;\n        try {\n            automation = ctx.getService<ConnectorRegistrySurface>('automation');\n        } catch {\n            automation = undefined;\n        }\n\n        if (!automation || typeof automation.registerConnector !== 'function') {\n            ctx.logger.info('ConnectorSlackPlugin: no automation engine — Slack connector not registered');\n            return;\n        }\n\n        const { def, handlers } = createSlackConnector(this.options);\n        automation.registerConnector(def, handlers);\n        this.automation = automation;\n        this.connectorName = def.name;\n        ctx.logger.info(`ConnectorSlackPlugin: Slack connector '${def.name}' registered`);\n    }\n\n    async stop(_ctx: PluginContext): Promise<void> {\n        if (this.automation && this.connectorName) {\n            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }\n        }\n    }\n}\n"],"mappings":"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","names":[]}