@company-semantics/contracts 1.1.0 → 1.2.0

package/package.json

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

package/src/resource-keys.ts

@@ -28,6 +28,13 @@ export type ResourceKey =
   | { type: 'deletionEligibility'; orgId: string }
   | { type: 'transferOwnership'; orgId: string }
   | { type: 'companyMdDocs'; orgId: string }
+  // OrgUnit canonical model (ADR-BE-120) — Phase 2 Wave 4
+  | { type: 'orgTree'; orgId: string }
+  | { type: 'orgLevelConfig'; orgId: string }
+  | { type: 'orgUnit'; orgId: string; unitId: string }
+  | { type: 'orgUnitChildren'; orgId: string; unitId: string }
+  | { type: 'orgUnitAncestors'; orgId: string; unitId: string }
+  | { type: 'orgUnitMemberships'; orgId: string; unitId: string }
   // User-scoped
   | { type: 'dismissedBanners'; userId: string }
   | { type: 'userOrgs'; userId: string }
@@ -54,6 +61,7 @@ const ORG_SCOPED_TYPES = [
   'members', 'departments', 'chats', 'teams', 'integrations', 'invites',
   'auditEvents', 'timeline', 'workspace', 'workspaceDomains', 'authSettings',
   'billing', 'aiUsage', 'deletionEligibility', 'transferOwnership', 'companyMdDocs',
+  'orgTree', 'orgLevelConfig',
 ] as const;
 
 const USER_SCOPED_TYPES = ['dismissedBanners', 'userOrgs', 'sessions', 'viewer'] as const;
@@ -82,6 +90,13 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'companyMdContextBank':
       return [key.type, key.orgId, key.slug] as const;
 
+    // OrgUnit identity keys (ADR-BE-120)
+    case 'orgUnit':
+    case 'orgUnitChildren':
+    case 'orgUnitAncestors':
+    case 'orgUnitMemberships':
+      return [key.type, key.orgId, key.unitId] as const;
+
     // User-scoped
     case 'dismissedBanners':
     case 'userOrgs':
@@ -106,6 +121,8 @@ export function toQueryKey(key: ResourceKey): readonly string[] {
     case 'deletionEligibility':
     case 'transferOwnership':
     case 'companyMdDocs':
+    case 'orgTree':
+    case 'orgLevelConfig':
       return [key.type, key.orgId] as const;
 
     default: {
@@ -134,6 +151,10 @@ export function fromQueryKey(queryKey: readonly string[]): ResourceKey {
     chat: 'chatId',
     companyMdDoc: 'slug',
     companyMdContextBank: 'slug',
+    orgUnit: 'unitId',
+    orgUnitChildren: 'unitId',
+    orgUnitAncestors: 'unitId',
+    orgUnitMemberships: 'unitId',
   };
 
   if (type in identityFields) {
@@ -172,6 +193,13 @@ export const resourceRelationships: Record<string, string[]> = {
   team: ['teams'],
   companyMdDocs: ['companyMdDoc'],
   companyMdDoc: ['companyMdDocs'],
+  // OrgUnit: reparent/create/archive invalidates the tree view of the whole org;
+  // membership mutations invalidate the unit + its memberships list.
+  orgTree: ['orgUnit', 'orgUnitChildren', 'orgUnitAncestors'],
+  orgUnit: ['orgTree'],
+  orgUnitChildren: ['orgTree'],
+  orgUnitAncestors: ['orgTree'],
+  orgUnitMemberships: ['orgUnit'],
 };
 
 /**
@@ -200,6 +228,7 @@ export function matchesResourceKey(queryKey: readonly unknown[], targetKey: Reso
   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;
+  if ('unitId' in parsed && 'unitId' in targetKey && parsed.unitId !== targetKey.unitId) return false;
 
   return true;
 }