@ai-matrx/messaging 0.16.2 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — `@ai-matrx/messaging`
 
+## 0.17.0 — session identity and global slots have one home
+
+- The session reader is `@ai-matrx/data/session-identity`; messaging supplies its words, its
+  branded `UserId` and its errors. `createSessionIdentity` (public) keeps its signature and words.
+  Test helpers `fakeSession`/`withSession`/`signedInAs` come from `@ai-matrx/data/testing`.
+- Global slots use `@ai-matrx/kit/global-slot`; keys unchanged (`ai-matrx.messaging.*`).
+- New dependency: `@ai-matrx/data` (architecture step 11).
+
+Consumer action: none.
+
 ## 0.16.2
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/index.cjs

@@ -26,7 +26,7 @@ __export(src_exports, {
   MESSAGING_SCHEMA: () => MESSAGING_SCHEMA,
   MessagingError: () => MessagingError,
   RPCS: () => RPCS,
-  SERVER_SESSION_IDENTITY: () => SERVER_SESSION_IDENTITY,
+  SERVER_SESSION_IDENTITY: () => import_session_identity2.SERVER_SESSION_IDENTITY,
   TABLES: () => TABLES,
   asClientMessageId: () => asClientMessageId,
   asConversationId: () => asConversationId,
@@ -44,7 +44,7 @@ __export(src_exports, {
   createMessagingStore: () => createMessagingStore,
   createOutbox: () => createOutbox,
   createReadCache: () => createReadCache,
-  createSessionIdentity: () => createSessionIdentity,
+  createSessionIdentity: () => createMessagingSessionIdentity,
   createWebOutboxStorage: () => createWebOutboxStorage,
   effectiveActorKey: () => effectiveActorKey,
   extractReferences: () => extractReferences,
@@ -585,22 +585,9 @@ function createReadCache(options) {
 
 // src/core/channels.ts
 var import_realtime = require("@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
+var import_global_slot = require("@ai-matrx/kit/global-slot");
 function namespaces() {
-  return globalSlot("channel-namespaces", () => ({
+  return (0, import_global_slot.globalSlot)("ai-matrx.messaging.channel-namespaces", () => ({
     inbox: (0, import_realtime.defineChannelNamespace)({
       namespace: "messaging-inbox",
       parts: ["userId"],
@@ -2095,89 +2082,24 @@ 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)."
+var import_session_identity = require("@ai-matrx/data/session-identity");
+var import_session_identity2 = require("@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 (0, import_session_identity.createSessionIdentity)({
+    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 = (0, import_session_identity.sessionUserId)(session);
+  return id === null ? null : asUserId(id);
 }
 function actingUserIdOf(identity) {
   return new Promise((resolve, reject) => {
@@ -2205,14 +2127,11 @@ function noSignedInUserError() {
   );
 }
 function noAuthSourceError() {
-  return new MessagingError(
-    "misconfigured",
-    NO_AUTH_SOURCE.message,
-    NO_AUTH_SOURCE.remedy
-  );
+  const { message, remedy } = (0, import_session_identity.noAuthSourceMessage)(MESSAGING_SESSION_WORDS);
+  return new MessagingError("misconfigured", message, remedy);
 }
 async function readActingUserId(client) {
-  const auth = authOf(client);
+  const auth = (0, import_session_identity.authOf)(client);
   if (auth === null) throw noAuthSourceError();
   let session;
   try {
@@ -2221,9 +2140,7 @@ async function readActingUserId(client) {
   } catch (error) {
     throw new MessagingError(
       "session-unavailable",
-      `Messaging could not read the signed-in session: ${String(
-        error?.message ?? error
-      )}`,
+      (0, import_session_identity.unreadableSessionMessage)(MESSAGING_SESSION_WORDS, error),
       "Reload the page and try again; if it persists, sign in again.",
       error
     );