2.4.0

Author: bas080

CHANGELOG.md

@@ -4,8 +4,16 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v2.4.0](https://github.com/bas080/sendscript/compare/v2.3.9...v2.4.0)
+
+- Update tap to 4.5.4 [`5249a85`](https://github.com/bas080/sendscript/commit/5249a85a08b10485f0d64058fd2c8bcaae84edda)
+- Add fn and args support [`6110654`](https://github.com/bas080/sendscript/commit/6110654fa039d17cd9ba0e15f749756b615b5d09)
+- Move transport agnostic section to socket example [`3a92257`](https://github.com/bas080/sendscript/commit/3a9225787df16a0fd83293bfa14d91b74a46d070)
+
 #### [v2.3.9](https://github.com/bas080/sendscript/compare/v2.3.8...v2.3.9)
 
+> 14 April 2026
+
 - Remove schema description from reference and schema shape [`7126829`](https://github.com/bas080/sendscript/commit/7126829b5968588d7c9377ee643b88465f3fe16e)
 
 #### [v2.3.8](https://github.com/bas080/sendscript/compare/v2.3.7...v2.3.8)

README.md

@@ -25,6 +25,7 @@ Write JS code that you can run on servers, browsers or other clients.
   * [Server](#server)
   * [Client](#client)
 - [Repl](#repl)
+- [Functions](#functions)
 - [Promises](#promises)
   * [.then / .catch](#then--catch)
   * [await](#await)
@@ -114,17 +115,14 @@ core or around it. Things like supporting more complex (de)serializers, errors
 and maybe mixing client functions with sendscript programs. Contact me if I have
 piqued your interest.
 
-***
-
-SendScript leaves it up to you to choose HTTP, web-sockets or any other method
-of communication between servers and clients that best fits your needs.
-
 ## Reference
 
 <!-- Generated by documentation.js. Update this documentation by updating the source code. -->
 
 ### defaultLeafParse
 
+[parse.mjs:49-49](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/parse.mjs#L49-L49 "Source code on GitHub")
+
 Default deserializer for leaf nodes.
 
 #### Parameters
@@ -135,6 +133,8 @@ Returns **any**&#x20;
 
 ### Parse
 
+[parse.mjs:68-215](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/parse.mjs#L68-L215 "Source code on GitHub")
+
 #### Parameters
 
 *   `schema` **[Schema](#schema)**&#x20;
@@ -145,6 +145,8 @@ Returns **[parse](#parse)**&#x20;
 
 ### parse
 
+[parse.mjs:78-214](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/parse.mjs#L78-L214 "Source code on GitHub")
+
 Parses and executes a serialized program.
 
 #### Parameters
@@ -155,6 +157,8 @@ Returns **(any | [Promise](https://developer.mozilla.org/docs/Web/JavaScript/Ref
 
 ### References
 
+[references.mjs:109-127](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/references.mjs#L109-L127 "Source code on GitHub")
+
 Builds a nested API structure from a schema definition.
 
 #### Parameters
@@ -170,12 +174,16 @@ Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 
 ### SchemaNode
 
+[schema.mjs:1-19](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/schema.mjs#L1-L6 "Source code on GitHub")
+
 A single schema node.
 
 Type: ([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | \[[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Schema](#schema)])
 
 ### Schema
 
+[schema.mjs:1-19](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/schema.mjs#L8-L18 "Source code on GitHub")
+
 A schema defines the structure of the runtime API tree.
 
 *   string → leaf node
@@ -187,6 +195,8 @@ Type: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global
 
 ### defaultLeafStringify
 
+[stringify.mjs:37-47](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/stringify.mjs#L37-L47 "Source code on GitHub")
+
 Default strict serializer for leaf values.
 
 Rejects non-JSON-safe values.
@@ -199,6 +209,8 @@ Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 
 ### Stringify
 
+[stringify.mjs:56-157](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/stringify.mjs#L56-L157 "Source code on GitHub")
+
 Creates a stringify function for SendScript AST structures.
 
 #### Parameters
@@ -209,6 +221,8 @@ Returns **[stringify](#stringify)**&#x20;
 
 ### stringify
 
+[stringify.mjs:64-156](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/stringify.mjs#L64-L156 "Source code on GitHub")
+
 Serializes a program into a JSON string representation.
 
 #### Parameters
@@ -219,6 +233,9 @@ Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/G
 
 ## Socket example
 
+SendScript leaves it up to you to choose HTTP, web-sockets or any other method
+of communication between servers and clients that best fits your needs.
+
 For this example we'll use [socket.io][socket.io].
 
 ### Module
@@ -325,6 +342,24 @@ run it by simply typing `sendscript` in their console.
 > Use the `DEBUG='*'` to enable all logs or `DEBUG='sendscript:*'` for
 > printingonly sendscript logs.
 
+## Functions
+
+SendScript as of `v2.4` supports functions to do basic templating. It does not
+support async functions and will throw an error when you define one.
+
+Under the hood the function is called when it is being parsed. Make sure you
+understand what you are doing when mixing client and server functions.
+
+```js
+map((a) => add(a, 1))([1, 2, 3]))
+```
+
+It also supports nested functions.
+
+```js
+map(call)(map((a) => () => add(a, 1))([1, 2, 3]))
+```
+
 ## Promises
 
 ### .then / .catch

example/typescript/docs/functions/add.md

@@ -8,7 +8,7 @@
 
 > **add**(`a`, `b`): `number`
 
-Defined in: [math.ts:1](https://github.com/bas080/sendscript/blob/7126829b5968588d7c9377ee643b88465f3fe16e/example/typescript/math.ts#L1)
+Defined in: [math.ts:1](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/example/typescript/math.ts#L1)
 
 ## Parameters
 

example/typescript/docs/functions/square.md

@@ -8,7 +8,7 @@
 
 > **square**(`a`): `number`
 
-Defined in: [math.ts:2](https://github.com/bas080/sendscript/blob/7126829b5968588d7c9377ee643b88465f3fe16e/example/typescript/math.ts#L2)
+Defined in: [math.ts:2](https://github.com/bas080/sendscript/blob/5249a85a08b10485f0d64058fd2c8bcaae84edda/example/typescript/math.ts#L2)
 
 ## Parameters
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "sendscript",
-  "version": "2.3.9",
+  "version": "2.4.0",
   "description": "Blur the line between server and client code.",
   "module": true,
   "main": "index.mjs",