@kamino-finance/klend-sdk 8.0.1 → 8.0.2

package/dist/classes/index.d.ts

@@ -13,10 +13,5 @@ export * from './manager';
 export * from './vault';
 export * from './fraction';
 export * from './vault_types';
-export * from './accountSubscriptionManager';
-export * from './balanceListener';
-export * from './borrowOrderFillListener';
-export * from './obligationListener';
-export * from './reserveListener';
 export * from './cdnClient';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AAExB,cAAc,gBAAgB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAI9B,cAAc,aAAa,CAAC"}

package/dist/classes/index.js

@@ -29,10 +29,7 @@ __exportStar(require("./manager"), exports);
 __exportStar(require("./vault"), exports);
 __exportStar(require("./fraction"), exports);
 __exportStar(require("./vault_types"), exports);
-__exportStar(require("./accountSubscriptionManager"), exports);
-__exportStar(require("./balanceListener"), exports);
-__exportStar(require("./borrowOrderFillListener"), exports);
-__exportStar(require("./obligationListener"), exports);
-__exportStar(require("./reserveListener"), exports);
+// WS subsystem moved to src/ws/. `src/lib.ts` re-exports `./ws` at the
+// package root so external imports stay unchanged.
 __exportStar(require("./cdnClient"), exports);
 //# sourceMappingURL=index.js.map

package/dist/classes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,gDAA8B;AAC9B,0CAAwB;AACxB,6CAA2B;AAC3B,2CAAyB;AACzB,+CAA6B;AAC7B,oDAAkC;AAClC,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AAExB,iDAA+B;AAE/B,4CAA0B;AAC1B,0CAAwB;AACxB,6CAA2B;AAC3B,gDAA8B;AAE9B,+DAA6C;AAC7C,oDAAkC;AAClC,4DAA0C;AAC1C,uDAAqC;AACrC,oDAAkC;AAClC,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/classes/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,gDAA8B;AAC9B,0CAAwB;AACxB,6CAA2B;AAC3B,2CAAyB;AACzB,+CAA6B;AAC7B,oDAAkC;AAClC,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AAExB,iDAA+B;AAE/B,4CAA0B;AAC1B,0CAAwB;AACxB,6CAA2B;AAC3B,gDAA8B;AAE9B,uEAAuE;AACvE,mDAAmD;AACnD,8CAA4B"}

package/dist/lib.d.ts

@@ -8,6 +8,7 @@ export * from './@codegen/kvault/accounts/VaultState';
 export * from './@codegen/kvault/types';
 export { PROGRAM_ID as KVAULTS_PROGRAM_ID } from './@codegen/kvault/programId';
 export * from './classes';
+export * from './ws';
 export * from './utils';
 export * from './leverage';
 export * from './referrals';

package/dist/lib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE/E,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAE/C,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7F,cAAc,uCAAuC,CAAC;AACtD,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAE/E,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,UAAU,CAAC"}

package/dist/lib.js

@@ -28,6 +28,7 @@ __exportStar(require("./@codegen/kvault/types"), exports);
 var programId_1 = require("./@codegen/kvault/programId");
 Object.defineProperty(exports, "KVAULTS_PROGRAM_ID", { enumerable: true, get: function () { return programId_1.PROGRAM_ID; } });
 __exportStar(require("./classes"), exports);
