@company-semantics/contracts 13.0.1 → 13.2.0

package/package.json

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

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/org/__tests__/view-scopes.test.ts

@@ -9,8 +9,8 @@ describe("VIEW_SCOPE_MAP golden snapshot", () => {
       teamwork: "org.view_teamwork",
       "teamwork-member": "org.view_teamwork",
       "company-md": "org.view_company_md",
-      teams: "org.view_teams",
       "internal-admin": "internal.view_admin",
+      teams: null,
       chat: null,
       settings: null,
       chats: null,
@@ -35,6 +35,8 @@ describe("getViewScope", () => {
     expect(getViewScope("settings")).toBeNull();
     expect(getViewScope("chats")).toBeNull();
     expect(getViewScope("upgrade")).toBeNull();
+    // teams is membership-derived, not scope-gated (ADR-CONTRACTS-062).
+    expect(getViewScope("teams")).toBeNull();
   });
 
   it("returns null for unknown view string", () => {

package/src/org/view-scopes.ts

@@ -22,9 +22,12 @@ export const VIEW_SCOPE_MAP = {
   teamwork: "org.view_teamwork",
   "teamwork-member": "org.view_teamwork",
   "company-md": "org.view_company_md",
-  teams: "org.view_teams",
   "internal-admin": "internal.view_admin",
   // Public views (require only authentication)
+  // `teams`: team/directory visibility is membership-derived (ADR-BE-241 tier 1),
+  // not a scope. Repointed from the never-enforced `org.view_teams` to null when
+  // that scope was retired from the backend catalog (ADR-CONTRACTS-062 / ADR-BE-256).
+  teams: null,
   chat: null,
   settings: null,
   chats: null,

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>;