@n8n/utils 1.28.1 → 1.30.0

package/dist/index.cjs

@@ -10,12 +10,19 @@ const require_sortByProperty = require('./sortByProperty.cjs');
 const require_truncate = require('./truncate.cjs');
 const require_sanitize = require('./sanitize.cjs');
 const require_path = require('./path.cjs');
+const require_placeholder = require('./placeholder2.cjs');
 
 exports.DEFAULT_KEYS = require_sublimeSearch.DEFAULT_KEYS;
 exports.assert = require_assert.assert;
 exports.createEventBus = require_event_bus.createEventBus;
 exports.createEventQueue = require_event_queue.createEventQueue;
+exports.extractPlaceholderLabels = require_placeholder.extractPlaceholderLabels;
+exports.findPlaceholderDetails = require_placeholder.findPlaceholderDetails;
+exports.formatPlaceholderPath = require_placeholder.formatPlaceholderPath;
 exports.generateNanoId = require_workflowId.generateNanoId;
+exports.hasPlaceholderDeep = require_placeholder.hasPlaceholderDeep;
+exports.isPlaceholderString = require_placeholder.isPlaceholderString;
+exports.isPlaceholderValue = require_placeholder.isPlaceholderValue;
 exports.isWindowsFilePath = require_path.isWindowsFilePath;
 exports.reRankSearchResults = require_reRankSearchResults.reRankSearchResults;
 exports.retry = require_retry.retry;

package/dist/index.d.cts

@@ -10,4 +10,5 @@ import { t as reRankSearchResults } from "./reRankSearchResults.cjs";
 import { n as sublimeSearch, t as DEFAULT_KEYS } from "./sublimeSearch.cjs";
 import { t as sortByProperty } from "./sortByProperty.cjs";
 import { n as truncateBeforeLast, t as truncate } from "./truncate.cjs";
