@tradejs/infra 2.0.18 → 2.0.20

package/dist/runtimeStrategyConfigs.js

@@ -0,0 +1,425 @@
+"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/runtimeStrategyConfigs.ts
+var runtimeStrategyConfigs_exports = {};
+__export(runtimeStrategyConfigs_exports, {
+  getRuntimeStrategyConfig: () => getRuntimeStrategyConfig,
+  getRuntimeStrategyConfigKeys: () => getRuntimeStrategyConfigKeys,
+  getRuntimeStrategyResultConfig: () => getRuntimeStrategyResultConfig,
+  loadRuntimeStrategyConfigs: () => loadRuntimeStrategyConfigs,
+  loadRuntimeStrategyNames: () => loadRuntimeStrategyNames,
+  resolveStrategyConfigIdentityByKey: () => resolveStrategyConfigIdentityByKey,
+  resolveStrategyNameByConfigKey: () => resolveStrategyNameByConfigKey,
+  saveRuntimeStrategyConfig: () => saveRuntimeStrategyConfig
+});
+module.exports = __toCommonJS(runtimeStrategyConfigs_exports);
+
+// 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 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}`,
+  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/runtimeStrategyConfigs.ts
+var RESERVED_STRATEGY_NAMES = /* @__PURE__ */ new Set(["charts"]);
+var RESERVED_CONFIG_IDS = /* @__PURE__ */ new Set(["results"]);
+var isStrategyConfig = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+var resolveStrategyConfigIdentityByKey = (userName, key) => {
+  const parts = key.split(":");
+  if (parts.length !== 5) return null;
+  const [users, keyUserName, strategiesKey, strategyName, configId] = parts;
+  if (users !== "users" || keyUserName !== userName || strategiesKey !== "strategies" || !strategyName || !configId || RESERVED_STRATEGY_NAMES.has(strategyName) || RESERVED_CONFIG_IDS.has(configId) || !/^[a-zA-Z0-9_-]+$/.test(configId)) {
+    return null;
+  }
+  return { strategyName, configId };
+};
+var resolveStrategyNameByConfigKey = (userName, key) => resolveStrategyConfigIdentityByKey(userName, key)?.strategyName ?? null;
+var getRuntimeStrategyConfigKeys = async (userName) => {
+  const keys = await getKeys(`${redisKeys.strategies(userName)}:`);
+  return keys.filter((key) => resolveStrategyConfigIdentityByKey(userName, key)).sort((left, right) => left.localeCompare(right));
+};
+var loadRuntimeStrategyConfigs = async (userName, {
+  onInvalidConfig
+} = {}) => {
+  const configKeys = await getRuntimeStrategyConfigKeys(userName);
+  const records = await Promise.all(
+    configKeys.map(async (key) => {
+      const identity = resolveStrategyConfigIdentityByKey(userName, key);
+      if (!identity) return null;
+      const strategyConfig = await getData(key, null);
+      if (!isStrategyConfig(strategyConfig)) {
+        onInvalidConfig?.(key);
+        return null;
+      }
+      return { key, ...identity, strategyConfig };
+    })
+  );
+  return records.filter(
+    (record) => record != null
+  );
+};
+var loadRuntimeStrategyNames = async (userName) => [
+  ...new Set(
+    (await getRuntimeStrategyConfigKeys(userName)).map(
+      (key) => resolveStrategyConfigIdentityByKey(userName, key)?.strategyName
+    ).filter(
+      (strategyName) => Boolean(strategyName)
+    )
+  )
+].sort((left, right) => left.localeCompare(right));
+var getRuntimeStrategyConfig = async (userName, strategyName, configId = "config") => {
+  const value = await getData(
+    redisKeys.strategyConfig(userName, strategyName, configId),
+    null
+  );
+  return isStrategyConfig(value) ? value : null;
+};
+var saveRuntimeStrategyConfig = async ({
+  userName,
+  strategyName,
+  configId,
+  strategyConfig
+}) => {
+  const key = redisKeys.strategyConfig(userName, strategyName, configId);
+  await setData(key, strategyConfig, { expire: 0 });
+  return { key, strategyName, configId, strategyConfig };
+};
+var getRuntimeStrategyResultConfig = async (userName, strategyName, symbol) => {
+  const results = await getData(
+    redisKeys.strategyResults(userName, strategyName),
+    null
+  );
+  const config = results?.[symbol]?.config;
+  return isStrategyConfig(config) ? config : null;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getRuntimeStrategyConfig,
+  getRuntimeStrategyConfigKeys,
+  getRuntimeStrategyResultConfig,
+  loadRuntimeStrategyConfigs,
+  loadRuntimeStrategyNames,
+  resolveStrategyConfigIdentityByKey,
+  resolveStrategyNameByConfigKey,
+  saveRuntimeStrategyConfig
+});

