@company-semantics/contracts 27.13.0 → 27.13.1

package/package.json

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

package/src/email/render/__tests__/render-snapshot.test.ts

@@ -28,10 +28,12 @@ function add<K extends ImplementedEmailKind>(
   payload: EmailPayloads[K],
   options?: RenderEmailOptions,
 ): void {
+  // `payload as never`: the add() call sites are type-checked (payload:
+  // EmailPayloads[K]); this only bridges the generic conditional in renderEmail.
   fixtures.push({
     kind,
     name,
-    render: () => renderEmail(kind, payload, options),
+    render: () => renderEmail(kind, payload as never, options),
   });
 }
 

package/src/email/render/index.ts

@@ -57,6 +57,7 @@ export {
 export {
   renderAuthOtpBody,
   renderAuthOtpHtml,
+  type AuthOtpPayload,
   type RenderOptions,
 } from "./auth-otp";
 export { renderOrgInviteBody, renderOrgInviteHtml } from "./org-invite";

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}`);
     }
   }
 }