@hostwebhook/template-engine 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -55,6 +55,35 @@ interface CodeResult {
  */
 declare function renderTemplate(template: string, ctx: TemplateContext, opts?: TemplateOptions): TemplateResult | CodeResult;
 
+/**
+ * Resolve a single input value — literal string or {{expression}}.
+ *
+ * If the value is wrapped in `{{...}}`, it's evaluated as a template expression
+ * (supports paths, pipes, $() cross-node references, JS when allowJs).
+ * Otherwise, the value is returned as-is (literal).
+ *
+ * Preserves types: `{{payload.count}}` returns the original number, not a string.
+ *
+ * @example
+ * resolveInput("active", payload)                          // → "active"
+ * resolveInput("{{payload.status}}", payload)              // → "delivered"
+ * resolveInput("{{payload.amount}}", payload)              // → 1500 (number)
+ * resolveInput("{{payload.date | formatDate}}", payload)   // → "2024-06-15"
+ * resolveInput('{{$("Filter").count}}', payload, { allowJs: true, workspacePayloads }) // → 42
+ * resolveInput(undefined, payload)                         // → undefined
+ */
+declare function resolveInput(value: string | undefined | null, payload: unknown, opts?: Pick<TemplateOptions, 'allowJs' | 'workspacePayloads'>): unknown;
+/**
+ * Normalize a field path — strips `{{`, `}}`, and `payload.` prefix.
+ *
+ * Accepts any of these formats and returns the plain dot-notation path:
+ * - `"{{payload.customer.name}}"` → `"customer.name"`
+ * - `"payload.customer.name"` → `"customer.name"`
+ * - `"customer.name"` → `"customer.name"`
+ * - `"{{customer.name}}"` → `"customer.name"`
+ */
+declare function resolveFieldPath(field: string): string;
+
 /**
  * Resolve a dot-notation path against a TemplateContext.
  * Supports bracket notation for array indexing: `payload.items[0].name`
@@ -87,4 +116,4 @@ declare function applyPipe(pipe: string, val: unknown, arg?: string, ctx?: Templ
  */
 declare function evaluate(expr: string, ctx: TemplateContext, opts?: TemplateOptions): string;
 
-export { type CodeResult, type TemplateContext, type TemplateMode, type TemplateOptions, type TemplateResult, applyPipe, evaluate, renderTemplate, resolvePath, tryNullCoalesce, tryTernary, valueToString };
+export { type CodeResult, type TemplateContext, type TemplateMode, type TemplateOptions, type TemplateResult, applyPipe, evaluate, renderTemplate, resolveFieldPath, resolveInput, resolvePath, tryNullCoalesce, tryTernary, valueToString };

package/dist/index.d.ts

@@ -55,6 +55,35 @@ interface CodeResult {
  */
 declare function renderTemplate(template: string, ctx: TemplateContext, opts?: TemplateOptions): TemplateResult | CodeResult;
 
+/**
+ * Resolve a single input value — literal string or {{expression}}.
+ *
+ * If the value is wrapped in `{{...}}`, it's evaluated as a template expression
+ * (supports paths, pipes, $() cross-node references, JS when allowJs).
+ * Otherwise, the value is returned as-is (literal).
+ *
+ * Preserves types: `{{payload.count}}` returns the original number, not a string.
+ *
+ * @example
+ * resolveInput("active", payload)                          // → "active"
+ * resolveInput("{{payload.status}}", payload)              // → "delivered"
+ * resolveInput("{{payload.amount}}", payload)              // → 1500 (number)
+ * resolveInput("{{payload.date | formatDate}}", payload)   // → "2024-06-15"
+ * resolveInput('{{$("Filter").count}}', payload, { allowJs: true, workspacePayloads }) // → 42
+ * resolveInput(undefined, payload)                         // → undefined
+ */
+declare function resolveInput(value: string | undefined | null, payload: unknown, opts?: Pick<TemplateOptions, 'allowJs' | 'workspacePayloads'>): unknown;
+/**
+ * Normalize a field path — strips `{{`, `}}`, and `payload.` prefix.
+ *
+ * Accepts any of these formats and returns the plain dot-notation path:
+ * - `"{{payload.customer.name}}"` → `"customer.name"`
+ * - `"payload.customer.name"` → `"customer.name"`
+ * - `"customer.name"` → `"customer.name"`
+ * - `"{{customer.name}}"` → `"customer.name"`
+ */
+declare function resolveFieldPath(field: string): string;
+
 /**
  * Resolve a dot-notation path against a TemplateContext.
  * Supports bracket notation for array indexing: `payload.items[0].name`
@@ -87,4 +116,4 @@ declare function applyPipe(pipe: string, val: unknown, arg?: string, ctx?: Templ
  */
 declare function evaluate(expr: string, ctx: TemplateContext, opts?: TemplateOptions): string;
 
-export { type CodeResult, type TemplateContext, type TemplateMode, type TemplateOptions, type TemplateResult, applyPipe, evaluate, renderTemplate, resolvePath, tryNullCoalesce, tryTernary, valueToString };
+export { type CodeResult, type TemplateContext, type TemplateMode, type TemplateOptions, type TemplateResult, applyPipe, evaluate, renderTemplate, resolveFieldPath, resolveInput, resolvePath, tryNullCoalesce, tryTernary, valueToString };

package/dist/index.js

@@ -33,6 +33,8 @@ __export(index_exports, {
   applyPipe: () => applyPipe,
   evaluate: () => evaluate,
   renderTemplate: () => renderTemplate,
+  resolveFieldPath: () => resolveFieldPath,
+  resolveInput: () => resolveInput,
   resolvePath: () => resolvePath,
   tryNullCoalesce: () => tryNullCoalesce,
   tryTernary: () => tryTernary,
@@ -377,7 +379,9 @@ function resolveJsonValue(value, ctx, opts) {
         return !val;
       }
       if (/\|\s*\w+/.test(expr)) {
-        return evaluate(expr, ctx, opts);
+        const result = evaluate(expr, ctx, opts);
+        if (result !== "" && isFinite(Number(result))) return Number(result);
+        return result;
       }
       const resolved = resolvePath(expr, ctx);
       if (resolved !== void 0) return resolved;
@@ -531,11 +535,33 @@ function renderTemplate(template, ctx, opts) {
       return resolveTextTemplate(template, ctx, opts);
   }
 }
+
+// src/resolve-input.ts
+function resolveInput(value, payload, opts) {
+  if (value == null || value === "") return value;
+  const str = String(value);
+  const match = str.match(/^\{\{([\s\S]+)\}\}$/);
+  if (!match) return value;
+  const expr = match[1].trim();
+  const ctx = { payload, headers: {}, meta: {} };
+  const resolved = resolvePath(expr, ctx);
+  if (resolved !== void 0) return resolved;
+  const evalOpts = opts ? { allowJs: opts.allowJs, workspacePayloads: opts.workspacePayloads } : void 0;
+  const result = evaluate(expr, ctx, evalOpts);
+  if (result !== "") return result;
+  return value;
+}
+function resolveFieldPath(field) {
+  if (!field) return "";
+  return field.replace(/^\{\{\s*/, "").replace(/\s*\}\}$/, "").replace(/^payload\./, "").trim();
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   applyPipe,
   evaluate,
   renderTemplate,
+  resolveFieldPath,
+  resolveInput,
   resolvePath,
   tryNullCoalesce,
   tryTernary,

package/dist/index.mjs

@@ -335,7 +335,9 @@ function resolveJsonValue(value, ctx, opts) {
         return !val;
       }
       if (/\|\s*\w+/.test(expr)) {
-        return evaluate(expr, ctx, opts);
+        const result = evaluate(expr, ctx, opts);
+        if (result !== "" && isFinite(Number(result))) return Number(result);
+        return result;
       }
       const resolved = resolvePath(expr, ctx);
       if (resolved !== void 0) return resolved;
@@ -489,10 +491,32 @@ function renderTemplate(template, ctx, opts) {
       return resolveTextTemplate(template, ctx, opts);
   }
 }
+
+// src/resolve-input.ts
+function resolveInput(value, payload, opts) {
+  if (value == null || value === "") return value;
+  const str = String(value);
+  const match = str.match(/^\{\{([\s\S]+)\}\}$/);
+  if (!match) return value;
+  const expr = match[1].trim();
+  const ctx = { payload, headers: {}, meta: {} };
+  const resolved = resolvePath(expr, ctx);
+  if (resolved !== void 0) return resolved;
+  const evalOpts = opts ? { allowJs: opts.allowJs, workspacePayloads: opts.workspacePayloads } : void 0;
+  const result = evaluate(expr, ctx, evalOpts);
+  if (result !== "") return result;
+  return value;
+}
+function resolveFieldPath(field) {
+  if (!field) return "";
+  return field.replace(/^\{\{\s*/, "").replace(/\s*\}\}$/, "").replace(/^payload\./, "").trim();
+}
 export {
   applyPipe,
   evaluate,
   renderTemplate,
+  resolveFieldPath,
+  resolveInput,
   resolvePath,
   tryNullCoalesce,
   tryTernary,

package/package.json

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