@ai-matrx/messaging 0.16.1 → 0.17.0

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { MatrxJsonObject, MatrxTransport } from '@ai-matrx/agents/matrx';
 import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
+import { SessionIdentity as SessionIdentity$1, SessionIdentitySnapshot as SessionIdentitySnapshot$1, SessionIdentityDiagnostic } from '@ai-matrx/data/session-identity';
+export { SERVER_SESSION_IDENTITY } from '@ai-matrx/data/session-identity';
 
 /**
  * THE MESSAGING DOMAIN TYPES.
@@ -858,38 +860,14 @@ type MessagingSupabaseInternal = SupabaseLike & RealtimeClientLike;
  * proven at compile time in `supabase-shape.test.ts`.
  */
 
-interface SessionIdentitySnapshot {
-    /**
-     * `resolving` until the first `getSession()` answers. A user-scoped read or
-     * write issued in this window would name a guess.
-     */
-    readonly state: "resolving" | "resolved";
-    /** Who the session says is acting, or `null` for nobody. */
-    readonly userId: UserId | null;
-}
-interface SessionIdentity {
-    /**
-     * False when the client handed to us has no auth source at all — a
-     * misconfiguration, not "nobody is signed in", and the two get different
-     * sentences.
-     */
-    readonly hasAuthSource: boolean;
-    /** Stable reference until the acting user actually changes. */
-    snapshot(): SessionIdentitySnapshot;
-    subscribe(listener: () => void): () => void;
-    dispose(): void;
-}
+type SessionIdentitySnapshot = SessionIdentitySnapshot$1<UserId>;
+type SessionIdentity = SessionIdentity$1<UserId>;
 interface SessionIdentityOptions {
     readonly client: MessagingSupabaseClient;
-    readonly onDiagnostic?: ((event: {
-        level: "info" | "warn" | "error";
-        message: string;
-        remedy?: string | undefined;
-    }) => void) | undefined;
+    readonly onDiagnostic?: ((event: SessionIdentityDiagnostic) => void) | undefined;
 }
-/** The snapshot every server render sees: nobody is acting on a server. */
-declare const SERVER_SESSION_IDENTITY: SessionIdentitySnapshot;
-declare function createSessionIdentity(options: SessionIdentityOptions): SessionIdentity;
+/** The acting user of `client`'s session, in messaging's words (public as `createSessionIdentity`). */
+declare function createMessagingSessionIdentity(options: SessionIdentityOptions): SessionIdentity;
 
 /**
  * THE DATA CONTRACT — the ONE place a messaging table or RPC name exists.
@@ -1535,4 +1513,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationAiContext, type ConversationCursor, type ConversationId, type ConversationReadCutoff, type ConversationReadFailure, type ConversationSummary, type ConversationThread, type ConversationType, DEFAULT_MESSAGING_ARCHIVE_FILTER, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingArchiveFilter, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PendingSoftExpiries, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, SERVER_SESSION_IDENTITY, type SchemaLike, type SessionIdentity, type SessionIdentitySnapshot, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationContextVariables, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createSessionIdentity, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isLapsed, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, softExpiryTime, splitText, summarizeText, toMessagingArchiveFilter, unreadCutoff, writeNotApplied };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationAiContext, type ConversationCursor, type ConversationId, type ConversationReadCutoff, type ConversationReadFailure, type ConversationSummary, type ConversationThread, type ConversationType, DEFAULT_MESSAGING_ARCHIVE_FILTER, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingArchiveFilter, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PendingSoftExpiries, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionIdentity, type SessionIdentitySnapshot, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationContextVariables, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createMessagingSessionIdentity as createSessionIdentity, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isLapsed, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, softExpiryTime, splitText, summarizeText, toMessagingArchiveFilter, unreadCutoff, writeNotApplied };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { MatrxJsonObject, MatrxTransport } from '@ai-matrx/agents/matrx';
 import { RealtimeClientLike, RealtimeManager } from '@ai-matrx/realtime';
+import { SessionIdentity as SessionIdentity$1, SessionIdentitySnapshot as SessionIdentitySnapshot$1, SessionIdentityDiagnostic } from '@ai-matrx/data/session-identity';
+export { SERVER_SESSION_IDENTITY } from '@ai-matrx/data/session-identity';
 
 /**
  * THE MESSAGING DOMAIN TYPES.
@@ -858,38 +860,14 @@ type MessagingSupabaseInternal = SupabaseLike & RealtimeClientLike;
  * proven at compile time in `supabase-shape.test.ts`.
  */
 
