@hostwebhook/template-engine 1.0.0 → 1.1.0

package/dist/index.d.mts

@@ -74,9 +74,14 @@ declare function tryNullCoalesce(expr: string, ctx: TemplateContext): string | n
  */
 declare function tryTernary(expr: string, ctx: TemplateContext): string | null;
 /**
- * Apply a pipe transform: | json, | upper, | lower, | trim
+ * Apply a pipe transform.
+ *
+ * String:  | json, | upper, | lower, | trim
+ * Date:    | formatDate, | formatTime, | formatDateTime, | toISO, | toEpoch
+ *          | diffDays(otherPath), | diffHours(otherPath)
+ * Number:  | currency, | percent, | round(decimals)
  */
-declare function applyPipe(pipe: string, val: unknown): string;
+declare function applyPipe(pipe: string, val: unknown, arg?: string, ctx?: TemplateContext): string;
 /**
  * Evaluate a single {{...}} expression and return a string.
  */

package/dist/index.d.ts

@@ -74,9 +74,14 @@ declare function tryNullCoalesce(expr: string, ctx: TemplateContext): string | n
  */
 declare function tryTernary(expr: string, ctx: TemplateContext): string | null;
 /**
- * Apply a pipe transform: | json, | upper, | lower, | trim
+ * Apply a pipe transform.
+ *
+ * String:  | json, | upper, | lower, | trim
+ * Date:    | formatDate, | formatTime, | formatDateTime, | toISO, | toEpoch
+ *          | diffDays(otherPath), | diffHours(otherPath)
+ * Number:  | currency, | percent, | round(decimals)
  */
-declare function applyPipe(pipe: string, val: unknown): string;
+declare function applyPipe(pipe: string, val: unknown, arg?: string, ctx?: TemplateContext): string;
 /**
  * Evaluate a single {{...}} expression and return a string.
  */

package/dist/index.js

@@ -218,7 +218,8 @@ var TRUTHY_RE = new RegExp(
   `^(!?)(.+?)\\s*\\?\\s*(${BRANCH})\\s*:\\s*(${BRANCH})$`
 );
 var NULL_COALESCE_RE = /^(.+?)\s*\?\?\s*("(?:[^"]*)"$|'(?:[^']*)'$|\S+$)/;
