byterover-cli 1.7.0 → 1.7.2

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-factory.d.ts

@@ -0,0 +1,44 @@
+import type { ITransportClient } from './i-client.js';
+/**
+ * Result of connection attempt.
+ */
+export type ConnectionResult = {
+    /** The connected client */
+    readonly client: ITransportClient;
+    /** Project root where instance was found */
+    readonly projectRoot: string;
+};
+/**
+ * Interface for transport client factory.
+ * Abstracts the creation and connection of transport clients.
+ *
+ * @remarks
+ * Follows Dependency Inversion Principle - high-level modules can depend
+ * on this abstraction rather than concrete factory implementations.
+ *
+ * @example
+ * ```typescript
+ * // Inject factory abstraction
+ * class MyService {
+ *   constructor(private readonly factory: IClientFactory) {}
+ *
+ *   async connect(): Promise<ITransportClient> {
+ *     const { client } = await this.factory.connect()
+ *     return client
+ *   }
+ * }
+ * ```
+ */
+export interface IClientFactory {
+    /**
+     * Discovers a running instance and connects to it.
+     *
+     * @param fromDir - Directory to start discovery from (default: cwd)
+     * @returns Connected client and project root
+     * @throws NoInstanceRunningError - No .brv directory found
+     * @throws InstanceCrashedError - Instance found but process dead
+     * @throws ConnectionFailedError - Instance found but connection failed
+     */
+    connect(fromDir?: string): Promise<ConnectionResult>;
+}
+//# sourceMappingURL=i-client-factory.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-factory.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-client-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAA;AAEnD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CACrD"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-factory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-client-factory.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-factory.js","sourceRoot":"","sources":["../../../core/interfaces/i-client-factory.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-logger.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Logger interface for the Socket.IO client component.
+ *
+ * This interface allows optional logging injection without creating
+ * dependencies on the main codebase's logging utilities.
+ *
+ * @remarks
+ * Follows Interface Segregation Principle - provides standard log levels
+ * without requiring complex logging infrastructure.
+ *
+ * The default implementation (NoOpClientLogger) is located in the
+ * infrastructure layer at `infra/no-op-client-logger.ts`.
+ */
+export interface IClientLogger {
+    /**
+     * Log a debug message.
+     * Used for connection state changes, reconnection attempts, etc.
+     *
+     * @param message - The message to log
+     */
+    debug(message: string): void;
+    /**
+     * Log an informational message.
+     * Used for significant events that are part of normal operation.
+     *
+     * @param message - The message to log
+     */
+    info(message: string): void;
+    /**
+     * Log a warning message.
+     * Used for potentially problematic situations that don't prevent operation.
+     *
+     * @param message - The message to log
+     */
+    warn(message: string): void;
+    /**
+     * Log an error message.
+     * Used for error conditions that may affect operation.
+     *
+     * @param message - The message to log
+     * @param error - Optional error object for stack trace
+     */
+    error(message: string, error?: Error): void;
+}
+//# sourceMappingURL=i-client-logger.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-logger.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-client-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CAC5C"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-client-logger.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client-logger.js","sourceRoot":"","sources":["../../../core/interfaces/i-client-logger.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client.d.ts

