@checkstack/integration-backend 0.1.30 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,89 @@
 # @checkstack/integration-backend
 
+## 0.2.0
+
+### Minor Changes
+
+- 41c77f4: feat(automation): one-time migration of webhook subscriptions + remove legacy integration backend
+
+  **BREAKING CHANGES** (platform is in BETA — no major bump):
+
+  - `IntegrationProvider` no longer carries `config` (subscription
+    config) or `deliver`. The interface now models a connection provider
+    only: connection schema + `getConnectionOptions` + `testConnection`.
+  - The legacy subscription / delivery-log / event endpoints
+    (`listSubscriptions`, `createSubscription`, `getDeliveryLogs`,
+    `listEventTypes`, …) are removed from `integrationContract`.
+  - `delivery-coordinator`, `hook-subscriber`, `event-registry`, and the
+    `integrationEventExtensionPoint` are deleted. Plugins that
+    previously called `integrationEvents.registerEvent(...)` now
+    register their hooks as automation triggers via
+    `automationTriggerExtensionPoint.registerTrigger(...)`.
+  - Frontend pages `IntegrationsPage` and `DeliveryLogsPage` are gone;
+    the integration plugin's only remaining UI is connection
+    management. Subscription management lives under `/automation/...`.
+  - `webhook_subscriptions` and `delivery_logs` tables stay in the
+    database for one release as a safety net (no code reads or writes
+    them), and will be dropped in a follow-up migration.
+
+  **New**:
+
+  - `jira.create_issue`, `teams.post_message`, `webex.post_message`,
+    `webhook.send`, `integration-script.run_shell`, and
+    `integration-script.run_script` actions registered against the
+    Automation Platform with matching `*.message`, `*.delivery`,
+    `shell.result`, and `script.result` artifact types. The script
+    plugin exposes **two** actions — `run_shell` runs bash via the
+    shared `ShellScriptRunner` (Monaco `shell` editor), `run_script`
+    runs an ESM module in a Bun subprocess via `EsmScriptRunner`
+    (Monaco `typescript` editor + `defineIntegration` helper) — to
+    preserve the legacy provider split. `jira.create_issue` keeps the
+    dynamic field-mapping dropdown (driven by
+    `JIRA_RESOLVERS.FIELD_OPTIONS`).
+  - One-time data migration runs on boot in
+    `automation-backend.afterPluginsReady`. It reads
+    `webhook_subscriptions` via a new service RPC
+    `IntegrationApi.listLegacySubscriptions`, translates each row into
+    a single-trigger / single-action automation (marked with
+    `managed_by = "migrated-subscription:<id>"`), and is idempotent
+    across restarts.
+  - Failed translations are recorded in a new
+    `automation_migration_failures` table and surfaced via
+    `AutomationApi.listMigrationFailures` /
+    `acknowledgeMigrationFailure` so admins can review and re-create
+    failed entries by hand.
+
+### Patch Changes
+
+- 41c77f4: feat(jira): register Jira automation actions + `jira.issue` artifact type
+
+  Adds three Jira actions to the Automation platform:
+
+  - `jira.create_issue` — produces the new `jira.issue` artifact type
+    (`issueKey`, `projectKey`, `issueUrl`, `id`, `status?`)
+  - `jira.transition_issue` — consumes `jira.issue` (or accepts an
+    explicit `issueKey`), idempotent against already-applied transitions
+  - `jira.add_comment` — consumes `jira.issue` (or accepts an explicit
+    `issueKey`)
+
+  Extends the Jira client with `getTransitions`, `getIssueStatus`,
+  `transitionIssue` (handles 204 No Content, comment in ADF for Cloud /
+  plain text for Data Center), and `addComment`. Adds a new
+  `JIRA_RESOLVERS.TRANSITION_OPTIONS` cascading dropdown driven by
+  `connectionId` + `issueKey`. `@checkstack/integration-backend` now
+  re-exports the `ConnectionStore` interface so action plugins can take
+  it as a typed dep.
+
+- Updated dependencies [41c77f4]
+- Updated dependencies [6d52276]
+- Updated dependencies [35bc682]
+  - @checkstack/integration-common@0.6.0
+  - @checkstack/common@0.12.0
+  - @checkstack/backend-api@0.18.0
+  - @checkstack/command-backend@0.1.31
+  - @checkstack/signal-common@0.2.5
+  - @checkstack/queue-api@0.3.6
+
 ## 0.1.30
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/integration-backend",
-  "version": "0.1.30",
+  "version": "0.2.0",
   "license": "Elastic-2.0",
   "type": "module",
   "main": "src/index.ts",