-var PIPE_RE = /^(.+?)\s*\|\s*(json|upper|lower|trim)$/;
+var PIPE_NAMES = "json|upper|lower|trim|diffDays|diffHours|formatDate|formatTime|formatDateTime|toISO|toEpoch|currency|percent|round";
+var PIPE_RE = new RegExp(`^(.+?)\\s*\\|\\s*(${PIPE_NAMES})(?:\\((.+?)\\))?$`);
 function tryNullCoalesce(expr, ctx) {
   const m = expr.match(NULL_COALESCE_RE);
   if (!m) return null;
@@ -245,8 +246,21 @@ function tryTernary(expr, ctx) {
   if (negate === "!") truthy = !truthy;
   return truthy ? resolveBranch(trueRaw, ctx) : resolveBranch(falseRaw, ctx);
 }
-function applyPipe(pipe, val) {
+function toDate(val) {
+  if (val instanceof Date) return val;
+  if (typeof val === "number") return new Date(val);
+  if (typeof val === "string") {
+    const d = new Date(val);
+    return isNaN(d.getTime()) ? null : d;
+  }
+  return null;
+}
+function pad2(n) {
+  return n < 10 ? `0${n}` : String(n);
+}
+function applyPipe(pipe, val, arg, ctx) {
   switch (pipe) {
+    // ── String ───────────────────────────────────────────────
     case "json":
       return JSON.stringify(val, null, 2);
     case "upper":
@@ -255,6 +269,59 @@ function applyPipe(pipe, val) {
       return String(val ?? "").toLowerCase();
     case "trim":
       return String(val ?? "").trim();
+    // ── Date formatting ──────────────────────────────────────
+    case "formatDate": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+    }
+    case "formatTime": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`;
+    }
+    case "formatDateTime": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())} ${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`;
+    }
+    case "toISO": {
+      const d = toDate(val);
+      return d ? d.toISOString() : "";
+    }
+    case "toEpoch": {
+      const d = toDate(val);
+      return d ? String(d.getTime()) : "";
+    }
+    // ── Date diff ────────────────────────────────────────────
+    case "diffDays":
+    case "diffHours": {
+      const d1 = toDate(val);
+      if (!d1 || !arg || !ctx) return "";
+      const otherVal = resolvePath(arg.trim(), ctx);
+      const d2 = toDate(otherVal);
+      if (!d2) return "";
+      const diffMs = Math.abs(d1.getTime() - d2.getTime());
+      if (pipe === "diffDays") return String(Math.floor(diffMs / 864e5));
+      return String(Math.floor(diffMs / 36e5));
+    }
+    // ── Number ───────────────────────────────────────────────
+    case "currency": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      return `$${n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    }
+    case "percent": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      return `${n}%`;
+    }
+    case "round": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      const decimals = arg ? parseInt(arg, 10) : 0;
+      return n.toFixed(isNaN(decimals) ? 0 : decimals);
+    }
     default:
       return valueToString(val);
   }
@@ -271,9 +338,9 @@ function evaluate(expr, ctx, opts) {
   }
   const pipeM = trimmed.match(PIPE_RE);
   if (pipeM) {
-    const [, path, pipe] = pipeM;
+    const [, path, pipe, arg] = pipeM;
     const val = resolvePath(path.trim(), ctx);
-    return applyPipe(pipe, val);
+    return applyPipe(pipe, val, arg, ctx);
   }
   const ncResult = tryNullCoalesce(trimmed, ctx);
   if (ncResult !== null) return ncResult;
@@ -309,7 +376,7 @@ function resolveJsonValue(value, ctx, opts) {
         const val = resolvePath(expr.slice(1).trim(), ctx);
         return !val;
       }
-      if (/\|\s*(json|upper|lower|trim)$/.test(expr)) {
+      if (/\|\s*\w+/.test(expr)) {
         return evaluate(expr, ctx, opts);
       }
       const resolved = resolvePath(expr, ctx);

package/dist/index.mjs

@@ -176,7 +176,8 @@ var TRUTHY_RE = new RegExp(
   `^(!?)(.+?)\\s*\\?\\s*(${BRANCH})\\s*:\\s*(${BRANCH})$`
 );
 var NULL_COALESCE_RE = /^(.+?)\s*\?\?\s*("(?:[^"]*)"$|'(?:[^']*)'$|\S+$)/;
-var PIPE_RE = /^(.+?)\s*\|\s*(json|upper|lower|trim)$/;
+var PIPE_NAMES = "json|upper|lower|trim|diffDays|diffHours|formatDate|formatTime|formatDateTime|toISO|toEpoch|currency|percent|round";
+var PIPE_RE = new RegExp(`^(.+?)\\s*\\|\\s*(${PIPE_NAMES})(?:\\((.+?)\\))?$`);
 function tryNullCoalesce(expr, ctx) {
   const m = expr.match(NULL_COALESCE_RE);
   if (!m) return null;
@@ -203,8 +204,21 @@ function tryTernary(expr, ctx) {
   if (negate === "!") truthy = !truthy;
   return truthy ? resolveBranch(trueRaw, ctx) : resolveBranch(falseRaw, ctx);
 }
-function applyPipe(pipe, val) {
+function toDate(val) {
+  if (val instanceof Date) return val;
+  if (typeof val === "number") return new Date(val);
+  if (typeof val === "string") {
+    const d = new Date(val);
+    return isNaN(d.getTime()) ? null : d;
+  }
+  return null;
+}
+function pad2(n) {
+  return n < 10 ? `0${n}` : String(n);
+}
+function applyPipe(pipe, val, arg, ctx) {
   switch (pipe) {
+    // ── String ───────────────────────────────────────────────
     case "json":
       return JSON.stringify(val, null, 2);
     case "upper":
@@ -213,6 +227,59 @@ function applyPipe(pipe, val) {
       return String(val ?? "").toLowerCase();
     case "trim":
       return String(val ?? "").trim();
+    // ── Date formatting ──────────────────────────────────────
+    case "formatDate": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+    }
+    case "formatTime": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`;
+    }
+    case "formatDateTime": {
+      const d = toDate(val);
+      if (!d) return "";
+      return `${d.getUTCFullYear()}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())} ${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())}:${pad2(d.getUTCSeconds())}`;
+    }
+    case "toISO": {
+      const d = toDate(val);
+      return d ? d.toISOString() : "";
+    }
+    case "toEpoch": {
+      const d = toDate(val);
+      return d ? String(d.getTime()) : "";
+    }
+    // ── Date diff ────────────────────────────────────────────
+    case "diffDays":
+    case "diffHours": {
+      const d1 = toDate(val);
+      if (!d1 || !arg || !ctx) return "";
+      const otherVal = resolvePath(arg.trim(), ctx);
+      const d2 = toDate(otherVal);
+      if (!d2) return "";
+      const diffMs = Math.abs(d1.getTime() - d2.getTime());
+      if (pipe === "diffDays") return String(Math.floor(diffMs / 864e5));
+      return String(Math.floor(diffMs / 36e5));
+    }
+    // ── Number ───────────────────────────────────────────────
+    case "currency": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      return `$${n.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+    }
+    case "percent": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      return `${n}%`;
+    }
+    case "round": {
+      const n = Number(val);
+      if (isNaN(n)) return "";
+      const decimals = arg ? parseInt(arg, 10) : 0;
+      return n.toFixed(isNaN(decimals) ? 0 : decimals);
+    }
     default:
       return valueToString(val);
   }
@@ -229,9 +296,9 @@ function evaluate(expr, ctx, opts) {
   }
   const pipeM = trimmed.match(PIPE_RE);
   if (pipeM) {
-    const [, path, pipe] = pipeM;
+    const [, path, pipe, arg] = pipeM;
     const val = resolvePath(path.trim(), ctx);
-    return applyPipe(pipe, val);
+    return applyPipe(pipe, val, arg, ctx);
   }
   const ncResult = tryNullCoalesce(trimmed, ctx);
   if (ncResult !== null) return ncResult;
@@ -267,7 +334,7 @@ function resolveJsonValue(value, ctx, opts) {
         const val = resolvePath(expr.slice(1).trim(), ctx);
         return !val;
       }
-      if (/\|\s*(json|upper|lower|trim)$/.test(expr)) {
+      if (/\|\s*\w+/.test(expr)) {
         return evaluate(expr, ctx, opts);
       }
       const resolved = resolvePath(expr, ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/template-engine",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Template interpolation and sandboxed JS execution engine for HostWebhook",
   "main": "dist/index.js",
   "module": "dist/index.mjs",