@iadev93/zuno 0.0.5 → 0.0.6

package/dist/server/index.d.cts

@@ -0,0 +1,57 @@
+import { f as ZunoStateEvent } from '../index-IbvF6TBr.cjs';
+import { IncomingMessage, ServerResponse } from 'http';
+
+type UniverseRecord = {
+    state: any;
+    version: number;
+};
+type ZunoStateListener = (event: ZunoStateEvent) => void;
+declare const getUniverseRecord: (storeKey: string) => UniverseRecord | undefined;
+declare const updateUniverseState: (event: ZunoStateEvent) => void;
+declare const getUniverseState: () => {
+    [k: string]: UniverseRecord;
+};
+declare const appendEvent: (event: ZunoStateEvent) => ZunoStateEvent;
+declare const getEventsAfter: (lastEventId: number) => ZunoStateEvent[];
+declare const getLastEventId: () => number;
+declare const subscribeToStateEvents: (listener: ZunoStateListener) => () => void;
+declare const publishToStateEvent: (event: ZunoStateEvent) => void;
+
+type ApplyResult = {
+    ok: true;
+    event: ZunoStateEvent;
+} | {
+    ok: false;
+    reason: "VERSION_CONFLICT";
+    current: {
+        state: any;
+        version: number;
+    };
+} | {
+    ok: false;
+    reason: string;
+    current?: never;
+};
+/**
+ * Validates and applies a state event to the server universe.
+ */
+declare function applyStateEvent(incoming: ZunoStateEvent): ApplyResult;
+
+type IncomingHeaders = IncomingMessage["headers"];
+/**
+ * Creates a Server-Sent Events (SSE) connection for Zuno state updates.
+ */
+declare const createSSEConnection: (req: IncomingMessage, res: ServerResponse, headers: IncomingHeaders) => void;
+/**
+ * Synchronizes the Zuno universe state by applying an incoming event.
+ */
+declare const syncUniverseState: (req: IncomingMessage, res: ServerResponse) => void;
+declare const setUniverseState: (req: IncomingMessage, res: ServerResponse) => void;
+
+/**
+ * Sends a snapshot of the current universe state to the response.
+ * Compatible with both Express and raw Node.js http.
+ */
+declare function sendSnapshot(_req: IncomingMessage, res: ServerResponse): void;
+
+export { type ApplyResult, type UniverseRecord, type ZunoStateListener, appendEvent, applyStateEvent, createSSEConnection, getEventsAfter, getLastEventId, getUniverseRecord, getUniverseState, publishToStateEvent, sendSnapshot, setUniverseState, subscribeToStateEvents, syncUniverseState, updateUniverseState };

package/dist/server/index.d.ts

@@ -1,4 +1,57 @@
-export * from "./snapshot-handler";
-export { createSSEConnection, setUniverseState } from "./sse-handler";
-export * from "./apply-state-event";
-//# sourceMappingURL=index.d.ts.map
+import { f as ZunoStateEvent } from '../index-IbvF6TBr.js';
+import { IncomingMessage, ServerResponse } from 'http';
+
+type UniverseRecord = {
+    state: any;
+    version: number;
+};
+type ZunoStateListener = (event: ZunoStateEvent) => void;
+declare const getUniverseRecord: (storeKey: string) => UniverseRecord | undefined;
+declare const updateUniverseState: (event: ZunoStateEvent) => void;
+declare const getUniverseState: () => {
+    [k: string]: UniverseRecord;
+};
+declare const appendEvent: (event: ZunoStateEvent) => ZunoStateEvent;
+declare const getEventsAfter: (lastEventId: number) => ZunoStateEvent[];
+declare const getLastEventId: () => number;
+declare const subscribeToStateEvents: (listener: ZunoStateListener) => () => void;
+declare const publishToStateEvent: (event: ZunoStateEvent) => void;
+
+type ApplyResult = {
+    ok: true;
+    event: ZunoStateEvent;
+} | {
+    ok: false;
+    reason: "VERSION_CONFLICT";
+    current: {
+        state: any;
+        version: number;
+    };
+} | {
+    ok: false;
+    reason: string;
+    current?: never;
+};
+/**
+ * Validates and applies a state event to the server universe.
+ */
+declare function applyStateEvent(incoming: ZunoStateEvent): ApplyResult;
+
+type IncomingHeaders = IncomingMessage["headers"];
+/**
+ * Creates a Server-Sent Events (SSE) connection for Zuno state updates.
+ */
+declare const createSSEConnection: (req: IncomingMessage, res: ServerResponse, headers: IncomingHeaders) => void;
+/**
+ * Synchronizes the Zuno universe state by applying an incoming event.
+ */
+declare const syncUniverseState: (req: IncomingMessage, res: ServerResponse) => void;
+declare const setUniverseState: (req: IncomingMessage, res: ServerResponse) => void;
+
+/**
+ * Sends a snapshot of the current universe state to the response.
+ * Compatible with both Express and raw Node.js http.
+ */
+declare function sendSnapshot(_req: IncomingMessage, res: ServerResponse): void;
+
+export { type ApplyResult, type UniverseRecord, type ZunoStateListener, appendEvent, applyStateEvent, createSSEConnection, getEventsAfter, getLastEventId, getUniverseRecord, getUniverseState, publishToStateEvent, sendSnapshot, setUniverseState, subscribeToStateEvents, syncUniverseState, updateUniverseState };

