@juspay/neurolink 10.1.2 → 10.2.0

package/dist/types/proxy.d.ts

@@ -700,6 +700,40 @@ export type ProxyStats = {
     totalQuotaRateLimits: number;
     accounts: Record<string, AccountStats>;
 };
+/** Durability and reconciliation state for the proxy usage counters. */
+export type ProxyStatsPersistenceStatus = {
+    enabled: boolean;
+    filePath: string | null;
+    revision: number;
+    pendingMutations: number;
+    inFlightMutations: number;
+    unpersistedMutations: number;
+    lastFlushedAt: number | null;
+    lastReconciledAt: number | null;
+    lastRecoveryAt: number | null;
+    lastError: string | null;
+};
+/** Versioned on-disk snapshot shared by overlapping proxy workers. */
+export type PersistedProxyStatsSnapshot = {
+    schemaVersion: 1;
+    revision: number;
+    updatedAt: number;
+    stats: ProxyStats;
+};
+/** Ownership metadata for the proxy statistics cross-process lock. */
+export type ProxyStatsLockOwner = {
+    token: string;
+    pid: number;
+    acquiredAt: number;
+};
+/** Construction options for an isolated proxy statistics store. */
+export type ProxyUsageStatsStoreOptions = {
+    filePath?: string;
+    flushIntervalMs?: number;
+    lockTimeoutMs?: number;
+    staleLockMs?: number;
+    now?: () => number;
+};
 export type RefreshableAccount = {
     token: string;
     refreshToken?: string;
@@ -874,6 +908,8 @@ export type ProxyPaths = {
     quotaFile: string;
     /** account-cooldowns.json — restart-safe account cooldown state */
     cooldownFile: string;
+    /** proxy-usage-stats.json — restart- and handoff-safe usage counters */
+    statsFile?: string;
     /** Whether this is a dev-mode isolated instance */
     isDev: boolean;
 };
@@ -1876,6 +1912,7 @@ export type ProxyStartApp = {
 };
 /** Stats shape consumed by the proxy status printer. */
 export type StatusStats = {
+    startedAt?: number;
     totalAttempts?: number;
     totalAttemptErrors?: number;
     totalRequests: number;
@@ -1896,7 +1933,9 @@ export type StatusStats = {
         transientRateLimits?: number;
         quotaRateLimits?: number;
         cooling: boolean;
+        status?: "active" | "cooling" | "disabled" | "excluded" | "removed";
     }[];
+    persistence?: ProxyStatsPersistenceStatus;
 };
 /** Sub-action of the `proxy telemetry` CLI command. */
 export type ProxyTelemetryAction = "setup" | "start" | "stop" | "status" | "logs" | "import-dashboard";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.1.2",
+  "version": "10.2.0",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {
@@ -179,9 +179,10 @@
     "proxy:observability:doctor": "node scripts/observability/check-proxy-telemetry.mjs",
     "proxy:observability:import-dashboard": "bash scripts/observability/manage-local-openobserve.sh import-dashboard",
     "proxy:performance:lifecycle": "tsx tools/testing/proxyLifecycleBenchmark.ts",
+    "proxy:performance:stats": "tsx tools/testing/proxyUsageStatsBenchmark.ts",
     "proxy:performance:transport": "tsx tools/testing/proxyTransportBenchmark.ts",
     "proxy:performance:rolling": "tsx tools/testing/proxyRollingHandoffBenchmark.ts",
-    "proxy:performance": "pnpm run proxy:performance:lifecycle && pnpm run proxy:performance:transport && pnpm run proxy:performance:rolling",
+    "proxy:performance": "pnpm run proxy:performance:lifecycle && pnpm run proxy:performance:stats && pnpm run proxy:performance:transport && pnpm run proxy:performance:rolling",
     "// Development & Monitoring": "",
     "dev:health": "tsx tools/development/healthMonitor.ts",
     "dev:demo": "concurrently \"pnpm run dev\" \"node neurolink-demo/complete-enhanced-server.js\"",