@company-semantics/contracts 6.2.0 → 6.3.0

package/package.json

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

package/src/email/__tests__/registry.test.ts

@@ -22,6 +22,12 @@ describe('EMAIL_KINDS golden snapshot', () => {
         plainTextRequired: true,
         htmlSupported: true,
       },
+      'org.leadership_granted': {
+        kind: 'org.leadership_granted',
+        subject: "You've been added to a team",
+        plainTextRequired: true,
+        htmlSupported: true,
+      },
       'security.alert': {
         kind: 'security.alert',
         subject: 'Security alert for your account',
@@ -95,7 +101,7 @@ describe('getEmailKindDefinition', () => {
 })
 
 describe('isValidEmailKind', () => {
-  it('returns true for all 5 valid email kinds', () => {
+  it('returns true for all valid email kinds', () => {
     for (const kind of Object.keys(EMAIL_KINDS)) {
       expect(isValidEmailKind(kind)).toBe(true)
     }

package/src/email/registry.ts

@@ -76,6 +76,12 @@ export const EMAIL_KINDS = {
     plainTextRequired: true,
     htmlSupported: true,
   },
+  'org.leadership_granted': {
+    kind: 'org.leadership_granted',
+    subject: "You've been added to a team",
+    plainTextRequired: true,
+    htmlSupported: true,
+  },
   'security.alert': {
     kind: 'security.alert',
     subject: 'Security alert for your account',

package/src/email/types.ts

@@ -27,6 +27,7 @@ export type EmailKind =
   | 'auth.otp'
   | 'auth.magic_link' // future
   | 'org.invite' // future
+  | 'org.leadership_granted'
   | 'security.alert' // future
   | 'chat.shared'
 
@@ -58,6 +59,20 @@ export interface EmailPayloads {
     acceptUrl: string
     expiresInDays: number
   }
+  'org.leadership_granted': {
+    /** Display name of the person who granted access */
+    granterName: string
+    /** Display name of the recipient (optional; falls back to a neutral greeting) */
+    recipientName?: string
+    /** Name of the org unit / team the access applies to */
+    unitName: string
+    /** Human-readable role label the recipient was given */
+    roleLabel: 'Leader' | 'Delegate'
+    /** Full URL to view the org unit in the app */
+    ctaUrl: string
+    /** Optional message from the granter, shown in the email and recorded with the grant */
+    message?: string
+  }
   'security.alert': {
     /** Type of security alert */
     alertType: 'excessive_otp_requests' | 'unusual_login_location'

package/src/org/schemas.ts

@@ -912,6 +912,11 @@ export const CreateDelegationRequestSchema = z.object({
    * UI captures a date and sends end-of-day in the user's timezone.
    */
   expiresAt: z.string().datetime().nullable().optional(),
+  /**
+   * When true, the granted user is emailed a notification (carrying `note` as
+   * the message). Not persisted — it only gates the side-effect email.
+   */
+  notify: z.boolean().optional().default(false),
 });
 export type CreateDelegationRequest = z.infer<typeof CreateDelegationRequestSchema>;