package/dist/server/index.js

@@ -1,3 +1,17 @@
-export * from "./snapshot-handler";
-export { createSSEConnection, setUniverseState } from "./sse-handler";
-export * from "./apply-state-event";
+var p=new Map,f=t=>p.get(t),d=t=>{let e=p.get(t.storeKey)??{version:0},o=typeof t.version=="number"?t.version:e.version+1;p.set(t.storeKey,{state:t.state,version:o});},c=()=>Object.fromEntries(p),h=1e3,x=1,a=[],S=t=>(t.eventId=x++,a.push(t),a.length>h&&a.shift(),t),y=t=>a.filter(e=>(e?.eventId??0)>t),g=()=>a[a.length-1]?.eventId??0,v=new Set,l=t=>(v.add(t),()=>{v.delete(t);}),m=t=>{v.forEach(e=>e(t));};function E(t){let e=f(t.storeKey)??{state:void 0,version:0};if(typeof t.baseVersion=="number"&&t.baseVersion!==e.version)return {ok:false,reason:"VERSION_CONFLICT",current:e};let o=e.version+1,n={...t,version:o};return d(n),S(n),m(n),{ok:true,event:n}}var A=(t,e,o)=>{e.writeHead(200,{"Cache-Control":"no-cache, no-transform","Content-Type":"text/event-stream; charset=utf-8",Connection:"keep-alive","X-Accel-Buffering":"no",...o}),e.flushHeaders?.();let n=t.headers["last-event-id"]||new URL(t.url||"","http://localhost").searchParams.get("lastEventId"),r=Number.parseInt(Array.isArray(n)?n[0]:n??"0",10)||0;if(r>0){let i=y(r);for(let u of i)e.write(`id: ${u.eventId}
+`),e.write(`event: state
+`),e.write(`data: ${JSON.stringify(u)}
+
+`);}else e.write(`event: snapshot
+`),e.write(`data: ${JSON.stringify(c())}
+
+`);let s=l(i=>{e.write(`id: ${i.eventId}
+`),e.write(`event: state
+`),e.write(`data: ${JSON.stringify(i)}
+
+`);}),I=setInterval(()=>{e.write(`: ping ${Date.now()}
+
+`);},15e3);e.write(`: connected 
+
+`),t.on("close",()=>{clearInterval(I),s(),e.end();});},O=(t,e)=>{let n="";t.on("data",r=>{n+=r.toString("utf8"),n.length>524288&&(e.writeHead(413,{"Content-Type":"application/json"}),e.end(JSON.stringify({ok:false,reason:"PAYLOAD_TOO_LARGE"})),t.destroy());}),t.on("end",()=>{try{let r=JSON.parse(n||"{}"),s=E(r);if(!s.ok){s.reason==="VERSION_CONFLICT"&&(e.writeHead(409,{"Content-Type":"application/json"}),e.end(JSON.stringify({ok:!1,reason:"VERSION_CONFLICT",current:s.current})));return}e.writeHead(200,{"Content-Type":"application/json"}),e.end(JSON.stringify({ok:!0,event:s.event}));}catch{e.writeHead(400,{"Content-Type":"application/json"}),e.end(JSON.stringify({ok:false,reason:"INVALID_JSON"}));}});},L=(t,e)=>O(t,e);function k(t,e){let o={state:c(),lastEventId:g()};"json"in e&&typeof e.json=="function"?e.json(o):(e.writeHead(200,{"Content-Type":"application/json"}),e.end(JSON.stringify(o)));}export{S as appendEvent,E as applyStateEvent,A as createSSEConnection,y as getEventsAfter,g as getLastEventId,f as getUniverseRecord,c as getUniverseState,m as publishToStateEvent,k as sendSnapshot,L as setUniverseState,l as subscribeToStateEvents,O as syncUniverseState,d as updateUniverseState};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/core.ts","../../src/server/apply-state-event.ts","../../src/server/sse-handler.ts","../../src/server/snapshot-handler.ts"],"names":["universeState","getUniverseRecord","storeKey","updateUniverseState","event","current","nextVersion","getUniverseState","MAX_EVENTS","nextEventId","eventLog","appendEvent","getEventsAfter","lastEventId","getLastEventId","listeners","subscribeToStateEvents","listener","publishToStateEvent","applyStateEvent","incoming","createSSEConnection","req","res","headers","raw","missed","unsubscribe","heartbeat","syncUniverseState","body","chunk","result","setUniverseState","sendSnapshot","_req","snapshot"],"mappings":"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","file":"index.js","sourcesContent":["import type { ZunoStateEvent } from \"../sync\";\n\n// --- Types ---\n\nexport type UniverseRecord = {\n  state: any;\n  version: number;\n};\n\nexport type ZunoStateListener = (event: ZunoStateEvent) => void;\n\n// --- State Store ---\n\nconst universeState = new Map<string, UniverseRecord>();\n\nexport const getUniverseRecord = (storeKey: string): UniverseRecord | undefined => {\n  return universeState.get(storeKey);\n};\n\nexport const updateUniverseState = (event: ZunoStateEvent) => {\n  const current = universeState.get(event.storeKey) ?? { state: undefined, version: 0 };\n  const nextVersion = typeof event.version === \"number\" ? event.version : current.version + 1;\n  universeState.set(event.storeKey, { state: event.state, version: nextVersion });\n};\n\nexport const getUniverseState = () => {\n  return Object.fromEntries(universeState);\n};\n\n// --- Event Log ---\n\nconst MAX_EVENTS = 1000;\nlet nextEventId = 1;\nconst eventLog: ZunoStateEvent[] = [];\n\nexport const appendEvent = (event: ZunoStateEvent) => {\n  event.eventId = nextEventId++;\n  eventLog.push(event);\n  if (eventLog.length > MAX_EVENTS) {\n    eventLog.shift();\n  }\n  return event;\n};\n\nexport const getEventsAfter = (lastEventId: number) => {\n  return eventLog.filter((event) => (event?.eventId ?? 0) > lastEventId);\n};\n\nexport const getLastEventId = () => {\n  return eventLog[eventLog.length - 1]?.eventId ?? 0;\n};\n\n// --- State Bus (Events) ---\n\nconst listeners = new Set<ZunoStateListener>();\n\nexport const subscribeToStateEvents = (listener: ZunoStateListener) => {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n};\n\nexport const publishToStateEvent = (event: ZunoStateEvent) => {\n  listeners.forEach((listener) => listener(event));\n};\n","import { getUniverseRecord, updateUniverseState, publishToStateEvent, appendEvent } from \"./core\";\nimport type { ZunoStateEvent } from \"../sync\";\n\nexport type ApplyResult = \n  | { ok: true; event: ZunoStateEvent }\n  | { ok: false; reason: \"VERSION_CONFLICT\"; current: { state: any; version: number } }\n  | { ok: false; reason: string; current?: never };\n\n/**\n * Validates and applies a state event to the server universe.\n */\nexport function applyStateEvent(incoming: ZunoStateEvent): ApplyResult {\n  const current = getUniverseRecord(incoming.storeKey) ?? { state: undefined, version: 0 };\n\n  // Strict version check\n  if (typeof incoming.baseVersion === \"number\" && incoming.baseVersion !== current.version) {\n    return { ok: false, reason: \"VERSION_CONFLICT\", current };\n  }\n\n  // Increment version\n  const nextVersion = current.version + 1;\n  const event = { ...incoming, version: nextVersion };\n\n  // Persistence\n  updateUniverseState(event);\n  appendEvent(event);\n\n  // Notify SSE subscribers\n  publishToStateEvent(event);\n\n  return { ok: true, event };\n}\n","import { subscribeToStateEvents } from \"./core\";\nimport { getUniverseState } from \"./core\";\nimport { getEventsAfter } from \"./core\";\nimport type { ZunoStateEvent } from \"../sync\";\nimport type { IncomingMessage, ServerResponse } from \"http\";\nimport { applyStateEvent } from \"./apply-state-event\";\n\ntype IncomingHeaders = IncomingMessage[\"headers\"];\n\n/**\n * Creates a Server-Sent Events (SSE) connection for Zuno state updates.\n */\nexport const createSSEConnection = (req: IncomingMessage, res: ServerResponse, headers: IncomingHeaders) => {\n  res.writeHead(200, {\n    \"Cache-Control\": \"no-cache, no-transform\",\n    \"Content-Type\": \"text/event-stream; charset=utf-8\",\n    Connection: \"keep-alive\",\n    \"X-Accel-Buffering\": \"no\",\n    ...headers\n  });\n\n  res.flushHeaders?.();\n\n  const raw = req.headers[\"last-event-id\"] || new URL(req.url || \"\", \"http://localhost\").searchParams.get(\"lastEventId\");\n  const lastEventId = Number.parseInt(Array.isArray(raw) ? raw[0] : (raw ?? \"0\"), 10) || 0;\n\n  if (lastEventId > 0) {\n    const missed = getEventsAfter(lastEventId);\n    for (const event of missed) {\n      res.write(`id: ${event.eventId}\\n`);\n      res.write(`event: state\\n`);\n      res.write(`data: ${JSON.stringify(event)}\\n\\n`);\n    }\n  } else {\n    res.write(`event: snapshot\\n`);\n    res.write(`data: ${JSON.stringify(getUniverseState())}\\n\\n`);\n  }\n\n  const unsubscribe = subscribeToStateEvents((event: ZunoStateEvent) => {\n    res.write(`id: ${event.eventId}\\n`);\n    res.write(`event: state\\n`);\n    res.write(`data: ${JSON.stringify(event)}\\n\\n`);\n  });\n\n  const heartbeat = setInterval(() => {\n    res.write(`: ping ${Date.now()}\\n\\n`);\n  }, 15000);\n\n  res.write(\": connected \\n\\n\");\n\n  req.on(\"close\", () => {\n    clearInterval(heartbeat);\n    unsubscribe();\n    res.end();\n  });\n};\n\n/**\n * Synchronizes the Zuno universe state by applying an incoming event.\n */\nexport const syncUniverseState = (req: IncomingMessage, res: ServerResponse) => {\n  const MAX_BODY_BYTES = 512 * 1024; // 512KB safety\n  let body = \"\";\n\n  req.on(\"data\", (chunk: Buffer) => {\n    body += chunk.toString(\"utf8\");\n    if (body.length > MAX_BODY_BYTES) {\n      res.writeHead(413, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ ok: false, reason: \"PAYLOAD_TOO_LARGE\" }));\n      req.destroy();\n    }\n  });\n\n  req.on(\"end\", () => {\n    try {\n      const incoming: ZunoStateEvent = JSON.parse(body || \"{}\") as any;\n      const result = applyStateEvent(incoming);\n\n      if (!result.ok) {\n        if (result.reason === \"VERSION_CONFLICT\") {\n          res.writeHead(409, { \"Content-Type\": \"application/json\" });\n          res.end(JSON.stringify({ ok: false, reason: \"VERSION_CONFLICT\", current: result.current }));\n        }\n        return;\n      }\n\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ ok: true, event: result.event }));\n    } catch {\n      res.writeHead(400, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ ok: false, reason: \"INVALID_JSON\" }));\n    }\n  });\n};\n\nexport const setUniverseState = (req: IncomingMessage, res: ServerResponse) => {\n  return syncUniverseState(req, res);\n};\n","import type { IncomingMessage, ServerResponse } from \"http\";\nimport { getUniverseState, getLastEventId } from \"./core\";\n\n/**\n * Sends a snapshot of the current universe state to the response.\n * Compatible with both Express and raw Node.js http.\n */\nexport function sendSnapshot(_req: IncomingMessage, res: ServerResponse) {\n  const snapshot = {\n    state: getUniverseState(),\n    lastEventId: getLastEventId(),\n  };\n\n  // Check for Express-like .json() method\n  if (\"json\" in res && typeof (res as any).json === \"function\") {\n    (res as any).json(snapshot);\n  } else {\n    res.writeHead(200, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify(snapshot));\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iadev93/zuno",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "author": "Ibrahim Aftab",
   "license": "MIT",
   "type": "module",