-export { CallbackFn, DEFAULT_KEYS, EventBus, assert, createEventBus, createEventQueue, generateNanoId, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };
+import { a as hasPlaceholderDeep, i as formatPlaceholderPath, n as extractPlaceholderLabels, o as isPlaceholderString, r as findPlaceholderDetails, s as isPlaceholderValue, t as PlaceholderDetail } from "./placeholder2.cjs";
+export { CallbackFn, DEFAULT_KEYS, EventBus, PlaceholderDetail, assert, createEventBus, createEventQueue, extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, generateNanoId, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/index.d.mts

@@ -10,4 +10,5 @@ import { t as reRankSearchResults } from "./reRankSearchResults.mjs";
 import { n as sublimeSearch, t as DEFAULT_KEYS } from "./sublimeSearch.mjs";
 import { t as sortByProperty } from "./sortByProperty.mjs";
 import { n as truncateBeforeLast, t as truncate } from "./truncate.mjs";
-export { CallbackFn, DEFAULT_KEYS, EventBus, assert, createEventBus, createEventQueue, generateNanoId, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };
+import { a as hasPlaceholderDeep, i as formatPlaceholderPath, n as extractPlaceholderLabels, o as isPlaceholderString, r as findPlaceholderDetails, s as isPlaceholderValue, t as PlaceholderDetail } from "./placeholder2.mjs";
+export { CallbackFn, DEFAULT_KEYS, EventBus, PlaceholderDetail, assert, createEventBus, createEventQueue, extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, generateNanoId, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/index.mjs

@@ -10,5 +10,6 @@ import { t as sortByProperty } from "./sortByProperty.mjs";
 import { n as truncateBeforeLast, t as truncate } from "./truncate.mjs";
 import { t as sanitizeFilename } from "./sanitize.mjs";
 import { t as isWindowsFilePath } from "./path.mjs";
+import { a as isPlaceholderString, i as hasPlaceholderDeep, n as findPlaceholderDetails, o as isPlaceholderValue, r as formatPlaceholderPath, t as extractPlaceholderLabels } from "./placeholder2.mjs";
 
-export { DEFAULT_KEYS, assert, createEventBus, createEventQueue, generateNanoId, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };
+export { DEFAULT_KEYS, assert, createEventBus, createEventQueue, extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, generateNanoId, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue, isWindowsFilePath, reRankSearchResults, retry, sanitizeFilename, smartDecimal, sortByProperty, sublimeSearch, truncate, truncateBeforeLast };

package/dist/placeholder.cjs

@@ -0,0 +1,8 @@
+const require_placeholder = require('./placeholder2.cjs');
+
+exports.extractPlaceholderLabels = require_placeholder.extractPlaceholderLabels;
+exports.findPlaceholderDetails = require_placeholder.findPlaceholderDetails;
+exports.formatPlaceholderPath = require_placeholder.formatPlaceholderPath;
+exports.hasPlaceholderDeep = require_placeholder.hasPlaceholderDeep;
+exports.isPlaceholderString = require_placeholder.isPlaceholderString;
+exports.isPlaceholderValue = require_placeholder.isPlaceholderValue;

package/dist/placeholder.d.cts

@@ -0,0 +1,2 @@
+import { a as hasPlaceholderDeep, i as formatPlaceholderPath, n as extractPlaceholderLabels, o as isPlaceholderString, r as findPlaceholderDetails, s as isPlaceholderValue, t as PlaceholderDetail } from "./placeholder2.cjs";
+export { PlaceholderDetail, extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue };

package/dist/placeholder.d.mts

@@ -0,0 +1,2 @@
+import { a as hasPlaceholderDeep, i as formatPlaceholderPath, n as extractPlaceholderLabels, o as isPlaceholderString, r as findPlaceholderDetails, s as isPlaceholderValue, t as PlaceholderDetail } from "./placeholder2.mjs";
+export { PlaceholderDetail, extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue };

package/dist/placeholder.mjs

@@ -0,0 +1,3 @@
+import { a as isPlaceholderString, i as hasPlaceholderDeep, n as findPlaceholderDetails, o as isPlaceholderValue, r as formatPlaceholderPath, t as extractPlaceholderLabels } from "./placeholder2.mjs";
+
+export { extractPlaceholderLabels, findPlaceholderDetails, formatPlaceholderPath, hasPlaceholderDeep, isPlaceholderString, isPlaceholderValue };

package/dist/placeholder2.cjs

@@ -0,0 +1,111 @@
+
+//#region src/placeholder.ts
+const PLACEHOLDER_SUFFIX = "__>";
+const PLACEHOLDER_VALUE_PREFIX = "<__PLACEHOLDER_VALUE__";
+const PLACEHOLDER_REGEX = /<__PLACEHOLDER.*?__>/;
+/** Check if a value is a placeholder sentinel string (format: `<__PLACEHOLDER_VALUE__hint__>`). */
+function isPlaceholderString(value) {
+	return typeof value === "string" && value.startsWith(PLACEHOLDER_VALUE_PREFIX) && value.endsWith(PLACEHOLDER_SUFFIX);
+}
+/** Recursively check if a value (string, array, or object) contains any placeholder sentinel strings. */
+function hasPlaceholderDeep(value) {
+	if (typeof value === "string") return isPlaceholderString(value);
+	if (Array.isArray(value)) return value.some(hasPlaceholderDeep);
+	if (value !== null && typeof value === "object") return Object.values(value).some(hasPlaceholderDeep);
+	return false;
+}
+/** Checks if a value is a placeholder value (matches the placeholder regex pattern). */
+function isPlaceholderValue(value) {
+	if (typeof value !== "string") return false;
+	return !!value.match(PLACEHOLDER_REGEX);
+}
+/**
+* Extracts the label from a single placeholder string.
+* Handles formats like:
+* - <__PLACEHOLDER_VALUE__label__>
+* - <__PLACEHOLDER__: label__>
+*/
+function extractLabelFromPlaceholder(placeholder) {
+	let label = placeholder.slice(14, -3);
+	if (label.startsWith("_VALUE__")) label = label.slice(8);
+	else if (label.startsWith("__:")) label = label.slice(3);
+	else if (label.startsWith("__")) label = label.slice(2);
+	return label.trim();
+}
+/**
+* Extracts all placeholder labels from a string value.
+* Handles both cases where the entire value is a placeholder and where
+* placeholders are embedded within code (e.g., Code node).
+* Returns an array of labels found.
+*/
+function extractPlaceholderLabels(value) {
+	if (typeof value !== "string") return [];
+	const labels = [];
+	const regex = new RegExp(PLACEHOLDER_REGEX.source, "g");
+	let match;
+	while ((match = regex.exec(value)) !== null) {
+		const label = extractLabelFromPlaceholder(match[0]);
+		if (label.length > 0) labels.push(label);
+	}
+	return labels;
+}
+/**
+* Recursively searches through a value (object, array, or primitive) to find
+* all placeholder values and their paths.
+*/
+function findPlaceholderDetails(value, path = []) {
+	if (typeof value === "string") return extractPlaceholderLabels(value).map((label) => ({
+		path,
+		label
+	}));
+	if (Array.isArray(value)) return value.flatMap((item, index) => findPlaceholderDetails(item, [...path, `[${index}]`]));
+	if (value !== null && typeof value === "object") return Object.entries(value).flatMap(([key, nested]) => findPlaceholderDetails(nested, [...path, key]));
+	return [];
+}
+/**
+* Formats a path array into a dot-notation string for display.
+* Array indices are preserved as [N] without leading dots.
+*/
+function formatPlaceholderPath(path) {
+	if (path.length === 0) return "parameters";
+	return path.map((segment, index) => segment.startsWith("[") || index === 0 ? segment : `.${segment}`).join("");
+}
+
+//#endregion
+Object.defineProperty(exports, 'extractPlaceholderLabels', {
+  enumerable: true,
+  get: function () {
+    return extractPlaceholderLabels;
+  }
+});
+Object.defineProperty(exports, 'findPlaceholderDetails', {
+  enumerable: true,
+  get: function () {
+    return findPlaceholderDetails;
+  }
+});
+Object.defineProperty(exports, 'formatPlaceholderPath', {
+  enumerable: true,
+  get: function () {
+    return formatPlaceholderPath;
+  }
+});
+Object.defineProperty(exports, 'hasPlaceholderDeep', {
+  enumerable: true,
+  get: function () {
+    return hasPlaceholderDeep;
+  }
+});
+Object.defineProperty(exports, 'isPlaceholderString', {
+  enumerable: true,
+  get: function () {
+    return isPlaceholderString;
+  }
+});
+Object.defineProperty(exports, 'isPlaceholderValue', {
+  enumerable: true,
+  get: function () {
+    return isPlaceholderValue;
+  }
+});
+//# sourceMappingURL=placeholder2.cjs.map

package/dist/placeholder2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder2.cjs","names":["labels: string[]"],"sources":["../src/placeholder.ts"],"sourcesContent":["const PLACEHOLDER_PREFIX = '<__PLACEHOLDER';\nconst PLACEHOLDER_SUFFIX = '__>';\nconst PLACEHOLDER_VALUE_PREFIX = '<__PLACEHOLDER_VALUE__';\n\nconst PLACEHOLDER_REGEX = /<__PLACEHOLDER.*?__>/;\n\nexport interface PlaceholderDetail {\n\tpath: string[];\n\tlabel: string;\n}\n\n/** Check if a value is a placeholder sentinel string (format: `<__PLACEHOLDER_VALUE__hint__>`). */\nexport function isPlaceholderString(value: unknown): boolean {\n\treturn (\n\t\ttypeof value === 'string' &&\n\t\tvalue.startsWith(PLACEHOLDER_VALUE_PREFIX) &&\n\t\tvalue.endsWith(PLACEHOLDER_SUFFIX)\n\t);\n}\n\n/** Recursively check if a value (string, array, or object) contains any placeholder sentinel strings. */\nexport function hasPlaceholderDeep(value: unknown): boolean {\n\tif (typeof value === 'string') return isPlaceholderString(value);\n\tif (Array.isArray(value)) return value.some(hasPlaceholderDeep);\n\tif (value !== null && typeof value === 'object') {\n\t\treturn Object.values(value as Record<string, unknown>).some(hasPlaceholderDeep);\n\t}\n\treturn false;\n}\n\n/** Checks if a value is a placeholder value (matches the placeholder regex pattern). */\nexport function isPlaceholderValue(value: unknown): boolean {\n\tif (typeof value !== 'string') return false;\n\treturn !!value.match(PLACEHOLDER_REGEX);\n}\n\n/**\n * Extracts the label from a single placeholder string.\n * Handles formats like:\n * - <__PLACEHOLDER_VALUE__label__>\n * - <__PLACEHOLDER__: label__>\n */\nfunction extractLabelFromPlaceholder(placeholder: string): string {\n\tlet label = placeholder.slice(PLACEHOLDER_PREFIX.length, -PLACEHOLDER_SUFFIX.length);\n\n\tif (label.startsWith('_VALUE__')) {\n\t\tlabel = label.slice('_VALUE__'.length);\n\t} else if (label.startsWith('__:')) {\n\t\tlabel = label.slice('__:'.length);\n\t} else if (label.startsWith('__')) {\n\t\tlabel = label.slice('__'.length);\n\t}\n\n\treturn label.trim();\n}\n\n/**\n * Extracts all placeholder labels from a string value.\n * Handles both cases where the entire value is a placeholder and where\n * placeholders are embedded within code (e.g., Code node).\n * Returns an array of labels found.\n */\nexport function extractPlaceholderLabels(value: unknown): string[] {\n\tif (typeof value !== 'string') return [];\n\n\tconst labels: string[] = [];\n\tconst regex = new RegExp(PLACEHOLDER_REGEX.source, 'g');\n\tlet match;\n\n\twhile ((match = regex.exec(value)) !== null) {\n\t\tconst label = extractLabelFromPlaceholder(match[0]);\n\t\tif (label.length > 0) {\n\t\t\tlabels.push(label);\n\t\t}\n\t}\n\n\treturn labels;\n}\n\n/**\n * Recursively searches through a value (object, array, or primitive) to find\n * all placeholder values and their paths.\n */\nexport function findPlaceholderDetails(value: unknown, path: string[] = []): PlaceholderDetail[] {\n\tif (typeof value === 'string') {\n\t\tconst labels = extractPlaceholderLabels(value);\n\t\treturn labels.map((label) => ({ path, label }));\n\t}\n\n\tif (Array.isArray(value)) {\n\t\treturn value.flatMap((item, index) => findPlaceholderDetails(item, [...path, `[${index}]`]));\n\t}\n\n\tif (value !== null && typeof value === 'object') {\n\t\treturn Object.entries(value).flatMap(([key, nested]) =>\n\t\t\tfindPlaceholderDetails(nested, [...path, key]),\n\t\t);\n\t}\n\n\treturn [];\n}\n\n/**\n * Formats a path array into a dot-notation string for display.\n * Array indices are preserved as [N] without leading dots.\n */\nexport function formatPlaceholderPath(path: string[]): string {\n\tif (path.length === 0) return 'parameters';\n\n\treturn path\n\t\t.map((segment, index) => (segment.startsWith('[') || index === 0 ? segment : `.${segment}`))\n\t\t.join('');\n}\n"],"mappings":";;AACA,MAAM,qBAAqB;AAC3B,MAAM,2BAA2B;AAEjC,MAAM,oBAAoB;;AAQ1B,SAAgB,oBAAoB,OAAyB;AAC5D,QACC,OAAO,UAAU,YACjB,MAAM,WAAW,yBAAyB,IAC1C,MAAM,SAAS,mBAAmB;;;AAKpC,SAAgB,mBAAmB,OAAyB;AAC3D,KAAI,OAAO,UAAU,SAAU,QAAO,oBAAoB,MAAM;AAChE,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,KAAK,mBAAmB;AAC/D,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO,OAAO,OAAO,MAAiC,CAAC,KAAK,mBAAmB;AAEhF,QAAO;;;AAIR,SAAgB,mBAAmB,OAAyB;AAC3D,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAO,CAAC,CAAC,MAAM,MAAM,kBAAkB;;;;;;;;AASxC,SAAS,4BAA4B,aAA6B;CACjE,IAAI,QAAQ,YAAY,MAAM,IAA2B,GAA2B;AAEpF,KAAI,MAAM,WAAW,WAAW,CAC/B,SAAQ,MAAM,MAAM,EAAkB;UAC5B,MAAM,WAAW,MAAM,CACjC,SAAQ,MAAM,MAAM,EAAa;UACvB,MAAM,WAAW,KAAK,CAChC,SAAQ,MAAM,MAAM,EAAY;AAGjC,QAAO,MAAM,MAAM;;;;;;;;AASpB,SAAgB,yBAAyB,OAA0B;AAClE,KAAI,OAAO,UAAU,SAAU,QAAO,EAAE;CAExC,MAAMA,SAAmB,EAAE;CAC3B,MAAM,QAAQ,IAAI,OAAO,kBAAkB,QAAQ,IAAI;CACvD,IAAI;AAEJ,SAAQ,QAAQ,MAAM,KAAK,MAAM,MAAM,MAAM;EAC5C,MAAM,QAAQ,4BAA4B,MAAM,GAAG;AACnD,MAAI,MAAM,SAAS,EAClB,QAAO,KAAK,MAAM;;AAIpB,QAAO;;;;;;AAOR,SAAgB,uBAAuB,OAAgB,OAAiB,EAAE,EAAuB;AAChG,KAAI,OAAO,UAAU,SAEpB,QADe,yBAAyB,MAAM,CAChC,KAAK,WAAW;EAAE;EAAM;EAAO,EAAE;AAGhD,KAAI,MAAM,QAAQ,MAAM,CACvB,QAAO,MAAM,SAAS,MAAM,UAAU,uBAAuB,MAAM,CAAC,GAAG,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC;AAG7F,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO,OAAO,QAAQ,MAAM,CAAC,SAAS,CAAC,KAAK,YAC3C,uBAAuB,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,CAC9C;AAGF,QAAO,EAAE;;;;;;AAOV,SAAgB,sBAAsB,MAAwB;AAC7D,KAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAO,KACL,KAAK,SAAS,UAAW,QAAQ,WAAW,IAAI,IAAI,UAAU,IAAI,UAAU,IAAI,UAAW,CAC3F,KAAK,GAAG"}

package/dist/placeholder2.d.cts

@@ -0,0 +1,14 @@
+//#region src/placeholder.d.ts
+interface PlaceholderDetail {
+  path: string[];
+  label: string;
+}
+declare function isPlaceholderString(value: unknown): boolean;
+declare function hasPlaceholderDeep(value: unknown): boolean;
+declare function isPlaceholderValue(value: unknown): boolean;
+declare function extractPlaceholderLabels(value: unknown): string[];
+declare function findPlaceholderDetails(value: unknown, path?: string[]): PlaceholderDetail[];
+declare function formatPlaceholderPath(path: string[]): string;
+//#endregion
+export { hasPlaceholderDeep as a, formatPlaceholderPath as i, extractPlaceholderLabels as n, isPlaceholderString as o, findPlaceholderDetails as r, isPlaceholderValue as s, PlaceholderDetail as t };
+//# sourceMappingURL=placeholder2.d.cts.map

package/dist/placeholder2.d.mts

@@ -0,0 +1,14 @@
+//#region src/placeholder.d.ts
+interface PlaceholderDetail {
+  path: string[];
+  label: string;
+}
+declare function isPlaceholderString(value: unknown): boolean;
+declare function hasPlaceholderDeep(value: unknown): boolean;
+declare function isPlaceholderValue(value: unknown): boolean;
+declare function extractPlaceholderLabels(value: unknown): string[];
+declare function findPlaceholderDetails(value: unknown, path?: string[]): PlaceholderDetail[];
+declare function formatPlaceholderPath(path: string[]): string;
+//#endregion
+export { hasPlaceholderDeep as a, formatPlaceholderPath as i, extractPlaceholderLabels as n, isPlaceholderString as o, findPlaceholderDetails as r, isPlaceholderValue as s, PlaceholderDetail as t };
+//# sourceMappingURL=placeholder2.d.mts.map

package/dist/placeholder2.mjs

@@ -0,0 +1,75 @@
+//#region src/placeholder.ts
+const PLACEHOLDER_SUFFIX = "__>";
+const PLACEHOLDER_VALUE_PREFIX = "<__PLACEHOLDER_VALUE__";
+const PLACEHOLDER_REGEX = /<__PLACEHOLDER.*?__>/;
+/** Check if a value is a placeholder sentinel string (format: `<__PLACEHOLDER_VALUE__hint__>`). */
+function isPlaceholderString(value) {
+	return typeof value === "string" && value.startsWith(PLACEHOLDER_VALUE_PREFIX) && value.endsWith(PLACEHOLDER_SUFFIX);
+}
+/** Recursively check if a value (string, array, or object) contains any placeholder sentinel strings. */
+function hasPlaceholderDeep(value) {
+	if (typeof value === "string") return isPlaceholderString(value);
+	if (Array.isArray(value)) return value.some(hasPlaceholderDeep);
+	if (value !== null && typeof value === "object") return Object.values(value).some(hasPlaceholderDeep);
+	return false;
+}
+/** Checks if a value is a placeholder value (matches the placeholder regex pattern). */
+function isPlaceholderValue(value) {
+	if (typeof value !== "string") return false;
+	return !!value.match(PLACEHOLDER_REGEX);
+}
+/**
+* Extracts the label from a single placeholder string.
+* Handles formats like:
+* - <__PLACEHOLDER_VALUE__label__>
+* - <__PLACEHOLDER__: label__>
+*/
+function extractLabelFromPlaceholder(placeholder) {
+	let label = placeholder.slice(14, -3);
+	if (label.startsWith("_VALUE__")) label = label.slice(8);
+	else if (label.startsWith("__:")) label = label.slice(3);
+	else if (label.startsWith("__")) label = label.slice(2);
+	return label.trim();
+}
+/**
+* Extracts all placeholder labels from a string value.
+* Handles both cases where the entire value is a placeholder and where
+* placeholders are embedded within code (e.g., Code node).
+* Returns an array of labels found.
+*/
+function extractPlaceholderLabels(value) {
+	if (typeof value !== "string") return [];
+	const labels = [];
+	const regex = new RegExp(PLACEHOLDER_REGEX.source, "g");
+	let match;
+	while ((match = regex.exec(value)) !== null) {
+		const label = extractLabelFromPlaceholder(match[0]);
+		if (label.length > 0) labels.push(label);
+	}
+	return labels;
+}
+/**
+* Recursively searches through a value (object, array, or primitive) to find
+* all placeholder values and their paths.
+*/
+function findPlaceholderDetails(value, path = []) {
+	if (typeof value === "string") return extractPlaceholderLabels(value).map((label) => ({
+		path,
+		label
+	}));
+	if (Array.isArray(value)) return value.flatMap((item, index) => findPlaceholderDetails(item, [...path, `[${index}]`]));
+	if (value !== null && typeof value === "object") return Object.entries(value).flatMap(([key, nested]) => findPlaceholderDetails(nested, [...path, key]));
+	return [];
+}
+/**
+* Formats a path array into a dot-notation string for display.
+* Array indices are preserved as [N] without leading dots.
+*/
+function formatPlaceholderPath(path) {
+	if (path.length === 0) return "parameters";
+	return path.map((segment, index) => segment.startsWith("[") || index === 0 ? segment : `.${segment}`).join("");
+}
+
+//#endregion
+export { isPlaceholderString as a, hasPlaceholderDeep as i, findPlaceholderDetails as n, isPlaceholderValue as o, formatPlaceholderPath as r, extractPlaceholderLabels as t };
+//# sourceMappingURL=placeholder2.mjs.map

package/dist/placeholder2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder2.mjs","names":["labels: string[]"],"sources":["../src/placeholder.ts"],"sourcesContent":["const PLACEHOLDER_PREFIX = '<__PLACEHOLDER';\nconst PLACEHOLDER_SUFFIX = '__>';\nconst PLACEHOLDER_VALUE_PREFIX = '<__PLACEHOLDER_VALUE__';\n\nconst PLACEHOLDER_REGEX = /<__PLACEHOLDER.*?__>/;\n\nexport interface PlaceholderDetail {\n\tpath: string[];\n\tlabel: string;\n}\n\n/** Check if a value is a placeholder sentinel string (format: `<__PLACEHOLDER_VALUE__hint__>`). */\nexport function isPlaceholderString(value: unknown): boolean {\n\treturn (\n\t\ttypeof value === 'string' &&\n\t\tvalue.startsWith(PLACEHOLDER_VALUE_PREFIX) &&\n\t\tvalue.endsWith(PLACEHOLDER_SUFFIX)\n\t);\n}\n\n/** Recursively check if a value (string, array, or object) contains any placeholder sentinel strings. */\nexport function hasPlaceholderDeep(value: unknown): boolean {\n\tif (typeof value === 'string') return isPlaceholderString(value);\n\tif (Array.isArray(value)) return value.some(hasPlaceholderDeep);\n\tif (value !== null && typeof value === 'object') {\n\t\treturn Object.values(value as Record<string, unknown>).some(hasPlaceholderDeep);\n\t}\n\treturn false;\n}\n\n/** Checks if a value is a placeholder value (matches the placeholder regex pattern). */\nexport function isPlaceholderValue(value: unknown): boolean {\n\tif (typeof value !== 'string') return false;\n\treturn !!value.match(PLACEHOLDER_REGEX);\n}\n\n/**\n * Extracts the label from a single placeholder string.\n * Handles formats like:\n * - <__PLACEHOLDER_VALUE__label__>\n * - <__PLACEHOLDER__: label__>\n */\nfunction extractLabelFromPlaceholder(placeholder: string): string {\n\tlet label = placeholder.slice(PLACEHOLDER_PREFIX.length, -PLACEHOLDER_SUFFIX.length);\n\n\tif (label.startsWith('_VALUE__')) {\n\t\tlabel = label.slice('_VALUE__'.length);\n\t} else if (label.startsWith('__:')) {\n\t\tlabel = label.slice('__:'.length);\n\t} else if (label.startsWith('__')) {\n\t\tlabel = label.slice('__'.length);\n\t}\n\n\treturn label.trim();\n}\n\n/**\n * Extracts all placeholder labels from a string value.\n * Handles both cases where the entire value is a placeholder and where\n * placeholders are embedded within code (e.g., Code node).\n * Returns an array of labels found.\n */\nexport function extractPlaceholderLabels(value: unknown): string[] {\n\tif (typeof value !== 'string') return [];\n\n\tconst labels: string[] = [];\n\tconst regex = new RegExp(PLACEHOLDER_REGEX.source, 'g');\n\tlet match;\n\n\twhile ((match = regex.exec(value)) !== null) {\n\t\tconst label = extractLabelFromPlaceholder(match[0]);\n\t\tif (label.length > 0) {\n\t\t\tlabels.push(label);\n\t\t}\n\t}\n\n\treturn labels;\n}\n\n/**\n * Recursively searches through a value (object, array, or primitive) to find\n * all placeholder values and their paths.\n */\nexport function findPlaceholderDetails(value: unknown, path: string[] = []): PlaceholderDetail[] {\n\tif (typeof value === 'string') {\n\t\tconst labels = extractPlaceholderLabels(value);\n\t\treturn labels.map((label) => ({ path, label }));\n\t}\n\n\tif (Array.isArray(value)) {\n\t\treturn value.flatMap((item, index) => findPlaceholderDetails(item, [...path, `[${index}]`]));\n\t}\n\n\tif (value !== null && typeof value === 'object') {\n\t\treturn Object.entries(value).flatMap(([key, nested]) =>\n\t\t\tfindPlaceholderDetails(nested, [...path, key]),\n\t\t);\n\t}\n\n\treturn [];\n}\n\n/**\n * Formats a path array into a dot-notation string for display.\n * Array indices are preserved as [N] without leading dots.\n */\nexport function formatPlaceholderPath(path: string[]): string {\n\tif (path.length === 0) return 'parameters';\n\n\treturn path\n\t\t.map((segment, index) => (segment.startsWith('[') || index === 0 ? segment : `.${segment}`))\n\t\t.join('');\n}\n"],"mappings":";AACA,MAAM,qBAAqB;AAC3B,MAAM,2BAA2B;AAEjC,MAAM,oBAAoB;;AAQ1B,SAAgB,oBAAoB,OAAyB;AAC5D,QACC,OAAO,UAAU,YACjB,MAAM,WAAW,yBAAyB,IAC1C,MAAM,SAAS,mBAAmB;;;AAKpC,SAAgB,mBAAmB,OAAyB;AAC3D,KAAI,OAAO,UAAU,SAAU,QAAO,oBAAoB,MAAM;AAChE,KAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,MAAM,KAAK,mBAAmB;AAC/D,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO,OAAO,OAAO,MAAiC,CAAC,KAAK,mBAAmB;AAEhF,QAAO;;;AAIR,SAAgB,mBAAmB,OAAyB;AAC3D,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAO,CAAC,CAAC,MAAM,MAAM,kBAAkB;;;;;;;;AASxC,SAAS,4BAA4B,aAA6B;CACjE,IAAI,QAAQ,YAAY,MAAM,IAA2B,GAA2B;AAEpF,KAAI,MAAM,WAAW,WAAW,CAC/B,SAAQ,MAAM,MAAM,EAAkB;UAC5B,MAAM,WAAW,MAAM,CACjC,SAAQ,MAAM,MAAM,EAAa;UACvB,MAAM,WAAW,KAAK,CAChC,SAAQ,MAAM,MAAM,EAAY;AAGjC,QAAO,MAAM,MAAM;;;;;;;;AASpB,SAAgB,yBAAyB,OAA0B;AAClE,KAAI,OAAO,UAAU,SAAU,QAAO,EAAE;CAExC,MAAMA,SAAmB,EAAE;CAC3B,MAAM,QAAQ,IAAI,OAAO,kBAAkB,QAAQ,IAAI;CACvD,IAAI;AAEJ,SAAQ,QAAQ,MAAM,KAAK,MAAM,MAAM,MAAM;EAC5C,MAAM,QAAQ,4BAA4B,MAAM,GAAG;AACnD,MAAI,MAAM,SAAS,EAClB,QAAO,KAAK,MAAM;;AAIpB,QAAO;;;;;;AAOR,SAAgB,uBAAuB,OAAgB,OAAiB,EAAE,EAAuB;AAChG,KAAI,OAAO,UAAU,SAEpB,QADe,yBAAyB,MAAM,CAChC,KAAK,WAAW;EAAE;EAAM;EAAO,EAAE;AAGhD,KAAI,MAAM,QAAQ,MAAM,CACvB,QAAO,MAAM,SAAS,MAAM,UAAU,uBAAuB,MAAM,CAAC,GAAG,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC;AAG7F,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO,OAAO,QAAQ,MAAM,CAAC,SAAS,CAAC,KAAK,YAC3C,uBAAuB,QAAQ,CAAC,GAAG,MAAM,IAAI,CAAC,CAC9C;AAGF,QAAO,EAAE;;;;;;AAOV,SAAgB,sBAAsB,MAAwB;AAC7D,KAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAO,KACL,KAAK,SAAS,UAAW,QAAQ,WAAW,IAAI,IAAI,UAAU,IAAI,UAAU,IAAI,UAAW,CAC3F,KAAK,GAAG"}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@n8n/utils",
   "type": "module",
-  "version": "1.28.1",
+  "version": "1.30.0",
   "files": [
     "dist",
-    "LICENSE_EE.md",
-    "LICENSE.md"
+    "LICENSE.md",
+    "LICENSE_EE.md"
   ],
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -29,7 +29,7 @@
   },
   "dependencies": {
     "nanoid": "3.3.8",
-    "@n8n/constants": "0.21.1"
+    "@n8n/constants": "0.23.0"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.6.3",
@@ -38,9 +38,9 @@
     "typescript": "6.0.2",
     "vite": "^8.0.2",
     "vitest": "^4.1.1",
-    "@n8n/eslint-config": "0.0.1",
     "@n8n/typescript-config": "1.4.0",
-    "@n8n/vitest-config": "1.9.0"
+    "@n8n/eslint-config": "0.0.1",
+    "@n8n/vitest-config": "1.10.0"
   },
   "license": "SEE LICENSE IN LICENSE.md",
   "homepage": "https://n8n.io",