@sugardarius/anzen 2.2.0 → 2.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/dist/chunk-LYFK3PWU.cjs +2 -0
- package/dist/chunk-LYFK3PWU.cjs.map +1 -0
- package/dist/chunk-WEUMYDOP.js +2 -0
- package/dist/chunk-WEUMYDOP.js.map +1 -0
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/server-components/index.cjs +1 -1
- package/dist/server-components/index.cjs.map +1 -1
- package/dist/server-components/index.d.cts +1 -1
- package/dist/server-components/index.d.ts +1 -1
- package/dist/server-components/index.js +1 -1
- package/dist/server-components/index.js.map +1 -1
- package/dist/{types-LPIIICMI.d.cts → types-D-blrRCr.d.cts} +3 -3
- package/dist/{types-LPIIICMI.d.ts → types-D-blrRCr.d.ts} +3 -3
- package/package.json +11 -11
- package/dist/chunk-O6UW3BSE.cjs +0 -2
- package/dist/chunk-O6UW3BSE.cjs.map +0 -1
- package/dist/chunk-Y6TQQ4BK.js +0 -2
- package/dist/chunk-Y6TQQ4BK.js.map +0 -1
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@ Fast, flexible, framework validation agnostic, type‑safe factories for creatin
|
|
|
8
8
|
- 🧠 Focused functionalities, use only features you want.
|
|
9
9
|
- 🧹 Clean and flexible API.
|
|
10
10
|
- 🔒 Type-safe.
|
|
11
|
-
- 🌱 Dependency free. Only [Next.js](https://nextjs.org/)
|
|
11
|
+
- 🌱 Dependency free. Only [Next.js](https://nextjs.org/) is required as peer dependency.
|
|
12
12
|
- 🪶 Lightweight. Less than 140kB unpacked.
|
|
13
13
|
|
|
14
14
|
## Install
|
|
@@ -239,7 +239,7 @@ Feel free to open an issue or a PR if you think a relevant option could be added
|
|
|
239
239
|
|
|
240
240
|
## Requirements
|
|
241
241
|
|
|
242
|
-
The factories require Next.js `v14`, `v15
|
|
242
|
+
The factories require Next.js `v14`, or `v15`, or `v16` as peer dependency.
|
|
243
243
|
|
|
244
244
|
## Contributing
|
|
245
245
|
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }function i(t,e){return e in t}function d(t){return t!==null&&(typeof t=="object"||typeof t=="function")&&typeof t.then=="function"}function u(t,e){if(d(t))throw new Error(e)}function l(t=!1){let e=t||process.env.NODE_ENV!=="production";return{info:(r,...n)=>{e&&console.log(r,...n)},error:(r,...n)=>{e&&console.error(r,...n)},warn:(r,...n)=>{e&&console.warn(r,...n)}}}function y(){let t=null,e=null;return{start:()=>{t=performance.now()},stop:()=>{if(t===null)throw new Error("Execution clock was not started.");e=performance.now()},get:()=>{if(!t||!e)throw new Error("Execution clock has not been started or stopped.");return`${(e-t).toFixed(2)}ms`}}}var p=t=>typeof t!="object"||t===null||!("digest"in t)||typeof t.digest!="string"?!1:t.digest.startsWith("NEXT_REDIRECT;"),c=t=>{if(typeof t!="object"||t===null||!("digest"in t)||typeof t.digest!="string")return!1;let e=t.digest;return e.endsWith(";404")||e.endsWith(";403")||e.endsWith(";401")};function f(t){return p(t)||c(t)}function h(t,e,r="Validation must be synchronous but schema returned a Promise."){let n=t["~standard"].validate(e);return u(n,r),n}function x(t,e){let r={},n=[];for(let o in t){if(!i(t,o))continue;let a=t[o]["~standard"].validate(e[o]);if(u(a,`Validation must be synchronous, but ${o} returned a Promise.`),a.issues){n.push(...a.issues.map(s=>({...s,path:[o,..._nullishCoalesce(s.path, () => ([]))]})));continue}r[o]=a.value}return n.length>0?{issues:n}:{value:r}}exports.a = l; exports.b = y; exports.c = f; exports.d = h; exports.e = x;
|
|
2
|
+
//# sourceMappingURL=chunk-LYFK3PWU.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/utils.ts"],"names":["hasDictKey","obj","key","isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime"],"mappings":"AACO,sLAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACwC,CACxC,OAAOA,EAAAA,GAAOD,CAChB,CAGO,SAASE,CAAAA,CACdC,CAAAA,CACsC,CACtC,OACEA,CAAAA,GAAU,IAAA,EAAA,CACT,OAAOA,CAAAA,EAAU,QAAA,EAAY,OAAOA,CAAAA,EAAU,UAAA,CAAA,EAE/C,OAAQA,CAAAA,CAAc,IAAA,EAAS,UAEnC,CAGO,SAASC,CAAAA,CACdD,CAAAA,CACAE,CAAAA,CACoB,CACpB,EAAA,CAAIH,CAAAA,CAAaC,CAAK,CAAA,CACpB,MAAM,IAAI,KAAA,CAAME,CAAO,CAE3B,CAGO,SAASC,CAAAA,CAAaC,CAAAA,CAAiB,CAAA,CAAA,CAAO,CACnD,IAAMC,CAAAA,CAAYD,CAAAA,EAAS,OAAA,CAAQ,GAAA,CAAI,QAAA,GAAa,YAAA,CACpD,MAAO,CACL,IAAA,CAAM,CAACF,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAC/CD,CAAAA,EACF,OAAA,CAAQ,GAAA,CAAIH,CAAAA,CAAS,GAAGI,CAAI,CAEhC,CAAA,CACA,KAAA,CAAO,CAACJ,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAChDD,CAAAA,EACF,OAAA,CAAQ,KAAA,CAAMH,CAAAA,CAAS,GAAGI,CAAI,CAElC,CAAA,CACA,IAAA,CAAM,CAACJ,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAC/CD,CAAAA,EACF,OAAA,CAAQ,IAAA,CAAKH,CAAAA,CAAS,GAAGI,CAAI,CAEjC,CACF,CACF,CAGO,SAASC,CAAAA,CAAAA,CAAuB,CACrC,IAAIC,CAAAA,CAA2B,IAAA,CAC3BC,CAAAA,CAAyB,IAAA,CAE7B,MAAO,CACL,KAAA,CAAO,CAAA,CAAA,EAAY,CACjBD,CAAAA,CAAY,WAAA,CAAY,GAAA,CAAI,CAC9B,CAAA,CACA,IAAA,CAAM,CAAA,CAAA,EAAY,CAChB,EAAA,CAAIA,CAAAA,GAAc,IAAA,CAChB,MAAM,IAAI,KAAA,CAAM,kCAAkC,CAAA,CAEpDC,CAAAA,CAAU,WAAA,CAAY,GAAA,CAAI,CAC5B,CAAA,CACA,GAAA,CAAK,CAAA,CAAA,EAAc,CACjB,EAAA,CAAI,CAACD,CAAAA,EAAa,CAACC,CAAAA,CACjB,MAAM,IAAI,KAAA,CAAM,kDAAkD,CAAA,CAIpE,MAAO,CAAA,EAAA","file":"/home/runner/work/anzen/anzen/dist/chunk-LYFK3PWU.cjs","sourcesContent":["/** @internal */\nexport function 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\n/** @internal */\nexport 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\n/** @internal */\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\n/** @internal */\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\n/** @internal */\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\n/**\n * @internal\n * Checks if an error is a Next.js redirect error.\n */\nconst isNextRedirectError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n return error.digest.startsWith('NEXT_REDIRECT;')\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js HTTP error (notFound, forbidden, unauthorized).\n */\nconst isNextHttpError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n const digest = error.digest\n // Check for notFound (;404), forbidden (;403), or unauthorized (;401)\n return (\n digest.endsWith(';404') ||\n digest.endsWith(';403') ||\n digest.endsWith(';401')\n )\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js native error that should not be logged.\n */\nexport function isNextNativeError(error: unknown): boolean {\n return isNextRedirectError(error) || isNextHttpError(error)\n}\n"]}
|
|
@@ -0,0 +1,2 @@
|
|
|
1
|
+
function i(t,e){return e in t}function d(t){return t!==null&&(typeof t=="object"||typeof t=="function")&&typeof t.then=="function"}function u(t,e){if(d(t))throw new Error(e)}function l(t=!1){let e=t||process.env.NODE_ENV!=="production";return{info:(r,...n)=>{e&&console.log(r,...n)},error:(r,...n)=>{e&&console.error(r,...n)},warn:(r,...n)=>{e&&console.warn(r,...n)}}}function y(){let t=null,e=null;return{start:()=>{t=performance.now()},stop:()=>{if(t===null)throw new Error("Execution clock was not started.");e=performance.now()},get:()=>{if(!t||!e)throw new Error("Execution clock has not been started or stopped.");return`${(e-t).toFixed(2)}ms`}}}var p=t=>typeof t!="object"||t===null||!("digest"in t)||typeof t.digest!="string"?!1:t.digest.startsWith("NEXT_REDIRECT;"),c=t=>{if(typeof t!="object"||t===null||!("digest"in t)||typeof t.digest!="string")return!1;let e=t.digest;return e.endsWith(";404")||e.endsWith(";403")||e.endsWith(";401")};function f(t){return p(t)||c(t)}function h(t,e,r="Validation must be synchronous but schema returned a Promise."){let n=t["~standard"].validate(e);return u(n,r),n}function x(t,e){let r={},n=[];for(let o in t){if(!i(t,o))continue;let a=t[o]["~standard"].validate(e[o]);if(u(a,`Validation must be synchronous, but ${o} returned a Promise.`),a.issues){n.push(...a.issues.map(s=>({...s,path:[o,...s.path??[]]})));continue}r[o]=a.value}return n.length>0?{issues:n}:{value:r}}export{l as a,y as b,f as c,h as d,x as e};
|
|
2
|
+
//# sourceMappingURL=chunk-WEUMYDOP.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/utils.ts","../src/standard-schema.ts"],"sourcesContent":["/** @internal */\nexport function 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\n/** @internal */\nexport 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\n/** @internal */\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\n/** @internal */\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\n/** @internal */\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\n/**\n * @internal\n * Checks if an error is a Next.js redirect error.\n */\nconst isNextRedirectError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n return error.digest.startsWith('NEXT_REDIRECT;')\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js HTTP error (notFound, forbidden, unauthorized).\n */\nconst isNextHttpError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n const digest = error.digest\n // Check for notFound (;404), forbidden (;403), or unauthorized (;401)\n return (\n digest.endsWith(';404') ||\n digest.endsWith(';403') ||\n digest.endsWith(';401')\n )\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js native error that should not be logged.\n */\nexport function isNextNativeError(error: unknown): boolean {\n return isNextRedirectError(error) || isNextHttpError(error)\n}\n","import { assertsSyncOperation, hasDictKey } 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\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"],"mappings":"AACO,SAASA,EACdC,EACAC,EACwC,CACxC,OAAOA,KAAOD,CAChB,CAGO,SAASE,EACdC,EACsC,CACtC,OACEA,IAAU,OACT,OAAOA,GAAU,UAAY,OAAOA,GAAU,aAE/C,OAAQA,EAAc,MAAS,UAEnC,CAGO,SAASC,EACdD,EACAE,EACoB,CACpB,GAAIH,EAAaC,CAAK,EACpB,MAAM,IAAI,MAAME,CAAO,CAE3B,CAGO,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,CAGO,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,CAMA,IAAME,EAAuBC,GAEzB,OAAOA,GAAU,UACjBA,IAAU,MACV,EAAE,WAAYA,IACd,OAAOA,EAAM,QAAW,SAEjB,GAEFA,EAAM,OAAO,WAAW,gBAAgB,EAO3CC,EAAmBD,GAA4B,CACnD,GACE,OAAOA,GAAU,UACjBA,IAAU,MACV,EAAE,WAAYA,IACd,OAAOA,EAAM,QAAW,SAExB,MAAO,GAET,IAAME,EAASF,EAAM,OAErB,OACEE,EAAO,SAAS,MAAM,GACtBA,EAAO,SAAS,MAAM,GACtBA,EAAO,SAAS,MAAM,CAE1B,EAMO,SAASC,EAAkBH,EAAyB,CACzD,OAAOD,EAAoBC,CAAK,GAAKC,EAAgBD,CAAK,CAC5D,CCjDO,SAASI,EACdC,EACAC,EACAC,EAAa,gEACmD,CAChE,IAAMC,EAASH,EAAO,WAAW,EAAE,SAASC,CAAK,EACjD,OAAAG,EAAqBD,EAAQD,CAAU,EAEhCC,CACT,CAoBO,SAASE,EACdC,EACAL,EACsE,CACtE,IAAME,EAAkC,CAAC,EACnCI,EAAmC,CAAC,EAE1C,QAAWC,KAAOF,EAAY,CAC5B,GAAI,CAACG,EAAWH,EAAYE,CAAG,EAC7B,SAGF,IAAME,EAAaJ,EAAWE,CAAG,EAAG,WAAW,EAAE,SAASP,EAAMO,CAAG,CAAC,EAOpE,GALAJ,EACEM,EACA,uCAAuCF,CAAG,sBAC5C,EAEIE,EAAW,OAAQ,CACrBH,EAAO,KACL,GAAGG,EAAW,OAAO,IAAKC,IAAW,CACnC,GAAGA,EACH,KAAM,CAACH,EAAK,GAAIG,EAAM,MAAQ,CAAC,CAAE,CACnC,EAAE,CACJ,EACA,QACF,CACAR,EAAOK,CAAG,EAAIE,EAAW,KAC3B,CAEA,OAAIH,EAAO,OAAS,EACX,CAAE,OAAAA,CAAO,EAGX,CAAE,MAAOJ,CAAgB,CAClC","names":["hasDictKey","obj","key","isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime","isNextRedirectError","error","isNextHttpError","digest","isNextNativeError","validateWithSchema","schema","value","errSyncMsg","result","assertsSyncOperation","parseWithDictionary","dictionary","issues","key","hasDictKey","propResult","issue"]}
|
package/dist/index.cjs
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
"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; }var
|
|
1
|
+
"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; }var _chunkLYFK3PWUcjs = require('./chunk-LYFK3PWU.cjs');var H="[unknown:route:handler]",B=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 n=await e.text();return JSON.parse(n)};function V(e,p){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 n=_chunkLYFK3PWUcjs.a.call(void 0, e.debug),o=_nullishCoalesce(e.id, () => (H)),y=_nullishCoalesce(e.onErrorResponse, () => ((t=>(n.error(`\u{1F6D1} Unexpected error in route handler '${o}'`,t),new Response("Internal server error",{status:500}))))),P=_nullishCoalesce(e.onSegmentsValidationErrorResponse, () => ((t=>(n.error(`\u{1F6D1} Invalid segments for route handler '${o}':`,t),new Response("Invalid segments",{status:400}))))),g=_nullishCoalesce(e.onSearchParamsValidationErrorResponse, () => ((t=>(n.error(`\u{1F6D1} Invalid search params for route handler '${o}':`,t),new Response("Invalid search params",{status:400}))))),v=_nullishCoalesce(e.onBodyValidationErrorResponse, () => ((t=>(n.error(`\u{1F6D1} Invalid body for route handler '${o}':`,t),new Response("Invalid body",{status:400}))))),A=_nullishCoalesce(e.onFormDataValidationErrorResponse, () => ((t=>(n.error(`\u{1F6D1} Invalid form data for route handler '${o}':`,t),new Response("Invalid form data",{status:400}))))),b=_nullishCoalesce(e.authorize, () => ((async()=>{})));return async function(t,C){let d=_chunkLYFK3PWUcjs.b.call(void 0, );d.start(),n.info(`\u{1F504} Running route handler '${o}'`),n.info(`\u{1F449}\u{1F3FB} Request ${t.method} ${t.url}`);let f=new URL(t.url),u;if(e.segments){let a=await C.params;if(a===void 0)return new Response("No segments provided",{status:400});let r=_chunkLYFK3PWUcjs.e.call(void 0, e.segments,a);if(r.issues)return await P(r.issues);u=r.value}let i;if(e.searchParams){let a=[...f.searchParams.keys()].map(s=>{let l=f.searchParams.getAll(s);return[s,l.length>1?l:l[0]]}),r=_chunkLYFK3PWUcjs.e.call(void 0, e.searchParams,Object.fromEntries(a));if(r.issues)return await g(r.issues);i=r.value}let S=t.clone(),c;if(e.body){if(!["POST","PUT","PATCH"].includes(t.method))return new Response("Invalid method for request body",{status:405});let a;try{a=await B(S)}catch(s){return await y(s)}let r=_chunkLYFK3PWUcjs.d.call(void 0, e.body,a,"Request body validation must be synchronous");if(r.issues)return await v(r.issues);c=r.value}let m;if(e.formData){if(!["POST","PUT","PATCH"].includes(t.method))return new Response("Invalid method for request form data",{status:405});let a=t.headers.get("content-type");if(!_optionalChain([a, 'optionalAccess', _6 => _6.startsWith, 'call', _7 => _7("multipart/form-data")])&&!_optionalChain([a, '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 r;try{r=await S.formData()}catch(l){return await y(l)}let s=_chunkLYFK3PWUcjs.e.call(void 0, e.formData,Object.fromEntries(r.entries()));if(s.issues)return await A(s.issues);m=s.value}let I=t.clone(),E={id:o,url:f,req:I,...u?{segments:u}:{},...i?{searchParams:i}:{},...c?{body:c}:{},...m?{formData:m}:{}},h=await b(E);if(h instanceof Response)return n.error(`\u{1F6D1} Request not authorized for route handler '${o}'`),h;let F={id:o,url:f,...h?{auth:h}:{},...u?{segments:u}:{},...i?{searchParams:i}:{},...c?{body:c}:{},...m?{formData:m}:{}};try{let a=await p(F,t);return d.stop(),n.info(`\u2705 Route handler '${o}' executed successfully in ${d.get()}`),a}catch(a){if(d.stop(),_chunkLYFK3PWUcjs.c.call(void 0, a))throw n.info("\u2139\uFE0F Ignoring native Next.js error"),a;return n.error(`\u{1F6D1} Route handler '${o} failed to execute after ${d.get()}'`),await y(a)}}}exports.createSafeRouteHandler = V;
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/home/runner/work/anzen/anzen/dist/index.cjs","../src/create-safe-route-handler.ts"],"names":["DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","providedContext","executionClock","createExecutionClock"],"mappings":"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","file":"/home/runner/work/anzen/anzen/dist/index.cjs","sourcesContent":[null,"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 ProvidedRouteContext,\n CreateSafeRouteHandlerOptions,\n CreateSafeRouteHandlerReturnType,\n SafeRouteHandler,\n SafeRouteHandlerContext,\n AuthFunctionParams,\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 (\n req: TReq,\n providedContext: ProvidedRouteContext\n ): 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 let segments = undefined\n if (options.segments) {\n const params = await providedContext.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 // 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()\n const authParams = {\n id,\n url,\n req: clonedReq_forAuth,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n ...(body ? { body } : {}),\n ...(formData ? { formData } : {}),\n } as AuthFunctionParams<\n TRouteDynamicSegments,\n TSearchParams,\n TBody,\n TFormData\n >\n const authOrResponse = await authorize(authParams)\n if (authOrResponse instanceof Response) {\n log.error(`🛑 Request not authorized for route handler '${id}'`)\n return authOrResponse\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"]}
|
|
1
|
+
{"version":3,"sources":["/home/runner/work/anzen/anzen/dist/index.cjs","../src/create-safe-route-handler.ts"],"names":["DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","providedContext","executionClock","createExecutionClock"],"mappings":"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","file":"/home/runner/work/anzen/anzen/dist/index.cjs","sourcesContent":[null,"import { createLogger, createExecutionClock, isNextNativeError } 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 ProvidedRouteContext,\n CreateSafeRouteHandlerOptions,\n CreateSafeRouteHandlerReturnType,\n SafeRouteHandler,\n SafeRouteHandlerContext,\n AuthFunctionParams,\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 (\n req: TReq,\n providedContext: ProvidedRouteContext\n ): 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 let segments = undefined\n if (options.segments) {\n const params = await providedContext.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 // 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()\n const authParams = {\n id,\n url,\n req: clonedReq_forAuth,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n ...(body ? { body } : {}),\n ...(formData ? { formData } : {}),\n } as AuthFunctionParams<\n TRouteDynamicSegments,\n TSearchParams,\n TBody,\n TFormData\n >\n const authOrResponse = await authorize(authParams)\n if (authOrResponse instanceof Response) {\n log.error(`🛑 Request not authorized for route handler '${id}'`)\n return authOrResponse\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\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Route handler '${id} failed to execute after ${executionClock.get()}'`\n )\n return await onErrorResponse(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { A as AuthContext, T as TSegmentsDict, a as TSearchParamsDict, b as TBodySchema, c as TFormDataDict, C as CreateSafeRouteHandlerOptions, S as SafeRouteHandler, d as CreateSafeRouteHandlerReturnType } from './types-
|
|
2
|
-
export {
|
|
1
|
+
import { A as AuthContext, T as TSegmentsDict, a as TSearchParamsDict, b as TBodySchema, c as TFormDataDict, C as CreateSafeRouteHandlerOptions, S as SafeRouteHandler, d as CreateSafeRouteHandlerReturnType } from './types-D-blrRCr.cjs';
|
|
2
|
+
export { e as AuthFunction, f as AuthFunctionParams, g as Awaitable, B as BaseOptions, O as OnValidationErrorResponse, P as ProvidedRouteContext, h as SafeRouteHandlerContext } from './types-D-blrRCr.cjs';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* Creates a safe route handler with data validation and error handling
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { A as AuthContext, T as TSegmentsDict, a as TSearchParamsDict, b as TBodySchema, c as TFormDataDict, C as CreateSafeRouteHandlerOptions, S as SafeRouteHandler, d as CreateSafeRouteHandlerReturnType } from './types-
|
|
2
|
-
export {
|
|
1
|
+
import { A as AuthContext, T as TSegmentsDict, a as TSearchParamsDict, b as TBodySchema, c as TFormDataDict, C as CreateSafeRouteHandlerOptions, S as SafeRouteHandler, d as CreateSafeRouteHandlerReturnType } from './types-D-blrRCr.js';
|
|
2
|
+
export { e as AuthFunction, f as AuthFunctionParams, g as Awaitable, B as BaseOptions, O as OnValidationErrorResponse, P as ProvidedRouteContext, h as SafeRouteHandlerContext } from './types-D-blrRCr.js';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* Creates a safe route handler with data validation and error handling
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{a as T,b as w,c as D,d as R}from"./chunk-
|
|
1
|
+
import{a as T,b as w,c as D,d as x,e as R}from"./chunk-WEUMYDOP.js";var H="[unknown:route:handler]",B=async e=>{if(e.headers.get("content-type")?.startsWith("application/json"))return await e.json();let n=await e.text();return JSON.parse(n)};function V(e,p){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 n=T(e.debug),o=e.id??H,y=e.onErrorResponse??(t=>(n.error(`\u{1F6D1} Unexpected error in route handler '${o}'`,t),new Response("Internal server error",{status:500}))),P=e.onSegmentsValidationErrorResponse??(t=>(n.error(`\u{1F6D1} Invalid segments for route handler '${o}':`,t),new Response("Invalid segments",{status:400}))),g=e.onSearchParamsValidationErrorResponse??(t=>(n.error(`\u{1F6D1} Invalid search params for route handler '${o}':`,t),new Response("Invalid search params",{status:400}))),v=e.onBodyValidationErrorResponse??(t=>(n.error(`\u{1F6D1} Invalid body for route handler '${o}':`,t),new Response("Invalid body",{status:400}))),A=e.onFormDataValidationErrorResponse??(t=>(n.error(`\u{1F6D1} Invalid form data for route handler '${o}':`,t),new Response("Invalid form data",{status:400}))),b=e.authorize??(async()=>{});return async function(t,C){let d=w();d.start(),n.info(`\u{1F504} Running route handler '${o}'`),n.info(`\u{1F449}\u{1F3FB} Request ${t.method} ${t.url}`);let f=new URL(t.url),u;if(e.segments){let a=await C.params;if(a===void 0)return new Response("No segments provided",{status:400});let r=R(e.segments,a);if(r.issues)return await P(r.issues);u=r.value}let i;if(e.searchParams){let a=[...f.searchParams.keys()].map(s=>{let l=f.searchParams.getAll(s);return[s,l.length>1?l:l[0]]}),r=R(e.searchParams,Object.fromEntries(a));if(r.issues)return await g(r.issues);i=r.value}let S=t.clone(),c;if(e.body){if(!["POST","PUT","PATCH"].includes(t.method))return new Response("Invalid method for request body",{status:405});let a;try{a=await B(S)}catch(s){return await y(s)}let r=x(e.body,a,"Request body validation must be synchronous");if(r.issues)return await v(r.issues);c=r.value}let m;if(e.formData){if(!["POST","PUT","PATCH"].includes(t.method))return new Response("Invalid method for request form data",{status:405});let a=t.headers.get("content-type");if(!a?.startsWith("multipart/form-data")&&!a?.startsWith("application/x-www-form-urlencoded"))return new Response("Invalid content type for request form data",{status:415});let r;try{r=await S.formData()}catch(l){return await y(l)}let s=R(e.formData,Object.fromEntries(r.entries()));if(s.issues)return await A(s.issues);m=s.value}let I=t.clone(),E={id:o,url:f,req:I,...u?{segments:u}:{},...i?{searchParams:i}:{},...c?{body:c}:{},...m?{formData:m}:{}},h=await b(E);if(h instanceof Response)return n.error(`\u{1F6D1} Request not authorized for route handler '${o}'`),h;let F={id:o,url:f,...h?{auth:h}:{},...u?{segments:u}:{},...i?{searchParams:i}:{},...c?{body:c}:{},...m?{formData:m}:{}};try{let a=await p(F,t);return d.stop(),n.info(`\u2705 Route handler '${o}' executed successfully in ${d.get()}`),a}catch(a){if(d.stop(),D(a))throw n.info("\u2139\uFE0F Ignoring native Next.js error"),a;return n.error(`\u{1F6D1} Route handler '${o} failed to execute after ${d.get()}'`),await y(a)}}}export{V as createSafeRouteHandler};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/create-safe-route-handler.ts"],"sourcesContent":["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 ProvidedRouteContext,\n CreateSafeRouteHandlerOptions,\n CreateSafeRouteHandlerReturnType,\n SafeRouteHandler,\n SafeRouteHandlerContext,\n AuthFunctionParams,\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 (\n req: TReq,\n providedContext: ProvidedRouteContext\n ): 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 let segments = undefined\n if (options.segments) {\n const params = await providedContext.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 // 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()\n const authParams = {\n id,\n url,\n req: clonedReq_forAuth,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n ...(body ? { body } : {}),\n ...(formData ? { formData } : {}),\n } as AuthFunctionParams<\n TRouteDynamicSegments,\n TSearchParams,\n TBody,\n TFormData\n >\n const authOrResponse = await authorize(authParams)\n if (authOrResponse instanceof Response) {\n log.error(`🛑 Request not authorized for route handler '${id}'`)\n return authOrResponse\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":["DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","providedContext","executionClock","createExecutionClock","url","segments","params","parsedSegments","parseWithDictionary","searchParams","queryParams_unsafe","k","values","parsedSearchParams","clonedReq_forBody","body","body_unsafe","parsedBody","validateWithSchema","formData","contentType","formData_unsafe","parsedFormData","clonedReq_forAuth","authParams","authOrResponse","ctx","response"]}
|
|
1
|
+
{"version":3,"sources":["../src/create-safe-route-handler.ts"],"sourcesContent":["import { createLogger, createExecutionClock, isNextNativeError } 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 ProvidedRouteContext,\n CreateSafeRouteHandlerOptions,\n CreateSafeRouteHandlerReturnType,\n SafeRouteHandler,\n SafeRouteHandlerContext,\n AuthFunctionParams,\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 (\n req: TReq,\n providedContext: ProvidedRouteContext\n ): 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 let segments = undefined\n if (options.segments) {\n const params = await providedContext.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 // 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()\n const authParams = {\n id,\n url,\n req: clonedReq_forAuth,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n ...(body ? { body } : {}),\n ...(formData ? { formData } : {}),\n } as AuthFunctionParams<\n TRouteDynamicSegments,\n TSearchParams,\n TBody,\n TFormData\n >\n const authOrResponse = await authorize(authParams)\n if (authOrResponse instanceof Response) {\n log.error(`🛑 Request not authorized for route handler '${id}'`)\n return authOrResponse\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\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Route handler '${id} failed to execute after ${executionClock.get()}'`\n )\n return await onErrorResponse(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n"],"mappings":"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","names":["DEFAULT_ID","readRequestBodyAsJson","req","text","createSafeRouteHandler","options","handlerFn","log","createLogger","id","onErrorResponse","err","onSegmentsValidationErrorResponse","issues","onSearchParamsValidationErrorResponse","onBodyValidationErrorResponse","onFormDataValidationErrorResponse","authorize","providedContext","executionClock","createExecutionClock","url","segments","params","parsedSegments","parseWithDictionary","searchParams","queryParams_unsafe","k","values","parsedSearchParams","clonedReq_forBody","body","body_unsafe","parsedBody","validateWithSchema","formData","contentType","formData_unsafe","parsedFormData","clonedReq_forAuth","authParams","authOrResponse","ctx","response","isNextNativeError"]}
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }var
|
|
1
|
+
"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }var _chunkLYFK3PWUcjs = require('../chunk-LYFK3PWU.cjs');var p=class extends Error{constructor(o,t,e){super(`${o==="searchParams"?"Search params":"Segments"} validation error for ${e} server component '${t}`),this.name="ValidationError"}},g=class extends Error{constructor(o,t){super(`No segments provided for ${t} server component '${o}'`),this.name="NoSegmentsProvidedError"}},h=class extends Error{constructor(o,t){super(`No search params provided for ${t} server component '${o}'`),this.name="NoSearchParamsProvidedError"}},P=class extends Error{constructor(o,t){let e=t.map(f=>`'${f}'`).join(", ");super(`Missing slots [${e}] for layout server component '${o}'`),this.name="MissingLayoutSlotsError"}};var A="[unknown:page:server:component]";function $(r,o){let t=_chunkLYFK3PWUcjs.a.call(void 0, r.debug),e=_nullishCoalesce(r.id, () => (A)),f=_nullishCoalesce(r.onError, () => ((c=>{throw t.error(`\u{1F6D1} Unexpected error in page server component '${e}'`,c),c}))),C=_nullishCoalesce(r.onSegmentsValidationError, () => ((c=>{throw t.error(`\u{1F6D1} Invalid segments for page server component '${e}'`,c),new p("segments",e,"page")}))),y=_nullishCoalesce(r.onSearchParamsValidationError, () => ((c=>{throw t.error(`\u{1F6D1} Invalid search params for server component '${e}'`,c),new p("searchParams",e,"page")}))),d=_nullishCoalesce(r.authorize, () => ((async()=>{})));return async function(l){let m=_chunkLYFK3PWUcjs.b.call(void 0, );m.start(),t.info(`\u{1F504} Running page server component'${e}'`);let s;if(r.segments){let a=await l.params;if(a===void 0)throw new g(e,"page");let n=_chunkLYFK3PWUcjs.e.call(void 0, r.segments,a);n.issues?await C(n.issues):s=n.value}let i;if(r.searchParams){let a=await l.searchParams;if(a===void 0)throw new h(e,"page");let n=_chunkLYFK3PWUcjs.e.call(void 0, r.searchParams,a);n.issues?await y(n.issues):i=n.value}let S;try{let a={id:e,...s?{segments:s}:{},...i?{searchParams:i}:{}};S=await d(a)}catch(a){throw t.error(`\u{1F6D1} Page server component '${e}' not authorized`),a}try{let a={id:e,...S?{auth:S}:{},...s?{segments:s}:{},...i?{searchParams:i}:{}},n=await o(a);return m.stop(),t.info(`\u2705 Page server component '${e}' executed successfully in ${m.get()}`),n}catch(a){if(m.stop(),_chunkLYFK3PWUcjs.c.call(void 0, a))throw t.info("\u2139\uFE0F Ignoring native Next.js error"),a;return t.error(`\u{1F6D1} Page server component '${e}' failed to execute after ${m.get()}`),await f(a)}}}var E="[unknown:layout:server:component]";function D(r,o){let t=_chunkLYFK3PWUcjs.a.call(void 0, r.debug),e=_nullishCoalesce(r.id, () => (E)),f=_nullishCoalesce(r.onError, () => ((d=>{throw t.error(`\u{1F6D1} Unexpected error in layout server component '${e}'`,d),d}))),C=_nullishCoalesce(r.onSegmentsValidationError, () => ((d=>{throw t.error(`\u{1F6D1} Invalid segments for layout server component '${e}'`,d),new p("segments",e,"page")}))),y=_nullishCoalesce(r.authorize, () => ((async()=>{})));return async function({params:c,children:l,...m}){let s=_chunkLYFK3PWUcjs.b.call(void 0, );s.start(),t.info(`\u{1F504} Running layout server component'${e}'`);let i;if(r.segments){let n=await c;if(n===void 0)throw new g(e,"page");let u=_chunkLYFK3PWUcjs.e.call(void 0, r.segments,n);u.issues?await C(u.issues):i=u.value}let S;if(r.experimental_slots){let n=r.experimental_slots,u=[];for(let L of n)L in m||u.push(L);if(u.length>0)throw new P(e,u);S=m}let a;try{let n={id:e,...i?{segments:i}:{}};a=await y(n)}catch(n){throw t.error(`\u{1F6D1} Layout server component '${e}' not authorized`),n}try{let n={id:e,...a?{auth:a}:{},...i?{segments:i}:{},children:l,...S?{experimental_slots:S}:{}},u=await o(n);return s.stop(),t.info(`\u2705 Layout server component '${e}' executed successfully in ${s.get()}`),u}catch(n){if(s.stop(),_chunkLYFK3PWUcjs.c.call(void 0, n))throw t.info("\u2139\uFE0F Ignoring native Next.js error"),n;return t.error(`\u{1F6D1} Layout server component '${e}' failed to execute after ${s.get()}`),await f(n)}}}exports.createSafeLayoutServerComponent = D; exports.createSafePageServerComponent = $;
|
|
2
2
|
//# sourceMappingURL=index.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["/home/runner/work/anzen/anzen/dist/server-components/index.cjs","../../src/server-components/errors.ts"],"names":["ValidationError","validationType","id","serverComponentType"],"mappings":"AAAA,
|
|
1
|
+
{"version":3,"sources":["/home/runner/work/anzen/anzen/dist/server-components/index.cjs","../../src/server-components/errors.ts"],"names":["ValidationError","validationType","id","serverComponentType"],"mappings":"AAAA,sOAA8D,ICGjDA,CAAAA,CAAN,MAAA,QAA8B,KAAM,CACzC,WAAA,CACEC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACA,CACA,KAAA,CACE,CAAA,EAAA","file":"/home/runner/work/anzen/anzen/dist/server-components/index.cjs","sourcesContent":[null,"/**\n * Validation error for server components.\n */\nexport class ValidationError extends Error {\n constructor(\n validationType: 'segments' | 'searchParams',\n id: string,\n serverComponentType: 'page' | 'layout'\n ) {\n super(\n `${validationType === 'searchParams' ? 'Search params' : 'Segments'} validation error for ${serverComponentType} server component '${id}`\n )\n this.name = 'ValidationError'\n }\n}\n\n/**\n * No segments provided error for server components.\n */\nexport class NoSegmentsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No segments provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSegmentsProvidedError'\n }\n}\n\n/**\n * No search params provided error for server components.\n */\nexport class NoSearchParamsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No search params provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSearchParamsProvidedError'\n }\n}\n\n/**\n * Missing slots error for layout server components.\n */\nexport class MissingLayoutSlotsError extends Error {\n constructor(id: string, missingSlots: readonly string[]) {\n const slotsList = missingSlots.map((s) => `'${s}'`).join(', ')\n super(`Missing slots [${slotsList}] for layout server component '${id}'`)\n this.name = 'MissingLayoutSlotsError'\n }\n}\n"]}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as StandardSchemaDictionary, j as StandardSchemaV1,
|
|
1
|
+
import { i as StandardSchemaDictionary, g as Awaitable, j as StandardSchemaV1, A as AuthContext, U as UnwrapReadonlyObject, E as EmptyObjectType } from '../types-D-blrRCr.cjs';
|
|
2
2
|
|
|
3
3
|
type ArrayToUnion<T extends readonly (string | number)[]> = T[number];
|
|
4
4
|
type TSegmentsDict = StandardSchemaDictionary;
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { i as StandardSchemaDictionary, j as StandardSchemaV1,
|
|
1
|
+
import { i as StandardSchemaDictionary, g as Awaitable, j as StandardSchemaV1, A as AuthContext, U as UnwrapReadonlyObject, E as EmptyObjectType } from '../types-D-blrRCr.js';
|
|
2
2
|
|
|
3
3
|
type ArrayToUnion<T extends readonly (string | number)[]> = T[number];
|
|
4
4
|
type TSegmentsDict = StandardSchemaDictionary;
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{a as
|
|
1
|
+
import{a as x,b as w,c as T,e as v}from"../chunk-WEUMYDOP.js";var p=class extends Error{constructor(o,t,e){super(`${o==="searchParams"?"Search params":"Segments"} validation error for ${e} server component '${t}`),this.name="ValidationError"}},g=class extends Error{constructor(o,t){super(`No segments provided for ${t} server component '${o}'`),this.name="NoSegmentsProvidedError"}},h=class extends Error{constructor(o,t){super(`No search params provided for ${t} server component '${o}'`),this.name="NoSearchParamsProvidedError"}},P=class extends Error{constructor(o,t){let e=t.map(f=>`'${f}'`).join(", ");super(`Missing slots [${e}] for layout server component '${o}'`),this.name="MissingLayoutSlotsError"}};var A="[unknown:page:server:component]";function $(r,o){let t=x(r.debug),e=r.id??A,f=r.onError??(c=>{throw t.error(`\u{1F6D1} Unexpected error in page server component '${e}'`,c),c}),C=r.onSegmentsValidationError??(c=>{throw t.error(`\u{1F6D1} Invalid segments for page server component '${e}'`,c),new p("segments",e,"page")}),y=r.onSearchParamsValidationError??(c=>{throw t.error(`\u{1F6D1} Invalid search params for server component '${e}'`,c),new p("searchParams",e,"page")}),d=r.authorize??(async()=>{});return async function(l){let m=w();m.start(),t.info(`\u{1F504} Running page server component'${e}'`);let s;if(r.segments){let a=await l.params;if(a===void 0)throw new g(e,"page");let n=v(r.segments,a);n.issues?await C(n.issues):s=n.value}let i;if(r.searchParams){let a=await l.searchParams;if(a===void 0)throw new h(e,"page");let n=v(r.searchParams,a);n.issues?await y(n.issues):i=n.value}let S;try{let a={id:e,...s?{segments:s}:{},...i?{searchParams:i}:{}};S=await d(a)}catch(a){throw t.error(`\u{1F6D1} Page server component '${e}' not authorized`),a}try{let a={id:e,...S?{auth:S}:{},...s?{segments:s}:{},...i?{searchParams:i}:{}},n=await o(a);return m.stop(),t.info(`\u2705 Page server component '${e}' executed successfully in ${m.get()}`),n}catch(a){if(m.stop(),T(a))throw t.info("\u2139\uFE0F Ignoring native Next.js error"),a;return t.error(`\u{1F6D1} Page server component '${e}' failed to execute after ${m.get()}`),await f(a)}}}var E="[unknown:layout:server:component]";function D(r,o){let t=x(r.debug),e=r.id??E,f=r.onError??(d=>{throw t.error(`\u{1F6D1} Unexpected error in layout server component '${e}'`,d),d}),C=r.onSegmentsValidationError??(d=>{throw t.error(`\u{1F6D1} Invalid segments for layout server component '${e}'`,d),new p("segments",e,"page")}),y=r.authorize??(async()=>{});return async function({params:c,children:l,...m}){let s=w();s.start(),t.info(`\u{1F504} Running layout server component'${e}'`);let i;if(r.segments){let n=await c;if(n===void 0)throw new g(e,"page");let u=v(r.segments,n);u.issues?await C(u.issues):i=u.value}let S;if(r.experimental_slots){let n=r.experimental_slots,u=[];for(let L of n)L in m||u.push(L);if(u.length>0)throw new P(e,u);S=m}let a;try{let n={id:e,...i?{segments:i}:{}};a=await y(n)}catch(n){throw t.error(`\u{1F6D1} Layout server component '${e}' not authorized`),n}try{let n={id:e,...a?{auth:a}:{},...i?{segments:i}:{},children:l,...S?{experimental_slots:S}:{}},u=await o(n);return s.stop(),t.info(`\u2705 Layout server component '${e}' executed successfully in ${s.get()}`),u}catch(n){if(s.stop(),T(n))throw t.info("\u2139\uFE0F Ignoring native Next.js error"),n;return t.error(`\u{1F6D1} Layout server component '${e}' failed to execute after ${s.get()}`),await f(n)}}}export{D as createSafeLayoutServerComponent,$ as createSafePageServerComponent};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/server-components/errors.ts","../../src/server-components/create-safe-server-component.ts"],"sourcesContent":["/**\n * Validation error for server components.\n */\nexport class ValidationError extends Error {\n constructor(\n validationType: 'segments' | 'searchParams',\n id: string,\n serverComponentType: 'page' | 'layout'\n ) {\n super(\n `${validationType === 'searchParams' ? 'Search params' : 'Segments'} validation error for ${serverComponentType} server component '${id}`\n )\n this.name = 'ValidationError'\n }\n}\n\n/**\n * No segments provided error for server components.\n */\nexport class NoSegmentsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No segments provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSegmentsProvidedError'\n }\n}\n\n/**\n * No search params provided error for server components.\n */\nexport class NoSearchParamsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No search params provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSearchParamsProvidedError'\n }\n}\n\n/**\n * Missing slots error for layout server components.\n */\nexport class MissingLayoutSlotsError extends Error {\n constructor(id: string, missingSlots: readonly string[]) {\n const slotsList = missingSlots.map((s) => `'${s}'`).join(', ')\n super(`Missing slots [${slotsList}] for layout server component '${id}'`)\n this.name = 'MissingLayoutSlotsError'\n }\n}\n","import { createExecutionClock, createLogger } from '../utils'\nimport { parseWithDictionary, type StandardSchemaV1 } from '../standard-schema'\nimport type { Awaitable, AuthContext } from '../types'\nimport type {\n TSegmentsDict,\n TSearchParamsDict,\n PageAuthFunctionParams,\n PageProvidedProps,\n SafePageServerComponentContext,\n CreateSafePageServerComponentOptions,\n CreateSafePageServerComponentReturnType,\n SafePageServerComponent,\n CreateSafeLayoutServerComponentOptions,\n SafeLayoutServerComponent,\n CreateSafeLayoutServerComponentReturnType,\n LayoutProvidedProps,\n LayoutAuthFunctionParams,\n SafeLayoutServerComponentContext,\n} from './types'\nimport {\n ValidationError,\n NoSegmentsProvidedError,\n NoSearchParamsProvidedError,\n MissingLayoutSlotsError,\n} from './errors'\n\n/**\n * @internal\n * Checks if an error is a Next.js redirect error.\n */\nconst isNextRedirectError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n return error.digest.startsWith('NEXT_REDIRECT;')\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js HTTP error (notFound, forbidden, unauthorized).\n */\nconst isNextHttpError = (error: unknown): boolean => {\n if (\n typeof error !== 'object' ||\n error === null ||\n !('digest' in error) ||\n typeof error.digest !== 'string'\n ) {\n return false\n }\n const digest = error.digest\n // Check for notFound (;404), forbidden (;403), or unauthorized (;401)\n return (\n digest.endsWith(';404') ||\n digest.endsWith(';403') ||\n digest.endsWith(';401')\n )\n}\n\n/**\n * @internal\n * Checks if an error is a Next.js native error that should not be logged.\n */\nconst isNextNativeError = (error: unknown): boolean => {\n return isNextRedirectError(error) || isNextHttpError(error)\n}\n\n/** @internal exported for testing only */\nexport const DEFAULT_PAGE_ID = '[unknown:page:server:component]'\n\n/**\n * Creates a safe page server component with data validation and error handling\n * for Next.js (>= 14) page server components.\n *\n * @param options - Options to configure the pageserver component.\n * @param pageServerComponentFn - The page server component function.\n *\n * @returns A Next.js page server component.\n */\nexport function createSafePageServerComponent<\n AC extends AuthContext | undefined = undefined,\n TSegments extends TSegmentsDict | undefined = undefined,\n TSearchParams extends TSearchParamsDict | undefined = undefined,\n>(\n options: CreateSafePageServerComponentOptions<AC, TSegments, TSearchParams>,\n pageServerComponentFn: SafePageServerComponent<AC, TSegments, TSearchParams>\n): CreateSafePageServerComponentReturnType {\n const log = createLogger(options.debug)\n const id = options.id ?? DEFAULT_PAGE_ID\n\n const onError =\n options.onError ??\n ((err: unknown): Awaitable<never> => {\n log.error(`🛑 Unexpected error in page server component '${id}'`, err)\n throw err\n })\n\n const onSegmentsValidationError =\n options.onSegmentsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(`🛑 Invalid segments for page server component '${id}'`, issues)\n throw new ValidationError('segments', id, 'page')\n })\n\n const onSearchParamsValidationError =\n options.onSearchParamsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(`🛑 Invalid search params for server component '${id}'`, issues)\n throw new ValidationError('searchParams', id, 'page')\n })\n\n const authorize = options.authorize ?? (async () => undefined)\n\n // Next.js page server component\n return async function SafePageServerComponent(\n props: PageProvidedProps\n ): Promise<React.ReactElement | never> {\n const executionClock = createExecutionClock()\n executionClock.start()\n\n log.info(`🔄 Running page server component'${id}'`)\n\n let segments = undefined\n if (options.segments) {\n const params_unsafe = await props.params\n if (params_unsafe === undefined) {\n throw new NoSegmentsProvidedError(id, 'page')\n }\n\n const parsedSegments = parseWithDictionary(\n options.segments,\n params_unsafe\n )\n if (parsedSegments.issues) {\n await onSegmentsValidationError(parsedSegments.issues)\n } else {\n segments = parsedSegments.value\n }\n }\n\n let searchParams = undefined\n if (options.searchParams) {\n const searchParams_unsafe = await props.searchParams\n if (searchParams_unsafe === undefined) {\n throw new NoSearchParamsProvidedError(id, 'page')\n }\n\n const parsedSearchParams = parseWithDictionary(\n options.searchParams,\n searchParams_unsafe\n )\n if (parsedSearchParams.issues) {\n await onSearchParamsValidationError(parsedSearchParams.issues)\n } else {\n searchParams = parsedSearchParams.value\n }\n }\n\n // Authorize the server component\n let auth = undefined\n try {\n // Build page auth function params\n const authParams = {\n id,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n } as PageAuthFunctionParams<TSegments, TSearchParams>\n\n auth = await authorize(authParams)\n } catch (err: unknown) {\n log.error(`🛑 Page server component '${id}' not authorized`)\n throw err\n }\n\n try {\n // Build safe page server component context\n const ctx = {\n id,\n ...(auth ? { auth } : {}),\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n } as SafePageServerComponentContext<AC, TSegments, TSearchParams>\n\n // Execute the page server component\n const PageServerComponent = await pageServerComponentFn(ctx)\n\n // Stop the execution clock\n executionClock.stop()\n log.info(\n `✅ Page server component '${id}' executed successfully in ${executionClock.get()}`\n )\n\n return PageServerComponent\n } catch (err: unknown) {\n executionClock.stop()\n\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Page server component '${id}' failed to execute after ${executionClock.get()}`\n )\n return await onError(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n\n/** @internal exported for testing only */\nexport const DEFAULT_LAYOUT_ID = '[unknown:layout:server:component]'\n\n/**\n * Creates a safe layout server component with data validation and error handling\n * for Next.js (>= 14) layout server components.\n *\n * @param options - Options to configure the pageserver component.\n * @param layoutServerComponentFn - The layout server component function.\n *\n * @returns A Next.js layout server component.\n */\nexport function createSafeLayoutServerComponent<\n AC extends AuthContext | undefined = undefined,\n TSegments extends TSegmentsDict | undefined = undefined,\n TSlots extends readonly string[] | undefined = undefined,\n>(\n options: CreateSafeLayoutServerComponentOptions<AC, TSegments, TSlots>,\n layoutServerComponentFn: SafeLayoutServerComponent<AC, TSegments, TSlots>\n): CreateSafeLayoutServerComponentReturnType<TSlots> {\n const log = createLogger(options.debug)\n const id = options.id ?? DEFAULT_LAYOUT_ID\n\n const onError =\n options.onError ??\n ((err: unknown): Awaitable<never> => {\n log.error(`🛑 Unexpected error in layout server component '${id}'`, err)\n throw err\n })\n\n const onSegmentsValidationError =\n options.onSegmentsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(\n `🛑 Invalid segments for layout server component '${id}'`,\n issues\n )\n throw new ValidationError('segments', id, 'page')\n })\n\n const authorize = options.authorize ?? (async () => undefined)\n\n // Next.js layout server component\n return async function SafeLayoutServerComponent({\n params,\n children,\n ...layoutSlots\n }: LayoutProvidedProps<TSlots>) {\n const executionClock = createExecutionClock()\n executionClock.start()\n\n log.info(`🔄 Running layout server component'${id}'`)\n\n let segments = undefined\n if (options.segments) {\n const params_unsafe = await params\n if (params_unsafe === undefined) {\n throw new NoSegmentsProvidedError(id, 'page')\n }\n\n const parsedSegments = parseWithDictionary(\n options.segments,\n params_unsafe\n )\n if (parsedSegments.issues) {\n await onSegmentsValidationError(parsedSegments.issues)\n } else {\n segments = parsedSegments.value\n }\n }\n\n let experimental_slots = undefined\n if (options.experimental_slots) {\n // Validate that all expected slots exist in `layoutSlots`\n // We don't want to let pass unexpected slots to the layout server component\n // when using parallel routes and when they are not explicitly defined in the `experimental_slots` option.\n // It ensures data integrity and prevents potential security issues.\n const expectedSlots = options.experimental_slots\n const missingSlots: string[] = []\n\n for (const slotName of expectedSlots) {\n if (!(slotName in layoutSlots)) {\n missingSlots.push(slotName)\n }\n }\n\n if (missingSlots.length > 0) {\n throw new MissingLayoutSlotsError(id, missingSlots)\n }\n\n experimental_slots = layoutSlots\n }\n\n // Authorize the server component\n let auth = undefined\n try {\n // Build layout auth function params\n const authParams = {\n id,\n ...(segments ? { segments } : {}),\n } as LayoutAuthFunctionParams<TSegments>\n\n auth = await authorize(authParams)\n } catch (err: unknown) {\n log.error(`🛑 Layout server component '${id}' not authorized`)\n throw err\n }\n\n try {\n // Build safe layout server component context\n const ctx = {\n id,\n ...(auth ? { auth } : {}),\n ...(segments ? { segments } : {}),\n children,\n ...(experimental_slots ? { experimental_slots } : {}),\n } as SafeLayoutServerComponentContext<AC, TSegments, TSlots>\n\n // Execute the layout server component\n const LayoutServerComponent = await layoutServerComponentFn(ctx)\n\n // Stop the execution clock\n executionClock.stop()\n log.info(\n `✅ Layout server component '${id}' executed successfully in ${executionClock.get()}`\n )\n\n return LayoutServerComponent\n } catch (err: unknown) {\n executionClock.stop()\n\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Layout server component '${id}' failed to execute after ${executionClock.get()}`\n )\n return await onError(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n"],"mappings":"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","names":["ValidationError","validationType","id","serverComponentType","NoSegmentsProvidedError","NoSearchParamsProvidedError","MissingLayoutSlotsError","missingSlots","slotsList","s","isNextRedirectError","error","isNextHttpError","digest","isNextNativeError","DEFAULT_PAGE_ID","createSafePageServerComponent","options","pageServerComponentFn","log","createLogger","id","onError","err","onSegmentsValidationError","issues","ValidationError","onSearchParamsValidationError","authorize","props","executionClock","createExecutionClock","segments","params_unsafe","NoSegmentsProvidedError","parsedSegments","parseWithDictionary","searchParams","searchParams_unsafe","NoSearchParamsProvidedError","parsedSearchParams","auth","authParams","ctx","PageServerComponent","DEFAULT_LAYOUT_ID","createSafeLayoutServerComponent","layoutServerComponentFn","params","children","layoutSlots","experimental_slots","expectedSlots","missingSlots","slotName","MissingLayoutSlotsError","LayoutServerComponent"]}
|
|
1
|
+
{"version":3,"sources":["../../src/server-components/errors.ts","../../src/server-components/create-safe-server-component.ts"],"sourcesContent":["/**\n * Validation error for server components.\n */\nexport class ValidationError extends Error {\n constructor(\n validationType: 'segments' | 'searchParams',\n id: string,\n serverComponentType: 'page' | 'layout'\n ) {\n super(\n `${validationType === 'searchParams' ? 'Search params' : 'Segments'} validation error for ${serverComponentType} server component '${id}`\n )\n this.name = 'ValidationError'\n }\n}\n\n/**\n * No segments provided error for server components.\n */\nexport class NoSegmentsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No segments provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSegmentsProvidedError'\n }\n}\n\n/**\n * No search params provided error for server components.\n */\nexport class NoSearchParamsProvidedError extends Error {\n constructor(id: string, serverComponentType: 'page' | 'layout') {\n super(\n `No search params provided for ${serverComponentType} server component '${id}'`\n )\n this.name = 'NoSearchParamsProvidedError'\n }\n}\n\n/**\n * Missing slots error for layout server components.\n */\nexport class MissingLayoutSlotsError extends Error {\n constructor(id: string, missingSlots: readonly string[]) {\n const slotsList = missingSlots.map((s) => `'${s}'`).join(', ')\n super(`Missing slots [${slotsList}] for layout server component '${id}'`)\n this.name = 'MissingLayoutSlotsError'\n }\n}\n","import { createExecutionClock, createLogger, isNextNativeError } from '../utils'\nimport { parseWithDictionary, type StandardSchemaV1 } from '../standard-schema'\nimport type { Awaitable, AuthContext } from '../types'\nimport type {\n TSegmentsDict,\n TSearchParamsDict,\n PageAuthFunctionParams,\n PageProvidedProps,\n SafePageServerComponentContext,\n CreateSafePageServerComponentOptions,\n CreateSafePageServerComponentReturnType,\n SafePageServerComponent,\n CreateSafeLayoutServerComponentOptions,\n SafeLayoutServerComponent,\n CreateSafeLayoutServerComponentReturnType,\n LayoutProvidedProps,\n LayoutAuthFunctionParams,\n SafeLayoutServerComponentContext,\n} from './types'\nimport {\n ValidationError,\n NoSegmentsProvidedError,\n NoSearchParamsProvidedError,\n MissingLayoutSlotsError,\n} from './errors'\n\n/** @internal exported for testing only */\nexport const DEFAULT_PAGE_ID = '[unknown:page:server:component]'\n\n/**\n * Creates a safe page server component with data validation and error handling\n * for Next.js (>= 14) page server components.\n *\n * @param options - Options to configure the pageserver component.\n * @param pageServerComponentFn - The page server component function.\n *\n * @returns A Next.js page server component.\n */\nexport function createSafePageServerComponent<\n AC extends AuthContext | undefined = undefined,\n TSegments extends TSegmentsDict | undefined = undefined,\n TSearchParams extends TSearchParamsDict | undefined = undefined,\n>(\n options: CreateSafePageServerComponentOptions<AC, TSegments, TSearchParams>,\n pageServerComponentFn: SafePageServerComponent<AC, TSegments, TSearchParams>\n): CreateSafePageServerComponentReturnType {\n const log = createLogger(options.debug)\n const id = options.id ?? DEFAULT_PAGE_ID\n\n const onError =\n options.onError ??\n ((err: unknown): Awaitable<never> => {\n log.error(`🛑 Unexpected error in page server component '${id}'`, err)\n throw err\n })\n\n const onSegmentsValidationError =\n options.onSegmentsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(`🛑 Invalid segments for page server component '${id}'`, issues)\n throw new ValidationError('segments', id, 'page')\n })\n\n const onSearchParamsValidationError =\n options.onSearchParamsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(`🛑 Invalid search params for server component '${id}'`, issues)\n throw new ValidationError('searchParams', id, 'page')\n })\n\n const authorize = options.authorize ?? (async () => undefined)\n\n // Next.js page server component\n return async function SafePageServerComponent(\n props: PageProvidedProps\n ): Promise<React.ReactElement | never> {\n const executionClock = createExecutionClock()\n executionClock.start()\n\n log.info(`🔄 Running page server component'${id}'`)\n\n let segments = undefined\n if (options.segments) {\n const params_unsafe = await props.params\n if (params_unsafe === undefined) {\n throw new NoSegmentsProvidedError(id, 'page')\n }\n\n const parsedSegments = parseWithDictionary(\n options.segments,\n params_unsafe\n )\n if (parsedSegments.issues) {\n await onSegmentsValidationError(parsedSegments.issues)\n } else {\n segments = parsedSegments.value\n }\n }\n\n let searchParams = undefined\n if (options.searchParams) {\n const searchParams_unsafe = await props.searchParams\n if (searchParams_unsafe === undefined) {\n throw new NoSearchParamsProvidedError(id, 'page')\n }\n\n const parsedSearchParams = parseWithDictionary(\n options.searchParams,\n searchParams_unsafe\n )\n if (parsedSearchParams.issues) {\n await onSearchParamsValidationError(parsedSearchParams.issues)\n } else {\n searchParams = parsedSearchParams.value\n }\n }\n\n // Authorize the server component\n let auth = undefined\n try {\n // Build page auth function params\n const authParams = {\n id,\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n } as PageAuthFunctionParams<TSegments, TSearchParams>\n\n auth = await authorize(authParams)\n } catch (err: unknown) {\n log.error(`🛑 Page server component '${id}' not authorized`)\n throw err\n }\n\n try {\n // Build safe page server component context\n const ctx = {\n id,\n ...(auth ? { auth } : {}),\n ...(segments ? { segments } : {}),\n ...(searchParams ? { searchParams } : {}),\n } as SafePageServerComponentContext<AC, TSegments, TSearchParams>\n\n // Execute the page server component\n const PageServerComponent = await pageServerComponentFn(ctx)\n\n // Stop the execution clock\n executionClock.stop()\n log.info(\n `✅ Page server component '${id}' executed successfully in ${executionClock.get()}`\n )\n\n return PageServerComponent\n } catch (err: unknown) {\n executionClock.stop()\n\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Page server component '${id}' failed to execute after ${executionClock.get()}`\n )\n return await onError(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n\n/** @internal exported for testing only */\nexport const DEFAULT_LAYOUT_ID = '[unknown:layout:server:component]'\n\n/**\n * Creates a safe layout server component with data validation and error handling\n * for Next.js (>= 14) layout server components.\n *\n * @param options - Options to configure the pageserver component.\n * @param layoutServerComponentFn - The layout server component function.\n *\n * @returns A Next.js layout server component.\n */\nexport function createSafeLayoutServerComponent<\n AC extends AuthContext | undefined = undefined,\n TSegments extends TSegmentsDict | undefined = undefined,\n TSlots extends readonly string[] | undefined = undefined,\n>(\n options: CreateSafeLayoutServerComponentOptions<AC, TSegments, TSlots>,\n layoutServerComponentFn: SafeLayoutServerComponent<AC, TSegments, TSlots>\n): CreateSafeLayoutServerComponentReturnType<TSlots> {\n const log = createLogger(options.debug)\n const id = options.id ?? DEFAULT_LAYOUT_ID\n\n const onError =\n options.onError ??\n ((err: unknown): Awaitable<never> => {\n log.error(`🛑 Unexpected error in layout server component '${id}'`, err)\n throw err\n })\n\n const onSegmentsValidationError =\n options.onSegmentsValidationError ??\n ((issues: readonly StandardSchemaV1.Issue[]): Awaitable<never> => {\n log.error(\n `🛑 Invalid segments for layout server component '${id}'`,\n issues\n )\n throw new ValidationError('segments', id, 'page')\n })\n\n const authorize = options.authorize ?? (async () => undefined)\n\n // Next.js layout server component\n return async function SafeLayoutServerComponent({\n params,\n children,\n ...layoutSlots\n }: LayoutProvidedProps<TSlots>) {\n const executionClock = createExecutionClock()\n executionClock.start()\n\n log.info(`🔄 Running layout server component'${id}'`)\n\n let segments = undefined\n if (options.segments) {\n const params_unsafe = await params\n if (params_unsafe === undefined) {\n throw new NoSegmentsProvidedError(id, 'page')\n }\n\n const parsedSegments = parseWithDictionary(\n options.segments,\n params_unsafe\n )\n if (parsedSegments.issues) {\n await onSegmentsValidationError(parsedSegments.issues)\n } else {\n segments = parsedSegments.value\n }\n }\n\n let experimental_slots = undefined\n if (options.experimental_slots) {\n // Validate that all expected slots exist in `layoutSlots`\n // We don't want to let pass unexpected slots to the layout server component\n // when using parallel routes and when they are not explicitly defined in the `experimental_slots` option.\n // It ensures data integrity and prevents potential security issues.\n const expectedSlots = options.experimental_slots\n const missingSlots: string[] = []\n\n for (const slotName of expectedSlots) {\n if (!(slotName in layoutSlots)) {\n missingSlots.push(slotName)\n }\n }\n\n if (missingSlots.length > 0) {\n throw new MissingLayoutSlotsError(id, missingSlots)\n }\n\n experimental_slots = layoutSlots\n }\n\n // Authorize the server component\n let auth = undefined\n try {\n // Build layout auth function params\n const authParams = {\n id,\n ...(segments ? { segments } : {}),\n } as LayoutAuthFunctionParams<TSegments>\n\n auth = await authorize(authParams)\n } catch (err: unknown) {\n log.error(`🛑 Layout server component '${id}' not authorized`)\n throw err\n }\n\n try {\n // Build safe layout server component context\n const ctx = {\n id,\n ...(auth ? { auth } : {}),\n ...(segments ? { segments } : {}),\n children,\n ...(experimental_slots ? { experimental_slots } : {}),\n } as SafeLayoutServerComponentContext<AC, TSegments, TSlots>\n\n // Execute the layout server component\n const LayoutServerComponent = await layoutServerComponentFn(ctx)\n\n // Stop the execution clock\n executionClock.stop()\n log.info(\n `✅ Layout server component '${id}' executed successfully in ${executionClock.get()}`\n )\n\n return LayoutServerComponent\n } catch (err: unknown) {\n executionClock.stop()\n\n if (!isNextNativeError(err)) {\n log.error(\n `🛑 Layout server component '${id}' failed to execute after ${executionClock.get()}`\n )\n return await onError(err)\n } else {\n log.info('ℹ️ Ignoring native Next.js error')\n throw err\n }\n }\n }\n}\n"],"mappings":"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","names":["ValidationError","validationType","id","serverComponentType","NoSegmentsProvidedError","NoSearchParamsProvidedError","MissingLayoutSlotsError","missingSlots","slotsList","s","DEFAULT_PAGE_ID","createSafePageServerComponent","options","pageServerComponentFn","log","createLogger","id","onError","err","onSegmentsValidationError","issues","ValidationError","onSearchParamsValidationError","authorize","props","executionClock","createExecutionClock","segments","params_unsafe","NoSegmentsProvidedError","parsedSegments","parseWithDictionary","searchParams","searchParams_unsafe","NoSearchParamsProvidedError","parsedSearchParams","auth","authParams","ctx","PageServerComponent","isNextNativeError","DEFAULT_LAYOUT_ID","createSafeLayoutServerComponent","layoutServerComponentFn","params","children","layoutSlots","experimental_slots","expectedSlots","missingSlots","slotName","MissingLayoutSlotsError","LayoutServerComponent"]}
|
|
@@ -217,7 +217,7 @@ req: TReq,
|
|
|
217
217
|
/**
|
|
218
218
|
* Provided context added by Next.js itself
|
|
219
219
|
*/
|
|
220
|
-
providedContext: ProvidedRouteContext) => Promise<Response>;
|
|
220
|
+
providedContext: ProvidedRouteContext) => Promise<Response | never>;
|
|
221
221
|
type SafeRouteHandlerContext<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
|
|
222
222
|
/**
|
|
223
223
|
* Route handler ID
|
|
@@ -261,6 +261,6 @@ ctx: SafeRouteHandlerContext<AC, TSegments, TSearchParams, TBody, TFormData>,
|
|
|
261
261
|
/**
|
|
262
262
|
* Original request
|
|
263
263
|
*/
|
|
264
|
-
req: TReq) => Promise<Response>;
|
|
264
|
+
req: TReq) => Promise<Response | never>;
|
|
265
265
|
|
|
266
|
-
export { type AuthContext as A, type BaseOptions as B, type CreateSafeRouteHandlerOptions as C, type EmptyObjectType as E, type OnValidationErrorResponse as O, type ProvidedRouteContext as P, type SafeRouteHandler as S, type TSegmentsDict as T, type UnwrapReadonlyObject as U, type TSearchParamsDict as a, type TBodySchema as b, type TFormDataDict as c, type CreateSafeRouteHandlerReturnType as d, type
|
|
266
|
+
export { type AuthContext as A, type BaseOptions as B, type CreateSafeRouteHandlerOptions as C, type EmptyObjectType as E, type OnValidationErrorResponse as O, type ProvidedRouteContext as P, type SafeRouteHandler as S, type TSegmentsDict as T, type UnwrapReadonlyObject as U, type TSearchParamsDict as a, type TBodySchema as b, type TFormDataDict as c, type CreateSafeRouteHandlerReturnType as d, type AuthFunction as e, type AuthFunctionParams as f, type Awaitable as g, type SafeRouteHandlerContext as h, StandardSchemaDictionary as i, StandardSchemaV1 as j };
|
|
@@ -217,7 +217,7 @@ req: TReq,
|
|
|
217
217
|
/**
|
|
218
218
|
* Provided context added by Next.js itself
|
|
219
219
|
*/
|
|
220
|
-
providedContext: ProvidedRouteContext) => Promise<Response>;
|
|
220
|
+
providedContext: ProvidedRouteContext) => Promise<Response | never>;
|
|
221
221
|
type SafeRouteHandlerContext<AC extends AuthContext | undefined, TSegments extends TSegmentsDict | undefined, TSearchParams extends TSearchParamsDict | undefined, TBody extends TBodySchema | undefined, TFormData extends TFormDataDict | undefined> = {
|
|
222
222
|
/**
|
|
223
223
|
* Route handler ID
|
|
@@ -261,6 +261,6 @@ ctx: SafeRouteHandlerContext<AC, TSegments, TSearchParams, TBody, TFormData>,
|
|
|
261
261
|
/**
|
|
262
262
|
* Original request
|
|
263
263
|
*/
|
|
264
|
-
req: TReq) => Promise<Response>;
|
|
264
|
+
req: TReq) => Promise<Response | never>;
|
|
265
265
|
|
|
266
|
-
export { type AuthContext as A, type BaseOptions as B, type CreateSafeRouteHandlerOptions as C, type EmptyObjectType as E, type OnValidationErrorResponse as O, type ProvidedRouteContext as P, type SafeRouteHandler as S, type TSegmentsDict as T, type UnwrapReadonlyObject as U, type TSearchParamsDict as a, type TBodySchema as b, type TFormDataDict as c, type CreateSafeRouteHandlerReturnType as d, type
|
|
266
|
+
export { type AuthContext as A, type BaseOptions as B, type CreateSafeRouteHandlerOptions as C, type EmptyObjectType as E, type OnValidationErrorResponse as O, type ProvidedRouteContext as P, type SafeRouteHandler as S, type TSegmentsDict as T, type UnwrapReadonlyObject as U, type TSearchParamsDict as a, type TBodySchema as b, type TFormDataDict as c, type CreateSafeRouteHandlerReturnType as d, type AuthFunction as e, type AuthFunctionParams as f, type Awaitable as g, type SafeRouteHandlerContext as h, StandardSchemaDictionary as i, StandardSchemaV1 as j };
|
package/package.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sugardarius/anzen",
|
|
3
|
-
"version": "2.2.
|
|
3
|
+
"version": "2.2.1",
|
|
4
4
|
"description": "Fast, flexible, framework validation agnostic, type‑safe factories for creating route handlers, page and layout Server Component files in Next.js.",
|
|
5
5
|
"license": "MIT",
|
|
6
|
-
"packageManager": "npm@11.
|
|
6
|
+
"packageManager": "npm@11.8.0",
|
|
7
7
|
"workspaces": [
|
|
8
8
|
".",
|
|
9
9
|
"www"
|
|
@@ -82,21 +82,21 @@
|
|
|
82
82
|
},
|
|
83
83
|
"devDependencies": {
|
|
84
84
|
"@arethetypeswrong/cli": "^0.18.2",
|
|
85
|
-
"@eslint/eslintrc": "^3.3.
|
|
86
|
-
"@eslint/js": "^9.39.
|
|
87
|
-
"@release-it/keep-a-changelog": "^7.0.
|
|
88
|
-
"@types/node": "^25.
|
|
89
|
-
"@types/react": "^19.2.
|
|
90
|
-
"decoders": "^2.
|
|
91
|
-
"eslint": "^9.39.
|
|
85
|
+
"@eslint/eslintrc": "^3.3.4",
|
|
86
|
+
"@eslint/js": "^9.39.3",
|
|
87
|
+
"@release-it/keep-a-changelog": "^7.0.1",
|
|
88
|
+
"@types/node": "^25.3.0",
|
|
89
|
+
"@types/react": "^19.2.14",
|
|
90
|
+
"decoders": "^2.8.0",
|
|
91
|
+
"eslint": "^9.39.3",
|
|
92
92
|
"prettier": "^3.8.1",
|
|
93
93
|
"publint": "^0.3.17",
|
|
94
94
|
"release-it": "^19.2.4",
|
|
95
95
|
"tsup": "^8.5.1",
|
|
96
96
|
"turbo": "^2.5.6",
|
|
97
97
|
"typescript": "^5.9.3",
|
|
98
|
-
"typescript-eslint": "^8.
|
|
99
|
-
"vitest": "^
|
|
98
|
+
"typescript-eslint": "^8.56.1",
|
|
99
|
+
"vitest": "^4.0.18",
|
|
100
100
|
"zod": "^4.3.6"
|
|
101
101
|
}
|
|
102
102
|
}
|
package/dist/chunk-O6UW3BSE.cjs
DELETED
|
@@ -1,2 +0,0 @@
|
|
|
1
|
-
"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }function i(e,t){return t in e}function d(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function u(e,t){if(d(e))throw new Error(t)}function p(e=!1){let t=e||process.env.NODE_ENV!=="production";return{info:(r,...n)=>{t&&console.log(r,...n)},error:(r,...n)=>{t&&console.error(r,...n)},warn:(r,...n)=>{t&&console.warn(r,...n)}}}function c(){let e=null,t=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");t=performance.now()},get:()=>{if(!e||!t)throw new Error("Execution clock has not been started or stopped.");return`${(t-e).toFixed(2)}ms`}}}function m(e,t,r="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(t);return u(n,r),n}function S(e,t){let r={},n=[];for(let o in e){if(!i(e,o))continue;let a=e[o]["~standard"].validate(t[o]);if(u(a,`Validation must be synchronous, but ${o} returned a Promise.`),a.issues){n.push(...a.issues.map(s=>({...s,path:[o,..._nullishCoalesce(s.path, () => ([]))]})));continue}r[o]=a.value}return n.length>0?{issues:n}:{value:r}}exports.a = p; exports.b = c; exports.c = m; exports.d = S;
|
|
2
|
-
//# sourceMappingURL=chunk-O6UW3BSE.cjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/utils.ts"],"names":["hasDictKey","obj","key","isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime"],"mappings":"AAAO,sLAASA,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACwC,CACxC,OAAOA,EAAAA,GAAOD,CAChB,CAEO,SAASE,CAAAA,CACdC,CAAAA,CACsC,CACtC,OACEA,CAAAA,GAAU,IAAA,EAAA,CACT,OAAOA,CAAAA,EAAU,QAAA,EAAY,OAAOA,CAAAA,EAAU,UAAA,CAAA,EAE/C,OAAQA,CAAAA,CAAc,IAAA,EAAS,UAEnC,CAEO,SAASC,CAAAA,CACdD,CAAAA,CACAE,CAAAA,CACoB,CACpB,EAAA,CAAIH,CAAAA,CAAaC,CAAK,CAAA,CACpB,MAAM,IAAI,KAAA,CAAME,CAAO,CAE3B,CAEO,SAASC,CAAAA,CAAaC,CAAAA,CAAiB,CAAA,CAAA,CAAO,CACnD,IAAMC,CAAAA,CAAYD,CAAAA,EAAS,OAAA,CAAQ,GAAA,CAAI,QAAA,GAAa,YAAA,CACpD,MAAO,CACL,IAAA,CAAM,CAACF,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAC/CD,CAAAA,EACF,OAAA,CAAQ,GAAA,CAAIH,CAAAA,CAAS,GAAGI,CAAI,CAEhC,CAAA,CACA,KAAA,CAAO,CAACJ,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAChDD,CAAAA,EACF,OAAA,CAAQ,KAAA,CAAMH,CAAAA,CAAS,GAAGI,CAAI,CAElC,CAAA,CACA,IAAA,CAAM,CAACJ,CAAAA,CAAAA,GAAoBI,CAAAA,CAAAA,EAA0B,CAC/CD,CAAAA,EACF,OAAA,CAAQ,IAAA,CAAKH,CAAAA,CAAS,GAAGI,CAAI,CAEjC,CACF,CACF,CAEO,SAASC,CAAAA,CAAAA,CAAuB,CACrC,IAAIC,CAAAA,CAA2B,IAAA,CAC3BC,CAAAA,CAAyB,IAAA,CAE7B,MAAO,CACL,KAAA,CAAO,CAAA,CAAA,EAAY,CACjBD,CAAAA,CAAY,WAAA,CAAY,GAAA,CAAI,CAC9B,CAAA,CACA,IAAA,CAAM,CAAA,CAAA,EAAY,CAChB,EAAA,CAAIA,CAAAA,GAAc,IAAA,CAChB,MAAM,IAAI,KAAA,CAAM,kCAAkC,CAAA,CAEpDC,CAAAA,CAAU,WAAA,CAAY,GAAA,CAAI,CAC5B,CAAA,CACA,GAAA,CAAK,CAAA,CAAA,EAAc,CACjB,EAAA,CAAI,CAACD,CAAAA,EAAa,CAACC,CAAAA,CACjB,MAAM,IAAI,KAAA,CAAM,kDAAkD,CAAA,CAIpE,MAAO,CAAA,EAAA","file":"/home/runner/work/anzen/anzen/dist/chunk-O6UW3BSE.cjs","sourcesContent":["export function 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 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"]}
|
package/dist/chunk-Y6TQQ4BK.js
DELETED
|
@@ -1,2 +0,0 @@
|
|
|
1
|
-
function i(e,t){return t in e}function d(e){return e!==null&&(typeof e=="object"||typeof e=="function")&&typeof e.then=="function"}function u(e,t){if(d(e))throw new Error(t)}function p(e=!1){let t=e||process.env.NODE_ENV!=="production";return{info:(r,...n)=>{t&&console.log(r,...n)},error:(r,...n)=>{t&&console.error(r,...n)},warn:(r,...n)=>{t&&console.warn(r,...n)}}}function c(){let e=null,t=null;return{start:()=>{e=performance.now()},stop:()=>{if(e===null)throw new Error("Execution clock was not started.");t=performance.now()},get:()=>{if(!e||!t)throw new Error("Execution clock has not been started or stopped.");return`${(t-e).toFixed(2)}ms`}}}function m(e,t,r="Validation must be synchronous but schema returned a Promise."){let n=e["~standard"].validate(t);return u(n,r),n}function S(e,t){let r={},n=[];for(let o in e){if(!i(e,o))continue;let a=e[o]["~standard"].validate(t[o]);if(u(a,`Validation must be synchronous, but ${o} returned a Promise.`),a.issues){n.push(...a.issues.map(s=>({...s,path:[o,...s.path??[]]})));continue}r[o]=a.value}return n.length>0?{issues:n}:{value:r}}export{p as a,c as b,m as c,S as d};
|
|
2
|
-
//# sourceMappingURL=chunk-Y6TQQ4BK.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/utils.ts","../src/standard-schema.ts"],"sourcesContent":["export function 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 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, hasDictKey } 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\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"],"mappings":"AAAO,SAASA,EACdC,EACAC,EACwC,CACxC,OAAOA,KAAOD,CAChB,CAEO,SAASE,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,CCEO,SAASE,EACdC,EACAC,EACAC,EAAa,gEACmD,CAChE,IAAMC,EAASH,EAAO,WAAW,EAAE,SAASC,CAAK,EACjD,OAAAG,EAAqBD,EAAQD,CAAU,EAEhCC,CACT,CAoBO,SAASE,EACdC,EACAL,EACsE,CACtE,IAAME,EAAkC,CAAC,EACnCI,EAAmC,CAAC,EAE1C,QAAWC,KAAOF,EAAY,CAC5B,GAAI,CAACG,EAAWH,EAAYE,CAAG,EAC7B,SAGF,IAAME,EAAaJ,EAAWE,CAAG,EAAG,WAAW,EAAE,SAASP,EAAMO,CAAG,CAAC,EAOpE,GALAJ,EACEM,EACA,uCAAuCF,CAAG,sBAC5C,EAEIE,EAAW,OAAQ,CACrBH,EAAO,KACL,GAAGG,EAAW,OAAO,IAAKC,IAAW,CACnC,GAAGA,EACH,KAAM,CAACH,EAAK,GAAIG,EAAM,MAAQ,CAAC,CAAE,CACnC,EAAE,CACJ,EACA,QACF,CACAR,EAAOK,CAAG,EAAIE,EAAW,KAC3B,CAEA,OAAIH,EAAO,OAAS,EACX,CAAE,OAAAA,CAAO,EAGX,CAAE,MAAOJ,CAAgB,CAClC","names":["hasDictKey","obj","key","isPromise","value","assertsSyncOperation","message","createLogger","debug","shouldLog","rest","createExecutionClock","startTime","endTime","validateWithSchema","schema","value","errSyncMsg","result","assertsSyncOperation","parseWithDictionary","dictionary","issues","key","hasDictKey","propResult","issue"]}
|