better-call 0.0.0-experimental.01ff4b77

package/dist/plugins/http/cookie.mjs

@@ -0,0 +1,113 @@
+import { v } from "../../index.mjs";
+import { res } from "./response.mjs";
+import { req } from "./request.mjs";
+//#region src/plugins/http/cookie.ts
+/** Cookie attributes as a SCHEMA - the source of truth. The TS type
+* falls out of it, and everything crossing a fn door validates against
+* it (enum-checked sameSite, `instanceof`-checked expires). */
+const cookieShape = {
+	maxAge: v.number({ optional: true }),
+	expires: v.date({ optional: true }),
+	path: v.string({ optional: true }),
+	domain: v.string({ optional: true }),
+	secure: v.boolean({ optional: true }),
+	httpOnly: v.boolean({ optional: true }),
+	sameSite: v.string({
+		enum: [
+			"strict",
+			"lax",
+			"none"
+		],
+		optional: true
+	})
+};
+/**
+* Scope-level cookie DEFAULTS, as a var: whatever sets it - app setup, a
+* module, an interceptor - every `setCookie` below merges its per-call
+* options ON TOP. Config that travels down the call tree is exactly what
+* a var is, so "change the global cookie config" is just a `.set()` at
+* any point in the scope.
+*/
+const cookieOptions = v.var("cookieOptions", {
+	default: {},
+	schema: v.object(cookieShape)
+});
+/** The per-call options field: the same shape, optional to send. */
+const cookieOptionsField = v.object(cookieShape, { optional: true });
+const serialize = (name, value, options = {}) => {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	if (options.maxAge !== void 0) parts.push(`Max-Age=${options.maxAge}`);
+	if (options.expires) parts.push(`Expires=${options.expires.toUTCString()}`);
+	if (options.path) parts.push(`Path=${options.path}`);
+	if (options.domain) parts.push(`Domain=${options.domain}`);
+	if (options.secure) parts.push("Secure");
+	if (options.httpOnly) parts.push("HttpOnly");
+	if (options.sameSite) parts.push(`SameSite=${options.sameSite.charAt(0).toUpperCase()}${options.sameSite.slice(1)}`);
+	return parts.join("; ");
+};
+const ck = v.fn("cookie.", { use: [{
+	req,
+	res,
+	cookieOptions
+}] });
+/** Read one cookie from the REQUEST jar. Positional: `getCookie("theme")`.
+* Readonly - reading a cookie can never write the scope. */
+const getCookie = ck.fn("get", {
+	input: [v.string()],
+	readonly: true
+}, (c) => {
+	const [name] = c.input;
+	return c.req?.cookies[name] ?? null;
+});
+/** Queue a Set-Cookie on the scope's response headers: the scope's
+* `cookieOptions` defaults, with per-call options merged on top. The
+* written cookie also lands in the request jar, so a later `getCookie`
+* in the same scope reads what was set. */
+const setCookie = ck.fn("set", { input: {
+	name: v.string(),
+	value: v.string(),
+	options: cookieOptionsField
+} }, (c) => {
+	const { name, value, options } = c.input;
+	let response = c.res;
+	if (!response) {
+		response = { headers: new Headers() };
+		c.res = response;
+	}
+	response.headers.append("set-cookie", serialize(name, value, {
+		...c.cookieOptions,
+		...options
+	}));
+	const current = c.req;
+	if (current) c.req = {
+		...current,
+		cookies: {
+			...current.cookies,
+			[name]: value
+		}
+	};
+	return { set: true };
+});
+/** Expire a cookie: a Set-Cookie with Max-Age=0 - the attributes (path,
+* domain) must match the ones it was set with. */
+const deleteCookie = ck.fn("delete", {
+	input: {
+		name: v.string(),
+		options: cookieOptionsField
+	},
+	use: [{ setCookie }]
+}, (c) => {
+	const { name, options } = c.input;
+	return c.setCookie({
+		name,
+		value: "",
+		options: {
+			...options,
+			maxAge: 0
+		}
+	});
+});
+//#endregion
+export { cookieOptions, cookieShape, deleteCookie, getCookie, setCookie };
+
+//# sourceMappingURL=cookie.mjs.map

