lifecycleion 0.0.6 → 0.0.8

package/README.md

@@ -1,4 +1,4 @@
-# Lifecycleion v0.0.6
+# Lifecycleion v0.0.8
 
 [![npm version](https://badge.fury.io/js/lifecycleion.svg)](https://badge.fury.io/js/lifecycleion)
 
@@ -89,6 +89,7 @@ Each library has comprehensive documentation in the [docs](./docs) folder. Click
 | [constants](./docs/constants.md)                                   | `lifecycleion/constants`                  | Common string constants including whitespace helpers and Python-style character sets                                                     |
 | [curly-brackets](./docs/curly-brackets.md)                         | `lifecycleion/curly-brackets`             | String templating with `{{placeholders}}`, fallbacks, escaping, and compiled templates                                                   |
 | [deep-clone](./docs/deep-clone.md)                                 | `lifecycleion/deep-clone`                 | Deep clone utility with circular reference detection for objects, arrays, Maps, Sets, and more                                           |
+| [dev-mode](./docs/dev-mode.md)                                     | `lifecycleion/dev-mode`                   | Runtime-settable dev/production mode flag with auto-detection from CLI args or NODE_ENV                                                  |
 | [error-to-string](./docs/error-to-string.md)                       | `lifecycleion/error-to-string`            | Format errors into readable ASCII tables with support for nested info and sensitive field masking                                        |
 | [event-emitter](./docs/event-emitter.md)                           | `lifecycleion/event-emitter`              | Lightweight event emitter with protected and public variants, type safety, and memory management                                         |
 | [id-helpers](./docs/id-helpers.md)                                 | `lifecycleion/id-helpers`                 | Unified ID generation and validation for ObjectID, UUID v4, UUID v7, and ULID                                                            |

package/dist/lib/curly-brackets.cjs

@@ -61,6 +61,14 @@ function getPathParts(path) {
   return parts;
 }
 
+// src/lib/internal/stringify-template-value.ts
+function stringifyTemplateValue(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  return String(value);
+}
+
 // src/lib/curly-brackets.ts
 var PLACEHOLDER_PATTERN = /(?:\\)?{{(\s*[^{}]+?\s*)(?:\\)?\s*}}/g;
 var CurlyBrackets = function(str = "", locals = {}, fallback = "(null)") {
@@ -105,7 +113,7 @@ CurlyBrackets.compileTemplate = function(str, fallback = "(null)") {
       if (replacement === void 0 || replacement === null) {
         return fallback;
       }
-      return String(replacement);
+      return stringifyTemplateValue(replacement);
     });
   };
 };

