@clay-design-system/email 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# @clay-design-system/email
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The **Lifecycle / Email** tier of the Clay Design System — responsive, Outlook-safe HTML emails
+authored in **MJML** and composed from the shared Clay foundation tokens.
+
+## Why MJML + inlined tokens
+
+Email clients (notably Outlook) do **not** support CSS custom properties (`var(--clay-*)`). So this
+package never ships `var()` — instead a build step reads the resolved literal token values from
+`@clay-design-system/tokens` (the `dist/tokens.js` ES export) and **inlines** them into MJML at build time.
+
+```
+@clay-design-system/tokens (JS literals)
+   ↓  src/tokens/build-email-tokens.ts   (generates)
+src/generated/base-head.mjml   ← <mj-head>: fonts, mj-class roles, dark-mode
+src/generated/email-tokens.ts  ← inline-able constants + px() helper
+   ↓  MJML sections + container
+src/build/compile.ts  (mjml2html)
+   ↓
+dist/emails/<name>.html         ← standalone, previewable
+dist/emails/<name>.braze.html   ← Braze full-template variant (unsubscribe token)
+dist/emails/<name>.static.html  ← hand-authored fallback (no MJML)
+dist/catalog.json               ← Storybook + docs source
+```
+
+## Structure
+
+- `src/container/` — the shared email shell (page bg → 640px card → 560px inner, preheader,
+  responsive + dark/light). Every email reuses it.
+- `src/sections/` — MJML section partials (logo-header, hero, feature-rows, icon-feature-list,
+  buttons-primary, footer).
+- `src/emails/` — full email compositions (container + sections) plus a static-HTML fallback.
+  **Gitignored / local-only:** every composed email is a generation, so it stays on the machine
+  that made it and contributors never see each other's campaigns. The build globs this folder at
+  compile time, so generating into it works unchanged — it is simply never committed. A fresh clone
+  starts empty here; `src/examples/` holds the committed Email Love → Braze reference exports.
+- `src/tokens/` — the token→email bridge codegen.
+- `src/build/` — MJML compile + Braze transform + catalog.
+
+## Scripts
+
+```bash
+pnpm --filter @clay-design-system/email build          # tokens bridge → tsc → compile MJML
+pnpm --filter @clay-design-system/email dev            # watch + recompile MJML
+pnpm --filter @clay-design-system/email tokens:check   # fail if generated token artifacts drift
+pnpm --filter @clay-design-system/email test           # vitest
+```
+
+Documented in Storybook under **Lifecycle/Email/**.

package/dist/build/asset-scoring.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared two-stage ranked-match algorithm for visual-resolver.ts's asset pickers
+ * (stock-library-map.ts, icon-registry-map.ts) — the "never guess between plausible candidates"
+ * rule, in exactly one place, extended to use more than one data column without weakening it.
+ *
+ * Stage 1 (content gate): a candidate must have positive `contentScore` to be considered at all —
+ * a secondary signal (aspect ratio, domain, category, ...) can never rescue a zero-content-overlap
+ * candidate, and can never outrank a candidate with a strictly higher content score.
+ * Stage 2 (tie-break): only among the candidates tied for the *maximum* content score, break the
+ * tie using `secondaryScore` — but only if that produces a unique, strictly-positive top scorer.
+ * A genuine tie (including an all-zero secondary tie) still returns null, same as before this
+ * module existed.
+ */
+/**
+ * Word-boundary match, not substring — shared by every fuzzy text matcher in this build pipeline
+ * (visual-resolver.ts, icon-registry-map.ts, stock-library-map.ts) so the "whole word" rule can't
+ * drift between them.
+ */
+export declare function containsWord(haystackLower: string, word: string): boolean;
+/**
+ * A visual slot's rough layout shape — derived automatically from the slot spec (see
+ * visual-resolver.ts's deriveSlotShape), never hand-authored in a brief. Used only as a
+ * stage-2 tie-breaker (see pickRankedMatch below), never as a stage-1 filter.
+ */
+export type SlotShape = 'hero' | 'card' | 'banner' | 'icon' | 'unknown';
+/**
+ * Which of stock-library-source.csv's curated `ratio` values ('square' | 'wide' | 'super wide')
+ * count as a fit for each shape. Deliberately permissive (a shape can accept more than one ratio)
+ * — the real section survey behind this showed sections sharing a shape name still vary in actual
+ * aspect (e.g. product-ui-hero is 1.6:1 landscape, image-hero is ~1:1, newsletter-hero is 0.82:1
+ * portrait), so this is a coarse signal, not an exact-ratio requirement. `icon`/`unknown` never
+ * score — icons have no aspect axis, and `unknown` is the shape for every slot whose text doesn't
+ * name one (including every existing test's `slot: 'x'`), so it's a guaranteed no-op there.
+ */
+export declare const SHAPE_ACCEPTABLE_RATIOS: Record<SlotShape, Set<string>>;
+export interface RankOptions<T> {
+    contentScore(entry: T): number;
+    secondaryScore(entry: T): number;
+    /** Only called on the eventual tie-break winner, to explain which signals fired for it. */
+    explainSecondary?(entry: T): string[];
+}
+export interface RankedMatch<T> {
+    entry: T;
+    /** Empty when the winner was a unique content-score winner (identical to pre-ranking behavior). Populated only when a content tie was broken by secondaryScore. */
+    disambiguatedBy: string[];
+}
+export declare function pickRankedMatch<T>(candidates: T[], opts: RankOptions<T>): RankedMatch<T> | null;
+//# sourceMappingURL=asset-scoring.d.ts.map

