@objectstack/connector-slack 17.0.0-rc.0 → 17.0.0-rc.1

package/CHANGELOG.md

@@ -1,5 +1,215 @@
 # @objectstack/connector-slack
 
+## 17.0.0-rc.1
+
+### Patch Changes
+
+- 2e836de: chore(packaging): CHANGELOG.md ships in every npm tarball (#4261)
+
+  The AGENTS.md post-task checklist requires breaking changesets to carry their
+  FROM → TO migration because "this text ships to consumers as `CHANGELOG.md`
+  inside the npm package and is what an upgrading agent greps after the tombstone
+  error." That delivery path was severed for 68 of the 69 publishable packages:
+  npm packs `package.json` / `README*` / `LICENSE*` unconditionally but — unlike
+  older npm versions — not `CHANGELOG.md`, and the canonical
+  `"files": ["dist", "README.md"]` whitelist never named it. Measured on npm
+  10.9.7: `npm pack --dry-run` on `@objectstack/types` shipped 3 files while its
+  70KB `CHANGELOG.md` stayed behind. Only `@objectstack/spec` listed it
+  explicitly.
+
+  The tombstone-error scenario is precisely the one where the repo is out of
+  reach — the upgrading agent has `node_modules` and nothing else — so the
+  migration text has to ride in the tarball. Every publishable package now
+  declares `CHANGELOG.md` in `files`, and the canonical whitelist is
+  `["dist", "README.md", "CHANGELOG.md"]`.
+
+  The other half is the gate: `check:published-files` gains a fifth invariant,
+  COMPLETE — a whitelist that fails to cover `CHANGELOG.md` fails the
+  always-required lint job, so the next package cannot silently sever the path
+  again. `@objectstack/spec`'s per-package EXTRA_ENTRIES exemption dissolves
+  into the canonical set.
+
+  Consumer-visible change: one more file per install (the package's changelog,
+  e.g. 70.8KB for `@objectstack/types`), and `grep -r "removed key"
+node_modules/@objectstack/*/CHANGELOG.md` now finds the migration it was
+  promised.
+
+- cc2de0e: chore(packaging): 20 packages stop publishing their sources, tests and build tooling (#4248)
+
+  These 20 packages declared no `files` field, so npm fell back to packing the
+  whole package directory. `npm pack --dry-run` on `@objectstack/plugin-webhooks`
+  listed **21 files** — 15 under `src/`, three of them unit tests
+  (`auto-enqueuer.test.ts`, `bootstrap-declared-webhooks.test.ts`, …), plus the
+  build-time `scripts/i18n-extract.config.ts`. `dist/` lands on top of that at
+  publish time rather than instead of it, so consumers were installing the
+  TypeScript sources and the test suite alongside the artifact they asked for.
+
+  Each now declares `"files": ["dist", "README.md"]`, matching the 29 packages
+  that already did. Nothing a consumer imports moves: every `main` / `types` /
+  `exports` target in all 20 already resolved inside `dist/`, which the new
+  `check:published-files` guard verifies rather than assumes. The visible change
+  is a smaller install and a smaller dependency-scanning surface — `npm pack` on
+  `@objectstack/plugin-webhooks` now yields 2 files plus `dist/`.
+
+  The other half of the fix is the gate. Half the packages declaring `files` and
+  half not was the #3786 shape — a hand-copied convention with nothing enforcing
+  it, where whoever forgets the line gets no signal at all. `check:published-files`
+  (new, wired into the always-required `lint` job) holds every non-private
+  workspace package to four invariants: `files` is **declared**; it is
+  **sufficient** (covers every entry point, so tightening a whitelist cannot ship
+  a package that fails to resolve); it is **minimal** (admits no test, test-harness
+  config or build script); and anything beyond `dist` + `README.md` is
+  **registered** with a reason, reconciled in both directions so a stale exemption
+  is an error rather than dead text. `@objectstack/spec` is the one package with
+  registered extras — its `.zod.ts` sources, JSON Schemas, liveness ledgers and
+  `CHANGELOG.md` are product, not build input.
+
+  This also closes an assumption #4206 was resting on. Excluding `<pkg>/scripts/**`
+  from the docs-drift implementation test is sound only while no package publishes
+  `scripts/` as runtime code; that held, but it held because someone read all three
+  offenders by hand. It is now checked on every PR.
+
+- Updated dependencies [6a67d7a]
+- Updated dependencies [0ecc656]
+- Updated dependencies [06772eb]
+- Updated dependencies [270650f]
+- Updated dependencies [3aef718]
+- Updated dependencies [1ea6bce]
+- Updated dependencies [c1dcacd]
+- Updated dependencies [ad303ed]
+- Updated dependencies [32ccb23]
+- Updated dependencies [f5a4ef0]
+- Updated dependencies [2d3e255]
+- Updated dependencies [7d7521f]
+- Updated dependencies [5dc4d02]
+- Updated dependencies [05154a1]
+- Updated dependencies [9b6fe7c]
+- Updated dependencies [8c711fb]
+- Updated dependencies [09e4547]
+- Updated dependencies [91f4c78]
+- Updated dependencies [820eff9]
+- Updated dependencies [8d895ff]
+- Updated dependencies [f6472d7]
+- Updated dependencies [78caf51]
+- Updated dependencies [62a789b]
+- Updated dependencies [789ad63]
+- Updated dependencies [2af1988]
+- Updated dependencies [0af50a3]
+- Updated dependencies [2e836de]
+- Updated dependencies [12a19a8]
+- Updated dependencies [41dcda3]
+- Updated dependencies [c8124e5]
+- Updated dependencies [a1a4140]
+- Updated dependencies [217e2e6]
+- Updated dependencies [86a71d1]
+- Updated dependencies [d5c75e2]
+- Updated dependencies [03d26f7]
+- Updated dependencies [4384921]
+- Updated dependencies [3c628ce]
+- Updated dependencies [7cb922e]
+- Updated dependencies [1d22114]
+- Updated dependencies [b5f9397]
+- Updated dependencies [ed77493]
+- Updated dependencies [58a03d2]
+- Updated dependencies [dc530b4]
+- Updated dependencies [e59786e]
+- Updated dependencies [bcf1112]
+- Updated dependencies [9774b78]
+- Updated dependencies [b07d829]
+- Updated dependencies [a648e96]
+- Updated dependencies [a47ac06]
+- Updated dependencies [e4c61a7]
+- Updated dependencies [cc60165]
+- Updated dependencies [081aa6f]
+- Updated dependencies [91f4c78]
+- Updated dependencies [e8d0c21]
+- Updated dependencies [45dc446]
+- Updated dependencies [c1d44f7]
+- Updated dependencies [ab9fb5c]
+- Updated dependencies [f985b3f]
+- Updated dependencies [9a4932a]
+- Updated dependencies [f9fc874]
+- Updated dependencies [011b386]
+- Updated dependencies [7777e8f]
+- Updated dependencies [507b92a]
+- Updated dependencies [7309c81]
+- Updated dependencies [20bc1ec]
+- Updated dependencies [90c2b15]
+- Updated dependencies [42eeb7d]
+- Updated dependencies [01e124d]
+- Updated dependencies [7ce02eb]
+- Updated dependencies [a13827e]
+- Updated dependencies [7733604]
+- Updated dependencies [40e420f]
+- Updated dependencies [d13004a]
+- Updated dependencies [be7360c]
+- Updated dependencies [5b47ab5]
+- Updated dependencies [b09d8d9]
+- Updated dependencies [b09d8d9]
+- Updated dependencies [8675db6]
+- Updated dependencies [b09d8d9]
+- Updated dependencies [3eb1b2b]
+- Updated dependencies [59b85c0]
+- Updated dependencies [6e357ed]
+- Updated dependencies [d6938bf]
+- Updated dependencies [31e0be9]
+- Updated dependencies [4bfd455]
+- Updated dependencies [ffd2ce2]
+- Updated dependencies [62f8017]
+- Updated dependencies [a831df1]
+- Updated dependencies [f752ee3]
+- Updated dependencies [a1b61e0]
+- Updated dependencies [cd6b9f2]
+- Updated dependencies [2cb6d3c]
+- Updated dependencies [af2a095]
+- Updated dependencies [ec796d5]
+- Updated dependencies [e87fea1]
+- Updated dependencies [c65e529]
+- Updated dependencies [3ca34c1]
+- Updated dependencies [239c3a3]
+- Updated dependencies [94a0bbc]
+- Updated dependencies [d6bfb3d]
+- Updated dependencies [a2266a6]
+- Updated dependencies [d25a0ec]
+- Updated dependencies [667b83e]
+- Updated dependencies [627b188]
+- Updated dependencies [8d4eae7]
+- Updated dependencies [857a6cf]
+- Updated dependencies [65a3a84]
+- Updated dependencies [ccd9397]
+- Updated dependencies [bca935b]
+- Updated dependencies [d92c72d]
+- Updated dependencies [c54c822]
+- Updated dependencies [8dcc0f5]
+- Updated dependencies [75b9e51]
+- Updated dependencies [0a2f233]
+- Updated dependencies [8621cdd]
+- Updated dependencies [6f23667]
+- Updated dependencies [5d21a48]
+- Updated dependencies [19365b7]
+- Updated dependencies [b7ed26d]
+- Updated dependencies [b3a3d83]
+- Updated dependencies [7a55913]
+- Updated dependencies [35accbf]
+- Updated dependencies [6038de7]
+- Updated dependencies [eb95d97]
+- Updated dependencies [e4c2dc8]
+- Updated dependencies [1bd2795]
+- Updated dependencies [8186a70]
+- Updated dependencies [a329cca]
+- Updated dependencies [6eec18c]
+- Updated dependencies [4d7bebf]
+- Updated dependencies [821ac7a]
+- Updated dependencies [8f81731]
+- Updated dependencies [8b50cb3]
+- Updated dependencies [8c2db68]
+- Updated dependencies [22b5e54]
+- Updated dependencies [0166bd5]
+- Updated dependencies [9b702dc]
+- Updated dependencies [ab16331]
+  - @objectstack/spec@17.0.0-rc.1
+  - @objectstack/core@17.0.0-rc.1
+
 ## 17.0.0-rc.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@objectstack/connector-slack",
-  "version": "17.0.0-rc.0",
+  "version": "17.0.0-rc.1",
   "license": "Apache-2.0",
   "description": "Slack Web API connector for ObjectStack — registers `chat.postMessage` / `chat.update` / `call` actions on the automation engine's connector registry (ADR-0018 §Addendum, ADR-0022).",
   "main": "dist/index.js",
@@ -13,14 +13,14 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "17.0.0-rc.0",
-    "@objectstack/spec": "17.0.0-rc.0"
+    "@objectstack/core": "17.0.0-rc.1",
+    "@objectstack/spec": "17.0.0-rc.1"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
-    "@objectstack/service-automation": "17.0.0-rc.0"
+    "@objectstack/service-automation": "17.0.0-rc.1"
   },
   "keywords": [
     "objectstack",
@@ -29,8 +29,14 @@
     "integration",
     "messaging"
   ],
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",
-    "test": "vitest run --passWithNoTests"
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
   }
 }

