byterover-cli 1.7.0 → 1.7.2

package/node_modules/@campfirein/brv-transport-client/dist/infra/reconnection-strategy.d.ts

@@ -0,0 +1,136 @@
+import type { IReconnectionStrategy } from '../core/interfaces/i-reconnection-strategy.js';
+/**
+ * Configuration for exponential backoff reconnection strategy.
+ */
+export type ExponentialBackoffConfig = {
+    /** Base delay in milliseconds (default: 5000) */
+    readonly baseDelayMs?: number;
+    /** Maximum delay in milliseconds (default: 60000) */
+    readonly maxDelayMs?: number;
+    /** Maximum number of attempts before giving up (default: 10) */
+    readonly maxAttempts?: number;
+    /** Predefined delays array (overrides baseDelayMs/maxDelayMs if provided) */
+    readonly delays?: readonly number[];
+    /**
+     * Maximum total time in milliseconds before giving up.
+     * This provides an overall timeout regardless of attempt count.
+     * Default: undefined (no total time limit)
+     *
+     * @remarks
+     * When set, the strategy will stop reconnection attempts once
+     * the total elapsed time since the first attempt exceeds this value.
+     * This prevents users from waiting excessively long for reconnection.
+     *
+     * @example
+     * ```typescript
+     * // Give up after 5 minutes total, regardless of attempts
+     * const strategy = new ExponentialBackoffStrategy({
+     *   maxTotalTimeMs: 5 * 60 * 1000,
+     * })
+     * ```
+     */
+    readonly maxTotalTimeMs?: number;
+    /**
+     * Jitter factor to randomize delays and prevent thundering herd.
+     * Value between 0 and 1. Default: 0.5
+     *
+     * @remarks
+     * When multiple clients disconnect simultaneously (e.g., server restart),
+     * they would all reconnect at exactly the same times without jitter,
+     * potentially overwhelming the server. Jitter randomizes the delay:
+     * - jitterFactor = 0: No randomization (delay is exact)
+     * - jitterFactor = 0.5: Delay varies from 50% to 100% of base delay
+     * - jitterFactor = 1: Delay varies from 0% to 100% of base delay
+     *
+     * Formula: actualDelay = baseDelay * (1 - jitterFactor + Math.random() * jitterFactor)
+     *
+     * @example
+     * ```typescript
+     * // With jitterFactor = 0.5 and baseDelay = 5000ms:
+     * // actualDelay will be between 2500ms and 5000ms
+     * const strategy = new ExponentialBackoffStrategy({
+     *   jitterFactor: 0.5,
+     * })
+     * ```
+     */
+    readonly jitterFactor?: number;
+};
+/**
+ * Exponential backoff reconnection strategy.
+ * Implements IReconnectionStrategy with configurable delays.
+ *
+ * @remarks
+ * This strategy uses exponential backoff with configurable delays.
+ * Once max attempts is reached or max total time exceeded, shouldContinue() returns false.
+ *
+ * @example
+ * ```typescript
+ * const strategy = new ExponentialBackoffStrategy({
+ *   delays: [1000, 2000, 4000, 8000],
+ *   maxAttempts: 5,
+ * })
+ *
+ * strategy.getDelay(0) // 1000
+ * strategy.getDelay(3) // 8000
+ * strategy.getDelay(4) // 8000 (capped at last delay)
+ * strategy.shouldContinue(5) // false (exceeded maxAttempts)
+ * ```
+ *
+ * @example With total time limit
+ * ```typescript
+ * const strategy = new ExponentialBackoffStrategy({
+ *   maxAttempts: 100,
+ *   maxTotalTimeMs: 2 * 60 * 1000, // 2 minutes max
+ * })
+ *
+ * // Will stop after 2 minutes regardless of attempt count
+ * ```
+ */
+export declare class ExponentialBackoffStrategy implements IReconnectionStrategy {
+    #private;
+    constructor(config?: ExponentialBackoffConfig);
+    /**
+     * Ensures the strategy timer is started.
+     * Initializes #startedAt on first call to any strategy method.
+     *
+     * @remarks
+     * This provides a single initialization point to ensure accurate
+     * maxTotalTimeMs tracking regardless of which method is called first.
+     */
+    private ensureStarted;
+    /**
+     * Gets the delay for the given attempt with jitter applied.
+     * Returns undefined if max attempts exceeded or max total time exceeded.
+     *
+     * @remarks
+     * Jitter is applied to prevent thundering herd when multiple clients
+     * reconnect simultaneously. The actual delay is randomized:
+     * actualDelay = baseDelay * (1 - jitterFactor + Math.random() * jitterFactor)
+     */
+    getDelay(attempt: number): number | undefined;
+    /**
+     * Resets the strategy state.
+     * Clears the start timestamp for total time tracking.
+     */
+    reset(): void;
+    /**
+     * Checks if reconnection should continue for the given attempt.
+     * Returns false if max attempts exceeded or max total time exceeded.
+     */
+    shouldContinue(attempt: number): boolean;
+    /**
+     * Gets the elapsed time since reconnection attempts started.
+     * Returns undefined if no attempts have been made yet.
+     */
+    getElapsedTime(): number | undefined;
+    /**
+     * Gets the remaining time before max total time is exceeded.
+     * Returns undefined if no max total time is configured or no attempts have been made.
+     */
+    getRemainingTime(): number | undefined;
+}
+/**
+ * Creates a default reconnection strategy for force reconnect scenarios.
+ */
+export declare function createDefaultReconnectionStrategy(): IReconnectionStrategy;
+//# sourceMappingURL=reconnection-strategy.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/reconnection-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnection-strategy.d.ts","sourceRoot":"","sources":["../../infra/reconnection-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,+CAA+C,CAAA;AAExF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B,CAAA;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,0BAA2B,YAAW,qBAAqB;;gBAa1D,MAAM,CAAC,EAAE,wBAAwB;IA8B7C;;;;;;;OAOG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;;;;;OAQG;IACI,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAkBpD;;;OAGG;IACI,KAAK,IAAI,IAAI;IAIpB;;;OAGG;IACI,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAoB/C;;;OAGG;IACI,cAAc,IAAI,MAAM,GAAG,SAAS;IAO3C;;;OAGG;IACI,gBAAgB,IAAI,MAAM,GAAG,SAAS;CAO9C;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,qBAAqB,CAEzE"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/reconnection-strategy.js

