@platforma-sdk/workflow-tengo 2.8.0 → 2.8.2

package/dist/tengo/lib/smart.lib.tengo

@@ -1,6 +1,5 @@
-/*
- * Library provides smart.Resource and smart.Field primitives.
- */
+
+
 
 tx := import("tx")
 ll := import("@platforma-sdk/workflow-tengo:ll")
@@ -10,1172 +9,1060 @@ json := import("json")
 times := import("times")
 constants := import("@platforma-sdk/workflow-tengo:constants")
 
-//////////////// definitions ////////////////
 
-/**
- * A read-only wrapper object around raw platforma resource
- */
+
+
 resource := undefined
 
-/**
- * A wrapper object around raw platforma resource field
- */
+
+
 field := undefined
 
-/**
- * A convenient builder for resource objects
- */
+
+
 resourceBuilder := undefined
 
-/**
- * Builder for structural resource
- *
- * @param resourceType { Name: "", Version: "" }
- */
+
+
+
+
 structBuilder := undefined
 
-/**
- * Builder for map resource
- */
+
+
 mapBuilder := undefined
 
-/**
- * Builder for ephemeral map resource
- */
+
+
 ephemeralMapBuilder := undefined
 
-/**
- * Builder for emphemeral resources
- *
- * @param resourceType { Name: "", Version: "" }
- */
+
+
+
+
 ephemeralBuilder := undefined
 
-/**
- * Create value resource
- *
- * @param resourceType { Name: "", Version: "" }
- * @param data optional data
- */
+
+
+
+
+
 createValueResource := undefined
 
-/**
- * Create Json resource
- *
- * @param value value to save in the resource
- */
+
+
+
+
 createJsonResource := undefined
 
-/**
- * Create map resource
- *
- * @param keyToValue: map[string]anyResource
- * @return resource
- */
+
+
+
+
+
 createMapResource := undefined
 
-/**
- * Create binary map resource
- *
- * @param keyToValue: map[string]valueResource
- * @return resource
- */
+
+
+
+
+
 createBinaryMapResource := undefined
 
-/**
- * Create blob map resource
- *
- * @param keyToValue: map[string]blobResource
- * @return resource
- */
+
+
+
+
+
 createBlobMapResource := undefined
 
-////////////////// helpers ///////////////////////////
 
-/**
- * Returns true if given object is a smart.Resource
- */
+
+
 isResource := func(f) {
-	return ll.isStrict(f) && ll.fromStrict(f)["_type"] == "resource"
+return ll.isStrict(f) && ll.fromStrict(f)["_type"] == "resource"
 }
 
-/**
- * Returns true if given object is a smart.Field
- */
+
+
 isField := func(f) {
-	return ll.isStrict(f) && ll.fromStrict(f)["_type"] == "field"
+return ll.isStrict(f) && ll.fromStrict(f)["_type"] == "field"
 }
 
-/**
- * Returns true if given object is a smart.Field or smart.Resource
- */
+
+
 isReference := func(f) {
-	return isField(f) || isResource(f)
-}
-
-/**
- * Gets future field by given field name and field type.
- *
- * @param from: reference - whether a resource or a field we get a field from.
- * @param name: string - field name
- * @param fieldType: field type: input, output
- * @param isEph: bool - resolve in ephemeral or pure mode
- *
- * @return field: smart field
- */
+return isField(f) || isResource(f)
+}
+
+
+
+
+
+
+
+
+
+
 _getFutureField := func(from, name, fieldType, isEph) {
-	ll.assert(isReference(from), "'from' must be either a resource or a field, got: %#v", from)
+ll.assert(isReference(from), "'from' must be either a resource or a field, got: %#v", from)
 
-	futureField := tx.createFutureFieldID(fieldType, name, !isEph)
-	f := field(futureField.ResourceFID)
-	f.set(from)
+futureField := tx.createFutureFieldID(fieldType, name, !isEph)
+f := field(futureField.ResourceFID)
+f.set(from)
 
-	return field(futureField.ResultFID)
+return field(futureField.ResultFID)
 }
-/**
- * Returns true if given object is a StdMap resource
- */
+
+
 isMapResource := func(r) {
-	return isResource(r) && (
-		r.info().Type.Name == constants.RTYPE_MAP.Name ||
-			r.info().Type.Name == constants.RTYPE_MAP_ALT.Name) // @TODO get rid of alt name
+return isResource(r) && (
+r.info().Type.Name == constants.RTYPE_MAP.Name ||
+r.info().Type.Name == constants.RTYPE_MAP_ALT.Name) // @TODO get rid of alt name
 
 }
 
-/**
- * Returns true if given object is an ephemeral std map resource
- */
+
+
 isEphMapResource := func(r) {
-	return isResource(r) &&  r.info().Type.Name == constants.RTYPE_MAP_EPH.Name
+return isResource(r) &&  r.info().Type.Name == constants.RTYPE_MAP_EPH.Name
 }
 
-/**
- * Returns true if given object is an ephemeral std map resource with locked inputs (so the list of inputs is final)
- */
+
+
 isLockedEphMapResource := func(r) {
-	return isEphMapResource(r) && r.info().InputsLocked
+return isEphMapResource(r) && r.info().InputsLocked
 }
 
-/**
- * Returns true if given object is a map or ephemeral map resource
- */
+
+
 isAnyMapResource := func(r) {
-	return isMapResource(r) || isEphMapResource(r)
+return isMapResource(r) || isEphMapResource(r)
 }
 
-/**
- * Returns true if given object is a json resource
- */
+
+
 isJsonResource := func(r) {
-	return isResource(r) && r.info().Type.Name == constants.RTYPE_JSON.Name
+return isResource(r) && r.info().Type.Name == constants.RTYPE_JSON.Name
 }
 
