@emabuild/export 0.0.0-stage → 0.1.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,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ import { type BrowserOptions } from './browser.js';
2
+ import { type LocalizeImagesOptions } from './assets.js';
3
+ import { type ZipEntry } from './zip.js';
4
+ import { type ExportInput } from './input.js';
5
+ /** Options of {@link exportImage} */
6
+ export interface ExportImageOptions extends BrowserOptions {
7
+ /** Viewport width in CSS px (default 600) */
8
+ width?: number;
9
+ /** Viewport height in CSS px (default 800; the image height when `fullPage` is false) */
10
+ height?: number;
11
+ /** Capture the whole page instead of the viewport (default true) */
12
+ fullPage?: boolean;
13
+ /** Image format (default `png`) */
14
+ type?: 'png' | 'jpeg';
15
+ /** JPEG quality 0–100 (default 85; ignored for PNG) */
16
+ quality?: number;
17
+ /** Pixel density (default 2 = retina; use e.g. 0.5 for small thumbnails) */
18
+ deviceScaleFactor?: number;
19
+ /** Transparent background where the page has none (PNG only) */
20
+ omitBackground?: boolean;
21
+ }
22
+ /** Options of {@link exportPdf} */
23
+ export interface ExportPdfOptions extends BrowserOptions {
24
+ /** Paper format (default `A4`) */
25
+ format?: 'Letter' | 'Legal' | 'Tabloid' | 'Ledger' | 'A0' | 'A1' | 'A2' | 'A3' | 'A4' | 'A5' | 'A6' | string;
26
+ /** Print background colours and images (default true) */
27
+ printBackground?: boolean;
28
+ landscape?: boolean;
29
+ /** Page margins (CSS lengths, default 0) */
30
+ margin?: {
31
+ top?: string;
32
+ right?: string;
33
+ bottom?: string;
34
+ left?: string;
35
+ };
36
+ /** Rendering scale 0.1–2 (default 1) */
37
+ scale?: number;
38
+ /** CSS media type to emulate (default `screen`, so the PDF looks like the email) */
39
+ media?: 'screen' | 'print';
40
+ /** Use `@page` size from the CSS when present (default false) */
41
+ preferCSSPageSize?: boolean;
42
+ /** Viewport width used for layout before printing (default 800) */
43
+ width?: number;
44
+ }
45
+ /** Options of {@link exportZip} */
46
+ export interface ExportZipOptions extends LocalizeImagesOptions {
47
+ /** Download images and rewrite their URLs to relative paths (default true) */
48
+ fetchImages?: boolean;
49
+ /** Name of the HTML file in the archive (default `index.html`) */
50
+ htmlFileName?: string;
51
+ /** Extra files to add (e.g. a plain-text version) */
52
+ extraFiles?: ZipEntry[];
53
+ /** Called with images that could not be downloaded (they keep their remote URL) */
54
+ onImageError?: (failed: {
55
+ url: string;
56
+ error: string;
57
+ }[]) => void;
58
+ }
59
+ /**
60
+ * Render HTML (or a design) to a PNG/JPEG image with headless Chromium —
61
+ * e.g. a template thumbnail. Requires `playwright-core`.
62
+ *
63
+ * @returns Image bytes
64
+ */
65
+ export declare function exportImage(input: ExportInput, options?: ExportImageOptions): Promise<Uint8Array>;
66
+ /**
67
+ * Render HTML (or a design) to a PDF with headless Chromium. Requires
68
+ * `playwright-core`.
69
+ *
70
+ * @returns PDF bytes
71
+ */
72
+ export declare function exportPdf(input: ExportInput, options?: ExportPdfOptions): Promise<Uint8Array>;
73
+ /**
74
+ * Package HTML (or a design) as a ZIP: the HTML file plus every referenced
75
+ * image downloaded into `images/`, with the references rewritten to those
76
+ * relative paths. Images that fail to download keep their remote URL.
77
+ *
78
+ * @returns ZIP bytes
79
+ */
80
+ export declare function exportZip(input: ExportInput, options?: ExportZipOptions): Promise<Uint8Array>;
81
+ //# sourceMappingURL=export.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE3D,qCAAqC;AACrC,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACtB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,kCAAkC;IAClC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAC7G,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4CAA4C;IAC5C,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC;IACxB,mFAAmF;IACnF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,IAAI,CAAC;CACnE;AAKD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,UAAU,CAAC,CAqB3G;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAevG;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAWvG"}
package/dist/export.js ADDED
@@ -0,0 +1,73 @@
1
+ import { withPage } from './browser.js';
2
+ import { localizeImages } from './assets.js';
3
+ import { createZip } from './zip.js';
4
+ import { resolveHtml } from './input.js';
5
+ const clamp = (v, min, max) => Math.min(max, Math.max(min, v));
6
+ const toBytes = (b) => (b instanceof Uint8Array && b.constructor === Uint8Array ? b : new Uint8Array(b.buffer, b.byteOffset, b.byteLength));
7
+ /**
8
+ * Render HTML (or a design) to a PNG/JPEG image with headless Chromium —
9
+ * e.g. a template thumbnail. Requires `playwright-core`.
10
+ *
11
+ * @returns Image bytes
12
+ */
13
+ export async function exportImage(input, options = {}) {
14
+ const html = resolveHtml(input);
15
+ const { width = 600, height = 800, fullPage = true, type = 'png', quality, deviceScaleFactor = 2, omitBackground } = options;
16
+ return withPage(html, options, {
17
+ viewport: { width: Math.round(clamp(width, 1, 10_000)), height: Math.round(clamp(height, 1, 20_000)) },
18
+ deviceScaleFactor: clamp(deviceScaleFactor, 0.1, 4),
19
+ }, async (page, timeout) => {
20
+ const shot = await page.screenshot({
21
+ type,
22
+ fullPage,
23
+ timeout,
24
+ ...(type === 'jpeg' ? { quality: Math.round(clamp(quality ?? 85, 0, 100)) } : {}),
25
+ ...(type === 'png' && omitBackground ? { omitBackground: true } : {}),
26
+ });
27
+ return toBytes(shot);
28
+ });
29
+ }
30
+ /**
31
+ * Render HTML (or a design) to a PDF with headless Chromium. Requires
32
+ * `playwright-core`.
33
+ *
34
+ * @returns PDF bytes
35
+ */
36
+ export async function exportPdf(input, options = {}) {
37
+ const html = resolveHtml(input);
38
+ const { format = 'A4', printBackground = true, landscape = false, margin, scale = 1, media = 'screen', preferCSSPageSize = false, width = 800 } = options;
39
+ return withPage(html, options, { viewport: { width: Math.round(clamp(width, 1, 10_000)), height: 1000 } }, async (page) => {
40
+ await page.emulateMedia({ media });
41
+ const pdf = await page.pdf({
42
+ format,
43
+ printBackground,
44
+ landscape,
45
+ margin: { top: '0', right: '0', bottom: '0', left: '0', ...margin },
46
+ scale: clamp(scale, 0.1, 2),
47
+ preferCSSPageSize,
48
+ });
49
+ return toBytes(pdf);
50
+ });
51
+ }
52
+ /**
53
+ * Package HTML (or a design) as a ZIP: the HTML file plus every referenced
54
+ * image downloaded into `images/`, with the references rewritten to those
55
+ * relative paths. Images that fail to download keep their remote URL.
56
+ *
57
+ * @returns ZIP bytes
58
+ */
59
+ export async function exportZip(input, options = {}) {
60
+ let html = resolveHtml(input);
61
+ const { fetchImages = true, htmlFileName = 'index.html', extraFiles = [], onImageError, ...localize } = options;
62
+ const entries = [];
63
+ if (fetchImages) {
64
+ const result = await localizeImages(html, localize);
65
+ html = result.html;
66
+ for (const asset of result.assets)
67
+ entries.push({ name: asset.path, data: asset.data });
68
+ if (result.failed.length)
69
+ onImageError?.(result.failed);
70
+ }
71
+ return createZip([{ name: htmlFileName, data: html }, ...entries, ...extraFiles]);
72
+ }
73
+ //# sourceMappingURL=export.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"export.js","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,cAAc,EAA8B,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAC;AAmD3D,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,GAAW,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACvF,MAAM,OAAO,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,UAAU,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAExJ;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAkB,EAAE,UAA8B,EAAE;IACpF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,GAAG,KAAK,EAAE,OAAO,EAAE,iBAAiB,GAAG,CAAC,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAC7H,OAAO,QAAQ,CACb,IAAI,EACJ,OAAO,EACP;QACE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE;QACtG,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;KACpD,EACD,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC;YACjC,IAAI;YACJ,QAAQ;YACR,OAAO;YACP,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAkB,EAAE,UAA4B,EAAE;IAChF,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,eAAe,GAAG,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,EAAE,iBAAiB,GAAG,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAC1J,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACxH,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;YACzB,MAAM;YACN,eAAe;YACf,SAAS;YACT,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE;YACnE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3B,iBAAiB;SAClB,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAkB,EAAE,UAA4B,EAAE;IAChF,IAAI,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,YAAY,GAAG,YAAY,EAAE,UAAU,GAAG,EAAE,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IAChH,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACxF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM;YAAE,YAAY,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC;AACpF,CAAC"}
@@ -0,0 +1,65 @@
1
+ import type { EmailDesign } from '@emabuild/types';
2
+ import { type BrowserOptions } from './browser.js';
3
+ import { type ExportImageOptions, type ExportPdfOptions, type ExportZipOptions } from './export.js';
4
+ import type { ToolRendererFn } from './input.js';
5
+ /** Export kinds served by {@link createExportHandler} */
6
+ export type ExportKind = 'image' | 'pdf' | 'zip';
7
+ /** Options of {@link createExportHandler} */
8
+ export interface ExportHandlerOptions {
9
+ /** Route prefix: routes are `POST {basePath}/image|pdf|zip` (default `/export`; `''` matches any prefix) */
10
+ basePath?: string;
11
+ /** Allowed CORS origins: "*", one origin, a list, or false (default: no CORS headers) */
12
+ cors?: string | string[] | false;
13
+ /** Return false to reject with 401 */
14
+ authorize?: (req: Request) => boolean | Promise<boolean>;
15
+ /** Maximum request body size in bytes (default 5 MB) */
16
+ maxBodyBytes?: number;
17
+ /** Server-side defaults for image exports (clients may override width/height/type/quality/fullPage/deviceScaleFactor) */
18
+ image?: Partial<ExportImageOptions>;
19
+ /** Server-side defaults for PDF exports (clients may override format/landscape/printBackground/scale) */
20
+ pdf?: Partial<ExportPdfOptions>;
21
+ /** Server-side defaults for ZIP exports (clients may override fetchImages) */
22
+ zip?: Partial<ExportZipOptions>;
23
+ /** Browser launch settings (one browser is launched lazily and shared; see `close()`) */
24
+ browser?: Pick<BrowserOptions, 'browser' | 'chromium' | 'launchOptions' | 'executablePath' | 'timeout'>;
25
+ /**
26
+ * Let exported HTML reach private / loopback hosts (images, fonts, page
27
+ * requests). Default false: the HTML comes from clients, so internal
28
+ * addresses are blocked (SSRF protection).
29
+ */
30
+ allowPrivateNetwork?: boolean;
31
+ /** Tool renderers: when set, requests may send `{ design }` instead of `{ html }` */
32
+ toolRenderers?: Map<string, ToolRendererFn>;
33
+ /** Maximum concurrent browser exports (default 4; others wait) */
34
+ maxConcurrency?: number;
35
+ /** Logging hook for unexpected errors */
36
+ onError?: (error: unknown) => void;
37
+ }
38
+ /** The handler returned by {@link createExportHandler} */
39
+ export interface ExportHandler {
40
+ (req: Request): Promise<Response>;
41
+ /** Close the shared browser (if one was launched) */
42
+ close(): Promise<void>;
43
+ }
44
+ /** JSON body accepted by the handler */
45
+ export interface ExportRequestBody {
46
+ html?: string;
47
+ design?: EmailDesign;
48
+ /** Per-request options (whitelisted and clamped) */
49
+ options?: Record<string, unknown>;
50
+ /** Download file name without extension (default `email`) */
51
+ filename?: string;
52
+ }
53
+ /**
54
+ * Create a Web Fetch handler for server-side exports:
55
+ *
56
+ * - `POST {basePath}/image` → PNG/JPEG (`image/png` | `image/jpeg`)
57
+ * - `POST {basePath}/pdf` → `application/pdf`
58
+ * - `POST {basePath}/zip` → `application/zip` (HTML + images)
59
+ *
60
+ * Body: `{ html, options?, filename? }` (or `{ design }` when `toolRenderers`
61
+ * is configured). Works on Node 18+, Bun, Deno, Next.js, Hono…; use
62
+ * `toNodeHandler` for `node:http` / Express.
63
+ */
64
+ export declare function createExportHandler(options?: ExportHandlerOptions): ExportHandler;
65
+ //# sourceMappingURL=handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAA4D,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7G,OAAO,EAAqC,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,WAAW,oBAAoB;IACnC,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IACjC,sCAAsC;IACtC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yHAAyH;IACzH,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,yGAAyG;IACzG,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChC,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChC,yFAAyF;IACzF,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACxG;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qFAAqF;IACrF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4DD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAyIrF"}
@@ -0,0 +1,208 @@
1
+ import { BrowserUnavailableError, launchBrowser } from './browser.js';
2
+ import { exportImage, exportPdf, exportZip } from './export.js';
3
+ import { allowPublicHttp, isPrivateHost } from './net.js';
4
+ import { corsHeaders } from '@emabuild/shared';
5
+ const DEFAULT_MAX_BODY = 5 * 1024 * 1024;
6
+ const PDF_FORMATS = new Set(['Letter', 'Legal', 'Tabloid', 'Ledger', 'A0', 'A1', 'A2', 'A3', 'A4', 'A5', 'A6']);
7
+ function json(status, body, headers) {
8
+ return new Response(JSON.stringify(body), { status, headers: { ...headers, 'content-type': 'application/json; charset=utf-8' } });
9
+ }
10
+ const num = (v, min, max) => typeof v === 'number' && Number.isFinite(v) ? Math.min(max, Math.max(min, v)) : undefined;
11
+ const bool = (v) => (typeof v === 'boolean' ? v : undefined);
12
+ const defined = (o) => Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
13
+ /** Whitelist + clamp the client options for a kind */
14
+ function clientOptions(kind, o = {}) {
15
+ if (kind === 'image') {
16
+ return defined({
17
+ width: num(o.width, 100, 2000),
18
+ height: num(o.height, 100, 4000),
19
+ fullPage: bool(o.fullPage),
20
+ type: o.type === 'jpeg' || o.type === 'png' ? o.type : undefined,
21
+ quality: num(o.quality, 1, 100),
22
+ deviceScaleFactor: num(o.deviceScaleFactor, 0.25, 3),
23
+ });
24
+ }
25
+ if (kind === 'pdf') {
26
+ return defined({
27
+ format: typeof o.format === 'string' && PDF_FORMATS.has(o.format) ? o.format : undefined,
28
+ landscape: bool(o.landscape),
29
+ printBackground: bool(o.printBackground),
30
+ scale: num(o.scale, 0.1, 2),
31
+ });
32
+ }
33
+ return defined({ fetchImages: bool(o.fetchImages) });
34
+ }
35
+ function safeFilename(name) {
36
+ const base = typeof name === 'string' ? name.replace(/\.[a-z0-9]+$/i, '').replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^[-.]+|-+$/g, '').slice(0, 80) : '';
37
+ return base || 'email';
38
+ }
39
+ /** A tiny counting semaphore */
40
+ function semaphore(size) {
41
+ let active = 0;
42
+ const queue = [];
43
+ return async (fn) => {
44
+ if (active >= size)
45
+ await new Promise((resolve) => queue.push(resolve));
46
+ active++;
47
+ try {
48
+ return await fn();
49
+ }
50
+ finally {
51
+ active--;
52
+ queue.shift()?.();
53
+ }
54
+ };
55
+ }
56
+ /**
57
+ * Create a Web Fetch handler for server-side exports:
58
+ *
59
+ * - `POST {basePath}/image` → PNG/JPEG (`image/png` | `image/jpeg`)
60
+ * - `POST {basePath}/pdf` → `application/pdf`
61
+ * - `POST {basePath}/zip` → `application/zip` (HTML + images)
62
+ *
63
+ * Body: `{ html, options?, filename? }` (or `{ design }` when `toolRenderers`
64
+ * is configured). Works on Node 18+, Bun, Deno, Next.js, Hono…; use
65
+ * `toNodeHandler` for `node:http` / Express.
66
+ */
67
+ export function createExportHandler(options = {}) {
68
+ const { basePath = '/export', cors = false, authorize, maxBodyBytes = DEFAULT_MAX_BODY, allowPrivateNetwork = false, toolRenderers, maxConcurrency = 4, onError, } = options;
69
+ const prefix = basePath.replace(/\/+$/, '');
70
+ const limit = semaphore(Math.max(1, maxConcurrency));
71
+ let shared = null;
72
+ const getBrowser = async () => {
73
+ if (options.browser?.browser)
74
+ return options.browser.browser;
75
+ if (shared) {
76
+ const b = await shared.catch(() => null);
77
+ if (b && (b.isConnected?.() ?? true))
78
+ return b;
79
+ }
80
+ shared = launchBrowser(options.browser ?? {});
81
+ shared.catch(() => {
82
+ shared = null;
83
+ });
84
+ return shared;
85
+ };
86
+ const allowRequest = allowPrivateNetwork
87
+ ? undefined
88
+ : (url) => {
89
+ try {
90
+ const u = new URL(url);
91
+ if (u.protocol === 'data:' || u.protocol === 'about:')
92
+ return true;
93
+ return (u.protocol === 'http:' || u.protocol === 'https:') && !isPrivateHost(u.hostname);
94
+ }
95
+ catch {
96
+ return false;
97
+ }
98
+ };
99
+ const handler = (async (req) => {
100
+ const ch = corsHeaders(req, cors, { expose: ['content-disposition'] });
101
+ const pathname = new URL(req.url).pathname.replace(/\/+$/, '');
102
+ const m = pathname.match(/\/(image|pdf|zip)$/);
103
+ const kind = m && (prefix === '' || pathname === `${prefix}/${m[1]}`) ? m[1] : null;
104
+ if (!kind)
105
+ return json(404, { error: 'Not found' }, ch);
106
+ if (req.method === 'OPTIONS')
107
+ return new Response(null, { status: 204, headers: ch });
108
+ if (req.method !== 'POST')
109
+ return json(405, { error: 'Method not allowed' }, { ...ch, allow: 'POST, OPTIONS' });
110
+ try {
111
+ if (authorize && !(await authorize(req)))
112
+ return json(401, { error: 'Unauthorized' }, ch);
113
+ }
114
+ catch (err) {
115
+ onError?.(err);
116
+ return json(401, { error: 'Unauthorized' }, ch);
117
+ }
118
+ if (Number(req.headers.get('content-length') ?? '0') > maxBodyBytes)
119
+ return json(413, { error: 'Request body too large' }, ch);
120
+ let text;
121
+ try {
122
+ text = await req.text();
123
+ }
124
+ catch {
125
+ return json(400, { error: 'Could not read request body' }, ch);
126
+ }
127
+ if (new TextEncoder().encode(text).length > maxBodyBytes)
128
+ return json(413, { error: 'Request body too large' }, ch);
129
+ let body;
130
+ try {
131
+ body = JSON.parse(text);
132
+ }
133
+ catch {
134
+ return json(400, { error: 'Body must be valid JSON' }, ch);
135
+ }
136
+ if (!body || typeof body !== 'object' || Array.isArray(body))
137
+ return json(400, { error: 'Body must be a JSON object' }, ch);
138
+ if (body.options !== undefined && (typeof body.options !== 'object' || body.options === null || Array.isArray(body.options))) {
139
+ return json(400, { error: '`options` must be an object' }, ch);
140
+ }
141
+ let input;
142
+ if (typeof body.html === 'string' && body.html.trim())
143
+ input = body.html;
144
+ else if (body.design && toolRenderers) {
145
+ const d = body.design;
146
+ if (!d.body || !Array.isArray(d.body.rows))
147
+ return json(400, { error: '`design` must be an EmailDesign with body.rows' }, ch);
148
+ input = { design: body.design, toolRenderers };
149
+ }
150
+ else {
151
+ return json(400, { error: toolRenderers ? '`html` (string) or `design` is required' : '`html` must be a non-empty string' }, ch);
152
+ }
153
+ const filename = safeFilename(body.filename);
154
+ const client = clientOptions(kind, body.options);
155
+ try {
156
+ let data;
157
+ let type;
158
+ let ext;
159
+ if (kind === 'zip') {
160
+ data = await exportZip(input, {
161
+ ...(allowPrivateNetwork ? {} : { allowUrl: allowPublicHttp }),
162
+ ...options.zip,
163
+ ...client,
164
+ });
165
+ type = 'application/zip';
166
+ ext = 'zip';
167
+ }
168
+ else {
169
+ const browserOpts = { ...options.browser, browser: await getBrowser(), ...(allowRequest ? { allowRequest } : {}) };
170
+ if (kind === 'image') {
171
+ const opts = { ...browserOpts, ...options.image, ...client };
172
+ data = await limit(() => exportImage(input, opts));
173
+ type = opts.type === 'jpeg' ? 'image/jpeg' : 'image/png';
174
+ ext = opts.type === 'jpeg' ? 'jpg' : 'png';
175
+ }
176
+ else {
177
+ data = await limit(() => exportPdf(input, { ...browserOpts, ...options.pdf, ...client }));
178
+ type = 'application/pdf';
179
+ ext = 'pdf';
180
+ }
181
+ }
182
+ return new Response(data, {
183
+ status: 200,
184
+ headers: {
185
+ ...ch,
186
+ 'content-type': type,
187
+ 'content-length': String(data.byteLength),
188
+ 'content-disposition': `attachment; filename="${filename}.${ext}"`,
189
+ 'cache-control': 'no-store',
190
+ },
191
+ });
192
+ }
193
+ catch (err) {
194
+ onError?.(err);
195
+ if (err instanceof BrowserUnavailableError)
196
+ return json(501, { error: err.message }, ch);
197
+ return json(500, { error: 'Export failed' }, ch);
198
+ }
199
+ });
200
+ handler.close = async () => {
201
+ const pending = shared;
202
+ shared = null;
203
+ if (pending)
204
+ await (await pending.catch(() => null))?.close().catch(() => undefined);
205
+ };
206
+ return handler;
207
+ }
208
+ //# sourceMappingURL=handler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @emabuild/export — server-side export of emabuild designs / email HTML to
3
+ * images (PNG/JPEG thumbnails), PDF and ZIP (HTML + downloaded images).
4
+ *
5
+ * Image and PDF export use headless Chromium through the optional peer
6
+ * dependency `playwright-core`; the ZIP export has no dependencies.
7
+ */
8
+ export { exportImage, exportPdf, exportZip, type ExportImageOptions, type ExportPdfOptions, type ExportZipOptions, } from './export.js';
9
+ export { createExportHandler, type ExportHandler, type ExportHandlerOptions, type ExportKind, type ExportRequestBody, } from './handler.js';
10
+ export { toNodeHandler, type FetchHandler, type NodeHandler } from '@emabuild/shared/node';
11
+ export { localizeImages, type LocalizeImagesOptions, type LocalizedHtml, type LocalAsset } from './assets.js';
12
+ export { createZip, readZip, crc32, type ZipEntry, type ZipFile } from './zip.js';
13
+ export { launchBrowser, loadChromium, BrowserUnavailableError, type BrowserOptions, type BrowserLike, type ChromiumLike, type PageLike, type BrowserContextLike, type RouteLike, } from './browser.js';
14
+ export { isPrivateHost, allowHttp, allowPublicHttp, fetchWithPolicy, type UrlPolicy, type PolicyFetchOptions } from './net.js';
15
+ export { resolveHtml, type ExportInput, type DesignInput, type ToolRendererFn } from './input.js';
16
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC/H,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @emabuild/export — server-side export of emabuild designs / email HTML to
3
+ * images (PNG/JPEG thumbnails), PDF and ZIP (HTML + downloaded images).
4
+ *
5
+ * Image and PDF export use headless Chromium through the optional peer
6
+ * dependency `playwright-core`; the ZIP export has no dependencies.
7
+ */
8
+ export { exportImage, exportPdf, exportZip, } from './export.js';
9
+ export { createExportHandler, } from './handler.js';
10
+ export { toNodeHandler } from '@emabuild/shared/node';
11
+ export { localizeImages } from './assets.js';
12
+ export { createZip, readZip, crc32 } from './zip.js';
13
+ export { launchBrowser, loadChromium, BrowserUnavailableError, } from './browser.js';
14
+ export { isPrivateHost, allowHttp, allowPublicHttp, fetchWithPolicy } from './net.js';
15
+ export { resolveHtml } from './input.js';
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,GAIV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,mBAAmB,GAKpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAuC,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,cAAc,EAAmE,MAAM,aAAa,CAAC;AAC9G,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAA+B,MAAM,UAAU,CAAC;AAClF,OAAO,EACL,aAAa,EACb,YAAY,EACZ,uBAAuB,GAOxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAA2C,MAAM,UAAU,CAAC;AAC/H,OAAO,EAAE,WAAW,EAA2D,MAAM,YAAY,CAAC"}
@@ -0,0 +1,23 @@
1
+ import type { EmailDesign } from '@emabuild/types';
2
+ import { type RenderOptions } from '@emabuild/email-renderer';
3
+ /** A tool renderer (tool name → `renderHtml`), as used by `@emabuild/email-renderer` */
4
+ export type ToolRendererFn = (values: Record<string, unknown>, ctx: any) => string;
5
+ /** A design plus what is needed to render it */
6
+ export interface DesignInput {
7
+ design: EmailDesign;
8
+ /** Tool name → HTML render function (the same map the editor/renderer uses) */
9
+ toolRenderers: Map<string, ToolRendererFn>;
10
+ /** Renderer options (`displayMode: 'web'`, merge tags, minify, …) */
11
+ options?: RenderOptions;
12
+ }
13
+ /**
14
+ * What the export functions accept: an HTML string, anything with an `html`
15
+ * string (e.g. an `ExportResult` from `exportHtml`), or a design with its
16
+ * tool renderers.
17
+ */
18
+ export type ExportInput = string | {
19
+ html: string;
20
+ } | DesignInput;
21
+ /** Turn an {@link ExportInput} into an HTML document */
22
+ export declare function resolveHtml(input: ExportInput): string;
23
+ //# sourceMappingURL=input.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAElF,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;AAEnF,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,+EAA+E;IAC/E,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,qEAAqE;IACrE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAAC;AAElE,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAQtD"}
package/dist/input.js ADDED
@@ -0,0 +1,15 @@
1
+ import { renderDesignToHtml } from '@emabuild/email-renderer';
2
+ /** Turn an {@link ExportInput} into an HTML document */
3
+ export function resolveHtml(input) {
4
+ if (typeof input === 'string')
5
+ return input;
6
+ if (input && typeof input === 'object') {
7
+ if (typeof input.html === 'string')
8
+ return input.html;
9
+ const d = input;
10
+ if (d.design && d.toolRenderers instanceof Map)
11
+ return renderDesignToHtml(d.design, d.toolRenderers, d.options).html;
12
+ }
13
+ throw new TypeError('Export input must be an HTML string, { html }, or { design, toolRenderers }');
14
+ }
15
+ //# sourceMappingURL=input.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AAqBlF,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAQ,KAA0B,CAAC,IAAI,CAAC;QACpG,MAAM,CAAC,GAAG,KAAoB,CAAC;QAC/B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,YAAY,GAAG;YAAE,OAAO,kBAAkB,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACvH,CAAC;IACD,MAAM,IAAI,SAAS,CAAC,6EAA6E,CAAC,CAAC;AACrG,CAAC"}
package/dist/net.d.ts ADDED
@@ -0,0 +1,42 @@
1
+ /**
2
+ * @module net
3
+ *
4
+ * URL policy helpers. Exports driven by untrusted HTML (e.g. the HTTP
5
+ * handler) must not let the server reach internal hosts; these checks block
6
+ * literal private / loopback / link-local addresses and `localhost`.
7
+ * They do not resolve DNS — put the export service behind an egress proxy
8
+ * if names may resolve to internal addresses.
9
+ */
10
+ /** Decides whether a URL may be requested */
11
+ export type UrlPolicy = (url: URL) => boolean | Promise<boolean>;
12
+ /**
13
+ * Whether a hostname is local or a literal private address (loopback,
14
+ * RFC 1918, link-local, CGNAT, ULA, multicast, `localhost`, `*.local`,
15
+ * `*.internal`).
16
+ */
17
+ export declare function isPrivateHost(hostname: string): boolean;
18
+ /** Allows http(s) URLs only */
19
+ export declare const allowHttp: UrlPolicy;
20
+ /** Allows public http(s) URLs only (see {@link isPrivateHost}) */
21
+ export declare const allowPublicHttp: UrlPolicy;
22
+ /** Options of {@link fetchWithPolicy} */
23
+ export interface PolicyFetchOptions {
24
+ fetch?: typeof fetch;
25
+ allowUrl?: UrlPolicy;
26
+ timeoutMs?: number;
27
+ maxBytes?: number;
28
+ maxRedirects?: number;
29
+ headers?: Record<string, string>;
30
+ }
31
+ /**
32
+ * GET a URL, following redirects manually so that every hop is checked
33
+ * against `allowUrl`, with a timeout and a response size limit.
34
+ *
35
+ * @returns Body bytes and content type
36
+ */
37
+ export declare function fetchWithPolicy(url: string, { fetch: fetchFn, allowUrl, timeoutMs, maxBytes, maxRedirects, headers }?: PolicyFetchOptions): Promise<{
38
+ data: Uint8Array;
39
+ contentType: string;
40
+ url: string;
41
+ }>;
42
+ //# sourceMappingURL=net.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../src/net.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6CAA6C;AAC7C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAmBjE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAgBvD;AAED,+BAA+B;AAC/B,eAAO,MAAM,SAAS,EAAE,SAA0E,CAAC;AAEnG,kEAAkE;AAClE,eAAO,MAAM,eAAe,EAAE,SAAmE,CAAC;AAElG,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,EAAE,KAAK,EAAE,OAA0B,EAAE,QAAoB,EAAE,SAAkB,EAAE,QAA2B,EAAE,YAAgB,EAAE,OAAO,EAAE,GAAE,kBAAuB,GAC/J,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBjE"}