@onlineapps/cookbook-template-helpers 1.0.15 → 2.0.0

package/README.md

@@ -49,6 +49,15 @@ Převede file/inline descriptor na string (přes ContentResolver). File stáhne
 async function file2string(descriptor, context)
 ```
 
+### Helper context — logger
+
+Oba descriptor helpery si staví `ContentResolver`, pokud jim v kontextu nepředáš
+hotový `context.contentResolver`. V tom případě je `context.logger` **povinný** a
+musí mít všechny čtyři metody: `info()`, `warn()`, `error()`, `debug()` — přesně
+to, co vyžaduje `@onlineapps/content-resolver` a za ním `@onlineapps/conn-base-storage`.
+Chybějící logger i logger neúplný padají hned v `getContentResolver()` a hláška
+jmenuje chybějící metodu; žádný `console` fallback neexistuje.
+
 ## Usage in Cookbook
 
 Helpers jsou k dispozici při resolvování template proměnných:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/cookbook-template-helpers",
-  "version": "1.0.15",
+  "version": "2.0.0",
   "description": "Template helper functions for cookbook variable resolution - string2file, file2string, and more",
   "main": "src/index.js",
   "scripts": {
@@ -19,7 +19,7 @@
   "author": "OnlineApps",
   "license": "PROPRIETARY",
   "dependencies": {
-    "@onlineapps/content-resolver": "2.0.1"
+    "@onlineapps/content-resolver": "3.0.0"
   },
   "devDependencies": {
     "jest": "29.7.0"

package/src/helpers/fileHelpers.js

@@ -7,6 +7,10 @@
 
 const ContentResolver = require('@onlineapps/content-resolver');
 
+// The logger methods `ContentResolver` requires of the object this module hands
+// it — the order is the order the error message lists them in.
+const LOGGER_METHODS = ['info', 'warn', 'error', 'debug'];
+
 /**
  * Normalize string: remove control/unsafe chars, keep letters (incl. diacritics), numbers,
  * whitespace and basic punctuation .,!?;:-_
@@ -66,8 +70,27 @@ function getContentResolver(helperContext) {
     helperContext.data?.step_id ||
     null;
 
-  if (!helperContext.logger || typeof helperContext.logger.warn !== 'function') {
-    throw new Error('[cookbook-template-helpers] Helper context logger is required - Expected logger with warn() method');
+  // The logger goes straight into `ContentResolver`, which demands all four
+  // methods (content-resolver src/index.js; conn-base-storage 3.0.0 behind it).
+  // Until 2026-09-03 only `warn()` was checked here, so a three-method logger
+  // passed this gate and failed one frame down — delayed validation, forbidden
+  // by architecture-principles.md §4. Owner confirmation:
+  // api/docs/governance/confirmations/connector-logger-contract.md 001.
+  if (!helperContext.logger) {
+    throw new Error(
+      '[cookbook-template-helpers] logger is required - Expected: a logger with info/warn/error/debug, '
+      + 'so the resolver this helper builds writes where the service writes. '
+      + 'Fix: pass context.logger (e.g. the logger your service already built).'
+    );
+  }
+
+  const missing = LOGGER_METHODS.filter((method) => typeof helperContext.logger[method] !== 'function');
+  if (missing.length > 0) {
+    throw new Error(
+      '[cookbook-template-helpers] logger is incomplete - Expected: info, warn, error, debug as functions; '
+      + `missing: ${missing.join(', ')}. `
+      + 'Fix: pass a logger implementing all four.'
+    );
   }
 
   return new ContentResolver({