@gamention/pulse-core 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -19,11 +19,13 @@ export declare class Connection extends Emitter {
     private reconnectAttempt;
     private reconnectTimer;
     private _state;
+    private permanentlyClosed;
     get state(): ConnectionState;
     constructor(endpoint?: string);
     connect(): void;
     disconnect(): void;
     send(message: ClientMessage): void;
+    permanentDisconnect(): void;
     private scheduleReconnect;
 }
 
@@ -52,6 +54,7 @@ export declare class PulseClient extends Emitter {
     constructor(config: PulseConfig);
     connect(): void;
     disconnect(): void;
+    destroy(): void;
     private authenticate;
     send(message: ClientMessage): void;
     moveCursor(position: CursorPosition): void;
@@ -120,6 +123,8 @@ export declare class StateManager extends Emitter {
     markAllNotificationsRead(): void;
     get activityLogs(): ActivityLog[];
     getUser(userId: string): PulseUser | undefined;
+    /** Get all known users (from presence + comment authors). */
+    get users(): PulseUser[];
     getReactions(targetId: string): Reaction[];
     getTypingUsers(threadId: string): string[];
     get viewports(): Map<string, ViewportInfo>;

package/dist/pulse-core.cjs

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

package/dist/pulse-core.js

@@ -1,19 +1,7 @@
-var u = Object.defineProperty;
-var p = (o, n, t) => n in o ? u(o, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[n] = t;
-var i = (o, n, t) => p(o, typeof n != "symbol" ? n + "" : n, t);
-const c = {
-  allowImages: !0,
-  allowAudio: !0,
-  allowVideo: !0,
-  maxFileSizeMb: 10,
-  maxAttachmentsPerComment: 5,
-  allowReactions: !0,
-  allowDrawing: !0,
-  allowMentions: !0,
-  showCursors: !0,
-  showPresence: !0,
-  showTypingIndicators: !0
-}, _ = "ws://localhost:4567", l = 50, f = 3e4, m = 1e3, w = 3e4;
+var p = Object.defineProperty;
+var f = (h, n, t) => n in h ? p(h, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : h[n] = t;
+var i = (h, n, t) => f(h, typeof n != "symbol" ? n + "" : n, t);
+import { DEFAULT_ENDPOINT as m, RECONNECT_BASE_DELAY_MS as _, RECONNECT_MAX_DELAY_MS as w, DEFAULT_ENV_CONFIG as c, CURSOR_THROTTLE_MS as l, PRESENCE_HEARTBEAT_MS as v } from "@gamention/pulse-shared";
 class d {
   constructor() {
     i(this, "handlers", /* @__PURE__ */ new Map());
@@ -35,7 +23,7 @@ class d {
     this.handlers.clear();
   }
 }
-class v extends d {
+class y extends d {
   constructor(t) {
     super();
     i(this, "ws", null);
@@ -43,17 +31,21 @@ class v extends d {
     i(this, "reconnectAttempt", 0);
     i(this, "reconnectTimer", null);
     i(this, "_state", "disconnected");
-    this.endpoint = t ?? _;
+    i(this, "permanentlyClosed", !1);
+    this.endpoint = t ?? m;
   }
   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.ws || this.permanentlyClosed || (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", (t) => {
-      const e = JSON.parse(t.data);
-      this.emit("message", e);
+      try {
+        const e = JSON.parse(t.data);
+        this.emit("message", e);
+      } catch {
+      }
     }), this.ws.addEventListener("close", () => {
       this.ws = null, this._state = "disconnected", this.emit("state", this._state), this.scheduleReconnect();
     }), this.ws.addEventListener("error", () => {
@@ -69,9 +61,13 @@ class v extends d {
     var e;
     ((e = this.ws) == null ? void 0 : e.readyState) === WebSocket.OPEN && this.ws.send(JSON.stringify(t));
   }
+  permanentDisconnect() {
+    this.permanentlyClosed = !0, this.disconnect();
+  }
   scheduleReconnect() {
+    if (this.permanentlyClosed) return;
     const t = Math.min(
-      m * 2 ** this.reconnectAttempt,
+      _ * 2 ** this.reconnectAttempt,
       w
     );
     this.reconnectAttempt++, this.reconnectTimer = setTimeout(() => {
@@ -79,7 +75,7 @@ class v extends d {
     }, t);
   }
 }
-class y extends d {
+class I extends d {
   constructor() {
     super(...arguments);
     /** HTTP base URL for resolving relative attachment paths (e.g. "http://localhost:4000"). */
@@ -105,7 +101,7 @@ class y extends d {
   /** Optimistically remove a comment from local state (before server round-trip). */
   removeComment(t) {
     for (const [e, s] of this._threads) {
-      const r = s.comments.findIndex((a) => a.id === t);
+      const r = s.comments.findIndex((o) => o.id === t);
       if (r !== -1) {
         s.comments.splice(r, 1), s.comments.length === 0 && this._threads.delete(e), this.emit("threads", this.threads);
         return;
@@ -142,6 +138,10 @@ class y extends d {
   getUser(t) {
     return this._users.get(t);
   }
+  /** Get all known users (from presence + comment authors). */
+  get users() {
+    return [...this._users.values()];
+  }
   getReactions(t) {
     return this._reactions.get(t) ?? [];
   }
@@ -149,8 +149,8 @@ class y extends d {
     const e = this._typing.get(t);
     if (!e) return [];
     const s = Date.now(), r = [];
-    for (const [a, h] of e)
-      s - h < 3e3 && r.push(a);
+    for (const [o, a] of e)
+      s - a < 3e3 && r.push(o);
     return r;
   }
   get viewports() {
@@ -309,6 +309,9 @@ class y extends d {
       case "activity:logged":
         this._activityLogs.unshift(t.activityLog), this._activityLogs.length > 100 && (this._activityLogs = this._activityLogs.slice(0, 100)), this.emit("activity-logs", this._activityLogs);
         break;
+      case "auth:error":
+        this.emit("auth:error", t);
+        break;
       case "error":
         this.emit("error", t);
         break;
@@ -318,7 +321,7 @@ class y extends d {
     this._user = null, this._config = { ...c }, 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 b extends d {
+class T extends d {
   constructor(t) {
     var s;
     super();
@@ -329,10 +332,10 @@ class b extends d {
     i(this, "lastCursorSend", 0);
     i(this, "pendingCursor", null);
     i(this, "cursorTimer", null);
-    this.config = t, this.state = new y(), this.state.baseUrl = (t.endpoint ?? "").replace(/^ws(s?):/, "http$1:").replace(/\/$/, "");
+    this.config = t, this.state = new I(), this.state.baseUrl = (t.endpoint ?? "").replace(/^ws(s?):/, "http$1:").replace(/\/$/, "");
     const e = ((s = t.endpoint) == null ? void 0 : s.replace(/^http/, "ws")) ?? void 0;
-    this.connection = new v(e), this.connection.on("message", (r) => {
-      this.state.handleMessage(r), this.emit(r.type, r);
+    this.connection = new y(e), this.connection.on("message", (r) => {
+      this.state.handleMessage(r), this.emit(r.type, r), r.type === "auth:error" && this.connection.permanentDisconnect();
     }), this.connection.on("state", (r) => {
       this.emit("connection", r), r === "connected" ? (this.authenticate(), this.startHeartbeat()) : r === "disconnected" && this.stopHeartbeat();
     });
@@ -345,7 +348,10 @@ class b extends d {
     this.connection.connect();
   }
   disconnect() {
-    this.stopHeartbeat(), this.connection.disconnect(), this.state.reset();
+    this.stopHeartbeat(), this.cursorTimer && (clearTimeout(this.cursorTimer), this.cursorTimer = null), this.connection.disconnect(), this.state.reset();
+  }
+  destroy() {
+    this.disconnect(), this.removeAll(), this.state.removeAll(), this.connection.removeAll();
   }
   authenticate() {
     this.send({
@@ -373,9 +379,9 @@ class b extends d {
     this.send({ type: "presence:update", status: t });
   }
   startHeartbeat() {
-    this.heartbeatTimer = setInterval(() => {
+    this.heartbeatTimer || (this.heartbeatTimer = setInterval(() => {
       this.send({ type: "presence:update", status: "online" });
-    }, f);
+    }, v));
   }
   stopHeartbeat() {
     this.heartbeatTimer && (clearInterval(this.heartbeatTimer), this.heartbeatTimer = null);
@@ -393,8 +399,8 @@ class b extends d {
     }), s;
   }
   reply(t, e, s = [], r) {
-    const a = crypto.randomUUID();
-    return this.send({ type: "comment:create", threadId: t, id: a, body: e, mentions: s, attachmentIds: r }), a;
+    const o = crypto.randomUUID();
+    return this.send({ type: "comment:create", threadId: t, id: o, body: e, mentions: s, attachmentIds: r }), o;
   }
   editComment(t, e, s = []) {
     this.send({ type: "comment:edit", commentId: t, body: e, mentions: s });
@@ -448,22 +454,22 @@ class b extends d {
   }
   // ── File Upload ──
   async uploadFile(t) {
-    const e = (this.config.endpoint ?? window.location.origin).replace(/^ws(s?):/, "http$1:"), s = new FormData();
-    s.append("file", t);
-    const r = await fetch(`${e}/api/v1/upload`, {
+    const e = typeof window < "u" ? window.location.origin : "", s = (this.config.endpoint ?? e).replace(/^ws(s?):/, "http$1:"), r = new FormData();
+    r.append("file", t);
+    const o = await fetch(`${s}/api/v1/upload`, {
       method: "POST",
       headers: {
         "X-Pulse-Key": this.config.apiKey,
         "X-Pulse-Token": this.config.token
       },
-      body: s
+      body: r
     });
-    if (!r.ok) {
-      const h = await r.json().catch(() => ({ error: "Upload failed" }));
-      throw new Error(h.error ?? "Upload failed");
+    if (!o.ok) {
+      const u = await o.json().catch(() => ({ error: "Upload failed" }));
+      throw new Error(u.error ?? "Upload failed");
     }
-    const a = await r.json();
-    return a.url && !a.url.startsWith("http") && (a.url = `${e}${a.url}`), a.thumbnailUrl && !a.thumbnailUrl.startsWith("http") && (a.thumbnailUrl = `${e}${a.thumbnailUrl}`), a;
+    const a = await o.json();
+    return a.url && !a.url.startsWith("http") && (a.url = `${s}${a.url}`), a.thumbnailUrl && !a.thumbnailUrl.startsWith("http") && (a.thumbnailUrl = `${s}${a.thumbnailUrl}`), a;
   }
   // ── Presence control ──
   setAppearOffline(t) {
@@ -471,8 +477,8 @@ class b extends d {
   }
 }
 export {
-  v as Connection,
+  y as Connection,
   d as Emitter,
-  b as PulseClient,
-  y as StateManager
+  T as PulseClient,
+  I as StateManager
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamention/pulse-core",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "Core client SDK for Pulse — WebSocket connection, state management, and API for real-time collaboration",
   "type": "module",
   "main": "./dist/pulse-core.cjs",
@@ -35,9 +35,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@gamention/pulse-shared": "0.1.10"
+  "peerDependencies": {
+    "@gamention/pulse-shared": "0.1.11"
   },
+  "dependencies": {},
   "devDependencies": {
     "typescript": "^5.7.0",
     "vite": "^6.0.0",