@company-semantics/contracts 6.0.1 → 6.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "6.0.1",
+  "version": "6.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 = 'cebabbf604ec' as const;
-export const SPEC_HASH_FULL = 'cebabbf604eca92841bb1704c008a26709357ca85fb82664e7baad97a9840b85' as const;
+export const SPEC_HASH = '22781c2b738f' as const;
+export const SPEC_HASH_FULL = '22781c2b738fdbdb0833b50ceab729227eccb7c54176ee35a373cc903d536b6c' as const;

package/src/api/generated.ts

@@ -1198,6 +1198,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/capabilities": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get the viewer resolved mutation capabilities */
+        get: operations["getMutationCapabilities"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/company-md/tree": {
         parameters: {
             query?: never;
@@ -1743,7 +1760,8 @@ export interface paths {
         delete: operations["deleteOrgUnitDelegation"];
         options?: never;
         head?: never;
-        patch?: never;
+        /** Change a delegation's expiry in place (extend / shorten / clear) */
+        patch: operations["updateOrgUnitDelegation"];
         trace?: never;
     };
     "/api/orgs/{orgId}/admins": {
@@ -3550,6 +3568,63 @@ export interface components {
             /** @constant */
             status: "cancelled";
         };
+        CapabilitiesResponse: {
+            profile?: {
+                fullName: {
+                    /** @enum {string} */
+                    state: "editable" | "locked";
+                    /** @enum {string} */
+                    reason?: "sso" | "rbac";
+                    requiredScope?: string;
+                };
+                preferredName: {
+                    /** @enum {string} */
+                    state: "editable" | "locked";
+                    /** @enum {string} */
+                    reason?: "sso" | "rbac";
+                    requiredScope?: string;
+                };
+            };
+            org?: {
+                name: {
+                    /** @enum {string} */
+                    state: "editable" | "locked";
+                    /** @enum {string} */
+                    reason?: "sso" | "rbac";
+                    requiredScope?: string;
+                };
+            };
+            orgUnit?: {
+                /** @enum {string} */
+                manage: "allowed" | "blocked";
+            };
+            actions?: {
+                members: {
+                    invite: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                    remove: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                    changeRole: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+                orgAdmins: {
+                    manage: {
+                        /** @enum {string} */
+                        state: "allowed" | "blocked";
+                        requiredScope?: string;
+                    };
+                };
+            };
+        };
         CompanyMdListResponse: {
             items: {
                 id: string;
@@ -3990,6 +4065,7 @@ export interface components {
                     };
                     /** Format: uuid */
                     delegationId?: string;
+                    expiresAt?: string | null;
                 }[];
             }[];
             inherited?: {
@@ -4015,6 +4091,7 @@ export interface components {
                     };
                     /** Format: uuid */
                     delegationId?: string;
+                    expiresAt?: string | null;
                 }[];
             }[];
         };
@@ -4033,6 +4110,7 @@ export interface components {
             /** @enum {string} */
             status: "active" | "revoked";
             note: string | null;
+            expiresAt: string | null;
         };
         OrgAdminGrantResponse: {
             /** Format: uuid */
@@ -6493,6 +6571,26 @@ export interface operations {
             };
         };
     };
+    getMutationCapabilities: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Resolved mutation capabilities for the current viewer + org */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CapabilitiesResponse"];
+                };
+            };
+        };
+    };
     getCompanyMdTree: {
         parameters: {
             query?: {
@@ -7391,6 +7489,7 @@ export interface operations {
                     /** Format: uuid */
                     userId: string;
                     note?: string;
+                    expiresAt?: string | null;
                 };
             };
         };
@@ -7427,6 +7526,35 @@ export interface operations {
             };
         };
     };
+    updateOrgUnitDelegation: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                unitId: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    expiresAt: string | null;
+                };
+            };
+        };
+        responses: {
+            /** @description Updated delegation row */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Delegation"];
+                };
+            };
+        };
+    };
     grantOrgAdmin: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -10,6 +10,7 @@ export const openApiRoutes = {
   '/api/account/sessions': ['GET'],
   '/api/account/sessions/{sessionId}': ['DELETE'],
   '/api/auth/consent/grant': ['POST'],
+  '/api/capabilities': ['GET'],
   '/api/chats': ['GET', 'POST'],
   '/api/chats/by-interaction/{interactionId}': ['GET'],
   '/api/chats/events': ['GET'],

package/src/org/index.ts

@@ -282,6 +282,7 @@ export {
   OrgUnitOwnersResponseSchema,
   DelegationSchema,
   CreateDelegationRequestSchema,
+  UpdateDelegationRequestSchema,
   DelegationListResponseSchema,
 } from './schemas';
 export type {
@@ -296,5 +297,6 @@ export type {
   OrgUnitOwnersResponse,
   Delegation,
   CreateDelegationRequest,
+  UpdateDelegationRequest,
   DelegationListResponse,
 } from './schemas';

package/src/org/schemas.ts

@@ -844,6 +844,14 @@ export const OwnerAuthoritySchema = z.object({
    * the revoke action.
    */
   delegationId: z.string().uuid().optional(),
+  /**
+   * Delegation expiry as an ISO-8601 timestamp when `mechanism === 'delegated'`
+   * and the delegation is time-boxed; `null` for a permanent delegation; omitted
+   * for non-delegated mechanisms. Expired delegations never reach this surface —
+   * the projection read filters `expires_at > now()` — so a present value is
+   * always in the future.
+   */
+  expiresAt: z.string().datetime().nullable().optional(),
 });
 export type OwnerAuthority = z.infer<typeof OwnerAuthoritySchema>;
 
@@ -886,15 +894,37 @@ export const DelegationSchema = z.object({
   revokedAt: z.string().nullable(),
   status: z.enum(['active', 'revoked']),
   note: z.string().nullable(),
+  /**
+   * ISO-8601 timestamp at which the delegation stops conferring authority, or
+   * `null` for a permanent delegation. Enforcement is read-time (the projection
+   * read filters `expires_at > now()`); the row itself stays `status='active'`
+   * until explicitly revoked.
+   */
+  expiresAt: z.string().nullable(),
 });
 export type Delegation = z.infer<typeof DelegationSchema>;
 
 export const CreateDelegationRequestSchema = z.object({
   userId: z.string().uuid(),
   note: z.string().max(2000).optional(),
+  /**
+   * Optional ISO-8601 expiry. Omitted or `null` ⇒ a permanent delegation. The
+   * UI captures a date and sends end-of-day in the user's timezone.
+   */
+  expiresAt: z.string().datetime().nullable().optional(),
 });
 export type CreateDelegationRequest = z.infer<typeof CreateDelegationRequestSchema>;
 
+/**
+ * Change a delegation's expiry without revoking it: extend, shorten, or clear
+ * (set `expiresAt: null` to make it permanent). Used by the inline expiry edit
+ * on an existing delegate row.
+ */
+export const UpdateDelegationRequestSchema = z.object({
+  expiresAt: z.string().datetime().nullable(),
+});
+export type UpdateDelegationRequest = z.infer<typeof UpdateDelegationRequestSchema>;
+
 export const DelegationListResponseSchema = z.object({
   delegations: z.array(DelegationSchema),
 });