@codingfactory/messenger-client 0.2.37 → 0.3.0

package/dist/services/moderation.d.ts

@@ -0,0 +1,9 @@
+export interface ReportPayload {
+    subject_urn: string;
+    category: string;
+    notes?: string;
+}
+export type ReportFn = (payload: ReportPayload) => Promise<void>;
+export declare function setModerationProvider(fn: ReportFn): void;
+export declare function resetModerationProvider(): void;
+export declare function fileReport(payload: ReportPayload): Promise<void>;

package/dist/services/terminology.d.ts

@@ -0,0 +1,10 @@
+export type TermFn = (key: string, params?: Record<string, unknown>) => string;
+export declare function setTermsProvider(fn: TermFn): void;
+export declare function resetTermsProvider(): void;
+/**
+ * Composable-style hook matching the blowglass `useTerms()` API.
+ * Returns an object with a `term()` function.
+ */
+export declare function useTerms(): {
+    term: TermFn;
+};

package/dist/services/toast.d.ts

@@ -0,0 +1,5 @@
+export type ToastColor = 'success' | 'error' | 'info' | 'warning';
+export type ToastFn = (message: string, type?: ToastColor) => void;
+export declare function setToastProvider(fn: ToastFn): void;
+export declare function resetToastProvider(): void;
+export declare function showToast(message: string, type?: ToastColor): void;

package/dist/services/tokenStorage.d.ts

@@ -0,0 +1,4 @@
+export type GetTokenFn = () => string | null;
+export declare function setTokenProvider(fn: GetTokenFn): void;
+export declare function resetTokenProvider(): void;
+export declare function getToken(): string | null;

package/dist/stores/chatWidget.d.ts

@@ -0,0 +1,62 @@
+export interface ChatWindowState {
+    conversationId: string;
+    minimized: boolean;
+}
+interface ChatWidgetState {
+    /** Whether the main panel (conversation list) is open */
+    panelOpen: boolean;
+    /** Open chat windows, ordered left-to-right. Max 3 on desktop. */
+    openWindows: ChatWindowState[];
+    /** Dynamic max windows based on viewport (1-3). */
+    maxWindows: number;
+}
+export declare const useChatWidgetStore: import("pinia").StoreDefinition<"chatWidget", ChatWidgetState, {
+    isWindowOpen: (state: {
+        panelOpen: boolean;
+        openWindows: {
+            conversationId: string;
+            minimized: boolean;
+        }[];
+        maxWindows: number;
+    } & import("pinia").PiniaCustomStateProperties<ChatWidgetState>) => (conversationId: string) => boolean;
+    getWindow: (state: {
+        panelOpen: boolean;
+        openWindows: {
+            conversationId: string;
+            minimized: boolean;
+        }[];
+        maxWindows: number;
+    } & import("pinia").PiniaCustomStateProperties<ChatWidgetState>) => (conversationId: string) => ChatWindowState | undefined;
+    expandedWindows: (state: {
+        panelOpen: boolean;
+        openWindows: {
+            conversationId: string;
+            minimized: boolean;
+        }[];
+        maxWindows: number;
+    } & import("pinia").PiniaCustomStateProperties<ChatWidgetState>) => ChatWindowState[];
+    minimizedWindows: (state: {
+        panelOpen: boolean;
+        openWindows: {
+            conversationId: string;
+            minimized: boolean;
+        }[];
+        maxWindows: number;
+    } & import("pinia").PiniaCustomStateProperties<ChatWidgetState>) => ChatWindowState[];
+}, {
+    togglePanel(): void;
+    openPanel(): void;
+    closePanel(): void;
+    setMaxWindows(maxWindows: number): void;
+    /**
+     * Open a conversation in its own chat window.
+     * If already open, bring it to focus (un-minimize).
+     * If max windows reached, close the oldest one.
+     */
+    openWindow(conversationId: string): void;
+    closeWindow(conversationId: string): void;
+    minimizeWindow(conversationId: string): void;
+    toggleMinimize(conversationId: string): void;
+    closeAllWindows(): void;
+}>;
+export {};

package/dist/utils/contentFormatter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Format a message body for safe HTML rendering.
+ * Escapes HTML, converts newlines to <br>, and auto-links URLs.
+ */
+export declare function formatMessageBody(body: string): string;
+/**
+ * Check if text contains only emoji characters (no regular text).
+ */
+export declare function isEmojiOnly(text: string): boolean;

package/dist/utils/mediaUrl.d.ts