package/.turbo/turbo-build.log

@@ -1,22 +0,0 @@
-
-> @objectstack/connector-slack@17.0.0-rc.0 build /home/runner/work/objectstack/objectstack/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/objectstack/objectstack/tsup.config.ts
-CLI Target: es2020
-CLI Cleaning output folder
-ESM Build start
-CJS Build start
-ESM dist/index.mjs     5.40 KB
-ESM dist/index.mjs.map 15.25 KB
-ESM ⚡️ Build success in 96ms
-CJS dist/index.js     6.48 KB
-CJS dist/index.js.map 16.39 KB
-CJS ⚡️ Build success in 96ms
-DTS Build start
-DTS ⚡️ Build success in 15023ms
-DTS dist/index.d.mts 4.81 KB
-DTS dist/index.d.ts  4.81 KB

package/src/connector-slack-plugin.test.ts

@@ -1,78 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { describe, it, expect } from 'vitest';
-import { LiteKernel } from '@objectstack/core';
-import { AutomationServicePlugin, type AutomationEngine } from '@objectstack/service-automation';
-import { ConnectorSlackPlugin } from './connector-slack-plugin.js';
-
-/** A fetch stub mimicking the Slack Web API (HTTP 200 + ok in the body). */
-function stubSlack() {
-    const calls: Array<{ url: string; init: RequestInit }> = [];
-    const impl = (async (url: string, init: RequestInit) => {
-        calls.push({ url, init });
-        return {
-            status: 200,
-            ok: true,
-            headers: { get: () => 'application/json' },
-            json: async () => ({ ok: true, ts: '1700000000.000200', channel: 'C42' }),
-            text: async () => '{"ok":true}',
-        };
-    }) as unknown as typeof fetch;
-    return { impl, calls };
-}
-
-describe('ConnectorSlackPlugin — end to end with the automation engine', () => {
-    it('registers the Slack connector so a connector_action flow can post a message', async () => {
-        const { impl, calls } = stubSlack();
-
-        const kernel = new LiteKernel();
-        kernel.use(new AutomationServicePlugin());
-        kernel.use(new ConnectorSlackPlugin({ token: 'xoxb-secret-token', fetchImpl: impl }));
-        await kernel.bootstrap();
-
-        const engine = kernel.getService<AutomationEngine>('automation');
-
-        // The baseline dispatch node and the plugin-contributed connector are both present.
-        expect(engine.getRegisteredNodeTypes()).toContain('connector_action');
-        expect(engine.getRegisteredConnectors()).toContain('slack');
-
-        engine.registerFlow('notify_channel', {
-            name: 'notify_channel',
-            label: 'Post to Slack',
-            type: 'autolaunched',
-            variables: [{ name: 'post.ok', type: 'boolean', isOutput: true }],
-            nodes: [
-                { id: 'start', type: 'start', label: 'Start' },
-                {
-                    id: 'post',
-                    type: 'connector_action',
-                    label: 'Post to #sales',
-                    connectorConfig: {
-                        connectorId: 'slack',
-                        actionId: 'chat.postMessage',
-                        input: { channel: 'C42', text: 'Deal closed 🎉' },
-                    },
-                },
-                { id: 'end', type: 'end', label: 'End' },
-            ],
-            edges: [
-                { id: 'e1', source: 'start', target: 'post' },
-                { id: 'e2', source: 'post', target: 'end' },
-            ],
-        });
-
-        const result = await engine.execute('notify_channel');
-
-        expect(result.success).toBe(true);
-        // The Slack connector handled the dispatch: one POST with bearer auth + JSON body.
-        expect(calls).toHaveLength(1);
-        expect(calls[0].url).toBe('https://slack.com/api/chat.postMessage');
-        expect(calls[0].init.method).toBe('POST');
-        expect((calls[0].init.headers as Record<string, string>).Authorization).toBe('Bearer xoxb-secret-token');
-        expect(calls[0].init.body).toBe('{"channel":"C42","text":"Deal closed 🎉"}');
-        // Slack's logical `ok` propagated back into the flow output.
-        expect(result.output).toEqual({ 'post.ok': true });
-
-        await kernel.shutdown();
-    });
-});