+__exportStar(require("./ws"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./leverage"), exports);
 __exportStar(require("./referrals"), exports);

package/dist/lib.js.map

@@ -1 +1 @@
-{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,4DAA0C;AAC1C,6DAA2C;AAC3C,gEAA8C;AAE9C,iEAA+C;AAC/C,+HAA+H;AAC/H,wEAA6F;AAApF,kHAAA,YAAY,OAAsB;AAC3C,wEAAsD;AACtD,0DAAwC;AACxC,yDAA+E;AAAtE,+GAAA,UAAU,OAAsB;AAEzC,4CAA0B;AAC1B,0CAAwB;AACxB,6CAA2B;AAC3B,8CAA4B;AAC5B,uDAAqC;AACrC,sDAAoC;AACpC,2CAAyB"}
+{"version":3,"file":"lib.js","sourceRoot":"","sources":["../src/lib.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,4DAA0C;AAC1C,6DAA2C;AAC3C,gEAA8C;AAE9C,iEAA+C;AAC/C,+HAA+H;AAC/H,wEAA6F;AAApF,kHAAA,YAAY,OAAsB;AAC3C,wEAAsD;AACtD,0DAAwC;AACxC,yDAA+E;AAAtE,+GAAA,UAAU,OAAsB;AAEzC,4CAA0B;AAC1B,uCAAqB;AACrB,0CAAwB;AACxB,6CAA2B;AAC3B,8CAA4B;AAC5B,uDAAqC;AACrC,sDAAoC;AACpC,2CAAyB"}

package/dist/ws/accountSubscriptionManager.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Generic account subscription manager using Solana programNotifications.
+ * Framework-agnostic — consumers provide error/log callbacks for observability.
+ *
+ * Features:
+ * - Ref-counted: first listener starts the WS, last unsubscribe tears it down.
+ * - Slot-based ordering + buffer dedup (skips unchanged data, updates slot only).
+ * - Auto-reconnect via {@link runReconnectLoop}.
+ * - Decode/listener throws are reported but DO NOT trigger reconnect.
+ * - Per-listener `onReconnect` for state refresh after WS recovery; cleaned
+ *   up on unsubscribe so departed listeners' hooks cannot fire later.
+ */
+import { type Address, type Base58EncodedBytes, type Commitment, type RpcSubscriptions, type Slot, type SolanaRpcSubscriptionsApi } from '@solana/kit';
+import { type SubscriptionHandle } from './subscriptionHandle';
+import type { UpdateScheduler } from './wsUpdateScheduler';
+export type SubscriptionCallback = (address: Address, buffer: Uint8Array, slot: Slot) => void;
+export type SubscriptionMode = 'ws' | 'idle';
+export type SubscriptionErrorHandler = (error: unknown) => void;
+export type SubscriptionLogger = (...args: unknown[]) => void;
+export type ProgramFilter = Readonly<{
+    dataSize: bigint;
+}> | Readonly<{
+    memcmp: Readonly<{
+        offset: bigint;
+        bytes: Base58EncodedBytes;
+        encoding: 'base58';
+    }>;
+}>;
+export interface AccountSubscriptionManagerConfig {
+    wsRpc: RpcSubscriptions<SolanaRpcSubscriptionsApi>;
+    onError?: SubscriptionErrorHandler;
+    onLog?: SubscriptionLogger;
+    reconnectDelayMs?: number;
+}
+export interface SubscribeProgramAccountsOptions {
+    commitment?: Commitment;
+    /** Called after WS reconnects, before resuming the notification loop.
+     *  Use to refresh state that may have drifted during downtime.
+     *
+     *  Per-listener: each subscriber's hook is tracked independently and
+     *  cleaned up on `unsubscribe()`. The hook invoked on each reconnect is
+     *  the most recently registered one still attached (latest wins), so a
+     *  subscriber whose hook is currently in use can leave without leaving
+     *  a dangling reference.
+     *
+     *  The manager wraps the call in retry-with-exponential-backoff (capped
+     *  at 30s, 5 attempts). A throwing hook is reported through `onError`
+     *  per attempt; after the max, we give up and proceed with cached state.
+     *  Aborts cleanly on `unsubscribe()`. */
+    onReconnect?: () => void | Promise<void>;
+    /** Request a delivery cadence of at most one per N ms. The actual cadence
+     *  is the minimum of all subscribers' demands (**shortest wins**) — your
+     *  callback may fire faster than your own `throttleMs` if another
+     *  subscriber asked for less.
+     *
+     *  - A subscriber that omits `throttleMs` adds no demand and inherits the
+     *    existing cadence. To guarantee strictly immediate delivery, ensure
+     *    no other subscriber on the same `(programId, commitment, filters)`
+     *    key sets a `throttleMs` — otherwise their throttle wins.
+     *  - A throttled subscriber joining an unthrottled key silently throttles
+     *    the original subscriber (intentional — fast wins, no data loss).
+     *
+     *  Required when `scheduler` is set (sets the group cadence). */
+    throttleMs?: number;
+    /** Cross-stream flush scheduler — registers an updater under `throttleMs`
+     *  in the scheduler's group map. Drains the buffer on each scheduler tick
+     *  instead of running an own setTimeout.
+     *
+     *  Per-listener tracking: each subscriber's scheduler is recorded, and
+     *  the **active** scheduler is the FIRST one passed (insertion order).
+     *  Subscribers that omit `scheduler` don't contribute, so a no-scheduler
+     *  subscriber doesn't block a later one from establishing the active
+     *  scheduler. If a subscriber passes a scheduler DIFFERENT from the
+     *  active one, the manager logs (via `onLog`) and records the demand
+     *  anyway — that scheduler will take over only if every listener owning
+     *  the currently-active scheduler unsubscribes.
+     *
+     *  On unsubscribe, the active scheduler is recomputed and the buffered-
+     *  drain registration moves to the next scheduler in line (or falls back
+     *  to a self-managed timer if none remain). This prevents holding a dead
+     *  reference to a scheduler whose owner has departed.
+     *
+     *  Note: this subscription's scheduler-group cadence follows the
+     *  shortest-wins effective `throttleMs`. If a later subscriber to the
+     *  same key passes a shorter `throttleMs` (with or without scheduler),
+     *  the scheduler-group registration moves to the faster cadence — your
+     *  other subscriptions registered under the original cadence will no
+     *  longer flush together with this one. */
+    scheduler?: UpdateScheduler;
+}
+export declare class AccountSubscriptionManager {
+    private subscriptions;
+    private nextListenerId;
+    private wsRpc;
+    private onError;
+    private onLog;
+    private reconnectDelayMs;
+    constructor(config: AccountSubscriptionManagerConfig);
+    /**
+     * Subscribe to program account changes. First subscriber for a key starts
+     * the WS; last unsubscribe tears it down. Late subscribers replay any
+     * cached account data immediately.
+     */
+    subscribeProgramAccounts(programId: Address, filters: readonly ProgramFilter[], callback: SubscriptionCallback, options?: SubscribeProgramAccountsOptions): SubscriptionHandle;
+    /**
+     * Drain any buffered notifications immediately. With `commitment`, flushes
+     * just that subscription; without, flushes all matching programId+filters
+     * across all commitments.
+     *
+     * No-op if unbuffered or empty. Cadence timers keep ticking — next firing
+     * may be a no-op since the buffer was just cleared.
+     */
+    flushPending(programId: Address, filters: readonly ProgramFilter[], commitment?: Commitment): void;
+    getMode(programId: Address, filters: readonly ProgramFilter[], commitment?: Commitment): SubscriptionMode;
+    destroy(): void;
+    /** Resolves when the WS subscription is established.
+     *
+     *  Throws if no subscription matches `(programId, filters, commitment)` —
+     *  silently resolving used to make caller typos (wrong commitment, missing
+     *  prior `subscribeProgramAccounts`, stale filter array) look like a
+     *  successful wait. Failing loudly surfaces the sequencing bug at the
+     *  call site. */
+    waitForConnection(programId: Address, filters: readonly ProgramFilter[], commitment?: Commitment): Promise<void>;
+    private buildKey;
+    /** Direct lookup with `commitment`; fan-out scan without. */
+    private findSubscription;
+    /** Re-wire cadence machinery after a demands change. Fast no-op if effective throttle didn't change. */
+    private recomputeEffectiveThrottle;
+    /** Re-pick the active scheduler from current demands and re-wire the
+     *  group registration if the choice changed. */
+    private recomputeActiveScheduler;
+    private tearDownActiveCadence;
+    private attachToSchedulerGroup;
+    private flushOrphanedBuffer;
+    private rearmTimerForBufferedData;
+    /** No-op if a timer is already armed. */
+    private armThrottleDrainTimer;
+    private flushSubscription;
+    private createSubscription;
+    private startWs;
+    private handleNotification;
+    private deliverByCadence;
+    private drainBufferedNotifications;
+    private fireListeners;
+    private teardown;
+    /** Sleep `ms`, but resolve immediately on abort — mirrors the pattern in
+     *  runReconnectLoop so teardown cancels in-flight reconnect-hook retries. */
+    private static abortableSleep;
+    /** Calls the latest registered `onReconnect` hook with bounded retry-with-
+     *  backoff. The manager is the documented wrapper for runReconnectLoop's
+     *  best-effort `onBeforeReconnect` contract — failing the hook silently
+     *  would let listeners resume with stale state (e.g. borrowOrderFills
+     *  misclassifying new fills against pre-downtime obligations).
+     *
+     *  After {@link RECONNECT_HOOK_MAX_RETRIES} consecutive failures we give
+     *  up and proceed anyway: an indefinitely failing hook would block the
+     *  WS forever, which is worse than stale state. The error reporter sees
+     *  every failure regardless. */
+    private runReconnectHookWithRetry;
+}
+//# sourceMappingURL=accountSubscriptionManager.d.ts.map

package/dist/ws/accountSubscriptionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accountSubscriptionManager.d.ts","sourceRoot":"","sources":["../../src/ws/accountSubscriptionManager.ts"],"names":[],"mappings":"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"}