fix: centralize local runtime targets

Signed-off-by: zebbern <185730623+zebbern@users.noreply.github.com>

Author: zebbern

backend/package.json

@@ -35,6 +35,7 @@
     "@opensearch-project/opensearch": "^3.5.1",
     "@sentris/backend-client": "workspace:*",
     "@sentris/component-sdk": "workspace:*",
+    "@sentris/local-runtime": "workspace:*",
     "@sentris/shared": "workspace:*",
     "@sentris/worker": "workspace:*",
     "@temporalio/client": "^1.14.1",

backend/scripts/__tests__/script-database-target.test.ts

@@ -201,4 +201,26 @@ describe('script database target resolver', () => {
       );
     }
   });
+
+  it('prevents DB-backed integration tests from falling back to the legacy local database', () => {
+    const integrationTestFiles = [
+      join(repoRoot, 'backend', 'src', '__tests__', 'backend-integration.test.ts'),
+      join(repoRoot, 'worker', 'src', '__tests__', 'worker-integration.test.ts'),
+      join(repoRoot, 'worker', 'src', 'adapters', '__tests__', 'file-storage.adapter.test.ts'),
+    ];
+
+    for (const file of integrationTestFiles) {
+      const source = readFileSync(file, 'utf-8');
+      expect(source, `${file} should use the shared script database resolver`).toContain(
+        'getScriptDatabaseTarget',
+      );
+      expect(
+        source,
+        `${file} should not read DATABASE_URL directly for its fallback`,
+      ).not.toContain('process.env.DATABASE_URL ||');
+      expect(source, `${file} should not fall back to the legacy sentris database`).not.toContain(
+        'postgresql://sentris:sentris@localhost:5433/sentris',
+      );
+    }
+  });
 });

backend/src/__tests__/backend-integration.test.ts

@@ -15,14 +15,25 @@ import {
 } from '../workflows/dto/workflow-graph.dto';
 import { WorkflowDefinition } from '../dsl/types';
 import { UploadedFile } from '../storage/storage.service';
+import {
+  formatDatabaseTarget,
+  getScriptDatabaseTarget,
+  readActiveInstance,
+} from '@sentris/local-runtime';
 
 const runIntegration = process.env.RUN_BACKEND_INTEGRATION === 'true';
 
-const baseUrl =
-  process.env.BACKEND_BASE_URL ??
-  `http://localhost:${process.env.BACKEND_PORT ?? process.env.PORT ?? '3211'}`;
+function resolveBackendBaseUrl(): string {
+  if (process.env.BACKEND_BASE_URL) return process.env.BACKEND_BASE_URL;
+
+  const explicitPort = process.env.BACKEND_PORT ?? process.env.PORT;
+  if (explicitPort) return `http://localhost:${explicitPort}`;
+
+  const activeInstance = readActiveInstance();
+  return `http://localhost:${3211 + Number(activeInstance.instance) * 100}`;
+}
 
-const api = (path: string) => `${baseUrl}${path}`;
+const api = (path: string) => `${resolveBackendBaseUrl()}${path}`;
 
 const normalizeNode = (override: Partial<WorkflowNodeDto> = {}): WorkflowNodeDto => ({
   id: override.id ?? 'node-1',
@@ -140,6 +151,13 @@ interface Component {
     // eslint-disable-next-line no-console
     console.log('🚀 Starting backend integration test setup...');
 
+    const databaseTarget = getScriptDatabaseTarget({
+      overrideEnvVar: 'BACKEND_INTEGRATION_DATABASE_URL',
+    });
+    process.env.DATABASE_URL = databaseTarget.connectionString;
+    // eslint-disable-next-line no-console
+    console.log(formatDatabaseTarget(databaseTarget));
+
     const { AppModule } = await import('../app.module');
 
     // Create NestJS test application
@@ -151,9 +169,7 @@ interface Component {
     await app.init();
 
     // Initialize database connection for cleanup
-    const connectionString =
-      process.env.DATABASE_URL || 'postgresql://sentris:sentris@localhost:5433/sentris';
-    pool = new Pool({ connectionString });
+    pool = new Pool({ connectionString: databaseTarget.connectionString });
     db = drizzle(pool);
 
     // Initialize MinIO client

backend/tsconfig.json

@@ -27,6 +27,9 @@
     {
       "path": "../packages/component-sdk"
     },
+    {
+      "path": "../packages/local-runtime"
+    },
     {
       "path": "../packages/backend-client"
     },

bun.lock

@@ -10,6 +10,7 @@
     "packages/backend-client",
     "packages/component-sdk",
     "packages/contracts",
+    "packages/local-runtime",
     "packages/shared"
   ],
   "scripts": {

package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@sentris/local-runtime",
+  "version": "0.1.0",
+  "type": "module",
+  "packageManager": "bun@1.3.10",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "license": "MIT",
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "bun-types": "^1.3.6",
+    "typescript": "^5.9.3"
+  }
+}