@juspay/neurolink 10.4.2 → 10.4.4

package/dist/types/proxy.d.ts

@@ -671,6 +671,29 @@ export type AnthropicUpstreamFetchResult = {
     sawNetworkError: boolean;
     upstreamSpan?: Span;
 };
+export type ProxyTerminalErrorCategory = "authentication" | "client_cancelled" | "fallback_exhausted" | "invalid_request" | "proxy_error" | "rate_limit" | "stream_error" | "unclassified" | "upstream_error" | "other";
+/** Compact, redacted terminal failure retained independently of body logs. */
+export type ProxyTerminalErrorSummary = {
+    id: string;
+    at: number;
+    status: number;
+    category: ProxyTerminalErrorCategory;
+    requestId?: string;
+    account?: string;
+    accountType?: string;
+    errorType?: string;
+    errorCode?: string;
+    terminalOutcome?: string;
+    message?: string;
+};
+/** Optional terminal context supplied when a final request error is recorded. */
+export type ProxyTerminalErrorDetails = {
+    requestId?: string;
+    errorType?: string;
+    errorCode?: string;
+    terminalOutcome?: string;
+    message?: string;
+};
 export type AccountStats = {
     label: string;
     type: string;
@@ -700,6 +723,19 @@ export type ProxyStats = {
     totalQuotaRateLimits: number;
     accounts: Record<string, AccountStats>;
 };
+/** Bounded terminal-error state stored separately from counters and body logs. */
+export type ProxyTerminalErrorJournal = {
+    startedAt: number;
+    totalErrors: number;
+    counts: Record<ProxyTerminalErrorCategory, number>;
+    recent: ProxyTerminalErrorSummary[];
+};
+export type ProxyUsageStatsSnapshot = {
+    stats: ProxyStats;
+    statsVersion: number;
+    terminalErrors: ProxyTerminalErrorJournal;
+    terminalErrorsVersion: number;
+};
 /** Durability and reconciliation state for the proxy usage counters. */
 export type ProxyStatsPersistenceStatus = {
     enabled: boolean;
@@ -712,6 +748,14 @@ export type ProxyStatsPersistenceStatus = {
     lastReconciledAt: number | null;
     lastRecoveryAt: number | null;
     lastError: string | null;
+    terminalErrorsFilePath?: string | null;
+    terminalErrorsRevision?: number;
+    terminalErrorsPending?: number;
+    terminalErrorsInFlight?: number;
+    terminalErrorsUnpersisted?: number;
+    terminalErrorsLastFlushedAt?: number | null;
+    terminalErrorsLastRecoveryAt?: number | null;
+    terminalErrorsLastError?: string | null;
 };
 /** Versioned on-disk snapshot shared by overlapping proxy workers. */
 export type PersistedProxyStatsSnapshot = {
@@ -720,6 +764,13 @@ export type PersistedProxyStatsSnapshot = {
     updatedAt: number;
     stats: ProxyStats;
 };
+/** Versioned terminal-error snapshot isolated from rolling-worker counter writes. */
+export type PersistedProxyTerminalErrorSnapshot = {
+    schemaVersion: 1;
+    revision: number;
+    updatedAt: number;
+    journal: ProxyTerminalErrorJournal;
+};
 /** Ownership metadata for the proxy statistics cross-process lock. */
 export type ProxyStatsLockOwner = {
     token: string;
@@ -729,6 +780,7 @@ export type ProxyStatsLockOwner = {
 /** Construction options for an isolated proxy statistics store. */
 export type ProxyUsageStatsStoreOptions = {
     filePath?: string;
+    terminalErrorsFilePath?: string;
     flushIntervalMs?: number;
     lockTimeoutMs?: number;
     staleLockMs?: number;
@@ -1121,6 +1173,7 @@ export type ProxyAnalysisAccount = {
     unclassifiedRateLimits: number;
 };
 /** Offline report generated from proxy request, attempt, and lifecycle logs. */
+export type ProxyAnalysisStreamName = "lifecycle" | "requests" | "attempts" | "debug";
 export type ProxyAnalysisReport = {
     generatedAt: string;
     since: string;
@@ -1129,6 +1182,7 @@ export type ProxyAnalysisReport = {
         lifecycle: number;
         requests: number;
         attempts: number;
+        debug: number;
     };
     coverage: {
         lifecycle: boolean;
@@ -1143,6 +1197,20 @@ export type ProxyAnalysisReport = {
         unsupportedLifecycleLines: number;
         lifecycleSequenceGaps: number;
         lifecycleSequenceDuplicates: number;
+        streams: Record<ProxyAnalysisStreamName, {
+            observedFrom: string | null;
+            observedTo: string | null;
+            startsAtOrBeforeRequestedWindow: boolean;
+        }>;
+        bodyArtifacts: {
+            capturesIndexed: number;
+            artifactsReferenced: number;
+            artifactsPresent: number;
+            artifactsMissing: number;
+            invalidPaths: number;
+            writeFailures: number;
+            truncatedCaptures: number;
+        };
     };
     lifecycle: {
         accepted: number;
@@ -1392,6 +1460,7 @@ export type StoredBodyArtifact = {
     storedFileBytes?: number;
     redactedBody?: string;
     bodyTruncated?: boolean;
+    bodyWriteFailed?: boolean;
 };
 /** File the proxy logger tracks for rotation and cleanup. */
 export type ManagedLogFile = {
@@ -1653,6 +1722,11 @@ export type ProxyWorkerStatusMessage = {
     generation: number;
     pid: number;
     socketId: string;
+} | {
+    type: "proxy-worker:replacement-requested";
+    generation: number;
+    pid: number;
+    reason: "environment";
 };
 export type ProxyWorkerSocketMessage = {
     type: "proxy-worker:socket";
@@ -1661,6 +1735,8 @@ export type ProxyWorkerSocketMessage = {
 };
 export type ProxyWorkerIpcMessage = ProxyWorkerControlMessage | ProxyWorkerStatusMessage | ProxyWorkerSocketMessage;
 export type TransferableProxySocket = Pick<import("node:net").Socket, "destroy" | "end" | "pause" | "resume" | "once">;
+/** A transferred socket whose temporary handoff listeners can be detached. */
+export type DetachableTransferableProxySocket = TransferableProxySocket & Pick<import("node:net").Socket, "off">;
 export type RollingWorkerHandle = {
     pid: number;
     sendControl: (message: ProxyWorkerControlMessage) => void;
@@ -1714,6 +1790,11 @@ export type RollingWorkerSupervisorOptions = {
     socketQueueTimeoutMs?: number;
     shutdownTimeoutMs?: number;
     onStateChange?: (snapshot: RollingWorkerSupervisorSnapshot) => void;
+    onReplacementRequested?: (request: {
+        generation: number;
+        pid: number;
+        reason: "environment";
+    }) => void;
     log?: (message: string) => void;
 };
 export type RollingProxyServerOptions = {
@@ -1854,6 +1935,7 @@ export type ProxyRuntimeConfigReloadResult = {
     applied: boolean;
     changed: boolean;
     generation: number;
+    environmentChanged?: boolean;
     error?: string;
 };
 /** Safe runtime configuration diagnostics exposed through proxy status. */
@@ -1921,6 +2003,11 @@ export type StatusStats = {
     totalRateLimits: number;
     totalTransientRateLimits?: number;
     totalQuotaRateLimits?: number;
+    terminalErrors?: ProxyTerminalErrorJournal;
+    lastTerminalError?: ProxyTerminalErrorSummary | null;
+    terminalErrorDetailsComparable?: boolean;
+    terminalErrorDetailsMissing?: number;
+    terminalErrorDetailsExcess?: number;
     accounts?: {
         label: string;
         type: string;
@@ -1933,7 +2020,9 @@ export type StatusStats = {
         transientRateLimits?: number;
         quotaRateLimits?: number;
         cooling: boolean;
-        status?: "active" | "cooling" | "disabled" | "excluded" | "removed";
+        allowed?: boolean;
+        expired?: boolean;
+        status?: "active" | "cooling" | "disabled" | "expired" | "excluded" | "removed" | "internal" | "unattributed";
     }[];
     persistence?: ProxyStatsPersistenceStatus;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "10.4.2",
+  "version": "10.4.4",
   "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": {