package/dist/plugins/http/cookie.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie.mjs","names":[],"sources":["../../../src/plugins/http/cookie.ts"],"sourcesContent":["import { v } from \"../../index\";\nimport type { InferArgs } from \"../../schema\";\nimport { req } from \"./request\";\nimport { res } from \"./response\";\n\n/** Cookie attributes as a SCHEMA - the source of truth. The TS type\n * falls out of it, and everything crossing a fn door validates against\n * it (enum-checked sameSite, `instanceof`-checked expires). */\nexport const cookieShape = {\n\tmaxAge: v.number({ optional: true }),\n\texpires: v.date({ optional: true }),\n\tpath: v.string({ optional: true }),\n\tdomain: v.string({ optional: true }),\n\tsecure: v.boolean({ optional: true }),\n\thttpOnly: v.boolean({ optional: true }),\n\tsameSite: v.string({ enum: [\"strict\", \"lax\", \"none\"], optional: true }),\n};\n\nexport type CookieOptions = InferArgs<typeof cookieShape>;\n\n/**\n * Scope-level cookie DEFAULTS, as a var: whatever sets it - app setup, a\n * module, an interceptor - every `setCookie` below merges its per-call\n * options ON TOP. Config that travels down the call tree is exactly what\n * a var is, so \"change the global cookie config\" is just a `.set()` at\n * any point in the scope.\n */\nexport const cookieOptions = v.var(\"cookieOptions\", {\n\tdefault: {},\n\tschema: v.object(cookieShape),\n});\n\n/** The per-call options field: the same shape, optional to send. */\nconst cookieOptionsField = v.object(cookieShape, { optional: true });\n\nconst serialize = (\n\tname: string,\n\tvalue: string,\n\toptions: CookieOptions = {},\n) => {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`];\n\tif (options.maxAge !== undefined) parts.push(`Max-Age=${options.maxAge}`);\n\tif (options.expires) parts.push(`Expires=${options.expires.toUTCString()}`);\n\tif (options.path) parts.push(`Path=${options.path}`);\n\tif (options.domain) parts.push(`Domain=${options.domain}`);\n\tif (options.secure) parts.push(\"Secure\");\n\tif (options.httpOnly) parts.push(\"HttpOnly\");\n\tif (options.sameSite) {\n\t\tparts.push(\n\t\t\t`SameSite=${options.sameSite.charAt(0).toUpperCase()}${options.sameSite.slice(1)}`,\n\t\t);\n\t}\n\treturn parts.join(\"; \");\n};\n\nconst ck = v.fn(\"cookie.\", {\n\tuse: [{ req, res, cookieOptions }],\n});\n\n/** Read one cookie from the REQUEST jar. Positional: `getCookie(\"theme\")`.\n * Readonly - reading a cookie can never write the scope. */\nexport const getCookie = ck.fn(\n\t\"get\",\n\t{ input: [v.string()], readonly: true },\n\t(c): string | null => {\n\t\tconst [name] = c.input;\n\t\treturn c.req?.cookies[name] ?? null;\n\t},\n);\n\n/** Queue a Set-Cookie on the scope's response headers: the scope's\n * `cookieOptions` defaults, with per-call options merged on top. The\n * written cookie also lands in the request jar, so a later `getCookie`\n * in the same scope reads what was set. */\nexport const setCookie = ck.fn(\n\t\"set\",\n\t{\n\t\tinput: {\n\t\t\tname: v.string(),\n\t\t\tvalue: v.string(),\n\t\t\toptions: cookieOptionsField,\n\t\t},\n\t},\n\t(c) => {\n\t\tconst { name, value, options } = c.input;\n\t\tlet response = c.res;\n\t\tif (!response) {\n\t\t\tresponse = { headers: new Headers() };\n\t\t\tc.res = response;\n\t\t}\n\t\tresponse.headers.append(\n\t\t\t\"set-cookie\",\n\t\t\tserialize(name, value, { ...c.cookieOptions, ...options }),\n\t\t);\n\t\tconst current = c.req;\n\t\tif (current) {\n\t\t\tc.req = {\n\t\t\t\t...current,\n\t\t\t\tcookies: { ...current.cookies, [name]: value },\n\t\t\t};\n\t\t}\n\t\treturn { set: true };\n\t},\n);\n\n/** Expire a cookie: a Set-Cookie with Max-Age=0 - the attributes (path,\n * domain) must match the ones it was set with. */\nexport const deleteCookie = ck.fn(\n\t\"delete\",\n\t{\n\t\tinput: {\n\t\t\tname: v.string(),\n\t\t\toptions: cookieOptionsField,\n\t\t},\n\t\tuse: [{ setCookie }],\n\t},\n\t(c) => {\n\t\tconst { name, options } = c.input;\n\t\treturn c.setCookie({\n\t\t\tname,\n\t\t\tvalue: \"\",\n\t\t\toptions: { ...options, maxAge: 0 },\n\t\t});\n\t},\n);\n"],"mappings":";;;;;;;AAQA,MAAa,cAAc;CAC1B,QAAQ,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC;CACnC,SAAS,EAAE,KAAK,EAAE,UAAU,KAAK,CAAC;CAClC,MAAM,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC;CACjC,QAAQ,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC;CACnC,QAAQ,EAAE,QAAQ,EAAE,UAAU,KAAK,CAAC;CACpC,UAAU,EAAE,QAAQ,EAAE,UAAU,KAAK,CAAC;CACtC,UAAU,EAAE,OAAO;EAAE,MAAM;GAAC;GAAU;GAAO;EAAM;EAAG,UAAU;CAAK,CAAC;AACvE;;;;;;;;AAWA,MAAa,gBAAgB,EAAE,IAAI,iBAAiB;CACnD,SAAS,CAAC;CACV,QAAQ,EAAE,OAAO,WAAW;AAC7B,CAAC;;AAGD,MAAM,qBAAqB,EAAE,OAAO,aAAa,EAAE,UAAU,KAAK,CAAC;AAEnE,MAAM,aACL,MACA,OACA,UAAyB,CAAC,MACtB;CACJ,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,KAAK,GAAG;CACrD,IAAI,QAAQ,WAAW,KAAA,GAAW,MAAM,KAAK,WAAW,QAAQ,QAAQ;CACxE,IAAI,QAAQ,SAAS,MAAM,KAAK,WAAW,QAAQ,QAAQ,YAAY,GAAG;CAC1E,IAAI,QAAQ,MAAM,MAAM,KAAK,QAAQ,QAAQ,MAAM;CACnD,IAAI,QAAQ,QAAQ,MAAM,KAAK,UAAU,QAAQ,QAAQ;CACzD,IAAI,QAAQ,QAAQ,MAAM,KAAK,QAAQ;CACvC,IAAI,QAAQ,UAAU,MAAM,KAAK,UAAU;CAC3C,IAAI,QAAQ,UACX,MAAM,KACL,YAAY,QAAQ,SAAS,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,QAAQ,SAAS,MAAM,CAAC,GAChF;CAED,OAAO,MAAM,KAAK,IAAI;AACvB;AAEA,MAAM,KAAK,EAAE,GAAG,WAAW,EAC1B,KAAK,CAAC;CAAE;CAAK;CAAK;AAAc,CAAC,EAClC,CAAC;;;AAID,MAAa,YAAY,GAAG,GAC3B,OACA;CAAE,OAAO,CAAC,EAAE,OAAO,CAAC;CAAG,UAAU;AAAK,IACrC,MAAqB;CACrB,MAAM,CAAC,QAAQ,EAAE;CACjB,OAAO,EAAE,KAAK,QAAQ,SAAS;AAChC,CACD;;;;;AAMA,MAAa,YAAY,GAAG,GAC3B,OACA,EACC,OAAO;CACN,MAAM,EAAE,OAAO;CACf,OAAO,EAAE,OAAO;CAChB,SAAS;AACV,EACD,IACC,MAAM;CACN,MAAM,EAAE,MAAM,OAAO,YAAY,EAAE;CACnC,IAAI,WAAW,EAAE;CACjB,IAAI,CAAC,UAAU;EACd,WAAW,EAAE,SAAS,IAAI,QAAQ,EAAE;EACpC,EAAE,MAAM;CACT;CACA,SAAS,QAAQ,OAChB,cACA,UAAU,MAAM,OAAO;EAAE,GAAG,EAAE;EAAe,GAAG;CAAQ,CAAC,CAC1D;CACA,MAAM,UAAU,EAAE;CAClB,IAAI,SACH,EAAE,MAAM;EACP,GAAG;EACH,SAAS;GAAE,GAAG,QAAQ;IAAU,OAAO;EAAM;CAC9C;CAED,OAAO,EAAE,KAAK,KAAK;AACpB,CACD;;;AAIA,MAAa,eAAe,GAAG,GAC9B,UACA;CACC,OAAO;EACN,MAAM,EAAE,OAAO;EACf,SAAS;CACV;CACA,KAAK,CAAC,EAAE,UAAU,CAAC;AACpB,IACC,MAAM;CACN,MAAM,EAAE,MAAM,YAAY,EAAE;CAC5B,OAAO,EAAE,UAAU;EAClB;EACA,OAAO;EACP,SAAS;GAAE,GAAG;GAAS,QAAQ;EAAE;CAClC,CAAC;AACF,CACD"}

