@company-semantics/contracts 30.0.0 → 32.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "30.0.0",
+  "version": "32.0.0",
   "private": false,
   "repository": {
     "type": "git",
@@ -125,13 +125,13 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^22.20.0",
+    "@types/node": "^26.1.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/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 = '43cd15935d12' as const;
-export const SPEC_HASH_FULL = '43cd15935d1232049463ee9ed6c4e833b6e012906cfc46644157aaaa310b895b' as const;
+export const SPEC_HASH = 'f12a9039164d' as const;
+export const SPEC_HASH_FULL = 'f12a9039164d9b743f154e65127c54971b513ed58f3f7f0e49a25397961de8d3' as const;

package/src/api/generated.ts

@@ -4667,14 +4667,8 @@ export interface components {
                 grantedAt: string;
             }[];
             effectiveAccess: {
-                /** @enum {string} */
-                level: "none" | "viewer" | "commenter" | "editor";
-                reasons: {
-                    /** @enum {string} */
-                    source: "org_rbac" | "sharing_policy" | "unit_baseline" | "unit_delegation" | "acl_grant" | "doc_ownership";
-                    detail: string;
-                }[];
-                canShare: boolean;
+                access_level: ("meta" | "owner" | "editor" | "commenter" | "viewer") | null;
+                source_chain: ("explicit" | "ownership" | "visibility" | "inheritance" | "authority" | "context_association" | "migration")[];
             };
         };
         UpdateCompanyMdSharingPolicyRequest: {
@@ -5657,7 +5651,7 @@ export interface components {
                 /** @enum {string} */
                 access_level: "meta" | "owner" | "editor" | "commenter" | "viewer";
                 /** @enum {string} */
-                source: "explicit" | "ownership" | "visibility" | "inheritance" | "migration";
+                source: "explicit" | "ownership" | "visibility" | "inheritance" | "authority" | "context_association" | "migration";
             }[];
         };
         RecentDecisionsResponse: {
@@ -5671,7 +5665,7 @@ export interface components {
                 actor_user_id: string | null;
                 allow: boolean;
                 reason: string;
-                source_chain: ("explicit" | "ownership" | "visibility" | "inheritance" | "migration")[];
+                source_chain: ("explicit" | "ownership" | "visibility" | "inheritance" | "authority" | "context_association" | "migration")[];
                 /** Format: date-time */
                 decided_at: string;
             }[];
@@ -5684,7 +5678,7 @@ export interface components {
                 /** @enum {string} */
                 access_level: "meta" | "owner" | "editor" | "commenter" | "viewer";
                 /** @enum {string} */
-                source: "explicit" | "ownership" | "visibility" | "inheritance" | "migration";
+                source: "explicit" | "ownership" | "visibility" | "inheritance" | "authority" | "context_association" | "migration";
             }[];
         };
         FloorResponse: {

package/src/content/schemas.ts

@@ -11,6 +11,7 @@
  */
 import { z } from "zod";
 import { CursorPageSchema } from "../api/primitives";
+import { EffectiveAccessResponseSchema } from "../permissions/share-api";
 
 // ---------------------------------------------------------------------------
 // Company.md Sub-schemas
@@ -197,29 +198,17 @@ const AclEntrySchema = z.object({
   grantedAt: z.string(),
 });
 
-const AccessReasonSchema = z.object({
-  source: z.enum([
-    "org_rbac",
-    "sharing_policy",
-    "unit_baseline",
-    "unit_delegation",
-    "acl_grant",
-    "doc_ownership",
-  ]),
-  detail: z.string(),
-});
-
-const EffectiveAccessSchema = z.object({
-  level: z.enum(["none", "viewer", "commenter", "editor"]),
-  reasons: z.array(AccessReasonSchema),
-  canShare: z.boolean(),
-});
-
-/** Response for GET /api/company-md/docs/:slug/sharing */
+/** Response for GET /api/company-md/docs/:id/sharing.
+ *
+ * `effectiveAccess` is the ONE authority's projection answer
+ * ({@link EffectiveAccessResponseSchema}: nullable `access_level` +
+ * `source_chain`). The legacy `EffectiveAccess` shape (`level` / `reasons` /
+ * `canShare`) was removed with `CompanyMdAccessEvaluator` (ADR-BE-392 /
+ * ADR-CONTRACTS-082). */
 export const CompanyMdShareResponseSchema = z.object({
   sharingPolicy: z.enum(["restricted", "org_read", "org_comment", "org_edit"]),
   acl: z.array(AclEntrySchema),
-  effectiveAccess: EffectiveAccessSchema,
+  effectiveAccess: EffectiveAccessResponseSchema,
 });
 
 // ---------------------------------------------------------------------------

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,
   },