package/dist/lib/curly-brackets.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/curly-brackets.ts","../../src/lib/internal/path-utils.ts"],"sourcesContent":["import { getPathParts } from './internal/path-utils';\n\nexport type TemplateFunction = (locals: Record<string, unknown>) => string;\n\ninterface CurlyBracketsFunction {\n  (str?: string, locals?: Record<string, unknown>, fallback?: string): string;\n  compileTemplate: (str: string, fallback?: string) => TemplateFunction;\n  escape: (str: string) => string;\n}\n\nconst PLACEHOLDER_PATTERN = /(?:\\\\)?{{(\\s*[^{}]+?\\s*)(?:\\\\)?\\s*}}/g;\n\n/**\n * Processes a template string, replacing placeholders with corresponding values from a provided object.\n *\n * @param {string} str - The template string to process.\n * @param locals - An object containing key-value pairs for placeholder replacement.\n * @param fallback - A default string to use when a placeholder's corresponding value is not found.\n * @returns - The processed string with placeholders replaced by their corresponding values.\n */\n\nconst CurlyBrackets: CurlyBracketsFunction = function (\n  str: string = '',\n  locals: Record<string, unknown> = {},\n  fallback: string = '(null)',\n): string {\n  // Short-circuit if no brackets - no need to process\n  if (!str.includes('{{')) {\n    return str;\n  }\n\n  const compiled = CurlyBrackets.compileTemplate(str, fallback);\n\n  return compiled(locals);\n} as CurlyBracketsFunction;\n\n/**\n * Compiles a template string into a reusable function, which can be called with different sets of locals.\n * This is more efficient when you have a template that you want to use with different sets of locals,\n * as it avoids the overhead of parsing the template string each time it is used.\n *\n * @param {string} str - The template string to compile.\n * @param {string} fallback - A default string to use when a placeholder's corresponding value is not found in locals.\n * @returns A function that takes an object of locals and returns a processed string.\n */\n\nCurlyBrackets.compileTemplate = function (\n  str: string,\n  fallback: string = '(null)',\n): TemplateFunction {\n  return (locals: Record<string, unknown>): string => {\n    return str.replace(PLACEHOLDER_PATTERN, (match, p1: string) => {\n      if (typeof p1 !== 'string') {\n        return match;\n      }\n\n      const hasLeadingEscape = match.startsWith('\\\\');\n      const hasEndingEscape = match.endsWith('\\\\}}');\n      const isFullyEscaped = hasLeadingEscape && hasEndingEscape;\n\n      if (isFullyEscaped) {\n        return match.slice(1, -3) + '}}';\n      }\n\n      if (hasLeadingEscape) {\n        return match.slice(1);\n      }\n\n      if (hasEndingEscape) {\n        return '{{' + p1.trim() + '}}';\n      }\n\n      const key = p1.trim();\n      const parts = getPathParts(key);\n\n      if (!parts || parts.length === 0) {\n        return match;\n      }\n\n      // Use a more specific approach to ensure the type is consistent\n      let replacement: unknown = locals;\n\n      for (const part of parts) {\n        if (\n          replacement !== undefined &&\n          replacement !== null &&\n          typeof replacement === 'object' &&\n          part in replacement\n        ) {\n          replacement = (replacement as Record<string, unknown>)[part];\n        } else {\n          replacement = undefined;\n          break;\n        }\n      }\n\n      if (replacement === undefined || replacement === null) {\n        return fallback;\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\n      return String(replacement);\n    });\n  };\n};\n\n/**\n * Escapes placeholders in a string by prefixing them with a backslash, preventing them from being replaced when processed.\n *\n * @param {string} str - The string in which to escape placeholders.\n * @returns {string} - The string with placeholders escaped.\n */\n\nCurlyBrackets.escape = function (str: string): string {\n  // Use a regex to replace instances of {{ and }} that are not already preceded by a backslash\n  return str\n    .replace(/(\\\\)?{{/g, (match, backslash) => (backslash ? match : '\\\\{{'))\n    .replace(/(\\\\)?}}/g, (match, backslash) => (backslash ? match : '\\\\}}'));\n};\n\nexport { CurlyBrackets };\n","const PATH_SEGMENT_PATTERN =\n  /(\\w+)|\\[(\\d+)\\]|\\[\"((?:[^\"\\\\]|\\\\.)*)\"\\]|\\['((?:[^'\\\\]|\\\\.)*)'\\]/y;\n\nfunction unescapeQuotedPathPart(value: string): string {\n  return value.replace(/\\\\([\"'\\\\])/g, '$1');\n}\n\n/**\n * Parses a mixed object/array path such as \"user.roles[0].name\" into lookup parts.\n */\nexport function getPathParts(path: string): string[] | null {\n  const parts: string[] = [];\n  let index = 0;\n\n  while (index < path.length) {\n    if (path[index] === '.') {\n      index++;\n\n      if (index >= path.length) {\n        return null;\n      }\n    }\n\n    PATH_SEGMENT_PATTERN.lastIndex = index;\n    const match = PATH_SEGMENT_PATTERN.exec(path);\n\n    if (!match) {\n      return null;\n    }\n\n    if (match[1] !== undefined) {\n      parts.push(match[1]);\n    } else if (match[2] !== undefined) {\n      parts.push(match[2]);\n    } else if (match[3] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[3]));\n    } else if (match[4] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[4]));\n    }\n\n    index = PATH_SEGMENT_PATTERN.lastIndex;\n\n    if (index < path.length && path[index] !== '.' && path[index] !== '[') {\n      return null;\n    }\n  }\n\n  return parts;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAM,uBACJ;AAEF,SAAS,uBAAuB,OAAuB;AACrD,SAAO,MAAM,QAAQ,eAAe,IAAI;AAC1C;AAKO,SAAS,aAAa,MAA+B;AAC1D,QAAM,QAAkB,CAAC;AACzB,MAAI,QAAQ;AAEZ,SAAO,QAAQ,KAAK,QAAQ;AAC1B,QAAI,KAAK,KAAK,MAAM,KAAK;AACvB;AAEA,UAAI,SAAS,KAAK,QAAQ;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,yBAAqB,YAAY;AACjC,UAAM,QAAQ,qBAAqB,KAAK,IAAI;AAE5C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,CAAC,MAAM,QAAW;AAC1B,YAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACrB,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACrB,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,uBAAuB,MAAM,CAAC,CAAC,CAAC;AAAA,IAC7C,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,uBAAuB,MAAM,CAAC,CAAC,CAAC;AAAA,IAC7C;AAEA,YAAQ,qBAAqB;AAE7B,QAAI,QAAQ,KAAK,UAAU,KAAK,KAAK,MAAM,OAAO,KAAK,KAAK,MAAM,KAAK;AACrE,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;;;ADtCA,IAAM,sBAAsB;AAW5B,IAAM,gBAAuC,SAC3C,MAAc,IACd,SAAkC,CAAC,GACnC,WAAmB,UACX;AAER,MAAI,CAAC,IAAI,SAAS,IAAI,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,cAAc,gBAAgB,KAAK,QAAQ;AAE5D,SAAO,SAAS,MAAM;AACxB;AAYA,cAAc,kBAAkB,SAC9B,KACA,WAAmB,UACD;AAClB,SAAO,CAAC,WAA4C;AAClD,WAAO,IAAI,QAAQ,qBAAqB,CAAC,OAAO,OAAe;AAC7D,UAAI,OAAO,OAAO,UAAU;AAC1B,eAAO;AAAA,MACT;AAEA,YAAM,mBAAmB,MAAM,WAAW,IAAI;AAC9C,YAAM,kBAAkB,MAAM,SAAS,MAAM;AAC7C,YAAM,iBAAiB,oBAAoB;AAE3C,UAAI,gBAAgB;AAClB,eAAO,MAAM,MAAM,GAAG,EAAE,IAAI;AAAA,MAC9B;AAEA,UAAI,kBAAkB;AACpB,eAAO,MAAM,MAAM,CAAC;AAAA,MACtB;AAEA,UAAI,iBAAiB;AACnB,eAAO,OAAO,GAAG,KAAK,IAAI;AAAA,MAC5B;AAEA,YAAM,MAAM,GAAG,KAAK;AACpB,YAAM,QAAQ,aAAa,GAAG;AAE9B,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,eAAO;AAAA,MACT;AAGA,UAAI,cAAuB;AAE3B,iBAAW,QAAQ,OAAO;AACxB,YACE,gBAAgB,UAChB,gBAAgB,QAChB,OAAO,gBAAgB,YACvB,QAAQ,aACR;AACA,wBAAe,YAAwC,IAAI;AAAA,QAC7D,OAAO;AACL,wBAAc;AACd;AAAA,QACF;AAAA,MACF;AAEA,UAAI,gBAAgB,UAAa,gBAAgB,MAAM;AACrD,eAAO;AAAA,MACT;AAGA,aAAO,OAAO,WAAW;AAAA,IAC3B,CAAC;AAAA,EACH;AACF;AASA,cAAc,SAAS,SAAU,KAAqB;AAEpD,SAAO,IACJ,QAAQ,YAAY,CAAC,OAAO,cAAe,YAAY,QAAQ,MAAO,EACtE,QAAQ,YAAY,CAAC,OAAO,cAAe,YAAY,QAAQ,MAAO;AAC3E;","names":[]}
+{"version":3,"sources":["../../src/lib/curly-brackets.ts","../../src/lib/internal/path-utils.ts","../../src/lib/internal/stringify-template-value.ts"],"sourcesContent":["import { getPathParts } from './internal/path-utils';\nimport { stringifyTemplateValue } from './internal/stringify-template-value';\n\nexport type TemplateFunction = (locals: Record<string, unknown>) => string;\n\ninterface CurlyBracketsFunction {\n  (str?: string, locals?: Record<string, unknown>, fallback?: string): string;\n  compileTemplate: (str: string, fallback?: string) => TemplateFunction;\n  escape: (str: string) => string;\n}\n\nconst PLACEHOLDER_PATTERN = /(?:\\\\)?{{(\\s*[^{}]+?\\s*)(?:\\\\)?\\s*}}/g;\n\n/**\n * Processes a template string, replacing placeholders with corresponding values from a provided object.\n *\n * @param {string} str - The template string to process.\n * @param locals - An object containing key-value pairs for placeholder replacement.\n * @param fallback - A default string to use when a placeholder's corresponding value is not found.\n * @returns - The processed string with placeholders replaced by their corresponding values.\n */\n\nconst CurlyBrackets: CurlyBracketsFunction = function (\n  str: string = '',\n  locals: Record<string, unknown> = {},\n  fallback: string = '(null)',\n): string {\n  // Short-circuit if no brackets - no need to process\n  if (!str.includes('{{')) {\n    return str;\n  }\n\n  const compiled = CurlyBrackets.compileTemplate(str, fallback);\n\n  return compiled(locals);\n} as CurlyBracketsFunction;\n\n/**\n * Compiles a template string into a reusable function, which can be called with different sets of locals.\n * This is more efficient when you have a template that you want to use with different sets of locals,\n * as it avoids the overhead of parsing the template string each time it is used.\n *\n * @param {string} str - The template string to compile.\n * @param {string} fallback - A default string to use when a placeholder's corresponding value is not found in locals.\n * @returns A function that takes an object of locals and returns a processed string.\n */\n\nCurlyBrackets.compileTemplate = function (\n  str: string,\n  fallback: string = '(null)',\n): TemplateFunction {\n  return (locals: Record<string, unknown>): string => {\n    return str.replace(PLACEHOLDER_PATTERN, (match, p1: string) => {\n      if (typeof p1 !== 'string') {\n        return match;\n      }\n\n      const hasLeadingEscape = match.startsWith('\\\\');\n      const hasEndingEscape = match.endsWith('\\\\}}');\n      const isFullyEscaped = hasLeadingEscape && hasEndingEscape;\n\n      if (isFullyEscaped) {\n        return match.slice(1, -3) + '}}';\n      }\n\n      if (hasLeadingEscape) {\n        return match.slice(1);\n      }\n\n      if (hasEndingEscape) {\n        return '{{' + p1.trim() + '}}';\n      }\n\n      const key = p1.trim();\n      const parts = getPathParts(key);\n\n      if (!parts || parts.length === 0) {\n        return match;\n      }\n\n      // Use a more specific approach to ensure the type is consistent\n      let replacement: unknown = locals;\n\n      for (const part of parts) {\n        if (\n          replacement !== undefined &&\n          replacement !== null &&\n          typeof replacement === 'object' &&\n          part in replacement\n        ) {\n          replacement = (replacement as Record<string, unknown>)[part];\n        } else {\n          replacement = undefined;\n          break;\n        }\n      }\n\n      if (replacement === undefined || replacement === null) {\n        return fallback;\n      }\n\n      return stringifyTemplateValue(replacement);\n    });\n  };\n};\n\n/**\n * Escapes placeholders in a string by prefixing them with a backslash, preventing them from being replaced when processed.\n *\n * @param {string} str - The string in which to escape placeholders.\n * @returns {string} - The string with placeholders escaped.\n */\n\nCurlyBrackets.escape = function (str: string): string {\n  // Use a regex to replace instances of {{ and }} that are not already preceded by a backslash\n  return str\n    .replace(/(\\\\)?{{/g, (match, backslash) => (backslash ? match : '\\\\{{'))\n    .replace(/(\\\\)?}}/g, (match, backslash) => (backslash ? match : '\\\\}}'));\n};\n\nexport { CurlyBrackets };\n","const PATH_SEGMENT_PATTERN =\n  /(\\w+)|\\[(\\d+)\\]|\\[\"((?:[^\"\\\\]|\\\\.)*)\"\\]|\\['((?:[^'\\\\]|\\\\.)*)'\\]/y;\n\nfunction unescapeQuotedPathPart(value: string): string {\n  return value.replace(/\\\\([\"'\\\\])/g, '$1');\n}\n\n/**\n * Parses a mixed object/array path such as \"user.roles[0].name\" into lookup parts.\n */\nexport function getPathParts(path: string): string[] | null {\n  const parts: string[] = [];\n  let index = 0;\n\n  while (index < path.length) {\n    if (path[index] === '.') {\n      index++;\n\n      if (index >= path.length) {\n        return null;\n      }\n    }\n\n    PATH_SEGMENT_PATTERN.lastIndex = index;\n    const match = PATH_SEGMENT_PATTERN.exec(path);\n\n    if (!match) {\n      return null;\n    }\n\n    if (match[1] !== undefined) {\n      parts.push(match[1]);\n    } else if (match[2] !== undefined) {\n      parts.push(match[2]);\n    } else if (match[3] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[3]));\n    } else if (match[4] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[4]));\n    }\n\n    index = PATH_SEGMENT_PATTERN.lastIndex;\n\n    if (index < path.length && path[index] !== '.' && path[index] !== '[') {\n      return null;\n    }\n  }\n\n  return parts;\n}\n","/**\n * Normalizes values to the same string representation used by template rendering.\n */\nexport function stringifyTemplateValue(value: unknown): string {\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  return String(value);\n}\n"],"mappings":"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","names":[]}

package/dist/lib/curly-brackets.js

@@ -35,6 +35,14 @@ function getPathParts(path) {
   return parts;
 }
 
+// src/lib/internal/stringify-template-value.ts
+function stringifyTemplateValue(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  return String(value);
+}
+
 // src/lib/curly-brackets.ts
 var PLACEHOLDER_PATTERN = /(?:\\)?{{(\s*[^{}]+?\s*)(?:\\)?\s*}}/g;
 var CurlyBrackets = function(str = "", locals = {}, fallback = "(null)") {
@@ -79,7 +87,7 @@ CurlyBrackets.compileTemplate = function(str, fallback = "(null)") {
       if (replacement === void 0 || replacement === null) {
         return fallback;
       }
-      return String(replacement);
+      return stringifyTemplateValue(replacement);
     });
   };
 };