package/dist/plugins/http/error.cjs

@@ -0,0 +1,39 @@
+const require_error = require("../../error.cjs");
+//#region src/plugins/http/error.ts
+/** Static HTTP metadata on an error declaration from `http.err`. Non-
+* enumerable so `asType` / object validation never treat it as a field. */
+const kHttpErr = Symbol.for("better-call:http.err");
+function err(status, data = {}) {
+	if (!Number.isInteger(status) || status < 200 || status > 599) throw new require_error.ValidationError("http.err.status", `expected HTTP status 200-599, received ${status}`);
+	const schema = { ...data };
+	Object.defineProperty(schema, kHttpErr, {
+		value: { status },
+		enumerable: false,
+		configurable: true
+	});
+	return schema;
+}
+/** Status declared via `http.err` on a single error-schema value, if any. */
+const statusOf = (decl) => {
+	if (decl === null || typeof decl !== "object") return void 0;
+	return decl[kHttpErr]?.status;
+};
+/** Status for a thrown tag, looked up on the fn's `errors` map. */
+const errorStatus = (errors, tag) => statusOf(errors?.[tag]);
+/**
+* Write a declared error onto `res`: set `status` from `http.err`
+* metadata when present. Returns the same `res` for chaining.
+*/
+const applyError = (response, errors, error) => {
+	const status = errorStatus(errors, error.tag);
+	if (status !== void 0) response.status = status;
+	return response;
+};
+//#endregion
+exports.applyError = applyError;
+exports.err = err;
+exports.errorStatus = errorStatus;
+exports.kHttpErr = kHttpErr;
+exports.statusOf = statusOf;
+
+//# sourceMappingURL=error.cjs.map

