@iadev93/zuno-express 0.0.10 → 0.0.11

package/README.md

@@ -26,7 +26,9 @@ import { createZunoExpress } from "@iadev93/zuno-express";
 const app = express();
 app.use(express.json());
 
-const zuno = createZunoExpress();
+const zuno = createZunoExpress({
+  batchSync: true // Optional: Enable batching
+});
 
 // Unified handlers
 app.get("/zuno/sse", zuno.sse);

package/dist/index.d.mts

@@ -1,5 +1,5 @@
+import { IncomingHttpHeaders } from 'node:http';
 import { Request, Response } from 'express';
-import { IncomingHttpHeaders } from 'http';
 
 /**
  * Options for creating an Express router for Zuno.
@@ -10,31 +10,67 @@ type CreateZunoExpressOptions = {
 };
 /**
  * Creates a Zuno Express instance.
- * @param {CreateZunoExpressOptions} [opts] - Options for creating the Express router.
- * @returns {Object} An object with the following properties:
- *   - sse: An Express handler function that handles SSE connections.
- *   - sync: An Express handler function that handles sync POST requests.
- *   - snapshot: An Express handler function that handles snapshot GET requests.
+ * Returns both granular handlers and a convenience `mount` helper.
  */
 declare function createZunoExpress(opts?: CreateZunoExpressOptions): {
     /**
-     * Handles SSE connections for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Optional convenience method to mount all Zuno handlers at once.
+     * @param app The Express App or Router to mount the handlers on.
+     * @param basePath The base path for the Zuno routes (defaults to "/zuno").
+     */
+    mount: (app: {
+        get: Function;
+        post: Function;
+    }, basePath?: string) => void;
+    /**
+     * SSE connection handler.
+     * Usage: app.get('/custom/sse', zuno.sse);
+     */
+    sse: (req: Request, res: Response) => void;
+    /**
+     * Sync POST handler.
+     * Usage: app.post('/custom/sync', zuno.sync);
+     */
+    sync: (req: Request, res: Response) => void;
+    /**
+     * Snapshot GET handler.
+     * Usage: app.get('/custom/snapshot', zuno.snapshot);
+     */
+    snapshot: (req: Request, res: Response) => void;
+};
+/**
+ * A standalone helper to mount Zuno handlers on an Express app/router.
+ */
+declare function mountZuno(app: {
+    get: Function;
+    post: Function;
+}, opts?: CreateZunoExpressOptions & {
+    basePath?: string;
+}): {
+    /**
+     * Optional convenience method to mount all Zuno handlers at once.
+     * @param app The Express App or Router to mount the handlers on.
+     * @param basePath The base path for the Zuno routes (defaults to "/zuno").
+     */
+    mount: (app: {
+        get: Function;
+        post: Function;
+    }, basePath?: string) => void;
+    /**
+     * SSE connection handler.
+     * Usage: app.get('/custom/sse', zuno.sse);
      */
     sse: (req: Request, res: Response) => void;
     /**
-     * Handles sync POST requests for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Sync POST handler.
+     * Usage: app.post('/custom/sync', zuno.sync);
      */
     sync: (req: Request, res: Response) => void;
     /**
-     * Handles snapshot GET requests for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Snapshot GET handler.
+     * Usage: app.get('/custom/snapshot', zuno.snapshot);
      */
     snapshot: (req: Request, res: Response) => void;
 };
 
-export { type CreateZunoExpressOptions, createZunoExpress };
+export { type CreateZunoExpressOptions, createZunoExpress, mountZuno };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
+import { IncomingHttpHeaders } from 'node:http';
 import { Request, Response } from 'express';
