@motiadev/stream-client 0.13.0-beta.162-080298 → 0.13.0-beta.162-660221

package/LICENSE

@@ -1,93 +1,21 @@
-Elastic License 2.0
-
-URL: https://www.elastic.co/licensing/elastic-license
-
-## Acceptance
-
-By using the software, you agree to all of the terms and conditions below.
-
-## Copyright License
-
-The licensor grants you a non-exclusive, royalty-free, worldwide,
-non-sublicensable, non-transferable license to use, copy, distribute, make
-available, and prepare derivative works of the software, in each case subject
-to the limitations and conditions below.
-
-## Limitations
-
-You may not provide the software to third parties as a hosted or managed
-service, where the service provides users with access to any substantial set of
-the features or functionality of the software.
-
-You may not move, change, disable, or circumvent the license key functionality
-in the software, and you may not remove or obscure any functionality in the
-software that is protected by the license key.
-
-You may not alter, remove, or obscure any licensing, copyright, or other notices
-of the licensor in the software. Any use of the licensor's trademarks is subject
-to applicable law.
-
-## Patents
-
-The licensor grants you a license, under any patent claims the licensor can
-license, or becomes able to license, to make, have made, use, sell, offer for
-sale, import and have imported the software, in each case subject to the
-limitations and conditions in this license. This license does not cover any
-patent claims that you cause to be infringed by modifications or additions to
-the software. If you or your company make any written claim that the software
-infringes or contributes to infringement of any patent, your patent license for
-the software granted under these terms ends immediately. If your company makes
-such a claim, your patent license ends immediately for work on behalf of your
-company.
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you
-also gets a copy of these terms.
-
-If you modify the software, you must include in any modified copies of the
-software prominent notices stating that you have modified the software.
-
-## No Other Rights
-
-These terms do not imply any licenses other than those expressly granted in
-these terms.
-
-## Termination
-
-If you use the software in violation of these terms, such use is not licensed,
-and your licenses will automatically terminate. If the licensor provides you
-with a notice of your violation, and you cease all violation of this license no
-later than 30 days after you receive that notice, your licenses will be
-reinstated retroactively. However, if you violate these terms after such
-reinstatement, any additional violation of these terms will cause your licenses
-to terminate automatically and permanently.
-
-## No Liability
-
-*As far as the law allows, the software comes as is, without any warranty or
-condition, and the licensor will not be liable to you for any damages arising
-out of these terms or the use or nature of the software, under any kind of
-legal claim.*
-
-## Definitions
-
-The **licensor** is the entity offering these terms, and the **software** is the
-software the licensor makes available under these terms, including any portion
-of it.
-
-**you** refers to the individual or entity agreeing to these terms.
-
-**your company** is any legal entity, sole proprietorship, or other kind of
-organization that you work for, plus all organizations that have control over,
-are under the control of, or are under common control with that organization.
-**control** means ownership of substantially all the assets of an entity, or the
-power to direct its management and policies by vote, contract, or otherwise.
-Control can be direct or indirect.
-
-**your licenses** are all the licenses granted to you for the software under
-these terms.
-
-**use** means anything you do with the software requiring one of your licenses.
-
-**trademark** means trademarks, service marks, and similar rights.
+MIT License
+
+Copyright (c) 2025 Motia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/__mocks__/uuid.ts

@@ -0,0 +1,10 @@
+let counter = 0
+
+export const v4 = (): string => {
+  counter++
+  return `00000000-0000-0000-0000-${counter.toString().padStart(12, '0')}`
+}
+
+export default {
+  v4,
+}

package/dist/index.d.mts

@@ -0,0 +1,8 @@
+import { SocketAdapter } from "./src/socket-adapter.mjs";
+import { SocketAdapterFactory } from "./src/adapter-factory.mjs";
+import { BaseMessage, CustomEvent, CustomEventListener, GroupEventMessage, GroupStreamEvent, ItemEventMessage, ItemStreamEvent, JoinMessage, Listener, Message, StreamEvent } from "./src/stream.types.mjs";
+import { StreamSubscription } from "./src/stream-subscription.mjs";
+import { StreamGroupSubscription } from "./src/stream-group.mjs";
+import { StreamItemSubscription } from "./src/stream-item.mjs";
+import { Stream } from "./src/stream.mjs";
+export { BaseMessage, CustomEvent, CustomEventListener, GroupEventMessage, GroupStreamEvent, ItemEventMessage, ItemStreamEvent, JoinMessage, Listener, Message, type SocketAdapter, type SocketAdapterFactory, Stream, StreamEvent, StreamGroupSubscription, StreamItemSubscription, StreamSubscription };

package/dist/index.mjs

@@ -0,0 +1,6 @@
+import { StreamSubscription } from "./src/stream-subscription.mjs";
+import { StreamGroupSubscription } from "./src/stream-group.mjs";
+import { StreamItemSubscription } from "./src/stream-item.mjs";
+import { Stream } from "./src/stream.mjs";
+
+export { Stream, StreamGroupSubscription, StreamItemSubscription, StreamSubscription };

package/dist/src/adapter-factory.d.mts

@@ -0,0 +1,7 @@
+import { SocketAdapter } from "./socket-adapter.mjs";
+
+//#region src/adapter-factory.d.ts
+type SocketAdapterFactory = () => SocketAdapter;
+//#endregion
+export { SocketAdapterFactory };
+//# sourceMappingURL=adapter-factory.d.mts.map

