uapp-communication-sdk 1.0.0-dev.101

package/types/features/chat/infrastructure/chat-realtime-parsers.d.ts

@@ -0,0 +1,12 @@
+import { type Logger } from '@core/logger';
+import { type ChatMessageDto } from './dto/chat-dtos';
+import { type MessageDeletedPayload, type PresencePayload, type ReactionTogglePayload, type ReceiptPayload, type RemovedFromConversationPayload, type StatusPayload, type TypingPayload } from './chat-realtime-protocol';
+export declare const parseRealtimeMessage: (payload: unknown, event: string, logger: Logger) => ChatMessageDto | null;
+export declare const parseReceiptPayload: (payload: unknown, event: string, logger: Logger) => ReceiptPayload | null;
+export declare const parseTypingPayload: (payload: unknown, event: string, logger: Logger) => TypingPayload | null;
+export declare const parsePresencePayload: (payload: unknown, event: string, logger: Logger) => PresencePayload | null;
+export declare const parseStatusPayload: (payload: unknown, event: string, logger: Logger) => StatusPayload | null;
+export declare const parseReactionTogglePayload: (payload: unknown, event: string, logger: Logger) => ReactionTogglePayload | null;
+export declare const parseMessageDeletedPayload: (payload: unknown, event: string, logger: Logger) => MessageDeletedPayload | null;
+export declare const parseRemovedFromConversationPayload: (payload: unknown, event: string, logger: Logger) => RemovedFromConversationPayload | null;
+//# sourceMappingURL=chat-realtime-parsers.d.ts.map

package/types/features/chat/infrastructure/chat-realtime-parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-realtime-parsers.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-realtime-parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAQL,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,8BAA8B,EACnC,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAsBlC,eAAO,MAAM,oBAAoB,GAC/B,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,cAAc,GAAG,IAAwD,CAAC;AAE7E,eAAO,MAAM,mBAAmB,GAC9B,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,cAAc,GAAG,IAA2D,CAAC;AAEhF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,aAAa,GAAG,IAA0D,CAAC;AAE9E,eAAO,MAAM,oBAAoB,GAC/B,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,eAAe,GAAG,IAA4D,CAAC;AAElF,eAAO,MAAM,kBAAkB,GAC7B,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,aAAa,GAAG,IAA0D,CAAC;AAE9E,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,qBAAqB,GAAG,IACiC,CAAC;AAE7D,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,qBAAqB,GAAG,IACiC,CAAC;AAE7D,eAAO,MAAM,mCAAmC,GAC9C,SAAS,OAAO,EAChB,OAAO,MAAM,EACb,QAAQ,MAAM,KACb,8BAA8B,GAAG,IACiC,CAAC"}