-interface SessionIdentitySnapshot {
-    /**
-     * `resolving` until the first `getSession()` answers. A user-scoped read or
-     * write issued in this window would name a guess.
-     */
-    readonly state: "resolving" | "resolved";
-    /** Who the session says is acting, or `null` for nobody. */
-    readonly userId: UserId | null;
-}
-interface SessionIdentity {
-    /**
-     * False when the client handed to us has no auth source at all — a
-     * misconfiguration, not "nobody is signed in", and the two get different
-     * sentences.
-     */
-    readonly hasAuthSource: boolean;
-    /** Stable reference until the acting user actually changes. */
-    snapshot(): SessionIdentitySnapshot;
-    subscribe(listener: () => void): () => void;
-    dispose(): void;
-}
+type SessionIdentitySnapshot = SessionIdentitySnapshot$1<UserId>;
+type SessionIdentity = SessionIdentity$1<UserId>;
 interface SessionIdentityOptions {
     readonly client: MessagingSupabaseClient;
-    readonly onDiagnostic?: ((event: {
-        level: "info" | "warn" | "error";
-        message: string;
-        remedy?: string | undefined;
-    }) => void) | undefined;
+    readonly onDiagnostic?: ((event: SessionIdentityDiagnostic) => void) | undefined;
 }
-/** The snapshot every server render sees: nobody is acting on a server. */
-declare const SERVER_SESSION_IDENTITY: SessionIdentitySnapshot;
-declare function createSessionIdentity(options: SessionIdentityOptions): SessionIdentity;
+/** The acting user of `client`'s session, in messaging's words (public as `createSessionIdentity`). */
+declare function createMessagingSessionIdentity(options: SessionIdentityOptions): SessionIdentity;
 
 /**
  * THE DATA CONTRACT — the ONE place a messaging table or RPC name exists.
@@ -1535,4 +1513,4 @@ declare function summarizeText(content: string, maxLength?: number): string;
 /** Serialize picked references into a fence the platform's other readers accept. */
 declare function composeFence(references: readonly MatrxReference[]): string;
 
-export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationAiContext, type ConversationCursor, type ConversationId, type ConversationReadCutoff, type ConversationReadFailure, type ConversationSummary, type ConversationThread, type ConversationType, DEFAULT_MESSAGING_ARCHIVE_FILTER, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingArchiveFilter, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PendingSoftExpiries, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, SERVER_SESSION_IDENTITY, type SchemaLike, type SessionIdentity, type SessionIdentitySnapshot, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationContextVariables, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createSessionIdentity, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isLapsed, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, softExpiryTime, splitText, summarizeText, toMessagingArchiveFilter, unreadCutoff, writeNotApplied };
+export { type ActionChoice, type ActionContext, type ActionHandler, type ActionOutcome, type ActionReceipt, type ActionRegistry, type ActorPresentation, type AiCallArgs, type AiCapability, type AiResult, type Attachment, type ClientMessageId, type Conversation, type ConversationAiContext, type ConversationCursor, type ConversationId, type ConversationReadCutoff, type ConversationReadFailure, type ConversationSummary, type ConversationThread, type ConversationType, DEFAULT_MESSAGING_ARCHIVE_FILTER, type DeliveryState, type DraftMessage, type EngineDiagnostic, type JsonObject, type JsonValue, MESSAGING_EVENTS, MESSAGING_RPC_SCHEMA, MESSAGING_SCHEMA, type MatrxReference, type Message, type MessageAction, type MessageCursor, type MessageGroup, type MessageId, type MessageKind, type MessagingAgentIdentity, type MessagingAgents, type MessagingAi, type MessagingAiOptions, type MessagingArchiveFilter, type MessagingEngine, type MessagingEngineOptions, MessagingError, type MessagingErrorCode, type MessagingIdentity, type MessagingRepository, type MessagingSnapshot, type MessagingStore, type MessagingSupabaseClient, type MessagingSupabaseInternal, type OrganizationId, type Outbox, type OutboxEntry, type OutboxOptions, type OutboxStorage, type Page, type Participant, type ParticipantRole, type PendingSoftExpiries, type PostgrestFilterLike, type PostgrestLikeResponse, type PostgrestTableLike, RPCS, type ReadCache, type ReadCacheOptions, type RepositoryOptions, type SchemaLike, type SessionIdentity, type SessionIdentitySnapshot, type SessionResolver, type SupabaseLike, TABLES, type TextSegment, type UserId, type UserSummary, asClientMessageId, asConversationId, asMessageId, asOrganizationId, asUserId, composeFence, conversationContextVariables, conversationTopic, createActionRegistry, createMemoryOutboxStorage, createMessagingAi, createMessagingEngine, createMessagingRepository, createMessagingStore, createOutbox, createReadCache, createMessagingSessionIdentity as createSessionIdentity, createWebOutboxStorage, effectiveActorKey, extractReferences, formatConversationTime, formatDateSeparator, formatLastSeen, formatMessageTime, formatTypists, groupMessages, inboxTopic, invalidResponse, isLapsed, isSameDay, messagingClientId, normalizeMessagingError, optimisticMessage, participantNames, projectConversationSummary, projectMessage, projectMessageAction, projectParticipantRole, projectUserSummary, resolveActor, softExpiryTime, splitText, summarizeText, toMessagingArchiveFilter, unreadCutoff, writeNotApplied };

