@meridianjs/framework 0.1.5 → 0.1.6

package/dist/index.d.ts

@@ -191,4 +191,24 @@ declare const apiRateLimit: express_rate_limit.RateLimitRequestHandler;
  */
 declare function validate(schema: ZodSchema): (req: Request, res: Response, next: NextFunction) => void;
 
-export { type BootstrapOptions, ConsoleLogger, type MeridianApp, type MiddlewareRoute, type MiddlewaresConfig, apiRateLimit, authRateLimit, bootstrap, createMeridianContainer, createServer, defineConfig, defineMiddlewares, loadConfig, loadJobs, loadLinks, loadModules, loadPlugins, loadRoutes, loadSubscribers, resolveModuleDefinition, validate };
+/**
+ * Manages Server-Sent Event (SSE) connections grouped by workspace.
+ * Subscribers call broadcast() after mutations; the frontend receives live updates
+ * and invalidates the relevant TanStack Query cache entries.
+ */
+declare class SseManager {
+    private clients;
+    /**
+     * Registers a response as an SSE client for the given workspace.
+     * Returns an unsubscribe function to call on connection close.
+     */
+    subscribe(workspaceId: string, res: Response): () => void;
+    /**
+     * Sends an SSE event to all connected clients in the given workspace.
+     */
+    broadcast(workspaceId: string, event: string, data: unknown): void;
+}
+/** Singleton shared across all routes and subscribers. */
+declare const sseManager: SseManager;
+
+export { type BootstrapOptions, ConsoleLogger, type MeridianApp, type MiddlewareRoute, type MiddlewaresConfig, SseManager, apiRateLimit, authRateLimit, bootstrap, createMeridianContainer, createServer, defineConfig, defineMiddlewares, loadConfig, loadJobs, loadLinks, loadModules, loadPlugins, loadRoutes, loadSubscribers, resolveModuleDefinition, sseManager, validate };

package/dist/index.js

@@ -724,8 +724,55 @@ function validate(schema) {
     next();
   };
 }
+
+// src/sse-manager.ts
+var SseManager = class {
+  clients = /* @__PURE__ */ new Map();
+  /**
+   * Registers a response as an SSE client for the given workspace.
+   * Returns an unsubscribe function to call on connection close.
+   */
+  subscribe(workspaceId, res) {
+    if (!this.clients.has(workspaceId)) {
+      this.clients.set(workspaceId, /* @__PURE__ */ new Set());
+    }
+    this.clients.get(workspaceId).add(res);
+    return () => {
+      const set = this.clients.get(workspaceId);
+      if (set) {
+        set.delete(res);
+        if (set.size === 0) this.clients.delete(workspaceId);
+      }
+    };
+  }
+  /**
+   * Sends an SSE event to all connected clients in the given workspace.
+   */
+  broadcast(workspaceId, event, data) {
+    const set = this.clients.get(workspaceId);
+    if (!set?.size) return;
+    const payload = `event: ${event}
+data: ${JSON.stringify(data)}
+
+`;
+    const dead = [];
+    for (const res of set) {
+      try {
+        res.write(payload);
+      } catch {
+        dead.push(res);
+      }
+    }
+    for (const res of dead) {
+      set.delete(res);
+    }
+    if (set.size === 0) this.clients.delete(workspaceId);
+  }
+};
+var sseManager = new SseManager();
 export {
   ConsoleLogger,
+  SseManager,
   apiRateLimit,
   asClass,
   asFunction,
@@ -744,5 +791,6 @@ export {
   loadRoutes,
   loadSubscribers,
   resolveModuleDefinition,
+  sseManager,
   validate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridianjs/framework",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Core Meridian framework: bootstrap, DI container, module/route/subscriber/job loaders",
   "main": "./dist/index.js",
   "module": "./dist/index.js",