fable 3.1.74 → 3.1.75

package/docs/services/expression-parser-functions/README.md

@@ -161,6 +161,10 @@ Basic math operations with arbitrary precision:
 - [bezierpoint](./bezierpoint.md) - Evaluate point on cubic Bezier curve
 - [beziercurvefit](./beziercurvefit.md) - Fit cubic Bezier curve to data points
 
+### Identifier Generation
+
+- [generateguid](./generateguid.md) - Generate a unique GUID string
+
 ### Other Utilities
 
 - [generatearrayofobjectsfromsets](./generatearrayofobjectsfromsets.md) - Generate objects from sets

package/docs/services/expression-parser-functions/generateguid.md

@@ -0,0 +1,56 @@
+# generateguid
+
+Generates a GUID string.
+
+## Syntax
+
+```
+generateguid()
+```
+
+## Parameters
+
+None
+
+## Returns
+
+String - A newly generated GUID, e.g. `'0x53c7c0bed0010000'`.
+
+## Description
+
+The `generateguid` function returns a unique identifier by delegating to `fable.getUUID()`. The underlying [UUID service](../uuid.md) uses the Snowflake ID pattern, encoding a timestamp together with the configured DataCenter and Worker IDs so that distributed processes can mint IDs without coordination.
+
+Each call produces a new identifier.
+
+## Examples
+
+### Basic Usage
+
+```expression
+Result = GENERATEGUID()
+// Result: "0x53c7c0bed0010000" (different each call)
+```
+
+### Tagging a Record
+
+```expression
+// Stamp a synthetic record with a fresh ID
+RecordID = GENERATEGUID()
+```
+
+## Use Cases
+
+- **Synthetic IDs**: Assign identifiers to records produced inside an expression
+- **Test data**: Generate unique keys for fixtures and mocks
+- **Correlation IDs**: Mint a trace/correlation token to thread through downstream calls
+
+## Related Functions
+
+- [randominteger](./randominteger.md) - Random integer (not guaranteed unique)
+
+## Notes
+
+- Returns the result as a string
+- Backed by `fable.getUUID()` / the Fable UUID service ([details](../uuid.md))
+- Configure DataCenter and Worker IDs via the `UUID` settings block on the Fable instance to keep IDs distinct across processes
+- Each call produces a different value

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fable",
-  "version": "3.1.74",
+  "version": "3.1.75",
   "description": "A service dependency injection, configuration and logging library.",
   "main": "source/Fable.js",
   "scripts": {

package/source/services/Fable-Service-ExpressionParser/Fable-Service-ExpressionParser-FunctionMap.json

@@ -520,5 +520,10 @@
 	"beziercurvefit": {
 		"Name": "Fit a Cubic Bezier Curve to a Set of Data Points",
 		"Address": "fable.Math.bezierCurveFit"
+	},
+
+	"generateguid": {
+		"Name": "Generate a GUID string",
+		"Address": "fable.getUUID"
 	}
 }

package/test/ExpressionParser_tests.js

@@ -331,6 +331,8 @@ suite
 									let tmpResultPrecise = _Parser.solve('Result = (160 * PR * Z) / (C / 100) * PR * Z + (160 * (1 - C / 100))', { C: "-13", PR: "1.5", Z: "20.03" })
 									Expect(tmpResultPrecise).to.equal("-1110837.0769230769230769230307");
 
+									Expect(_Parser.solve('Result = generateguid()').length).to.equal(36);
+
 									return fDone();
 								}
 							);