@@ -21,9 +21,6 @@
       "default": "./dist/server/index.js"
     }
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.json"
-  },
   "keywords": [
     "state",
     "state-management",
@@ -40,5 +37,12 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/IADev-Channel/zuno.git"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
   }
-}
+}

package/dist/core/createZuno.d.ts

@@ -1,77 +0,0 @@
-import type { ZunoStateEvent } from "../sync/sync-types";
-import type { Universe, ZunoSnapshot } from "./types";
-/** Store */
-type ZunoStore<T> = {
-    get(): T;
-    set(next: T): void;
-    subscribe(cb: (state: T) => void): () => void;
-};
-export type CreateZunoOptions = {
-    /** Universe */
-    universe?: Universe;
-    /** Optional transports */
-    channelName?: string;
-    /** SSE */
-    sseUrl?: string;
-    /** Sync */
-    syncUrl?: string;
-    /** Behavior */
-    optimistic?: boolean;
-    /** Client ID */
-    clientId?: string;
-};
-/**
- * Creates a Zuno instance, which provides a state management system with optional synchronization
- * capabilities via Server-Sent Events (SSE) and BroadcastChannel.
- *
- * @param opts - Configuration options for the Zuno instance.
- * @param opts.universe - An optional pre-existing ZunoUniverse instance. If not provided, a new one will be created.
- * @param opts.channelName - An optional name for the BroadcastChannel to enable local tab synchronization.
- * @param opts.sseUrl - The URL for the Server-Sent Events endpoint to receive state updates from a server.
- * @param opts.syncUrl - The URL for the synchronization endpoint to send state updates to a server. Required if `sseUrl` is provided.
- * @param opts.optimistic - A boolean indicating whether state updates should be applied optimistically before server confirmation. Defaults to `true`.
- * @param opts.clientId - A unique identifier for the client. If not provided, a random UUID will be generated.
- * @returns An object containing methods to interact with the Zuno instance, including `getStore`, `destroy`, and `broadcast`.
- */
-export declare const createZuno: (opts?: CreateZunoOptions) => {
-    /** Universe */
-    universe: Universe;
-    /** Client ID */
-    clientId: string;
-    /** Get store */
-    getStore: <T>(storeKey: string, init: () => T) => import("./types").Store<T>;
-    /** Create store */
-    store: <T>(storeKey: string, init: () => T) => {
-        key: string;
-        get: () => T;
-        set: (next: T | ((prev: T) => T)) => Promise<any>;
-        subscribe: (cb: (state: T) => void) => () => void;
-        raw: () => ZunoStore<T>;
-    };
-    /** Get state */
-    get: <T>(storeKey: string, init?: () => T) => T;
-    /** Set state */
-    set: <T>(storeKey: string, next: T | ((prev: T) => T), init?: () => T) => Promise<{
-        ok: boolean;
-        status: number;
-        json: any;
-    }>;
-    /** Subscribe to store */
-    subscribe: <T>(storeKey: string, init: () => T, cb: (state: T) => void) => () => boolean;
-    /** Dispatch event */
-    dispatch: (event: ZunoStateEvent) => Promise<{
-        ok: boolean;
-        status: number;
-        json: any;
-    }>;
-    /** Stop */
-    stop: () => void;
-    /** Hydrate snapshot */
-    hydrateSnapshot: (snapshot: ZunoSnapshot) => void;
-    /** Get last event ID */
-    getLastEventId: () => number;
-    /** Set last event ID */
-    setLastEventId: (id: number) => void;
-};
-export {};
-//# sourceMappingURL=createZuno.d.ts.map

