@studious-lms/server 1.23.0 → 1.25.0

package/dist/lib/idCardPdf.d.ts

@@ -0,0 +1,26 @@
+import { type RGB } from "pdf-lib";
+/** CR80 ID card size in PDF points (3.375" × 2.125"). */
+export declare const ID_CARD_WIDTH = 243;
+export declare const ID_CARD_HEIGHT = 153;
+export declare const DEFAULT_BRAND_COLOR = "#1E3A5F";
+export type IdCardStudent = {
+    displayName: string;
+    username: string;
+    /** Class / grade label, e.g. "Grade 5 · Section A". */
+    classLabel: string | null;
+    /** Hex accent from class/department branding when available. */
+    brandColor: string | null;
+    profilePictureUrl: string | null;
+};
+export type IdCardSchool = {
+    name: string;
+    logoPath: string | null;
+};
+export declare function parseHexColor(hex: string | null | undefined): RGB;
+/** Convert arbitrary image bytes (incl. SVG/WebP) to PNG for pdf-lib. */
+export declare function toPngBytes(input: Buffer): Promise<Uint8Array | null>;
+/**
+ * Build a multi-page PDF: one CR80 front-side ID card per student.
+ */
+export declare function buildIdCardsPdf(school: IdCardSchool, students: IdCardStudent[]): Promise<Uint8Array>;
+//# sourceMappingURL=idCardPdf.d.ts.map

package/dist/lib/idCardPdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idCardPdf.d.ts","sourceRoot":"/","sources":["lib/idCardPdf.ts"],"names":[],"mappings":"AAMA,OAAO,EAOL,KAAK,GAAG,EACT,MAAM,SAAS,CAAC;AAIjB,yDAAyD;AACzD,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,cAAc,MAAM,CAAC;AAElC,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AASF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,GAAG,CAMjE;AAoDD,yEAAyE;AACzE,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQ1E;AA8LD;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,UAAU,CAAC,CA0BrB"}

package/dist/lib/idCardPdf.js