package/types/features/chat/infrastructure/chat-realtime-protocol.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+/**
+ * The chat real-time wire contract. The single source of truth for the SignalR hub path, the
+ * server→client event names, the client→server method names, and the Zod schemas for every
+ * non-message payload. Lives in `infrastructure` because it is a boundary concern (like the HTTP
+ * DTOs): the presentation layer validates incoming frames against these schemas before any data
+ * reaches the realtime store or the query cache. The `MessageReceived` event carries a full
+ * `ChatMessageDto` and is validated with the existing `ChatMessageSchema` in `dto/chat-dtos.ts`.
+ */
+/** SignalR hub path — same-origin; the Vite dev proxy forwards `/signalr` (with websockets). */
+export declare const CHAT_HUB_PATH = "/signalr/chat";
+/** Server→client event names. Subscribe via `connection.on(name, ...)`. */
+export declare const ClientEvents: {
+    readonly MessageReceived: "MessageReceived";
+    readonly MessageEdited: "MessageEdited";
+    readonly MessageDeleted: "MessageDeleted";
+    readonly MessageDelivered: "MessageDelivered";
+    readonly MessageRead: "MessageRead";
+    readonly Typing: "Typing";
+    readonly PresenceChanged: "PresenceChanged";
+    readonly StatusChanged: "StatusChanged";
+    readonly ReactionToggled: "ReactionToggled";
+    readonly RemovedFromConversation: "RemovedFromConversation";
+};
+/** Client→server method names. Invoke via `connection.invoke(name, ...args)`. */
+export declare const ServerMethods: {
+    readonly MarkRead: "MarkRead";
+    readonly MarkDelivered: "MarkDelivered";
+    readonly Typing: "Typing";
+};
+/** `{ conversationId, byUserId, uptoSequence }` — a delivery/read pointer moved by another member. */
+export declare const ReceiptPayloadSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    byUserId: z.ZodString;
+    uptoSequence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    uptoSequence: number;
+    byUserId: string;
+}, {
+    conversationId: string;
+    uptoSequence: number;
+    byUserId: string;
+}>;
+export type ReceiptPayload = z.infer<typeof ReceiptPayloadSchema>;
+/** `{ conversationId, userId, isTyping }` — a member started/stopped typing in a conversation. */
+export declare const TypingPayloadSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    userId: z.ZodString;
+    isTyping: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    conversationId: string;
+    isTyping: boolean;
+}, {
+    userId: string;
+    conversationId: string;
+    isTyping: boolean;
+}>;
+export type TypingPayload = z.infer<typeof TypingPayloadSchema>;
+/** `{ userId, online, lastSeenUtc }` — a member's presence changed. `lastSeenUtc` is null while online. */
+export declare const PresencePayloadSchema: z.ZodObject<{
+    userId: z.ZodString;
+    online: z.ZodBoolean;
+    lastSeenUtc: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    online: boolean;
+    lastSeenUtc: string | null;
+}, {
+    userId: string;
+    online: boolean;
+    lastSeenUtc: string | null;
+}>;
+export type PresencePayload = z.infer<typeof PresencePayloadSchema>;
+/**
+ * `{ userId, status, untilUtc }` — a member's STATUS changed. Separate from the presence frame
+ * because the two answer different questions: presence carries the dot, this carries the badge, and
+ * joining a meeting emits this one alone.
+ *
+ * <p>`status` is the wire NUMBER, mapped through `presenceStatusFromNumber` so a value this client
+ * predates degrades to `offline` rather than to a confident wrong label.</p>
+ */
+export declare const StatusPayloadSchema: z.ZodObject<{
+    userId: z.ZodString;
+    status: z.ZodNumber;
+    untilUtc: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: number;
+    userId: string;
+    untilUtc?: string | null | undefined;
+}, {
+    status: number;
+    userId: string;
+    untilUtc?: string | null | undefined;
+}>;
+export type StatusPayload = z.infer<typeof StatusPayloadSchema>;
+/**
+ * `{ conversationId, messageId, byUserId, emoji, added }` — a per-user reaction toggle DELTA (NOT a
+ * per-viewer count/reacted snapshot). `added` is true when the user added the emoji, false when they
+ * removed it. The presentation layer folds this into the cached message via `applyReactionToggle`.
+ */
+export declare const ReactionTogglePayloadSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    byUserId: z.ZodString;
+    emoji: z.ZodString;
+    added: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+    emoji: string;
+    byUserId: string;
+    added: boolean;
+}, {
+    conversationId: string;
+    messageId: string;
+    emoji: string;
+    byUserId: string;
+    added: boolean;
+}>;
+export type ReactionTogglePayload = z.infer<typeof ReactionTogglePayloadSchema>;
+/** `{ conversationId, messageId }` — a message was deleted for everyone. */
+export declare const MessageDeletedPayloadSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>;
+export type MessageDeletedPayload = z.infer<typeof MessageDeletedPayloadSchema>;
+/** `{ conversationId }` — the viewer was removed from this conversation (sent to them only). */
+export declare const RemovedFromConversationPayloadSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+}, {
+    conversationId: string;
+}>;
+export type RemovedFromConversationPayload = z.infer<typeof RemovedFromConversationPayloadSchema>;
+//# sourceMappingURL=chat-realtime-protocol.d.ts.map

