@meridianjs/framework 0.1.4 → 0.1.6

package/dist/index.d.ts

@@ -159,7 +159,7 @@ declare function loadLinks(container: MeridianContainer, linksDir: string): Prom
  *  - relative local path: "./src/plugins/my-plugin"
  *  - absolute path: "/absolute/path/to/plugin"
  */
-declare function loadPlugins(container: MeridianContainer, plugins: PluginConfig[], rootDir: string): Promise<void>;
+declare function loadPlugins(container: MeridianContainer, plugins: PluginConfig[], rootDir: string, server?: any): Promise<void>;
 
 declare class ConsoleLogger implements ILogger {
     private readonly prefix;
@@ -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

@@ -401,7 +401,7 @@ var QueryService = class {
 };
 
 // src/plugin-loader.ts
-async function loadPlugins(container, plugins, rootDir) {
+async function loadPlugins(container, plugins, rootDir, server) {
   const logger = container.resolve("logger");
   for (const plugin of plugins) {
     logger.info(`Loading plugin: ${plugin.resolve}`);
@@ -444,17 +444,12 @@ async function loadPlugins(container, plugins, rootDir) {
       }
     }
     if (scanRoot) {
-      await autoScanPlugin(scanRoot, container, logger);
+      await autoScanPlugin(scanRoot, container, logger, server);
     }
     logger.info(`Plugin loaded: ${plugin.resolve}`);
   }
 }
-async function autoScanPlugin(scanRoot, container, logger) {
-  let server = null;
-  try {
-    server = container.resolve("server");
-  } catch {
-  }
+async function autoScanPlugin(scanRoot, container, logger, server) {
   const candidates = [
     scanRoot,
     // pluginRoot already points to compiled dir
@@ -629,7 +624,7 @@ async function bootstrap(opts) {
   const server = createServer(container, config);
   container.register({ server });
   await loadMiddlewares(server, container, path8.join(rootDir, "src", "api"));
-  await loadPlugins(container, config.plugins ?? [], rootDir);
+  await loadPlugins(container, config.plugins ?? [], rootDir, server);
   await loadLinks(container, path8.join(rootDir, "src", "links"));
   await loadRoutes(server, container, path8.join(rootDir, "src", "api"));
   await loadSubscribers(container, path8.join(rootDir, "src", "subscribers"));
@@ -729,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,
@@ -749,5 +791,6 @@ export {
   loadRoutes,
   loadSubscribers,
   resolveModuleDefinition,
+  sseManager,
   validate
 };

package/package.json

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