package/dist/src/socket-adapter.d.mts

@@ -0,0 +1,13 @@
+//#region src/socket-adapter.d.ts
+interface SocketAdapter {
+  connect(): void;
+  close(): void;
+  send(message: string): void;
+  isOpen(): boolean;
+  onMessage(callback: (message: string) => void): void;
+  onOpen(callback: () => void): void;
+  onClose(callback: () => void): void;
+}
+//#endregion
+export { SocketAdapter };
+//# sourceMappingURL=socket-adapter.d.mts.map

package/dist/src/stream-group.d.mts

@@ -0,0 +1,18 @@
+import { GroupEventMessage, JoinMessage } from "./stream.types.mjs";
+import { StreamSubscription } from "./stream-subscription.mjs";
+
+//#region src/stream-group.d.ts
+declare class StreamGroupSubscription<TData extends {
+  id: string;
+}> extends StreamSubscription<TData[], GroupEventMessage<TData>> {
+  private sortKey?;
+  private lastTimestamp;
+  private lastTimestampMap;
+  constructor(sub: JoinMessage, sortKey?: keyof TData | undefined);
+  private sort;
+  protected setState(state: TData[]): void;
+  listener(message: GroupEventMessage<TData>): void;
+}
+//#endregion
+export { StreamGroupSubscription };
+//# sourceMappingURL=stream-group.d.mts.map

package/dist/src/stream-group.mjs

@@ -0,0 +1,55 @@
+import { StreamSubscription } from "./stream-subscription.mjs";
+
+//#region src/stream-group.ts
+var StreamGroupSubscription = class extends StreamSubscription {
+	constructor(sub, sortKey) {
+		super(sub, []);
+		this.sortKey = sortKey;
+		this.lastTimestamp = 0;
+		this.lastTimestampMap = /* @__PURE__ */ new Map();
+	}
+	sort(state) {
+		const sortKey = this.sortKey;
+		if (sortKey) return state.sort((a, b) => {
+			const aValue = a[sortKey];
+			const bValue = b[sortKey];
+			if (aValue && bValue) return aValue.toString().localeCompare(bValue.toString());
+			return 0;
+		});
+		return state;
+	}
+	setState(state) {
+		super.setState(this.sort(state));
+	}
+	listener(message) {
+		if (message.event.type === "sync") {
+			if (message.timestamp < this.lastTimestamp) return;
+			this.lastTimestampMap = /* @__PURE__ */ new Map();
+			this.lastTimestamp = message.timestamp;
+			this.setState(message.event.data);
+		} else if (message.event.type === "create") {
+			const id = message.event.data.id;
+			const state = this.getState();
+			if (!state.find((item) => item.id === id)) this.setState([...state, message.event.data]);
+		} else if (message.event.type === "update") {
+			const messageData = message.event.data;
+			const messageDataId = messageData.id;
+			const state = this.getState();
+			const currentItemTimestamp = this.lastTimestampMap.get(messageDataId);
+			if (currentItemTimestamp && currentItemTimestamp >= message.timestamp) return;
+			this.lastTimestamp = message.timestamp;
+			this.lastTimestampMap.set(messageDataId, message.timestamp);
+			this.setState(state.map((item) => item.id === messageDataId ? messageData : item));
+		} else if (message.event.type === "delete") {
+			const messageDataId = message.event.data.id;
+			const state = this.getState();
+			this.lastTimestamp = message.timestamp;
+			this.lastTimestampMap.set(messageDataId, message.timestamp);
+			this.setState(state.filter((item) => item.id !== messageDataId));
+		} else if (message.event.type === "event") this.onEventReceived(message.event.event);
+	}
+};
+
+//#endregion
+export { StreamGroupSubscription };
+//# sourceMappingURL=stream-group.mjs.map

