@formadapter/http 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ludicrous
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# `@formadapter/http`
+
+Use any JSON or multipart HTTP endpoint as a FormAdapter submission target.
+
+```sh
+bun add @formadapter/http
+```
+
+```tsx
+import { createHttpSubmission } from "@formadapter/http";
+
+const submit = createHttpSubmission({ url: "/api/profile" });
+
+<Profile.Form onSubmit={submit} />;
+```
+
+JSON is the default. It sends `SubmitContext.input`, the prepared schema input
+before output transforms, so the server can validate and transform again at its
+trust boundary. The endpoint response is wrapped as a successful shared
+`SubmissionState` unless it already returns a well-formed state.
+
+For files or an existing multipart endpoint, send the schema-aware FormData
+created by the React runtime:
+
+```tsx
+const submit = createHttpSubmission({
+  url: "/api/profile",
+  body: "form-data",
+  init: { credentials: "include" },
+});
+```
+
+Do not manually set `content-type` in FormData mode; `fetch` must add its
+boundary. `init` may also be a per-submit function and can set method/headers.
+The submit AbortSignal is always forwarded, and a custom `fetch` implementation
+is supported.
+
+Structured error states from successful and 4xx responses are preserved. A 4xx
+string or `message` is treated as intentional client-safe feedback. Response
+bodies from 5xx failures and exception messages from network failures are never
+shown to users; they use `errorMessage` or a safe fallback instead. Aborts are
+re-thrown so cancellation keeps working. A failed HTTP status is never treated
+as success merely because its body resembles a successful state.

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { SubmissionState } from "@formadapter/core";
+
+//#region src/index.d.ts
+interface HttpSubmissionContext<Input = unknown> {
+  readonly input: Input;
+  readonly formData: FormData;
+  readonly signal: AbortSignal;
+}
+interface HttpSubmissionOptions {
+  readonly url: RequestInfo | URL;
+  readonly body?: "form-data" | "json";
+  readonly fetch?: typeof globalThis.fetch;
+  readonly init?: Omit<RequestInit, "body" | "signal"> | ((context: HttpSubmissionContext) => Omit<RequestInit, "body" | "signal">);
+  readonly errorMessage?: string;
+}
+type HttpSubmission = (output: unknown, context: HttpSubmissionContext) => Promise<SubmissionState>;
+declare function createHttpSubmission(options: HttpSubmissionOptions): HttpSubmission;
+//#endregion
+export { HttpSubmission, HttpSubmissionContext, HttpSubmissionOptions, createHttpSubmission };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,78 @@
+import { isSubmissionState, submissionFailure, submissionSuccess } from "@formadapter/core";
+//#region src/index.ts
+const DEFAULT_NETWORK_ERROR_MESSAGE = "Unable to reach the server. Please try again.";
+const DEFAULT_RESPONSE_ERROR_MESSAGE = "Unable to read the server response. Please try again.";
+function transportFailure(message) {
+	return submissionFailure({
+		errorKind: "transport",
+		formErrors: [message]
+	});
+}
+function isAbort(error, signal) {
+	if (signal.aborted) return true;
+	try {
+		return typeof error === "object" && error !== null && "name" in error && error.name === "AbortError";
+	} catch {
+		return false;
+	}
+}
+function fallbackMessage(configured, fallback) {
+	return configured?.trim() ? configured : fallback;
+}
+function responseErrorMessage(body) {
+	if (typeof body === "string") return body.trim() ? body : void 0;
+	if (typeof body !== "object" || body === null) return void 0;
+	try {
+		if (!Object.hasOwn(body, "message")) return void 0;
+		const message = body.message;
+		return typeof message === "string" && message.trim() ? message : void 0;
+	} catch {
+		return;
+	}
+}
+async function responseBody(response) {
+	if (response.status === 204) return void 0;
+	const contentType = response.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+	if (contentType === "application/json" || contentType.endsWith("+json")) return response.json();
+	return await response.text() || void 0;
+}
+function createHttpSubmission(options) {
+	return async (_output, context) => {
+		const request = options.fetch ?? globalThis.fetch;
+		const configured = typeof options.init === "function" ? options.init(context) : options.init ?? {};
+		const formDataBody = options.body === "form-data";
+		const headers = new Headers(configured.headers);
+		if (!formDataBody && !headers.has("content-type")) headers.set("content-type", "application/json");
+		let response;
+		try {
+			response = await request(options.url, {
+				...configured,
+				body: formDataBody ? context.formData : JSON.stringify(context.input),
+				headers,
+				method: configured.method ?? "POST",
+				signal: context.signal
+			});
+		} catch (error) {
+			if (isAbort(error, context.signal)) throw error;
+			return transportFailure(fallbackMessage(options.errorMessage, DEFAULT_NETWORK_ERROR_MESSAGE));
+		}
+		let body;
+		try {
+			body = await responseBody(response);
+		} catch (error) {
+			if (isAbort(error, context.signal)) throw error;
+			return transportFailure(fallbackMessage(options.errorMessage, DEFAULT_RESPONSE_ERROR_MESSAGE));
+		}
+		if (!response.ok) {
+			if (response.status >= 500) return transportFailure(fallbackMessage(options.errorMessage, `Request failed with status ${response.status}`));
+			if (isSubmissionState(body) && body.status === "error") return body;
+			return transportFailure(responseErrorMessage(body) ?? fallbackMessage(options.errorMessage, `Request failed with status ${response.status}`));
+		}
+		if (isSubmissionState(body)) return body;
+		return submissionSuccess(body);
+	};
+}
+//#endregion
+export { createHttpSubmission };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import {\n  isSubmissionState,\n  submissionFailure,\n  submissionSuccess,\n  type SubmissionState,\n} from \"@formadapter/core\";\n\nexport interface HttpSubmissionContext<Input = unknown> {\n  readonly input: Input;\n  readonly formData: FormData;\n  readonly signal: AbortSignal;\n}\n\nexport interface HttpSubmissionOptions {\n  readonly url: RequestInfo | URL;\n  readonly body?: \"form-data\" | \"json\";\n  readonly fetch?: typeof globalThis.fetch;\n  readonly init?:\n    | Omit<RequestInit, \"body\" | \"signal\">\n    | ((context: HttpSubmissionContext) => Omit<RequestInit, \"body\" | \"signal\">);\n  readonly errorMessage?: string;\n}\n\nexport type HttpSubmission = (\n  output: unknown,\n  context: HttpSubmissionContext,\n) => Promise<SubmissionState>;\n\nconst DEFAULT_NETWORK_ERROR_MESSAGE =\n  \"Unable to reach the server. Please try again.\";\nconst DEFAULT_RESPONSE_ERROR_MESSAGE =\n  \"Unable to read the server response. Please try again.\";\n\nfunction transportFailure(message: string): SubmissionState {\n  return submissionFailure({\n    errorKind: \"transport\",\n    formErrors: [message],\n  });\n}\n\nfunction isAbort(error: unknown, signal: AbortSignal): boolean {\n  if (signal.aborted) return true;\n  try {\n    return (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"name\" in error &&\n      error.name === \"AbortError\"\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction fallbackMessage(\n  configured: string | undefined,\n  fallback: string,\n): string {\n  return configured?.trim() ? configured : fallback;\n}\n\nfunction responseErrorMessage(body: unknown): string | undefined {\n  if (typeof body === \"string\") return body.trim() ? body : undefined;\n  if (typeof body !== \"object\" || body === null) return undefined;\n  try {\n    if (!Object.hasOwn(body, \"message\")) return undefined;\n    const message = (body as Readonly<Record<string, unknown>>).message;\n    return typeof message === \"string\" && message.trim() ? message : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function responseBody(response: Response): Promise<unknown> {\n  if (response.status === 204) return undefined;\n  const contentType = response.headers.get(\"content-type\")\n    ?.split(\";\", 1)[0]\n    ?.trim()\n    .toLowerCase() ?? \"\";\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return response.json();\n  }\n  const text = await response.text();\n  return text || undefined;\n}\n\nexport function createHttpSubmission(\n  options: HttpSubmissionOptions,\n): HttpSubmission {\n  return async (_output, context) => {\n    const request = options.fetch ?? globalThis.fetch;\n    const configured = typeof options.init === \"function\"\n      ? options.init(context)\n      : options.init ?? {};\n    const formDataBody = options.body === \"form-data\";\n    const headers = new Headers(configured.headers);\n    if (!formDataBody && !headers.has(\"content-type\")) {\n      headers.set(\"content-type\", \"application/json\");\n    }\n    let response: Response;\n    try {\n      response = await request(options.url, {\n        ...configured,\n        body: formDataBody\n          ? context.formData\n          : JSON.stringify(context.input),\n        headers,\n        method: configured.method ?? \"POST\",\n        signal: context.signal,\n      });\n    } catch (error) {\n      if (isAbort(error, context.signal)) throw error;\n      return transportFailure(\n        fallbackMessage(options.errorMessage, DEFAULT_NETWORK_ERROR_MESSAGE),\n      );\n    }\n\n    let body: unknown;\n    try {\n      body = await responseBody(response);\n    } catch (error) {\n      if (isAbort(error, context.signal)) throw error;\n      return transportFailure(\n        fallbackMessage(options.errorMessage, DEFAULT_RESPONSE_ERROR_MESSAGE),\n      );\n    }\n\n    if (!response.ok) {\n      if (response.status >= 500) {\n        return transportFailure(\n          fallbackMessage(\n            options.errorMessage,\n            `Request failed with status ${response.status}`,\n          ),\n        );\n      }\n      if (isSubmissionState(body) && body.status === \"error\") return body;\n      const message = responseErrorMessage(body) ?? fallbackMessage(\n        options.errorMessage,\n        `Request failed with status ${response.status}`,\n      );\n      return transportFailure(message);\n    }\n    if (isSubmissionState(body)) return body;\n    return submissionSuccess(body);\n  };\n}\n"],"mappings":";;AA4BA,MAAM,gCACJ;AACF,MAAM,iCACJ;AAEF,SAAS,iBAAiB,SAAkC;AAC1D,QAAO,kBAAkB;EACvB,WAAW;EACX,YAAY,CAAC,QAAQ;EACtB,CAAC;;AAGJ,SAAS,QAAQ,OAAgB,QAA8B;AAC7D,KAAI,OAAO,QAAS,QAAO;AAC3B,KAAI;AACF,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACV,MAAM,SAAS;SAEX;AACN,SAAO;;;AAIX,SAAS,gBACP,YACA,UACQ;AACR,QAAO,YAAY,MAAM,GAAG,aAAa;;AAG3C,SAAS,qBAAqB,MAAmC;AAC/D,KAAI,OAAO,SAAS,SAAU,QAAO,KAAK,MAAM,GAAG,OAAO,KAAA;AAC1D,KAAI,OAAO,SAAS,YAAY,SAAS,KAAM,QAAO,KAAA;AACtD,KAAI;AACF,MAAI,CAAC,OAAO,OAAO,MAAM,UAAU,CAAE,QAAO,KAAA;EAC5C,MAAM,UAAW,KAA2C;AAC5D,SAAO,OAAO,YAAY,YAAY,QAAQ,MAAM,GAAG,UAAU,KAAA;SAC3D;AACN;;;AAIJ,eAAe,aAAa,UAAsC;AAChE,KAAI,SAAS,WAAW,IAAK,QAAO,KAAA;CACpC,MAAM,cAAc,SAAS,QAAQ,IAAI,eAAe,EACpD,MAAM,KAAK,EAAE,CAAC,IACd,MAAM,CACP,aAAa,IAAI;AACpB,KAAI,gBAAgB,sBAAsB,YAAY,SAAS,QAAQ,CACrE,QAAO,SAAS,MAAM;AAGxB,QAAO,MADY,SAAS,MAAM,IACnB,KAAA;;AAGjB,SAAgB,qBACd,SACgB;AAChB,QAAO,OAAO,SAAS,YAAY;EACjC,MAAM,UAAU,QAAQ,SAAS,WAAW;EAC5C,MAAM,aAAa,OAAO,QAAQ,SAAS,aACvC,QAAQ,KAAK,QAAQ,GACrB,QAAQ,QAAQ,EAAE;EACtB,MAAM,eAAe,QAAQ,SAAS;EACtC,MAAM,UAAU,IAAI,QAAQ,WAAW,QAAQ;AAC/C,MAAI,CAAC,gBAAgB,CAAC,QAAQ,IAAI,eAAe,CAC/C,SAAQ,IAAI,gBAAgB,mBAAmB;EAEjD,IAAI;AACJ,MAAI;AACF,cAAW,MAAM,QAAQ,QAAQ,KAAK;IACpC,GAAG;IACH,MAAM,eACF,QAAQ,WACR,KAAK,UAAU,QAAQ,MAAM;IACjC;IACA,QAAQ,WAAW,UAAU;IAC7B,QAAQ,QAAQ;IACjB,CAAC;WACK,OAAO;AACd,OAAI,QAAQ,OAAO,QAAQ,OAAO,CAAE,OAAM;AAC1C,UAAO,iBACL,gBAAgB,QAAQ,cAAc,8BAA8B,CACrE;;EAGH,IAAI;AACJ,MAAI;AACF,UAAO,MAAM,aAAa,SAAS;WAC5B,OAAO;AACd,OAAI,QAAQ,OAAO,QAAQ,OAAO,CAAE,OAAM;AAC1C,UAAO,iBACL,gBAAgB,QAAQ,cAAc,+BAA+B,CACtE;;AAGH,MAAI,CAAC,SAAS,IAAI;AAChB,OAAI,SAAS,UAAU,IACrB,QAAO,iBACL,gBACE,QAAQ,cACR,8BAA8B,SAAS,SACxC,CACF;AAEH,OAAI,kBAAkB,KAAK,IAAI,KAAK,WAAW,QAAS,QAAO;AAK/D,UAAO,iBAJS,qBAAqB,KAAK,IAAI,gBAC5C,QAAQ,cACR,8BAA8B,SAAS,SACxC,CAC+B;;AAElC,MAAI,kBAAkB,KAAK,CAAE,QAAO;AACpC,SAAO,kBAAkB,KAAK"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@formadapter/http",
+  "version": "0.0.0",
+  "description": "JSON and multipart HTTP submissions for FormAdapter forms.",
+  "keywords": [
+    "fetch",
+    "forms",
+    "http",
+    "standard-schema",
+    "typescript"
+  ],
+  "homepage": "https://formadapter.com",
+  "bugs": {
+    "url": "https://github.com/ludicroushq/formadapter/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ludicroushq/formadapter.git",
+    "directory": "packages/http"
+  },
+  "author": "ludicrous",
+  "type": "module",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo .turbo",
+    "test": "vitest run --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@formadapter/core": "^0.0.0"
+  },
+  "license": "MIT"
+}