@formadapter/server 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,100 @@
+# `@formadapter/server`
+
+Framework-neutral schema-aware FormData/JSON validation and reusable submission
+transports for FormAdapter.
+
+```sh
+bun add @formadapter/server
+```
+
+The package compiles a schema's input-side Standard JSON Schema once and
+delegates authoritative validation/transformation to the original Standard
+Schema. FormData is decoded from model-known paths and normalized for browser
+semantics first. JSON is passed to the schema exactly as received: unknown
+keys, malformed nested values, and other invalid input are never pruned before
+validation. Zod, ArkType, and any other schema exposing both standards use the
+same boundary.
+
+## Reusable submissions
+
+Build one transport-neutral submission, then expose it through any boundary:
+
+```ts
+import { z } from "zod";
+import {
+  createSubmissionHandler,
+  fieldError,
+  toRequestHandler,
+  toServerAction,
+} from "@formadapter/server";
+
+const schema = z.object({
+  email: z.email(),
+  age: z.number().int().min(18),
+});
+
+const submission = createSubmissionHandler(schema, async (values) => {
+  if (await emailAlreadyExists(values.email)) {
+    throw fieldError("email", "That email is already registered");
+  }
+  return database.users.create({ data: values });
+});
+
+export const action = toServerAction(submission);
+export const POST = toRequestHandler(submission);
+```
+
+`createServerAction(schema, handler)` and
+`createRequestHandler(schema, handler)` are direct convenience factories. A
+server action has React's native `(previousState, FormData)` signature. The HTTP
+handler accepts POST requests with JSON, `multipart/form-data`, or
+`application/x-www-form-urlencoded` bodies and returns serialized
+`SubmissionState` JSON.
+
+Pass the same `config` used to create the client form when server parsing must
+apply `requiredWhenVisible` rules. Model-decoded FormData also prunes conditional
+`hidden` branches. JSON stays exactly as received so strict-object and malformed
+payload errors cannot disappear before schema validation:
+
+```ts
+const submission = createSubmissionHandler(schema, save, { config: formConfig });
+```
+
+Expected business failures should be thrown with `formError`, `fieldError`, or
+`FormAdapterServerError`. They become structured field/form errors. Unexpected
+errors are deliberately rethrown so framework error boundaries, monitoring,
+redirects, and not-found control flow are not swallowed.
+
+Transport adapters may add context to the submission's second argument. For
+example, the TanStack Start adapter preserves its middleware `context`, method,
+and server-function metadata for the business handler. Adapter-owned
+`payloadKind` and `formData` values cannot be overridden by transport input.
+
+Use `createSubmissionHandlerFactory<InvocationContext>()` to bind a transport
+context once while retaining schema-output and handler-result inference. Its
+returned submissions require the context argument; the default
+`createSubmissionHandler` remains optional-context and backward compatible.
+
+## Typed FormData decoding
+
+The React runtime uses dotted paths for objects and array indices. Three
+repeatable hidden markers preserve information native FormData normally loses:
+
+- `__formadapter_array` records a concrete array path, including an empty array.
+- `__formadapter_boolean` records a boolean path, including an unchecked value.
+- `__formadapter_value` opts a concrete scalar path into tagged string, number,
+  boolean, or null decoding.
+
+The exported constants are available for custom renderers. `parseFormData`
+ignores framework `$ACTION_` entries and unknown fields, protects unsafe object
+path segments and oversized indices, preserves files, normalizes optional and
+nullable blanks, and prunes presentation-hidden branches before validation.
+
+FormData parsing throws a descriptive configuration error for schema paths it
+cannot encode: FormAdapter's `__formadapter_` namespace, `$ACTION_` names,
+prototype keys, numeric-like keys, and keys containing path syntax such as dots,
+brackets, or quotes. JSON-only server submissions can still validate those
+properties, but FormAdapter cannot render or encode them as form fields.
+
+Do not treat hidden inputs as trusted data. Authentication, authorization, and
+ownership checks remain the responsibility of every server handler.

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+import { FormConfig, FormSchema, InferInput, InferOutput, MaybePromise, SubmissionAction, SubmissionState } from "@formadapter/core";
+
+//#region src/types.d.ts
+interface ParseFormDataSuccess<Output> {
+  readonly success: true;
+  readonly data: Output;
+}
+interface ParseFormDataFailure {
+  readonly success: false;
+  readonly fieldErrors: Readonly<Record<string, readonly string[]>>;
+  readonly formErrors: readonly string[];
+}
+type ParseFormDataResult<Output> = ParseFormDataFailure | ParseFormDataSuccess<Output>;
+interface SubmissionOptions<Schema extends FormSchema> {
+  readonly config?: FormConfig<InferInput<Schema>, string>;
+}
+interface SubmissionInvocationContext<Data = unknown> {
+  /** Transport-specific values (for example TanStack Start middleware context). */
+  readonly [key: string]: unknown;
+  readonly previousState?: SubmissionState<Data>;
+  readonly request?: Request;
+}
+type SubmissionHandlerContext<Data = unknown, InvocationContext extends object = SubmissionInvocationContext<Data>> = InvocationContext & {
+  readonly payloadKind: "form-data" | "json";
+  readonly formData?: FormData;
+};
+type SubmissionHandlerResult<Data> = Data | SubmissionState<Data> | void;
+type SubmissionValueHandler<Schema extends FormSchema, Data = unknown, InvocationContext extends object = SubmissionInvocationContext<Data>> = (value: InferOutput<Schema>, context: SubmissionHandlerContext<Data, InvocationContext>) => MaybePromise<SubmissionHandlerResult<Data>>;
+interface CreatedSubmissionHandler<Data = unknown, InvocationContext extends object = SubmissionInvocationContext<Data>> {
+  (payload: unknown, context?: InvocationContext): Promise<SubmissionState<Data>>;
+}
+interface ContextualCreatedSubmissionHandler<Data, InvocationContext extends object> {
+  (payload: unknown, context: InvocationContext): Promise<SubmissionState<Data>>;
+}
+type DataFromResolvedHandlerResult<Result> = Result extends SubmissionState<infer Data> ? Data : Result extends void ? unknown : Result;
+type SubmissionDataFromHandlerResult<Result> = DataFromResolvedHandlerResult<Awaited<Result>>;
+interface CreateSubmissionHandler<InvocationContext extends object> {
+  <Schema extends FormSchema, Result>(schema: Schema, handler: (value: InferOutput<Schema>, context: SubmissionHandlerContext<unknown, InvocationContext>) => MaybePromise<Result>, options?: SubmissionOptions<Schema>): ContextualCreatedSubmissionHandler<SubmissionDataFromHandlerResult<Result>, InvocationContext>;
+}
+type ServerAction<Data = unknown> = SubmissionAction<FormData, Data>;
+type RequestHandler = (request: Request) => Promise<Response>;
+//#endregion
+//#region src/form-data.d.ts
+declare const FORMADAPTER_ARRAY_MARKER = "__formadapter_array";
+declare const FORMADAPTER_BOOLEAN_MARKER = "__formadapter_boolean";
+declare const FORMADAPTER_VALUE_MARKER = "__formadapter_value";
+/** Decodes and validates FormData using the schema's input-side form model. */
+declare function parseFormData<Schema extends FormSchema>(schema: Schema, formData: FormData, options?: SubmissionOptions<Schema>): Promise<ParseFormDataResult<InferOutput<Schema>>>;
+//#endregion
+//#region src/error.d.ts
+type ErrorMessages = readonly string[] | string;
+interface FormAdapterServerErrorOptions {
+  readonly cause?: unknown;
+  readonly fieldErrors?: Readonly<Record<string, ErrorMessages>>;
+  readonly formErrors?: ErrorMessages;
+  readonly message?: string;
+}
+interface ErrorHelperOptions {
+  readonly cause?: unknown;
+  readonly message?: string;
+}
+/** A deliberate, user-safe business failure raised by a submission handler. */
+declare class FormAdapterServerError extends Error {
+  override readonly name = "FormAdapterServerError";
+  readonly fieldErrors: Readonly<Record<string, readonly string[]>>;
+  readonly formErrors: readonly string[];
+  constructor(options?: FormAdapterServerErrorOptions);
+}
+/** Creates a business error intended to be thrown from a submission handler. */
+declare function formError(errorMessages: ErrorMessages, options?: ErrorHelperOptions): FormAdapterServerError;
+/** Creates a field-scoped business error intended to be thrown from a handler. */
+declare function fieldError(path: string, errorMessages: ErrorMessages, options?: ErrorHelperOptions): FormAdapterServerError;
+//#endregion
+//#region src/submission.d.ts
+/** Compiles a schema once and returns a transport-neutral submission function. */
+declare function createSubmissionHandler<Schema extends FormSchema, Data = unknown>(schema: Schema, handler: SubmissionValueHandler<Schema, Data>, options?: SubmissionOptions<Schema>): CreatedSubmissionHandler<Data>;
+declare function createSubmissionHandler<Schema extends FormSchema, Data, InvocationContext extends object>(schema: Schema, handler: SubmissionValueHandler<Schema, Data, InvocationContext>, options?: SubmissionOptions<Schema>): ContextualCreatedSubmissionHandler<Data, InvocationContext>;
+/** Binds a transport invocation-context type while preserving schema/data inference. */
+declare function createSubmissionHandlerFactory<InvocationContext extends object>(): CreateSubmissionHandler<InvocationContext>;
+//#endregion
+//#region src/transports.d.ts
+/** Adapts a reusable submission to React/Next-style `(state, FormData)` actions. */
+declare function toServerAction<Data>(submission: CreatedSubmissionHandler<Data>): ServerAction<Data>;
+/** Creates a React/Next-style server action directly from a schema and handler. */
+declare function createServerAction<Schema extends FormSchema, Data = unknown>(schema: Schema, handler: SubmissionValueHandler<Schema, Data>, options?: SubmissionOptions<Schema>): ServerAction<Data>;
+/** Adapts a reusable submission to a POST JSON/FormData HTTP request handler. */
+declare function toRequestHandler<Data>(submission: CreatedSubmissionHandler<Data>): RequestHandler;
+/** Creates a JSON/FormData HTTP handler directly from a schema and handler. */
+declare function createRequestHandler<Schema extends FormSchema, Data = unknown>(schema: Schema, handler: SubmissionValueHandler<Schema, Data>, options?: SubmissionOptions<Schema>): RequestHandler;
+//#endregion
+export { type ContextualCreatedSubmissionHandler, type CreateSubmissionHandler, type CreatedSubmissionHandler, type ErrorHelperOptions, type ErrorMessages, FORMADAPTER_ARRAY_MARKER, FORMADAPTER_BOOLEAN_MARKER, FORMADAPTER_VALUE_MARKER, FormAdapterServerError, type FormAdapterServerErrorOptions, type ParseFormDataFailure, type ParseFormDataResult, type ParseFormDataSuccess, type RequestHandler, type ServerAction, type SubmissionDataFromHandlerResult, type SubmissionHandlerContext, type SubmissionHandlerResult, type SubmissionInvocationContext, type SubmissionOptions, type SubmissionValueHandler, createRequestHandler, createServerAction, createSubmissionHandler, createSubmissionHandlerFactory, fieldError, formError, parseFormData, toRequestHandler, toServerAction };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,350 @@
+import { compileForm, isReservedFormPathSegment, isSubmissionState, issuePath, optionForSerializedValue, pathToConfigPath, pathToName, prepareFormValues, submissionFailure, submissionSuccess, validatePresentationRules } from "@formadapter/core";
+//#region src/form-data.ts
+const FORMADAPTER_ARRAY_MARKER = "__formadapter_array";
+const FORMADAPTER_BOOLEAN_MARKER = "__formadapter_boolean";
+const FORMADAPTER_VALUE_MARKER = "__formadapter_value";
+const OMIT = Symbol("formadapter.omit");
+const MAX_ARRAY_INDEX = 1e4;
+function assertFormDataFieldNames(model) {
+	const reserved = [];
+	const visit = (node, root = false) => {
+		if (!root && isReservedFormPathSegment(node.key)) reserved.push(node.path || node.key);
+		if (node.kind === "object") for (const child of node.children) visit(child);
+		else if (node.kind === "array") visit(node.item);
+	};
+	visit(model.root, true);
+	if (reserved.length === 0) return;
+	const names = reserved.map((name) => JSON.stringify(name)).join(", ");
+	throw new TypeError(`Cannot decode FormData for unrepresentable field path ${names}. Rename the field or use a JSON-only submission.`);
+}
+function own(container, key) {
+	return Object.prototype.hasOwnProperty.call(container, key);
+}
+function concretePath(name) {
+	if (!name || name.startsWith("$ACTION_")) return void 0;
+	const parts = name.split(".");
+	const result = [];
+	for (const part of parts) if (/^(?:0|[1-9]\d*)$/.test(part)) {
+		const index = Number(part);
+		if (!Number.isSafeInteger(index) || index > MAX_ARRAY_INDEX) return;
+		result.push(index);
+	} else {
+		if (isReservedFormPathSegment(part)) return void 0;
+		result.push(part);
+	}
+	return result;
+}
+function nodeAtPath(model, path) {
+	return model.fieldMap[pathToConfigPath(path)];
+}
+function createContainer(next) {
+	return typeof next === "number" ? [] : {};
+}
+function valueAtPath(root, path) {
+	let current = root;
+	for (const segment of path) {
+		if (typeof current !== "object" || current === null || !own(current, segment)) return;
+		current = current[segment];
+	}
+	return current;
+}
+function hasPath(root, path) {
+	let current = root;
+	for (const segment of path) {
+		if (typeof current !== "object" || current === null || !own(current, segment)) return false;
+		current = current[segment];
+	}
+	return true;
+}
+function setPath(root, path, value) {
+	let current = root;
+	for (const [position, segment] of path.entries()) {
+		if (position === path.length - 1) {
+			current[segment] = value;
+			return;
+		}
+		const next = path[position + 1];
+		const existing = current[segment];
+		if (!(typeof existing === "object" && existing !== null && (typeof next === "number" ? Array.isArray(existing) : !Array.isArray(existing)))) current[segment] = createContainer(next);
+		current = current[segment];
+	}
+}
+function appendPath(root, path, value) {
+	const existing = valueAtPath(root, path);
+	if (Array.isArray(existing)) existing.push(value);
+	else setPath(root, path, [value]);
+}
+function isFile(value) {
+	return typeof value !== "string";
+}
+function emptyFile(value) {
+	return value.name === "" && value.size === 0;
+}
+function serializedOption(value) {
+	const separator = value.indexOf(":");
+	if (separator === -1) return OMIT;
+	const type = value.slice(0, separator);
+	const serialized = value.slice(separator + 1);
+	switch (type) {
+		case "boolean":
+			if (serialized === "true") return true;
+			if (serialized === "false") return false;
+			return OMIT;
+		case "null": return serialized === "" ? null : OMIT;
+		case "number": {
+			const number = Number(serialized);
+			return serialized.trim() && Number.isFinite(number) ? number : OMIT;
+		}
+		case "string": return serialized;
+		default: return OMIT;
+	}
+}
+function hasOptions(node) {
+	return Boolean(node.options || node.config.options || node.control === "radio" || node.control === "select");
+}
+function decodeOption(node, value) {
+	const staticOption = node.options ? optionForSerializedValue(node.options, value) : void 0;
+	if (staticOption) return staticOption.value;
+	if (!hasOptions(node)) return OMIT;
+	return serializedOption(value);
+}
+function decodeBoolean(value) {
+	if (value === "on" || value === "1" || value === "true") return true;
+	if (value === "0" || value === "false") return false;
+	return value;
+}
+function decodeScalar(node, entry, typedValue = false) {
+	if (node.dataType === "file") {
+		if (!isFile(entry)) return entry;
+		if (!emptyFile(entry)) return entry;
+		return node.nullable ? null : OMIT;
+	}
+	if (isFile(entry)) return entry;
+	if (typedValue) {
+		const typed = serializedOption(entry);
+		if (typed !== OMIT) return typed;
+	}
+	const option = decodeOption(node, entry);
+	if (option !== OMIT) return option;
+	if (entry === "" && node.nullable) return null;
+	if (node.dataType === "number" || node.dataType === "integer") {
+		if (!entry.trim()) return OMIT;
+		const number = Number(entry);
+		return Number.isFinite(number) ? number : entry;
+	}
+	if (node.dataType === "boolean") return decodeBoolean(entry);
+	return entry;
+}
+function markerPaths(formData, marker) {
+	return formData.getAll(marker).filter((value) => typeof value === "string").map(concretePath).filter((path) => path !== void 0);
+}
+/** Model-driven decoding. This is intentionally not exported from the package. */
+function decodeFormData(model, formData) {
+	const raw = {};
+	const typedPaths = new Set(markerPaths(formData, FORMADAPTER_VALUE_MARKER).map(pathToName));
+	for (const path of markerPaths(formData, FORMADAPTER_ARRAY_MARKER)) if (nodeAtPath(model, path)?.kind === "array" && !hasPath(raw, path)) setPath(raw, path, []);
+	for (const path of markerPaths(formData, FORMADAPTER_BOOLEAN_MARKER)) {
+		const node = nodeAtPath(model, path);
+		if (node?.kind === "scalar" && node.dataType === "boolean" && !hasPath(raw, path)) setPath(raw, path, false);
+	}
+	for (const [name, entry] of formData.entries()) {
+		if (name === "__formadapter_array" || name === "__formadapter_boolean" || name === "__formadapter_value" || name.startsWith("$ACTION_")) continue;
+		const path = concretePath(name);
+		if (!path) continue;
+		const node = nodeAtPath(model, path);
+		if (!node) continue;
+		if (node.kind === "scalar") {
+			const decoded = decodeScalar(node, entry, typedPaths.has(name));
+			if (decoded !== OMIT) setPath(raw, path, decoded);
+			continue;
+		}
+		if (node.kind === "array" && node.item.kind === "scalar") {
+			const decoded = decodeScalar(node.item, entry, typedPaths.has(name));
+			if (decoded !== OMIT) appendPath(raw, path, decoded);
+		}
+	}
+	return raw;
+}
+function issuesFailure(issues) {
+	const fieldErrors = Object.create(null);
+	const formErrors = [];
+	for (const issue of issues) {
+		const path = pathToName(issuePath(issue).map((segment) => typeof segment === "number" || typeof segment === "string" ? segment : String(segment)));
+		if (!path) formErrors.push(issue.message);
+		else (fieldErrors[path] ??= []).push(issue.message);
+	}
+	return {
+		success: false,
+		fieldErrors,
+		formErrors
+	};
+}
+async function validateSubmissionValue(schema, model, value) {
+	const presentationIssues = validatePresentationRules(model, value);
+	const result = await schema["~standard"].validate(value);
+	if (result.issues !== void 0) return issuesFailure([...result.issues.length > 0 ? result.issues : [{ message: "Schema validation failed" }], ...presentationIssues]);
+	return presentationIssues.length > 0 ? issuesFailure(presentationIssues) : {
+		success: true,
+		data: result.value
+	};
+}
+async function parseFormDataWithModel(schema, model, formData) {
+	assertFormDataFieldNames(model);
+	return validateSubmissionValue(schema, model, prepareFormValues(model, decodeFormData(model, formData)));
+}
+/** Decodes and validates FormData using the schema's input-side form model. */
+async function parseFormData(schema, formData, options = {}) {
+	return parseFormDataWithModel(schema, compileForm(schema, options.config ?? {}), formData);
+}
+//#endregion
+//#region src/error.ts
+function messages(value) {
+	if (value === void 0) return [];
+	return typeof value === "string" ? [value] : [...value];
+}
+function normalizedFieldErrors(errors) {
+	if (!errors) return {};
+	return Object.fromEntries(Object.entries(errors).map(([path, value]) => [path, messages(value)]));
+}
+/** A deliberate, user-safe business failure raised by a submission handler. */
+var FormAdapterServerError = class extends Error {
+	name = "FormAdapterServerError";
+	fieldErrors;
+	formErrors;
+	constructor(options = {}) {
+		const fieldErrors = normalizedFieldErrors(options.fieldErrors);
+		const formErrors = messages(options.formErrors);
+		const firstFieldMessage = Object.values(fieldErrors)[0]?.[0];
+		const message = options.message ?? formErrors[0] ?? firstFieldMessage ?? "Submission failed";
+		super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+		this.fieldErrors = fieldErrors;
+		this.formErrors = formErrors;
+	}
+};
+/** Creates a business error intended to be thrown from a submission handler. */
+function formError(errorMessages, options = {}) {
+	return new FormAdapterServerError({
+		...options,
+		formErrors: errorMessages
+	});
+}
+/** Creates a field-scoped business error intended to be thrown from a handler. */
+function fieldError(path, errorMessages, options = {}) {
+	if (!path) throw new TypeError("A field error requires a non-empty path");
+	return new FormAdapterServerError({
+		...options,
+		fieldErrors: { [path]: errorMessages }
+	});
+}
+//#endregion
+//#region src/submission.ts
+function isFormData(value) {
+	return typeof FormData !== "undefined" && value instanceof FormData;
+}
+function handlerContext(payload, context) {
+	const formData = isFormData(payload) ? payload : void 0;
+	const forwarded = { ...context };
+	delete forwarded.formData;
+	delete forwarded.payloadKind;
+	return {
+		...forwarded,
+		...formData ? { formData } : {},
+		payloadKind: formData ? "form-data" : "json"
+	};
+}
+function createSubmissionHandler(schema, handler, options = {}) {
+	const model = compileForm(schema, options.config ?? {});
+	return async (payload, context) => {
+		const parsed = isFormData(payload) ? await parseFormDataWithModel(schema, model, payload) : await validateSubmissionValue(schema, model, payload);
+		if (!parsed.success) return submissionFailure({
+			errorKind: "validation",
+			fieldErrors: parsed.fieldErrors,
+			formErrors: parsed.formErrors
+		});
+		try {
+			const result = await handler(parsed.data, handlerContext(payload, context));
+			if (isSubmissionState(result)) return result;
+			return submissionSuccess(result);
+		} catch (error) {
+			if (error instanceof FormAdapterServerError) return submissionFailure({
+				errorKind: "business",
+				fieldErrors: error.fieldErrors,
+				formErrors: error.formErrors
+			});
+			throw error;
+		}
+	};
+}
+/** Binds a transport invocation-context type while preserving schema/data inference. */
+function createSubmissionHandlerFactory() {
+	return createSubmissionHandler;
+}
+//#endregion
+//#region src/transports.ts
+function jsonResponse(state, status, headers) {
+	const responseHeaders = new Headers(headers);
+	responseHeaders.set("content-type", "application/json; charset=utf-8");
+	return new Response(JSON.stringify(state), {
+		headers: responseHeaders,
+		status
+	});
+}
+function transportFailure(message) {
+	return submissionFailure({
+		errorKind: "transport",
+		formErrors: [message]
+	});
+}
+function responseStatus(state) {
+	if (state.status !== "error") return 200;
+	return state.errorKind === "transport" ? 400 : 422;
+}
+function serverActionState(state) {
+	if (state.status !== "error") return state;
+	return {
+		...state,
+		fieldErrors: Object.fromEntries(Object.entries(state.fieldErrors).map(([path, messages]) => [path, [...messages]])),
+		formErrors: [...state.formErrors]
+	};
+}
+function mediaType(request) {
+	return request.headers.get("content-type")?.split(";", 1)[0]?.trim().toLowerCase() ?? "";
+}
+function isJsonMediaType(type) {
+	return type === "application/json" || type.endsWith("+json");
+}
+function isFormMediaType(type) {
+	return type === "multipart/form-data" || type === "application/x-www-form-urlencoded";
+}
+/** Adapts a reusable submission to React/Next-style `(state, FormData)` actions. */
+function toServerAction(submission) {
+	return async (previousState, formData) => serverActionState(await submission(formData, { previousState }));
+}
+/** Creates a React/Next-style server action directly from a schema and handler. */
+function createServerAction(schema, handler, options = {}) {
+	return toServerAction(createSubmissionHandler(schema, handler, options));
+}
+/** Adapts a reusable submission to a POST JSON/FormData HTTP request handler. */
+function toRequestHandler(submission) {
+	return async (request) => {
+		if (request.method.toUpperCase() !== "POST") return jsonResponse(transportFailure("Only POST requests are supported."), 405, { allow: "POST" });
+		const type = mediaType(request);
+		if (!isJsonMediaType(type) && !isFormMediaType(type)) return jsonResponse(transportFailure("Expected a JSON or form request body."), 415);
+		let payload;
+		try {
+			payload = isJsonMediaType(type) ? await request.json() : await request.formData();
+		} catch {
+			return jsonResponse(transportFailure("Unable to read the request body."), 400);
+		}
+		const state = await submission(payload, { request });
+		return jsonResponse(state, responseStatus(state));
+	};
+}
+/** Creates a JSON/FormData HTTP handler directly from a schema and handler. */
+function createRequestHandler(schema, handler, options = {}) {
+	return toRequestHandler(createSubmissionHandler(schema, handler, options));
+}
+//#endregion
+export { FORMADAPTER_ARRAY_MARKER, FORMADAPTER_BOOLEAN_MARKER, FORMADAPTER_VALUE_MARKER, FormAdapterServerError, createRequestHandler, createServerAction, createSubmissionHandler, createSubmissionHandlerFactory, fieldError, formError, parseFormData, toRequestHandler, toServerAction };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/form-data.ts","../src/error.ts","../src/submission.ts","../src/transports.ts"],"sourcesContent":["import {\n  compileForm,\n  issuePath,\n  isReservedFormPathSegment,\n  optionForSerializedValue,\n  pathToConfigPath,\n  pathToName,\n  prepareFormValues,\n  validatePresentationRules,\n} from \"@formadapter/core\";\nimport type {\n  DeepPartial,\n  FormModel,\n  FormNode,\n  FormSchema,\n  InferInput,\n  InferOutput,\n  ScalarField,\n  StandardIssue,\n} from \"@formadapter/core\";\n\nimport type {\n  ParseFormDataFailure,\n  ParseFormDataResult,\n  SubmissionOptions,\n} from \"./types\";\n\nexport const FORMADAPTER_ARRAY_MARKER = \"__formadapter_array\";\nexport const FORMADAPTER_BOOLEAN_MARKER = \"__formadapter_boolean\";\nexport const FORMADAPTER_VALUE_MARKER = \"__formadapter_value\";\n\nconst OMIT = Symbol(\"formadapter.omit\");\nconst MAX_ARRAY_INDEX = 10_000;\n\ntype ConcretePath = readonly (number | string)[];\ntype MutableRecord = Record<string, unknown>;\n\nfunction assertFormDataFieldNames<Input, Control extends string>(\n  model: FormModel<Input, Control>,\n): void {\n  const reserved: string[] = [];\n  const visit = (node: FormNode<Control, Input>, root = false): void => {\n    if (!root && isReservedFormPathSegment(node.key)) {\n      reserved.push(node.path || node.key);\n    }\n    if (node.kind === \"object\") {\n      for (const child of node.children) visit(child);\n    } else if (node.kind === \"array\") {\n      visit(node.item);\n    }\n  };\n  visit(model.root, true);\n  if (reserved.length === 0) return;\n  const names = reserved.map((name) => JSON.stringify(name)).join(\", \");\n  throw new TypeError(\n    `Cannot decode FormData for unrepresentable field path ${names}. ` +\n      \"Rename the field or use a JSON-only submission.\",\n  );\n}\n\nfunction own(container: object, key: number | string): boolean {\n  return Object.prototype.hasOwnProperty.call(container, key);\n}\n\nfunction concretePath(name: string): ConcretePath | undefined {\n  if (!name || name.startsWith(\"$ACTION_\")) return undefined;\n  const parts = name.split(\".\");\n  const result: Array<number | string> = [];\n  for (const part of parts) {\n    if (/^(?:0|[1-9]\\d*)$/.test(part)) {\n      const index = Number(part);\n      if (!Number.isSafeInteger(index) || index > MAX_ARRAY_INDEX) {\n        return undefined;\n      }\n      result.push(index);\n    } else {\n      if (isReservedFormPathSegment(part)) return undefined;\n      result.push(part);\n    }\n  }\n  return result;\n}\n\nfunction nodeAtPath<Input, Control extends string>(\n  model: FormModel<Input, Control>,\n  path: ConcretePath,\n): FormNode<Control, Input> | undefined {\n  return model.fieldMap[pathToConfigPath(path)];\n}\n\nfunction createContainer(next: number | string): MutableRecord | unknown[] {\n  return typeof next === \"number\" ? [] : {};\n}\n\nfunction valueAtPath(root: MutableRecord, path: ConcretePath): unknown {\n  let current: unknown = root;\n  for (const segment of path) {\n    if (\n      (typeof current !== \"object\" || current === null) ||\n      !own(current, segment)\n    ) {\n      return undefined;\n    }\n    current = (current as MutableRecord)[segment];\n  }\n  return current;\n}\n\nfunction hasPath(root: MutableRecord, path: ConcretePath): boolean {\n  let current: unknown = root;\n  for (const segment of path) {\n    if (\n      (typeof current !== \"object\" || current === null) ||\n      !own(current, segment)\n    ) {\n      return false;\n    }\n    current = (current as MutableRecord)[segment];\n  }\n  return true;\n}\n\nfunction setPath(\n  root: MutableRecord,\n  path: ConcretePath,\n  value: unknown,\n): void {\n  let current: MutableRecord | unknown[] = root;\n  for (const [position, segment] of path.entries()) {\n    const last = position === path.length - 1;\n    if (last) {\n      (current as MutableRecord)[segment] = value;\n      return;\n    }\n\n    const next = path[position + 1]!;\n    const existing = (current as MutableRecord)[segment];\n    const needsArray = typeof next === \"number\";\n    const usable =\n      typeof existing === \"object\" &&\n      existing !== null &&\n      (needsArray ? Array.isArray(existing) : !Array.isArray(existing));\n    if (!usable) {\n      (current as MutableRecord)[segment] = createContainer(next);\n    }\n    current = (current as MutableRecord)[segment] as MutableRecord | unknown[];\n  }\n}\n\nfunction appendPath(\n  root: MutableRecord,\n  path: ConcretePath,\n  value: unknown,\n): void {\n  const existing = valueAtPath(root, path);\n  if (Array.isArray(existing)) {\n    existing.push(value);\n  } else {\n    setPath(root, path, [value]);\n  }\n}\n\nfunction isFile(value: FormDataEntryValue): value is File {\n  return typeof value !== \"string\";\n}\n\nfunction emptyFile(value: File): boolean {\n  return value.name === \"\" && value.size === 0;\n}\n\nfunction serializedOption(value: string): unknown | typeof OMIT {\n  const separator = value.indexOf(\":\");\n  if (separator === -1) return OMIT;\n  const type = value.slice(0, separator);\n  const serialized = value.slice(separator + 1);\n  switch (type) {\n    case \"boolean\":\n      if (serialized === \"true\") return true;\n      if (serialized === \"false\") return false;\n      return OMIT;\n    case \"null\":\n      return serialized === \"\" ? null : OMIT;\n    case \"number\": {\n      const number = Number(serialized);\n      return serialized.trim() && Number.isFinite(number) ? number : OMIT;\n    }\n    case \"string\":\n      return serialized;\n    default:\n      return OMIT;\n  }\n}\n\nfunction hasOptions<Input, Control extends string>(\n  node: ScalarField<Control, Input>,\n): boolean {\n  return Boolean(\n    node.options ||\n      node.config.options ||\n      node.control === \"radio\" ||\n      node.control === \"select\",\n  );\n}\n\nfunction decodeOption<Input, Control extends string>(\n  node: ScalarField<Control, Input>,\n  value: string,\n): unknown | typeof OMIT {\n  const staticOption = node.options\n    ? optionForSerializedValue(node.options, value)\n    : undefined;\n  if (staticOption) return staticOption.value;\n  if (!hasOptions(node)) return OMIT;\n  return serializedOption(value);\n}\n\nfunction decodeBoolean(value: string): boolean | string {\n  if (value === \"on\" || value === \"1\" || value === \"true\") return true;\n  if (value === \"0\" || value === \"false\") return false;\n  return value;\n}\n\nfunction decodeScalar<Input, Control extends string>(\n  node: ScalarField<Control, Input>,\n  entry: FormDataEntryValue,\n  typedValue = false,\n): unknown | typeof OMIT {\n  if (node.dataType === \"file\") {\n    if (!isFile(entry)) return entry;\n    if (!emptyFile(entry)) return entry;\n    return node.nullable ? null : OMIT;\n  }\n  if (isFile(entry)) return entry;\n\n  if (typedValue) {\n    const typed = serializedOption(entry);\n    if (typed !== OMIT) return typed;\n  }\n\n  const option = decodeOption(node, entry);\n  if (option !== OMIT) return option;\n  if (entry === \"\" && node.nullable) return null;\n\n  if (node.dataType === \"number\" || node.dataType === \"integer\") {\n    if (!entry.trim()) return OMIT;\n    const number = Number(entry);\n    return Number.isFinite(number) ? number : entry;\n  }\n  if (node.dataType === \"boolean\") return decodeBoolean(entry);\n  return entry;\n}\n\nfunction markerPaths(formData: FormData, marker: string): ConcretePath[] {\n  return formData\n    .getAll(marker)\n    .filter((value): value is string => typeof value === \"string\")\n    .map(concretePath)\n    .filter((path): path is ConcretePath => path !== undefined);\n}\n\n/** Model-driven decoding. This is intentionally not exported from the package. */\nexport function decodeFormData<Input, Control extends string>(\n  model: FormModel<Input, Control>,\n  formData: FormData,\n): DeepPartial<Input> {\n  const raw: MutableRecord = {};\n  const typedPaths = new Set(\n    markerPaths(formData, FORMADAPTER_VALUE_MARKER).map(pathToName),\n  );\n\n  for (const path of markerPaths(formData, FORMADAPTER_ARRAY_MARKER)) {\n    if (nodeAtPath(model, path)?.kind === \"array\" && !hasPath(raw, path)) {\n      setPath(raw, path, []);\n    }\n  }\n  for (const path of markerPaths(formData, FORMADAPTER_BOOLEAN_MARKER)) {\n    const node = nodeAtPath(model, path);\n    if (\n      node?.kind === \"scalar\" &&\n      node.dataType === \"boolean\" &&\n      !hasPath(raw, path)\n    ) {\n      setPath(raw, path, false);\n    }\n  }\n\n  for (const [name, entry] of formData.entries()) {\n    if (\n      name === FORMADAPTER_ARRAY_MARKER ||\n      name === FORMADAPTER_BOOLEAN_MARKER ||\n      name === FORMADAPTER_VALUE_MARKER ||\n      name.startsWith(\"$ACTION_\")\n    ) {\n      continue;\n    }\n    const path = concretePath(name);\n    if (!path) continue;\n    const node = nodeAtPath(model, path);\n    if (!node) continue;\n\n    if (node.kind === \"scalar\") {\n      const decoded = decodeScalar(node, entry, typedPaths.has(name));\n      if (decoded !== OMIT) setPath(raw, path, decoded);\n      continue;\n    }\n\n    if (node.kind === \"array\" && node.item.kind === \"scalar\") {\n      const decoded = decodeScalar(node.item, entry, typedPaths.has(name));\n      if (decoded !== OMIT) appendPath(raw, path, decoded);\n    }\n  }\n\n  return raw as DeepPartial<Input>;\n}\n\nfunction issuesFailure(\n  issues: readonly StandardIssue[],\n): ParseFormDataFailure {\n  const fieldErrors: Record<string, string[]> = Object.create(null);\n  const formErrors: string[] = [];\n  for (const issue of issues) {\n    const path = pathToName(\n      issuePath(issue).map((segment) =>\n        typeof segment === \"number\" || typeof segment === \"string\"\n          ? segment\n          : String(segment),\n      ),\n    );\n    if (!path) {\n      formErrors.push(issue.message);\n    } else {\n      (fieldErrors[path] ??= []).push(issue.message);\n    }\n  }\n  return { success: false, fieldErrors, formErrors };\n}\n\nexport async function validateSubmissionValue<\n  Schema extends FormSchema,\n  Control extends string,\n>(\n  schema: Schema,\n  model: FormModel<InferInput<Schema>, Control>,\n  value: unknown,\n): Promise<ParseFormDataResult<InferOutput<Schema>>> {\n  const presentationIssues = validatePresentationRules(\n    model,\n    value as DeepPartial<InferInput<Schema>>,\n  );\n  const result = await schema[\"~standard\"].validate(value);\n  if (result.issues !== undefined) {\n    const schemaIssues = result.issues.length > 0\n      ? result.issues\n      : [{ message: \"Schema validation failed\" }];\n    return issuesFailure([...schemaIssues, ...presentationIssues]);\n  }\n  return presentationIssues.length > 0\n    ? issuesFailure(presentationIssues)\n    : { success: true, data: result.value };\n}\n\nexport async function parseFormDataWithModel<\n  Schema extends FormSchema,\n  Control extends string,\n>(\n  schema: Schema,\n  model: FormModel<InferInput<Schema>, Control>,\n  formData: FormData,\n): Promise<ParseFormDataResult<InferOutput<Schema>>> {\n  assertFormDataFieldNames(model);\n  const decoded = decodeFormData(model, formData);\n  const prepared = prepareFormValues(model, decoded);\n  return validateSubmissionValue(schema, model, prepared);\n}\n\n/** Decodes and validates FormData using the schema's input-side form model. */\nexport async function parseFormData<\n  Schema extends FormSchema,\n>(\n  schema: Schema,\n  formData: FormData,\n  options: SubmissionOptions<Schema> = {},\n): Promise<ParseFormDataResult<InferOutput<Schema>>> {\n  const model = compileForm(schema, options.config ?? {});\n  return parseFormDataWithModel(schema, model, formData);\n}\n","export type ErrorMessages = readonly string[] | string;\n\nexport interface FormAdapterServerErrorOptions {\n  readonly cause?: unknown;\n  readonly fieldErrors?: Readonly<Record<string, ErrorMessages>>;\n  readonly formErrors?: ErrorMessages;\n  readonly message?: string;\n}\n\nexport interface ErrorHelperOptions {\n  readonly cause?: unknown;\n  readonly message?: string;\n}\n\nfunction messages(value: ErrorMessages | undefined): readonly string[] {\n  if (value === undefined) return [];\n  return typeof value === \"string\" ? [value] : [...value];\n}\n\nfunction normalizedFieldErrors(\n  errors: Readonly<Record<string, ErrorMessages>> | undefined,\n): Readonly<Record<string, readonly string[]>> {\n  if (!errors) return {};\n  return Object.fromEntries(\n    Object.entries(errors).map(([path, value]) => [path, messages(value)]),\n  );\n}\n\n/** A deliberate, user-safe business failure raised by a submission handler. */\nexport class FormAdapterServerError extends Error {\n  public override readonly name = \"FormAdapterServerError\";\n  public readonly fieldErrors: Readonly<Record<string, readonly string[]>>;\n  public readonly formErrors: readonly string[];\n\n  public constructor(options: FormAdapterServerErrorOptions = {}) {\n    const fieldErrors = normalizedFieldErrors(options.fieldErrors);\n    const formErrors = messages(options.formErrors);\n    const firstFieldMessage = Object.values(fieldErrors)[0]?.[0];\n    const message =\n      options.message ??\n      formErrors[0] ??\n      firstFieldMessage ??\n      \"Submission failed\";\n    super(\n      message,\n      options.cause === undefined ? undefined : { cause: options.cause },\n    );\n    this.fieldErrors = fieldErrors;\n    this.formErrors = formErrors;\n  }\n}\n\n/** Creates a business error intended to be thrown from a submission handler. */\nexport function formError(\n  errorMessages: ErrorMessages,\n  options: ErrorHelperOptions = {},\n): FormAdapterServerError {\n  return new FormAdapterServerError({\n    ...options,\n    formErrors: errorMessages,\n  });\n}\n\n/** Creates a field-scoped business error intended to be thrown from a handler. */\nexport function fieldError(\n  path: string,\n  errorMessages: ErrorMessages,\n  options: ErrorHelperOptions = {},\n): FormAdapterServerError {\n  if (!path) throw new TypeError(\"A field error requires a non-empty path\");\n  return new FormAdapterServerError({\n    ...options,\n    fieldErrors: { [path]: errorMessages },\n  });\n}\n","import {\n  compileForm,\n  isSubmissionState,\n  submissionFailure,\n  submissionSuccess,\n} from \"@formadapter/core\";\nimport type {\n  FormSchema,\n  SubmissionState,\n} from \"@formadapter/core\";\n\nimport { FormAdapterServerError } from \"./error\";\nimport {\n  parseFormDataWithModel,\n  validateSubmissionValue,\n} from \"./form-data\";\nimport type {\n  CreatedSubmissionHandler,\n  ContextualCreatedSubmissionHandler,\n  CreateSubmissionHandler,\n  SubmissionHandlerContext,\n  SubmissionInvocationContext,\n  SubmissionOptions,\n  SubmissionValueHandler,\n} from \"./types\";\n\nfunction isFormData(value: unknown): value is FormData {\n  return typeof FormData !== \"undefined\" && value instanceof FormData;\n}\n\nfunction handlerContext<Data, InvocationContext extends object>(\n  payload: unknown,\n  context: InvocationContext | undefined,\n): SubmissionHandlerContext<Data, InvocationContext> {\n  const formData = isFormData(payload) ? payload : undefined;\n  const forwarded = { ...context } as Record<string, unknown>;\n  delete forwarded.formData;\n  delete forwarded.payloadKind;\n  return {\n    ...forwarded,\n    ...(formData ? { formData } : {}),\n    payloadKind: formData ? \"form-data\" : \"json\",\n  } as SubmissionHandlerContext<Data, InvocationContext>;\n}\n\n/** Compiles a schema once and returns a transport-neutral submission function. */\nexport function createSubmissionHandler<\n  Schema extends FormSchema,\n  Data = unknown,\n>(\n  schema: Schema,\n  handler: SubmissionValueHandler<Schema, Data>,\n  options?: SubmissionOptions<Schema>,\n): CreatedSubmissionHandler<Data>;\nexport function createSubmissionHandler<\n  Schema extends FormSchema,\n  Data,\n  InvocationContext extends object,\n>(\n  schema: Schema,\n  handler: SubmissionValueHandler<Schema, Data, InvocationContext>,\n  options?: SubmissionOptions<Schema>,\n): ContextualCreatedSubmissionHandler<Data, InvocationContext>;\nexport function createSubmissionHandler<\n  Schema extends FormSchema,\n  Data = unknown,\n  InvocationContext extends object = SubmissionInvocationContext<Data>,\n>(\n  schema: Schema,\n  handler: SubmissionValueHandler<Schema, Data, InvocationContext>,\n  options: SubmissionOptions<Schema> = {},\n): CreatedSubmissionHandler<Data, InvocationContext> {\n  const model = compileForm(schema, options.config ?? {});\n\n  return async (\n    payload: unknown,\n    context?: InvocationContext,\n  ): Promise<SubmissionState<Data>> => {\n    const parsed = isFormData(payload)\n      ? await parseFormDataWithModel(schema, model, payload)\n      : await validateSubmissionValue(schema, model, payload);\n\n    if (!parsed.success) {\n      return submissionFailure({\n        errorKind: \"validation\",\n        fieldErrors: parsed.fieldErrors,\n        formErrors: parsed.formErrors,\n      });\n    }\n\n    try {\n      const result = await handler(parsed.data, handlerContext(payload, context));\n      if (isSubmissionState(result)) {\n        return result as SubmissionState<Data>;\n      }\n      return submissionSuccess<Data>(result as Data);\n    } catch (error) {\n      if (error instanceof FormAdapterServerError) {\n        return submissionFailure({\n          errorKind: \"business\",\n          fieldErrors: error.fieldErrors,\n          formErrors: error.formErrors,\n        });\n      }\n      throw error;\n    }\n  };\n}\n\n/** Binds a transport invocation-context type while preserving schema/data inference. */\nexport function createSubmissionHandlerFactory<\n  InvocationContext extends object,\n>(): CreateSubmissionHandler<InvocationContext> {\n  return createSubmissionHandler as CreateSubmissionHandler<InvocationContext>;\n}\n","import { submissionFailure } from \"@formadapter/core\";\nimport type { FormSchema, SubmissionState } from \"@formadapter/core\";\n\nimport { createSubmissionHandler } from \"./submission\";\nimport type {\n  CreatedSubmissionHandler,\n  RequestHandler,\n  ServerAction,\n  SubmissionOptions,\n  SubmissionValueHandler,\n} from \"./types\";\n\nfunction jsonResponse(\n  state: SubmissionState,\n  status: number,\n  headers?: HeadersInit,\n): Response {\n  const responseHeaders = new Headers(headers);\n  responseHeaders.set(\"content-type\", \"application/json; charset=utf-8\");\n  return new Response(JSON.stringify(state), {\n    headers: responseHeaders,\n    status,\n  });\n}\n\nfunction transportFailure(message: string): ReturnType<typeof submissionFailure> {\n  return submissionFailure({\n    errorKind: \"transport\",\n    formErrors: [message],\n  });\n}\n\nfunction responseStatus(state: SubmissionState): number {\n  if (state.status !== \"error\") return 200;\n  return state.errorKind === \"transport\" ? 400 : 422;\n}\n\nfunction serverActionState<Data>(\n  state: SubmissionState<Data>,\n): SubmissionState<Data> {\n  if (state.status !== \"error\") return state;\n  return {\n    ...state,\n    fieldErrors: Object.fromEntries(\n      Object.entries(state.fieldErrors).map(([path, messages]) => [\n        path,\n        [...messages],\n      ]),\n    ),\n    formErrors: [...state.formErrors],\n  };\n}\n\nfunction mediaType(request: Request): string {\n  return request.headers.get(\"content-type\")?.split(\";\", 1)[0]?.trim().toLowerCase() ?? \"\";\n}\n\nfunction isJsonMediaType(type: string): boolean {\n  return type === \"application/json\" || type.endsWith(\"+json\");\n}\n\nfunction isFormMediaType(type: string): boolean {\n  return type === \"multipart/form-data\" || type === \"application/x-www-form-urlencoded\";\n}\n\n/** Adapts a reusable submission to React/Next-style `(state, FormData)` actions. */\nexport function toServerAction<Data>(\n  submission: CreatedSubmissionHandler<Data>,\n): ServerAction<Data> {\n  return async (previousState, formData) =>\n    serverActionState(await submission(formData, { previousState }));\n}\n\n/** Creates a React/Next-style server action directly from a schema and handler. */\nexport function createServerAction<\n  Schema extends FormSchema,\n  Data = unknown,\n>(\n  schema: Schema,\n  handler: SubmissionValueHandler<Schema, Data>,\n  options: SubmissionOptions<Schema> = {},\n): ServerAction<Data> {\n  return toServerAction(createSubmissionHandler(schema, handler, options));\n}\n\n/** Adapts a reusable submission to a POST JSON/FormData HTTP request handler. */\nexport function toRequestHandler<Data>(\n  submission: CreatedSubmissionHandler<Data>,\n): RequestHandler {\n  return async (request): Promise<Response> => {\n    if (request.method.toUpperCase() !== \"POST\") {\n      return jsonResponse(\n        transportFailure(\"Only POST requests are supported.\"),\n        405,\n        { allow: \"POST\" },\n      );\n    }\n\n    const type = mediaType(request);\n    if (!isJsonMediaType(type) && !isFormMediaType(type)) {\n      return jsonResponse(\n        transportFailure(\"Expected a JSON or form request body.\"),\n        415,\n      );\n    }\n\n    let payload: unknown;\n    try {\n      payload = isJsonMediaType(type)\n        ? await request.json()\n        : await request.formData();\n    } catch {\n      return jsonResponse(transportFailure(\"Unable to read the request body.\"), 400);\n    }\n\n    const state = await submission(payload, { request });\n    return jsonResponse(state, responseStatus(state));\n  };\n}\n\n/** Creates a JSON/FormData HTTP handler directly from a schema and handler. */\nexport function createRequestHandler<\n  Schema extends FormSchema,\n  Data = unknown,\n>(\n  schema: Schema,\n  handler: SubmissionValueHandler<Schema, Data>,\n  options: SubmissionOptions<Schema> = {},\n): RequestHandler {\n  return toRequestHandler(createSubmissionHandler(schema, handler, options));\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@formadapter/server",
+  "version": "0.0.0",
+  "description": "Framework-neutral parsing, validation, and submission transports for FormAdapter.",
+  "keywords": [
+    "forms",
+    "server-actions",
+    "schema",
+    "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/server"
+  },
+  "license": "MIT",
+  "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"
+  },
+  "dependencies": {
+    "@formadapter/core": "^0.0.0"
+  },
+  "devDependencies": {
+    "arktype": "^2.2.3",
+    "zod": "^4.4.3"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo .turbo",
+    "dev": "tsdown --watch",
+    "test": "vitest run --config vitest.config.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage",
+    "test:typecheck": "tsc --project tsconfig.test.json --noEmit",
+    "typecheck": "tsc --project tsconfig.json --noEmit"
+  }
+}