@codingfactory/messenger-client 0.1.0

package/README.md

@@ -0,0 +1,38 @@
+# messenger-client
+
+Shared frontend messaging state, API helpers, and realtime composables extracted
+from `blowglass`.
+
+## Status
+
+This package is in copy-first extraction mode. The goal is to preserve proven
+behavior while moving generic messaging code into a standalone package.
+
+## Configuration
+
+Consumer apps should configure the package runtime once during app bootstrap:
+
+```ts
+import { configureMessengerClient } from '@codingfactory/messenger-client'
+
+configureMessengerClient({
+  apiClient,
+  authStore: useAuthStore,
+  mediaApi,
+  createLogger,
+  playMessageNotification,
+  echo: {
+    initializedEvent: 'blowglass:echo-initialized',
+    getEcho,
+    onConnectionStatusChange,
+    subscribeToPresenceStatus,
+    unsubscribeFromPresenceStatus,
+    subscribeToConversation,
+    unsubscribeFromConversation,
+  },
+})
+```
+
+The extracted store and composables can then be imported from the package
+instead of staying embedded inside the consumer app.
+

package/dist/composables/useConversationChannel.d.ts

@@ -0,0 +1,13 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+type UseConversationChannel = {
+    isSubscribed: ComputedRef<boolean>;
+    error: ComputedRef<string | null>;
+    subscribe: () => void;
+    unsubscribe: () => void;
+};
+/**
+ * Composable for managing WebSocket subscription to a specific conversation
+ * Handles real-time message events and updates the messaging store
+ */
+export declare function useConversationChannel(conversationIdSource: MaybeRefOrGetter<string | null | undefined>): UseConversationChannel;
+export {};

package/dist/composables/useGlobalMessaging.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Subscribes to a bounded set of the current user's most recent conversation
+ * channels so incoming messages can update unread counts without auth-bursting
+ * the entire inbox.
+ *
+ * When a conversation also has an active useConversationChannel (detail view),
+ * the global handler skips the unread increment to avoid double counting.
+ * The detail handler already handles addMessage + unread for that conversation.
+ *
+ * Usage: call once in TabsLayout (the root authenticated layout).
+ */
+export declare function useGlobalMessaging(): void;

package/dist/composables/useNotificationSound.d.ts

@@ -0,0 +1,4 @@
+export type PlayMessageNotification = (isMuted: boolean) => void;
+export declare let playMessageNotification: PlayMessageNotification;
+export declare function setMessageNotificationPlayer(player: PlayMessageNotification): void;
+export declare function resetMessageNotificationPlayer(): void;

package/dist/configure.d.ts

@@ -0,0 +1,16 @@
+import { type MessagingHttpClient } from './services/auth';
+import { type EchoRuntimeConfig } from './services/echo';
+import { type MessagingMediaApi } from './services/mediaApi';
+import { type UseMessagingAuthStore } from './stores/auth';
+import { type PlayMessageNotification } from './composables/useNotificationSound';
+import { type CreateLogger } from './utils/logger';
+export interface MessengerClientConfig {
+    apiClient?: MessagingHttpClient;
+    authStore?: UseMessagingAuthStore;
+    mediaApi?: MessagingMediaApi;
+    createLogger?: CreateLogger;
+    playMessageNotification?: PlayMessageNotification;
+    echo?: EchoRuntimeConfig;
+}
+export declare function configureMessengerClient(config: MessengerClientConfig): void;
+export declare function resetMessengerClientConfig(): void;

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from './composables/useConversationChannel';
+export * from './composables/useGlobalMessaging';
+export * from './configure';
+export * from './services/api/messaging';
+export * from './services/auth';
+export * from './services/echo';
+export * from './services/mediaApi';
+export * from './stores/auth';
+export * from './stores/messaging';
+export * from './utils/errorUtils';
+export * from './utils/logger';