@gamention/pulse-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,120 @@
+import { ActivityLog } from '@gamention/pulse-shared';
+import { ClientMessage } from '@gamention/pulse-shared';
+import { CursorPosition } from '@gamention/pulse-shared';
+import { Notification as Notification_2 } from '@gamention/pulse-shared';
+import { PinPosition } from '@gamention/pulse-shared';
+import { PresenceUser } from '@gamention/pulse-shared';
+import { PulseConfig } from '@gamention/pulse-shared';
+import { PulseUser } from '@gamention/pulse-shared';
+import { Reaction } from '@gamention/pulse-shared';
+import { SelectionRange } from '@gamention/pulse-shared';
+import { ServerMessage } from '@gamention/pulse-shared';
+import { Thread } from '@gamention/pulse-shared';
+import { ViewportInfo } from '@gamention/pulse-shared';
+
+export declare class Connection extends Emitter {
+    private ws;
+    private endpoint;
+    private reconnectAttempt;
+    private reconnectTimer;
+    private _state;
+    get state(): ConnectionState;
+    constructor(endpoint?: string);
+    connect(): void;
+    disconnect(): void;
+    send(message: ClientMessage): void;
+    private scheduleReconnect;
+}
+
+export declare type ConnectionState = "disconnected" | "connecting" | "connected";
+
+export declare class Emitter {
+    private handlers;
+    on<T = unknown>(event: string, handler: Handler<T>): () => void;
+    off<T = unknown>(event: string, handler: Handler<T>): void;
+    emit<T = unknown>(event: string, data: T): void;
+    removeAll(): void;
+}
+
+declare type Handler<T = unknown> = (data: T) => void;
+
+export declare class PulseClient extends Emitter {
+    readonly state: StateManager;
+    private connection;
+    private config;
+    private heartbeatTimer;
+    private lastCursorSend;
+    private pendingCursor;
+    private cursorTimer;
+    /** Current WebSocket connection state. */
+    get connectionState(): ConnectionState;
+    constructor(config: PulseConfig);
+    connect(): void;
+    disconnect(): void;
+    private authenticate;
+    send(message: ClientMessage): void;
+    moveCursor(position: CursorPosition): void;
+    private flushCursor;
+    updatePresence(status: "online" | "idle"): void;
+    private startHeartbeat;
+    private stopHeartbeat;
+    createThread(body: string, options?: {
+        position?: PinPosition;
+        mentions?: string[];
+    }): string;
+    reply(threadId: string, body: string, mentions?: string[]): string;
+    editComment(commentId: string, body: string, mentions?: string[]): void;
+    deleteComment(commentId: string): void;
+    resolveThread(threadId: string, resolved?: boolean): void;
+    addReaction(targetId: string, targetType: "comment" | "thread", emoji: string): void;
+    removeReaction(reactionId: string): void;
+    markRead(notificationId: string): void;
+    markAllRead(): void;
+    performClick(position: CursorPosition): void;
+    sendTyping(threadId: string): void;
+    updateViewport(info: ViewportInfo): void;
+    updateSelection(selection: SelectionRange | null): void;
+    dropEmoji(emoji: string, position: CursorPosition): void;
+    drawStroke(points: {
+        x: number;
+        y: number;
+    }[], color: string, width: number): void;
+    clearDrawing(): void;
+    uploadFile(file: File): Promise<{
+        id: string;
+        type: string;
+        filename: string;
+        url: string;
+        thumbnailUrl?: string;
+    }>;
+    setAppearOffline(offline: boolean): void;
+}
+
+export declare class StateManager extends Emitter {
+    private _user;
+    private _users;
+    private _presence;
+    private _threads;
+    private _reactions;
+    private _notifications;
+    private _activityLogs;
+    private _typing;
+    private _viewports;
+    private _selections;
+    get user(): PulseUser | null;
+    get presence(): PresenceUser[];
+    get threads(): Thread[];
+    get notifications(): Notification_2[];
+    get unreadCount(): number;
+    get activityLogs(): ActivityLog[];
+    getUser(userId: string): PulseUser | undefined;
+    getReactions(targetId: string): Reaction[];
+    getTypingUsers(threadId: string): string[];
+    get viewports(): Map<string, ViewportInfo>;
+    getViewport(userId: string): ViewportInfo | undefined;
+    get selections(): Map<string, SelectionRange | null>;
+    handleMessage(msg: ServerMessage): void;
+    reset(): void;
+}
+
+export { }

