@hoox-sh/hoox-shared 1.2.0

package/dist/exchange-client.js

@@ -0,0 +1,107 @@
+// @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, options) {
+    const key = exchange.toLowerCase();
+    const provider = this.providers.get(key);
+    if (!provider) {
+      throw new Error(`Unsupported exchange: ${exchange}`);
+    }
+    if (options?.testnet && provider.supportsTestTrading === false) {
+      throw new Error(`TEST_TRADING_UNSUPPORTED: ${exchange} does not support test/sandbox trading via API`);
+    }
+    if (!provider.hasCredentials(env)) {
+      throw new Error(`API secret bindings not configured or accessible for ${exchange}`);
+    }
+    return { exchange: key, client: provider.createClient(env, options) };
+  }
+}
+
+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/exchanges/base-exchange-client.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface ExchangeConfig {
+    apiKey: string;
+    apiSecret: string;
+    baseUrl?: string;
+    testnet?: boolean;
+}
+/** Optional constructor options for exchange clients. */
+export interface ExchangeClientOptions {
+    /** Override the default API base URL. */
+    baseUrl?: string;
+    /** When true, use the exchange testnet/sandbox endpoint (if supported). */
+    testnet?: boolean;
+}
+export interface TradeParams {
+    symbol: string;
+    side: string;
+    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;
+}
+/**
+ * Base class for exchange clients. All exchange implementations must extend this.
+ * Provides common functionality for exchange API clients including signature generation,
+ * HTTP requests, and trade execution helpers.
+ */
+export declare abstract class BaseExchangeClient {
+    protected readonly apiKey: string;
+    protected readonly apiSecret: string;
+    protected readonly baseUrl: string;
+    protected readonly isTestnet: boolean;
+    protected readonly importedKeyPromise: Promise<CryptoKey>;
+    constructor(apiKey: string, apiSecret: string, options?: ExchangeClientOptions);
+    /** Whether this client instance is targeting a testnet/sandbox host. */
+    get testnet(): boolean;
+    /**
+     * Returns the error message prefix for this client.
+     * Subclasses can override to customize error messages.
+     */
+    protected getErrorMessagePrefix(): string;
+    protected abstract getDefaultBaseUrl(): string;
+    protected generateSignature(_params: Record<string, string | number | boolean>): Promise<string>;
+    protected buildHeaders(_method: string, _path: string, _params?: Record<string, string | number | boolean>): Headers;
+    /**
+     * Imports the API secret as a CryptoKey for HMAC-SHA256 signing.
+     */
+    private importKey;
+    /**
+     * Signs data using HMAC-SHA256 with the API secret.
+     */
+    protected cryptoSign(data: string): Promise<string>;
+    protected fetch<T>(method: string, path: string, params?: Record<string, string | number | boolean>): Promise<T>;
+    setLeverage(_symbol: string, _leverage: number): Promise<void>;
+    executeTrade(_params: TradeParams): Promise<OrderResponse>;
+    getAccountInfo(): Promise<Record<string, unknown>>;
+    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=base-exchange-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-exchange-client.d.ts","sourceRoot":"","sources":["../../src/exchanges/base-exchange-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,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,yDAAyD;AACzD,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,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;AAED;;;;GAIG;AACH,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;IACtC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;gBAGxD,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,qBAAqB;IAgBjC,wEAAwE;IACxE,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED;;;OAGG;IACH,SAAS,CAAC,qBAAqB,IAAI,MAAM;IAIzC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,MAAM;IAE9C,SAAS,CAAC,iBAAiB,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACjD,OAAO,CAAC,MAAM,CAAC;IAIlB,SAAS,CAAC,YAAY,CACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAClD,OAAO;IAIV;;OAEG;YACW,SAAS;IAWvB;;OAEG;cACa,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAazC,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;IAqBN,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAI1D,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIlD,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAI7C,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;IAUZ,UAAU,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC;CAS1B"}

package/dist/exchanges/base-exchange-client.js

@@ -0,0 +1,123 @@
+// @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/exchanges/base-exchange-client.ts
+class BaseExchangeClient {
+  apiKey;
+  apiSecret;
+  baseUrl;
+  isTestnet;
+  importedKeyPromise;
+  constructor(apiKey, apiSecret, options) {
+    if (!apiKey || !apiSecret) {
+      throw new Error(this.getErrorMessagePrefix() + "API key and secret are required.");
+    }
+    this.apiKey = apiKey;
+    this.apiSecret = apiSecret;
+    this.isTestnet = options?.testnet ?? false;
+    this.baseUrl = options?.baseUrl ?? this.getDefaultBaseUrl();
+    this.importedKeyPromise = this.importKey();
+  }
+  get testnet() {
+    return this.isTestnet;
+  }
+  getErrorMessagePrefix() {
+    return "";
+  }
+  generateSignature(_params) {
+    throw new Error("generateSignature must be implemented by subclass");
+  }
+  buildHeaders(_method, _path, _params) {
+    return new Headers;
+  }
+  async importKey() {
+    const encoder = new TextEncoder;
+    return crypto.subtle.importKey("raw", encoder.encode(this.apiSecret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+  }
+  async cryptoSign(data) {
+    const encoder = new TextEncoder;
+    const key = await this.importedKeyPromise;
+    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(data));
+    return Array.from(new Uint8Array(signature)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  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();
+  }
+  setLeverage(_symbol, _leverage) {
+    throw new Error("setLeverage must be implemented by subclass");
+  }
+  executeTrade(_params) {
+    throw new Error("executeTrade must be implemented by subclass");
+  }
+  getAccountInfo() {
+    throw new Error("getAccountInfo must be implemented by subclass");
+  }
+  getPositions(_symbol) {
+    throw new Error("getPositions must be implemented by subclass");
+  }
+  async openLong(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "BUY",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async openShort(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "SELL",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async closeLong(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "SELL",
+      orderType: "MARKET",
+      quantity,
+      reduceOnly: true
+    });
+  }
+  async closeShort(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "BUY",
+      orderType: "MARKET",
+      quantity,
+      reduceOnly: true
+    });
+  }
+}
+export {
+  BaseExchangeClient
+};

package/dist/exchanges/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export { BaseExchangeClient, type ExchangeConfig, type ExchangeClientOptions, type TradeParams, type OrderResponse, type Position, } from "./base-exchange-client";
+export type { SupportedExchange } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/exchanges/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/exchanges/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,QAAQ,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/exchanges/index.js

@@ -0,0 +1,123 @@
+// @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/exchanges/base-exchange-client.ts
+class BaseExchangeClient {
+  apiKey;
+  apiSecret;
+  baseUrl;
+  isTestnet;
+  importedKeyPromise;
+  constructor(apiKey, apiSecret, options) {
+    if (!apiKey || !apiSecret) {
+      throw new Error(this.getErrorMessagePrefix() + "API key and secret are required.");
+    }
+    this.apiKey = apiKey;
+    this.apiSecret = apiSecret;
+    this.isTestnet = options?.testnet ?? false;
+    this.baseUrl = options?.baseUrl ?? this.getDefaultBaseUrl();
+    this.importedKeyPromise = this.importKey();
+  }
+  get testnet() {
+    return this.isTestnet;
+  }
+  getErrorMessagePrefix() {
+    return "";
+  }
+  generateSignature(_params) {
+    throw new Error("generateSignature must be implemented by subclass");
+  }
+  buildHeaders(_method, _path, _params) {
+    return new Headers;
+  }
+  async importKey() {
+    const encoder = new TextEncoder;
+    return crypto.subtle.importKey("raw", encoder.encode(this.apiSecret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+  }
+  async cryptoSign(data) {
+    const encoder = new TextEncoder;
+    const key = await this.importedKeyPromise;
+    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(data));
+    return Array.from(new Uint8Array(signature)).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  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();
+  }
+  setLeverage(_symbol, _leverage) {
+    throw new Error("setLeverage must be implemented by subclass");
+  }
+  executeTrade(_params) {
+    throw new Error("executeTrade must be implemented by subclass");
+  }
+  getAccountInfo() {
+    throw new Error("getAccountInfo must be implemented by subclass");
+  }
+  getPositions(_symbol) {
+    throw new Error("getPositions must be implemented by subclass");
+  }
+  async openLong(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "BUY",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async openShort(symbol, quantity, price, orderType = "MARKET") {
+    return this.executeTrade({
+      symbol,
+      side: "SELL",
+      orderType,
+      quantity,
+      price
+    });
+  }
+  async closeLong(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "SELL",
+      orderType: "MARKET",
+      quantity,
+      reduceOnly: true
+    });
+  }
+  async closeShort(symbol, quantity) {
+    return this.executeTrade({
+      symbol,
+      side: "BUY",
+      orderType: "MARKET",
+      quantity,
+      reduceOnly: true
+    });
+  }
+}
+export {
+  BaseExchangeClient
+};

package/dist/exchanges/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type SupportedExchange = "binance" | "bybit" | "mexc";
+export interface ExchangeOrder {
+    orderId: string;
+    symbol: string;
+    side: "BUY" | "SELL";
+    quantity: number;
+    price?: number;
+    leverage?: number;
+    status: "PENDING" | "FILLED" | "CANCELED" | "FAILED";
+}
+export interface ExchangePosition {
+    symbol: string;
+    quantity: number;
+    leverage: number;
+    markPrice: number;
+    unrealizedPnl: number;
+    side: "LONG" | "SHORT";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/exchanges/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/exchanges/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;CACtD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/exchanges/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/format-time.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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;;;GAGG;AAEH;;;;;;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,36 @@
+/**
+ * Copyright (c) 2026 HOOX · HOOX · jango-blockchained (hoox-sh)
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * 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;;;GAGG;AAEH;;;;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"}