@fragno-dev/forms 0.0.3 → 0.1.2

package/dist/browser/{src-DbMX_NY6.js → src-BNcd9ogF.js}

@@ -15,6 +15,80 @@ function resolveRouteFactories(context, routesOrFactories) {
 	return routes$1;
 }
 
+//#endregion
+//#region ../fragno/dist/api/internal/path.js
+/**
+* Extract parameter names from a path pattern at runtime.
+* Examples:
+* - "/users/:id" => ["id"]
+* - "/files/**" => ["**"]
+* - "/files/**:rest" => ["rest"]
+*/
+function extractPathParams(pathPattern) {
+	const segments = pathPattern.split("/").filter((s) => s.length > 0);
+	const names = [];
+	for (const segment of segments) {
+		if (segment.startsWith(":")) {
+			names.push(segment.slice(1));
+			continue;
+		}
+		if (segment === "**") {
+			names.push("**");
+			continue;
+		}
+		if (segment.startsWith("**:")) {
+			names.push(segment.slice(3));
+			continue;
+		}
+	}
+	return names;
+}
+/**
+* Build a concrete path by replacing placeholders in a path pattern with values.
+*
+* Supports the same placeholder syntax as the matcher:
+* - Named parameter ":name" is URL-encoded as a single segment
+* - Anonymous wildcard "**" inserts the remainder as-is (slashes preserved)
+* - Named wildcard "**:name" inserts the remainder from the named key
+*
+* Examples:
+* - buildPath("/users/:id", { id: "123" }) => "/users/123"
+* - buildPath("/files/**", { "**": "a/b" }) => "/files/a/b"
+* - buildPath("/files/**:rest", { rest: "a/b" }) => "/files/a/b"
+*/
+function buildPath(pathPattern, params) {
+	const patternSegments = pathPattern.split("/");
+	const builtSegments = [];
+	for (const segment of patternSegments) {
+		if (segment.length === 0) {
+			builtSegments.push("");
+			continue;
+		}
+		if (segment.startsWith(":")) {
+			const name = segment.slice(1);
+			const value = params[name];
+			if (value === void 0) throw new Error(`Missing value for path parameter :${name}`);
+			builtSegments.push(encodeURIComponent(value));
+			continue;
+		}
+		if (segment === "**") {
+			const value = params["**"];
+			if (value === void 0) throw new Error("Missing value for path wildcard **");
+			builtSegments.push(value);
+			continue;
+		}
+		if (segment.startsWith("**:")) {
+			const name = segment.slice(3);
+			const value = params[name];
+			if (value === void 0) throw new Error(`Missing value for path wildcard **:${name}`);
+			builtSegments.push(value);
+			continue;
+		}
+		builtSegments.push(segment);
+	}
+	return builtSegments.join("/");
+}
+
 //#endregion
 //#region ../fragno/dist/api/internal/route.js
 function getMountRoute(opts) {
@@ -161,6 +235,72 @@ var RequestInputContext = class RequestInputContext$1 {
 		return this.#body;
 	}
 	/**
+	* Access the request body as FormData.
+	*
+	* Use this method when handling file uploads or multipart form submissions.
+	* The request must have been sent with Content-Type: multipart/form-data.
+	*
+	* @throws Error if the request body is not FormData
+	*
+	* @example
+	* ```typescript
+	* defineRoute({
+	*   method: "POST",
+	*   path: "/upload",
+	*   async handler(ctx, res) {
+	*     const formData = ctx.formData();
+	*     const file = formData.get("file") as File;
+	*     const description = formData.get("description") as string;
+	*     // ... process file
+	*   }
+	* });
+	* ```
+	*/
+	formData() {
+		if (!(this.#parsedBody instanceof FormData)) throw new Error("Request body is not FormData. Ensure the request was sent with Content-Type: multipart/form-data.");
+		return this.#parsedBody;
+	}
+	/**
+	* Check if the request body is FormData.
+	*
+	* Useful for routes that accept both JSON and FormData payloads.
+	*
+	* @example
+	* ```typescript
+	* defineRoute({
+	*   method: "POST",
+	*   path: "/upload",
+	*   async handler(ctx, res) {
+	*     if (ctx.isFormData()) {
+	*       const formData = ctx.formData();
+	*       // handle file upload
+	*     } else {
+	*       const json = await ctx.input.valid();
+	*       // handle JSON payload
+	*     }
+	*   }
+	* });
+	* ```
+	*/
+	isFormData() {
+		return this.#parsedBody instanceof FormData;
+	}
+	/**
+	* Access the request body as a ReadableStream (application/octet-stream).
+	*
+	* @throws Error if the request body is not a ReadableStream
+	*/
+	bodyStream() {
+		if (!(this.#parsedBody instanceof ReadableStream)) throw new Error("Request body is not a ReadableStream. Ensure the request was sent with Content-Type: application/octet-stream.");
+		return this.#parsedBody;
+	}
+	/**
+	* Check if the request body is a ReadableStream.
+	*/
+	isBodyStream() {
+		return this.#parsedBody instanceof ReadableStream;
+	}
+	/**
 	* Input validation context (only if inputSchema is defined)
 	* @remarks `InputContext`
 	*/
@@ -177,6 +317,7 @@ var RequestInputContext = class RequestInputContext$1 {
 	async #validateInput() {
 		if (!this.#inputSchema) throw new Error("No input schema defined for this route");
 		if (this.#parsedBody instanceof FormData || this.#parsedBody instanceof Blob) throw new Error("Schema validation is only supported for JSON data, not FormData or Blob");
+		if (this.#parsedBody instanceof ReadableStream) throw new Error("Schema validation is only supported for JSON data, not FormData, Blob, or ReadableStream");
 		const result = await this.#inputSchema["~standard"].validate(this.#parsedBody);
 		if (result.issues) throw new FragnoApiValidationError("Validation failed", result.issues);
 		return result.value;
@@ -377,170 +518,6 @@ var RequestOutputContext = class extends OutputContext {
 	}
 };
 
-//#endregion
-//#region ../fragno/dist/api/internal/path.js
-/**
-* Extract parameter names from a path pattern at runtime.
-* Examples:
-* - "/users/:id" => ["id"]
-* - "/files/**" => ["**"]
-* - "/files/**:rest" => ["rest"]
-*/
-function extractPathParams(pathPattern) {
-	const segments = pathPattern.split("/").filter((s) => s.length > 0);
-	const names = [];
-	for (const segment of segments) {
-		if (segment.startsWith(":")) {
-			names.push(segment.slice(1));
-			continue;
-		}
-		if (segment === "**") {
-			names.push("**");
-			continue;
-		}
-		if (segment.startsWith("**:")) {
-			names.push(segment.slice(3));
-			continue;
-		}
-	}
-	return names;
-}
-/**
-* Build a concrete path by replacing placeholders in a path pattern with values.
-*
-* Supports the same placeholder syntax as the matcher:
-* - Named parameter ":name" is URL-encoded as a single segment
-* - Anonymous wildcard "**" inserts the remainder as-is (slashes preserved)
-* - Named wildcard "**:name" inserts the remainder from the named key
-*
-* Examples:
-* - buildPath("/users/:id", { id: "123" }) => "/users/123"
-* - buildPath("/files/**", { "**": "a/b" }) => "/files/a/b"
-* - buildPath("/files/**:rest", { rest: "a/b" }) => "/files/a/b"
-*/
-function buildPath(pathPattern, params) {
-	const patternSegments = pathPattern.split("/");
-	const builtSegments = [];
-	for (const segment of patternSegments) {
-		if (segment.length === 0) {
-			builtSegments.push("");
-			continue;
-		}
-		if (segment.startsWith(":")) {
-			const name = segment.slice(1);
-			const value = params[name];
-			if (value === void 0) throw new Error(`Missing value for path parameter :${name}`);
-			builtSegments.push(encodeURIComponent(value));
-			continue;
-		}
-		if (segment === "**") {
-			const value = params["**"];
-			if (value === void 0) throw new Error("Missing value for path wildcard **");
-			builtSegments.push(value);
-			continue;
-		}
-		if (segment.startsWith("**:")) {
-			const name = segment.slice(3);
-			const value = params[name];
-			if (value === void 0) throw new Error(`Missing value for path wildcard **:${name}`);
-			builtSegments.push(value);
-			continue;
-		}
-		builtSegments.push(segment);
-	}
-	return builtSegments.join("/");
-}
-
-//#endregion
-//#region ../fragno/dist/client/client-error.js
-/**
-* Base error class for all Fragno client errors.
-*/
-var FragnoClientError = class extends Error {
-	#code;
-	constructor(message, code, options = {}) {
-		super(message, { cause: options.cause });
-		this.name = "FragnoClientError";
-		this.#code = code;
-	}
-	get code() {
-		return this.#code;
-	}
-};
-var FragnoClientFetchError = class extends FragnoClientError {
-	constructor(message, code, options = {}) {
-		super(message, code, options);
-		this.name = "FragnoClientFetchError";
-	}
-	static fromUnknownFetchError(error) {
-		if (!(error instanceof Error)) return new FragnoClientFetchNetworkError("Network request failed", { cause: error });
-		if (error.name === "AbortError") return new FragnoClientFetchAbortError("Request was aborted", { cause: error });
-		return new FragnoClientFetchNetworkError("Network request failed", { cause: error });
-	}
-};
-/**
-* Error thrown when a network request fails (e.g., no internet connection, DNS failure).
-*/
-var FragnoClientFetchNetworkError = class extends FragnoClientFetchError {
-	constructor(message = "Network request failed", options = {}) {
-		super(message, "NETWORK_ERROR", options);
-		this.name = "FragnoClientFetchNetworkError";
-	}
-};
-/**
-* Error thrown when a request is aborted (e.g., user cancels request, timeout).
-*/
-var FragnoClientFetchAbortError = class extends FragnoClientFetchError {
-	constructor(message = "Request was aborted", options = {}) {
-		super(message, "ABORT_ERROR", options);
-		this.name = "FragnoClientFetchAbortError";
-	}
-};
-/**
-* Error thrown when the API result is unexpected, e.g. no json is returned.
-*/
-var FragnoClientUnknownApiError = class extends FragnoClientError {
-	#status;
-	constructor(message = "Unknown API error", status, options = {}) {
-		super(message, "UNKNOWN_API_ERROR", options);
-		this.name = "FragnoClientUnknownApiError";
-		this.#status = status;
-	}
-	get status() {
-		return this.#status;
-	}
-};
-var FragnoClientApiError = class FragnoClientApiError$1 extends FragnoClientError {
-	#status;
-	constructor({ message, code }, status, options = {}) {
-		super(message, code, options);
-		this.name = "FragnoClientApiError";
-		this.#status = status;
-	}
-	get status() {
-		return this.#status;
-	}
-	/**
-	* The error code returned by the API.
-	*
-	* The type is `TErrorCode` (the set of known error codes for this route), but may also be a string
-	* for forward compatibility with future error codes.
-	*/
-	get code() {
-		return super.code;
-	}
-	static async fromResponse(response) {
-		const unknown = await response.json();
-		const status = response.status;
-		if (!("message" in unknown || "code" in unknown)) return new FragnoClientUnknownApiError("Unknown API error", status);
-		if (!(typeof unknown.message === "string" && typeof unknown.code === "string")) return new FragnoClientUnknownApiError("Unknown API error", status);
-		return new FragnoClientApiError$1({
-			message: unknown.message,
-			code: unknown.code
-		}, status);
-	}
-};
-
 //#endregion
 //#region ../fragno/dist/util/content-type.js
 /**
@@ -589,142 +566,36 @@ function parseContentType(contentType) {
 }
 
 //#endregion
-//#region ../fragno/dist/client/internal/ndjson-streaming.js
+//#region ../fragno/dist/util/nanostores.js
 /**
-* Creates a promise that rejects when the abort signal is triggered
+* Normalizes a value that could be a plain value, an Atom, or a Vue Ref to a plain value.
 */
-function createAbortPromise(abortSignal) {
-	return new Promise((_, reject) => {
-		const abortHandler = () => {
-			reject(new FragnoClientFetchAbortError("Operation was aborted"));
-		};
-		if (abortSignal.aborted) abortHandler();
-		else abortSignal.addEventListener("abort", abortHandler, { once: true });
-	});
+function unwrapAtom(value) {
+	if (value && typeof value === "object" && "get" in value && typeof value.get === "function") return value.get();
+	return value;
 }
 /**
-* Handles NDJSON streaming responses by returning the first item from the fetcher
-* and then continuing to stream updates via the store's mutate method.
-*
-* This makes it so that we can wait until the first chunk before updating the store, if we did
-* not do this, `loading` would briefly be false before the first item would be populated in the
-* result.
-*
-* @param response - The fetch Response object containing the NDJSON stream
-* @param store - The fetcher store to update with streaming data
-* @param abortSignal - Optional AbortSignal to cancel the streaming operation
-* @returns A promise that resolves to an object containing the first item and a streaming promise
+* Normalizes an object where values can be plain values, Atoms, or Vue Refs.
+* Returns a new object with all values normalized to plain values.
 */
-async function handleNdjsonStreamingFirstItem(response, store, options = {}) {
-	if (!response.body) throw new FragnoClientFetchError("Streaming response has no body", "NO_BODY");
-	const { abortSignal } = options;
-	if (abortSignal?.aborted) throw new FragnoClientFetchAbortError("Operation was aborted");
-	const decoder = new TextDecoder();
-	const reader = response.body.getReader();
-	let buffer = "";
-	let firstItem = null;
-	const items = [];
-	try {
-		while (firstItem === null) {
-			if (abortSignal?.aborted) {
-				reader.releaseLock();
-				throw new FragnoClientFetchAbortError("Operation was aborted");
-			}
-			const { done, value } = await (abortSignal ? Promise.race([reader.read(), createAbortPromise(abortSignal)]) : reader.read());
-			if (done) break;
-			buffer += decoder.decode(value, { stream: true });
-			const lines = buffer.split("\n");
-			buffer = lines.pop() || "";
-			for (const line of lines) {
-				if (!line.trim()) continue;
-				try {
-					const jsonObject = JSON.parse(line);
-					items.push(jsonObject);
-					if (firstItem === null) {
-						firstItem = jsonObject;
-						const streamingPromise = continueStreaming(reader, decoder, buffer, items, store, abortSignal);
-						return {
-							firstItem,
-							streamingPromise
-						};
-					}
-				} catch (parseError) {
-					throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 500, { cause: parseError });
-				}
-			}
-		}
-		if (firstItem === null) {
-			reader.releaseLock();
-			throw new FragnoClientUnknownApiError("NDJSON stream contained no valid items", 500);
-		}
-		reader.releaseLock();
-		throw new FragnoClientFetchError("Unexpected end of stream processing", "NO_BODY");
-	} catch (error) {
-		if (error instanceof FragnoClientError) {
-			store?.setError(error);
-			throw error;
-		} else {
-			const clientError = new FragnoClientUnknownApiError("Unknown streaming error", 500, { cause: error });
-			store?.setError(clientError);
-			throw clientError;
-		}
-	}
+function unwrapObject(params) {
+	if (!params) return;
+	return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, unwrapAtom(value)]));
 }
-/**
-* Continues streaming the remaining items in the background
-*/
-async function continueStreaming(reader, decoder, initialBuffer, items, store, abortSignal) {
-	let buffer = initialBuffer;
-	try {
-		while (true) {
-			if (abortSignal?.aborted) throw new FragnoClientFetchAbortError("Operation was aborted");
-			const { done, value } = await (abortSignal ? Promise.race([reader.read(), createAbortPromise(abortSignal)]) : reader.read());
-			if (done) {
-				if (buffer.trim()) {
-					const lines$1 = buffer.split("\n");
-					for (const line of lines$1) {
-						if (!line.trim()) continue;
-						try {
-							const jsonObject = JSON.parse(line);
-							items.push(jsonObject);
-							store?.setData([...items]);
-						} catch (parseError) {
-							throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 400, { cause: parseError });
-						}
-					}
-				}
-				break;
-			}
-			buffer += decoder.decode(value, { stream: true });
-			const lines = buffer.split("\n");
-			buffer = lines.pop() || "";
-			for (const line of lines) {
-				if (!line.trim()) continue;
-				try {
-					const jsonObject = JSON.parse(line);
-					items.push(jsonObject);
-					store?.setData([...items]);
-				} catch (parseError) {
-					throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 400, { cause: parseError });
-				}
-			}
-		}
-	} catch (error) {
-		if (error instanceof FragnoClientError) store?.setError(error);
-		else {
-			const clientError = new FragnoClientUnknownApiError("Unknown streaming error", 400, { cause: error });
-			store?.setError(clientError);
-			throw clientError;
-		}
-		throw error;
-	} finally {
-		reader.releaseLock();
-	}
-	return items;
+function isReadableAtom(value) {
+	if (!value) return false;
+	if (typeof value !== "object" || value === null) return false;
+	if (!("get" in value) || typeof value.get !== "function") return false;
+	if (!("lc" in value) || typeof value.lc !== "number") return false;
+	if (!("notify" in value) || typeof value.notify !== "function") return false;
+	if (!("off" in value) || typeof value.off !== "function") return false;
+	if (!("subscribe" in value) || typeof value.subscribe !== "function") return false;
+	if (!("value" in value)) return false;
+	return true;
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/task/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/task/index.js
 let tasks = 0;
 let resolves = [];
 function startTask() {
@@ -746,11 +617,11 @@ function task(cb) {
 }
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/clean-stores/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/clean-stores/index.js
 let clean = Symbol("clean");
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/atom/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/atom/index.js
 let listenerQueue = [];
 let lqIndex = 0;
 const QUEUE_ITEMS_PER_LISTENER = 4;
@@ -762,6 +633,7 @@ const atom = /* @__NO_SIDE_EFFECTS__ */ (initialValue) => {
 			if (!$atom.lc) $atom.listen(() => {})();
 			return $atom.value;
 		},
+		init: initialValue,
 		lc: 0,
 		listen(listener) {
 			$atom.lc = listeners.push(listener);
@@ -808,7 +680,7 @@ const atom = /* @__NO_SIDE_EFFECTS__ */ (initialValue) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/lifecycle/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/lifecycle/index.js
 const START = 0;
 const STOP = 1;
 const MOUNT = 5;
@@ -903,7 +775,21 @@ let onMount = ($store, initialize) => {
 };
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/computed/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/warn/index.js
+let warned = {};
+function warn(text) {
+	if (!warned[text]) {
+		warned[text] = true;
+		if (typeof console !== "undefined" && console.warn) {
+			console.groupCollapsed("Nano Stores: " + text);
+			console.trace("Source of deprecated call");
+			console.groupEnd();
+		}
+	}
+}
+
+//#endregion
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/computed/index.js
 let computedStore = (stores$1, cb, batched$1) => {
 	if (!Array.isArray(stores$1)) stores$1 = [stores$1];
 	let previousArgs;
@@ -915,10 +801,12 @@ let computedStore = (stores$1, cb, batched$1) => {
 		if (!previousArgs || args.some((arg, i) => arg !== previousArgs[i])) {
 			previousArgs = args;
 			let value = cb(...args);
-			if (value && value.then && value.t) value.then((asyncValue) => {
-				if (previousArgs === args) $computed.set(asyncValue);
-			});
-			else {
+			if (value && value.then && value.t) {
+				warn("Use @nanostores/async for async computed. We will remove Promise support in computed() in Nano Stores 2.0");
+				value.then((asyncValue) => {
+					if (previousArgs === args) $computed.set(asyncValue);
+				});
+			} else {
 				$computed.set(value);
 				currentEpoch = epoch;
 			}
@@ -948,7 +836,7 @@ const computed = /* @__NO_SIDE_EFFECTS__ */ (stores$1, fn) => computedStore(stor
 const batched = /* @__NO_SIDE_EFFECTS__ */ (stores$1, fn) => computedStore(stores$1, fn, true);
 
 //#endregion
-//#region ../../node_modules/.pnpm/nanostores@1.1.0/node_modules/nanostores/map/index.js
+//#region ../../node_modules/.pnpm/nanostores@1.2.0/node_modules/nanostores/map/index.js
 const map = /* @__NO_SIDE_EFFECTS__ */ (initial = {}) => {
 	let $map = atom(initial);
 	$map.setKey = function(key, value) {
@@ -985,33 +873,94 @@ function getInitialData(key) {
 }
 
 //#endregion
-//#region ../fragno/dist/util/nanostores.js
+//#region ../fragno/dist/client/client-error.js
+/**
+* Base error class for all Fragno client errors.
+*/
+var FragnoClientError = class extends Error {
+	#code;
+	constructor(message, code, options = {}) {
+		super(message, { cause: options.cause });
+		this.name = "FragnoClientError";
+		this.#code = code;
+	}
+	get code() {
+		return this.#code;
+	}
+};
+var FragnoClientFetchError = class extends FragnoClientError {
+	constructor(message, code, options = {}) {
+		super(message, code, options);
+		this.name = "FragnoClientFetchError";
+	}
+	static fromUnknownFetchError(error) {
+		if (!(error instanceof Error)) return new FragnoClientFetchNetworkError("Network request failed", { cause: error });
+		if (error.name === "AbortError") return new FragnoClientFetchAbortError("Request was aborted", { cause: error });
+		return new FragnoClientFetchNetworkError("Network request failed", { cause: error });
+	}
+};
+/**
+* Error thrown when a network request fails (e.g., no internet connection, DNS failure).
+*/
+var FragnoClientFetchNetworkError = class extends FragnoClientFetchError {
+	constructor(message = "Network request failed", options = {}) {
+		super(message, "NETWORK_ERROR", options);
+		this.name = "FragnoClientFetchNetworkError";
+	}
+};
 /**
-* Normalizes a value that could be a plain value, an Atom, or a Vue Ref to a plain value.
+* Error thrown when a request is aborted (e.g., user cancels request, timeout).
 */
-function unwrapAtom(value) {
-	if (value && typeof value === "object" && "get" in value && typeof value.get === "function") return value.get();
-	return value;
-}
+var FragnoClientFetchAbortError = class extends FragnoClientFetchError {
+	constructor(message = "Request was aborted", options = {}) {
+		super(message, "ABORT_ERROR", options);
+		this.name = "FragnoClientFetchAbortError";
+	}
+};
 /**
-* Normalizes an object where values can be plain values, Atoms, or Vue Refs.
-* Returns a new object with all values normalized to plain values.
+* Error thrown when the API result is unexpected, e.g. no json is returned.
 */
-function unwrapObject(params) {
-	if (!params) return;
-	return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, unwrapAtom(value)]));
-}
-function isReadableAtom(value) {
-	if (!value) return false;
-	if (typeof value !== "object" || value === null) return false;
-	if (!("get" in value) || typeof value.get !== "function") return false;
-	if (!("lc" in value) || typeof value.lc !== "number") return false;
-	if (!("notify" in value) || typeof value.notify !== "function") return false;
-	if (!("off" in value) || typeof value.off !== "function") return false;
-	if (!("subscribe" in value) || typeof value.subscribe !== "function") return false;
-	if (!("value" in value)) return false;
-	return true;
-}
+var FragnoClientUnknownApiError = class extends FragnoClientError {
+	#status;
+	constructor(message = "Unknown API error", status, options = {}) {
+		super(message, "UNKNOWN_API_ERROR", options);
+		this.name = "FragnoClientUnknownApiError";
+		this.#status = status;
+	}
+	get status() {
+		return this.#status;
+	}
+};
+var FragnoClientApiError = class FragnoClientApiError$1 extends FragnoClientError {
+	#status;
+	constructor({ message, code }, status, options = {}) {
+		super(message, code, options);
+		this.name = "FragnoClientApiError";
+		this.#status = status;
+	}
+	get status() {
+		return this.#status;
+	}
+	/**
+	* The error code returned by the API.
+	*
+	* The type is `TErrorCode` (the set of known error codes for this route), but may also be a string
+	* for forward compatibility with future error codes.
+	*/
+	get code() {
+		return super.code;
+	}
+	static async fromResponse(response) {
+		const unknown = await response.json();
+		const status = response.status;
+		if (!("message" in unknown || "code" in unknown)) return new FragnoClientUnknownApiError("Unknown API error", status);
+		if (!(typeof unknown.message === "string" && typeof unknown.code === "string")) return new FragnoClientUnknownApiError("Unknown API error", status);
+		return new FragnoClientApiError$1({
+			message: unknown.message,
+			code: unknown.code
+		}, status);
+	}
+};
 
 //#endregion
 //#region ../fragno/dist/client/internal/fetcher-merge.js
@@ -1047,6 +996,141 @@ function mergeHeaders(author, user) {
 	return merged;
 }
 
+//#endregion
+//#region ../fragno/dist/client/internal/ndjson-streaming.js
+/**
+* Creates a promise that rejects when the abort signal is triggered
+*/
+function createAbortPromise(abortSignal) {
+	return new Promise((_, reject) => {
+		const abortHandler = () => {
+			reject(new FragnoClientFetchAbortError("Operation was aborted"));
+		};
+		if (abortSignal.aborted) abortHandler();
+		else abortSignal.addEventListener("abort", abortHandler, { once: true });
+	});
+}
+/**
+* Handles NDJSON streaming responses by returning the first item from the fetcher
+* and then continuing to stream updates via the store's mutate method.
+*
+* This makes it so that we can wait until the first chunk before updating the store, if we did
+* not do this, `loading` would briefly be false before the first item would be populated in the
+* result.
+*
+* @param response - The fetch Response object containing the NDJSON stream
+* @param store - The fetcher store to update with streaming data
+* @param abortSignal - Optional AbortSignal to cancel the streaming operation
+* @returns A promise that resolves to an object containing the first item and a streaming promise
+*/
+async function handleNdjsonStreamingFirstItem(response, store, options = {}) {
+	if (!response.body) throw new FragnoClientFetchError("Streaming response has no body", "NO_BODY");
+	const { abortSignal } = options;
+	if (abortSignal?.aborted) throw new FragnoClientFetchAbortError("Operation was aborted");
+	const decoder = new TextDecoder();
+	const reader = response.body.getReader();
+	let buffer = "";
+	let firstItem = null;
+	const items = [];
+	try {
+		while (firstItem === null) {
+			if (abortSignal?.aborted) {
+				reader.releaseLock();
+				throw new FragnoClientFetchAbortError("Operation was aborted");
+			}
+			const { done, value } = await (abortSignal ? Promise.race([reader.read(), createAbortPromise(abortSignal)]) : reader.read());
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			const lines = buffer.split("\n");
+			buffer = lines.pop() || "";
+			for (const line of lines) {
+				if (!line.trim()) continue;
+				try {
+					const jsonObject = JSON.parse(line);
+					items.push(jsonObject);
+					if (firstItem === null) {
+						firstItem = jsonObject;
+						const streamingPromise = continueStreaming(reader, decoder, buffer, items, store, abortSignal);
+						return {
+							firstItem,
+							streamingPromise
+						};
+					}
+				} catch (parseError) {
+					throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 500, { cause: parseError });
+				}
+			}
+		}
+		if (firstItem === null) {
+			reader.releaseLock();
+			throw new FragnoClientUnknownApiError("NDJSON stream contained no valid items", 500);
+		}
+		reader.releaseLock();
+		throw new FragnoClientFetchError("Unexpected end of stream processing", "NO_BODY");
+	} catch (error) {
+		if (error instanceof FragnoClientError) {
+			store?.setError(error);
+			throw error;
+		} else {
+			const clientError = new FragnoClientUnknownApiError("Unknown streaming error", 500, { cause: error });
+			store?.setError(clientError);
+			throw clientError;
+		}
+	}
+}
+/**
+* Continues streaming the remaining items in the background
+*/
+async function continueStreaming(reader, decoder, initialBuffer, items, store, abortSignal) {
+	let buffer = initialBuffer;
+	try {
+		while (true) {
+			if (abortSignal?.aborted) throw new FragnoClientFetchAbortError("Operation was aborted");
+			const { done, value } = await (abortSignal ? Promise.race([reader.read(), createAbortPromise(abortSignal)]) : reader.read());
+			if (done) {
+				if (buffer.trim()) {
+					const lines$1 = buffer.split("\n");
+					for (const line of lines$1) {
+						if (!line.trim()) continue;
+						try {
+							const jsonObject = JSON.parse(line);
+							items.push(jsonObject);
+							store?.setData([...items]);
+						} catch (parseError) {
+							throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 400, { cause: parseError });
+						}
+					}
+				}
+				break;
+			}
+			buffer += decoder.decode(value, { stream: true });
+			const lines = buffer.split("\n");
+			buffer = lines.pop() || "";
+			for (const line of lines) {
+				if (!line.trim()) continue;
+				try {
+					const jsonObject = JSON.parse(line);
+					items.push(jsonObject);
+					store?.setData([...items]);
+				} catch (parseError) {
+					throw new FragnoClientUnknownApiError("Failed to parse NDJSON line", 400, { cause: parseError });
+				}
+			}
+		}
+	} catch (error) {
+		if (error instanceof FragnoClientError) store?.setError(error);
+		else {
+			const clientError = new FragnoClientUnknownApiError("Unknown streaming error", 400, { cause: error });
+			store?.setError(clientError);
+			throw clientError;
+		}
+		throw error;
+	} finally {
+		reader.releaseLock();
+	}
+	return items;
+}
+
 //#endregion
 //#region ../../node_modules/.pnpm/nanoevents@9.1.0/node_modules/nanoevents/index.js
 let createNanoEvents = () => ({
@@ -1063,7 +1147,7 @@ let createNanoEvents = () => ({
 });
 
 //#endregion
-//#region ../../node_modules/.pnpm/@nanostores+query@0.3.4_nanostores@1.1.0/node_modules/@nanostores/query/dist/nanoquery.js
+//#region ../../node_modules/.pnpm/@nanostores+query@0.3.4_nanostores@1.2.0/node_modules/@nanostores/query/dist/nanoquery.js
 function defaultOnErrorRetry({ retryCount }) {
 	return ~~((Math.random() + .5) * (1 << (retryCount < 8 ? retryCount : 8))) * 2e3;
 }
@@ -1420,6 +1504,97 @@ const GET_HOOK_SYMBOL = Symbol("fragno-get-hook");
 const MUTATOR_HOOK_SYMBOL = Symbol("fragno-mutator-hook");
 const STORE_SYMBOL = Symbol("fragno-store");
 /**
+* Check if a value contains files that should be sent as FormData.
+* @internal
+*/
+function containsFiles(value) {
+	if (value instanceof File || value instanceof Blob) return true;
+	if (value instanceof FormData) return true;
+	if (typeof value === "object" && value !== null) return Object.values(value).some((v) => v instanceof File || v instanceof Blob || v instanceof FormData);
+	return false;
+}
+/**
+* Convert an object containing files to FormData.
+* Handles nested File/Blob values by appending them directly.
+* Other values are JSON-stringified.
+* @internal
+*/
+function toFormData(value) {
+	const formData = new FormData();
+	for (const [key, val] of Object.entries(value)) if (val instanceof File) formData.append(key, val, val.name);
+	else if (val instanceof Blob) formData.append(key, val);
+	else if (val !== void 0 && val !== null) formData.append(key, typeof val === "string" ? val : JSON.stringify(val));
+	return formData;
+}
+/**
+* Prepare request body and headers for sending.
+* Handles FormData (file uploads) vs JSON data.
+* @internal
+*/
+function prepareRequestBody(body, contentType) {
+	if (body === void 0) return { body: void 0 };
+	if (contentType === "application/octet-stream") {
+		if (body instanceof ReadableStream || body instanceof Blob || body instanceof File || body instanceof ArrayBuffer || body instanceof Uint8Array) return {
+			body,
+			headers: { "Content-Type": "application/octet-stream" }
+		};
+		throw new Error("Octet-stream routes only accept Blob, File, ArrayBuffer, Uint8Array, or ReadableStream bodies.");
+	}
+	if (body instanceof FormData) return { body };
+	if (body instanceof File) {
+		const formData = new FormData();
+		formData.append("file", body, body.name);
+		return { body: formData };
+	}
+	if (body instanceof Blob) {
+		const formData = new FormData();
+		formData.append("file", body);
+		return { body: formData };
+	}
+	if (typeof body === "object" && body !== null && containsFiles(body)) return { body: toFormData(body) };
+	return {
+		body: JSON.stringify(body),
+		headers: { "Content-Type": "application/json" }
+	};
+}
+async function schemaAllowsUndefined(schema) {
+	try {
+		return !(await schema["~standard"].validate(void 0)).issues;
+	} catch {
+		return false;
+	}
+}
+async function assertBodyProvided(body, inputSchema, errorMessage) {
+	if (typeof body !== "undefined" || inputSchema === void 0) return;
+	if (await schemaAllowsUndefined(inputSchema)) return;
+	throw new Error(errorMessage);
+}
+/**
+* Merge request headers from multiple sources.
+* Returns undefined if there are no headers to merge.
+* @internal
+*/
+function mergeRequestHeaders(...headerSources) {
+	const result = {};
+	let hasHeaders = false;
+	for (const source of headerSources) {
+		if (!source) continue;
+		if (source instanceof Headers) for (const [key, value] of source.entries()) {
+			result[key] = value;
+			hasHeaders = true;
+		}
+		else if (Array.isArray(source)) for (const [key, value] of source) {
+			result[key] = value;
+			hasHeaders = true;
+		}
+		else for (const [key, value] of Object.entries(source)) {
+			result[key] = value;
+			hasHeaders = true;
+		}
+	}
+	return hasHeaders ? result : void 0;
+}
+/**
 * @internal
 */
 function buildUrl(config, params) {
@@ -1504,9 +1679,13 @@ var ClientBuilder = class {
 	get cacheEntries() {
 		return Object.fromEntries(this.#cache.entries());
 	}
-	createStore(obj) {
+	createStore(input) {
+		if (typeof input === "function") return {
+			factory: input,
+			[STORE_SYMBOL]: true
+		};
 		return {
-			obj,
+			obj: input,
 			[STORE_SYMBOL]: true
 		};
 	}
@@ -1517,7 +1696,10 @@ var ClientBuilder = class {
 	buildUrl(path, params) {
 		return buildUrl({
 			baseUrl: this.#publicConfig.baseUrl ?? "",
-			mountRoute: getMountRoute(this.#fragmentConfig),
+			mountRoute: getMountRoute({
+				name: this.#fragmentConfig.name,
+				mountRoute: this.#publicConfig.mountRoute
+			}),
 			path
 		}, {
 			pathParams: params?.path,
@@ -1536,7 +1718,7 @@ var ClientBuilder = class {
 	}
 	#getFetcher() {
 		if (this.#fetcherConfig?.type === "function") return this.#fetcherConfig.fetcher;
-		return fetch;
+		return globalThis.fetch.bind(globalThis);
 	}
 	#getFetcherOptions() {
 		if (this.#fetcherConfig?.type === "options") return this.#fetcherConfig.options;
@@ -1555,7 +1737,10 @@ var ClientBuilder = class {
 		if (route.method !== "GET") throw new Error(`Only GET routes are supported for hooks. Route '${route.path}' is a ${route.method} route.`);
 		if (!route.outputSchema) throw new Error(`Output schema is required for GET routes. Route '${route.path}' has no output schema.`);
 		const baseUrl = this.#publicConfig.baseUrl ?? "";
-		const mountRoute = getMountRoute(this.#fragmentConfig);
+		const mountRoute = getMountRoute({
+			name: this.#fragmentConfig.name,
+			mountRoute: this.#publicConfig.mountRoute
+		});
 		const fetcher = this.#getFetcher();
 		const fetcherOptions = this.#getFetcherOptions();
 		async function callServerSideHandler(params) {
@@ -1663,7 +1848,10 @@ var ClientBuilder = class {
 	#createRouteQueryMutator(route, onInvalidate = (invalidate, params) => invalidate("GET", route.path, params)) {
 		const method = route.method;
 		const baseUrl = this.#publicConfig.baseUrl ?? "";
-		const mountRoute = getMountRoute(this.#fragmentConfig);
+		const mountRoute = getMountRoute({
+			name: this.#fragmentConfig.name,
+			mountRoute: this.#publicConfig.mountRoute
+		});
 		const fetcher = this.#getFetcher();
 		const fetcherOptions = this.#getFetcherOptions();
 		async function executeMutateQuery({ body, path, query }) {
@@ -1685,11 +1873,16 @@ var ClientBuilder = class {
 			});
 			let response;
 			try {
-				response = await fetcher(url, {
+				const { body: preparedBody, headers: bodyHeaders } = prepareRequestBody(body, route.contentType);
+				const mergedHeaders = mergeRequestHeaders(fetcherOptions?.headers, bodyHeaders);
+				const requestOptions = {
 					...fetcherOptions,
 					method,
-					body: body !== void 0 ? JSON.stringify(body) : void 0
-				});
+					body: preparedBody,
+					...mergedHeaders ? { headers: mergedHeaders } : {}
+				};
+				if (preparedBody instanceof ReadableStream) requestOptions.duplex = "half";
+				response = await fetcher(url, requestOptions);
 			} catch (error) {
 				throw FragnoClientFetchError.fromUnknownFetchError(error);
 			}
@@ -1699,7 +1892,7 @@ var ClientBuilder = class {
 		const mutatorStore = this.#createMutatorStore(async ({ data }) => {
 			if (typeof window === "undefined") {}
 			const { body, path, query } = data;
-			if (typeof body === "undefined" && route.inputSchema !== void 0) throw new Error("Body is required.");
+			await assertBodyProvided(body, route.inputSchema, "Body is required.");
 			const response = await executeMutateQuery({
 				body,
 				path,
@@ -1738,7 +1931,7 @@ var ClientBuilder = class {
 		} });
 		const mutateQuery = async (data) => {
 			const { body, path, query } = data;
-			if (typeof body === "undefined" && route.inputSchema !== void 0) throw new Error("Body is required for mutateQuery");
+			await assertBodyProvided(body, route.inputSchema, "Body is required for mutateQuery");
 			const response = await executeMutateQuery({
 				body,
 				path,
@@ -1784,7 +1977,10 @@ function createClientBuilder(definition, publicConfig, routesOrFactories, author
 		name: definition.name,
 		routes: routes$1
 	};
-	const mountRoute = publicConfig.mountRoute ?? `/${definition.name}`;
+	const mountRoute = getMountRoute({
+		name: definition.name,
+		mountRoute: publicConfig.mountRoute
+	});
 	const mergedFetcherConfig = mergeFetcherConfigs(authorFetcherConfig, publicConfig.fetcherConfig);
 	return new ClientBuilder({
 		...publicConfig,
@@ -1795,7 +1991,7 @@ function createClientBuilder(definition, publicConfig, routesOrFactories, author
 
 //#endregion
 //#region src/definition.ts
-const formsFragmentDef = defineFragment("forms").extend((x) => x).withDependencies(() => {}).providesBaseService(() => {}).build();
+const formsFragmentDef = defineFragment("forms").extend((x) => x).providesBaseService(() => {}).build();
 
 //#endregion
 //#region src/models.ts
@@ -1810,11 +2006,11 @@ const FormStatusSchema = z.enum([
 const FormSchema = z.object({
 	id: z.string(),
 	title: z.string(),
-	description: z.string().nullable(),
-	slug: z.string(),
+	description: z.string().nullable().optional(),
+	slug: z.string().min(1).max(255).toLowerCase().trim(),
 	status: FormStatusSchema,
 	dataSchema: JSONSchemaSchema,
-	uiSchema: UISchemaElementSchema,
+	uiSchema: UISchemaElementSchema.optional(),
 	version: z.number(),
 	createdAt: z.date(),
 	updatedAt: z.date()
@@ -1830,7 +2026,7 @@ const ResponseMetadataSchema = z.object({
 	ip: z.union([z.ipv4(), z.ipv6()]).nullable(),
 	userAgent: z.string().max(4096).nullable()
 });
-const ResponseSchema = z.object({
+const FormResponseSchema = z.object({
 	id: z.string(),
 	formId: z.string().nullable().describe("Form ID (static form ID or database form external ID)"),
 	formVersion: z.number(),
@@ -1839,7 +2035,7 @@ const ResponseSchema = z.object({
 	ip: z.string().max(45).nullable(),
 	userAgent: z.string().max(512).nullable()
 });
-const NewResponseSchema = ResponseSchema.omit({
+const NewFormResponseSchema = FormResponseSchema.omit({
 	id: true,
 	submittedAt: true,
 	formId: true,
@@ -1861,7 +2057,7 @@ const publicRoutes = defineRoutes(formsFragmentDef).create(({ services, defineRo
 	}), defineRoute({
 		method: "POST",
 		path: "/:slug/submit",
-		inputSchema: NewResponseSchema,
+		inputSchema: NewFormResponseSchema,
 		outputSchema: z.string(),
 		errorCodes: [
 			"NOT_FOUND",
@@ -1879,19 +2075,30 @@ const adminRoutes = defineRoutes(formsFragmentDef).create(({ services, defineRou
 			outputSchema: z.array(FormSchema),
 			handler: () => {}
 		}),
+		defineRoute({
+			method: "GET",
+			path: "/admin/forms/:id",
+			outputSchema: FormSchema,
+			errorCodes: ["NOT_FOUND"],
+			handler: () => {}
+		}),
 		defineRoute({
 			method: "POST",
 			path: "/admin/forms",
 			inputSchema: NewFormSchema,
 			outputSchema: z.string(),
-			errorCodes: ["CREATE_FAILED"],
+			errorCodes: ["CREATE_FAILED", "INVALID_JSON_SCHEMA"],
 			handler: () => {}
 		}),
 		defineRoute({
 			method: "PUT",
 			path: "/admin/forms/:id",
 			inputSchema: UpdateFormSchema,
-			errorCodes: ["NOT_FOUND", "STATIC_FORM_READ_ONLY"],
+			errorCodes: [
+				"NOT_FOUND",
+				"STATIC_FORM_READ_ONLY",
+				"INVALID_JSON_SCHEMA"
+			],
 			handler: () => {}
 		}),
 		defineRoute({
@@ -1904,13 +2111,13 @@ const adminRoutes = defineRoutes(formsFragmentDef).create(({ services, defineRou
 			method: "GET",
 			path: "/admin/forms/:id/submissions",
 			queryParameters: ["sortOrder"],
-			outputSchema: z.array(ResponseSchema),
+			outputSchema: z.array(FormResponseSchema),
 			handler: () => {}
 		}),
 		defineRoute({
 			method: "GET",
 			path: "/admin/submissions/:id",
-			outputSchema: ResponseSchema,
+			outputSchema: FormResponseSchema,
 			errorCodes: ["NOT_FOUND"],
 			handler: () => {}
 		}),
@@ -1935,6 +2142,7 @@ function createFormsClients(fragnoConfig) {
 		useForm: b.createHook("/:slug"),
 		useSubmitForm: b.createMutator("POST", "/:slug/submit"),
 		useForms: b.createHook("/admin/forms"),
+		useFormById: b.createHook("/admin/forms/:id"),
 		useCreateForm: b.createMutator("POST", "/admin/forms"),
 		useUpdateForm: b.createMutator("PUT", "/admin/forms/:id"),
 		useDeleteForm: b.createMutator("DELETE", "/admin/forms/:id"),
@@ -1946,4 +2154,4 @@ function createFormsClients(fragnoConfig) {
 
 //#endregion
 export { atom, createFormsClients, createFormsFragment, formsFragmentDef, isGetHook, isMutatorHook, isReadableAtom, isStore, routes };
-//# sourceMappingURL=src-DbMX_NY6.js.map
+//# sourceMappingURL=src-BNcd9ogF.js.map