@company-semantics/contracts 13.13.2 → 13.14.0

package/package.json

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

package/src/org/schemas.ts

@@ -578,6 +578,9 @@ const OrgInviteSchema = z.object({
   // Home unit the invitee is placed in on acceptance (users.primary_unit_id).
   // Optional/nullable: legacy invites predate this field.
   homeUnitId: z.string().uuid().optional(),
+  // Role the invitee takes in homeUnitId on acceptance ('leader' is a deferred
+  // structural-leadership grant). Optional/'member' for legacy + unit-less invites.
+  homeUnitRole: z.enum(["member", "leader"]).optional(),
   createdAt: z.string(),
   expiresAt: z.string(),
   acceptedAt: z.string().optional(),

package/src/org/types.ts

@@ -416,6 +416,13 @@ export interface OrgInvite {
    * invites created before this field have none.
    */
   homeUnitId?: string;
+  /**
+   * Role the invitee takes in `homeUnitId` on acceptance — a plain team member,
+   * or a structural leader of that unit (a *deferred* leadership grant applied
+   * at acceptance time). Distinct from the org-level {@link role}. Optional:
+   * legacy invites and unit-less invites have none (treated as `member`).
+   */
+  homeUnitRole?: "member" | "leader";
   createdAt: string;
   expiresAt: string;
   acceptedAt?: string;
@@ -433,6 +440,14 @@ export interface CreateInviteRequest {
    * can roll out without breaking older callers.
    */
   homeUnitId?: string;
+  /**
+   * Role the invitee takes in `homeUnitId` on acceptance: a plain team member
+   * (default), or a structural leader of that unit. `leader` is a *deferred*
+   * grant — the invite is sent now and the leadership is assigned when the
+   * invitee accepts. Only meaningful when `homeUnitId` is set; the backend
+   * rejects `leader` without a home unit. Optional/`member` for older callers.
+   */
+  homeUnitRole?: "member" | "leader";
 }
 
 /**