@ai-matrx/messaging 0.4.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # Changelog — `@ai-matrx/messaging`
 
+## 0.6.0 — 2026-09-07
+
+**The two entries did not agree on their own branded ids.** A consumer that minted a
+`ConversationId` with `asConversationId` from `@ai-matrx/messaging` could not pass it to a hook
+from `@ai-matrx/messaging/react` — the two were different types, with an error message that
+blames the consumer. Found by the first real adoption, which does exactly that on its
+conversation route.
+
+### Fixed
+
+- **The nominal brand is a named marker, not a `unique symbol`.** The package ships two entries
+  built as two bundles, so every shared type is DECLARED TWICE in the shipped `.d.ts` — and two
+  `declare const brand: unique symbol` declarations are two different symbols, hence two
+  incompatible `ConversationId`s. A structural marker (`__mxBrand`) is identical in both
+  declarations, so the brands unify while still being impossible to produce by accident. No
+  runtime change: the marker is types-only.
+- **`verify-tarball` now typechecks a real consumer against BOTH entries** — core-minted ids
+  assigned to `/react` types and back. It fails against the `unique symbol` build, which is the
+  only way this class can be caught: in `src/` there is only ever one declaration, so every
+  source gate stays green while the shipped types are broken.
+- The canary still imported `getInitials` / `avatarPaletteIndex`, which moved to
+  `@ai-matrx/kit/format` in 0.5.0 — it would have failed that release's publish.
+
+### Consumer action (C28)
+
+None. `asConversationId(...)` and friends behave exactly as before; ids from the two entries now
+actually interoperate, which is what the types always claimed.
+
+## 0.5.0 — 2026-09-07
+
+**Consumer action (C28).** Two exports MOVED OUT of this package to
+`@ai-matrx/kit/format`. Update the import; the behaviour is identical.
+
+| was | now |
+|---|---|
+| `import { getInitials } from "@ai-matrx/messaging"` | `import { getInitials } from "@ai-matrx/kit/format"` |
+| `import { avatarPaletteIndex } from "@ai-matrx/messaging"` | `import { avatarPaletteIndex } from "@ai-matrx/kit/format"` |
+
+**Why.** Duplication census finding H1 (2026-09-07): both bodies were
+duplicated in `@ai-matrx/meet`, and while two packages claimed them no host
+twin had a correct owner to point at. They now live in `@ai-matrx/kit`, which
+has zero sibling dependencies.
+
+The conversation-shaped formatters — `formatConversationTime`,
+`formatMessageTime`, `formatDateSeparator`, `formatLastSeen`, `formatTypists`,
+`groupMessages`, `isSameDay`, `participantNames` — all stay here. Nothing is
+re-exported: this package imports kit directly.
+
+New dependency: `@ai-matrx/kit` (`latest`).
+
 ## 0.4.0 — 2026-09-07
 
 **A ```matrx fence written in the PLATFORM's dialect was being deleted on render.** Found the

package/dist/index.cjs

@@ -30,7 +30,6 @@ __export(src_exports, {
   asMessageId: () => asMessageId,
   asOrganizationId: () => asOrganizationId,
   asUserId: () => asUserId,
-  avatarPaletteIndex: () => avatarPaletteIndex,
   composeFence: () => composeFence,
   conversationTopic: () => conversationTopic,
   createActionRegistry: () => createActionRegistry,
@@ -48,7 +47,6 @@ __export(src_exports, {
   formatLastSeen: () => formatLastSeen,
   formatMessageTime: () => formatMessageTime,
   formatTypists: () => formatTypists,
-  getInitials: () => getInitials,
   groupMessages: () => groupMessages,
   inboxTopic: () => inboxTopic,
   invalidResponse: () => invalidResponse,
@@ -1496,20 +1494,6 @@ function formatDateSeparator(isoString, now = Date.now(), locale) {
     day: "numeric"
   });
 }
-function getInitials(name) {
-  const parts = name.trim().split(/\s+/).filter(Boolean);
-  if (parts.length === 0) return "?";
-  const first = parts[0]?.[0] ?? "";
-  const last = parts.length > 1 ? parts.at(-1)?.[0] ?? "" : "";
-  return `${first}${last}`.toUpperCase() || "?";
-}
-function avatarPaletteIndex(seed, buckets = 8) {
-  let hash = 0;
-  for (let index = 0; index < seed.length; index += 1) {
-    hash = hash * 31 + seed.charCodeAt(index) | 0;
-  }
-  return Math.abs(hash) % buckets;
-}
 function groupMessages(messages, args = {}) {
   const windowMs = args.windowMs ?? 5 * MINUTE;
   const now = args.now ?? Date.now();