@sugardarius/anzen 1.1.1 → 1.1.3

package/README.md

@@ -122,7 +122,16 @@ import { NextRequest } from 'next/server'
 import { createSafeRouteHandler } from '@sugardarius/anzen'
 
 export const GET = createSafeRouteHandler(
-  { id: 'next/request' },
+  {
+    id: 'next/request',
+    authorize: async ({
+      // Due to `NextRequest` limitations as the req is cloned it's always a `Request`
+      req,
+    }) => {
+      console.log(req)
+      return { user: 'John Doe' }
+    },
+  },
   async (ctx, req: NextRequest) => {
     console.log('pathname', req.nextUrl.pathname)
     return new Response(null, 200)

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }function E(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function w(e,a){if(E(e))throw new Error(a)}function g(e=!1){let a=e||process.env.NODE_ENV!=="production";return{info:(t,...n)=>{a&&console.log(t,...n)},error:(t,...n)=>{a&&console.error(t,...n)},warn:(t,...n)=>{a&&console.warn(t,...n)}}}function D(){let e=null,a=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");a=performance.now()},get:()=>{if(!e||!a)throw new Error("Execution clock has not been started or stopped.");return`${(a-e).toFixed(2)}ms`}}}function I(e,a,t="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(a);return w(n,t),n}var A=(e,a)=>a in e;function h(e,a){let t={},n=[];for(let u in e){if(!A(e,u))continue;let i=e[u]["~standard"].validate(a[u]);if(w(i,`Validation must be synchronous, but ${u} returned a Promise.`),i.issues){n.push(...i.issues.map(p=>({...p,path:[u,..._nullishCoalesce(p.path, () => ([]))]})));continue}t[u]=i.value}return n.length>0?{issues:n}:{value:t}}var C="[unknown:route:handler]",q=async e=>{if(_optionalChain([e, 'access', _ => _.headers, 'access', _2 => _2.get, 'call', _3 => _3("content-type"), 'optionalAccess', _4 => _4.startsWith, 'call', _5 => _5("application/json")]))return await e.json();let t=await e.text();return JSON.parse(t)};function F(e,a){if(e.body&&e.formData)throw new Error("You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.");let t=g(e.debug),n=_nullishCoalesce(e.id, () => (C)),u=_nullishCoalesce(e.onErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Unexpected error in route handler '${n}'`,r),new Response("Internal server error",{status:500}))))),i=_nullishCoalesce(e.onSegmentsValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid segments for route handler '${n}':`,r),new Response("Invalid segments",{status:400}))))),p=_nullishCoalesce(e.onSearchParamsValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid search params for route handler '${n}':`,r),new Response("Invalid search params",{status:400}))))),P=_nullishCoalesce(e.onBodyValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid body for route handler '${n}':`,r),new Response("Invalid body",{status:400}))))),v=_nullishCoalesce(e.onFormDataValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid form data for route handler '${n}':`,r),new Response("Invalid form data",{status:400}))))),b=_nullishCoalesce(e.authorize, () => ((async()=>{})));return async function(r,O){let c=D();c.start(),t.info(`\u{1F504} Running route handler '${n}'`),t.info(`\u{1F449}\u{1F3FB} Request ${r.method} ${r.url}`);let m=new URL(r.url),k=r.clone(),f=await b({req:k,url:m});if(f instanceof Response)return t.error(`\u{1F6D1} Request not authorized for route handler '${n}'`),f;let y;if(e.segments){let o=await O.params;if(o===void 0)return new Response("No segments provided",{status:400});let s=h(e.segments,o);if(s.issues)return await i(s.issues);y=s.value}let S;if(e.searchParams){let o=[...m.searchParams.keys()].map(d=>{let l=m.searchParams.getAll(d);return[d,l.length>1?l:l[0]]}),s=h(e.searchParams,Object.fromEntries(o));if(s.issues)return await p(s.issues);S=s.value}let x=r.clone(),R;if(e.body){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request body",{status:405});let o;try{o=await q(x)}catch(d){return await u(d)}let s=I(e.body,o,"Request body validation must be synchronous");if(s.issues)return await P(s.issues);R=s.value}let T;if(e.formData){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request form data",{status:405});let o=r.headers.get("content-type");if(!_optionalChain([o, 'optionalAccess', _6 => _6.startsWith, 'call', _7 => _7("multipart/form-data")])&&!_optionalChain([o, 'optionalAccess', _8 => _8.startsWith, 'call', _9 => _9("application/x-www-form-urlencoded")]))return new Response("Invalid content type for request form data",{status:415});let s;try{s=await x.formData()}catch(l){return await u(l)}let d=h(e.formData,Object.fromEntries(s.entries()));if(d.issues)return await v(d.issues);T=d.value}let V={id:n,url:m,...f?{auth:f}:{},...y?{segments:y}:{},...S?{searchParams:S}:{},...R?{body:R}:{},...T?{formData:T}:{}};try{let o=await a(V,r);return c.stop(),t.info(`\u2705 Route handler '${n}' executed successfully in ${c.get()}`),o}catch(o){return c.stop(),t.error(`\u{1F6D1} Route handler '${n} failed to execute after ${c.get()}'`),await u(o)}}}exports.createSafeRouteHandler = F;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }function E(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function w(e,a){if(E(e))throw new Error(a)}function g(e=!1){let a=e||process.env.NODE_ENV!=="production";return{info:(t,...n)=>{a&&console.log(t,...n)},error:(t,...n)=>{a&&console.error(t,...n)},warn:(t,...n)=>{a&&console.warn(t,...n)}}}function D(){let e=null,a=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");a=performance.now()},get:()=>{if(!e||!a)throw new Error("Execution clock has not been started or stopped.");return`${(a-e).toFixed(2)}ms`}}}function I(e,a,t="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(a);return w(n,t),n}var A=(e,a)=>a in e;function h(e,a){let t={},n=[];for(let u in e){if(!A(e,u))continue;let i=e[u]["~standard"].validate(a[u]);if(w(i,`Validation must be synchronous, but ${u} returned a Promise.`),i.issues){n.push(...i.issues.map(p=>({...p,path:[u,..._nullishCoalesce(p.path, () => ([]))]})));continue}t[u]=i.value}return n.length>0?{issues:n}:{value:t}}var C="[unknown:route:handler]",F=async e=>{if(_optionalChain([e, 'access', _ => _.headers, 'access', _2 => _2.get, 'call', _3 => _3("content-type"), 'optionalAccess', _4 => _4.startsWith, 'call', _5 => _5("application/json")]))return await e.json();let t=await e.text();return JSON.parse(t)};function H(e,a){if(e.body&&e.formData)throw new Error("You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.");let t=g(e.debug),n=_nullishCoalesce(e.id, () => (C)),u=_nullishCoalesce(e.onErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Unexpected error in route handler '${n}'`,r),new Response("Internal server error",{status:500}))))),i=_nullishCoalesce(e.onSegmentsValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid segments for route handler '${n}':`,r),new Response("Invalid segments",{status:400}))))),p=_nullishCoalesce(e.onSearchParamsValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid search params for route handler '${n}':`,r),new Response("Invalid search params",{status:400}))))),P=_nullishCoalesce(e.onBodyValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid body for route handler '${n}':`,r),new Response("Invalid body",{status:400}))))),v=_nullishCoalesce(e.onFormDataValidationErrorResponse, () => ((r=>(t.error(`\u{1F6D1} Invalid form data for route handler '${n}':`,r),new Response("Invalid form data",{status:400}))))),b=_nullishCoalesce(e.authorize, () => ((async()=>{})));return async function(r,O){let c=D();c.start(),t.info(`\u{1F504} Running route handler '${n}'`),t.info(`\u{1F449}\u{1F3FB} Request ${r.method} ${r.url}`);let m=new URL(r.url),k=r.clone(),f=await b({url:m,req:k});if(f instanceof Response)return t.error(`\u{1F6D1} Request not authorized for route handler '${n}'`),f;let y;if(e.segments){let o=await O.params;if(o===void 0)return new Response("No segments provided",{status:400});let s=h(e.segments,o);if(s.issues)return await i(s.issues);y=s.value}let S;if(e.searchParams){let o=[...m.searchParams.keys()].map(d=>{let l=m.searchParams.getAll(d);return[d,l.length>1?l:l[0]]}),s=h(e.searchParams,Object.fromEntries(o));if(s.issues)return await p(s.issues);S=s.value}let x=r.clone(),R;if(e.body){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request body",{status:405});let o;try{o=await F(x)}catch(d){return await u(d)}let s=I(e.body,o,"Request body validation must be synchronous");if(s.issues)return await P(s.issues);R=s.value}let T;if(e.formData){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request form data",{status:405});let o=r.headers.get("content-type");if(!_optionalChain([o, 'optionalAccess', _6 => _6.startsWith, 'call', _7 => _7("multipart/form-data")])&&!_optionalChain([o, 'optionalAccess', _8 => _8.startsWith, 'call', _9 => _9("application/x-www-form-urlencoded")]))return new Response("Invalid content type for request form data",{status:415});let s;try{s=await x.formData()}catch(l){return await u(l)}let d=h(e.formData,Object.fromEntries(s.entries()));if(d.issues)return await v(d.issues);T=d.value}let V={id:n,url:m,...f?{auth:f}:{},...y?{segments:y}:{},...S?{searchParams:S}:{},...R?{body:R}:{},...T?{formData:T}:{}};try{let o=await a(V,r);return c.stop(),t.info(`\u2705 Route handler '${n}' executed successfully in ${c.get()}`),o}catch(o){return c.stop(),t.error(`\u{1F6D1} Route handler '${n} failed to execute after ${c.get()}'`),await u(o)}}}exports.createSafeRouteHandler = H;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -73,20 +73,21 @@ type TSegmentsDict = StandardSchemaDictionary;
 type TSearchParamsDict = StandardSchemaDictionary;
 type TBodySchema = StandardSchemaV1;
 type TFormDataDict = StandardSchemaDictionary;
-type AuthFunction<TReq extends Request, AC extends AuthContext | undefined> = (input: {
+type AuthFunction<AC extends AuthContext | undefined> = (input: {
+    /**
+     * Parsed request url
+     */
+    readonly url: URL;
     /**
      * Original request
      *
      * Cloned from the incoming request to avoid side effects
      * and to make it consumable in the `authorize` function.
+     * Due to `NextRequest` limitations as the req is cloned it's always a `Request`
      */
-    readonly req: TReq;
-    /**
-     * Parsed request url
-     */
-    readonly url: URL;
+    req: Request;
 }) => Awaitable<AC | Response>;
-type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
+type BaseOptions<AC extends AuthContext | undefined> = {
     /**
      * ID for the route handler.
      * Used when logging in development or when `debug` is enabled.
@@ -101,7 +102,7 @@ type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
      * When returning a response, it will be used as the response for the request.
      * Return a response when the request is not authorized.
      */
-    authorize?: AuthFunction<TReq, AC>;
+    authorize?: AuthFunction<AC>;
     /**
      * Callback triggered when the request fails.
      * By default it returns a simple `500` response and the error is logged into the console.
@@ -120,7 +121,7 @@ type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
     debug?: boolean;
 };
 type OnValidationErrorResponse = (issues: readonly StandardSchemaV1.Issue[]) => Awaitable<Response>;
-type CreateSafeRouteHandlerOptions<TReq extends Request, AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
+type CreateSafeRouteHandlerOptions<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
     /**
      * Dynamic route segments used for the route handler path.
      * By design it will handler if the segments are a `Promise` or not.
@@ -176,14 +177,14 @@ type CreateSafeRouteHandlerOptions<TReq extends Request, AC extends AuthContext
      * By default it returns a simple `400` response and issues are logged into the console.
      */
     onFormDataValidationErrorResponse?: OnValidationErrorResponse;
-} & BaseOptions<TReq, AC>;
+} & BaseOptions<AC>;
 type RequestExtras = {
     /**
      * Route dynamic segments as params
      */
     params: Awaitable<any> | undefined;
 };
-type CreateSafeRouteHandlerReturnType<TReq extends Request> = (
+type CreateSafeRouteHandlerReturnType<TReq extends Request = Request> = (
 /**
  * Original request
  */
@@ -227,7 +228,7 @@ type SafeRouteHandlerContext<AC extends AuthContext | undefined, TSegments exten
      */
     readonly formData: UnwrapReadonlyObject<StandardSchemaDictionary.InferOutput<TFormData>>;
 } : EmptyObjectType);
-type SafeRouteHandler<TReq extends Request, AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = (
+type SafeRouteHandler<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined, TReq extends Request = Request> = (
 /**
  * Safe route handler context
  */
@@ -273,6 +274,6 @@ req: TReq) => Promise<Response>;
  *)
  * ```
  */
-declare function createSafeRouteHandler<TReq extends Request = Request, AC extends AuthContext | undefined = undefined, TRouteDynamicSegments extends TSegmentsDict | undefined = undefined, TSearchParams extends TSearchParamsDict | undefined = undefined, TBody extends TBodySchema | undefined = undefined, TFormData extends TFormDataDict | undefined = undefined>(options: CreateSafeRouteHandlerOptions<TReq, AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>, handlerFn: SafeRouteHandler<TReq, AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>): CreateSafeRouteHandlerReturnType<TReq>;
+declare function createSafeRouteHandler<AC extends AuthContext | undefined = undefined, TRouteDynamicSegments extends TSegmentsDict | undefined = undefined, TSearchParams extends TSearchParamsDict | undefined = undefined, TBody extends TBodySchema | undefined = undefined, TFormData extends TFormDataDict | undefined = undefined, TReq extends Request = Request>(options: CreateSafeRouteHandlerOptions<AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>, handlerFn: SafeRouteHandler<AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData, TReq>): CreateSafeRouteHandlerReturnType<TReq>;
 
 export { type AuthContext, type AuthFunction, type Awaitable, type BaseOptions, type CreateSafeRouteHandlerOptions, type CreateSafeRouteHandlerReturnType, type OnValidationErrorResponse, type RequestExtras, type SafeRouteHandler, type SafeRouteHandlerContext, type TBodySchema, type TFormDataDict, type TSearchParamsDict, type TSegmentsDict, createSafeRouteHandler };

package/dist/index.d.ts

@@ -73,20 +73,21 @@ type TSegmentsDict = StandardSchemaDictionary;
 type TSearchParamsDict = StandardSchemaDictionary;
 type TBodySchema = StandardSchemaV1;
 type TFormDataDict = StandardSchemaDictionary;
-type AuthFunction<TReq extends Request, AC extends AuthContext | undefined> = (input: {
+type AuthFunction<AC extends AuthContext | undefined> = (input: {
+    /**
+     * Parsed request url
+     */
+    readonly url: URL;
     /**
      * Original request
      *
      * Cloned from the incoming request to avoid side effects
      * and to make it consumable in the `authorize` function.
+     * Due to `NextRequest` limitations as the req is cloned it's always a `Request`
      */
-    readonly req: TReq;
-    /**
-     * Parsed request url
-     */
-    readonly url: URL;
+    req: Request;
 }) => Awaitable<AC | Response>;
-type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
+type BaseOptions<AC extends AuthContext | undefined> = {
     /**
      * ID for the route handler.
      * Used when logging in development or when `debug` is enabled.
@@ -101,7 +102,7 @@ type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
      * When returning a response, it will be used as the response for the request.
      * Return a response when the request is not authorized.
      */
-    authorize?: AuthFunction<TReq, AC>;
+    authorize?: AuthFunction<AC>;
     /**
      * Callback triggered when the request fails.
      * By default it returns a simple `500` response and the error is logged into the console.
@@ -120,7 +121,7 @@ type BaseOptions<TReq extends Request, AC extends AuthContext | undefined> = {
     debug?: boolean;
 };
 type OnValidationErrorResponse = (issues: readonly StandardSchemaV1.Issue[]) => Awaitable<Response>;
-type CreateSafeRouteHandlerOptions<TReq extends Request, AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
+type CreateSafeRouteHandlerOptions<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
     /**
      * Dynamic route segments used for the route handler path.
      * By design it will handler if the segments are a `Promise` or not.
@@ -176,14 +177,14 @@ type CreateSafeRouteHandlerOptions<TReq extends Request, AC extends AuthContext
      * By default it returns a simple `400` response and issues are logged into the console.
      */
     onFormDataValidationErrorResponse?: OnValidationErrorResponse;
-} & BaseOptions<TReq, AC>;
+} & BaseOptions<AC>;
 type RequestExtras = {
     /**
      * Route dynamic segments as params
      */
     params: Awaitable<any> | undefined;
 };
-type CreateSafeRouteHandlerReturnType<TReq extends Request> = (
+type CreateSafeRouteHandlerReturnType<TReq extends Request = Request> = (
 /**
  * Original request
  */
@@ -227,7 +228,7 @@ type SafeRouteHandlerContext<AC extends AuthContext | undefined, TSegments exten
      */
     readonly formData: UnwrapReadonlyObject<StandardSchemaDictionary.InferOutput<TFormData>>;
 } : EmptyObjectType);
-type SafeRouteHandler<TReq extends Request, AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = (
+type SafeRouteHandler<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined, TReq extends Request = Request> = (
 /**
  * Safe route handler context
  */
@@ -273,6 +274,6 @@ req: TReq) => Promise<Response>;
  *)
  * ```
  */
-declare function createSafeRouteHandler<TReq extends Request = Request, AC extends AuthContext | undefined = undefined, TRouteDynamicSegments extends TSegmentsDict | undefined = undefined, TSearchParams extends TSearchParamsDict | undefined = undefined, TBody extends TBodySchema | undefined = undefined, TFormData extends TFormDataDict | undefined = undefined>(options: CreateSafeRouteHandlerOptions<TReq, AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>, handlerFn: SafeRouteHandler<TReq, AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>): CreateSafeRouteHandlerReturnType<TReq>;
+declare function createSafeRouteHandler<AC extends AuthContext | undefined = undefined, TRouteDynamicSegments extends TSegmentsDict | undefined = undefined, TSearchParams extends TSearchParamsDict | undefined = undefined, TBody extends TBodySchema | undefined = undefined, TFormData extends TFormDataDict | undefined = undefined, TReq extends Request = Request>(options: CreateSafeRouteHandlerOptions<AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData>, handlerFn: SafeRouteHandler<AC, TRouteDynamicSegments, TSearchParams, TBody, TFormData, TReq>): CreateSafeRouteHandlerReturnType<TReq>;
 
 export { type AuthContext, type AuthFunction, type Awaitable, type BaseOptions, type CreateSafeRouteHandlerOptions, type CreateSafeRouteHandlerReturnType, type OnValidationErrorResponse, type RequestExtras, type SafeRouteHandler, type SafeRouteHandlerContext, type TBodySchema, type TFormDataDict, type TSearchParamsDict, type TSegmentsDict, createSafeRouteHandler };

package/dist/index.js

@@ -1,2 +1,2 @@
-function E(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function w(e,a){if(E(e))throw new Error(a)}function g(e=!1){let a=e||process.env.NODE_ENV!=="production";return{info:(t,...n)=>{a&&console.log(t,...n)},error:(t,...n)=>{a&&console.error(t,...n)},warn:(t,...n)=>{a&&console.warn(t,...n)}}}function D(){let e=null,a=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");a=performance.now()},get:()=>{if(!e||!a)throw new Error("Execution clock has not been started or stopped.");return`${(a-e).toFixed(2)}ms`}}}function I(e,a,t="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(a);return w(n,t),n}var A=(e,a)=>a in e;function h(e,a){let t={},n=[];for(let u in e){if(!A(e,u))continue;let i=e[u]["~standard"].validate(a[u]);if(w(i,`Validation must be synchronous, but ${u} returned a Promise.`),i.issues){n.push(...i.issues.map(p=>({...p,path:[u,...p.path??[]]})));continue}t[u]=i.value}return n.length>0?{issues:n}:{value:t}}var C="[unknown:route:handler]",q=async e=>{if(e.headers.get("content-type")?.startsWith("application/json"))return await e.json();let t=await e.text();return JSON.parse(t)};function F(e,a){if(e.body&&e.formData)throw new Error("You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.");let t=g(e.debug),n=e.id??C,u=e.onErrorResponse??(r=>(t.error(`\u{1F6D1} Unexpected error in route handler '${n}'`,r),new Response("Internal server error",{status:500}))),i=e.onSegmentsValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid segments for route handler '${n}':`,r),new Response("Invalid segments",{status:400}))),p=e.onSearchParamsValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid search params for route handler '${n}':`,r),new Response("Invalid search params",{status:400}))),P=e.onBodyValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid body for route handler '${n}':`,r),new Response("Invalid body",{status:400}))),v=e.onFormDataValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid form data for route handler '${n}':`,r),new Response("Invalid form data",{status:400}))),b=e.authorize??(async()=>{});return async function(r,O){let c=D();c.start(),t.info(`\u{1F504} Running route handler '${n}'`),t.info(`\u{1F449}\u{1F3FB} Request ${r.method} ${r.url}`);let m=new URL(r.url),k=r.clone(),f=await b({req:k,url:m});if(f instanceof Response)return t.error(`\u{1F6D1} Request not authorized for route handler '${n}'`),f;let y;if(e.segments){let o=await O.params;if(o===void 0)return new Response("No segments provided",{status:400});let s=h(e.segments,o);if(s.issues)return await i(s.issues);y=s.value}let S;if(e.searchParams){let o=[...m.searchParams.keys()].map(d=>{let l=m.searchParams.getAll(d);return[d,l.length>1?l:l[0]]}),s=h(e.searchParams,Object.fromEntries(o));if(s.issues)return await p(s.issues);S=s.value}let x=r.clone(),R;if(e.body){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request body",{status:405});let o;try{o=await q(x)}catch(d){return await u(d)}let s=I(e.body,o,"Request body validation must be synchronous");if(s.issues)return await P(s.issues);R=s.value}let T;if(e.formData){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request form data",{status:405});let o=r.headers.get("content-type");if(!o?.startsWith("multipart/form-data")&&!o?.startsWith("application/x-www-form-urlencoded"))return new Response("Invalid content type for request form data",{status:415});let s;try{s=await x.formData()}catch(l){return await u(l)}let d=h(e.formData,Object.fromEntries(s.entries()));if(d.issues)return await v(d.issues);T=d.value}let V={id:n,url:m,...f?{auth:f}:{},...y?{segments:y}:{},...S?{searchParams:S}:{},...R?{body:R}:{},...T?{formData:T}:{}};try{let o=await a(V,r);return c.stop(),t.info(`\u2705 Route handler '${n}' executed successfully in ${c.get()}`),o}catch(o){return c.stop(),t.error(`\u{1F6D1} Route handler '${n} failed to execute after ${c.get()}'`),await u(o)}}}export{F as createSafeRouteHandler};
+function E(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function w(e,a){if(E(e))throw new Error(a)}function g(e=!1){let a=e||process.env.NODE_ENV!=="production";return{info:(t,...n)=>{a&&console.log(t,...n)},error:(t,...n)=>{a&&console.error(t,...n)},warn:(t,...n)=>{a&&console.warn(t,...n)}}}function D(){let e=null,a=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");a=performance.now()},get:()=>{if(!e||!a)throw new Error("Execution clock has not been started or stopped.");return`${(a-e).toFixed(2)}ms`}}}function I(e,a,t="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(a);return w(n,t),n}var A=(e,a)=>a in e;function h(e,a){let t={},n=[];for(let u in e){if(!A(e,u))continue;let i=e[u]["~standard"].validate(a[u]);if(w(i,`Validation must be synchronous, but ${u} returned a Promise.`),i.issues){n.push(...i.issues.map(p=>({...p,path:[u,...p.path??[]]})));continue}t[u]=i.value}return n.length>0?{issues:n}:{value:t}}var C="[unknown:route:handler]",F=async e=>{if(e.headers.get("content-type")?.startsWith("application/json"))return await e.json();let t=await e.text();return JSON.parse(t)};function H(e,a){if(e.body&&e.formData)throw new Error("You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.");let t=g(e.debug),n=e.id??C,u=e.onErrorResponse??(r=>(t.error(`\u{1F6D1} Unexpected error in route handler '${n}'`,r),new Response("Internal server error",{status:500}))),i=e.onSegmentsValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid segments for route handler '${n}':`,r),new Response("Invalid segments",{status:400}))),p=e.onSearchParamsValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid search params for route handler '${n}':`,r),new Response("Invalid search params",{status:400}))),P=e.onBodyValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid body for route handler '${n}':`,r),new Response("Invalid body",{status:400}))),v=e.onFormDataValidationErrorResponse??(r=>(t.error(`\u{1F6D1} Invalid form data for route handler '${n}':`,r),new Response("Invalid form data",{status:400}))),b=e.authorize??(async()=>{});return async function(r,O){let c=D();c.start(),t.info(`\u{1F504} Running route handler '${n}'`),t.info(`\u{1F449}\u{1F3FB} Request ${r.method} ${r.url}`);let m=new URL(r.url),k=r.clone(),f=await b({url:m,req:k});if(f instanceof Response)return t.error(`\u{1F6D1} Request not authorized for route handler '${n}'`),f;let y;if(e.segments){let o=await O.params;if(o===void 0)return new Response("No segments provided",{status:400});let s=h(e.segments,o);if(s.issues)return await i(s.issues);y=s.value}let S;if(e.searchParams){let o=[...m.searchParams.keys()].map(d=>{let l=m.searchParams.getAll(d);return[d,l.length>1?l:l[0]]}),s=h(e.searchParams,Object.fromEntries(o));if(s.issues)return await p(s.issues);S=s.value}let x=r.clone(),R;if(e.body){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request body",{status:405});let o;try{o=await F(x)}catch(d){return await u(d)}let s=I(e.body,o,"Request body validation must be synchronous");if(s.issues)return await P(s.issues);R=s.value}let T;if(e.formData){if(!["POST","PUT","PATCH"].includes(r.method))return new Response("Invalid method for request form data",{status:405});let o=r.headers.get("content-type");if(!o?.startsWith("multipart/form-data")&&!o?.startsWith("application/x-www-form-urlencoded"))return new Response("Invalid content type for request form data",{status:415});let s;try{s=await x.formData()}catch(l){return await u(l)}let d=h(e.formData,Object.fromEntries(s.entries()));if(d.issues)return await v(d.issues);T=d.value}let V={id:n,url:m,...f?{auth:f}:{},...y?{segments:y}:{},...S?{searchParams:S}:{},...R?{body:R}:{},...T?{formData:T}:{}};try{let o=await a(V,r);return c.stop(),t.info(`\u2705 Route handler '${n}' executed successfully in ${c.get()}`),o}catch(o){return c.stop(),t.error(`\u{1F6D1} Route handler '${n} failed to execute after ${c.get()}'`),await u(o)}}}export{H as createSafeRouteHandler};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils.ts","../src/standard-schema.ts","../src/create-safe-route-handler.ts"],"sourcesContent":["export function isPromise<T>(\n  value: unknown\n): value is Promise<T> | PromiseLike<T> {\n  return (\n    value !== null &&\n    (typeof value === 'object' || typeof value === 'function') &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    typeof (value as any).then === 'function'\n  )\n}\n\nexport function assertsSyncOperation<T>(\n  value: T | Promise<T> | PromiseLike<T>,\n  message: string\n): asserts value is T {\n  if (isPromise<T>(value)) {\n    throw new Error(message)\n  }\n}\n\nexport function createLogger(debug: boolean = false) {\n  const shouldLog = debug || process.env.NODE_ENV !== 'production'\n  return {\n    info: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.log(message, ...rest)\n      }\n    },\n    error: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.error(message, ...rest)\n      }\n    },\n    warn: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.warn(message, ...rest)\n      }\n    },\n  }\n}\n\nexport function createExecutionClock() {\n  let startTime: number | null = null\n  let endTime: number | null = null\n\n  return {\n    start: (): void => {\n      startTime = performance.now()\n    },\n    stop: (): void => {\n      if (startTime === null) {\n        throw new Error('Execution clock was not started.')\n      }\n      endTime = performance.now()\n    },\n    get: (): string => {\n      if (!startTime || !endTime) {\n        throw new Error('Execution clock has not been started or stopped.')\n      }\n\n      const duration = endTime - startTime\n      return `${duration.toFixed(2)}ms`\n    },\n  }\n}\n","import { assertsSyncOperation } from './utils'\n\n/** The Standard Schema interface. */\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  /** The Standard Schema properties. */\n  readonly '~standard': StandardSchemaV1.Props<Input, Output>\n}\n\nexport declare namespace StandardSchemaV1 {\n  /** The Standard Schema properties interface. */\n  export interface Props<Input = unknown, Output = Input> {\n    /** The version number of the standard. */\n    readonly version: 1\n    /** The vendor name of the schema library. */\n    readonly vendor: string\n    /** Validates unknown input values. */\n    readonly validate: (\n      value: unknown\n    ) => Result<Output> | Promise<Result<Output>>\n    /** Inferred types associated with the schema. */\n    readonly types?: Types<Input, Output> | undefined\n  }\n\n  /** The result interface of the validate function. */\n  export type Result<Output> = SuccessResult<Output> | FailureResult\n\n  /** The result interface if validation succeeds. */\n  export interface SuccessResult<Output> {\n    /** The typed output value. */\n    readonly value: Output\n    /** The non-existent issues. */\n    readonly issues?: undefined\n  }\n\n  /** The result interface if validation fails. */\n  export interface FailureResult {\n    /** The issues of failed validation. */\n    readonly issues: ReadonlyArray<Issue>\n  }\n\n  /** The issue interface of the failure output. */\n  export interface Issue {\n    /** The error message of the issue. */\n    readonly message: string\n    /** The path of the issue, if any. */\n    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined\n  }\n\n  /** The path segment interface of the issue. */\n  export interface PathSegment {\n    /** The key representing a path segment. */\n    readonly key: PropertyKey\n  }\n\n  /** The Standard Schema types interface. */\n  export interface Types<Input = unknown, Output = Input> {\n    /** The input type of the schema. */\n    readonly input: Input\n    /** The output type of the schema. */\n    readonly output: Output\n  }\n\n  /** Infers the input type of a Standard Schema. */\n  export type InferInput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema['~standard']['types']\n  >['input']\n\n  /** Infers the output type of a Standard Schema. */\n  export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema['~standard']['types']\n  >['output']\n}\n\nexport function validateWithSchema<TSchema extends StandardSchemaV1>(\n  schema: TSchema,\n  value: unknown,\n  errSyncMsg = 'Validation must be synchronous but schema returned a Promise.'\n): StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>> {\n  const result = schema['~standard'].validate(value)\n  assertsSyncOperation(result, errSyncMsg)\n\n  return result\n}\n\n// Thanks to `@t3-env/core` (👉🏻 https://github.com/t3-oss/t3-env/blob/main/packages/core/src/standard.ts)\n// for this awesome dictionary schema.\nexport type StandardSchemaDictionary<\n  Input = Record<string, unknown>,\n  Output extends Record<keyof Input, unknown> = Input,\n> = {\n  [K in keyof Input]-?: StandardSchemaV1<Input[K], Output[K]>\n}\n\nexport namespace StandardSchemaDictionary {\n  export type InferInput<T extends StandardSchemaDictionary> = {\n    [K in keyof T]: StandardSchemaV1.InferInput<T[K]>\n  }\n  export type InferOutput<T extends StandardSchemaDictionary> = {\n    [K in keyof T]: StandardSchemaV1.InferOutput<T[K]>\n  }\n}\n\nconst hasDictKey = <T extends object, K extends PropertyKey>(\n  obj: T,\n  key: K\n): obj is T & Record<typeof key, unknown> => {\n  return key in obj\n}\n\nexport function parseWithDictionary<TDict extends StandardSchemaDictionary>(\n  dictionary: TDict,\n  value: Record<string, unknown>\n): StandardSchemaV1.Result<StandardSchemaDictionary.InferOutput<TDict>> {\n  const result: Record<string, unknown> = {}\n  const issues: StandardSchemaV1.Issue[] = []\n\n  for (const key in dictionary) {\n    if (!hasDictKey(dictionary, key)) {\n      continue\n    }\n    // NOTE: safe to assert as we're ensuring just before key isn't undefined\n    const propResult = dictionary[key]!['~standard'].validate(value[key])\n\n    assertsSyncOperation(\n      propResult,\n      `Validation must be synchronous, but ${key} returned a Promise.`\n    )\n\n    if (propResult.issues) {\n      issues.push(\n        ...propResult.issues.map((issue) => ({\n          ...issue,\n          path: [key, ...(issue.path ?? [])],\n        }))\n      )\n      continue\n    }\n    result[key] = propResult.value\n  }\n\n  if (issues.length > 0) {\n    return { issues }\n  }\n\n  return { value: result as never }\n}\n","import { createLogger, createExecutionClock } from './utils'\nimport {\n  parseWithDictionary,\n  validateWithSchema,\n  type StandardSchemaV1,\n} from './standard-schema'\nimport type {\n  Awaitable,\n  AuthContext,\n  TSegmentsDict,\n  TSearchParamsDict,\n  TBodySchema,\n  TFormDataDict,\n  RequestExtras,\n  CreateSafeRouteHandlerOptions,\n  CreateSafeRouteHandlerReturnType,\n  SafeRouteHandler,\n  SafeRouteHandlerContext,\n} from './types'\n\n/** @internal exported for testing only */\nexport const DEFAULT_ID = '[unknown:route:handler]'\n\n/**\n * @internal\n *\n * Reads the request body as JSON.\n * If it fails, it calls the `onErrorResponse` callback.\n */\nconst readRequestBodyAsJson = async <TReq extends Request>(\n  req: TReq\n): Promise<unknown> => {\n  const contentType = req.headers.get('content-type')\n  if (contentType?.startsWith('application/json')) {\n    return await req.json()\n  }\n\n  const text = await req.text()\n  return JSON.parse(text)\n}\n\n/**\n * Creates a safe route handler with data validation and error handling\n * for Next.js (>= 14) API route handlers.\n *\n * @param options - Options to configure the route handler.\n * @param handlerFn - The route handler function.\n *\n * @returns A Next.js API route handler function.\n *\n * @example\n * ```ts\n * import { string } from 'decoders'\n *import { createSafeRouteHandler } from '@sugardarius/anzen'\n * import { auth } from '~/lib/auth'\n *\n * export const GET = createSafeRouteHandler(\n *  {\n *    id: 'my-safe-route-handler',\n *    authorize: async ({ req }) => {\n *      const session = await auth.getSession(req)\n *      if (!session) {\n *        return new Response(null, { status: 401 })\n *      }\n *\n *      return { user: session.user }\n *     },\n *     segments: {\n *       id: string,\n *     },\n *   },\n *   async ({ auth, segments, }, req): Promise<Response> => {\n *     return Response.json({ user: auth.user, segments }, { status: 200 })\n *   }\n *)\n * ```\n */\nexport function createSafeRouteHandler<\n  TReq extends Request = Request,\n  AC extends AuthContext | undefined = undefined,\n  TRouteDynamicSegments extends TSegmentsDict | undefined = undefined,\n  TSearchParams extends TSearchParamsDict | undefined = undefined,\n  TBody extends TBodySchema | undefined = undefined,\n  TFormData extends TFormDataDict | undefined = undefined,\n>(\n  options: CreateSafeRouteHandlerOptions<\n    TReq,\n    AC,\n    TRouteDynamicSegments,\n    TSearchParams,\n    TBody,\n    TFormData\n  >,\n  handlerFn: SafeRouteHandler<\n    TReq,\n    AC,\n    TRouteDynamicSegments,\n    TSearchParams,\n    TBody,\n    TFormData\n  >\n): CreateSafeRouteHandlerReturnType<TReq> {\n  // NOTE: `body` and `formData` options are mutually exclusive 🎭\n  if (options.body && options.formData) {\n    throw new Error(\n      'You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.'\n    )\n  }\n\n  const log = createLogger(options.debug)\n  const id = options.id ?? DEFAULT_ID\n\n  const onErrorResponse =\n    options.onErrorResponse ??\n    ((err: unknown): Awaitable<Response> => {\n      log.error(`🛑 Unexpected error in route handler '${id}'`, err)\n      return new Response('Internal server error', {\n        status: 500,\n      })\n    })\n\n  const onSegmentsValidationErrorResponse =\n    options.onSegmentsValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid segments for route handler '${id}':`, issues)\n      return new Response('Invalid segments', {\n        status: 400,\n      })\n    })\n\n  const onSearchParamsValidationErrorResponse =\n    options.onSearchParamsValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid search params for route handler '${id}':`, issues)\n      return new Response('Invalid search params', {\n        status: 400,\n      })\n    })\n\n  const onBodyValidationErrorResponse =\n    options.onBodyValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid body for route handler '${id}':`, issues)\n      return new Response('Invalid body', {\n        status: 400,\n      })\n    })\n\n  const onFormDataValidationErrorResponse =\n    options.onFormDataValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid form data for route handler '${id}':`, issues)\n      return new Response('Invalid form data', {\n        status: 400,\n      })\n    })\n\n  const authorize = options.authorize ?? (async () => undefined)\n\n  // Next.js API Route handler declaration\n  return async function (req: TReq, extras: RequestExtras): Promise<Response> {\n    const executionClock = createExecutionClock()\n    executionClock.start()\n\n    log.info(`🔄 Running route handler '${id}'`)\n    log.info(`👉🏻 Request ${req.method} ${req.url}`)\n\n    const url = new URL(req.url)\n\n    // Do not mutate / consume the original request\n    const clonedReq_forAuth = req.clone() as TReq\n    const authOrResponse = await authorize({ req: clonedReq_forAuth, url })\n    if (authOrResponse instanceof Response) {\n      log.error(`🛑 Request not authorized for route handler '${id}'`)\n      return authOrResponse\n    }\n\n    let segments = undefined\n    if (options.segments) {\n      const params = await extras.params\n      if (params === undefined) {\n        return new Response('No segments provided', { status: 400 })\n      }\n\n      const parsedSegments = parseWithDictionary(options.segments, params)\n      if (parsedSegments.issues) {\n        return await onSegmentsValidationErrorResponse(parsedSegments.issues)\n      }\n\n      segments = parsedSegments.value\n    }\n\n    let searchParams = undefined\n    if (options.searchParams) {\n      const queryParams_unsafe = [...url.searchParams.keys()].map((k) => {\n        const values = url.searchParams.getAll(k)\n        return [k, values.length > 1 ? values : values[0]]\n      })\n\n      const parsedSearchParams = parseWithDictionary(\n        options.searchParams,\n        Object.fromEntries(queryParams_unsafe)\n      )\n\n      if (parsedSearchParams.issues) {\n        return await onSearchParamsValidationErrorResponse(\n          parsedSearchParams.issues\n        )\n      }\n\n      searchParams = parsedSearchParams.value\n    }\n\n    // Do not mutate / consume the original request\n    const clonedReq_forBody = req.clone() as TReq\n\n    let body = undefined\n    if (options.body) {\n      if (!['POST', 'PUT', 'PATCH'].includes(req.method)) {\n        return new Response('Invalid method for request body', {\n          status: 405,\n        })\n      }\n\n      let body_unsafe: unknown\n      try {\n        body_unsafe = await readRequestBodyAsJson(clonedReq_forBody)\n      } catch (err) {\n        return await onErrorResponse(err)\n      }\n\n      const parsedBody = validateWithSchema(\n        options.body,\n        body_unsafe,\n        'Request body validation must be synchronous'\n      )\n\n      if (parsedBody.issues) {\n        return await onBodyValidationErrorResponse(parsedBody.issues)\n      }\n\n      body = parsedBody.value\n    }\n\n    let formData = undefined\n    if (options.formData) {\n      if (!['POST', 'PUT', 'PATCH'].includes(req.method)) {\n        return new Response('Invalid method for request form data', {\n          status: 405,\n        })\n      }\n\n      const contentType = req.headers.get('content-type')\n      if (\n        !contentType?.startsWith('multipart/form-data') &&\n        !contentType?.startsWith('application/x-www-form-urlencoded')\n      ) {\n        return new Response('Invalid content type for request form data', {\n          status: 415,\n        })\n      }\n\n      let formData_unsafe: FormData\n      try {\n        // NOTE: 🤔 maybe find a better way to counter the deprecation warning?\n        formData_unsafe = await clonedReq_forBody.formData()\n      } catch (err) {\n        return await onErrorResponse(err)\n      }\n\n      const parsedFormData = parseWithDictionary(\n        options.formData,\n        Object.fromEntries(formData_unsafe.entries())\n      )\n\n      if (parsedFormData.issues) {\n        return await onFormDataValidationErrorResponse(parsedFormData.issues)\n      }\n\n      formData = parsedFormData.value\n    }\n\n    // Build safe route handler context\n    const ctx = {\n      id,\n      url,\n      ...(authOrResponse ? { auth: authOrResponse } : {}),\n      ...(segments ? { segments } : {}),\n      ...(searchParams ? { searchParams } : {}),\n      ...(body ? { body } : {}),\n      ...(formData ? { formData } : {}),\n    } as SafeRouteHandlerContext<\n      AC,\n      TRouteDynamicSegments,\n      TSearchParams,\n      TBody,\n      TFormData\n    >\n\n    // Let's catch any error that might happen in the handler\n    try {\n      const response = await handlerFn(ctx, req)\n\n      executionClock.stop()\n      log.info(\n        `✅ Route handler '${id}' executed successfully in ${executionClock.get()}`\n      )\n\n      return response\n    } catch (err) {\n      executionClock.stop()\n      log.error(\n        `🛑 Route handler '${id} failed to execute after ${executionClock.get()}'`\n      )\n\n      return await onErrorResponse(err)\n    }\n  }\n}\n"],"mappings":"AAAO,SAASA,EACdC,EACsC,CACtC,OACEA,IAAU,OACT,OAAOA,GAAU,UAAY,OAAOA,GAAU,aAE/C,OAAQA,EAAc,MAAS,UAEnC,CAEO,SAASC,EACdD,EACAE,EACoB,CACpB,GAAIH,EAAaC,CAAK,EACpB,MAAM,IAAI,MAAME,CAAO,CAE3B,CAEO,SAASC,EAAaC,EAAiB,GAAO,CACnD,IAAMC,EAAYD,GAAS,QAAQ,IAAI,WAAa,aACpD,MAAO,CACL,KAAM,CAACF,KAAoBI,IAA0B,CAC/CD,GACF,QAAQ,IAAIH,EAAS,GAAGI,CAAI,CAEhC,EACA,MAAO,CAACJ,KAAoBI,IAA0B,CAChDD,GACF,QAAQ,MAAMH,EAAS,GAAGI,CAAI,CAElC,EACA,KAAM,CAACJ,KAAoBI,IAA0B,CAC/CD,GACF,QAAQ,KAAKH,EAAS,GAAGI,CAAI,CAEjC,CACF,CACF,CAEO,SAASC,GAAuB,CACrC,IAAIC,EAA2B,KAC3BC,EAAyB,KAE7B,MAAO,CACL,MAAO,IAAY,CACjBD,EAAY,YAAY,IAAI,CAC9B,EACA,KAAM,IAAY,CAChB,GAAIA,IAAc,KAChB,MAAM,IAAI,MAAM,kCAAkC,EAEpDC,EAAU,YAAY,IAAI,CAC5B,EACA,IAAK,IAAc,CACjB,GAAI,CAACD,GAAa,CAACC,EACjB,MAAM,IAAI,MAAM,kDAAkD,EAIpE,MAAO,IADUA,EAAUD,GACR,QAAQ,CAAC,CAAC,IAC/B,CACF,CACF,CCSO,SAASE,EACdC,EACAC,EACAC,EAAa,gEACmD,CAChE,IAAMC,EAASH,EAAO,WAAW,EAAE,SAASC,CAAK,EACjD,OAAAG,EAAqBD,EAAQD,CAAU,EAEhCC,CACT,CAoBA,IAAME,EAAa,CACjBC,EACAC,IAEOA,KAAOD,EAGT,SAASE,EACdC,EACAR,EACsE,CACtE,IAAME,EAAkC,CAAC,EACnCO,EAAmC,CAAC,EAE1C,QAAWH,KAAOE,EAAY,CAC5B,GAAI,CAACJ,EAAWI,EAAYF,CAAG,EAC7B,SAGF,IAAMI,EAAaF,EAAWF,CAAG,EAAG,WAAW,EAAE,SAASN,EAAMM,CAAG,CAAC,EAOpE,GALAH,EACEO,EACA,uCAAuCJ,CAAG,sBAC5C,EAEII,EAAW,OAAQ,CACrBD,EAAO,KACL,GAAGC,EAAW,OAAO,IAAKC,IAAW,CACnC,GAAGA,EACH,KAAM,CAACL,EAAK,GAAIK,EAAM,MAAQ,CAAC,CAAE,CACnC,EAAE,CACJ,EACA,QACF,CACAT,EAAOI,CAAG,EAAII,EAAW,KAC3B,CAEA,OAAID,EAAO,OAAS,EACX,CAAE,OAAAA,CAAO,EAGX,CAAE,MAAOP,CAAgB,CAClC,CC5HO,IAAMU,EAAa,0BAQpBC,EAAwB,MAC5BC,GACqB,CAErB,GADoBA,EAAI,QAAQ,IAAI,cAAc,GACjC,WAAW,kBAAkB,EAC5C,OAAO,MAAMA,EAAI,KAAK,EAGxB,IAAMC,EAAO,MAAMD,EAAI,KAAK,EAC5B,OAAO,KAAK,MAAMC,CAAI,CACxB,EAsCO,SAASC,EAQdC,EAQAC,EAQwC,CAExC,GAAID,EAAQ,MAAQA,EAAQ,SAC1B,MAAM,IAAI,MACR,wGACF,EAGF,IAAME,EAAMC,EAAaH,EAAQ,KAAK,EAChCI,EAAKJ,EAAQ,IAAML,EAEnBU,EACJL,EAAQ,kBACNM,IACAJ,EAAI,MAAM,gDAAyCE,CAAE,IAAKE,CAAG,EACtD,IAAI,SAAS,wBAAyB,CAC3C,OAAQ,GACV,CAAC,IAGCC,EACJP,EAAQ,oCACNQ,IACAN,EAAI,MAAM,iDAA0CE,CAAE,KAAMI,CAAM,EAC3D,IAAI,SAAS,mBAAoB,CACtC,OAAQ,GACV,CAAC,IAGCC,EACJT,EAAQ,wCACNQ,IACAN,EAAI,MAAM,sDAA+CE,CAAE,KAAMI,CAAM,EAChE,IAAI,SAAS,wBAAyB,CAC3C,OAAQ,GACV,CAAC,IAGCE,EACJV,EAAQ,gCACNQ,IACAN,EAAI,MAAM,6CAAsCE,CAAE,KAAMI,CAAM,EACvD,IAAI,SAAS,eAAgB,CAClC,OAAQ,GACV,CAAC,IAGCG,EACJX,EAAQ,oCACNQ,IACAN,EAAI,MAAM,kDAA2CE,CAAE,KAAMI,CAAM,EAC5D,IAAI,SAAS,oBAAqB,CACvC,OAAQ,GACV,CAAC,IAGCI,EAAYZ,EAAQ,YAAc,SAAS,IAGjD,OAAO,eAAgBH,EAAWgB,EAA0C,CAC1E,IAAMC,EAAiBC,EAAqB,EAC5CD,EAAe,MAAM,EAErBZ,EAAI,KAAK,oCAA6BE,CAAE,GAAG,EAC3CF,EAAI,KAAK,8BAAgBL,EAAI,MAAM,IAAIA,EAAI,GAAG,EAAE,EAEhD,IAAMmB,EAAM,IAAI,IAAInB,EAAI,GAAG,EAGrBoB,EAAoBpB,EAAI,MAAM,EAC9BqB,EAAiB,MAAMN,EAAU,CAAE,IAAKK,EAAmB,IAAAD,CAAI,CAAC,EACtE,GAAIE,aAA0B,SAC5B,OAAAhB,EAAI,MAAM,uDAAgDE,CAAE,GAAG,EACxDc,EAGT,IAAIC,EACJ,GAAInB,EAAQ,SAAU,CACpB,IAAMoB,EAAS,MAAMP,EAAO,OAC5B,GAAIO,IAAW,OACb,OAAO,IAAI,SAAS,uBAAwB,CAAE,OAAQ,GAAI,CAAC,EAG7D,IAAMC,EAAiBC,EAAoBtB,EAAQ,SAAUoB,CAAM,EACnE,GAAIC,EAAe,OACjB,OAAO,MAAMd,EAAkCc,EAAe,MAAM,EAGtEF,EAAWE,EAAe,KAC5B,CAEA,IAAIE,EACJ,GAAIvB,EAAQ,aAAc,CACxB,IAAMwB,EAAqB,CAAC,GAAGR,EAAI,aAAa,KAAK,CAAC,EAAE,IAAKS,GAAM,CACjE,IAAMC,EAASV,EAAI,aAAa,OAAOS,CAAC,EACxC,MAAO,CAACA,EAAGC,EAAO,OAAS,EAAIA,EAASA,EAAO,CAAC,CAAC,CACnD,CAAC,EAEKC,EAAqBL,EACzBtB,EAAQ,aACR,OAAO,YAAYwB,CAAkB,CACvC,EAEA,GAAIG,EAAmB,OACrB,OAAO,MAAMlB,EACXkB,EAAmB,MACrB,EAGFJ,EAAeI,EAAmB,KACpC,CAGA,IAAMC,EAAoB/B,EAAI,MAAM,EAEhCgC,EACJ,GAAI7B,EAAQ,KAAM,CAChB,GAAI,CAAC,CAAC,OAAQ,MAAO,OAAO,EAAE,SAASH,EAAI,MAAM,EAC/C,OAAO,IAAI,SAAS,kCAAmC,CACrD,OAAQ,GACV,CAAC,EAGH,IAAIiC,EACJ,GAAI,CACFA,EAAc,MAAMlC,EAAsBgC,CAAiB,CAC7D,OAAStB,EAAK,CACZ,OAAO,MAAMD,EAAgBC,CAAG,CAClC,CAEA,IAAMyB,EAAaC,EACjBhC,EAAQ,KACR8B,EACA,6CACF,EAEA,GAAIC,EAAW,OACb,OAAO,MAAMrB,EAA8BqB,EAAW,MAAM,EAG9DF,EAAOE,EAAW,KACpB,CAEA,IAAIE,EACJ,GAAIjC,EAAQ,SAAU,CACpB,GAAI,CAAC,CAAC,OAAQ,MAAO,OAAO,EAAE,SAASH,EAAI,MAAM,EAC/C,OAAO,IAAI,SAAS,uCAAwC,CAC1D,OAAQ,GACV,CAAC,EAGH,IAAMqC,EAAcrC,EAAI,QAAQ,IAAI,cAAc,EAClD,GACE,CAACqC,GAAa,WAAW,qBAAqB,GAC9C,CAACA,GAAa,WAAW,mCAAmC,EAE5D,OAAO,IAAI,SAAS,6CAA8C,CAChE,OAAQ,GACV,CAAC,EAGH,IAAIC,EACJ,GAAI,CAEFA,EAAkB,MAAMP,EAAkB,SAAS,CACrD,OAAStB,EAAK,CACZ,OAAO,MAAMD,EAAgBC,CAAG,CAClC,CAEA,IAAM8B,EAAiBd,EACrBtB,EAAQ,SACR,OAAO,YAAYmC,EAAgB,QAAQ,CAAC,CAC9C,EAEA,GAAIC,EAAe,OACjB,OAAO,MAAMzB,EAAkCyB,EAAe,MAAM,EAGtEH,EAAWG,EAAe,KAC5B,CAGA,IAAMC,EAAM,CACV,GAAAjC,EACA,IAAAY,EACA,GAAIE,EAAiB,CAAE,KAAMA,CAAe,EAAI,CAAC,EACjD,GAAIC,EAAW,CAAE,SAAAA,CAAS,EAAI,CAAC,EAC/B,GAAII,EAAe,CAAE,aAAAA,CAAa,EAAI,CAAC,EACvC,GAAIM,EAAO,CAAE,KAAAA,CAAK,EAAI,CAAC,EACvB,GAAII,EAAW,CAAE,SAAAA,CAAS,EAAI,CAAC,CACjC,EASA,GAAI,CACF,IAAMK,EAAW,MAAMrC,EAAUoC,EAAKxC,CAAG,EAEzC,OAAAiB,EAAe,KAAK,EACpBZ,EAAI,KACF,yBAAoBE,CAAE,8BAA8BU,EAAe,IAAI,CAAC,EAC1E,EAEOwB,CACT,OAAShC,EAAK,CACZ,OAAAQ,EAAe,KAAK,EACpBZ,EAAI,MACF,4BAAqBE,CAAE,4BAA4BU,EAAe,IAAI,CAAC,GACzE,EAEO,MAAMT,EAAgBC,CAAG,CAClC,CACF,CACF","names":["isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime","validateWithSchema","schema","value","errSyncMsg","result","assertsSyncOperation","hasDictKey","obj","key","parseWithDictionary","dictionary","issues","propResult","issue","DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","extras","executionClock","createExecutionClock","url","clonedReq_forAuth","authOrResponse","segments","params","parsedSegments","parseWithDictionary","searchParams","queryParams_unsafe","k","values","parsedSearchParams","clonedReq_forBody","body","body_unsafe","parsedBody","validateWithSchema","formData","contentType","formData_unsafe","parsedFormData","ctx","response"]}
+{"version":3,"sources":["../src/utils.ts","../src/standard-schema.ts","../src/create-safe-route-handler.ts"],"sourcesContent":["export function isPromise<T>(\n  value: unknown\n): value is Promise<T> | PromiseLike<T> {\n  return (\n    value !== null &&\n    (typeof value === 'object' || typeof value === 'function') &&\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    typeof (value as any).then === 'function'\n  )\n}\n\nexport function assertsSyncOperation<T>(\n  value: T | Promise<T> | PromiseLike<T>,\n  message: string\n): asserts value is T {\n  if (isPromise<T>(value)) {\n    throw new Error(message)\n  }\n}\n\nexport function createLogger(debug: boolean = false) {\n  const shouldLog = debug || process.env.NODE_ENV !== 'production'\n  return {\n    info: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.log(message, ...rest)\n      }\n    },\n    error: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.error(message, ...rest)\n      }\n    },\n    warn: (message: string, ...rest: unknown[]): void => {\n      if (shouldLog) {\n        console.warn(message, ...rest)\n      }\n    },\n  }\n}\n\nexport function createExecutionClock() {\n  let startTime: number | null = null\n  let endTime: number | null = null\n\n  return {\n    start: (): void => {\n      startTime = performance.now()\n    },\n    stop: (): void => {\n      if (startTime === null) {\n        throw new Error('Execution clock was not started.')\n      }\n      endTime = performance.now()\n    },\n    get: (): string => {\n      if (!startTime || !endTime) {\n        throw new Error('Execution clock has not been started or stopped.')\n      }\n\n      const duration = endTime - startTime\n      return `${duration.toFixed(2)}ms`\n    },\n  }\n}\n","import { assertsSyncOperation } from './utils'\n\n/** The Standard Schema interface. */\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  /** The Standard Schema properties. */\n  readonly '~standard': StandardSchemaV1.Props<Input, Output>\n}\n\nexport declare namespace StandardSchemaV1 {\n  /** The Standard Schema properties interface. */\n  export interface Props<Input = unknown, Output = Input> {\n    /** The version number of the standard. */\n    readonly version: 1\n    /** The vendor name of the schema library. */\n    readonly vendor: string\n    /** Validates unknown input values. */\n    readonly validate: (\n      value: unknown\n    ) => Result<Output> | Promise<Result<Output>>\n    /** Inferred types associated with the schema. */\n    readonly types?: Types<Input, Output> | undefined\n  }\n\n  /** The result interface of the validate function. */\n  export type Result<Output> = SuccessResult<Output> | FailureResult\n\n  /** The result interface if validation succeeds. */\n  export interface SuccessResult<Output> {\n    /** The typed output value. */\n    readonly value: Output\n    /** The non-existent issues. */\n    readonly issues?: undefined\n  }\n\n  /** The result interface if validation fails. */\n  export interface FailureResult {\n    /** The issues of failed validation. */\n    readonly issues: ReadonlyArray<Issue>\n  }\n\n  /** The issue interface of the failure output. */\n  export interface Issue {\n    /** The error message of the issue. */\n    readonly message: string\n    /** The path of the issue, if any. */\n    readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined\n  }\n\n  /** The path segment interface of the issue. */\n  export interface PathSegment {\n    /** The key representing a path segment. */\n    readonly key: PropertyKey\n  }\n\n  /** The Standard Schema types interface. */\n  export interface Types<Input = unknown, Output = Input> {\n    /** The input type of the schema. */\n    readonly input: Input\n    /** The output type of the schema. */\n    readonly output: Output\n  }\n\n  /** Infers the input type of a Standard Schema. */\n  export type InferInput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema['~standard']['types']\n  >['input']\n\n  /** Infers the output type of a Standard Schema. */\n  export type InferOutput<Schema extends StandardSchemaV1> = NonNullable<\n    Schema['~standard']['types']\n  >['output']\n}\n\nexport function validateWithSchema<TSchema extends StandardSchemaV1>(\n  schema: TSchema,\n  value: unknown,\n  errSyncMsg = 'Validation must be synchronous but schema returned a Promise.'\n): StandardSchemaV1.Result<StandardSchemaV1.InferOutput<TSchema>> {\n  const result = schema['~standard'].validate(value)\n  assertsSyncOperation(result, errSyncMsg)\n\n  return result\n}\n\n// Thanks to `@t3-env/core` (👉🏻 https://github.com/t3-oss/t3-env/blob/main/packages/core/src/standard.ts)\n// for this awesome dictionary schema.\nexport type StandardSchemaDictionary<\n  Input = Record<string, unknown>,\n  Output extends Record<keyof Input, unknown> = Input,\n> = {\n  [K in keyof Input]-?: StandardSchemaV1<Input[K], Output[K]>\n}\n\nexport namespace StandardSchemaDictionary {\n  export type InferInput<T extends StandardSchemaDictionary> = {\n    [K in keyof T]: StandardSchemaV1.InferInput<T[K]>\n  }\n  export type InferOutput<T extends StandardSchemaDictionary> = {\n    [K in keyof T]: StandardSchemaV1.InferOutput<T[K]>\n  }\n}\n\nconst hasDictKey = <T extends object, K extends PropertyKey>(\n  obj: T,\n  key: K\n): obj is T & Record<typeof key, unknown> => {\n  return key in obj\n}\n\nexport function parseWithDictionary<TDict extends StandardSchemaDictionary>(\n  dictionary: TDict,\n  value: Record<string, unknown>\n): StandardSchemaV1.Result<StandardSchemaDictionary.InferOutput<TDict>> {\n  const result: Record<string, unknown> = {}\n  const issues: StandardSchemaV1.Issue[] = []\n\n  for (const key in dictionary) {\n    if (!hasDictKey(dictionary, key)) {\n      continue\n    }\n    // NOTE: safe to assert as we're ensuring just before key isn't undefined\n    const propResult = dictionary[key]!['~standard'].validate(value[key])\n\n    assertsSyncOperation(\n      propResult,\n      `Validation must be synchronous, but ${key} returned a Promise.`\n    )\n\n    if (propResult.issues) {\n      issues.push(\n        ...propResult.issues.map((issue) => ({\n          ...issue,\n          path: [key, ...(issue.path ?? [])],\n        }))\n      )\n      continue\n    }\n    result[key] = propResult.value\n  }\n\n  if (issues.length > 0) {\n    return { issues }\n  }\n\n  return { value: result as never }\n}\n","import { createLogger, createExecutionClock } from './utils'\nimport {\n  parseWithDictionary,\n  validateWithSchema,\n  type StandardSchemaV1,\n} from './standard-schema'\nimport type {\n  Awaitable,\n  AuthContext,\n  TSegmentsDict,\n  TSearchParamsDict,\n  TBodySchema,\n  TFormDataDict,\n  RequestExtras,\n  CreateSafeRouteHandlerOptions,\n  CreateSafeRouteHandlerReturnType,\n  SafeRouteHandler,\n  SafeRouteHandlerContext,\n} from './types'\n\n/** @internal exported for testing only */\nexport const DEFAULT_ID = '[unknown:route:handler]'\n\n/**\n * @internal\n *\n * Reads the request body as JSON.\n * If it fails, it calls the `onErrorResponse` callback.\n */\nconst readRequestBodyAsJson = async <TReq extends Request>(\n  req: TReq\n): Promise<unknown> => {\n  const contentType = req.headers.get('content-type')\n  if (contentType?.startsWith('application/json')) {\n    return await req.json()\n  }\n\n  const text = await req.text()\n  return JSON.parse(text)\n}\n\n/**\n * Creates a safe route handler with data validation and error handling\n * for Next.js (>= 14) API route handlers.\n *\n * @param options - Options to configure the route handler.\n * @param handlerFn - The route handler function.\n *\n * @returns A Next.js API route handler function.\n *\n * @example\n * ```ts\n * import { string } from 'decoders'\n *import { createSafeRouteHandler } from '@sugardarius/anzen'\n * import { auth } from '~/lib/auth'\n *\n * export const GET = createSafeRouteHandler(\n *  {\n *    id: 'my-safe-route-handler',\n *    authorize: async ({ req }) => {\n *      const session = await auth.getSession(req)\n *      if (!session) {\n *        return new Response(null, { status: 401 })\n *      }\n *\n *      return { user: session.user }\n *     },\n *     segments: {\n *       id: string,\n *     },\n *   },\n *   async ({ auth, segments, }, req): Promise<Response> => {\n *     return Response.json({ user: auth.user, segments }, { status: 200 })\n *   }\n *)\n * ```\n */\nexport function createSafeRouteHandler<\n  AC extends AuthContext | undefined = undefined,\n  TRouteDynamicSegments extends TSegmentsDict | undefined = undefined,\n  TSearchParams extends TSearchParamsDict | undefined = undefined,\n  TBody extends TBodySchema | undefined = undefined,\n  TFormData extends TFormDataDict | undefined = undefined,\n  TReq extends Request = Request,\n>(\n  options: CreateSafeRouteHandlerOptions<\n    AC,\n    TRouteDynamicSegments,\n    TSearchParams,\n    TBody,\n    TFormData\n  >,\n  handlerFn: SafeRouteHandler<\n    AC,\n    TRouteDynamicSegments,\n    TSearchParams,\n    TBody,\n    TFormData,\n    TReq\n  >\n): CreateSafeRouteHandlerReturnType<TReq> {\n  // NOTE: `body` and `formData` options are mutually exclusive 🎭\n  if (options.body && options.formData) {\n    throw new Error(\n      'You cannot use both `body` and `formData` in the same route handler. They are both mutually exclusive.'\n    )\n  }\n\n  const log = createLogger(options.debug)\n  const id = options.id ?? DEFAULT_ID\n\n  const onErrorResponse =\n    options.onErrorResponse ??\n    ((err: unknown): Awaitable<Response> => {\n      log.error(`🛑 Unexpected error in route handler '${id}'`, err)\n      return new Response('Internal server error', {\n        status: 500,\n      })\n    })\n\n  const onSegmentsValidationErrorResponse =\n    options.onSegmentsValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid segments for route handler '${id}':`, issues)\n      return new Response('Invalid segments', {\n        status: 400,\n      })\n    })\n\n  const onSearchParamsValidationErrorResponse =\n    options.onSearchParamsValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid search params for route handler '${id}':`, issues)\n      return new Response('Invalid search params', {\n        status: 400,\n      })\n    })\n\n  const onBodyValidationErrorResponse =\n    options.onBodyValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid body for route handler '${id}':`, issues)\n      return new Response('Invalid body', {\n        status: 400,\n      })\n    })\n\n  const onFormDataValidationErrorResponse =\n    options.onFormDataValidationErrorResponse ??\n    ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<Response> => {\n      log.error(`🛑 Invalid form data for route handler '${id}':`, issues)\n      return new Response('Invalid form data', {\n        status: 400,\n      })\n    })\n\n  const authorize = options.authorize ?? (async () => undefined)\n\n  // Next.js API Route handler declaration\n  return async function (req: TReq, extras: RequestExtras): Promise<Response> {\n    const executionClock = createExecutionClock()\n    executionClock.start()\n\n    log.info(`🔄 Running route handler '${id}'`)\n    log.info(`👉🏻 Request ${req.method} ${req.url}`)\n\n    const url = new URL(req.url)\n\n    // Do not mutate / consume the original request\n    // Due to `NextRequest` limitations as the req is cloned it's always a Request\n    const clonedReq_forAuth = req.clone() as TReq\n    const authOrResponse = await authorize({ url, req: clonedReq_forAuth })\n    if (authOrResponse instanceof Response) {\n      log.error(`🛑 Request not authorized for route handler '${id}'`)\n      return authOrResponse\n    }\n\n    let segments = undefined\n    if (options.segments) {\n      const params = await extras.params\n      if (params === undefined) {\n        return new Response('No segments provided', { status: 400 })\n      }\n\n      const parsedSegments = parseWithDictionary(options.segments, params)\n      if (parsedSegments.issues) {\n        return await onSegmentsValidationErrorResponse(parsedSegments.issues)\n      }\n\n      segments = parsedSegments.value\n    }\n\n    let searchParams = undefined\n    if (options.searchParams) {\n      const queryParams_unsafe = [...url.searchParams.keys()].map((k) => {\n        const values = url.searchParams.getAll(k)\n        return [k, values.length > 1 ? values : values[0]]\n      })\n\n      const parsedSearchParams = parseWithDictionary(\n        options.searchParams,\n        Object.fromEntries(queryParams_unsafe)\n      )\n\n      if (parsedSearchParams.issues) {\n        return await onSearchParamsValidationErrorResponse(\n          parsedSearchParams.issues\n        )\n      }\n\n      searchParams = parsedSearchParams.value\n    }\n\n    // Do not mutate / consume the original request\n    const clonedReq_forBody = req.clone() as TReq\n\n    let body = undefined\n    if (options.body) {\n      if (!['POST', 'PUT', 'PATCH'].includes(req.method)) {\n        return new Response('Invalid method for request body', {\n          status: 405,\n        })\n      }\n\n      let body_unsafe: unknown\n      try {\n        body_unsafe = await readRequestBodyAsJson(clonedReq_forBody)\n      } catch (err) {\n        return await onErrorResponse(err)\n      }\n\n      const parsedBody = validateWithSchema(\n        options.body,\n        body_unsafe,\n        'Request body validation must be synchronous'\n      )\n\n      if (parsedBody.issues) {\n        return await onBodyValidationErrorResponse(parsedBody.issues)\n      }\n\n      body = parsedBody.value\n    }\n\n    let formData = undefined\n    if (options.formData) {\n      if (!['POST', 'PUT', 'PATCH'].includes(req.method)) {\n        return new Response('Invalid method for request form data', {\n          status: 405,\n        })\n      }\n\n      const contentType = req.headers.get('content-type')\n      if (\n        !contentType?.startsWith('multipart/form-data') &&\n        !contentType?.startsWith('application/x-www-form-urlencoded')\n      ) {\n        return new Response('Invalid content type for request form data', {\n          status: 415,\n        })\n      }\n\n      let formData_unsafe: FormData\n      try {\n        // NOTE: 🤔 maybe find a better way to counter the deprecation warning?\n        formData_unsafe = await clonedReq_forBody.formData()\n      } catch (err) {\n        return await onErrorResponse(err)\n      }\n\n      const parsedFormData = parseWithDictionary(\n        options.formData,\n        Object.fromEntries(formData_unsafe.entries())\n      )\n\n      if (parsedFormData.issues) {\n        return await onFormDataValidationErrorResponse(parsedFormData.issues)\n      }\n\n      formData = parsedFormData.value\n    }\n\n    // Build safe route handler context\n    const ctx = {\n      id,\n      url,\n      ...(authOrResponse ? { auth: authOrResponse } : {}),\n      ...(segments ? { segments } : {}),\n      ...(searchParams ? { searchParams } : {}),\n      ...(body ? { body } : {}),\n      ...(formData ? { formData } : {}),\n    } as SafeRouteHandlerContext<\n      AC,\n      TRouteDynamicSegments,\n      TSearchParams,\n      TBody,\n      TFormData\n    >\n\n    // Let's catch any error that might happen in the handler\n    try {\n      const response = await handlerFn(ctx, req)\n\n      executionClock.stop()\n      log.info(\n        `✅ Route handler '${id}' executed successfully in ${executionClock.get()}`\n      )\n\n      return response\n    } catch (err) {\n      executionClock.stop()\n      log.error(\n        `🛑 Route handler '${id} failed to execute after ${executionClock.get()}'`\n      )\n\n      return await onErrorResponse(err)\n    }\n  }\n}\n"],"mappings":"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","names":["isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime","validateWithSchema","schema","value","errSyncMsg","result","assertsSyncOperation","hasDictKey","obj","key","parseWithDictionary","dictionary","issues","propResult","issue","DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","extras","executionClock","createExecutionClock","url","clonedReq_forAuth","authOrResponse","segments","params","parsedSegments","parseWithDictionary","searchParams","queryParams_unsafe","k","values","parsedSearchParams","clonedReq_forBody","body","body_unsafe","parsedBody","validateWithSchema","formData","contentType","formData_unsafe","parsedFormData","ctx","response"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sugardarius/anzen",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "A fast, framework validation agnostic, type-safe factory for creating Next.JS App Router route handlers.",
   "license": "MIT",
   "packageManager": "npm@11.3.0",
@@ -63,23 +63,24 @@
     "release": "release-it"
   },
   "peerDependencies": {
-    "next": "^14 || ^15",
+    "next": "^16 || ^15 || ^14",
     "typescript": "^5"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
-    "@eslint/js": "^9.31.0",
+    "@eslint/js": "^9.38.0",
     "@release-it/keep-a-changelog": "^7.0.0",
-    "@types/node": "^24.0.14",
-    "eslint": "^9.31.0",
+    "@types/node": "^24.9.1",
+    "decoders": "^2.7.5",
+    "eslint": "^9.38.0",
     "prettier": "^3.6.2",
-    "publint": "^0.3.12",
-    "release-it": "^19.0.4",
+    "publint": "^0.3.15",
+    "release-it": "^19.0.5",
     "tsup": "^8.5.0",
-    "turbo": "^2.5.4",
-    "typescript": "^5.8.3",
-    "typescript-eslint": "^8.37.0",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2",
     "vitest": "^3.2.4",
-    "zod": "^4.0.5"
+    "zod": "^4.1.12"
   }
 }