@company-semantics/contracts 13.1.0 → 13.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "13.1.0",
+  "version": "13.2.1",
   "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 = 'dd85c63b3fd6' as const;
-export const SPEC_HASH_FULL = 'dd85c63b3fd6d351429bf5f601815dea1e6b22e52f31f467c7d1df4616d0b03f' as const;
+export const SPEC_HASH = '4dd221ddc8fd' as const;
+export const SPEC_HASH_FULL = '4dd221ddc8fd1a1ff75153543db47c0e2c5a667d1f428e855026a035cdc3b3c6' as const;

package/src/api/generated.ts

@@ -4868,6 +4868,8 @@ export interface components {
         AclGrantRequest: {
             /** @enum {string} */
             access_level: "editor" | "commenter" | "viewer";
+            note?: string;
+            notify?: boolean;
         };
         VisibilityPatchRequest: {
             /** @enum {string} */

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

@@ -32,6 +32,18 @@ describe("EMAIL_KINDS golden snapshot", () => {
         plainTextRequired: true,
         htmlSupported: true,
       },
+      "org.ownership_transfer": {
+        kind: "org.ownership_transfer",
+        subject: "You've been invited to become a workspace owner",
+        plainTextRequired: true,
+        htmlSupported: false,
+      },
+      "org.ownership_transfer_completed": {
+        kind: "org.ownership_transfer_completed",
+        subject: "Workspace ownership has been transferred",
+        plainTextRequired: true,
+        htmlSupported: false,
+      },
       "security.alert": {
         kind: "security.alert",
         subject: "Security alert for your account",
@@ -44,6 +56,12 @@ describe("EMAIL_KINDS golden snapshot", () => {
         plainTextRequired: true,
         htmlSupported: true,
       },
+      "share.granted": {
+        kind: "share.granted",
+        subject: "Something has been shared with you",
+        plainTextRequired: true,
+        htmlSupported: true,
+      },
     });
   });
 });

package/src/email/registry.ts

@@ -82,6 +82,18 @@ export const EMAIL_KINDS = {
     plainTextRequired: true,
     htmlSupported: true,
   },
+  "org.ownership_transfer": {
+    kind: "org.ownership_transfer",
+    subject: "You've been invited to become a workspace owner",
+    plainTextRequired: true,
+    htmlSupported: false,
+  },
+  "org.ownership_transfer_completed": {
+    kind: "org.ownership_transfer_completed",
+    subject: "Workspace ownership has been transferred",
+    plainTextRequired: true,
+    htmlSupported: false,
+  },
   "security.alert": {
     kind: "security.alert",
     subject: "Security alert for your account",
@@ -94,6 +106,12 @@ export const EMAIL_KINDS = {
     plainTextRequired: true,
     htmlSupported: true,
   },
+  "share.granted": {
+    kind: "share.granted",
+    subject: "Something has been shared with you",
+    plainTextRequired: true,
+    htmlSupported: true,
+  },
 } as const satisfies Record<EmailKind, EmailKindDefinition>;
 
 // =============================================================================

package/src/email/types.ts

@@ -28,8 +28,11 @@ export type EmailKind =
   | "auth.magic_link" // future
   | "org.invite" // future
   | "org.leadership_granted"
+  | "org.ownership_transfer"
+  | "org.ownership_transfer_completed"
   | "security.alert" // future
-  | "chat.shared";
+  | "chat.shared"
+  | "share.granted";
 
 // =============================================================================
 // Email Payloads
@@ -73,6 +76,22 @@ export interface EmailPayloads {
     /** Optional message from the granter, shown in the email and recorded with the grant */
     message?: string;
   };
+  "org.ownership_transfer": {
+    /** Name of the organization being transferred (subject is static; org name renders in the body) */
+    orgName: string;
+    /** Full URL to accept the transfer (token-bearing) */
+    acceptUrl: string;
+    /** How long until the invitation expires */
+    expiresInDays: number;
+    /** Optional message from the current owner */
+    note?: string;
+  };
+  "org.ownership_transfer_completed": {
+    /** Name of the organization that was transferred */
+    orgName: string;
+    /** Email address of the new owner */
+    newOwnerEmail: string;
+  };
   "security.alert": {
     /** Type of security alert */
     alertType: "excessive_otp_requests" | "unusual_login_location";
@@ -93,6 +112,22 @@ export interface EmailPayloads {
     /** First ~200 chars of chat content for email preview. Generated server-side from snapshot. */
     previewText?: string;
   };
+  "share.granted": {
+    /** Display name of the person who shared */
+    granterName: string;
+    /** Display name of the recipient (optional; falls back to a neutral greeting) */
+    recipientName?: string;
+    /** Human-readable entity label, e.g. "document" | "work item" | "meeting" */
+    entityLabel: string;
+    /** Title of the shared entity (absent for entities without titles, e.g. meetings) */
+    entityTitle?: string;
+    /** Access level the recipient was granted */
+    accessLevel: "editor" | "commenter" | "viewer";
+    /** Full URL to view the shared entity in the app */
+    ctaUrl: string;
+    /** Optional message from the granter, included in the email only (not persisted) */
+    message?: string;
+  };
 }
 
 // =============================================================================

package/src/permissions/share-api.ts

@@ -34,6 +34,18 @@ export type EntityVisibility = z.infer<typeof EntityVisibilitySchema>;
 
 export const AclGrantRequestSchema = z.object({
   access_level: GrantableAccessLevelSchema,
+  /**
+   * Optional message from the granter, included in the notify email only.
+   * Ephemeral notification-event metadata — never persisted on the grant.
+   * Bound matches the leadership note/reason fields (2000).
+   */
+  note: z.string().max(2000).optional(),
+  /**
+   * When true, email the grantee(s) about the new grant. Gates the email
+   * side-effect only; omitted is treated as false (no .default(), mirrors
+   * CreateDelegationRequestSchema).
+   */
+  notify: z.boolean().optional(),
 });
 export type AclGrantRequest = z.infer<typeof AclGrantRequestSchema>;