@adaptic/utils 0.1.47 → 0.1.49

package/dist/types/utils/http-keep-alive.d.ts

@@ -0,0 +1,110 @@
+/**
+ * HTTP connection pooling and keep-alive configuration.
+ *
+ * Node.js (>=20) uses undici as its built-in fetch implementation, which
+ * automatically maintains an internal connection pool with keep-alive enabled
+ * by default. This module provides:
+ *
+ * 1. Explicit documentation of the connection pooling behavior
+ * 2. A configured HTTP Agent for use with node:http/node:https if needed
+ * 3. Verification utilities to confirm keep-alive is active
+ *
+ * ## Connection Pooling Behavior
+ *
+ * **Native fetch (undici):** The global `fetch()` used throughout this package
+ * uses Node.js built-in undici which maintains persistent connections by default.
+ * Connections are kept alive and reused across requests to the same origin.
+ * No additional configuration is needed for fetch-based API calls.
+ *
+ * **Alpaca SDK (@alpacahq/alpaca-trade-api):** The SDK uses its own internal
+ * HTTP client with connection reuse. The SDK is configured through `AlpacaClient`
+ * in `src/alpaca/client.ts` via the `createAlpacaClient()` factory which caches
+ * client instances by API key + account type.
+ *
+ * **WebSocket connections:** Trading API and market data WebSocket connections
+ * are long-lived persistent connections managed by `AlpacaTradingAPI` and
+ * `AlpacaMarketDataAPI` respectively.
+ *
+ * ## API Client Summary
+ *
+ * | API Client | Transport | Keep-Alive | Connection Reuse |
+ * |------------|-----------|------------|------------------|
+ * | Alpaca Trading (direct) | fetch() | Built-in | Undici pool |
+ * | Alpaca Market Data | fetch() | Built-in | Undici pool |
+ * | Alpaca SDK | internal | Built-in | SDK managed |
+ * | Massive.com | fetch() via fetchWithRetry | Built-in | Undici pool |
+ * | Alpha Vantage | fetch() | Built-in | Undici pool |
+ * | WebSocket (Trading) | ws | Persistent | Long-lived |
+ * | WebSocket (Market Data) | ws | Persistent | Long-lived |
+ */
+import http from "http";
+import https from "https";
+/**
+ * Default keep-alive configuration values.
+ * These are applied when creating explicit HTTP agents for non-fetch use cases.
+ */
+export declare const KEEP_ALIVE_DEFAULTS: {
+    /** Enable keep-alive connections */
+    readonly keepAlive: true;
+    /** Initial delay before sending keep-alive probes (in milliseconds) */
+    readonly keepAliveMsecs: 60000;
+    /** Maximum number of sockets per host */
+    readonly maxSockets: 50;
+    /** Maximum total number of sockets */
+    readonly maxTotalSockets: 256;
+    /** Maximum number of free (idle) sockets per host */
+    readonly maxFreeSockets: 10;
+    /** Socket timeout for idle connections (in milliseconds) */
+    readonly timeout: 60000;
+};
+/**
+ * Pre-configured HTTP agent with keep-alive enabled.
+ * Use this when making requests through node:http (not needed for fetch).
+ */
+export declare const httpAgent: http.Agent;
+/**
+ * Pre-configured HTTPS agent with keep-alive enabled.
+ * Use this when making requests through node:https (not needed for fetch).
+ */
+export declare const httpsAgent: https.Agent;
+/**
+ * Connection pool status information
+ */
+export interface ConnectionPoolStatus {
+    /** Name of the HTTP agent */
+    name: string;
+    /** Whether keep-alive is enabled */
+    keepAlive: boolean;
+    /** Number of active sockets */
+    activeSockets: number;
+    /** Number of free (idle) sockets */
+    freeSockets: number;
+    /** Number of pending requests (waiting for a socket) */
+    pendingRequests: number;
+    /** Maximum sockets per host */
+    maxSockets: number;
+    /** Maximum free sockets per host */
+    maxFreeSockets: number;
+}
+/**
+ * Get the connection pool status for an HTTP/HTTPS agent.
+ * Useful for monitoring and debugging connection reuse.
+ *
+ * @param agent - The HTTP/HTTPS agent to inspect
+ * @param name - A human-readable name for the agent
+ * @returns Connection pool status information
+ */
+export declare function getAgentPoolStatus(agent: http.Agent | https.Agent, name?: string): ConnectionPoolStatus;
+/**
+ * Verifies that keep-alive is properly configured for the Node.js built-in fetch.
+ * Node.js >= 20 uses undici internally, which has keep-alive enabled by default.
+ *
+ * @returns Object indicating whether keep-alive is expected to be active
+ */
+export declare function verifyFetchKeepAlive(): {
+    supported: boolean;
+    nodeVersion: string;
+    undiciBuiltIn: boolean;
+    keepAliveExpected: boolean;
+};
+//# sourceMappingURL=http-keep-alive.d.ts.map

package/dist/types/utils/http-keep-alive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-keep-alive.d.ts","sourceRoot":"","sources":["../../../src/utils/http-keep-alive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,eAAO,MAAM,mBAAmB;IAC9B,oCAAoC;;IAEpC,uEAAuE;;IAEvE,yCAAyC;;IAEzC,sCAAsC;;IAEtC,qDAAqD;;IAErD,4DAA4D;;CAEpD,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,SAAS,YAOpB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,aAOrB,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAC/B,IAAI,GAAE,MAAkB,GACvB,oBAAoB,CA4BtB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,CAeA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaptic/utils",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "author": "Adaptic.ai",
   "description": "Utility functions used in Adaptic app and Lambda functions",
   "always-build-npm": true,

package/dist/types/__tests__/financial-regression.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=financial-regression.test.d.ts.map

package/dist/types/__tests__/financial-regression.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"financial-regression.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/financial-regression.test.ts"],"names":[],"mappings":""}

package/dist/types/__tests__/price-utils.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=price-utils.test.d.ts.map

package/dist/types/__tests__/price-utils.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"price-utils.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/price-utils.test.ts"],"names":[],"mappings":""}