@fnet/cli 0.133.0 → 1.0.0

package/template/fnet/node/src/default/blocks/pipeline.js.njk

@@ -0,0 +1,109 @@
+{% set assign=true %}
+{% set signal=true %}
+{% set resolve=true %}
+{% set result=true %}
+
+{% import "src/default/types/block.js.njk" as block with context %}
+
+{% call block.header() %}
+{% endcall %}
+
+{% call block.definition() %}
+  // PIPELINE EXECUTION
+  const { spawn } = await import('child_process');
+
+  const pipelineBinary = '{{ context.transform.binaryName }}';
+  {% if context.transform.args %}
+  const pipelineArgs = {{ context.transform.args | safe }};
+  {% else %}
+  const pipelineArgs = [];
+  {% endif %}
+
+  {% if context.transform.input %}
+  const pipelineInput = {{ context.transform.input | safe }};
+  {% else %}
+  const pipelineInput = null;
+  {% endif %}
+
+  const pipelineFormat = '{{ context.transform.format }}';
+
+  {% if context.transform.env %}
+  const pipelineEnv = {{ context.transform.env | safe }};
+  {% else %}
+  const pipelineEnv = {};
+  {% endif %}
+
+  {% if context.transform.cwd %}
+  const pipelineCwd = {{ context.transform.cwd | safe }};
+  {% else %}
+  const pipelineCwd = undefined;
+  {% endif %}
+
+  const result = await new Promise((pipelineResolve, pipelineReject) => {
+    const spawnOptions = {
+      env: { ...process.env, ...pipelineEnv },
+      stdio: ['pipe', 'pipe', 'pipe']  // stdin, stdout, stderr as pipes (don't inherit parent)
+    };
+
+    if (pipelineCwd) {
+      spawnOptions.cwd = pipelineCwd;
+    }
+
+    const proc = spawn(pipelineBinary, pipelineArgs, spawnOptions);
+
+    let stdout = '';
+    let stderr = '';
+
+    proc.stdout.on('data', (data) => {
+      stdout += data.toString();
+    });
+
+    proc.stderr.on('data', (data) => {
+      stderr += data.toString();
+    });
+
+    proc.on('error', (error) => {
+      pipelineReject(new Error(`Failed to execute pipeline '${pipelineBinary}': ${error.message}`));
+    });
+
+    proc.on('close', (code) => {
+      if (code !== 0) {
+        pipelineReject(new Error(`Pipeline '${pipelineBinary}' exited with code ${code}: ${stderr}`));
+        return;
+      }
+
+      // Parse output based on format
+      if (pipelineFormat === 'text') {
+        // Text format: return as-is
+        pipelineResolve(stdout.trim());
+      } else {
+        // JSON format (default): parse
+        try {
+          const result = JSON.parse(stdout.trim());
+          pipelineResolve(result);
+        } catch (error) {
+          pipelineReject(new Error(`Failed to parse pipeline output as JSON: ${error.message}`));
+        }
+      }
+    });
+
+    // Write input based on type (auto-detect)
+    if (pipelineInput !== null && pipelineInput !== undefined) {
+      if (typeof pipelineInput === 'object') {
+        // Object/Array → JSON
+        proc.stdin.write(JSON.stringify(pipelineInput) + '\n');
+      } else if (typeof pipelineInput === 'string') {
+        // String → as-is (text)
+        proc.stdin.write(pipelineInput + '\n');
+      } else {
+        // Other types → JSON
+        proc.stdin.write(JSON.stringify(pipelineInput) + '\n');
+      }
+    }
+    proc.stdin.end();
+  });
+
+{% endcall %}
+
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/raise.js.njk

@@ -1,31 +1,15 @@
-{% include "src/default/macros/block-header.js.njk" %}
+{% import "src/default/types/block.js.njk" as block with context %}
 
