jsgui3-server 0.0.131 → 0.0.133

package/README.md

@@ -768,6 +768,33 @@ const server = new Server({
 
 Data models can be shared within a single client instance, enabling synchronized UI controls.
 
+### Publishing functions with `server.publish`
+
+The server can publish plain JavaScript functions as HTTP endpoints. When a function is published, request bodies are parsed and passed to the function, and the function's return value determines the response MIME type. The API base path (for example, `/api`) is prefixed automatically, so only provide the route suffix to `publish()`.
+
+- If the function returns a string, the response is sent as `text/plain; charset=UTF-8`.
+- If the function returns an object (including arrays), it is serialized as JSON with `application/json`.
+- If the function returns a Promise, it is awaited and then handled by the two rules above.
+
+Input payload handling:
+- `Content-Type: application/json` bodies are parsed to an object and passed as the single argument.
+- `Content-Type: text/plain` bodies are passed as a UTF-8 string.
+
+Minimal example:
+
+```javascript
+// Inside your server bootstrap (after constructing Server)
+server.on('ready', () => {
+  // Returns text/plain at GET/POST /api/hello
+  server.publish('hello', name => `Hello ${name || 'world'}`);
+
+  // Returns application/json at GET/POST /api/sum
+  server.publish('sum', ({ a, b }) => ({ sum: a + b }));
+});
+```
+
+This behavior is implemented by the function publisher, which inspects the function result type to choose the correct headers and serialization.
+
 ## CSS Architecture and Styling
 
 ### CSS Definition Patterns

package/examples/json-api/json_server_1.js

@@ -21,6 +21,17 @@ if (require.main === module) {
         return new Date().toISOString();
     });
 
+    server.publish('user', () => {
+        return { id: 1, name: 'John Doe' };
+    });
+
+    server.publish('users', () => {
+        return [
+            { id: 1, name: 'John Doe' },
+            { id: 2, name: 'Jane Doe' }
+        ];
+    });
+
     server.start(8088);
     
 }

package/package.json

@@ -38,5 +38,5 @@
     "type": "git",
     "url": "https://github.com/metabench/jsgui3-server.git"
   },
-  "version": "0.0.131"
+  "version": "0.0.133"
 }

package/publishers/http-function-publisher.js

@@ -145,7 +145,7 @@ class Function_Publisher extends HTTP_Publisher {
                 const tfr = tf(fn_res);
                 //console.log('fn_res', fn_res);
                 
-                //console.log('tfr', tfr);
+                //
 
                 if (tfr === 'p') {
                     // promise
@@ -174,8 +174,22 @@ class Function_Publisher extends HTTP_Publisher {
                     res.end(fn_res);
 
 
-                } else {
+                } else if (tfr === 'o' || tfr === 'a') {
+                    // Just write it as a string for the moment I think?
+                    //   Or always encode as JSON?
 
+                    // text/plain;charset=UTF-8
+
+                    res.writeHead(200, {
+                        'Content-Type': 'application/json'//,
+                        //'Transfer-Encoding': 'chunked',
+                        //'Trailer': 'Content-MD5'
+                    });
+                    res.end(JSON.stringify(fn_res));
+
+
+                } else {
+                    console.log('tfr', tfr);
                     console.trace();
                     throw 'NYI';
                 }