@digilogiclabs/platform-core 1.18.0 → 1.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/pdf-exports/index.ts","../../src/pdf-exports/prominence.ts","../../src/pdf-exports/qr.ts","../../src/pdf-exports/url-utils.ts","../../src/pdf-exports/pdf-chrome.tsx"],"sourcesContent":["/**\n * Shared PDF export primitives — branded chrome, tier-aware prominence, QR codes,\n * UTM-tagged URLs, and filename builders for branded export pipelines.\n *\n * Companion to `/email-templates`: same shape (types + layout + utilities), different\n * runtime (server-side react-pdf rendering).\n *\n * **Optional peer dependencies:**\n * - `@react-pdf/renderer` (^4.0.0) — required for chrome components\n * - `qrcode` (^1.5.0) — required for `generateQrDataUrl`\n *\n * **Brand-agnostic:** the package ships zero brand data. Apps supply a `BrandConfig`\n * with their own logo render functions, color palette, name, and domain.\n *\n * @example\n * ```ts\n * import {\n * BrandedPdfPage,\n * tierToProminence,\n * generateQrDataUrl,\n * buildExportUrl,\n * buildExportFilename,\n * type BrandConfig,\n * } from \"@digilogiclabs/platform-core/pdf-exports\";\n *\n * const ossBrand: BrandConfig = {\n * name: \"OpenSourceSports\",\n * domain: \"opensourcesports.io\",\n * tagline: \"Where Sports Are Defined\",\n * colors: { primary: \"#f16c25\", secondary: \"#1a4d52\", ink: \"#0c1f22\", muted: \"#3a5a5f\" },\n * renderLogoMark: (p) => <OssLogoMark {...p} />,\n * renderLogoMarkPdf: (p) => <OssLogoMarkPdf {...p} />,\n * };\n * ```\n */\n\n// Types\nexport type {\n BrandColors,\n BrandConfig,\n ExportProminence,\n ExportTier,\n LogoMarkRenderProps,\n LogoVariant,\n PrintProfile,\n} from \"./types\";\n\n// Tier mapping\nexport { tierToProminence, resolveProminence } from \"./prominence\";\n\n// QR code generator\nexport { generateQrDataUrl } from \"./qr\";\nexport type { GenerateQrDataUrlOptions } from \"./qr\";\n\n// URL + filename builders\nexport { buildExportUrl, buildExportFilename } from \"./url-utils\";\nexport type {\n BuildExportUrlInput,\n BuildExportFilenameInput,\n ExportMedium,\n ExportFileExt,\n} from \"./url-utils\";\n\n// PDF chrome components\nexport { ExportHeaderPdf, ExportFooterPdf, BrandedPdfPage } from \"./pdf-chrome\";\nexport type {\n ExportHeaderPdfProps,\n ExportFooterPdfProps,\n BrandedPdfPageProps,\n} from \"./pdf-chrome\";\n","import type { BrandConfig, ExportProminence, ExportTier } from \"./types\";\n\n/**\n * Default tier → prominence mapping.\n *\n * Patron and supporter tiers earn `refined` prominence (smaller branding chrome,\n * tagline hidden). All other tiers — including signed-in free users and anonymous\n * visitors — receive `maximum` prominence so OSS/app branding stays visible.\n *\n * Branding is **never removed**, only modulated in size and detail. Apps that need\n * a different vocabulary (e.g., \"plus\" / \"pro\") should supply\n * `BrandConfig.prominenceMap` instead of forking this function.\n *\n * @example\n * ```ts\n * tierToProminence(\"patron\"); // \"refined\"\n * tierToProminence(\"supporter\"); // \"refined\"\n * tierToProminence(\"free\"); // \"maximum\"\n * tierToProminence(null); // \"maximum\"\n * tierToProminence(\"plus\"); // \"maximum\" (unknown token falls back)\n * ```\n */\nexport function tierToProminence(tier: ExportTier): ExportProminence {\n if (tier === \"patron\") return \"refined\";\n if (tier === \"supporter\") return \"refined\";\n return \"maximum\";\n}\n\n/**\n * Resolve prominence for a brand — uses the brand's `prominenceMap` if supplied,\n * otherwise the default `tierToProminence` mapping.\n */\nexport function resolveProminence(\n brand: BrandConfig,\n tier: ExportTier,\n): ExportProminence {\n if (brand.prominenceMap) return brand.prominenceMap(tier);\n return tierToProminence(tier);\n}\n","/**\n * QR code generation for branded export footers.\n *\n * Uses the `qrcode` package (optional peer dependency). Calls return a base64\n * data URL ready to be embedded as an `<Image src={...}>` in react-pdf or as a\n * standard `<img>` in HTML preview routes.\n *\n * Failures (invalid URL, encoder errors) return `null` rather than throwing —\n * exports should degrade gracefully without a QR rather than failing the whole\n * PDF render.\n */\n\nexport interface GenerateQrDataUrlOptions {\n /** Output pixel size (square). Default: 320. */\n size?: number;\n /** Quiet-zone margin in modules. Default: 1. */\n margin?: number;\n /** Module (foreground) color. Default: \"#0c1f22\" (dark ink). */\n darkColor?: string;\n /** Background color. Default: \"#ffffff\". */\n lightColor?: string;\n /**\n * Error-correction level. Default: \"M\" (15% recovery — balances density vs durability\n * on printed sheets that may scuff or fold).\n */\n errorCorrectionLevel?: \"L\" | \"M\" | \"Q\" | \"H\";\n}\n\n/**\n * Generate a QR code as a base64 PNG data URL.\n *\n * @param url - The URL to encode (typically a UTM-tagged link back to the live page).\n * @param options - Color, size, and error-correction overrides.\n * @returns Data URL string, or `null` on failure.\n *\n * @example\n * ```ts\n * const qrDataUrl = await generateQrDataUrl(\n * \"https://opensourcesports.io/rules/basketball?utm_source=export\",\n * { darkColor: brand.colors.ink },\n * );\n * if (qrDataUrl) {\n * // <Image src={qrDataUrl} style={...} />\n * }\n * ```\n */\nexport async function generateQrDataUrl(\n url: string,\n options?: GenerateQrDataUrlOptions,\n): Promise<string | null> {\n try {\n // Dynamic import keeps qrcode as an optional peer dep — only loaded if used.\n const qr = await import(\"qrcode\");\n const toDataURL = qr.default?.toDataURL ?? qr.toDataURL;\n return await toDataURL(url, {\n width: options?.size ?? 320,\n margin: options?.margin ?? 1,\n errorCorrectionLevel: options?.errorCorrectionLevel ?? \"M\",\n color: {\n dark: options?.darkColor ?? \"#0c1f22\",\n light: options?.lightColor ?? \"#ffffff\",\n },\n });\n } catch {\n return null;\n }\n}\n","import type { BrandConfig } from \"./types\";\n\n/**\n * Export medium — used in UTM tagging and filename suffixes.\n */\nexport type ExportMedium = \"pdf\" | \"png\" | \"ical\" | \"csv\" | \"tsv\";\n\n/**\n * File extension — distinct from medium because iCal uses `.ics` not `.ical`.\n */\nexport type ExportFileExt = \"pdf\" | \"png\" | \"ics\" | \"csv\" | \"tsv\";\n\nexport interface BuildExportUrlInput {\n /** Brand config — supplies the domain. */\n brand: BrandConfig;\n /**\n * Tool / template identifier (e.g., \"bracket-generator\", \"rules\", \"scoreboard\").\n * Becomes part of the URL path and `utm_tool`.\n */\n tool: string;\n /** Export medium for `utm_medium`. */\n medium: ExportMedium;\n /**\n * Optional share-link slug — when present, the URL points at `/s/<slug>` rather than\n * `/tools/<tool>` so QR scanners land on the actual shared artifact.\n */\n shareSlug?: string;\n /**\n * Optional URL path override. When supplied, replaces both `/s/<slug>` and\n * `/tools/<tool>` defaults. Useful for non-tool exports (e.g., `/rules/basketball`).\n */\n path?: string;\n /** Optional extra UTM/query params merged into the URL. */\n params?: Record<string, string>;\n}\n\n/**\n * Build a UTM-tagged URL for QR codes / footer links on branded exports.\n *\n * Every printed sheet that scans back to the live page becomes a measurable acquisition\n * channel — the UTM trio (`utm_source=export`, `utm_medium=<medium>`, `utm_tool=<tool>`)\n * lets analytics attribute traffic to specific export types.\n *\n * @example\n * ```ts\n * buildExportUrl({\n * brand: ossBrand,\n * tool: \"rules\",\n * medium: \"pdf\",\n * path: \"/rules/basketball\",\n * });\n * // → \"https://opensourcesports.io/rules/basketball?utm_source=export&utm_medium=pdf&utm_tool=rules\"\n * ```\n */\nexport function buildExportUrl({\n brand,\n tool,\n medium,\n shareSlug,\n path,\n params,\n}: BuildExportUrlInput): string {\n const resolvedPath = path\n ? path\n : shareSlug\n ? `/s/${shareSlug}`\n : `/tools/${tool}`;\n const base = `https://${brand.domain}${resolvedPath}`;\n const search = new URLSearchParams({\n utm_source: \"export\",\n utm_medium: medium,\n utm_tool: tool,\n ...params,\n });\n return `${base}?${search.toString()}`;\n}\n\nexport interface BuildExportFilenameInput {\n /** Brand config — supplies the filename prefix. */\n brand: BrandConfig;\n /** Tool / template identifier. */\n tool: string;\n /** Optional title or date suffix (slugified). */\n titleOrDate?: string;\n /** File extension. */\n ext: ExportFileExt;\n}\n\n/**\n * Build a filename of the form `{brand-slug}-{tool}[-{title-slug}].{ext}`.\n *\n * The brand slug is derived from `brand.name` (lowercased, hyphenated) so the filename\n * carries brand identity even when downloaded outside the app context.\n *\n * @example\n * ```ts\n * buildExportFilename({\n * brand: ossBrand,\n * tool: \"rules\",\n * titleOrDate: \"Basketball NBA\",\n * ext: \"pdf\",\n * });\n * // → \"opensourcesports-rules-basketball-nba.pdf\"\n * ```\n */\nexport function buildExportFilename({\n brand,\n tool,\n titleOrDate,\n ext,\n}: BuildExportFilenameInput): string {\n const brandSlug = slugify(brand.name);\n const titleSlug = slugify(titleOrDate);\n const middle = titleSlug ? `${tool}-${titleSlug}` : tool;\n return `${brandSlug}-${middle}.${ext}`;\n}\n\nfunction slugify(input: string | undefined): string {\n if (!input) return \"\";\n return input\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, \"-\")\n .replace(/^-+|-+$/g, \"\")\n .slice(0, 60);\n}\n","import { Image, Page, StyleSheet, Text, View } from \"@react-pdf/renderer\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nimport type { BrandConfig, ExportProminence } from \"./types\";\n\n/**\n * @react-pdf/renderer is declared as an OPTIONAL peer dependency. Apps that\n * import this subpath must install it themselves; bundlers will surface a\n * clear \"Cannot find module\" error if it isn't present, which is the standard\n * platform-core pattern for optional peers (`pg`, `ioredis`, `bullmq`, etc).\n */\n\n/**\n * Build a brand-aware StyleSheet for header + footer chrome.\n *\n * Called once per render — react-pdf's StyleSheet.create is intentionally\n * lightweight and the perf cost is negligible relative to the actual document\n * render. Building per render means brand colors are honored without\n * module-level caching tricks.\n */\nfunction makeChromeStyles(brand: BrandConfig) {\n return StyleSheet.create({\n headerRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n borderBottomWidth: 3,\n borderBottomColor: brand.colors.primary,\n paddingBottom: 10,\n marginBottom: 12,\n gap: 16,\n },\n headerLeft: { flexDirection: \"column\", flexGrow: 1, flexShrink: 1 },\n eyebrow: {\n fontSize: 9,\n letterSpacing: 1.5,\n color: brand.colors.muted,\n textTransform: \"uppercase\",\n fontFamily: \"Helvetica-Bold\",\n marginBottom: 2,\n },\n title: {\n fontSize: 22,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.ink,\n lineHeight: 1.15,\n },\n subtitle: {\n fontSize: 10,\n color: brand.colors.muted,\n marginTop: 3,\n },\n lockupRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n gap: 8,\n },\n wordmark: {\n fontSize: 13,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n letterSpacing: -0.2,\n },\n footerRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n borderTopWidth: 2,\n borderTopColor: brand.colors.primary,\n paddingTop: 8,\n marginTop: 10,\n gap: 16,\n },\n footerLeft: { flexDirection: \"row\", alignItems: \"center\", gap: 8 },\n footerMid: {\n flexDirection: \"column\",\n alignItems: \"flex-end\",\n flexShrink: 1,\n },\n footerUrl: {\n fontSize: 9,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n },\n footerDate: {\n fontSize: 8,\n color: brand.colors.muted,\n marginTop: 2,\n },\n footerTagline: {\n fontSize: 8,\n color: brand.colors.muted,\n },\n footerName: {\n fontSize: 11,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n },\n qr: {\n width: 44,\n height: 44,\n },\n qrRefined: {\n width: 32,\n height: 32,\n },\n pageBody: {\n flex: 1,\n },\n });\n}\n\nexport interface ExportHeaderPdfProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Document title (e.g., \"Basketball (NBA) — Official Rules\"). */\n title: string;\n /** Small uppercase eyebrow above the title (e.g., \"Rules Sheet\", \"Bracket Generator\"). */\n toolLabel: string;\n /** Optional supplemental line under the title. */\n subtitle?: string;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n}\n\n/**\n * Branded PDF document header — first-page only by default.\n *\n * Renders eyebrow + title + optional subtitle on the left, brand mark + wordmark on\n * the right, with a primary-color rule below.\n */\nexport function ExportHeaderPdf({\n brand,\n title,\n toolLabel,\n subtitle,\n prominence = \"maximum\",\n}: ExportHeaderPdfProps): ReactElement {\n const styles = makeChromeStyles(brand);\n const lockupSize = prominence === \"maximum\" ? 32 : 26;\n const titleSize = prominence === \"maximum\" ? 22 : 18;\n const Logo = brand.renderLogoMarkPdf;\n return (\n <View style={styles.headerRow} fixed={false}>\n <View style={styles.headerLeft}>\n <Text style={styles.eyebrow}>{toolLabel}</Text>\n <Text style={[styles.title, { fontSize: titleSize }]}>{title}</Text>\n {subtitle ? <Text style={styles.subtitle}>{subtitle}</Text> : null}\n </View>\n <View style={styles.lockupRow}>\n <Logo size={lockupSize} variant=\"original\" />\n <Text style={styles.wordmark}>{brand.name}</Text>\n </View>\n </View>\n );\n}\n\nexport interface ExportFooterPdfProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Public URL displayed in footer (typically UTM-tagged via `buildExportUrl`). */\n url: string;\n /** Generation date label (e.g., \"Generated April 26, 2026\"). */\n dateLabel?: string;\n /** Pre-rendered QR data URL (from `generateQrDataUrl`). Pass `null` to omit. */\n qrDataUrl?: string | null;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n}\n\n/**\n * Branded PDF document footer — `fixed` so it renders on every page.\n *\n * Composition: brand mark + name (left), URL + date (center-right), QR (far right).\n * Tagline shown only at `maximum` prominence; QR shrinks at `refined`.\n */\nexport function ExportFooterPdf({\n brand,\n url,\n dateLabel,\n qrDataUrl,\n prominence = \"maximum\",\n}: ExportFooterPdfProps): ReactElement {\n const styles = makeChromeStyles(brand);\n const isRefined = prominence === \"refined\";\n const showTagline = prominence === \"maximum\" && Boolean(brand.tagline);\n const markSize = isRefined ? 20 : 26;\n const showQr = Boolean(qrDataUrl);\n const Logo = brand.renderLogoMarkPdf;\n\n return (\n <View style={styles.footerRow} fixed>\n <View style={styles.footerLeft}>\n <Logo size={markSize} variant=\"original\" />\n <View>\n <Text style={styles.footerName}>{brand.name}</Text>\n {showTagline ? (\n <Text style={styles.footerTagline}>{brand.tagline}</Text>\n ) : null}\n </View>\n </View>\n <View style={styles.footerMid}>\n <Text style={styles.footerUrl}>{url}</Text>\n {dateLabel ? <Text style={styles.footerDate}>{dateLabel}</Text> : null}\n </View>\n {showQr && qrDataUrl ? (\n <Image\n src={qrDataUrl}\n style={isRefined ? styles.qrRefined : styles.qr}\n />\n ) : null}\n </View>\n );\n}\n\nexport interface BrandedPdfPageProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Document title shown in the header. */\n title: string;\n /** Eyebrow label above the title. */\n toolLabel: string;\n /** Optional subtitle under the title. */\n subtitle?: string;\n /** Footer URL (typically UTM-tagged). */\n url: string;\n /** Footer date label. */\n dateLabel?: string;\n /** Pre-rendered QR data URL. */\n qrDataUrl?: string | null;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n /**\n * Optional react-pdf Page-level style overrides (e.g., padding, fontFamily).\n * Merged onto the default page styles.\n */\n pageStyle?: Record<string, unknown>;\n /** Optional react-pdf page size. Defaults to \"LETTER\". */\n size?: \"LETTER\" | \"A4\" | \"LEGAL\" | \"TABLOID\";\n /** Document body — your selected sections, content, etc. */\n children: ReactNode;\n}\n\n/**\n * Full branded PDF page wrapper — composes header + body slot + sticky footer.\n *\n * The footer is `fixed` so it renders on every page automatically. The header is\n * first-page only; if you need a per-page compact strip on page 2+, use\n * `ExportHeaderPdf` with your own placement logic.\n *\n * @example\n * ```tsx\n * import { Document } from \"@react-pdf/renderer\";\n * import { BrandedPdfPage } from \"@digilogiclabs/platform-core/pdf-exports\";\n *\n * <Document>\n * <BrandedPdfPage\n * brand={ossBrand}\n * title=\"Basketball — Official Rules\"\n * toolLabel=\"Rules Sheet\"\n * url=\"https://opensourcesports.io/rules/basketball?utm_source=export\"\n * qrDataUrl={qrDataUrl}\n * prominence={tierToProminence(userTier)}\n * >\n * <RulesBody sections={selectedSections} />\n * </BrandedPdfPage>\n * </Document>\n * ```\n */\nexport function BrandedPdfPage({\n brand,\n title,\n toolLabel,\n subtitle,\n url,\n dateLabel,\n qrDataUrl,\n prominence = \"maximum\",\n pageStyle,\n size = \"LETTER\",\n children,\n}: BrandedPdfPageProps): ReactElement {\n const styles = makeChromeStyles(brand);\n\n const defaultPageStyle = {\n padding: 36,\n fontFamily: \"Helvetica\",\n backgroundColor: brand.colors.surface ?? \"#ffffff\",\n fontSize: 10,\n color: brand.colors.ink,\n };\n const mergedPageStyle = { ...defaultPageStyle, ...pageStyle };\n\n return (\n <Page size={size} style={mergedPageStyle}>\n <ExportHeaderPdf\n brand={brand}\n title={title}\n toolLabel={toolLabel}\n subtitle={subtitle}\n prominence={prominence}\n />\n <View style={styles.pageBody}>{children}</View>\n <ExportFooterPdf\n brand={brand}\n url={url}\n dateLabel={dateLabel}\n qrDataUrl={qrDataUrl}\n prominence={prominence}\n />\n </Page>\n );\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,273 @@
1
+ // src/pdf-exports/prominence.ts
2
+ function tierToProminence(tier) {
3
+ if (tier === "patron") return "refined";
4
+ if (tier === "supporter") return "refined";
5
+ return "maximum";
6
+ }
7
+ function resolveProminence(brand, tier) {
8
+ if (brand.prominenceMap) return brand.prominenceMap(tier);
9
+ return tierToProminence(tier);
10
+ }
11
+
12
+ // src/pdf-exports/qr.ts
13
+ async function generateQrDataUrl(url, options) {
14
+ try {
15
+ const qr = await import("qrcode");
16
+ const toDataURL = qr.default?.toDataURL ?? qr.toDataURL;
17
+ return await toDataURL(url, {
18
+ width: options?.size ?? 320,
19
+ margin: options?.margin ?? 1,
20
+ errorCorrectionLevel: options?.errorCorrectionLevel ?? "M",
21
+ color: {
22
+ dark: options?.darkColor ?? "#0c1f22",
23
+ light: options?.lightColor ?? "#ffffff"
24
+ }
25
+ });
26
+ } catch {
27
+ return null;
28
+ }
29
+ }
30
+
31
+ // src/pdf-exports/url-utils.ts
32
+ function buildExportUrl({
33
+ brand,
34
+ tool,
35
+ medium,
36
+ shareSlug,
37
+ path,
38
+ params
39
+ }) {
40
+ const resolvedPath = path ? path : shareSlug ? `/s/${shareSlug}` : `/tools/${tool}`;
41
+ const base = `https://${brand.domain}${resolvedPath}`;
42
+ const search = new URLSearchParams({
43
+ utm_source: "export",
44
+ utm_medium: medium,
45
+ utm_tool: tool,
46
+ ...params
47
+ });
48
+ return `${base}?${search.toString()}`;
49
+ }
50
+ function buildExportFilename({
51
+ brand,
52
+ tool,
53
+ titleOrDate,
54
+ ext
55
+ }) {
56
+ const brandSlug = slugify(brand.name);
57
+ const titleSlug = slugify(titleOrDate);
58
+ const middle = titleSlug ? `${tool}-${titleSlug}` : tool;
59
+ return `${brandSlug}-${middle}.${ext}`;
60
+ }
61
+ function slugify(input) {
62
+ if (!input) return "";
63
+ return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
64
+ }
65
+
66
+ // src/pdf-exports/pdf-chrome.tsx
67
+ import { Image, Page, StyleSheet, Text, View } from "@react-pdf/renderer";
68
+ import { jsx, jsxs } from "react/jsx-runtime";
69
+ function makeChromeStyles(brand) {
70
+ return StyleSheet.create({
71
+ headerRow: {
72
+ flexDirection: "row",
73
+ alignItems: "center",
74
+ justifyContent: "space-between",
75
+ borderBottomWidth: 3,
76
+ borderBottomColor: brand.colors.primary,
77
+ paddingBottom: 10,
78
+ marginBottom: 12,
79
+ gap: 16
80
+ },
81
+ headerLeft: { flexDirection: "column", flexGrow: 1, flexShrink: 1 },
82
+ eyebrow: {
83
+ fontSize: 9,
84
+ letterSpacing: 1.5,
85
+ color: brand.colors.muted,
86
+ textTransform: "uppercase",
87
+ fontFamily: "Helvetica-Bold",
88
+ marginBottom: 2
89
+ },
90
+ title: {
91
+ fontSize: 22,
92
+ fontFamily: "Helvetica-Bold",
93
+ color: brand.colors.ink,
94
+ lineHeight: 1.15
95
+ },
96
+ subtitle: {
97
+ fontSize: 10,
98
+ color: brand.colors.muted,
99
+ marginTop: 3
100
+ },
101
+ lockupRow: {
102
+ flexDirection: "row",
103
+ alignItems: "center",
104
+ gap: 8
105
+ },
106
+ wordmark: {
107
+ fontSize: 13,
108
+ fontFamily: "Helvetica-Bold",
109
+ color: brand.colors.secondary,
110
+ letterSpacing: -0.2
111
+ },
112
+ footerRow: {
113
+ flexDirection: "row",
114
+ alignItems: "center",
115
+ justifyContent: "space-between",
116
+ borderTopWidth: 2,
117
+ borderTopColor: brand.colors.primary,
118
+ paddingTop: 8,
119
+ marginTop: 10,
120
+ gap: 16
121
+ },
122
+ footerLeft: { flexDirection: "row", alignItems: "center", gap: 8 },
123
+ footerMid: {
124
+ flexDirection: "column",
125
+ alignItems: "flex-end",
126
+ flexShrink: 1
127
+ },
128
+ footerUrl: {
129
+ fontSize: 9,
130
+ fontFamily: "Helvetica-Bold",
131
+ color: brand.colors.secondary
132
+ },
133
+ footerDate: {
134
+ fontSize: 8,
135
+ color: brand.colors.muted,
136
+ marginTop: 2
137
+ },
138
+ footerTagline: {
139
+ fontSize: 8,
140
+ color: brand.colors.muted
141
+ },
142
+ footerName: {
143
+ fontSize: 11,
144
+ fontFamily: "Helvetica-Bold",
145
+ color: brand.colors.secondary
146
+ },
147
+ qr: {
148
+ width: 44,
149
+ height: 44
150
+ },
151
+ qrRefined: {
152
+ width: 32,
153
+ height: 32
154
+ },
155
+ pageBody: {
156
+ flex: 1
157
+ }
158
+ });
159
+ }
160
+ function ExportHeaderPdf({
161
+ brand,
162
+ title,
163
+ toolLabel,
164
+ subtitle,
165
+ prominence = "maximum"
166
+ }) {
167
+ const styles = makeChromeStyles(brand);
168
+ const lockupSize = prominence === "maximum" ? 32 : 26;
169
+ const titleSize = prominence === "maximum" ? 22 : 18;
170
+ const Logo = brand.renderLogoMarkPdf;
171
+ return /* @__PURE__ */ jsxs(View, { style: styles.headerRow, fixed: false, children: [
172
+ /* @__PURE__ */ jsxs(View, { style: styles.headerLeft, children: [
173
+ /* @__PURE__ */ jsx(Text, { style: styles.eyebrow, children: toolLabel }),
174
+ /* @__PURE__ */ jsx(Text, { style: [styles.title, { fontSize: titleSize }], children: title }),
175
+ subtitle ? /* @__PURE__ */ jsx(Text, { style: styles.subtitle, children: subtitle }) : null
176
+ ] }),
177
+ /* @__PURE__ */ jsxs(View, { style: styles.lockupRow, children: [
178
+ /* @__PURE__ */ jsx(Logo, { size: lockupSize, variant: "original" }),
179
+ /* @__PURE__ */ jsx(Text, { style: styles.wordmark, children: brand.name })
180
+ ] })
181
+ ] });
182
+ }
183
+ function ExportFooterPdf({
184
+ brand,
185
+ url,
186
+ dateLabel,
187
+ qrDataUrl,
188
+ prominence = "maximum"
189
+ }) {
190
+ const styles = makeChromeStyles(brand);
191
+ const isRefined = prominence === "refined";
192
+ const showTagline = prominence === "maximum" && Boolean(brand.tagline);
193
+ const markSize = isRefined ? 20 : 26;
194
+ const showQr = Boolean(qrDataUrl);
195
+ const Logo = brand.renderLogoMarkPdf;
196
+ return /* @__PURE__ */ jsxs(View, { style: styles.footerRow, fixed: true, children: [
197
+ /* @__PURE__ */ jsxs(View, { style: styles.footerLeft, children: [
198
+ /* @__PURE__ */ jsx(Logo, { size: markSize, variant: "original" }),
199
+ /* @__PURE__ */ jsxs(View, { children: [
200
+ /* @__PURE__ */ jsx(Text, { style: styles.footerName, children: brand.name }),
201
+ showTagline ? /* @__PURE__ */ jsx(Text, { style: styles.footerTagline, children: brand.tagline }) : null
202
+ ] })
203
+ ] }),
204
+ /* @__PURE__ */ jsxs(View, { style: styles.footerMid, children: [
205
+ /* @__PURE__ */ jsx(Text, { style: styles.footerUrl, children: url }),
206
+ dateLabel ? /* @__PURE__ */ jsx(Text, { style: styles.footerDate, children: dateLabel }) : null
207
+ ] }),
208
+ showQr && qrDataUrl ? /* @__PURE__ */ jsx(
209
+ Image,
210
+ {
211
+ src: qrDataUrl,
212
+ style: isRefined ? styles.qrRefined : styles.qr
213
+ }
214
+ ) : null
215
+ ] });
216
+ }
217
+ function BrandedPdfPage({
218
+ brand,
219
+ title,
220
+ toolLabel,
221
+ subtitle,
222
+ url,
223
+ dateLabel,
224
+ qrDataUrl,
225
+ prominence = "maximum",
226
+ pageStyle,
227
+ size = "LETTER",
228
+ children
229
+ }) {
230
+ const styles = makeChromeStyles(brand);
231
+ const defaultPageStyle = {
232
+ padding: 36,
233
+ fontFamily: "Helvetica",
234
+ backgroundColor: brand.colors.surface ?? "#ffffff",
235
+ fontSize: 10,
236
+ color: brand.colors.ink
237
+ };
238
+ const mergedPageStyle = { ...defaultPageStyle, ...pageStyle };
239
+ return /* @__PURE__ */ jsxs(Page, { size, style: mergedPageStyle, children: [
240
+ /* @__PURE__ */ jsx(
241
+ ExportHeaderPdf,
242
+ {
243
+ brand,
244
+ title,
245
+ toolLabel,
246
+ subtitle,
247
+ prominence
248
+ }
249
+ ),
250
+ /* @__PURE__ */ jsx(View, { style: styles.pageBody, children }),
251
+ /* @__PURE__ */ jsx(
252
+ ExportFooterPdf,
253
+ {
254
+ brand,
255
+ url,
256
+ dateLabel,
257
+ qrDataUrl,
258
+ prominence
259
+ }
260
+ )
261
+ ] });
262
+ }
263
+ export {
264
+ BrandedPdfPage,
265
+ ExportFooterPdf,
266
+ ExportHeaderPdf,
267
+ buildExportFilename,
268
+ buildExportUrl,
269
+ generateQrDataUrl,
270
+ resolveProminence,
271
+ tierToProminence
272
+ };
273
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/pdf-exports/prominence.ts","../../src/pdf-exports/qr.ts","../../src/pdf-exports/url-utils.ts","../../src/pdf-exports/pdf-chrome.tsx"],"sourcesContent":["import type { BrandConfig, ExportProminence, ExportTier } from \"./types\";\n\n/**\n * Default tier → prominence mapping.\n *\n * Patron and supporter tiers earn `refined` prominence (smaller branding chrome,\n * tagline hidden). All other tiers — including signed-in free users and anonymous\n * visitors — receive `maximum` prominence so OSS/app branding stays visible.\n *\n * Branding is **never removed**, only modulated in size and detail. Apps that need\n * a different vocabulary (e.g., \"plus\" / \"pro\") should supply\n * `BrandConfig.prominenceMap` instead of forking this function.\n *\n * @example\n * ```ts\n * tierToProminence(\"patron\"); // \"refined\"\n * tierToProminence(\"supporter\"); // \"refined\"\n * tierToProminence(\"free\"); // \"maximum\"\n * tierToProminence(null); // \"maximum\"\n * tierToProminence(\"plus\"); // \"maximum\" (unknown token falls back)\n * ```\n */\nexport function tierToProminence(tier: ExportTier): ExportProminence {\n if (tier === \"patron\") return \"refined\";\n if (tier === \"supporter\") return \"refined\";\n return \"maximum\";\n}\n\n/**\n * Resolve prominence for a brand — uses the brand's `prominenceMap` if supplied,\n * otherwise the default `tierToProminence` mapping.\n */\nexport function resolveProminence(\n brand: BrandConfig,\n tier: ExportTier,\n): ExportProminence {\n if (brand.prominenceMap) return brand.prominenceMap(tier);\n return tierToProminence(tier);\n}\n","/**\n * QR code generation for branded export footers.\n *\n * Uses the `qrcode` package (optional peer dependency). Calls return a base64\n * data URL ready to be embedded as an `<Image src={...}>` in react-pdf or as a\n * standard `<img>` in HTML preview routes.\n *\n * Failures (invalid URL, encoder errors) return `null` rather than throwing —\n * exports should degrade gracefully without a QR rather than failing the whole\n * PDF render.\n */\n\nexport interface GenerateQrDataUrlOptions {\n /** Output pixel size (square). Default: 320. */\n size?: number;\n /** Quiet-zone margin in modules. Default: 1. */\n margin?: number;\n /** Module (foreground) color. Default: \"#0c1f22\" (dark ink). */\n darkColor?: string;\n /** Background color. Default: \"#ffffff\". */\n lightColor?: string;\n /**\n * Error-correction level. Default: \"M\" (15% recovery — balances density vs durability\n * on printed sheets that may scuff or fold).\n */\n errorCorrectionLevel?: \"L\" | \"M\" | \"Q\" | \"H\";\n}\n\n/**\n * Generate a QR code as a base64 PNG data URL.\n *\n * @param url - The URL to encode (typically a UTM-tagged link back to the live page).\n * @param options - Color, size, and error-correction overrides.\n * @returns Data URL string, or `null` on failure.\n *\n * @example\n * ```ts\n * const qrDataUrl = await generateQrDataUrl(\n * \"https://opensourcesports.io/rules/basketball?utm_source=export\",\n * { darkColor: brand.colors.ink },\n * );\n * if (qrDataUrl) {\n * // <Image src={qrDataUrl} style={...} />\n * }\n * ```\n */\nexport async function generateQrDataUrl(\n url: string,\n options?: GenerateQrDataUrlOptions,\n): Promise<string | null> {\n try {\n // Dynamic import keeps qrcode as an optional peer dep — only loaded if used.\n const qr = await import(\"qrcode\");\n const toDataURL = qr.default?.toDataURL ?? qr.toDataURL;\n return await toDataURL(url, {\n width: options?.size ?? 320,\n margin: options?.margin ?? 1,\n errorCorrectionLevel: options?.errorCorrectionLevel ?? \"M\",\n color: {\n dark: options?.darkColor ?? \"#0c1f22\",\n light: options?.lightColor ?? \"#ffffff\",\n },\n });\n } catch {\n return null;\n }\n}\n","import type { BrandConfig } from \"./types\";\n\n/**\n * Export medium — used in UTM tagging and filename suffixes.\n */\nexport type ExportMedium = \"pdf\" | \"png\" | \"ical\" | \"csv\" | \"tsv\";\n\n/**\n * File extension — distinct from medium because iCal uses `.ics` not `.ical`.\n */\nexport type ExportFileExt = \"pdf\" | \"png\" | \"ics\" | \"csv\" | \"tsv\";\n\nexport interface BuildExportUrlInput {\n /** Brand config — supplies the domain. */\n brand: BrandConfig;\n /**\n * Tool / template identifier (e.g., \"bracket-generator\", \"rules\", \"scoreboard\").\n * Becomes part of the URL path and `utm_tool`.\n */\n tool: string;\n /** Export medium for `utm_medium`. */\n medium: ExportMedium;\n /**\n * Optional share-link slug — when present, the URL points at `/s/<slug>` rather than\n * `/tools/<tool>` so QR scanners land on the actual shared artifact.\n */\n shareSlug?: string;\n /**\n * Optional URL path override. When supplied, replaces both `/s/<slug>` and\n * `/tools/<tool>` defaults. Useful for non-tool exports (e.g., `/rules/basketball`).\n */\n path?: string;\n /** Optional extra UTM/query params merged into the URL. */\n params?: Record<string, string>;\n}\n\n/**\n * Build a UTM-tagged URL for QR codes / footer links on branded exports.\n *\n * Every printed sheet that scans back to the live page becomes a measurable acquisition\n * channel — the UTM trio (`utm_source=export`, `utm_medium=<medium>`, `utm_tool=<tool>`)\n * lets analytics attribute traffic to specific export types.\n *\n * @example\n * ```ts\n * buildExportUrl({\n * brand: ossBrand,\n * tool: \"rules\",\n * medium: \"pdf\",\n * path: \"/rules/basketball\",\n * });\n * // → \"https://opensourcesports.io/rules/basketball?utm_source=export&utm_medium=pdf&utm_tool=rules\"\n * ```\n */\nexport function buildExportUrl({\n brand,\n tool,\n medium,\n shareSlug,\n path,\n params,\n}: BuildExportUrlInput): string {\n const resolvedPath = path\n ? path\n : shareSlug\n ? `/s/${shareSlug}`\n : `/tools/${tool}`;\n const base = `https://${brand.domain}${resolvedPath}`;\n const search = new URLSearchParams({\n utm_source: \"export\",\n utm_medium: medium,\n utm_tool: tool,\n ...params,\n });\n return `${base}?${search.toString()}`;\n}\n\nexport interface BuildExportFilenameInput {\n /** Brand config — supplies the filename prefix. */\n brand: BrandConfig;\n /** Tool / template identifier. */\n tool: string;\n /** Optional title or date suffix (slugified). */\n titleOrDate?: string;\n /** File extension. */\n ext: ExportFileExt;\n}\n\n/**\n * Build a filename of the form `{brand-slug}-{tool}[-{title-slug}].{ext}`.\n *\n * The brand slug is derived from `brand.name` (lowercased, hyphenated) so the filename\n * carries brand identity even when downloaded outside the app context.\n *\n * @example\n * ```ts\n * buildExportFilename({\n * brand: ossBrand,\n * tool: \"rules\",\n * titleOrDate: \"Basketball NBA\",\n * ext: \"pdf\",\n * });\n * // → \"opensourcesports-rules-basketball-nba.pdf\"\n * ```\n */\nexport function buildExportFilename({\n brand,\n tool,\n titleOrDate,\n ext,\n}: BuildExportFilenameInput): string {\n const brandSlug = slugify(brand.name);\n const titleSlug = slugify(titleOrDate);\n const middle = titleSlug ? `${tool}-${titleSlug}` : tool;\n return `${brandSlug}-${middle}.${ext}`;\n}\n\nfunction slugify(input: string | undefined): string {\n if (!input) return \"\";\n return input\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, \"-\")\n .replace(/^-+|-+$/g, \"\")\n .slice(0, 60);\n}\n","import { Image, Page, StyleSheet, Text, View } from \"@react-pdf/renderer\";\nimport type { ReactElement, ReactNode } from \"react\";\n\nimport type { BrandConfig, ExportProminence } from \"./types\";\n\n/**\n * @react-pdf/renderer is declared as an OPTIONAL peer dependency. Apps that\n * import this subpath must install it themselves; bundlers will surface a\n * clear \"Cannot find module\" error if it isn't present, which is the standard\n * platform-core pattern for optional peers (`pg`, `ioredis`, `bullmq`, etc).\n */\n\n/**\n * Build a brand-aware StyleSheet for header + footer chrome.\n *\n * Called once per render — react-pdf's StyleSheet.create is intentionally\n * lightweight and the perf cost is negligible relative to the actual document\n * render. Building per render means brand colors are honored without\n * module-level caching tricks.\n */\nfunction makeChromeStyles(brand: BrandConfig) {\n return StyleSheet.create({\n headerRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n borderBottomWidth: 3,\n borderBottomColor: brand.colors.primary,\n paddingBottom: 10,\n marginBottom: 12,\n gap: 16,\n },\n headerLeft: { flexDirection: \"column\", flexGrow: 1, flexShrink: 1 },\n eyebrow: {\n fontSize: 9,\n letterSpacing: 1.5,\n color: brand.colors.muted,\n textTransform: \"uppercase\",\n fontFamily: \"Helvetica-Bold\",\n marginBottom: 2,\n },\n title: {\n fontSize: 22,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.ink,\n lineHeight: 1.15,\n },\n subtitle: {\n fontSize: 10,\n color: brand.colors.muted,\n marginTop: 3,\n },\n lockupRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n gap: 8,\n },\n wordmark: {\n fontSize: 13,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n letterSpacing: -0.2,\n },\n footerRow: {\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n borderTopWidth: 2,\n borderTopColor: brand.colors.primary,\n paddingTop: 8,\n marginTop: 10,\n gap: 16,\n },\n footerLeft: { flexDirection: \"row\", alignItems: \"center\", gap: 8 },\n footerMid: {\n flexDirection: \"column\",\n alignItems: \"flex-end\",\n flexShrink: 1,\n },\n footerUrl: {\n fontSize: 9,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n },\n footerDate: {\n fontSize: 8,\n color: brand.colors.muted,\n marginTop: 2,\n },\n footerTagline: {\n fontSize: 8,\n color: brand.colors.muted,\n },\n footerName: {\n fontSize: 11,\n fontFamily: \"Helvetica-Bold\",\n color: brand.colors.secondary,\n },\n qr: {\n width: 44,\n height: 44,\n },\n qrRefined: {\n width: 32,\n height: 32,\n },\n pageBody: {\n flex: 1,\n },\n });\n}\n\nexport interface ExportHeaderPdfProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Document title (e.g., \"Basketball (NBA) — Official Rules\"). */\n title: string;\n /** Small uppercase eyebrow above the title (e.g., \"Rules Sheet\", \"Bracket Generator\"). */\n toolLabel: string;\n /** Optional supplemental line under the title. */\n subtitle?: string;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n}\n\n/**\n * Branded PDF document header — first-page only by default.\n *\n * Renders eyebrow + title + optional subtitle on the left, brand mark + wordmark on\n * the right, with a primary-color rule below.\n */\nexport function ExportHeaderPdf({\n brand,\n title,\n toolLabel,\n subtitle,\n prominence = \"maximum\",\n}: ExportHeaderPdfProps): ReactElement {\n const styles = makeChromeStyles(brand);\n const lockupSize = prominence === \"maximum\" ? 32 : 26;\n const titleSize = prominence === \"maximum\" ? 22 : 18;\n const Logo = brand.renderLogoMarkPdf;\n return (\n <View style={styles.headerRow} fixed={false}>\n <View style={styles.headerLeft}>\n <Text style={styles.eyebrow}>{toolLabel}</Text>\n <Text style={[styles.title, { fontSize: titleSize }]}>{title}</Text>\n {subtitle ? <Text style={styles.subtitle}>{subtitle}</Text> : null}\n </View>\n <View style={styles.lockupRow}>\n <Logo size={lockupSize} variant=\"original\" />\n <Text style={styles.wordmark}>{brand.name}</Text>\n </View>\n </View>\n );\n}\n\nexport interface ExportFooterPdfProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Public URL displayed in footer (typically UTM-tagged via `buildExportUrl`). */\n url: string;\n /** Generation date label (e.g., \"Generated April 26, 2026\"). */\n dateLabel?: string;\n /** Pre-rendered QR data URL (from `generateQrDataUrl`). Pass `null` to omit. */\n qrDataUrl?: string | null;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n}\n\n/**\n * Branded PDF document footer — `fixed` so it renders on every page.\n *\n * Composition: brand mark + name (left), URL + date (center-right), QR (far right).\n * Tagline shown only at `maximum` prominence; QR shrinks at `refined`.\n */\nexport function ExportFooterPdf({\n brand,\n url,\n dateLabel,\n qrDataUrl,\n prominence = \"maximum\",\n}: ExportFooterPdfProps): ReactElement {\n const styles = makeChromeStyles(brand);\n const isRefined = prominence === \"refined\";\n const showTagline = prominence === \"maximum\" && Boolean(brand.tagline);\n const markSize = isRefined ? 20 : 26;\n const showQr = Boolean(qrDataUrl);\n const Logo = brand.renderLogoMarkPdf;\n\n return (\n <View style={styles.footerRow} fixed>\n <View style={styles.footerLeft}>\n <Logo size={markSize} variant=\"original\" />\n <View>\n <Text style={styles.footerName}>{brand.name}</Text>\n {showTagline ? (\n <Text style={styles.footerTagline}>{brand.tagline}</Text>\n ) : null}\n </View>\n </View>\n <View style={styles.footerMid}>\n <Text style={styles.footerUrl}>{url}</Text>\n {dateLabel ? <Text style={styles.footerDate}>{dateLabel}</Text> : null}\n </View>\n {showQr && qrDataUrl ? (\n <Image\n src={qrDataUrl}\n style={isRefined ? styles.qrRefined : styles.qr}\n />\n ) : null}\n </View>\n );\n}\n\nexport interface BrandedPdfPageProps {\n /** Brand configuration. */\n brand: BrandConfig;\n /** Document title shown in the header. */\n title: string;\n /** Eyebrow label above the title. */\n toolLabel: string;\n /** Optional subtitle under the title. */\n subtitle?: string;\n /** Footer URL (typically UTM-tagged). */\n url: string;\n /** Footer date label. */\n dateLabel?: string;\n /** Pre-rendered QR data URL. */\n qrDataUrl?: string | null;\n /** Branding prominence. Defaults to `maximum`. */\n prominence?: ExportProminence;\n /**\n * Optional react-pdf Page-level style overrides (e.g., padding, fontFamily).\n * Merged onto the default page styles.\n */\n pageStyle?: Record<string, unknown>;\n /** Optional react-pdf page size. Defaults to \"LETTER\". */\n size?: \"LETTER\" | \"A4\" | \"LEGAL\" | \"TABLOID\";\n /** Document body — your selected sections, content, etc. */\n children: ReactNode;\n}\n\n/**\n * Full branded PDF page wrapper — composes header + body slot + sticky footer.\n *\n * The footer is `fixed` so it renders on every page automatically. The header is\n * first-page only; if you need a per-page compact strip on page 2+, use\n * `ExportHeaderPdf` with your own placement logic.\n *\n * @example\n * ```tsx\n * import { Document } from \"@react-pdf/renderer\";\n * import { BrandedPdfPage } from \"@digilogiclabs/platform-core/pdf-exports\";\n *\n * <Document>\n * <BrandedPdfPage\n * brand={ossBrand}\n * title=\"Basketball — Official Rules\"\n * toolLabel=\"Rules Sheet\"\n * url=\"https://opensourcesports.io/rules/basketball?utm_source=export\"\n * qrDataUrl={qrDataUrl}\n * prominence={tierToProminence(userTier)}\n * >\n * <RulesBody sections={selectedSections} />\n * </BrandedPdfPage>\n * </Document>\n * ```\n */\nexport function BrandedPdfPage({\n brand,\n title,\n toolLabel,\n subtitle,\n url,\n dateLabel,\n qrDataUrl,\n prominence = \"maximum\",\n pageStyle,\n size = \"LETTER\",\n children,\n}: BrandedPdfPageProps): ReactElement {\n const styles = makeChromeStyles(brand);\n\n const defaultPageStyle = {\n padding: 36,\n fontFamily: \"Helvetica\",\n backgroundColor: brand.colors.surface ?? \"#ffffff\",\n fontSize: 10,\n color: brand.colors.ink,\n };\n const mergedPageStyle = { ...defaultPageStyle, ...pageStyle };\n\n return (\n <Page size={size} style={mergedPageStyle}>\n <ExportHeaderPdf\n brand={brand}\n title={title}\n toolLabel={toolLabel}\n subtitle={subtitle}\n prominence={prominence}\n />\n <View style={styles.pageBody}>{children}</View>\n <ExportFooterPdf\n brand={brand}\n url={url}\n dateLabel={dateLabel}\n qrDataUrl={qrDataUrl}\n prominence={prominence}\n />\n </Page>\n );\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@digilogiclabs/platform-core",
3
- "version": "1.18.0",
3
+ "version": "1.20.0",
4
4
  "description": "Vendor-agnostic infrastructure abstraction layer for DLL Platform",
