@company-semantics/contracts 1.0.0 → 1.2.0

package/package.json

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

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'af4199988265' as const;
-export const SPEC_HASH_FULL = 'af4199988265ad0b2a80b107680fa1bbd60043ebcc0ccad9b9245f9a0358f661' as const;
+export const SPEC_HASH = '0e90960db25d' as const;
+export const SPEC_HASH_FULL = '0e90960db25d88b3945b8fa9533362f10776b9d1d59ead1291806198b1f3c703' as const;

package/src/api/generated.ts

@@ -1605,6 +1605,58 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/org-units/{unitId}/memberships": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List memberships of an org unit */
+        get: operations["listOrgUnitMemberships"];
+        put?: never;
+        /** Add a manual membership to an org unit */
+        post: operations["createOrgUnitMembership"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/org-units/{unitId}/memberships/{userId}/role": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Update a manual membership role */
+        put: operations["updateOrgUnitMembershipRole"];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/org-units/{unitId}/memberships/{userId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a manual membership */
+        delete: operations["deleteOrgUnitMembership"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/drive/files": {
         parameters: {
             query?: never;
@@ -3089,6 +3141,50 @@ export interface components {
                 updatedAt: string;
             }[];
         };
+        OrgUnitMembershipListResponse: {
+            /** Format: uuid */
+            unitId: string;
+            memberships: {
+                /** Format: uuid */
+                id: string;
+                /** Format: uuid */
+                orgId: string;
+                /** Format: uuid */
+                unitId: string;
+                /** Format: uuid */
+                userId: string;
+                /** @enum {string} */
+                membershipRole: "member" | "manager" | "owner";
+                /** @enum {string} */
+                status: "active" | "pending" | "removed";
+                /** @enum {string} */
+                source: "manual" | "google_groups" | "scim" | "hris";
+                sourceRef: string | null;
+                createdAt: string;
+                updatedAt: string;
+            }[];
+        };
+        OrgUnitMembershipResponse: {
+            membership: {
+                /** Format: uuid */
+                id: string;
+                /** Format: uuid */
+                orgId: string;
+                /** Format: uuid */
+                unitId: string;
+                /** Format: uuid */
+                userId: string;
+                /** @enum {string} */
+                membershipRole: "member" | "manager" | "owner";
+                /** @enum {string} */
+                status: "active" | "pending" | "removed";
+                /** @enum {string} */
+                source: "manual" | "google_groups" | "scim" | "hris";
+                sourceRef: string | null;
+                createdAt: string;
+                updatedAt: string;
+            };
+        };
         DriveFileListResponse: {
             files: {
                 id: string;
@@ -5723,6 +5819,110 @@ export interface operations {
             };
         };
     };
+    listOrgUnitMemberships: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Memberships of the unit */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgUnitMembershipListResponse"];
+                };
+            };
+        };
+    };
+    createOrgUnitMembership: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** Format: uuid */
+                    userId: string;
+                    /** @enum {string} */
+                    role?: "member" | "manager" | "owner";
+                };
+            };
+        };
+        responses: {
+            /** @description Created membership */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgUnitMembershipResponse"];
+                };
+            };
+        };
+    };
+    updateOrgUnitMembershipRole: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @enum {string} */
+                    role: "member" | "manager" | "owner";
+                };
+            };
+        };
+        responses: {
+            /** @description Updated membership */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OrgUnitMembershipResponse"];
+                };
+            };
+        };
+    };
+    deleteOrgUnitMembership: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Membership removed */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listDriveFiles: {
         parameters: {
             query?: never;

package/src/org/index.ts

@@ -228,6 +228,8 @@ export {
   OrgUnitDescendantsResponseSchema,
   OrgUnitRelationshipsResponseSchema,
   OrgLevelConfigResponseSchema,
+  OrgUnitMembershipResponseSchema,
+  OrgUnitMembershipListResponseSchema,
 } from './schemas';
 export type {
   OrgUnit,
@@ -242,4 +244,6 @@ export type {
   OrgUnitDescendantsResponse,
   OrgUnitRelationshipsResponse,
   OrgLevelConfigResponse,
+  OrgUnitMembershipResponse,
+  OrgUnitMembershipListResponse,
 } from './schemas';

package/src/org/schemas.ts

@@ -747,6 +747,15 @@ export const OrgLevelConfigResponseSchema = z.object({
   entries: z.array(OrgLevelConfigSchema),
 });
 
+export const OrgUnitMembershipResponseSchema = z.object({
+  membership: OrgUnitMembershipSchema,
+});
+
+export const OrgUnitMembershipListResponseSchema = z.object({
+  unitId: z.string().uuid(),
+  memberships: z.array(OrgUnitMembershipSchema),
+});
+
 // --- Inferred types ---
 
 export type OrgUnit = z.infer<typeof OrgUnitSchema>;
@@ -761,3 +770,5 @@ export type OrgUnitAncestorsResponse = z.infer<typeof OrgUnitAncestorsResponseSc
 export type OrgUnitDescendantsResponse = z.infer<typeof OrgUnitDescendantsResponseSchema>;
 export type OrgUnitRelationshipsResponse = z.infer<typeof OrgUnitRelationshipsResponseSchema>;
 export type OrgLevelConfigResponse = z.infer<typeof OrgLevelConfigResponseSchema>;
+export type OrgUnitMembershipResponse = z.infer<typeof OrgUnitMembershipResponseSchema>;
+export type OrgUnitMembershipListResponse = z.infer<typeof OrgUnitMembershipListResponseSchema>;

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;
 }