@@ -16,11 +16,11 @@
   },
   "dependencies": {
     "@checkstack/integration-common": "0.5.0",
-    "@checkstack/backend-api": "0.17.0",
+    "@checkstack/backend-api": "0.17.1",
     "@checkstack/signal-common": "0.2.4",
-    "@checkstack/queue-api": "0.3.4",
+    "@checkstack/queue-api": "0.3.5",
     "@checkstack/common": "0.11.0",
-    "@checkstack/command-backend": "0.1.29",
+    "@checkstack/command-backend": "0.1.30",
     "drizzle-orm": "^0.45.0",
     "zod": "^4.2.1",
     "@orpc/server": "^1.13.2"
@@ -29,7 +29,7 @@
     "@checkstack/drizzle-helper": "0.0.5",
     "@checkstack/scripts": "0.3.3",
     "@checkstack/tsconfig": "0.0.7",
-    "@checkstack/test-utils-backend": "0.1.29",
+    "@checkstack/test-utils-backend": "0.1.30",
     "@types/node": "^20.0.0",
     "drizzle-kit": "^0.31.10",
     "typescript": "^5.0.0"

package/src/index.ts

@@ -13,26 +13,14 @@ import {
 } from "@checkstack/integration-common";
 import { resolveRoute } from "@checkstack/common";
 import type { PluginMetadata } from "@checkstack/common";
-import type {
-  IntegrationEventDefinition,
-  IntegrationProvider,
-} from "./provider-types";
+import type { IntegrationProvider } from "./provider-types";
 
 import * as schema from "./schema";
-import {
-  createIntegrationEventRegistry,
-  type IntegrationEventRegistry,
-} from "./event-registry";
-import {
-  createIntegrationProviderRegistry,
-  type IntegrationProviderRegistry,
-} from "./provider-registry";
-import { createDeliveryCoordinator } from "./delivery-coordinator";
+import { createIntegrationProviderRegistry } from "./provider-registry";
 import {
   createConnectionStore,
   type ConnectionStore,
 } from "./connection-store";
-import { subscribeToRegisteredEvents } from "./hook-subscriber";
 import { createIntegrationRouter } from "./router";
 import { registerSearchProvider } from "@checkstack/command-backend";
 
@@ -41,11 +29,11 @@ import { registerSearchProvider } from "@checkstack/command-backend";
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 /**
- * Service reference for the connection store.
- * Provider plugins can inject this to access connection credentials.
+ * Service reference for the connection store. Provider plugins inject
+ * this to look up credentials when an automation action runs.
  */
 export const connectionStoreRef = createServiceRef<ConnectionStore>(
-  "integration.connectionStore"
+  "integration.connectionStore",
 );
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -53,45 +41,21 @@ export const connectionStoreRef = createServiceRef<ConnectionStore>(
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 /**
- * Extension point for registering integration events.
- * Plugins use this to expose their hooks for external webhook subscriptions.
- */
-export interface IntegrationEventExtensionPoint {
-  /**
-   * Register a hook as an integration event.
-   * The event will be namespaced by the plugin's ID automatically.
-   */
-  registerEvent<T>(
-    definition: IntegrationEventDefinition<T>,
-    pluginMetadata: PluginMetadata
-  ): void;
-}
-
-export const integrationEventExtensionPoint =
-  createExtensionPoint<IntegrationEventExtensionPoint>(
-    "integration.eventExtensionPoint"
-  );
-
-/**
- * Extension point for registering integration providers.
- * Plugins use this to register webhook delivery providers.
+ * Extension point for registering integration providers. After the
+ * migration to the Automation Platform a provider is just the
+ * connection metadata + dropdown resolvers + a test endpoint — the
+ * per-event delivery work moved onto automation actions.
  */
 export interface IntegrationProviderExtensionPoint {
-  /**
-   * Register an integration provider.
-   * The provider will be namespaced by the plugin's ID automatically.
-   * @template TConfig - Per-subscription configuration type
-   * @template TConnection - Site-wide connection configuration type (optional)
-   */
-  addProvider<TConfig, TConnection = undefined>(
-    provider: IntegrationProvider<TConfig, TConnection>,
-    pluginMetadata: PluginMetadata
+  addProvider<TConnection = undefined>(
+    provider: IntegrationProvider<TConnection>,
+    pluginMetadata: PluginMetadata,
   ): void;
 }
 
 export const integrationProviderExtensionPoint =
   createExtensionPoint<IntegrationProviderExtensionPoint>(
-    "integration.providerExtensionPoint"
+    "integration.providerExtensionPoint",
   );
 
 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -102,34 +66,15 @@ export default createBackendPlugin({
   metadata: pluginMetadata,
 
   register(env) {
-    // Create the registries
-    const eventRegistry = createIntegrationEventRegistry();
     const providerRegistry = createIntegrationProviderRegistry();
 
-    // Register static access rules
     env.registerAccessRules(integrationAccessRules);
 
-    // Register the event extension point
-    env.registerExtensionPoint(integrationEventExtensionPoint, {
-      registerEvent: <T>(
-        definition: IntegrationEventDefinition<T>,
-        metadata: PluginMetadata
-      ) => {
-        // Type erasure: cast to unknown for storage (the registry handles this internally)
-        eventRegistry.register(
-          definition as IntegrationEventDefinition<unknown>,
-          metadata
-        );
-      },
-    });
-
-    // Register the provider extension point
     env.registerExtensionPoint(integrationProviderExtensionPoint, {
       addProvider: (provider, metadata) => {
-        // Type erasure: cast to unknown for storage (the registry handles this internally)
         providerRegistry.register(
           provider as IntegrationProvider<unknown>,
-          metadata
+          metadata,
         );
       },
     });
@@ -140,167 +85,59 @@ export default createBackendPlugin({
         logger: coreServices.logger,
         rpc: coreServices.rpc,
         config: coreServices.config,
-        signalService: coreServices.signalService,
-        queueManager: coreServices.queueManager,
       },
-      init: async ({
-        logger,
-        database,
-        rpc,
-        config,
-        signalService,
-        queueManager,
-      }) => {
+      init: async ({ logger, rpc, config, database }) => {
         logger.debug("🔌 Initializing Integration Backend...");
 
-        const db = database;
-
-        // Create connection store for generic connection management
         const connectionStore = createConnectionStore({
           configService: config,
           providerRegistry,
           logger,
         });
-
-        // Publish connection store for provider plugins to inject
         env.registerService(connectionStoreRef, connectionStore);
 
-        // Create delivery coordinator
-        const deliveryCoordinator = createDeliveryCoordinator({
-          db,
-          providerRegistry,
-          connectionStore,
-          queueManager,
-          signalService,
-          logger,
-        });
-
-        // Store for afterPluginsReady access
-        (
-          env as unknown as {
-            eventRegistry: IntegrationEventRegistry;
-            providerRegistry: IntegrationProviderRegistry;
-            deliveryCoordinator: typeof deliveryCoordinator;
-          }
-        ).eventRegistry = eventRegistry;
-        (
-          env as unknown as {
-            eventRegistry: IntegrationEventRegistry;
-            providerRegistry: IntegrationProviderRegistry;
-            deliveryCoordinator: typeof deliveryCoordinator;
-          }
-        ).providerRegistry = providerRegistry;
-        (
-          env as unknown as {
-            eventRegistry: IntegrationEventRegistry;
-            providerRegistry: IntegrationProviderRegistry;
-            deliveryCoordinator: typeof deliveryCoordinator;
-          }
-        ).deliveryCoordinator = deliveryCoordinator;
-
-        // Create and register the router
         const router = createIntegrationRouter({
-          db,
-          eventRegistry,
+          db: database,
           providerRegistry,
-          deliveryCoordinator,
           connectionStore,
-          signalService,
           logger,
         });
         rpc.registerRouter(router, integrationContract);
 
-        // Register command palette commands
         registerSearchProvider({
           pluginMetadata,
           commands: [
             {
-              id: "create",
-              title: "Create Integration Subscription",
-              subtitle: "Create a new subscription for integration events",
-              iconName: "Webhook",
-              route:
-                resolveRoute(integrationRoutes.routes.list) + "?action=create",
-              requiredAccessRules: [integrationAccess.manage],
-            },
-            {
-              id: "manage",
-              title: "Manage Integrations",
-              subtitle: "Manage integration subscriptions and connections",
+              id: "connections",
+              title: "Manage Integration Connections",
+              subtitle: "Configure credentials for Jira, Teams, Webex, etc.",
               iconName: "Webhook",
               shortcuts: ["meta+shift+g", "ctrl+shift+g"],
               route: resolveRoute(integrationRoutes.routes.list),
               requiredAccessRules: [integrationAccess.manage],
             },
-            {
-              id: "logs",
-              title: "View Integration Logs",
-              subtitle: "View integration delivery logs",
-              iconName: "FileText",
-              route: resolveRoute(integrationRoutes.routes.logs),
-              requiredAccessRules: [integrationAccess.manage],
-            },
           ],
         });
 
-        logger.debug("✅ Integration Backend initialized.");
-      },
-      afterPluginsReady: async ({ logger, onHook }) => {
-        // Get registries from env
-        const stored = env as unknown as {
-          eventRegistry: IntegrationEventRegistry;
-          providerRegistry: IntegrationProviderRegistry;
-          deliveryCoordinator: ReturnType<typeof createDeliveryCoordinator>;
-        };
-
-        const events = stored.eventRegistry.getEvents();
-        const providers = stored.providerRegistry.getProviders();
-
         logger.debug(
-          `🔌 Registered ${events.length} integration events: ${events
-            .map((e) => e.eventId)
-            .join(", ")}`
+          `📡 Integration Backend init complete with ${providerRegistry.getProviders().length} providers`,
         );
-
-        logger.debug(
-          `📡 Registered ${providers.length} integration providers: ${providers
-            .map((p) => p.qualifiedId)
-            .join(", ")}`
-        );
-
-        // Subscribe to all registered integration events
-        // Uses work-queue mode to ensure only ONE instance processes each event
-        subscribeToRegisteredEvents({
-          onHook,
-          eventRegistry: stored.eventRegistry,
-          deliveryCoordinator: stored.deliveryCoordinator,
-          logger,
-        });
-
-        // Start the delivery worker
-        await stored.deliveryCoordinator.startWorker();
-
-        logger.debug("✅ Integration Backend afterPluginsReady complete.");
       },
     });
   },
 });
 
-// Re-export extension points for consumer plugins
-export { integrationEventExtensionPoint as eventExtensionPoint };
+// ─── Re-exports ─────────────────────────────────────────────────────────
+
 export { integrationProviderExtensionPoint as providerExtensionPoint };
 
-// Re-export provider types for consumer plugins
-// All backend-only types are defined here (not in integration-common)
 export type {
-  IntegrationEventDefinition,
-  IntegrationDeliveryContext,
-  IntegrationDeliveryResult,
   TestConnectionResult,
   ProviderDocumentation,
   ConnectionOption,
   GetConnectionOptionsParams,
   IntegrationProvider,
   RegisteredIntegrationProvider,
-  RegisteredIntegrationEvent,
 } from "./provider-types";
+
+export type { ConnectionStore } from "./connection-store";