@mycadet/gateway 0.12.11 → 0.13.0

package/src/feature-flag-remote-store.ts

@@ -1,166 +0,0 @@
-/**
- * Gateway-side remote feature flag store — file-backed persistence of
- * feature flag values pushed from the cloud.
- *
- * Mirrors the feature-flag-store.ts pattern: file path resolution via
- * getGatewaySecurityDir(), atomic writes (temp file + rename), 0o600
- * permissions, and module-level caching with manual invalidation.
- *
- * Unlike the local override store, writes replace the *entire* value map at
- * once (the cloud pushes a complete snapshot) and immediately update the
- * in-memory cache so no file watcher is needed.
- */
-
-import {
-  chmodSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  renameSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
-
-import { getLogger } from "./logger.js";
-import { getGatewaySecurityDir } from "./paths.js";
-
-const log = getLogger("feature-flag-remote-store");
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-interface FeatureFlagFileData {
-  version: 1;
-  values: Record<string, boolean | string>;
-}
-
-// ---------------------------------------------------------------------------
-// File path
-// ---------------------------------------------------------------------------
-
-export function getRemoteFeatureFlagStorePath(): string {
-  return join(getGatewaySecurityDir(), "feature-flags-remote.json");
-}
-
-// ---------------------------------------------------------------------------
-// Disk I/O with caching
-// ---------------------------------------------------------------------------
-
-let cachedRemoteValues: Record<string, boolean | string> | null = null;
-
-export function readRemoteFeatureFlags(): Record<string, boolean | string> {
-  if (cachedRemoteValues != null) return cachedRemoteValues;
-
-  const path = getRemoteFeatureFlagStorePath();
-  if (!existsSync(path)) {
-    cachedRemoteValues = {};
-    return cachedRemoteValues;
-  }
-
-  try {
-    const raw = readFileSync(path, "utf-8");
-    const data = JSON.parse(raw) as FeatureFlagFileData;
-
-    if (data.version !== 1) {
-      log.warn(
-        { version: data.version },
-        "Unknown remote feature flag store version, returning empty values",
-      );
-      cachedRemoteValues = {};
-      return cachedRemoteValues;
-    }
-
-    if (
-      data.values &&
-      typeof data.values === "object" &&
-      !Array.isArray(data.values)
-    ) {
-      const filtered: Record<string, boolean | string> = {};
-      for (const [k, v] of Object.entries(data.values)) {
-        if (typeof v === "boolean" || typeof v === "string") filtered[k] = v;
-      }
-      cachedRemoteValues = filtered;
-    } else {
-      cachedRemoteValues = {};
-    }
-    return cachedRemoteValues;
-  } catch (err) {
-    log.error({ err }, "Failed to load remote feature flag store");
-    cachedRemoteValues = {};
-    return cachedRemoteValues;
-  }
-}
-
-/**
- * Persist remote feature flags to disk and update the in-memory cache.
- * Returns `true` when the new values differ from the previous cache.
- */
-export function writeRemoteFeatureFlags(
-  values: Record<string, boolean | string>,
-): boolean {
-  const path = getRemoteFeatureFlagStorePath();
-  const dir = dirname(path);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-
-  const data: FeatureFlagFileData = { version: 1, values };
-  const tmpPath = path + ".tmp." + process.pid;
-  writeFileSync(tmpPath, JSON.stringify(data, null, 2), { mode: 0o600 });
-  renameSync(tmpPath, path);
-  chmodSync(path, 0o600);
-
-  const changed = !shallowEqual(cachedRemoteValues, values);
-  cachedRemoteValues = values;
-
-  const msg = "Wrote remote feature flags";
-  const meta = { count: Object.keys(values).length };
-  if (changed) {
-    log.info(meta, msg);
-  } else {
-    log.debug(meta, msg);
-  }
-
-  return changed;
-}
-
-/**
- * Returns `true` when the incoming flag snapshot matches what's already
- * cached. Only used for log-level gating — correctness doesn't depend on it.
- */
-function shallowEqual(
-  a: Record<string, boolean | string> | null,
-  b: Record<string, boolean | string>,
-): boolean {
-  if (a == null) return false;
-  const aKeys = Object.keys(a);
-  if (aKeys.length !== Object.keys(b).length) return false;
-  for (const k of aKeys) {
-    if (a[k] !== b[k]) return false;
-  }
-  return true;
-}
-
-/**
- * Clear the in-memory cache so the next `readRemoteFeatureFlags()` call
- * re-reads from disk. Useful in tests for resetting state between cases.
- */
-export function clearRemoteFeatureFlagStoreCache(): void {
-  cachedRemoteValues = null;
-}
-
-/**
- * Re-read the remote feature flag file from disk into the in-memory cache.
- *
- * Called by the file watcher when `feature-flags-remote.json` changes on
- * disk (e.g. written by a separate process or a previous gateway instance).
- * This ensures the next `readRemoteFeatureFlags()` call returns fresh data
- * without requiring every read to hit disk.
- */
-export function refreshRemoteFeatureFlagStoreCache(): void {
-  cachedRemoteValues = null;
-  // Force a re-read into cache immediately so the next
-  // readRemoteFeatureFlags() call picks up the new values.
-  readRemoteFeatureFlags();
-}