timeback-studio 0.1.7 → 0.1.8

package/dist/bin.js

@@ -22937,6 +22937,7 @@ function createLogger(options = {}) {
 }
 // src/server/services/bootstrap.ts
 var log = createLogger({ scope: "studio:service:bootstrap" });
+var hasLoggedInitialLoad = false;
 
 class BootstrapService {
   client;
@@ -22967,8 +22968,11 @@ class BootstrapService {
       stats,
       errors: errors3.length
     });
-    const message = `Loaded ${underline(stats.totalCourses)} ${pluralize(stats.totalCourses, "course")}, ${underline(stats.totalStudents)} ${pluralize(stats.totalStudents, "student")}`;
-    M2.success(message);
+    if (!hasLoggedInitialLoad) {
+      const message = `Loaded ${underline(stats.totalCourses)} ${pluralize(stats.totalCourses, "course")}, ${underline(stats.totalStudents)} ${pluralize(stats.totalStudents, "student")}`;
+      M2.success(message);
+      hasLoggedInitialLoad = true;
+    }
     return {
       user,
       courses,
@@ -23448,48 +23452,107 @@ class EventsService {
     return result;
   }
 }
-// src/server/services/live.ts
-var log4 = createLogger({ scope: "studio:service:live" });
+// src/server/services/live-poller.ts
+var log4 = createLogger({ scope: "studio:service:live-poller" });
+var pollers = new Map;
+function getOrCreatePoller(environment, statusService, eventsService) {
+  let poller = pollers.get(environment);
+  if (!poller) {
+    poller = new LivePoller({ environment, statusService, eventsService });
+    pollers.set(environment, poller);
+  }
+  return poller;
+}
 