5
5
  "keywords": [
6
6
  "platform",
@@ -55,6 +55,11 @@
55
55
  "types": "./dist/agents.d.ts",
56
56
  "import": "./dist/agents.mjs",
57
57
  "require": "./dist/agents.js"
58
+ },
59
+ "./pdf-exports": {
60
+ "types": "./dist/pdf-exports/index.d.ts",
61
+ "import": "./dist/pdf-exports/index.mjs",
62
+ "require": "./dist/pdf-exports/index.js"
58
63
  }
59
64
  },
60
65
  "files": [
@@ -91,6 +96,11 @@
91
96
  "nodemailer": "^6.9.0",
92
97
  "pg": "^8.13.0",
93
98
  "resend": "^6.5.2",
99
+ "@react-pdf/renderer": "^4.0.0",
100
+ "qrcode": "^1.5.0",
101
+ "@types/qrcode": "^1.5.0",
102
+ "@types/react": "^19.0.0",
103
+ "react": "^19.0.0",
94
104
  "tsup": "^8.0.0",
95
105
  "typescript": "^5.7.0",
96
106
  "vitest": "^2.0.0"
@@ -118,7 +128,10 @@
118
128
  "ioredis": ">=5.0.0",
119
129
  "nodemailer": ">=6.0.0",
120
130
  "pg": ">=8.0.0",
121
- "resend": ">=2.0.0"
131
+ "resend": ">=2.0.0",
132
+ "@react-pdf/renderer": ">=4.0.0",
133
+ "qrcode": ">=1.5.0",
134
+ "react": "^18.2.0 || ^19.0.0"
122
135
  },
123
136
  "repository": {
124
137
  "type": "git",
@@ -194,6 +207,15 @@
194
207
  },
195
208
  "pg": {
196
209
  "optional": true
210
+ },
211
+ "@react-pdf/renderer": {
212
+ "optional": true
213
+ },
214
+ "qrcode": {
215
+ "optional": true
216
+ },
217
+ "react": {
218
+ "optional": true
197
219
  }
198
220
  },
199
221
  "scripts": {