@motiadev/stream-client 0.13.2-beta.164-110989 → 0.14.0-beta.164

package/dist/esm/src/stream.js

@@ -0,0 +1,98 @@
+import { v4 as uuidv4 } from 'uuid';
+import { StreamGroupSubscription } from './stream-group';
+import { StreamItemSubscription } from './stream-item';
+export class Stream {
+    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 subscriptionId = uuidv4();
+        const sub = { streamName, groupId, id, subscriptionId };
+        const subscription = new StreamItemSubscription(sub);
+        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 subscriptionId = uuidv4();
+        const sub = { streamName, groupId, subscriptionId };
+        const subscription = new StreamGroupSubscription(sub, sortKey);
+        this.subscribe(subscription);
+        return subscription;
+    }
+    close() {
+        this.listeners = {}; // clean up all listeners
+        this.ws.close();
+    }
+    onSocketClose() {
+        // retry to connect
+        setTimeout(() => this.createSocket(), 2000);
+    }
+    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));
+        // we need to discard sync to group subs when it's an item event
+        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));
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    subscribe(subscription) {
+        const room = this.roomName(subscription.sub);
+        if (!this.listeners[room]) {
+            this.listeners[room] = 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}`;
+    }
+}

package/dist/esm/src/stream.types.d.ts

@@ -0,0 +1,56 @@
+export type BaseMessage = {
+    streamName: string;
+    groupId: string;
+    id?: string;
+    timestamp: number;
+};
+export type JoinMessage = Omit<BaseMessage, 'timestamp'> & {
+    subscriptionId: string;
+};
+export type CustomEvent = {
+    type: string;
+    data: any;
+};
+export type StreamEvent<TData extends {
+    id: string;
+}> = {
+    type: 'create';
+    data: TData;
+} | {
+    type: 'update';
+    data: TData;
+} | {
+    type: 'delete';
+    data: TData;
+} | {
+    type: 'event';
+    event: CustomEvent;
+};
+export type ItemStreamEvent<TData extends {
+    id: string;
+}> = StreamEvent<TData> | {
+    type: 'sync';
+    data: TData;
+};
+export type GroupStreamEvent<TData extends {
+    id: string;
+}> = StreamEvent<TData> | {
+    type: 'sync';
+    data: TData[];
+};
+export type ItemEventMessage<TData extends {
+    id: string;
+}> = BaseMessage & {
+    event: ItemStreamEvent<TData>;
+};
+export type GroupEventMessage<TData extends {
+    id: string;
+}> = BaseMessage & {
+    event: GroupStreamEvent<TData>;
+};
+export type Message = {
+    type: 'join' | 'leave';
+    data: JoinMessage;
+};
+export type Listener<TData> = (state: TData | null) => void;
+export type CustomEventListener<TData> = (event: TData) => void;

package/dist/esm/src/stream.types.js

@@ -0,0 +1 @@
+export {};

package/dist/types/__tests__/stream-group.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/__tests__/stream-item.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/__tests__/stream.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+export { SocketAdapterFactory } from './src/adapter-factory';
+export { SocketAdapter } from './src/socket-adapter';
+export { Stream } from './src/stream';
+export * from './src/stream.types';
+export { StreamGroupSubscription } from './src/stream-group';
+export { StreamItemSubscription } from './src/stream-item';
+export { StreamSubscription } from './src/stream-subscription';

package/dist/types/src/adapter-factory.d.ts

@@ -0,0 +1,2 @@
+import type { SocketAdapter } from './socket-adapter';
+export type SocketAdapterFactory = () => SocketAdapter;

package/dist/types/src/socket-adapter.d.ts

@@ -0,0 +1,9 @@
+export 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;
+}

package/dist/types/src/stream-group.d.ts

@@ -0,0 +1,13 @@
+import type { GroupEventMessage, JoinMessage } from './stream.types';
+import { StreamSubscription } from './stream-subscription';
+export 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;
+}

package/dist/types/src/stream-item.d.ts

@@ -0,0 +1,9 @@
+import type { ItemEventMessage, JoinMessage } from './stream.types';
+import { StreamSubscription } from './stream-subscription';
+export declare class StreamItemSubscription<TData extends {
+    id: string;
+}> extends StreamSubscription<TData | null, ItemEventMessage<TData>> {
+    private lastEventTimestamp;
+    constructor(sub: JoinMessage);
+    listener(message: ItemEventMessage<TData>): void;
+}

package/dist/types/src/stream-subscription.d.ts

@@ -0,0 +1,36 @@
+import type { CustomEvent, JoinMessage, Listener } from './stream.types';
+type CustomEventListener = (event: any) => void;
+export 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;
+}
+export {};

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

@@ -0,0 +1,38 @@
+import type { SocketAdapterFactory } from './adapter-factory';
+import type { SocketAdapter } from './socket-adapter';
+import { StreamGroupSubscription } from './stream-group';
+import { StreamItemSubscription } from './stream-item';
+export 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;
+}

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

@@ -0,0 +1,56 @@
+export type BaseMessage = {
+    streamName: string;
+    groupId: string;
+    id?: string;
+    timestamp: number;
+};
+export type JoinMessage = Omit<BaseMessage, 'timestamp'> & {
+    subscriptionId: string;
+};
+export type CustomEvent = {
+    type: string;
+    data: any;
+};
+export type StreamEvent<TData extends {
+    id: string;
+}> = {
+    type: 'create';
+    data: TData;
+} | {
+    type: 'update';
+    data: TData;
+} | {
+    type: 'delete';
+    data: TData;
+} | {
+    type: 'event';
+    event: CustomEvent;
+};
+export type ItemStreamEvent<TData extends {
+    id: string;
+}> = StreamEvent<TData> | {
+    type: 'sync';
+    data: TData;
+};
+export type GroupStreamEvent<TData extends {
+    id: string;
+}> = StreamEvent<TData> | {
+    type: 'sync';
+    data: TData[];
+};
+export type ItemEventMessage<TData extends {
+    id: string;
+}> = BaseMessage & {
+    event: ItemStreamEvent<TData>;
+};
+export type GroupEventMessage<TData extends {
+    id: string;
+}> = BaseMessage & {
+    event: GroupStreamEvent<TData>;
+};
+export type Message = {
+    type: 'join' | 'leave';
+    data: JoinMessage;
+};
+export type Listener<TData> = (state: TData | null) => void;
+export type CustomEventListener<TData> = (event: TData) => void;

package/package.json

@@ -1,30 +1,35 @@
 {
   "name": "@motiadev/stream-client",
   "description": "Motia Stream Client Package – Responsible for managing streams of data.",
-  "version": "0.13.2-beta.164-110989",
+  "version": "0.14.0-beta.164",
   "license": "Elastic-2.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/cjs/index.js",
+      "import": "./dist/esm/index.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./workbench": {
+      "require": "./dist/cjs/workbench.js",
+      "import": "./dist/esm/workbench.js",
+      "types": "./dist/types/workbench.d.ts"
+    }
+  },
   "dependencies": {
-    "uuid": "^13.0.0"
+    "uuid": "^11.1.0"
   },
   "devDependencies": {
-    "@types/jest": "^30.0.0",
+    "@types/jest": "^29.5.14",
     "@types/ws": "^8.18.1",
-    "jest": "^30.2.0",
-    "ts-jest": "^29.4.5",
-    "tsdown": "^0.16.6",
-    "typescript": "^5.9.3"
-  },
-  "exports": {
-    ".": "./dist/index.js",
-    "./package.json": "./package.json"
+    "jest": "^29.7.0",
+    "ts-jest": "^29.3.2",
+    "typescript": "^5.7.2"
   },
   "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
+    "build": "sh scripts/build.sh",
     "lint": "eslint --config ../../eslint.config.js",
     "test": "jest"
   }

package/scripts/build.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+
+rm -rf dist
+
+echo "Building CommonJS version..."
+npx tsc --project tsconfig.json --outDir dist/cjs --module CommonJS
+
+echo "Building ESM version..."
+npx tsc --project tsconfig.json --outDir dist/esm --module ES2020
+
+echo "Building type declarations..."
+npx tsc --emitDeclarationOnly --declaration --outDir dist/types
+
+echo "Build completed successfully!" 

package/__mocks__/uuid.ts

@@ -1,10 +0,0 @@
-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.ts

@@ -1,167 +0,0 @@
-//#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
-//#region src/adapter-factory.d.ts
-type SocketAdapterFactory = () => SocketAdapter;
-//#endregion
-//#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
-//#region src/stream-subscription.d.ts
-type CustomEventListener$1 = (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$1): void;
-  /**
-   * Remove a custom event listener.
-   */
-  offEvent(type: string, listener: CustomEventListener$1): 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
-//#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
-//#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
-//#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 { BaseMessage, CustomEvent, CustomEventListener, GroupEventMessage, GroupStreamEvent, ItemEventMessage, ItemStreamEvent, JoinMessage, Listener, Message, type SocketAdapter, type SocketAdapterFactory, Stream, StreamEvent, StreamGroupSubscription, StreamItemSubscription, StreamSubscription };