-class LiveService {
+class LivePoller {
+  environment;
   statusService;
   eventsService;
+  subscribers = new Set;
+  interval = null;
+  state;
+  lastBroadcast;
+  initialTickPromise = null;
+  ticking = false;
   constructor(options) {
+    this.environment = options.environment;
     this.statusService = options.statusService;
     this.eventsService = options.eventsService;
-  }
-  static createInitialState() {
     const now = Date.now();
-    return {
+    this.state = {
       lastStatusHash: "",
       lastEventTime: new Date().toISOString(),
       lastStatusTick: now,
       lastEventsTick: now
     };
   }
-  async tick(state) {
-    const updates = [];
-    const now = Date.now();
-    const newState = { ...state };
-    const statusUpdate = await this.fetchStatusIfChanged(state.lastStatusHash);
-    if (statusUpdate) {
-      updates.push(statusUpdate.update);
-      newState.lastStatusHash = statusUpdate.hash;
+  subscribe(callback) {
+    this.subscribers.add(callback);
+    if (this.subscribers.size === 1) {
+      this.start();
     }
-    newState.lastStatusTick = now;
-    const shouldCheckEvents = this.hasIntervalElapsed(state.lastEventsTick, now, constants.events.polling.tickIntervalMs);
-    if (shouldCheckEvents) {
-      const eventsUpdate = await this.fetchEventsIfNew(state.lastEventTime);
-      if (eventsUpdate) {
-        updates.push(eventsUpdate.update);
-        newState.lastEventTime = eventsUpdate.newEventTime;
+    return () => {
+      this.subscribers.delete(callback);
+      if (this.subscribers.size === 0) {
+        this.stop();
+        pollers.delete(this.environment);
       }
-      newState.lastEventsTick = now;
+    };
+  }
+  async getLastBroadcastAfterInitialTick() {
+    if (this.initialTickPromise) {
+      await this.initialTickPromise;
     }
-    return { updates, newState };
+    return this.lastBroadcast;
   }
-  hasIntervalElapsed(lastTick, now, intervalMs) {
-    return now - lastTick >= intervalMs;
+  start() {
+    log4.debug("Poller started", { environment: this.environment });
+    this.initialTickPromise = this.tick();
+    this.interval = setInterval(() => this.tick(), constants.sse.defaultTickIntervalMs);
+  }
+  stop() {
+    if (this.interval) {
+      clearInterval(this.interval);
+      this.interval = null;
+    }
+    this.lastBroadcast = undefined;
+    this.initialTickPromise = null;
+    log4.debug("Poller stopped", { environment: this.environment });
+  }
+  async tick() {
+    if (this.ticking)
+      return;
+    this.ticking = true;
+    try {
+      const updates = [];
+      const now = Date.now();
+      const statusUpdate = await this.fetchStatusIfChanged(this.state.lastStatusHash);
+      if (statusUpdate) {
+        updates.push(statusUpdate.update);
+        this.state.lastStatusHash = statusUpdate.hash;
+      }
+      this.state.lastStatusTick = now;
+      const shouldCheckEvents = now - this.state.lastEventsTick >= constants.events.polling.tickIntervalMs;
+      if (shouldCheckEvents) {
+        const eventsUpdate = await this.fetchEventsIfNew(this.state.lastEventTime);
+        if (eventsUpdate) {
+          updates.push(eventsUpdate.update);
+          this.state.lastEventTime = eventsUpdate.newEventTime;
+        }
+        this.state.lastEventsTick = now;
+      }
+      if (updates.length > 0) {
+        const data = JSON.stringify(updates);
+        this.lastBroadcast = data;
+        for (const callback of this.subscribers) {
+          callback(data);
+        }
+      }
+    } catch (error48) {
+      log4.error("Tick failed", { environment: this.environment, error: error48 });
+    } finally {
+      this.ticking = false;
+    }
   }
   async fetchStatusIfChanged(lastHash) {
     try {
@@ -23516,7 +23579,8 @@ class LiveService {
       }
       const message = `${underline(newEvents.length)} new ${pluralize(newEvents.length, "event")}`;
       M2.message(message, { symbol: magenta("◆") });
-      const mostRecentTime = newEvents.map((e2) => e2.eventTime).sort().pop();
+      const mostRecentTime = newEvents.map((e2) => new Date(e2.eventTime).getTime()).sort((a, b3) => a - b3).pop();
+      const newEventTime = mostRecentTime === undefined ? lastEventTime : new Date(mostRecentTime + 1).toISOString();
       return {
         update: {
           type: "events",
@@ -23525,7 +23589,7 @@ class LiveService {
             timestamp: new Date().toISOString()
           }
         },
-        newEventTime: mostRecentTime ?? lastEventTime
+        newEventTime
       };
     } catch (error48) {
       log4.error("Failed to fetch events", { error: error48 });
@@ -23930,6 +23994,7 @@ function runSSE(c, options) {
     } catch {
       abort("write error");
     }
+    options.onClose?.();
     unregisterConnection(key, () => abort("superseded"));
     log8.debug("SSE connection closed", { ...meta3, reason: closeReason });
   });
@@ -24032,20 +24097,41 @@ function handleEventsStream(c) {
 }
 // src/server/controllers/live.ts
 function handleLive(c) {
+  const env2 = c.get("env");
   const { status: statusService, events: eventsService } = c.get("services");
-  const liveService = new LiveService({ statusService, eventsService });
-  let state = LiveService.createInitialState();
+  const poller = getOrCreatePoller(env2, statusService, eventsService);
+  let pending;
+  let isFirstTick = true;
+  const takePending = () => {
+    const data = pending;
+    pending = undefined;
+    return data;
+  };
+  const unsubscribe = poller.subscribe((data) => {
+    pending = data;
+  });
   return runSSE(c, {
     event: "live",
     intervalMs: constants.sse.defaultTickIntervalMs,
     sendInitial: true,
+    onClose: unsubscribe,
     tick: async () => {
-      const result = await liveService.tick(state);
-      state = result.newState;
-      if (result.updates.length === 0) {
-        return;
+      if (isFirstTick) {
+        isFirstTick = false;
+        const immediate = takePending();
+        if (immediate !== undefined) {
+          return immediate;
+        }
+        const initial = await poller.getLastBroadcastAfterInitialTick();
+        if (pending !== undefined && pending === initial) {
+          pending = undefined;
+        }
+        if (initial !== undefined) {
+          return initial;
+        }
+        return takePending();
       }
-      return JSON.stringify(result.updates);
+      return takePending();
     }
   });
 }

package/dist/index.js

@@ -20827,6 +20827,7 @@ function createLogger(options = {}) {
 }
 // src/server/services/bootstrap.ts
 var log = createLogger({ scope: "studio:service:bootstrap" });
+var hasLoggedInitialLoad = false;
 
 class BootstrapService {
   client;
@@ -20857,8 +20858,11 @@ class BootstrapService {
       stats,
       errors: errors3.length
     });
-    const message = `Loaded ${underline(stats.totalCourses)} ${pluralize(stats.totalCourses, "course")}, ${underline(stats.totalStudents)} ${pluralize(stats.totalStudents, "student")}`;
-    M2.success(message);
+    if (!hasLoggedInitialLoad) {
+      const message = `Loaded ${underline(stats.totalCourses)} ${pluralize(stats.totalCourses, "course")}, ${underline(stats.totalStudents)} ${pluralize(stats.totalStudents, "student")}`;
+      M2.success(message);
+      hasLoggedInitialLoad = true;
+    }
     return {
       user,
       courses,
@@ -21338,48 +21342,107 @@ class EventsService {
     return result;
   }
 }
-// src/server/services/live.ts
-var log4 = createLogger({ scope: "studio:service:live" });
+// src/server/services/live-poller.ts
+var log4 = createLogger({ scope: "studio:service:live-poller" });
+var pollers = new Map;
+function getOrCreatePoller(environment, statusService, eventsService) {
+  let poller = pollers.get(environment);
+  if (!poller) {
+    poller = new LivePoller({ environment, statusService, eventsService });
+    pollers.set(environment, poller);
+  }
+  return poller;
+}
 
-class LiveService {
+class LivePoller {
+  environment;
   statusService;
   eventsService;
+  subscribers = new Set;
+  interval = null;
+  state;
+  lastBroadcast;
+  initialTickPromise = null;
+  ticking = false;
   constructor(options) {
+    this.environment = options.environment;
     this.statusService = options.statusService;
     this.eventsService = options.eventsService;
-  }
-  static createInitialState() {
     const now = Date.now();
-    return {
+    this.state = {
       lastStatusHash: "",
       lastEventTime: new Date().toISOString(),
       lastStatusTick: now,
       lastEventsTick: now
     };
   }
-  async tick(state) {
-    const updates = [];
-    const now = Date.now();
-    const newState = { ...state };
-    const statusUpdate = await this.fetchStatusIfChanged(state.lastStatusHash);
-    if (statusUpdate) {
-      updates.push(statusUpdate.update);
-      newState.lastStatusHash = statusUpdate.hash;
+  subscribe(callback) {
+    this.subscribers.add(callback);
+    if (this.subscribers.size === 1) {
+      this.start();
     }
-    newState.lastStatusTick = now;
-    const shouldCheckEvents = this.hasIntervalElapsed(state.lastEventsTick, now, constants.events.polling.tickIntervalMs);
-    if (shouldCheckEvents) {
-      const eventsUpdate = await this.fetchEventsIfNew(state.lastEventTime);
-      if (eventsUpdate) {
-        updates.push(eventsUpdate.update);
-        newState.lastEventTime = eventsUpdate.newEventTime;
+    return () => {
+      this.subscribers.delete(callback);
+      if (this.subscribers.size === 0) {
+        this.stop();
+        pollers.delete(this.environment);
       }
-      newState.lastEventsTick = now;
+    };
+  }
+  async getLastBroadcastAfterInitialTick() {
+    if (this.initialTickPromise) {
+      await this.initialTickPromise;
     }
-    return { updates, newState };
+    return this.lastBroadcast;
   }
-  hasIntervalElapsed(lastTick, now, intervalMs) {
-    return now - lastTick >= intervalMs;
+  start() {
+    log4.debug("Poller started", { environment: this.environment });
+    this.initialTickPromise = this.tick();
+    this.interval = setInterval(() => this.tick(), constants.sse.defaultTickIntervalMs);
+  }
+  stop() {
+    if (this.interval) {
+      clearInterval(this.interval);
+      this.interval = null;
+    }
+    this.lastBroadcast = undefined;
+    this.initialTickPromise = null;
+    log4.debug("Poller stopped", { environment: this.environment });
+  }
+  async tick() {
+    if (this.ticking)
+      return;
+    this.ticking = true;
+    try {
+      const updates = [];
+      const now = Date.now();
+      const statusUpdate = await this.fetchStatusIfChanged(this.state.lastStatusHash);
+      if (statusUpdate) {
+        updates.push(statusUpdate.update);
+        this.state.lastStatusHash = statusUpdate.hash;
+      }
+      this.state.lastStatusTick = now;
+      const shouldCheckEvents = now - this.state.lastEventsTick >= constants.events.polling.tickIntervalMs;
+      if (shouldCheckEvents) {
+        const eventsUpdate = await this.fetchEventsIfNew(this.state.lastEventTime);
+        if (eventsUpdate) {
+          updates.push(eventsUpdate.update);
+          this.state.lastEventTime = eventsUpdate.newEventTime;
+        }
+        this.state.lastEventsTick = now;
+      }
+      if (updates.length > 0) {
+        const data = JSON.stringify(updates);
+        this.lastBroadcast = data;
+        for (const callback of this.subscribers) {
+          callback(data);
+        }
+      }
+    } catch (error48) {
+      log4.error("Tick failed", { environment: this.environment, error: error48 });
+    } finally {
+      this.ticking = false;
+    }
   }
   async fetchStatusIfChanged(lastHash) {
     try {
@@ -21406,7 +21469,8 @@ class LiveService {
       }
       const message = `${underline(newEvents.length)} new ${pluralize(newEvents.length, "event")}`;
       M2.message(message, { symbol: magenta("◆") });
-      const mostRecentTime = newEvents.map((e2) => e2.eventTime).sort().pop();
+      const mostRecentTime = newEvents.map((e2) => new Date(e2.eventTime).getTime()).sort((a, b3) => a - b3).pop();
+      const newEventTime = mostRecentTime === undefined ? lastEventTime : new Date(mostRecentTime + 1).toISOString();
       return {
         update: {
           type: "events",
@@ -21415,7 +21479,7 @@ class LiveService {
             timestamp: new Date().toISOString()
           }
         },
-        newEventTime: mostRecentTime ?? lastEventTime
+        newEventTime
       };
     } catch (error48) {
       log4.error("Failed to fetch events", { error: error48 });
@@ -21820,6 +21884,7 @@ function runSSE(c, options) {
     } catch {
       abort("write error");
     }
+    options.onClose?.();
     unregisterConnection(key, () => abort("superseded"));
     log8.debug("SSE connection closed", { ...meta3, reason: closeReason });
   });
@@ -21922,20 +21987,41 @@ function handleEventsStream(c) {
 }
 // src/server/controllers/live.ts
 function handleLive(c) {
+  const env2 = c.get("env");
   const { status: statusService, events: eventsService } = c.get("services");
-  const liveService = new LiveService({ statusService, eventsService });
-  let state = LiveService.createInitialState();
+  const poller = getOrCreatePoller(env2, statusService, eventsService);
+  let pending;
+  let isFirstTick = true;
+  const takePending = () => {
+    const data = pending;
+    pending = undefined;
+    return data;
+  };
+  const unsubscribe = poller.subscribe((data) => {
+    pending = data;
+  });
   return runSSE(c, {
     event: "live",
     intervalMs: constants.sse.defaultTickIntervalMs,
     sendInitial: true,
+    onClose: unsubscribe,
     tick: async () => {
-      const result = await liveService.tick(state);
-      state = result.newState;
-      if (result.updates.length === 0) {
-        return;
+      if (isFirstTick) {
+        isFirstTick = false;
+        const immediate = takePending();
+        if (immediate !== undefined) {
+          return immediate;
+        }
+        const initial = await poller.getLastBroadcastAfterInitialTick();
+        if (pending !== undefined && pending === initial) {
+          pending = undefined;
+        }
+        if (initial !== undefined) {
+          return initial;
+        }
+        return takePending();
       }
-      return JSON.stringify(result.updates);
+      return takePending();
     }
   });
 }

package/dist/server/controllers/live.d.ts

@@ -3,15 +3,17 @@
  *
  * GET /api/live - Multiplexed SSE stream combining status and events.
  *
- * See LiveService for detailed documentation on how tick intervals work.
+ * Uses a shared LivePoller per environment so all SSE connections receive
+ * the same data from a single polling loop. See LivePoller for details.
  */
 import type { Context } from 'hono';
 import type { EnvVariables } from '../lib';
 /**
  * GET /api/live - Multiplexed SSE stream for status and events.
  *
- * Combines status updates (on change) and event updates (every 30s) into
- * a single SSE connection. Emits an array of LiveUpdate objects.
+ * Subscribes to the shared LivePoller for the current environment.
+ * The poller broadcasts serialized updates which are forwarded to
+ * the client via the SSE tick function.
  *
  * @param c - Hono context with env variables
  * @returns SSE stream

package/dist/server/controllers/live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/server/controllers/live.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,YAqBjE"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/server/controllers/live.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC;IAAE,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC,YAiDjE"}

package/dist/server/lib/sse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/server/lib/sse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AA6C5C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAMD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,YA4ExD"}
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../src/server/lib/sse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AA6C5C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAMD;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,YA6ExD"}

package/dist/server/lib/types.d.ts

@@ -60,5 +60,7 @@ export interface RunSSEOptions {
     sendInitial?: boolean;
     /** Return a string to emit, or undefined to skip this tick */
     tick: () => Promise<string | undefined>;
+    /** Called when the stream closes for any reason (superseded, client disconnect, error) */
+    onClose?: () => void;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/server/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EACX,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAM/D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,gBAAgB,CAAA;IAC3B,UAAU,EAAE,iBAAiB,CAAA;IAC7B,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,aAAa,CAAA;IACrB,aAAa,EAAE,oBAAoB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,+CAA+C;IAC/C,UAAU,EAAE,UAAU,CAAA;IACtB,oCAAoC;IACpC,MAAM,EAAE,cAAc,CAAA;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,WAAW,CAAA;IAChB,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,cAAc,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CACvC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/lib/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EACX,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAM/D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,gBAAgB,CAAA;IAC3B,UAAU,EAAE,iBAAiB,CAAA;IAC7B,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,aAAa,CAAA;IACrB,aAAa,EAAE,oBAAoB,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,+CAA+C;IAC/C,UAAU,EAAE,UAAU,CAAA;IACtB,oCAAoC;IACpC,MAAM,EAAE,cAAc,CAAA;IACtB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,WAAW,CAAA;IAChB,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,cAAc,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,KAAK,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,WAAW,EAAE,CAAA;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB"}

package/dist/server/services/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/server/services/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EACX,eAAe,EAIf,mBAAmB,EACnB,MAAM,SAAS,CAAA;AAyBhB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,cAAc,EAEjC;IAED;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8CzE;IAMD;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;YAkBN,oBAAoB;YAoEpB,0BAA0B;YA8F1B,cAAc;YAgGd,YAAY;YAgCZ,gBAAgB;YA2BhB,gBAAgB;CAmH9B"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/server/services/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAGpD,OAAO,KAAK,EACX,eAAe,EAIf,mBAAmB,EACnB,MAAM,SAAS,CAAA;AAiChB;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IAEvC,YAAY,MAAM,EAAE,cAAc,EAEjC;IAED;;;;;OAKG;IACG,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiDzE;IAMD;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;YAkBN,oBAAoB;YAoEpB,0BAA0B;YA8F1B,cAAc;YAgGd,YAAY;YAgCZ,gBAAgB;YA2BhB,gBAAgB;CAmH9B"}

package/dist/server/services/index.d.ts

@@ -6,8 +6,8 @@
 export { BootstrapService } from './bootstrap';
 export { EnrollmentService } from './enrollment';
 export { EventsService } from './events';
-export { LiveService } from './live';
+export { getOrCreatePoller } from './live';
 export { StatusService } from './status';
 export { StudentSearchService } from './student-search';
-export type { BootstrapResult, BootstrapStats, EnrichedComponentResource, EnrichedEnrollment, GetBootstrapOptions, EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions, GetNewEventsOptions, GetRecentEventsOptions, TickResult, TickState, SearchStudentsOptions, StudentSearchResponse, StudentSearchResult, } from './types';
+export type { BootstrapResult, BootstrapStats, EnrichedComponentResource, EnrichedEnrollment, GetBootstrapOptions, EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions, GetNewEventsOptions, GetRecentEventsOptions, TickState, SearchStudentsOptions, StudentSearchResponse, StudentSearchResult, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAMvD,YAAY,EAEX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EAEnB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EAEpB,mBAAmB,EACnB,sBAAsB,EAEtB,UAAU,EACV,SAAS,EAET,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAMvD,YAAY,EAEX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EAEnB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EAEpB,mBAAmB,EACnB,sBAAsB,EAEtB,SAAS,EAET,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,SAAS,CAAA"}

package/dist/server/services/live-poller.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Live Poller
+ *
+ * Shared polling loop for the multiplexed /api/live SSE endpoint.
+ *
+ * ## Why This Exists
+ *
+ * The Studio server is a single-user process — every browser tab connects
+ * to the same backend and sees the same data. Rather than each SSE connection
+ * running its own polling loop (duplicating API calls), a single LivePoller
+ * per environment polls once and broadcasts to all subscribers.
+ *
+ * ## How It Works
+ *
+ * ```
+ * LivePoller (one per environment)
+ *   => ticks every 1s
+ *   => ALWAYS fetch status, emit only if hash changed
+ *   => Every 30s, fetch events, emit if any new
+ *   => broadcast serialized updates to all subscribers
+ * ```
+ *
+ * ## Lifecycle
+ *
+ * Ref-counted: the poller starts when the first SSE connection subscribes,
+ * and stops when the last one disconnects. No polling when nobody is listening.
+ *
+ * ## Data Sources
+ *
+ * | Source  | Check Frequency | Emit Condition       |
+ * |---------|-----------------|----------------------|
+ * | Status  | Every tick (1s) | Payload hash changed |
+ * | Events  | Every 30s       | New events exist     |
+ */
+import type { EventsService } from './events';
+import type { StatusService } from './status';
+/**
+ * Get an existing poller for the environment, or create one.
+ *
+ * The poller is shared across all SSE connections for the same environment.
+ * It is removed from the registry when its last subscriber disconnects.
+ *
+ * @param environment - Environment key (e.g. 'staging', 'production')
+ * @param statusService - Status service instance
+ * @param eventsService - Events service instance
+ * @returns The shared LivePoller for this environment
+ */
+export declare function getOrCreatePoller(environment: string, statusService: StatusService, eventsService: EventsService): LivePoller;
+/**
+ * Options for creating a LivePoller.
+ */
+interface LivePollerOptions {
+    environment: string;
+    statusService: StatusService;
+    eventsService: EventsService;
+}
+/** Callback invoked when the poller has new data to broadcast. */
+type Subscriber = (data: string) => void;
+/**
+ * Shared polling loop for a single environment.
+ *
+ * Owns the tick state (status hash, event cursor) and broadcasts
+ * serialized updates to all subscribed SSE connections.
+ */
+export declare class LivePoller {
+    private readonly environment;
+    private readonly statusService;
+    private readonly eventsService;
+    private readonly subscribers;
+    private interval;
+    private state;
+    private lastBroadcast;
+    private initialTickPromise;
+    private ticking;
+    constructor(options: LivePollerOptions);
+    /**
+     * Subscribe to updates from this poller.
+     *
+     * Starts the polling loop on the first subscriber.
+     * Returns an unsubscribe function that stops polling when the last subscriber leaves.
+     *
+     * @param callback - Called with serialized LiveUpdate[] JSON when new data is available
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: Subscriber): () => void;
+    /**
+     * Wait for the initial tick (triggered when polling starts) and then
+     * return the most recent broadcast payload.
+     *
+     * This is used by newly connected SSE clients so the initial send can
+     * include up-to-date data even if the first poll is still in progress.
+     *
+     * @returns Last broadcast JSON string, or undefined
+     */
+    getLastBroadcastAfterInitialTick(): Promise<string | undefined>;
+    private start;
+    private stop;
+    private tick;
+    private fetchStatusIfChanged;
+    private fetchEventsIfNew;
+}
+export {};
+//# sourceMappingURL=live-poller.d.ts.map

package/dist/server/services/live-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-poller.d.ts","sourceRoot":"","sources":["../../../src/server/services/live-poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAYH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAW7C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAChC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,GAC1B,UAAU,CASZ;AAMD;;GAEG;AACH,UAAU,iBAAiB;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;CAC5B;AAED,kEAAkE;AAClE,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAExC;;;;;GAKG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,OAAO,CAAQ;IAEvB,YAAY,OAAO,EAAE,iBAAiB,EAYrC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,IAAI,CAe1C;IAED;;;;;;;;OAQG;IACG,gCAAgC,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKpE;IAMD,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,IAAI;YAeE,IAAI;YA8DJ,oBAAoB;YA4BpB,gBAAgB;CA2C9B"}

package/dist/server/services/live.d.ts

@@ -1,83 +1,8 @@
 /**
- * Live Service
+ * Live Service (re-export)
  *
- * Orchestrates multiple data sources for the multiplexed /api/live SSE endpoint.
- *
- * ## How It Works
- *
- * The SSE connection ticks every 1 second (base interval). On each tick,
- * this service decides what to check based on each data source's rules:
- *
- * ```
- * runSSE setInterval(1s)
- *   => every tick, calls liveService.tick(state)
- *
- *   liveService.tick():
- *     => ALWAYS fetch status, but only emit if hash changed
- *     => Check if 30s elapsed since lastEventsTick:
- *        - YES: fetch events, emit if any new
- *        - NO: skip events entirely
- *
- *     => return { updates: [...], newState }
- * ```
- *
- * ## Data Sources
- *
- * | Source  | Check Frequency | Emit Condition      |
- * |---------|-----------------|---------------------|
- * | Status  | Every tick (1s) | Payload hash changed |
- * | Events  | Every 30s       | New events exist    |
- *
- * This means 29 out of 30 ticks only check status. The 30th tick checks both.
- */
-import type { EventsService } from './events';
-import type { StatusService } from './status';
-import type { TickResult, TickState } from './types';
-/**
- * Options for creating a LiveService.
- */
-interface LiveServiceOptions {
-    statusService: StatusService;
-    eventsService: EventsService;
-}
-/**
- * Service that orchestrates status and event updates for the multiplexed SSE endpoint.
- *
- * Each SSE connection gets its own instance. The service manages independent tick
- * intervals: status is checked every tick (1s) but only emitted on hash change,
- * while events are fetched every 30s and emitted when new events exist.
+ * The shared LivePoller replaces the per-connection LiveService.
+ * This file re-exports for barrel compatibility.
  */
-export declare class LiveService {
-    private readonly statusService;
-    private readonly eventsService;
-    constructor(options: LiveServiceOptions);
-    /**
-     * Create initial tick state for a new SSE connection.
-     *
-     * @returns Fresh tick state with empty hash and current timestamps
-     */
-    static createInitialState(): TickState;
-    /**
-     * Perform a tick operation.
-     *
-     * Called every base tick (1s) by the SSE loop. Checks each data source
-     * according to its rules and returns any updates to emit.
-     *
-     * @param state - Current tick state from previous tick
-     * @returns Updates to emit and new state for next tick
-     */
-    tick(state: TickState): Promise<TickResult>;
-    /**
-     * Check if enough time has passed since the last check.
-     *
-     * @param lastTick - Timestamp (ms) of last check
-     * @param now - Current timestamp (ms)
-     * @param intervalMs - Required interval between checks
-     * @returns True if interval has elapsed
-     */
-    private hasIntervalElapsed;
-    private fetchStatusIfChanged;
-    private fetchEventsIfNew;
-}
-export {};
+export { getOrCreatePoller } from './live-poller';
 //# sourceMappingURL=live.d.ts.map

package/dist/server/services/live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/server/services/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAYH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIpD;;GAEG;AACH,UAAU,kBAAkB;IAC3B,aAAa,EAAE,aAAa,CAAA;IAC5B,aAAa,EAAE,aAAa,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,YAAY,OAAO,EAAE,kBAAkB,EAGtC;IAED;;;;OAIG;IACH,MAAM,CAAC,kBAAkB,IAAI,SAAS,CAQrC;IAED;;;;;;;;OAQG;IACG,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAoChD;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;YAUZ,oBAAoB;YA4BpB,gBAAgB;CAiC9B"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../src/server/services/live.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/dist/server/services/types/index.d.ts

@@ -7,5 +7,5 @@ export type { BootstrapResult, BootstrapStats, EnrichedComponentResource, Enrich
 export type { EnrollmentActionOptions, EnrollmentResult, EnrollStudentOptions } from './enrollment';
 export type { GetNewEventsOptions, GetRecentEventsOptions } from './events';
 export type { SearchStudentsOptions, StudentSearchResponse, StudentSearchResult, } from './student-search';
-export type { TickResult, TickState } from './live';
+export type { TickState } from './live';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/services/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnG,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAE3E,YAAY,EACX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,eAAe,EACf,cAAc,EACd,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAEnG,YAAY,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAE3E,YAAY,EACX,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA"}

package/dist/server/services/types/live.d.ts

@@ -1,14 +1,12 @@
 /**
- * Live Service Types
+ * Live Poller Types
  *
  * Types for the multiplexed SSE endpoint that combines status and events.
  */
-import type { LiveUpdate } from '../../../types';
 /**
- * Per-connection state for tracking when to check each data source.
+ * State for tracking when to check each data source.
  *
- * Each SSE connection maintains its own TickState. The LiveService uses
- * this state to determine:
+ * Owned by the shared LivePoller (one per environment). Used to determine:
  * - Status: Has the payload hash changed since last emit?
  * - Events: Has 30s elapsed since last check?
  */
@@ -22,13 +20,4 @@ export interface TickState {
     /** Timestamp (ms) of last events check. Used to enforce 30s interval. */
     lastEventsTick: number;
 }
-/**
- * Result of a tick operation.
- */
-export interface TickResult {
-    /** Updates to emit to the client (may be empty if nothing changed) */
-    updates: LiveUpdate[];
-    /** Updated state to pass to the next tick */
-    newState: TickState;
-}
 //# sourceMappingURL=live.d.ts.map

package/dist/server/services/types/live.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/live.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IAKzB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;IAMtB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IAErB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,sEAAsE;IACtE,OAAO,EAAE,UAAU,EAAE,CAAA;IAErB,6CAA6C;IAC7C,QAAQ,EAAE,SAAS,CAAA;CACnB"}
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../../../src/server/services/types/live.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IAKzB,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAA;IAEtB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;IAMtB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAA;IAErB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAA;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "timeback-studio",
-	"version": "0.1.7",
+	"version": "0.1.8",
 	"type": "module",
 	"exports": {
 		".": {
@@ -27,7 +27,7 @@
 	"dependencies": {
 		"@clack/prompts": "^0.11.0",
 		"@hono/node-server": "^1.19.7",
-		"@timeback/core": "0.1.4",
+		"@timeback/core": "0.1.5",
 		"c12": "^3.3.3",
 		"colorette": "^2.0.20",
 		"commander": "^14.0.2",