package/dist/index.js

@@ -509,22 +509,9 @@ function createReadCache(options) {
 
 // src/core/channels.ts
 import { defineChannelNamespace } from "@ai-matrx/realtime";
-
-// src/core/slot.ts
-var NAMESPACE = "ai-matrx.messaging";
-function globalSlot(name, create) {
-  const key = /* @__PURE__ */ Symbol.for(`${NAMESPACE}.${name}`);
-  const host = globalThis;
-  const existing = host[key];
-  if (existing !== void 0) return existing;
-  const created = create();
-  host[key] = created;
-  return created;
-}
-
-// src/core/channels.ts
+import { globalSlot } from "@ai-matrx/kit/global-slot";
 function namespaces() {
-  return globalSlot("channel-namespaces", () => ({
+  return globalSlot("ai-matrx.messaging.channel-namespaces", () => ({
     inbox: defineChannelNamespace({
       namespace: "messaging-inbox",
       parts: ["userId"],
@@ -2021,89 +2008,30 @@ function formatLastSeen(lastSeenMs, now = Date.now()) {
 }
 
 // src/core/session-identity.ts
-var RESOLVING = Object.freeze({
-  state: "resolving",
-  userId: null
-});
-var SERVER_SESSION_IDENTITY = RESOLVING;
-function authOf(client) {
-  const candidate = client.auth;
-  if (candidate === null || typeof candidate !== "object") return null;
-  const auth = candidate;
-  if (typeof auth.getSession !== "function") return null;
-  if (typeof auth.onAuthStateChange !== "function") return null;
-  return auth;
-}
-function userIdOf(session) {
-  const id = session?.user?.id;
-  return typeof id === "string" && id.length > 0 ? asUserId(id) : null;
-}
-var NO_AUTH_SOURCE = {
-  message: "Messaging cannot tell who is signed in: the Supabase client it was given has no auth session source.",
-  remedy: "Pass your app's browser Supabase client \u2014 the same client it signs in with \u2014 to <MessagingProvider client={...}> or createMessagingRepository({ client }). Messaging reads the acting user from that client's session; there is no prop or option for a user id, on purpose (DD-241)."
+import {
+  authOf,
+  createSessionIdentity as createDataSessionIdentity,
+  noAuthSourceMessage,
+  sessionUserId,
+  unreadableSessionMessage
+} from "@ai-matrx/data/session-identity";
+import { authOf as authOf2, SERVER_SESSION_IDENTITY } from "@ai-matrx/data/session-identity";
+var MESSAGING_SESSION_WORDS = {
+  product: "Messaging",
+  noAuthSourceRemedy: "Pass your app's browser Supabase client \u2014 the same client it signs in with \u2014 to <MessagingProvider client={...}> or createMessagingRepository({ client }). Messaging reads the acting user from that client's session; there is no prop or option for a user id, on purpose (DD-241).",
+  unreadableRemedy: "Messages stay unavailable on this device until the session can be read. Reload the page; if it persists, sign in again."
 };
-function createSessionIdentity(options) {
-  const { client, onDiagnostic } = options;
-  const listeners = /* @__PURE__ */ new Set();
-  let current = RESOLVING;
-  let disposed = false;
-  const publish = (state, userId) => {
-    if (disposed) return;
-    if (current.state === state && current.userId === userId) return;
-    current = Object.freeze({ state, userId });
-    for (const listener of [...listeners]) listener();
-  };
-  const subscribeOnly = (hasAuthSource) => ({
-    hasAuthSource,
-    snapshot: () => current,
-    subscribe: (listener) => {
-      listeners.add(listener);
-      return () => {
-        listeners.delete(listener);
-      };
-    },
-    dispose: () => {
-      disposed = true;
-      listeners.clear();
-    }
+function createMessagingSessionIdentity(options) {
+  return createDataSessionIdentity({
+    client: options.client,
+    words: MESSAGING_SESSION_WORDS,
+    toUserId: asUserId,
+    onDiagnostic: options.onDiagnostic
   });
-  const auth = authOf(client);
-  if (auth === null) {
-    onDiagnostic?.({ level: "error", ...NO_AUTH_SOURCE });
-    current = Object.freeze({ state: "resolved", userId: null });
-    return subscribeOnly(false);
-  }
-  void (async () => {
-    try {
-      const result = await auth.getSession();
-      publish("resolved", userIdOf(result?.data?.session));
-    } catch (error) {
-      onDiagnostic?.({
-        level: "warn",
-        message: `Messaging could not read the signed-in session: ${String(
-          error?.message ?? error
-        )}`,
-        remedy: "Messages stay unavailable on this device until the session can be read. Reload the page; if it persists, sign in again."
-      });
-      publish("resolved", null);
-    }
-  })();
-  const subscription = auth.onAuthStateChange((_event, session) => {
-    publish("resolved", userIdOf(session));
-  });
-  const base = subscribeOnly(true);
-  return {
-    hasAuthSource: true,
-    snapshot: base.snapshot,
-    subscribe: base.subscribe,
-    dispose: () => {
-      base.dispose();
-      try {
-        subscription.data.subscription.unsubscribe();
-      } catch {
-      }
-    }
-  };
+}
+function userIdOf(session) {
+  const id = sessionUserId(session);
+  return id === null ? null : asUserId(id);
 }
 function actingUserIdOf(identity) {
   return new Promise((resolve, reject) => {
@@ -2131,11 +2059,8 @@ function noSignedInUserError() {
   );
 }
 function noAuthSourceError() {
-  return new MessagingError(
-    "misconfigured",
-    NO_AUTH_SOURCE.message,
-    NO_AUTH_SOURCE.remedy
-  );
+  const { message, remedy } = noAuthSourceMessage(MESSAGING_SESSION_WORDS);
+  return new MessagingError("misconfigured", message, remedy);
 }
 async function readActingUserId(client) {
   const auth = authOf(client);
@@ -2147,9 +2072,7 @@ async function readActingUserId(client) {
   } catch (error) {
     throw new MessagingError(
       "session-unavailable",
-      `Messaging could not read the signed-in session: ${String(
-        error?.message ?? error
-      )}`,
+      unreadableSessionMessage(MESSAGING_SESSION_WORDS, error),
       "Reload the page and try again; if it persists, sign in again.",
       error
     );
@@ -2805,7 +2728,7 @@ export {
   createMessagingStore,
   createOutbox,
   createReadCache,
-  createSessionIdentity,
+  createMessagingSessionIdentity as createSessionIdentity,
   createWebOutboxStorage,
   effectiveActorKey,
   extractReferences,