package/dist/src/stream-group.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-group.mjs","names":["sortKey?: keyof TData"],"sources":["../../src/stream-group.ts"],"sourcesContent":["import type { GroupEventMessage, JoinMessage } from './stream.types'\nimport { StreamSubscription } from './stream-subscription'\n\nexport class StreamGroupSubscription<TData extends { id: string }> extends StreamSubscription<\n  TData[],\n  GroupEventMessage<TData>\n> {\n  private lastTimestamp: number = 0\n  private lastTimestampMap: Map<string, number> = new Map()\n\n  constructor(\n    sub: JoinMessage,\n    private sortKey?: keyof TData,\n  ) {\n    super(sub, [])\n  }\n\n  private sort(state: TData[]): TData[] {\n    const sortKey = this.sortKey\n\n    if (sortKey) {\n      return state.sort((a: TData, b: TData) => {\n        const aValue = a[sortKey]\n        const bValue = b[sortKey]\n\n        if (aValue && bValue) {\n          return aValue.toString().localeCompare(bValue.toString())\n        }\n\n        return 0\n      })\n    }\n\n    return state\n  }\n\n  protected setState(state: TData[]): void {\n    super.setState(this.sort(state))\n  }\n\n  listener(message: GroupEventMessage<TData>): void {\n    if (message.event.type === 'sync') {\n      if (message.timestamp < this.lastTimestamp) {\n        return\n      }\n\n      this.lastTimestampMap = new Map()\n      this.lastTimestamp = message.timestamp\n      this.setState(message.event.data)\n    } else if (message.event.type === 'create') {\n      const id = message.event.data.id\n      const state = this.getState()\n\n      if (!state.find((item) => item.id === id)) {\n        this.setState([...state, message.event.data])\n      }\n    } else if (message.event.type === 'update') {\n      const messageData = message.event.data\n      const messageDataId = messageData.id\n      const state = this.getState()\n      const currentItemTimestamp = this.lastTimestampMap.get(messageDataId)\n\n      if (currentItemTimestamp && currentItemTimestamp >= message.timestamp) {\n        return\n      }\n\n      this.lastTimestamp = message.timestamp\n      this.lastTimestampMap.set(messageDataId, message.timestamp)\n      this.setState(state.map((item) => (item.id === messageDataId ? messageData : item)))\n    } else if (message.event.type === 'delete') {\n      const messageDataId = message.event.data.id\n      const state = this.getState()\n\n      this.lastTimestamp = message.timestamp\n      this.lastTimestampMap.set(messageDataId, message.timestamp)\n      this.setState(state.filter((item) => item.id !== messageDataId))\n    } else if (message.event.type === 'event') {\n      this.onEventReceived(message.event.event)\n    }\n  }\n}\n"],"mappings":";;;AAGA,IAAa,0BAAb,cAA2E,mBAGzE;CAIA,YACE,KACA,AAAQA,SACR;AACA,QAAM,KAAK,EAAE,CAAC;EAFN;uBALsB;0CACgB,IAAI,KAAK;;CASzD,AAAQ,KAAK,OAAyB;EACpC,MAAM,UAAU,KAAK;AAErB,MAAI,QACF,QAAO,MAAM,MAAM,GAAU,MAAa;GACxC,MAAM,SAAS,EAAE;GACjB,MAAM,SAAS,EAAE;AAEjB,OAAI,UAAU,OACZ,QAAO,OAAO,UAAU,CAAC,cAAc,OAAO,UAAU,CAAC;AAG3D,UAAO;IACP;AAGJ,SAAO;;CAGT,AAAU,SAAS,OAAsB;AACvC,QAAM,SAAS,KAAK,KAAK,MAAM,CAAC;;CAGlC,SAAS,SAAyC;AAChD,MAAI,QAAQ,MAAM,SAAS,QAAQ;AACjC,OAAI,QAAQ,YAAY,KAAK,cAC3B;AAGF,QAAK,mCAAmB,IAAI,KAAK;AACjC,QAAK,gBAAgB,QAAQ;AAC7B,QAAK,SAAS,QAAQ,MAAM,KAAK;aACxB,QAAQ,MAAM,SAAS,UAAU;GAC1C,MAAM,KAAK,QAAQ,MAAM,KAAK;GAC9B,MAAM,QAAQ,KAAK,UAAU;AAE7B,OAAI,CAAC,MAAM,MAAM,SAAS,KAAK,OAAO,GAAG,CACvC,MAAK,SAAS,CAAC,GAAG,OAAO,QAAQ,MAAM,KAAK,CAAC;aAEtC,QAAQ,MAAM,SAAS,UAAU;GAC1C,MAAM,cAAc,QAAQ,MAAM;GAClC,MAAM,gBAAgB,YAAY;GAClC,MAAM,QAAQ,KAAK,UAAU;GAC7B,MAAM,uBAAuB,KAAK,iBAAiB,IAAI,cAAc;AAErE,OAAI,wBAAwB,wBAAwB,QAAQ,UAC1D;AAGF,QAAK,gBAAgB,QAAQ;AAC7B,QAAK,iBAAiB,IAAI,eAAe,QAAQ,UAAU;AAC3D,QAAK,SAAS,MAAM,KAAK,SAAU,KAAK,OAAO,gBAAgB,cAAc,KAAM,CAAC;aAC3E,QAAQ,MAAM,SAAS,UAAU;GAC1C,MAAM,gBAAgB,QAAQ,MAAM,KAAK;GACzC,MAAM,QAAQ,KAAK,UAAU;AAE7B,QAAK,gBAAgB,QAAQ;AAC7B,QAAK,iBAAiB,IAAI,eAAe,QAAQ,UAAU;AAC3D,QAAK,SAAS,MAAM,QAAQ,SAAS,KAAK,OAAO,cAAc,CAAC;aACvD,QAAQ,MAAM,SAAS,QAChC,MAAK,gBAAgB,QAAQ,MAAM,MAAM"}

package/dist/src/stream-item.d.mts

@@ -0,0 +1,14 @@
+import { ItemEventMessage, JoinMessage } from "./stream.types.mjs";
+import { StreamSubscription } from "./stream-subscription.mjs";
+
+//#region src/stream-item.d.ts
+declare class StreamItemSubscription<TData extends {
+  id: string;
+}> extends StreamSubscription<TData | null, ItemEventMessage<TData>> {
+  private lastEventTimestamp;
+  constructor(sub: JoinMessage);
+  listener(message: ItemEventMessage<TData>): void;
+}
+//#endregion
+export { StreamItemSubscription };
+//# sourceMappingURL=stream-item.d.mts.map

package/dist/src/stream-item.mjs

