@ai-matrx/associations 0.7.6 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog — @ai-matrx/associations
 
+## 0.8.0 — 2026-09-07
+
+**Consumer action (C28).** Two exports MOVED OUT of this package.
+
+| was | now |
+|---|---|
+| `import { formatRelativeTime } from "@ai-matrx/associations/react"` | `import { formatRelativeTime } from "@ai-matrx/kit/format"` |
+| `import { isUuid } from "@ai-matrx/associations/core"` | `import { isUuidShape } from "@ai-matrx/kit/uuid"` |
+
+**`formatRelativeTime` keeps its exact voice behind two options.** This
+package's copy was the `Intl.RelativeTimeFormat` one that echoes an
+unparseable input instead of an em-dash. Kit's default style is the dense
+`"2m ago"` form, so pass the options to keep this behaviour byte-for-byte:
+
+```ts
+formatRelativeTime(iso, { style: "intl", fallbackToInput: true })
+```
+
+An explicit `now` moves from the second positional argument into the options
+bag: `formatRelativeTime(iso, now)` becomes
+`formatRelativeTime(iso, { now, style: "intl", fallbackToInput: true })`.
+
+**`isUuid` -> `isUuidShape`.** The rename is the point. The fleet had TWO
+predicates both called `isUuid` — this package's LAX 8-4-4-4-12 shape check,
+and a STRICT RFC-4122 one on six matrx-frontend API doors — and the difference
+was invisible at the call site. Both now live in `@ai-matrx/kit/uuid` under
+names that say which is which, and `isUuidShape` is the drop-in for this one. A
+bare `isUuid` is deliberately not exported anywhere: a caller must choose.
+`isRfc4122Uuid` REJECTS things `isUuidShape` accepts (the nil UUID, every
+v6/v7/v8 id) — never swap one for the other to make a test pass.
+
+**Why.** Duplication census finding H1 (2026-09-07): this package and
+`@ai-matrx/diff` each defined their own `formatRelativeTime`, so ~16 host twins
+had no correct owner. The `assoc_*` guards still validate ids exactly as
+before, proven end-to-end by the existing guard suite.
+
+New dependency: `@ai-matrx/kit` (`latest`).
+
 ## 0.7.6
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/core/index.cjs

@@ -47,7 +47,6 @@ __export(core_exports, {
   isContentSourceEdge: () => isContentSourceEdge,
   isMembershipMetadata: () => isMembershipMetadata,
   isTransportFailure: () => isTransportFailure,
-  isUuid: () => isUuid,
   ok: () => ok,
   resolveEntityToken: () => resolveEntityToken
 });
@@ -76,6 +75,9 @@ function createDefaultErrorSink() {
   };
 }
 
+// src/core/guards.ts
+var import_uuid = require("@ai-matrx/kit/uuid");
+
 // src/entity-types.generated.ts
 var ENTITY_TYPE_METADATA = {
   "access_request": { token: "access_request", schema: "iam", table: "access_requests", label: "Access Request", baseTier: 1, isComponent: false, isModule: false, isListed: false, scopeable: true, category: "System", referencePickable: false, titleColumn: null, contentRole: "utility", referenceCategory: null },
@@ -1401,10 +1403,6 @@ function isEntityTypeToken(value) {
 }
 
 // src/core/guards.ts
-var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-function isUuid(value) {
-  return typeof value === "string" && UUID_RE.test(value);
-}
 function show(value) {
   if (typeof value === "string") return JSON.stringify(value);
   if (value === null || value === void 0) return String(value);
@@ -1439,11 +1437,11 @@ function createAssociationGuards(errorSink) {
   }
   return {
     checkUuid(field, value) {
-      return isUuid(value) ? null : invalid(field, value, "must be a UUID");
+      return (0, import_uuid.isUuidShape)(value) ? null : invalid(field, value, "must be a UUID");
     },
     checkUuidArray(field, values) {
       for (let i = 0; i < values.length; i++) {
-        if (!isUuid(values[i]))
+        if (!(0, import_uuid.isUuidShape)(values[i]))
           return invalid(`${field}[${i}]`, values[i], "must be a UUID");
       }
       return null;