@company-semantics/contracts 35.0.0 → 35.1.0

package/src/notifications/__tests__/output-parity.test.ts

@@ -1,122 +0,0 @@
-/**
- * The "no output change" proof for the multi-channel notification work
- * (ADR-CONTRACTS-086), now closed.
- *
- * The golden was captured from the old email layer at 32.0.0, before any of this
- * existed. This renders the same fixtures through the entry point that replaced
- * it — `renderToChannel(kind, payload, emailRenderer, ctx)`, the whole
- * `compose → Content → Renderer` pipeline — and asserts the same bytes. That
- * comparison is the point of the golden: it is the only thing standing between a
- * refactor of the code that renders real transactional email and a silently lost
- * blank line. Now that `src/email/` is deleted, it is also the only record of
- * what that layer emitted.
- *
- * `renderers/email/__tests__/render.test.ts` proves the RENDERER reproduces the
- * golden from composed content. This proves the ENTRY POINT does, which is the
- * claim a caller actually depends on.
- *
- * There is no fake timer here any more, and that is the improvement being locked
- * in. The old layer read `new Date().getFullYear()` inside `signature()`, so
- * every parity render had to freeze the clock or fail on New Year's Day for
- * calendar reasons alone. The year is now a value in the `RenderContext`, so the
- * golden's clock is just a number — and this file no longer has an opinion about
- * what day it is.
- */
-
-import { describe, expect, it } from "vitest";
-
-import { createRenderContext } from "../context";
-import type { RenderContext } from "../context";
-import type { NotificationKind } from "../kinds";
-import { renderEmail, renderToChannel } from "../render";
-import { NOTIFICATION_DEFINITIONS } from "../registry";
-import { emailRenderer } from "../renderers/email";
-import {
-  OUTPUT_PARITY_CLOCK,
-  OUTPUT_PARITY_FIXTURES,
-  OUTPUT_PARITY_GOLDEN,
-  fixtureKey,
-} from "./output-parity.golden";
-
-/**
- * The instant the golden was captured under, stated rather than ticked. Only the
- * year is pinned; the brand name comes from `createRenderContext`'s own default,
- * so the golden keeps asserting the real `COMPANY_NAME` rather than a copy of it
- * written here.
- */
-const GOLDEN_CONTEXT: RenderContext = createRenderContext({
-  brand: { copyrightYear: new Date(OUTPUT_PARITY_CLOCK).getUTCFullYear() },
-});
-
-const KINDS = Object.keys(NOTIFICATION_DEFINITIONS) as NotificationKind[];
-
-describe("email output parity", () => {
-  it("has a fixture for every kind that can be rendered", () => {
-    // Sourced from the registry rather than the old `IMPLEMENTED_EMAIL_KINDS`:
-    // the registry is what a caller starts from now, and it is total, so "every
-    // kind the entry point accepts" and "every kind with a fixture" must agree.
-    const covered = new Set(OUTPUT_PARITY_FIXTURES.map((f) => f.kind));
-    for (const kind of KINDS) {
-      expect(covered.has(kind), `missing fixture for ${kind}`).toBe(true);
-    }
-  });
-
-  it("golden covers exactly the fixtures — no missing or orphaned entries", () => {
-    const expected = OUTPUT_PARITY_FIXTURES.map((f) =>
-      fixtureKey(f.kind, f.name),
-    );
-    expect(new Set(expected).size, "fixture keys must be unique").toBe(
-      expected.length,
-    );
-    expect(Object.keys(OUTPUT_PARITY_GOLDEN).sort()).toEqual(expected.sort());
-  });
-
-  it("golden was captured under the frozen clock", () => {
-    // Guards the context above: if the golden had been captured under a
-    // different year, every case below would fail for calendar reasons.
-    const year = new Date(OUTPUT_PARITY_CLOCK).getUTCFullYear();
-    for (const [key, rendered] of Object.entries(OUTPUT_PARITY_GOLDEN)) {
-      expect(rendered.text, `${key} text`).toContain(`ⓒ ${year} •`);
-      expect(rendered.html, `${key} html`).toContain(`ⓒ ${year} •`);
-    }
-  });
-
-  for (const fixture of OUTPUT_PARITY_FIXTURES) {
-    const key = fixtureKey(fixture.kind, fixture.name);
-    it(`${key} renders byte-for-byte`, () => {
-      // `payload as never`: the fixture call sites are type-checked in the
-      // golden module; this only bridges compose's per-kind payload.
-      const rendered = renderToChannel(
-        fixture.kind,
-        fixture.payload as never,
-        emailRenderer,
-        GOLDEN_CONTEXT,
-      );
-      expect(rendered).toEqual(OUTPUT_PARITY_GOLDEN[key]);
-    });
-  }
-});
-
-describe("renderEmail", () => {
-  it("is renderToChannel through the email renderer, and nothing more", () => {
-    const year = new Date(OUTPUT_PARITY_CLOCK).getUTCFullYear();
-    for (const fixture of OUTPUT_PARITY_FIXTURES) {
-      const key = fixtureKey(fixture.kind, fixture.name);
-      expect(
-        renderEmail(fixture.kind, fixture.payload as never, {
-          brand: { copyrightYear: year },
-        }),
-        key,
-      ).toEqual(OUTPUT_PARITY_GOLDEN[key]);
-    }
-  });
-
-  it("takes the copyright year from the caller, never from a clock", () => {
-    const rendered = renderEmail(
-      "auth.otp",
-      { otp: "123456", expiresInMinutes: 10 },
-      { brand: { copyrightYear: 1999 } },
-    );
-    expect(rendered.text).toContain("ⓒ 1999 •");
-  });
-});