package/types/features/chat/infrastructure/chat-realtime-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-realtime-protocol.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-realtime-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AAEH,gGAAgG;AAChG,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,2EAA2E;AAC3E,eAAO,MAAM,YAAY;;;;;;;;;;;CAWf,CAAC;AAEX,iFAAiF;AACjF,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,sGAAsG;AACtG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,kGAAkG;AAClG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,2GAA2G;AAC3G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;EAMtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B;;;;;;;;;EAGtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,gGAAgG;AAChG,eAAO,MAAM,oCAAoC;;;;;;EAE/C,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,oCAAoC,CAC5C,CAAC"}

package/types/features/chat/infrastructure/chat-seed.d.ts

@@ -0,0 +1,68 @@
+import { type ChatMessageKind, type ConversationKind, type ConversationMember, type ConversationMemberReceipt, ChatMessage } from '../domain';
+/** The current viewer (matches the shell's demo user). Messages from this id render right-aligned. */
+export declare const VIEWER: {
+    readonly id: "u-shamim";
+    readonly name: "Shamim Rahman";
+    readonly initials: "SR";
+    readonly color: "#e9445a";
+};
+/** A reaction stored by the WHO that reacted — so one user counts once and can toggle off. */
+export interface MockReaction {
+    readonly emoji: string;
+    readonly userIds: readonly string[];
+}
+export interface MockMessage {
+    id: string;
+    kind: ChatMessageKind;
+    authorId: string;
+    authorName: string;
+    authorInitials: string;
+    authorColor: string;
+    text: string;
+    time: string;
+    /** Per-conversation monotonic order — assigned by `seedThread` / on send. */
+    sequence: number;
+    /** Idempotency key echoed back to the sender (null for seed/system messages). */
+    clientMessageId: string | null;
+    reactions: readonly MockReaction[];
+    deletedForEveryone?: boolean;
+}
+export interface MockConversation {
+    id: string;
+    kind: ConversationKind;
+    title: string;
+    subtitle: string;
+    initials: string;
+    color: string;
+    online: boolean;
+    unread: number;
+    pinned: boolean;
+    favourite: boolean;
+    archived: boolean;
+    admin: boolean;
+    lastMessage: string;
+    lastTime: string;
+    lastSynced: string | null;
+    tenantId: string;
+    categoryId: string | null;
+    members: readonly ConversationMember[];
+    adminIds: readonly string[];
+    data: Readonly<Record<string, string>>;
+    peerUserId: string | null;
+    memberReceipts: readonly ConversationMemberReceipt[];
+}
+export declare const me: (id: string, text: string, time: string, reactions?: readonly MockReaction[]) => MockMessage;
+/** A centered activity line — "Shamim Rahman added Mihadul Islam", "… made … an admin", etc. */
+export declare const sys: (id: string, text: string, time: string) => MockMessage;
+/** Assign monotonic per-conversation sequences (1-based) to a freshly-built seed thread. */
+export declare const seedThread: (messages: readonly MockMessage[]) => MockMessage[];
+/** Everyone who can be added to a group from the Manage-members picker. */
+export declare const CHAT_STAFF: readonly ConversationMember[];
+export declare const SEED_CONVERSATIONS: readonly MockConversation[];
+/** Build a minimal DM mock conversation with a freshly-allocated id, used by the mock gateway. */
+export declare const makeDirectConversation: (id: string, peer: ConversationMember) => MockConversation;
+/** Build a minimal group mock conversation (viewer is the sole admin), used by the mock gateway. */
+export declare const makeGroupConversation: (id: string, title: string, members: readonly ConversationMember[]) => MockConversation;
+export declare const seedMessages: () => Map<string, MockMessage[]>;
+export declare const toMessage: (message: MockMessage) => ChatMessage;
+//# sourceMappingURL=chat-seed.d.ts.map

package/types/features/chat/infrastructure/chat-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-seed.d.ts","sourceRoot":"","sources":["../../../../../../src/features/chat/infrastructure/chat-seed.ts"],"names":[],"mappings":"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"}