@platforma-sdk/workflow-tengo 2.14.0 → 2.15.0

package/dist/tengo/lib/workflow.lib.tengo

@@ -1,6 +1,6 @@
-/*
- * Library provides development kit for workflows
- */
+
+
+
 
 tx := import("tx")
 ll := import("@platforma-sdk/workflow-tengo:ll")
@@ -17,30 +17,30 @@ bobject := import("@platforma-sdk/workflow-tengo:workflow.bobject")
 bquery := import("@platforma-sdk/workflow-tengo:workflow.bquery")
 
 
-// instance of this
+
 self := import("@platforma-sdk/workflow-tengo:tpl")
 
-// renderer's output field storing a map with the results
+
 _RESULTS_FIELD_NAME := "result"
 
-// renderer's inputs map field with the context resource
+
 _INPUT_CONTEXT_FIELD_NAME := "context"
 
-// renderer's output field with the context resource
+
 _OUTPUT_CONTEXT_FIELD_NAME := "context"
 
-// a field name prefix used in the renderer's inputs map fields
-// that store prepared resources (aka requested in the 'prepare()' method)
+
+
 _PREPARED_INPUTS_PREFIX := "prepared/"
 
 
-// define outputs as we know them
-// this is important to unlock 'prepare' functionality
-// as workflow is an eph template
+
+
+
 self.defineOutputs([_RESULTS_FIELD_NAME, _OUTPUT_CONTEXT_FIELD_NAME])
 
 _isProduction := func() {
-	// using low level api to avoid unnecessary unmarshalling etc
+
 	return self.rawInputs().isProduction.getValueAsJson() == true
 }
 
@@ -48,28 +48,28 @@ _isStaging := func() {
 	return !_isProduction()
 }
 
-// register standard inputs preprocessors [now added by default for all templates]
-// self.registerUnmarshaller(bquery.resultUnmarshaller())
+
+
 
 _args := undefined
 
