@pythnetwork/pyth-lazer-sdk 6.2.2 → 6.2.4

package/README.md

@@ -60,3 +60,77 @@ c.subscribe({
   jsonBinaryEncoding: "hex",
 });
 ```
+
+## Error callbacks and outage detection
+
+The SDK exposes two error callbacks and an "all connections down" listener that
+serve distinct purposes. Choose what to handle based on whether you want
+visibility into per-socket churn or a signal that the price stream has actually
+stopped.
+
+### `onWebSocketError` (per-socket errors)
+
+Passed via `webSocketPoolConfig.onWebSocketError`. Fires for individual
+socket-level errors on a single underlying WebSocket — for example, a transient
+`502` from one endpoint during a server upgrade or chaos test:
+
+```json
+{
+  "at": "pyth#connect",
+  "level": "ERROR",
+  "error": "Unexpected server response: 502"
+}
+```
+
+**In most cases you never need to handle `onWebSocketError` — it is purely
+informational.** The pool manages each socket's lifecycle (reconnect, retry,
+failover across the configured URLs), so these errors are expected churn when
+one endpoint hiccups. When the SDK is configured with redundant connections
+(`numConnections > 1`, multiple `urls`), a single socket failing does **not**
+mean the stream is dark — the other connections continue delivering messages.
+Treat it as diagnostic only; don't page or alert on it.
+
+### `onWebSocketPoolError` (pool-level errors)
+
+Passed via `webSocketPoolConfig.onWebSocketPoolError`. Fires for errors that
+originate from the pool itself rather than a single socket — server-sent
+`subscriptionError`/`error` messages, exceptions thrown by your message
+listeners, send failures, and other internal errors that would otherwise
+surface as unhandled rejections. Applications should listen to this and surface
+it (log, alert, etc.).
+
+```javascript
+webSocketPoolConfig: {
+  onWebSocketError: (error) => {
+    // Individual socket error — usually safe to log at info/debug.
+    console.warn("websocket error (single connection):", error.message);
+  },
+  onWebSocketPoolError: (error) => {
+    // Pool-level error — surface this.
+    console.error("websocket pool error:", error);
+  },
+},
+```
+
+### `addAllConnectionsDownListener` (stream is dark)
+
+Registered on the client. Fires when **every** redundant connection is down or
+reconnecting at the same time — i.e., the price stream really has stopped.
+This is the right signal for outage detection and paging:
+
+```javascript
+c.addAllConnectionsDownListener(() => {
+  console.error("All Lazer connections are down — stream is dark.");
+});
+```
+
+A matching `addConnectionRestoredListener` fires when at least one connection
+comes back after an all-down period.
+
+### Recommendation
+
+For detecting real outages, handle `onWebSocketPoolError` and
+`addAllConnectionsDownListener`. Do not page or panic solely on
+`onWebSocketError` when the SDK is configured with redundant endpoints and
+prices are still flowing — individual sockets are expected to flap during
+server upgrades and chaos tests.

package/dist/cjs/constants.cjs

@@ -30,7 +30,7 @@ _export(exports, {
 });
 const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
-const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+const DEFAULT_METADATA_SERVICE_URL = "https://pyth.dourolabs.app";
 const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
 const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
 const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/cjs/constants.d.ts

@@ -1,6 +1,6 @@
 export declare const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export declare const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
-export declare const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export declare const DEFAULT_METADATA_SERVICE_URL = "https://pyth.dourolabs.app";
 export declare const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
 export declare const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
 export declare const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/esm/constants.d.ts

@@ -1,6 +1,6 @@
 export declare const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export declare const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
-export declare const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export declare const DEFAULT_METADATA_SERVICE_URL = "https://pyth.dourolabs.app";
 export declare const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
 export declare const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
 export declare const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/dist/esm/constants.mjs

@@ -1,6 +1,6 @@
 export const SOLANA_LAZER_PROGRAM_ID = "pytd2yyk641x7ak7mkaasSJVXh6YYZnC7wTmtgAyxPt";
 export const SOLANA_LAZER_STORAGE_ID = "3rdJbqfnagQ4yx9HXJViD4zc4xpiSqmFsKpPuSCQVyQL";
-export const DEFAULT_METADATA_SERVICE_URL = "https://history.pyth-lazer.dourolabs.app/history";
+export const DEFAULT_METADATA_SERVICE_URL = "https://pyth.dourolabs.app";
 export const DEFAULT_PRICE_SERVICE_URL = "https://pyth-lazer-0.dourolabs.app";
 export const DEFAULT_STREAM_SERVICE_0_URL = "wss://pyth-lazer-0.dourolabs.app/v1/stream";
 export const DEFAULT_STREAM_SERVICE_1_URL = "wss://pyth-lazer-1.dourolabs.app/v1/stream";

package/package.json

@@ -1,20 +1,20 @@
 {
   "bugs": {
-    "url": "https://github.com/pyth-network/pyth-crosschain/issues"
+    "url": "https://github.com/pyth-network/pyth-lazer-public/issues"
   },
   "dependencies": {
-    "@isaacs/ttlcache": "^2.1.4",
+    "@isaacs/ttlcache": "^2.1.5",
     "buffer": "^6.0.3",
     "isomorphic-ws": "^5.0.0",
-    "ts-log": "^2.2.7",
-    "ws": "^8.20.0"
+    "ts-log": "^3.0.2",
+    "ws": "^8.21.0"
   },
   "description": "Pyth Lazer SDK",
   "devDependencies": {
-    "@cprussin/tsconfig": "^4.0.2",
-    "@types/node": "^24.10.1",
+    "@cprussin/tsconfig": "^5.0.0",
+    "@types/node": "^26.0.0",
     "@types/ws": "^8.18.1",
-    "typedoc": "^0.28.18"
+    "typedoc": "^0.28.19"
   },
   "engines": {
     "node": "^24.0.0"
@@ -135,7 +135,7 @@
   "files": [
     "dist/**/*"
   ],
-  "homepage": "https://github.com/pyth-network/pyth-crosschain/tree/main/lazer/sdk/js",
+  "homepage": "https://github.com/pyth-network/pyth-lazer-public/tree/main/sdk/js",
   "keywords": [
     "pyth",
     "oracle"
@@ -148,9 +148,9 @@
     "access": "public"
   },
   "repository": {
-    "directory": "lazer/sdk/js",
+    "directory": "sdk/js",
     "type": "git",
-    "url": "https://github.com/pyth-network/pyth-crosschain"
+    "url": "https://github.com/pyth-network/pyth-lazer-public"
   },
   "scripts": {
     "build": "ts-duality --clean",
@@ -164,5 +164,5 @@
   },
   "type": "module",
   "types": "./dist/cjs/index.d.ts",
-  "version": "6.2.2"
+  "version": "6.2.4"
 }