@@ -0,0 +1,20 @@
+import { StreamSubscription } from "./stream-subscription.mjs";
+
+//#region src/stream-item.ts
+var StreamItemSubscription = class extends StreamSubscription {
+	constructor(sub) {
+		super(sub, null);
+		this.lastEventTimestamp = 0;
+	}
+	listener(message) {
+		if (message.timestamp <= this.lastEventTimestamp) return;
+		this.lastEventTimestamp = message.timestamp;
+		if (message.event.type === "sync" || message.event.type === "create" || message.event.type === "update") this.setState(message.event.data);
+		else if (message.event.type === "delete") this.setState(null);
+		else if (message.event.type === "event") this.onEventReceived(message.event.event);
+	}
+};
+
+//#endregion
+export { StreamItemSubscription };
+//# sourceMappingURL=stream-item.mjs.map

package/dist/src/stream-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-item.mjs","names":[],"sources":["../../src/stream-item.ts"],"sourcesContent":["import type { ItemEventMessage, JoinMessage } from './stream.types'\nimport { StreamSubscription } from './stream-subscription'\n\nexport class StreamItemSubscription<TData extends { id: string }> extends StreamSubscription<\n  TData | null,\n  ItemEventMessage<TData>\n> {\n  private lastEventTimestamp = 0\n\n  constructor(sub: JoinMessage) {\n    super(sub, null)\n  }\n\n  listener(message: ItemEventMessage<TData>): void {\n    if (message.timestamp <= this.lastEventTimestamp) {\n      return\n    }\n\n    this.lastEventTimestamp = message.timestamp\n\n    if (message.event.type === 'sync' || message.event.type === 'create' || message.event.type === 'update') {\n      this.setState(message.event.data)\n    } else if (message.event.type === 'delete') {\n      this.setState(null)\n    } else if (message.event.type === 'event') {\n      this.onEventReceived(message.event.event)\n    }\n  }\n}\n"],"mappings":";;;AAGA,IAAa,yBAAb,cAA0E,mBAGxE;CAGA,YAAY,KAAkB;AAC5B,QAAM,KAAK,KAAK;4BAHW;;CAM7B,SAAS,SAAwC;AAC/C,MAAI,QAAQ,aAAa,KAAK,mBAC5B;AAGF,OAAK,qBAAqB,QAAQ;AAElC,MAAI,QAAQ,MAAM,SAAS,UAAU,QAAQ,MAAM,SAAS,YAAY,QAAQ,MAAM,SAAS,SAC7F,MAAK,SAAS,QAAQ,MAAM,KAAK;WACxB,QAAQ,MAAM,SAAS,SAChC,MAAK,SAAS,KAAK;WACV,QAAQ,MAAM,SAAS,QAChC,MAAK,gBAAgB,QAAQ,MAAM,MAAM"}

package/dist/src/stream-subscription.d.mts

@@ -0,0 +1,40 @@
+import { CustomEvent, JoinMessage, Listener } from "./stream.types.mjs";
+
+//#region src/stream-subscription.d.ts
+type CustomEventListener = (event: any) => void;
+declare abstract class StreamSubscription<TData = unknown, TEventData = unknown> {
+  private customEventListeners;
+  private closeListeners;
+  private onChangeListeners;
+  private state;
+  readonly sub: JoinMessage;
+  constructor(sub: JoinMessage, state: TData);
+  abstract listener(message: TEventData): void;
+  protected onEventReceived(event: CustomEvent): void;
+  /**
+   * Add a custom event listener. This listener will be called whenever the custom event is received.
+   */
+  onEvent(type: string, listener: CustomEventListener): void;
+  /**
+   * Remove a custom event listener.
+   */
+  offEvent(type: string, listener: CustomEventListener): void;
+  onClose(listener: () => void): void;
+  close(): void;
+  /**
+   * Add a change listener. This listener will be called whenever the state of the group changes.
+   */
+  addChangeListener(listener: Listener<TData>): void;
+  /**
+   * Remove a change listener.
+   */
+  removeChangeListener(listener: Listener<TData>): void;
+  /**
+   * Get the current state of the group.
+   */
+  getState(): TData;
+  protected setState(state: TData): void;
+}
+//#endregion
+export { StreamSubscription };
+//# sourceMappingURL=stream-subscription.d.mts.map

package/dist/src/stream-subscription.mjs

@@ -0,0 +1,64 @@
+//#region src/stream-subscription.ts
+var StreamSubscription = class {
+	constructor(sub, state) {
+		this.customEventListeners = /* @__PURE__ */ new Map();
+		this.closeListeners = /* @__PURE__ */ new Set();
+		this.onChangeListeners = /* @__PURE__ */ new Set();
+		this.sub = sub;
+		this.state = state;
+	}
+	onEventReceived(event) {
+		const customEventListeners = this.customEventListeners.get(event.type);
+		if (customEventListeners) {
+			const eventData = event.data;
+			customEventListeners.forEach((listener) => listener(eventData));
+		}
+	}
+	/**
+	* Add a custom event listener. This listener will be called whenever the custom event is received.
+	*/
+	onEvent(type, listener) {
+		const listeners = this.customEventListeners.get(type) || [];
+		this.customEventListeners.set(type, [...listeners, listener]);
+	}
+	/**
+	* Remove a custom event listener.
+	*/
+	offEvent(type, listener) {
+		const listeners = this.customEventListeners.get(type) || [];
+		this.customEventListeners.set(type, listeners.filter((l) => l !== listener));
+	}
+	onClose(listener) {
+		this.closeListeners.add(listener);
+	}
+	close() {
+		this.closeListeners.forEach((listener) => listener());
+		this.closeListeners.clear();
+	}
+	/**
+	* Add a change listener. This listener will be called whenever the state of the group changes.
+	*/
+	addChangeListener(listener) {
+		this.onChangeListeners.add(listener);
+	}
+	/**
+	* Remove a change listener.
+	*/
+	removeChangeListener(listener) {
+		this.onChangeListeners.delete(listener);
+	}
+	/**
+	* Get the current state of the group.
+	*/
+	getState() {
+		return this.state;
+	}
+	setState(state) {
+		this.state = state;
+		this.onChangeListeners.forEach((listener) => listener(state));
+	}
+};
+
+//#endregion
+export { StreamSubscription };
+//# sourceMappingURL=stream-subscription.mjs.map

