@robinpath/form

Multipart form data builder, file uploads, URL encoding/decoding, and form submission

Why use this module?

The form module lets you:

• Create a FormData object from key-value pairs
• Add a text field to a FormData
• Add a file to a FormData
• Submit a FormData to a URL
• URL-encode an object as application/x-www-form-urlencoded

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

Installation

npm install @robinpath/form

Quick Start

No credentials needed — start using it right away:

form.addField $form "name" "Alice"

Available Functions

| Function | Description | |----------|-------------| | form.create | Create a FormData object from key-value pairs | | form.addField | Add a text field to a FormData | | form.addFile | Add a file to a FormData | | form.submit | Submit a FormData to a URL | | form.encode | URL-encode an object as application/x-www-form-urlencoded | | form.decode | Decode a URL-encoded form body | | form.uploadFile | Upload a file to a URL as multipart form | | form.parseMultipart | Parse a multipart form body |

Examples

Add a text field to a FormData

form.addField $form "name" "Alice"

Add a file to a FormData

form.addFile $form "avatar" "./photo.jpg"

Submit a FormData to a URL

form.submit "https://api.example.com/upload" $form

Integration with RobinPath

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

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

const result = await rp.executeScript(`
  form.addField $form "name" "Alice"
`);

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