package/dist/plugins/http/error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.cjs","names":["ValidationError"],"sources":["../../../src/plugins/http/error.ts"],"sourcesContent":["import { ValidationError } from \"../../error\";\nimport type { HttpResponse } from \"./response\";\n\n/** Static HTTP metadata on an error declaration from `http.err`. Non-\n * enumerable so `asType` / object validation never treat it as a field. */\nexport const kHttpErr = Symbol.for(\"better-call:http.err\");\n\nexport type HttpErrMeta = {\n\tstatus: number;\n};\n\n/**\n * Declare an HTTP status on a fn error tag. Returns a normal payload\n * schema (so `c.error(tag, data)` validates as today) with status stashed\n * on {@link kHttpErr}. Core never sees HTTP; the edge reads it back with\n * {@link errorStatus} / {@link applyError}.\n *\n * @example\n * ```ts\n * errors: {\n *   invalid_credentials: http.err(401, { attempts: v.number() }),\n *   gone: http.err(410),\n * }\n * ```\n */\nexport function err(status: number): Record<string, never>;\nexport function err<const S extends Record<string, unknown>>(\n\tstatus: number,\n\tdata: S,\n): S;\nexport function err(\n\tstatus: number,\n\tdata: Record<string, unknown> = {},\n): Record<string, unknown> {\n\tif (!Number.isInteger(status) || status < 200 || status > 599) {\n\t\tthrow new ValidationError(\n\t\t\t\"http.err.status\",\n\t\t\t`expected HTTP status 200-599, received ${status}`,\n\t\t);\n\t}\n\t// Copy so two tags can share a data shape without sharing metadata.\n\tconst schema = { ...data };\n\tObject.defineProperty(schema, kHttpErr, {\n\t\tvalue: { status } satisfies HttpErrMeta,\n\t\tenumerable: false,\n\t\tconfigurable: true,\n\t});\n\treturn schema;\n}\n\n/** Status declared via `http.err` on a single error-schema value, if any. */\nexport const statusOf = (decl: unknown): number | undefined => {\n\tif (decl === null || typeof decl !== \"object\") return undefined;\n\tconst meta = (decl as Record<symbol, HttpErrMeta | undefined>)[kHttpErr];\n\treturn meta?.status;\n};\n\n/** Status for a thrown tag, looked up on the fn's `errors` map. */\nexport const errorStatus = (\n\terrors: Record<string, unknown> | undefined | null,\n\ttag: string,\n): number | undefined => statusOf(errors?.[tag]);\n\n/**\n * Write a declared error onto `res`: set `status` from `http.err`\n * metadata when present. Returns the same `res` for chaining.\n */\nexport const applyError = (\n\tresponse: HttpResponse,\n\terrors: Record<string, unknown> | undefined | null,\n\terror: { tag: string },\n): HttpResponse => {\n\tconst status = errorStatus(errors, error.tag);\n\tif (status !== undefined) response.status = status;\n\treturn response;\n};\n"],"mappings":";;;;AAKA,MAAa,WAAW,OAAO,IAAI,sBAAsB;AAyBzD,SAAgB,IACf,QACA,OAAgC,CAAC,GACP;CAC1B,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,OAAO,SAAS,KACzD,MAAM,IAAIA,cAAAA,gBACT,mBACA,0CAA0C,QAC3C;CAGD,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,OAAO,eAAe,QAAQ,UAAU;EACvC,OAAO,EAAE,OAAO;EAChB,YAAY;EACZ,cAAc;CACf,CAAC;CACD,OAAO;AACR;;AAGA,MAAa,YAAY,SAAsC;CAC9D,IAAI,SAAS,QAAQ,OAAO,SAAS,UAAU,OAAO,KAAA;CAEtD,OADc,KAAiD,SACpD,EAAE;AACd;;AAGA,MAAa,eACZ,QACA,QACwB,SAAS,SAAS,IAAI;;;;;AAM/C,MAAa,cACZ,UACA,QACA,UACkB;CAClB,MAAM,SAAS,YAAY,QAAQ,MAAM,GAAG;CAC5C,IAAI,WAAW,KAAA,GAAW,SAAS,SAAS;CAC5C,OAAO;AACR"}

package/dist/plugins/http/error.d.cts

@@ -0,0 +1,38 @@
+import { HttpResponse } from "./response.cjs";
+//#region src/plugins/http/error.d.ts
+/** Static HTTP metadata on an error declaration from `http.err`. Non-
+ * enumerable so `asType` / object validation never treat it as a field. */
+declare const kHttpErr: unique symbol;
+type HttpErrMeta = {
+  status: number;
+};
+/**
+ * Declare an HTTP status on a fn error tag. Returns a normal payload
+ * schema (so `c.error(tag, data)` validates as today) with status stashed
+ * on {@link kHttpErr}. Core never sees HTTP; the edge reads it back with
+ * {@link errorStatus} / {@link applyError}.
+ *
+ * @example
+ * ```ts
+ * errors: {
+ *   invalid_credentials: http.err(401, { attempts: v.number() }),
+ *   gone: http.err(410),
+ * }
+ * ```
+ */
+declare function err(status: number): Record<string, never>;
+declare function err<const S extends Record<string, unknown>>(status: number, data: S): S;
+/** Status declared via `http.err` on a single error-schema value, if any. */
+declare const statusOf: (decl: unknown) => number | undefined;
+/** Status for a thrown tag, looked up on the fn's `errors` map. */
+declare const errorStatus: (errors: Record<string, unknown> | undefined | null, tag: string) => number | undefined;
+/**
+ * Write a declared error onto `res`: set `status` from `http.err`
+ * metadata when present. Returns the same `res` for chaining.
+ */
+declare const applyError: (response: HttpResponse, errors: Record<string, unknown> | undefined | null, error: {
+  tag: string;
+}) => HttpResponse;
+//#endregion
+export { HttpErrMeta, applyError, err, errorStatus, kHttpErr, statusOf };
+//# sourceMappingURL=error.d.cts.map

