@company-semantics/contracts 6.0.0 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "6.0.0",
+  "version": "6.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 = 'f8ecf637857f' as const;
-export const SPEC_HASH_FULL = 'f8ecf637857fded90a144d5a76bfa2919d3494bb0b5b78d4131e906ab4a6edf5' as const;
+export const SPEC_HASH = '040afdc07507' as const;
+export const SPEC_HASH_FULL = '040afdc07507321af65f848b48a5843c9a80b13017fbf62d22e134703cb3d10a' as const;

package/src/api/generated.ts

@@ -1743,8 +1743,8 @@ export interface paths {
         delete: operations["deleteOrgUnitDelegation"];
         options?: never;
         head?: never;
-        /** Update the scopes of an existing delegation */
-        patch: operations["updateOrgUnitDelegationScopes"];
+        /** Change a delegation's expiry in place (extend / shorten / clear) */
+        patch: operations["updateOrgUnitDelegation"];
         trace?: never;
     };
     "/api/orgs/{orgId}/admins": {
@@ -3991,7 +3991,7 @@ export interface components {
                     };
                     /** Format: uuid */
                     delegationId?: string;
-                    scopes: ("doc.edit" | "doc.acl" | "members.manage")[];
+                    expiresAt?: string | null;
                 }[];
             }[];
             inherited?: {
@@ -4017,7 +4017,7 @@ export interface components {
                     };
                     /** Format: uuid */
                     delegationId?: string;
-                    scopes: ("doc.edit" | "doc.acl" | "members.manage")[];
+                    expiresAt?: string | null;
                 }[];
             }[];
         };
@@ -4036,7 +4036,7 @@ export interface components {
             /** @enum {string} */
             status: "active" | "revoked";
             note: string | null;
-            scopes: ("doc.edit" | "doc.acl" | "members.manage")[];
+            expiresAt: string | null;
         };
         OrgAdminGrantResponse: {
             /** Format: uuid */
@@ -7395,7 +7395,7 @@ export interface operations {
                     /** Format: uuid */
                     userId: string;
                     note?: string;
-                    scopes?: ("doc.edit" | "doc.acl" | "members.manage")[];
+                    expiresAt?: string | null;
                 };
             };
         };
@@ -7432,7 +7432,7 @@ export interface operations {
             };
         };
     };
-    updateOrgUnitDelegationScopes: {
+    updateOrgUnitDelegation: {
         parameters: {
             query?: never;
             header?: never;
@@ -7445,12 +7445,12 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": {
-                    scopes: ("doc.edit" | "doc.acl" | "members.manage")[];
+                    expiresAt: string | null;
                 };
             };
         };
         responses: {
-            /** @description Delegation row with updated scopes */
+            /** @description Updated delegation row */
             200: {
                 headers: {
                     [name: string]: unknown;

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