package/dist/build/asset-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-scoring.d.ts","sourceRoot":"","sources":["../../src/build/asset-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGzE;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAMlE,CAAA;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,YAAY,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAA;IAC9B,cAAc,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAA;IAChC,2FAA2F;IAC3F,gBAAgB,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,CAAA;CACtC;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAA;IACR,mKAAmK;IACnK,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAgB/F"}

package/dist/build/asset-scoring.js

@@ -0,0 +1,57 @@
+/**
+ * Shared two-stage ranked-match algorithm for visual-resolver.ts's asset pickers
+ * (stock-library-map.ts, icon-registry-map.ts) — the "never guess between plausible candidates"
+ * rule, in exactly one place, extended to use more than one data column without weakening it.
+ *
+ * Stage 1 (content gate): a candidate must have positive `contentScore` to be considered at all —
+ * a secondary signal (aspect ratio, domain, category, ...) can never rescue a zero-content-overlap
+ * candidate, and can never outrank a candidate with a strictly higher content score.
+ * Stage 2 (tie-break): only among the candidates tied for the *maximum* content score, break the
+ * tie using `secondaryScore` — but only if that produces a unique, strictly-positive top scorer.
+ * A genuine tie (including an all-zero secondary tie) still returns null, same as before this
+ * module existed.
+ */
+/**
+ * Word-boundary match, not substring — shared by every fuzzy text matcher in this build pipeline
+ * (visual-resolver.ts, icon-registry-map.ts, stock-library-map.ts) so the "whole word" rule can't
+ * drift between them.
+ */
+export function containsWord(haystackLower, word) {
+    const escaped = word.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`\\b${escaped}\\b`).test(haystackLower);
+}
+/**
+ * Which of stock-library-source.csv's curated `ratio` values ('square' | 'wide' | 'super wide')
+ * count as a fit for each shape. Deliberately permissive (a shape can accept more than one ratio)
+ * — the real section survey behind this showed sections sharing a shape name still vary in actual
+ * aspect (e.g. product-ui-hero is 1.6:1 landscape, image-hero is ~1:1, newsletter-hero is 0.82:1
+ * portrait), so this is a coarse signal, not an exact-ratio requirement. `icon`/`unknown` never
+ * score — icons have no aspect axis, and `unknown` is the shape for every slot whose text doesn't
+ * name one (including every existing test's `slot: 'x'`), so it's a guaranteed no-op there.
+ */
+export const SHAPE_ACCEPTABLE_RATIOS = {
+    hero: new Set(['wide', 'super wide']),
+    card: new Set(['square']),
+    banner: new Set(['super wide']),
+    icon: new Set([]),
+    unknown: new Set([]),
+};
+export function pickRankedMatch(candidates, opts) {
+    const scored = candidates.map((entry) => ({ entry, contentScore: opts.contentScore(entry) })).filter((s) => s.contentScore > 0);
+    if (!scored.length)
+        return null;
+    const maxContent = Math.max(...scored.map((s) => s.contentScore));
+    const contentWinners = scored.filter((s) => s.contentScore === maxContent);
+    if (contentWinners.length === 1)
+        return { entry: contentWinners[0].entry, disambiguatedBy: [] };
+    const withSecondary = contentWinners.map((s) => ({ entry: s.entry, secondaryScore: opts.secondaryScore(s.entry) }));
+    const maxSecondary = Math.max(...withSecondary.map((s) => s.secondaryScore));
+    if (maxSecondary <= 0)
+        return null;
+    const secondaryWinners = withSecondary.filter((s) => s.secondaryScore === maxSecondary);
+    if (secondaryWinners.length !== 1)
+        return null;
+    const winner = secondaryWinners[0].entry;
+    return { entry: winner, disambiguatedBy: opts.explainSecondary ? opts.explainSecondary(winner) : [] };
+}
+//# sourceMappingURL=asset-scoring.js.map

