Documentation menuHandler

Handler

Options of createInverseHandler and handleDeclaration.

import { createInverseHandler, type HandlerOptions } from "@sweberdev/inverse";

Option	Type
`company`	`{ name, address?, email?, website? }`	shown in receipt and copy
`onDeclaration`	`(record) => void \| Promise<void>`	store the declaration; if it throws, the consumer sees an error and can retry
`sendReceipt`	`(receipt, record) => void \| Promise<void>`	send the e-mail; errors go to `onError`, the consumer still gets the copy
`kinds`	`("withdrawal" \| "cancellation")[]`	default both
`locale`	`"de" \| "en" \| "fr" \| "it"`	fallback if the request sends none
`timeZone`	IANA zone	dates in receipts, default `Europe/Berlin`
`resolveEndDate`	`(record) => string \| undefined`	cancellation: end date for the receipt
`onError`	`(error, record?) => void`	default `console.error`

Order of operations

Reject other methods (405) and unknown kinds (400).
Honeypot filled: answer with success, store nothing.
Validate (422 with field errors).
Create the record with a random reference and receivedAt from the server clock.
resolveEndDate, then onDeclaration. Failure: 500.
Render and send the receipt. Failure is logged, not shown: the declaration is received either way.
Return the reference, time and a text copy.

Rate limiting is up to your platform (Vercel firewall, Cloudflare, middleware). Don't add a captcha that can block real consumers; the honeypot catches simple bots.

Record

interface DeclarationRecord {
  id: string;            // "W-7K3QX9PD" or "K-…"
  kind: "withdrawal" | "cancellation";
  receivedAt: string;    // ISO 8601, server time
  locale: "de" | "en" | "fr" | "it";
  data: WithdrawalInput | CancellationInput;
  endsAt?: string;       // cancellation, YYYY-MM-DD
}