@jacques-ai/server 0.0.7-alpha.1

package/dist/server.js

@@ -0,0 +1,173 @@
+/**
+ * Jacques Server
+ *
+ * Standalone entry point for the Jacques server.
+ * Uses the embeddable server module for the actual implementation.
+ */
+import { startEmbeddedServer } from './start-server.js';
+import { writeFileSync, unlinkSync, existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createServer, connect } from 'net';
+const PID_FILE = join(homedir(), '.jacques', 'server.pid');
+const SOCKET_PATH = '/tmp/jacques.sock';
+const WS_PORT = parseInt(process.env.JACQUES_WS_PORT || '4242', 10);
+const HTTP_PORT = parseInt(process.env.JACQUES_HTTP_PORT || '4243', 10);
+let server = null;
+/**
+ * Write PID file for process management
+ */
+function writePidFile() {
+    try {
+        const dir = join(homedir(), '.jacques');
+        if (!existsSync(dir)) {
+            const { mkdirSync } = require('fs');
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(PID_FILE, String(process.pid));
+    }
+    catch (err) {
+        console.error(`[Server] Warning: Could not write PID file: ${err}`);
+    }
+}
+/**
+ * Remove PID file on shutdown
+ */
+function removePidFile() {
+    try {
+        if (existsSync(PID_FILE)) {
+            unlinkSync(PID_FILE);
+        }
+    }
+    catch {
+        // Ignore errors when removing PID file
+    }
+}
+/**
+ * Check if a Unix socket has an active listener
+ */
+function isSocketAlive(path) {
+    return new Promise((resolve) => {
+        const client = connect({ path }, () => {
+            client.end();
+            resolve(true);
+        });
+        client.on('error', () => resolve(false));
+        const timeout = setTimeout(() => { client.destroy(); resolve(false); }, 1000);
+        client.on('close', () => clearTimeout(timeout));
+    });
+}
+/**
+ * Check if a TCP port is available
+ */
+function isPortFree(port) {
+    return new Promise((resolve) => {
+        const srv = createServer();
+        srv.once('error', () => resolve(false));
+        srv.once('listening', () => {
+            srv.close(() => resolve(true));
+        });
+        srv.listen(port);
+    });
+}
+/**
+ * Pre-flight: ensure no other Jacques server is running
+ */
+async function ensureServerNotRunning() {
+    // 1. Check PID file
+    if (existsSync(PID_FILE)) {
+        try {
+            const pid = parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+            if (!isNaN(pid)) {
+                try {
+                    process.kill(pid, 0); // Throws if process doesn't exist
+                    console.error(`[Server] Jacques server already running (PID: ${pid}).`);
+                    console.error(`[Server] Stop it first: npm run stop:server`);
+                    process.exit(1);
+                }
+                catch {
+                    // Process doesn't exist — stale PID file
+                    unlinkSync(PID_FILE);
+                }
+            }
+        }
+        catch {
+            // Can't read PID file — remove it
+            try {
+                unlinkSync(PID_FILE);
+            }
+            catch { /* ignore */ }
+        }
+    }
+    // 2. Check if socket is actively listened on
+    if (existsSync(SOCKET_PATH)) {
+        if (await isSocketAlive(SOCKET_PATH)) {
+            console.error(`[Server] Another server is listening on ${SOCKET_PATH}.`);
+            console.error(`[Server] Stop it first: npm run stop:server`);
+            process.exit(1);
+        }
+        // Stale socket — will be cleaned up by UnixSocketServer.start()
+    }
+    // 3. Check port availability
+    for (const port of [WS_PORT, HTTP_PORT]) {
+        if (!(await isPortFree(port))) {
+            console.error(`[Server] Port ${port} is already in use.`);
+            console.error(`[Server] Stop the existing server: npm run stop:server`);
+            process.exit(1);
+        }
+    }
+}
+/**
+ * Start the server
+ */
+async function start() {
+    console.log('');
+    console.log('╔═══════════════════════════════════════════════════════╗');
+    console.log('║         JACQUES - Claude Code Context Monitor          ║');
+    console.log('╚═══════════════════════════════════════════════════════╝');
+    console.log('');
+    // Pre-flight: ensure no other server is running
+    await ensureServerNotRunning();
+    try {
+        // Write PID file for process management
+        writePidFile();
+        console.log(`[Server] PID: ${process.pid} (written to ${PID_FILE})`);
+        server = await startEmbeddedServer({ silent: false });
+        console.log('[Server] Waiting for Claude Code sessions...');
+        console.log('[Server] Press Ctrl+C to stop');
+        console.log('');
+    }
+    catch (err) {
+        console.error(`[Server] Failed to start: ${err}`);
+        removePidFile();
+        process.exit(1);
+    }
+}
+/**
+ * Graceful shutdown
+ */
+async function shutdown() {
+    console.log('');
+    if (server) {
+        await server.stop();
+    }
+    // Clean up PID file
+    removePidFile();
+    process.exit(0);
+}
+// Register shutdown handlers
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+// Handle uncaught errors
+process.on('uncaughtException', (err) => {
+    console.error(`[Server] Uncaught exception: ${err.message}`);
+    console.error(err.stack);
+    shutdown();
+});
+process.on('unhandledRejection', (reason) => {
+    console.error(`[Server] Unhandled rejection: ${reason}`);
+    shutdown();
+});
+// Start the server
+start();
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/services/branch-divergence-service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Branch Divergence Service
+ *
+ * Periodically computes ahead/behind counts and dirty status for all active sessions.
+ * Groups by (repoRoot, branch) to avoid duplicate git calls for sessions on the same branch.
+ */
+import type { Session } from '../types.js';
+import type { Logger } from '../logging/logger-factory.js';
+export interface BranchDivergenceServiceOptions {
+    getAllSessions: () => Session[];
+    broadcastSessionUpdate: (session: Session) => void;
+    logger?: Logger;
+}
+export declare class BranchDivergenceService {
+    private interval;
+    private debounceTimer;
+    private checking;
+    private getAllSessions;
+    private broadcastSessionUpdate;
+    private logger;
+    private static readonly DEBOUNCE_MS;
+    /** Cache of default branch per repo root (cleared each cycle) */
+    private defaultBranchCache;
+    constructor(options: BranchDivergenceServiceOptions);
+    /**
+     * Start periodic divergence checking.
+     */
+    start(intervalMs?: number): void;
+    /**
+     * Stop periodic checking.
+     */
+    stop(): void;
+    /**
+     * Schedule a debounced divergence check.
+     * Multiple calls within DEBOUNCE_MS coalesce into one check.
+     */
+    scheduleCheck(): void;
+    /**
+     * Run a single divergence check across all active sessions.
+     */
+    private check;
+    private runCheck;
+    /**
+     * Get default branch for a repo, with per-cycle caching.
+     */
+    private getDefaultBranch;
+}
+//# sourceMappingURL=branch-divergence-service.d.ts.map

package/dist/services/branch-divergence-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-divergence-service.d.ts","sourceRoot":"","sources":["../../src/services/branch-divergence-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAM3D,MAAM,WAAW,8BAA8B;IAC7C,cAAc,EAAE,MAAM,OAAO,EAAE,CAAC;IAChC,sBAAsB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,MAAM,CAAS;IAEvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAE3C,iEAAiE;IACjE,OAAO,CAAC,kBAAkB,CAA6B;gBAE3C,OAAO,EAAE,8BAA8B;IAMnD;;OAEG;IACH,KAAK,CAAC,UAAU,GAAE,MAAsC,GAAG,IAAI;IAkB/D;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACH,aAAa,IAAI,IAAI;IAYrB;;OAEG;YACW,KAAK;YAUL,QAAQ;IAoEtB;;OAEG;YACW,gBAAgB;CAQ/B"}

package/dist/services/branch-divergence-service.js

@@ -0,0 +1,156 @@
+/**
+ * Branch Divergence Service
+ *
+ * Periodically computes ahead/behind counts and dirty status for all active sessions.
+ * Groups by (repoRoot, branch) to avoid duplicate git calls for sessions on the same branch.
+ */
+import { createLogger } from '../logging/logger-factory.js';
+import { computeBranchDivergence, checkDirtyStatus } from '@jacques-ai/core';
+import { detectDefaultBranch } from '../connection/worktree.js';
+import { BRANCH_DIVERGENCE_INTERVAL_MS } from '../connection/constants.js';
+export class BranchDivergenceService {
+    interval = null;
+    debounceTimer = null;
+    checking = false;
+    getAllSessions;
+    broadcastSessionUpdate;
+    logger;
+    static DEBOUNCE_MS = 3000;
+    /** Cache of default branch per repo root (cleared each cycle) */
+    defaultBranchCache = new Map();
+    constructor(options) {
+        this.getAllSessions = options.getAllSessions;
+        this.broadcastSessionUpdate = options.broadcastSessionUpdate;
+        this.logger = options.logger ?? createLogger({ silent: true });
+    }
+    /**
+     * Start periodic divergence checking.
+     */
+    start(intervalMs = BRANCH_DIVERGENCE_INTERVAL_MS) {
+        if (this.interval)
+            return;
+        // Run immediately
+        this.check().catch((err) => {
+            this.logger.warn(`[Divergence] Check failed: ${err}`);
+        });
+        // Then periodically
+        this.interval = setInterval(() => {
+            this.check().catch((err) => {
+                this.logger.warn(`[Divergence] Check failed: ${err}`);
+            });
+        }, intervalMs);
+        this.logger.log(`[Divergence] Started (interval: ${intervalMs / 1000}s)`);
+    }
+    /**
+     * Stop periodic checking.
+     */
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+    }
+    /**
+     * Schedule a debounced divergence check.
+     * Multiple calls within DEBOUNCE_MS coalesce into one check.
+     */
+    scheduleCheck() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.check().catch((err) => {
+                this.logger.warn(`[Divergence] Scheduled check failed: ${err}`);
+            });
+        }, BranchDivergenceService.DEBOUNCE_MS);
+    }
+    /**
+     * Run a single divergence check across all active sessions.
+     */
+    async check() {
+        if (this.checking)
+            return;
+        this.checking = true;
+        try {
+            await this.runCheck();
+        }
+        finally {
+            this.checking = false;
+        }
+    }
+    async runCheck() {
+        const sessions = this.getAllSessions();
+        if (sessions.length === 0)
+            return;
+        // Clear default branch cache each cycle
+        this.defaultBranchCache.clear();
+        // Group sessions by (repoRoot, branch) for divergence
+        const divergenceGroups = new Map();
+        // Group sessions by cwd for dirty status
+        const dirtyGroups = new Map();
+        for (const session of sessions) {
+            if (session.git_repo_root && session.git_branch) {
+                const key = `${session.git_repo_root}\0${session.git_branch}`;
+                const group = divergenceGroups.get(key) || [];
+                group.push(session);
+                divergenceGroups.set(key, group);
+            }
+            if (session.cwd) {
+                const group = dirtyGroups.get(session.cwd) || [];
+                group.push(session);
+                dirtyGroups.set(session.cwd, group);
+            }
+        }
+        // Compute divergence per unique (repoRoot, branch)
+        for (const [key, groupSessions] of divergenceGroups) {
+            const [repoRoot, branch] = key.split('\0');
+            const defaultBranch = await this.getDefaultBranch(repoRoot);
+            // Skip if this IS the default branch
+            if (branch === defaultBranch) {
+                for (const session of groupSessions) {
+                    if (session.git_ahead !== 0 || session.git_behind !== 0) {
+                        session.git_ahead = 0;
+                        session.git_behind = 0;
+                        this.broadcastSessionUpdate(session);
+                    }
+                }
+                continue;
+            }
+            const { ahead, behind } = await computeBranchDivergence(repoRoot, branch, defaultBranch);
+            for (const session of groupSessions) {
+                if (session.git_ahead !== ahead || session.git_behind !== behind) {
+                    session.git_ahead = ahead;
+                    session.git_behind = behind;
+                    this.broadcastSessionUpdate(session);
+                }
+            }
+        }
+        // Compute dirty status per unique cwd
+        for (const [cwd, groupSessions] of dirtyGroups) {
+            const dirty = await checkDirtyStatus(cwd);
+            for (const session of groupSessions) {
+                if (session.git_dirty !== dirty) {
+                    session.git_dirty = dirty;
+                    this.broadcastSessionUpdate(session);
+                }
+            }
+        }
+    }
+    /**
+     * Get default branch for a repo, with per-cycle caching.
+     */
+    async getDefaultBranch(repoRoot) {
+        const cached = this.defaultBranchCache.get(repoRoot);
+        if (cached)
+            return cached;
+        const branch = await detectDefaultBranch(repoRoot);
+        this.defaultBranchCache.set(repoRoot, branch);
+        return branch;
+    }
+}
+//# sourceMappingURL=branch-divergence-service.js.map

