Skip to content

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

2.5 KB
Raw Blame
// The React Native adapter: the app injects the Forme engine (packages/forme-native) and, through
// `configureFontReader`, a persistent font cache. That wrapper must fall back to the network on disk errors.
// No React Native import, so the package stays runtime-neutral. Configure readers once before rendering.
import type { ResumeRenderOptions } from "./context";
import type { FormeEngine } from "./forme/render";
import type { PageMap } from "./page-map";
import type { ResumeData } from "@reactive-resume/schema/resume/data";
import type { Template } from "@reactive-resume/schema/templates";
import { parseResumeData } from "@reactive-resume/schema/resume/data";
import { loadFonts } from "./forme/fonts";
import { assertPdfFonts, lostCharacters, renderResume, resumeFontRequests } from "./forme/render";

export type { ResumeRenderOptions } from "./context";
export type { FormeEngine } from "./forme/render";
export type { PageMap } from "./page-map";
export { configureFontReader, downloadFont } from "./forme/fonts";
export { configureImageFetch } from "./forme/images";

export type RenderResumePdfOptions = {
	data: ResumeData;
	template?: Template | undefined;
	renderOptions?: ResumeRenderOptions | undefined;
	/** Mobile resolves server-relative sources and decodes data URIs before streaming remote images. */
	readImage?: ((source: string) => Promise<Uint8Array>) | undefined;
	/** Receives the header, section and item boxes of this render (see `page-map.ts`). */
	onPageMap?: ((pageMap: PageMap) => void) | undefined;
	/** Receives characters no font could draw; not called when every character rendered. */
	onLostCharacters?: ((characters: string[]) => void) | undefined;
};

/** Same contract as `createResumePdfBlob` in `browser.tsx`, with the engine injected; resolves to PDF bytes. */
export const renderResumePdf = async (
	engine: FormeEngine,
	{ onPageMap, onLostCharacters, ...input }: RenderResumePdfOptions,
): Promise<Uint8Array> => {
	const data = parseResumeData(input.data);
	const result = await renderResume(engine, { ...input, data });
	assertPdfFonts(result);
	onPageMap?.(result.pageMap);
	const lost = lostCharacters(result.warnings);
	if (lost) onLostCharacters?.(lost);
	return result.pdf;
};

/** Warm the persistent/in-memory font caches before opening the Page tab. The native engine is already linked. */
export async function preloadResumePdf(data: ResumeData): Promise<void> {
	const { missing } = await loadFonts(resumeFontRequests(parseResumeData(data)));
	assertPdfFonts({ missingFonts: missing });
}