@company-semantics/contracts 7.0.0 → 7.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "7.0.0",
+  "version": "7.1.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 = 'e20bec799e8f' as const;
-export const SPEC_HASH_FULL = 'e20bec799e8f8bd1a51fccbafa626fad0f4e001789ff8b13cda65847c32972f2' as const;
+export const SPEC_HASH = '937aecbfe6e6' as const;
+export const SPEC_HASH_FULL = '937aecbfe6e6533edabb1b83d66be83f63100e519ecf9e4531af3e8a627e122a' as const;

package/src/api/generated.ts

@@ -1972,6 +1972,30 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/users/{userId}/avatar": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /**
+         * Upload (replace) a user's avatar photo from an image file
+         * @description Accepts a multipart image upload (PNG/JPEG/WebP/HEIC) up to 5 MB. The caller must be the target user or hold org.manage_users. HEIC/HEIF is converted to JPEG and the bytes are re-hosted via the blob store. Returns the resolved avatar.
+         */
+        put: operations["uploadUserAvatar"];
+        post?: never;
+        /**
+         * Clear a user's uploaded avatar (reverts to Slack photo or initials)
+         * @description Clears an in-app uploaded avatar only (source=upload); Slack-sourced avatars are left intact. The caller must be the target user or hold org.manage_users. Returns the resolved avatar after reverting.
+         */
+        delete: operations["deleteUserAvatar"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/drive/files": {
         parameters: {
             query?: never;
@@ -2782,7 +2806,7 @@ export interface components {
             slackUserId: string | null;
             avatar: {
                 /** @enum {string} */
-                source: "slack" | "initials";
+                source: "photo" | "initials";
                 url?: string;
                 initials: string;
             };
@@ -4067,7 +4091,7 @@ export interface components {
                 userId: string;
                 fullName: string;
                 jobTitle: string | null;
-                slackAvatarUrl: string | null;
+                avatarUrl: string | null;
                 authorities: {
                     /** @enum {string} */
                     mechanism: "structural" | "delegated" | "rbac";
@@ -4094,7 +4118,7 @@ export interface components {
                 userId: string;
                 fullName: string;
                 jobTitle: string | null;
-                slackAvatarUrl: string | null;
+                avatarUrl: string | null;
                 authorities: {
                     /** @enum {string} */
                     mechanism: "structural" | "delegated" | "rbac";
@@ -4228,7 +4252,7 @@ export interface components {
                 id: string;
                 fullName: string;
                 jobTitle: string | null;
-                slackAvatarUrl: string | null;
+                avatarUrl: string | null;
                 primaryUnitId: string | null;
             }[];
             edges: {
@@ -7923,6 +7947,101 @@ export interface operations {
             };
         };
     };
+    uploadUserAvatar: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    [key: string]: unknown;
+                };
+            };
+        };
+        responses: {
+            /** @description Avatar uploaded; resolved avatar returned */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or malformed multipart upload */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller may not change this avatar */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Target user is not a member of the caller org */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Upload exceeds the 5 MB size limit */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Unsupported image type or bytes are not a valid image */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    deleteUserAvatar: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                userId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Uploaded avatar cleared; resolved avatar returned */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller may not change this avatar */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Target user is not a member of the caller org */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     listDriveFiles: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -117,6 +117,7 @@ export const openApiRoutes = {
   '/api/users/org-chart': ['GET'],
   '/api/users/org-chart/import': ['POST'],
   '/api/users/org-chart/import/{operationId}/retry': ['POST'],
+  '/api/users/{userId}/avatar': ['DELETE', 'PUT'],
   '/api/work-items/{id}': ['GET'],
   '/api/work-items/{id}/content': ['PUT'],
   '/api/work-items/{id}/title': ['PUT'],

package/src/org/index.ts

@@ -125,6 +125,8 @@ export {
   WorkspaceOverviewSchema,
   WorkspaceMembersResponseSchema,
   WorkspaceMemberDetailSchema,
+  WorkspaceMemberManagesEntrySchema,
+  OrgUnitDesignationSchema,
   RoleCatalogEntrySchema,
   RoleCatalogResponseSchema,
   WorkspaceAuthConfigSchema,
@@ -148,6 +150,8 @@ export type {
   WorkspaceAccessResponse,
   WorkspaceOverview as WorkspaceOverviewDto,
   WorkspaceMembersResponse,
+  WorkspaceMemberManagesEntry,
+  OrgUnitDesignation,
   WorkspaceAuthConfig as WorkspaceAuthConfigDto,
   WorkspaceAuditEvent as WorkspaceAuditEventDto,
   WorkspaceResolvePathResponse,

package/src/org/schemas.ts

@@ -25,6 +25,31 @@ const WorkspaceMemberUnitSummarySchema = z.object({
   role: z.enum(['owner', 'manager', 'member']),
 });
 
+/**
+ * Designation a member holds over a unit they manage (ADR-CTRL-112).
+ *
+ * Precedence, highest-first: whole_org > admin > leader > delegate > member.
+ * The org-wide designations (`whole_org`, `admin`) anchor to the org root
+ * unit. This vocabulary is DISPLAY-ONLY — it summarizes management reach for
+ * UI surfaces and is NEVER an authorization input (authority resolution uses
+ * the orthogonal membership/delegation axes, not this enum).
+ */
+export const OrgUnitDesignationSchema = z.enum([
+  'whole_org',
+  'admin',
+  'leader',
+  'delegate',
+  'member',
+]);
+export type OrgUnitDesignation = z.infer<typeof OrgUnitDesignationSchema>;
+
+export const WorkspaceMemberManagesEntrySchema = z.object({
+  unitId: z.string(),
+  unitName: z.string(),
+  designation: OrgUnitDesignationSchema,
+});
+export type WorkspaceMemberManagesEntry = z.infer<typeof WorkspaceMemberManagesEntrySchema>;
+
 const WorkspaceMemberSchema = z.object({
   id: z.string(),
   name: z.string(),
@@ -36,6 +61,7 @@ const WorkspaceMemberSchema = z.object({
   lastActiveAt: z.string().nullable(),
   primaryUnitId: z.string().uuid().nullable(),
   unitMemberships: z.array(WorkspaceMemberUnitSummarySchema),
+  manages: z.array(WorkspaceMemberManagesEntrySchema),
   unitMembershipsTruncated: z.boolean(),
   inviteStatus: z.enum(['active', 'pending', 'expired']).nullable(),
 });