-export default function Block(context){
+{% call block.header() %}
+{% endcall %}
 
-  {% include "src/default/macros/block-body-header.js.njk" %}
+{% call block.definition() %}
 
-  this.run= function (){
-      
-    {% include "src/default/macros/block-entry-args.js.njk" %}
+  const raise = {{context.transform.raise | safe}};
 
-    return new Promise(async (resolve,reject)=>{            
-        {% include "src/default/macros/block-run-header.js.njk" %}
+  reject(new Error(raise?.message||raise||"Unknown error"));
 
-        {% include "src/default/macros/page.js.njk" %}
-        
-        const raise = {{context.transform.raise | safe}};
+{% endcall %}
 
-        {% include "src/default/macros/block-assign.js.njk" %}
-        
-        {% include "src/default/macros/block-signal.js.njk" %}
-
-        onError? onError(new Error(raise?.message||raise||"Unknown error")) : reject(new Error(raise?.message||raise||"Unknown error"));
-
-        {% include "src/default/macros/block-run-footer.js.njk" %}
-    });
-  }
-
-  Object.freeze(this);
-}
-
-{% include "src/default/macros/block-footer.js.njk" %}
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/retry.js.njk

@@ -0,0 +1,70 @@
+{% set resolve=true %}
+
+{% import "src/default/types/block.js.njk" as block with context %}
+
+{% call block.header() %}
+  {% for child in childs %}
+    {% if not child.definition.dynamic %}
+      // RETRYABLE CHILD: {{child.indexKey}}
+      import {{child.codeKey}} from "./{{child.codeKey}}.js";
+    {% endif %}
+  {% endfor %}
+{% endcall %}
+
+{% call block.definition() %}
+  // Retry configuration (always an object)
+  const attempts = {{ context.transform.retry.attempts }};
+  const initialDelay = {{ context.transform.retry.delay }};
+  const backoff = "{{ context.transform.retry.backoff }}";
+  const maxDelay = {% if context.transform.retry.maxDelay %}{{ context.transform.retry.maxDelay }}{% else %}null{% endif %};
+
+  {% if childs[0] %}
+  // Create child block instance
+  const retryableBlock = new {{childs[0].codeKey}}({
+    parent: _this,
+    engine: engine,
+    flow: flow
+  });
+
+  // Retry logic with backoff
+  let lastError;
+  let currentDelay = initialDelay;
+
+  for (let attempt = 1; attempt <= attempts; attempt++) {
+    try {
+      // Execute child block
+      await retryableBlock.run();
+
+      // Success! Break out of retry loop
+      break;
+    } catch (error) {
+      lastError = error;
+
+      // Last attempt failed - throw error
+      if (attempt === attempts) {
+        throw new Error(`Retry failed after ${attempts} attempts: ${error.message}`);
+      }
+
+      // Wait before retry
+      await new Promise(resolve => setTimeout(resolve, currentDelay));
+
+      // Calculate next delay based on backoff strategy
+      if (backoff === 'exponential') {
+        currentDelay = currentDelay * 2;
+      } else if (backoff === 'linear') {
+        currentDelay = currentDelay + initialDelay;
+      }
+      // 'fixed' keeps currentDelay unchanged
+
+      // Apply maxDelay cap if specified
+      if (maxDelay && currentDelay > maxDelay) {
+        currentDelay = maxDelay;
+      }
+    }
+  }
+  {% endif %}
+
+{% endcall %}
+
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/return.js.njk

@@ -1,33 +1,21 @@
-{% include "src/default/macros/block-header.js.njk" %}
+{% import "src/default/types/block.js.njk" as block with context %}
 
-export default function Block(context){
+{% call block.header() %}
+{% endcall %}
 
-  {% include "src/default/macros/block-body-header.js.njk" %}
+{% call block.definition() %}
 
-  this.run= function (){
-      
-    {% include "src/default/macros/block-entry-args.js.njk" %}
+  {% include "src/default/macros/block-assign.js.njk" %}
+  
+  {% include "src/default/macros/block-signal.js.njk" %}
 
-    return new Promise(async (resolve,reject)=>{            
-        {% include "src/default/macros/block-run-header.js.njk" %}
+  const value = {{context.transform.return | safe}};
 
-        {% include "src/default/macros/page.js.njk" %}
-        
-        const value = {{context.transform.return | safe}};
+  flow.result={value: value};
 
-        flow.result={value: value};
+  resolve({type:'return',value: value});
 
-        {% include "src/default/macros/block-assign.js.njk" %}
-        
-        {% include "src/default/macros/block-signal.js.njk" %}
+{% endcall %}
 
-        resolve({type:'return',value: value});
-
-        {% include "src/default/macros/block-run-footer.js.njk" %}
-    });
-  }
-
-  Object.freeze(this);
-}
-
-{% include "src/default/macros/block-footer.js.njk" %}
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/schedule.js.njk

