@meridianjs/framework 0.1.5 → 0.1.7

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

@@ -32,6 +32,9 @@ function wrapContainer(raw) {
     },
     createScope() {
       return wrapContainer(raw.createScope());
+    },
+    async dispose() {
+      await raw.dispose();
     }
   };
   return container;
@@ -506,6 +509,7 @@ import cors from "cors";
 import helmet from "helmet";
 function createServer(container, config) {
   const app = express();
+  app.set("trust proxy", 1);
   const logger = container.resolve("logger");
   app.use(express.json({ limit: "10mb" }));
   app.use(express.urlencoded({ extended: true, limit: "10mb" }));
@@ -536,8 +540,10 @@ function createServer(container, config) {
       exposedHeaders: ["X-RateLimit-Limit", "X-RateLimit-Remaining", "X-RateLimit-Reset"]
     })
   );
-  app.use((req, _res, next) => {
+  app.use((req, res, next) => {
     req.scope = container.createScope();
+    res.on("finish", () => req.scope.dispose?.());
+    res.on("close", () => req.scope.dispose?.());
     next();
   });
   app.get("/health", (_req, res) => {
@@ -657,18 +663,34 @@ async function bootstrap(opts) {
         await bus.close?.();
       } catch {
       }
+      try {
+        const scheduler = container.resolve("scheduler");
+        await scheduler.close();
+      } catch {
+      }
       logger.info("Meridian server stopped.");
     }
   };
 }
 async function loadMiddlewares(server, container, apiDir) {
   const logger = container.resolve("logger");
-  const middlewaresPath = path8.join(apiDir, "middlewares.ts");
-  let mod;
-  try {
-    const { pathToFileURL: pathToFileURL8 } = await import("url");
-    mod = await import(pathToFileURL8(middlewaresPath).href);
-  } catch {
+  const candidates = [
+    path8.join(apiDir, "middlewares.ts"),
+    path8.join(apiDir, "middlewares.mts"),
+    path8.join(apiDir, "middlewares.js"),
+    path8.join(apiDir, "middlewares.mjs")
+  ];
+  let mod = null;
+  const { pathToFileURL: pathToFileURL8 } = await import("url");
+  for (const candidate of candidates) {
+    try {
+      mod = await import(pathToFileURL8(candidate).href);
+      break;
+    } catch (err) {
+      if (err.code !== "ERR_MODULE_NOT_FOUND" && err.code !== "MODULE_NOT_FOUND") throw err;
+    }
+  }
+  if (!mod) {
     return;
   }
   const config = mod.default;
@@ -724,8 +746,56 @@ 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 safeEvent = event.replace(/[\r\n]/g, "");
+    const payload = `event: ${safeEvent}
+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 +814,6 @@ export {
   loadRoutes,
   loadSubscribers,
   resolveModuleDefinition,
+  sseManager,
   validate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meridianjs/framework",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Core Meridian framework: bootstrap, DI container, module/route/subscriber/job loaders",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -8,8 +8,10 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
     }
   },
   "scripts": {