@@ -0,0 +1,8 @@
+import type { Attachment } from '../stores/messaging';
+export type NormalizeMediaUrlFn = (url: string | undefined) => string | undefined;
+export type ResolveVideoPlaybackUrlFn = (attachment: Attachment) => string | undefined;
+export declare function setNormalizeMediaUrl(fn: NormalizeMediaUrlFn): void;
+export declare function setResolveVideoPlaybackUrl(fn: ResolveVideoPlaybackUrlFn): void;
+export declare function resetMediaUrlProviders(): void;
+export declare function normalizeMediaUrl(url: string | undefined): string | undefined;
+export declare function resolveMessageVideoPlaybackUrl(attachment: Attachment): string | undefined;

package/dist/utils/messagingDates.d.ts

@@ -0,0 +1,4 @@
+import type { Message } from '../stores/messaging';
+export declare function isSameMessageDay(previousMessage: Message, currentMessage: Message): boolean;
+export declare function shouldShowDaySeparatorForIndex(messages: Message[], index: number): boolean;
+export declare function formatMessageDayLabel(message: Message): string;

package/dist/utils/messagingScroll.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Calculates the scrollTop needed to center a message inside the scroll container.
+ * The result is clamped to [0, maxScrollTop].
+ */
+export declare const calculateCenteredScrollTop: (containerRect: DOMRect, messageRect: DOMRect, currentScrollTop: number, maxScrollTop: number) => number;
+type ScrollableElement = {
+    clientHeight?: number;
+    scrollHeight?: number;
+    scrollTop: number;
+    scrollTo?: (options: ScrollToOptions) => void;
+};
+/**
+ * Keeps the current viewport anchored when older messages are prepended above it.
+ */
+export declare const calculateAnchoredPrependScrollTop: (previousScrollHeight: number, previousScrollTop: number, nextScrollHeight: number) => number;
+/**
+ * Returns the current distance between the viewport and the bottom of the scrollable area.
+ */
+export declare const getDistanceFromBottom: (element: ScrollableElement) => number;
+/**
+ * Reports whether the viewport is close enough to the bottom to be treated as "sticky".
+ */
+export declare const isScrollNearBottom: (element: ScrollableElement, thresholdPx?: number) => boolean;
+/**
+ * Scrolls a container to `top` with smooth behavior when possible.
+ * Falls back to setting `scrollTop` directly if smooth scrolling no-ops.
+ */
+export declare const scrollElementTo: (element: ScrollableElement, top: number, fallbackDelayMs?: number, behavior?: ScrollBehavior) => void;
+export {};

package/dist/utils/messagingScrollMemory.d.ts

@@ -0,0 +1,4 @@
+export declare const getSavedScrollTop: (key: string) => number;
+export declare const hasSavedScrollTop: (key: string) => boolean;
+export declare const setSavedScrollTop: (key: string, scrollTop: number) => void;
+export declare const clearSavedScrollTop: (key: string) => void;

package/dist/utils/messagingUnread.d.ts

@@ -0,0 +1,2 @@
+import type { Conversation, Message } from '../stores/messaging';
+export declare const resolveFirstUnreadMessageId: (conversation: Conversation | undefined, messages: Message[], currentUserId?: string) => string | null;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codingfactory/messenger-client",
-  "version": "0.2.37",
-  "description": "Shared messaging frontend state, API helpers, and realtime composables.",
+  "version": "0.3.0",
+  "description": "Shared messaging frontend: UI components, state management, API helpers, and realtime composables.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -25,21 +25,29 @@
   },
   "dependencies": {
     "axios": "^1.13.6",
-    "ionicons": "^8.0.13",
     "laravel-echo": "^2.2.0",
     "pusher-js": "^8.4.0"
   },
   "peerDependencies": {
     "pinia": "^3.0.0",
     "vue": "^3.5.0",
-    "vue-router": "^4.5.0 || ^5.0.0"
+    "vue-router": "^4.5.0 || ^5.0.0",
+    "date-fns": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "date-fns": { "optional": true },
+    "@ionic/vue": { "optional": true }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@ionic/vue": "^8.8.1",
     "@types/node": "^25.3.5",
+    "@vitejs/plugin-vue": "^6.0.5",
     "@vue/test-utils": "^2.4.6",
+    "date-fns": "^4.1.0",
     "eslint": "^10.0.3",
     "globals": "^17.4.0",
+    "ionicons": "^8.0.13",
     "jsdom": "^28.1.0",
     "pinia": "^3.0.4",
     "typescript": "^5.9.3",