package/dist/lib/curly-brackets.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/lib/internal/path-utils.ts","../../src/lib/curly-brackets.ts"],"sourcesContent":["const PATH_SEGMENT_PATTERN =\n  /(\\w+)|\\[(\\d+)\\]|\\[\"((?:[^\"\\\\]|\\\\.)*)\"\\]|\\['((?:[^'\\\\]|\\\\.)*)'\\]/y;\n\nfunction unescapeQuotedPathPart(value: string): string {\n  return value.replace(/\\\\([\"'\\\\])/g, '$1');\n}\n\n/**\n * Parses a mixed object/array path such as \"user.roles[0].name\" into lookup parts.\n */\nexport function getPathParts(path: string): string[] | null {\n  const parts: string[] = [];\n  let index = 0;\n\n  while (index < path.length) {\n    if (path[index] === '.') {\n      index++;\n\n      if (index >= path.length) {\n        return null;\n      }\n    }\n\n    PATH_SEGMENT_PATTERN.lastIndex = index;\n    const match = PATH_SEGMENT_PATTERN.exec(path);\n\n    if (!match) {\n      return null;\n    }\n\n    if (match[1] !== undefined) {\n      parts.push(match[1]);\n    } else if (match[2] !== undefined) {\n      parts.push(match[2]);\n    } else if (match[3] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[3]));\n    } else if (match[4] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[4]));\n    }\n\n    index = PATH_SEGMENT_PATTERN.lastIndex;\n\n    if (index < path.length && path[index] !== '.' && path[index] !== '[') {\n      return null;\n    }\n  }\n\n  return parts;\n}\n","import { getPathParts } from './internal/path-utils';\n\nexport type TemplateFunction = (locals: Record<string, unknown>) => string;\n\ninterface CurlyBracketsFunction {\n  (str?: string, locals?: Record<string, unknown>, fallback?: string): string;\n  compileTemplate: (str: string, fallback?: string) => TemplateFunction;\n  escape: (str: string) => string;\n}\n\nconst PLACEHOLDER_PATTERN = /(?:\\\\)?{{(\\s*[^{}]+?\\s*)(?:\\\\)?\\s*}}/g;\n\n/**\n * Processes a template string, replacing placeholders with corresponding values from a provided object.\n *\n * @param {string} str - The template string to process.\n * @param locals - An object containing key-value pairs for placeholder replacement.\n * @param fallback - A default string to use when a placeholder's corresponding value is not found.\n * @returns - The processed string with placeholders replaced by their corresponding values.\n */\n\nconst CurlyBrackets: CurlyBracketsFunction = function (\n  str: string = '',\n  locals: Record<string, unknown> = {},\n  fallback: string = '(null)',\n): string {\n  // Short-circuit if no brackets - no need to process\n  if (!str.includes('{{')) {\n    return str;\n  }\n\n  const compiled = CurlyBrackets.compileTemplate(str, fallback);\n\n  return compiled(locals);\n} as CurlyBracketsFunction;\n\n/**\n * Compiles a template string into a reusable function, which can be called with different sets of locals.\n * This is more efficient when you have a template that you want to use with different sets of locals,\n * as it avoids the overhead of parsing the template string each time it is used.\n *\n * @param {string} str - The template string to compile.\n * @param {string} fallback - A default string to use when a placeholder's corresponding value is not found in locals.\n * @returns A function that takes an object of locals and returns a processed string.\n */\n\nCurlyBrackets.compileTemplate = function (\n  str: string,\n  fallback: string = '(null)',\n): TemplateFunction {\n  return (locals: Record<string, unknown>): string => {\n    return str.replace(PLACEHOLDER_PATTERN, (match, p1: string) => {\n      if (typeof p1 !== 'string') {\n        return match;\n      }\n\n      const hasLeadingEscape = match.startsWith('\\\\');\n      const hasEndingEscape = match.endsWith('\\\\}}');\n      const isFullyEscaped = hasLeadingEscape && hasEndingEscape;\n\n      if (isFullyEscaped) {\n        return match.slice(1, -3) + '}}';\n      }\n\n      if (hasLeadingEscape) {\n        return match.slice(1);\n      }\n\n      if (hasEndingEscape) {\n        return '{{' + p1.trim() + '}}';\n      }\n\n      const key = p1.trim();\n      const parts = getPathParts(key);\n\n      if (!parts || parts.length === 0) {\n        return match;\n      }\n\n      // Use a more specific approach to ensure the type is consistent\n      let replacement: unknown = locals;\n\n      for (const part of parts) {\n        if (\n          replacement !== undefined &&\n          replacement !== null &&\n          typeof replacement === 'object' &&\n          part in replacement\n        ) {\n          replacement = (replacement as Record<string, unknown>)[part];\n        } else {\n          replacement = undefined;\n          break;\n        }\n      }\n\n      if (replacement === undefined || replacement === null) {\n        return fallback;\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\n      return String(replacement);\n    });\n  };\n};\n\n/**\n * Escapes placeholders in a string by prefixing them with a backslash, preventing them from being replaced when processed.\n *\n * @param {string} str - The string in which to escape placeholders.\n * @returns {string} - The string with placeholders escaped.\n */\n\nCurlyBrackets.escape = function (str: string): string {\n  // Use a regex to replace instances of {{ and }} that are not already preceded by a backslash\n  return str\n    .replace(/(\\\\)?{{/g, (match, backslash) => (backslash ? match : '\\\\{{'))\n    .replace(/(\\\\)?}}/g, (match, backslash) => (backslash ? match : '\\\\}}'));\n};\n\nexport { CurlyBrackets };\n"],"mappings":";AAAA,IAAM,uBACJ;AAEF,SAAS,uBAAuB,OAAuB;AACrD,SAAO,MAAM,QAAQ,eAAe,IAAI;AAC1C;AAKO,SAAS,aAAa,MAA+B;AAC1D,QAAM,QAAkB,CAAC;AACzB,MAAI,QAAQ;AAEZ,SAAO,QAAQ,KAAK,QAAQ;AAC1B,QAAI,KAAK,KAAK,MAAM,KAAK;AACvB;AAEA,UAAI,SAAS,KAAK,QAAQ;AACxB,eAAO;AAAA,MACT;AAAA,IACF;AAEA,yBAAqB,YAAY;AACjC,UAAM,QAAQ,qBAAqB,KAAK,IAAI;AAE5C,QAAI,CAAC,OAAO;AACV,aAAO;AAAA,IACT;AAEA,QAAI,MAAM,CAAC,MAAM,QAAW;AAC1B,YAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACrB,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,MAAM,CAAC,CAAC;AAAA,IACrB,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,uBAAuB,MAAM,CAAC,CAAC,CAAC;AAAA,IAC7C,WAAW,MAAM,CAAC,MAAM,QAAW;AACjC,YAAM,KAAK,uBAAuB,MAAM,CAAC,CAAC,CAAC;AAAA,IAC7C;AAEA,YAAQ,qBAAqB;AAE7B,QAAI,QAAQ,KAAK,UAAU,KAAK,KAAK,MAAM,OAAO,KAAK,KAAK,MAAM,KAAK;AACrE,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;;;ACtCA,IAAM,sBAAsB;AAW5B,IAAM,gBAAuC,SAC3C,MAAc,IACd,SAAkC,CAAC,GACnC,WAAmB,UACX;AAER,MAAI,CAAC,IAAI,SAAS,IAAI,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,cAAc,gBAAgB,KAAK,QAAQ;AAE5D,SAAO,SAAS,MAAM;AACxB;AAYA,cAAc,kBAAkB,SAC9B,KACA,WAAmB,UACD;AAClB,SAAO,CAAC,WAA4C;AAClD,WAAO,IAAI,QAAQ,qBAAqB,CAAC,OAAO,OAAe;AAC7D,UAAI,OAAO,OAAO,UAAU;AAC1B,eAAO;AAAA,MACT;AAEA,YAAM,mBAAmB,MAAM,WAAW,IAAI;AAC9C,YAAM,kBAAkB,MAAM,SAAS,MAAM;AAC7C,YAAM,iBAAiB,oBAAoB;AAE3C,UAAI,gBAAgB;AAClB,eAAO,MAAM,MAAM,GAAG,EAAE,IAAI;AAAA,MAC9B;AAEA,UAAI,kBAAkB;AACpB,eAAO,MAAM,MAAM,CAAC;AAAA,MACtB;AAEA,UAAI,iBAAiB;AACnB,eAAO,OAAO,GAAG,KAAK,IAAI;AAAA,MAC5B;AAEA,YAAM,MAAM,GAAG,KAAK;AACpB,YAAM,QAAQ,aAAa,GAAG;AAE9B,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,eAAO;AAAA,MACT;AAGA,UAAI,cAAuB;AAE3B,iBAAW,QAAQ,OAAO;AACxB,YACE,gBAAgB,UAChB,gBAAgB,QAChB,OAAO,gBAAgB,YACvB,QAAQ,aACR;AACA,wBAAe,YAAwC,IAAI;AAAA,QAC7D,OAAO;AACL,wBAAc;AACd;AAAA,QACF;AAAA,MACF;AAEA,UAAI,gBAAgB,UAAa,gBAAgB,MAAM;AACrD,eAAO;AAAA,MACT;AAGA,aAAO,OAAO,WAAW;AAAA,IAC3B,CAAC;AAAA,EACH;AACF;AASA,cAAc,SAAS,SAAU,KAAqB;AAEpD,SAAO,IACJ,QAAQ,YAAY,CAAC,OAAO,cAAe,YAAY,QAAQ,MAAO,EACtE,QAAQ,YAAY,CAAC,OAAO,cAAe,YAAY,QAAQ,MAAO;AAC3E;","names":[]}
+{"version":3,"sources":["../../src/lib/internal/path-utils.ts","../../src/lib/internal/stringify-template-value.ts","../../src/lib/curly-brackets.ts"],"sourcesContent":["const PATH_SEGMENT_PATTERN =\n  /(\\w+)|\\[(\\d+)\\]|\\[\"((?:[^\"\\\\]|\\\\.)*)\"\\]|\\['((?:[^'\\\\]|\\\\.)*)'\\]/y;\n\nfunction unescapeQuotedPathPart(value: string): string {\n  return value.replace(/\\\\([\"'\\\\])/g, '$1');\n}\n\n/**\n * Parses a mixed object/array path such as \"user.roles[0].name\" into lookup parts.\n */\nexport function getPathParts(path: string): string[] | null {\n  const parts: string[] = [];\n  let index = 0;\n\n  while (index < path.length) {\n    if (path[index] === '.') {\n      index++;\n\n      if (index >= path.length) {\n        return null;\n      }\n    }\n\n    PATH_SEGMENT_PATTERN.lastIndex = index;\n    const match = PATH_SEGMENT_PATTERN.exec(path);\n\n    if (!match) {\n      return null;\n    }\n\n    if (match[1] !== undefined) {\n      parts.push(match[1]);\n    } else if (match[2] !== undefined) {\n      parts.push(match[2]);\n    } else if (match[3] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[3]));\n    } else if (match[4] !== undefined) {\n      parts.push(unescapeQuotedPathPart(match[4]));\n    }\n\n    index = PATH_SEGMENT_PATTERN.lastIndex;\n\n    if (index < path.length && path[index] !== '.' && path[index] !== '[') {\n      return null;\n    }\n  }\n\n  return parts;\n}\n","/**\n * Normalizes values to the same string representation used by template rendering.\n */\nexport function stringifyTemplateValue(value: unknown): string {\n  if (typeof value === 'string') {\n    return value;\n  }\n\n  return String(value);\n}\n","import { getPathParts } from './internal/path-utils';\nimport { stringifyTemplateValue } from './internal/stringify-template-value';\n\nexport type TemplateFunction = (locals: Record<string, unknown>) => string;\n\ninterface CurlyBracketsFunction {\n  (str?: string, locals?: Record<string, unknown>, fallback?: string): string;\n  compileTemplate: (str: string, fallback?: string) => TemplateFunction;\n  escape: (str: string) => string;\n}\n\nconst PLACEHOLDER_PATTERN = /(?:\\\\)?{{(\\s*[^{}]+?\\s*)(?:\\\\)?\\s*}}/g;\n\n/**\n * Processes a template string, replacing placeholders with corresponding values from a provided object.\n *\n * @param {string} str - The template string to process.\n * @param locals - An object containing key-value pairs for placeholder replacement.\n * @param fallback - A default string to use when a placeholder's corresponding value is not found.\n * @returns - The processed string with placeholders replaced by their corresponding values.\n */\n\nconst CurlyBrackets: CurlyBracketsFunction = function (\n  str: string = '',\n  locals: Record<string, unknown> = {},\n  fallback: string = '(null)',\n): string {\n  // Short-circuit if no brackets - no need to process\n  if (!str.includes('{{')) {\n    return str;\n  }\n\n  const compiled = CurlyBrackets.compileTemplate(str, fallback);\n\n  return compiled(locals);\n} as CurlyBracketsFunction;\n\n/**\n * Compiles a template string into a reusable function, which can be called with different sets of locals.\n * This is more efficient when you have a template that you want to use with different sets of locals,\n * as it avoids the overhead of parsing the template string each time it is used.\n *\n * @param {string} str - The template string to compile.\n * @param {string} fallback - A default string to use when a placeholder's corresponding value is not found in locals.\n * @returns A function that takes an object of locals and returns a processed string.\n */\n\nCurlyBrackets.compileTemplate = function (\n  str: string,\n  fallback: string = '(null)',\n): TemplateFunction {\n  return (locals: Record<string, unknown>): string => {\n    return str.replace(PLACEHOLDER_PATTERN, (match, p1: string) => {\n      if (typeof p1 !== 'string') {\n        return match;\n      }\n\n      const hasLeadingEscape = match.startsWith('\\\\');\n      const hasEndingEscape = match.endsWith('\\\\}}');\n      const isFullyEscaped = hasLeadingEscape && hasEndingEscape;\n\n      if (isFullyEscaped) {\n        return match.slice(1, -3) + '}}';\n      }\n\n      if (hasLeadingEscape) {\n        return match.slice(1);\n      }\n\n      if (hasEndingEscape) {\n        return '{{' + p1.trim() + '}}';\n      }\n\n      const key = p1.trim();\n      const parts = getPathParts(key);\n\n      if (!parts || parts.length === 0) {\n        return match;\n      }\n\n      // Use a more specific approach to ensure the type is consistent\n      let replacement: unknown = locals;\n\n      for (const part of parts) {\n        if (\n          replacement !== undefined &&\n          replacement !== null &&\n          typeof replacement === 'object' &&\n          part in replacement\n        ) {\n          replacement = (replacement as Record<string, unknown>)[part];\n        } else {\n          replacement = undefined;\n          break;\n        }\n      }\n\n      if (replacement === undefined || replacement === null) {\n        return fallback;\n      }\n\n      return stringifyTemplateValue(replacement);\n    });\n  };\n};\n\n/**\n * Escapes placeholders in a string by prefixing them with a backslash, preventing them from being replaced when processed.\n *\n * @param {string} str - The string in which to escape placeholders.\n * @returns {string} - The string with placeholders escaped.\n */\n\nCurlyBrackets.escape = function (str: string): string {\n  // Use a regex to replace instances of {{ and }} that are not already preceded by a backslash\n  return str\n    .replace(/(\\\\)?{{/g, (match, backslash) => (backslash ? match : '\\\\{{'))\n    .replace(/(\\\\)?}}/g, (match, backslash) => (backslash ? match : '\\\\}}'));\n};\n\nexport { CurlyBrackets };\n"],"mappings":"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","names":[]}