-/**
- * Block arguments map
- */
+
+
+
 args := func() {
 	if is_undefined(_args) {
-		// template inputs
+
 		inputs := self.inputs()
 
-		// original args from inputs
+
 		_args = inputs.args
 		if is_undefined(_args) || smart.isReference(_args) {
 			ll.panic("Unexpected args type: %v", _args)
 		}
 
-		// add all prepared 'extra' inputs to the args
+
 		for k, v in inputs {
-			// those extra inputs are prefixed
+
 			if text.has_prefix(k, _PREPARED_INPUTS_PREFIX) {
 
 				name := text.trim_prefix(k, _PREPARED_INPUTS_PREFIX)
@@ -85,9 +85,9 @@ args := func() {
 
 _blockId := undefined
 
-/**
- * Id of this block
- */
+
+
+
 blockId := func() {
 	if _blockId == undefined {
 		_blockId = self.inputs().blockId
@@ -99,9 +99,9 @@ blockId := func() {
 
 __parentContext := undefined
 
-/**
- * Parent context
- */
+
+
+
 _parentContext := func() {
 	if __parentContext == undefined {
 		__parentContext = self.inputs()[_INPUT_CONTEXT_FIELD_NAME]
@@ -112,9 +112,9 @@ _parentContext := func() {
 	return __parentContext
 }
 
-/**
- * Utility function to build final template outputs given block results
- */
+
+
+
 _buildOutputs := func(results) {
 	ll.assert(ll.isMap(results), "expected to see map result from body function")
 	ll.assert(
@@ -128,30 +128,30 @@ _buildOutputs := func(results) {
 	ll.assert(ll.isMap(results.outputs), "expected a map in outputs returned from workflow.body")
 	ll.assert(ll.isMap(results.exports), "expected a map in exports returned from workflow.body")
 
-	// block outputs
+
 	o := results.outputs
-	// block exports
+
 	e := results.exports
 
-	// create results map
+
 	resBuilder := smart.mapBuilder()
 	for name, value in o {
 		ll.assert(!is_undefined(value), "value is undefined for output ", name)
 		resBuilder.add(name, value)
 	}
 
-	// data to pass to ctx builder template
+
 	eData := {}
 	eData[constants.NO_PREFIX_EXPORT] = {}
 
 	for name, value in e {
-		// pass resource to flatten in ctx builder
+
 		if smart.isReference(value) {
 			eData[name] = value
 			continue
 		}
 
-		// check that value has spec and data
+
 		ll.assert(
 			sets.fromSlice(["spec", "data"]) == sets.fromMapKeys(value),
 			"expected spec and data export structure"
@@ -167,7 +167,7 @@ _buildOutputs := func(results) {
 		eData[constants.NO_PREFIX_EXPORT][name + ".data"] = value.data
 	}
 
-	// create ctx and save exports
+
 	ctxBuilder := render.createEphemeral(
 		assets.importTemplate("@platforma-sdk/workflow-tengo:workflow.build-ctx"),
 		{
@@ -177,7 +177,7 @@ _buildOutputs := func(results) {
 		}
 	)
 
-	// final template outputs
+
 	tplOutputs := {}
 	tplOutputs[_RESULTS_FIELD_NAME] = resBuilder.build()
 	tplOutputs[_OUTPUT_CONTEXT_FIELD_NAME] = ctxBuilder.output("ctx")
@@ -185,22 +185,22 @@ _buildOutputs := func(results) {
 	return tplOutputs
 }
 
-/**
- * Query results pool.
- *
- * @param spec: query spec
- * @return result: an array of {ref: spec: data:} objects (data will be absent if not requested)
- */
+
+
+
+
+
+
 query := func(spec, ...options) {
 	return bquery.create(spec, _parentContext(), options...)
 }
 
-/**
- * Query results pool to find spec & data for a given ref.
- *
- * @param ref: a ref object ({blockId: name:})
- * @return result: a {ref: spec: data:} object
- */
+
+
+
+
+
+
 resolve := func(ref, ...options) {
 	r := bquery.resolve(ref, _parentContext(), options...)
 
@@ -211,14 +211,14 @@ resolve := func(ref, ...options) {
 }
 
 
-// template for prerun
+
 _preRunTpl := undefined
 
 _prepare := func(cb) {
 	self.prepare(func(_){
 		raw := cb(args())
 		prefixed := {}
-		// mark prepared inputs
+
 		for k, v in raw {
 			prefixed[_PREPARED_INPUTS_PREFIX + k] = v
 		}
@@ -226,12 +226,12 @@ _prepare := func(cb) {
 	})
 }
 
-/**
- * Prepare additional resources for the workflow body. The body function of the workflow will be executed only when the references will be
- * returned by the prepare method will ve resolved into a ready resources. The resulting resources will be passed as an input to the body function.
- *
- * @param cb: a callback function returning a map of references to be resolved
- */
+
+
+
+
+
+
 prepare := func(cb) {
 	if !_isProduction() {
 		return 
@@ -239,12 +239,12 @@ prepare := func(cb) {
 	_prepare(cb)
 }
 
-/**
- * Prepare additional resources for the workflow body in pre-run. The body function of the workflow will be executed only when the references will be
- * returned by the prepare method will ve resolved into a ready resources. The resulting resources will be passed as an input to the body function.
- *
- * @param cb: a callback function returning a map of references to be resolved
- */
+
+
+
+
+
+
 preparePreRun := func(cb) {
 	if !_isStaging() {
 		return 
@@ -252,9 +252,9 @@ preparePreRun := func(cb) {
 	_prepare(cb)
 }
 
-/**
- * Defines a pre run entry point for a current workflow
- */
+
+
+
 setPreRun := func(tplId) {
 	ll.assert(is_undefined(_preRunTpl), "pre run template is already set")
 
@@ -262,18 +262,18 @@ setPreRun := func(tplId) {
 	_preRunTpl = tplId
 }
 
-/**
- * Validate that arguments fulfil the desired schema
- */
+
+
+
 validateArgs := func(argsSchema) {
 	self.validateInputs({
 		args: argsSchema
 	})
 }
 
-/**
- * Defines main entry point for current workflow
- */
+
+
+
 body := func(bodyFn) {
 
 	if _isProduction() {
@@ -288,13 +288,13 @@ body := func(bodyFn) {
 
 	} else if !is_undefined(_preRunTpl) {
 
-		// staging; render pre-run template
+
 
 		self.delegate(_preRunTpl, { isProduction: true }, [_RESULTS_FIELD_NAME, _OUTPUT_CONTEXT_FIELD_NAME])
 
 	} else {
 
-		// staging; pre-run template not specified; noop
+
 
 		self.body(func(_) {
 			return _buildOutputs({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/workflow-tengo",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Tengo SDK library",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
     "@platforma-open/milaboratories.software-small-binaries": "^1.15.13"
   },
   "devDependencies": {
-    "@platforma-sdk/tengo-builder": "^1.18.0"
+    "@platforma-sdk/tengo-builder": "^1.19.0"
   },
   "scripts": {
     "type-check": "pl-tengo check",