package/dist/core/createZuno.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"createZuno.d.ts","sourceRoot":"","sources":["../../src/core/createZuno.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEtD,YAAY;AACZ,KAAK,SAAS,CAAC,CAAC,IAAI;IAClB,GAAG,IAAI,CAAC,CAAC;IACT,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,WAAW;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,eAAe;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,GAAI,OAAM,iBAAsB;IAmRnD,eAAe;;IAEf,gBAAgB;;IAIhB,gBAAgB;eAlIA,CAAC,YAAa,MAAM,QAAQ,MAAM,CAAC;IAoInD,mBAAmB;YArBN,CAAC,YAAa,MAAM,QAAQ,MAAM,CAAC;aAb3C,MAAM;;6CAE0B,OAAO,CAAC,GAAG,CAAC;sCACnB,IAAI,KAAK,MAAM,IAAI;;;IAiCjD,gBAAgB;UA7HL,CAAC,YAAa,MAAM,SAAS,MAAM,CAAC,KAAG,CAAC;IA+HnD,gBAAgB;UAhFC,CAAC,YACR,MAAM,QACV,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,SACnB,MAAM,CAAC;;;;;IA+Ed,yBAAyB;gBA1DR,CAAC,YACR,MAAM,QACV,MAAM,CAAC,MACT,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IA2DtB,qBAAqB;sBA7HQ,cAAc;;;;;IA+H3C,WAAW;;IAGX,uBAAuB;gCAhRU,YAAY;IAkR7C,wBAAwB;;IAExB,wBAAwB;yBA3PE,MAAM;CA8PnC,CAAC"}

