@learncard/email-templates 1.0.1

package/dist/templates/recovery-key.js

@@ -0,0 +1,46 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * RecoveryKey — email containing a user's account recovery key.
+ *
+ * Used by: lca-api keys.ts (templateAlias: RECOVERY_KEY_TEMPLATE_ALIAS)
+ */
+import { Text } from '@react-email/components';
+import { DEFAULT_BRANDING } from '../branding';
+import { Layout } from '../components/Layout';
+import { CodeBlock } from '../components/CodeBlock';
+export const RecoveryKey = ({ branding, recoveryKey, }) => (_jsxs(Layout, { branding: branding, preview: `Your ${branding.brandName} recovery key — keep this safe`, children: [_jsxs(Text, { style: heading, children: ["Your ", branding.brandName, " Recovery Key"] }), _jsx(Text, { style: paragraph, children: "Hello," }), _jsxs(Text, { style: paragraph, children: ["Keep this email safe. You can use the recovery key below to regain access to your ", branding.brandName, " account if you lose your device."] }), _jsx(CodeBlock, { code: recoveryKey, label: "Recovery Key \u2014 do NOT share this with anyone", variant: "key" }), _jsxs(Text, { style: paragraph, children: ["To recover your account, choose ", _jsx("strong", { children: "\u201CRecover via Email\u201D" }), " in the app and paste the recovery key above when prompted."] }), _jsx(Text, { style: muted, children: "If you did not request this, you can safely ignore this email." }), _jsxs(Text, { style: paragraph, children: [branding.brandName, " is your private, digital passport for learning and work. It lets you securely collect and share your verified skills and achievements online."] }), _jsxs(Text, { style: signOff, children: ["Sincerely,", _jsx("br", {}), "The ", branding.brandName, " Team"] })] }));
+export const getRecoveryKeySubject = (branding) => `Your ${branding.brandName} recovery key`;
+// ---------------------------------------------------------------------------
+// Styles
+// ---------------------------------------------------------------------------
+const heading = {
+    fontSize: 24,
+    fontWeight: 600,
+    color: '#111827',
+    margin: '0 0 24px',
+};
+const paragraph = {
+    fontSize: 16,
+    color: '#374151',
+    lineHeight: '24px',
+    margin: '0 0 24px',
+};
+const muted = {
+    fontSize: 14,
+    color: '#6b7280',
+    lineHeight: '20px',
+    margin: '0 0 24px',
+};
+const signOff = {
+    fontSize: 14,
+    color: '#374151',
+    lineHeight: '20px',
+    margin: '24px 0 0',
+};
+// ---------------------------------------------------------------------------
+// Preview
+// ---------------------------------------------------------------------------
+export default function Preview() {
+    return (_jsx(RecoveryKey, { branding: DEFAULT_BRANDING, recoveryKey: "mango-delta-fox-echo-bravo-seven-lima-niner" }));
+}
+//# sourceMappingURL=recovery-key.js.map

package/dist/templates/recovery-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-key.js","sourceRoot":"","sources":["../../src/templates/recovery-key.tsx"],"names":[],"mappings":";AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAI/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAOpD,MAAM,CAAC,MAAM,WAAW,GAA+B,CAAC,EACpD,QAAQ,EACR,WAAW,GACd,EAAE,EAAE,CAAC,CACF,MAAC,MAAM,IAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,QAAQ,CAAC,SAAS,gCAAgC,aAC3F,MAAC,IAAI,IAAC,KAAK,EAAE,OAAO,sBAAQ,QAAQ,CAAC,SAAS,qBAAqB,EAEnE,KAAC,IAAI,IAAC,KAAK,EAAE,SAAS,uBAAe,EAErC,MAAC,IAAI,IAAC,KAAK,EAAE,SAAS,mGAET,QAAQ,CAAC,SAAS,yCACxB,EAEP,KAAC,SAAS,IAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAC,mDAA8C,EAAC,OAAO,EAAC,KAAK,GAAG,EAEnG,MAAC,IAAI,IAAC,KAAK,EAAE,SAAS,iDACc,6DAAgD,mEAE7E,EAEP,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,+EAEX,EAEP,MAAC,IAAI,IAAC,KAAK,EAAE,SAAS,aACjB,QAAQ,CAAC,SAAS,sJAEhB,EAEP,MAAC,IAAI,IAAC,KAAK,EAAE,OAAO,2BACN,cAAM,UAAK,QAAQ,CAAC,SAAS,aACpC,IACF,CACZ,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAwB,EAAU,EAAE,CACtE,QAAQ,QAAQ,CAAC,SAAS,eAAe,CAAC;AAE9C,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,MAAM,OAAO,GAAwB;IACjC,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;IACf,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,SAAS,GAAwB;IACnC,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,KAAK,GAAwB;IAC/B,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,UAAU;CACrB,CAAC;AAEF,MAAM,OAAO,GAAwB;IACjC,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,UAAU;CACrB,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,OAAO,UAAU,OAAO;IAC3B,OAAO,CACH,KAAC,WAAW,IACR,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAC,6CAA6C,GAC3D,CACL,CAAC;AACN,CAAC"}

