@forumone/throughline-integrations 0.0.1 → 0.2.0

package/dist/integrations/webhook/healthcheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthcheck.d.ts","sourceRoot":"","sources":["../../../src/integrations/webhook/healthcheck.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgBnF"}

package/dist/integrations/webhook/healthcheck.js

@@ -0,0 +1,26 @@
+const HEALTHCHECK_TIMEOUT_MS = 5000;
+/**
+ * Light reachability check for the webhook target. Sends a HEAD request and
+ * accepts any 2xx, plus 405 (Method Not Allowed) since plenty of webhook
+ * receivers only allow POST and reject HEAD with 405. That's healthy enough
+ * for a "your endpoint is up" probe.
+ */
+export async function healthcheck(config) {
+    try {
+        const response = await fetch(config.targetUrl, {
+            method: 'HEAD',
+            signal: AbortSignal.timeout(HEALTHCHECK_TIMEOUT_MS),
+        });
+        if (response.ok || response.status === 405) {
+            return { ok: true, details: `Reachable (HTTP ${response.status})` };
+        }
+        return { ok: false, details: `Endpoint returned HTTP ${response.status}` };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            details: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=healthcheck.js.map

package/dist/integrations/webhook/healthcheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthcheck.js","sourceRoot":"","sources":["../../../src/integrations/webhook/healthcheck.ts"],"names":[],"mappings":"AAGA,MAAM,sBAAsB,GAAG,IAAI,CAAA;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAqB;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE;YAC7C,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC;SACpD,CAAC,CAAA;QACF,IAAI,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC3C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAA;QACrE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,0BAA0B,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAClE,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/integrations/webhook/hmac.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HMAC-SHA256 utility used by the webhook integration to sign delivery
+ * payloads. The hex-encoded digest is sent in the `x-throughline-signature`
+ * header (prefixed with `sha256=`); receivers verify by recomputing with
+ * the shared secret.
+ *
+ * Uses Web Crypto so the same code runs in Node 20+, edge runtimes, and
+ * the browser (for tests). No Node-specific imports.
+ */
+export declare function hmacSha256Hex(payload: string, secret: string): Promise<string>;
+//# sourceMappingURL=hmac.d.ts.map

package/dist/integrations/webhook/hmac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmac.d.ts","sourceRoot":"","sources":["../../../src/integrations/webhook/hmac.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWpF"}

package/dist/integrations/webhook/hmac.js

@@ -0,0 +1,25 @@
+/**
+ * HMAC-SHA256 utility used by the webhook integration to sign delivery
+ * payloads. The hex-encoded digest is sent in the `x-throughline-signature`
+ * header (prefixed with `sha256=`); receivers verify by recomputing with
+ * the shared secret.
+ *
+ * Uses Web Crypto so the same code runs in Node 20+, edge runtimes, and
+ * the browser (for tests). No Node-specific imports.
+ */
+const HEX_CHARS = '0123456789abcdef';
+export async function hmacSha256Hex(payload, secret) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(payload));
+    return bytesToHex(new Uint8Array(signature));
+}
+function bytesToHex(bytes) {
+    let out = '';
+    for (let i = 0; i < bytes.length; i += 1) {
+        const byte = bytes[i];
+        out += HEX_CHARS[byte >> 4] + HEX_CHARS[byte & 0xf];
+    }
+    return out;
+}
+//# sourceMappingURL=hmac.js.map

package/dist/integrations/webhook/hmac.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmac.js","sourceRoot":"","sources":["../../../src/integrations/webhook/hmac.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,SAAS,GAAG,kBAAkB,CAAA;AAEpC,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe,EAAE,MAAc;IACjE,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CACvC,KAAK,EACL,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EACtB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,EACjC,KAAK,EACL,CAAC,MAAM,CAAC,CACT,CAAA;IACD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IAChF,OAAO,UAAU,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC,CAAA;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACtB,GAAG,IAAI,SAAS,CAAC,IAAI,IAAI,CAAC,CAAE,GAAG,SAAS,CAAC,IAAI,GAAG,GAAG,CAAE,CAAA;IACvD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/integrations/webhook/index.d.ts