@@ -0,0 +1,170 @@
+import type { ConnectionState, ConnectionStateHandler } from './i-connection-state.js';
+import type { EventHandler } from './i-event-dispatcher.js';
+export type { ConnectionState, ConnectionStateHandler } from './i-connection-state.js';
+export type { EventHandler } from './i-event-dispatcher.js';
+/**
+ * Options for client requests.
+ */
+export type RequestOptions = {
+    /**
+     * Timeout in milliseconds for the request.
+     * If not specified, uses the default timeout.
+     */
+    readonly timeout?: number;
+};
+/**
+ * Interface for transport client operations.
+ * Provides abstraction over real-time communication protocols (Socket.IO, WebSocket, etc.)
+ * following Clean Architecture principles.
+ *
+ * The client:
+ * - Connects to a transport server
+ * - Sends requests and receives responses
+ * - Listens for broadcast events
+ * - Joins rooms for targeted broadcasts
+ *
+ * @remarks
+ * This interface follows Interface Segregation Principle (ISP) by providing
+ * only the essential operations needed by consumers. Internal implementation
+ * details are hidden behind composition of smaller, focused components.
+ */
+export interface ITransportClient {
+    /**
+     * Connects to the transport server at the specified URL.
+     * @param url - The server URL to connect to (e.g., "http://localhost:9847")
+     * @throws TransportConnectionError if connection fails
+     */
+    connect(url: string): Promise<void>;
+    /**
+     * Disconnects from the transport server.
+     * Cleans up resources and stops reconnection attempts.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Returns the unique client ID assigned by the server.
+     * @returns Client ID or undefined if not connected
+     */
+    getClientId(): string | undefined;
+    /**
+     * Returns the current connection state.
+     */
+    getState(): ConnectionState;
+    /**
+     * Checks if the socket is actually connected and responsive.
+     * Verifies bidirectional communication by sending a ping and waiting for response.
+     * @param timeoutMs - Timeout in milliseconds (default: 2000)
+     * @returns true if socket is connected and responsive, false otherwise
+     */
+    isConnected(timeoutMs?: number): Promise<boolean>;
+    /**
+     * Joins a room for targeted broadcasts.
+     * @param room - The room identifier to join
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomError if join fails
+     * @throws TransportRoomTimeoutError if join times out
+     */
+    joinRoom(room: string): Promise<void>;
+    /**
+     * Leaves a room.
+     *
+     * @remarks
+     * This method uses "fire-and-forget" semantics for room tracking.
+     * The room is immediately removed from internal tracking to prevent infinite
+     * rejoin loops on reconnect, regardless of whether the server-side leave succeeds.
+     *
+     * @param room - The room identifier to leave
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomError if server-side leave fails
+     * @throws TransportRoomTimeoutError if leave operation times out
+     */
+    leaveRoom(room: string): Promise<void>;
+    /**
+     * Registers a handler for a specific event from the server.
+     * Multiple handlers can be registered for the same event.
+     *
+     * @remarks
+     * Lifecycle:
+     * - Can be called before connect() - handlers are queued and registered on connect
+     * - Handlers do NOT persist across disconnect/connect cycles
+     * - If disconnect() is called, all handlers are cleared
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to handle incoming events
+     * @returns Unsubscribe function to remove the handler
+     */
+    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
+    /**
+     * Registers a one-time handler for a specific event.
+     * The handler will be automatically removed after first invocation.
+     *
+     * @remarks
+     * Lifecycle:
+     * - Can be called before connect() - handlers are queued and registered on connect
+     * - Handlers do NOT persist across disconnect/connect cycles
+     * - If disconnect() is called before the event fires, queued handlers are cleared
+     *
+     * @param event - The event name to listen for
+     * @param handler - The function to handle the event
+     * @throws InvalidEventNameError if event name is invalid
+     * @throws MaxPendingOnceHandlersExceededError if max pending handlers exceeded while not connected
+     */
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Registers a handler for connection state changes.
+     *
+     * @remarks
+     * State handlers persist across disconnect/connect cycles until explicitly unsubscribed.
+     *
+     * @param handler - Called when connection state changes
+     * @returns Unsubscribe function to remove the handler
+     */
+    onStateChange(handler: ConnectionStateHandler): () => void;
+    /**
+     * Sends an event to the server (fire-and-forget or with callback).
+     * Similar to Socket.IO's emit() method.
+     *
+     * @example Fire-and-forget
+     * ```typescript
+     * client.request('log:entry', { level: 'info', message: 'Hello' })
+     * ```
+     *
+     * @example With acknowledgment callback
+     * ```typescript
+     * client.request('ping', {}, (response) => {
+     *   console.log('Server responded:', response)
+     * })
+     * ```
+     *
+     * @param event - The event name
+     * @param data - The request payload
+     * @param ack - Optional callback for server acknowledgment
+     * @throws TransportNotConnectedError if not connected
+     * @throws InvalidEventNameError if event name is invalid
+     */
+    request(event: string, data?: unknown): void;
+    request<T = unknown>(event: string, data: unknown, ack: (response: T) => void): void;
+    /**
+     * Promise-based request that waits for server response.
+     * Similar to Socket.IO's emitWithAck() method.
+     *
+     * @param event - The event name
+     * @param data - The request payload
+     * @param options - Request options (timeout, etc.)
+     * @returns Promise resolving to the server response
+     * @throws TransportNotConnectedError if not connected
+     * @throws InvalidEventNameError if event name is invalid
+     * @throws TransportRequestTimeoutError if request times out
+     * @throws TransportRequestError if server returns an error
+     *
+     * @example
+     * ```typescript
+     * // Request with typed response
+     * const user = await client.requestWithAck<User>('user:get', { id: '123' })
+     *
+     * // Request with custom timeout
+     * const result = await client.requestWithAck('slow:operation', data, { timeout: 30000 })
+     * ```
+     */
+    requestWithAck<TResponse = unknown, TRequest = unknown>(event: string, data?: TRequest, options?: RequestOptions): Promise<TResponse>;
+}
+//# sourceMappingURL=i-client.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAE,sBAAsB,EAAC,MAAM,yBAAyB,CAAA;AACpF,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAGzD,YAAY,EAAC,eAAe,EAAE,sBAAsB,EAAC,MAAM,yBAAyB,CAAA;AACpF,YAAY,EAAC,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAE3B;;;OAGG;IACH,WAAW,IAAI,MAAM,GAAG,SAAS,CAAA;IAEjC;;OAEG;IACH,QAAQ,IAAI,eAAe,CAAA;IAE3B;;;;;OAKG;IACH,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEjD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAErC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtC;;;;;;;;;;;;;OAaG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAA;IAEpE;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;IAEhE;;;;;;;;OAQG;IACH,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAAA;IAE1D;;;;;;;;;;;;;;;;;;;;;OAqBG;IAEH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAE5C,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;IAEpF;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,cAAc,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EACpD,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,QAAQ,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,SAAS,CAAC,CAAA;CACtB"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-client.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-client.js","sourceRoot":"","sources":["../../../core/interfaces/i-client.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-connection-state.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Possible connection states.
+ */
+export type ConnectionState = 'connected' | 'connecting' | 'disconnected' | 'reconnecting';
+/**
+ * Handler function for connection state changes.
+ */
+export type ConnectionStateHandler = (state: ConnectionState) => void;
+/**
+ * Read-only interface for observing connection state.
+ * Use this interface for components that only need to read state,
+ * following Interface Segregation Principle (ISP).
+ *
+ * @remarks
+ * State handlers persist across disconnect/connect cycles.
+ * Use the returned unsubscribe function to remove handlers.
+ */
+export interface IConnectionStateReader {
+    /**
+     * Gets the current connection state.
+     * @returns Current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Registers a handler for connection state changes.
+     * @param handler - Function to call when state changes
+     * @returns Unsubscribe function to remove the handler
+     */
+    onStateChange(handler: ConnectionStateHandler): () => void;
+}
+/**
+ * Interface for managing connection state.
+ * Extends IConnectionStateReader with mutation capabilities.
+ * Follows Observer Pattern for state change notifications.
+ *
+ * @remarks
+ * Use IConnectionStateReader for components that only observe state.
+ * Use IConnectionStateManager for components that control state.
+ */
+export interface IConnectionStateManager extends IConnectionStateReader {
+    /**
+     * Updates the connection state and notifies handlers.
+     * @param newState - The new connection state
+     * @throws {InvalidStateTransitionError} If the transition is not allowed
+     */
+    setState(newState: ConnectionState): void;
+    /**
+     * Clears all state handlers.
+     */
+    clearHandlers(): void;
+    /**
+     * Checks if transition to a new state is valid from current state.
+     * @param newState - The target state
+     * @returns True if transition is allowed
+     */
+    canTransitionTo(newState: ConnectionState): boolean;
+    /**
+     * Checks if currently connected.
+     * @returns True if state is 'connected'
+     */
+    isConnected(): boolean;
+    /**
+     * Checks if currently connecting.
+     * @returns True if state is 'connecting'
+     */
+    isConnecting(): boolean;
+    /**
+     * Checks if currently disconnected.
+     * @returns True if state is 'disconnected'
+     */
+    isDisconnected(): boolean;
+    /**
+     * Checks if currently reconnecting.
+     * @returns True if state is 'reconnecting'
+     */
+    isReconnecting(): boolean;
+}
+//# sourceMappingURL=i-connection-state.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-connection-state.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-connection-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,cAAc,CAAA;AAE1F;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;AAErE;;;;;;;;GAQG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,IAAI,eAAe,CAAA;IAE3B;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAAA;CAC3D;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;IAEzC;;OAEG;IACH,aAAa,IAAI,IAAI,CAAA;IAErB;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAA;IAEnD;;;OAGG;IACH,WAAW,IAAI,OAAO,CAAA;IAEtB;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAA;IAEvB;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAA;IAEzB;;;OAGG;IACH,cAAc,IAAI,OAAO,CAAA;CAC1B"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-connection-state.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-connection-state.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-connection-state.js","sourceRoot":"","sources":["../../../core/interfaces/i-connection-state.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-event-dispatcher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Handler function for events.
+ */
+export type EventHandler<T = unknown> = (data: T) => void;
+/**
+ * Public interface for managing event subscriptions.
+ * Follows Observer Pattern for event handling.
+ *
+ * @remarks
+ * This interface exposes only what consumers need.
+ * Handlers can be registered before connection is established.
+ * Implementations should queue handlers and register them on connect.
+ */
+export interface IEventDispatcher {
+    /**
+     * Registers a persistent event handler.
+     * Handler persists across reconnects until explicitly unsubscribed.
+     *
+     * @param event - Event name to listen for
+     * @param handler - Function to call when event is received
+     * @returns Unsubscribe function to remove the handler
+     */
+    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
+    /**
+     * Registers a one-time event handler.
+     * Handler is automatically removed after first invocation.
+     *
+     * @param event - Event name to listen for
+     * @param handler - Function to call when event is received
+     */
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+}
+//# sourceMappingURL=i-event-dispatcher.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-event-dispatcher.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-event-dispatcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAA;AAEzD;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAA;IAEpE;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAA;CACjE"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-event-dispatcher.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-event-dispatcher.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-event-dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-event-dispatcher.js","sourceRoot":"","sources":["../../../core/interfaces/i-event-dispatcher.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-force-reconnect-manager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Interface for force reconnection management.
+ *
+ * Manages reconnection attempts after the built-in reconnection mechanism gives up.
+ * Follows Interface Segregation Principle (ISP) by exposing only essential operations.
+ */
+export interface IForceReconnectManager {
+    /**
+     * Returns whether a reconnection is currently scheduled.
+     */
+    readonly isScheduled: boolean;
+    /**
+     * Returns the current attempt count.
+     */
+    readonly attemptCount: number;
+    /**
+     * Schedules the next force reconnect attempt.
+     * If already scheduled, this is a no-op.
+     */
+    schedule(): void;
+    /**
+     * Clears the scheduled timer without resetting the attempt counter.
+     * Useful when connection succeeds externally.
+     */
+    clearTimer(): void;
+    /**
+     * Cancels force reconnection completely (timer + counter).
+     * Resets the reconnection strategy state.
+     */
+    cancel(): void;
+    /**
+     * Resets the attempt counter and strategy state.
+     * Call this after a successful connection.
+     */
+    reset(): void;
+    /**
+     * Restarts force reconnection from attempt 0.
+     * Useful after wake from sleep.
+     */
+    restart(): void;
+}
+//# sourceMappingURL=i-force-reconnect-manager.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-force-reconnect-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-force-reconnect-manager.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-force-reconnect-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAE7B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAE7B;;;OAGG;IACH,QAAQ,IAAI,IAAI,CAAA;IAEhB;;;OAGG;IACH,UAAU,IAAI,IAAI,CAAA;IAElB;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAA;IAEd;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAA;CAChB"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-force-reconnect-manager.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-force-reconnect-manager.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-force-reconnect-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-force-reconnect-manager.js","sourceRoot":"","sources":["../../../core/interfaces/i-force-reconnect-manager.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-discovery.d.ts

