@onlineapps/cookbook-template-helpers 1.0.14 → 1.0.15

package/README.md

@@ -65,38 +65,39 @@ Helpers jsou k dispozici při resolvování template proměnných:
 
 ## Integration
 
-Tyto helpery jsou v `@onlineapps/cookbook-executor` zapojené **jako výchozí** —
-executor si je vyžádá sám a nic se předávat nemusí:
+Tenhle balíček se do běhu nezapojuje sám a nikdo ho v běhové cestě nevyžaduje
+přímo. Cesta je tříčlánková a jde vždy stejně:
+
+1. balíček je závislostí `@onlineapps/conn-orch-cookbook`, který ho re-exportuje
+   jako plochý klíč `templateHelpers`
+   (`shared/connector/conn-orch-cookbook/src/index.js`);
+2. `ServiceWrapper` injektuje **celý modul** `conn-orch-cookbook` do
+   orchestrátoru jako `config.cookbook`
+   (`shared/connector/service-wrapper/src/ServiceWrapper.js:1818`);
+3. `WorkflowOrchestrator` si helper vyzvedne při rozvíjení `{{helper(...)}}`
+   ve vstupu kroku:
 
 ```javascript
-const { CookbookExecutor } = require('@onlineapps/cookbook-executor');
+// shared/connector/conn-orch-orchestrator/src/WorkflowOrchestrator.js:786
+const helpers = this.cookbook?.templateHelpers || {};
+const helperFn = helpers[helperName];
 
-// helpers se neuvádí — executor použije tento balíček automaticky
-const executor = new CookbookExecutor(cookbook);
+if (typeof helperFn !== 'function') {
+  throw new Error(`[WorkflowOrchestrator] Unknown template helper '${helperName}' - Expected helper to exist in cookbook.templateHelpers`);
+}
 ```
 
-Volba `helpers` existuje jen jako **override** — když ji předáš, výchozí sada se
-nepoužije a platí výhradně to, co jsi předal (viz `cookbook-executor/src/executor.js`,
-`const helpers = options.helpers || templateHelpers`). Pokud chceš výchozí helpery
-zachovat a jen přidat vlastní, musíš je do override sady zahrnout — viz níže.
-
-## Adding Custom Helpers
+Žádná volba `helpers` a žádný override neexistují: platí přesně to, co tenhle
+balíček exportuje. Neznámý helper je tvrdá chyba, ne prázdná hodnota.
 
-You can combine global helpers with custom helpers:
+Živý cookbook, který touhle cestou prochází:
+[`infra/api_doorman/cookbooks/tester-helpers.json`](../../../infra/api_doorman/cookbooks/tester-helpers.json)
+— volá `normalizeString`, `webalizeString`, `string2file` i `file2string`.
 
-```javascript
-const templateHelpers = require('@onlineapps/cookbook-template-helpers');
-const customHelpers = require('./customHelpers');
+## Adding a Helper
 
-const allHelpers = {
-  ...templateHelpers,
-  ...customHelpers
-};
-
-const executor = new CookbookExecutor(cookbook, {
-  helpers: allHelpers
-});
-```
+Nový helper se přidá **do tohoto balíčku** (a vydá se nová verze) — jinak se
+k orchestrátoru nedostane, protože ten čte výhradně `cookbook.templateHelpers`.
 
 ## Helper Function Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onlineapps/cookbook-template-helpers",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "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.0"
+    "@onlineapps/content-resolver": "2.0.1"
   },
   "devDependencies": {
     "jest": "29.7.0"