@@ -0,0 +1,272 @@
+/**
+ * Student ID card PDF generation (front-side, CR80) via pdf-lib.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="77a2e4ef-b728-5a9e-85eb-71bd3525a454")}catch(e){}}();
+import fontkit from "@pdf-lib/fontkit";
+import { readFileSync } from "fs";
+import { join } from "path";
+import { PDFDocument, StandardFonts, rgb, } from "pdf-lib";
+import sharp from "sharp";
+import { logger } from "../utils/logger.js";
+/** CR80 ID card size in PDF points (3.375" × 2.125"). */
+export const ID_CARD_WIDTH = 243;
+export const ID_CARD_HEIGHT = 153;
+export const DEFAULT_BRAND_COLOR = "#1E3A5F";
+function hexToRgb(cleaned) {
+    const r = parseInt(cleaned.slice(0, 2), 16) / 255;
+    const g = parseInt(cleaned.slice(2, 4), 16) / 255;
+    const b = parseInt(cleaned.slice(4, 6), 16) / 255;
+    return rgb(r, g, b);
+}
+export function parseHexColor(hex) {
+    const fallback = hexToRgb(DEFAULT_BRAND_COLOR.replace(/^#/, ""));
+    if (!hex)
+        return fallback;
+    const cleaned = hex.trim().replace(/^#/, "");
+    if (!/^[0-9a-fA-F]{6}$/.test(cleaned))
+        return fallback;
+    return hexToRgb(cleaned);
+}
+function contrastTextColor(bg) {
+    const luminance = 0.2126 * bg.red + 0.7152 * bg.green + 0.0722 * bg.blue;
+    return luminance > 0.55 ? rgb(0.1, 0.1, 0.1) : rgb(1, 1, 1);
+}
+async function loadFonts(pdfDoc) {
+    pdfDoc.registerFontkit(fontkit);
+    const fontDir = join(process.cwd(), "src", "lib");
+    try {
+        const regularBytes = readFileSync(join(fontDir, "NotoSans-Regular.ttf"));
+        const boldBytes = readFileSync(join(fontDir, "NotoSans-Bold.ttf"));
+        return {
+            regular: await pdfDoc.embedFont(regularBytes),
+            bold: await pdfDoc.embedFont(boldBytes),
+        };
+    }
+    catch (error) {
+        logger.warn(`idCardPdf: falling back to Helvetica fonts: ${error}`);
+        return {
+            regular: await pdfDoc.embedFont(StandardFonts.Helvetica),
+            bold: await pdfDoc.embedFont(StandardFonts.HelveticaBold),
+        };
+    }
+}
+async function fetchBytesFromUrl(url) {
+    try {
+        const response = await fetch(url);
+        if (!response.ok)
+            return null;
+        return Buffer.from(await response.arrayBuffer());
+    }
+    catch (error) {
+        logger.warn(`idCardPdf: failed to fetch image URL: ${error}`);
+        return null;
+    }
+}
+async function loadGcsBytes(path) {
+    try {
+        // Dynamic import keeps unit tests free of GCS/env bootstrap.
+        const { bucket } = await import("./googleCloudStorage.js");
+        const [bytes] = await bucket.file(path).download();
+        return Buffer.from(bytes);
+    }
+    catch (error) {
+        logger.warn(`idCardPdf: failed to download GCS object ${path}: ${error}`);
+        return null;
+    }
+}
+/** Convert arbitrary image bytes (incl. SVG/WebP) to PNG for pdf-lib. */
+export async function toPngBytes(input) {
+    try {
+        const png = await sharp(input).rotate().png().toBuffer();
+        return new Uint8Array(png);
+    }
+    catch (error) {
+        logger.warn(`idCardPdf: sharp conversion failed: ${error}`);
+        return null;
+    }
+}
+async function embedImage(pdfDoc, bytes) {
+    if (!bytes || bytes.length === 0)
+        return null;
+    const png = await toPngBytes(bytes);
+    if (!png)
+        return null;
+    try {
+        return await pdfDoc.embedPng(png);
+    }
+    catch (error) {
+        logger.warn(`idCardPdf: embedPng failed: ${error}`);
+        return null;
+    }
+}
+function truncateToWidth(text, font, size, maxWidth) {
+    if (font.widthOfTextAtSize(text, size) <= maxWidth)
+        return text;
+    let truncated = text;
+    const ellipsis = "…";
+    while (truncated.length > 1 &&
+        font.widthOfTextAtSize(truncated + ellipsis, size) > maxWidth) {
+        truncated = truncated.slice(0, -1);
+    }
+    return truncated + ellipsis;
+}
+function drawCard(page, fonts, school, student, logo, photo) {
+    const brand = parseHexColor(student.brandColor ?? DEFAULT_BRAND_COLOR);
+    const onBrand = contrastTextColor(brand);
+    const muted = rgb(0.4, 0.45, 0.5);
+    const ink = rgb(0.12, 0.14, 0.18);
+    const border = rgb(0.85, 0.87, 0.9);
+    page.drawRectangle({
+        x: 0,
+        y: 0,
+        width: ID_CARD_WIDTH,
+        height: ID_CARD_HEIGHT,
+        color: rgb(1, 1, 1),
+    });
+    const headerH = 36;
+    page.drawRectangle({
+        x: 0,
+        y: ID_CARD_HEIGHT - headerH,
+        width: ID_CARD_WIDTH,
+        height: headerH,
+        color: brand,
+    });
+    page.drawRectangle({
+        x: 0,
+        y: 0,
+        width: ID_CARD_WIDTH,
+        height: 6,
+        color: brand,
+    });
+    page.drawRectangle({
+        x: 0.5,
+        y: 0.5,
+        width: ID_CARD_WIDTH - 1,
+        height: ID_CARD_HEIGHT - 1,
+        borderColor: border,
+        borderWidth: 0.75,
+    });
+    const logoSize = 22;
+    let schoolNameX = 12;
+    if (logo) {
+        const scale = Math.min(logoSize / logo.width, logoSize / logo.height);
+        const w = logo.width * scale;
+        const h = logo.height * scale;
+        page.drawImage(logo, {
+            x: 10,
+            y: ID_CARD_HEIGHT - headerH + (headerH - h) / 2,
+            width: w,
+            height: h,
+        });
+        schoolNameX = 10 + w + 8;
+    }
+    const schoolName = truncateToWidth(school.name, fonts.bold, 11, ID_CARD_WIDTH - schoolNameX - 10);
+    page.drawText(schoolName, {
+        x: schoolNameX,
+        y: ID_CARD_HEIGHT - headerH + 13,
+        size: 11,
+        font: fonts.bold,
+        color: onBrand,
+    });
+    const photoX = 12;
+    const photoY = 22;
+    const photoW = 64;
+    const photoH = 80;
+    page.drawRectangle({
+        x: photoX,
+        y: photoY,
+        width: photoW,
+        height: photoH,
+        color: rgb(0.94, 0.95, 0.97),
+        borderColor: border,
+        borderWidth: 0.5,
+    });
+    if (photo) {
+        const scale = Math.min(photoW / photo.width, photoH / photo.height);
+        const w = photo.width * scale;
+        const h = photo.height * scale;
+        page.drawImage(photo, {
+            x: photoX + (photoW - w) / 2,
+            y: photoY + (photoH - h) / 2,
+            width: w,
+            height: h,
+        });
+    }
+    else {
+        const initials = student.displayName
+            .split(/\s+/)
+            .filter(Boolean)
+            .slice(0, 2)
+            .map((p) => p[0]?.toUpperCase() ?? "")
+            .join("");
+        const initialsSize = 18;
+        const iw = fonts.bold.widthOfTextAtSize(initials || "?", initialsSize);
+        page.drawText(initials || "?", {
+            x: photoX + (photoW - iw) / 2,
+            y: photoY + photoH / 2 - initialsSize / 3,
+            size: initialsSize,
+            font: fonts.bold,
+            color: muted,
+        });
+    }
+    const textX = photoX + photoW + 12;
+    const maxTextW = ID_CARD_WIDTH - textX - 10;
+    let y = ID_CARD_HEIGHT - headerH - 22;
+    const drawField = (label, value, valueSize = 10) => {
+        page.drawText(label, {
+            x: textX,
+            y,
+            size: 7,
+            font: fonts.regular,
+            color: muted,
+        });
+        y -= 12;
+        const line = truncateToWidth(value, fonts.bold, valueSize, maxTextW);
+        page.drawText(line, {
+            x: textX,
+            y,
+            size: valueSize,
+            font: fonts.bold,
+            color: ink,
+        });
+        y -= 16;
+    };
+    drawField("Name", student.displayName || student.username, 11);
+    drawField("Student ID", student.username, 10);
+    drawField("Class / Grade", student.classLabel || "—", 9);
+    page.drawText("STUDENT", {
+        x: textX,
+        y: 14,
+        size: 7,
+        font: fonts.bold,
+        color: brand,
+    });
+}
+/**
+ * Build a multi-page PDF: one CR80 front-side ID card per student.
+ */
+export async function buildIdCardsPdf(school, students) {
+    if (students.length === 0) {
+        throw new Error("No students provided for ID card generation");
+    }
+    const pdfDoc = await PDFDocument.create();
+    const fonts = await loadFonts(pdfDoc);
+    let logoBytes = null;
+    if (school.logoPath) {
+        logoBytes = await loadGcsBytes(school.logoPath);
+    }
+    const logo = await embedImage(pdfDoc, logoBytes);
+    for (const student of students) {
+        let photoBytes = null;
+        if (student.profilePictureUrl) {
+            photoBytes = await fetchBytesFromUrl(student.profilePictureUrl);
+        }
+        const photo = await embedImage(pdfDoc, photoBytes);
+        const page = pdfDoc.addPage([ID_CARD_WIDTH, ID_CARD_HEIGHT]);
+        drawCard(page, fonts, school, student, logo, photo);
+    }
+    return pdfDoc.save();
+}
+//# sourceMappingURL=idCardPdf.js.map
+//# debugId=77a2e4ef-b728-5a9e-85eb-71bd3525a454

package/dist/lib/idCardPdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idCardPdf.js","sources":["lib/idCardPdf.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Student ID card PDF generation (front-side, CR80) via pdf-lib.\n */\nimport fontkit from \"@pdf-lib/fontkit\";\nimport { readFileSync } from \"fs\";\nimport { join } from \"path\";\nimport {\n  PDFDocument,\n  PDFFont,\n  PDFImage,\n  PDFPage,\n  StandardFonts,\n  rgb,\n  type RGB,\n} from \"pdf-lib\";\nimport sharp from \"sharp\";\nimport { logger } from \"../utils/logger.js\";\n\n/** CR80 ID card size in PDF points (3.375\" × 2.125\"). */\nexport const ID_CARD_WIDTH = 243;\nexport const ID_CARD_HEIGHT = 153;\n\nexport const DEFAULT_BRAND_COLOR = \"#1E3A5F\";\n\nexport type IdCardStudent = {\n  displayName: string;\n  username: string;\n  /** Class / grade label, e.g. \"Grade 5 · Section A\". */\n  classLabel: string | null;\n  /** Hex accent from class/department branding when available. */\n  brandColor: string | null;\n  profilePictureUrl: string | null;\n};\n\nexport type IdCardSchool = {\n  name: string;\n  logoPath: string | null;\n};\n\nfunction hexToRgb(cleaned: string): RGB {\n  const r = parseInt(cleaned.slice(0, 2), 16) / 255;\n  const g = parseInt(cleaned.slice(2, 4), 16) / 255;\n  const b = parseInt(cleaned.slice(4, 6), 16) / 255;\n  return rgb(r, g, b);\n}\n\nexport function parseHexColor(hex: string | null | undefined): RGB {\n  const fallback = hexToRgb(DEFAULT_BRAND_COLOR.replace(/^#/, \"\"));\n  if (!hex) return fallback;\n  const cleaned = hex.trim().replace(/^#/, \"\");\n  if (!/^[0-9a-fA-F]{6}$/.test(cleaned)) return fallback;\n  return hexToRgb(cleaned);\n}\n\nfunction contrastTextColor(bg: RGB): RGB {\n  const luminance = 0.2126 * bg.red + 0.7152 * bg.green + 0.0722 * bg.blue;\n  return luminance > 0.55 ? rgb(0.1, 0.1, 0.1) : rgb(1, 1, 1);\n}\n\nasync function loadFonts(pdfDoc: PDFDocument): Promise<{\n  regular: PDFFont;\n  bold: PDFFont;\n}> {\n  pdfDoc.registerFontkit(fontkit);\n  const fontDir = join(process.cwd(), \"src\", \"lib\");\n  try {\n    const regularBytes = readFileSync(join(fontDir, \"NotoSans-Regular.ttf\"));\n    const boldBytes = readFileSync(join(fontDir, \"NotoSans-Bold.ttf\"));\n    return {\n      regular: await pdfDoc.embedFont(regularBytes),\n      bold: await pdfDoc.embedFont(boldBytes),\n    };\n  } catch (error) {\n    logger.warn(`idCardPdf: falling back to Helvetica fonts: ${error}`);\n    return {\n      regular: await pdfDoc.embedFont(StandardFonts.Helvetica),\n      bold: await pdfDoc.embedFont(StandardFonts.HelveticaBold),\n    };\n  }\n}\n\nasync function fetchBytesFromUrl(url: string): Promise<Buffer | null> {\n  try {\n    const response = await fetch(url);\n    if (!response.ok) return null;\n    return Buffer.from(await response.arrayBuffer());\n  } catch (error) {\n    logger.warn(`idCardPdf: failed to fetch image URL: ${error}`);\n    return null;\n  }\n}\n\nasync function loadGcsBytes(path: string): Promise<Buffer | null> {\n  try {\n    // Dynamic import keeps unit tests free of GCS/env bootstrap.\n    const { bucket } = await import(\"./googleCloudStorage.js\");\n    const [bytes] = await bucket.file(path).download();\n    return Buffer.from(bytes);\n  } catch (error) {\n    logger.warn(`idCardPdf: failed to download GCS object ${path}: ${error}`);\n    return null;\n  }\n}\n\n/** Convert arbitrary image bytes (incl. SVG/WebP) to PNG for pdf-lib. */\nexport async function toPngBytes(input: Buffer): Promise<Uint8Array | null> {\n  try {\n    const png = await sharp(input).rotate().png().toBuffer();\n    return new Uint8Array(png);\n  } catch (error) {\n    logger.warn(`idCardPdf: sharp conversion failed: ${error}`);\n    return null;\n  }\n}\n\nasync function embedImage(\n  pdfDoc: PDFDocument,\n  bytes: Buffer | null\n): Promise<PDFImage | null> {\n  if (!bytes || bytes.length === 0) return null;\n  const png = await toPngBytes(bytes);\n  if (!png) return null;\n  try {\n    return await pdfDoc.embedPng(png);\n  } catch (error) {\n    logger.warn(`idCardPdf: embedPng failed: ${error}`);\n    return null;\n  }\n}\n\nfunction truncateToWidth(\n  text: string,\n  font: PDFFont,\n  size: number,\n  maxWidth: number\n): string {\n  if (font.widthOfTextAtSize(text, size) <= maxWidth) return text;\n  let truncated = text;\n  const ellipsis = \"…\";\n  while (\n    truncated.length > 1 &&\n    font.widthOfTextAtSize(truncated + ellipsis, size) > maxWidth\n  ) {\n    truncated = truncated.slice(0, -1);\n  }\n  return truncated + ellipsis;\n}\n\nfunction drawCard(\n  page: PDFPage,\n  fonts: { regular: PDFFont; bold: PDFFont },\n  school: IdCardSchool,\n  student: IdCardStudent,\n  logo: PDFImage | null,\n  photo: PDFImage | null\n) {\n  const brand = parseHexColor(student.brandColor ?? DEFAULT_BRAND_COLOR);\n  const onBrand = contrastTextColor(brand);\n  const muted = rgb(0.4, 0.45, 0.5);\n  const ink = rgb(0.12, 0.14, 0.18);\n  const border = rgb(0.85, 0.87, 0.9);\n\n  page.drawRectangle({\n    x: 0,\n    y: 0,\n    width: ID_CARD_WIDTH,\n    height: ID_CARD_HEIGHT,\n    color: rgb(1, 1, 1),\n  });\n\n  const headerH = 36;\n  page.drawRectangle({\n    x: 0,\n    y: ID_CARD_HEIGHT - headerH,\n    width: ID_CARD_WIDTH,\n    height: headerH,\n    color: brand,\n  });\n\n  page.drawRectangle({\n    x: 0,\n    y: 0,\n    width: ID_CARD_WIDTH,\n    height: 6,\n    color: brand,\n  });\n\n  page.drawRectangle({\n    x: 0.5,\n    y: 0.5,\n    width: ID_CARD_WIDTH - 1,\n    height: ID_CARD_HEIGHT - 1,\n    borderColor: border,\n    borderWidth: 0.75,\n  });\n\n  const logoSize = 22;\n  let schoolNameX = 12;\n  if (logo) {\n    const scale = Math.min(logoSize / logo.width, logoSize / logo.height);\n    const w = logo.width * scale;\n    const h = logo.height * scale;\n    page.drawImage(logo, {\n      x: 10,\n      y: ID_CARD_HEIGHT - headerH + (headerH - h) / 2,\n      width: w,\n      height: h,\n    });\n    schoolNameX = 10 + w + 8;\n  }\n\n  const schoolName = truncateToWidth(\n    school.name,\n    fonts.bold,\n    11,\n    ID_CARD_WIDTH - schoolNameX - 10\n  );\n  page.drawText(schoolName, {\n    x: schoolNameX,\n    y: ID_CARD_HEIGHT - headerH + 13,\n    size: 11,\n    font: fonts.bold,\n    color: onBrand,\n  });\n\n  const photoX = 12;\n  const photoY = 22;\n  const photoW = 64;\n  const photoH = 80;\n  page.drawRectangle({\n    x: photoX,\n    y: photoY,\n    width: photoW,\n    height: photoH,\n    color: rgb(0.94, 0.95, 0.97),\n    borderColor: border,\n    borderWidth: 0.5,\n  });\n  if (photo) {\n    const scale = Math.min(photoW / photo.width, photoH / photo.height);\n    const w = photo.width * scale;\n    const h = photo.height * scale;\n    page.drawImage(photo, {\n      x: photoX + (photoW - w) / 2,\n      y: photoY + (photoH - h) / 2,\n      width: w,\n      height: h,\n    });\n  } else {\n    const initials = student.displayName\n      .split(/\\s+/)\n      .filter(Boolean)\n      .slice(0, 2)\n      .map((p) => p[0]?.toUpperCase() ?? \"\")\n      .join(\"\");\n    const initialsSize = 18;\n    const iw = fonts.bold.widthOfTextAtSize(initials || \"?\", initialsSize);\n    page.drawText(initials || \"?\", {\n      x: photoX + (photoW - iw) / 2,\n      y: photoY + photoH / 2 - initialsSize / 3,\n      size: initialsSize,\n      font: fonts.bold,\n      color: muted,\n    });\n  }\n\n  const textX = photoX + photoW + 12;\n  const maxTextW = ID_CARD_WIDTH - textX - 10;\n  let y = ID_CARD_HEIGHT - headerH - 22;\n\n  const drawField = (label: string, value: string, valueSize = 10) => {\n    page.drawText(label, {\n      x: textX,\n      y,\n      size: 7,\n      font: fonts.regular,\n      color: muted,\n    });\n    y -= 12;\n    const line = truncateToWidth(value, fonts.bold, valueSize, maxTextW);\n    page.drawText(line, {\n      x: textX,\n      y,\n      size: valueSize,\n      font: fonts.bold,\n      color: ink,\n    });\n    y -= 16;\n  };\n\n  drawField(\"Name\", student.displayName || student.username, 11);\n  drawField(\"Student ID\", student.username, 10);\n  drawField(\"Class / Grade\", student.classLabel || \"—\", 9);\n\n  page.drawText(\"STUDENT\", {\n    x: textX,\n    y: 14,\n    size: 7,\n    font: fonts.bold,\n    color: brand,\n  });\n}\n\n/**\n * Build a multi-page PDF: one CR80 front-side ID card per student.\n */\nexport async function buildIdCardsPdf(\n  school: IdCardSchool,\n  students: IdCardStudent[]\n): Promise<Uint8Array> {\n  if (students.length === 0) {\n    throw new Error(\"No students provided for ID card generation\");\n  }\n\n  const pdfDoc = await PDFDocument.create();\n  const fonts = await loadFonts(pdfDoc);\n\n  let logoBytes: Buffer | null = null;\n  if (school.logoPath) {\n    logoBytes = await loadGcsBytes(school.logoPath);\n  }\n  const logo = await embedImage(pdfDoc, logoBytes);\n\n  for (const student of students) {\n    let photoBytes: Buffer | null = null;\n    if (student.profilePictureUrl) {\n      photoBytes = await fetchBytesFromUrl(student.profilePictureUrl);\n    }\n    const photo = await embedImage(pdfDoc, photoBytes);\n\n    const page = pdfDoc.addPage([ID_CARD_WIDTH, ID_CARD_HEIGHT]);\n    drawCard(page, fonts, school, student, logo, photo);\n  }\n\n  return pdfDoc.save();\n}\n"],"names":[],"mappings":"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","debug_id":"77a2e4ef-b728-5a9e-85eb-71bd3525a454"}

package/dist/lib/pdfLetterhead.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reusable PDF letterhead stamp helper (pdf-lib).
+ *
+ * Callers (transcripts, fee receipts, ID cards) load school letterhead bytes
+ * and pass them here to draw a header image on the first page.
+ */
+import { PDFDocument, PDFPage } from "pdf-lib";
+export interface StampLetterheadOptions {
+    /** Full page width (points). Defaults to A4 width. */
+    pageWidth?: number;
+    /** Top margin inset. Defaults to 24. */
+    topMargin?: number;
+    /** Max letterhead height in points. Defaults to 72. */
+    maxHeight?: number;
+    /** Horizontal inset from page edges. Defaults to 48. */
+    sideMargin?: number;
+}
+/**
+ * Draw letterhead on `page` and return the Y coordinate below the image
+ * (content should start at or below this value). Returns the original
+ * `contentTopY` when letterhead cannot be embedded.
+ */
+export declare function stampLetterheadOnPage(input: {
+    pdfDoc: PDFDocument;
+    page: PDFPage;
+    letterheadBytes?: Uint8Array | null;
+    letterheadContentType?: string | null;
+    /** Current top Y for content (page height - top margin). */
+    contentTopY: number;
+    options?: StampLetterheadOptions;
+}): Promise<number>;
+/**
+ * Convenience: load an existing PDF, stamp letterhead on page 0, return bytes.
+ */
+export declare function stampLetterheadOnPdfBytes(input: {
+    pdfBytes: Uint8Array;
+    letterheadBytes?: Uint8Array | null;
+    letterheadContentType?: string | null;
+    options?: StampLetterheadOptions;
+}): Promise<Uint8Array>;
+//# sourceMappingURL=pdfLetterhead.d.ts.map

package/dist/lib/pdfLetterhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfLetterhead.d.ts","sourceRoot":"/","sources":["lib/pdfLetterhead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAY,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAqCD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,UAAU,CAAC;IACrB,eAAe,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBtB"}

package/dist/lib/pdfLetterhead.js

@@ -0,0 +1,86 @@
+/**
+ * Reusable PDF letterhead stamp helper (pdf-lib).
+ *
+ * Callers (transcripts, fee receipts, ID cards) load school letterhead bytes
+ * and pass them here to draw a header image on the first page.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="dffa9b67-991b-5a4d-a8be-1fe64b153bf1")}catch(e){}}();
+import { PDFDocument } from "pdf-lib";
+function looksLikePng(bytes) {
+    return (bytes.length >= 8 &&
+        bytes[0] === 0x89 &&
+        bytes[1] === 0x50 &&
+        bytes[2] === 0x4e &&
+        bytes[3] === 0x47);
+}
+async function embedImage(pdfDoc, bytes, contentType) {
+    if (!bytes.length)
+        return null;
+    const type = (contentType ?? "").toLowerCase();
+    try {
+        if (type.includes("png") || (!type && looksLikePng(bytes))) {
+            return await pdfDoc.embedPng(bytes);
+        }
+        return await pdfDoc.embedJpg(bytes);
+    }
+    catch {
+        try {
+            return await pdfDoc.embedPng(bytes);
+        }
+        catch {
+            try {
+                return await pdfDoc.embedJpg(bytes);
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+}
+/**
+ * Draw letterhead on `page` and return the Y coordinate below the image
+ * (content should start at or below this value). Returns the original
+ * `contentTopY` when letterhead cannot be embedded.
+ */
+export async function stampLetterheadOnPage(input) {
+    const { pdfDoc, page, letterheadBytes, letterheadContentType, contentTopY, options, } = input;
+    if (!letterheadBytes?.length)
+        return contentTopY;
+    const pageWidth = options?.pageWidth ?? page.getWidth();
+    const sideMargin = options?.sideMargin ?? 48;
+    const maxHeight = options?.maxHeight ?? 72;
+    const image = await embedImage(pdfDoc, letterheadBytes, letterheadContentType);
+    if (!image)
+        return contentTopY;
+    const maxWidth = pageWidth - sideMargin * 2;
+    const scale = Math.min(maxWidth / image.width, maxHeight / image.height, 1);
+    const drawWidth = image.width * scale;
+    const drawHeight = image.height * scale;
+    const x = (pageWidth - drawWidth) / 2;
+    const y = contentTopY - drawHeight;
+    page.drawImage(image, { x, y, width: drawWidth, height: drawHeight });
+    // Leave a small gap under the letterhead.
+    return y - 16;
+}
+/**
+ * Convenience: load an existing PDF, stamp letterhead on page 0, return bytes.
+ */
+export async function stampLetterheadOnPdfBytes(input) {
+    const pdfDoc = await PDFDocument.load(input.pdfBytes);
+    const page = pdfDoc.getPages()[0];
+    if (!page)
+        return input.pdfBytes;
+    const topMargin = input.options?.topMargin ?? 24;
+    await stampLetterheadOnPage({
+        pdfDoc,
+        page,
+        letterheadBytes: input.letterheadBytes,
+        letterheadContentType: input.letterheadContentType,
+        contentTopY: page.getHeight() - topMargin,
+        options: input.options,
+    });
+    return pdfDoc.save();
+}
+//# sourceMappingURL=pdfLetterhead.js.map
+//# debugId=dffa9b67-991b-5a4d-a8be-1fe64b153bf1

package/dist/lib/pdfLetterhead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pdfLetterhead.js","sources":["lib/pdfLetterhead.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Reusable PDF letterhead stamp helper (pdf-lib).\n *\n * Callers (transcripts, fee receipts, ID cards) load school letterhead bytes\n * and pass them here to draw a header image on the first page.\n */\n\nimport { PDFDocument, PDFImage, PDFPage } from \"pdf-lib\";\n\nexport interface StampLetterheadOptions {\n  /** Full page width (points). Defaults to A4 width. */\n  pageWidth?: number;\n  /** Top margin inset. Defaults to 24. */\n  topMargin?: number;\n  /** Max letterhead height in points. Defaults to 72. */\n  maxHeight?: number;\n  /** Horizontal inset from page edges. Defaults to 48. */\n  sideMargin?: number;\n}\n\nfunction looksLikePng(bytes: Uint8Array): boolean {\n  return (\n    bytes.length >= 8 &&\n    bytes[0] === 0x89 &&\n    bytes[1] === 0x50 &&\n    bytes[2] === 0x4e &&\n    bytes[3] === 0x47\n  );\n}\n\nasync function embedImage(\n  pdfDoc: PDFDocument,\n  bytes: Uint8Array,\n  contentType?: string | null\n): Promise<PDFImage | null> {\n  if (!bytes.length) return null;\n  const type = (contentType ?? \"\").toLowerCase();\n  try {\n    if (type.includes(\"png\") || (!type && looksLikePng(bytes))) {\n      return await pdfDoc.embedPng(bytes);\n    }\n    return await pdfDoc.embedJpg(bytes);\n  } catch {\n    try {\n      return await pdfDoc.embedPng(bytes);\n    } catch {\n      try {\n        return await pdfDoc.embedJpg(bytes);\n      } catch {\n        return null;\n      }\n    }\n  }\n}\n\n/**\n * Draw letterhead on `page` and return the Y coordinate below the image\n * (content should start at or below this value). Returns the original\n * `contentTopY` when letterhead cannot be embedded.\n */\nexport async function stampLetterheadOnPage(input: {\n  pdfDoc: PDFDocument;\n  page: PDFPage;\n  letterheadBytes?: Uint8Array | null;\n  letterheadContentType?: string | null;\n  /** Current top Y for content (page height - top margin). */\n  contentTopY: number;\n  options?: StampLetterheadOptions;\n}): Promise<number> {\n  const {\n    pdfDoc,\n    page,\n    letterheadBytes,\n    letterheadContentType,\n    contentTopY,\n    options,\n  } = input;\n  if (!letterheadBytes?.length) return contentTopY;\n\n  const pageWidth = options?.pageWidth ?? page.getWidth();\n  const sideMargin = options?.sideMargin ?? 48;\n  const maxHeight = options?.maxHeight ?? 72;\n\n  const image = await embedImage(pdfDoc, letterheadBytes, letterheadContentType);\n  if (!image) return contentTopY;\n\n  const maxWidth = pageWidth - sideMargin * 2;\n  const scale = Math.min(maxWidth / image.width, maxHeight / image.height, 1);\n  const drawWidth = image.width * scale;\n  const drawHeight = image.height * scale;\n  const x = (pageWidth - drawWidth) / 2;\n  const y = contentTopY - drawHeight;\n\n  page.drawImage(image, { x, y, width: drawWidth, height: drawHeight });\n\n  // Leave a small gap under the letterhead.\n  return y - 16;\n}\n\n/**\n * Convenience: load an existing PDF, stamp letterhead on page 0, return bytes.\n */\nexport async function stampLetterheadOnPdfBytes(input: {\n  pdfBytes: Uint8Array;\n  letterheadBytes?: Uint8Array | null;\n  letterheadContentType?: string | null;\n  options?: StampLetterheadOptions;\n}): Promise<Uint8Array> {\n  const pdfDoc = await PDFDocument.load(input.pdfBytes);\n  const page = pdfDoc.getPages()[0];\n  if (!page) return input.pdfBytes;\n\n  const topMargin = input.options?.topMargin ?? 24;\n  await stampLetterheadOnPage({\n    pdfDoc,\n    page,\n    letterheadBytes: input.letterheadBytes,\n    letterheadContentType: input.letterheadContentType,\n    contentTopY: page.getHeight() - topMargin,\n    options: input.options,\n  });\n\n  return pdfDoc.save();\n}\n"],"names":[],"mappings":"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","debug_id":"dffa9b67-991b-5a4d-a8be-1fe64b153bf1"}

