@manonero/chat-client-sdk 0.0.1-beta.1

package/dist/types/participant.d.ts

@@ -0,0 +1,22 @@
+import type { MediaReference } from './common.js';
+export interface ParticipantDto {
+    id: string;
+    uniqueName: string;
+    fullName: string;
+    /** Supports both internal storage and external URL */
+    avatar?: MediaReference | null;
+    gender?: string | null;
+    isBot: boolean;
+    /** ISO 8601 */
+    createdAt: string;
+    /** ISO 8601 */
+    updatedAt: string;
+}
+export interface CreateOrUpdateParticipantRequest {
+    id: string;
+    uniqueName: string;
+    fullName: string;
+    avatar?: MediaReference;
+    gender?: string;
+}
+//# sourceMappingURL=participant.d.ts.map

package/dist/types/participant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.d.ts","sourceRoot":"","sources":["../../src/types/participant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/participant.js

@@ -0,0 +1,3 @@
+// participant.ts — Participant types
+export {};
+//# sourceMappingURL=participant.js.map

package/dist/types/participant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.js","sourceRoot":"","sources":["../../src/types/participant.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/dist/types/signalr.d.ts

@@ -0,0 +1,84 @@
+import type { Block, QuickReply, Mention } from './block.js';
+export interface ChatSendMessageRequest {
+    conversationId: string;
+    blocks: Block[];
+    replyToMessageId?: string;
+    quickReplies?: QuickReply[];
+    mentions?: Mention[];
+    /** Up to 128 characters — for optimistic rendering */
+    clientMessageId?: string;
+}
+/**
+ * NOTE: Field names differ from REST EditMessageRequest.
+ * REST uses blocks/mentions; SignalR uses newBlocks/newMentions.
+ */
+export interface ChatEditMessageRequest {
+    messageId: string;
+    newBlocks: Block[];
+    newMentions?: Mention[];
+    /** Pass null to remove the existing reply reference */
+    newReplyToMessageId?: string | null;
+}
+/** NOTE: Server expects an object, NOT a bare string */
+export interface ChatDeleteMessageRequest {
+    messageId: string;
+}
+/** NOTE: Server expects an object, NOT a bare string */
+export interface ChatRecoverMessageRequest {
+    messageId: string;
+}
+export interface ChatAddReactionRequest {
+    messageId: string;
+    conversationId: string;
+    emoji: string;
+}
+export interface ChatRemoveReactionRequest {
+    messageId: string;
+    emoji: string;
+}
+export interface SendMessageAck {
+    success: boolean;
+    messageId?: string;
+    clientMessageId?: string;
+    /** ISO 8601 — time the message was created on the server */
+    createdAt?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface EditMessageAck {
+    success: boolean;
+    messageId?: string;
+    /** ISO 8601 */
+    editedAt?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface DeleteMessageAck {
+    success: boolean;
+    messageId?: string;
+    /** ISO 8601 */
+    deletedAt?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface RecoverMessageAck {
+    success: boolean;
+    messageId?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+export interface ReactionAck {
+    success: boolean;
+    messageId?: string;
+    emoji?: string;
+    errorCode?: string;
+    errorMessage?: string;
+}
+/** Hub error sent via 'Error' server→client event */
+export interface HubErrorDto {
+    code: string;
+    message: string;
+    /** Server may explicitly send `null`; field may also be omitted entirely */
+    details?: Record<string, unknown> | null;
+}
+//# sourceMappingURL=signalr.d.ts.map

package/dist/types/signalr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalr.d.ts","sourceRoot":"","sources":["../../src/types/signalr.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAM7D,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,wDAAwD;AACxD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C"}

package/dist/types/signalr.js

@@ -0,0 +1,3 @@
+// signalr.ts — Hub request types (Client→Server) and ack types (Server→Client return values)
+export {};
+//# sourceMappingURL=signalr.js.map

package/dist/types/signalr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signalr.js","sourceRoot":"","sources":["../../src/types/signalr.ts"],"names":[],"mappings":"AAAA,6FAA6F"}

package/dist/utils/TypedEventEmitter.d.ts

@@ -0,0 +1,32 @@
+/** Function returned by on() to remove the handler */
+export type Unsubscribe = () => void;
+/**
+ * Generic typed event emitter.
+ *
+ * Usage:
+ *   type MyEvents = { message: string; count: number };
+ *   const emitter = new TypedEventEmitter<MyEvents>();
+ *   const unsub = emitter.on('message', (msg) => console.log(msg));
+ *   emitter.emit('message', 'hello');
+ *   unsub(); // removes handler
+ */
+export declare class TypedEventEmitter<TEventMap extends object> {
+    private readonly handlers;
+    /**
+     * Subscribe to an event. Returns an unsubscribe function for easy cleanup.
+     */
+    on<K extends keyof TEventMap>(event: K, handler: (payload: TEventMap[K]) => void): Unsubscribe;
+    /**
+     * Unsubscribe a specific handler from an event.
+     */
+    off<K extends keyof TEventMap>(event: K, handler: (payload: TEventMap[K]) => void): void;
+    /**
+     * Emit an event with the given payload. All registered handlers are called synchronously.
+     */
+    emit<K extends keyof TEventMap>(event: K, payload: TEventMap[K]): void;
+    /**
+     * Remove all handlers for all events. Useful for cleanup on disconnect.
+     */
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=TypedEventEmitter.d.ts.map

package/dist/utils/TypedEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedEventEmitter.d.ts","sourceRoot":"","sources":["../../src/utils/TypedEventEmitter.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAErC;;;;;;;;;GASG;AACH,qBAAa,iBAAiB,CAAC,SAAS,SAAS,MAAM;IACrD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+D;IAExF;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,SAAS,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,WAAW;IAWd;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAC3B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,GACvC,IAAI;IAUP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAUtE;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAG3B"}

package/dist/utils/TypedEventEmitter.js

@@ -0,0 +1,60 @@
+// utils/TypedEventEmitter.ts — Generic typed event emitter for SignalR events
+/**
+ * Generic typed event emitter.
+ *
+ * Usage:
+ *   type MyEvents = { message: string; count: number };
+ *   const emitter = new TypedEventEmitter<MyEvents>();
+ *   const unsub = emitter.on('message', (msg) => console.log(msg));
+ *   emitter.emit('message', 'hello');
+ *   unsub(); // removes handler
+ */
+export class TypedEventEmitter {
+    constructor() {
+        this.handlers = new Map();
+    }
+    /**
+     * Subscribe to an event. Returns an unsubscribe function for easy cleanup.
+     */
+    on(event, handler) {
+        let set = this.handlers.get(event);
+        if (!set) {
+            set = new Set();
+            this.handlers.set(event, set);
+        }
+        const h = handler;
+        set.add(h);
+        return () => this.off(event, handler);
+    }
+    /**
+     * Unsubscribe a specific handler from an event.
+     */
+    off(event, handler) {
+        const set = this.handlers.get(event);
+        if (set) {
+            set.delete(handler);
+            if (set.size === 0) {
+                this.handlers.delete(event);
+            }
+        }
+    }
+    /**
+     * Emit an event with the given payload. All registered handlers are called synchronously.
+     */
+    emit(event, payload) {
+        const set = this.handlers.get(event);
+        if (set) {
+            // Copy to avoid mutation issues if a handler unsubscribes during emit
+            for (const h of Array.from(set)) {
+                h(payload);
+            }
+        }
+    }
+    /**
+     * Remove all handlers for all events. Useful for cleanup on disconnect.
+     */
+    removeAllListeners() {
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=TypedEventEmitter.js.map

package/dist/utils/TypedEventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedEventEmitter.js","sourceRoot":"","sources":["../../src/utils/TypedEventEmitter.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAK9E;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACmB,aAAQ,GAAG,IAAI,GAAG,EAAoD,CAAC;IAsD1F,CAAC;IApDC;;OAEG;IACH,EAAE,CACA,KAAQ,EACR,OAAwC;QAExC,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,CAAC,GAAG,OAAqC,CAAC;QAChD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACX,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,GAAG,CACD,KAAQ,EACR,OAAwC;QAExC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,CAAC,OAAqC,CAAC,CAAC;YAClD,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAA4B,KAAQ,EAAE,OAAqB;QAC7D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,GAAG,EAAE,CAAC;YACR,sEAAsE;YACtE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChC,CAAC,CAAC,OAAO,CAAC,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@manonero/chat-client-sdk",
+  "version": "0.0.1-beta.1",
+  "description": "A TypeScript SDK for building chat clients using Microsoft SignalR.",
+  "author": "Manonero",
+  "license": "MIT",
+  "keywords": ["chat", "sdk", "signalr", "typescript", "realtime"],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test",
+    "publish:beta": "npm publish --access public --tag beta",
+    "publish:latest": "npm publish --access public"
+  },
+  "peerDependencies": {
+    "@microsoft/signalr": ">=8.0.0"
+  },
+  "devDependencies": {
+    "@microsoft/signalr": "^10.0.0",
+    "@vitest/coverage-v8": "^4.1.2",
+    "jsdom": "^29.0.1",
+    "typescript": "~5.9.3",
+    "vite": "^8.0.1",
+    "vitest": "^4.1.2"
+  }
+}