package/dist/lib/dev-mode.cjs

@@ -0,0 +1,77 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/dev-mode.ts
+var dev_mode_exports = {};
+__export(dev_mode_exports, {
+  getDevMode: () => getDevMode,
+  initDevMode: () => initDevMode,
+  overrideDevMode: () => overrideDevMode
+});
+module.exports = __toCommonJS(dev_mode_exports);
+var GLOBAL_KEY = "__lifecycleion_is_dev__";
+var INIT_PARAM_KEY = "__lifecycleion_init_param__";
+var g = globalThis;
+function detectValue(detect, isStrict) {
+  const argv = typeof process !== "undefined" ? process.argv ?? [] : [];
+  const env = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
+  const cmdArg = argv.find((a) => a === "dev" || a === "prod");
+  if (isStrict && detect === "cmd" && cmdArg === void 0) {
+    throw new Error('initDevMode: expected "dev" or "prod" as a CLI argument');
+  }
+  const isFromCmd = cmdArg !== void 0 ? cmdArg === "dev" : false;
+  const isFromEnv = env === "development";
+  if (detect === "cmd") {
+    return isFromCmd;
+  }
+  if (detect === "node_env") {
+    return isFromEnv;
+  }
+  return cmdArg !== void 0 ? isFromCmd : isFromEnv;
+}
+function resolveInitParam(param) {
+  if (param === void 0) {
+    return detectValue("both");
+  }
+  if (typeof param === "boolean") {
+    return param;
+  }
+  return detectValue(param.detect, param.strict);
+}
+function getDevMode() {
+  return typeof g[GLOBAL_KEY] === "boolean" ? g[GLOBAL_KEY] : false;
+}
+function initDevMode(param) {
+  if (typeof g[GLOBAL_KEY] === "boolean") {
+    return;
+  }
+  g[INIT_PARAM_KEY] = param;
+  g[GLOBAL_KEY] = resolveInitParam(param);
+}
+function overrideDevMode(value) {
+  const savedParam = g[INIT_PARAM_KEY];
+  g[GLOBAL_KEY] = value === "redetect" ? resolveInitParam(savedParam) : value;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDevMode,
+  initDevMode,
+  overrideDevMode
+});
+//# sourceMappingURL=dev-mode.cjs.map

