@jango-blockchained/hoox-shared 1.0.8

package/dist/exchange-client.d.ts

@@ -0,0 +1,84 @@
+export type ExchangeName = "binance" | "mexc" | "bybit";
+export interface ExchangeConfig {
+    apiKey: string;
+    apiSecret: string;
+    baseUrl?: string;
+    testnet?: boolean;
+}
+export interface TradeParams {
+    symbol: string;
+    side: "long" | "short";
+    orderType?: string;
+    quantity: number;
+    price?: number;
+    reduceOnly?: boolean;
+    leverage?: number;
+}
+export interface OrderResponse {
+    orderId: string;
+    symbol: string;
+    status: string;
+    executedQty?: string;
+    price?: string;
+}
+export interface Position {
+    symbol: string;
+    side: "long" | "short";
+    quantity: number;
+    entryPrice: number;
+    unrealizedPnl?: number;
+}
+/**
+ * Generic exchange provider interface.
+ * Workers implement this to provide exchange-specific client creation and credential validation.
+ *
+ * @typeParam TClient - The exchange client type (e.g., IExchangeClient)
+ * @typeParam TEnv - The worker's environment/bindings type (e.g., Env)
+ */
+export interface IExchangeProvider<TClient, TEnv> {
+    readonly name: string;
+    createClient(env: TEnv): TClient;
+    hasCredentials(env: TEnv): boolean;
+}
+/**
+ * Generic exchange router that maps exchange names to providers.
+ * Workers extend or compose this to add worker-specific routing logic.
+ *
+ * @typeParam TClient - The exchange client type
+ * @typeParam TEnv - The worker's environment type
+ *
+ * @example
+ * ```ts
+ * const router = new ExchangeRouter<IExchangeClient, Env>();
+ * router.registerProvider(new BinanceProvider());
+ * const { client } = router.route("binance", env);
+ * ```
+ */
+export declare class ExchangeRouter<TClient, TEnv> {
+    private readonly providers;
+    registerProvider(provider: IExchangeProvider<TClient, TEnv>): void;
+    route(exchange: string, env: TEnv): {
+        exchange: string;
+        client: TClient;
+    };
+}
+export declare abstract class BaseExchangeClient {
+    protected readonly apiKey: string;
+    protected readonly apiSecret: string;
+    protected readonly baseUrl: string;
+    protected readonly isTestnet: boolean;
+    constructor(config: ExchangeConfig);
+    protected abstract getDefaultBaseUrl(): string;
+    protected abstract generateSignature(params: Record<string, string | number | boolean>): Promise<string>;
+    protected abstract buildHeaders(method: string, path: string, params?: Record<string, string | number | boolean>): Headers;
+    protected fetch<T>(method: string, path: string, params?: Record<string, string | number | boolean>): Promise<T>;
+    abstract setLeverage(symbol: string, leverage: number): Promise<void>;
+    abstract executeTrade(params: TradeParams): Promise<OrderResponse>;
+    abstract getAccountInfo(): Promise<Record<string, unknown>>;
+    abstract getPositions(symbol?: string): Promise<Position[]>;
+    openLong(symbol: string, quantity: number, price?: number, orderType?: string): Promise<OrderResponse>;
+    openShort(symbol: string, quantity: number, price?: number, orderType?: string): Promise<OrderResponse>;
+    closeLong(symbol: string, quantity: number): Promise<OrderResponse>;
+    closeShort(symbol: string, quantity: number): Promise<OrderResponse>;
+}
+//# sourceMappingURL=exchange-client.d.ts.map

