@tradejs/infra 3.1.8-beta.207 → 3.1.8-beta.212

package/dist/{chunk-JLVCBKE3.mjs → chunk-NN4CAPDW.mjs}

@@ -231,9 +231,67 @@ var getData = async (key, fallback = []) => {
     return fallback;
   }
 };
+var requireReadyRedis = async () => {
+  if (redisUnavailable) {
+    throw new Error("Redis is unavailable");
+  }
+  const redis = await getReadyRedis();
+  if (!redis) {
+    throw new Error("Redis is unavailable");
+  }
+  return redis;
+};
+var parseJsonStrict = (key, raw) => {
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    throw new Error(`Invalid JSON stored at ${key}`, { cause: error });
+  }
+};
+var getDataStrict = async (key) => {
+  const redis = await requireReadyRedis();
+  try {
+    const raw = toResultString(await redis.call("JSON.GET", key));
+    return raw == null ? null : parseJsonStrict(key, raw);
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+      throw error;
+    }
+    if (error instanceof Error && error.message.startsWith("Invalid JSON")) {
+      throw error;
+    }
+    logger.log(
+      "error",
+      "failed strict JSON.GET %s: %s (fallback to GET)",
+      key,
+      String(error)
+    );
+  }
+  try {
+    const raw = await redis.get(key);
+    return raw == null ? null : parseJsonStrict(key, raw);
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var delKey = async (key) => {
   return delKeyWithOptions(key);
 };
+var delKeyStrict = async (key) => {
+  const redis = await requireReadyRedis();
+  try {
+    return await redis.del(key) === 1;
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var RedisWriteBlockedError = class extends Error {
   constructor(message) {
     super(message);
@@ -301,6 +359,41 @@ var setData = async (key, data, options = {}) => {
     }
   }
 };
+var setDataStrict = async (key, data, options = {}) => {
+  const { expire } = { ...DEFAULT_OPTIONS, ...options };
+  const redis = await requireReadyRedis();
+  const value = toJson(data);
+  try {
+    await redis.call("JSON.SET", key, "$", value);
+    if (expire) {
+      await redis.expire(key, expire);
+    }
+    return;
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+      throw error;
+    }
+    logger.log(
+      "error",
+      "failed strict JSON.SET %s: %s (fallback to SET)",
+      key,
+      String(error)
+    );
+  }
+  try {
+    if (expire) {
+      await redis.set(key, value, "EX", expire);
+    } else {
+      await redis.set(key, value);
+    }
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var setDataIfAbsent = async (key, data) => {
   if (redisUnavailable) return false;
   const redis = await getReadyRedis();
@@ -508,18 +601,14 @@ var redisKeys = {
   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`,
+  runtimeControls: (userName) => `users:${userName}:runtime:controls`,
   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}`,
-  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`,
@@ -583,10 +672,13 @@ export {
   publishData,
   getKeys,
   getData,
+  getDataStrict,
   delKey,
+  delKeyStrict,
   RedisWriteBlockedError,
   delKeyWithOptions,
   setData,
+  setDataStrict,
   setDataIfAbsent,
   incrementKey,
   setHashJsonField,

package/dist/redis.d.mts

@@ -13,12 +13,20 @@ interface DelKeyOptions {
 }
 declare const getKeys: (prefix: string) => Promise<string[]>;
 declare const getData: (key: string, fallback?: any) => Promise<any>;
+/**
+ * Reads durable operational state without treating a Redis outage or malformed
+ * JSON as a missing key. Use this for fail-closed controls, not cache reads.
+ */
+declare const getDataStrict: (key: string) => Promise<unknown | null>;
 declare const delKey: (key: string) => Promise<boolean>;
+declare const delKeyStrict: (key: string) => Promise<boolean>;
 declare class RedisWriteBlockedError extends Error {
     constructor(message: string);
 }
 declare const delKeyWithOptions: (key: string, options?: DelKeyOptions) => Promise<boolean>;
 declare const setData: <T>(key: string, data: T, options?: Options) => Promise<void>;
+/** Writes durable operational state and surfaces every write failure. */
+declare const setDataStrict: <T>(key: string, data: T, options?: Options) => Promise<void>;
 /** Writes a JSON value only when the key does not exist. */
 declare const setDataIfAbsent: <T>(key: string, data: T) => Promise<boolean>;
 declare const incrementKey: (key: string) => Promise<number>;
@@ -38,18 +46,14 @@ declare const redisKeys: {
     user: (userName: string) => string;
     tradingAccounts: (userName: string) => string;
     tradingAccount: (userName: string, accountId: string) => string;
-    runtimeDeployments: (userName: string) => string;
-    runtimeDeployment: (userName: string, deploymentId: string) => string;
     runtimeDeploymentHeartbeat: (userName: string, deploymentId: string) => string;
+    runtimeControls: (userName: string) => string;
     bots: (userName: string) => string;
     botsPrefix: () => string;
     bot: (userName: string, botId: string) => string;
     backtestConfig: (userName: string, config: string) => string;
     strategies: (userName: string) => string;
     strategyConfig: (userName: string, strategyName: string, configId?: string) => string;
-    runtimeStrategyReleases: (userName: string, strategyName: string) => string;
-    runtimeStrategyRelease: (userName: string, strategyName: string, releaseVersion: number) => string;
-    runtimeStrategyReleaseSequence: (userName: string, strategyName: string) => string;
     runtimeStrategyControlEvents: (userName: string) => string;
     runtimeStrategyControlEvent: (userName: string, eventId: string) => string;
     strategyResults: (userName: string, strategyName: string) => string;
@@ -108,4 +112,4 @@ declare const redisKeys: {
     mlResult: (strategyName: string, signalId: string) => string;
 };
 
-export { RedisWriteBlockedError, closeRedisConnection, consumeScreenshotSessionToken, createScreenshotSessionToken, delKey, delKeyWithOptions, getData, getHashData, getHashJsonField, getHashJsonValues, getKeys, incrHashFields, incrementKey, publishData, redisKeys, setData, setDataIfAbsent, setHashJsonField, setHashJsonFields };
+export { RedisWriteBlockedError, closeRedisConnection, consumeScreenshotSessionToken, createScreenshotSessionToken, delKey, delKeyStrict, delKeyWithOptions, getData, getDataStrict, getHashData, getHashJsonField, getHashJsonValues, getKeys, incrHashFields, incrementKey, publishData, redisKeys, setData, setDataIfAbsent, setDataStrict, setHashJsonField, setHashJsonFields };

package/dist/redis.d.ts

@@ -13,12 +13,20 @@ interface DelKeyOptions {
 }
 declare const getKeys: (prefix: string) => Promise<string[]>;
 declare const getData: (key: string, fallback?: any) => Promise<any>;
+/**
+ * Reads durable operational state without treating a Redis outage or malformed
+ * JSON as a missing key. Use this for fail-closed controls, not cache reads.
+ */
+declare const getDataStrict: (key: string) => Promise<unknown | null>;
 declare const delKey: (key: string) => Promise<boolean>;
+declare const delKeyStrict: (key: string) => Promise<boolean>;
 declare class RedisWriteBlockedError extends Error {
     constructor(message: string);
 }
 declare const delKeyWithOptions: (key: string, options?: DelKeyOptions) => Promise<boolean>;
 declare const setData: <T>(key: string, data: T, options?: Options) => Promise<void>;
+/** Writes durable operational state and surfaces every write failure. */
+declare const setDataStrict: <T>(key: string, data: T, options?: Options) => Promise<void>;
 /** Writes a JSON value only when the key does not exist. */
 declare const setDataIfAbsent: <T>(key: string, data: T) => Promise<boolean>;
 declare const incrementKey: (key: string) => Promise<number>;
@@ -38,18 +46,14 @@ declare const redisKeys: {
     user: (userName: string) => string;
     tradingAccounts: (userName: string) => string;
     tradingAccount: (userName: string, accountId: string) => string;
-    runtimeDeployments: (userName: string) => string;
-    runtimeDeployment: (userName: string, deploymentId: string) => string;
     runtimeDeploymentHeartbeat: (userName: string, deploymentId: string) => string;
+    runtimeControls: (userName: string) => string;
     bots: (userName: string) => string;
     botsPrefix: () => string;
     bot: (userName: string, botId: string) => string;
     backtestConfig: (userName: string, config: string) => string;
     strategies: (userName: string) => string;
     strategyConfig: (userName: string, strategyName: string, configId?: string) => string;
-    runtimeStrategyReleases: (userName: string, strategyName: string) => string;
-    runtimeStrategyRelease: (userName: string, strategyName: string, releaseVersion: number) => string;
-    runtimeStrategyReleaseSequence: (userName: string, strategyName: string) => string;
     runtimeStrategyControlEvents: (userName: string) => string;
     runtimeStrategyControlEvent: (userName: string, eventId: string) => string;
     strategyResults: (userName: string, strategyName: string) => string;
@@ -108,4 +112,4 @@ declare const redisKeys: {
     mlResult: (strategyName: string, signalId: string) => string;
 };
 
-export { RedisWriteBlockedError, closeRedisConnection, consumeScreenshotSessionToken, createScreenshotSessionToken, delKey, delKeyWithOptions, getData, getHashData, getHashJsonField, getHashJsonValues, getKeys, incrHashFields, incrementKey, publishData, redisKeys, setData, setDataIfAbsent, setHashJsonField, setHashJsonFields };
+export { RedisWriteBlockedError, closeRedisConnection, consumeScreenshotSessionToken, createScreenshotSessionToken, delKey, delKeyStrict, delKeyWithOptions, getData, getDataStrict, getHashData, getHashJsonField, getHashJsonValues, getKeys, incrHashFields, incrementKey, publishData, redisKeys, setData, setDataIfAbsent, setDataStrict, setHashJsonField, setHashJsonFields };

package/dist/redis.js

@@ -35,8 +35,10 @@ __export(redis_exports, {
   consumeScreenshotSessionToken: () => consumeScreenshotSessionToken,
   createScreenshotSessionToken: () => createScreenshotSessionToken,
   delKey: () => delKey,
+  delKeyStrict: () => delKeyStrict,
   delKeyWithOptions: () => delKeyWithOptions,
   getData: () => getData,
+  getDataStrict: () => getDataStrict,
   getHashData: () => getHashData,
   getHashJsonField: () => getHashJsonField,
   getHashJsonValues: () => getHashJsonValues,
@@ -47,6 +49,7 @@ __export(redis_exports, {
   redisKeys: () => redisKeys,
   setData: () => setData,
   setDataIfAbsent: () => setDataIfAbsent,
+  setDataStrict: () => setDataStrict,
   setHashJsonField: () => setHashJsonField,
   setHashJsonFields: () => setHashJsonFields
 });
@@ -283,9 +286,67 @@ var getData = async (key, fallback = []) => {
     return fallback;
   }
 };
+var requireReadyRedis = async () => {
+  if (redisUnavailable) {
+    throw new Error("Redis is unavailable");
+  }
+  const redis = await getReadyRedis();
+  if (!redis) {
+    throw new Error("Redis is unavailable");
+  }
+  return redis;
+};
+var parseJsonStrict = (key, raw) => {
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    throw new Error(`Invalid JSON stored at ${key}`, { cause: error });
+  }
+};
+var getDataStrict = async (key) => {
+  const redis = await requireReadyRedis();
+  try {
+    const raw = toResultString(await redis.call("JSON.GET", key));
+    return raw == null ? null : parseJsonStrict(key, raw);
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+      throw error;
+    }
+    if (error instanceof Error && error.message.startsWith("Invalid JSON")) {
+      throw error;
+    }
+    logger.log(
+      "error",
+      "failed strict JSON.GET %s: %s (fallback to GET)",
+      key,
+      String(error)
+    );
+  }
+  try {
+    const raw = await redis.get(key);
+    return raw == null ? null : parseJsonStrict(key, raw);
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var delKey = async (key) => {
   return delKeyWithOptions(key);
 };
+var delKeyStrict = async (key) => {
+  const redis = await requireReadyRedis();
+  try {
+    return await redis.del(key) === 1;
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var RedisWriteBlockedError = class extends Error {
   constructor(message) {
     super(message);
@@ -353,6 +414,41 @@ var setData = async (key, data, options = {}) => {
     }
   }
 };
+var setDataStrict = async (key, data, options = {}) => {
+  const { expire } = { ...DEFAULT_OPTIONS, ...options };
+  const redis = await requireReadyRedis();
+  const value = toJson(data);
+  try {
+    await redis.call("JSON.SET", key, "$", value);
+    if (expire) {
+      await redis.expire(key, expire);
+    }
+    return;
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+      throw error;
+    }
+    logger.log(
+      "error",
+      "failed strict JSON.SET %s: %s (fallback to SET)",
+      key,
+      String(error)
+    );
+  }
+  try {
+    if (expire) {
+      await redis.set(key, value, "EX", expire);
+    } else {
+      await redis.set(key, value);
+    }
+  } catch (error) {
+    if (error instanceof Error && isRedisConnectivityError(error)) {
+      markRedisUnavailable(error);
+    }
+    throw error;
+  }
+};
 var setDataIfAbsent = async (key, data) => {
   if (redisUnavailable) return false;
   const redis = await getReadyRedis();
@@ -560,18 +656,14 @@ var redisKeys = {
   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`,
+  runtimeControls: (userName) => `users:${userName}:runtime:controls`,
   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}`,
-  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`,
@@ -636,8 +728,10 @@ var redisKeys = {
   consumeScreenshotSessionToken,
   createScreenshotSessionToken,
   delKey,
+  delKeyStrict,
   delKeyWithOptions,
   getData,
+  getDataStrict,
   getHashData,
   getHashJsonField,
   getHashJsonValues,
@@ -648,6 +742,7 @@ var redisKeys = {
   redisKeys,
   setData,
   setDataIfAbsent,
+  setDataStrict,
   setHashJsonField,
   setHashJsonFields
 });

package/dist/redis.mjs

@@ -4,8 +4,10 @@ import {
   consumeScreenshotSessionToken,
   createScreenshotSessionToken,
   delKey,
+  delKeyStrict,
   delKeyWithOptions,
   getData,
+  getDataStrict,
   getHashData,
   getHashJsonField,
   getHashJsonValues,
@@ -16,17 +18,20 @@ import {
   redisKeys,
   setData,
   setDataIfAbsent,
+  setDataStrict,
   setHashJsonField,
   setHashJsonFields
-} from "./chunk-JLVCBKE3.mjs";
+} from "./chunk-NN4CAPDW.mjs";
 export {
   RedisWriteBlockedError,
   closeRedisConnection,
   consumeScreenshotSessionToken,
   createScreenshotSessionToken,
   delKey,
+  delKeyStrict,
   delKeyWithOptions,
   getData,
+  getDataStrict,
   getHashData,
   getHashJsonField,
   getHashJsonValues,
@@ -37,6 +42,7 @@ export {
   redisKeys,
   setData,
   setDataIfAbsent,
+  setDataStrict,
   setHashJsonField,
   setHashJsonFields
 };

package/dist/runtimeControls.d.mts

@@ -0,0 +1,28 @@
+import { RuntimeControls, RuntimeStrategyControlState, RuntimeStrategyControlEvent } from '@tradejs/types';
+
+declare const emptyRuntimeControls: () => RuntimeControls;
+declare const verifyRuntimeControls: (value: unknown) => RuntimeControls;
+declare const getRuntimeControls: (userName: string) => Promise<RuntimeControls>;
+declare const pauseRuntimeStrategy: ({ userName, deploymentId, strategyName, updatedBy, updatedAt, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+    updatedBy: string;
+    updatedAt?: string;
+}) => Promise<RuntimeControls>;
+declare const resumeRuntimeStrategy: ({ userName, deploymentId, strategyName, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+}) => Promise<RuntimeControls>;
+declare const recordRuntimeStrategyControlEvent: ({ userName, deploymentId, strategyName, version, previousState, nextState, createdBy, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+    version: number;
+    previousState: RuntimeStrategyControlState;
+    nextState: RuntimeStrategyControlState;
+    createdBy: string;
+}) => Promise<RuntimeStrategyControlEvent>;
+
+export { emptyRuntimeControls, getRuntimeControls, pauseRuntimeStrategy, recordRuntimeStrategyControlEvent, resumeRuntimeStrategy, verifyRuntimeControls };

package/dist/runtimeControls.d.ts

@@ -0,0 +1,28 @@
+import { RuntimeControls, RuntimeStrategyControlState, RuntimeStrategyControlEvent } from '@tradejs/types';
+
+declare const emptyRuntimeControls: () => RuntimeControls;
+declare const verifyRuntimeControls: (value: unknown) => RuntimeControls;
+declare const getRuntimeControls: (userName: string) => Promise<RuntimeControls>;
+declare const pauseRuntimeStrategy: ({ userName, deploymentId, strategyName, updatedBy, updatedAt, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+    updatedBy: string;
+    updatedAt?: string;
+}) => Promise<RuntimeControls>;
+declare const resumeRuntimeStrategy: ({ userName, deploymentId, strategyName, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+}) => Promise<RuntimeControls>;
+declare const recordRuntimeStrategyControlEvent: ({ userName, deploymentId, strategyName, version, previousState, nextState, createdBy, }: {
+    userName: string;
+    deploymentId: string;
+    strategyName: string;
+    version: number;
+    previousState: RuntimeStrategyControlState;
+    nextState: RuntimeStrategyControlState;
+    createdBy: string;
+}) => Promise<RuntimeStrategyControlEvent>;
+
+export { emptyRuntimeControls, getRuntimeControls, pauseRuntimeStrategy, recordRuntimeStrategyControlEvent, resumeRuntimeStrategy, verifyRuntimeControls };