@@ -0,0 +1,45 @@
+import type { InstanceInfo } from '../domain/entities/instance-info.js';
+/**
+ * Result of instance discovery.
+ *
+ * - no_instance: No .brv/ directory found in tree
+ * - instance_crashed: Found instance.json but pid is dead
+ */
+export type DiscoveryResult = {
+    found: false;
+    reason: 'instance_crashed' | 'no_instance';
+} | {
+    found: true;
+    instance: InstanceInfo;
+    projectRoot: string;
+};
+/**
+ * Interface for discovering running instances via walk-up directory search.
+ *
+ * Walk up directory tree to find .brv/instance.json, verify pid alive.
+ */
+export interface IInstanceDiscovery {
+    /**
+     * Discovers a running instance starting from the given directory.
+     *
+     * Walk-up algorithm:
+     * 1. Start from `fromDir`
+     * 2. Check if .brv/instance.json exists
+     * 3. If yes, verify pid is alive
+     * 4. If no, walk up to parent directory
+     * 5. Repeat until root or found
+     *
+     * @param fromDir - Starting directory (usually cwd)
+     * @returns DiscoveryResult with instance info and project root if found
+     */
+    discover: (fromDir: string) => Promise<DiscoveryResult>;
+    /**
+     * Finds the project root by walking up from a directory.
+     * Returns the directory containing .brv/ or undefined if not found.
+     *
+     * @param fromDir - Starting directory
+     * @returns Project root path or undefined
+     */
+    findProjectRoot: (fromDir: string) => Promise<string | undefined>;
+}
+//# sourceMappingURL=i-instance-discovery.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-instance-discovery.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-instance-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qCAAqC,CAAA;AAErE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,aAAa,CAAA;CAAC,GAC1D;IAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAC,CAAA;AAE9D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAEvD;;;;;;OAMG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAClE"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-discovery.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-instance-discovery.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-instance-discovery.js","sourceRoot":"","sources":["../../../core/interfaces/i-instance-discovery.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-reader.d.ts

