@shipfox/api-integration-core 8.0.0 → 9.0.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@shipfox/api-integration-core",
   "license": "MIT",
-  "version": "8.0.0",
+  "version": "9.0.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ShipfoxHQ/shipfox.git",
@@ -11,10 +11,6 @@
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "imports": {
-    "#test/*": "./test/*",
-    "#*": "./dist/*"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -27,30 +23,42 @@
     "ajv": "^8.20.0",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@shipfox/api-agent-dto": "8.0.0",
-    "@shipfox/api-auth-context": "7.1.0",
-    "@shipfox/api-workflows-dto": "8.0.0",
-    "@shipfox/api-integration-core-dto": "8.0.0",
-    "@shipfox/api-workspaces-dto": "6.0.0",
-    "@shipfox/api-integration-gitea": "8.0.0",
-    "@shipfox/api-integration-github": "8.0.0",
-    "@shipfox/api-integration-jira": "8.0.0",
-    "@shipfox/api-integration-linear": "8.0.0",
-    "@shipfox/api-integration-sentry": "8.0.0",
-    "@shipfox/api-integration-slack": "8.0.0",
-    "@shipfox/api-integration-webhook": "8.0.0",
-    "@shipfox/config": "1.2.2",
-    "@shipfox/inter-module": "0.2.0",
-    "@shipfox/node-drizzle": "0.3.2",
-    "@shipfox/node-fastify": "0.3.0",
-    "@shipfox/node-module": "0.5.0",
-    "@shipfox/node-opentelemetry": "0.6.0",
-    "@shipfox/node-error-monitoring": "0.2.0",
-    "@shipfox/node-outbox": "0.2.4",
-    "@shipfox/node-postgres": "0.4.2",
-    "@shipfox/node-temporal": "0.4.0",
-    "@shipfox/regex": "0.2.2",
-    "@shipfox/redact": "0.2.3"
+    "@shipfox/api-agent-dto": "9.0.2",
+    "@shipfox/api-auth-context": "9.0.2",
+    "@shipfox/api-workflows-dto": "9.0.2",
+    "@shipfox/api-integration-core-dto": "9.0.2",
+    "@shipfox/api-integration-spi": "0.2.2",
+    "@shipfox/api-workspaces-dto": "9.0.2",
+    "@shipfox/api-integration-gitea": "9.0.2",
+    "@shipfox/api-integration-github": "9.0.2",
+    "@shipfox/api-integration-jira": "9.0.2",
+    "@shipfox/api-integration-linear": "9.0.2",
+    "@shipfox/api-integration-slack": "9.0.2",
+    "@shipfox/api-integration-sentry": "9.0.2",
+    "@shipfox/config": "1.2.4",
+    "@shipfox/api-integration-webhook": "9.0.2",
+    "@shipfox/inter-module": "0.2.2",
+    "@shipfox/node-drizzle": "0.3.4",
+    "@shipfox/node-fastify": "0.3.2",
+    "@shipfox/node-module": "1.0.1",
+    "@shipfox/node-error-monitoring": "0.2.2",
+    "@shipfox/node-opentelemetry": "0.6.2",
+    "@shipfox/node-outbox": "0.2.6",
+    "@shipfox/node-postgres": "0.4.4",
+    "@shipfox/node-temporal": "0.4.2",
+    "@shipfox/redact": "0.2.5",
+    "@shipfox/regex": "0.2.4"
+  },
+  "imports": {
+    "#*": "./dist/*"
+  },
+  "shipfox": {
+    "architecture": {
+      "schema": 1,
+      "realm": "source-available",
+      "kind": "implementation",
+      "context": "integrations"
+    }
   },
   "scripts": {
     "build": "shipfox-swc && shipfox-temporal-bundle dist/temporal/workflows/index.js",

package/src/core/agent-tool-selection.ts

@@ -3,7 +3,7 @@ import type {
   AgentToolSelectionCatalog,
   IntegrationCapability,
   IntegrationProviderKind,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import type {IntegrationProviderRegistry} from '#core/providers/registry.js';
 import {listIntegrationConnections} from '#db/connections.js';
 

package/src/core/entities/connection.ts

@@ -1,4 +1,4 @@
 export type {
   IntegrationConnection,
   IntegrationConnectionLifecycleStatus,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';

package/src/core/entities/provider.ts

@@ -3,7 +3,7 @@ import type {
   RegisteredIntegrationProvider as CoreRegisteredIntegrationProvider,
   WebhookRequestProcessor,
   WebhookRouteId,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import type {RouteExport} from '@shipfox/node-fastify';
 
 export type {
@@ -17,7 +17,7 @@ export type {
   IntegrationProviderAdapters,
   IntegrationProviderKind,
   OpenAgentToolsSessionInput,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 
 export type IntegrationProvider = CoreIntegrationProvider<string, RouteExport> & {
   webhookProcessors?:

package/src/core/errors.ts

@@ -2,7 +2,7 @@ import {
   ConnectionSlugConflictError,
   IntegrationProviderError,
   type IntegrationProviderErrorReason,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import type {IntegrationCapability, IntegrationProviderKind} from '#core/entities/provider.js';
 
 export class IntegrationConnectionNotFoundError extends Error {

package/src/core/providers/agent-tools.ts

@@ -7,4 +7,4 @@ export type {
   AgentToolSession,
   AgentToolsProvider,
   OpenAgentToolsSessionInput,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';

package/src/core/providers/redact-checkout-spec.test.ts

@@ -1,4 +1,4 @@
-import type {CheckoutSpec} from '@shipfox/api-integration-core-dto';
+import type {CheckoutSpec} from '@shipfox/api-integration-spi';
 import {redactCheckoutSpec} from './redact-checkout-spec.js';
 
 describe('redactCheckoutSpec', () => {

package/src/core/providers/redact-checkout-spec.ts

@@ -1,4 +1,4 @@
-import type {CheckoutSpec} from '@shipfox/api-integration-core-dto';
+import type {CheckoutSpec} from '@shipfox/api-integration-spi';
 import {REDACTION_PLACEHOLDER, stripUrlCredentials} from '@shipfox/redact';
 
 /**

package/src/core/providers/source-control.ts

@@ -14,4 +14,4 @@ export type {
   RepositoryVisibility,
   ResolveRepositoryInput,
   SourceControlProvider,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';

package/src/db/connections.test.ts

@@ -1,5 +1,5 @@
-import {ConnectionSlugConflictError} from '@shipfox/api-integration-core-dto';
 import {upsertGithubInstallation} from '@shipfox/api-integration-github';
+import {ConnectionSlugConflictError} from '@shipfox/api-integration-spi';
 import {IntegrationConnectionAlreadyExistsError} from '#core/errors.js';
 import {
   createIntegrationConnection,

package/src/db/connections.ts

@@ -1,7 +1,5 @@
-import {
-  CONNECTION_SLUG_MAX_LENGTH,
-  ConnectionSlugConflictError,
-} from '@shipfox/api-integration-core-dto';
+import {CONNECTION_SLUG_MAX_LENGTH} from '@shipfox/api-integration-core-dto';
+import {ConnectionSlugConflictError} from '@shipfox/api-integration-spi';
 import {and, eq} from 'drizzle-orm';
 import type {
   IntegrationConnection,

package/src/db/webhook-deliveries.test.ts

@@ -3,7 +3,7 @@ import {
   INTEGRATION_SOURCE_COMMIT_PUSHED,
   type IntegrationEventReceivedEvent,
   type SourcePushPayload,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {and, eq, sql} from 'drizzle-orm';
 import {db} from './db.js';
 import {integrationsOutbox} from './schema/outbox.js';

package/src/db/webhook-deliveries.ts

@@ -4,7 +4,7 @@ import {
   type IntegrationEventReceivedEvent,
   type IntegrationsEventMap,
   type SourcePushPayload,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {writeOutboxEvent, writeOutboxEvents} from '@shipfox/node-outbox';
 import {lt} from 'drizzle-orm';
 import {db} from './db.js';

package/src/index.test.ts

@@ -1,7 +1,4 @@
-import type {
-  StoredWebhookRequest,
-  WebhookRequestProcessor,
-} from '@shipfox/api-integration-core-dto';
+import type {StoredWebhookRequest, WebhookRequestProcessor} from '@shipfox/api-integration-spi';
 import {createOutboxRegistry, type ModuleService, startModuleServices} from '@shipfox/node-module';
 import {createIntegrationsContext, WebhookProcessorNotConfiguredError} from './index.js';
 

package/src/index.ts

@@ -6,7 +6,7 @@ import {
   type WebhookProcessingResult,
   type WebhookRequestProcessor,
   type WebhookRouteId,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import type {WorkflowsModuleClient} from '@shipfox/api-workflows-dto/inter-module';
 import type {WorkspacesInterModuleClient} from '@shipfox/api-workspaces-dto/inter-module';
 import {reportError} from '@shipfox/node-error-monitoring';
@@ -45,12 +45,12 @@ export type {
   WebhookProcessingResult,
   WebhookRequestProcessor,
   WebhookRouteId,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 export {
   buildProviderRepositoryId,
   MAX_REPOSITORY_FILE_BYTES,
   parseProviderRepositoryId,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 export type {
   AgentToolCatalogs,
   AgentToolSelectionCatalogs,
@@ -238,7 +238,7 @@ export async function createIntegrationsContext(
     ],
     startupTasks: runStartupTasks,
     database: [
-      {db, migrationsPath},
+      {db, migrationsPath, databaseNamespace: 'integrations'},
       ...parts.flatMap((part) => (part.database ? [part.database] : [])),
     ],
     routes: createIntegrationRoutes(registry, sourceControl, {

package/src/presentation/dto/integrations.ts

@@ -1,4 +1,3 @@
-import {toIntegrationConnectionDto as toCoreIntegrationConnectionDto} from '@shipfox/api-integration-core-dto';
 import type {IntegrationConnection} from '#core/entities/connection.js';
 import type {
   IntegrationCapability,
@@ -21,7 +20,27 @@ export function toIntegrationConnectionDto(
     externalUrl?: string | undefined;
   },
 ) {
-  return toCoreIntegrationConnectionDto(connection, options);
+  return mapIntegrationConnection(connection, options.capabilities, options.externalUrl);
+}
+
+function mapIntegrationConnection(
+  connection: IntegrationConnection,
+  capabilities: IntegrationCapability[],
+  externalUrl?: string,
+) {
+  return {
+    id: connection.id,
+    workspace_id: connection.workspaceId,
+    provider: connection.provider,
+    external_account_id: connection.externalAccountId,
+    slug: connection.slug,
+    display_name: connection.displayName,
+    lifecycle_status: connection.lifecycleStatus,
+    capabilities,
+    ...(externalUrl ? {external_url: externalUrl} : {}),
+    created_at: connection.createdAt.toISOString(),
+    updated_at: connection.updatedAt.toISOString(),
+  };
 }
 
 export function toRepositoryDto(connectionId: string, repository: RepositorySnapshot) {

package/src/presentation/routes/list-connections.ts

@@ -2,7 +2,7 @@ import {AUTH_USER, requireWorkspaceAccess} from '@shipfox/api-auth-context';
 import {
   listIntegrationConnectionsQuerySchema,
   listIntegrationConnectionsResponseSchema,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {defineRoute} from '@shipfox/node-fastify';
 import type {IntegrationProviderRegistry} from '#core/providers/registry.js';
 import {listIntegrationConnections} from '#db/connections.js';

package/src/presentation/routes/list-providers.ts

@@ -2,7 +2,7 @@ import {AUTH_USER} from '@shipfox/api-auth-context';
 import {
   listIntegrationProvidersQuerySchema,
   listIntegrationProvidersResponseSchema,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {defineRoute} from '@shipfox/node-fastify';
 import type {IntegrationProviderRegistry} from '#core/providers/registry.js';
 import {toIntegrationProviderDto} from '#presentation/dto/integrations.js';

package/src/presentation/routes/list-repositories.ts

@@ -3,7 +3,7 @@ import {
   listRepositoriesParamsSchema,
   listRepositoriesQuerySchema,
   listRepositoriesResponseSchema,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {defineRoute} from '@shipfox/node-fastify';
 import type {IntegrationSourceControlService} from '#core/source-control-service.js';
 import {toRepositoryDto} from '#presentation/dto/integrations.js';

package/src/presentation/routes/manage-connections.ts

@@ -2,7 +2,7 @@ import {AUTH_USER, requireWorkspaceAccess} from '@shipfox/api-auth-context';
 import {
   integrationConnectionDtoSchema,
   updateIntegrationConnectionBodySchema,
-} from '@shipfox/api-integration-core-dto';
+} from '@shipfox/api-integration-spi';
 import {ClientError, defineRoute} from '@shipfox/node-fastify';
 import {z} from 'zod';
 import type {IntegrationProviderRegistry} from '#core/providers/registry.js';

package/src/providers/connection-slug.ts

@@ -1,8 +1,16 @@
-import {ConnectionSlugConflictError} from '@shipfox/api-integration-core-dto';
+import {CONNECTION_SLUG_MAX_LENGTH} from '@shipfox/api-integration-core-dto';
+import {ConnectionSlugConflictError} from '@shipfox/api-integration-spi';
 import {isIntegrationConnectionSlugUniqueViolation} from '#db/connections.js';
 
 const MAX_CONNECTION_SLUG_ATTEMPTS = 3;
 
+export function slugifyConnectionSlug(input: string, options: {fallback: string}): string {
+  const slug = normalizeSlug(input);
+  if (slug) return slug;
+
+  return normalizeSlug(options.fallback) || 'connection';
+}
+
 export async function retryConnectionSlugCollision<T>(operation: () => Promise<T>): Promise<T> {
   for (let attempt = 1; ; attempt += 1) {
     try {
@@ -17,3 +25,12 @@ export async function retryConnectionSlugCollision<T>(operation: () => Promise<T
     }
   }
 }
+
+function normalizeSlug(input: string): string {
+  return input
+    .toLowerCase()
+    .replaceAll(/[^a-z0-9]+/g, '_')
+    .replaceAll(/^_+|_+$/g, '')
+    .slice(0, CONNECTION_SLUG_MAX_LENGTH)
+    .replaceAll(/_+$/g, '');
+}

package/src/providers/gitea.ts

@@ -1,8 +1,5 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {ConnectGiteaConnectionInput} from '@shipfox/api-integration-gitea';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   getIntegrationConnectionById,
@@ -11,15 +8,9 @@ import {
 } from '#db/connections.js';
 import {db} from '#db/db.js';
 import {publishSourcePush, recordDeliveryOnly} from '#db/webhook-deliveries.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {IntegrationModuleParts, IntegrationProviderModule} from '#providers/types.js';
 
-// Stable migration-tracking table name for the Gitea provider database. This
-// must NOT depend on the provider's position in the module `database` array. A
-// positional name would shift if a provider is flag-disabled and silently
-// re-run migrations against existing tables.
-const GITEA_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_gitea';
-
 async function loadGiteaModuleParts(): Promise<IntegrationModuleParts> {
   const {
     createGiteaIntegrationProvider,
@@ -94,7 +85,7 @@ async function loadGiteaModuleParts(): Promise<IntegrationModuleParts> {
     database: {
       db: giteaDb,
       migrationsPath: giteaMigrationsPath,
-      migrationsTableName: GITEA_MIGRATIONS_TABLE,
+      databaseNamespace: 'integrations_gitea',
     },
   };
 }

package/src/providers/github.ts

@@ -1,8 +1,5 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {ConnectGithubInstallationInput} from '@shipfox/api-integration-github';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   getIntegrationConnectionById,
@@ -15,19 +12,13 @@ import {
   publishSourcePush,
   recordDeliveryOnly,
 } from '#db/webhook-deliveries.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {
   IntegrationModuleParts,
   IntegrationProviderModule,
   IntegrationProviderModuleLoadOptions,
 } from '#providers/types.js';
 
-// Stable migration-tracking table name for the GitHub provider database. This
-// must NOT depend on the provider's position in the module `database` array. A
-// positional name would shift if a provider is flag-disabled and silently
-// re-run migrations against existing tables.
-const GITHUB_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_github';
-
 async function loadGithubModuleParts(
   options: IntegrationProviderModuleLoadOptions = {},
 ): Promise<IntegrationModuleParts> {
@@ -144,7 +135,7 @@ async function loadGithubModuleParts(
     database: {
       db: githubDb,
       migrationsPath: githubMigrationsPath,
-      migrationsTableName: GITHUB_MIGRATIONS_TABLE,
+      databaseNamespace: 'integrations_github',
     },
   };
 }

package/src/providers/jira.test.ts

@@ -26,7 +26,7 @@ describe('jiraProviderModule', () => {
     await runMigrations(
       jiraPart.database.db(),
       jiraPart.database.migrationsPath,
-      jiraPart.database.migrationsTableName,
+      `__drizzle_migrations_${jiraPart.database.databaseNamespace}`,
     );
     const connection = await upsertIntegrationConnection({
       workspaceId,

package/src/providers/jira.ts

@@ -1,12 +1,9 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {
   ConnectJiraInstallationInput,
   JiraPendingSelectionSecretsStore,
   JiraSecretsStore,
 } from '@shipfox/api-integration-jira';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   deleteIntegrationConnection,
@@ -16,10 +13,9 @@ import {
   upsertIntegrationConnection,
 } from '#db/connections.js';
 import {db} from '#db/db.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {IntegrationModuleParts, IntegrationProviderModule} from '#providers/types.js';
 
-const JIRA_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_jira';
 const JIRA_SECRETS_NAMESPACE_PREFIX = 'system/integrations/jira/';
 type IntegrationDb = ReturnType<typeof db>;
 type IntegrationTx = Parameters<Parameters<IntegrationDb['transaction']>[0]>[0];
@@ -157,7 +153,7 @@ async function loadJiraModuleParts(
           : {}),
       },
     }),
-    database: {db: jiraDb, migrationsPath, migrationsTableName: JIRA_MIGRATIONS_TABLE},
+    database: {db: jiraDb, migrationsPath, databaseNamespace: 'integrations_jira'},
   };
 }
 

package/src/providers/linear.test.ts

@@ -27,7 +27,7 @@ describe('linearProviderModule', () => {
     await runMigrations(
       linearPart.database.db(),
       linearPart.database.migrationsPath,
-      linearPart.database.migrationsTableName,
+      `__drizzle_migrations_${linearPart.database.databaseNamespace}`,
     );
     const app = await createTestApp([linearPart.provider]);
     const connection = await upsertIntegrationConnection({
@@ -99,7 +99,7 @@ describe('linearProviderModule', () => {
     await runMigrations(
       linearPart.database.db(),
       linearPart.database.migrationsPath,
-      linearPart.database.migrationsTableName,
+      `__drizzle_migrations_${linearPart.database.databaseNamespace}`,
     );
     const connection = await upsertIntegrationConnection({
       workspaceId: context.workspaceId,

package/src/providers/linear.ts

@@ -1,11 +1,8 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {
   ConnectLinearInstallationInput,
   LinearSecretsStore,
 } from '@shipfox/api-integration-linear';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   deleteIntegrationConnection,
@@ -15,10 +12,9 @@ import {
 } from '#db/connections.js';
 import {db} from '#db/db.js';
 import {publishIntegrationEventReceived, recordDeliveryOnly} from '#db/webhook-deliveries.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {IntegrationModuleParts, IntegrationProviderModule} from '#providers/types.js';
 
-const LINEAR_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_linear';
 const LINEAR_SECRETS_NAMESPACE_PREFIX = 'system/integrations/linear/';
 
 type IntegrationDb = ReturnType<typeof db>;
@@ -180,7 +176,7 @@ async function loadLinearModuleParts(
     database: {
       db: linearDb,
       migrationsPath: linearMigrationsPath,
-      migrationsTableName: LINEAR_MIGRATIONS_TABLE,
+      databaseNamespace: 'integrations_linear',
     },
   };
 }

package/src/providers/sentry.ts

@@ -1,8 +1,5 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {ConnectSentryInstallationInput} from '@shipfox/api-integration-sentry';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   getIntegrationConnectionById,
@@ -12,15 +9,9 @@ import {
 } from '#db/connections.js';
 import {db} from '#db/db.js';
 import {publishIntegrationEventReceived, recordDeliveryOnly} from '#db/webhook-deliveries.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {IntegrationModuleParts, IntegrationProviderModule} from '#providers/types.js';
 
-// Stable migration-tracking table name for the Sentry provider database. This
-// must NOT depend on the provider's position in the module `database` array. A
-// positional name would shift if a provider is flag-disabled and silently
-// re-run migrations against existing tables.
-const SENTRY_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_sentry';
-
 async function loadSentryModuleParts(): Promise<IntegrationModuleParts> {
   const {
     createSentryIntegrationProvider,
@@ -103,7 +94,7 @@ async function loadSentryModuleParts(): Promise<IntegrationModuleParts> {
     database: {
       db: sentryDb,
       migrationsPath: sentryMigrationsPath,
-      migrationsTableName: SENTRY_MIGRATIONS_TABLE,
+      databaseNamespace: 'integrations_sentry',
     },
     workers: [createSentryMaintenanceWorker()],
   };

package/src/providers/slack.test.ts

@@ -30,7 +30,7 @@ describe('slackProviderModule', () => {
     await runMigrations(
       slackPart.database.db(),
       slackPart.database.migrationsPath,
-      slackPart.database.migrationsTableName,
+      `__drizzle_migrations_${slackPart.database.databaseNamespace}`,
     );
     const connection = await upsertIntegrationConnection({
       workspaceId,
@@ -81,7 +81,7 @@ describe('slackProviderModule', () => {
     await runMigrations(
       slackPart.database.db(),
       slackPart.database.migrationsPath,
-      slackPart.database.migrationsTableName,
+      `__drizzle_migrations_${slackPart.database.databaseNamespace}`,
     );
     const app = await createTestApp([slackPart.provider]);
     const connection = await upsertIntegrationConnection({
@@ -159,7 +159,7 @@ describe('slackProviderModule', () => {
     await runMigrations(
       slackPart.database.db(),
       slackPart.database.migrationsPath,
-      slackPart.database.migrationsTableName,
+      `__drizzle_migrations_${slackPart.database.databaseNamespace}`,
     );
     const connection = await upsertIntegrationConnection({
       workspaceId: context.workspaceId,

package/src/providers/slack.ts

@@ -1,11 +1,8 @@
-import {
-  type IntegrationConnection as CoreIntegrationConnection,
-  slugifyConnectionSlug,
-} from '@shipfox/api-integration-core-dto';
 import type {
   ConnectSlackInstallationInput,
   SlackSecretsStore,
 } from '@shipfox/api-integration-slack';
+import type {IntegrationConnection as CoreIntegrationConnection} from '@shipfox/api-integration-spi';
 import {config} from '#config.js';
 import {
   deleteIntegrationConnection,
@@ -19,10 +16,9 @@ import {
   publishIntegrationEventReceived,
   recordDeliveryOnly,
 } from '#db/webhook-deliveries.js';
-import {retryConnectionSlugCollision} from '#providers/connection-slug.js';
+import {retryConnectionSlugCollision, slugifyConnectionSlug} from '#providers/connection-slug.js';
 import type {IntegrationModuleParts, IntegrationProviderModule} from '#providers/types.js';
 
-const SLACK_MIGRATIONS_TABLE = '__drizzle_migrations_integrations_slack';
 const SLACK_SECRETS_NAMESPACE_PREFIX = 'system/integrations/slack/';
 
 type IntegrationDb = ReturnType<typeof db>;
@@ -183,7 +179,7 @@ async function loadSlackModuleParts(
     database: {
       db: slackDb,
       migrationsPath: slackMigrationsPath,
-      migrationsTableName: SLACK_MIGRATIONS_TABLE,
+      databaseNamespace: 'integrations_slack',
     },
   };
 }

package/src/providers/types.ts

@@ -1,5 +1,5 @@
 import type {UserContextMembership} from '@shipfox/api-auth-context';
-import type {WebhookRequestProcessor, WebhookRouteId} from '@shipfox/api-integration-core-dto';
+import type {WebhookRequestProcessor, WebhookRouteId} from '@shipfox/api-integration-spi';
 import type {RouteExport} from '@shipfox/node-fastify';
 import type {ModuleDatabase, ModuleWorker} from '@shipfox/node-module';
 import type {IntegrationProvider} from '#core/entities/provider.js';