package/dist/lib/transcriptPdf.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Branded transcript / progress-report PDF builder (pdf-lib).
+ *
+ * Variants:
+ * - `letter` — percentage + letter-grade style transcript
+ * - `level` — CDC Annex-4 style progress report (Below Basic / Basic /
+ *   Proficient / Advanced) when grading boundaries are level-based
+ *
+ * School branding uses name + optional logo. Letterhead is not in the School
+ * schema yet — when added, callers can pass `letterheadBytes` without blocking.
+ */
+export type TranscriptReportVariant = "letter" | "level";
+export interface TranscriptClassRow {
+    className: string;
+    subject: string;
+    section: string;
+    percentage: number | null;
+    gradeLabel: string | null;
+    categorySummaries: {
+        name: string;
+        average: number | null;
+    }[];
+}
+export interface TranscriptAttendanceSummary {
+    present: number;
+    late: number;
+    absent: number;
+    total: number;
+    /** (present + late) / total * 100, or null when total is 0. */
+    percent: number | null;
+}
+export interface TranscriptPdfInput {
+    schoolName: string;
+    studentName: string;
+    studentUsername?: string | null;
+    /** Free-text school year (no AcademicTerm model yet — see C1). */
+    schoolYear?: string | null;
+    periodLabel?: string | null;
+    variant: TranscriptReportVariant;
+    classes: TranscriptClassRow[];
+    attendance: TranscriptAttendanceSummary;
+    logoBytes?: Uint8Array | null;
+    logoContentType?: string | null;
+    /** Optional future letterhead image; ignored when null/undefined. */
+    letterheadBytes?: Uint8Array | null;
+    letterheadContentType?: string | null;
+    generatedAt?: Date;
+}
+/**
+ * Detects CDC Annex-4 style level boundaries from a GradingBoundary
+ * `structured` JSON payload.
+ */
+export declare function isLevelBasedBoundary(structured: string | null | undefined): boolean;
+export declare function buildTranscriptPdf(input: TranscriptPdfInput): Promise<Uint8Array>;
+//# sourceMappingURL=transcriptPdf.d.ts.map

package/dist/lib/transcriptPdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcriptPdf.d.ts","sourceRoot":"/","sources":["lib/transcriptPdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,uBAAuB,CAAC;IACjC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,UAAU,EAAE,2BAA2B,CAAC;IACxC,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qEAAqE;IACrE,eAAe,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AA+GD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAoBnF;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,UAAU,CAAC,CA8JrB"}