@@ -0,0 +1,66 @@
+{% set resolve=true %}
+
+{% import "src/default/types/block.js.njk" as block with context %}
+
+{% call block.header() %}
+  {% for child in childs %}
+    {% if not child.definition.dynamic %}
+      // SCHEDULED CHILD: {{child.indexKey}}
+      import {{child.codeKey}} from "./{{child.codeKey}}.js";
+    {% endif %}
+  {% endfor %}
+{% endcall %}
+
+{% call block.definition() %}
+  // Import node-cron for scheduling
+  const cron = await import('node-cron');
+
+  // Schedule configuration
+  const cronExpression = {{ context.transform.schedule.cron | safe }};
+  const timezone = {{ context.transform.schedule.timezone | dump | safe }};
+  const enabled = {{ context.transform.schedule.enabled | dump | safe }};
+
+  // Check if schedule is enabled
+  if (!enabled) {
+    // Schedule is disabled, skip to next block
+    {% include "src/default/macros/block-next.js.njk" %}
+    return;
+  }
+
+  // Validate cron expression
+  if (!cron.validate(cronExpression)) {
+    reject(new Error(`Invalid cron expression: ${cronExpression}`));
+    return;
+  }
+
+  // Get child block (the scheduled task)
+  {% if childs[0] %}
+  const scheduledTask = new {{childs[0].codeKey}}({
+    parent: _this,
+    engine: engine,
+    flow: flow
+  });
+  {% endif %}
+
+  // Schedule the task with optional timezone
+  const scheduleOptions = timezone ? { timezone } : {};
+  const task = cron.schedule(cronExpression, async () => {
+    try {
+      {% if childs[0] %}
+      await scheduledTask.run();
+      {% endif %}
+    } catch (error) {
+      console.error(`Scheduled task '{{indexKey}}' failed:`, error);
+    }
+  }, scheduleOptions);
+
+  // Start the scheduled task
+  task.start();
+
+  // Store task reference for potential cleanup
+  flow.set('{{indexKey}}_task', task);
+
+{% endcall %}
+
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/signal.js.njk

@@ -1,37 +1,15 @@
-{% include "src/default/macros/block-header.js.njk" %}
+{% set assign=true %}
+{% set signal=true %}
+{% set resolve=true %}
 
-export default function Block(context){
+{% import "src/default/types/block.js.njk" as block with context %}
 
-  {% include "src/default/macros/block-body-header.js.njk" %}
+{% call block.header() %}
+{% endcall %}
 
-  this.run= function (){
-      
-    {% include "src/default/macros/block-entry-args.js.njk" %}
+{% call block.definition() %}
 
-    return new Promise(async (resolve,reject)=>{            
-      {% include "src/default/macros/block-run-header.js.njk" %}
-      
-      {% include "src/default/macros/page.js.njk" %}
+{% endcall %}
 
-      {% for assign in context.transform.assign %}
-      flow.set({{assign.key | safe}},{{assign.value | safe}});
-      {% endfor%}
-
-      {% if context.transform.return %}
-        resolve({type:'return',value: {{context.transform.return | safe}}});
-      {% elseif context.next and context.transform.wait!=='next'%}
-        {% include "src/default/macros/block-next.js.njk" %}
-      {% elseif not context.next%}
-        resolve();
-      {% endif %}
-
-      {% if context.transform.signal==='next' %}
-        flow.continueForNext({key:'{{indexKey}}'});
-      {% endif %}
-
-      {% include "src/default/macros/block-run-footer.js.njk" %}
-    });
-  }
-}
-
-{% include "src/default/macros/block-footer.js.njk" %}
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/steps.js.njk