package/dist/runtimeStrategyConfigs.mjs

@@ -0,0 +1,89 @@
+import {
+  getData,
+  getKeys,
+  redisKeys,
+  setData
+} from "./chunk-6ZKAUA4Q.mjs";
+
+// src/runtimeStrategyConfigs.ts
+var RESERVED_STRATEGY_NAMES = /* @__PURE__ */ new Set(["charts"]);
+var RESERVED_CONFIG_IDS = /* @__PURE__ */ new Set(["results"]);
+var isStrategyConfig = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+var resolveStrategyConfigIdentityByKey = (userName, key) => {
+  const parts = key.split(":");
+  if (parts.length !== 5) return null;
+  const [users, keyUserName, strategiesKey, strategyName, configId] = parts;
+  if (users !== "users" || keyUserName !== userName || strategiesKey !== "strategies" || !strategyName || !configId || RESERVED_STRATEGY_NAMES.has(strategyName) || RESERVED_CONFIG_IDS.has(configId) || !/^[a-zA-Z0-9_-]+$/.test(configId)) {
+    return null;
+  }
+  return { strategyName, configId };
+};
+var resolveStrategyNameByConfigKey = (userName, key) => resolveStrategyConfigIdentityByKey(userName, key)?.strategyName ?? null;
+var getRuntimeStrategyConfigKeys = async (userName) => {
+  const keys = await getKeys(`${redisKeys.strategies(userName)}:`);
+  return keys.filter((key) => resolveStrategyConfigIdentityByKey(userName, key)).sort((left, right) => left.localeCompare(right));
+};
+var loadRuntimeStrategyConfigs = async (userName, {
+  onInvalidConfig
+} = {}) => {
+  const configKeys = await getRuntimeStrategyConfigKeys(userName);
+  const records = await Promise.all(
+    configKeys.map(async (key) => {
+      const identity = resolveStrategyConfigIdentityByKey(userName, key);
+      if (!identity) return null;
+      const strategyConfig = await getData(key, null);
+      if (!isStrategyConfig(strategyConfig)) {
+        onInvalidConfig?.(key);
+        return null;
+      }
+      return { key, ...identity, strategyConfig };
+    })
+  );
+  return records.filter(
+    (record) => record != null
+  );
+};
+var loadRuntimeStrategyNames = async (userName) => [
+  ...new Set(
+    (await getRuntimeStrategyConfigKeys(userName)).map(
+      (key) => resolveStrategyConfigIdentityByKey(userName, key)?.strategyName
+    ).filter(
+      (strategyName) => Boolean(strategyName)
+    )
+  )
+].sort((left, right) => left.localeCompare(right));
+var getRuntimeStrategyConfig = async (userName, strategyName, configId = "config") => {
+  const value = await getData(
+    redisKeys.strategyConfig(userName, strategyName, configId),
+    null
+  );
+  return isStrategyConfig(value) ? value : null;
+};
+var saveRuntimeStrategyConfig = async ({
+  userName,
+  strategyName,
+  configId,
+  strategyConfig
+}) => {
+  const key = redisKeys.strategyConfig(userName, strategyName, configId);
+  await setData(key, strategyConfig, { expire: 0 });
+  return { key, strategyName, configId, strategyConfig };
+};
+var getRuntimeStrategyResultConfig = async (userName, strategyName, symbol) => {
+  const results = await getData(
+    redisKeys.strategyResults(userName, strategyName),
+    null
+  );
+  const config = results?.[symbol]?.config;
+  return isStrategyConfig(config) ? config : null;
+};
+export {
+  getRuntimeStrategyConfig,
+  getRuntimeStrategyConfigKeys,
+  getRuntimeStrategyResultConfig,
+  loadRuntimeStrategyConfigs,
+  loadRuntimeStrategyNames,
+  resolveStrategyConfigIdentityByKey,
+  resolveStrategyNameByConfigKey,
+  saveRuntimeStrategyConfig
+};

package/dist/strategyReleaseEvidence.d.mts