package/dist/build/asset-scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-scoring.js","sourceRoot":"","sources":["../../src/build/asset-scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,aAAqB,EAAE,IAAY;IAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAA;IAC3D,OAAO,IAAI,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;AAC3D,CAAC;AASD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmC;IACrE,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IAC/B,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;IACjB,OAAO,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;CACrB,CAAA;AAeD,MAAM,UAAU,eAAe,CAAI,UAAe,EAAE,IAAoB;IACtE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAA;IAC/H,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAE/B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAA;IACjE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,UAAU,CAAC,CAAA;IAC1E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,CAAA;IAE/F,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IACnH,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAA;IAC5E,IAAI,YAAY,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAElC,MAAM,gBAAgB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,YAAY,CAAC,CAAA;IACvF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACxC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;AACvG,CAAC"}

package/dist/build/braze-transform.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Braze export transform.
+ *
+ * Chunk 1 = **full-template import** mode: the whole HTML document is preserved (so head media-queries
+ * and the dark-mode block survive — Braze content-block export would strip the <head>). We only:
+ *   1. replace the footer unsubscribe placeholder with Braze's Liquid unsubscribe token, and
+ *   2. optionally wrap flagged strings in Liquid (off by default — plumbing for later chunks).
+ *
+ * Content-block mode (head-CSS re-injection) is deferred to a later chunk.
+ */
+/** Placeholder token authored into the footer section; swapped for the ESP's real unsubscribe URL. */
+export declare const UNSUBSCRIBE_PLACEHOLDER = "%%UNSUBSCRIBE_URL%%";
+export interface BrazeConfig {
+    mode?: 'template' | 'content-block';
+    unsubscribe?: boolean;
+    /** map of placeholder → Liquid expression, applied verbatim (optional) */
+    liquid?: Record<string, string>;
+}
+export declare function brazeTransform(html: string, config?: BrazeConfig): string;
+//# sourceMappingURL=braze-transform.d.ts.map

package/dist/build/braze-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"braze-transform.d.ts","sourceRoot":"","sources":["../../src/build/braze-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sGAAsG;AACtG,eAAO,MAAM,uBAAuB,wBAAwB,CAAA;AAK5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,UAAU,GAAG,eAAe,CAAA;IACnC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB,GAAG,MAAM,CAa7E"}

package/dist/build/braze-transform.js