package/dist/src/stream-subscription.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-subscription.mjs","names":[],"sources":["../../src/stream-subscription.ts"],"sourcesContent":["import type { CustomEvent, JoinMessage, Listener } from './stream.types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype CustomEventListener = (event: any) => void\n\nexport abstract class StreamSubscription<TData = unknown, TEventData = unknown> {\n  private customEventListeners: Map<string, CustomEventListener[]> = new Map()\n  private closeListeners: Set<() => void> = new Set()\n\n  private onChangeListeners: Set<Listener<TData>> = new Set()\n  private state: TData\n\n  readonly sub: JoinMessage\n\n  constructor(sub: JoinMessage, state: TData) {\n    this.sub = sub\n    this.state = state\n  }\n\n  abstract listener(message: TEventData): void\n\n  protected onEventReceived(event: CustomEvent) {\n    const customEventListeners = this.customEventListeners.get(event.type)\n\n    if (customEventListeners) {\n      const eventData = event.data\n      customEventListeners.forEach((listener) => listener(eventData))\n    }\n  }\n\n  /**\n   * Add a custom event listener. This listener will be called whenever the custom event is received.\n   */\n  onEvent(type: string, listener: CustomEventListener) {\n    const listeners = this.customEventListeners.get(type) || []\n    this.customEventListeners.set(type, [...listeners, listener])\n  }\n\n  /**\n   * Remove a custom event listener.\n   */\n  offEvent(type: string, listener: CustomEventListener) {\n    const listeners = this.customEventListeners.get(type) || []\n    this.customEventListeners.set(\n      type,\n      listeners.filter((l) => l !== listener),\n    )\n  }\n\n  onClose(listener: () => void) {\n    this.closeListeners.add(listener)\n  }\n\n  close() {\n    this.closeListeners.forEach((listener) => listener())\n    this.closeListeners.clear()\n  }\n\n  /**\n   * Add a change listener. This listener will be called whenever the state of the group changes.\n   */\n  addChangeListener(listener: Listener<TData>) {\n    this.onChangeListeners.add(listener)\n  }\n\n  /**\n   * Remove a change listener.\n   */\n  removeChangeListener(listener: Listener<TData>) {\n    this.onChangeListeners.delete(listener)\n  }\n\n  /**\n   * Get the current state of the group.\n   */\n  getState(): TData {\n    return this.state\n  }\n\n  protected setState(state: TData) {\n    this.state = state\n    this.onChangeListeners.forEach((listener) => listener(state))\n  }\n}\n"],"mappings":";AAKA,IAAsB,qBAAtB,MAAgF;CAS9E,YAAY,KAAkB,OAAc;8CARuB,IAAI,KAAK;wCAClC,IAAI,KAAK;2CAED,IAAI,KAAK;AAMzD,OAAK,MAAM;AACX,OAAK,QAAQ;;CAKf,AAAU,gBAAgB,OAAoB;EAC5C,MAAM,uBAAuB,KAAK,qBAAqB,IAAI,MAAM,KAAK;AAEtE,MAAI,sBAAsB;GACxB,MAAM,YAAY,MAAM;AACxB,wBAAqB,SAAS,aAAa,SAAS,UAAU,CAAC;;;;;;CAOnE,QAAQ,MAAc,UAA+B;EACnD,MAAM,YAAY,KAAK,qBAAqB,IAAI,KAAK,IAAI,EAAE;AAC3D,OAAK,qBAAqB,IAAI,MAAM,CAAC,GAAG,WAAW,SAAS,CAAC;;;;;CAM/D,SAAS,MAAc,UAA+B;EACpD,MAAM,YAAY,KAAK,qBAAqB,IAAI,KAAK,IAAI,EAAE;AAC3D,OAAK,qBAAqB,IACxB,MACA,UAAU,QAAQ,MAAM,MAAM,SAAS,CACxC;;CAGH,QAAQ,UAAsB;AAC5B,OAAK,eAAe,IAAI,SAAS;;CAGnC,QAAQ;AACN,OAAK,eAAe,SAAS,aAAa,UAAU,CAAC;AACrD,OAAK,eAAe,OAAO;;;;;CAM7B,kBAAkB,UAA2B;AAC3C,OAAK,kBAAkB,IAAI,SAAS;;;;;CAMtC,qBAAqB,UAA2B;AAC9C,OAAK,kBAAkB,OAAO,SAAS;;;;;CAMzC,WAAkB;AAChB,SAAO,KAAK;;CAGd,AAAU,SAAS,OAAc;AAC/B,OAAK,QAAQ;AACb,OAAK,kBAAkB,SAAS,aAAa,SAAS,MAAM,CAAC"}