package/dist/exchange-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-client.d.ts","sourceRoot":"","sources":["../src/exchange-client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,EAAE,IAAI;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC;IACjC,cAAc,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc,CAAC,OAAO,EAAE,IAAI;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAGtB;IAEJ,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;IAIlE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE;CAa1E;AAID,8BAAsB,kBAAkB;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IACrC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;gBAE1B,MAAM,EAAE,cAAc;IAUlC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,MAAM;IAE9C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAChD,OAAO,CAAC,MAAM,CAAC;IAElB,SAAS,CAAC,QAAQ,CAAC,YAAY,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,OAAO;cAEM,KAAK,CAAC,CAAC,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,OAAO,CAAC,CAAC,CAAC;aAqBG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;aAE5D,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;aAEzD,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aAElD,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAErD,QAAQ,CACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,SAAW,GACnB,OAAO,CAAC,aAAa,CAAC;IAUZ,SAAS,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,SAAW,GACnB,OAAO,CAAC,aAAa,CAAC;IAUZ,SAAS,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;IASZ,UAAU,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;CAQ1B"}

package/dist/exchange-client.js

@@ -0,0 +1,104 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/exchange-client.ts
+class ExchangeRouter {
+  providers = new Map;
+  registerProvider(provider) {
+    this.providers.set(provider.name.toLowerCase(), provider);
+  }
+  route(exchange, env) {
+    const key = exchange.toLowerCase();
+    const provider = this.providers.get(key);
+    if (!provider) {
+      throw new Error(`Unsupported exchange: ${exchange}`);
+    }
+    if (!provider.hasCredentials(env)) {
+      throw new Error(`API secret bindings not configured or accessible for ${exchange}`);
+    }
+    return { exchange: key, client: provider.createClient(env) };
+  }
+}
+
+class BaseExchangeClient {
+  apiKey;
+  apiSecret;
+  baseUrl;
+  isTestnet;
+  constructor(config) {
+    if (!config.apiKey || !config.apiSecret) {
+      throw new Error("API key and secret are required.");
+    }
+    this.apiKey = config.apiKey;
+    this.apiSecret = config.apiSecret;
+    this.baseUrl = config.baseUrl || this.getDefaultBaseUrl();
+    this.isTestnet = config.testnet || false;
+  }
+  async fetch(method, path, params) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = this.buildHeaders(method, path, params);
+    const body = params ? new URLSearchParams(params).toString() : undefined;
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: method !== "GET" ? body : undefined
+    });
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Exchange API error: ${response.status} - ${error}`);
+    }
+    return response.json();
+  }
+  async openLong(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "long",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async openShort(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "short",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async closeLong(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "long",
+      quantity,
+      reduceOnly: true
+    });
+  }
+  async closeShort(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "short",
+      quantity,
+      reduceOnly: true
+    });
+  }
+}
+export {
+  ExchangeRouter,
+  BaseExchangeClient
+};

package/dist/format-time.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Relative time formatter — converts a timestamp (ms) into a human-readable
+ * "time ago" string. Used by the StatusBar stale-data indicator and toast
+ * notifications for reconnection downtime.
+ *
+ * Format: "< 1m ago", "2m ago", "1h ago", "3d ago", "> 30d ago"
+ */
+/**
+ * Format a timestamp as a relative "X ago" string.
+ *
+ * @param timestampMs  Unix timestamp in milliseconds
+ * @param nowMs        Optional "now" reference (defaults to Date.now())
+ * @returns            Relative time string (e.g. "5m ago")
+ */
+export declare function formatRelativeTime(timestampMs: number, nowMs?: number): string;
+/**
+ * Format a duration in milliseconds as a compact human-readable string.
+ * Used for reconnection downtime toasts.
+ *
+ * @param durationMs  Duration in milliseconds
+ * @returns           Compact duration string (e.g. "12s", "2m 30s")
+ */
+export declare function formatDuration(durationMs: number): string;
+//# sourceMappingURL=format-time.d.ts.map

package/dist/format-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-time.d.ts","sourceRoot":"","sources":["../src/format-time.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAkBR;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAczD"}

package/dist/format-time.js

@@ -0,0 +1,57 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/format-time.ts
+function formatRelativeTime(timestampMs, nowMs) {
+  const now = nowMs ?? Date.now();
+  const diffMs = now - timestampMs;
+  if (diffMs < 0)
+    return "just now";
+  if (timestampMs === 0)
+    return "\u2014";
+  const seconds = Math.floor(diffMs / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (seconds < 60)
+    return "< 1m ago";
+  if (minutes < 60)
+    return `${minutes}m ago`;
+  if (hours < 24)
+    return `${hours}h ago`;
+  if (days < 30)
+    return `${days}d ago`;
+  return `> 30d ago`;
+}
+function formatDuration(durationMs) {
+  const seconds = Math.floor(durationMs / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  if (hours > 0) {
+    const remainMin = minutes % 60;
+    return remainMin > 0 ? `${hours}h ${remainMin}m` : `${hours}h`;
+  }
+  if (minutes > 0) {
+    const remainSec = seconds % 60;
+    return remainSec > 0 ? `${minutes}m ${remainSec}s` : `${minutes}m`;
+  }
+  return `${seconds}s`;
+}
+export {
+  formatRelativeTime,
+  formatDuration
+};

package/dist/formatters.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Formatters — Number, currency, duration, and timestamp formatting utilities.
+ *
+ * Pure functions — no side effects, safe for NaN/Infinity/negative/zero.
+ */
+/** Format large numbers with K/M/B suffixes */
+export declare function formatNumber(n: number): string;
+/** Format as compact currency */
+export declare function formatCurrency(n: number): string;
+/** Compact currency without sign prefix for raw values */
+export declare function formatCompactCurrency(n: number): string;
+/** Format duration in seconds to human-readable */
+export declare function formatDuration(seconds: number): string;
+/** Compact duration (e.g. "72h", "1d 3h") */
+export declare function formatDurationCompact(seconds: number): string;
+/** ISO timestamp to human-readable */
+export declare function formatTimestamp(iso: string): string;
+/** Relative time (e.g. "2m ago", "1h ago", "3d ago") */
+export declare function formatRelativeTime(timestamp: number): string;
+/** Format percentage */
+export declare function formatPercent(n: number, decimals?: number): string;
+/** Uptime seconds to human-readable */
+export declare function formatUptime(seconds: number): string;
+/** Latency in ms */
+export declare function formatLatency(ms: number): string;
+/** Request count */
+export declare function formatRequests(n: number): string;
+/** Memory in MB */
+export declare function formatMemory(usedMB: number, limitMB: number): string;
+/** CPU time in ms */
+export declare function formatCpu(ms: number): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM9C;AAED,iCAAiC;AACjC,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYtD;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED,wBAAwB;AACxB,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAI7D;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,oBAAoB;AACpB,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED,oBAAoB;AACpB,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,mBAAmB;AACnB,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,qBAAqB;AACrB,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5C"}

package/dist/formatters.js

@@ -0,0 +1,155 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/formatters.ts
+function formatNumber(n) {
+  if (!isFinite(n))
+    return "\u2014";
+  if (Math.abs(n) >= 1e9)
+    return `${(n / 1e9).toFixed(1)}B`;
+  if (Math.abs(n) >= 1e6)
+    return `${(n / 1e6).toFixed(1)}M`;
+  if (Math.abs(n) >= 1000)
+    return `${(n / 1000).toFixed(1)}K`;
+  return n.toLocaleString();
+}
+function formatCurrency(n) {
+  if (!isFinite(n))
+    return "\u2014";
+  const sign = n >= 0 ? "+" : "-";
+  const abs = Math.abs(n);
+  if (abs >= 1e6)
+    return `${sign}$${(abs / 1e6).toFixed(2)}M`;
+  if (abs >= 1000)
+    return `${sign}$${(abs / 1000).toFixed(2)}K`;
+  return `${sign}$${abs.toFixed(2)}`;
+}
+function formatCompactCurrency(n) {
+  if (!isFinite(n))
+    return "\u2014";
+  const abs = Math.abs(n);
+  const sign = n < 0 ? "-" : "";
+  if (abs >= 1e6)
+    return `${sign}$${(abs / 1e6).toFixed(2)}M`;
+  if (abs >= 1000)
+    return `${sign}$${(abs / 1000).toFixed(2)}K`;
+  return `${sign}$${abs.toFixed(2)}`;
+}
+function formatDuration(seconds) {
+  if (!isFinite(seconds) || seconds < 0)
+    return "\u2014";
+  const d = Math.floor(seconds / 86400);
+  const h = Math.floor(seconds % 86400 / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  const s = Math.floor(seconds % 60);
+  const parts = [];
+  if (d > 0)
+    parts.push(`${d}d`);
+  if (h > 0 || d > 0)
+    parts.push(`${h}h`);
+  if (m > 0 || h > 0 || d > 0)
+    parts.push(`${m}m`);
+  parts.push(`${s}s`);
+  return parts.join(" ");
+}
+function formatDurationCompact(seconds) {
+  if (!isFinite(seconds) || seconds < 0)
+    return "\u2014";
+  const d = Math.floor(seconds / 86400);
+  const h = Math.floor(seconds % 86400 / 3600);
+  const m = Math.floor(seconds % 3600 / 60);
+  if (d > 0)
+    return `${d}d ${h}h`;
+  if (h > 0)
+    return `${h}h ${m}m`;
+  if (m > 0)
+    return `${m}m`;
+  return `${Math.floor(seconds)}s`;
+}
+function formatTimestamp(iso) {
+  try {
+    const d = new Date(iso);
+    if (isNaN(d.getTime()))
+      return iso;
+    return d.toLocaleTimeString("en-US", { hour12: false });
+  } catch {
+    return iso;
+  }
+}
+function formatRelativeTime(timestamp) {
+  const now = Date.now();
+  const diff = now - timestamp;
+  if (diff < 0)
+    return "just now";
+  const seconds = Math.floor(diff / 1000);
+  if (seconds < 60)
+    return `${seconds}s ago`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60)
+    return `${minutes}m ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24)
+    return `${hours}h ago`;
+  const days = Math.floor(hours / 24);
+  return `${days}d ago`;
+}
+function formatPercent(n, decimals = 2) {
+  if (!isFinite(n))
+    return "\u2014";
+  const sign = n >= 0 ? "+" : "";
+  return `${sign}${n.toFixed(decimals)}%`;
+}
+function formatUptime(seconds) {
+  return formatDuration(seconds);
+}
+function formatLatency(ms) {
+  if (!isFinite(ms))
+    return "\u2014";
+  if (ms < 1)
+    return "<1ms";
+  if (ms < 1000)
+    return `${Math.round(ms)}ms`;
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatRequests(n) {
+  return formatNumber(n);
+}
+function formatMemory(usedMB, limitMB) {
+  const u = usedMB.toFixed(0);
+  const l = limitMB.toFixed(0);
+  return `${u}/${l} MB`;
+}
+function formatCpu(ms) {
+  if (!isFinite(ms))
+    return "\u2014";
+  return `${ms.toFixed(1)}ms`;
+}
+export {
+  formatUptime,
+  formatTimestamp,
+  formatRequests,
+  formatRelativeTime,
+  formatPercent,
+  formatNumber,
+  formatMemory,
+  formatLatency,
+  formatDurationCompact,
+  formatDuration,
+  formatCurrency,
+  formatCpu,
+  formatCompactCurrency
+};

package/dist/health.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Health check handler for Cloudflare Workers
+ * Provides a standardized /health endpoint response
+ */
+export interface HealthCheckOptions {
+    /** Worker/service name included in the response */
+    worker?: string;
+    /** Version string included in the response */
+    version?: string;
+    /** Additional details to include */
+    details?: Record<string, unknown>;
+}
+/**
+ * Create a standardized health check response.
+ * Returns a JSON response with success status and health metadata.
+ * Format: { success: true, result: { status: 'ok', timestamp, worker, version, details } }
+ */
+export declare function healthCheck(options?: HealthCheckOptions): Response;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAalE"}

package/dist/health.js

@@ -0,0 +1,117 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/errors.ts
+function toError(err, fallback = "Unknown error") {
+  if (err instanceof Error)
+    return err.message;
+  if (typeof err === "string")
+    return err;
+  if (err && typeof err === "object" && "message" in err && typeof err.message === "string") {
+    return err.message;
+  }
+  if (err === null || err === undefined)
+    return fallback;
+  try {
+    return JSON.stringify(err) || fallback;
+  } catch {
+    return fallback;
+  }
+}
+function sanitizeOutput(data) {
+  if (data instanceof Error) {
+    return { name: data.name, message: data.message };
+  }
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    const sanitized = {};
+    for (const [k, v] of Object.entries(data)) {
+      if (k === "stack" || k === "cause")
+        continue;
+      sanitized[k] = v instanceof Error ? { name: v.name, message: v.message } : sanitizeOutput(v);
+    }
+    return sanitized;
+  }
+  if (Array.isArray(data)) {
+    return data.map(sanitizeOutput);
+  }
+  return data;
+}
+function createJsonResponse(data, status = 200) {
+  return new Response(JSON.stringify(sanitizeOutput(data)), {
+    status,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+function createSuccessResponse(result) {
+  return createJsonResponse({ success: true, result }, 200);
+}
+function createErrorResponse(error, status) {
+  const message = typeof error === "string" ? error : error.message;
+  const statusCode = typeof error === "string" ? status ?? 500 : error.status ?? 500;
+  const body = { success: false, error: message };
+  if (typeof error !== "string" && error.code)
+    body.code = error.code;
+  if (typeof error !== "string" && error.details !== undefined)
+    body.details = error.details;
+  return new Response(JSON.stringify(body), {
+    status: statusCode,
+    headers: { "Content-Type": "application/json" }
+  });
+}
+var Errors = {
+  badRequest: (message) => createErrorResponse({ message, status: 400, code: "BAD_REQUEST" }),
+  unauthorized: (message = "Unauthorized") => createErrorResponse({ message, status: 401, code: "UNAUTHORIZED" }),
+  forbidden: (message = "Forbidden") => createErrorResponse({ message, status: 403, code: "FORBIDDEN" }),
+  notFound: (message = "Not found") => createErrorResponse({ message, status: 404, code: "NOT_FOUND" }),
+  methodNotAllowed: (message = "Method not allowed") => createErrorResponse({ message, status: 405, code: "METHOD_NOT_ALLOWED" }),
+  rateLimited: (retryAfter) => {
+    const res = createErrorResponse({
+      message: "Rate limit exceeded",
+      status: 429,
+      code: "RATE_LIMITED"
+    });
+    if (retryAfter)
+      res.headers.set("Retry-After", String(retryAfter));
+    return res;
+  },
+  internal: (err) => {
+    const message = err ? toError(err, "Internal server error") : "Internal server error";
+    return createErrorResponse({
+      message,
+      status: 500,
+      code: "INTERNAL_ERROR"
+    });
+  }
+};
+
+// src/health.ts
+function healthCheck(options) {
+  const result = {
+    status: "ok",
+    timestamp: new Date().toISOString()
+  };
+  if (options?.worker !== undefined && options?.worker !== null)
+    result.service = options.worker;
+  if (options?.version !== undefined && options?.version !== null)
+    result.version = options.version;
+  if (options?.details)
+    result.details = options.details;
+  return createSuccessResponse(result);
+}
+export {
+  healthCheck
+};

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @hoox/shared — Shared module for HOOX CLI and TUI
+ *
+ * Barrel export: re-exports all shared utilities, types, stores, and TUI helpers.
+ */
+export { COPYRIGHT, TRADEMARKS, TRADEMARK_NOTICE, DISCLAIMER, FULL_LEGAL_NOTICE, DISCLAIMER_HEADER, } from "./legal";
+export type { StandardResponse, ApiSuccessResponse, ApiErrorResponse, ApiResponse, WorkerServiceBinding, WorkerD1Binding, WorkerSecretsStoreBinding, WorkerQueueConfig, HousekeepingCheck, HousekeepingPayload, HousekeepingSummary, SettingsPayload, ProcessRequestBody, BaseEnv, Result, } from "./types";
+export { TradeActionSchema, WebhookPayloadSchema, TradeSignalSchema, PositionSchema, BalanceSchema, } from "./types";
+export type { TradeAction, WebhookPayload, TradeSignal } from "./types";
+export { KVKeys } from "./kvKeys";
+export { toError, Errors, createJsonResponse, createSuccessResponse, createErrorResponse, } from "./errors";
+export { BaseExchangeClient, ExchangeRouter } from "./exchange-client";
+export type { ExchangeName, ExchangeConfig, TradeParams, OrderResponse, Position, IExchangeProvider, } from "./exchange-client";
+export { logKvTimestamp, headersToObject } from "./kvUtils";
+export type { EnvWithKV } from "./kvUtils";
+export { trackAnalytics } from "./analytics";
+export type { AnalyticsEnv } from "./analytics";
+export { healthCheck } from "./health";
+export type { HealthCheckOptions } from "./health";
+export { D1Repository } from "./d1/index";
+export { serviceFetch } from "./service-bindings";
+export type { TradeRecord, PositionRecord, BalanceRecord, SystemLogRecord, TradeSignalRecord, D1QueryResult, BatchStatement, } from "./d1/index";
+export { Colors } from "./colors";
+export type { ColorKey } from "./colors";
+export { formatNumber, formatCurrency, formatCompactCurrency, formatDuration, formatDurationCompact, formatTimestamp, formatRelativeTime, formatPercent, formatUptime, formatLatency, formatRequests, formatMemory, formatCpu, } from "./formatters";
+export { readConfigSync, readConfig, writeConfigSync, writeConfig, validateConfig, } from "./config";
+export type { HooxConfig } from "./config";
+export { hooxFetch, WorkerAPIError } from "./api-client";
+export { subscribeSSE } from "./sse";
+export type { SSECallback, SSEStatusCallback } from "./sse";
+export { restoreSession, saveSession } from "./session";
+export type { SessionState } from "./session";
+export { formatRelativeTime as formatRelativeTimeFromTime } from "./format-time";
+export type { ViewId, ModalState, WorkerStatus, WorkerInfo, TradeSide, Trade, AlertSeverity, Alert, LogLevel, LogEntry, SystemMetrics, ConnectionStatus, LogFilter, NotificationPreferences, } from "./types";
+export type { StepId, WorkerPresetName, WorkerPreset, WorkerConfig, WorkersJsonConfig, IntegratedService, ProvisioningPlan, ProvisionResult, WizardCloudflareConfig, WizardState, StepDefinition, } from "./wizard";
+export type { Provisioner } from "./wizard";
+export { WizardEngine, PRESETS, WORKER_DEPENDENCIES, INTEGRATIONS, resolveDependencies, serializeState, deserializeState, WIZARD_STATE_PATH, } from "./wizard";
+export * from "./schemas/index.js";
+export { useUIStore } from "./stores/ui-store";
+export { useServiceStore } from "./stores/service-store";
+export { useConfigStore } from "./stores/config-store";
+export type { UIState } from "./stores/ui-store";
+export type { ServiceState } from "./stores/service-store";
+export type { ConfigState } from "./stores/config-store";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}