package/dist/plugins/http/error.d.mts

@@ -0,0 +1,38 @@
+import { HttpResponse } from "./response.mjs";
+//#region src/plugins/http/error.d.ts
+/** Static HTTP metadata on an error declaration from `http.err`. Non-
+ * enumerable so `asType` / object validation never treat it as a field. */
+declare const kHttpErr: unique symbol;
+type HttpErrMeta = {
+  status: number;
+};
+/**
+ * Declare an HTTP status on a fn error tag. Returns a normal payload
+ * schema (so `c.error(tag, data)` validates as today) with status stashed
+ * on {@link kHttpErr}. Core never sees HTTP; the edge reads it back with
+ * {@link errorStatus} / {@link applyError}.
+ *
+ * @example
+ * ```ts
+ * errors: {
+ *   invalid_credentials: http.err(401, { attempts: v.number() }),
+ *   gone: http.err(410),
+ * }
+ * ```
+ */
+declare function err(status: number): Record<string, never>;
+declare function err<const S extends Record<string, unknown>>(status: number, data: S): S;
+/** Status declared via `http.err` on a single error-schema value, if any. */
+declare const statusOf: (decl: unknown) => number | undefined;
+/** Status for a thrown tag, looked up on the fn's `errors` map. */
+declare const errorStatus: (errors: Record<string, unknown> | undefined | null, tag: string) => number | undefined;
+/**
+ * Write a declared error onto `res`: set `status` from `http.err`
+ * metadata when present. Returns the same `res` for chaining.
+ */
+declare const applyError: (response: HttpResponse, errors: Record<string, unknown> | undefined | null, error: {
+  tag: string;
+}) => HttpResponse;
+//#endregion
+export { HttpErrMeta, applyError, err, errorStatus, kHttpErr, statusOf };
+//# sourceMappingURL=error.d.mts.map

package/dist/plugins/http/error.mjs

@@ -0,0 +1,35 @@
+import { ValidationError } from "../../error.mjs";
+//#region src/plugins/http/error.ts
+/** Static HTTP metadata on an error declaration from `http.err`. Non-
+* enumerable so `asType` / object validation never treat it as a field. */
+const kHttpErr = Symbol.for("better-call:http.err");
+function err(status, data = {}) {
+	if (!Number.isInteger(status) || status < 200 || status > 599) throw new ValidationError("http.err.status", `expected HTTP status 200-599, received ${status}`);
+	const schema = { ...data };
+	Object.defineProperty(schema, kHttpErr, {
+		value: { status },
+		enumerable: false,
+		configurable: true
+	});
+	return schema;
+}
+/** Status declared via `http.err` on a single error-schema value, if any. */
+const statusOf = (decl) => {
+	if (decl === null || typeof decl !== "object") return void 0;
+	return decl[kHttpErr]?.status;
+};
+/** Status for a thrown tag, looked up on the fn's `errors` map. */
+const errorStatus = (errors, tag) => statusOf(errors?.[tag]);
+/**
+* Write a declared error onto `res`: set `status` from `http.err`
+* metadata when present. Returns the same `res` for chaining.
+*/
+const applyError = (response, errors, error) => {
+	const status = errorStatus(errors, error.tag);
+	if (status !== void 0) response.status = status;
+	return response;
+};
+//#endregion
+export { applyError, err, errorStatus, kHttpErr, statusOf };
+
+//# sourceMappingURL=error.mjs.map