package/dist/core/createZuno.js

@@ -1,250 +0,0 @@
-import { createUniverse } from "./universe";
-import { startSSE } from "../sync/sse-client";
-import { startBroadcastChannel } from "../sync/broadcast-channel";
-import { applyIncomingEvent } from "../sync/apply-incoming-event";
-/**
- * Creates a Zuno instance, which provides a state management system with optional synchronization
- * capabilities via Server-Sent Events (SSE) and BroadcastChannel.
- *
- * @param opts - Configuration options for the Zuno instance.
- * @param opts.universe - An optional pre-existing ZunoUniverse instance. If not provided, a new one will be created.
- * @param opts.channelName - An optional name for the BroadcastChannel to enable local tab synchronization.
- * @param opts.sseUrl - The URL for the Server-Sent Events endpoint to receive state updates from a server.
- * @param opts.syncUrl - The URL for the synchronization endpoint to send state updates to a server. Required if `sseUrl` is provided.
- * @param opts.optimistic - A boolean indicating whether state updates should be applied optimistically before server confirmation. Defaults to `true`.
- * @param opts.clientId - A unique identifier for the client. If not provided, a random UUID will be generated.
- * @returns An object containing methods to interact with the Zuno instance, including `getStore`, `destroy`, and `broadcast`.
- */
-export const createZuno = (opts = {}) => {
-    /** Local state */
-    const localState = new Map();
-    /** Local per-store versions (for BC / local ordering) */
-    const versions = new Map();
-    /** Universe */
-    const universe = (opts.universe ?? (createUniverse()));
-    /** Unique client ID */
-    const clientId = opts.clientId ?? (globalThis.crypto?.randomUUID?.() ?? String(Math.random()));
-    /** SSE ready */
-    let sseReady = false;
-    /** Last event ID */
-    let lastEventId = 0;
-    /**
-     * Hydrate snapshot
-     * @param snapshot - The snapshot to hydrate.
-     */
-    function hydrateSnapshot(snapshot) {
-        const plain = {};
-        for (const [k, rec] of Object.entries(snapshot.state)) {
-            plain[k] = rec.state;
-            versions.set(k, rec.version);
-        }
-        universe.restore(plain);
-        lastEventId = snapshot.lastEventId;
-    }
-    /**
-     * Get store base version
-     * @param storeKey - The key of the store to get the base version for.
-     */
-    function getStoreBaseVersion(storeKey) { return versions.get(storeKey) ?? 0; }
-    /**
-     * Get last event ID
-     */
-    function getLastEventId() { return lastEventId; }
-    /**
-     * Set last event ID
-     * @param id - The new last event ID.
-     */
-    function setLastEventId(id) { lastEventId = id; }
-    /** SSE Prefer server sync if provided */
-    const sse = opts.sseUrl && opts.syncUrl
-        ? startSSE({
-            universe,
-            url: opts.sseUrl,
-            syncUrl: opts.syncUrl,
-            optimistic: opts.optimistic ?? true,
-            clientId,
-            versions,
-            getLastEventId: () => lastEventId,
-            onOpen: () => {
-                sseReady = true;
-            },
-            onClose: () => {
-                sseReady = false;
-            },
-        })
-        : null;
-    /** Apply event to target */
-    const apply = (event) => {
-        /** Update last event ID */
-        if (typeof event.eventId === "number")
-            lastEventId = Math.max(lastEventId, event.eventId);
-        applyIncomingEvent(universe, event, { clientId, localState, versions });
-    };
-    /** Broadcast Channel for local tab sync */
-    const bc = opts.channelName
-        ? startBroadcastChannel({
-            /** Channel name for BroadcastChannel */
-            channelName: opts.channelName,
-            /** Unique client ID */
-            clientId,
-            /** Apply event to target */
-            onEvent: (ev) => {
-                apply(ev);
-            },
-            /** Get snapshot of local state */
-            getSnapshot: () => {
-                /** Snapshot */
-                const snap = universe.snapshot();
-                /** Snapshot */
-                const out = {};
-                /** Iterate local state */
-                for (const [storeKey, state] of Object.entries(snap)) {
-                    /** Add to snapshot */
-                    out[storeKey] = {
-                        state,
-                        version: versions.get(storeKey) ?? 0,
-                    };
-                }
-                return out;
-            },
-            /** Apply snapshot to target */
-            onSnapshot: (snap) => {
-                /** Iterate snapshot with store key and record */
-                for (const [storeKey, rec] of Object.entries(snap)) {
-                    /** Record */
-                    const record = rec;
-                    /** Get the universe store state or the store state */
-                    const state = record?.state ?? record;
-                    /** Get the universe store version or the store version */
-                    const version = typeof record?.version === "number" ? record.version : 0;
-                    /** Set the latest version */
-                    // versions.set(storeKey, Math.max(versions.get(storeKey) ?? 0, version));
-                    /** Apply the event */
-                    apply({ storeKey, state, version });
-                }
-            },
-        })
-        : null;
-    /** Immediately ask other tabs for snapshot (BC-first) */
-    setTimeout(() => bc?.hello(), 0);
-    /** Store factory
-     * @param storeKey - The key of the store to get.
-     * @param init - The initialization function for the store.
-     * @returns The store.
-    */
-    const getStore = (storeKey, init) => {
-        return universe.getStore(storeKey, init);
-    };
-    /** Get store by store key
-     * @param storeKey - The key of the store to get.
-     * @param init - The initialization function for the store.
-     * @returns The state of the store.
-    */
-    const get = (storeKey, init) => {
-        return universe.getStore(storeKey, init ?? (() => undefined)).get();
-    };
-    /** Dispatch event to universe
-     * @param event - The event to dispatch.
-     * @returns A promise that resolves to the result of the dispatch.
-    */
-    const dispatch = async (event) => {
-        /** Check if SSE is enabled */
-        if (sse && sseReady) {
-            /** Payload with origin */
-            const payload = { ...event, origin: clientId, baseVersion: getStoreBaseVersion(event.storeKey) };
-            /** Dispatch to SSE */
-            return await sse.dispatch(payload);
-        }
-        /** Current version */
-        const current = versions.get(event.storeKey) ?? 0;
-        /** Next version */
-        const nextVersion = current + 1;
-        /** Apply event with next version */
-        apply({ ...event, version: nextVersion });
-        /** Set version */
-        versions.set(event.storeKey, nextVersion);
-        /** Check if BroadcastChannel is enabled */
-        if (bc) {
-            /** Publish event */
-            bc.publish({ ...event, version: nextVersion, origin: clientId });
-        }
-        /** Return success */
-        return { ok: true, status: 200, json: null };
-    };
-    /** Set store state
-     * @param storeKey - The key of the store to set.
-     * @param next - The new state to set.
-     * @param init - The initialization function for the store.
-     * @returns A promise that resolves to the result of the dispatch.
-    */
-    const set = async (storeKey, next, init) => {
-        /** Get store */
-        const store = universe.getStore(storeKey, init ?? (() => undefined));
-        /** Get previous state */
-        const prev = store.get();
-        /** Get next state */
-        const state = typeof next === "function" ? next(prev) : next;
-        /** Dispatch event */
-        return dispatch({ storeKey, state });
-    };
-    /** Subscribe to store
-     * @param storeKey - The key of the store to subscribe to.
-     * @param init - The initialization function for the store.
-     * @param cb - The callback function to be called when the store state changes.
-     * @returns A function to unsubscribe from the store.
-    */
-    const subscribe = (storeKey, init, cb) => {
-        /** Get store */
-        const store = universe.getStore(storeKey, init);
-        return store.subscribe(cb);
-    };
-    /** Stop cleanup */
-    const stop = () => {
-        sse?.unsubscribe?.();
-        bc?.stop?.();
-    };
-    /**
-     * Creates a bound store for a specific key.
-     * @param storeKey The key of the store to create.
-     * @param init The initialization function for the store.
-     * @returns A BoundStore object representing the store.
-     */
-    const store = (storeKey, init) => {
-        const rawStore = getStore(storeKey, init);
-        return {
-            key: storeKey,
-            raw: () => rawStore,
-            get: () => rawStore.get(),
-            subscribe: (cb) => rawStore.subscribe(cb),
-            set: (next) => set(storeKey, next, init),
-        };
-    };
-    return {
-        /** Universe */
-        universe,
-        /** Client ID */
-        clientId,
-        // ------------ DX ------------ \\
-        /** Get store */
-        getStore,
-        /** Create store */
-        store,
-        /** Get state */
-        get,
-        /** Set state */
-        set,
-        /** Subscribe to store */
-        subscribe,
-        // ------------ Advanced ------------ \\
-        /** Dispatch event */
-        dispatch,
-        /** Stop */
-        stop,
-        /** Hydrate snapshot */
-        hydrateSnapshot,
-        /** Get last event ID */
-        getLastEventId,
-        /** Set last event ID */
-        setLastEventId,
-    };
-};