package/dist/pulse-core.cjs

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var _=(a,n,e)=>n in a?u(a,n,{enumerable:!0,configurable:!0,writable:!0,value:e}):a[n]=e;var i=(a,n,e)=>_(a,typeof n!="symbol"?n+"":n,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f="ws://localhost:4567",h=50,w=3e4,y=1e3,m=3e4;class o{constructor(){i(this,"handlers",new Map)}on(n,e){this.handlers.has(n)||this.handlers.set(n,new Set);const t=this.handlers.get(n);return t.add(e),()=>t.delete(e)}off(n,e){var t;(t=this.handlers.get(n))==null||t.delete(e)}emit(n,e){var t;(t=this.handlers.get(n))==null||t.forEach(s=>s(e))}removeAll(){this.handlers.clear()}}class d extends o{constructor(e){super();i(this,"ws",null);i(this,"endpoint");i(this,"reconnectAttempt",0);i(this,"reconnectTimer",null);i(this,"_state","disconnected");this.endpoint=e??f}get state(){return this._state}connect(){this.ws||(this._state="connecting",this.emit("state",this._state),this.ws=new WebSocket(this.endpoint),this.ws.addEventListener("open",()=>{this._state="connected",this.reconnectAttempt=0,this.emit("state",this._state)}),this.ws.addEventListener("message",e=>{const t=JSON.parse(e.data);this.emit("message",t)}),this.ws.addEventListener("close",()=>{this.ws=null,this._state="disconnected",this.emit("state",this._state),this.scheduleReconnect()}),this.ws.addEventListener("error",()=>{var e;(e=this.ws)==null||e.close()}))}disconnect(){var e;this.reconnectTimer&&(clearTimeout(this.reconnectTimer),this.reconnectTimer=null),this.reconnectAttempt=0,(e=this.ws)==null||e.close(),this.ws=null,this._state="disconnected",this.emit("state",this._state)}send(e){var t;((t=this.ws)==null?void 0:t.readyState)===WebSocket.OPEN&&this.ws.send(JSON.stringify(e))}scheduleReconnect(){const e=Math.min(y*2**this.reconnectAttempt,m);this.reconnectAttempt++,this.reconnectTimer=setTimeout(()=>{this.reconnectTimer=null,this.connect()},e)}}class p extends o{constructor(){super(...arguments);i(this,"_user",null);i(this,"_users",new Map);i(this,"_presence",new Map);i(this,"_threads",new Map);i(this,"_reactions",new Map);i(this,"_notifications",[]);i(this,"_activityLogs",[]);i(this,"_typing",new Map);i(this,"_viewports",new Map);i(this,"_selections",new Map)}get user(){return this._user}get presence(){return[...this._presence.values()]}get threads(){return[...this._threads.values()]}get notifications(){return this._notifications}get unreadCount(){return this._notifications.filter(e=>!e.read).length}get activityLogs(){return this._activityLogs}getUser(e){return this._users.get(e)}getReactions(e){return this._reactions.get(e)??[]}getTypingUsers(e){const t=this._typing.get(e);if(!t)return[];const s=Date.now(),r=[];for(const[c,l]of t)s-l<3e3&&r.push(c);return r}get viewports(){return this._viewports}getViewport(e){return this._viewports.get(e)}get selections(){return this._selections}handleMessage(e){switch(e.type){case"auth:ok":this._user=e.user,this._users.clear();for(const t of e.users)this._users.set(t.id,t);this._presence.clear();for(const t of e.presence)this._presence.set(t.user.id,t),this._users.set(t.user.id,t.user);this._users.set(e.user.id,e.user),this._threads.clear();for(const t of e.threads)this._threads.set(t.id,t);this._notifications=e.notifications,this._reactions.clear();for(const t of e.reactions){const s=this._reactions.get(t.targetId)??[];s.push(t),this._reactions.set(t.targetId,s)}this._activityLogs=[...e.activityLogs],this.emit("auth",e.user),this.emit("presence",this.presence),this.emit("threads",this.threads),this.emit("notifications",this._notifications),this.emit("reactions",null),this.emit("activity-logs",this._activityLogs);break;case"presence:join":this._presence.set(e.user.user.id,e.user),this._users.set(e.user.user.id,e.user.user),this.emit("presence",this.presence);break;case"presence:leave":this._presence.delete(e.userId),this._viewports.delete(e.userId),this._selections.delete(e.userId);for(const t of this._typing.values())t.delete(e.userId);this.emit("presence",this.presence);break;case"presence:update":{const t=this._presence.get(e.userId);t&&(t.status=e.status,this.emit("presence",this.presence));break}case"cursor:move":this.emit("cursor",{userId:e.userId,position:e.position});break;case"click:perform":this.emit("click",{userId:e.userId,position:e.position});break;case"thread:created":this._threads.set(e.thread.id,e.thread),this.emit("threads",this.threads);break;case"comment:created":{const t=this._threads.get(e.threadId);t&&(t.comments.push(e.comment),t.updatedAt=e.comment.createdAt,this.emit("threads",this.threads));break}case"comment:edited":{const t=this._threads.get(e.threadId);if(t){const s=t.comments.findIndex(r=>r.id===e.comment.id);s!==-1&&(t.comments[s]=e.comment),this.emit("threads",this.threads)}break}case"comment:deleted":{const t=this._threads.get(e.threadId);t&&(t.comments=t.comments.filter(s=>s.id!==e.commentId),t.comments.length===0&&this._threads.delete(e.threadId),this.emit("threads",this.threads));break}case"thread:resolved":{const t=this._threads.get(e.threadId);t&&(t.resolved=e.resolved,this.emit("threads",this.threads));break}case"thread:deleted":this._threads.delete(e.threadId),this.emit("threads",this.threads);break;case"reaction:added":{const t=this._reactions.get(e.reaction.targetId)??[];t.push(e.reaction),this._reactions.set(e.reaction.targetId,t),this.emit("reactions",{targetId:e.reaction.targetId,reactions:t});break}case"reaction:removed":{const t=this._reactions.get(e.targetId);if(t){const s=t.filter(r=>r.id!==e.reactionId);this._reactions.set(e.targetId,s),this.emit("reactions",{targetId:e.targetId,reactions:s})}break}case"notification":this._notifications.unshift(e.notification),this.emit("notifications",this._notifications);break;case"typing:indicator":{this._typing.has(e.threadId)||this._typing.set(e.threadId,new Map),this._typing.get(e.threadId).set(e.userId,Date.now()),this.emit("typing",{threadId:e.threadId,userId:e.userId});break}case"viewport:update":{this._viewports.set(e.userId,{scrollX:e.scrollX,scrollY:e.scrollY,viewportWidth:e.viewportWidth,viewportHeight:e.viewportHeight,pageWidth:e.pageWidth,pageHeight:e.pageHeight}),this.emit("viewport",{userId:e.userId});break}case"selection:update":this._selections.set(e.userId,e.selection),this.emit("selection",{userId:e.userId,selection:e.selection});break;case"emoji:drop":this.emit("emoji-drop",{userId:e.userId,emoji:e.emoji,position:e.position});break;case"draw:stroke":this.emit("draw-stroke",{userId:e.userId,points:e.points,color:e.color,width:e.width});break;case"draw:clear":this.emit("draw-clear",{userId:e.userId});break;case"activity:logged":this._activityLogs.unshift(e.activityLog),this._activityLogs.length>100&&(this._activityLogs=this._activityLogs.slice(0,100)),this.emit("activity-logs",this._activityLogs);break;case"error":this.emit("error",e);break}}reset(){this._user=null,this._users.clear(),this._presence.clear(),this._threads.clear(),this._reactions.clear(),this._notifications=[],this._activityLogs=[],this._typing.clear(),this._viewports.clear(),this._selections.clear()}}class v extends o{constructor(e){var s;super();i(this,"state");i(this,"connection");i(this,"config");i(this,"heartbeatTimer",null);i(this,"lastCursorSend",0);i(this,"pendingCursor",null);i(this,"cursorTimer",null);this.config=e,this.state=new p;const t=((s=e.endpoint)==null?void 0:s.replace(/^http/,"ws"))??void 0;this.connection=new d(t),this.connection.on("message",r=>{this.state.handleMessage(r),this.emit(r.type,r)}),this.connection.on("state",r=>{this.emit("connection",r),r==="connected"?(this.authenticate(),this.startHeartbeat()):r==="disconnected"&&this.stopHeartbeat()})}get connectionState(){return this.connection.state}connect(){this.connection.connect()}disconnect(){this.stopHeartbeat(),this.connection.disconnect(),this.state.reset()}authenticate(){this.send({type:"auth",apiKey:this.config.apiKey,token:this.config.token,room:this.config.room})}send(e){this.connection.send(e)}moveCursor(e){const t=Date.now();this.pendingCursor=e,t-this.lastCursorSend>=h?this.flushCursor():this.cursorTimer||(this.cursorTimer=setTimeout(()=>{this.cursorTimer=null,this.flushCursor()},h))}flushCursor(){this.pendingCursor&&(this.send({type:"cursor:move",position:this.pendingCursor}),this.lastCursorSend=Date.now(),this.pendingCursor=null)}updatePresence(e){this.send({type:"presence:update",status:e})}startHeartbeat(){this.heartbeatTimer=setInterval(()=>{this.send({type:"presence:update",status:"online"})},w)}stopHeartbeat(){this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null)}createThread(e,t={}){const s=crypto.randomUUID();return this.send({type:"thread:create",id:s,body:e,mentions:t.mentions??[],position:t.position??null}),s}reply(e,t,s=[]){const r=crypto.randomUUID();return this.send({type:"comment:create",threadId:e,id:r,body:t,mentions:s}),r}editComment(e,t,s=[]){this.send({type:"comment:edit",commentId:e,body:t,mentions:s})}deleteComment(e){this.send({type:"comment:delete",commentId:e})}resolveThread(e,t=!0){this.send({type:"thread:resolve",threadId:e,resolved:t})}addReaction(e,t,s){this.send({type:"reaction:add",targetId:e,targetType:t,emoji:s})}removeReaction(e){this.send({type:"reaction:remove",reactionId:e})}markRead(e){this.send({type:"notification:read",notificationId:e})}markAllRead(){this.send({type:"notification:read-all"})}performClick(e){this.send({type:"click:perform",position:e})}sendTyping(e){this.send({type:"typing:start",threadId:e})}updateViewport(e){this.send({type:"viewport:update",...e})}updateSelection(e){this.send({type:"selection:update",selection:e})}dropEmoji(e,t){this.send({type:"emoji:drop",emoji:e,position:t})}drawStroke(e,t,s){this.send({type:"draw:stroke",points:e,color:t,width:s})}clearDrawing(){this.send({type:"draw:clear"})}async uploadFile(e){const t=this.config.endpoint??window.location.origin,s=new FormData;s.append("file",e);const r=await fetch(`${t}/api/v1/upload`,{method:"POST",headers:{Authorization:`Bearer ${this.config.apiKey}`},body:s});if(!r.ok){const c=await r.json().catch(()=>({error:"Upload failed"}));throw new Error(c.error??"Upload failed")}return r.json()}setAppearOffline(e){e?(this.stopHeartbeat(),this.send({type:"presence:update",status:"idle"})):(this.startHeartbeat(),this.send({type:"presence:update",status:"online"}))}}exports.Connection=d;exports.Emitter=o;exports.PulseClient=v;exports.StateManager=p;

