wip v26

Author: geraldarthurdavis

uapi/jest.config.cjs

@@ -70,6 +70,7 @@ module.exports = {
     // -------------------------------------------------------------------
     '^@/lib/protocol-demonstration-app-context$': '<rootDir>/lib/protocol-demonstration-app-context.ts',
     '^@/lib/bitcode-app-context$': '<rootDir>/lib/bitcode-app-context.ts',
+    '^@/lib/bitcode-app-context-options$': '<rootDir>/lib/bitcode-app-context-options.ts',
     '^@/lib/mock-review-mode$': '<rootDir>/lib/mock-review-mode.ts',
     '^@/lib/logger$': '<rootDir>/../packages/pipelines-generics/src/logger.ts',
     '^@/lib/engine/pipeline$': '<rootDir>/../packages/pipelines-generics/src/pipeline/index.ts',

uapi/lib/bitcode-app-context-options.ts

@@ -0,0 +1,32 @@
+import os from 'node:os';
+import path from 'node:path';
+
+type BitcodeAppContextOptions = {
+  dataPath?: string;
+};
+
+function isServerlessRuntime(env: NodeJS.ProcessEnv) {
+  return (
+    env.VERCEL === '1'
+    || Boolean(env.LAMBDA_TASK_ROOT)
+    || Boolean(env.AWS_LAMBDA_FUNCTION_NAME)
+    || String(env.AWS_EXECUTION_ENV || '').startsWith('AWS_Lambda')
+  );
+}
+
+export function resolveBitcodeAppContextOptions(
+  env: NodeJS.ProcessEnv = process.env,
+): BitcodeAppContextOptions {
+  const configuredDataPath = String(env.BITCODE_DATA_PATH || '').trim();
+  if (configuredDataPath) {
+    return { dataPath: configuredDataPath };
+  }
+
+  if (isServerlessRuntime(env)) {
+    return {
+      dataPath: path.join(os.tmpdir(), 'bitcode-uapi-state.json'),
+    };
+  }
+
+  return {};
+}

uapi/lib/bitcode-app-context.ts

@@ -1,9 +1,11 @@
 import { createAppContext } from '@bitcode/protocol-demonstration';
 import { NextResponse } from 'next/server';
 
+import { resolveBitcodeAppContextOptions } from '@/lib/bitcode-app-context-options';
+
 type StatusError = Error & { statusCode?: number | undefined };
 
-const bitcodeAppContext = createAppContext();
+const bitcodeAppContext = createAppContext(resolveBitcodeAppContextOptions());
 
 export function getBitcodeAppContext() {
   return bitcodeAppContext;

uapi/tests/api/bitcodeAppContextOptions.test.ts

@@ -0,0 +1,25 @@
+import os from 'node:os';
+import path from 'node:path';
+
+import { resolveBitcodeAppContextOptions } from '@/lib/bitcode-app-context-options';
+
+describe('resolveBitcodeAppContextOptions', () => {
+  it('uses an explicit Bitcode state path when configured', () => {
+    expect(
+      resolveBitcodeAppContextOptions({
+        BITCODE_DATA_PATH: '/tmp/custom-bitcode-state.json',
+        VERCEL: '1',
+      }),
+    ).toEqual({ dataPath: '/tmp/custom-bitcode-state.json' });
+  });
+
+  it('keeps the protocol-demonstration default outside serverless runtimes', () => {
+    expect(resolveBitcodeAppContextOptions({})).toEqual({});
+  });
+
+  it('moves mutable Bitcode state to tmp in Vercel/serverless runtimes', () => {
+    expect(resolveBitcodeAppContextOptions({ VERCEL: '1' })).toEqual({
+      dataPath: path.join(os.tmpdir(), 'bitcode-uapi-state.json'),
+    });
+  });
+});