@josephomills/esign 0.8.0 → 0.9.0

package/dist/server/index.cjs

@@ -113,6 +113,58 @@ function toErrorResponse(err) {
     { status: 500 }
   );
 }
+
+// src/shared/fields.ts
+var DATE_FORMATS = [
+  "DD/MM/YYYY",
+  "MM/DD/YYYY",
+  "YYYY-MM-DD",
+  "D MMM YYYY",
+  "Do MMM YYYY",
+  "Do MMMM YYYY",
+  "MMMM D, YYYY"
+];
+var DEFAULT_DATE_FORMAT = "Do MMMM YYYY";
+var MONTHS_SHORT = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+var MONTHS_LONG = ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+function ordinal(n) {
+  const s = ["th", "st", "nd", "rd"];
+  const v = n % 100;
+  return `${n}${s[(v - 20) % 10] ?? s[v] ?? s[0]}`;
+}
+function formatPickedDate(iso, format) {
+  const [y, m, d] = iso.split("-").map(Number);
+  if (!y || !m || !d) return iso;
+  const dd = String(d).padStart(2, "0");
+  const mm = String(m).padStart(2, "0");
+  switch (format) {
+    case "DD/MM/YYYY":
+      return `${dd}/${mm}/${y}`;
+    case "MM/DD/YYYY":
+      return `${mm}/${dd}/${y}`;
+    case "YYYY-MM-DD":
+      return `${y}-${mm}-${dd}`;
+    case "D MMM YYYY":
+      return `${d} ${MONTHS_SHORT[m - 1]} ${y}`;
+    case "Do MMM YYYY":
+      return `${ordinal(d)} ${MONTHS_SHORT[m - 1]} ${y}`;
+    case "Do MMMM YYYY":
+      return `${ordinal(d)} ${MONTHS_LONG[m - 1]} ${y}`;
+    case "MMMM D, YYYY":
+      return `${MONTHS_LONG[m - 1]} ${d}, ${y}`;
+  }
+}
+var DATE_FORMAT_LABELS = {
+  "DD/MM/YYYY": "02/10/2026",
+  "MM/DD/YYYY": "10/02/2026",
+  "YYYY-MM-DD": "2026-10-02",
+  "D MMM YYYY": "2 Oct 2026",
+  "Do MMM YYYY": "2nd Oct 2026",
+  "Do MMMM YYYY": "2nd October 2026",
+  "MMMM D, YYYY": "October 2, 2026"
+};
+
+// src/server/types.ts
 var ESIGN_CHANNELS = [
   "EMAIL",
   "TELEGRAM",
@@ -128,11 +180,18 @@ var placementSchema = zod.z.object({
   w: zod.z.number().min(0.01).max(1),
   h: zod.z.number().min(0.01).max(1)
 }).strict();
-var signatureFieldSchema = placementSchema.extend({
+var isoDate = zod.z.string().regex(/^\d{4}-\d{2}-\d{2}$/);
+var documentFieldSchema = placementSchema.extend({
   id: zod.z.string().min(1).max(64),
-  label: zod.z.string().trim().max(80)
+  label: zod.z.string().trim().max(80),
+  type: zod.z.enum(["signature", "date"]).default("signature"),
+  dateFormat: zod.z.enum(DATE_FORMATS).optional(),
+  minDate: isoDate.nullable().optional()
+}).strict();
+var signatureFieldSchema = documentFieldSchema;
+var placementsSchema = zod.z.array(documentFieldSchema).min(1).max(20).refine((fields) => fields.some((f) => f.type === "signature"), {
+  message: "A document needs at least one signature field."
 });
-var placementsSchema = zod.z.array(signatureFieldSchema).min(1).max(20);
 function addressFor(recipient, channel) {
   switch (channel) {
     case "EMAIL":
@@ -162,7 +221,8 @@ var submitSignatureSchema = zod.z.object({
   signaturePng: zod.z.string().min(1).max(15e5),
   // ~1MB cap on the data URL
   signerName: zod.z.string().trim().min(1).max(200),
-  consent: zod.z.literal(true)
+  consent: zod.z.literal(true),
+  dateValues: zod.z.record(zod.z.string().min(1).max(64), isoDate).optional()
 }).strict();
 var declineSchema = zod.z.object({ reason: zod.z.string().trim().max(500).optional() }).strict();
 var ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
@@ -652,15 +712,35 @@ async function sealPdf(input) {
   const png = await pdf.embedPng(input.signaturePng);
   const font = await pdf.embedFont(pdfLib.StandardFonts.Helvetica);
   const caption = `Signed by ${input.signerName} \xB7 ${input.signedAt}${input.signerIp ? ` \xB7 IP ${input.signerIp}` : ""}`;
-  input.placements.forEach((placement, i) => {
-    const pageIndex = Math.min(Math.max(placement.page - 1, 0), pages.length - 1);
+  let captionDrawn = false;
+  input.fields.forEach((field) => {
+    const pageIndex = Math.min(Math.max(field.page - 1, 0), pages.length - 1);
     const page = pages[pageIndex];
     const pageW = page.getWidth();
     const pageH = page.getHeight();
-    const boxX = placement.x * pageW;
-    const boxW = placement.w * pageW;
-    const boxH = placement.h * pageH;
-    const boxBottomY = pageH * (1 - placement.y - placement.h);
+    const boxX = field.x * pageW;
+    const boxW = field.w * pageW;
+    const boxH = field.h * pageH;
+    const boxBottomY = pageH * (1 - field.y - field.h);
+    if (field.type === "date") {
+      const iso = input.dateValues[field.id];
+      if (!iso) return;
+      const text = formatPickedDate(iso, field.dateFormat ?? DEFAULT_DATE_FORMAT);
+      let size = Math.min(boxH * 0.62, 15);
+      let textW = font.widthOfTextAtSize(text, size);
+      if (textW > boxW && textW > 0) {
+        size *= boxW / textW;
+        textW = font.widthOfTextAtSize(text, size);
+      }
+      page.drawText(text, {
+        x: boxX + Math.max(0, (boxW - textW) / 2),
+        y: boxBottomY + (boxH - size) / 2 + size * 0.22,
+        size,
+        font,
+        color: pdfLib.rgb(0.1, 0.1, 0.12)
+      });
+      return;
+    }
     const scale = Math.min(boxW / png.width, boxH / png.height);
     const drawW = png.width * scale;
     const drawH = png.height * scale;
@@ -670,7 +750,8 @@ async function sealPdf(input) {
       width: drawW,
       height: drawH
     });
-    if (i === 0) {
+    if (!captionDrawn) {
+      captionDrawn = true;
       page.drawText(caption, {
         x: boxX,
         y: Math.max(boxBottomY - 11, 4),
@@ -786,6 +867,18 @@ async function submitSignature(deps, input) {
   const src = await storage.get(version.sourceObjectKey);
   if (!src) throw new EsignError("INTERNAL", "Source document missing.");
   const document = await persistence.getDocument(request.documentId);
+  const dateValues = input.dateValues ?? {};
+  const createdFloor = document?.createdAt ? document.createdAt.slice(0, 10) : null;
+  for (const field of version.placements) {
+    if (field.type !== "date") continue;
+    const value = dateValues[field.id];
+    const name = field.label || "date";
+    if (!value) throw new EsignError("INVALID_INPUT", `Please fill in the "${name}" date.`);
+    const floor = field.minDate ?? createdFloor;
+    if (floor && value < floor) {
+      throw new EsignError("INVALID_INPUT", `The "${name}" date can't be before ${floor}.`);
+    }
+  }
   const existing = (await persistence.listAuditEvents(request.id)).map(toLink);
   const nowIso = now.toISOString();
   const consented = await recordEvent(persistence, request.id, existing.at(-1) ?? null, {
@@ -800,7 +893,8 @@ async function submitSignature(deps, input) {
   const seal = await sealPdf({
     sourcePdf: src.bytes,
     signaturePng: input.signaturePng,
-    placements: version.placements,
+    fields: version.placements,
+    dateValues,
     signerName: input.signerName,
     signedAt: nowIso,
     signerIp: input.ip,
@@ -921,6 +1015,7 @@ function createSignActionsRoute(deps) {
         token,
         signaturePng: pngFromDataUrl(body.signaturePng),
         signerName: body.signerName,
+        dateValues: body.dateValues,
         ip: clientIp(req),
         userAgent: req.headers.get("user-agent")
       });
@@ -1014,6 +1109,9 @@ function registerSubjectTypes(types) {
 }
 
 exports.ACTIVE_STATUSES = ACTIVE_STATUSES;
+exports.DATE_FORMATS = DATE_FORMATS;
+exports.DATE_FORMAT_LABELS = DATE_FORMAT_LABELS;
+exports.DEFAULT_DATE_FORMAT = DEFAULT_DATE_FORMAT;
 exports.ESIGN_CHANNELS = ESIGN_CHANNELS;
 exports.ESIGN_STATUSES = ESIGN_STATUSES;
 exports.EsignError = EsignError;
@@ -1034,7 +1132,9 @@ exports.declineRequest = declineRequest;
 exports.declineSchema = declineSchema;
 exports.deleteDocument = deleteDocument;
 exports.documentCoverage = documentCoverage;
+exports.documentFieldSchema = documentFieldSchema;
 exports.esignChannelSchema = esignChannelSchema;
+exports.formatPickedDate = formatPickedDate;
 exports.getSigningView = getSigningView;
 exports.isActive = isActive;
 exports.isTerminal = isTerminal;