@company-semantics/contracts 27.13.0 → 27.14.0

package/src/email/render/ownership-transfer.ts

@@ -5,7 +5,7 @@
 import type { EmailPayloads } from "../types";
 
 import { baseTextLayout } from "./base-text";
-import { textQuote } from "./blocks";
+import { chatUserBoxText } from "./blocks";
 
 export type OwnershipTransferPayload = EmailPayloads["org.ownership_transfer"];
 
@@ -19,7 +19,7 @@ export function renderOwnershipTransferBody(
 
   if (note) {
     sections.push("");
-    sections.push(textQuote("Message from the current owner", note));
+    sections.push(chatUserBoxText(note, "Message from the current owner"));
   }
 
   sections.push("");

package/src/email/render/render-email.ts

@@ -68,15 +68,22 @@ export const IMPLEMENTED_EMAIL_KINDS = [
 
 export type ImplementedEmailKind = (typeof IMPLEMENTED_EMAIL_KINDS)[number];
 
+/** Payload type for a kind (or `never` for kinds without a payload). */
+type PayloadFor<K extends EmailKind> = K extends keyof EmailPayloads
+  ? EmailPayloads[K]
+  : never;
+
 /**
  * Render an email by kind. Subject comes from `EMAIL_KINDS`; `html` is present
- * only when the template emits an HTML variant.
+ * only when the template emits an HTML variant. Accepts the full `EmailKind`
+ * union so callers with a generic kind (e.g. the backend `EmailService`) type
+ * cleanly; unimplemented kinds throw at runtime.
  *
  * @throws if the kind has no implementation.
  */
-export function renderEmail<K extends ImplementedEmailKind>(
+export function renderEmail<K extends EmailKind>(
   kind: K,
-  payload: EmailPayloads[K],
+  payload: PayloadFor<K>,
   options?: RenderEmailOptions,
 ): RenderedEmail {
   const subject = EMAIL_KINDS[kind].subject;
@@ -159,8 +166,9 @@ export function renderEmail<K extends ImplementedEmailKind>(
       };
     }
     default: {
-      const unimplemented: never = kind;
-      throw new Error(`Email kind not implemented: ${String(unimplemented)}`);
+      // Reachable for registered-but-unimplemented kinds (e.g. auth.magic_link).
+      const unimplemented: string = kind;
+      throw new Error(`Email kind not implemented: ${unimplemented}`);
     }
   }
 }

package/src/email/render/share-granted.ts

@@ -8,15 +8,15 @@ import { baseTextLayout } from "./base-text";
 import {
   ACCESS_PHRASE,
   asciiCtaBox,
-  bodyParagraph,
+  paragraph,
   ctaBox,
   footer,
   greeting,
   htmlShell,
   NOTICE,
-  quoteBlock,
-  signatureLine,
-  textQuote,
+  chatUserBubble,
+  chatUserBoxText,
+  signature,
 } from "./blocks";
 import { COMPANY_NAME } from "./constants";
 import { escapeHtml } from "./escape-html";
@@ -42,7 +42,7 @@ export function renderShareGrantedBody(payload: ShareGrantedPayload): string {
 
   if (message) {
     sections.push("");
-    sections.push(textQuote(`Message from ${granterName}`, message));
+    sections.push(chatUserBoxText(message, `Message from ${granterName}`));
   }
 
   sections.push("");
@@ -73,15 +73,10 @@ export function renderShareGrantedHtml(payload: ShareGrantedPayload): string {
 
   return htmlShell([
     greeting(recipientName),
-    bodyParagraph(
+    paragraph(
       `<b>${escapeHtml(granterName)}</b> shared ${entityHtml} with you &mdash; you ${ACCESS_PHRASE[accessLevel]}.`,
     ),
-    message
-      ? quoteBlock(
-          `Message from ${escapeHtml(granterName)}:`,
-          escapeHtml(message),
-        )
-      : "",
+    message ? chatUserBubble(message, `Message from ${granterName}`) : "",
     ctaBox({
       label: "OPEN",
       href: ctaUrl,
@@ -90,6 +85,6 @@ export function renderShareGrantedHtml(payload: ShareGrantedPayload): string {
       maxWidth: "220px",
     }),
     footer(`This notification was sent via ${COMPANY_NAME}.`, NOTICE),
-    signatureLine(),
+    signature(),
   ]);
 }

package/src/email/render/unit-owner-granted.ts

@@ -7,15 +7,15 @@ import type { EmailPayloads } from "../types";
 import { baseTextLayout } from "./base-text";
 import {
   asciiCtaBox,
-  bodyParagraph,
+  paragraph,
   ctaBox,
   footer,
   greeting,
   htmlShell,
   NOTICE,
-  quoteBlock,
-  signatureLine,
-  textQuote,
+  chatUserBubble,
+  chatUserBoxText,
+  signature,
 } from "./blocks";
 import { COMPANY_NAME } from "./constants";
 import { escapeHtml } from "./escape-html";
@@ -35,7 +35,7 @@ export function renderUnitOwnerGrantedBody(
 
   if (message) {
     sections.push("");
-    sections.push(textQuote(`Message from ${granterName}`, message));
+    sections.push(chatUserBoxText(message, `Message from ${granterName}`));
   }
 
   sections.push("");
@@ -57,15 +57,10 @@ export function renderUnitOwnerGrantedHtml(
 
   return htmlShell([
     greeting(recipientName),
-    bodyParagraph(
+    paragraph(
       `<b>${escapeHtml(granterName)}</b> added you as a <b>${escapeHtml(roleLabel)}</b> of <b>${escapeHtml(unitName)}</b>.`,
     ),
-    message
-      ? quoteBlock(
-          `Message from ${escapeHtml(granterName)}:`,
-          escapeHtml(message),
-        )
-      : "",
+    message ? chatUserBubble(message, `Message from ${granterName}`) : "",
     ctaBox({
       label: "VIEW TEAM",
       href: ctaUrl,
@@ -74,6 +69,6 @@ export function renderUnitOwnerGrantedHtml(
       maxWidth: "220px",
     }),
     footer(`This notification was sent via ${COMPANY_NAME}.`, NOTICE),
-    signatureLine(),
+    signature(),
   ]);
 }