@harborclient/sdk 1.0.54 → 1.0.55

package/dist/http/substitute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"substitute.d.ts","sourceRoot":"","sources":["../../src/http/substitute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,KAAK,QAAQ,GAAG;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAU7F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACnC,UAAU,CAWZ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EAAE,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,QAAQ,EAAE,CAKZ"}
+{"version":3,"file":"substitute.d.ts","sourceRoot":"","sources":["../../src/http/substitute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,KAAK,QAAQ,GAAG;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACnC,UAAU,CAWZ;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EAAE,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,QAAQ,EAAE,CAKZ"}

package/dist/http/substitute.js

@@ -1,5 +1,4 @@
-import { resolveDynamicVariable } from '../variables/dynamic.js';
-import { VARIABLE_TOKEN_PATTERN } from '../variables/tokens.js';
+import { substituteVariablesFromMap } from '../variables/tokens.js';
 /**
  * Replaces {{key}} placeholders using a runtime variable map.
  *
@@ -7,15 +6,7 @@ import { VARIABLE_TOKEN_PATTERN } from '../variables/tokens.js';
  * @param runtimeVars - Current runtime variable values.
  */
 export function substituteVariables(text, runtimeVars) {
-    const pattern = new RegExp(VARIABLE_TOKEN_PATTERN.source, 'g');
-    return text.replace(pattern, (match, key) => {
-        const value = runtimeVars[key];
-        if (value !== undefined) {
-            return value;
-        }
-        const dynamic = resolveDynamicVariable(key);
-        return dynamic !== undefined ? dynamic : match;
-    });
+    return substituteVariablesFromMap(text, runtimeVars);
 }
 /**
  * Resolves {{variable}} placeholders in auth credential fields.

package/dist/snippets.d.ts

@@ -11,12 +11,13 @@
  * `src/main/scripting/scriptApi.ts` and editor completions in
  * `src/renderer/src/scripting/hcCompletions.ts`.
  *
- * **Import and export** — snippets whose **Name** ends in `.js` (for example
- * `pass-testing.js` or `utils/helpers.js`) may be imported from scripts with
- * relative ESM paths: `import { fn } from './pass-testing.js'`. Use standard
- * `export function`, `export const`, and `export default` in snippet source.
- * Cross-snippet imports are resolved at send time in HarborClient; the SDK does
- * not type-check import paths between snippet files.
+ * **Import and export** — scripts or snippets whose **Name** ends in `.js` (for example
+ * `pass-testing.js`, `before.js`, or `utils/helpers.js`) may be imported from scripts with
+ * relative ESM paths: `import { fn } from './pass-testing.js'`. Import targets include
+ * the snippet library and inline scripts in the same request and collection. Use standard
+ * `export function`, `export const`, and `export default` in module source.
+ * Cross-module imports are resolved at send time in HarborClient; the SDK does
+ * not type-check import paths between snippet or inline script files.
  *
  * **Not supported:** npm package imports, `require`, and Node.js built-ins.
  * See [Request scripts — Snippets](https://harborclient.com/scripting#snippets).

package/dist/variables/filters.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A filter invocation inside a `{{ variable | filter }}` expression.
+ */
+export interface FilterCall {
+    /**
+     * Filter name (e.g. `upper`, `urlencode`).
+     */
+    name: string;
+    /**
+     * Positional arguments for future filter support; always empty for now.
+     */
+    args: string[];
+}
+/**
+ * Registry of Twig-style variable filters.
+ *
+ * Add or edit entries here to extend filter support. Each filter receives the
+ * current piped string value and an argument list (unused until arg support ships).
+ */
+export declare const FILTERS: Record<string, (value: string, args: string[]) => string>;
+/**
+ * Sorted list of registered filter names for autocomplete and documentation.
+ */
+export declare const FILTER_NAMES: string[];
+/**
+ * Pipes a resolved variable value through a chain of filters left-to-right.
+ *
+ * @param value - Resolved variable value before filtering.
+ * @param filters - Ordered filter calls from the expression.
+ * @returns Filtered value, or null when an unknown filter name is encountered.
+ */
+export declare function applyFilters(value: string, filters: FilterCall[]): string | null;
+//# sourceMappingURL=filters.d.ts.map

package/dist/variables/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/variables/filters.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAoB7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,UAA8B,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,IAAI,CAYhF"}

package/dist/variables/filters.js

@@ -0,0 +1,49 @@
+/**
+ * Registry of Twig-style variable filters.
+ *
+ * Add or edit entries here to extend filter support. Each filter receives the
+ * current piped string value and an argument list (unused until arg support ships).
+ */
+export const FILTERS = {
+    upper: (value) => value.toUpperCase(),
+    lower: (value) => value.toLowerCase(),
+    urlencode: (value) => encodeURIComponent(value),
+    trim: (value) => value.trim(),
+    length: (value) => String(value.length),
+    striptags: (value) => value.replace(/<[^>]*>/g, ''),
+    capitalize: (value) => {
+        if (value.length === 0) {
+            return value;
+        }
+        return value.charAt(0).toUpperCase() + value.slice(1).toLowerCase();
+    },
+    round: (value) => {
+        const numeric = Number(value);
+        if (Number.isNaN(numeric)) {
+            return value;
+        }
+        return String(Math.round(numeric));
+    }
+};
+/**
+ * Sorted list of registered filter names for autocomplete and documentation.
+ */
+export const FILTER_NAMES = Object.keys(FILTERS).sort();
+/**
+ * Pipes a resolved variable value through a chain of filters left-to-right.
+ *
+ * @param value - Resolved variable value before filtering.
+ * @param filters - Ordered filter calls from the expression.
+ * @returns Filtered value, or null when an unknown filter name is encountered.
+ */
+export function applyFilters(value, filters) {
+    let current = value;
+    for (const filter of filters) {
+        const handler = FILTERS[filter.name];
+        if (!handler) {
+            return null;
+        }
+        current = handler(current, filter.args);
+    }
+    return current;
+}

package/dist/variables/index.d.ts

@@ -1,3 +1,4 @@
 export { DYNAMIC_VARIABLES, DYNAMIC_VARIABLE_CATEGORIES, DYNAMIC_VARIABLE_NAMES, getDynamicVariableDescription, isDynamicVariable, resolveDynamicVariable, type DynamicVariableDefinition } from './dynamic.js';
-export { VARIABLE_NAME_CHARS, VARIABLE_TOKEN_PATTERN, getVariableTokenAtOffset, getVariableTooltipContent, resolveVariable, substituteVariables, tokenizeVariables, type VariableToken, type VariableTokenMatch, type VariableTooltipContent } from './tokens.js';
+export { FILTER_NAMES, FILTERS, applyFilters, type FilterCall } from './filters.js';
+export { VARIABLE_NAME_CHARS, VARIABLE_TOKEN_PATTERN, getVariableTokenAtOffset, getVariableTooltipContent, parseVariableTokens, resolveVariable, substituteVariables, substituteVariablesFromMap, substituteVariablesWithResolver, tokenizeVariables, type ParsedVariableToken, type VariableToken, type VariableTokenMatch, type VariableTooltipContent } from './tokens.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/variables/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/variables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/variables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,6BAA6B,EAC7B,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,+BAA+B,EAC/B,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC"}

package/dist/variables/index.js

@@ -1,2 +1,3 @@
 export { DYNAMIC_VARIABLES, DYNAMIC_VARIABLE_CATEGORIES, DYNAMIC_VARIABLE_NAMES, getDynamicVariableDescription, isDynamicVariable, resolveDynamicVariable } from './dynamic.js';
-export { VARIABLE_NAME_CHARS, VARIABLE_TOKEN_PATTERN, getVariableTokenAtOffset, getVariableTooltipContent, resolveVariable, substituteVariables, tokenizeVariables } from './tokens.js';
+export { FILTER_NAMES, FILTERS, applyFilters } from './filters.js';
+export { VARIABLE_NAME_CHARS, VARIABLE_TOKEN_PATTERN, getVariableTokenAtOffset, getVariableTooltipContent, parseVariableTokens, resolveVariable, substituteVariables, substituteVariablesFromMap, substituteVariablesWithResolver, tokenizeVariables } from './tokens.js';

package/dist/variables/tokens.d.ts

@@ -1,10 +1,22 @@
 import type { Variable } from '../types.js';
+import { type FilterCall } from './filters.js';
 /**
  * A segment of text, optionally marking a {{variable}} token.
  */
 export interface VariableToken {
     text: string;
     key?: string;
+    filters?: FilterCall[];
+}
+/**
+ * A parsed `{{ variable | filter }}` placeholder with source offsets.
+ */
+export interface ParsedVariableToken {
+    raw: string;
+    key: string;
+    filters: FilterCall[];
+    start: number;
+    end: number;
 }
 /**
  * Allowed characters inside a `{{variable}}` token name (excluding braces).
@@ -12,9 +24,16 @@ export interface VariableToken {
  */
 export declare const VARIABLE_NAME_CHARS = "\\w$.-";
 /**
- * Global regex matching `{{variableName}}` placeholders in request text.
+ * Global regex matching `{{variableName}}` and filter chains for editor highlighting.
  */
 export declare const VARIABLE_TOKEN_PATTERN: RegExp;
+/**
+ * Scans text for `{{ variable | filter }}` placeholders using a hand-written lexer.
+ *
+ * @param text - Text containing variable placeholders.
+ * @returns Parsed tokens with character offsets; malformed `{{` sequences are skipped.
+ */
+export declare function parseVariableTokens(text: string): ParsedVariableToken[];
 /**
  * Splits text into plain and {{variable}} segments.
  *
@@ -29,6 +48,7 @@ export interface VariableTokenMatch {
     key: string;
     start: number;
     end: number;
+    filters?: FilterCall[];
 }
 /**
  * Returns the variable token containing the given character offset, if any.
@@ -72,4 +92,20 @@ export declare function resolveVariable(key: string, variables: Variable[]): str
  * @returns Text with known variables substituted; unknown tokens are left unchanged.
  */
 export declare function substituteVariables(text: string, variables: Variable[]): string;
+/**
+ * Replaces {{key}} placeholders using a custom key resolver.
+ *
+ * @param text - Text containing variable placeholders.
+ * @param resolveKey - Resolver for static/runtime variables; undefined leaves token unchanged.
+ * @returns Text with known variables substituted and filters applied.
+ */
+export declare function substituteVariablesWithResolver(text: string, resolveKey: (key: string) => string | undefined): string;
+/**
+ * Replaces {{key}} placeholders using a runtime variable map.
+ *
+ * @param text - Text containing variable placeholders.
+ * @param runtimeVars - Current runtime variable values.
+ * @returns Text with known variables substituted and filters applied.
+ */
+export declare function substituteVariablesFromMap(text: string, runtimeVars: Record<string, string>): string;
 //# sourceMappingURL=tokens.d.ts.map

package/dist/variables/tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/variables/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAGlC,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAmB/D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAahG;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,QAAQ,EAAE,GACpB,sBAAsB,CAYxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAY/E"}
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/variables/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAGlC,CAAC;AA0CF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmCvE;AAyED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CA0B/D;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAkBhG;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,QAAQ,EAAE,GACpB,sBAAsB,CAYxB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,GAAG,SAAS,CAEtF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAG/E;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC9C,MAAM,CAER;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,MAAM,CAER"}

package/dist/variables/tokens.js

@@ -1,13 +1,84 @@
 import { getDynamicVariableDescription, resolveDynamicVariable } from './dynamic.js';
+import { applyFilters } from './filters.js';
 /**
  * Allowed characters inside a `{{variable}}` token name (excluding braces).
  * Includes `$` so Postman-style dynamic names such as `$randomUUID` are recognized.
  */
 export const VARIABLE_NAME_CHARS = '\\w$.-';
 /**
- * Global regex matching `{{variableName}}` placeholders in request text.
+ * Global regex matching `{{variableName}}` and filter chains for editor highlighting.
  */
-export const VARIABLE_TOKEN_PATTERN = new RegExp(`\\{\\{\\s*([${VARIABLE_NAME_CHARS}]+)\\s*\\}\\}`, 'g');
+export const VARIABLE_TOKEN_PATTERN = new RegExp(`\\{\\{\\s*([${VARIABLE_NAME_CHARS}]+)(\\s*\\|\\s*[${VARIABLE_NAME_CHARS}]+)*\\s*\\}\\}`, 'g');
+const VALID_NAME_PATTERN = new RegExp(`^[${VARIABLE_NAME_CHARS}]+$`);
+/**
+ * Returns whether a variable key or filter name uses only allowed characters.
+ *
+ * @param name - Identifier from inside `{{...}}` braces.
+ */
+function isValidName(name) {
+    return name.length > 0 && VALID_NAME_PATTERN.test(name);
+}
+/**
+ * Parses the inner expression of a `{{...}}` token into a key and filter chain.
+ *
+ * @param inner - Text between opening and closing braces.
+ * @returns Parsed key and filters, or null when malformed.
+ */
+function parseVariableExpression(inner) {
+    const segments = inner.split('|').map((segment) => segment.trim());
+    if (segments.length === 0 || segments[0] === '') {
+        return null;
+    }
+    const key = segments[0];
+    if (!isValidName(key)) {
+        return null;
+    }
+    const filters = [];
+    for (let i = 1; i < segments.length; i++) {
+        const name = segments[i];
+        if (!isValidName(name)) {
+            return null;
+        }
+        filters.push({ name, args: [] });
+    }
+    return { key, filters };
+}
+/**
+ * Scans text for `{{ variable | filter }}` placeholders using a hand-written lexer.
+ *
+ * @param text - Text containing variable placeholders.
+ * @returns Parsed tokens with character offsets; malformed `{{` sequences are skipped.
+ */
+export function parseVariableTokens(text) {
+    const tokens = [];
+    let index = 0;
+    while (index < text.length) {
+        const open = text.indexOf('{{', index);
+        if (open === -1) {
+            break;
+        }
+        const close = text.indexOf('}}', open + 2);
+        if (close === -1) {
+            break;
+        }
+        const raw = text.slice(open, close + 2);
+        const inner = text.slice(open + 2, close);
+        const parsed = parseVariableExpression(inner);
+        if (parsed) {
+            tokens.push({
+                raw,
+                key: parsed.key,
+                filters: parsed.filters,
+                start: open,
+                end: close + 2
+            });
+            index = close + 2;
+            continue;
+        }
+        index = open + 2;
+    }
+    return tokens;
+}
 /**
  * Builds a lookup map from collection variables.
  *
@@ -19,6 +90,51 @@ function variableLookup(variables) {
         .filter((v) => v.key.trim())
         .map((v) => [v.key.trim(), v.value !== '' ? v.value : v.defaultValue]));
 }
+/**
+ * Resolves a variable key to a string value using a lookup function and dynamic variables.
+ *
+ * @param key - Base variable name from a parsed token.
+ * @param resolveKey - Resolver for static/runtime variables.
+ * @returns Resolved value, or undefined when the key is not defined.
+ */
+function resolveKeyValue(key, resolveKey) {
+    const value = resolveKey(key);
+    if (value !== undefined) {
+        return value;
+    }
+    return resolveDynamicVariable(key);
+}
+/**
+ * Substitutes parsed variable tokens in text using a key resolver.
+ *
+ * Unknown variables and unknown filters leave the original token unchanged.
+ *
+ * @param text - Text containing variable placeholders.
+ * @param resolveKey - Resolver for static/runtime variables.
+ * @returns Text with known variables substituted and filters applied.
+ */
+function substituteWithResolver(text, resolveKey) {
+    const parsedTokens = parseVariableTokens(text);
+    if (parsedTokens.length === 0) {
+        return text;
+    }
+    let result = '';
+    let lastIndex = 0;
+    for (const token of parsedTokens) {
+        result += text.slice(lastIndex, token.start);
+        const resolved = resolveKeyValue(token.key, resolveKey);
+        if (resolved === undefined) {
+            result += token.raw;
+        }
+        else {
+            const filtered = applyFilters(resolved, token.filters);
+            result += filtered ?? token.raw;
+        }
+        lastIndex = token.end;
+    }
+    result += text.slice(lastIndex);
+    return result;
+}
 /**
  * Splits text into plain and {{variable}} segments.
  *
@@ -26,16 +142,22 @@ function variableLookup(variables) {
  * @returns Ordered tokens for rendering or further processing.
  */
 export function tokenizeVariables(text) {
+    const parsedTokens = parseVariableTokens(text);
+    if (parsedTokens.length === 0) {
+        return [{ text }];
+    }
     const tokens = [];
-    const pattern = new RegExp(VARIABLE_TOKEN_PATTERN.source, 'g');
     let lastIndex = 0;
-    for (const match of text.matchAll(pattern)) {
-        const index = match.index ?? 0;
-        if (index > lastIndex) {
-            tokens.push({ text: text.slice(lastIndex, index) });
+    for (const token of parsedTokens) {
+        if (token.start > lastIndex) {
+            tokens.push({ text: text.slice(lastIndex, token.start) });
         }
-        tokens.push({ text: match[0], key: match[1] });
-        lastIndex = index + match[0].length;
+        tokens.push({
+            text: token.raw,
+            key: token.key,
+            filters: token.filters.length > 0 ? token.filters : undefined
+        });
+        lastIndex = token.end;
     }
     if (lastIndex < text.length) {
         tokens.push({ text: text.slice(lastIndex) });
@@ -55,7 +177,12 @@ export function getVariableTokenAtOffset(text, offset) {
         const start = position;
         const end = position + token.text.length;
         if (token.key && offset >= start && offset <= end) {
-            return { key: token.key, start, end };
+            return {
+                key: token.key,
+                start,
+                end,
+                filters: token.filters
+            };
         }
         position = end;
     }
@@ -101,13 +228,25 @@ export function resolveVariable(key, variables) {
  */
 export function substituteVariables(text, variables) {
     const lookup = variableLookup(variables);
-    const pattern = new RegExp(VARIABLE_TOKEN_PATTERN.source, 'g');
-    return text.replace(pattern, (match, key) => {
-        const value = lookup.get(key);
-        if (value !== undefined) {
-            return value;
-        }
-        const dynamic = resolveDynamicVariable(key);
-        return dynamic !== undefined ? dynamic : match;
-    });
+    return substituteWithResolver(text, (key) => lookup.get(key));
+}
+/**
+ * Replaces {{key}} placeholders using a custom key resolver.
+ *
+ * @param text - Text containing variable placeholders.
+ * @param resolveKey - Resolver for static/runtime variables; undefined leaves token unchanged.
+ * @returns Text with known variables substituted and filters applied.
+ */
+export function substituteVariablesWithResolver(text, resolveKey) {
+    return substituteWithResolver(text, resolveKey);
+}
+/**
+ * Replaces {{key}} placeholders using a runtime variable map.
+ *
+ * @param text - Text containing variable placeholders.
+ * @param runtimeVars - Current runtime variable values.
+ * @returns Text with known variables substituted and filters applied.
+ */
+export function substituteVariablesFromMap(text, runtimeVars) {
+    return substituteWithResolver(text, (key) => runtimeVars[key]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harborclient/sdk",
-  "version": "1.0.54",
+  "version": "1.0.55",
   "description": "TypeScript SDK for HarborClient development.",
   "keywords": [
     "harborclient",