package/dist/plugins/http/error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.mjs","names":[],"sources":["../../../src/plugins/http/error.ts"],"sourcesContent":["import { ValidationError } from \"../../error\";\nimport type { HttpResponse } from \"./response\";\n\n/** Static HTTP metadata on an error declaration from `http.err`. Non-\n * enumerable so `asType` / object validation never treat it as a field. */\nexport const kHttpErr = Symbol.for(\"better-call:http.err\");\n\nexport type HttpErrMeta = {\n\tstatus: number;\n};\n\n/**\n * Declare an HTTP status on a fn error tag. Returns a normal payload\n * schema (so `c.error(tag, data)` validates as today) with status stashed\n * on {@link kHttpErr}. Core never sees HTTP; the edge reads it back with\n * {@link errorStatus} / {@link applyError}.\n *\n * @example\n * ```ts\n * errors: {\n *   invalid_credentials: http.err(401, { attempts: v.number() }),\n *   gone: http.err(410),\n * }\n * ```\n */\nexport function err(status: number): Record<string, never>;\nexport function err<const S extends Record<string, unknown>>(\n\tstatus: number,\n\tdata: S,\n): S;\nexport function err(\n\tstatus: number,\n\tdata: Record<string, unknown> = {},\n): Record<string, unknown> {\n\tif (!Number.isInteger(status) || status < 200 || status > 599) {\n\t\tthrow new ValidationError(\n\t\t\t\"http.err.status\",\n\t\t\t`expected HTTP status 200-599, received ${status}`,\n\t\t);\n\t}\n\t// Copy so two tags can share a data shape without sharing metadata.\n\tconst schema = { ...data };\n\tObject.defineProperty(schema, kHttpErr, {\n\t\tvalue: { status } satisfies HttpErrMeta,\n\t\tenumerable: false,\n\t\tconfigurable: true,\n\t});\n\treturn schema;\n}\n\n/** Status declared via `http.err` on a single error-schema value, if any. */\nexport const statusOf = (decl: unknown): number | undefined => {\n\tif (decl === null || typeof decl !== \"object\") return undefined;\n\tconst meta = (decl as Record<symbol, HttpErrMeta | undefined>)[kHttpErr];\n\treturn meta?.status;\n};\n\n/** Status for a thrown tag, looked up on the fn's `errors` map. */\nexport const errorStatus = (\n\terrors: Record<string, unknown> | undefined | null,\n\ttag: string,\n): number | undefined => statusOf(errors?.[tag]);\n\n/**\n * Write a declared error onto `res`: set `status` from `http.err`\n * metadata when present. Returns the same `res` for chaining.\n */\nexport const applyError = (\n\tresponse: HttpResponse,\n\terrors: Record<string, unknown> | undefined | null,\n\terror: { tag: string },\n): HttpResponse => {\n\tconst status = errorStatus(errors, error.tag);\n\tif (status !== undefined) response.status = status;\n\treturn response;\n};\n"],"mappings":";;;;AAKA,MAAa,WAAW,OAAO,IAAI,sBAAsB;AAyBzD,SAAgB,IACf,QACA,OAAgC,CAAC,GACP;CAC1B,IAAI,CAAC,OAAO,UAAU,MAAM,KAAK,SAAS,OAAO,SAAS,KACzD,MAAM,IAAI,gBACT,mBACA,0CAA0C,QAC3C;CAGD,MAAM,SAAS,EAAE,GAAG,KAAK;CACzB,OAAO,eAAe,QAAQ,UAAU;EACvC,OAAO,EAAE,OAAO;EAChB,YAAY;EACZ,cAAc;CACf,CAAC;CACD,OAAO;AACR;;AAGA,MAAa,YAAY,SAAsC;CAC9D,IAAI,SAAS,QAAQ,OAAO,SAAS,UAAU,OAAO,KAAA;CAEtD,OADc,KAAiD,SACpD,EAAE;AACd;;AAGA,MAAa,eACZ,QACA,QACwB,SAAS,SAAS,IAAI;;;;;AAM/C,MAAa,cACZ,UACA,QACA,UACkB;CAClB,MAAM,SAAS,YAAY,QAAQ,MAAM,GAAG;CAC5C,IAAI,WAAW,KAAA,GAAW,SAAS,SAAS;CAC5C,OAAO;AACR"}

package/dist/plugins/http/handle.cjs

@@ -0,0 +1,73 @@
+const require_index = require("../../index.cjs");
+const require_response = require("./response.cjs");
+const require_request = require("./request.cjs");
+const require_cookie = require("./cookie.cjs");
+const require_redirect = require("./redirect.cjs");
+//#region src/plugins/http/handle.ts
+const base = {
+	req: require_request.req,
+	res: require_response.res,
+	fromRequest: require_request.fromRequest,
+	redirect: require_redirect.redirect,
+	getCookie: require_cookie.getCookie,
+	setCookie: require_cookie.setCookie,
+	deleteCookie: require_cookie.deleteCookie,
+	cookieOptions: require_cookie.cookieOptions
+};
+const isBodyInit = (value) => typeof value === "string" || value instanceof Blob || value instanceof ArrayBuffer || ArrayBuffer.isView(value) || value instanceof ReadableStream || value instanceof FormData || value instanceof URLSearchParams;
+const resultToResponse = (response, out) => {
+	if (out instanceof Response) return out;
+	if (out === void 0 || out === null) return require_response.toResponse(response, null);
+	if (isBodyInit(out)) return require_response.toResponse(response, out);
+	if (!response.headers.has("content-type")) response.headers.set("content-type", "application/json");
+	return require_response.toResponse(response, JSON.stringify(out));
+};
+const catchRedirect = (thrown, response) => {
+	if (!(thrown instanceof require_redirect.Redirect)) throw thrown;
+	const current = response ?? { headers: new Headers() };
+	require_redirect.applyRedirect(current, thrown);
+	return require_response.toResponse(current, null);
+};
+/** Seed req/res, run `run` on the same `c`, settle Redirect / body. */
+const settle = async (c, request, run) => {
+	await c.fromRequest({ request });
+	try {
+		const out = await run(c);
+		return resultToResponse(c.res ?? { headers: new Headers() }, out);
+	} catch (thrown) {
+		return catchRedirect(thrown, c.res);
+	}
+};
+/**
+* Mounted web edge: seed `req`/`res` from `request`, run `run` in the
+* same scope, and turn {@link Redirect} into a 3xx Response.
+*
+* @example
+* ```ts
+* return c.handler({
+*   request: c.input.request,
+*   run: (ctx) => {
+*     ctx.redirect({ url: "/dashboard" });
+*   },
+* });
+* ```
+*/
+const handler = require_index.v.fn({ use: [base] }).fn("http.handler", { input: {
+	request: require_index.v.any(),
+	run: require_index.v.any()
+} }, async (c) => settle(c, c.input.request, c.input.run));
+/**
+* Fetch adapter: `(request) => Response`. Modules in `options.use` are
+* mounted on the same context as `req` / `res` / `redirect`, so
+* `createHandler((c) => c.whoami(), { use: [{ whoami }] })` works.
+*/
+function createHandler(run, options) {
+	const use = [base, ...options?.use ?? []];
+	const entry = require_index.v.fn({ use }).fn("http.create_handler", { input: { request: require_index.v.any() } }, async (c) => settle(c, c.input.request, run));
+	return (request) => entry({ request });
+}
+//#endregion
+exports.createHandler = createHandler;
+exports.handler = handler;
+
+//# sourceMappingURL=handle.cjs.map