package/dist/lib/dev-mode.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/dev-mode.ts"],"sourcesContent":["// Stored in globalThis so state survives module re-evaluation and works across\n// module boundaries.\nconst GLOBAL_KEY = '__lifecycleion_is_dev__';\nconst INIT_PARAM_KEY = '__lifecycleion_init_param__';\n\ntype DevModeSource = 'cmd' | 'node_env' | 'both';\ntype InitParam =\n  | boolean\n  | { detect: DevModeSource; strict?: boolean }\n  | undefined;\n\n// Cast once at module level — avoids repeating the assertion in every function.\nconst g = globalThis as typeof globalThis & Record<string, unknown>;\n\nfunction detectValue(detect: DevModeSource, isStrict?: boolean): boolean {\n  // Guard against environments where process or its properties may not exist\n  // (e.g. browser without polyfill, Deno without Node compat, edge runtimes).\n  // Vite statically replaces process.env.NODE_ENV at build time, so it is safe\n  // on the client. process.argv is an empty array shim in browsers — harmless.\n  const argv: string[] =\n    typeof process !== 'undefined' ? (process.argv ?? []) : [];\n  const env: string | undefined =\n    typeof process !== 'undefined' ? process.env?.NODE_ENV : undefined;\n\n  const cmdArg = argv.find((a) => a === 'dev' || a === 'prod');\n\n  if (isStrict && detect === 'cmd' && cmdArg === undefined) {\n    throw new Error('initDevMode: expected \"dev\" or \"prod\" as a CLI argument');\n  }\n\n  const isFromCmd = cmdArg !== undefined ? cmdArg === 'dev' : false;\n  const isFromEnv = env === 'development';\n\n  if (detect === 'cmd') {\n    return isFromCmd;\n  }\n\n  if (detect === 'node_env') {\n    return isFromEnv;\n  }\n\n  // 'both': cmd wins when explicitly present, otherwise fall back to NODE_ENV\n  return cmdArg !== undefined ? isFromCmd : isFromEnv;\n}\n\nfunction resolveInitParam(param: InitParam): boolean {\n  if (param === undefined) {\n    return detectValue('both');\n  }\n\n  if (typeof param === 'boolean') {\n    return param;\n  }\n\n  return detectValue(param.detect, param.strict);\n}\n\n/**\n * Returns the current dev mode value.\n *\n * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if\n * `initDevMode()` has not been called yet.\n */\nexport function getDevMode(): boolean {\n  return typeof g[GLOBAL_KEY] === 'boolean' ? g[GLOBAL_KEY] : false;\n}\n\n/**\n * Sets the dev mode global for the current process.\n *\n * First-wins: if the global is already set (e.g. set by the HTML injection on\n * the client, or by a prior `initDevMode()` call), this is a no-op. Call once\n * at startup before serving any requests.\n *\n * @param param\n *   - `true` / `false` — explicit value\n *   - `{ detect: 'cmd' }` — read from `process.argv` (\"dev\" or \"prod\")\n *   - `{ detect: 'node_env' }` — read from `NODE_ENV`\n *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`\n *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent\n *   - omitted — same as `{ detect: 'both' }`\n */\nexport function initDevMode(\n  param?: boolean | { detect: DevModeSource; strict?: boolean },\n): void {\n  if (typeof g[GLOBAL_KEY] === 'boolean') {\n    return; // first-wins — already initialized, no-op\n  }\n\n  g[INIT_PARAM_KEY] = param; // save original param so 'redetect' can replay it\n  g[GLOBAL_KEY] = resolveInitParam(param);\n}\n\n/**\n * Bypasses first-wins semantics and forces the dev mode value.\n *\n * Intended for testing or tooling — not for production use.\n *\n * Pass `'redetect'` to re-run the same detection logic that\n * `initDevMode()` used originally.\n */\nexport function overrideDevMode(value: boolean | 'redetect'): void {\n  const savedParam = g[INIT_PARAM_KEY] as InitParam;\n  g[GLOBAL_KEY] = value === 'redetect' ? resolveInitParam(savedParam) : value;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,aAAa;AACnB,IAAM,iBAAiB;AASvB,IAAM,IAAI;AAEV,SAAS,YAAY,QAAuB,UAA6B;AAKvE,QAAM,OACJ,OAAO,YAAY,cAAe,QAAQ,QAAQ,CAAC,IAAK,CAAC;AAC3D,QAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,WAAW;AAE3D,QAAM,SAAS,KAAK,KAAK,CAAC,MAAM,MAAM,SAAS,MAAM,MAAM;AAE3D,MAAI,YAAY,WAAW,SAAS,WAAW,QAAW;AACxD,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AAEA,QAAM,YAAY,WAAW,SAAY,WAAW,QAAQ;AAC5D,QAAM,YAAY,QAAQ;AAE1B,MAAI,WAAW,OAAO;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,WAAW,YAAY;AACzB,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,SAAY,YAAY;AAC5C;AAEA,SAAS,iBAAiB,OAA2B;AACnD,MAAI,UAAU,QAAW;AACvB,WAAO,YAAY,MAAM;AAAA,EAC3B;AAEA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,YAAY,MAAM,QAAQ,MAAM,MAAM;AAC/C;AAQO,SAAS,aAAsB;AACpC,SAAO,OAAO,EAAE,UAAU,MAAM,YAAY,EAAE,UAAU,IAAI;AAC9D;AAiBO,SAAS,YACd,OACM;AACN,MAAI,OAAO,EAAE,UAAU,MAAM,WAAW;AACtC;AAAA,EACF;AAEA,IAAE,cAAc,IAAI;AACpB,IAAE,UAAU,IAAI,iBAAiB,KAAK;AACxC;AAUO,SAAS,gBAAgB,OAAmC;AACjE,QAAM,aAAa,EAAE,cAAc;AACnC,IAAE,UAAU,IAAI,UAAU,aAAa,iBAAiB,UAAU,IAAI;AACxE;","names":[]}