@@ -0,0 +1,174 @@
+/**
+ * Default delays for force reconnection (exponential backoff).
+ */
+const DEFAULT_DELAYS = [5000, 10_000, 20_000, 30_000, 60_000];
+/**
+ * Default maximum attempts.
+ */
+const DEFAULT_MAX_ATTEMPTS = 10;
+/**
+ * Default jitter factor to prevent thundering herd.
+ * 0.5 means delays vary from 50% to 100% of base delay.
+ */
+const DEFAULT_JITTER_FACTOR = 0.5;
+/**
+ * Exponential backoff reconnection strategy.
+ * Implements IReconnectionStrategy with configurable delays.
+ *
+ * @remarks
+ * This strategy uses exponential backoff with configurable delays.
+ * Once max attempts is reached or max total time exceeded, shouldContinue() returns false.
+ *
+ * @example
+ * ```typescript
+ * const strategy = new ExponentialBackoffStrategy({
+ *   delays: [1000, 2000, 4000, 8000],
+ *   maxAttempts: 5,
+ * })
+ *
+ * strategy.getDelay(0) // 1000
+ * strategy.getDelay(3) // 8000
+ * strategy.getDelay(4) // 8000 (capped at last delay)
+ * strategy.shouldContinue(5) // false (exceeded maxAttempts)
+ * ```
+ *
+ * @example With total time limit
+ * ```typescript
+ * const strategy = new ExponentialBackoffStrategy({
+ *   maxAttempts: 100,
+ *   maxTotalTimeMs: 2 * 60 * 1000, // 2 minutes max
+ * })
+ *
+ * // Will stop after 2 minutes regardless of attempt count
+ * ```
+ */
+export class ExponentialBackoffStrategy {
+    #delays;
+    #maxAttempts;
+    #maxTotalTimeMs;
+    #jitterFactor;
+    /**
+     * Timestamp when reconnection attempts started.
+     * Set on first call to shouldContinue() or getDelay().
+     * Reset by reset().
+     */
+    #startedAt;
+    constructor(config) {
+        this.#delays = config?.delays ?? DEFAULT_DELAYS;
+        this.#maxAttempts = config?.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+        this.#maxTotalTimeMs = config?.maxTotalTimeMs;
+        this.#jitterFactor = config?.jitterFactor ?? DEFAULT_JITTER_FACTOR;
+        // Validate configuration
+        if (this.#delays.length === 0) {
+            throw new Error('ExponentialBackoffStrategy: delays array cannot be empty');
+        }
+        // Validate each delay value is a positive finite number
+        for (let i = 0; i < this.#delays.length; i++) {
+            const delay = this.#delays[i];
+            if (typeof delay !== 'number' || !Number.isFinite(delay) || delay <= 0) {
+                throw new Error(`ExponentialBackoffStrategy: delays[${i}]=${delay} must be a positive finite number`);
+            }
+        }
+        if (this.#maxAttempts <= 0) {
+            throw new Error('ExponentialBackoffStrategy: maxAttempts must be positive');
+        }
+        if (this.#maxTotalTimeMs !== undefined && this.#maxTotalTimeMs <= 0) {
+            throw new Error('ExponentialBackoffStrategy: maxTotalTimeMs must be positive');
+        }
+        if (this.#jitterFactor < 0 || this.#jitterFactor > 1) {
+            throw new Error('ExponentialBackoffStrategy: jitterFactor must be between 0 and 1');
+        }
+    }
+    /**
+     * Ensures the strategy timer is started.
+     * Initializes #startedAt on first call to any strategy method.
+     *
+     * @remarks
+     * This provides a single initialization point to ensure accurate
+     * maxTotalTimeMs tracking regardless of which method is called first.
+     */
+    ensureStarted() {
+        if (this.#startedAt === undefined) {
+            this.#startedAt = Date.now();
+        }
+    }
+    /**
+     * Gets the delay for the given attempt with jitter applied.
+     * Returns undefined if max attempts exceeded or max total time exceeded.
+     *
+     * @remarks
+     * Jitter is applied to prevent thundering herd when multiple clients
+     * reconnect simultaneously. The actual delay is randomized:
+     * actualDelay = baseDelay * (1 - jitterFactor + Math.random() * jitterFactor)
+     */
+    getDelay(attempt) {
+        // Ensure timer started before checking shouldContinue
+        this.ensureStarted();
+        if (!this.shouldContinue(attempt)) {
+            return undefined;
+        }
+        // Cap at last delay value
+        const index = Math.min(attempt, this.#delays.length - 1);
+        const baseDelay = this.#delays[index];
+        // Apply jitter to prevent thundering herd
+        // Formula: delay * (1 - jitter + random * jitter)
+        // With jitter=0.5: delay varies from 0.5*base to 1.0*base
+        const jitterMultiplier = 1 - this.#jitterFactor + Math.random() * this.#jitterFactor;
+        return Math.floor(baseDelay * jitterMultiplier);
+    }
+    /**
+     * Resets the strategy state.
+     * Clears the start timestamp for total time tracking.
+     */
+    reset() {
+        this.#startedAt = undefined;
+    }
+    /**
+     * Checks if reconnection should continue for the given attempt.
+     * Returns false if max attempts exceeded or max total time exceeded.
+     */
+    shouldContinue(attempt) {
+        // Ensure timer started (delegated to ensureStarted for consistency)
+        this.ensureStarted();
+        // Check max attempts
+        if (attempt >= this.#maxAttempts) {
+            return false;
+        }
+        // Check max total time
+        if (this.#maxTotalTimeMs !== undefined) {
+            const elapsed = Date.now() - this.#startedAt;
+            if (elapsed >= this.#maxTotalTimeMs) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Gets the elapsed time since reconnection attempts started.
+     * Returns undefined if no attempts have been made yet.
+     */
+    getElapsedTime() {
+        if (this.#startedAt === undefined) {
+            return undefined;
+        }
+        return Date.now() - this.#startedAt;
+    }
+    /**
+     * Gets the remaining time before max total time is exceeded.
+     * Returns undefined if no max total time is configured or no attempts have been made.
+     */
+    getRemainingTime() {
+        if (this.#maxTotalTimeMs === undefined || this.#startedAt === undefined) {
+            return undefined;
+        }
+        const elapsed = Date.now() - this.#startedAt;
+        return Math.max(0, this.#maxTotalTimeMs - elapsed);
+    }
+}
+/**
+ * Creates a default reconnection strategy for force reconnect scenarios.
+ */
+export function createDefaultReconnectionStrategy() {
+    return new ExponentialBackoffStrategy();
+}
+//# sourceMappingURL=reconnection-strategy.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/reconnection-strategy.js.map

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

package/node_modules/@campfirein/brv-transport-client/dist/infra/room-manager.d.ts

@@ -0,0 +1,122 @@
+import type { IRoomManager } from '../core/interfaces/i-room-manager.js';
+import type { IClientLogger } from '../core/interfaces/i-client-logger.js';
+import type { ISocketProvider } from '../core/interfaces/i-socket-provider.js';
+/**
+ * Public configuration for RoomManager.
+ * Follows Interface Segregation Principle - exposes only necessary options.
+ */
+export type RoomManagerConfig = {
+    /** Timeout for room operations in milliseconds (default: 2000) */
+    readonly roomTimeoutMs?: number;
+    /** Logger for debugging (default: NoOpClientLogger) */
+    readonly logger?: IClientLogger;
+    /** Socket provider for accessing the socket instance (required) */
+    readonly socketProvider: ISocketProvider;
+};
+/**
+ * Internal tuning parameters for rejoin behavior.
+ * Not exposed in public API - implementation detail.
+ * @internal
+ */
+type InternalRejoinConfig = {
+    /** Maximum rejoin attempts after reconnect (default: 5) */
+    readonly maxRejoinAttempts?: number;
+    /** Base delay for rejoin retry in milliseconds (default: 50) */
+    readonly rejoinBaseDelayMs?: number;
+};
+/**
+ * Full internal configuration type.
+ * @internal
+ */
+type InternalRoomManagerConfig = RoomManagerConfig & InternalRejoinConfig;
+/**
+ * Manages room subscriptions for targeted broadcasts.
+ * Handles join, leave, and auto-rejoin on reconnect.
+ *
+ * @remarks
+ * - Tracks joined rooms for auto-rejoin after reconnect
+ * - Uses exponential backoff for rejoin retries
+ * - All operations have timeout protection
+ * - Uses AbortController for clean cancellation of rejoin operations
+ *
+ * @example
+ * ```typescript
+ * const roomManager = new RoomManager()
+ * roomManager.setSocket(socket)
+ *
+ * await roomManager.joinRoom('my-room')
+ * console.log(roomManager.getJoinedRooms()) // Set { 'my-room' }
+ *
+ * // After reconnect
+ * roomManager.rejoinRooms()
+ *
+ * await roomManager.leaveRoom('my-room')
+ * ```
+ */
+export declare class RoomManager implements IRoomManager {
+    #private;
+    constructor(config: InternalRoomManagerConfig);
+    /**
+     * Gets the current socket from the provider.
+     * @returns Socket instance or undefined if not connected
+     */
+    private get socket();
+    /**
+     * Gets the set of currently joined rooms.
+     * Returns a defensive copy to prevent external mutation.
+     * @returns Set of room identifiers (immutable copy)
+     */
+    getJoinedRooms(): ReadonlySet<string>;
+    /**
+     * Joins a room for targeted broadcasts.
+     * @throws InvalidRoomNameError if room name is invalid
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomTimeoutError if join times out
+     * @throws TransportRoomError if join fails
+     */
+    joinRoom(room: string): Promise<void>;
+    /**
+     * Leaves a previously joined room.
+     * @throws InvalidRoomNameError if room name is invalid
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomTimeoutError if leave times out
+     * @throws TransportRoomError if leave fails
+     */
+    leaveRoom(room: string): Promise<void>;
+    /**
+     * Rejoins all tracked rooms after reconnect.
+     * Skips rooms that already have an active rejoin operation in progress.
+     */
+    rejoinRooms(): void;
+    /**
+     * Clears all tracked rooms and cancels pending rejoin operations.
+     */
+    clearRooms(): void;
+    /**
+     * Cancels rejoin operation for a specific room.
+     */
+    private cancelRejoin;
+    /**
+     * Creates a cancellable delay using AbortSignal.
+     * @returns Promise that resolves after delay or rejects if aborted
+     */
+    private delay;
+    /**
+     * Rejoins a single room with retry logic and timeout protection.
+     * Uses exponential backoff: 50ms, 100ms, 200ms, 400ms, 800ms (max 5 attempts).
+     * Cancellable via AbortSignal for clean cleanup.
+     */
+    private rejoinRoomWithRetry;
+    /**
+     * Attempts to join a room with timeout protection.
+     * @returns true if join succeeded, false if failed
+     * @throws Error if aborted or timed out
+     */
+    private attemptRoomJoin;
+    /**
+     * Logs a message with prefix.
+     */
+    private log;
+}
+export {};
+//# sourceMappingURL=room-manager.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/room-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-manager.d.ts","sourceRoot":"","sources":["../../infra/room-manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,sCAAsC,CAAA;AACtE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uCAAuC,CAAA;AACxE,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,yCAAyC,CAAA;AAU5E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;CACzC,CAAA;AAED;;;;GAIG;AACH,KAAK,oBAAoB,GAAG;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,gEAAgE;IAChE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC,CAAA;AAED;;;GAGG;AACH,KAAK,yBAAyB,GAAG,iBAAiB,GAAG,oBAAoB,CAAA;AAEzE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,WAAY,YAAW,YAAY;;gBAelC,MAAM,EAAE,yBAAyB;IAQ7C;;;OAGG;IACH,OAAO,KAAK,MAAM,GAEjB;IAED;;;;OAIG;IACI,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC;IAI5C;;;;;;OAMG;IACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClD;;;;;;OAMG;IACU,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCnD;;;OAGG;IACI,WAAW,IAAI,IAAI;IAmB1B;;OAEG;IACI,UAAU,IAAI,IAAI;IASzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;;OAGG;IACH,OAAO,CAAC,KAAK;IAqBb;;;;OAIG;YACW,mBAAmB;IAsDjC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;IACH,OAAO,CAAC,GAAG;CAGZ"}