@@ -0,0 +1,19 @@
+import type { InstanceInfo } from '../domain/entities/instance-info.js';
+/**
+ * Read-only interface for loading instance information.
+ *
+ * This is a subset of IInstanceManager that only exposes the load() method,
+ * following the Interface Segregation Principle. The socket-io-client component
+ * only needs to READ instance.json, not write or manage it.
+ */
+export interface IInstanceReader {
+    /**
+     * Reads instance info from the project root.
+     * Returns undefined if instance.json doesn't exist or is invalid.
+     *
+     * @param projectRoot - Root directory containing .brv/
+     * @returns Instance info or undefined if not found/invalid
+     */
+    load(projectRoot: string): Promise<InstanceInfo | undefined>;
+}
+//# sourceMappingURL=i-instance-reader.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-instance-reader.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-instance-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qCAAqC,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAA;CAC7D"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-reader.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-instance-reader.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-instance-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-instance-reader.js","sourceRoot":"","sources":["../../../core/interfaces/i-instance-reader.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-reconnection-strategy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Strategy interface for handling reconnection logic.
+ * Follows Strategy Pattern for flexibility in reconnection behavior.
+ *
+ * @remarks
+ * Implementations should be stateless or manage their own state.
+ * The TransportClient delegates reconnection decisions to this strategy.
+ */
+export interface IReconnectionStrategy {
+    /**
+     * Gets the delay before the next reconnection attempt.
+     * @param attempt - Current attempt number (0-based)
+     * @returns Delay in milliseconds, or undefined to stop retrying
+     */
+    getDelay(attempt: number): number | undefined;
+    /**
+     * Resets the strategy state (e.g., attempt counter).
+     */
+    reset(): void;
+    /**
+     * Checks if reconnection should continue.
+     * @param attempt - Current attempt number
+     * @returns true if should continue, false to give up
+     */
+    shouldContinue(attempt: number): boolean;
+}
+//# sourceMappingURL=i-reconnection-strategy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i-reconnection-strategy.d.ts","sourceRoot":"","sources":["../../../core/interfaces/i-reconnection-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAE7C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAA;IAEb;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CACzC"}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-reconnection-strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i-reconnection-strategy.js.map

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-reconnection-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-reconnection-strategy.js","sourceRoot":"","sources":["../../../core/interfaces/i-reconnection-strategy.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/core/interfaces/i-room-manager.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Public interface for managing room subscriptions.
+ * Handles join and leave operations.
+ *
+ * @remarks
+ * Room operations require an active connection.
+ * This interface exposes only what consumers need.
+ */
+export interface IRoomManager {
+    /**
+     * Joins a room for targeted broadcasts.
+     * @param room - Room identifier to join
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomError if join fails
+     * @throws TransportRoomTimeoutError if join times out
+     */
+    joinRoom(room: string): Promise<void>;
+    /**
+     * Leaves a previously joined room.
+     * @param room - Room identifier to leave
+     * @throws TransportNotConnectedError if not connected
+     * @throws TransportRoomError if leave fails
+     * @throws TransportRoomTimeoutError if leave times out
+     */
+    leaveRoom(room: string): Promise<void>;
+    /**
+     * Gets the set of currently joined rooms.
+     * @returns Set of room identifiers
+     */
+    getJoinedRooms(): ReadonlySet<string>;
+}
+//# sourceMappingURL=i-room-manager.d.ts.map