package/dist/services/branch-divergence-service.js.map

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

package/dist/services/broadcast-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Broadcast Service
+ *
+ * Unified broadcasting service that combines session updates
+ * with focus change notifications. Eliminates repeated broadcast
+ * patterns in event handlers.
+ */
+import type { Session } from '../types.js';
+import type { JacquesWebSocketServer } from '../websocket.js';
+import type { SessionRegistry } from '../session-registry.js';
+import type { Logger } from '../logging/logger-factory.js';
+/**
+ * Configuration for the BroadcastService
+ */
+export interface BroadcastServiceConfig {
+    /** WebSocket server for broadcasting */
+    wsServer: JacquesWebSocketServer;
+    /** Session registry for focus information */
+    registry: SessionRegistry;
+    /** Optional logger */
+    logger?: Logger;
+}
+/**
+ * BroadcastService - handles unified session and focus broadcasting
+ *
+ * Instead of calling:
+ *   wsServer.broadcastSessionUpdate(session);
+ *   broadcastFocusChange();
+ *
+ * Use:
+ *   broadcastService.broadcastSessionWithFocus(session);
+ */
+export declare class BroadcastService {
+    private wsServer;
+    private registry;
+    private logger;
+    private lastBroadcastedFocusId;
+    constructor(config: BroadcastServiceConfig);
+    /**
+     * Broadcast a session update along with focus change
+     *
+     * @param session The session that was updated
+     */
+    broadcastSessionWithFocus(session: Session): void;
+    /**
+     * Broadcast session removal along with focus change
+     *
+     * @param sessionId The ID of the removed session
+     */
+    broadcastSessionRemovedWithFocus(sessionId: string): void;
+    /**
+     * Broadcast only the session update (no focus change)
+     *
+     * Use when focus should not be affected (e.g., idle status)
+     *
+     * @param session The session that was updated
+     */
+    broadcastSessionUpdate(session: Session): void;
+    /**
+     * Broadcast only the focus change (skips if focus hasn't changed)
+     */
+    broadcastFocusChange(): void;
+    /**
+     * Force broadcast focus change (used when focus must be re-sent, e.g. session removal)
+     */
+    forceBroadcastFocusChange(): void;
+}
+//# sourceMappingURL=broadcast-service.d.ts.map