@@ -0,0 +1,26 @@
+/**
+ * Braze export transform.
+ *
+ * Chunk 1 = **full-template import** mode: the whole HTML document is preserved (so head media-queries
+ * and the dark-mode block survive — Braze content-block export would strip the <head>). We only:
+ *   1. replace the footer unsubscribe placeholder with Braze's Liquid unsubscribe token, and
+ *   2. optionally wrap flagged strings in Liquid (off by default — plumbing for later chunks).
+ *
+ * Content-block mode (head-CSS re-injection) is deferred to a later chunk.
+ */
+/** Placeholder token authored into the footer section; swapped for the ESP's real unsubscribe URL. */
+export const UNSUBSCRIBE_PLACEHOLDER = '%%UNSUBSCRIBE_URL%%';
+/** Braze Liquid personalization tag for the unsubscribe URL. */
+const BRAZE_UNSUBSCRIBE = '{{${set_user_to_unsubscribed_url}}}';
+export function brazeTransform(html, config = {}) {
+    const { unsubscribe = true, liquid = {} } = config;
+    let out = html;
+    if (unsubscribe) {
+        out = out.split(UNSUBSCRIBE_PLACEHOLDER).join(BRAZE_UNSUBSCRIBE);
+    }
+    for (const [placeholder, expr] of Object.entries(liquid)) {
+        out = out.split(placeholder).join(expr);
+    }
+    return out;
+}
+//# sourceMappingURL=braze-transform.js.map