package/src/connector-slack-plugin.ts

@@ -1,79 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Plugin, PluginContext } from '@objectstack/core';
-import type { Connector } from '@objectstack/spec/integration';
-import { createSlackConnector, type SlackConnectorOptions } from './slack-connector.js';
-
-/**
- * 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`.
- */
-export interface ConnectorRegistrySurface {
-    registerConnector(
-        def: Connector,
-        handlers: Record<
-            string,
-            (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>
-        >,
-    ): void;
-    unregisterConnector(name: string): void;
-}
-
-export 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.
- */
-export class ConnectorSlackPlugin implements Plugin {
-    name = 'com.objectstack.connector.slack';
-    version = '1.0.0';
-    type = 'standard' as const;
-    // Ensure the automation engine (and its connector registry) is started first.
-    dependencies = ['com.objectstack.service-automation'];
-
-    private readonly options: ConnectorSlackPluginOptions;
-    private connectorName?: string;
-    private automation?: ConnectorRegistrySurface;
-
-    constructor(options: ConnectorSlackPluginOptions) {
-        this.options = options;
-    }
-
-    async init(_ctx: PluginContext): Promise<void> {
-        // No services to register; the connector is registered in start() once
-        // the automation engine is available.
-    }
-
-    async start(ctx: PluginContext): Promise<void> {
-        let automation: ConnectorRegistrySurface | undefined;
-        try {
-            automation = ctx.getService<ConnectorRegistrySurface>('automation');
-        } catch {
-            automation = undefined;
-        }
-
-        if (!automation || typeof automation.registerConnector !== 'function') {
-            ctx.logger.info('ConnectorSlackPlugin: no automation engine — 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: PluginContext): Promise<void> {
-        if (this.automation && this.connectorName) {
-            try { this.automation.unregisterConnector(this.connectorName); } catch { /* ignore */ }
-        }
-    }
-}

package/src/index.ts

@@ -1,28 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-/**
- * @objectstack/connector-slack
- *
- * Slack Web API connector — a concrete connector (ADR-0018 §Addendum) and the
- * second reference implementation after `@objectstack/connector-rest`. The
- * baseline automation engine ships the `connector_action` dispatch node + an
- * empty connector registry; this plugin populates it with a `slack` connector
- * exposing `chat.postMessage`, `chat.update`, and a generic `call` action.
- *
- * This is the integration mechanism (ADR-0022 "raw API call" path), not the
- * human-notification layer. Static bot-token auth only; OAuth2 install/refresh,
- * credential vaulting, and multi-tenant lifecycle are the enterprise tier.
- */
-
-export {
-    createSlackConnector,
-    type SlackConnectorOptions,
-    type SlackConnectorBundle,
-    type SlackPostMessageInput,
-    type SlackResult,
-} from './slack-connector.js';
-export {
-    ConnectorSlackPlugin,
-    type ConnectorSlackPluginOptions,
-    type ConnectorRegistrySurface,
-} from './connector-slack-plugin.js';

package/src/slack-connector.test.ts

@@ -1,132 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { describe, it, expect } from 'vitest';
-import { createSlackConnector } from './slack-connector.js';
-
-// ─── Helpers ─────────────────────────────────────────────────────────
-
-interface CapturedCall {
-    url: string;
-    init: RequestInit;
-}
-
-/**
- * A fetch stub mimicking the Slack Web API: always HTTP 200, with the logical
- * outcome carried in the JSON body's `ok` field.
- */
-function stubSlack(responseBody: Record<string, unknown> = { ok: true }) {
-    const calls: CapturedCall[] = [];
-    const impl = (async (url: string, init: RequestInit) => {
-        calls.push({ url, init });
-        return {
-            status: 200,
-            ok: true,
-            headers: { get: () => 'application/json' },
-            json: async () => responseBody,
-            text: async () => JSON.stringify(responseBody),
-        };
-    }) as unknown as typeof fetch;
-    return { impl, calls };
-}
-
-function headersOf(call: CapturedCall): Record<string, string> {
-    return (call.init.headers ?? {}) as Record<string, string>;
-}
-
-// ─── definition ──────────────────────────────────────────────────────
-
-describe('createSlackConnector — definition', () => {
-    it('declares a slack connector with the expected actions and bearer auth', () => {
-        const { def, handlers } = createSlackConnector({ token: 'xoxb-1' });
-
-        expect(def.name).toBe('slack');
-        expect(def.type).toBe('api');
-        expect(def.authentication).toEqual({ type: 'bearer', token: 'xoxb-1' });
-
-        const keys = (def.actions ?? []).map((a) => a.key);
-        expect(keys).toEqual(['chat.postMessage', 'chat.update', 'call']);
-        // Every declared action has a handler (the registry enforces this too).
-        for (const k of keys) expect(typeof handlers[k]).toBe('function');
-    });
-});
-
-// ─── chat.postMessage ────────────────────────────────────────────────
-
-describe('createSlackConnector — chat.postMessage', () => {
-    it('POSTs JSON to the method URL with a bearer token and returns ok from the payload', async () => {
-        const { impl, calls } = stubSlack({ ok: true, ts: '1700000000.000100', channel: 'C123' });
-        const { handlers } = createSlackConnector({ token: 'xoxb-secret', fetchImpl: impl });
-
-        const out = await handlers['chat.postMessage'](
-            { channel: 'C123', text: 'hello', thread_ts: '1699999999.0001' },
-            {},
-        );
-
-        expect(calls).toHaveLength(1);
-        expect(calls[0].url).toBe('https://slack.com/api/chat.postMessage');
-        expect(calls[0].init.method).toBe('POST');
-        expect(headersOf(calls[0]).Authorization).toBe('Bearer xoxb-secret');
-        expect(calls[0].init.body).toBe('{"channel":"C123","text":"hello","thread_ts":"1699999999.0001"}');
-
-        expect(out.ok).toBe(true);
-        expect(out.status).toBe(200);
-        expect(out.body).toEqual({ ok: true, ts: '1700000000.000100', channel: 'C123' });
-        expect(out.error).toBeUndefined();
-    });
-
-    it('surfaces a Slack logical failure (HTTP 200, ok:false) without throwing', async () => {
-        const { impl } = stubSlack({ ok: false, error: 'channel_not_found' });
-        const { handlers } = createSlackConnector({ token: 'xoxb-1', fetchImpl: impl });
-
-        const out = await handlers['chat.postMessage']({ channel: 'nope', text: 'hi' }, {});
-
-        expect(out.ok).toBe(false);
-        expect(out.error).toBe('channel_not_found');
-        expect(out.status).toBe(200);
-    });
-});
-
-// ─── chat.update + call ───────────────────────────────────────────────
-
-describe('createSlackConnector — chat.update & generic call', () => {
-    it('chat.update hits the chat.update method', async () => {
-        const { impl, calls } = stubSlack({ ok: true });
-        const { handlers } = createSlackConnector({ token: 'xoxb-1', fetchImpl: impl });
-
-        await handlers['chat.update']({ channel: 'C1', ts: '170.1', text: 'edited' }, {});
-        expect(calls[0].url).toBe('https://slack.com/api/chat.update');
-        expect(calls[0].init.body).toBe('{"channel":"C1","ts":"170.1","text":"edited"}');
-    });
-
-    it('call dispatches to an arbitrary Web API method with params', async () => {
-        const { impl, calls } = stubSlack({ ok: true, channels: [] });
-        const { handlers } = createSlackConnector({ token: 'xoxb-1', fetchImpl: impl });
-
-        const out = await handlers.call({ method: 'conversations.list', params: { limit: 50 } }, {});
-        expect(calls[0].url).toBe('https://slack.com/api/conversations.list');
-        expect(calls[0].init.body).toBe('{"limit":50}');
-        expect(out.ok).toBe(true);
-    });
-
-    it('call throws when method is missing', async () => {
-        const { impl } = stubSlack();
-        const { handlers } = createSlackConnector({ token: 'xoxb-1', fetchImpl: impl });
-        await expect(handlers.call({ params: {} }, {})).rejects.toThrow(/method.*required/);
-    });
-
-    it('honours a custom baseUrl and merges defaultHeaders', async () => {
-        const { impl, calls } = stubSlack();
-        const { handlers } = createSlackConnector({
-            token: 'xoxb-1',
-            baseUrl: 'https://slack.example.test/api/',
-            defaultHeaders: { 'X-Trace': 'on' },
-            fetchImpl: impl,
-        });
-
-        await handlers['chat.postMessage']({ channel: 'C1', text: 'x' }, {});
-        expect(calls[0].url).toBe('https://slack.example.test/api/chat.postMessage');
-        expect(headersOf(calls[0])['X-Trace']).toBe('on');
-        // Auth still wins over defaultHeaders.
-        expect(headersOf(calls[0]).Authorization).toBe('Bearer xoxb-1');
-    });
-});

package/src/slack-connector.ts

@@ -1,210 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import type { Connector } from '@objectstack/spec/integration';
-import { resilientFetch } from '@objectstack/spec/shared';
-
-/**
- * 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}`.
- */
-
-export 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`. */
-export 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. */
-export 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(). */
-export interface SlackConnectorBundle {
-    def: Connector;
-    handlers: Record<
-        string,
-        (input: Record<string, unknown>, ctx: unknown) => Promise<Record<string, unknown>>
-    >;
-}
-
-export function createSlackConnector(opts: SlackConnectorOptions): SlackConnectorBundle {
-    const name = opts.name ?? 'slack';
-    const baseUrl = (opts.baseUrl ?? 'https://slack.com/api').replace(/\/+$/, '');
-
-    const def: Connector = {
-        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: 30000,
-        requestTimeoutMs: 30000,
-        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 — 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(),
-            },
-        ],
-    };
-
-    /** POST a JSON body to a Slack Web API method and normalise the result. */
-    async function callSlack(method: string, params: Record<string, unknown>): Promise<SlackResult> {
-        const headers: Record<string, string> = {
-            'Content-Type': 'application/json; charset=utf-8',
-            ...opts.defaultHeaders,
-            Authorization: `Bearer ${opts.token}`,
-        };
-
-        const response = await resilientFetch(`${baseUrl}/${method}`, {
-            method: 'POST',
-            headers,
-            body: JSON.stringify(params),
-        }, { fetchImpl: opts.fetchImpl });
-
-        // The Slack Web API always answers with JSON; `ok` is the real outcome.
-        const body = (await response.json()) as Record<string, unknown>;
-        const ok = body.ok === true;
-        return {
-            ok,
-            status: response.status,
-            body,
-            error: ok ? undefined : (body.error as string | undefined),
-        };
-    }
-
-    async function postMessage(input: Record<string, unknown>): Promise<Record<string, unknown>> {
-        return toRecord(await callSlack('chat.postMessage', input));
-    }
-
-    async function update(input: Record<string, unknown>): Promise<Record<string, unknown>> {
-        return toRecord(await callSlack('chat.update', input));
-    }
-
-    async function call(input: Record<string, unknown>): Promise<Record<string, unknown>> {
-        const method = String(input.method ?? '');
-        if (!method) throw new Error("slack 'call' action: 'method' is required");
-        const params = (input.params as Record<string, unknown>) ?? {};
-        return toRecord(await callSlack(method, params));
-    }
-
-    return {
-        def,
-        handlers: {
-            'chat.postMessage': postMessage,
-            'chat.update': update,
-            call,
-        },
-    };
-}
-
-function toRecord(r: SlackResult): Record<string, unknown> {
-    return { ok: r.ok, status: r.status, body: r.body, error: r.error };
-}
-
-function slackOutputSchema(): Record<string, unknown> {
-    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' },
-        },
-    };
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["node"]
-  },
-  "include": ["src/**/*"],
-  "exclude": ["dist", "node_modules", "**/*.test.ts"]
-}