@company-semantics/contracts 31.0.0 → 33.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "31.0.0",
+  "version": "33.0.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -125,13 +125,13 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^22.20.0",
+    "@types/node": "^22.20.1",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.8",
     "markdownlint-cli2": "^0.23.0",
     "openapi-typescript": "^7.13.0",
-    "prettier": "^3.9.4",
-    "tsx": "^4.23.0",
+    "prettier": "^3.9.5",
+    "tsx": "^4.23.1",
     "typescript": "^5.8.3",
     "vitest": "^4.1.10",
     "yaml": "^2.9.0"

package/src/content/schemas.ts

@@ -125,7 +125,24 @@ export const CompanyMdDocResponseSchema = z.object({
   ]),
   parentId: z.string().nullable(),
   owningUnitId: z.string().nullable(),
-  owner: CompanyMdPersonSchema.nullable(),
+  /**
+   * The doc's EFFECTIVE owners (ADR-CONTRACTS-084), resolved by the same
+   * authority as the share dialog's `owner_user_ids`: a stored personal owner,
+   * else the owning unit's live authority holders, else the org account owner.
+   *
+   * A list, not a scalar — co-ownership is first-class (ADR-CTRL-161) and every
+   * entry is owner-equivalent (ADR-BE-189), so a surface naming one owner reads
+   * `owners[0]` and derives any co-owner count from `owners.length` (e.g. "Ada
+   * +2 are owners"). Ordered deterministically so the named owner is stable
+   * across reads. Empty only when the org has no account owner
+   * (runtime-impossible) — replaces the nullable `owner` scalar and the
+   * `ownerCount` shadow field.
+   */
+  owners: z
+    .array(CompanyMdPersonSchema)
+    .refine((a) => new Set(a.map((p) => p.id)).size === a.length, {
+      message: "duplicate id in owners",
+    }),
   canEdit: z.boolean(),
   /**
    * UI capability signal (ADR-BE-382): whether the requesting actor holds

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

@@ -10,7 +10,7 @@ describe("EMAIL_KINDS golden snapshot", () => {
     expect(EMAIL_KINDS).toStrictEqual({
       "auth.otp": {
         kind: "auth.otp",
-        subject: "Your login code",
+        subject: "Your login code for Company Semantics",
         plainTextRequired: true,
         htmlSupported: false,
       },
@@ -22,13 +22,13 @@ describe("EMAIL_KINDS golden snapshot", () => {
       },
       "org.invite": {
         kind: "org.invite",
-        subject: "You have been invited to join a workspace",
+        subject: "You've been invited to join {orgName} on Company Semantics",
         plainTextRequired: true,
         htmlSupported: true,
       },
       "org.unit_owner_granted": {
         kind: "org.unit_owner_granted",
-        subject: "You've been added to a team",
+        subject: "You've been added as {roleWord} to {unitName} in {orgName}",
         plainTextRequired: true,
         htmlSupported: true,
       },

package/src/email/registry.ts

@@ -32,7 +32,9 @@ import type { EmailKind } from "./types";
 export interface EmailKindDefinition {
   /** The email kind this definition describes */
   kind: EmailKind;
-  /** Email subject line (single source of truth) */
+  /** Email subject line (single source of truth). May contain `{field}`
+   * placeholders that `renderEmail` fills from the payload (e.g. `{orgName}`);
+   * an unmatched placeholder is left verbatim. */
   subject: string;
   /** Whether plain text body is required */
   plainTextRequired: boolean;
@@ -60,7 +62,7 @@ export interface EmailKindDefinition {
 export const EMAIL_KINDS = {
   "auth.otp": {
     kind: "auth.otp",
-    subject: "Your login code",
+    subject: "Your login code for Company Semantics",
     plainTextRequired: true,
     htmlSupported: false,
   },
@@ -72,13 +74,13 @@ export const EMAIL_KINDS = {
   },
   "org.invite": {
     kind: "org.invite",
-    subject: "You have been invited to join a workspace",
+    subject: "You've been invited to join {orgName} on Company Semantics",
     plainTextRequired: true,
     htmlSupported: true,
   },
   "org.unit_owner_granted": {
     kind: "org.unit_owner_granted",
-    subject: "You've been added to a team",
+    subject: "You've been added as {roleWord} to {unitName} in {orgName}",
     plainTextRequired: true,
     htmlSupported: true,
   },