-// deep check whether map has resources somewhere inside
 _hasReferenceValues := func(object) {
-	if isReference(object) {
-		// first check is reference since resource/field will return true on ll.isMap
-		return true
-	} else if ll.isMap(object) {
-		for _, v in object {
-			if _hasReferenceValues(v) {
-				return true
-			}
-		}
-	} else if is_array(object) {
-		for v in object {
-			if _hasReferenceValues(v) {
-				return true
-			}
-		}
-	}
-	return false
-}
-
-/**
- * Convert given object to resource. If object is a true json, then
- * a simple Json resource will be created, otherwise a resource map.
- */
+if isReference(object) {
+return true
+} else if ll.isMap(object) {
+for _, v in object {
+if _hasReferenceValues(v) {
+return true
+}
+}
+} else if is_array(object) {
+for v in object {
+if _hasReferenceValues(v) {
+return true
+}
+}
+}
+return false
+}
+
+
+
+
 _toRefOrJson := func(object) {
-	if isReference(object) {
-		// first check is reference since resource/field will return true on ll.isMap
-		return object
-	} else if ll.isMap(object) {
+if isReference(object) {
+return object
+} else if ll.isMap(object) {
 
-		// just json if there are no nested resources
-		if !_hasReferenceValues(object)  {
-			return createJsonResource(object)
-		}
+if !_hasReferenceValues(object)  {
+return createJsonResource(object)
+}
 
-		mb := mapBuilder()
-		for k, v in object {
-			mb.add(k, _toRefOrJson(v))
-		}
+mb := mapBuilder()
+for k, v in object {
+mb.add(k, _toRefOrJson(v))
+}
 
-		return mb.build()
-	} else if is_array(object) {
+return mb.build()
+} else if is_array(object) {
 
-		// assert we are not having refs inside
-		ll.assert(!_hasReferenceValues(object), "array can't contain references")
+ll.assert(!_hasReferenceValues(object), "array can't contain references")
 
-		return createJsonResource(object)
-	} else {
-		return createJsonResource(object)
-	}
+return createJsonResource(object)
+} else {
+return createJsonResource(object)
+}
 }
 
 resourceTypesEqual := func(rType1, rType2) {
-	return rType1.Name == rType2.Name && rType1.Version == rType2.Version
+return rType1.Name == rType2.Name && rType1.Version == rType2.Version
 }
 
-////////////////// implementation ///////////////////////////
 