@@ -0,0 +1,6 @@
+import type { Integration } from '../../types.js';
+import { type WebhookConfig } from './config-fields.js';
+export declare const webhookIntegration: Integration<WebhookConfig>;
+export type { WebhookConfig } from './config-fields.js';
+export { WEBHOOK_INTEGRATION_ID } from './functions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/webhook/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/integrations/webhook/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,oBAAoB,CAAA;AAI3B,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,aAAa,CAyCzD,CAAA;AAED,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/integrations/webhook/index.js

@@ -0,0 +1,46 @@
+import { configFields, MIN_SIGNING_SECRET_LENGTH, } from './config-fields.js';
+import { createWebhookFunctions, WEBHOOK_INTEGRATION_ID } from './functions.js';
+import { healthcheck } from './healthcheck.js';
+export const webhookIntegration = {
+    id: WEBHOOK_INTEGRATION_ID,
+    name: 'Generic Webhook',
+    description: 'POST system events to an external HTTPS endpoint with HMAC-SHA256 signed payloads. Configurable event filter, retries, and timeout.',
+    category: 'webhook',
+    configFields,
+    async validateConfig(config) {
+        if (!config?.targetUrl)
+            return { ok: false, reason: 'targetUrl is required' };
+        let url;
+        try {
+            url = new URL(config.targetUrl);
+        }
+        catch {
+            return { ok: false, reason: 'targetUrl is not a valid URL' };
+        }
+        if (url.protocol !== 'https:') {
+            return { ok: false, reason: 'targetUrl must use https://' };
+        }
+        if (!config.signingSecret || config.signingSecret.length < MIN_SIGNING_SECRET_LENGTH) {
+            return {
+                ok: false,
+                reason: `signingSecret must be at least ${MIN_SIGNING_SECRET_LENGTH} characters`,
+            };
+        }
+        if (config.timeoutSeconds !== undefined &&
+            (typeof config.timeoutSeconds !== 'number' || config.timeoutSeconds <= 0)) {
+            return { ok: false, reason: 'timeoutSeconds must be a positive number' };
+        }
+        return { ok: true };
+    },
+    subscribes: [
+        { event: 'content/page.published', purpose: 'Notify external systems when content goes live' },
+        { event: 'content/page.unpublished', purpose: 'Notify when content is taken down' },
+        { event: 'content/page.rolled_back', purpose: 'Notify when content reverts to a prior version' },
+        { event: 'form/submission.received', purpose: 'Forward form submissions to downstream systems' },
+        { event: 'approval/decided', purpose: 'Notify external workflow tools of approval outcomes' },
+    ],
+    createFunctions: createWebhookFunctions,
+    healthcheck,
+};
+export { WEBHOOK_INTEGRATION_ID } from './functions.js';
+//# sourceMappingURL=index.js.map

package/dist/integrations/webhook/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/integrations/webhook/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,YAAY,EACZ,yBAAyB,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAA+B;IAC5D,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,qIAAqI;IACvI,QAAQ,EAAE,SAAS;IACnB,YAAY;IACZ,KAAK,CAAC,cAAc,CAAC,MAAM;QACzB,IAAI,CAAC,MAAM,EAAE,SAAS;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAA;QAC7E,IAAI,GAAQ,CAAA;QACZ,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAA;QAC9D,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAA;QAC7D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;YACrF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,kCAAkC,yBAAyB,aAAa;aACjF,CAAA;QACH,CAAC;QACD,IACE,MAAM,CAAC,cAAc,KAAK,SAAS;YACnC,CAAC,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,IAAI,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,EACzE,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0CAA0C,EAAE,CAAA;QAC1E,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACrB,CAAC;IACD,UAAU,EAAE;QACV,EAAE,KAAK,EAAE,wBAAwB,EAAE,OAAO,EAAE,gDAAgD,EAAE;QAC9F,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACnF,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,gDAAgD,EAAE;QAChG,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,gDAAgD,EAAE;QAChG,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,qDAAqD,EAAE;KAC9F;IACD,eAAe,EAAE,sBAAsB;IACvC,WAAW;CACZ,CAAA;AAGD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/integrations/webhook/payload.d.ts

