@oobe-protocol-labs/synapse-client-sdk 1.0.8 → 1.2.0

package/dist/esm/context/refs.js

@@ -0,0 +1,664 @@
+/**
+ * Memory-safe service references — ref counting, leak detection, WeakRef sharing.
+ *
+ * ## Why refs?
+ *
+ * In an SDK, memory management is critical. Raw `resolve()` returns
+ * a direct reference with no tracking. `acquireRef()` returns a
+ * `ServiceRef<T>` that:
+ *
+ * 1. **Tracks** how many components hold the service (ref counting)
+ * 2. **Invalidates** automatically when the context is disposed
+ * 3. **Detects leaks** via `FinalizationRegistry` (if a ref is GC'd without release)
+ * 4. **Supports RAII** via `use()` / `useAsync()` / `withRef()`
+ *
+ * ## Architecture
+ *
+ * ```
+ * ┌──────────────────────────────────────────────────────────┐
+ * │ Component A                   Component B                │
+ * │  acquireRef(RPC) ──┐    ┌── acquireRef(RPC)              │
+ * │    ServiceRef #1   │    │    ServiceRef #2                │
+ * │     refCount: 2    ▼    ▼    refCount: 2                 │
+ * │               ┌──────────┐                               │
+ * │               │ Registry │  ← FinalizationRegistry       │
+ * │               │  RPC → 2 │     (leak detection)          │
+ * │               └────┬─────┘                               │
+ * │                    │                                      │
+ * │               ┌────▼─────┐                               │
+ * │               │ Singleton│  (one instance, N refs)        │
+ * │               │  RPC svc │                               │
+ * │               └──────────┘                               │
+ * │                                                          │
+ * │ A.release() → refCount: 1 │ B.release() → refCount: 0   │
+ * └──────────────────────────────────────────────────────────┘
+ * ```
+ *
+ * ## Component sharing pattern
+ *
+ * ```ts
+ * // Component A — acquires a tracked reference
+ * const rpcRef = ctx.acquireRef(Tokens.RPC);
+ * const balance = await rpcRef.current.getBalance(pubkey);
+ *
+ * // Component B — acquires its own tracked ref to the SAME instance
+ * const rpcRef2 = ctx.acquireRef(Tokens.RPC);
+ * const slot = await rpcRef2.current.getSlot();
+ *
+ * // Both hold the SAME singleton — ref count is 2
+ * ctx.refCount(Tokens.RPC); // → 2
+ *
+ * // Component A unmounts
+ * rpcRef.release();         // ref count → 1
+ *
+ * // Component B unmounts
+ * rpcRef2.release();        // ref count → 0
+ * ```
+ *
+ * ## RAII pattern (auto-release)
+ *
+ * ```ts
+ * // Sync — ref released in finally block
+ * const balance = withRef(ctx, Tokens.RPC, rpc => rpc.getBalance(pubkey));
+ *
+ * // Async — ref released after await completes
+ * const slot = await withRefAsync(ctx, Tokens.RPC, rpc => rpc.getSlot());
+ *
+ * // On the ref itself
+ * const result = ref.use(rpc => rpc.getBalance(pubkey));
+ * ```
+ *
+ * @module context/refs
+ * @since 1.2.0
+ */
+import { SynapseError } from '../core/errors.js';
+// ── Errors ─────────────────────────────────────────────────────
+/**
+ * Thrown when accessing `.current` on a released or invalidated reference.
+ * @since 1.2.0
+ */
+export class RefReleasedError extends SynapseError {
+    constructor(tokenName) {
+        super(`Service reference for "${tokenName}" has been released. ` +
+            'Acquire a new ref with acquireRef() or check ref.alive before access.', -32104);
+        this.name = 'RefReleasedError';
+    }
+}
+// ── ServiceRef ─────────────────────────────────────────────────
+/**
+ * A tracked, ref-counted reference to a resolved service.
+ *
+ * Provides memory-safe access: accessing `.current` after `.release()`
+ * throws {@link RefReleasedError} instead of returning a stale value.
+ *
+ * @typeParam T - The service type.
+ * @since 1.2.0
+ *
+ * @example
+ * ```ts
+ * const rpcRef = ctx.acquireRef(Tokens.RPC);
+ *
+ * // Use the service
+ * const balance = await rpcRef.current.getBalance(pubkey);
+ *
+ * // Release when done (e.g. on unmount)
+ * rpcRef.release();
+ *
+ * // Accessing after release throws
+ * rpcRef.current; // ❌ RefReleasedError
+ * ```
+ */
+export class ServiceRef {
+    _value;
+    _token;
+    _onRelease;
+    id;
+    _released = false;
+    _acquiredAt;
+    /**
+     * @internal Use `ctx.acquireRef(token)` or `RefRegistry.acquire()` to create refs.
+     */
+    constructor(_value, _token, _onRelease, 
+    /** Unique reference ID (monotonically increasing within a registry). */
+    id) {
+        this._value = _value;
+        this._token = _token;
+        this._onRelease = _onRelease;
+        this.id = id;
+        this._acquiredAt = performance.now();
+    }
+    // ── Accessors ──────────────────────────────────────────────
+    /**
+     * The resolved service instance.
+     *
+     * @throws {RefReleasedError} If the ref has been released or invalidated.
+     */
+    get current() {
+        if (this._released) {
+            throw new RefReleasedError(this._token.name);
+        }
+        return this._value;
+    }
+    /** Whether this reference is still valid (not released). */
+    get alive() { return !this._released; }
+    /** The token this ref was acquired for. */
+    get token() { return this._token; }
+    /** `performance.now()` timestamp when this ref was acquired. */
+    get acquiredAt() { return this._acquiredAt; }
+    /** How long this ref has been alive, in ms. */
+    get ageMs() { return performance.now() - this._acquiredAt; }
+    // ── Release ────────────────────────────────────────────────
+    /**
+     * Release this reference, decrementing the ref count.
+     *
+     * After release:
+     * - `.current` throws {@link RefReleasedError}
+     * - `.alive` returns `false`
+     * - The ref count for this token decreases by 1
+     *
+     * Safe to call multiple times (idempotent).
+     */
+    release() {
+        if (this._released)
+            return;
+        this._released = true;
+        this._onRelease(this);
+    }
+    /** Alias for {@link release}. Implements {@link Disposable}. */
+    dispose() { this.release(); }
+    // ── RAII patterns ──────────────────────────────────────────
+    /**
+     * Execute a function with this reference, auto-releasing afterward.
+     *
+     * The ref is released in a `finally` block, guaranteeing cleanup
+     * even if the function throws.
+     *
+     * @param fn - Receives the unwrapped service value.
+     * @returns The return value of `fn`.
+     *
+     * @example
+     * ```ts
+     * const balance = rpcRef.use(rpc => rpc.getBalance(pubkey));
+     * // rpcRef is now released — no leak possible
+     * ```
+     */
+    use(fn) {
+        try {
+            return fn(this.current);
+        }
+        finally {
+            this.release();
+        }
+    }
+    /**
+     * Async version of {@link use}. Awaits the function, then releases.
+     *
+     * @example
+     * ```ts
+     * const balance = await rpcRef.useAsync(rpc => rpc.getBalance(pubkey));
+     * ```
+     */
+    async useAsync(fn) {
+        try {
+            return await fn(this.current);
+        }
+        finally {
+            this.release();
+        }
+    }
+    // ── Sharing ────────────────────────────────────────────────
+    /**
+     * Create a weak reference that does **not** prevent garbage collection.
+     *
+     * The returned `WeakServiceRef` can be shared to components that
+     * only need the service optionally — if the strong refs are all
+     * released and the GC collects the object, `.deref()` returns
+     * `undefined` instead of throwing.
+     *
+     * @throws {SynapseError} If the service value is a primitive (not weakly referenceable).
+     *
+     * @example
+     * ```ts
+     * const weakRpc = rpcRef.toWeak();
+     * // Later:
+     * const rpc = weakRpc.deref();
+     * if (rpc) rpc.getBalance(pubkey);
+     * ```
+     */
+    toWeak() {
+        if (typeof this._value !== 'object' || this._value === null) {
+            throw new SynapseError(`Cannot create WeakRef for non-object service "${this._token.name}". ` +
+                'WeakRef requires an object target.', -32105);
+        }
+        return new WeakServiceRef(this._value);
+    }
+}
+// ── WeakServiceRef ─────────────────────────────────────────────
+/**
+ * A non-preventing (weak) reference to a service.
+ *
+ * Unlike {@link ServiceRef}, this does **not** keep the service alive
+ * in memory. The garbage collector can collect the underlying object
+ * even while this ref exists. Use `.deref()` to check if the service
+ * is still available.
+ *
+ * @typeParam T - The service type (must be an object).
+ * @since 1.2.0
+ *
+ * @example
+ * ```ts
+ * const weakRpc = strongRef.toWeak();
+ *
+ * // In another component — check before use
+ * const rpc = weakRpc.deref();
+ * if (rpc) {
+ *   await rpc.getBalance(pubkey);
+ * } else {
+ *   // Service was GC'd — re-acquire if needed
+ * }
+ * ```
+ */
+export class WeakServiceRef {
+    _ref;
+    constructor(value) {
+        this._ref = new WeakRef(value);
+    }
+    /**
+     * Dereference the weak ref.
+     * @returns The service instance, or `undefined` if it was GC'd.
+     */
+    deref() {
+        return this._ref.deref();
+    }
+    /** Whether the underlying object is still alive (not yet GC'd). */
+    get alive() {
+        return this._ref.deref() !== undefined;
+    }
+}
+// ── RefRegistry ────────────────────────────────────────────────
+/**
+ * Centralized registry that tracks all active {@link ServiceRef}s.
+ *
+ * Provides ref counting, introspection, and leak detection via
+ * `FinalizationRegistry`. Each `SynapseContext` owns at most one
+ * `RefRegistry` (created lazily on first `acquireRef()`).
+ *
+ * @since 1.2.0
+ */
+export class RefRegistry {
+    /** @internal Active refs grouped by token. */
+    _entries = new Map();
+    /** @internal FinalizationRegistry for GC-based leak detection. */
+    _leakDetector;
+    /** @internal Track which ref IDs are still active (for leak detection). */
+    _activeRefIds = new Set();
+    /** @internal Monotonically increasing ref ID. */
+    _nextId = 1;
+    /** @internal Counters. */
+    _totalAcquired = 0;
+    _totalReleased = 0;
+    _peakActive = 0;
+    _leakedCount = 0;
+    /** @internal Leak handlers. */
+    _leakHandlers = [];
+    /** @internal Whether the registry has been disposed. */
+    _disposed = false;
+    constructor(config = {}) {
+        const enableLeaks = config.enableLeakDetection !== false;
+        if (enableLeaks && typeof FinalizationRegistry !== 'undefined') {
+            this._leakDetector = new FinalizationRegistry((held) => {
+                // This ref was GC'd without release() being called → leak
+                if (this._activeRefIds.has(held.refId)) {
+                    this._activeRefIds.delete(held.refId);
+                    this._leakedCount++;
+                    const report = {
+                        tokenName: held.tokenName,
+                        refId: held.refId,
+                        acquiredAt: held.acquiredAt,
+                        detectedAt: performance.now(),
+                    };
+                    for (const handler of this._leakHandlers) {
+                        try {
+                            handler(report);
+                        }
+                        catch { /* swallow listener errors */ }
+                    }
+                }
+            });
+        }
+    }
+    // ── Acquire & Release ──────────────────────────────────────
+    /**
+     * Create a tracked ref for a resolved service value.
+     *
+     * @param token - The service token.
+     * @param value - The resolved service instance.
+     * @returns A new `ServiceRef<T>` linked to this registry.
+     */
+    acquire(token, value) {
+        if (this._disposed) {
+            throw new SynapseError('RefRegistry has been disposed', -32106);
+        }
+        const id = this._nextId++;
+        this._totalAcquired++;
+        const ref = new ServiceRef(value, token, (r) => this._handleRelease(token, r), id);
+        // Track in entries map
+        let set = this._entries.get(token);
+        if (!set) {
+            set = new Set();
+            this._entries.set(token, set);
+        }
+        set.add(ref);
+        // Track active ID
+        this._activeRefIds.add(id);
+        if (this._activeRefIds.size > this._peakActive) {
+            this._peakActive = this._activeRefIds.size;
+        }
+        // Register with leak detector
+        if (this._leakDetector) {
+            this._leakDetector.register(ref, { tokenName: token.name, refId: id, acquiredAt: ref.acquiredAt }, ref);
+        }
+        return ref;
+    }
+    /** @internal Handle a ref being released. */
+    _handleRelease(token, ref) {
+        this._activeRefIds.delete(ref.id);
+        this._totalReleased++;
+        const set = this._entries.get(token);
+        if (set) {
+            set.delete(ref);
+            if (set.size === 0)
+                this._entries.delete(token);
+        }
+        // Unregister from leak detector (ref was properly released)
+        if (this._leakDetector) {
+            this._leakDetector.unregister(ref);
+        }
+    }
+    // ── Ref Counting ───────────────────────────────────────────
+    /**
+     * Number of active refs for a specific token.
+     */
+    refCount(token) {
+        return this._entries.get(token)?.size ?? 0;
+    }
+    /**
+     * Total number of active (unreleased) refs across all tokens.
+     */
+    totalActive() {
+        return this._activeRefIds.size;
+    }
+    // ── Stats & Introspection ──────────────────────────────────
+    /**
+     * Aggregate statistics snapshot.
+     */
+    get stats() {
+        return {
+            totalAcquired: this._totalAcquired,
+            totalReleased: this._totalReleased,
+            active: this._activeRefIds.size,
+            peak: this._peakActive,
+            leaked: this._leakedCount,
+            byToken: this._tokenBreakdown(),
+        };
+    }
+    /** @internal Build per-token breakdown. */
+    _tokenBreakdown() {
+        const result = {};
+        for (const [token, set] of this._entries) {
+            if (set.size > 0)
+                result[token.name] = set.size;
+        }
+        return result;
+    }
+    // ── Leak Detection ─────────────────────────────────────────
+    /**
+     * Check for potential leaks: refs that have been alive longer
+     * than `maxAgeMs` without being released.
+     *
+     * This is a **heuristic** — long-lived refs (e.g. for the lifetime
+     * of the app) are expected. Use this for debugging / dev mode.
+     *
+     * @param maxAgeMs - Threshold in ms. @default 60_000
+     */
+    checkLeaks(maxAgeMs = 60_000) {
+        const now = performance.now();
+        const reports = [];
+        for (const [token, set] of this._entries) {
+            for (const ref of set) {
+                if (ref.ageMs > maxAgeMs) {
+                    reports.push({
+                        tokenName: token.name,
+                        refId: ref.id,
+                        acquiredAt: ref.acquiredAt,
+                        detectedAt: now,
+                    });
+                }
+            }
+        }
+        return reports;
+    }
+    /**
+     * Register a handler for GC-detected leaks.
+     *
+     * Called when a `ServiceRef` is garbage collected without
+     * `.release()` having been called first.
+     *
+     * @param handler - Receives a {@link LeakReport} for each leak.
+     */
+    onLeak(handler) {
+        this._leakHandlers.push(handler);
+    }
+    // ── Cleanup ────────────────────────────────────────────────
+    /**
+     * Force-release all active refs.
+     *
+     * Called automatically when the owning `SynapseContext` is disposed.
+     * After this, all refs' `.current` will throw {@link RefReleasedError}.
+     */
+    invalidateAll() {
+        for (const set of this._entries.values()) {
+            // Iterate a copy because release() modifies the set
+            for (const ref of [...set]) {
+                ref.release();
+            }
+        }
+        this._entries.clear();
+        this._activeRefIds.clear();
+    }
+    /** Dispose the registry — invalidates all refs, clears handlers. */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        this.invalidateAll();
+        this._leakHandlers.length = 0;
+    }
+    /** Whether this registry has been disposed. */
+    get isDisposed() { return this._disposed; }
+}
+// ── MemoryGuard ────────────────────────────────────────────────
+/**
+ * Memory safety monitor that wraps a {@link RefRegistry}.
+ *
+ * Provides configurable thresholds, periodic leak checks, and
+ * pressure alerts. Designed for dev-mode diagnostics or production
+ * monitoring of SDK memory usage.
+ *
+ * @since 1.2.0
+ *
+ * @example
+ * ```ts
+ * const guard = new MemoryGuard(registry, {
+ *   maxRefAgeMs: 30_000,
+ *   maxActiveRefs: 50,
+ *   checkIntervalMs: 10_000,
+ * });
+ *
+ * guard.onPressure(stats => {
+ *   console.warn('⚠️ Memory pressure:', stats.active, 'active refs');
+ * });
+ *
+ * guard.onLeak(report => {
+ *   console.error('🔴 Leaked ref:', report.tokenName, '#' + report.refId);
+ * });
+ * ```
+ */
+export class MemoryGuard {
+    _registry;
+    _timer;
+    _pressureHandlers = [];
+    _config;
+    constructor(_registry, config = {}) {
+        this._registry = _registry;
+        this._config = {
+            maxRefAgeMs: config.maxRefAgeMs ?? 60_000,
+            maxActiveRefs: config.maxActiveRefs ?? 100,
+            checkIntervalMs: config.checkIntervalMs ?? 0,
+        };
+        // Forward leak events from registry
+        // (no extra wiring needed — users subscribe via guard.onLeak())
+        // Periodic check timer
+        if (this._config.checkIntervalMs > 0) {
+            this._timer = setInterval(() => this._periodicCheck(), this._config.checkIntervalMs);
+            // unref() so the timer doesn't prevent process.exit()
+            if (typeof this._timer === 'object' && 'unref' in this._timer) {
+                this._timer.unref();
+            }
+        }
+    }
+    // ── Stats ──────────────────────────────────────────────────
+    /** Current ref statistics from the underlying registry. */
+    get stats() { return this._registry.stats; }
+    /** Whether the active ref count exceeds the threshold. */
+    get underPressure() {
+        return this._registry.totalActive() >= this._config.maxActiveRefs;
+    }
+    /** Number of currently active refs. */
+    get activeRefs() {
+        return this._registry.totalActive();
+    }
+    // ── Checks ─────────────────────────────────────────────────
+    /**
+     * Check for potential leaks (refs older than `maxRefAgeMs`).
+     */
+    checkLeaks() {
+        return this._registry.checkLeaks(this._config.maxRefAgeMs);
+    }
+    // ── Events ─────────────────────────────────────────────────
+    /**
+     * Subscribe to memory pressure events.
+     *
+     * Fires when the active ref count exceeds `maxActiveRefs`
+     * during a periodic check.
+     */
+    onPressure(handler) {
+        this._pressureHandlers.push(handler);
+    }
+    /**
+     * Subscribe to GC-detected leak events.
+     *
+     * Delegates to the underlying {@link RefRegistry.onLeak}.
+     */
+    onLeak(handler) {
+        this._registry.onLeak(handler);
+    }
+    // ── Internal ───────────────────────────────────────────────
+    /** @internal Periodic check callback. */
+    _periodicCheck() {
+        if (this.underPressure) {
+            const stats = this.stats;
+            for (const handler of this._pressureHandlers) {
+                try {
+                    handler(stats);
+                }
+                catch { /* swallow */ }
+            }
+        }
+    }
+    /** Dispose the guard — stops the timer, clears handlers. */
+    dispose() {
+        if (this._timer) {
+            clearInterval(this._timer);
+            this._timer = undefined;
+        }
+        this._pressureHandlers.length = 0;
+    }
+}
+/**
+ * Create a binding that acquires tracked refs for multiple tokens.
+ *
+ * Services are resolved **lazily** on first property access. All refs
+ * are released together with a single `.release()` call.
+ *
+ * @param acquireFn - Function that acquires a ref for a token (usually `ctx.acquireRef.bind(ctx)`).
+ * @param tokens    - Record mapping property names to service tokens.
+ * @returns A {@link ServiceBinding} with lazy services and batch release.
+ * @since 1.2.0
+ *
+ * @example
+ * ```ts
+ * const binding = createBinding(
+ *   token => ctx.acquireRef(token),
+ *   { rpc: Tokens.RPC, das: Tokens.DAS, programs: Tokens.PROGRAMS },
+ * );
+ *
+ * // Use services (each is acquired on first access):
+ * await binding.services.rpc.getBalance(pubkey);
+ * await binding.services.das.getAsset(assetId);
+ *
+ * // Release ALL refs at once:
+ * binding.release();
+ * ```
+ */
+export function createBinding(acquireFn, tokens) {
+    const refs = new Map();
+    let released = false;
+    const services = new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop === 'symbol')
+                return undefined;
+            if (released) {
+                throw new SynapseError('ServiceBinding has been released. Cannot access services after release.', -32107);
+            }
+            // Return cached if already acquired
+            const existing = refs.get(prop);
+            if (existing)
+                return existing.current;
+            // Acquire new ref
+            const token = tokens[prop];
+            if (!token)
+                return undefined;
+            const ref = acquireFn(token);
+            refs.set(prop, ref);
+            return ref.current;
+        },
+        has(_target, prop) {
+            return typeof prop === 'string' && prop in tokens;
+        },
+        ownKeys() {
+            return Object.keys(tokens);
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (typeof prop === 'string' && prop in tokens) {
+                return { configurable: true, enumerable: true, writable: false };
+            }
+            return undefined;
+        },
+    });
+    return {
+        services,
+        refs,
+        get alive() { return !released && [...refs.values()].some(r => r.alive); },
+        release() {
+            if (released)
+                return;
+            released = true;
+            for (const ref of refs.values()) {
+                ref.release();
+            }
+        },
+        dispose() { this.release(); },
+    };
+}
+//# sourceMappingURL=refs.js.map

package/dist/esm/context/refs.js.map

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