package/dist/build/braze-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"braze-transform.js","sourceRoot":"","sources":["../../src/build/braze-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,sGAAsG;AACtG,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAA;AAE5D,gEAAgE;AAChE,MAAM,iBAAiB,GAAG,qCAAqC,CAAA;AAS/D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,SAAsB,EAAE;IACnE,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,MAAM,CAAA;IAClD,IAAI,GAAG,GAAG,IAAI,CAAA;IAEd,IAAI,WAAW,EAAE,CAAC;QAChB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;IAClE,CAAC;IAED,KAAK,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzC,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/build/catalog.d.ts

@@ -0,0 +1,25 @@
+/** Catalog of compiled email artifacts — the source Storybook + docs read from. */
+export type CatalogKind = 'container' | 'section' | 'component' | 'email';
+export interface CatalogItem {
+    /** stable slug, e.g. "email-love-sample" or "hero" */
+    id: string;
+    /** human title, e.g. "Hero" */
+    title: string;
+    kind: CatalogKind;
+    /** compiled standalone HTML (MJML → HTML) */
+    html: string;
+    /** Braze full-template variant (emails only) */
+    brazeHtml?: string;
+    /** hand-authored static fallback (emails only) */
+    staticHtml?: string;
+    /** inbox subject line, derived from the compiled `<title>` (emails only) */
+    subject?: string;
+    /** inbox preview/preheader line, derived from the compiled hidden preheader div (emails only) */
+    preheader?: string;
+}
+export interface Catalog {
+    /** provenance note */
+    generatedFrom: string;
+    items: CatalogItem[];
+}
+//# sourceMappingURL=catalog.d.ts.map

package/dist/build/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/build/catalog.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAA;AAEzE,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,WAAW,CAAA;IACjB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,OAAO;IACtB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB"}

package/dist/build/catalog.js

@@ -0,0 +1,3 @@
+/** Catalog of compiled email artifacts — the source Storybook + docs read from. */
+export {};
+//# sourceMappingURL=catalog.js.map

package/dist/build/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/build/catalog.ts"],"names":[],"mappings":"AAAA,mFAAmF"}

package/dist/build/cloudinary-env.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cloudinary credential loader.
+ *
+ * Reads CLOUDINARY_CLOUD_NAME / CLOUDINARY_API_KEY / CLOUDINARY_API_SECRET from the repo-root
+ * `.env` (untracked — see skills/email-campaign/OPEN-QUESTIONS.md Q4). Never hardcode or log the
+ * raw secret values; this module only reports which *names* are missing.
+ */
+export interface CloudinaryEnv {
+    cloudName: string;
+    apiKey: string;
+    apiSecret: string;
+}
+/** Throws a clear, actionable error (pointing at Q4) if any credential is missing. */
+export declare function loadCloudinaryEnv(): CloudinaryEnv;
+//# sourceMappingURL=cloudinary-env.d.ts.map

package/dist/build/cloudinary-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary-env.d.ts","sourceRoot":"","sources":["../../src/build/cloudinary-env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,IAAI,aAAa,CA0BjD"}

package/dist/build/cloudinary-env.js

@@ -0,0 +1,36 @@
+/**
+ * Cloudinary credential loader.
+ *
+ * Reads CLOUDINARY_CLOUD_NAME / CLOUDINARY_API_KEY / CLOUDINARY_API_SECRET from the repo-root
+ * `.env` (untracked — see skills/email-campaign/OPEN-QUESTIONS.md Q4). Never hardcode or log the
+ * raw secret values; this module only reports which *names* are missing.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(__dirname, '../../../..');
+const envPath = resolve(repoRoot, '.env');
+/** Throws a clear, actionable error (pointing at Q4) if any credential is missing. */
+export function loadCloudinaryEnv() {
+    if (existsSync(envPath)) {
+        process.loadEnvFile(envPath);
+    }
+    const cloudName = process.env.CLOUDINARY_CLOUD_NAME;
+    const apiKey = process.env.CLOUDINARY_API_KEY;
+    const apiSecret = process.env.CLOUDINARY_API_SECRET;
+    const missing = [
+        !cloudName && 'CLOUDINARY_CLOUD_NAME',
+        !apiKey && 'CLOUDINARY_API_KEY',
+        !apiSecret && 'CLOUDINARY_API_SECRET',
+    ].filter((v) => Boolean(v));
+    if (missing.length) {
+        throw new Error(`Missing Cloudinary credentials: ${missing.join(', ')}.\n` +
+            `Add them to an untracked .env at the repo root (${envPath}) — see ` +
+            `skills/email-campaign/OPEN-QUESTIONS.md Q4:\n` +
+            `  CLOUDINARY_CLOUD_NAME=...\n  CLOUDINARY_API_KEY=...\n  CLOUDINARY_API_SECRET=...\n` +
+            `Use --dry-run to preview what would be uploaded without credentials.`);
+    }
+    return { cloudName: cloudName, apiKey: apiKey, apiSecret: apiSecret };
+}
+//# sourceMappingURL=cloudinary-env.js.map

package/dist/build/cloudinary-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary-env.js","sourceRoot":"","sources":["../../src/build/cloudinary-env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;AAClD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;AAQzC,sFAAsF;AACtF,MAAM,UAAU,iBAAiB;IAC/B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IAEnD,MAAM,OAAO,GAAG;QACd,CAAC,SAAS,IAAI,uBAAuB;QACrC,CAAC,MAAM,IAAI,oBAAoB;QAC/B,CAAC,SAAS,IAAI,uBAAuB;KACtC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAExC,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YACxD,mDAAmD,OAAO,UAAU;YACpE,+CAA+C;YAC/C,sFAAsF;YACtF,sEAAsE,CACzE,CAAA;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAU,EAAE,MAAM,EAAE,MAAO,EAAE,SAAS,EAAE,SAAU,EAAE,CAAA;AAC1E,CAAC"}

package/dist/build/cloudinary-manifest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared manifest shape + path for the Cloudinary upload pipeline.
+ *
+ * `upload-assets.ts` writes this file; `compile.ts` reads it (if present) to swap a campaign
+ * asset's `src` for its hosted URL instead of inlining it as base64. Both import from here so the
+ * path and shape can never drift between writer and reader.
+ */
+/** dist/ is gitignored — this is local, regenerable build output, not committed. */
+export declare const cloudinaryManifestPath: string;
+export interface CloudinaryManifestEntry {
+    /** Path relative to src/assets/, e.g. "sales-agent-activation/tp1-library-hero.png". */
+    sourcePath: string;
+    /** Top-level dir under src/emails/ that referenced this asset. */
+    campaign: string;
+    /** The specific email (fileBaseName) that referenced this asset. */
+    email: string;
+    /** Cloudinary secure_url returned by the upload. */
+    url: string;
+    bytes: number;
+    /** sha256 of the local file content — lets re-runs skip an unchanged upload. */
+    contentHash: string;
+    uploadedAt: string;
+}
+export interface CloudinaryManifest {
+    generatedFrom: string;
+    cloudName: string;
+    /** Keyed by Cloudinary public_id, e.g. "lifecycle/sales-agent-activation/tp1a-library/tp1-library-hero". */
+    assets: Record<string, CloudinaryManifestEntry>;
+}
+export declare function loadCloudinaryManifest(): CloudinaryManifest | null;
+/** Lookup keyed by `${campaign}/${email}/${filename}` for O(1) resolution during compile. */
+export declare function indexManifestByCampaignEmailFile(manifest: CloudinaryManifest): Map<string, string>;
+//# sourceMappingURL=cloudinary-manifest.d.ts.map

package/dist/build/cloudinary-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary-manifest.d.ts","sourceRoot":"","sources":["../../src/build/cloudinary-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,QAAsD,CAAA;AAEzF,MAAM,WAAW,uBAAuB;IACtC,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,4GAA4G;IAC5G,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAA;CAChD;AAED,wBAAgB,sBAAsB,IAAI,kBAAkB,GAAG,IAAI,CAOlE;AAED,6FAA6F;AAC7F,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlG"}

package/dist/build/cloudinary-manifest.js

@@ -0,0 +1,36 @@
+/**
+ * Shared manifest shape + path for the Cloudinary upload pipeline.
+ *
+ * `upload-assets.ts` writes this file; `compile.ts` reads it (if present) to swap a campaign
+ * asset's `src` for its hosted URL instead of inlining it as base64. Both import from here so the
+ * path and shape can never drift between writer and reader.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgDir = resolve(__dirname, '..', '..');
+/** dist/ is gitignored — this is local, regenerable build output, not committed. */
+export const cloudinaryManifestPath = resolve(pkgDir, 'dist', 'cloudinary-manifest.json');
+export function loadCloudinaryManifest() {
+    if (!existsSync(cloudinaryManifestPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(cloudinaryManifestPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Lookup keyed by `${campaign}/${email}/${filename}` for O(1) resolution during compile. */
+export function indexManifestByCampaignEmailFile(manifest) {
+    const index = new Map();
+    for (const entry of Object.values(manifest.assets)) {
+        const filename = entry.sourcePath.split('/').pop();
+        if (!filename)
+            continue;
+        index.set(`${entry.campaign}/${entry.email}/${filename}`, entry.url);
+    }
+    return index;
+}
+//# sourceMappingURL=cloudinary-manifest.js.map

package/dist/build/cloudinary-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary-manifest.js","sourceRoot":"","sources":["../../src/build/cloudinary-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAE7C,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,0BAA0B,CAAC,CAAA;AAwBzF,MAAM,UAAU,sBAAsB;IACpC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC;QAAE,OAAO,IAAI,CAAA;IACpD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAuB,CAAA;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gCAAgC,CAAC,QAA4B;IAC3E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAA;QAClD,IAAI,CAAC,QAAQ;YAAE,SAAQ;QACvB,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/build/compile.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MJML compile pipeline.
+ *
+ * Discovers the container, section previews, and full email compositions; compiles each with MJML;
+ * writes standalone HTML (+ Braze + static variants for emails) to dist/emails/, and a dist/catalog.json
+ * that Storybook and the docs read from.
+ *
+ * Run via tsx (not the emitted dist copy). Pass --watch to recompile on change.
+ */
+export {};
+//# sourceMappingURL=compile.d.ts.map

package/dist/build/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/build/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}