@@ -0,0 +1,9 @@
+/**
+ * When a webhook instance is configured with `includeFullPayload=false`,
+ * we still want to include enough context to make the event useful: IDs,
+ * slugs, and any other field whose name ends in `Id`. Keeps payloads small
+ * without requiring the receiver to make a follow-up API call for the
+ * common case.
+ */
+export declare function extractIds(data: unknown): Record<string, unknown>;
+//# sourceMappingURL=payload.d.ts.map

package/dist/integrations/webhook/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../src/integrations/webhook/payload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASjE"}

package/dist/integrations/webhook/payload.js

@@ -0,0 +1,19 @@
+/**
+ * When a webhook instance is configured with `includeFullPayload=false`,
+ * we still want to include enough context to make the event useful: IDs,
+ * slugs, and any other field whose name ends in `Id`. Keeps payloads small
+ * without requiring the receiver to make a follow-up API call for the
+ * common case.
+ */
+export function extractIds(data) {
+    if (!data || typeof data !== 'object')
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(data)) {
+        if (key === 'id' || key === 'slug' || key.endsWith('Id')) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=payload.js.map

package/dist/integrations/webhook/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../src/integrations/webhook/payload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAA;IAChD,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,22 @@
+import type { Inngest } from 'inngest';
+import type { BaseCorePluginOptions } from '@forumone/throughline-plugin-contract';
+import type { Integration } from './types.js';
+export declare const DEFAULT_INTEGRATIONS_SLUG = "integrations";
+export interface IntegrationsPluginOptions extends BaseCorePluginOptions {
+    /**
+     * Inngest client used to register integration functions and to fire
+     * manual-sync trigger events. Required: integrations are an
+     * event-driven feature and there is no useful behaviour without one.
+     */
+    inngest: Inngest;
+    /**
+     * Integration modules to register, in addition to the built-in webhook
+     * integration. Order matters only for tie-breaking in lists; the registry
+     * rejects duplicate ids.
+     */
+    integrations?: Integration[];
+    /** Override the Integrations collection slug. Default: 'integrations'. */
+    collectionSlug?: string;
+}
+export declare function validateOptions(options: IntegrationsPluginOptions): IntegrationsPluginOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,eAAO,MAAM,yBAAyB,iBAAiB,CAAA;AAEvD,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,yBAAyB,GAAG,yBAAyB,CAK7F"}

package/dist/options.js

@@ -0,0 +1,8 @@
+export const DEFAULT_INTEGRATIONS_SLUG = 'integrations';
+export function validateOptions(options) {
+    if (!options.inngest) {
+        throw new Error('integrationsPlugin requires an Inngest client (`options.inngest`).');
+    }
+    return options;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,yBAAyB,GAAG,cAAc,CAAA;AAmBvD,MAAM,UAAU,eAAe,CAAC,OAAkC;IAChE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,19 @@
+import type { CorePlugin } from '@forumone/throughline-plugin-contract';
+import { type IntegrationsPluginOptions } from './options.js';
+import { IntegrationRegistry } from './registry.js';
+import type { IntegrationContext } from './types.js';
+/**
+ * Integrations server. Registers the Integrations collection, the
+ * five-tool MCP server, and a process-local registry of integration
+ * modules. The webhook integration is registered automatically; clients
+ * extend the registry by passing additional integrations via options.
+ *
+ * Integration Inngest functions are not served here — they are exposed
+ * via `getIntegrationRegistry(payload)` so the client app's Inngest
+ * endpoint can merge them with its own functions. See
+ * `docs/integrations-wiring.md` in the repository root.
+ */
+export declare const integrationsPlugin: CorePlugin<IntegrationsPluginOptions>;
+export declare function getIntegrationRegistry(payload: unknown): IntegrationRegistry | undefined;
+export declare function getIntegrationContext(payload: unknown): IntegrationContext | undefined;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,uCAAuC,CAAA;AAQ1F,OAAO,EAAE,KAAK,yBAAyB,EAA8C,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAkBpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAAU,CAAC,yBAAyB,CAoJlE,CAAA;AAEH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAExF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAEtF"}

package/dist/plugin.js

@@ -0,0 +1,162 @@
+import { getPluginRegistry } from '@forumone/throughline-plugin-contract';
+import { createMcpHandler, createNamedLogger, defaultLogger, getAuditWriter, } from '@forumone/throughline-core';
+import { validateOptions, DEFAULT_INTEGRATIONS_SLUG } from './options.js';
+import { IntegrationRegistry } from './registry.js';
+import { createIntegrationsCollection } from './collection.js';
+import { webhookIntegration } from './integrations/index.js';
+import { createGetIntegrationStatusTool, createListIntegrationsTool, createListIntegrationTypesTool, createTestIntegrationTool, createTriggerSyncTool, } from './tools/index.js';
+const PLUGIN_ID = '@forumone/throughline-integrations';
+const PLUGIN_VERSION = '0.1.0';
+const MCP_HANDLER_SYMBOL = Symbol.for('@forumone/throughline/integrations-mcp-handler');
+const REGISTRY_SYMBOL = Symbol.for('@forumone/throughline/integrations-registry');
+const CONTEXT_SYMBOL = Symbol.for('@forumone/throughline/integrations-context');
+/**
+ * Integrations server. Registers the Integrations collection, the
+ * five-tool MCP server, and a process-local registry of integration
+ * modules. The webhook integration is registered automatically; clients
+ * extend the registry by passing additional integrations via options.
+ *
+ * Integration Inngest functions are not served here — they are exposed
+ * via `getIntegrationRegistry(payload)` so the client app's Inngest
+ * endpoint can merge them with its own functions. See
+ * `docs/integrations-wiring.md` in the repository root.
+ */
+export const integrationsPlugin = (rawOptions) => (incomingConfig) => {
+    if (rawOptions.enabled === false)
+        return incomingConfig;
+    const options = validateOptions(rawOptions);
+    const collectionSlug = options.collectionSlug ?? DEFAULT_INTEGRATIONS_SLUG;
+    const routePrefix = options.routePrefix ?? '/integrations';
+    const logger = createNamedLogger('integrations', options.logger ?? defaultLogger);
+    const registry = new IntegrationRegistry();
+    registry.register(webhookIntegration);
+    for (const integration of options.integrations ?? []) {
+        registry.register(integration);
+    }
+    const collection = createIntegrationsCollection({ slug: collectionSlug, registry });
+    return {
+        ...incomingConfig,
+        collections: [...(incomingConfig.collections ?? []), collection],
+        endpoints: [
+            ...(incomingConfig.endpoints ?? []),
+            {
+                path: `${routePrefix}/mcp`,
+                method: 'post',
+                handler: async (req) => {
+                    const handler = req.payload[MCP_HANDLER_SYMBOL];
+                    if (!handler) {
+                        return new Response(JSON.stringify({ error: 'Integrations MCP not initialized' }), { status: 503, headers: { 'content-type': 'application/json' } });
+                    }
+                    return handler(req);
+                },
+            },
+        ],
+        onInit: async (payload) => {
+            if (incomingConfig.onInit)
+                await incomingConfig.onInit(payload);
+            const pluginRegistry = getPluginRegistry(payload);
+            pluginRegistry.requireCapability('audit-log', PLUGIN_ID);
+            const auditWriter = getAuditWriter(payload);
+            const context = {
+                inngest: options.inngest,
+                integrationsCollectionSlug: collectionSlug,
+                async loadInstances(integrationId) {
+                    const result = await payload.find({
+                        collection: collectionSlug,
+                        where: {
+                            and: [
+                                { integrationType: { equals: integrationId } },
+                                { enabled: { equals: true } },
+                            ],
+                        },
+                        limit: 100,
+                    });
+                    return result.docs.map((doc) => ({
+                        id: String(doc['id']),
+                        name: String(doc['name']),
+                        config: (doc['config'] ?? {}),
+                    }));
+                },
+                async updateStatus(instanceId, status, error) {
+                    await payload.update({
+                        collection: collectionSlug,
+                        id: instanceId,
+                        data: {
+                            lastSyncAt: new Date().toISOString(),
+                            lastSyncStatus: status,
+                            ...(error !== undefined ? { lastError: error } : { lastError: null }),
+                        },
+                    });
+                },
+                async recordAudit(event) {
+                    await auditWriter({
+                        actor: { type: 'system', apiKeyName: `integration:${event.integrationId}` },
+                        action: event.action,
+                        mcpServer: 'integrations',
+                        mcpTool: `integration:${event.integrationId}`,
+                        integrationId: event.instanceName,
+                        summary: event.summary,
+                        ...(event.errorMessage ? { errorMessage: event.errorMessage } : {}),
+                        success: event.action === 'integration.synced',
+                    });
+                },
+            };
+            for (const integration of registry.list()) {
+                const fnCount = integration.createFunctions(context).length;
+                logger.info('Integration registered', {
+                    id: integration.id,
+                    inngestFunctions: fnCount,
+                });
+            }
+            const deps = { payload, collectionSlug };
+            const tools = [
+                createListIntegrationsTool(deps),
+                createGetIntegrationStatusTool(deps),
+                createTriggerSyncTool({ ...deps, inngest: options.inngest }),
+                createTestIntegrationTool({ ...deps, registry }),
+                createListIntegrationTypesTool({ registry }),
+            ];
+            const handler = createMcpHandler({
+                payload,
+                serverName: 'integrations',
+                tools,
+                logger,
+            });
+            Object.defineProperty(payload, MCP_HANDLER_SYMBOL, {
+                value: handler,
+                enumerable: false,
+                writable: false,
+                configurable: false,
+            });
+            Object.defineProperty(payload, REGISTRY_SYMBOL, {
+                value: registry,
+                enumerable: false,
+                writable: false,
+                configurable: false,
+            });
+            Object.defineProperty(payload, CONTEXT_SYMBOL, {
+                value: context,
+                enumerable: false,
+                writable: false,
+                configurable: false,
+            });
+            pluginRegistry.register({
+                id: PLUGIN_ID,
+                version: PLUGIN_VERSION,
+                capabilities: ['integrations', 'integration-registry'],
+            });
+            logger.info('Integrations server ready', {
+                collectionSlug,
+                routePrefix,
+                integrationCount: registry.size,
+            });
+        },
+    };
+};
+export function getIntegrationRegistry(payload) {
+    return payload[REGISTRY_SYMBOL];
+}
+export function getIntegrationContext(payload) {
+    return payload[CONTEXT_SYMBOL];
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,15 @@
+import type { Integration } from './types.js';
+/**
+ * Tiny registry keyed by integration id. Construction is per-plugin-init
+ * (not a module-level singleton) so two Payload configs in the same process
+ * don't share state. Keeps duplicate-id detection synchronous and simple.
+ */
+export declare class IntegrationRegistry {
+    private readonly byId;
+    register(integration: Integration): void;
+    get(id: string): Integration | undefined;
+    list(): Integration[];
+    has(id: string): boolean;
+    get size(): number;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAiC;IAEtD,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAOxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,IAAI,IAAI,WAAW,EAAE;IAIrB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/registry.js

@@ -0,0 +1,27 @@
+/**
+ * Tiny registry keyed by integration id. Construction is per-plugin-init
+ * (not a module-level singleton) so two Payload configs in the same process
+ * don't share state. Keeps duplicate-id detection synchronous and simple.
+ */
+export class IntegrationRegistry {
+    byId = new Map();
+    register(integration) {
+        if (this.byId.has(integration.id)) {
+            throw new Error(`Integration "${integration.id}" is already registered`);
+        }
+        this.byId.set(integration.id, integration);
+    }
+    get(id) {
+        return this.byId.get(id);
+    }
+    list() {
+        return Array.from(this.byId.values());
+    }
+    has(id) {
+        return this.byId.has(id);
+    }
+    get size() {
+        return this.byId.size;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IACb,IAAI,GAAG,IAAI,GAAG,EAAuB,CAAA;IAEtD,QAAQ,CAAC,WAAwB;QAC/B,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,gBAAgB,WAAW,CAAC,EAAE,yBAAyB,CAAC,CAAA;QAC1E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC1B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;IACvB,CAAC;CACF"}

package/dist/tools/access.d.ts

@@ -0,0 +1,7 @@
+import type { McpToolContext } from '@forumone/throughline-plugin-contract';
+export declare function isIntegrationsReader(ctx: McpToolContext): boolean;
+export declare function isIntegrationsAdmin(ctx: McpToolContext): boolean;
+export declare function deniedEnvelope(reason: string): {
+    error: string;
+};
+//# sourceMappingURL=access.d.ts.map

package/dist/tools/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../../src/tools/access.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAE3E,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAIjE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAGhE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAEhE"}

package/dist/tools/access.js

@@ -0,0 +1,15 @@
+export function isIntegrationsReader(ctx) {
+    if (!ctx.user)
+        return false;
+    const roles = ctx.user.roles;
+    return roles.includes('admin') || roles.includes('editor');
+}
+export function isIntegrationsAdmin(ctx) {
+    if (!ctx.user)
+        return false;
+    return ctx.user.roles.includes('admin');
+}
+export function deniedEnvelope(reason) {
+    return { error: reason };
+}
+//# sourceMappingURL=access.js.map

package/dist/tools/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../../src/tools/access.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAAC,GAAmB;IACtD,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAA;IAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAmB;IACrD,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC1B,CAAC"}

package/dist/tools/get-integration-status.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { Payload } from 'payload';
+import type { McpToolDefinition } from '@forumone/throughline-plugin-contract';
+export interface GetIntegrationStatusDeps {
+    payload: Payload;
+    collectionSlug: string;
+}
+declare const inputSchema: z.ZodObject<{
+    integrationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    integrationId: string;
+}, {
+    integrationId: string;
+}>;
+export declare function createGetIntegrationStatusTool(deps: GetIntegrationStatusDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=get-integration-status.d.ts.map

package/dist/tools/get-integration-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-integration-status.d.ts","sourceRoot":"","sources":["../../src/tools/get-integration-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAG9E,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,QAAA,MAAM,WAAW;;;;;;EAIf,CAAA;AAEF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,wBAAwB,GAC7B,iBAAiB,CAAC,OAAO,WAAW,CAAC,CAkCvC"}

package/dist/tools/get-integration-status.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { deniedEnvelope, isIntegrationsReader } from './access.js';
+const inputSchema = z.object({
+    integrationId: z
+        .string()
+        .describe('The ID of the integration instance (the row id from list_integrations).'),
+});
+export function createGetIntegrationStatusTool(deps) {
+    return {
+        name: 'get_integration_status',
+        description: 'Detailed status for a single integration instance — including its last sync time, last error, and current configuration metadata (config values themselves are admin-only and not returned).',
+        inputSchema,
+        handler: async (input, ctx) => {
+            if (!isIntegrationsReader(ctx)) {
+                return deniedEnvelope('Only admins and editors can view integration status.');
+            }
+            let doc = null;
+            try {
+                doc = (await deps.payload.findByID({
+                    collection: deps.collectionSlug,
+                    id: input.integrationId,
+                }));
+            }
+            catch {
+                doc = null;
+            }
+            if (!doc)
+                return { error: `No integration instance with id "${input.integrationId}".` };
+            return {
+                id: String(doc['id']),
+                name: String(doc['name']),
+                type: String(doc['integrationType']),
+                enabled: doc['enabled'] === true,
+                lastSyncAt: typeof doc['lastSyncAt'] === 'string' ? doc['lastSyncAt'] : null,
+                lastSyncStatus: typeof doc['lastSyncStatus'] === 'string' ? doc['lastSyncStatus'] : 'never-run',
+                lastError: typeof doc['lastError'] === 'string' ? doc['lastError'] : null,
+            };
+        },
+    };
+}
+//# sourceMappingURL=get-integration-status.js.map

package/dist/tools/get-integration-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-integration-status.js","sourceRoot":"","sources":["../../src/tools/get-integration-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAOlE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC,CAAA;AAEF,MAAM,UAAU,8BAA8B,CAC5C,IAA8B;IAE9B,OAAO;QACL,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,8LAA8L;QAChM,WAAW;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,cAAc,CAAC,sDAAsD,CAAC,CAAA;YAC/E,CAAC;YAED,IAAI,GAAG,GAAmC,IAAI,CAAA;YAC9C,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;oBACjC,UAAU,EAAE,IAAI,CAAC,cAAc;oBAC/B,EAAE,EAAE,KAAK,CAAC,aAAa;iBACxB,CAAC,CAAmC,CAAA;YACvC,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,IAAI,CAAA;YACZ,CAAC;YAED,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,KAAK,EAAE,oCAAoC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAA;YAEvF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACrB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACzB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBACpC,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI;gBAChC,UAAU,EAAE,OAAO,GAAG,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC5E,cAAc,EAAE,OAAO,GAAG,CAAC,gBAAgB,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,WAAW;gBAC/F,SAAS,EAAE,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;aAC1E,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,12 @@
+export { createListIntegrationsTool } from './list-integrations.js';
+export type { ListIntegrationsDeps } from './list-integrations.js';
+export { createGetIntegrationStatusTool } from './get-integration-status.js';
+export type { GetIntegrationStatusDeps } from './get-integration-status.js';
+export { createTriggerSyncTool } from './trigger-sync.js';
+export type { TriggerSyncDeps } from './trigger-sync.js';
+export { createTestIntegrationTool } from './test-integration.js';
+export type { TestIntegrationDeps } from './test-integration.js';
+export { createListIntegrationTypesTool } from './list-integration-types.js';
+export type { ListIntegrationTypesDeps } from './list-integration-types.js';
+export { isIntegrationsReader, isIntegrationsAdmin } from './access.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AACzD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAC5E,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAA;AAC3E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+export { createListIntegrationsTool } from './list-integrations.js';
+export { createGetIntegrationStatusTool } from './get-integration-status.js';
+export { createTriggerSyncTool } from './trigger-sync.js';
+export { createTestIntegrationTool } from './test-integration.js';
+export { createListIntegrationTypesTool } from './list-integration-types.js';
+export { isIntegrationsReader, isIntegrationsAdmin } from './access.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEnE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAEzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AAEjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA;AAE5E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA"}

package/dist/tools/list-integration-types.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { McpToolDefinition } from '@forumone/throughline-plugin-contract';
+import type { IntegrationRegistry } from '../registry.js';
+export interface ListIntegrationTypesDeps {
+    registry: IntegrationRegistry;
+}
+declare const inputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare function createListIntegrationTypesTool(deps: ListIntegrationTypesDeps): McpToolDefinition<typeof inputSchema>;
+export {};
+//# sourceMappingURL=list-integration-types.d.ts.map