@@ -1,63 +1,47 @@
-{% include "src/default/macros/block-header.js.njk" %}
+{% set assign=true %}
+{% set signal=true %}
+{% set resolve=true %}
 
-{% include "src/default/macros/block-next-header.js.njk" %}
+{% import "src/default/types/block.js.njk" as block with context %}
 
-export default function Block(context){
+{% call block.header() %}
+{% endcall %}
 
-  {% include "src/default/macros/block-body-header.js.njk" %}
+{% call block.definition() %}
 
-  this.run= function (){
-      
-    {% include "src/default/macros/block-entry-args.js.njk" %}
+  {% if context.next %}
 
-    return new Promise(async (resolve,reject)=>{
-        
-      {% include "src/default/macros/block-run-header.js.njk" %}
+    // NEXT : {{context.next.indexKey}}
+    {% if context.next.definition.dynamic %}
+      const { default: {{context.next.codeKey}} } = await import("./{{context.next.codeKey}}.js");
+    {% endif %}
 
-      {% if context.next %}
+    let current=new {{context.next.codeKey}}({ parent:_this, engine, flow, caller:c , error });
+    let currentArgs=args;
 
-        // NEXT : {{context.next.indexKey}}
-        {% if context.next.definition.dynamic %}
-          const { default: {{context.next.codeKey}} } = await import("./{{context.next.codeKey}}.js");
-        {% endif %}
-
-        let current=new {{context.next.codeKey}}({ parent:_this, engine, flow, caller:c ,onError, error });
-        let currentArgs=args;
-
-        do {
-          
-          {% if workflow.parent.context.atom.doc.features.print_runners %}
-            console.log(new Date().toLocaleString(),' * ',_this.constructor.IndexKey,' -> ',current.constructor.IndexKey);
-          {% endif %}
-
-          const nextBlock= typeof currentArgs==='undefined'? await current.run() 
-            : Array.isArray(currentArgs)? await current.run.apply(current,currentArgs) : await current.run.call(current, currentArgs) ;
-
-          if(nextBlock?.type==='return') return resolve(nextBlock);
-          else if(nextBlock?.type!=='block') break;
-
-          if(nextBlock.toType.ParentTypeId!==_this.constructor.TypeId)
-            return resolve(nextBlock);
-
-          current=new nextBlock.toType({ parent:_this, engine, flow, caller:c, onError, error });
-          currentArgs=nextBlock.input;
-
-        } while(true);
+    do {
 
+      {% if workflow.parent.context.atom.doc.features.print_runners %}
+        console.log(new Date().toLocaleString(),' * ',_this.constructor.IndexKey,' -> ',current.constructor.IndexKey);
       {% endif %}
 
+      const nextBlock= typeof currentArgs==='undefined'? await current.run()
+        : Array.isArray(currentArgs)? await current.run.apply(current,currentArgs) : await current.run.call(current, currentArgs) ;
+
+      if(nextBlock?.type==='return') return resolve(nextBlock);
+      else if(nextBlock?.type!=='block') break;
 
-      {% include "src/default/macros/block-assign.js.njk" %}
+      if(nextBlock.toType.ParentTypeId!==_this.constructor.TypeId)
+        return resolve(nextBlock);
 
-      {% include "src/default/macros/block-signal.js.njk" %}
+      current=new nextBlock.toType({ parent:_this, engine, flow, caller:c, error });
+      currentArgs=nextBlock.input;
 
-      resolve();
-      
-      {% include "src/default/macros/block-run-footer.js.njk" %}
-    });
-  }
+    } while(true);
 
-  Object.freeze(this);
-}
+  {% endif %}
+  
+{% endcall %}
 
-{% include "src/default/macros/block-footer.js.njk" %}
+{% call block.footer()%} 
+{% endcall %}

package/template/fnet/node/src/default/blocks/switch.js.njk

@@ -1,79 +1,49 @@
-{% include "src/default/macros/block-header.js.njk" %}
+{% set assign=true %}
+{% set signal=true %}
+{% set resolve=true %}
 
