feat(runtime): add production control-plane foundation

2026-07-18 12:43:46 +08:00
parent 9451e1ee42
commit 293c015f89
13 changed files with 513 additions and 31 deletions
@@ -0,0 +1,43 @@
+import { resolve } from 'node:path';
+import {
+  CANARY_DEFAULT_PORT,
+  CANARY_DEFAULT_UPSTREAM_PORT,
+  type CanaryGatewayOptions,
+} from './canary-gateway.js';
+
+export interface CanaryRuntimeEnvironment {
+  readonly CANARY_DIST_DIR?: string;
+  readonly CANARY_PORT?: string;
+  readonly CANARY_UPSTREAM_PORT?: string;
+  readonly MULTI_SIMADMIN_GATEWAY_TOKEN?: string;
+}
+
+function environmentPort(value: string | undefined, name: string, fallback: number): number {
+  if (value === undefined || value === '') return fallback;
+  const port = Number(value);
+  if (!Number.isInteger(port) || port < 1 || port > 65_535)
+    throw new Error(`${name} must be an integer port`);
+  return port;
+}
+
+export function readCanaryRuntimeOptions(
+  environment: CanaryRuntimeEnvironment,
+): CanaryGatewayOptions {
+  const gatewayToken = environment.MULTI_SIMADMIN_GATEWAY_TOKEN;
+  if (
+    !gatewayToken ||
+    Buffer.byteLength(gatewayToken) < 32 ||
+    Buffer.byteLength(gatewayToken) > 512
+  )
+    throw new Error('Gateway token must contain between 32 and 512 bytes');
+  return Object.freeze({
+    distDir: resolve(environment.CANARY_DIST_DIR ?? 'apps/web/dist'),
+    port: environmentPort(environment.CANARY_PORT, 'CANARY_PORT', CANARY_DEFAULT_PORT),
+    upstreamPort: environmentPort(
+      environment.CANARY_UPSTREAM_PORT,
+      'CANARY_UPSTREAM_PORT',
+      CANARY_DEFAULT_UPSTREAM_PORT,
+    ),
+    gatewayToken,
+  });
+}