package/dist/plugins/http/handle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.cjs","names":["toResponse","Redirect","v"],"sources":["../../../src/plugins/http/handle.ts"],"sourcesContent":["import type { Context, Fn } from \"../../fn\";\nimport { v } from \"../../index\";\nimport type { ApplyOns, Module, ModuleFns } from \"../../module\";\nimport type { ScopeOf } from \"../../scope\";\nimport { cookieOptions, deleteCookie, getCookie, setCookie } from \"./cookie\";\nimport { applyRedirect, Redirect, redirect } from \"./redirect\";\nimport { fromRequest, req } from \"./request\";\nimport type { HttpResponse } from \"./response\";\nimport { res, toResponse } from \"./response\";\n\nconst base = {\n\treq,\n\tres,\n\tfromRequest,\n\tredirect,\n\tgetCookie,\n\tsetCookie,\n\tdeleteCookie,\n\tcookieOptions,\n};\n\ntype EdgeModules<PL extends readonly Module[]> = readonly [typeof base, ...PL];\n\n/** Context `run` receives: HTTP base plus anything in `options.use`. */\nexport type CreateHandlerContext<PL extends readonly Module[] = readonly []> =\n\tContext<\n\t\t{ request: Request },\n\t\tScopeOf<EdgeModules<PL>>,\n\t\tnever,\n\t\tApplyOns<ModuleFns<EdgeModules<PL>>, EdgeModules<PL>>,\n\t\tFn\n\t>;\n\nconst isBodyInit = (value: unknown): value is BodyInit =>\n\ttypeof value === \"string\" ||\n\tvalue instanceof Blob ||\n\tvalue instanceof ArrayBuffer ||\n\tArrayBuffer.isView(value) ||\n\tvalue instanceof ReadableStream ||\n\tvalue instanceof FormData ||\n\tvalue instanceof URLSearchParams;\n\nconst resultToResponse = (response: HttpResponse, out: unknown): Response => {\n\tif (out instanceof Response) return out;\n\tif (out === undefined || out === null) return toResponse(response, null);\n\tif (isBodyInit(out)) return toResponse(response, out);\n\tif (!response.headers.has(\"content-type\")) {\n\t\tresponse.headers.set(\"content-type\", \"application/json\");\n\t}\n\treturn toResponse(response, JSON.stringify(out));\n};\n\nconst catchRedirect = (\n\tthrown: unknown,\n\tresponse: HttpResponse | null | undefined,\n): Response => {\n\tif (!(thrown instanceof Redirect)) throw thrown;\n\tconst current = response ?? { headers: new Headers() };\n\tapplyRedirect(current, thrown);\n\treturn toResponse(current, null);\n};\n\n/** Seed req/res, run `run` on the same `c`, settle Redirect / body. */\nconst settle = async (\n\tc: any,\n\trequest: Request,\n\trun: (c: any) => unknown | Promise<unknown>,\n): Promise<Response> => {\n\tawait c.fromRequest({ request });\n\ttry {\n\t\tconst out = await run(c);\n\t\treturn resultToResponse(c.res ?? { headers: new Headers() }, out);\n\t} catch (thrown) {\n\t\treturn catchRedirect(thrown, c.res);\n\t}\n};\n\nconst h = v.fn({ use: [base] });\n\n/**\n * Mounted web edge: seed `req`/`res` from `request`, run `run` in the\n * same scope, and turn {@link Redirect} into a 3xx Response.\n *\n * @example\n * ```ts\n * return c.handler({\n *   request: c.input.request,\n *   run: (ctx) => {\n *     ctx.redirect({ url: \"/dashboard\" });\n *   },\n * });\n * ```\n */\nexport const handler = h.fn(\n\t\"http.handler\",\n\t{\n\t\tinput: {\n\t\t\trequest: v.any<Request>(),\n\t\t\trun: v.any<(c: any) => unknown | Promise<unknown>>(),\n\t\t},\n\t},\n\tasync (c) => settle(c, c.input.request, c.input.run),\n);\n\nexport type CreateHandlerOptions<PL extends readonly Module[] = readonly []> = {\n\t/** Extra modules mounted onto the same `c` that `run` receives. */\n\tuse?: PL;\n};\n\n/**\n * Fetch adapter: `(request) => Response`. Modules in `options.use` are\n * mounted on the same context as `req` / `res` / `redirect`, so\n * `createHandler((c) => c.whoami(), { use: [{ whoami }] })` works.\n */\nexport function createHandler<\n\tconst PL extends readonly Module[] = readonly [],\n\tR = unknown,\n>(\n\trun: (c: CreateHandlerContext<PL>) => R | Promise<R>,\n\toptions?: CreateHandlerOptions<PL>,\n): (request: Request) => Promise<Response> {\n\tconst use = [base, ...(options?.use ?? [])] as EdgeModules<PL>;\n\tconst entry = v\n\t\t.fn({ use })\n\t\t.fn(\n\t\t\t\"http.create_handler\",\n\t\t\t{ input: { request: v.any<Request>() } },\n\t\t\tasync (c) => settle(c, c.input.request, run),\n\t\t);\n\n\treturn (request) => entry({ request }) as Promise<Response>;\n}\n"],"mappings":";;;;;;AAUA,MAAM,OAAO;CACZ,KAAA,gBAAA;CACA,KAAA,iBAAA;CACA,aAAA,gBAAA;CACA,UAAA,iBAAA;CACA,WAAA,eAAA;CACA,WAAA,eAAA;CACA,cAAA,eAAA;CACA,eAAA,eAAA;AACD;AAcA,MAAM,cAAc,UACnB,OAAO,UAAU,YACjB,iBAAiB,QACjB,iBAAiB,eACjB,YAAY,OAAO,KAAK,KACxB,iBAAiB,kBACjB,iBAAiB,YACjB,iBAAiB;AAElB,MAAM,oBAAoB,UAAwB,QAA2B;CAC5E,IAAI,eAAe,UAAU,OAAO;CACpC,IAAI,QAAQ,KAAA,KAAa,QAAQ,MAAM,OAAOA,iBAAAA,WAAW,UAAU,IAAI;CACvE,IAAI,WAAW,GAAG,GAAG,OAAOA,iBAAAA,WAAW,UAAU,GAAG;CACpD,IAAI,CAAC,SAAS,QAAQ,IAAI,cAAc,GACvC,SAAS,QAAQ,IAAI,gBAAgB,kBAAkB;CAExD,OAAOA,iBAAAA,WAAW,UAAU,KAAK,UAAU,GAAG,CAAC;AAChD;AAEA,MAAM,iBACL,QACA,aACc;CACd,IAAI,EAAE,kBAAkBC,iBAAAA,WAAW,MAAM;CACzC,MAAM,UAAU,YAAY,EAAE,SAAS,IAAI,QAAQ,EAAE;CACrD,iBAAA,cAAc,SAAS,MAAM;CAC7B,OAAOD,iBAAAA,WAAW,SAAS,IAAI;AAChC;;AAGA,MAAM,SAAS,OACd,GACA,SACA,QACuB;CACvB,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC;CAC/B,IAAI;EACH,MAAM,MAAM,MAAM,IAAI,CAAC;EACvB,OAAO,iBAAiB,EAAE,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,GAAG,GAAG;CACjE,SAAS,QAAQ;EAChB,OAAO,cAAc,QAAQ,EAAE,GAAG;CACnC;AACD;;;;;;;;;;;;;;;AAkBA,MAAa,UAhBHE,cAAAA,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAgBN,CAAA,CAAE,GACxB,gBACA,EACC,OAAO;CACN,SAASA,cAAAA,EAAE,IAAa;CACxB,KAAKA,cAAAA,EAAE,IAA4C;AACpD,EACD,GACA,OAAO,MAAM,OAAO,GAAG,EAAE,MAAM,SAAS,EAAE,MAAM,GAAG,CACpD;;;;;;AAYA,SAAgB,cAIf,KACA,SAC0C;CAC1C,MAAM,MAAM,CAAC,MAAM,GAAI,SAAS,OAAO,CAAC,CAAE;CAC1C,MAAM,QAAQA,cAAAA,EACZ,GAAG,EAAE,IAAI,CAAC,CAAC,CACX,GACA,uBACA,EAAE,OAAO,EAAE,SAASA,cAAAA,EAAE,IAAa,EAAE,EAAE,GACvC,OAAO,MAAM,OAAO,GAAG,EAAE,MAAM,SAAS,GAAG,CAC5C;CAED,QAAQ,YAAY,MAAM,EAAE,QAAQ,CAAC;AACtC"}