-{% if not hasDefaultCondition %}
-  {% include "src/default/macros/block-next-header.js.njk" %}
-{% endif %}
+{% import "src/default/types/block.js.njk" as block with context %}
 
-{% include "src/default/macros/block-modules-header.js.njk" %}
+{% call block.header() %}
 
-{% for child in childs %}
-  {% if not child.definition.dynamic %}
-    // CHILD: {{child.indexKey}}
-    import {{child.codeKey}} from "./{{child.codeKey}}.js";
-  {% endif %}
-{% endfor%}
+  {% for child in childs %}
+    {% if not child.definition.dynamic %}
+      // CHILD: {{child.indexKey}}
+      import {{child.codeKey}} from "./{{child.codeKey}}.js";
+    {% endif %}
+  {% endfor%}
 
-export default function Block(context) {
+{% endcall %}
 
-  {% include "src/default/macros/block-body-header.js.njk" %}
+{% call block.definition() %}
   
-  this.run= function (){
-      
-    {% include "src/default/macros/block-entry-args.js.njk" %}
-
-    return new Promise(async (resolve,reject)=>{
-        
-      {% include "src/default/macros/block-run-header.js.njk" %}
-
-      {% include "src/default/macros/page.js.njk" %}
-
-      {% include "src/default/macros/block-modules.js.njk" %}
-      
-      {% for child in childs %}
-        {% if loop.first %}
-          if ({{child.context.transform.condition | safe}}) 
-        {% else %}
-          {%if child.context.transform.condition %}
-            else if ({{child.context.transform.condition | safe}}) 
-          {% else %}
-            else
-          {% endif %}
-        {% endif %} 
-          {
-            {% if child.definition.dynamic %}
-              // CHILD: {{child.indexKey}}
-              const { default: {{child.codeKey}} } = await import("./{{child.codeKey}}.js");
-            {% endif %}
-
-            const current=new {{child.codeKey}}({ parent:_this, engine, flow, caller:c, onError });
-
-            {% if workflow.parent.context.atom.doc.features.print_runners %}
-              console.log(new Date().toLocaleString(),' * ',_this.constructor.IndexKey,' -> ',current.constructor.IndexKey);
-            {% endif %}
-
-            return resolve(Array.isArray(args)? await current.run.apply(current,args) : await current.run.call(current,args));
-          }
-      {% endfor%}
-
-      {% include "src/default/macros/block-assign.js.njk" %}
+  {% for child in childs %}
+    {% if loop.first %}
+      if ({{child.context.transform.condition | safe}}) 
+    {% else %}
+      {%if child.context.transform.condition %}
+        else if ({{child.context.transform.condition | safe}}) 
+      {% else %}
+        else
+      {% endif %}
+    {% endif %} 
+      {
+        {% if child.definition.dynamic %}
+          // CHILD: {{child.indexKey}}
+          const { default: {{child.codeKey}} } = await import("./{{child.codeKey}}.js");
+        {% endif %}
 
-      {% include "src/default/macros/block-signal.js.njk" %}
+        const current=new {{child.codeKey}}({ parent:_this, engine, flow, caller:c, error });
 
-      {% if not hasDefaultCondition %}
-        {% if context.transform.return %}
-          resolve({type:'return',value: {{context.transform.return | safe}}});
-        {% elseif context.next %}
-          {% include "src/default/macros/block-next.js.njk" %}
-        {% else %}
-          resolve();
+        {% if workflow.parent.context.atom.doc.features.print_runners %}
+          console.log(new Date().toLocaleString(),' * ',_this.constructor.IndexKey,' -> ',current.constructor.IndexKey);
         {% endif %}
-      {% endif %}
 
-      {% include "src/default/macros/block-run-footer.js.njk" %}
-    });
-  }  
+        return resolve(Array.isArray(args)? await current.run.apply(current,args) : await current.run.call(current,args));
+      }
+  {% endfor%}
 
-  Object.freeze(this);
-}
+{% endcall %}
 
-{% include "src/default/macros/block-footer.js.njk" %}
+{% call block.footer()%} 
+{% endcall %}