@voyantjs/utils 0.3.1 → 0.4.0

package/dist/index.d.ts

@@ -5,5 +5,7 @@ export * from "./kms.js";
 export * from "./kv.js";
 export * from "./languages.js";
 export * from "./localized-countries-regions.js";
+export * from "./pdf-renderer.js";
+export * from "./template-renderer.js";
 export * from "./timezones.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -5,5 +5,7 @@ export * from "./kms.js";
 export * from "./kv.js";
 export * from "./languages.js";
 export * from "./localized-countries-regions.js";
+export * from "./pdf-renderer.js";
+export * from "./template-renderer.js";
 export * from "./timezones.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kCAAkC,CAAA;AAChD,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA"}

package/dist/pdf-renderer.d.ts

@@ -0,0 +1,9 @@
+export type PdfContentFormat = "text" | "html" | "markdown" | "lexical_json";
+export interface RenderPdfDocumentInput {
+    title?: string | null;
+    content: string;
+    format?: PdfContentFormat;
+    metadataLines?: string[];
+}
+export declare function renderPdfDocument(input: RenderPdfDocumentInput): Promise<Uint8Array>;
+//# sourceMappingURL=pdf-renderer.d.ts.map

package/dist/pdf-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdf-renderer.d.ts","sourceRoot":"","sources":["../src/pdf-renderer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,cAAc,CAAA;AAE5E,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAwFD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiE1F"}

package/dist/pdf-renderer.js

