@tradejs/infra 3.0.1 → 3.1.1

package/dist/runtimeStrategyReleases.js

@@ -0,0 +1,598 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/runtimeStrategyReleases.ts
+var runtimeStrategyReleases_exports = {};
+__export(runtimeStrategyReleases_exports, {
+  assertRuntimeStrategyReleaseConfig: () => assertRuntimeStrategyReleaseConfig,
+  getRuntimeStrategyDraft: () => getRuntimeStrategyDraft,
+  getRuntimeStrategyRelease: () => getRuntimeStrategyRelease,
+  listRuntimeStrategyReleases: () => listRuntimeStrategyReleases,
+  publishRuntimeStrategyRelease: () => publishRuntimeStrategyRelease,
+  recordRuntimeStrategyControlEvent: () => recordRuntimeStrategyControlEvent,
+  saveRuntimeStrategyDraft: () => saveRuntimeStrategyDraft,
+  verifyRuntimeStrategyRelease: () => verifyRuntimeStrategyRelease
+});
+module.exports = __toCommonJS(runtimeStrategyReleases_exports);
+var import_node_crypto = require("crypto");
+var import_types = require("@tradejs/types");
+
+// src/redis.ts
+var import_ioredis = __toESM(require("ioredis"));
+var TTL_1D = 86400;
+var SCREENSHOT_TOKEN_TTL_SECONDS = 15 * 60;
+var toJson = (value) => JSON.stringify(value);
+var logger = {
+  log: (level, message, ...args) => {
+    const method = level === "error" ? "error" : level === "warn" ? "warn" : "log";
+    console[method](`[infra:redis] ${message}`, ...args);
+  }
+};
+var redisConnectionWarningShown = false;
+var redisUnavailable = false;
+var isRedisConnectivityError = (error) => {
+  const errorText = [error.name, error.message, String(error)].join(" ");
+  return /ECONNREFUSED|ECONNRESET|ECONNABORTED|EPIPE|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|MaxRetriesPerRequestError|Connection is closed|Stream isn't writeable/i.test(
+    errorText
+  );
+};
+var toNonNegativeInt = (value, fallback) => {
+  const parsed = Number.parseInt(String(value ?? ""), 10);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+};
+var toPositiveInt = (value, fallback) => {
+  const parsed = Number.parseInt(String(value ?? ""), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+};
+var markRedisUnavailable = (error) => {
+  redisUnavailable = true;
+  if (redisConnectionWarningShown) return;
+  redisConnectionWarningShown = true;
+  logger.log(
+    "warn",
+    "Redis is unavailable: %s. Cache-dependent features are temporarily disabled.",
+    error.message
+  );
+};
+var getRedis = () => {
+  if (!global.__redis__) {
+    const host = process.env.REDIS_HOST || "127.0.0.1";
+    const port = toPositiveInt(process.env.REDIS_PORT, 6379);
+    const connectTimeout = toPositiveInt(
+      process.env.REDIS_CONNECT_TIMEOUT_MS,
+      3e3
+    );
+    const maxRetriesPerRequest = toNonNegativeInt(
+      process.env.REDIS_MAX_RETRIES_PER_REQUEST,
+      1
+    );
+    global.__redis__ = new import_ioredis.default({
+      host,
+      port,
+      connectTimeout,
+      maxRetriesPerRequest,
+      enableOfflineQueue: false,
+      retryStrategy: (attempt) => Math.min(attempt * 200, 2e3)
+    });
+    global.__redis__.on("error", (error) => {
+      if (isRedisConnectivityError(error)) {
+        markRedisUnavailable(error);
+        return;
+      }
+      logger.log("error", "Redis client error: %s", String(error));
+    });
+    global.__redis__.on("ready", () => {
+      redisUnavailable = false;
+      if (redisConnectionWarningShown) {
+        redisConnectionWarningShown = false;
+        logger.log("info", "Redis connection restored");
+      }
+    });
+  }
+  return global.__redis__;
+};
+var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var getRedisStatus = (redis) => String(redis.status ?? "ready");
+var waitForRedisReady = async (redis) => {
+  if (getRedisStatus(redis) === "ready") {
+    return true;
+  }
+  const readyTimeoutMs = toPositiveInt(
+    process.env.REDIS_READY_TIMEOUT_MS,
+    toPositiveInt(process.env.REDIS_CONNECT_TIMEOUT_MS, 3e3)
+  );
+  const startedAt = Date.now();
+  while (Date.now() - startedAt < readyTimeoutMs) {
+    if (getRedisStatus(redis) === "ready") {
+      return true;
+    }
+    if (getRedisStatus(redis) === "end") {
+      return false;
+    }
+    await sleep(50);
+  }
+  return getRedisStatus(redis) === "ready";
+};
+var getReadyRedis = async () => {
+  if (redisUnavailable) return null;
+  const redis = getRedis();
+  const ready = await waitForRedisReady(redis);
+  if (ready) {
+    return redis;
+  }
+  markRedisUnavailable(
+    new Error(`Redis is not ready (status=${getRedisStatus(redis)})`)
+  );
+  return null;
+};
+var toResultString = (result) => {
+  if (result == null) return null;
+  if (typeof result === "string") return result;
+  if (Buffer.isBuffer(result)) return result.toString("utf8");
+  return String(result);
+};
+var DEFAULT_OPTIONS = {
+  expire: TTL_1D
+};
+var parseJsonOrDeleteKey = async (redis, key, raw, fallback) => {
+  try {
+    return JSON.parse(raw);
+  } catch (e) {
+    logger.log("error", "failed JSON.parse(%s): %s", key, String(e));
+    await redis.del(key);
+    return fallback;
+  }
+};
+var getKeys = async (prefix) => {
+  if (redisUnavailable) return [];
+  const redis = await getReadyRedis();
+  if (!redis) return [];
+  const keys = [];
+  try {
+    let cursor = "0";
+    do {
+      const [nextCursor, batch] = await redis.scan(
+        cursor,
+        "MATCH",
+        `${prefix}*`,
+        "COUNT",
+        "200"
+      );
+      cursor = nextCursor;
+      for (const key of batch) {
+        if (key.startsWith(prefix)) {
+          keys.push(key);
+        }
+      }
+    } while (cursor !== "0");
+  } catch (e) {
+    if (e instanceof Error && isRedisConnectivityError(e)) {
+      markRedisUnavailable(e);
+      return [];
+    }
+    logger.log("warn", "failed SCAN for %s: %s", prefix, String(e));
+    return [];
+  }
+  return keys;
+};
+var getData = async (key, fallback = []) => {
+  if (redisUnavailable) return fallback;
+  const redis = await getReadyRedis();
+  if (!redis) return fallback;
+  try {
+    const rawJson = await redis.call("JSON.GET", key);
+    const raw = toResultString(rawJson);
+    if (raw == null) return fallback;
+    return parseJsonOrDeleteKey(redis, key, raw, fallback);
+  } catch (e) {
+    if (e instanceof Error && isRedisConnectivityError(e)) {
+      markRedisUnavailable(e);
+      return fallback;
+    }
+    logger.log(
+      "error",
+      "failed JSON.GET %s: %s (fallback to GET)",
+      key,
+      String(e)
+    );
+  }
+  try {
+    const raw = await redis.get(key);
+    if (raw == null) return fallback;
+    return parseJsonOrDeleteKey(redis, key, raw, fallback);
+  } catch (e) {
+    if (e instanceof Error && isRedisConnectivityError(e)) {
+      markRedisUnavailable(e);
+      return fallback;
+    }
+    logger.log("error", "failed GET %s: %s", key, String(e));
+    return fallback;
+  }
+};
+var setData = async (key, data, options = {}) => {
+  if (redisUnavailable) return;
+  const { expire } = { ...DEFAULT_OPTIONS, ...options };
+  const redis = await getReadyRedis();
+  if (!redis) return;
+  const value = toJson(data);
+  try {
+    await redis.call("JSON.SET", key, "$", value);
+    if (expire) {
+      await redis.expire(key, expire);
+    }
+  } catch (e) {
+    if (e instanceof Error && isRedisConnectivityError(e)) {
+      markRedisUnavailable(e);
+      return;
+    }
+    logger.log(
+      "error",
+      "failed JSON.SET %s: %s (fallback to SET)",
+      key,
+      String(e)
+    );
+    try {
+      if (expire) {
+        await redis.set(key, value, "EX", expire);
+      } else {
+        await redis.set(key, value);
+      }
+    } catch (e2) {
+      if (e2 instanceof Error && isRedisConnectivityError(e2)) {
+        markRedisUnavailable(e2);
+        return;
+      }
+      logger.log("error", "failed SET %s: %s", key, String(e2));
+    }
+  }
+};
+var setDataIfAbsent = async (key, data) => {
+  if (redisUnavailable) return false;
+  const redis = await getReadyRedis();
+  if (!redis) return false;
+  try {
+    return await redis.call("JSON.SET", key, "$", toJson(data), "NX") === "OK";
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+      return false;
+    }
+    logger.log(
+      "warn",
+      "failed JSON.SET NX %s: %s (fallback to SET NX)",
+      key,
+      String(error)
+    );
+    try {
+      return await redis.set(key, toJson(data), "NX") === "OK";
+    } catch (fallbackError) {
+      if (fallbackError instanceof Error && isRedisConnectivityError(fallbackError)) {
+        markRedisUnavailable(fallbackError);
+      }
+      logger.log("error", "failed SET NX %s: %s", key, String(fallbackError));
+      return false;
+    }
+  }
+};
+var incrementKey = async (key) => {
+  if (redisUnavailable) throw new Error("Redis is unavailable");
+  const redis = await getReadyRedis();
+  if (!redis) throw new Error("Redis is unavailable");
+  try {
+    return await redis.incr(key);
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
+var redisKeys = {
+  users: () => "users:index:",
+  user: (userName) => `users:index:${userName}`,
+  tradingAccounts: (userName) => `users:${userName}:trading-accounts:`,
+  tradingAccount: (userName, accountId) => `users:${userName}:trading-accounts:${accountId}`,
+  runtimeDeployments: (userName) => `users:${userName}:runtime:deployments:`,
+  runtimeDeployment: (userName, deploymentId) => `users:${userName}:runtime:deployments:${deploymentId}`,
+  runtimeDeploymentHeartbeat: (userName, deploymentId) => `users:${userName}:runtime:deployments:${deploymentId}:heartbeat`,
+  bots: (userName) => `users:${userName}:bots`,
+  botsPrefix: () => "users:",
+  bot: (userName, botId) => `users:${userName}:bots:${botId}`,
+  backtestConfig: (userName, config) => `users:${userName}:backtests:configs:${config}`,
+  strategies: (userName) => `users:${userName}:strategies`,
+  strategyConfig: (userName, strategyName, configId = "config") => `users:${userName}:strategies:${strategyName}:${configId}`,
+  runtimeStrategyDraft: (userName, strategyName) => `users:${userName}:strategies:${strategyName}:draft`,
+  runtimeStrategyReleases: (userName, strategyName) => `users:${userName}:strategies:${strategyName}:releases:`,
+  runtimeStrategyRelease: (userName, strategyName, releaseVersion) => `users:${userName}:strategies:${strategyName}:releases:${releaseVersion}`,
+  runtimeStrategyReleaseSequence: (userName, strategyName) => `users:${userName}:strategies:${strategyName}:release-seq`,
+  runtimeStrategyControlEvents: (userName) => `users:${userName}:runtime:strategy-control-events:`,
+  runtimeStrategyControlEvent: (userName, eventId) => `users:${userName}:runtime:strategy-control-events:${eventId}`,
+  strategyResults: (userName, strategyName) => `users:${userName}:strategies:${strategyName}:results`,
+  strategyCharts: (userName, mode) => `users:${userName}:strategies:charts:${mode}`,
+  strategyChartCards: (userName, mode) => `users:${userName}:strategies:charts:${mode}:cards:`,
+  strategyChartCard: (userName, mode, cardId) => `users:${userName}:strategies:charts:${mode}:cards:${cardId}`,
+  tests: (userName, strategyName) => strategyName ? `users:${userName}:tests:${strategyName}` : `users:${userName}:tests:`,
+  testOrders: (userName, strategyName, testName) => `users:${userName}:tests:${strategyName}:${testName}:orders`,
+  testConfig: (userName, strategyName, testName) => `users:${userName}:tests:${strategyName}:${testName}:config`,
+  testStat: (userName, strategyName, testName) => `users:${userName}:tests:${strategyName}:${testName}:stat`,
+  testSummaries: (userName) => `users:${userName}:tests:index:summary`,
+  cacheChunk: (userName, chunkId) => `users:${userName}:cache:tests:chunks:${chunkId}`,
+  cacheOrders: (userName, orderLogId) => `users:${userName}:cache:tests:orders:${orderLogId}`,
+  cachePositions: (userName, orderLogId) => `users:${userName}:cache:tests:positions:${orderLogId}`,
+  tickerUniverse: (userName, connectorName, universe, accountId) => universe || accountId ? `users:${userName}:cache:tickers:${connectorName}:${universe ?? "crypto"}:${accountId ?? "default"}` : `users:${userName}:cache:tickers:${connectorName}`,
+  signal: (symbol, signalId) => `signals:${symbol}:${signalId}`,
+  signalsBySymbol: (symbol) => `signals:${symbol}:`,
+  storeSignal: (symbol, signalId) => `store:signals:${symbol}:${signalId}`,
+  runtimeSignals: (userName) => `users:${userName}:runtime:signals:`,
+  runtimeSignal: (userName, signalId) => `users:${userName}:runtime:signals:${signalId}`,
+  runtimeSignalBuckets: (userName) => `users:${userName}:runtime:signals:days:`,
+  runtimeSignalBucket: (userName, dayKey, strategyName) => `users:${userName}:runtime:signals:days:${dayKey}:${strategyName}`,
+  runtimeSignalEvaluations: (userName) => `users:${userName}:runtime:signal-evaluations:`,
+  runtimeSignalEvaluation: (userName, evaluationId) => `users:${userName}:runtime:signal-evaluations:${evaluationId}`,
+  runtimeSignalEvaluationBuckets: (userName) => `users:${userName}:runtime:signal-evaluations:days:`,
+  runtimeSignalEvaluationBucket: (userName, dayKey, strategyName) => `users:${userName}:runtime:signal-evaluations:days:${dayKey}:${strategyName}`,
+  runtimeSignalEvaluationStatsBuckets: (userName) => `users:${userName}:runtime:signal-evaluation-stats:days:`,
+  runtimeSignalEvaluationStatsBucket: (userName, dayKey, strategyName) => `users:${userName}:runtime:signal-evaluation-stats:days:${dayKey}:${strategyName}`,
+  runtimeLineageScopeBucket: (userName, dayKey) => `users:${userName}:runtime:lineage-scopes:days:${dayKey}`,
+  runtimeTrades: (userName) => `users:${userName}:runtime:trade-records:`,
+  runtimeTrade: (userName, orderId) => `users:${userName}:runtime:trade-records:${orderId}`,
+  runtimeTradeBuckets: (userName) => `users:${userName}:runtime:trade-records:days:`,
+  runtimeTradeBucket: (userName, dayKey) => `users:${userName}:runtime:trade-records:days:${dayKey}`,
+  runtimeClosedTradeBuckets: (userName) => `users:${userName}:runtime:closed-trade-records:days:`,
+  runtimeClosedTradeBucket: (userName, dayKey) => `users:${userName}:runtime:closed-trade-records:days:${dayKey}`,
+  runtimeActiveTrades: (userName) => `users:${userName}:runtime:active-trades:`,
+  runtimeActiveTrade: (userName, symbol, scopeId) => scopeId ? `users:${userName}:runtime:active-trades:${scopeId}:${symbol}` : `users:${userName}:runtime:active-trades:${symbol}`,
+  aiChatHistory: (userName, symbolKey) => `users:${userName}:ai:chats:${symbolKey}`,
+  analysis: (symbol, signalId) => `analysis:${symbol}:${signalId}`,
+  screenshotSessionToken: (token) => `auth:screenshot:${token}`,
+  backtestResults: (userName, config, timestamp) => `users:${userName}:backtests:results:${config}:${timestamp}`,
+  backtestJobs: (userName) => `users:${userName}:backtests:jobs:`,
+  backtestJob: (userName, jobId) => `users:${userName}:backtests:jobs:${jobId}`,
+  backtestRuns: (userName) => `users:${userName}:backtests:runs:`,
+  backtestRun: (userName, runId) => `users:${userName}:backtests:runs:${runId}`,
+  backtestRunResults: (userName, runId) => `users:${userName}:backtests:runs:${runId}:results`,
+  backtestLatestRun: (userName, config) => `users:${userName}:backtests:latest:${config}`,
+  researchRuns: (userName) => `users:${userName}:research:runs:`,
+  researchRun: (userName, runId) => `users:${userName}:research:runs:${runId}`,
+  researchLatestRun: (userName, strategyName) => `users:${userName}:research:latest:${strategyName}`,
+  mlSignalsByStrategy: (strategyName) => `ml:${strategyName}:signals:`,
+  mlSignals: () => "ml:",
+  mlSignal: (strategyName, signalId) => `ml:${strategyName}:signals:${signalId}`,
+  mlResultsByStrategy: (strategyName) => `ml:${strategyName}:results:`,
+  mlResults: () => "ml:",
+  mlResult: (strategyName, signalId) => `ml:${strategyName}:results:${signalId}`
+};
+
+// src/runtimeStrategyReleases.ts
+var SHA256_RE = /^[a-f0-9]{64}$/;
+var FORBIDDEN_RELEASE_CONFIG_KEYS = /* @__PURE__ */ new Set([
+  "ACCOUNT_ID",
+  "AI_REPLAY_ANALYSES",
+  "DEPLOYMENT_ID",
+  "ENABLE",
+  "ENV",
+  "MAKE_ORDERS",
+  "RECORD_RUNTIME_TRADES",
+  "configId"
+]);
+var SECRET_CONFIG_KEY_RE = /(?:^|_)(?:API_KEY|API_SECRET|TOKEN|PASSWORD|PRIVATE_KEY)$/i;
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+var canonicalJson = (value) => {
+  const normalize = (current) => {
+    if (Array.isArray(current)) return current.map(normalize);
+    const record = asRecord(current);
+    if (!record) return current;
+    return Object.fromEntries(
+      Object.entries(record).filter(([, entry]) => entry !== void 0).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => [key, normalize(entry)])
+    );
+  };
+  return JSON.stringify(normalize(value));
+};
+var releaseContentSha256 = (release) => (0, import_node_crypto.createHash)("sha256").update(canonicalJson(release)).digest("hex");
+var assertStrategyName = (strategyName) => {
+  if (!/^[a-zA-Z0-9_-]+$/.test(strategyName)) {
+    throw new Error(`Invalid strategy name: ${strategyName}`);
+  }
+};
+var assertRuntimeStrategyReleaseConfig = (config) => {
+  const record = asRecord(config);
+  if (!record) throw new Error("Strategy release config must be an object");
+  for (const key of FORBIDDEN_RELEASE_CONFIG_KEYS) {
+    if (record[key] !== void 0) {
+      throw new Error(`${key} is a deployment binding, not release config`);
+    }
+  }
+  const inspect = (value, parentPath = "") => {
+    if (Array.isArray(value)) {
+      value.forEach(
+        (entry, index) => inspect(entry, `${parentPath}[${index}]`)
+      );
+      return;
+    }
+    const current = asRecord(value);
+    if (!current) return;
+    for (const [key, entry] of Object.entries(current)) {
+      const keyPath = parentPath ? `${parentPath}.${key}` : key;
+      if (SECRET_CONFIG_KEY_RE.test(key)) {
+        throw new Error(`${keyPath} is secret material, not release config`);
+      }
+      inspect(entry, keyPath);
+    }
+  };
+  inspect(record);
+  if (typeof record.INTERVAL !== "string" || !record.INTERVAL.trim()) {
+    throw new Error("Published strategy config must define INTERVAL");
+  }
+  if (record.UNIVERSE !== "crypto" && record.UNIVERSE !== "tradfi") {
+    throw new Error("Published strategy config must define a valid UNIVERSE");
+  }
+};
+var isRelease = (value) => {
+  const release = asRecord(value);
+  return Boolean(
+    release?.schema === import_types.RUNTIME_STRATEGY_RELEASE_SCHEMA && typeof release.strategyName === "string" && Number.isSafeInteger(release.releaseVersion) && Number(release.releaseVersion) > 0 && asRecord(release.config) && typeof release.createdAt === "number" && typeof release.createdBy === "string" && typeof release.contentSha256 === "string" && SHA256_RE.test(release.contentSha256)
+  );
+};
+var verifyRuntimeStrategyRelease = (value) => {
+  if (!isRelease(value)) throw new Error("Invalid runtime strategy release");
+  const { contentSha256, ...content } = value;
+  if (releaseContentSha256(content) !== contentSha256) {
+    throw new Error(
+      `${value.strategyName} v${value.releaseVersion} content checksum mismatch`
+    );
+  }
+  assertRuntimeStrategyReleaseConfig(value.config);
+  return value;
+};
+var getRuntimeStrategyDraft = async (userName, strategyName) => {
+  const value = await getData(
+    redisKeys.runtimeStrategyDraft(userName, strategyName),
+    null
+  );
+  const draft = asRecord(value);
+  return draft?.schema === import_types.RUNTIME_STRATEGY_DRAFT_SCHEMA && draft.strategyName === strategyName && asRecord(draft.config) ? value : null;
+};
+var saveRuntimeStrategyDraft = async ({
+  userName,
+  strategyName,
+  config,
+  baseReleaseVersion = null,
+  updatedBy
+}) => {
+  assertStrategyName(strategyName);
+  const draft = {
+    schema: import_types.RUNTIME_STRATEGY_DRAFT_SCHEMA,
+    strategyName,
+    baseReleaseVersion,
+    config,
+    updatedAt: Date.now(),
+    updatedBy
+  };
+  await setData(redisKeys.runtimeStrategyDraft(userName, strategyName), draft, {
+    expire: 0
+  });
+  return draft;
+};
+var getRuntimeStrategyRelease = async (userName, strategyName, releaseVersion) => {
+  const value = await getData(
+    redisKeys.runtimeStrategyRelease(userName, strategyName, releaseVersion),
+    null
+  );
+  return value == null ? null : verifyRuntimeStrategyRelease(value);
+};
+var listRuntimeStrategyReleases = async (userName, strategyName) => {
+  const keys = await getKeys(
+    redisKeys.runtimeStrategyReleases(userName, strategyName)
+  );
+  const releases = await Promise.all(
+    keys.map(async (key) => {
+      const value = await getData(key, null);
+      return value == null ? null : verifyRuntimeStrategyRelease(value);
+    })
+  );
+  return releases.filter((release) => release != null).sort((left, right) => right.releaseVersion - left.releaseVersion);
+};
+var publishRuntimeStrategyRelease = async ({
+  userName,
+  strategyName,
+  config,
+  strategyPackage = null,
+  strategyPackageVersion = null,
+  runtimePackageVersion = null,
+  createdBy
+}) => {
+  assertStrategyName(strategyName);
+  assertRuntimeStrategyReleaseConfig(config);
+  const releaseVersion = await incrementKey(
+    redisKeys.runtimeStrategyReleaseSequence(userName, strategyName)
+  );
+  const content = {
+    schema: import_types.RUNTIME_STRATEGY_RELEASE_SCHEMA,
+    strategyName,
+    releaseVersion,
+    config,
+    strategyPackage,
+    strategyPackageVersion,
+    runtimePackageVersion,
+    createdAt: Date.now(),
+    createdBy
+  };
+  const release = {
+    ...content,
+    contentSha256: releaseContentSha256(content)
+  };
+  const stored = await setDataIfAbsent(
+    redisKeys.runtimeStrategyRelease(userName, strategyName, releaseVersion),
+    release
+  );
+  if (!stored) {
+    throw new Error(`Refused to overwrite ${strategyName} v${releaseVersion}`);
+  }
+  return release;
+};
+var recordRuntimeStrategyControlEvent = async ({
+  userName,
+  deploymentId,
+  strategyName,
+  releaseVersion,
+  previousState,
+  nextState,
+  createdBy
+}) => {
+  const action = nextState === "entries_paused" ? "pause_entries" : "resume";
+  const createdAt = Date.now();
+  const event = {
+    eventId: `${createdAt}-${(0, import_node_crypto.randomUUID)()}`,
+    deploymentId,
+    strategyName,
+    releaseVersion,
+    action,
+    previousState,
+    nextState,
+    createdAt,
+    createdBy
+  };
+  await setData(
+    redisKeys.runtimeStrategyControlEvent(userName, event.eventId),
+    event,
+    { expire: 0 }
+  );
+  return event;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertRuntimeStrategyReleaseConfig,
+  getRuntimeStrategyDraft,
+  getRuntimeStrategyRelease,
+  listRuntimeStrategyReleases,
+  publishRuntimeStrategyRelease,
+  recordRuntimeStrategyControlEvent,
+  saveRuntimeStrategyDraft,
+  verifyRuntimeStrategyRelease
+});