@@ -0,0 +1,12 @@
+import { StrategyEvidenceMarkerPayload, StrategyEvidenceMarkerEnvelope } from '@tradejs/types';
+
+declare const canonicalStrategyEvidenceJson: (value: unknown) => string;
+declare const strategyEvidenceSha256: (value: unknown) => string;
+declare const strategyEvidenceFingerprint: (value: unknown) => string;
+declare const strategyEvidenceFileSha256: (filePath: string) => Promise<string>;
+declare const safeStrategyEvidenceSegment: (value: string, fallback?: string) => string;
+declare const compactStrategyEvidenceTimestamp: (timestamp: number) => string;
+declare const createStrategyEvidenceMarkerEnvelope: (payload: StrategyEvidenceMarkerPayload) => StrategyEvidenceMarkerEnvelope;
+declare const verifyStrategyEvidenceMarkerEnvelope: (value: unknown) => StrategyEvidenceMarkerEnvelope;
+
+export { canonicalStrategyEvidenceJson, compactStrategyEvidenceTimestamp, createStrategyEvidenceMarkerEnvelope, safeStrategyEvidenceSegment, strategyEvidenceFileSha256, strategyEvidenceFingerprint, strategyEvidenceSha256, verifyStrategyEvidenceMarkerEnvelope };

package/dist/strategyReleaseEvidence.d.ts

@@ -0,0 +1,12 @@
+import { StrategyEvidenceMarkerPayload, StrategyEvidenceMarkerEnvelope } from '@tradejs/types';
+
+declare const canonicalStrategyEvidenceJson: (value: unknown) => string;
+declare const strategyEvidenceSha256: (value: unknown) => string;
+declare const strategyEvidenceFingerprint: (value: unknown) => string;
+declare const strategyEvidenceFileSha256: (filePath: string) => Promise<string>;
+declare const safeStrategyEvidenceSegment: (value: string, fallback?: string) => string;
+declare const compactStrategyEvidenceTimestamp: (timestamp: number) => string;
+declare const createStrategyEvidenceMarkerEnvelope: (payload: StrategyEvidenceMarkerPayload) => StrategyEvidenceMarkerEnvelope;
+declare const verifyStrategyEvidenceMarkerEnvelope: (value: unknown) => StrategyEvidenceMarkerEnvelope;
+
+export { canonicalStrategyEvidenceJson, compactStrategyEvidenceTimestamp, createStrategyEvidenceMarkerEnvelope, safeStrategyEvidenceSegment, strategyEvidenceFileSha256, strategyEvidenceFingerprint, strategyEvidenceSha256, verifyStrategyEvidenceMarkerEnvelope };

package/dist/strategyReleaseEvidence.js