@@ -0,0 +1,139 @@
+import { PDFDocument, rgb, StandardFonts } from "pdf-lib";
+function decodeEntities(input) {
+    return input
+        .replace(/ /gi, " ")
+        .replace(/&/gi, "&")
+        .replace(/&lt;/gi, "<")
+        .replace(/&gt;/gi, ">")
+        .replace(/&quot;/gi, '"')
+        .replace(/&#39;/gi, "'");
+}
+function stripHtml(input) {
+    return decodeEntities(input
+        .replace(/<\/(p|div|section|article|h[1-6]|li|tr)>/gi, "\n")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/[ \t]+\n/g, "\n"));
+}
+function stripMarkdown(input) {
+    return input
+        .replace(/^#{1,6}\s*/gm, "")
+        .replace(/[*_~`>#-]+/g, " ")
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+}
+function extractLexicalText(input) {
+    try {
+        const root = JSON.parse(input);
+        const parts = [];
+        const visit = (node) => {
+            if (!node || typeof node !== "object")
+                return;
+            if ("text" in node && typeof node.text === "string") {
+                parts.push(node.text);
+            }
+            if ("children" in node && Array.isArray(node.children)) {
+                for (const child of node.children)
+                    visit(child);
+                if (node.type === "paragraph") {
+                    parts.push("\n");
+                }
+            }
+        };
+        visit(root);
+        return parts.join(" ");
+    }
+    catch {
+        return input;
+    }
+}
+function normalizePdfText(input, format) {
+    const text = format === "html"
+        ? stripHtml(input)
+        : format === "markdown"
+            ? stripMarkdown(input)
+            : format === "lexical_json"
+                ? extractLexicalText(input)
+                : input;
+    return text
+        .replace(/\r\n/g, "\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .replace(/[ \t]{2,}/g, " ")
+        .trim();
+}
+function wrapLine(text, width, measure) {
+    const words = text.split(/\s+/).filter(Boolean);
+    const lines = [];
+    let current = "";
+    for (const word of words) {
+        const next = current ? `${current} ${word}` : word;
+        if (measure(next) <= width || !current) {
+            current = next;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines.length > 0 ? lines : [""];
+}
+export async function renderPdfDocument(input) {
+    const pdfDoc = await PDFDocument.create();
+    const font = await pdfDoc.embedFont(StandardFonts.Helvetica);
+    const bold = await pdfDoc.embedFont(StandardFonts.HelveticaBold);
+    const PAGE_WIDTH = 595.28;
+    const PAGE_HEIGHT = 841.89;
+    const MARGIN = 48;
+    const TITLE_SIZE = 18;
+    const BODY_SIZE = 10;
+    const LINE_HEIGHT = 14;
+    const bodyWidth = PAGE_WIDTH - MARGIN * 2;
+    const measure = (value) => font.widthOfTextAtSize(value, BODY_SIZE);
+    let page = pdfDoc.addPage([PAGE_WIDTH, PAGE_HEIGHT]);
+    let y = PAGE_HEIGHT - MARGIN;
+    const ensureSpace = (needed) => {
+        if (y - needed < MARGIN) {
+            page = pdfDoc.addPage([PAGE_WIDTH, PAGE_HEIGHT]);
+            y = PAGE_HEIGHT - MARGIN;
+        }
+    };
+    const drawLine = (text, options) => {
+        const size = options?.size ?? BODY_SIZE;
+        ensureSpace(LINE_HEIGHT);
+        page.drawText(text, {
+            x: MARGIN,
+            y,
+            size,
+            font: options?.bold ? bold : font,
+            color: rgb(0.12, 0.12, 0.12),
+        });
+        y -= LINE_HEIGHT;
+    };
+    const title = input.title?.trim();
+    if (title) {
+        drawLine(title, { bold: true, size: TITLE_SIZE });
+        y -= 6;
+    }
+    for (const meta of input.metadataLines ?? []) {
+        const trimmed = meta.trim();
+        if (!trimmed)
+            continue;
+        for (const line of wrapLine(trimmed, bodyWidth, measure)) {
+            drawLine(line);
+        }
+    }
+    if ((input.metadataLines?.length ?? 0) > 0) {
+        y -= 6;
+    }
+    const normalized = normalizePdfText(input.content, input.format ?? "text");
+    for (const paragraph of normalized.split(/\n{2,}/)) {
+        const lines = paragraph.split("\n").flatMap((line) => wrapLine(line, bodyWidth, measure));
+        for (const line of lines) {
+            drawLine(line);
+        }
+        y -= 4;
+    }
+    return pdfDoc.save();
+}
+//# sourceMappingURL=pdf-renderer.js.map

package/dist/pdf-renderer.js.map

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

package/dist/template-renderer.d.ts

@@ -0,0 +1,5 @@
+export type StructuredTemplateBodyFormat = "html" | "markdown" | "lexical_json";
+export declare function renderMustacheTemplate(body: string, variables: Record<string, unknown>): string;
+export declare function renderStringTemplate(body: string, variables: Record<string, unknown>): string;
+export declare function renderStructuredTemplate(body: string, bodyFormat: StructuredTemplateBodyFormat, variables: Record<string, unknown>): string;
+//# sourceMappingURL=template-renderer.d.ts.map

package/dist/template-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-renderer.d.ts","sourceRoot":"","sources":["../src/template-renderer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,UAAU,GAAG,cAAc,CAAA;AAsD/E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAK/F;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAM7F;AAaD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,4BAA4B,EACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM,CA6BR"}

package/dist/template-renderer.js

@@ -0,0 +1,106 @@
+import { Liquid } from "liquidjs";
+const liquid = new Liquid({
+    strictFilters: false,
+    strictVariables: false,
+    jsTruthy: true,
+});
+liquid.registerFilter("json", (value) => JSON.stringify(value ?? null));
+function resolvePath(obj, path) {
+    if (obj === null || obj === undefined)
+        return undefined;
+    const segments = [];
+    const parts = path.split(".");
+    for (const part of parts) {
+        if (!part)
+            continue;
+        const indexMatches = [...part.matchAll(/([^[\]]+)|\[(\d+)\]/g)];
+        for (const match of indexMatches) {
+            if (match[1] !== undefined)
+                segments.push(match[1]);
+            else if (match[2] !== undefined)
+                segments.push(Number.parseInt(match[2], 10));
+        }
+    }
+    let current = obj;
+    for (const seg of segments) {
+        if (current === null || current === undefined)
+            return undefined;
+        if (typeof seg === "number") {
+            if (!Array.isArray(current))
+                return undefined;
+            current = current[seg];
+        }
+        else {
+            if (typeof current !== "object")
+                return undefined;
+            current = current[seg];
+        }
+    }
+    return current;
+}
+function stringifyValue(value) {
+    if (value === null || value === undefined)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return JSON.stringify(value);
+}
+const MUSTACHE_RE = /\{\{\s*([^}]+?)\s*\}\}/g;
+const LIQUID_CONTROL_RE = /\{%-?[\s\S]*?-?%\}/;
+const LIQUID_FILTER_RE = /\{\{[\s\S]*\|[\s\S]*\}\}/;
+export function renderMustacheTemplate(body, variables) {
+    return body.replace(MUSTACHE_RE, (_, path) => {
+        const resolved = resolvePath(variables, path.trim());
+        return stringifyValue(resolved);
+    });
+}
+function shouldUseLiquid(body) {
+    return LIQUID_CONTROL_RE.test(body) || LIQUID_FILTER_RE.test(body);
+}
+export function renderStringTemplate(body, variables) {
+    if (!shouldUseLiquid(body)) {
+        return renderMustacheTemplate(body, variables);
+    }
+    return liquid.parseAndRenderSync(body, variables);
+}
+function walkLexical(node, variables) {
+    const next = { ...node };
+    if (typeof next.text === "string") {
+        next.text = renderStringTemplate(next.text, variables);
+    }
+    if (Array.isArray(next.children)) {
+        next.children = next.children.map((child) => walkLexical(child, variables));
+    }
+    return next;
+}
+export function renderStructuredTemplate(body, bodyFormat, variables) {
+    if (bodyFormat === "lexical_json") {
+        try {
+            const parsed = JSON.parse(body);
+            if (Array.isArray(parsed)) {
+                return JSON.stringify(parsed.map((entry) => {
+                    if (entry && typeof entry === "object") {
+                        return walkLexical(entry, variables);
+                    }
+                    return entry;
+                }));
+            }
+            if (parsed && typeof parsed === "object") {
+                const obj = parsed;
+                if (obj.root && typeof obj.root === "object") {
+                    const result = { ...obj, root: walkLexical(obj.root, variables) };
+                    return JSON.stringify(result);
+                }
+                return JSON.stringify(walkLexical(obj, variables));
+            }
+            return body;
+        }
+        catch {
+            return renderStringTemplate(body, variables);
+        }
+    }
+    return renderStringTemplate(body, variables);
+}
+//# sourceMappingURL=template-renderer.js.map

package/dist/template-renderer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyantjs/utils",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "license": "FSL-1.1-Apache-2.0",
   "repository": {
     "type": "git",
@@ -61,6 +61,14 @@
     "./cache": {
       "types": "./dist/cache.d.ts",
       "import": "./dist/cache.js"
+    },
+    "./template-renderer": {
+      "types": "./dist/template-renderer.d.ts",
+      "import": "./dist/template-renderer.js"
+    },
+    "./pdf-renderer": {
+      "types": "./dist/pdf-renderer.d.ts",
+      "import": "./dist/pdf-renderer.js"
     }
   },
   "publishConfig": {
@@ -71,8 +79,10 @@
   ],
   "dependencies": {
     "drizzle-orm": "^0.45.2",
+    "liquidjs": "^10.24.0",
+    "pdf-lib": "^1.17.1",
     "zod": "^4.3.6",
-    "@voyantjs/types": "0.3.1"
+    "@voyantjs/types": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",