package/dist/src/stream.d.mts

@@ -0,0 +1,43 @@
+import { SocketAdapter } from "./socket-adapter.mjs";
+import { SocketAdapterFactory } from "./adapter-factory.mjs";
+import { StreamGroupSubscription } from "./stream-group.mjs";
+import { StreamItemSubscription } from "./stream-item.mjs";
+
+//#region src/stream.d.ts
+declare class Stream {
+  private adapterFactory;
+  private ws;
+  private listeners;
+  constructor(adapterFactory: SocketAdapterFactory);
+  createSocket(): SocketAdapter;
+  /**
+   * Subscribe to an item in a stream.
+   *
+   * @argument streamName - The name of the stream to subscribe to.
+   * @argument groupId - The id of the group to subscribe to.
+   * @argument id - The id of the item to subscribe to.
+   */
+  subscribeItem<TData extends {
+    id: string;
+  }>(streamName: string, groupId: string, id: string): StreamItemSubscription<TData>;
+  /**
+   * Subscribe to a group in a stream.
+   *
+   * @argument streamName - The name of the stream to subscribe to.
+   * @argument groupId - The id of the group to subscribe to.
+   */
+  subscribeGroup<TData extends {
+    id: string;
+  }>(streamName: string, groupId: string, sortKey?: keyof TData): StreamGroupSubscription<TData>;
+  close(): void;
+  private onSocketClose;
+  private onSocketOpen;
+  messageListener(event: string): void;
+  private subscribe;
+  private join;
+  private leave;
+  private roomName;
+}
+//#endregion
+export { Stream };
+//# sourceMappingURL=stream.d.mts.map

package/dist/src/stream.mjs

@@ -0,0 +1,104 @@
+import { StreamGroupSubscription } from "./stream-group.mjs";
+import { StreamItemSubscription } from "./stream-item.mjs";
+import { v4 } from "uuid";
+
+//#region src/stream.ts
+var Stream = class {
+	constructor(adapterFactory) {
+		this.adapterFactory = adapterFactory;
+		this.listeners = {};
+		this.ws = this.createSocket();
+	}
+	createSocket() {
+		this.ws = this.adapterFactory();
+		this.ws.onMessage((message) => this.messageListener(message));
+		this.ws.onOpen(() => this.onSocketOpen());
+		this.ws.onClose(() => this.onSocketClose());
+		return this.ws;
+	}
+	/**
+	* Subscribe to an item in a stream.
+	*
+	* @argument streamName - The name of the stream to subscribe to.
+	* @argument groupId - The id of the group to subscribe to.
+	* @argument id - The id of the item to subscribe to.
+	*/
+	subscribeItem(streamName, groupId, id) {
+		const subscription = new StreamItemSubscription({
+			streamName,
+			groupId,
+			id,
+			subscriptionId: v4()
+		});
+		this.subscribe(subscription);
+		return subscription;
+	}
+	/**
+	* Subscribe to a group in a stream.
+	*
+	* @argument streamName - The name of the stream to subscribe to.
+	* @argument groupId - The id of the group to subscribe to.
+	*/
+	subscribeGroup(streamName, groupId, sortKey) {
+		const subscription = new StreamGroupSubscription({
+			streamName,
+			groupId,
+			subscriptionId: v4()
+		}, sortKey);
+		this.subscribe(subscription);
+		return subscription;
+	}
+	close() {
+		this.listeners = {};
+		this.ws.close();
+	}
+	onSocketClose() {
+		setTimeout(() => this.createSocket(), 2e3);
+	}
+	onSocketOpen() {
+		Object.values(this.listeners).forEach((listeners) => {
+			listeners.forEach((subscription) => this.join(subscription));
+		});
+	}
+	messageListener(event) {
+		const message = JSON.parse(event);
+		const room = this.roomName(message);
+		this.listeners[room]?.forEach((listener) => listener.listener(message));
+		if (message.id && message.event.type !== "sync") {
+			const groupRoom = this.roomName({
+				streamName: message.streamName,
+				groupId: message.groupId
+			});
+			this.listeners[groupRoom]?.forEach((listener) => listener.listener(message));
+		}
+	}
+	subscribe(subscription) {
+		const room = this.roomName(subscription.sub);
+		if (!this.listeners[room]) this.listeners[room] = /* @__PURE__ */ new Set();
+		this.listeners[room].add(subscription);
+		this.join(subscription);
+		subscription.onClose(() => {
+			this.listeners[room]?.delete(subscription);
+			this.leave(subscription);
+		});
+	}
+	join(subscription) {
+		if (this.ws.isOpen()) this.ws.send(JSON.stringify({
+			type: "join",
+			data: subscription.sub
+		}));
+	}
+	leave(subscription) {
+		if (this.ws.isOpen()) this.ws.send(JSON.stringify({
+			type: "leave",
+			data: subscription.sub
+		}));
+	}
+	roomName(message) {
+		return message.id ? `${message.streamName}:group:${message.groupId}:item:${message.id}` : `${message.streamName}:group:${message.groupId}`;
+	}
+};
+
+//#endregion
+export { Stream };
+//# sourceMappingURL=stream.mjs.map

