@gamention/pulse-core 0.1.9 → 0.1.11

package/dist/index.d.ts

@@ -92,6 +92,8 @@ export declare class PulseClient extends Emitter {
 }
 
 export declare class StateManager extends Emitter {
+    /** HTTP base URL for resolving relative attachment paths (e.g. "http://localhost:4000"). */
+    baseUrl: string;
     private _user;
     private _users;
     private _presence;
@@ -114,6 +116,11 @@ export declare class StateManager extends Emitter {
     get viewports(): Map<string, ViewportInfo>;
     getViewport(userId: string): ViewportInfo | undefined;
     get selections(): Map<string, SelectionRange | null>;
+    /** Resolve a relative URL to absolute using baseUrl. */
+    private resolveUrl;
+    private resolveAttachments;
+    private resolveComment;
+    private resolveThread;
     handleMessage(msg: ServerMessage): void;
     reset(): void;
 }

package/dist/pulse-core.cjs

@@ -1 +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 c{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 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??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 c{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[o,l]of t)s-l<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,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 I 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 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,attachmentIds:t.attachmentIds}),s}reply(e,t,s=[],r){const o=crypto.randomUUID();return this.send({type:"comment:create",threadId:e,id:o,body:t,mentions:s,attachmentIds:r}),o}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).replace(/^ws(s?):/,"http$1:"),s=new FormData;s.append("file",e);const r=await fetch(`${t}/api/v1/upload`,{method:"POST",headers:{"X-Pulse-Key":this.config.apiKey,"X-Pulse-Token":this.config.token},body:s});if(!r.ok){const o=await r.json().catch(()=>({error:"Upload failed"}));throw new Error(o.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=c;exports.PulseClient=I;exports.StateManager=p;
+"use strict";var u=Object.defineProperty;var _=(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)=>_(o,typeof n!="symbol"?n+"":n,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f="ws://localhost:4567",d=50,m=3e4,w=1e3,v=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 l 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??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",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(w*2**this.reconnectAttempt,v);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,"_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(t=>!t.read).length}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._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._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 y 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 l(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>=d?this.flushCursor():this.cursorTimer||(this.cursorTimer=setTimeout(()=>{this.cursorTimer=null,this.flushCursor()},d))}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"})},m)}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.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.send({type:"notification:read",notificationId:t})}markAllRead(){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=l;exports.Emitter=h;exports.PulseClient=y;exports.StateManager=p;

package/dist/pulse-core.js

@@ -1,37 +1,37 @@
 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";
+var l = (o, n, t) => n in o ? d(o, n, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[n] = t;
+var i = (o, n, t) => l(o, typeof n != "symbol" ? n + "" : n, t);
+const p = "ws://localhost:4567";
 class c {
   constructor() {
     i(this, "handlers", /* @__PURE__ */ new Map());
   }
-  on(n, e) {
+  on(n, t) {
     this.handlers.has(n) || this.handlers.set(n, /* @__PURE__ */ new Set());
-    const t = this.handlers.get(n);
-    return t.add(e), () => t.delete(e);
+    const e = this.handlers.get(n);
+    return e.add(t), () => e.delete(t);
   }
-  off(n, e) {
-    var t;
-    (t = this.handlers.get(n)) == null || t.delete(e);
+  off(n, t) {
+    var e;
+    (e = this.handlers.get(n)) == null || e.delete(t);
   }
-  emit(n, e) {
-    var t;
-    (t = this.handlers.get(n)) == null || t.forEach((s) => s(e));
+  emit(n, t) {
+    var e;
+    (e = this.handlers.get(n)) == null || e.forEach((s) => s(t));
   }
   removeAll() {
     this.handlers.clear();
   }
 }
 class u extends c {
-  constructor(e) {
+  constructor(t) {
     super();
     i(this, "ws", null);
     i(this, "endpoint");
     i(this, "reconnectAttempt", 0);
     i(this, "reconnectTimer", null);
     i(this, "_state", "disconnected");
-    this.endpoint = e ?? l;
+    this.endpoint = t ?? p;
   }
   get state() {
     return this._state;
@@ -39,37 +39,39 @@ class u extends c {
   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("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 e;
-      (e = this.ws) == null || e.close();
+      var t;
+      (t = this.ws) == null || t.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));
+    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 e = Math.min(
+    const t = Math.min(
       1e3 * 2 ** this.reconnectAttempt,
       3e4
     );
     this.reconnectAttempt++, this.reconnectTimer = setTimeout(() => {
       this.reconnectTimer = null, this.connect();
-    }, e);
+    }, t);
   }
 }
 class _ extends c {
   constructor() {
     super(...arguments);
+    /** HTTP base URL for resolving relative attachment paths (e.g. "http://localhost:4000"). */
+    i(this, "baseUrl", "");
     i(this, "_user", null);
     i(this, "_users", /* @__PURE__ */ new Map());
     i(this, "_presence", /* @__PURE__ */ new Map());
@@ -94,163 +96,183 @@ class _ extends c {
     return this._notifications;
   }
   get unreadCount() {
-    return this._notifications.filter((e) => !e.read).length;
+    return this._notifications.filter((t) => !t.read).length;
   }
   get activityLogs() {
     return this._activityLogs;
   }
-  getUser(e) {
-    return this._users.get(e);
+  getUser(t) {
+    return this._users.get(t);
   }
-  getReactions(e) {
-    return this._reactions.get(e) ?? [];
+  getReactions(t) {
+    return this._reactions.get(t) ?? [];
   }
-  getTypingUsers(e) {
-    const t = this._typing.get(e);
-    if (!t) return [];
+  getTypingUsers(t) {
+    const e = this._typing.get(t);
+    if (!e) return [];
     const s = Date.now(), r = [];
-    for (const [o, h] of t)
-      s - h < 3e3 && r.push(o);
+    for (const [a, h] of e)
+      s - h < 3e3 && r.push(a);
     return r;
   }
   get viewports() {
     return this._viewports;
   }
-  getViewport(e) {
-    return this._viewports.get(e);
+  getViewport(t) {
+    return this._viewports.get(t);
   }
   get selections() {
     return this._selections;
   }
-  handleMessage(e) {
-    switch (e.type) {
+  /** Resolve a relative URL to absolute using baseUrl. */
+  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._user = e.user, this._users.clear();
-        for (const t of e.users) this._users.set(t.id, t);
+        this._user = t.user, this._users.clear();
+        for (const e of t.users) this._users.set(e.id, e);
         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);
+        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 = [...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);
+        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(e.user.user.id, e.user), this._users.set(e.user.user.id, e.user.user), this.emit("presence", this.presence);
+        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(e.userId), this._viewports.delete(e.userId), this._selections.delete(e.userId);
-        for (const t of this._typing.values())
-          t.delete(e.userId);
+        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 t = this._presence.get(e.userId);
-        t && (t.status = e.status, this.emit("presence", this.presence));
+        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: e.userId, position: e.position });
+        this.emit("cursor", { userId: t.userId, position: t.position });
         break;
       case "click:perform":
-        this.emit("click", { userId: e.userId, position: e.position });
+        this.emit("click", { userId: t.userId, position: t.position });
         break;
       case "thread:created":
-        this._threads.set(e.thread.id, e.thread), this.emit("threads", this.threads);
+        this._threads.set(t.thread.id, this.resolveThread(t.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));
+        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 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);
+        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 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));
+        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 t = this._threads.get(e.threadId);
-        t && (t.resolved = e.resolved, this.emit("threads", this.threads));
+        const e = this._threads.get(t.threadId);
+        e && (e.resolved = t.resolved, this.emit("threads", this.threads));
         break;
       }
       case "thread:deleted":
-        this._threads.delete(e.threadId), this.emit("threads", this.threads);
+        this._threads.delete(t.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
+        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 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,
+        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(e.notification), this.emit("notifications", this._notifications);
+        this._notifications.unshift(t.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 });
+        this._typing.has(t.threadId) || this._typing.set(t.threadId, /* @__PURE__ */ 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(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 });
+        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(e.userId, e.selection), this.emit("selection", { userId: e.userId, selection: e.selection });
+        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: e.userId,
-          emoji: e.emoji,
-          position: e.position
+          userId: t.userId,
+          emoji: t.emoji,
+          position: t.position
         });
         break;
       case "draw:stroke":
         this.emit("draw-stroke", {
-          userId: e.userId,
-          points: e.points,
-          color: e.color,
-          width: e.width
+          userId: t.userId,
+          points: t.points,
+          color: t.color,
+          width: t.width
         });
         break;
       case "draw:clear":
-        this.emit("draw-clear", { userId: e.userId });
+        this.emit("draw-clear", { userId: t.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);
+        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", e);
+        this.emit("error", t);
         break;
     }
   }
@@ -258,8 +280,8 @@ class _ extends c {
     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) {
+class m extends c {
+  constructor(t) {
     var s;
     super();
     i(this, "state");
@@ -269,9 +291,9 @@ class w extends c {
     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.config = t, this.state = new _(), 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();
@@ -295,13 +317,13 @@ class w extends c {
       room: this.config.room
     });
   }
-  send(e) {
-    this.connection.send(e);
+  send(t) {
+    this.connection.send(t);
   }
   // ── Cursors ──
-  moveCursor(e) {
-    const t = Date.now();
-    this.pendingCursor = e, t - this.lastCursorSend >= 50 ? this.flushCursor() : this.cursorTimer || (this.cursorTimer = setTimeout(() => {
+  moveCursor(t) {
+    const e = Date.now();
+    this.pendingCursor = t, e - this.lastCursorSend >= 50 ? this.flushCursor() : this.cursorTimer || (this.cursorTimer = setTimeout(() => {
       this.cursorTimer = null, this.flushCursor();
     }, 50));
   }
@@ -309,8 +331,8 @@ class w extends c {
     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 });
+  updatePresence(t) {
+    this.send({ type: "presence:update", status: t });
   }
   startHeartbeat() {
     this.heartbeatTimer = setInterval(() => {
@@ -321,76 +343,76 @@ class w extends c {
     this.heartbeatTimer && (clearInterval(this.heartbeatTimer), this.heartbeatTimer = null);
   }
   // ── Threads & Comments ──
-  createThread(e, t = {}) {
+  createThread(t, e = {}) {
     const s = crypto.randomUUID();
     return this.send({
       type: "thread:create",
       id: s,
-      body: e,
-      mentions: t.mentions ?? [],
-      position: t.position ?? null,
-      attachmentIds: t.attachmentIds
+      body: t,
+      mentions: e.mentions ?? [],
+      position: e.position ?? null,
+      attachmentIds: e.attachmentIds
     }), s;
   }
-  reply(e, t, s = [], r) {
-    const o = crypto.randomUUID();
-    return this.send({ type: "comment:create", threadId: e, id: o, body: t, mentions: s, attachmentIds: r }), o;
+  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(e, t, s = []) {
-    this.send({ type: "comment:edit", commentId: e, body: t, mentions: s });
+  editComment(t, e, s = []) {
+    this.send({ type: "comment:edit", commentId: t, body: e, mentions: s });
   }
-  deleteComment(e) {
-    this.send({ type: "comment:delete", commentId: e });
+  deleteComment(t) {
+    this.send({ type: "comment:delete", commentId: t });
   }
-  resolveThread(e, t = !0) {
-    this.send({ type: "thread:resolve", threadId: e, resolved: t });
+  resolveThread(t, e = !0) {
+    this.send({ type: "thread:resolve", threadId: t, resolved: e });
   }
   // ── Reactions ──
-  addReaction(e, t, s) {
-    this.send({ type: "reaction:add", targetId: e, targetType: t, emoji: s });
+  addReaction(t, e, s) {
+    this.send({ type: "reaction:add", targetId: t, targetType: e, emoji: s });
   }
-  removeReaction(e) {
-    this.send({ type: "reaction:remove", reactionId: e });
+  removeReaction(t) {
+    this.send({ type: "reaction:remove", reactionId: t });
   }
   // ── Notifications ──
-  markRead(e) {
-    this.send({ type: "notification:read", notificationId: e });
+  markRead(t) {
+    this.send({ type: "notification:read", notificationId: t });
   }
   markAllRead() {
     this.send({ type: "notification:read-all" });
   }
   // ── Clicks ──
-  performClick(e) {
-    this.send({ type: "click:perform", position: e });
+  performClick(t) {
+    this.send({ type: "click:perform", position: t });
   }
   // ── Typing ──
-  sendTyping(e) {
-    this.send({ type: "typing:start", threadId: e });
+  sendTyping(t) {
+    this.send({ type: "typing:start", threadId: t });
   }
   // ── Viewport ──
-  updateViewport(e) {
-    this.send({ type: "viewport:update", ...e });
+  updateViewport(t) {
+    this.send({ type: "viewport:update", ...t });
   }
   // ── Selection ──
-  updateSelection(e) {
-    this.send({ type: "selection:update", selection: e });
+  updateSelection(t) {
+    this.send({ type: "selection:update", selection: t });
   }
   // ── Emoji Drops ──
-  dropEmoji(e, t) {
-    this.send({ type: "emoji:drop", emoji: e, position: t });
+  dropEmoji(t, e) {
+    this.send({ type: "emoji:drop", emoji: t, position: e });
   }
   // ── Drawing ──
-  drawStroke(e, t, s) {
-    this.send({ type: "draw:stroke", points: e, color: t, width: s });
+  drawStroke(t, e, s) {
+    this.send({ type: "draw:stroke", points: t, color: e, width: s });
   }
   clearDrawing() {
     this.send({ type: "draw:clear" });
   }
   // ── File Upload ──
-  async uploadFile(e) {
-    const t = (this.config.endpoint ?? window.location.origin).replace(/^ws(s?):/, "http$1:"), s = new FormData();
-    s.append("file", e);
-    const r = await fetch(`${t}/api/v1/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`, {
       method: "POST",
       headers: {
         "X-Pulse-Key": this.config.apiKey,
@@ -399,19 +421,20 @@ class w extends c {
       body: s
     });
     if (!r.ok) {
-      const o = await r.json().catch(() => ({ error: "Upload failed" }));
-      throw new Error(o.error ?? "Upload failed");
+      const h = await r.json().catch(() => ({ error: "Upload failed" }));
+      throw new Error(h.error ?? "Upload failed");
     }
-    return r.json();
+    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;
   }
   // ── Presence control ──
-  setAppearOffline(e) {
-    e ? (this.stopHeartbeat(), this.send({ type: "presence:update", status: "idle" })) : (this.startHeartbeat(), this.send({ type: "presence:update", status: "online" }));
+  setAppearOffline(t) {
+    t ? (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,
+  m as PulseClient,
   _ as StateManager
 };

package/package.json

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