deepline 0.3.89 → 0.3.90

package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-queue-suffix.ts

@@ -0,0 +1,73 @@
+import { createHash } from 'node:crypto';
+import { PROD_DEFAULT_RUNTIME_SCHEDULER_SCHEMA } from '../runtime-scheduler-topology';
+
+type EnvMap = Record<string, string | undefined>;
+
+/** Per-process suffix used to isolate Absurd queue tables. */
+export const ABSURD_QUEUE_SUFFIX_ENV = 'DEEPLINE_ABSURD_QUEUE_SUFFIX';
+
+/** Scheduler schema native to this process. */
+export const ABSURD_SCHEDULER_SCHEMA_ENV = 'DEEPLINE_RUNTIME_SCHEDULER_SCHEMA';
+
+/** The production scheduler schema uses the canonical, unsuffixed queues. */
+export const ABSURD_PROD_DEFAULT_SCHEMA = PROD_DEFAULT_RUNTIME_SCHEDULER_SCHEMA;
+
+export const ABSURD_DEV_RELEASE_PREFIX = 'dev-';
+
+function normalizeQueueSuffixValue(raw: string): string {
+  return raw
+    .toLowerCase()
+    .replace(/[^a-z0-9_]+/g, '_')
+    .replace(/^_+|_+$/g, '')
+    .slice(0, 32);
+}
+
+/** Read and normalize the queue suffix owned by this process. */
+export function resolveAbsurdQueueSuffix(env: EnvMap = process.env): string {
+  const raw = env[ABSURD_QUEUE_SUFFIX_ENV]?.trim();
+  return raw ? normalizeQueueSuffixValue(raw) : '';
+}
+
+/**
+ * Resolve the queue suffix for an explicitly selected scheduler schema.
+ * The process-owned suffix applies only to its native schema. A different
+ * explicitly selected schema is a remote runtime and therefore derives the
+ * stable schema fingerprint provisioned by that runtime's worker workflow.
+ */
+export function resolveAbsurdQueueSuffixForSchema(
+  schema?: string | null,
+  env: EnvMap = process.env,
+): string {
+  const normalizedSchema = schema?.trim();
+  const envSuffix = resolveAbsurdQueueSuffix(env);
+  if (!normalizedSchema || normalizedSchema === ABSURD_PROD_DEFAULT_SCHEMA) {
+    return envSuffix;
+  }
+  const nativeSchema = env[ABSURD_SCHEDULER_SCHEMA_ENV]?.trim();
+  if (envSuffix && nativeSchema === normalizedSchema) return envSuffix;
+  return resolveAbsurdQueueSuffixForIsolatedSchema(normalizedSchema);
+}
+
+/** Pure queue identity for an explicitly selected isolated scheduler schema. */
+export function resolveAbsurdQueueSuffixForIsolatedSchema(
+  schema: string,
+): string {
+  const normalizedSchema = schema.trim();
+  if (!normalizedSchema || normalizedSchema === ABSURD_PROD_DEFAULT_SCHEMA) {
+    throw new Error('An isolated scheduler schema is required.');
+  }
+  return normalizeQueueSuffixValue(
+    createHash('sha256').update(normalizedSchema).digest('hex').slice(0, 12),
+  );
+}
+
+/** Map a non-empty isolated queue suffix to its dev-collapse release id. */
+export function absurdDevReleaseIdForQueueSuffix(suffix: string): string {
+  const normalized = normalizeQueueSuffixValue(suffix.trim());
+  if (!normalized) {
+    throw new Error(
+      'An isolated Absurd runtime environment requires a non-empty queue suffix.',
+    );
+  }
+  return `${ABSURD_DEV_RELEASE_PREFIX}${normalized}`;
+}