package/dist/services/broadcast-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-service.d.ts","sourceRoot":"","sources":["../../src/services/broadcast-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,sBAAsB,CAAwC;gBAE1D,MAAM,EAAE,sBAAsB;IAM1C;;;;OAIG;IACH,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjD;;;;OAIG;IACH,gCAAgC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzD;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAQ5B;;OAEG;IACH,yBAAyB,IAAI,IAAI;CAMlC"}

package/dist/services/broadcast-service.js

@@ -0,0 +1,78 @@
+/**
+ * Broadcast Service
+ *
+ * Unified broadcasting service that combines session updates
+ * with focus change notifications. Eliminates repeated broadcast
+ * patterns in event handlers.
+ */
+import { createLogger } from '../logging/logger-factory.js';
+/**
+ * BroadcastService - handles unified session and focus broadcasting
+ *
+ * Instead of calling:
+ *   wsServer.broadcastSessionUpdate(session);
+ *   broadcastFocusChange();
+ *
+ * Use:
+ *   broadcastService.broadcastSessionWithFocus(session);
+ */
+export class BroadcastService {
+    wsServer;
+    registry;
+    logger;
+    lastBroadcastedFocusId = undefined;
+    constructor(config) {
+        this.wsServer = config.wsServer;
+        this.registry = config.registry;
+        this.logger = config.logger ?? createLogger({ silent: true });
+    }
+    /**
+     * Broadcast a session update along with focus change
+     *
+     * @param session The session that was updated
+     */
+    broadcastSessionWithFocus(session) {
+        this.wsServer.broadcastSessionUpdate(session);
+        this.broadcastFocusChange();
+    }
+    /**
+     * Broadcast session removal along with focus change
+     *
+     * @param sessionId The ID of the removed session
+     */
+    broadcastSessionRemovedWithFocus(sessionId) {
+        this.wsServer.broadcastSessionRemoved(sessionId);
+        this.forceBroadcastFocusChange();
+    }
+    /**
+     * Broadcast only the session update (no focus change)
+     *
+     * Use when focus should not be affected (e.g., idle status)
+     *
+     * @param session The session that was updated
+     */
+    broadcastSessionUpdate(session) {
+        this.wsServer.broadcastSessionUpdate(session);
+    }
+    /**
+     * Broadcast only the focus change (skips if focus hasn't changed)
+     */
+    broadcastFocusChange() {
+        const focusedId = this.registry.getFocusedSessionId();
+        if (focusedId === this.lastBroadcastedFocusId)
+            return;
+        this.lastBroadcastedFocusId = focusedId;
+        const focusedSession = focusedId ? this.registry.getSession(focusedId) ?? null : null;
+        this.wsServer.broadcastFocusChange(focusedId, focusedSession);
+    }
+    /**
+     * Force broadcast focus change (used when focus must be re-sent, e.g. session removal)
+     */
+    forceBroadcastFocusChange() {
+        const focusedId = this.registry.getFocusedSessionId();
+        this.lastBroadcastedFocusId = focusedId;
+        const focusedSession = focusedId ? this.registry.getSession(focusedId) ?? null : null;
+        this.wsServer.broadcastFocusChange(focusedId, focusedSession);
+    }
+}
+//# sourceMappingURL=broadcast-service.js.map

package/dist/services/broadcast-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-service.js","sourceRoot":"","sources":["../../src/services/broadcast-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAc5D;;;;;;;;;GASG;AACH,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAyB;IACjC,QAAQ,CAAkB;IAC1B,MAAM,CAAS;IACf,sBAAsB,GAA8B,SAAS,CAAC;IAEtE,YAAY,MAA8B;QACxC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,yBAAyB,CAAC,OAAgB;QACxC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,gCAAgC,CAAC,SAAiB;QAChD,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,yBAAyB,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;OAMG;IACH,sBAAsB,CAAC,OAAgB;QACrC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QACtD,IAAI,SAAS,KAAK,IAAI,CAAC,sBAAsB;YAAE,OAAO;QACtD,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;QACxC,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,yBAAyB;QACvB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QACtD,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;QACxC,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACtF,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/services/broadcast-service.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Broadcast Service Tests
+ */
+export {};
+//# sourceMappingURL=broadcast-service.test.d.ts.map

package/dist/services/broadcast-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broadcast-service.test.d.ts","sourceRoot":"","sources":["../../src/services/broadcast-service.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}