FormForge Client

Upload and DateTime Modes

Choose staged, managed, or direct upload strategy and datetime serialization mode.

Upload mode

staged (default): stage files first, then submit upload tokens
managed: send multipart payload directly at submit time
direct: send JSON file references

File fields support the following schema limits:

accept: accepted extensions or MIME types
max_files: maximum number of files when multiple selection is enabled
max_size: maximum size per file in bytes
max_total_size: maximum combined size in bytes

The client validates these limits before submission. The backend remains authoritative and applies the same limits to managed and staged payloads.

Per-call override:

await submitter.submit({ mode: 'managed' })

DateTime mode

offset: keep local timezone offset
utc: convert to UTC ISO

The current form UI treats temporal as the canonical field shape. Legacy temporal variants remain supported for existing schemas, but new integrations should prefer the unified temporal schema on the backend and date / time modes in the client renderer.

Auth and Request Hooks

Inject auth headers and context before every FormForge request.

Error Handling

Interpret normalized FormForge client errors and map business codes.