@company-semantics/contracts 0.102.0 → 0.103.0

package/package.json

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

package/src/resource-keys.ts

@@ -12,9 +12,15 @@ export type ResourceKey =
   | { type: 'integrations'; orgId: string }
   | { type: 'invites'; orgId: string }
   | { type: 'auditEvents'; orgId: string }
+  | { type: 'timeline'; orgId: string }
   // Identities (singular) — single entities
   | { type: 'member'; orgId: string; memberId: string }
+  | { type: 'team'; orgId: string; teamId: string }
+  | { type: 'department'; orgId: string; departmentId: string }
+  | { type: 'chat'; orgId: string; chatId: string }
+  | { type: 'goalDoc'; orgId: string; slug: string }
   | { type: 'workspace'; orgId: string }
+  | { type: 'workspaceDomains'; orgId: string }
   | { type: 'authSettings'; orgId: string }
   | { type: 'billing'; orgId: string }
   | { type: 'aiUsage'; orgId: string }
@@ -24,7 +30,8 @@ export type ResourceKey =
   // User-scoped
   | { type: 'dismissedBanners'; userId: string }
   | { type: 'userOrgs'; userId: string }
-  | { type: 'sessions'; userId: string };
+  | { type: 'sessions'; userId: string }
+  | { type: 'viewer'; userId: string };
 
 /**
  * Action — structured mutation key used across execution system, audit, permissions.
@@ -44,11 +51,11 @@ export function resolveScope(context: {
 /** All ResourceKey type literals for exhaustive checking. */
 const ORG_SCOPED_TYPES = [
   'members', 'departments', 'chats', 'teams', 'integrations', 'invites',
-  'auditEvents', 'workspace', 'authSettings', 'billing', 'aiUsage',
-  'deletionEligibility', 'transferOwnership', 'goals',
+  'auditEvents', 'timeline', 'workspace', 'workspaceDomains', 'authSettings',
+  'billing', 'aiUsage', 'deletionEligibility', 'transferOwnership', 'goals',
 ] as const;
 
-const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions'] as const;
+const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions', 'viewer'] as const;
 
 /**
  * Canonical ResourceKey → query key conversion.
@@ -61,14 +68,23 @@ const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions'] as const;
  */
 export function toQueryKey(key: ResourceKey): readonly string[] {
   switch (key.type) {
-    // Identity with extra field
+    // Identities with extra field
     case 'member':
       return [key.type, key.orgId, key.memberId] as const;
+    case 'team':
+      return [key.type, key.orgId, key.teamId] as const;
+    case 'department':
+      return [key.type, key.orgId, key.departmentId] as const;
+    case 'chat':
+      return [key.type, key.orgId, key.chatId] as const;
+    case 'goalDoc':
+      return [key.type, key.orgId, key.slug] as const;
 
     // User-scoped
     case 'dismissedBanners':
     case 'userOrgs':
     case 'sessions':
+    case 'viewer':
       return [key.type, key.userId] as const;
 
     // Org-scoped collections and identities
@@ -79,7 +95,9 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'integrations':
     case 'invites':
     case 'auditEvents':
+    case 'timeline':
     case 'workspace':
+    case 'workspaceDomains':
     case 'authSettings':
     case 'billing':
     case 'aiUsage':
@@ -106,12 +124,20 @@ export function fromQueryKey(queryKey: readonly string[]): ResourceKey {
     throw new Error(`Invalid query key: expected at least [type, scope], got ${JSON.stringify(queryKey)}`);
   }
 
-  // Identity with extra field
-  if (type === 'member') {
+  // Identities with extra field
+  const identityFields: Record<string, string> = {
+    member: 'memberId',
+    team: 'teamId',
+    department: 'departmentId',
+    chat: 'chatId',
+    goalDoc: 'slug',
+  };
+
+  if (type in identityFields) {
     if (rest.length !== 2) {
-      throw new Error(`Invalid query key for 'member': expected [type, orgId, memberId], got ${JSON.stringify(queryKey)}`);
+      throw new Error(`Invalid query key for '${type}': expected [type, orgId, ${identityFields[type]}], got ${JSON.stringify(queryKey)}`);
     }
-    return { type: 'member', orgId: rest[0], memberId: rest[1] };
+    return { type, orgId: rest[0], [identityFields[type]]: rest[1] } as ResourceKey;
   }
 
   // User-scoped types
@@ -141,6 +167,8 @@ export const resourceRelationships: Record<string, string[]> = {
   chat: ['chats'],
   teams: ['team'],
   team: ['teams'],
+  goals: ['goalDoc'],
+  goalDoc: ['goals'],
 };
 
 /**
@@ -165,6 +193,10 @@ export function matchesResourceKey(queryKey: readonly unknown[], targetKey: Reso
   if ('orgId' in parsed && 'orgId' in targetKey && parsed.orgId !== targetKey.orgId) return false;
   if ('userId' in parsed && 'userId' in targetKey && parsed.userId !== targetKey.userId) return false;
   if ('memberId' in parsed && 'memberId' in targetKey && parsed.memberId !== targetKey.memberId) return false;
+  if ('teamId' in parsed && 'teamId' in targetKey && parsed.teamId !== targetKey.teamId) return false;
+  if ('departmentId' in parsed && 'departmentId' in targetKey && parsed.departmentId !== targetKey.departmentId) return false;
+  if ('chatId' in parsed && 'chatId' in targetKey && parsed.chatId !== targetKey.chatId) return false;
+  if ('slug' in parsed && 'slug' in targetKey && parsed.slug !== targetKey.slug) return false;
 
   return true;
 }