@robinpath/http

HTTP server for RobinPath scripts. Register routes with static responses (JSON, HTML, files), enable CORS, serve static directories. No callbacks needed.

Why use this module?

The http module lets you:

• Create a new HTTP server instance (does not start listening yet)
• Register a GET route that returns static JSON data
• Register a POST route that returns static JSON data
• Register a PUT route that returns static JSON data
• Register a DELETE route that returns static JSON data

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/http

Quick Start

No credentials needed — start using it right away:

any "myapi" "/api/products" [{"id": 1}]

Available Functions

Function	Description
http.createServer	Create a new HTTP server instance (does not start listening yet)
http.get	Register a GET route that returns static JSON data
http.post	Register a POST route that returns static JSON data
http.put	Register a PUT route that returns static JSON data
http.delete	Register a DELETE route that returns static JSON data
http.html	Register a GET route that serves an HTML string
http.file	Register a GET route that serves a file from disk
http.redirect	Register a route that redirects to another URL
http.static	Register a directory to serve static files from
http.cors	Enable CORS on the server
http.listen	Start the HTTP server listening for requests
http.stop	Stop the HTTP server gracefully
http.status	Get server status: port, routes, listening state, request count
http.logs	Get the request log for a server

Examples

Register a GET route that returns static JSON data

any "myapi" "/api/products" [{"id": 1}]

Register a POST route that returns static JSON data

any "myapi" "/api/products" {"created": true}

Register a PUT route that returns static JSON data

any "myapi" "/api/products/:id" {"updated": true}

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/http";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  any "myapi" "/api/products" [{"id": 1}]
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT