@legalplace/prerenderx 3.9.16 → 3.9.17

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.9.17](https://git.legalplace.eu/legalplace/prerenderx/compare/@legalplace/prerenderx@3.9.16...@legalplace/prerenderx@3.9.17) (2026-10-15)
+
+### Bug Fixes
+
+- add day offset and format to signature date tag api[#124](https://git.legalplace.eu/legalplace/prerenderx/issues/124)j4fvkq4f ([33802bd](https://git.legalplace.eu/legalplace/prerenderx/commits/33802bdbb5bd8aa15b98cc3ca1b1c510c13e59e2)), closes [api#124j4fvkq4](https://git.legalplace.eu/api/issues/124j4fvkq4) [api#124j4fvkq4](https://git.legalplace.eu/api/issues/124j4fvkq4)
+
 ## [3.9.16](https://git.legalplace.eu/legalplace/prerenderx/compare/@legalplace/prerenderx@3.9.15...@legalplace/prerenderx@3.9.16) (2026-10-14)
 
 **Note:** Version bump only for package @legalplace/prerenderx

package/dist/libs/OutputParser.js

@@ -56,6 +56,18 @@ var getRelatedVariablesValues = function (optionId, index, variables, ovc, refer
     return variablesValues;
 };
 exports.getRelatedVariablesValues = getRelatedVariablesValues;
+var SIGNATURE_DATE_FORMATS = [
+    "dd/MM/yyyy",
+    "dd-MM-yyyy",
+    "dd.MM.yyyy",
+    "yyyy-MM-dd",
+    "MM/dd/yyyy",
+    "dd MMMM yyyy",
+    "MMMM dd, yyyy",
+    "MMM dd, yyyy",
+];
+var DEFAULT_SIGNATURE_DATE_FORMAT = "dd/MM/yyyy";
+var signatureDateWithParamsRegex = new RegExp("\\[signature:date(?:\\+([0-9]{1,3}))?:([0-9]+)(?::(".concat(SIGNATURE_DATE_FORMATS.map(function (format) { return format.replace(/[./-]/g, "\\$&"); }).join("|"), "))?\\]"), "g");
 var parseOutputWithVariables = function (output, index, variables, autonums) {
     var parsedOutput = "".concat(output);
     Object.keys(variables).forEach(function (variableId) {
@@ -75,6 +87,9 @@ var parseOutputWithVariables = function (output, index, variables, autonums) {
     parsedOutput = parsedOutput.replace(/\[signature:date:([0-9]+)\]/g, function (v, signatureId) {
         return "<span data-signature=\"date\" data-signature-id=\"".concat(signatureId, "\" data-signer-index=\"").concat(index, "\"></span>");
     });
+    parsedOutput = parsedOutput.replace(signatureDateWithParamsRegex, function (v, offset, signatureId, format) {
+        return "<span data-signature=\"date\" data-signature-id=\"".concat(signatureId, "\" data-signer-index=\"").concat(index, "\" data-signature-offset=\"").concat(offset !== null && offset !== void 0 ? offset : 0, "\" data-signature-format=\"").concat(format !== null && format !== void 0 ? format : DEFAULT_SIGNATURE_DATE_FORMAT, "\"></span>");
+    });
     parsedOutput = parsedOutput.replace(/\[signature:mention:([0-9]+):(?:&quot;|")((?:[^"&]|\\.)*?)(?:&quot;|")\]/g, function (v, signatureId, mention) {
         return "<span data-signature=\"mention\" data-signature-id=\"".concat(signatureId, "\" data-signer-index=\"").concat(index, "\" data-signer-mention=\"").concat(mention, "\"></span>");
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@legalplace/prerenderx",
-  "version": "3.9.16",
+  "version": "3.9.17",
   "description": "PrerenderX",
   "main": "dist/index.js",
   "repository": "https://git.legalplace.eu/legalplace/prerenderx",
@@ -39,5 +39,5 @@
     "ts-jest": "^24.0.2"
   },
   "prettier": "@legalplace/prettier-config",
-  "gitHead": "5c96a9f4113e49792cbb5d836c62485474d93576"
+  "gitHead": "7c098875cac91677cba3fd973c3457b557fc8a6e"
 }

package/src/libs/OutputParser.ts

@@ -92,6 +92,26 @@ export const getRelatedVariablesValues: getRelatedVarsT = (
  * @param variables Variables values list
  * @param autonums Autonums values
  */
+
+const SIGNATURE_DATE_FORMATS = [
+  "dd/MM/yyyy",
+  "dd-MM-yyyy",
+  "dd.MM.yyyy",
+  "yyyy-MM-dd",
+  "MM/dd/yyyy",
+  "dd MMMM yyyy",
+  "MMMM dd, yyyy",
+  "MMM dd, yyyy",
+];
+const DEFAULT_SIGNATURE_DATE_FORMAT = "dd/MM/yyyy";
+// Must run after the bare [signature:date:<id>] replacement, which it would otherwise also match
+const signatureDateWithParamsRegex = new RegExp(
+  `\\[signature:date(?:\\+([0-9]{1,3}))?:([0-9]+)(?::(${SIGNATURE_DATE_FORMATS.map(
+    (format) => format.replace(/[./-]/g, "\\$&")
+  ).join("|")}))?\\]`,
+  "g"
+);
+
 type autonumsType = [string, string, number, string | null][];
 type parseOutputT = (
   output: string,
@@ -147,6 +167,16 @@ export const parseOutputWithVariables: parseOutputT = (
     (v, signatureId) =>
       `<span data-signature="date" data-signature-id="${signatureId}" data-signer-index="${index}"></span>`
   );
+  // Signature date tag with a day offset and/or a display format, e.g. [signature:date+364:1:dd/MM/yyyy]
+  parsedOutput = parsedOutput.replace(
+    signatureDateWithParamsRegex,
+    (v, offset, signatureId, format) =>
+      `<span data-signature="date" data-signature-id="${signatureId}" data-signer-index="${index}" data-signature-offset="${
+        offset ?? 0
+      }" data-signature-format="${
+        format ?? DEFAULT_SIGNATURE_DATE_FORMAT
+      }"></span>`
+  );
 
   // Signature mention tag
   parsedOutput = parsedOutput.replace(

package/tests/OutputParser.signatureDate.test.ts

@@ -0,0 +1,42 @@
+import { parseOutputWithVariables } from "../src/libs/OutputParser";
+
+const parse = (output: string, index = 0) =>
+  parseOutputWithVariables(output, index, {}, []);
+
+describe("parseOutputWithVariables - signature date tags", () => {
+  it("keeps [signature:date:<id>] unchanged (no offset nor format attributes)", () => {
+    expect(parse("[signature:date:1]")).toBe(
+      '<span data-signature="date" data-signature-id="1" data-signer-index="0"></span>'
+    );
+  });
+
+  it("adds the day offset and the default format for [signature:date+X:<id>]", () => {
+    expect(parse("[signature:date+364:1]", 2)).toBe(
+      '<span data-signature="date" data-signature-id="1" data-signer-index="2" data-signature-offset="364" data-signature-format="dd/MM/yyyy"></span>'
+    );
+  });
+
+  it("adds a zero offset and the given format for [signature:date:<id>:<format>]", () => {
+    expect(parse("[signature:date:1:dd MMMM yyyy]")).toBe(
+      '<span data-signature="date" data-signature-id="1" data-signer-index="0" data-signature-offset="0" data-signature-format="dd MMMM yyyy"></span>'
+    );
+  });
+
+  it("supports both offset and format", () => {
+    expect(parse("[signature:date+30:2:MMMM dd, yyyy]")).toBe(
+      '<span data-signature="date" data-signature-id="2" data-signer-index="0" data-signature-offset="30" data-signature-format="MMMM dd, yyyy"></span>'
+    );
+  });
+
+  it.each([
+    "[signature:date+abc:1]",
+    "[signature:date+1000:1]",
+    "[signature:date+364]",
+    "[signature:date:1:yyyy]",
+    // Not supported by Yousign signature_date fields
+    "[signature:date-30:1]",
+    "[signature:date:1:dd/MM]",
+  ])("leaves the malformed tag %s visible", (tag) => {
+    expect(parse(tag)).toBe(tag);
+  });
+});