better-call 0.0.0-experimental.01ff4b77

package/dist/plugins/http/handle.mjs

@@ -0,0 +1,72 @@
+import { v } from "../../index.mjs";
+import { res, toResponse } from "./response.mjs";
+import { fromRequest, req } from "./request.mjs";
+import { cookieOptions, deleteCookie, getCookie, setCookie } from "./cookie.mjs";
+import { Redirect, applyRedirect, redirect } from "./redirect.mjs";
+//#region src/plugins/http/handle.ts
+const base = {
+	req,
+	res,
+	fromRequest,
+	redirect,
+	getCookie,
+	setCookie,
+	deleteCookie,
+	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 toResponse(response, null);
+	if (isBodyInit(out)) return toResponse(response, out);
+	if (!response.headers.has("content-type")) response.headers.set("content-type", "application/json");
+	return toResponse(response, JSON.stringify(out));
+};
+const catchRedirect = (thrown, response) => {
+	if (!(thrown instanceof Redirect)) throw thrown;
+	const current = response ?? { headers: new Headers() };
+	applyRedirect(current, thrown);
+	return 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 = v.fn({ use: [base] }).fn("http.handler", { input: {
+	request: v.any(),
+	run: 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 = v.fn({ use }).fn("http.create_handler", { input: { request: v.any() } }, async (c) => settle(c, c.input.request, run));
+	return (request) => entry({ request });
+}
+//#endregion
+export { createHandler, handler };
+
+//# sourceMappingURL=handle.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle.mjs","names":[],"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;CACA;CACA;CACA;CACA;CACA;CACA;CACA;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,OAAO,WAAW,UAAU,IAAI;CACvE,IAAI,WAAW,GAAG,GAAG,OAAO,WAAW,UAAU,GAAG;CACpD,IAAI,CAAC,SAAS,QAAQ,IAAI,cAAc,GACvC,SAAS,QAAQ,IAAI,gBAAgB,kBAAkB;CAExD,OAAO,WAAW,UAAU,KAAK,UAAU,GAAG,CAAC;AAChD;AAEA,MAAM,iBACL,QACA,aACc;CACd,IAAI,EAAE,kBAAkB,WAAW,MAAM;CACzC,MAAM,UAAU,YAAY,EAAE,SAAS,IAAI,QAAQ,EAAE;CACrD,cAAc,SAAS,MAAM;CAC7B,OAAO,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,UAhBH,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAgBN,CAAA,CAAE,GACxB,gBACA,EACC,OAAO;CACN,SAAS,EAAE,IAAa;CACxB,KAAK,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,QAAQ,EACZ,GAAG,EAAE,IAAI,CAAC,CAAC,CACX,GACA,uBACA,EAAE,OAAO,EAAE,SAAS,EAAE,IAAa,EAAE,EAAE,GACvC,OAAO,MAAM,OAAO,GAAG,EAAE,MAAM,SAAS,GAAG,CAC5C;CAED,QAAQ,YAAY,MAAM,EAAE,QAAQ,CAAC;AACtC"}

package/dist/plugins/http/redirect.cjs

@@ -0,0 +1,82 @@
+const require_error = require("../../error.cjs");
+const require_index = require("../../index.cjs");
+const require_response = require("./response.cjs");
+//#region src/plugins/http/redirect.ts
+const REDIRECT_STATUSES = [
+	301,
+	302,
+	303,
+	307,
+	308
+];
+/** HTTP navigation control - not a domain refusal and not a defect.
+* Thrown by {@link redirect} after writing Location + status onto `res`. */
+var Redirect = class extends require_error.ControlFlow {
+	url;
+	status;
+	constructor(url, status = 302) {
+		super(`redirect ${status} ${url}`);
+		this.url = url;
+		this.status = status;
+		this.name = "Redirect";
+	}
+};
+/**
+* Write a redirect onto the scope's `res`, then throw {@link Redirect}
+* so the call stack unwinds. Catch it at the web edge with
+* {@link handler} / {@link createHandler} (or {@link asResponse} in a
+* manual try/catch). `.try` does not catch it.
+*
+* @example
+* ```ts
+* return c.handler({
+*   request,
+*   run: (ctx) => {
+*     ctx.redirect({ url: "/dashboard" });
+*   },
+* });
+* ```
+*/
+const redirect = require_index.v.fn({ use: [{ res: require_response.res }] }).fn("http.redirect", { input: {
+	url: require_index.v.string(),
+	status: require_index.v.number({
+		enum: REDIRECT_STATUSES,
+		default: 302
+	})
+} }, (c) => {
+	const { url, status } = c.input;
+	let response = c.res;
+	if (!response) {
+		response = { headers: new Headers() };
+		c.res = response;
+	}
+	response.status = status;
+	response.headers.set("location", url);
+	throw new Redirect(url, status);
+});
+/**
+* Write a thrown {@link Redirect} onto `res`: status + Location.
+* Returns the same `res` for chaining.
+*/
+const applyRedirect = (response, redirected) => {
+	response.status = redirected.status;
+	response.headers.set("location", redirected.url);
+	return response;
+};
+/**
+* Turn a thrown {@link Redirect} into a fetch Response, preserving
+* headers already on `response`. Any other value is rethrown.
+*/
+const asResponse = (thrown, response) => {
+	if (!(thrown instanceof Redirect)) throw thrown;
+	const current = response ?? { headers: new Headers() };
+	applyRedirect(current, thrown);
+	return require_response.toResponse(current, null);
+};
+//#endregion
+exports.Redirect = Redirect;
+exports.applyRedirect = applyRedirect;
+exports.asResponse = asResponse;
+exports.redirect = redirect;
+
+//# sourceMappingURL=redirect.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.cjs","names":["ControlFlow","v","toResponse"],"sources":["../../../src/plugins/http/redirect.ts"],"sourcesContent":["import { ControlFlow } from \"../../error\";\nimport { v } from \"../../index\";\nimport type { HttpResponse } from \"./response\";\nimport { res, toResponse } from \"./response\";\n\nexport type RedirectStatus = 301 | 302 | 303 | 307 | 308;\n\nconst REDIRECT_STATUSES = [301, 302, 303, 307, 308] as const;\n\n/** HTTP navigation control - not a domain refusal and not a defect.\n * Thrown by {@link redirect} after writing Location + status onto `res`. */\nexport class Redirect extends ControlFlow {\n\tconstructor(\n\t\tpublic url: string,\n\t\tpublic status: RedirectStatus = 302,\n\t) {\n\t\tsuper(`redirect ${status} ${url}`);\n\t\tthis.name = \"Redirect\";\n\t}\n}\n\nconst h = v.fn({ use: [{ res }] });\n\n/**\n * Write a redirect onto the scope's `res`, then throw {@link Redirect}\n * so the call stack unwinds. Catch it at the web edge with\n * {@link handler} / {@link createHandler} (or {@link asResponse} in a\n * manual try/catch). `.try` does not catch it.\n *\n * @example\n * ```ts\n * return c.handler({\n *   request,\n *   run: (ctx) => {\n *     ctx.redirect({ url: \"/dashboard\" });\n *   },\n * });\n * ```\n */\nexport const redirect = h.fn(\n\t\"http.redirect\",\n\t{\n\t\tinput: {\n\t\t\turl: v.string(),\n\t\t\tstatus: v.number({\n\t\t\t\tenum: REDIRECT_STATUSES,\n\t\t\t\tdefault: 302,\n\t\t\t}),\n\t\t},\n\t},\n\t(c): never => {\n\t\tconst { url, status } = 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.status = status;\n\t\tresponse.headers.set(\"location\", url);\n\t\tthrow new Redirect(url, status as RedirectStatus);\n\t},\n);\n\n/**\n * Write a thrown {@link Redirect} onto `res`: status + Location.\n * Returns the same `res` for chaining.\n */\nexport const applyRedirect = (\n\tresponse: HttpResponse,\n\tredirected: Redirect,\n): HttpResponse => {\n\tresponse.status = redirected.status;\n\tresponse.headers.set(\"location\", redirected.url);\n\treturn response;\n};\n\n/**\n * Turn a thrown {@link Redirect} into a fetch Response, preserving\n * headers already on `response`. Any other value is rethrown.\n */\nexport const asResponse = (\n\tthrown: unknown,\n\tresponse?: HttpResponse | null,\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"],"mappings":";;;;AAOA,MAAM,oBAAoB;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG;;;AAIlD,IAAa,WAAb,cAA8BA,cAAAA,YAAY;CAEjC;CACA;CAFR,YACC,KACA,SAAgC,KAC/B;EACD,MAAM,YAAY,OAAO,GAAG,KAAK;EAH1B,KAAA,MAAA;EACA,KAAA,SAAA;EAGP,KAAK,OAAO;CACb;AACD;;;;;;;;;;;;;;;;;AAoBA,MAAa,WAlBHC,cAAAA,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAA,iBAAA,IAAI,CAAC,EAAE,CAkBR,CAAA,CAAE,GACzB,iBACA,EACC,OAAO;CACN,KAAKA,cAAAA,EAAE,OAAO;CACd,QAAQA,cAAAA,EAAE,OAAO;EAChB,MAAM;EACN,SAAS;CACV,CAAC;AACF,EACD,IACC,MAAa;CACb,MAAM,EAAE,KAAK,WAAW,EAAE;CAC1B,IAAI,WAAW,EAAE;CACjB,IAAI,CAAC,UAAU;EACd,WAAW,EAAE,SAAS,IAAI,QAAQ,EAAE;EACpC,EAAE,MAAM;CACT;CACA,SAAS,SAAS;CAClB,SAAS,QAAQ,IAAI,YAAY,GAAG;CACpC,MAAM,IAAI,SAAS,KAAK,MAAwB;AACjD,CACD;;;;;AAMA,MAAa,iBACZ,UACA,eACkB;CAClB,SAAS,SAAS,WAAW;CAC7B,SAAS,QAAQ,IAAI,YAAY,WAAW,GAAG;CAC/C,OAAO;AACR;;;;;AAMA,MAAa,cACZ,QACA,aACc;CACd,IAAI,EAAE,kBAAkB,WAAW,MAAM;CACzC,MAAM,UAAU,YAAY,EAAE,SAAS,IAAI,QAAQ,EAAE;CACrD,cAAc,SAAS,MAAM;CAC7B,OAAOC,iBAAAA,WAAW,SAAS,IAAI;AAChC"}

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

@@ -0,0 +1,67 @@
+import { ControlFlow } from "../../error.cjs";
+import { TypeDefination } from "../../schema.cjs";
+import { FnDefination } from "../../fn.cjs";
+import { HttpResponse } from "./response.cjs";
+//#region src/plugins/http/redirect.d.ts
+type RedirectStatus = 301 | 302 | 303 | 307 | 308;
+/** HTTP navigation control - not a domain refusal and not a defect.
+ * Thrown by {@link redirect} after writing Location + status onto `res`. */
+declare class Redirect extends ControlFlow {
+  url: string;
+  status: RedirectStatus;
+  constructor(url: string, status?: RedirectStatus);
+}
+/**
+ * Write a redirect onto the scope's `res`, then throw {@link Redirect}
+ * so the call stack unwinds. Catch it at the web edge with
+ * {@link handler} / {@link createHandler} (or {@link asResponse} in a
+ * manual try/catch). `.try` does not catch it.
+ *
+ * @example
+ * ```ts
+ * return c.handler({
+ *   request,
+ *   run: (ctx) => {
+ *     ctx.redirect({ url: "/dashboard" });
+ *   },
+ * });
+ * ```
+ */
+declare const redirect: FnDefination<{
+  readonly url: string;
+  readonly status?: number | undefined;
+}, never, "http.redirect", {
+  readonly url: TypeDefination<string, string, never>;
+  readonly status: TypeDefination<number, number, number>;
+}, readonly [], {}, {
+  res?: ({
+    headers: {
+      append: (name: string, value: string) => void;
+      delete: (name: string) => void;
+      get: (name: string) => string | null;
+      getSetCookie: () => string[];
+      has: (name: string) => boolean;
+      set: (name: string, value: string) => void;
+      forEach: (callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any) => void;
+      entries: () => HeadersIterator<[string, string]>;
+      keys: () => HeadersIterator<string>;
+      values: () => HeadersIterator<string>;
+      [Symbol.iterator]: () => HeadersIterator<[string, string]>;
+    };
+    status?: number | undefined;
+    statusText?: string | undefined;
+  } & HttpResponse) | null | undefined;
+}, unknown>;
+/**
+ * Write a thrown {@link Redirect} onto `res`: status + Location.
+ * Returns the same `res` for chaining.
+ */
+declare const applyRedirect: (response: HttpResponse, redirected: Redirect) => HttpResponse;
+/**
+ * Turn a thrown {@link Redirect} into a fetch Response, preserving
+ * headers already on `response`. Any other value is rethrown.
+ */
+declare const asResponse: (thrown: unknown, response?: HttpResponse | null) => Response;
+//#endregion
+export { Redirect, RedirectStatus, applyRedirect, asResponse, redirect };
+//# sourceMappingURL=redirect.d.cts.map

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

@@ -0,0 +1,67 @@
+import { ControlFlow } from "../../error.mjs";
+import { TypeDefination } from "../../schema.mjs";
+import { FnDefination } from "../../fn.mjs";
+import { HttpResponse } from "./response.mjs";
+//#region src/plugins/http/redirect.d.ts
+type RedirectStatus = 301 | 302 | 303 | 307 | 308;
+/** HTTP navigation control - not a domain refusal and not a defect.
+ * Thrown by {@link redirect} after writing Location + status onto `res`. */
+declare class Redirect extends ControlFlow {
+  url: string;
+  status: RedirectStatus;
+  constructor(url: string, status?: RedirectStatus);
+}
+/**
+ * Write a redirect onto the scope's `res`, then throw {@link Redirect}
+ * so the call stack unwinds. Catch it at the web edge with
+ * {@link handler} / {@link createHandler} (or {@link asResponse} in a
+ * manual try/catch). `.try` does not catch it.
+ *
+ * @example
+ * ```ts
+ * return c.handler({
+ *   request,
+ *   run: (ctx) => {
+ *     ctx.redirect({ url: "/dashboard" });
+ *   },
+ * });
+ * ```
+ */
+declare const redirect: FnDefination<{
+  readonly url: string;
+  readonly status?: number | undefined;
+}, never, "http.redirect", {
+  readonly url: TypeDefination<string, string, never>;
+  readonly status: TypeDefination<number, number, number>;
+}, readonly [], {}, {
+  res?: ({
+    headers: {
+      append: (name: string, value: string) => void;
+      delete: (name: string) => void;
+      get: (name: string) => string | null;
+      getSetCookie: () => string[];
+      has: (name: string) => boolean;
+      set: (name: string, value: string) => void;
+      forEach: (callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any) => void;
+      entries: () => HeadersIterator<[string, string]>;
+      keys: () => HeadersIterator<string>;
+      values: () => HeadersIterator<string>;
+      [Symbol.iterator]: () => HeadersIterator<[string, string]>;
+    };
+    status?: number | undefined;
+    statusText?: string | undefined;
+  } & HttpResponse) | null | undefined;
+}, unknown>;
+/**
+ * Write a thrown {@link Redirect} onto `res`: status + Location.
+ * Returns the same `res` for chaining.
+ */
+declare const applyRedirect: (response: HttpResponse, redirected: Redirect) => HttpResponse;
+/**
+ * Turn a thrown {@link Redirect} into a fetch Response, preserving
+ * headers already on `response`. Any other value is rethrown.
+ */
+declare const asResponse: (thrown: unknown, response?: HttpResponse | null) => Response;
+//#endregion
+export { Redirect, RedirectStatus, applyRedirect, asResponse, redirect };
+//# sourceMappingURL=redirect.d.mts.map

package/dist/plugins/http/redirect.mjs

@@ -0,0 +1,79 @@
+import { ControlFlow } from "../../error.mjs";
+import { v } from "../../index.mjs";
+import { res, toResponse } from "./response.mjs";
+//#region src/plugins/http/redirect.ts
+const REDIRECT_STATUSES = [
+	301,
+	302,
+	303,
+	307,
+	308
+];
+/** HTTP navigation control - not a domain refusal and not a defect.
+* Thrown by {@link redirect} after writing Location + status onto `res`. */
+var Redirect = class extends ControlFlow {
+	url;
+	status;
+	constructor(url, status = 302) {
+		super(`redirect ${status} ${url}`);
+		this.url = url;
+		this.status = status;
+		this.name = "Redirect";
+	}
+};
+/**
+* Write a redirect onto the scope's `res`, then throw {@link Redirect}
+* so the call stack unwinds. Catch it at the web edge with
+* {@link handler} / {@link createHandler} (or {@link asResponse} in a
+* manual try/catch). `.try` does not catch it.
+*
+* @example
+* ```ts
+* return c.handler({
+*   request,
+*   run: (ctx) => {
+*     ctx.redirect({ url: "/dashboard" });
+*   },
+* });
+* ```
+*/
+const redirect = v.fn({ use: [{ res }] }).fn("http.redirect", { input: {
+	url: v.string(),
+	status: v.number({
+		enum: REDIRECT_STATUSES,
+		default: 302
+	})
+} }, (c) => {
+	const { url, status } = c.input;
+	let response = c.res;
+	if (!response) {
+		response = { headers: new Headers() };
+		c.res = response;
+	}
+	response.status = status;
+	response.headers.set("location", url);
+	throw new Redirect(url, status);
+});
+/**
+* Write a thrown {@link Redirect} onto `res`: status + Location.
+* Returns the same `res` for chaining.
+*/
+const applyRedirect = (response, redirected) => {
+	response.status = redirected.status;
+	response.headers.set("location", redirected.url);
+	return response;
+};
+/**
+* Turn a thrown {@link Redirect} into a fetch Response, preserving
+* headers already on `response`. Any other value is rethrown.
+*/
+const asResponse = (thrown, response) => {
+	if (!(thrown instanceof Redirect)) throw thrown;
+	const current = response ?? { headers: new Headers() };
+	applyRedirect(current, thrown);
+	return toResponse(current, null);
+};
+//#endregion
+export { Redirect, applyRedirect, asResponse, redirect };
+
+//# sourceMappingURL=redirect.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirect.mjs","names":[],"sources":["../../../src/plugins/http/redirect.ts"],"sourcesContent":["import { ControlFlow } from \"../../error\";\nimport { v } from \"../../index\";\nimport type { HttpResponse } from \"./response\";\nimport { res, toResponse } from \"./response\";\n\nexport type RedirectStatus = 301 | 302 | 303 | 307 | 308;\n\nconst REDIRECT_STATUSES = [301, 302, 303, 307, 308] as const;\n\n/** HTTP navigation control - not a domain refusal and not a defect.\n * Thrown by {@link redirect} after writing Location + status onto `res`. */\nexport class Redirect extends ControlFlow {\n\tconstructor(\n\t\tpublic url: string,\n\t\tpublic status: RedirectStatus = 302,\n\t) {\n\t\tsuper(`redirect ${status} ${url}`);\n\t\tthis.name = \"Redirect\";\n\t}\n}\n\nconst h = v.fn({ use: [{ res }] });\n\n/**\n * Write a redirect onto the scope's `res`, then throw {@link Redirect}\n * so the call stack unwinds. Catch it at the web edge with\n * {@link handler} / {@link createHandler} (or {@link asResponse} in a\n * manual try/catch). `.try` does not catch it.\n *\n * @example\n * ```ts\n * return c.handler({\n *   request,\n *   run: (ctx) => {\n *     ctx.redirect({ url: \"/dashboard\" });\n *   },\n * });\n * ```\n */\nexport const redirect = h.fn(\n\t\"http.redirect\",\n\t{\n\t\tinput: {\n\t\t\turl: v.string(),\n\t\t\tstatus: v.number({\n\t\t\t\tenum: REDIRECT_STATUSES,\n\t\t\t\tdefault: 302,\n\t\t\t}),\n\t\t},\n\t},\n\t(c): never => {\n\t\tconst { url, status } = 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.status = status;\n\t\tresponse.headers.set(\"location\", url);\n\t\tthrow new Redirect(url, status as RedirectStatus);\n\t},\n);\n\n/**\n * Write a thrown {@link Redirect} onto `res`: status + Location.\n * Returns the same `res` for chaining.\n */\nexport const applyRedirect = (\n\tresponse: HttpResponse,\n\tredirected: Redirect,\n): HttpResponse => {\n\tresponse.status = redirected.status;\n\tresponse.headers.set(\"location\", redirected.url);\n\treturn response;\n};\n\n/**\n * Turn a thrown {@link Redirect} into a fetch Response, preserving\n * headers already on `response`. Any other value is rethrown.\n */\nexport const asResponse = (\n\tthrown: unknown,\n\tresponse?: HttpResponse | null,\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"],"mappings":";;;;AAOA,MAAM,oBAAoB;CAAC;CAAK;CAAK;CAAK;CAAK;AAAG;;;AAIlD,IAAa,WAAb,cAA8B,YAAY;CAEjC;CACA;CAFR,YACC,KACA,SAAgC,KAC/B;EACD,MAAM,YAAY,OAAO,GAAG,KAAK;EAH1B,KAAA,MAAA;EACA,KAAA,SAAA;EAGP,KAAK,OAAO;CACb;AACD;;;;;;;;;;;;;;;;;AAoBA,MAAa,WAlBH,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,EAAE,CAkBR,CAAA,CAAE,GACzB,iBACA,EACC,OAAO;CACN,KAAK,EAAE,OAAO;CACd,QAAQ,EAAE,OAAO;EAChB,MAAM;EACN,SAAS;CACV,CAAC;AACF,EACD,IACC,MAAa;CACb,MAAM,EAAE,KAAK,WAAW,EAAE;CAC1B,IAAI,WAAW,EAAE;CACjB,IAAI,CAAC,UAAU;EACd,WAAW,EAAE,SAAS,IAAI,QAAQ,EAAE;EACpC,EAAE,MAAM;CACT;CACA,SAAS,SAAS;CAClB,SAAS,QAAQ,IAAI,YAAY,GAAG;CACpC,MAAM,IAAI,SAAS,KAAK,MAAwB;AACjD,CACD;;;;;AAMA,MAAa,iBACZ,UACA,eACkB;CAClB,SAAS,SAAS,WAAW;CAC7B,SAAS,QAAQ,IAAI,YAAY,WAAW,GAAG;CAC/C,OAAO;AACR;;;;;AAMA,MAAa,cACZ,QACA,aACc;CACd,IAAI,EAAE,kBAAkB,WAAW,MAAM;CACzC,MAAM,UAAU,YAAY,EAAE,SAAS,IAAI,QAAQ,EAAE;CACrD,cAAc,SAAS,MAAM;CAC7B,OAAO,WAAW,SAAS,IAAI;AAChC"}

package/dist/plugins/http/request.cjs

@@ -0,0 +1,63 @@
+const require_index = require("../../index.cjs");
+const require_response = require("./response.cjs");
+//#region src/plugins/http/request.ts
+const parseQuery = (url) => {
+	const q = {};
+	for (const [key, value] of url.searchParams) {
+		const current = q[key];
+		q[key] = current === void 0 ? value : Array.isArray(current) ? [...current, value] : [current, value];
+	}
+	return q;
+};
+const parseCookies = (header) => {
+	const jar = {};
+	for (const part of (header ?? "").split(";")) {
+		const [name, ...rest] = part.trim().split("=");
+		if (name) jar[name] = decodeURIComponent(rest.join("="));
+	}
+	return jar;
+};
+/** Build the `req` value from a fetch Request. The body cannot be read
+* synchronously, so it comes in from whoever already awaited it -
+* `fromRequest` does that for you. */
+const toHttpRequest = (raw, body) => {
+	const url = new URL(raw.url);
+	return {
+		raw,
+		method: raw.method.toUpperCase(),
+		path: url.pathname,
+		headers: raw.headers,
+		query: parseQuery(url),
+		cookies: parseCookies(raw.headers.get("cookie")),
+		body
+	};
+};
+const req = require_index.v.var("req", { default: null });
+const fromRequest = require_index.v.fn({ use: [{
+	req,
+	res: require_response.res
+}] }).fn("http.from_request", {
+	input: { request: require_index.v.any() },
+	provides: ["req"]
+}, async (c) => {
+	const raw = c.input.request;
+	let body;
+	if (raw.method !== "GET" && raw.method !== "HEAD") {
+		const contentType = raw.headers.get("content-type") ?? "";
+		if (contentType.includes("json")) body = await raw.clone().json().catch(() => void 0);
+		else if (contentType.includes("text")) body = await raw.clone().text().catch(() => void 0);
+	}
+	const value = toHttpRequest(raw, body);
+	c.req = value;
+	c.res = { headers: new Headers() };
+	return {
+		method: value.method,
+		path: value.path
+	};
+});
+//#endregion
+exports.fromRequest = fromRequest;
+exports.req = req;
+exports.toHttpRequest = toHttpRequest;
+
+//# sourceMappingURL=request.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.cjs","names":["v"],"sources":["../../../src/plugins/http/request.ts"],"sourcesContent":["import { v } from \"../../index\";\nimport { res } from \"./response\";\n\nconst parseQuery = (url: URL) => {\n\tconst q: Record<string, string | string[]> = {};\n\tfor (const [key, value] of url.searchParams) {\n\t\tconst current = q[key];\n\t\tq[key] =\n\t\t\tcurrent === undefined\n\t\t\t\t? value\n\t\t\t\t: Array.isArray(current)\n\t\t\t\t\t? [...current, value]\n\t\t\t\t\t: [current, value];\n\t}\n\treturn q;\n};\n\nconst parseCookies = (header: string | null) => {\n\tconst jar: Record<string, string> = {};\n\tfor (const part of (header ?? \"\").split(\";\")) {\n\t\tconst [name, ...rest] = part.trim().split(\"=\");\n\t\tif (name) jar[name] = decodeURIComponent(rest.join(\"=\"));\n\t}\n\treturn jar;\n};\n\n/** The whole request-side state, as ONE value: `c.req` and\n * everything is there - no per-piece vars to require one by one. */\nexport type HttpRequest = {\n\t/** The fetch Request itself, untouched. */\n\traw: Request;\n\tmethod: string;\n\tpath: string;\n\theaders: Headers;\n\tquery: Record<string, string | string[]>;\n\tcookies: Record<string, string>;\n\t/** Parsed by `fromRequest` when the content type says json/text -\n\t * anything else stays on `raw`. */\n\tbody: unknown;\n};\n\n/** Build the `req` value from a fetch Request. The body cannot be read\n * synchronously, so it comes in from whoever already awaited it -\n * `fromRequest` does that for you. */\nexport const toHttpRequest = (raw: Request, body?: unknown): HttpRequest => {\n\tconst url = new URL(raw.url);\n\treturn {\n\t\traw,\n\t\tmethod: raw.method.toUpperCase(),\n\t\tpath: url.pathname,\n\t\theaders: raw.headers,\n\t\tquery: parseQuery(url),\n\t\tcookies: parseCookies(raw.headers.get(\"cookie\")),\n\t\tbody,\n\t};\n};\n\nexport const req = v.var(\"req\", { default: null as HttpRequest | null });\n\nconst h = v.fn({ use: [{ req, res }] });\n\nexport const fromRequest = h.fn(\n\t\"http.from_request\",\n\t{ input: { request: v.any<Request>() }, provides: [\"req\"] },\n\tasync (c) => {\n\t\tconst raw = c.input.request;\n\t\tlet body: unknown;\n\t\tif (raw.method !== \"GET\" && raw.method !== \"HEAD\") {\n\t\t\tconst contentType = raw.headers.get(\"content-type\") ?? \"\";\n\t\t\tif (contentType.includes(\"json\")) {\n\t\t\t\tbody = await raw\n\t\t\t\t\t.clone()\n\t\t\t\t\t.json()\n\t\t\t\t\t.catch(() => undefined);\n\t\t\t} else if (contentType.includes(\"text\")) {\n\t\t\t\tbody = await raw\n\t\t\t\t\t.clone()\n\t\t\t\t\t.text()\n\t\t\t\t\t.catch(() => undefined);\n\t\t\t}\n\t\t}\n\t\tconst value = toHttpRequest(raw, body);\n\t\tc.req = value;\n\t\tc.res = { headers: new Headers() };\n\t\treturn { method: value.method, path: value.path };\n\t},\n);\n"],"mappings":";;;AAGA,MAAM,cAAc,QAAa;CAChC,MAAM,IAAuC,CAAC;CAC9C,KAAK,MAAM,CAAC,KAAK,UAAU,IAAI,cAAc;EAC5C,MAAM,UAAU,EAAE;EAClB,EAAE,OACD,YAAY,KAAA,IACT,QACA,MAAM,QAAQ,OAAO,IACpB,CAAC,GAAG,SAAS,KAAK,IAClB,CAAC,SAAS,KAAK;CACrB;CACA,OAAO;AACR;AAEA,MAAM,gBAAgB,WAA0B;CAC/C,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,SAAS,UAAU,GAAA,CAAI,MAAM,GAAG,GAAG;EAC7C,MAAM,CAAC,MAAM,GAAG,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG;EAC7C,IAAI,MAAM,IAAI,QAAQ,mBAAmB,KAAK,KAAK,GAAG,CAAC;CACxD;CACA,OAAO;AACR;;;;AAoBA,MAAa,iBAAiB,KAAc,SAAgC;CAC3E,MAAM,MAAM,IAAI,IAAI,IAAI,GAAG;CAC3B,OAAO;EACN;EACA,QAAQ,IAAI,OAAO,YAAY;EAC/B,MAAM,IAAI;EACV,SAAS,IAAI;EACb,OAAO,WAAW,GAAG;EACrB,SAAS,aAAa,IAAI,QAAQ,IAAI,QAAQ,CAAC;EAC/C;CACD;AACD;AAEA,MAAa,MAAMA,cAAAA,EAAE,IAAI,OAAO,EAAE,SAAS,KAA2B,CAAC;AAIvE,MAAa,cAFHA,cAAAA,EAAE,GAAG,EAAE,KAAK,CAAC;CAAE;CAAK,KAAA,iBAAA;AAAI,CAAC,EAAE,CAEV,CAAA,CAAE,GAC5B,qBACA;CAAE,OAAO,EAAE,SAASA,cAAAA,EAAE,IAAa,EAAE;CAAG,UAAU,CAAC,KAAK;AAAE,GAC1D,OAAO,MAAM;CACZ,MAAM,MAAM,EAAE,MAAM;CACpB,IAAI;CACJ,IAAI,IAAI,WAAW,SAAS,IAAI,WAAW,QAAQ;EAClD,MAAM,cAAc,IAAI,QAAQ,IAAI,cAAc,KAAK;EACvD,IAAI,YAAY,SAAS,MAAM,GAC9B,OAAO,MAAM,IACX,MAAM,CAAC,CACP,KAAK,CAAC,CACN,YAAY,KAAA,CAAS;OACjB,IAAI,YAAY,SAAS,MAAM,GACrC,OAAO,MAAM,IACX,MAAM,CAAC,CACP,KAAK,CAAC,CACN,YAAY,KAAA,CAAS;CAEzB;CACA,MAAM,QAAQ,cAAc,KAAK,IAAI;CACrC,EAAE,MAAM;CACR,EAAE,MAAM,EAAE,SAAS,IAAI,QAAQ,EAAE;CACjC,OAAO;EAAE,QAAQ,MAAM;EAAQ,MAAM,MAAM;CAAK;AACjD,CACD"}

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

@@ -0,0 +1,142 @@
+import { TypeDefination } from "../../schema.cjs";
+import { FnDefination } from "../../fn.cjs";
+import { VarDefination } from "../../var.cjs";
+import { HttpResponse } from "./response.cjs";
+//#region src/plugins/http/request.d.ts
+/** The whole request-side state, as ONE value: `c.req` and
+ * everything is there - no per-piece vars to require one by one. */
+type HttpRequest = {
+  /** The fetch Request itself, untouched. */
+  raw: Request;
+  method: string;
+  path: string;
+  headers: Headers;
+  query: Record<string, string | string[]>;
+  cookies: Record<string, string>;
+  /** Parsed by `fromRequest` when the content type says json/text -
+   * anything else stays on `raw`. */
+  body: unknown;
+};
+/** Build the `req` value from a fetch Request. The body cannot be read
+ * synchronously, so it comes in from whoever already awaited it -
+ * `fromRequest` does that for you. */
+declare const toHttpRequest: (raw: Request, body?: unknown) => HttpRequest;
+declare const req: VarDefination<"req", HttpRequest | null, undefined, never>;
+declare const fromRequest: FnDefination<{
+  readonly request: Request;
+}, Promise<{
+  method: string;
+  path: string;
+}>, "http.from_request", {
+  readonly request: TypeDefination<Request, Request, never>;
+}, readonly ["req"], {}, {
+  res?: ({
+    headers: {
+      append: (name: string, value: string) => void;
+      delete: (name: string) => void;
+      get: (name: string) => string | null;
+      getSetCookie: () => string[];
+      has: (name: string) => boolean;
+      set: (name: string, value: string) => void;
+      forEach: (callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any) => void;
+      entries: () => HeadersIterator<[string, string]>;
+      keys: () => HeadersIterator<string>;
+      values: () => HeadersIterator<string>;
+      [Symbol.iterator]: () => HeadersIterator<[string, string]>;
+    };
+    status?: number | undefined;
+    statusText?: string | undefined;
+  } & HttpResponse) | null | undefined;
+  req?: ({
+    raw: {
+      readonly cache: RequestCache;
+      readonly credentials: RequestCredentials;
+      readonly destination: RequestDestination;
+      readonly headers: {
+        append: (name: string, value: string) => void;
+        delete: (name: string) => void;
+        get: (name: string) => string | null;
+        getSetCookie: () => string[];
+        has: (name: string) => boolean;
+        set: (name: string, value: string) => void;
+        forEach: (callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any) => void;
+        entries: () => HeadersIterator<[string, string]>;
+        keys: () => HeadersIterator<string>;
+        values: () => HeadersIterator<string>;
+        [Symbol.iterator]: () => HeadersIterator<[string, string]>;
+      };
+      readonly integrity: string;
+      readonly keepalive: boolean;
+      readonly method: string;
+      readonly mode: RequestMode;
+      readonly redirect: RequestRedirect;
+      readonly referrer: string;
+      readonly referrerPolicy: ReferrerPolicy;
+      readonly signal: {
+        readonly aborted: boolean;
+        onabort: ((this: AbortSignal, ev: Event) => any) | null;
+        readonly reason: any;
+        throwIfAborted: () => void;
+        addEventListener: {
+          <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+          (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        };
+        removeEventListener: {
+          <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+          (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+        };
+        dispatchEvent: (event: Event) => boolean;
+      };
+      readonly url: string;
+      clone: () => Request;
+      readonly body: {
+        readonly locked: boolean;
+        cancel: (reason?: any) => Promise<void>;
+        getReader: {
+          (options: {
+            mode: "byob";
+          }): ReadableStreamBYOBReader;
+          (): ReadableStreamDefaultReader<Uint8Array<ArrayBuffer>>;
+          (options?: ReadableStreamGetReaderOptions): ReadableStreamReader<Uint8Array<ArrayBuffer>>;
+        };
+        pipeThrough: <T>(transform: ReadableWritablePair<T, Uint8Array<ArrayBuffer>>, options?: StreamPipeOptions) => ReadableStream<T>;
+        pipeTo: (destination: WritableStream<Uint8Array<ArrayBuffer>>, options?: StreamPipeOptions) => Promise<void>;
+        tee: () => [ReadableStream<Uint8Array<ArrayBuffer>>, ReadableStream<Uint8Array<ArrayBuffer>>];
+        values: (options?: ReadableStreamIteratorOptions) => ReadableStreamAsyncIterator<Uint8Array<ArrayBuffer>>;
+        [Symbol.asyncIterator]: (options?: ReadableStreamIteratorOptions) => ReadableStreamAsyncIterator<Uint8Array<ArrayBuffer>>;
+      } | null;
+      readonly bodyUsed: boolean;
+      arrayBuffer: () => Promise<ArrayBuffer>;
+      blob: () => Promise<Blob>;
+      bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+      formData: () => Promise<FormData>;
+      json: () => Promise<any>;
+      text: () => Promise<string>;
+    };
+    method: string;
+    path: string;
+    headers: {
+      append: (name: string, value: string) => void;
+      delete: (name: string) => void;
+      get: (name: string) => string | null;
+      getSetCookie: () => string[];
+      has: (name: string) => boolean;
+      set: (name: string, value: string) => void;
+      forEach: (callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any) => void;
+      entries: () => HeadersIterator<[string, string]>;
+      keys: () => HeadersIterator<string>;
+      values: () => HeadersIterator<string>;
+      [Symbol.iterator]: () => HeadersIterator<[string, string]>;
+    };
+    query: {
+      [x: string]: string | string[];
+    };
+    cookies: {
+      [x: string]: string;
+    };
+    body: unknown;
+  } & HttpRequest) | null | undefined;
+}, unknown>;
+//#endregion
+export { HttpRequest, fromRequest, req, toHttpRequest };
+//# sourceMappingURL=request.d.cts.map