sendscript 2.3.4 → 2.3.5

package/CHANGELOG.md

@@ -4,8 +4,14 @@ 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.3.5](https://github.com/bas080/sendscript/compare/v2.3.4...v2.3.5)
+
+- Have reference and parse reference same schema type [`0a05608`](https://github.com/bas080/sendscript/commit/0a0560828b78d297bfa5b12639a5e54774c089bd)
+
 #### [v2.3.4](https://github.com/bas080/sendscript/compare/v2.3.3...v2.3.4)
 
+> 14 April 2026
+
 - Improve naming in JSDocs [`669a40e`](https://github.com/bas080/sendscript/commit/669a40e28a5c77963d855dd4e2122d0ba2c074cd)
 
 #### [v2.3.3](https://github.com/bas080/sendscript/compare/v2.3.2...v2.3.3)

package/CONTRIBUTING.md

@@ -40,7 +40,7 @@ Generate the README from the mz file.
 ```bash bash
 markatzea ./README.mz | tee ./README.md
 
-npx documentation readme references.mjs stringify.mjs parse.mjs -s Reference --github --a public --markdown-toc false
+npx documentation readme schema.mjs references.mjs stringify.mjs parse.mjs -s Reference --github --a public --markdown-toc false
 
 npx markdown-toc --maxdepth 3 -i README.md
 

package/README.md

@@ -15,6 +15,7 @@ Write JS code that you can run on servers, browsers or other clients.
   * [Parse](#parse)
   * [parse](#parse)
   * [References](#references)
+  * [Schema](#schema)
   * [defaultLeafStringify](#defaultleafstringify)
   * [Stringify](#stringify)
   * [stringify](#stringify)
@@ -135,7 +136,7 @@ Returns **any** 
 
 #### Parameters
 
-*   `schemaArg` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | \[[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)])>**&#x20;
+*   `schema` **[Schema](#schema)**&#x20;
 *   `env` **Env** runtime environment for refs
 *   `leafParse`   (optional, default `defaultLeafParse`)
 
@@ -162,7 +163,7 @@ Schema supports:
 
 #### Parameters
 
-*   `schema` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | \[[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)])>**&#x20;
+*   `schema` **[Schema](#schema)**&#x20;
 *   `parentPath` **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>**  (optional, default `[]`)
 
 <!---->
@@ -171,6 +172,15 @@ Schema supports:
 
 Returns **[Object](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object)** Nested instrumented API object
 
+### Schema
+
+A schema defines the structure of the runtime API tree.
+
+*   string → leaf node
+*   \[name, children] → namespace
+
+Type: [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | \[[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)])>
+
 ### defaultLeafStringify
 
 Default strict serializer for leaf values.

package/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/669a40e28a5c77963d855dd4e2122d0ba2c074cd/example/typescript/math.ts#L1)
+Defined in: [math.ts:1](https://github.com/bas080/sendscript/blob/0a0560828b78d297bfa5b12639a5e54774c089bd/example/typescript/math.ts#L1)
 
 ## Parameters
 

package/example/typescript/docs/functions/square.md

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

package/package.json

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

package/parse.mjs

@@ -112,14 +112,14 @@ const defaultLeafParse = (text) => JSON.parse(text)
  * - collects and executes async awaits
  * - evaluates AST-like JSON programs
  *
- * @param {Array<string | [string, Array]>} schemaArg
+ * @param {Schema}  schema
  * @param {Env} env - runtime environment for refs
  * @param {(text: string) => any} [leafParse=defaultLeafParse]
  * @returns {parse}
  * @public
  */
-export default function Parse (schemaArg, env, leafParse = defaultLeafParse) {
-  const schema = flattenSchema(schemaArg)
+export default function Parse (schema, env, leafParse = defaultLeafParse) {
+  const flatSchema = flattenSchema(schema)
 
   /**
    * Parses and executes a serialized program.
@@ -160,7 +160,7 @@ export default function Parse (schemaArg, env, leafParse = defaultLeafParse) {
       if (operator === 'ref') {
         const path = rest
         let current = env
-        let schemaCurrent = schema
+        let schemaCurrent = flatSchema
 
         for (const segment of path) {
           if (schemaCurrent && Object.hasOwn(schemaCurrent, segment)) {

package/references.mjs

@@ -104,7 +104,7 @@ function instrument (path) {
  * - string => leaf function node
  * - [name, children] => namespace with nested schema
  *
- * @param {Array<string | [string, Array]>} schema
+ * @param {Schema} schema
  * @param {Array<string>} [parentPath=[]]
  * @returns {Object} Nested instrumented API object
  *

package/schema.mjs

@@ -0,0 +1,9 @@
+/**
+ * A schema defines the structure of the runtime API tree.
+ *
+ * - string → leaf node
+ * - [name, children] → namespace
+ *
+ * @typedef {Array<string | [string, Array]>} Schema
+ * @public
+ */