@company-semantics/contracts 44.4.0 → 44.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "44.4.0",
+  "version": "44.5.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/__tests__/resource-keys.test.ts

@@ -98,6 +98,37 @@ describe("resource-keys: system-scoped internalAdmin* types", () => {
   });
 });
 
+describe("resource-keys: userMd (user-scoped singleton)", () => {
+  const USER_ID = "55555555-5555-4555-8555-555555555555";
+  const key: ResourceKey = { type: "userMd", userId: USER_ID };
+
+  it("toQueryKey produces [type, userId] with no doc identity", () => {
+    const qk = toQueryKey(key);
+    expect(qk).toEqual(["userMd", USER_ID]);
+    // A per-user singleton: the user IS the identity, so there is no third
+    // segment even though the payload is a work item (ADR-BE-487).
+    expect(qk).toHaveLength(2);
+  });
+
+  it("roundtrips through fromQueryKey", () => {
+    const parsed = fromQueryKey(toQueryKey(key));
+    expect(parsed).toEqual(key);
+    expect("orgId" in parsed).toBe(false);
+  });
+
+  it("matchesResourceKey is user-scoped: rejects another user's doc", () => {
+    const otherUser = "66666666-6666-4666-8666-666666666666";
+    expect(matchesResourceKey(toQueryKey(key), key)).toBe(true);
+    expect(matchesResourceKey(["userMd", otherUser], key)).toBe(false);
+  });
+
+  it("does not collide with the other user-scoped keys", () => {
+    const viewerKey: ResourceKey = { type: "viewer", userId: USER_ID };
+    expect(matchesResourceKey(toQueryKey(viewerKey), key)).toBe(false);
+    expect(matchesResourceKey(toQueryKey(key), viewerKey)).toBe(false);
+  });
+});
+
 describe("resource-keys: companyMdAccessRequests (per-doc identity)", () => {
   const DOC_ID = "22222222-2222-4222-8222-222222222222";
   const key: ResourceKey = {

package/src/resource-keys.ts

@@ -84,6 +84,12 @@ export type ResourceKey =
   | { type: "dismissedBanners"; userId: string }
   | { type: "userOrgs"; userId: string }
   | { type: "sessions"; userId: string }
+  // The viewer's personal doc (`/api/me/md`) — a per-user singleton, so it is
+  // keyed by userId alone with no doc identity segment. Its PAYLOAD is a work
+  // item, lazily materialized on first read (ADR-BE-487), but the resource is
+  // "this user's personal doc", not "work item <id>": a future generic
+  // `workItem` key would be a different resource with a different identity.
+  | { type: "userMd"; userId: string }
   | { type: "viewer"; userId: string };
 
 /**
@@ -131,6 +137,7 @@ const USER_SCOPED_TYPES = [
   "dismissedBanners",
   "userOrgs",
   "sessions",
+  "userMd",
   "viewer",
 ] as const;
 
@@ -186,6 +193,7 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case "dismissedBanners":
     case "userOrgs":
     case "sessions":
+    case "userMd":
     case "viewer":
       return [key.type, key.userId] as const;