package/dist/lib/dev-mode.d.cts

@@ -0,0 +1,38 @@
+type DevModeSource = 'cmd' | 'node_env' | 'both';
+/**
+ * Returns the current dev mode value.
+ *
+ * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if
+ * `initDevMode()` has not been called yet.
+ */
+declare function getDevMode(): boolean;
+/**
+ * Sets the dev mode global for the current process.
+ *
+ * First-wins: if the global is already set (e.g. set by the HTML injection on
+ * the client, or by a prior `initDevMode()` call), this is a no-op. Call once
+ * at startup before serving any requests.
+ *
+ * @param param
+ *   - `true` / `false` — explicit value
+ *   - `{ detect: 'cmd' }` — read from `process.argv` ("dev" or "prod")
+ *   - `{ detect: 'node_env' }` — read from `NODE_ENV`
+ *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`
+ *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent
+ *   - omitted — same as `{ detect: 'both' }`
+ */
+declare function initDevMode(param?: boolean | {
+    detect: DevModeSource;
+    strict?: boolean;
+}): void;
+/**
+ * Bypasses first-wins semantics and forces the dev mode value.
+ *
+ * Intended for testing or tooling — not for production use.
+ *
+ * Pass `'redetect'` to re-run the same detection logic that
+ * `initDevMode()` used originally.
+ */
+declare function overrideDevMode(value: boolean | 'redetect'): void;
+
+export { getDevMode, initDevMode, overrideDevMode };