package/dist/core/store.d.ts

@@ -1,10 +0,0 @@
-import type { Store } from "./types";
-/**
- * Creates a ZUNO state management store.
- *
- * @template T The type of the state managed by the store.
- * @param {T} initial The initial state value.
- * @returns {Store<T>} An object containing methods to interact with the store.
- */
-export declare const createStore: <T>(initial: T) => Store<T>;
-//# sourceMappingURL=store.d.ts.map

package/dist/core/store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/core/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,SAAS,CAAC,KAAG,KAAK,CAAC,CAAC,CAsBlD,CAAC"}

package/dist/core/store.js

@@ -1,27 +0,0 @@
-/**
- * Creates a ZUNO state management store.
- *
- * @template T The type of the state managed by the store.
- * @param {T} initial The initial state value.
- * @returns {Store<T>} An object containing methods to interact with the store.
- */
-export const createStore = (initial) => {
-    let state = initial;
-    const listeners = new Set();
-    return {
-        get: () => state,
-        set: (next) => {
-            const value = typeof next === "function"
-                ? next(state)
-                : next;
-            if (Object.is(value, state))
-                return;
-            state = value;
-            listeners.forEach((l) => l(state));
-        },
-        subscribe: (listener) => {
-            listeners.add(listener);
-            return () => listeners.delete(listener);
-        }
-    };
-};