package/dist/pulse-core.js

@@ -0,0 +1,415 @@
+var d = Object.defineProperty;
+var p = (a, n, e) => n in a ? d(a, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : a[n] = e;
+var i = (a, n, e) => p(a, typeof n != "symbol" ? n + "" : n, e);
+const l = "ws://localhost:4567";
+class c {
+  constructor() {
+    i(this, "handlers", /* @__PURE__ */ new Map());
+  }
+  on(n, e) {
+    this.handlers.has(n) || this.handlers.set(n, /* @__PURE__ */ new Set());
+    const t = this.handlers.get(n);
+    return t.add(e), () => t.delete(e);
+  }
+  off(n, e) {
+    var t;
+    (t = this.handlers.get(n)) == null || t.delete(e);
+  }
+  emit(n, e) {
+    var t;
+    (t = this.handlers.get(n)) == null || t.forEach((s) => s(e));
+  }
+  removeAll() {
+    this.handlers.clear();
+  }
+}
+class u extends c {
+  constructor(e) {
+    super();
+    i(this, "ws", null);
+    i(this, "endpoint");
+    i(this, "reconnectAttempt", 0);
+    i(this, "reconnectTimer", null);
+    i(this, "_state", "disconnected");
+    this.endpoint = e ?? l;
+  }
+  get state() {
+    return this._state;
+  }
+  connect() {
+    this.ws || (this._state = "connecting", this.emit("state", this._state), this.ws = new WebSocket(this.endpoint), this.ws.addEventListener("open", () => {
+      this._state = "connected", this.reconnectAttempt = 0, this.emit("state", this._state);
+    }), this.ws.addEventListener("message", (e) => {
+      const t = JSON.parse(e.data);
+      this.emit("message", t);
+    }), this.ws.addEventListener("close", () => {
+      this.ws = null, this._state = "disconnected", this.emit("state", this._state), this.scheduleReconnect();
+    }), this.ws.addEventListener("error", () => {
+      var e;
+      (e = this.ws) == null || e.close();
+    }));
+  }
+  disconnect() {
+    var e;
+    this.reconnectTimer && (clearTimeout(this.reconnectTimer), this.reconnectTimer = null), this.reconnectAttempt = 0, (e = this.ws) == null || e.close(), this.ws = null, this._state = "disconnected", this.emit("state", this._state);
+  }
+  send(e) {
+    var t;
+    ((t = this.ws) == null ? void 0 : t.readyState) === WebSocket.OPEN && this.ws.send(JSON.stringify(e));
+  }
+  scheduleReconnect() {
+    const e = Math.min(
+      1e3 * 2 ** this.reconnectAttempt,
+      3e4
+    );
+    this.reconnectAttempt++, this.reconnectTimer = setTimeout(() => {
+      this.reconnectTimer = null, this.connect();
+    }, e);
+  }
+}
+class _ extends c {
+  constructor() {
+    super(...arguments);
+    i(this, "_user", null);
+    i(this, "_users", /* @__PURE__ */ new Map());
+    i(this, "_presence", /* @__PURE__ */ new Map());
+    i(this, "_threads", /* @__PURE__ */ new Map());
+    i(this, "_reactions", /* @__PURE__ */ new Map());
+    i(this, "_notifications", []);
+    i(this, "_activityLogs", []);
+    i(this, "_typing", /* @__PURE__ */ new Map());
+    i(this, "_viewports", /* @__PURE__ */ new Map());
+    i(this, "_selections", /* @__PURE__ */ new Map());
+  }
+  get user() {
+    return this._user;
+  }
+  get presence() {
+    return [...this._presence.values()];
+  }
+  get threads() {
+    return [...this._threads.values()];
+  }
+  get notifications() {
+    return this._notifications;
+  }
+  get unreadCount() {
+    return this._notifications.filter((e) => !e.read).length;
+  }
+  get activityLogs() {
+    return this._activityLogs;
+  }
+  getUser(e) {
+    return this._users.get(e);
+  }
+  getReactions(e) {
+    return this._reactions.get(e) ?? [];
+  }
+  getTypingUsers(e) {
+    const t = this._typing.get(e);
+    if (!t) return [];
+    const s = Date.now(), r = [];
+    for (const [o, h] of t)
+      s - h < 3e3 && r.push(o);
+    return r;
+  }
+  get viewports() {
+    return this._viewports;
+  }
+  getViewport(e) {
+    return this._viewports.get(e);
+  }
+  get selections() {
+    return this._selections;
+  }
+  handleMessage(e) {
+    switch (e.type) {
+      case "auth:ok":
+        this._user = e.user, this._users.clear();
+        for (const t of e.users) this._users.set(t.id, t);
+        this._presence.clear();
+        for (const t of e.presence)
+          this._presence.set(t.user.id, t), this._users.set(t.user.id, t.user);
+        this._users.set(e.user.id, e.user), this._threads.clear();
+        for (const t of e.threads) this._threads.set(t.id, t);
+        this._notifications = e.notifications, this._reactions.clear();
+        for (const t of e.reactions) {
+          const s = this._reactions.get(t.targetId) ?? [];
+          s.push(t), this._reactions.set(t.targetId, s);
+        }
+        this._activityLogs = [...e.activityLogs], this.emit("auth", e.user), this.emit("presence", this.presence), this.emit("threads", this.threads), this.emit("notifications", this._notifications), this.emit("reactions", null), this.emit("activity-logs", this._activityLogs);
+        break;
+      case "presence:join":
+        this._presence.set(e.user.user.id, e.user), this._users.set(e.user.user.id, e.user.user), this.emit("presence", this.presence);
+        break;
+      case "presence:leave":
+        this._presence.delete(e.userId), this._viewports.delete(e.userId), this._selections.delete(e.userId);
+        for (const t of this._typing.values())
+          t.delete(e.userId);
+        this.emit("presence", this.presence);
+        break;
+      case "presence:update": {
+        const t = this._presence.get(e.userId);
+        t && (t.status = e.status, this.emit("presence", this.presence));
+        break;
+      }
+      case "cursor:move":
+        this.emit("cursor", { userId: e.userId, position: e.position });
+        break;
+      case "click:perform":
+        this.emit("click", { userId: e.userId, position: e.position });
+        break;
+      case "thread:created":
+        this._threads.set(e.thread.id, e.thread), this.emit("threads", this.threads);
+        break;
+      case "comment:created": {
+        const t = this._threads.get(e.threadId);
+        t && (t.comments.push(e.comment), t.updatedAt = e.comment.createdAt, this.emit("threads", this.threads));
+        break;
+      }
+      case "comment:edited": {
+        const t = this._threads.get(e.threadId);
+        if (t) {
+          const s = t.comments.findIndex((r) => r.id === e.comment.id);
+          s !== -1 && (t.comments[s] = e.comment), this.emit("threads", this.threads);
+        }
+        break;
+      }
+      case "comment:deleted": {
+        const t = this._threads.get(e.threadId);
+        t && (t.comments = t.comments.filter((s) => s.id !== e.commentId), t.comments.length === 0 && this._threads.delete(e.threadId), this.emit("threads", this.threads));
+        break;
+      }
+      case "thread:resolved": {
+        const t = this._threads.get(e.threadId);
+        t && (t.resolved = e.resolved, this.emit("threads", this.threads));
+        break;
+      }
+      case "thread:deleted":
+        this._threads.delete(e.threadId), this.emit("threads", this.threads);
+        break;
+      case "reaction:added": {
+        const t = this._reactions.get(e.reaction.targetId) ?? [];
+        t.push(e.reaction), this._reactions.set(e.reaction.targetId, t), this.emit("reactions", {
+          targetId: e.reaction.targetId,
+          reactions: t
+        });
+        break;
+      }
+      case "reaction:removed": {
+        const t = this._reactions.get(e.targetId);
+        if (t) {
+          const s = t.filter((r) => r.id !== e.reactionId);
+          this._reactions.set(e.targetId, s), this.emit("reactions", {
+            targetId: e.targetId,
+            reactions: s
+          });
+        }
+        break;
+      }
+      case "notification":
+        this._notifications.unshift(e.notification), this.emit("notifications", this._notifications);
+        break;
+      case "typing:indicator": {
+        this._typing.has(e.threadId) || this._typing.set(e.threadId, /* @__PURE__ */ new Map()), this._typing.get(e.threadId).set(e.userId, Date.now()), this.emit("typing", { threadId: e.threadId, userId: e.userId });
+        break;
+      }
+      case "viewport:update": {
+        this._viewports.set(e.userId, {
+          scrollX: e.scrollX,
+          scrollY: e.scrollY,
+          viewportWidth: e.viewportWidth,
+          viewportHeight: e.viewportHeight,
+          pageWidth: e.pageWidth,
+          pageHeight: e.pageHeight
+        }), this.emit("viewport", { userId: e.userId });
+        break;
+      }
+      case "selection:update":
+        this._selections.set(e.userId, e.selection), this.emit("selection", { userId: e.userId, selection: e.selection });
+        break;
+      case "emoji:drop":
+        this.emit("emoji-drop", {
+          userId: e.userId,
+          emoji: e.emoji,
+          position: e.position
+        });
+        break;
+      case "draw:stroke":
+        this.emit("draw-stroke", {
+          userId: e.userId,
+          points: e.points,
+          color: e.color,
+          width: e.width
+        });
+        break;
+      case "draw:clear":
+        this.emit("draw-clear", { userId: e.userId });
+        break;
+      case "activity:logged":
+        this._activityLogs.unshift(e.activityLog), this._activityLogs.length > 100 && (this._activityLogs = this._activityLogs.slice(0, 100)), this.emit("activity-logs", this._activityLogs);
+        break;
+      case "error":
+        this.emit("error", e);
+        break;
+    }
+  }
+  reset() {
+    this._user = null, this._users.clear(), this._presence.clear(), this._threads.clear(), this._reactions.clear(), this._notifications = [], this._activityLogs = [], this._typing.clear(), this._viewports.clear(), this._selections.clear();
+  }
+}
+class w extends c {
+  constructor(e) {
+    var s;
+    super();
+    i(this, "state");
+    i(this, "connection");
+    i(this, "config");
+    i(this, "heartbeatTimer", null);
+    i(this, "lastCursorSend", 0);
+    i(this, "pendingCursor", null);
+    i(this, "cursorTimer", null);
+    this.config = e, this.state = new _();
+    const t = ((s = e.endpoint) == null ? void 0 : s.replace(/^http/, "ws")) ?? void 0;
+    this.connection = new u(t), this.connection.on("message", (r) => {
+      this.state.handleMessage(r), this.emit(r.type, r);
+    }), this.connection.on("state", (r) => {
+      this.emit("connection", r), r === "connected" ? (this.authenticate(), this.startHeartbeat()) : r === "disconnected" && this.stopHeartbeat();
+    });
+  }
+  /** Current WebSocket connection state. */
+  get connectionState() {
+    return this.connection.state;
+  }
+  connect() {
+    this.connection.connect();
+  }
+  disconnect() {
+    this.stopHeartbeat(), this.connection.disconnect(), this.state.reset();
+  }
+  authenticate() {
+    this.send({
+      type: "auth",
+      apiKey: this.config.apiKey,
+      token: this.config.token,
+      room: this.config.room
+    });
+  }
+  send(e) {
+    this.connection.send(e);
+  }
+  // ── Cursors ──
+  moveCursor(e) {
+    const t = Date.now();
+    this.pendingCursor = e, t - this.lastCursorSend >= 50 ? this.flushCursor() : this.cursorTimer || (this.cursorTimer = setTimeout(() => {
+      this.cursorTimer = null, this.flushCursor();
+    }, 50));
+  }
+  flushCursor() {
+    this.pendingCursor && (this.send({ type: "cursor:move", position: this.pendingCursor }), this.lastCursorSend = Date.now(), this.pendingCursor = null);
+  }
+  // ── Presence ──
+  updatePresence(e) {
+    this.send({ type: "presence:update", status: e });
+  }
+  startHeartbeat() {
+    this.heartbeatTimer = setInterval(() => {
+      this.send({ type: "presence:update", status: "online" });
+    }, 3e4);
+  }
+  stopHeartbeat() {
+    this.heartbeatTimer && (clearInterval(this.heartbeatTimer), this.heartbeatTimer = null);
+  }
+  // ── Threads & Comments ──
+  createThread(e, t = {}) {
+    const s = crypto.randomUUID();
+    return this.send({
+      type: "thread:create",
+      id: s,
+      body: e,
+      mentions: t.mentions ?? [],
+      position: t.position ?? null
+    }), s;
+  }
+  reply(e, t, s = []) {
+    const r = crypto.randomUUID();
+    return this.send({ type: "comment:create", threadId: e, id: r, body: t, mentions: s }), r;
+  }
+  editComment(e, t, s = []) {
+    this.send({ type: "comment:edit", commentId: e, body: t, mentions: s });
+  }
+  deleteComment(e) {
+    this.send({ type: "comment:delete", commentId: e });
+  }
+  resolveThread(e, t = !0) {
+    this.send({ type: "thread:resolve", threadId: e, resolved: t });
+  }
+  // ── Reactions ──
+  addReaction(e, t, s) {
+    this.send({ type: "reaction:add", targetId: e, targetType: t, emoji: s });
+  }
+  removeReaction(e) {
+    this.send({ type: "reaction:remove", reactionId: e });
+  }
+  // ── Notifications ──
+  markRead(e) {
+    this.send({ type: "notification:read", notificationId: e });
+  }
+  markAllRead() {
+    this.send({ type: "notification:read-all" });
+  }
+  // ── Clicks ──
+  performClick(e) {
+    this.send({ type: "click:perform", position: e });
+  }
+  // ── Typing ──
+  sendTyping(e) {
+    this.send({ type: "typing:start", threadId: e });
+  }
+  // ── Viewport ──
+  updateViewport(e) {
+    this.send({ type: "viewport:update", ...e });
+  }
+  // ── Selection ──
+  updateSelection(e) {
+    this.send({ type: "selection:update", selection: e });
+  }
+  // ── Emoji Drops ──
+  dropEmoji(e, t) {
+    this.send({ type: "emoji:drop", emoji: e, position: t });
+  }
+  // ── Drawing ──
+  drawStroke(e, t, s) {
+    this.send({ type: "draw:stroke", points: e, color: t, width: s });
+  }
+  clearDrawing() {
+    this.send({ type: "draw:clear" });
+  }
+  // ── File Upload ──
+  async uploadFile(e) {
+    const t = this.config.endpoint ?? window.location.origin, s = new FormData();
+    s.append("file", e);
+    const r = await fetch(`${t}/api/v1/upload`, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.config.apiKey}`
+      },
+      body: s
+    });
+    if (!r.ok) {
+      const o = await r.json().catch(() => ({ error: "Upload failed" }));
+      throw new Error(o.error ?? "Upload failed");
+    }
+    return r.json();
+  }
+  // ── Presence control ──
+  setAppearOffline(e) {
+    e ? (this.stopHeartbeat(), this.send({ type: "presence:update", status: "idle" })) : (this.startHeartbeat(), this.send({ type: "presence:update", status: "online" }));
+  }
+}
+export {
+  u as Connection,
+  c as Emitter,
+  w as PulseClient,
+  _ as StateManager
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@gamention/pulse-core",
+  "version": "0.1.0",
+  "description": "Core client SDK for Pulse — WebSocket connection, state management, and API for real-time collaboration",
+  "type": "module",
+  "main": "./dist/pulse-core.cjs",
+  "module": "./dist/pulse-core.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/pulse-core.js",
+      "require": "./dist/pulse-core.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["pulse", "collaboration", "realtime", "websocket", "client", "sdk"],
+  "author": "Krishna Thorat <krishnathorat007@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gamentionkray/pulse.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://pulse.hire.rest/docs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@gamention/pulse-shared": "workspace:*"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.3.0"
+  }
+}