package/dist/lib/dev-mode.d.ts

@@ -0,0 +1,38 @@
+type DevModeSource = 'cmd' | 'node_env' | 'both';
+/**
+ * Returns the current dev mode value.
+ *
+ * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if
+ * `initDevMode()` has not been called yet.
+ */
+declare function getDevMode(): boolean;
+/**
+ * Sets the dev mode global for the current process.
+ *
+ * First-wins: if the global is already set (e.g. set by the HTML injection on
+ * the client, or by a prior `initDevMode()` call), this is a no-op. Call once
+ * at startup before serving any requests.
+ *
+ * @param param
+ *   - `true` / `false` — explicit value
+ *   - `{ detect: 'cmd' }` — read from `process.argv` ("dev" or "prod")
+ *   - `{ detect: 'node_env' }` — read from `NODE_ENV`
+ *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`
+ *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent
+ *   - omitted — same as `{ detect: 'both' }`
+ */
+declare function initDevMode(param?: boolean | {
+    detect: DevModeSource;
+    strict?: boolean;
+}): void;
+/**
+ * Bypasses first-wins semantics and forces the dev mode value.
+ *
+ * Intended for testing or tooling — not for production use.
+ *
+ * Pass `'redetect'` to re-run the same detection logic that
+ * `initDevMode()` used originally.
+ */
+declare function overrideDevMode(value: boolean | 'redetect'): void;
+
+export { getDevMode, initDevMode, overrideDevMode };

package/dist/lib/dev-mode.js

@@ -0,0 +1,50 @@
+// src/lib/dev-mode.ts
+var GLOBAL_KEY = "__lifecycleion_is_dev__";
+var INIT_PARAM_KEY = "__lifecycleion_init_param__";
+var g = globalThis;
+function detectValue(detect, isStrict) {
+  const argv = typeof process !== "undefined" ? process.argv ?? [] : [];
+  const env = typeof process !== "undefined" ? process.env?.NODE_ENV : void 0;
+  const cmdArg = argv.find((a) => a === "dev" || a === "prod");
+  if (isStrict && detect === "cmd" && cmdArg === void 0) {
+    throw new Error('initDevMode: expected "dev" or "prod" as a CLI argument');
+  }
+  const isFromCmd = cmdArg !== void 0 ? cmdArg === "dev" : false;
+  const isFromEnv = env === "development";
+  if (detect === "cmd") {
+    return isFromCmd;
+  }
+  if (detect === "node_env") {
+    return isFromEnv;
+  }
+  return cmdArg !== void 0 ? isFromCmd : isFromEnv;
+}
+function resolveInitParam(param) {
+  if (param === void 0) {
+    return detectValue("both");
+  }
+  if (typeof param === "boolean") {
+    return param;
+  }
+  return detectValue(param.detect, param.strict);
+}
+function getDevMode() {
+  return typeof g[GLOBAL_KEY] === "boolean" ? g[GLOBAL_KEY] : false;
+}
+function initDevMode(param) {
+  if (typeof g[GLOBAL_KEY] === "boolean") {
+    return;
+  }
+  g[INIT_PARAM_KEY] = param;
+  g[GLOBAL_KEY] = resolveInitParam(param);
+}
+function overrideDevMode(value) {
+  const savedParam = g[INIT_PARAM_KEY];
+  g[GLOBAL_KEY] = value === "redetect" ? resolveInitParam(savedParam) : value;
+}
+export {
+  getDevMode,
+  initDevMode,
+  overrideDevMode
+};
+//# sourceMappingURL=dev-mode.js.map

