@company-semantics/contracts 39.6.0 → 39.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "39.6.0",
+  "version": "39.7.0",
   "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 = 'b02ad24e598a' as const;
-export const SPEC_HASH_FULL = 'b02ad24e598abefeaaa58e146e9784fea88bc3abbd1af8b24a7d9c5d947db757' as const;
+export const SPEC_HASH = 'e8cf36a33d43' as const;
+export const SPEC_HASH_FULL = 'e8cf36a33d43bec5e4383c8edbfbdccd37fe8d081a5ddd02e96c83cb5e7bd21a' as const;

package/src/api/generated.ts

@@ -4740,6 +4740,8 @@ export interface components {
         };
         AccessRequestCreate: {
             message?: string;
+            /** @enum {string} */
+            requestedAccessLevel?: "editor" | "commenter" | "viewer";
         };
         ApproveAccessRequest: {
             /** @enum {string} */

package/src/index.ts

@@ -452,6 +452,8 @@ export {
   COMPANY_MD_COLLAB_MAX_UPDATE_B64_CHARS,
   COMPANY_MD_COLLAB_MAX_DOC_TEXT_BYTES,
   COMPANY_MD_COLLAB_MAX_PRESENCE_POSITION_CHARS,
+  COMPANY_MD_COLLAB_PRESENCE_TTL_MS,
+  COMPANY_MD_COLLAB_PRESENCE_HEARTBEAT_MS,
   CompanyMdCollabSyncLimitsSchema,
   CompanyMdCollabSyncResponseSchema,
   CompanyMdCollabUpdateAcceptedSchema,

package/src/notifications/__tests__/__snapshots__/registry.test.ts.snap

@@ -15,6 +15,7 @@ exports[`NOTIFICATION_DEFINITIONS > titles every kind 1`] = `
   "companyMd.access_request_denied · No reason": "Your access request was reviewed",
   "companyMd.access_request_denied · With reason": "Your access request was reviewed",
   "companyMd.access_requested · No message": "Someone requested access to a document",
+  "companyMd.access_requested · Requested editor": "Someone requested access to a document",
   "companyMd.access_requested · With message": "Someone requested access to a document",
   "org.invite · Admin": "You've been invited to join Acme Corp on Company Semantics",
   "org.invite · Member": "You've been invited to join Acme Corp on Company Semantics",

package/src/notifications/__tests__/fixtures.ts

@@ -198,6 +198,13 @@ add("companyMd.access_requested", "No message", {
   docTitle: "Engineering Handbook",
   reviewUrl: `${APP}/doc/handbook?request=req_456`,
 });
+add("companyMd.access_requested", "Requested editor", {
+  requesterName: "Sam Chen",
+  docTitle: "Engineering Handbook",
+  message: "I maintain this section day to day — may I edit it directly?",
+  requestedAccessLevel: "editor",
+  reviewUrl: `${APP}/doc/handbook?request=req_789`,
+});
 
 add("companyMd.access_request_approved", "Editor", {
   approverName: "Jordan Lee",

package/src/notifications/kinds/company-md-access-requested.ts

@@ -8,11 +8,28 @@
 
 import type { NotificationDefinition } from "../definition";
 
+/**
+ * How each requestable band reads in prose ("requested edit access") and in the
+ * key-value table ("Editor"). Absent band ⇒ band-neutral copy, so senders that
+ * predate `requestedAccessLevel` (ADR-CONTRACTS-098) render exactly as before.
+ */
+const LEVEL_PHRASE = {
+  viewer: "view",
+  commenter: "comment",
+  editor: "edit",
+} as const;
+const LEVEL_LABEL = {
+  viewer: "Viewer",
+  commenter: "Commenter",
+  editor: "Editor",
+} as const;
+
 export const accessRequestedDefinition: NotificationDefinition<"companyMd.access_requested"> =
   {
     kind: "companyMd.access_requested",
     compose: (payload, context) => {
-      const { requesterName, docTitle, message, reviewUrl } = payload;
+      const { requesterName, docTitle, message, requestedAccessLevel, reviewUrl } =
+        payload;
 
       return {
         metadata: {
@@ -23,7 +40,12 @@ export const accessRequestedDefinition: NotificationDefinition<"companyMd.access
           {
             elements: [
               { type: "greeting" },
-              { type: "body", text: "Someone requested document access." },
+              {
+                type: "body",
+                text: requestedAccessLevel
+                  ? `Someone requested ${LEVEL_PHRASE[requestedAccessLevel]} access to a document.`
+                  : "Someone requested document access.",
+              },
               {
                 type: "chatUnit",
                 items: [
@@ -47,6 +69,14 @@ export const accessRequestedDefinition: NotificationDefinition<"companyMd.access
                 rows: [
                   { label: "From", value: requesterName },
                   { label: "Document", value: `"${docTitle}"` },
+                  ...(requestedAccessLevel
+                    ? [
+                        {
+                          label: "Requested",
+                          value: LEVEL_LABEL[requestedAccessLevel],
+                        },
+                      ]
+                    : []),
                 ],
               },
               {

package/src/notifications/payloads.ts

@@ -132,6 +132,12 @@ export interface NotificationPayloads {
     docTitle: string;
     /** Optional message from the requester (notification only) */
     message?: string;
+    /**
+     * The band the requester asked for (ADR-CONTRACTS-098): names the intent
+     * in the owner's email ("requested edit access"). Absent = unspecified
+     * (older senders / clients) — the copy stays band-neutral.
+     */
+    requestedAccessLevel?: "viewer" | "commenter" | "editor";
     /** Deep-link that opens the doc's ShareDialog scrolled to the pending request */
     reviewUrl: string;
   };

package/src/permissions/access-request.ts

@@ -28,6 +28,15 @@ export type AccessRequestStatus = z.infer<typeof AccessRequestStatusSchema>;
 export const AccessRequestCreateSchema = z.object({
   /** Optional context the requester sends to the owner(s). */
   message: z.string().max(2000).optional(),
+  /**
+   * The band the requester is asking for (ADR-CONTRACTS-098 / ADR-BE-454):
+   * `viewer` from the locked preview, `editor` from the view-only Editor tab
+   * (elevation, ADR-BE-453). A REQUEST, not a claim — the owner still chooses
+   * the granted band on approval; this only seeds their picker. Optional so
+   * older clients keep working (absent ⇒ unspecified, owners default to
+   * viewer).
+   */
+  requestedAccessLevel: GrantableAccessLevelSchema.optional(),
 });
 export type AccessRequestCreate = z.infer<typeof AccessRequestCreateSchema>;
 
@@ -45,6 +54,12 @@ export const AccessRequestSchema = z.object({
   docId: z.string(),
   status: AccessRequestStatusSchema,
   message: z.string().nullable(),
+  /**
+   * The band the requester asked for (ADR-CONTRACTS-098) — seeds the owner
+   * inbox's approval picker. Null for requests filed before the field existed
+   * or by clients that did not specify one.
+   */
+  requestedAccessLevel: GrantableAccessLevelSchema.nullable(),
   createdAt: z.string(),
   resolvedAt: z.string().nullable(),
 });