-import { IncomingHttpHeaders } from 'http';
 
 /**
  * Options for creating an Express router for Zuno.
@@ -10,31 +10,67 @@ type CreateZunoExpressOptions = {
 };
 /**
  * Creates a Zuno Express instance.
- * @param {CreateZunoExpressOptions} [opts] - Options for creating the Express router.
- * @returns {Object} An object with the following properties:
- *   - sse: An Express handler function that handles SSE connections.
- *   - sync: An Express handler function that handles sync POST requests.
- *   - snapshot: An Express handler function that handles snapshot GET requests.
+ * Returns both granular handlers and a convenience `mount` helper.
  */
 declare function createZunoExpress(opts?: CreateZunoExpressOptions): {
     /**
-     * Handles SSE connections for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Optional convenience method to mount all Zuno handlers at once.
+     * @param app The Express App or Router to mount the handlers on.
+     * @param basePath The base path for the Zuno routes (defaults to "/zuno").
+     */
+    mount: (app: {
+        get: Function;
+        post: Function;
+    }, basePath?: string) => void;
+    /**
+     * SSE connection handler.
+     * Usage: app.get('/custom/sse', zuno.sse);
+     */
+    sse: (req: Request, res: Response) => void;
+    /**
+     * Sync POST handler.
+     * Usage: app.post('/custom/sync', zuno.sync);
+     */
+    sync: (req: Request, res: Response) => void;
+    /**
+     * Snapshot GET handler.
+     * Usage: app.get('/custom/snapshot', zuno.snapshot);
+     */
+    snapshot: (req: Request, res: Response) => void;
+};
+/**
+ * A standalone helper to mount Zuno handlers on an Express app/router.
+ */
+declare function mountZuno(app: {
+    get: Function;
+    post: Function;
+}, opts?: CreateZunoExpressOptions & {
+    basePath?: string;
+}): {
+    /**
+     * Optional convenience method to mount all Zuno handlers at once.
+     * @param app The Express App or Router to mount the handlers on.
+     * @param basePath The base path for the Zuno routes (defaults to "/zuno").
+     */
+    mount: (app: {
+        get: Function;
+        post: Function;
+    }, basePath?: string) => void;
+    /**
+     * SSE connection handler.
+     * Usage: app.get('/custom/sse', zuno.sse);
      */
     sse: (req: Request, res: Response) => void;
     /**
-     * Handles sync POST requests for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Sync POST handler.
+     * Usage: app.post('/custom/sync', zuno.sync);
      */
     sync: (req: Request, res: Response) => void;
     /**
-     * Handles snapshot GET requests for Express.
-     * @param {Request} req - Express request object.
-     * @param {Response} res - Express response object.
+     * Snapshot GET handler.
+     * Usage: app.get('/custom/snapshot', zuno.snapshot);
      */
     snapshot: (req: Request, res: Response) => void;
 };
 