package/dist/lib/dev-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/dev-mode.ts"],"sourcesContent":["// Stored in globalThis so state survives module re-evaluation and works across\n// module boundaries.\nconst GLOBAL_KEY = '__lifecycleion_is_dev__';\nconst INIT_PARAM_KEY = '__lifecycleion_init_param__';\n\ntype DevModeSource = 'cmd' | 'node_env' | 'both';\ntype InitParam =\n  | boolean\n  | { detect: DevModeSource; strict?: boolean }\n  | undefined;\n\n// Cast once at module level — avoids repeating the assertion in every function.\nconst g = globalThis as typeof globalThis & Record<string, unknown>;\n\nfunction detectValue(detect: DevModeSource, isStrict?: boolean): boolean {\n  // Guard against environments where process or its properties may not exist\n  // (e.g. browser without polyfill, Deno without Node compat, edge runtimes).\n  // Vite statically replaces process.env.NODE_ENV at build time, so it is safe\n  // on the client. process.argv is an empty array shim in browsers — harmless.\n  const argv: string[] =\n    typeof process !== 'undefined' ? (process.argv ?? []) : [];\n  const env: string | undefined =\n    typeof process !== 'undefined' ? process.env?.NODE_ENV : undefined;\n\n  const cmdArg = argv.find((a) => a === 'dev' || a === 'prod');\n\n  if (isStrict && detect === 'cmd' && cmdArg === undefined) {\n    throw new Error('initDevMode: expected \"dev\" or \"prod\" as a CLI argument');\n  }\n\n  const isFromCmd = cmdArg !== undefined ? cmdArg === 'dev' : false;\n  const isFromEnv = env === 'development';\n\n  if (detect === 'cmd') {\n    return isFromCmd;\n  }\n\n  if (detect === 'node_env') {\n    return isFromEnv;\n  }\n\n  // 'both': cmd wins when explicitly present, otherwise fall back to NODE_ENV\n  return cmdArg !== undefined ? isFromCmd : isFromEnv;\n}\n\nfunction resolveInitParam(param: InitParam): boolean {\n  if (param === undefined) {\n    return detectValue('both');\n  }\n\n  if (typeof param === 'boolean') {\n    return param;\n  }\n\n  return detectValue(param.detect, param.strict);\n}\n\n/**\n * Returns the current dev mode value.\n *\n * Reads `globalThis.__lifecycleion_is_dev__`. Defaults to `false` if\n * `initDevMode()` has not been called yet.\n */\nexport function getDevMode(): boolean {\n  return typeof g[GLOBAL_KEY] === 'boolean' ? g[GLOBAL_KEY] : false;\n}\n\n/**\n * Sets the dev mode global for the current process.\n *\n * First-wins: if the global is already set (e.g. set by the HTML injection on\n * the client, or by a prior `initDevMode()` call), this is a no-op. Call once\n * at startup before serving any requests.\n *\n * @param param\n *   - `true` / `false` — explicit value\n *   - `{ detect: 'cmd' }` — read from `process.argv` (\"dev\" or \"prod\")\n *   - `{ detect: 'node_env' }` — read from `NODE_ENV`\n *   - `{ detect: 'both' }` — argv takes precedence, falls back to `NODE_ENV`\n *   - `{ detect: 'cmd', strict: true }` — argv required, throws if absent\n *   - omitted — same as `{ detect: 'both' }`\n */\nexport function initDevMode(\n  param?: boolean | { detect: DevModeSource; strict?: boolean },\n): void {\n  if (typeof g[GLOBAL_KEY] === 'boolean') {\n    return; // first-wins — already initialized, no-op\n  }\n\n  g[INIT_PARAM_KEY] = param; // save original param so 'redetect' can replay it\n  g[GLOBAL_KEY] = resolveInitParam(param);\n}\n\n/**\n * Bypasses first-wins semantics and forces the dev mode value.\n *\n * Intended for testing or tooling — not for production use.\n *\n * Pass `'redetect'` to re-run the same detection logic that\n * `initDevMode()` used originally.\n */\nexport function overrideDevMode(value: boolean | 'redetect'): void {\n  const savedParam = g[INIT_PARAM_KEY] as InitParam;\n  g[GLOBAL_KEY] = value === 'redetect' ? resolveInitParam(savedParam) : value;\n}\n"],"mappings":";AAEA,IAAM,aAAa;AACnB,IAAM,iBAAiB;AASvB,IAAM,IAAI;AAEV,SAAS,YAAY,QAAuB,UAA6B;AAKvE,QAAM,OACJ,OAAO,YAAY,cAAe,QAAQ,QAAQ,CAAC,IAAK,CAAC;AAC3D,QAAM,MACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,WAAW;AAE3D,QAAM,SAAS,KAAK,KAAK,CAAC,MAAM,MAAM,SAAS,MAAM,MAAM;AAE3D,MAAI,YAAY,WAAW,SAAS,WAAW,QAAW;AACxD,UAAM,IAAI,MAAM,yDAAyD;AAAA,EAC3E;AAEA,QAAM,YAAY,WAAW,SAAY,WAAW,QAAQ;AAC5D,QAAM,YAAY,QAAQ;AAE1B,MAAI,WAAW,OAAO;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,WAAW,YAAY;AACzB,WAAO;AAAA,EACT;AAGA,SAAO,WAAW,SAAY,YAAY;AAC5C;AAEA,SAAS,iBAAiB,OAA2B;AACnD,MAAI,UAAU,QAAW;AACvB,WAAO,YAAY,MAAM;AAAA,EAC3B;AAEA,MAAI,OAAO,UAAU,WAAW;AAC9B,WAAO;AAAA,EACT;AAEA,SAAO,YAAY,MAAM,QAAQ,MAAM,MAAM;AAC/C;AAQO,SAAS,aAAsB;AACpC,SAAO,OAAO,EAAE,UAAU,MAAM,YAAY,EAAE,UAAU,IAAI;AAC9D;AAiBO,SAAS,YACd,OACM;AACN,MAAI,OAAO,EAAE,UAAU,MAAM,WAAW;AACtC;AAAA,EACF;AAEA,IAAE,cAAc,IAAI;AACpB,IAAE,UAAU,IAAI,iBAAiB,KAAK;AACxC;AAUO,SAAS,gBAAgB,OAAmC;AACjE,QAAM,aAAa,EAAE,cAAc;AACnC,IAAE,UAAU,IAAI,UAAU,aAAa,iBAAiB,UAAU,IAAI;AACxE;","names":[]}

package/dist/lib/logger/index.cjs

@@ -971,6 +971,14 @@ function getPathParts(path) {
   return parts;
 }
 
+// src/lib/internal/stringify-template-value.ts
+function stringifyTemplateValue(value) {
+  if (typeof value === "string") {
+    return value;
+  }
+  return String(value);
+}
+
 // src/lib/curly-brackets.ts
 var PLACEHOLDER_PATTERN = /(?:\\)?{{(\s*[^{}]+?\s*)(?:\\)?\s*}}/g;
 var CurlyBrackets = function(str = "", locals = {}, fallback = "(null)") {
@@ -1015,7 +1023,7 @@ CurlyBrackets.compileTemplate = function(str, fallback = "(null)") {
       if (replacement === void 0 || replacement === null) {
         return fallback;
       }
-      return String(replacement);
+      return stringifyTemplateValue(replacement);
     });
   };
 };
@@ -1391,14 +1399,17 @@ function applyRedaction(params, redactedKeys, redactFunction) {
   const redactedParams = deepClone(params);
   for (const key of redactedKeys) {
     if (key.includes(".") || key.includes("[")) {
-      const value = getNestedValue(redactedParams, key);
+      const value = getNestedValue(params, key);
       if (value !== void 0) {
-        const redactedValue = redactFn(key, value);
+        const redactedValue = redactFn(key, stringifyTemplateValue(value));
         setNestedValue(redactedParams, key, redactedValue);
       }
     } else {
-      if (key in redactedParams) {
-        redactedParams[key] = redactFn(key, redactedParams[key]);
+      if (key in params) {
+        redactedParams[key] = redactFn(
+          key,
+          stringifyTemplateValue(params[key])
+        );
       }
     }
   }
@@ -2478,8 +2489,9 @@ var Logger = class _Logger extends EventEmitter {
     const params = options?.params;
     const tags = options?.tags;
     const redactedKeys = options?.redactedKeys;
-    const message = params ? CurlyBrackets(template, params) : template;
-    const redactedParams = params ? applyRedaction(params, redactedKeys, this.redactFunction) : void 0;
+    const redactedParams = params && redactedKeys && redactedKeys.length > 0 ? applyRedaction(params, redactedKeys, this.redactFunction) : void 0;
+    const messageParams = redactedParams ?? params;
+    const message = messageParams ? CurlyBrackets(template, messageParams) : template;
     const entry = {
       timestamp,
       type,