@@ -0,0 +1,120 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/strategyReleaseEvidence.ts
+var strategyReleaseEvidence_exports = {};
+__export(strategyReleaseEvidence_exports, {
+  canonicalStrategyEvidenceJson: () => canonicalStrategyEvidenceJson,
+  compactStrategyEvidenceTimestamp: () => compactStrategyEvidenceTimestamp,
+  createStrategyEvidenceMarkerEnvelope: () => createStrategyEvidenceMarkerEnvelope,
+  safeStrategyEvidenceSegment: () => safeStrategyEvidenceSegment,
+  strategyEvidenceFileSha256: () => strategyEvidenceFileSha256,
+  strategyEvidenceFingerprint: () => strategyEvidenceFingerprint,
+  strategyEvidenceSha256: () => strategyEvidenceSha256,
+  verifyStrategyEvidenceMarkerEnvelope: () => verifyStrategyEvidenceMarkerEnvelope
+});
+module.exports = __toCommonJS(strategyReleaseEvidence_exports);
+var import_node_crypto = require("crypto");
+var import_node_fs = require("fs");
+var import_types = require("@tradejs/types");
+var SHA256_RE = /^[a-f0-9]{64}$/;
+var LINEAGE_FINGERPRINT_RE = /^[a-f0-9]{16}$/;
+var MARKER_TYPES = /* @__PURE__ */ new Set([
+  "G",
+  "L",
+  "E",
+  "D",
+  "P",
+  "R"
+]);
+var asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+var isString = (value) => typeof value === "string" && value.trim().length > 0;
+var isNumber = (value) => typeof value === "number" && Number.isFinite(value);
+var canonicalStrategyEvidenceJson = (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 strategyEvidenceSha256 = (value) => (0, import_node_crypto.createHash)("sha256").update(canonicalStrategyEvidenceJson(value)).digest("hex");
+var strategyEvidenceFingerprint = (value) => strategyEvidenceSha256(value).slice(0, 16);
+var strategyEvidenceFileSha256 = async (filePath) => {
+  const hash = (0, import_node_crypto.createHash)("sha256");
+  for await (const chunk of (0, import_node_fs.createReadStream)(filePath)) hash.update(chunk);
+  return hash.digest("hex");
+};
+var safeStrategyEvidenceSegment = (value, fallback = "strategy") => {
+  const safe = value.trim().replace(/[^a-zA-Z0-9._-]+/g, "-");
+  return safe && safe !== "." && safe !== ".." ? safe : fallback;
+};
+var compactStrategyEvidenceTimestamp = (timestamp) => new Date(timestamp).toISOString().replace(/[-:]/g, "").replace(/\.000Z$/, "Z");
+var createStrategyEvidenceMarkerEnvelope = (payload) => {
+  const payloadSha256 = strategyEvidenceSha256(payload);
+  return {
+    schema: import_types.STRATEGY_EVIDENCE_MARKERS_SCHEMA,
+    artifactId: `${safeStrategyEvidenceSegment(payload.strategy)}_${compactStrategyEvidenceTimestamp(payload.createdAt)}_${payloadSha256.slice(0, 16)}`,
+    payloadSha256,
+    payload
+  };
+};
+var verifyStrategyEvidenceMarkerEnvelope = (value) => {
+  const envelope = asRecord(value);
+  const payload = asRecord(envelope?.payload);
+  if (envelope?.schema !== import_types.STRATEGY_EVIDENCE_MARKERS_SCHEMA || !isString(envelope.artifactId) || !isString(envelope.payloadSha256) || !SHA256_RE.test(envelope.payloadSha256) || !payload || !isString(payload.strategy) || !isNumber(payload.createdAt) || !Array.isArray(payload.markers) || !Array.isArray(payload.sourceArtifacts)) {
+    throw new Error("Invalid strategy evidence marker envelope");
+  }
+  for (const value2 of payload.markers) {
+    const marker = asRecord(value2);
+    const coverage = asRecord(marker?.coverage);
+    if (!marker || !isString(marker.id) || !isString(marker.type) || !MARKER_TYPES.has(marker.type) || !isNumber(marker.timestamp) || !isString(marker.label) || !isString(marker.summary) || !isString(marker.artifactId) || !isString(marker.artifactSha256) || !SHA256_RE.test(marker.artifactSha256) || marker.gitSha !== void 0 && !isString(marker.gitSha) || marker.gateFingerprint !== void 0 && (!isString(marker.gateFingerprint) || !LINEAGE_FINGERPRINT_RE.test(marker.gateFingerprint)) || marker.configFingerprint !== void 0 && (!isString(marker.configFingerprint) || !LINEAGE_FINGERPRINT_RE.test(marker.configFingerprint)) || marker.contextFingerprint !== void 0 && (!isString(marker.contextFingerprint) || !LINEAGE_FINGERPRINT_RE.test(marker.contextFingerprint)) || marker.maxLossValue !== void 0 && !isNumber(marker.maxLossValue) || marker.coverage !== void 0 && (!coverage || !isNumber(coverage.startTime) || !isNumber(coverage.endTime) || coverage.startTime > coverage.endTime)) {
+      throw new Error("Invalid strategy evidence marker");
+    }
+  }
+  for (const value2 of payload.sourceArtifacts) {
+    const artifact = asRecord(value2);
+    if (!artifact || !isString(artifact.artifactId) || !isString(artifact.sha256) || !SHA256_RE.test(artifact.sha256) || artifact.path !== void 0 && typeof artifact.path !== "string") {
+      throw new Error("Invalid strategy evidence source artifact");
+    }
+  }
+  const payloadSha256 = strategyEvidenceSha256(payload);
+  if (payloadSha256 !== envelope.payloadSha256) {
+    throw new Error("Strategy evidence marker checksum mismatch");
+  }
+  const expectedId = `${safeStrategyEvidenceSegment(payload.strategy)}_${compactStrategyEvidenceTimestamp(payload.createdAt)}_${payloadSha256.slice(0, 16)}`;
+  if (expectedId !== envelope.artifactId) {
+    throw new Error("Strategy evidence marker artifact identity mismatch");
+  }
+  return value;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  canonicalStrategyEvidenceJson,
+  compactStrategyEvidenceTimestamp,
+  createStrategyEvidenceMarkerEnvelope,
+  safeStrategyEvidenceSegment,
+  strategyEvidenceFileSha256,
+  strategyEvidenceFingerprint,
+  strategyEvidenceSha256,
+  verifyStrategyEvidenceMarkerEnvelope
+});