package/dist/src/stream.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.mjs","names":["adapterFactory: SocketAdapterFactory","uuidv4","message: ItemEventMessage<never>"],"sources":["../../src/stream.ts"],"sourcesContent":["import { v4 as uuidv4 } from 'uuid'\nimport type { SocketAdapterFactory } from './adapter-factory'\nimport type { SocketAdapter } from './socket-adapter'\nimport type { BaseMessage, ItemEventMessage } from './stream.types'\nimport { StreamGroupSubscription } from './stream-group'\nimport { StreamItemSubscription } from './stream-item'\nimport type { StreamSubscription } from './stream-subscription'\n\nexport class Stream {\n  private ws: SocketAdapter\n  private listeners: { [channelId: string]: Set<StreamSubscription> } = {}\n\n  constructor(private adapterFactory: SocketAdapterFactory) {\n    this.ws = this.createSocket()\n  }\n\n  createSocket(): SocketAdapter {\n    this.ws = this.adapterFactory()\n    this.ws.onMessage((message) => this.messageListener(message))\n    this.ws.onOpen(() => this.onSocketOpen())\n    this.ws.onClose(() => this.onSocketClose())\n\n    return this.ws\n  }\n\n  /**\n   * Subscribe to an item in a stream.\n   *\n   * @argument streamName - The name of the stream to subscribe to.\n   * @argument groupId - The id of the group to subscribe to.\n   * @argument id - The id of the item to subscribe to.\n   */\n  subscribeItem<TData extends { id: string }>(\n    streamName: string,\n    groupId: string,\n    id: string,\n  ): StreamItemSubscription<TData> {\n    const subscriptionId = uuidv4()\n    const sub = { streamName, groupId, id, subscriptionId }\n    const subscription = new StreamItemSubscription<TData>(sub)\n\n    this.subscribe(subscription)\n\n    return subscription\n  }\n\n  /**\n   * Subscribe to a group in a stream.\n   *\n   * @argument streamName - The name of the stream to subscribe to.\n   * @argument groupId - The id of the group to subscribe to.\n   */\n  subscribeGroup<TData extends { id: string }>(\n    streamName: string,\n    groupId: string,\n    sortKey?: keyof TData,\n  ): StreamGroupSubscription<TData> {\n    const subscriptionId = uuidv4()\n    const sub = { streamName, groupId, subscriptionId }\n    const subscription = new StreamGroupSubscription<TData>(sub, sortKey)\n\n    this.subscribe(subscription)\n\n    return subscription\n  }\n\n  close() {\n    this.listeners = {} // clean up all listeners\n    this.ws.close()\n  }\n\n  private onSocketClose(): void {\n    // retry to connect\n    setTimeout(() => this.createSocket(), 2000)\n  }\n\n  private onSocketOpen(): void {\n    Object.values(this.listeners).forEach((listeners) => {\n      listeners.forEach((subscription) => this.join(subscription))\n    })\n  }\n\n  messageListener(event: string): void {\n    const message: ItemEventMessage<never> = JSON.parse(event)\n    const room = this.roomName(message)\n\n    this.listeners[room]?.forEach((listener) => listener.listener(message))\n\n    // we need to discard sync to group subs when it's an item event\n    if (message.id && message.event.type !== 'sync') {\n      const groupRoom = this.roomName({\n        streamName: message.streamName,\n        groupId: message.groupId,\n      })\n\n      this.listeners[groupRoom]?.forEach((listener) => listener.listener(message))\n    }\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  private subscribe(subscription: StreamSubscription<any, any>): void {\n    const room = this.roomName(subscription.sub)\n\n    if (!this.listeners[room]) {\n      this.listeners[room] = new Set()\n    }\n\n    this.listeners[room].add(subscription)\n    this.join(subscription)\n\n    subscription.onClose(() => {\n      this.listeners[room]?.delete(subscription)\n      this.leave(subscription)\n    })\n  }\n\n  private join(subscription: StreamSubscription): void {\n    if (this.ws.isOpen()) {\n      this.ws.send(JSON.stringify({ type: 'join', data: subscription.sub }))\n    }\n  }\n\n  private leave(subscription: StreamSubscription): void {\n    if (this.ws.isOpen()) {\n      this.ws.send(JSON.stringify({ type: 'leave', data: subscription.sub }))\n    }\n  }\n\n  private roomName(message: Omit<BaseMessage, 'timestamp'>): string {\n    return message.id\n      ? `${message.streamName}:group:${message.groupId}:item:${message.id}`\n      : `${message.streamName}:group:${message.groupId}`\n  }\n}\n"],"mappings":";;;;;AAQA,IAAa,SAAb,MAAoB;CAIlB,YAAY,AAAQA,gBAAsC;EAAtC;mBAFkD,EAAE;AAGtE,OAAK,KAAK,KAAK,cAAc;;CAG/B,eAA8B;AAC5B,OAAK,KAAK,KAAK,gBAAgB;AAC/B,OAAK,GAAG,WAAW,YAAY,KAAK,gBAAgB,QAAQ,CAAC;AAC7D,OAAK,GAAG,aAAa,KAAK,cAAc,CAAC;AACzC,OAAK,GAAG,cAAc,KAAK,eAAe,CAAC;AAE3C,SAAO,KAAK;;;;;;;;;CAUd,cACE,YACA,SACA,IAC+B;EAG/B,MAAM,eAAe,IAAI,uBADb;GAAE;GAAY;GAAS;GAAI,gBADhBC,IAAQ;GACwB,CACI;AAE3D,OAAK,UAAU,aAAa;AAE5B,SAAO;;;;;;;;CAST,eACE,YACA,SACA,SACgC;EAGhC,MAAM,eAAe,IAAI,wBADb;GAAE;GAAY;GAAS,gBADZA,IAAQ;GACoB,EACU,QAAQ;AAErE,OAAK,UAAU,aAAa;AAE5B,SAAO;;CAGT,QAAQ;AACN,OAAK,YAAY,EAAE;AACnB,OAAK,GAAG,OAAO;;CAGjB,AAAQ,gBAAsB;AAE5B,mBAAiB,KAAK,cAAc,EAAE,IAAK;;CAG7C,AAAQ,eAAqB;AAC3B,SAAO,OAAO,KAAK,UAAU,CAAC,SAAS,cAAc;AACnD,aAAU,SAAS,iBAAiB,KAAK,KAAK,aAAa,CAAC;IAC5D;;CAGJ,gBAAgB,OAAqB;EACnC,MAAMC,UAAmC,KAAK,MAAM,MAAM;EAC1D,MAAM,OAAO,KAAK,SAAS,QAAQ;AAEnC,OAAK,UAAU,OAAO,SAAS,aAAa,SAAS,SAAS,QAAQ,CAAC;AAGvE,MAAI,QAAQ,MAAM,QAAQ,MAAM,SAAS,QAAQ;GAC/C,MAAM,YAAY,KAAK,SAAS;IAC9B,YAAY,QAAQ;IACpB,SAAS,QAAQ;IAClB,CAAC;AAEF,QAAK,UAAU,YAAY,SAAS,aAAa,SAAS,SAAS,QAAQ,CAAC;;;CAKhF,AAAQ,UAAU,cAAkD;EAClE,MAAM,OAAO,KAAK,SAAS,aAAa,IAAI;AAE5C,MAAI,CAAC,KAAK,UAAU,MAClB,MAAK,UAAU,wBAAQ,IAAI,KAAK;AAGlC,OAAK,UAAU,MAAM,IAAI,aAAa;AACtC,OAAK,KAAK,aAAa;AAEvB,eAAa,cAAc;AACzB,QAAK,UAAU,OAAO,OAAO,aAAa;AAC1C,QAAK,MAAM,aAAa;IACxB;;CAGJ,AAAQ,KAAK,cAAwC;AACnD,MAAI,KAAK,GAAG,QAAQ,CAClB,MAAK,GAAG,KAAK,KAAK,UAAU;GAAE,MAAM;GAAQ,MAAM,aAAa;GAAK,CAAC,CAAC;;CAI1E,AAAQ,MAAM,cAAwC;AACpD,MAAI,KAAK,GAAG,QAAQ,CAClB,MAAK,GAAG,KAAK,KAAK,UAAU;GAAE,MAAM;GAAS,MAAM,aAAa;GAAK,CAAC,CAAC;;CAI3E,AAAQ,SAAS,SAAiD;AAChE,SAAO,QAAQ,KACX,GAAG,QAAQ,WAAW,SAAS,QAAQ,QAAQ,QAAQ,QAAQ,OAC/D,GAAG,QAAQ,WAAW,SAAS,QAAQ"}

package/dist/src/stream.types.d.mts

@@ -0,0 +1,60 @@
+//#region src/stream.types.d.ts
+type BaseMessage = {
+  streamName: string;
+  groupId: string;
+  id?: string;
+  timestamp: number;
+};
+type JoinMessage = Omit<BaseMessage, 'timestamp'> & {
+  subscriptionId: string;
+};
+type CustomEvent = {
+  type: string;
+  data: any;
+};
+type StreamEvent<TData extends {
+  id: string;
+}> = {
+  type: 'create';
+  data: TData;
+} | {
+  type: 'update';
+  data: TData;
+} | {
+  type: 'delete';
+  data: TData;
+} | {
+  type: 'event';
+  event: CustomEvent;
+};
+type ItemStreamEvent<TData extends {
+  id: string;
+}> = StreamEvent<TData> | {
+  type: 'sync';
+  data: TData;
+};
+type GroupStreamEvent<TData extends {
+  id: string;
+}> = StreamEvent<TData> | {
+  type: 'sync';
+  data: TData[];
+};
+type ItemEventMessage<TData extends {
+  id: string;
+}> = BaseMessage & {
+  event: ItemStreamEvent<TData>;
+};
+type GroupEventMessage<TData extends {
+  id: string;
+}> = BaseMessage & {
+  event: GroupStreamEvent<TData>;
+};
+type Message = {
+  type: 'join' | 'leave';
+  data: JoinMessage;
+};
+type Listener<TData> = (state: TData | null) => void;
+type CustomEventListener<TData> = (event: TData) => void;
+//#endregion
+export { BaseMessage, CustomEvent, CustomEventListener, GroupEventMessage, GroupStreamEvent, ItemEventMessage, ItemStreamEvent, JoinMessage, Listener, Message, StreamEvent };
+//# sourceMappingURL=stream.types.d.mts.map