-/**
- * @param r either resource id or resource info
- */
+
+
 resource = func(r) {
-	self := undefined
-	strictSelf := undefined
-
-	if isResource(r) {
-		return r
-	}
-
-	id := ll.isStrict(r) ? r.ID : r
-
-	if !is_int(id) {
-		ll.panic("resource id should be int for ", r)
-	}
-
-	if id == 0 {
-		ll.panic("null resource id for ", r)
-	}
-
-	self = {
-		_type: "resource",
-
-		/**
-		 * Resource id (int64)
-		 */
-		id: id,
-
-		/**
-		 * Resource info:
-		 *
-		 *	ID:			   int64
-		 *	Data:		   byte[],
-		 *	Type:		   { Name: string, Version: string }
-		 *	Features:	   { ephemeral: bool }
-		 *	Inputs:		   strict map
-		 *	Outputs:	   strict map
-		 *	Dynamic:	   strict map
-		 *	OTW:		   strict map
-		 *	ResourceReady: bool
-		 *	AllInputsSet:  bool
-		 *	AllOutputsSet: bool
-		 *	IsDuplicate:   bool
-		 *	InputsLocked:  bool
-		 *	OutputsLocked: bool
-		 *	HasErrors:	   bool
-		 */
-		info: func() {
-			return tx.getResource(self.id)
-		},
-
-		/**
-		 * Returns true if resource has type equal to the one provided as an agrument.
-		 *
-		 * @param expectedType type to compare resource type with
-		 * @return true if type matches, false otherwise
-		 */
-		checkResourceType: func(expectedType) {
-			return resourceTypesEqual(self.info().Type, expectedType)
-		},
-
-		/**
-		 * Resource is ready when all inputs are set to the terminal values.
-		 */
-		isReady: func() {
-			return self.info().ResourceReady
-		},
-
-		isEphemeral: func() {
-			resourceInfo := self.info()
-
-			if !maps.containsKey(resourceInfo, "Features") {
-				// by default we consider all resources to be ephemeral for backward compatiblity to keep stable logic
-				// in platforma backend before v1.16.0.
-				// TODO: once we consider this version old enough, we can panic here instead of 'return true'
-				return true
-			}
-
-			return resourceInfo.Features.ephemeral
-		},
-
-		/**
-		 * Get raw resource data
-		 *
-		 * @return data: []byte - raw resource data
-		 */
-		getData: func() {
-			if self.hasError() {
-				ll.panic("resource has errors: ", self.info())
-			}
-			return self.info().Data;
-		},
-
-		/**
-		 * Get resource data as Json
-		 */
-		getDataAsJson: func() {
-			return json.decode(self.getData());
-		},
-
-		/**
-		 * Whether this resource has error
-		 */
-		hasError: func() {
-			return self._hasField("OneTimeWritables", "resourceError")
-		},
-
-		/**
-		 * Whether any of the input fields have errors. The resource itself may still not have
-		 * error status because error propagation was not yet happened.
-		 */
-		hasInputErrors: func() {
-			return self.info().HasErrors
-		},
-
-		/**
-		 * Return error set in the resource
-		 */
-		getError: func() {
-			if !self.info().HasErrors {
-				ll.panic("no error set in resource")
-			}
-			return self.getField("resourceError").getValue()
-		},
-
-		_hasField: func(fieldMapName, fieldName) {
-			return ll.fromStrict(self.info()[fieldMapName])[fieldName] != undefined
-		},
-
-		/**
-		 * Whether resource has input field with specified name
-		 *
-		 * @param name field name
-		 */
-		hasInputField: func(name) {
-			return self._hasField("Inputs", name)
-		},
-
-		/**
-		 * Whether resource has output field with specified name
-		 *
-		 * @param name field name
-		 */
-		hasOutputField: func(name) {
-			return self._hasField("Outputs", name)
-		},
-
-		/**
-		 * Whether resource has any field with specified name
-		 *
-		 * @param name field name
-		 */
-		hasField: func(name) {
-			return self._hasField("Inputs", name) ||
-				self._hasField("Outputs", name) ||
-				self._hasField("DynamicFields", name) ||
-				self._hasField("OneTimeWritables", name)
-		},
-
-		// cached _inputs
-		_inputs: undefined,
-		/**
-		 * Returns resource inputs map name -> smart.Field
-		 */
-		inputs: func() {
-			if self._inputs == undefined {
-				info := self.info()
-				inputs := maps.mapValues(info.Inputs, field)
-				if !info.InputsLocked {
-					return inputs
-				}
-				self._inputs = inputs
-			}
-			return self._inputs
-		},
-
-		// cached _outputs
-		_outputs: undefined,
-		/**
-		 * Returns resource outputs map name -> smart.Field
-		 */
-		outputs: func() {
-			if(self._outputs == undefined) {
-				info := self.info()
-				outputs := ll.toStrict(maps.mapValues(info.Outputs, field))
-				if !info.OutputsLocked {
-					return outputs
-				}
-				self._outputs = outputs
-			}
-			return self._outputs
-		},
-
-		/**
-		 * Get smart.Field by name
-		 *
-		 * @param name field name
-		 */
-		getField: func(name) {
-			if(!self.hasField(name)) {
-				ll.panic("field %v is not found", name)
-			}
-
-			return field(ll.fieldId(self.id, name))
-		},
-
-		/**
-		 * Get future field given field name and field type.
-		 *
-		 * @param name: string - field name
-		 * @param fieldType: field type - input, output
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart.field
-		 */
-		getFutureField: func(name, fieldType, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-			return _getFutureField(strictSelf, name, fieldType, isEph)
-		},
-
-		/**
-		 * Get future input field given field name or a path
-		 *
-		 * @param nameOrPath: string|string[] - field name or an array representing a path to be traversed
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart.field
-		 */
-		getFutureInputField: func(nameOrPath, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-
-			if is_array(nameOrPath) {
-				current := strictSelf
-				for name in nameOrPath {
-					current = current.getFutureField(name, "input", isEph)
-				}
-				return current
-			} else {
-				return self.getFutureField(nameOrPath, "input", isEph)
-			}
-		},
-
-		/**
-		 * Get future output field given field name
-		 *
-		 * @param name: string - field name
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart.field
-		 */
-		getFutureOutputField: func(name, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-
-			if ll.apiVersion() < 1 && !isEph {
-				// Dirty hack that saves from issues with buggy pure getField before v1.16.1
-				// We can safely drop it when we consider v1.16.0 old enough.
-				return self.getFutureField(name, "output", true).expectNonEphemeral()
-			}
-
-			return self.getFutureField(name, "output", isEph)
-		},
-
-		/**
-		 * Get a resource set in field of a given field name
-		 *
-		 * @param name field name
-		 */
-		get: func(name) {
-			return self.getField(name).getValue()
-		},
-
-		/**
-		 * Gets value from key value storage associated with resource if corresponding
-		 * record exists.
-		 *
-		 * @param key string key
-		 * @return bytes or undefined
-		 */
-		kvGet: func(key) {
-			return tx.resourceKeyValueGet(self.id, key)
-		},
-
-		/**
-		 * Sets bytes or string value to a key value storage associated
-		 * with resource.
-		 *
-		 * @param key string key
-		 * @param value to be set
-		 */
-		kvSet: func(key, value) {
-			tx.resourceKeyValueSet(self.id, key, value)
-		},
-
-		/**
-		 * Gets value as string from key value storage associated with resource if
-		 * corresponding record exists.
-		 *
-		 * @param key string key
-		 * @return string or undefined
-		 */
-		kvGetAsString: func(key) {
-			value := tx.resourceKeyValueGet(self.id, key)
-			if is_undefined(value) {
-				return undefined
-			} else {
-				return string(value)
-			}
-		},
-
-		/**
-		 * Gets value from key value storage associated with resource and
-		 * decodes as json if corresponding record exists.
-		 *
-		 * @param key string key
-		 * @return value or undefined
-		 */
-		kvGetAsJson: func(key) {
-			bytes := self.kvGet(key)
-			if is_undefined(bytes){
-				return undefined
-			} else {
-				return json.decode(bytes)
-			}
-		},
-
-		/**
-		 * Sets json value to a key value storage associated with resource.
-		 *
-		 * @param key string key
-		 * @param value to be set
-		 */
-		kvSetJson: func(key, value) {
-			self.kvSet(key, json.encode(value))
-		}
-	}
-
-	strictSelf = ll.toStrict(self)
-
-	return strictSelf
+self := undefined
+strictSelf := undefined
+
+if isResource(r) {
+return r
 }
 
-field = func(f) {
-	self := undefined
-	strictSelf := undefined
-
-	id := ll.isFieldId(f) ? f : f.ID
-
-	if (is_undefined(id)) {
-		ll.panic("undefined id in smart.field. <f>="+f)
-	}
-
-	self = {
-		_type: "field",
-
-		/**
-		 * Field id struct:
-		 *
-		 *	ResourceID: int64
-		 *	Name:		string
-		 *
-		 */
-		id: id,
-
-		/**
-		 * Field name
-		 */
-		name: func() {
-			return self.id.Name
-		},
-
-		/**
-		 * Associated smart.Resource
-		 */
-		resource: func() {
-			return resource(self.id.ResourceID)
-		},
-
-		/**
-		 * Field info:
-		 *
-		 *	ID:			{ ResourceId: int64, Name: string }
-		 *	Type:		string - see constants.FTYPE_* for possible values
-		 *	Features:	{ ephemeral: bool }
-		 *	Value:		int64 - value resource id
-		 *	Error:		int64 - error resource id
-		 *	IsSet:		bool  - whether field is set
-		 */
-		info: func() {
-			return tx.getField(self.id)
-		},
-
-		/**
-		 * Whether the field points to resource or error
-		 */
-		isSet: func() {
-			return self.info().IsSet
-		},
-
-		/**
-		 * Whether field is resolved to a value
-		 */
-		isValueSet: func() {
-			return self.info().Value != 0
-		},
-
-		/**
-		 * Whether field is resolved to a error
-		 */
-		isErrorSet: func() {
-			return self.info().Error != 0
-		},
-
-		/**
-		 * Some fields cannot point to ephemeral resources.
-		 * This method checks, if current field can.
-		 *
-		 * @return bool - "true' when field can point to ephemeral resource, 'false' when not
-		 */
-		isEphemeral: func() {
-			fieldInfo := self.info()
-
-			if !maps.containsKey(fieldInfo, "Features") {
-				// by default we consider all fields can point to ephemeral resources for backward compatiblity to keep stable logic
-				// in platforma backend before v1.16.0.
-				// TODO: once we consider this version old enough, we can panic here instead of 'return true'
-				return true
-			}
-
-			isParentResourceEphemeral := fieldInfo.Features.ephemeral
-			if isParentResourceEphemeral {
-				return true
-			}
-
-			return fieldInfo.Type != constants.FTYPE_INPUT &&
-				fieldInfo.Type != constants.FTYPE_OUTPUT
-		},
-
-		expectNonEphemeral: func() {
-			rr := field(self.id)
-			rr.isEphemeral = func() { return false }
-			return rr
-		},
-
-		/**
-		 * Use cacheMillis, cacheSeconds, cacheMinutes, cacheHours and cacheDays to not make hidden mistakes in cache time ranges.
-		 * Sets the cache time.
-		 *
-		 * @param time: duration - the cache time from 'times' library.
-		 */
-		setCache: func(time) {
-			ll.assert(is_int(time) && time >= times.millisecond,
-				"smart.field.setCache: cache time must be an integer >= millisecond. Did you forget to import a standard tengo library 'times'?")
-
-			tx.cacheSetToField(self.id, time)
-			return self
-		},
-
-		/**
-		 * Sets the cache time in milliseconds.
-		 *
-		 * @param millis: number
-		 */
-		setCacheMillis: func(millis) {
-			ll.assert(is_int(millis) && millis > 0,
-				"smart.field.setCacheMillis: cache time must be a number of milliseconds (> 0)")
-			return self.setCache(millis * times.millisecond)
-		},
-
-		/**
-		 * Sets the cache time in seconds.
-		 *
-		 * @param seconds: number
-		 */
-		setCacheSeconds: func(seconds) {
-			ll.assert(is_int(seconds) && seconds > 0,
-				"smart.field.setCacheSeconds: cache time must be a number of seconds (> 0)")
-			return self.setCache(seconds * times.second)
-		},
-
-		/**
-		 * Sets the cache time in minutes.
-		 *
-		 * @param minutes: number
-		 */
-		setCacheMinutes: func(minutes) {
-			ll.assert(is_int(minutes) && minutes > 0,
-				"smart.field.setCacheMinutes: cache time must be a number of minutes (> 0)")
-			return self.setCache(minutes * times.minute)
-		},
-
-		/**
-		 * Sets the cache time in hours.
-		 *
-		 * @param hours: number
-		 */
-		setCacheHours: func(hours) {
-			ll.assert(is_int(hours) && hours > 0, "smart.field.setCacheHours: cache time must be a number of hours (> 0)")
-			return self.setCache(hours * times.hour)
-		},
-
-		/**
-		 * Sets the cache time in days
-		 *
-		 * @param days: number
-		 */
-		setCacheDays: func(days) {
-			ll.assert(is_int(days) && days > 0, "smart.field.setCacheDays: cache time must be a number of days (> 0)")
-			return self.setCache(days * 24 * times.hour)
-		},
-
-		/**
-		 * Returns a smart.Resource object from the resolved field value
-		 */
-		getValue: func() {
-			if self.isErrorSet() {
-				err := self.getError().getDataAsJson()
-				if !is_undefined(err.message) {
-					err = err.message
-				}
-				ll.panic("failed to get the value of field %v, error is not empty: %v", self.name(), err)
-			}
-
-			ll.assert(self.isSet(), "field value is not set; ", self.name())
-
-			return resource(self.info().Value)
-		},
-
-		/**
-		 * Returns a smart.Resource object from the resolved field error
-		 */
-		getError: func() {
-			return resource(self.info().Error)
-		},
-
-		/**
-		 * Set (resolve) this field to a Json resource
-		 *
-		 * @param value any
-		 */
-		setJson: func(value) {
-			self.set(createJsonResource(value))
-		},
-
-		/**
-		 * Set (resolve) this field to a Map resource
-		 *
-		 * @param keyToValue any
-		 */
-		setMap: func(keyToValue) {
-			self.set(createMapResource(keyToValue))
-		},
-
-		/**
-		 * Set (resolve) this field to either another resource or field
-		 *
-		 * @param reference smart.resource or smart.field
-		 */
-		set: func(reference) {
-			ll.assert(!self.isSet(), "field ", self.name(), " is already set")
-
-			if isResource(reference) {
-				tx.setFieldToResource(self.id, reference.id)
-			} else if isField(reference) {
-				tx.setFieldToField(self.id, reference.id)
-			} else {
-				ll.panic("smart resource or smart field expected (target field %v), got %#v: ", self.name(), reference)
-			}
-		},
-
-		/**
-		 * Sets this field to either another resource, field or a JSON value.
-		 *
-		 * @param refOrJson: resource|field|JSON
-		 * @return nothing
-		 */
-		setRefOrJson: func(refOrJson) {
-			if is_undefined(refOrJson) {
-				ll.panic("attempt to assign undefined value to field %v", self.name())
-			}
-			self.set(_toRefOrJson(refOrJson))
-		},
-
-		/**
-		 * Returns a json encoded data of the resolved value resource
-		 */
-		getValueAsJson: func() {
-			return self.getValue().getDataAsJson()
-		},
-
-		/**
-		 * Get future field given field name and field type.
-		 *
-		 * @param name: string - field name
-		 * @param fieldType: field type: input, output
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart.field
-		 */
-		getFutureField: func(name, fieldType, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-			return _getFutureField(strictSelf, name, fieldType, isEph)
-		},
-
-		/**
-		 * Get future input field given field name or a path
-		 *
-		 * @param nameOrPath: string|string[] - field name or an array representing a path to be traversed
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart field
-		 */
-		getFutureInputField: func(nameOrPath, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-
-			if is_array(nameOrPath) {
-				current := strictSelf
-				for name in nameOrPath {
-					current = current.getFutureField(name, "input", eph...)
-				}
-				return current
-			} else {
-				return self.getFutureField(nameOrPath, "input", eph...)
-			}
-		},
-
-		/**
-		 * Get future output field given field name
-		 *
-		 * @param name: string - field name
-		 * @param eph: bool (optional) - when false, the operation becomes pure function, waiting for resource
-		 *                               to pass deduplication before resolution.
-		 *
-		 * @return field: smart field
-		 */
-		getFutureOutputField: func(name, ...eph) {
-			isEph := strictSelf.isEphemeral()
-			if len(eph) > 0 {
-				isEph = eph[0]
-			}
-
-			if ll.apiVersion() < 1 && !isEph {
-				// Dirty hack that saves from issues with buggy pure getField before v1.16.1
-				// We can safely drop it when we consider v1.16.0 old enough.
-				return self.getFutureField(name, "output", true).expectNonEphemeral()
-			}
-
-			return self.getFutureField(name, "output", isEph)
-		}
-	}
-
-	strictSelf = ll.toStrict(self)
-
-	return strictSelf
-}
-
-
-/**
- * Universal resource builder.
- *
- * @param r either resource id or resource info
- */
-resourceBuilder = func(r) {
-	super := resource(r)
-
-	self := undefined
-
-	// Mutator methods of the builder cannot be used after it was built.
-	built := false
-	assertNotBuilt := func() {
-		ll.assert(!built, "builder methods must not be used after a build() was called")
-	}
-
-	self = ll.toStrict(oop.inherit(super, {
-		/**
-		 * Create new field with given name and field type.
-		 *
-		 * @param name field name
-		 * @param fieldType: field type - input, output, dynamic, service, OTW. Use FfTYPE_* constants.
-		 */
-		createField: func(name, fieldType) {
-			assertNotBuilt()
-			fid := ll.fieldId(super.id, name)
-			tx.createField(fid, fieldType)
-			return field(fid)
-		},
-
-		/**
-		 * Create new input field with given name.
-		 *
-		 * @param name field name
-		 */
-		createInputField: func(name) {
-			assertNotBuilt()
-			return self.createField(name, "input")
-		},
-
-		/**
-		 * Create new output field with given name.
-		 *
-		 * @param name field name
-		 */
-		createOutputField: func(name) {
-			assertNotBuilt()
-			return self.createField(name, "output")
-		},
-
-		/**
-		 * Lock resource outputs
-		 */
-		lockOutputs: func() {
-			assertNotBuilt()
-			tx.lockOutputs(super.id)
-		},
-
-		/**
-		 * Lock resource inputs
-		 */
-		lockInputs: func() {
-			assertNotBuilt()
-			tx.lockInputs(super.id)
-		},
-
-		/**
-		 * Lock both resource inputs and outputs
-		 */
-		lock: func() {
-			assertNotBuilt()
-			self.lockInputs()
-			self.lockOutputs()
-		},
-
-		/**
-		 * Lock inputs and outputs and return resulting smart.Resource
-		 */
-		lockAndBuild: func() {
-			self.lock()
-			built = true
-			return super
-		},
-
-		/**
-		 * Lock outputs and return resulting smart.Resource
-		 */
-		lockOutputsAndBuild: func() {
-			self.lockOutputs()
-			built = true
-			return super
-		},
-
-		/**
-		 * Lock inputs and return resulting smart.Resource
-		 */
-		lockInputsAndBuild: func() {
-			self.lockInputs()
-			built = true
-			return super
-		},
-
-		/**
-		 * Return smart.Resource without locking inputs and outputs
-		 */
-		buildUnlocked: func() {
-			built = true
-			return super
-		}
-	}))
-
-	return self
-}
-
-/**
- * Creates a structural resource and returns a builder from it.
- *
- * @params resourceType a resource type
- * @params data, optional, bytes that will go in Data of the resource.
- */
-structBuilder = func(resourceType, ...data) {
-	id := undefined
-	if len(data) > 0 {
-		id = tx.createStruct(resourceType.Name, resourceType.Version, data[0])
-	} else {
-		id = tx.createStruct(resourceType.Name, resourceType.Version)
-	}
+id := ll.isStrict(r) ? r.ID : r
 
-	return resourceBuilder(id)
+if !is_int(id) {
+ll.panic("resource id should be int for ", r)
 }
 
-/**
- * @param isEph: is ephemeral map
- */
-_mapBuilder := func(isEph) {
-	builder := isEph ? ephemeralBuilder(constants.RTYPE_MAP_EPH) : structBuilder(constants.RTYPE_MAP)
-	// ensure no outputs will be created
-	builder.lockOutputs()
-
-	self := undefined
-
-	self = ll.toStrict(oop.inherit(builder, {
-		/**
-		 * Adds a reference to the map by a given key.
-		 *
-		 * @param key: string - how the field will be named in the map
-		 * @param value: reference - a field or resource that will be set in the field
-		 * @return self: mapBuilder
-		 */
-		addRef: func(key, value) {
-			builder.createInputField(key).set(value)
-			return self
-		},
-
-		/**
-		 * Adds a primitive value that can be converted to JSON to the map.
-		 *
-		 * @param key: string - how the field will be named in the map
-		 * @param value: any - a primitive value, e.g. Tengo's map.
-		 * @return self: mapBuilder
-		 */
-		addJson: func(key, value) {
-			builder.createInputField(key).set(createJsonResource(value))
-			return self
-		},
-
-		/**
-		 * Adds object automatically converting non-reference objects into Json values.
-		 *
-		 * @param key: string - how the field will be named in the map
-		 * @param value: any - a reference or a primitive value
-		 * @return self: mapBuilder
-		 */
-		add: func(key, value) {
-			builder.createInputField(key).setRefOrJson(value)
-			return self
-		},
-
-
-		/**
-		 * Creates a map in the platforma
-		 *
-		 * @return nothing
-		 */
-		build: func() {
-			return builder.lockAndBuild()
-		}
-	}))
-
-	return self
+if id == 0 {
+ll.panic("null resource id for ", r)
 }
 
-mapBuilder = func() {
-	return _mapBuilder(false)
+self = {
+_type: "resource",
+
+
+
+id: id,
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+info: func() {
+return tx.getResource(self.id)
+},
+
+
+
+
+
+
+checkResourceType: func(expectedType) {
+return resourceTypesEqual(self.info().Type, expectedType)
+},
+
+
+
+isReady: func() {
+return self.info().ResourceReady
+},
+
+isEphemeral: func() {
+resourceInfo := self.info()
+
+if !maps.containsKey(resourceInfo, "Features") {
+return true
 }
 
-ephemeralMapBuilder = func() {
-	return _mapBuilder(true)
+return resourceInfo.Features.ephemeral
+},
+
+
+
+
+
+getData: func() {
+if self.hasError() {
+ll.panic("resource has errors: ", self.info())
 }
+return self.info().Data;
+},
+
+
+
+getDataAsJson: func() {
+return json.decode(self.getData());
+},
+
 
-ephemeralBuilder = func(resourceType, ...data) {
-	id := undefined
-	if (len(data) > 0) {
-		id = tx.createEphemeral(resourceType.Name, resourceType.Version, data[0])
-	} else {
-		id = tx.createEphemeral(resourceType.Name, resourceType.Version)
-	}
 
-	return resourceBuilder(id)
+hasError: func() {
+return self._hasField("OneTimeWritables", "resourceError")
+},
+
+
+
+
+hasInputErrors: func() {
+return self.info().HasErrors
+},
+
+
+
+getError: func() {
+if !self.info().HasErrors {
+ll.panic("no error set in resource")
 }
+return self.getField("resourceError").getValue()
+},
 
-createValueResource = func(resourceType, data) {
-	ll.assert(data != undefined, "can't create resource with undefined data")
-	return resource(tx.createValue(resourceType.Name, resourceType.Version, data))
+_hasField: func(fieldMapName, fieldName) {
+return ll.fromStrict(self.info()[fieldMapName])[fieldName] != undefined
+},
+
+
+
+
+
+hasInputField: func(name) {
+return self._hasField("Inputs", name)
+},
+
+
+
+
+
+hasOutputField: func(name) {
+return self._hasField("Outputs", name)
+},
+
+
+
+
+
+hasField: func(name) {
+return self._hasField("Inputs", name) ||
+self._hasField("Outputs", name) ||
+self._hasField("DynamicFields", name) ||
+self._hasField("OneTimeWritables", name)
+},
+
+_inputs: undefined,
+
+
+inputs: func() {
+if self._inputs == undefined {
+info := self.info()
+inputs := maps.mapValues(info.Inputs, field)
+if !info.InputsLocked {
+return inputs
 }
+self._inputs = inputs
+}
+return self._inputs
+},
 
-createJsonResource = func(value) {
-	ll.assert(value != undefined, "can't create Json value from undefined")
+_outputs: undefined,
+
+
+outputs: func() {
+if(self._outputs == undefined) {
+info := self.info()
+outputs := ll.toStrict(maps.mapValues(info.Outputs, field))
+if !info.OutputsLocked {
+return outputs
+}
+self._outputs = outputs
+}
+return self._outputs
+},
 
-	// important: strict map can't be encoded to JSON
 
-	ll.assert(!ll.isStrict(value), "can't encode strict map: ", value)
-	// value = ll.ensureNonStrict(value)
 
-	encoded := json.encode(value)
-	return createValueResource(constants.RTYPE_JSON, encoded)
+
+
+getField: func(name) {
+if(!self.hasField(name)) {
+ll.panic("field %v is not found", name)
 }
 
-createMapResourceWithType := func(resourceType, keyToValue) {
-	builder := structBuilder(resourceType)
+return field(ll.fieldId(self.id, name))
+},
+
+
+
+
+
+
+
+
+
+
+getFutureField: func(name, fieldType, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+return _getFutureField(strictSelf, name, fieldType, isEph)
+},
+
+
+
+
+
+
+
+
+
+getFutureInputField: func(nameOrPath, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+
+if is_array(nameOrPath) {
+current := strictSelf
+for name in nameOrPath {
+current = current.getFutureField(name, "input", isEph)
+}
+return current
+} else {
+return self.getFutureField(nameOrPath, "input", isEph)
+}
+},
+
+
+
+
+
+
+
+
+
+getFutureOutputField: func(name, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+
+if ll.apiVersion() < 1 && !isEph {
+return self.getFutureField(name, "output", true).expectNonEphemeral()
+}
+
+return self.getFutureField(name, "output", isEph)
+},
+
+
+
+
+
+get: func(name) {
+return self.getField(name).getValue()
+},
+
+
+
+
+
+
+
+kvGet: func(key) {
+return tx.resourceKeyValueGet(self.id, key)
+},
+
+
+
+
+
+
+
+kvSet: func(key, value) {
+tx.resourceKeyValueSet(self.id, key, value)
+},
+
+
+
+
+
+
+
+kvGetAsString: func(key) {
+value := tx.resourceKeyValueGet(self.id, key)
+if is_undefined(value) {
+return undefined
+} else {
+return string(value)
+}
+},
+
+
+
+
+
+
+
+kvGetAsJson: func(key) {
+bytes := self.kvGet(key)
+if is_undefined(bytes){
+return undefined
+} else {
+return json.decode(bytes)
+}
+},
+
+
+
+
+
+
+kvSetJson: func(key, value) {
+self.kvSet(key, json.encode(value))
+}
+}
+
+strictSelf = ll.toStrict(self)
+
+return strictSelf
+}
+
+field = func(f) {
+self := undefined
+strictSelf := undefined
 
-	for key, value in keyToValue {
-		builder.createInputField(key).setRefOrJson(value)
-	}
+id := ll.isFieldId(f) ? f : f.ID
+
+if (is_undefined(id)) {
+ll.panic("undefined id in smart.field. <f>="+f)
+}
+
+self = {
+_type: "field",
+
+
+
+
+
+
+
+id: id,
+
+
+
+name: func() {
+return self.id.Name
+},
+
+
+
+resource: func() {
+return resource(self.id.ResourceID)
+},
+
+
+
+
+
+
+
+
+
+
+info: func() {
+return tx.getField(self.id)
+},
+
+
+
+isSet: func() {
+return self.info().IsSet
+},
+
+
+
+isValueSet: func() {
+return self.info().Value != 0
+},
+
+
+
+isErrorSet: func() {
+return self.info().Error != 0
+},
+
+
+
+
+
+
+isEphemeral: func() {
+fieldInfo := self.info()
+
+if !maps.containsKey(fieldInfo, "Features") {
+return true
+}
+
+isParentResourceEphemeral := fieldInfo.Features.ephemeral
+if isParentResourceEphemeral {
+return true
+}
+
+return fieldInfo.Type != constants.FTYPE_INPUT &&
+fieldInfo.Type != constants.FTYPE_OUTPUT
+},
+
+expectNonEphemeral: func() {
+rr := field(self.id)
+rr.isEphemeral = func() { return false }
+return rr
+},
+
+
+
+
+
+
+setCache: func(time) {
+ll.assert(is_int(time) && time >= times.millisecond,
+"smart.field.setCache: cache time must be an integer >= millisecond. Did you forget to import a standard tengo library 'times'?")
+
+tx.cacheSetToField(self.id, time)
+return self
+},
+
+
+
+
+
+setCacheMillis: func(millis) {
+ll.assert(is_int(millis) && millis > 0,
+"smart.field.setCacheMillis: cache time must be a number of milliseconds (> 0)")
+return self.setCache(millis * times.millisecond)
+},
+
+
+
+
+
+setCacheSeconds: func(seconds) {
+ll.assert(is_int(seconds) && seconds > 0,
+"smart.field.setCacheSeconds: cache time must be a number of seconds (> 0)")
+return self.setCache(seconds * times.second)
+},
+
+
+
+
+
+setCacheMinutes: func(minutes) {
+ll.assert(is_int(minutes) && minutes > 0,
+"smart.field.setCacheMinutes: cache time must be a number of minutes (> 0)")
+return self.setCache(minutes * times.minute)
+},
+
+
+
+
+
+setCacheHours: func(hours) {
+ll.assert(is_int(hours) && hours > 0, "smart.field.setCacheHours: cache time must be a number of hours (> 0)")
+return self.setCache(hours * times.hour)
+},
+
+
+
+
+
+setCacheDays: func(days) {
+ll.assert(is_int(days) && days > 0, "smart.field.setCacheDays: cache time must be a number of days (> 0)")
+return self.setCache(days * 24 * times.hour)
+},
+
+
+
+getValue: func() {
+if self.isErrorSet() {
+err := self.getError().getDataAsJson()
+if !is_undefined(err.message) {
+err = err.message
+}
+ll.panic("failed to get the value of field %v, error is not empty: %v", self.name(), err)
+}
+
+ll.assert(self.isSet(), "field value is not set; ", self.name())
+
+return resource(self.info().Value)
+},
+
+
+
+getError: func() {
+return resource(self.info().Error)
+},
+
+
+
+
+
+setJson: func(value) {
+self.set(createJsonResource(value))
+},
+
+
+
+
+
+setMap: func(keyToValue) {
+self.set(createMapResource(keyToValue))
+},
+
+
+
+
+
+set: func(reference) {
+ll.assert(!self.isSet(), "field ", self.name(), " is already set")
+
+if isResource(reference) {
+tx.setFieldToResource(self.id, reference.id)
+} else if isField(reference) {
+tx.setFieldToField(self.id, reference.id)
+} else {
+ll.panic("smart resource or smart field expected (target field %v), got %#v: ", self.name(), reference)
+}
+},
+
+
+
+
+
+
+setRefOrJson: func(refOrJson) {
+if is_undefined(refOrJson) {
+ll.panic("attempt to assign undefined value to field %v", self.name())
+}
+self.set(_toRefOrJson(refOrJson))
+},
+
+
+
+getValueAsJson: func() {
+return self.getValue().getDataAsJson()
+},
+
+
+
+
+
+
+
+
+
+
+getFutureField: func(name, fieldType, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+return _getFutureField(strictSelf, name, fieldType, isEph)
+},
+
+
+
+
+
+
+
+
+
+getFutureInputField: func(nameOrPath, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+
+if is_array(nameOrPath) {
+current := strictSelf
+for name in nameOrPath {
+current = current.getFutureField(name, "input", eph...)
+}
+return current
+} else {
+return self.getFutureField(nameOrPath, "input", eph...)
+}
+},
+
+
+
+
+
+
+
+
+
+getFutureOutputField: func(name, ...eph) {
+isEph := strictSelf.isEphemeral()
+if len(eph) > 0 {
+isEph = eph[0]
+}
+
+if ll.apiVersion() < 1 && !isEph {
+return self.getFutureField(name, "output", true).expectNonEphemeral()
+}
+
+return self.getFutureField(name, "output", isEph)
+}
+}
+
+strictSelf = ll.toStrict(self)
+
+return strictSelf
+}
+
+
+
+
+
+
+resourceBuilder = func(r) {
+super := resource(r)
+
+self := undefined
+
+built := false
+assertNotBuilt := func() {
+ll.assert(!built, "builder methods must not be used after a build() was called")
+}
+
+self = ll.toStrict(oop.inherit(super, {
+
+
+
+
+
+createField: func(name, fieldType) {
+assertNotBuilt()
+fid := ll.fieldId(super.id, name)
+tx.createField(fid, fieldType)
+return field(fid)
+},
+
+
+
+
+
+createInputField: func(name) {
+assertNotBuilt()
+return self.createField(name, "input")
+},
+
+
+
+
+
+createOutputField: func(name) {
+assertNotBuilt()
+return self.createField(name, "output")
+},
+
+
+
+lockOutputs: func() {
+assertNotBuilt()
+tx.lockOutputs(super.id)
+},
+
+
+
+lockInputs: func() {
+assertNotBuilt()
+tx.lockInputs(super.id)
+},
+
+
+
+lock: func() {
+assertNotBuilt()
+self.lockInputs()
+self.lockOutputs()
+},
+
+
+
+lockAndBuild: func() {
+self.lock()
+built = true
+return super
+},
+
+
+
+lockOutputsAndBuild: func() {
+self.lockOutputs()
+built = true
+return super
+},
+
+
+
+lockInputsAndBuild: func() {
+self.lockInputs()
+built = true
+return super
+},
+
+
+
+buildUnlocked: func() {
+built = true
+return super
+}
+}))
+
+return self
+}
+
+
+
+
+
+
+structBuilder = func(resourceType, ...data) {
+id := undefined
+if len(data) > 0 {
+id = tx.createStruct(resourceType.Name, resourceType.Version, data[0])
+} else {
+id = tx.createStruct(resourceType.Name, resourceType.Version)
+}
+
+return resourceBuilder(id)
+}
+
+
+
+_mapBuilder := func(isEph) {
+builder := isEph ? ephemeralBuilder(constants.RTYPE_MAP_EPH) : structBuilder(constants.RTYPE_MAP)
+builder.lockOutputs()
+
+self := undefined
+
+self = ll.toStrict(oop.inherit(builder, {
+
+
+
+
+
+
+addRef: func(key, value) {
+builder.createInputField(key).set(value)
+return self
+},
+
+
+
+
+
+
+
+addJson: func(key, value) {
+builder.createInputField(key).set(createJsonResource(value))
+return self
+},
+
+
+
+
+
+
+
+add: func(key, value) {
+builder.createInputField(key).setRefOrJson(value)
+return self
+},
+
+
+
+
+
+
+build: func() {
+return builder.lockAndBuild()
+}
+}))
+
+return self
+}
+
+mapBuilder = func() {
+return _mapBuilder(false)
+}
+
+ephemeralMapBuilder = func() {
+return _mapBuilder(true)
+}
+
+ephemeralBuilder = func(resourceType, ...data) {
+id := undefined
+if (len(data) > 0) {
+id = tx.createEphemeral(resourceType.Name, resourceType.Version, data[0])
+} else {
+id = tx.createEphemeral(resourceType.Name, resourceType.Version)
+}
+
+return resourceBuilder(id)
+}
+
+createValueResource = func(resourceType, data) {
+ll.assert(data != undefined, "can't create resource with undefined data")
+return resource(tx.createValue(resourceType.Name, resourceType.Version, data))
+}
+
+createJsonResource = func(value) {
+ll.assert(value != undefined, "can't create Json value from undefined")
+
+
+ll.assert(!ll.isStrict(value), "can't encode strict map: ", value)
+
+encoded := json.encode(value)
+return createValueResource(constants.RTYPE_JSON, encoded)
+}
+
+createMapResourceWithType := func(resourceType, keyToValue) {
+builder := structBuilder(resourceType)
+
+for key, value in keyToValue {
+builder.createInputField(key).setRefOrJson(value)
+}
 
-	return builder.lockAndBuild()
+return builder.lockAndBuild()
 }
 
 createMapResource = func(keyToValue) {
-	return createMapResourceWithType(constants.RTYPE_MAP, keyToValue)
+return createMapResourceWithType(constants.RTYPE_MAP, keyToValue)
 }
 
 createBinaryMapResource = func(keyToValue) {
-	return createMapResourceWithType(constants.RTYPE_BINARY_MAP, keyToValue)
+return createMapResourceWithType(constants.RTYPE_BINARY_MAP, keyToValue)
 }
 
 createBlobMapResource = func(keyToValue) {
-	return createMapResourceWithType(constants.RTYPE_BLOB_MAP, keyToValue)
+return createMapResourceWithType(constants.RTYPE_BLOB_MAP, keyToValue)
 }
 
 export ll.toStrict({
-	isResource: isResource,
-	isField: isField,
-	isReference: isReference,
-	isMapResource: isMapResource,
-	isEphMapResource: isEphMapResource,
-	isAnyMapResource: isAnyMapResource,
-	isLockedEphMapResource: isLockedEphMapResource,
-	isJsonResource: isJsonResource,
-	resource: resource,
-	field: field,
-	resourceBuilder: resourceBuilder,
-	structBuilder: structBuilder,
-	mapBuilder: mapBuilder,
-	ephemeralMapBuilder: ephemeralMapBuilder,
-	ephemeralBuilder: ephemeralBuilder,
-	createValueResource: createValueResource,
-	createJsonResource: createJsonResource,
-	createMapResourceWithType: createMapResourceWithType,
-	createMapResource: createMapResource,
-	createBinaryMapResource: createBinaryMapResource,
-	createBlobMapResource: createBlobMapResource
+isResource: isResource,
+isField: isField,
+isReference: isReference,
+isMapResource: isMapResource,
+isEphMapResource: isEphMapResource,
+isAnyMapResource: isAnyMapResource,
+isLockedEphMapResource: isLockedEphMapResource,
+isJsonResource: isJsonResource,
+resource: resource,
+field: field,
+resourceBuilder: resourceBuilder,
+structBuilder: structBuilder,
+mapBuilder: mapBuilder,
+ephemeralMapBuilder: ephemeralMapBuilder,
+ephemeralBuilder: ephemeralBuilder,
+createValueResource: createValueResource,
+createJsonResource: createJsonResource,
+createMapResourceWithType: createMapResourceWithType,
+createMapResource: createMapResource,
+createBinaryMapResource: createBinaryMapResource,
+createBlobMapResource: createBlobMapResource
 })