package/dist/templates/verification-code.d.ts

@@ -0,0 +1,24 @@
+/**
+ * VerificationCode — shared template for all code-based verification emails.
+ *
+ * Used by:
+ *   - login-verification-code (lca-api firebase.ts)
+ *   - recovery-email-code (lca-api keys.ts)
+ *   - embed-email-verification (brain-service contact-methods.ts)
+ *   - contact-method-verification (brain-service contact-methods.ts)
+ *
+ * The `variant` prop controls the subject line and descriptive text.
+ */
+import * as React from 'react';
+import type { TenantBranding } from '../branding';
+export type VerificationCodeVariant = 'login' | 'recovery-email' | 'embed-verification' | 'contact-method';
+export interface VerificationCodeProps {
+    branding: TenantBranding;
+    verificationCode: string;
+    verificationEmail?: string;
+    variant: VerificationCodeVariant;
+}
+export declare const VerificationCode: React.FC<VerificationCodeProps>;
+export declare const getVerificationCodeSubject: (branding: TenantBranding, variant: VerificationCodeVariant) => string;
+export default function Preview(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=verification-code.d.ts.map

package/dist/templates/verification-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-code.d.ts","sourceRoot":"","sources":["../../src/templates/verification-code.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,MAAM,uBAAuB,GAC7B,OAAO,GACP,gBAAgB,GAChB,oBAAoB,GACpB,gBAAgB,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,uBAAuB,CAAC;CACpC;AAwCD,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA8B5D,CAAC;AAEF,eAAO,MAAM,0BAA0B,aACzB,cAAc,WACf,uBAAuB,KACjC,MAA6D,CAAC;AAsCjE,MAAM,CAAC,OAAO,UAAU,OAAO,4CAS9B"}

package/dist/templates/verification-code.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * VerificationCode — shared template for all code-based verification emails.
+ *
+ * Used by:
+ *   - login-verification-code (lca-api firebase.ts)
+ *   - recovery-email-code (lca-api keys.ts)
+ *   - embed-email-verification (brain-service contact-methods.ts)
+ *   - contact-method-verification (brain-service contact-methods.ts)
+ *
+ * The `variant` prop controls the subject line and descriptive text.
+ */
+import { Text } from '@react-email/components';
+import { DEFAULT_BRANDING } from '../branding';
+import { Layout } from '../components/Layout';
+import { CodeBlock } from '../components/CodeBlock';
+const VARIANT_CONFIG = {
+    login: {
+        subject: (b) => `Your ${b} login code`,
+        heading: (b) => `Your ${b} Login Code`,
+        description: (email, b) => email
+            ? `Here's your secure 6-digit code to log into ${b}`
+            : `Here's your secure 6-digit code to log into ${b}`,
+        expiry: 'This code will expire in 5 minutes. If you didn\u2019t request this, you can safely ignore this email.',
+    },
+    'recovery-email': {
+        subject: () => 'Verify your recovery email',
+        heading: (b) => `Your ${b} Verification Code`,
+        description: (email, b) => email
+            ? `Here's your secure 6-digit code to add ${email} as a recovery method for ${b}`
+            : `Here's your secure 6-digit code to add a recovery method for ${b}`,
+        expiry: 'This code will expire in 5 minutes. If you didn\u2019t request this, you can safely ignore this email.',
+    },
+    'embed-verification': {
+        subject: (b) => `Your ${b} verification code`,
+        heading: (b) => `Your ${b} Verification Code`,
+        description: (email) => email
+            ? `Enter this code to verify ${email} and claim your credential:`
+            : 'Enter this code to verify your email address and claim your credential:',
+        expiry: 'This code will expire in 10 minutes. If you didn\u2019t request this, you can safely ignore this email.',
+    },
+    'contact-method': {
+        subject: (b) => `Your ${b} verification code`,
+        heading: (b) => `Your ${b} Verification Code`,
+        description: () => 'Enter this code in the app to verify your contact information.',
+        expiry: 'This code will expire in 24 hours. If you didn\u2019t request this, you can safely ignore this email.',
+    },
+};
+export const VerificationCode = ({ branding, verificationCode, verificationEmail, variant, }) => {
+    const config = VARIANT_CONFIG[variant];
+    return (_jsxs(Layout, { branding: branding, preview: `Your code: ${verificationCode}`, children: [_jsx(Text, { style: headingStyle, children: config.heading(branding.brandName) }), _jsx(Text, { style: paragraph, children: "Hello," }), _jsx(Text, { style: paragraph, children: config.description(verificationEmail, branding.brandName) }), _jsx(CodeBlock, { code: verificationCode, label: "Verification code" }), _jsx(Text, { style: muted, children: config.expiry }), _jsxs(Text, { style: paragraph, children: [branding.brandName, " is your private, digital passport for learning and work. It lets you securely collect and share your verified skills and achievements online."] }), _jsxs(Text, { style: signOff, children: ["Sincerely,", _jsx("br", {}), "The ", branding.brandName, " Team"] })] }));
+};
+export const getVerificationCodeSubject = (branding, variant) => VARIANT_CONFIG[variant].subject(branding.brandName);
+// ---------------------------------------------------------------------------
+// Styles
+// ---------------------------------------------------------------------------
+const headingStyle = {
+    fontSize: 24,
+    fontWeight: 600,
+    color: '#111827',
+    margin: '0 0 24px',
+};
+const paragraph = {
+    fontSize: 16,
+    color: '#374151',
+    lineHeight: '24px',
+    margin: '0 0 24px',
+};
+const muted = {
+    fontSize: 14,
+    color: '#6b7280',
+    lineHeight: '20px',
+    margin: '0 0 24px',
+};
+const signOff = {
+    fontSize: 14,
+    color: '#374151',
+    lineHeight: '20px',
+    margin: '24px 0 0',
+};
+// ---------------------------------------------------------------------------
+// Preview (used by `pnpm dev` / react-email dev server)
+// ---------------------------------------------------------------------------
+export default function Preview() {
+    return (_jsx(VerificationCode, { branding: DEFAULT_BRANDING, verificationCode: "847293", verificationEmail: "jane@example.com", variant: "login" }));
+}
+//# sourceMappingURL=verification-code.js.map

package/dist/templates/verification-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification-code.js","sourceRoot":"","sources":["../../src/templates/verification-code.tsx"],"names":[],"mappings":"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"}

package/dist/tenant-registry.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Server-side tenant resolution for brain-service and lca-api.
+ *
+ * Resolution order (first match wins):
+ *   1. Explicit `X-Tenant-Id` header — native apps, any client that knows its tenant
+ *   2. `Origin` / `Referer` header hostname — web apps (e.g. alpha.vetpass.app → vetpass)
+ *   3. `DEFAULT_TENANT_ID` env var — per-tenant deploys, cron jobs, server-to-server
+ *   4. Fallback to 'learncard'
+ *
+ * The registry maps tenant IDs to email branding overrides. Missing fields
+ * fall back to LearnCard defaults via `resolveBranding()`.
+ */
+import type { TenantBranding } from './branding';
+export interface ResolvedTenant {
+    /** Canonical tenant identifier, e.g. 'vetpass', 'learncard'. */
+    id: string;
+    /** Partial email branding — pass to `resolveBranding()` for full defaults. */
+    emailBranding: Partial<TenantBranding>;
+    /** How the tenant was resolved — useful for logging / debugging. */
+    resolvedVia: 'header' | 'origin' | 'env' | 'default';
+}
+export interface RequestHeaders {
+    /** Value of the X-Tenant-Id header. */
+    'x-tenant-id'?: string | undefined;
+    /** Origin header (e.g. "https://alpha.vetpass.app"). */
+    origin?: string | undefined;
+    /** Referer header (fallback for Origin). */
+    referer?: string | undefined;
+    [key: string]: string | string[] | undefined;
+}
+/**
+ * Resolve the tenant from HTTP request headers.
+ *
+ * @param headers — Request headers object. Accepts plain objects, Node IncomingHttpHeaders, etc.
+ * @param envTenantId — Override for `process.env.DEFAULT_TENANT_ID` (useful for testing).
+ */
+export declare const resolveTenantFromRequest: (headers: RequestHeaders, envTenantId?: string) => ResolvedTenant;
+/**
+ * Register additional origin → tenant mappings at startup.
+ * Useful for dev/staging domains configured via env vars.
+ */
+export declare const registerOriginMapping: (hostname: string, tenantId: string) => void;
+/**
+ * Register or update email branding for a tenant at startup.
+ * Merges with any existing branding (does not replace).
+ */
+export declare const registerTenantBranding: (tenantId: string, branding: Partial<TenantBranding>) => void;
+//# sourceMappingURL=tenant-registry.d.ts.map

package/dist/tenant-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-registry.d.ts","sourceRoot":"","sources":["../src/tenant-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAMjD,MAAM,WAAW,cAAc;IAC3B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IAEX,8EAA8E;IAC9E,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvC,oEAAoE;IACpE,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC3B,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CAChD;AAkFD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,YACxB,cAAc,gBACT,MAAM,KACrB,cAgCF,CAAC;AAsBF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAAc,MAAM,YAAY,MAAM,KAAG,IAE1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,aAAc,MAAM,YAAY,OAAO,CAAC,cAAc,CAAC,KAAG,IAK5F,CAAC"}

package/dist/tenant-registry.js

@@ -0,0 +1,146 @@
+/**
+ * Server-side tenant resolution for brain-service and lca-api.
+ *
+ * Resolution order (first match wins):
+ *   1. Explicit `X-Tenant-Id` header — native apps, any client that knows its tenant
+ *   2. `Origin` / `Referer` header hostname — web apps (e.g. alpha.vetpass.app → vetpass)
+ *   3. `DEFAULT_TENANT_ID` env var — per-tenant deploys, cron jobs, server-to-server
+ *   4. Fallback to 'learncard'
+ *
+ * The registry maps tenant IDs to email branding overrides. Missing fields
+ * fall back to LearnCard defaults via `resolveBranding()`.
+ */
+// ---------------------------------------------------------------------------
+// Origin → tenant ID mapping
+//
+// Add new entries when a tenant gets a web deployment.
+// Supports exact hostname match and wildcard subdomains.
+// ---------------------------------------------------------------------------
+const ORIGIN_MAP = {
+    // VetPass
+    'vetpass.app': 'vetpass',
+    'alpha.vetpass.app': 'vetpass',
+    'staging.vetpass.app': 'vetpass',
+    // LearnCard
+    'learncard.app': 'learncard',
+    'staging.learncard.app': 'learncard',
+    'app.learncard.com': 'learncard',
+    // Local dev
+    'localhost': 'learncard',
+};
+// ---------------------------------------------------------------------------
+// Tenant email branding registry
+//
+// Only override fields that differ from LearnCard defaults.
+// Missing fields → resolveBranding() fills in DEFAULT_BRANDING.
+// ---------------------------------------------------------------------------
+const TENANT_EMAIL_BRANDING = {
+    learncard: {},
+    vetpass: {
+        brandName: 'VetPass',
+        logoUrl: 'https://vetpass.app/assets/icon/icon.png',
+        logoAlt: 'VetPass',
+        primaryColor: '#1B5E20',
+        primaryTextColor: '#ffffff',
+        supportEmail: 'support@vetpass.app',
+        websiteUrl: 'https://www.vetpass.app',
+        appUrl: 'https://vetpass.app',
+        fromDomain: 'vetpass.app',
+        copyrightHolder: 'VetPass',
+    },
+};
+// ---------------------------------------------------------------------------
+// Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Extract a hostname from a URL string. Returns undefined if parsing fails.
+ */
+const extractHostname = (urlString) => {
+    try {
+        return new URL(urlString).hostname;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Look up tenant ID from a hostname, checking exact match first,
+ * then stripping subdomains progressively (e.g. "foo.bar.vetpass.app" → "vetpass.app").
+ */
+const tenantIdFromHostname = (hostname) => {
+    if (ORIGIN_MAP[hostname])
+        return ORIGIN_MAP[hostname];
+    // Strip subdomains: "alpha.vetpass.app" → "vetpass.app"
+    const parts = hostname.split('.');
+    for (let i = 1; i < parts.length - 1; i++) {
+        const parent = parts.slice(i).join('.');
+        if (ORIGIN_MAP[parent])
+            return ORIGIN_MAP[parent];
+    }
+    return undefined;
+};
+/**
+ * Resolve the tenant from HTTP request headers.
+ *
+ * @param headers — Request headers object. Accepts plain objects, Node IncomingHttpHeaders, etc.
+ * @param envTenantId — Override for `process.env.DEFAULT_TENANT_ID` (useful for testing).
+ */
+export const resolveTenantFromRequest = (headers, envTenantId) => {
+    // 1. Explicit X-Tenant-Id header (native apps, any informed client)
+    const explicit = normalizeHeader(headers['x-tenant-id']);
+    if (explicit) {
+        return buildTenant(explicit, 'header');
+    }
+    // 2. Origin / Referer header (web apps)
+    const origin = normalizeHeader(headers.origin) || normalizeHeader(headers.referer);
+    if (origin) {
+        const hostname = extractHostname(origin);
+        if (hostname) {
+            const matched = tenantIdFromHostname(hostname);
+            if (matched) {
+                return buildTenant(matched, 'origin');
+            }
+        }
+    }
+    // 3. Deploy-level env var
+    const envDefault = envTenantId ?? process.env.DEFAULT_TENANT_ID;
+    if (envDefault) {
+        return buildTenant(envDefault, 'env');
+    }
+    // 4. Safe default
+    return buildTenant('learncard', 'default');
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const normalizeHeader = (value) => {
+    if (Array.isArray(value))
+        return value[0];
+    return value || undefined;
+};
+const buildTenant = (id, resolvedVia) => ({
+    id,
+    emailBranding: TENANT_EMAIL_BRANDING[id] ?? {},
+    resolvedVia,
+});
+// ---------------------------------------------------------------------------
+// Admin helpers (for extending the registry at runtime via env vars)
+// ---------------------------------------------------------------------------
+/**
+ * Register additional origin → tenant mappings at startup.
+ * Useful for dev/staging domains configured via env vars.
+ */
+export const registerOriginMapping = (hostname, tenantId) => {
+    ORIGIN_MAP[hostname] = tenantId;
+};
+/**
+ * Register or update email branding for a tenant at startup.
+ * Merges with any existing branding (does not replace).
+ */
+export const registerTenantBranding = (tenantId, branding) => {
+    TENANT_EMAIL_BRANDING[tenantId] = {
+        ...TENANT_EMAIL_BRANDING[tenantId],
+        ...branding,
+    };
+};
+//# sourceMappingURL=tenant-registry.js.map

package/dist/tenant-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-registry.js","sourceRoot":"","sources":["../src/tenant-registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@learncard/email-templates",
+  "version": "1.0.1",
+  "description": "Git-managed, tenant-branded email and SMS templates for LearnCard services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@react-email/components": "^0.0.36",
+    "@react-email/render": "^1.0.5",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react-email": "^3.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "author": "Learning Economy Foundation (www.learningeconomy.io)",
+  "license": "MIT",
+  "homepage": "https://github.com/learningeconomy/LearnCard/tree/main/packages/email-templates/README.md",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/learningeconomy/LearnCard"
+  },
+  "bugs": {
+    "url": "https://github.com/learningeconomy/LearnCard/issues"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "dev": "email dev --dir src --port 3333",
+    "preview": "email dev --dir src --port 3333",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc"
+  }
+}