-export { type CreateZunoExpressOptions, createZunoExpress };
+export { type CreateZunoExpressOptions, createZunoExpress, mountZuno };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var server=require('@iadev93/zuno/server');function c(n){let{headers:o}=n??{};return {sse:(t,e)=>server.createSSEConnection(t,e,o??{}),sync:(t,e)=>{let r=t.body,s=server.applyStateEvent(r);if(!s.ok){e.status(409).json({reason:s.reason,current:s.current});return}e.status(200).json({ok:true,event:s.event});},snapshot:(t,e)=>server.sendSnapshot(t,e)}}exports.createZunoExpress=c;//# sourceMappingURL=index.js.map
+'use strict';var server=require('@iadev93/zuno/server');function i(o){let{headers:r={}}=o??{},n={sse:(e,t)=>server.createSSEConnection(e,t,r),sync:(e,t)=>{let u=e.body,s=server.applyStateEvent(u);if(!s.ok){t.status(409).json({ok:false,reason:s.reason,current:s.current});return}t.status(200).json({ok:true,event:s.event});},snapshot:(e,t)=>server.sendSnapshot(e,t)};return {...n,mount:(e,t="/zuno")=>{e.get(`${t}/sse`,n.sse),e.get(`${t}/snapshot`,n.snapshot),e.post(`${t}/sync`,n.sync);}}}function d(o,r){let{basePath:n="/zuno",...e}=r??{},t=i(e);return t.mount(o,n),t}exports.createZunoExpress=i;exports.mountZuno=d;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["createZunoExpress","opts","headers","req","res","createSSEConnection","incoming","result","applyStateEvent","sendSnapshot"],"mappings":"wDAyBO,SAASA,CAAAA,CAAkBC,EAAiC,CAClE,GAAM,CAAE,OAAA,CAAAC,CAAQ,EAAID,CAAAA,EAAQ,GAE5B,OAAO,CAMN,GAAA,CAAK,CAACE,EAAcC,CAAAA,GACnBC,0BAAAA,CAAoBF,EAAKC,CAAAA,CAAKF,CAAAA,EAAW,EAAE,CAAA,CAO5C,KAAM,CAACC,CAAAA,CAAcC,IAAkB,CACtC,IAAME,EAAWH,CAAAA,CAAI,IAAA,CACfI,EAASC,sBAAAA,CAAgBF,CAAQ,CAAA,CAEvC,GAAI,CAACC,CAAAA,CAAO,EAAA,CAAI,CACfH,CAAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,CACpB,MAAA,CAAQG,CAAAA,CAAO,OACf,OAAA,CAASA,CAAAA,CAAO,OACjB,CAAC,CAAA,CACD,MACD,CAEAH,CAAAA,CAAI,MAAA,CAAO,GAAG,EAAE,IAAA,CAAK,CAAE,GAAI,IAAA,CAAM,KAAA,CAAOG,EAAO,KAAM,CAAC,EACvD,CAAA,CAOA,QAAA,CAAU,CAACJ,CAAAA,CAAcC,CAAAA,GAAkBK,oBAAaN,CAAAA,CAAKC,CAAG,CACjE,CACD","file":"index.js","sourcesContent":["import type { ZunoStateEvent } from \"@iadev93/zuno\";\nimport {\n\tapplyStateEvent,\n\tcreateSSEConnection,\n\tsendSnapshot,\n} from \"@iadev93/zuno/server\";\nimport type { Request, Response } from \"express\";\nimport type { IncomingHttpHeaders } from \"http\";\n\n/**\n * Options for creating an Express router for Zuno.\n */\nexport type CreateZunoExpressOptions = {\n\t/** Optional custom headers to be sent with the SSE response. */\n\theaders?: IncomingHttpHeaders;\n};\n\n/**\n * Creates a Zuno Express instance.\n * @param {CreateZunoExpressOptions} [opts] - Options for creating the Express router.\n * @returns {Object} An object with the following properties:\n *   - sse: An Express handler function that handles SSE connections.\n *   - sync: An Express handler function that handles sync POST requests.\n *   - snapshot: An Express handler function that handles snapshot GET requests.\n */\nexport function createZunoExpress(opts?: CreateZunoExpressOptions) {\n\tconst { headers } = opts ?? {};\n\n\treturn {\n\t\t/**\n\t\t * Handles SSE connections for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsse: (req: Request, res: Response) =>\n\t\t\tcreateSSEConnection(req, res, headers ?? {}),\n\n\t\t/**\n\t\t * Handles sync POST requests for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsync: (req: Request, res: Response) => {\n\t\t\tconst incoming = req.body as ZunoStateEvent;\n\t\t\tconst result = applyStateEvent(incoming);\n\n\t\t\tif (!result.ok) {\n\t\t\t\tres.status(409).json({\n\t\t\t\t\treason: result.reason,\n\t\t\t\t\tcurrent: result.current,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tres.status(200).json({ ok: true, event: result.event });\n\t\t},\n\n\t\t/**\n\t\t * Handles snapshot GET requests for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsnapshot: (req: Request, res: Response) => sendSnapshot(req, res),\n\t};\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["createZunoExpress","opts","headers","handlers","req","res","createSSEConnection","incoming","result","applyStateEvent","sendSnapshot","app","basePath","mountZuno","rest","zuno"],"mappings":"wDAqBO,SAASA,CAAAA,CAAkBC,EAAiC,CAClE,GAAM,CAAE,OAAA,CAAAC,EAAU,EAAG,CAAA,CAAID,CAAAA,EAAQ,EAAC,CAM5BE,CAAAA,CAAW,CAKhB,GAAA,CAAK,CAACC,CAAAA,CAAcC,CAAAA,GACnBC,0BAAAA,CAAoBF,CAAAA,CAAKC,EAAKH,CAAO,CAAA,CAMtC,IAAA,CAAM,CAACE,EAAcC,CAAAA,GAAkB,CACtC,IAAME,CAAAA,CAAWH,EAAI,IAAA,CACfI,CAAAA,CAASC,sBAAAA,CAAgBF,CAAQ,EAEvC,GAAI,CAACC,CAAAA,CAAO,EAAA,CAAI,CACfH,CAAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,KAAK,CACpB,EAAA,CAAI,KAAA,CACJ,MAAA,CAAQG,EAAO,MAAA,CACf,OAAA,CAASA,CAAAA,CAAO,OACjB,CAAC,CAAA,CACD,MACD,CAEAH,CAAAA,CAAI,OAAO,GAAG,CAAA,CAAE,IAAA,CAAK,CAAE,GAAI,IAAA,CAAM,KAAA,CAAOG,CAAAA,CAAO,KAAM,CAAC,EACvD,CAAA,CAMA,QAAA,CAAU,CAACJ,CAAAA,CAAcC,CAAAA,GAAkBK,mBAAAA,CAAaN,CAAAA,CAAKC,CAAG,CACjE,CAAA,CAEA,OAAO,CACN,GAAGF,CAAAA,CAMH,KAAA,CAAO,CAACQ,CAAAA,CAAwCC,EAAW,OAAA,GAAY,CACtED,CAAAA,CAAI,GAAA,CAAI,GAAGC,CAAQ,CAAA,IAAA,CAAA,CAAQT,CAAAA,CAAS,GAAG,EACvCQ,CAAAA,CAAI,GAAA,CAAI,CAAA,EAAGC,CAAQ,YAAaT,CAAAA,CAAS,QAAQ,CAAA,CACjDQ,CAAAA,CAAI,KAAK,CAAA,EAAGC,CAAQ,CAAA,KAAA,CAAA,CAAST,CAAAA,CAAS,IAAI,EAC3C,CACD,CACD,CAKO,SAASU,CAAAA,CACfF,CAAAA,CACAV,CAAAA,CACC,CACD,GAAM,CAAE,QAAA,CAAAW,CAAAA,CAAW,OAAA,CAAS,GAAGE,CAAK,CAAA,CAAIb,CAAAA,EAAQ,GAC1Cc,CAAAA,CAAOf,CAAAA,CAAkBc,CAAI,CAAA,CACnC,OAAAC,CAAAA,CAAK,KAAA,CAAMJ,CAAAA,CAAKC,CAAQ,EACjBG,CACR","file":"index.js","sourcesContent":["import type { IncomingHttpHeaders } from \"node:http\";\nimport type { ZunoStateEvent } from \"@iadev93/zuno\";\nimport {\n\tapplyStateEvent,\n\tcreateSSEConnection,\n\tsendSnapshot,\n} from \"@iadev93/zuno/server\";\nimport type { Request, Response } from \"express\";\n\n/**\n * Options for creating an Express router for Zuno.\n */\nexport type CreateZunoExpressOptions = {\n\t/** Optional custom headers to be sent with the SSE response. */\n\theaders?: IncomingHttpHeaders;\n};\n\n/**\n * Creates a Zuno Express instance.\n * Returns both granular handlers and a convenience `mount` helper.\n */\nexport function createZunoExpress(opts?: CreateZunoExpressOptions) {\n\tconst { headers = {} } = opts ?? {};\n\n\t/**\n\t * Granular handlers for maximum control.\n\t * You can mount these manually to any route or wrap them in custom middleware.\n\t */\n\tconst handlers = {\n\t\t/**\n\t\t * SSE connection handler.\n\t\t * Usage: app.get('/custom/sse', zuno.sse);\n\t\t */\n\t\tsse: (req: Request, res: Response) =>\n\t\t\tcreateSSEConnection(req, res, headers),\n\n\t\t/**\n\t\t * Sync POST handler.\n\t\t * Usage: app.post('/custom/sync', zuno.sync);\n\t\t */\n\t\tsync: (req: Request, res: Response) => {\n\t\t\tconst incoming = req.body as ZunoStateEvent;\n\t\t\tconst result = applyStateEvent(incoming);\n\n\t\t\tif (!result.ok) {\n\t\t\t\tres.status(409).json({\n\t\t\t\t\tok: false,\n\t\t\t\t\treason: result.reason,\n\t\t\t\t\tcurrent: result.current,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tres.status(200).json({ ok: true, event: result.event });\n\t\t},\n\n\t\t/**\n\t\t * Snapshot GET handler.\n\t\t * Usage: app.get('/custom/snapshot', zuno.snapshot);\n\t\t */\n\t\tsnapshot: (req: Request, res: Response) => sendSnapshot(req, res),\n\t};\n\n\treturn {\n\t\t...handlers,\n\t\t/**\n\t\t * Optional convenience method to mount all Zuno handlers at once.\n\t\t * @param app The Express App or Router to mount the handlers on.\n\t\t * @param basePath The base path for the Zuno routes (defaults to \"/zuno\").\n\t\t */\n\t\tmount: (app: { get: Function; post: Function }, basePath = \"/zuno\") => {\n\t\t\tapp.get(`${basePath}/sse`, handlers.sse);\n\t\t\tapp.get(`${basePath}/snapshot`, handlers.snapshot);\n\t\t\tapp.post(`${basePath}/sync`, handlers.sync);\n\t\t},\n\t};\n}\n\n/**\n * A standalone helper to mount Zuno handlers on an Express app/router.\n */\nexport function mountZuno(\n\tapp: { get: Function; post: Function },\n\topts?: CreateZunoExpressOptions & { basePath?: string },\n) {\n\tconst { basePath = \"/zuno\", ...rest } = opts ?? {};\n\tconst zuno = createZunoExpress(rest);\n\tzuno.mount(app, basePath);\n\treturn zuno;\n}\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {sendSnapshot,createSSEConnection,applyStateEvent}from'@iadev93/zuno/server';function c(n){let{headers:o}=n??{};return {sse:(t,e)=>createSSEConnection(t,e,o??{}),sync:(t,e)=>{let r=t.body,s=applyStateEvent(r);if(!s.ok){e.status(409).json({reason:s.reason,current:s.current});return}e.status(200).json({ok:true,event:s.event});},snapshot:(t,e)=>sendSnapshot(t,e)}}export{c as createZunoExpress};//# sourceMappingURL=index.mjs.map
+import {sendSnapshot,createSSEConnection,applyStateEvent}from'@iadev93/zuno/server';function i(o){let{headers:r={}}=o??{},n={sse:(e,t)=>createSSEConnection(e,t,r),sync:(e,t)=>{let u=e.body,s=applyStateEvent(u);if(!s.ok){t.status(409).json({ok:false,reason:s.reason,current:s.current});return}t.status(200).json({ok:true,event:s.event});},snapshot:(e,t)=>sendSnapshot(e,t)};return {...n,mount:(e,t="/zuno")=>{e.get(`${t}/sse`,n.sse),e.get(`${t}/snapshot`,n.snapshot),e.post(`${t}/sync`,n.sync);}}}function d(o,r){let{basePath:n="/zuno",...e}=r??{},t=i(e);return t.mount(o,n),t}export{i as createZunoExpress,d as mountZuno};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["createZunoExpress","opts","headers","req","res","createSSEConnection","incoming","result","applyStateEvent","sendSnapshot"],"mappings":"oFAyBO,SAASA,CAAAA,CAAkBC,EAAiC,CAClE,GAAM,CAAE,OAAA,CAAAC,CAAQ,EAAID,CAAAA,EAAQ,GAE5B,OAAO,CAMN,GAAA,CAAK,CAACE,EAAcC,CAAAA,GACnBC,mBAAAA,CAAoBF,EAAKC,CAAAA,CAAKF,CAAAA,EAAW,EAAE,CAAA,CAO5C,KAAM,CAACC,CAAAA,CAAcC,IAAkB,CACtC,IAAME,EAAWH,CAAAA,CAAI,IAAA,CACfI,EAASC,eAAAA,CAAgBF,CAAQ,CAAA,CAEvC,GAAI,CAACC,CAAAA,CAAO,EAAA,CAAI,CACfH,CAAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,IAAA,CAAK,CACpB,MAAA,CAAQG,CAAAA,CAAO,OACf,OAAA,CAASA,CAAAA,CAAO,OACjB,CAAC,CAAA,CACD,MACD,CAEAH,CAAAA,CAAI,MAAA,CAAO,GAAG,EAAE,IAAA,CAAK,CAAE,GAAI,IAAA,CAAM,KAAA,CAAOG,EAAO,KAAM,CAAC,EACvD,CAAA,CAOA,QAAA,CAAU,CAACJ,CAAAA,CAAcC,CAAAA,GAAkBK,aAAaN,CAAAA,CAAKC,CAAG,CACjE,CACD","file":"index.mjs","sourcesContent":["import type { ZunoStateEvent } from \"@iadev93/zuno\";\nimport {\n\tapplyStateEvent,\n\tcreateSSEConnection,\n\tsendSnapshot,\n} from \"@iadev93/zuno/server\";\nimport type { Request, Response } from \"express\";\nimport type { IncomingHttpHeaders } from \"http\";\n\n/**\n * Options for creating an Express router for Zuno.\n */\nexport type CreateZunoExpressOptions = {\n\t/** Optional custom headers to be sent with the SSE response. */\n\theaders?: IncomingHttpHeaders;\n};\n\n/**\n * Creates a Zuno Express instance.\n * @param {CreateZunoExpressOptions} [opts] - Options for creating the Express router.\n * @returns {Object} An object with the following properties:\n *   - sse: An Express handler function that handles SSE connections.\n *   - sync: An Express handler function that handles sync POST requests.\n *   - snapshot: An Express handler function that handles snapshot GET requests.\n */\nexport function createZunoExpress(opts?: CreateZunoExpressOptions) {\n\tconst { headers } = opts ?? {};\n\n\treturn {\n\t\t/**\n\t\t * Handles SSE connections for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsse: (req: Request, res: Response) =>\n\t\t\tcreateSSEConnection(req, res, headers ?? {}),\n\n\t\t/**\n\t\t * Handles sync POST requests for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsync: (req: Request, res: Response) => {\n\t\t\tconst incoming = req.body as ZunoStateEvent;\n\t\t\tconst result = applyStateEvent(incoming);\n\n\t\t\tif (!result.ok) {\n\t\t\t\tres.status(409).json({\n\t\t\t\t\treason: result.reason,\n\t\t\t\t\tcurrent: result.current,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tres.status(200).json({ ok: true, event: result.event });\n\t\t},\n\n\t\t/**\n\t\t * Handles snapshot GET requests for Express.\n\t\t * @param {Request} req - Express request object.\n\t\t * @param {Response} res - Express response object.\n\t\t */\n\t\tsnapshot: (req: Request, res: Response) => sendSnapshot(req, res),\n\t};\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["createZunoExpress","opts","headers","handlers","req","res","createSSEConnection","incoming","result","applyStateEvent","sendSnapshot","app","basePath","mountZuno","rest","zuno"],"mappings":"oFAqBO,SAASA,CAAAA,CAAkBC,EAAiC,CAClE,GAAM,CAAE,OAAA,CAAAC,EAAU,EAAG,CAAA,CAAID,CAAAA,EAAQ,EAAC,CAM5BE,CAAAA,CAAW,CAKhB,GAAA,CAAK,CAACC,CAAAA,CAAcC,CAAAA,GACnBC,mBAAAA,CAAoBF,CAAAA,CAAKC,EAAKH,CAAO,CAAA,CAMtC,IAAA,CAAM,CAACE,EAAcC,CAAAA,GAAkB,CACtC,IAAME,CAAAA,CAAWH,EAAI,IAAA,CACfI,CAAAA,CAASC,eAAAA,CAAgBF,CAAQ,EAEvC,GAAI,CAACC,CAAAA,CAAO,EAAA,CAAI,CACfH,CAAAA,CAAI,MAAA,CAAO,GAAG,CAAA,CAAE,KAAK,CACpB,EAAA,CAAI,KAAA,CACJ,MAAA,CAAQG,EAAO,MAAA,CACf,OAAA,CAASA,CAAAA,CAAO,OACjB,CAAC,CAAA,CACD,MACD,CAEAH,CAAAA,CAAI,OAAO,GAAG,CAAA,CAAE,IAAA,CAAK,CAAE,GAAI,IAAA,CAAM,KAAA,CAAOG,CAAAA,CAAO,KAAM,CAAC,EACvD,CAAA,CAMA,QAAA,CAAU,CAACJ,CAAAA,CAAcC,CAAAA,GAAkBK,YAAAA,CAAaN,CAAAA,CAAKC,CAAG,CACjE,CAAA,CAEA,OAAO,CACN,GAAGF,CAAAA,CAMH,KAAA,CAAO,CAACQ,CAAAA,CAAwCC,EAAW,OAAA,GAAY,CACtED,CAAAA,CAAI,GAAA,CAAI,GAAGC,CAAQ,CAAA,IAAA,CAAA,CAAQT,CAAAA,CAAS,GAAG,EACvCQ,CAAAA,CAAI,GAAA,CAAI,CAAA,EAAGC,CAAQ,YAAaT,CAAAA,CAAS,QAAQ,CAAA,CACjDQ,CAAAA,CAAI,KAAK,CAAA,EAAGC,CAAQ,CAAA,KAAA,CAAA,CAAST,CAAAA,CAAS,IAAI,EAC3C,CACD,CACD,CAKO,SAASU,CAAAA,CACfF,CAAAA,CACAV,CAAAA,CACC,CACD,GAAM,CAAE,QAAA,CAAAW,CAAAA,CAAW,OAAA,CAAS,GAAGE,CAAK,CAAA,CAAIb,CAAAA,EAAQ,GAC1Cc,CAAAA,CAAOf,CAAAA,CAAkBc,CAAI,CAAA,CACnC,OAAAC,CAAAA,CAAK,KAAA,CAAMJ,CAAAA,CAAKC,CAAQ,EACjBG,CACR","file":"index.mjs","sourcesContent":["import type { IncomingHttpHeaders } from \"node:http\";\nimport type { ZunoStateEvent } from \"@iadev93/zuno\";\nimport {\n\tapplyStateEvent,\n\tcreateSSEConnection,\n\tsendSnapshot,\n} from \"@iadev93/zuno/server\";\nimport type { Request, Response } from \"express\";\n\n/**\n * Options for creating an Express router for Zuno.\n */\nexport type CreateZunoExpressOptions = {\n\t/** Optional custom headers to be sent with the SSE response. */\n\theaders?: IncomingHttpHeaders;\n};\n\n/**\n * Creates a Zuno Express instance.\n * Returns both granular handlers and a convenience `mount` helper.\n */\nexport function createZunoExpress(opts?: CreateZunoExpressOptions) {\n\tconst { headers = {} } = opts ?? {};\n\n\t/**\n\t * Granular handlers for maximum control.\n\t * You can mount these manually to any route or wrap them in custom middleware.\n\t */\n\tconst handlers = {\n\t\t/**\n\t\t * SSE connection handler.\n\t\t * Usage: app.get('/custom/sse', zuno.sse);\n\t\t */\n\t\tsse: (req: Request, res: Response) =>\n\t\t\tcreateSSEConnection(req, res, headers),\n\n\t\t/**\n\t\t * Sync POST handler.\n\t\t * Usage: app.post('/custom/sync', zuno.sync);\n\t\t */\n\t\tsync: (req: Request, res: Response) => {\n\t\t\tconst incoming = req.body as ZunoStateEvent;\n\t\t\tconst result = applyStateEvent(incoming);\n\n\t\t\tif (!result.ok) {\n\t\t\t\tres.status(409).json({\n\t\t\t\t\tok: false,\n\t\t\t\t\treason: result.reason,\n\t\t\t\t\tcurrent: result.current,\n\t\t\t\t});\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tres.status(200).json({ ok: true, event: result.event });\n\t\t},\n\n\t\t/**\n\t\t * Snapshot GET handler.\n\t\t * Usage: app.get('/custom/snapshot', zuno.snapshot);\n\t\t */\n\t\tsnapshot: (req: Request, res: Response) => sendSnapshot(req, res),\n\t};\n\n\treturn {\n\t\t...handlers,\n\t\t/**\n\t\t * Optional convenience method to mount all Zuno handlers at once.\n\t\t * @param app The Express App or Router to mount the handlers on.\n\t\t * @param basePath The base path for the Zuno routes (defaults to \"/zuno\").\n\t\t */\n\t\tmount: (app: { get: Function; post: Function }, basePath = \"/zuno\") => {\n\t\t\tapp.get(`${basePath}/sse`, handlers.sse);\n\t\t\tapp.get(`${basePath}/snapshot`, handlers.snapshot);\n\t\t\tapp.post(`${basePath}/sync`, handlers.sync);\n\t\t},\n\t};\n}\n\n/**\n * A standalone helper to mount Zuno handlers on an Express app/router.\n */\nexport function mountZuno(\n\tapp: { get: Function; post: Function },\n\topts?: CreateZunoExpressOptions & { basePath?: string },\n) {\n\tconst { basePath = \"/zuno\", ...rest } = opts ?? {};\n\tconst zuno = createZunoExpress(rest);\n\tzuno.mount(app, basePath);\n\treturn zuno;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iadev93/zuno-express",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -16,14 +16,14 @@
   },
   "peerDependencies": {
     "express": "^5.0.0",
-    "@iadev93/zuno": "0.0.8"
+    "@iadev93/zuno": "0.0.9"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",
     "@types/node": "^20.0.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
-    "@iadev93/zuno": "0.0.8"
+    "@iadev93/zuno": "0.0.9"
   },
   "keywords": [
     "zuno",