moonflower 1.2.0 → 1.3.0

package/dist/openapi/analyzerModule/parseEndpoint.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parseEndpoint.mjs","sources":["../../../src/openapi/analyzerModule/parseEndpoint.ts"],"sourcesContent":["import { Node, SyntaxKind, ts } from 'ts-morph'\n\nimport { ApiEndpointDocs } from '../../hooks/useApiEndpoint'\nimport { Logger } from '../../utils/logger'\nimport { EndpointData } from '../types'\nimport {\n\tfindNodeImplementation,\n\tgetProperTypeShape,\n\tgetShapeOfValidatorLiteral,\n\tgetValidatorPropertyOptionality,\n\tgetValidatorPropertyShape,\n\tgetValidatorPropertyStringValue,\n\tgetValuesOfObjectLiteral,\n} from './nodeParsers'\n\nexport const parseEndpoint = (node: Node<ts.Node>, sourceFilePath: string) => {\n\tconst parsedEndpointMethod = node\n\t\t.getFirstDescendantByKind(SyntaxKind.PropertyAccessExpression)!\n\t\t.getText()\n\t\t.split('.')[1]\n\t\t.toUpperCase()\n\n\tconst endpointMethod = parsedEndpointMethod === 'DEL' ? 'DELETE' : parsedEndpointMethod\n\n\tconst endpointText = node.getFirstDescendantByKind(SyntaxKind.StringLiteral)!.getText() ?? ''\n\tconst endpointPath = endpointText.substring(1, endpointText.length - 1)\n\n\tconst endpointData: EndpointData = {\n\t\tmethod: endpointMethod as 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n\t\tpath: endpointPath,\n\t\tsourceFilePath,\n\t\trequestPathParams: [],\n\t\trequestQuery: [],\n\t\trequestHeaders: [],\n\t\trawBody: undefined,\n\t\tobjectBody: [],\n\t\tresponses: [],\n\t\tname: undefined,\n\t\tsummary: undefined,\n\t\tdescription: undefined,\n\t\ttags: undefined,\n\t}\n\n\tconst warningData: {\n\t\tsegment: string\n\t\terror: Error\n\t}[] = []\n\n\t// API documentation\n\ttry {\n\t\tconst entries = parseApiDocumentation(node)\n\t\tentries.forEach((param) => {\n\t\t\tendpointData[param.identifier] = param.value as string & string[]\n\t\t})\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'api',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request params\n\ttry {\n\t\tendpointData.requestPathParams = parseRequestParams(node, endpointPath)\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'path',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request query\n\ttry {\n\t\tendpointData.requestQuery = parseRequestObjectInput(node, 'useQueryParams')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'query',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request headers\n\ttry {\n\t\tendpointData.requestHeaders = parseRequestObjectInput(node, 'useHeaderParams')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'headers',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Raw request body\n\ttry {\n\t\tconst parsedBody = parseRequestRawBody(node)\n\t\tif (parsedBody) {\n\t\t\tendpointData.rawBody = parsedBody\n\t\t}\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'rawBody',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Object request body\n\ttry {\n\t\tendpointData.objectBody = parseRequestObjectInput(node, 'useRequestBody')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'objectBody',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request response\n\ttry {\n\t\tendpointData.responses = parseRequestResponse(node)\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'response',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\treturn endpointData\n}\n\nconst getHookNode = (\n\tendpointNode: Node<ts.Node>,\n\thookName:\n\t\t| 'useApiEndpoint'\n\t\t| 'usePathParams'\n\t\t| 'useQueryParams'\n\t\t| 'useHeaderParams'\n\t\t| 'useRequestBody'\n\t\t| 'useRequestRawBody',\n) => {\n\tconst callExpressions = endpointNode.getDescendantsOfKind(SyntaxKind.CallExpression)\n\tconst matchingCallExpressions = callExpressions.filter((node) => {\n\t\treturn node.getFirstChildByKind(SyntaxKind.Identifier)?.getText() === hookName\n\t})\n\treturn matchingCallExpressions[0] ?? null\n}\n\nconst parseApiDocumentation = (node: Node<ts.Node>) => {\n\tconst hookNode = getHookNode(node, 'useApiEndpoint')\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error('Non-literal type used in useApiEndpoint')\n\t}\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\n\tconst values = getValuesOfObjectLiteral(objectLiteral).filter((param) => param.value !== null)\n\treturn values as {\n\t\tidentifier: keyof ApiEndpointDocs\n\t\tvalue: (typeof values)[number]['value']\n\t}[]\n}\n\nconst parseRequestParams = (node: Node<ts.Node>, endpointPath: string): EndpointData['requestPathParams'] => {\n\tconst hookNode = getHookNode(node, 'usePathParams')\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error('Non-literal type used in usePathParams')\n\t}\n\n\tconst declaredParams = endpointPath\n\t\t.split('/')\n\t\t.filter((segment) => segment.startsWith(':'))\n\t\t.map((segment) => ({\n\t\t\tname: segment.substring(1).replace(/\\?/, ''),\n\t\t\toptional: segment.includes('?'),\n\t\t}))\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\treturn getShapeOfValidatorLiteral(objectLiteral)\n\t\t.filter((param) => param.shape !== null)\n\t\t.map((param) => ({\n\t\t\tidentifier: param.identifier,\n\t\t\tsignature: param.shape as string,\n\t\t\toptional: declaredParams.some((declared) => declared.name === param.identifier && declared.optional),\n\t\t\tdescription: param.description,\n\t\t\terrorMessage: param.errorMessage,\n\t\t}))\n}\n\nconst parseRequestRawBody = (node: Node<ts.Node>): NonNullable<EndpointData['rawBody']> | null => {\n\tconst hookNode = getHookNode(node, 'useRequestRawBody')\n\tif (!hookNode) {\n\t\treturn null\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(\n\t\tparamNode.getLastChild((node) => !node.isKind(SyntaxKind.CommaToken))!,\n\t)\n\n\treturn {\n\t\tsignature: getValidatorPropertyShape(valueNode),\n\t\toptional: getValidatorPropertyOptionality(valueNode),\n\t\tdescription: getValidatorPropertyStringValue(valueNode, 'description'),\n\t\terrorMessage: getValidatorPropertyStringValue(valueNode, 'errorMessage'),\n\t}\n}\n\nconst parseRequestObjectInput = (\n\tnode: Node<ts.Node>,\n\tnodeName: 'useQueryParams' | 'useHeaderParams' | 'useRequestBody',\n): EndpointData['requestQuery'] | EndpointData['objectBody'] => {\n\tconst hookNode = getHookNode(node, nodeName)\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error(`Non-literal type used in ${nodeName}`)\n\t}\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\treturn getShapeOfValidatorLiteral(objectLiteral)\n\t\t.filter((param) => param.shape !== null)\n\t\t.map((param) => ({\n\t\t\tidentifier: param.identifier,\n\t\t\tsignature: param.shape as string,\n\t\t\toptional: param.optional,\n\t\t\tdescription: param.description,\n\t\t\terrorMessage: param.errorMessage,\n\t\t}))\n}\n\nconst parseRequestResponse = (node: Node<ts.Node>): EndpointData['responses'] => {\n\tconst implementationNode = node\n\t\t.getFirstChildByKind(SyntaxKind.CallExpression)!\n\t\t.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\t\t.getFirstChildByKind(SyntaxKind.ArrowFunction)!\n\tconst returnType = implementationNode.getReturnType()\n\n\tconst actualType = (() => {\n\t\tif (returnType.getText().startsWith('Promise')) {\n\t\t\treturn returnType.getTypeArguments()[0]\n\t\t}\n\t\treturn returnType\n\t})()\n\n\tconst responseType = getProperTypeShape(actualType, node)\n\n\treturn parseResponseTypes(responseType)\n}\n\nconst parseResponseTypes = (\n\tresponseType: ReturnType<typeof getProperTypeShape>,\n): EndpointData['responses'] => {\n\t// TODO: Add support for response descriptions and errors\n\tif (typeof responseType === 'string') {\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus: responseType === 'void' || responseType === 'null' ? 204 : 200,\n\t\t\t\tcontentType: 'text/plain',\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\tif (responseType[0].role === 'union_entry' || responseType[0].role === 'literal_string') {\n\t\treturn parseResponseTypes(responseType[0].shape)\n\t}\n\n\t// Response type is a useReturnValue hook\n\tif (responseType[0].role === 'property' && responseType[0].identifier === '_isUseReturnValue') {\n\t\tconst status = (() => {\n\t\t\tconst property = responseType.find(\n\t\t\t\t(response) => response.role === 'property' && response.identifier === 'status',\n\t\t\t)?.shape\n\t\t\tif (!property || typeof property === 'string' || typeof property[0].shape !== 'string') {\n\t\t\t\tthrow new Error('Invalid useReturnValue hook')\n\t\t\t}\n\t\t\treturn parseInt(property[0].shape)\n\t\t})()\n\t\tconst contentType = (() => {\n\t\t\tconst property = responseType.find(\n\t\t\t\t(response) => response.role === 'property' && response.identifier === 'contentType',\n\t\t\t)?.shape\n\t\t\tif (!property || typeof property === 'string' || typeof property[0].shape !== 'string') {\n\t\t\t\tthrow new Error('Invalid useReturnValue hook')\n\t\t\t}\n\t\t\treturn property[0].shape\n\t\t})()\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus,\n\t\t\t\tcontentType,\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\tif (responseType[0].role === 'union') {\n\t\tif (typeof responseType[0].shape === 'string') {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tstatus: responseType[0].shape === 'void' || responseType[0].shape === 'null' ? 204 : 200,\n\t\t\t\t\tcontentType: 'application/json',\n\t\t\t\t\tsignature: responseType[0].shape,\n\t\t\t\t\tdescription: '',\n\t\t\t\t\terrorMessage: '',\n\t\t\t\t},\n\t\t\t]\n\t\t}\n\n\t\treturn responseType[0].shape.flatMap((unionEntry) => {\n\t\t\treturn parseResponseTypes([unionEntry])\n\t\t})\n\t}\n\n\tif (responseType[0].role === 'buffer') {\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus: 200,\n\t\t\t\tcontentType: 'application/octet-stream',\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\treturn [\n\t\t{\n\t\t\tstatus: 200,\n\t\t\tcontentType: 'application/json',\n\t\t\tsignature: responseType,\n\t\t\tdescription: '',\n\t\t\terrorMessage: '',\n\t\t},\n\t]\n}\n"],"names":["parseEndpoint","node","sourceFilePath","parsedEndpointMethod","SyntaxKind","endpointMethod","endpointText","endpointPath","endpointData","parseApiDocumentation","param","err","Logger","parseRequestParams","parseRequestObjectInput","parsedBody","parseRequestRawBody","parseRequestResponse","getHookNode","endpointNode","hookName","hookNode","paramNode","valueNode","findNodeImplementation","objectLiteral","getValuesOfObjectLiteral","declaredParams","segment","getShapeOfValidatorLiteral","declared","getValidatorPropertyShape","getValidatorPropertyOptionality","getValidatorPropertyStringValue","nodeName","returnType","actualType","responseType","getProperTypeShape","parseResponseTypes","status","property","response","contentType","unionEntry"],"mappings":"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"}
+{"version":3,"file":"parseEndpoint.mjs","sources":["../../../src/openapi/analyzerModule/parseEndpoint.ts"],"sourcesContent":["import { Node, SyntaxKind, ts } from 'ts-morph'\n\nimport { ApiEndpointDocs } from '../../hooks/useApiEndpoint'\nimport { Logger } from '../../utils/logger'\nimport { EndpointData } from '../types'\nimport {\n\tfindNodeImplementation,\n\tgetProperTypeShape,\n\tgetShapeOfValidatorLiteral,\n\tgetValidatorPropertyOptionality,\n\tgetValidatorPropertyShape,\n\tgetValidatorPropertyStringValue,\n\tgetValuesOfObjectLiteral,\n\tresolveEndpointPath,\n} from './nodeParsers'\n\nexport const parseEndpoint = (node: Node<ts.Node>, sourceFilePath: string) => {\n\tconst parsedEndpointMethod = node\n\t\t.getFirstDescendantByKind(SyntaxKind.PropertyAccessExpression)!\n\t\t.getText()\n\t\t.split('.')[1]\n\t\t.toUpperCase()\n\n\tconst endpointMethod = parsedEndpointMethod === 'DEL' ? 'DELETE' : parsedEndpointMethod\n\n\tconst endpointPath = resolveEndpointPath(node) ?? ''\n\n\tconst endpointData: EndpointData = {\n\t\tmethod: endpointMethod as 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',\n\t\tpath: endpointPath,\n\t\tsourceFilePath,\n\t\trequestPathParams: [],\n\t\trequestQuery: [],\n\t\trequestHeaders: [],\n\t\trawBody: undefined,\n\t\tobjectBody: [],\n\t\tresponses: [],\n\t\tname: undefined,\n\t\tsummary: undefined,\n\t\tdescription: undefined,\n\t\ttags: undefined,\n\t}\n\n\tconst warningData: {\n\t\tsegment: string\n\t\terror: Error\n\t}[] = []\n\n\t// API documentation\n\ttry {\n\t\tconst entries = parseApiDocumentation(node)\n\t\tentries.forEach((param) => {\n\t\t\tendpointData[param.identifier] = param.value as string & string[]\n\t\t})\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'api',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request params\n\ttry {\n\t\tendpointData.requestPathParams = parseRequestParams(node, endpointPath)\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'path',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request query\n\ttry {\n\t\tendpointData.requestQuery = parseRequestObjectInput(node, 'useQueryParams')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'query',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request headers\n\ttry {\n\t\tendpointData.requestHeaders = parseRequestObjectInput(node, 'useHeaderParams')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'headers',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Raw request body\n\ttry {\n\t\tconst parsedBody = parseRequestRawBody(node)\n\t\tif (parsedBody) {\n\t\t\tendpointData.rawBody = parsedBody\n\t\t}\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'rawBody',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Object request body\n\ttry {\n\t\tendpointData.objectBody = parseRequestObjectInput(node, 'useRequestBody')\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'objectBody',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\t// Request response\n\ttry {\n\t\tendpointData.responses = parseRequestResponse(node)\n\t} catch (err) {\n\t\twarningData.push({\n\t\t\tsegment: 'response',\n\t\t\terror: err as Error,\n\t\t})\n\t\tLogger.error('Error', err)\n\t}\n\n\treturn endpointData\n}\n\nconst getHookNode = (\n\tendpointNode: Node<ts.Node>,\n\thookName:\n\t\t| 'useApiEndpoint'\n\t\t| 'usePathParams'\n\t\t| 'useQueryParams'\n\t\t| 'useHeaderParams'\n\t\t| 'useRequestBody'\n\t\t| 'useRequestRawBody',\n) => {\n\tconst callExpressions = endpointNode.getDescendantsOfKind(SyntaxKind.CallExpression)\n\tconst matchingCallExpressions = callExpressions.filter((node) => {\n\t\treturn node.getFirstChildByKind(SyntaxKind.Identifier)?.getText() === hookName\n\t})\n\treturn matchingCallExpressions[0] ?? null\n}\n\nconst parseApiDocumentation = (node: Node<ts.Node>) => {\n\tconst hookNode = getHookNode(node, 'useApiEndpoint')\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error('Non-literal type used in useApiEndpoint')\n\t}\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\n\tconst values = getValuesOfObjectLiteral(objectLiteral).filter((param) => param.value !== null)\n\treturn values as {\n\t\tidentifier: keyof ApiEndpointDocs\n\t\tvalue: (typeof values)[number]['value']\n\t}[]\n}\n\nconst parseRequestParams = (node: Node<ts.Node>, endpointPath: string): EndpointData['requestPathParams'] => {\n\tconst hookNode = getHookNode(node, 'usePathParams')\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error('Non-literal type used in usePathParams')\n\t}\n\n\tconst declaredParams = endpointPath\n\t\t.split('/')\n\t\t.filter((segment) => segment.startsWith(':'))\n\t\t.map((segment) => ({\n\t\t\tname: segment.substring(1).replace(/\\?/, ''),\n\t\t\toptional: segment.includes('?'),\n\t\t}))\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\treturn getShapeOfValidatorLiteral(objectLiteral)\n\t\t.filter((param) => param.shape !== null)\n\t\t.map((param) => ({\n\t\t\tidentifier: param.identifier,\n\t\t\tsignature: param.shape as string,\n\t\t\toptional: declaredParams.some((declared) => declared.name === param.identifier && declared.optional),\n\t\t\tdescription: param.description,\n\t\t\terrorMessage: param.errorMessage,\n\t\t}))\n}\n\nconst parseRequestRawBody = (node: Node<ts.Node>): NonNullable<EndpointData['rawBody']> | null => {\n\tconst hookNode = getHookNode(node, 'useRequestRawBody')\n\tif (!hookNode) {\n\t\treturn null\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(\n\t\tparamNode.getLastChild((node) => !node.isKind(SyntaxKind.CommaToken))!,\n\t)\n\n\treturn {\n\t\tsignature: getValidatorPropertyShape(valueNode),\n\t\toptional: getValidatorPropertyOptionality(valueNode),\n\t\tdescription: getValidatorPropertyStringValue(valueNode, 'description'),\n\t\terrorMessage: getValidatorPropertyStringValue(valueNode, 'errorMessage'),\n\t}\n}\n\nconst parseRequestObjectInput = (\n\tnode: Node<ts.Node>,\n\tnodeName: 'useQueryParams' | 'useHeaderParams' | 'useRequestBody',\n): EndpointData['requestQuery'] | EndpointData['objectBody'] => {\n\tconst hookNode = getHookNode(node, nodeName)\n\tif (!hookNode) {\n\t\treturn []\n\t}\n\tconst paramNode = hookNode.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\tconst valueNode = findNodeImplementation(paramNode.getLastChild()!)\n\n\tif (!valueNode.isKind(SyntaxKind.ObjectLiteralExpression)) {\n\t\tthrow new Error(`Non-literal type used in ${nodeName}`)\n\t}\n\n\tconst objectLiteral = valueNode.asKind(SyntaxKind.ObjectLiteralExpression)!\n\treturn getShapeOfValidatorLiteral(objectLiteral)\n\t\t.filter((param) => param.shape !== null)\n\t\t.map((param) => ({\n\t\t\tidentifier: param.identifier,\n\t\t\tsignature: param.shape as string,\n\t\t\toptional: param.optional,\n\t\t\tdescription: param.description,\n\t\t\terrorMessage: param.errorMessage,\n\t\t}))\n}\n\nconst parseRequestResponse = (node: Node<ts.Node>): EndpointData['responses'] => {\n\tconst implementationNode = node\n\t\t.getFirstChildByKind(SyntaxKind.CallExpression)!\n\t\t.getFirstChildByKind(SyntaxKind.SyntaxList)!\n\t\t.getFirstChildByKind(SyntaxKind.ArrowFunction)!\n\tconst returnType = implementationNode.getReturnType()\n\n\tconst actualType = (() => {\n\t\tif (returnType.getText().startsWith('Promise')) {\n\t\t\treturn returnType.getTypeArguments()[0]\n\t\t}\n\t\treturn returnType\n\t})()\n\n\tconst responseType = getProperTypeShape(actualType, node)\n\n\treturn parseResponseTypes(responseType)\n}\n\nconst parseResponseTypes = (\n\tresponseType: ReturnType<typeof getProperTypeShape>,\n): EndpointData['responses'] => {\n\t// TODO: Add support for response descriptions and errors\n\tif (typeof responseType === 'string') {\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus: responseType === 'void' || responseType === 'null' ? 204 : 200,\n\t\t\t\tcontentType: 'text/plain',\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\tif (responseType[0].role === 'union_entry' || responseType[0].role === 'literal_string') {\n\t\treturn parseResponseTypes(responseType[0].shape)\n\t}\n\n\t// Response type is a useReturnValue hook\n\tif (responseType[0].role === 'property' && responseType[0].identifier === '_isUseReturnValue') {\n\t\tconst status = (() => {\n\t\t\tconst property = responseType.find(\n\t\t\t\t(response) => response.role === 'property' && response.identifier === 'status',\n\t\t\t)?.shape\n\t\t\tif (!property || typeof property === 'string' || typeof property[0].shape !== 'string') {\n\t\t\t\tthrow new Error('Invalid useReturnValue hook')\n\t\t\t}\n\t\t\treturn parseInt(property[0].shape)\n\t\t})()\n\t\tconst contentType = (() => {\n\t\t\tconst property = responseType.find(\n\t\t\t\t(response) => response.role === 'property' && response.identifier === 'contentType',\n\t\t\t)?.shape\n\t\t\tif (!property || typeof property === 'string' || typeof property[0].shape !== 'string') {\n\t\t\t\tthrow new Error('Invalid useReturnValue hook')\n\t\t\t}\n\t\t\treturn property[0].shape\n\t\t})()\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus,\n\t\t\t\tcontentType,\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\tif (responseType[0].role === 'union') {\n\t\tif (typeof responseType[0].shape === 'string') {\n\t\t\treturn [\n\t\t\t\t{\n\t\t\t\t\tstatus: responseType[0].shape === 'void' || responseType[0].shape === 'null' ? 204 : 200,\n\t\t\t\t\tcontentType: 'application/json',\n\t\t\t\t\tsignature: responseType[0].shape,\n\t\t\t\t\tdescription: '',\n\t\t\t\t\terrorMessage: '',\n\t\t\t\t},\n\t\t\t]\n\t\t}\n\n\t\treturn responseType[0].shape.flatMap((unionEntry) => {\n\t\t\treturn parseResponseTypes([unionEntry])\n\t\t})\n\t}\n\n\tif (responseType[0].role === 'buffer') {\n\t\treturn [\n\t\t\t{\n\t\t\t\tstatus: 200,\n\t\t\t\tcontentType: 'application/octet-stream',\n\t\t\t\tsignature: responseType,\n\t\t\t\tdescription: '',\n\t\t\t\terrorMessage: '',\n\t\t\t},\n\t\t]\n\t}\n\n\treturn [\n\t\t{\n\t\t\tstatus: 200,\n\t\t\tcontentType: 'application/json',\n\t\t\tsignature: responseType,\n\t\t\tdescription: '',\n\t\t\terrorMessage: '',\n\t\t},\n\t]\n}\n"],"names":["parseEndpoint","node","sourceFilePath","parsedEndpointMethod","SyntaxKind","endpointMethod","endpointPath","resolveEndpointPath","endpointData","parseApiDocumentation","param","err","Logger","parseRequestParams","parseRequestObjectInput","parsedBody","parseRequestRawBody","parseRequestResponse","getHookNode","endpointNode","hookName","hookNode","paramNode","valueNode","findNodeImplementation","objectLiteral","getValuesOfObjectLiteral","declaredParams","segment","getShapeOfValidatorLiteral","declared","getValidatorPropertyShape","getValidatorPropertyOptionality","getValidatorPropertyStringValue","nodeName","returnType","actualType","responseType","getProperTypeShape","parseResponseTypes","status","property","response","contentType","unionEntry"],"mappings":"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"}

package/dist/openapi/analyzerModule/test/TestCase.d.ts

@@ -0,0 +1,9 @@
+export declare const TestCase: {
+    readonly parsesInlineZodNumber: "parses-inline-zod-number";
+    readonly parsesInlineZodString: "parses-inline-zod-string";
+    readonly parsesInlineZodObject: "parses-inline-zod-object";
+    readonly parsesInlineZodNumberArray: "parses-inline-zod-number-array";
+    readonly parsesInlineZodObjectArray: "parses-inline-zod-object-array";
+    readonly parsedAliasedZodSchema: "parses-aliased-zod-schema";
+};
+//# sourceMappingURL=TestCase.d.ts.map

package/dist/openapi/analyzerModule/test/TestCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestCase.d.ts","sourceRoot":"","sources":["../../../../src/openapi/analyzerModule/test/TestCase.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;;;;CAOX,CAAA"}

package/dist/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openApiAnalyzer.zod.spec.d.ts.map

package/dist/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiAnalyzer.zod.spec.d.ts","sourceRoot":"","sources":["../../../../src/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.ts"],"names":[],"mappings":""}

package/dist/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.data.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=openApiAnalyzer.zod.spec.data.d.ts.map

package/dist/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiAnalyzer.zod.spec.data.d.ts","sourceRoot":"","sources":["../../../../src/openapi/analyzerModule/test/openApiAnalyzer.zod.spec.data.ts"],"names":[],"mappings":""}

package/dist/utils/getValueAsNullableString.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function e(t){return t===null?null:typeof t=="object"?JSON.stringify(t):String(t)}exports.getValueAsNullableString=e;
+//# sourceMappingURL=getValueAsNullableString.cjs.map

package/dist/utils/getValueAsNullableString.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getValueAsNullableString.cjs","sources":["../../src/utils/getValueAsNullableString.ts"],"sourcesContent":["export function getValueAsNullableString(value: unknown) {\n\tif (value === null) {\n\t\treturn null\n\t} else if (typeof value === 'object') {\n\t\treturn JSON.stringify(value)\n\t}\n\treturn String(value)\n}\n"],"names":["getValueAsNullableString","value"],"mappings":"gFAAO,SAASA,EAAyBC,EAAgB,CACxD,OAAIA,IAAU,KACN,KACG,OAAOA,GAAU,SACpB,KAAK,UAAUA,CAAK,EAErB,OAAOA,CAAK,CACpB"}

package/dist/utils/getValueAsNullableString.d.ts

@@ -0,0 +1,2 @@
+export declare function getValueAsNullableString(value: unknown): string | null;
+//# sourceMappingURL=getValueAsNullableString.d.ts.map

package/dist/utils/getValueAsNullableString.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getValueAsNullableString.d.ts","sourceRoot":"","sources":["../../src/utils/getValueAsNullableString.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,iBAOtD"}

package/dist/utils/getValueAsNullableString.mjs

@@ -0,0 +1,7 @@
+function n(t) {
+  return t === null ? null : typeof t == "object" ? JSON.stringify(t) : String(t);
+}
+export {
+  n as getValueAsNullableString
+};
+//# sourceMappingURL=getValueAsNullableString.mjs.map

package/dist/utils/getValueAsNullableString.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getValueAsNullableString.mjs","sources":["../../src/utils/getValueAsNullableString.ts"],"sourcesContent":["export function getValueAsNullableString(value: unknown) {\n\tif (value === null) {\n\t\treturn null\n\t} else if (typeof value === 'object') {\n\t\treturn JSON.stringify(value)\n\t}\n\treturn String(value)\n}\n"],"names":["getValueAsNullableString","value"],"mappings":"AAAO,SAASA,EAAyBC,GAAgB;AACxD,SAAIA,MAAU,OACN,OACG,OAAOA,KAAU,WACpB,KAAK,UAAUA,CAAK,IAErB,OAAOA,CAAK;AACpB;"}

package/dist/utils/validationMessages.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=e=>{const i="name"in e?e.name:e.originalName,{description:a}=e.validator;return a?`'${i}' (${a})`:`'${i}'`},t=e=>{const i="name"in e?e.name:e.originalName,{description:a,errorMessage:n}=e.validator;return n?`'${i}' (${n})`:a?`'${i}' (${a})`:`'${i}'`},o=e=>{const{description:i}=e;return i?`Missing request body (${i}).`:"Missing request body."},r=e=>{const{description:i,errorMessage:a}=e;return a?`Failed request body validation (${a}).`:i?`Failed request body validation (${i}).`:"Failed request body validation."};exports.getFailedRawBodyValidationMessage=r;exports.getMissingParamMessage=s;exports.getMissingRawBodyMessage=o;exports.getValidationResultMessage=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=e=>{const i="name"in e?e.name:e.originalName,{description:a}=e.validator;return a?`'${i}' (${a})`:`'${i}'`},r=(e,i)=>{const a="name"in e?e.name:e.originalName,{description:n,errorMessage:s}=e.validator;return i?`'${a}' (${i})`:s?`'${a}' (${s})`:n?`'${a}' (${n})`:`'${a}'`},o=e=>{const{description:i}=e;return i?`Missing request body (${i}).`:"Missing request body."},d=e=>{const{description:i,errorMessage:a}=e;return a?`Failed request body validation (${a}).`:i?`Failed request body validation (${i}).`:"Failed request body validation."};exports.getFailedRawBodyValidationMessage=d;exports.getMissingParamMessage=t;exports.getMissingRawBodyMessage=o;exports.getValidationResultMessage=r;
 //# sourceMappingURL=validationMessages.cjs.map

package/dist/utils/validationMessages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validationMessages.cjs","sources":["../../src/utils/validationMessages.ts"],"sourcesContent":["import { Validator } from '../validators/types'\n\nexport const getMissingParamMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description } = result.validator\n\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getValidationResultMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description, errorMessage } = result.validator\n\n\tif (errorMessage) {\n\t\treturn `'${name}' (${errorMessage})`\n\t}\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getMissingRawBodyMessage = (validator: Validator<unknown>) => {\n\tconst { description } = validator\n\n\tif (description) {\n\t\treturn `Missing request body (${description}).`\n\t}\n\treturn 'Missing request body.'\n}\n\nexport const getFailedRawBodyValidationMessage = (validator: Validator<unknown>) => {\n\tconst { description, errorMessage } = validator\n\n\tif (errorMessage) {\n\t\treturn `Failed request body validation (${errorMessage}).`\n\t}\n\tif (description) {\n\t\treturn `Failed request body validation (${description}).`\n\t}\n\treturn 'Failed request body validation.'\n}\n"],"names":["getMissingParamMessage","result","name","description","getValidationResultMessage","errorMessage","getMissingRawBodyMessage","validator","getFailedRawBodyValidationMessage"],"mappings":"gFAEa,MAAAA,EACZC,GASI,CACJ,MAAMC,EAAO,SAAUD,EAASA,EAAO,KAAOA,EAAO,aAC/C,CAAE,YAAAE,GAAgBF,EAAO,UAE/B,OAAIE,EACI,IAAID,CAAI,MAAMC,CAAW,IAE1B,IAAID,CAAI,GAChB,EAEaE,EACZH,GASI,CACJ,MAAMC,EAAO,SAAUD,EAASA,EAAO,KAAOA,EAAO,aAC/C,CAAE,YAAAE,EAAa,aAAAE,CAAa,EAAIJ,EAAO,UAE7C,OAAII,EACI,IAAIH,CAAI,MAAMG,CAAY,IAE9BF,EACI,IAAID,CAAI,MAAMC,CAAW,IAE1B,IAAID,CAAI,GAChB,EAEaI,EAA4BC,GAAkC,CACpE,KAAA,CAAE,YAAAJ,GAAgBI,EAExB,OAAIJ,EACI,yBAAyBA,CAAW,KAErC,uBACR,EAEaK,EAAqCD,GAAkC,CAC7E,KAAA,CAAE,YAAAJ,EAAa,aAAAE,CAAA,EAAiBE,EAEtC,OAAIF,EACI,mCAAmCA,CAAY,KAEnDF,EACI,mCAAmCA,CAAW,KAE/C,iCACR"}
+{"version":3,"file":"validationMessages.cjs","sources":["../../src/utils/validationMessages.ts"],"sourcesContent":["import { Validator } from '../validators/types'\n\nexport const getMissingParamMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description } = result.validator\n\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getValidationResultMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n\texception?: string | null,\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description, errorMessage } = result.validator\n\n\tif (exception) {\n\t\treturn `'${name}' (${exception})`\n\t}\n\tif (errorMessage) {\n\t\treturn `'${name}' (${errorMessage})`\n\t}\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getMissingRawBodyMessage = (validator: Validator<unknown>) => {\n\tconst { description } = validator\n\n\tif (description) {\n\t\treturn `Missing request body (${description}).`\n\t}\n\treturn 'Missing request body.'\n}\n\nexport const getFailedRawBodyValidationMessage = (validator: Validator<unknown>) => {\n\tconst { description, errorMessage } = validator\n\n\tif (errorMessage) {\n\t\treturn `Failed request body validation (${errorMessage}).`\n\t}\n\tif (description) {\n\t\treturn `Failed request body validation (${description}).`\n\t}\n\treturn 'Failed request body validation.'\n}\n"],"names":["getMissingParamMessage","result","name","description","getValidationResultMessage","exception","errorMessage","getMissingRawBodyMessage","validator","getFailedRawBodyValidationMessage"],"mappings":"gFAEa,MAAAA,EACZC,GASI,CACJ,MAAMC,EAAO,SAAUD,EAASA,EAAO,KAAOA,EAAO,aAC/C,CAAE,YAAAE,GAAgBF,EAAO,UAE/B,OAAIE,EACI,IAAID,CAAI,MAAMC,CAAW,IAE1B,IAAID,CAAI,GAChB,EAEaE,EAA6B,CACzCH,EASAI,IACI,CACJ,MAAMH,EAAO,SAAUD,EAASA,EAAO,KAAOA,EAAO,aAC/C,CAAE,YAAAE,EAAa,aAAAG,CAAa,EAAIL,EAAO,UAE7C,OAAII,EACI,IAAIH,CAAI,MAAMG,CAAS,IAE3BC,EACI,IAAIJ,CAAI,MAAMI,CAAY,IAE9BH,EACI,IAAID,CAAI,MAAMC,CAAW,IAE1B,IAAID,CAAI,GAChB,EAEaK,EAA4BC,GAAkC,CACpE,KAAA,CAAE,YAAAL,GAAgBK,EAExB,OAAIL,EACI,yBAAyBA,CAAW,KAErC,uBACR,EAEaM,EAAqCD,GAAkC,CAC7E,KAAA,CAAE,YAAAL,EAAa,aAAAG,CAAA,EAAiBE,EAEtC,OAAIF,EACI,mCAAmCA,CAAY,KAEnDH,EACI,mCAAmCA,CAAW,KAE/C,iCACR"}

package/dist/utils/validationMessages.d.ts

@@ -13,7 +13,7 @@ export declare const getValidationResultMessage: (result: {
 } | {
     originalName: string;
     validator: Pick<Validator<unknown>, "description" | "errorMessage">;
-}) => string;
+}, exception?: string | null) => string;
 export declare const getMissingRawBodyMessage: (validator: Validator<unknown>) => string;
 export declare const getFailedRawBodyValidationMessage: (validator: Validator<unknown>) => string;
 //# sourceMappingURL=validationMessages.d.ts.map

package/dist/utils/validationMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validationMessages.d.ts","sourceRoot":"","sources":["../../src/utils/validationMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,eAAO,MAAM,sBAAsB,WAE/B;IACA,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,GACD;IACA,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,WASJ,CAAA;AAED,eAAO,MAAM,0BAA0B,WAEnC;IACA,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,GACD;IACA,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,WAYJ,CAAA;AAED,eAAO,MAAM,wBAAwB,cAAe,SAAS,CAAC,OAAO,CAAC,WAOrE,CAAA;AAED,eAAO,MAAM,iCAAiC,cAAe,SAAS,CAAC,OAAO,CAAC,WAU9E,CAAA"}
+{"version":3,"file":"validationMessages.d.ts","sourceRoot":"","sources":["../../src/utils/validationMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,eAAO,MAAM,sBAAsB,WAE/B;IACA,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,GACD;IACA,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,WASJ,CAAA;AAED,eAAO,MAAM,0BAA0B,WAEnC;IACA,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,GACD;IACA,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAClE,cACQ,MAAM,GAAG,IAAI,WAezB,CAAA;AAED,eAAO,MAAM,wBAAwB,cAAe,SAAS,CAAC,OAAO,CAAC,WAOrE,CAAA;AAED,eAAO,MAAM,iCAAiC,cAAe,SAAS,CAAC,OAAO,CAAC,WAU9E,CAAA"}

package/dist/utils/validationMessages.mjs

@@ -1,20 +1,20 @@
 const t = (e) => {
   const i = "name" in e ? e.name : e.originalName, { description: n } = e.validator;
   return n ? `'${i}' (${n})` : `'${i}'`;
-}, r = (e) => {
-  const i = "name" in e ? e.name : e.originalName, { description: n, errorMessage: a } = e.validator;
-  return a ? `'${i}' (${a})` : n ? `'${i}' (${n})` : `'${i}'`;
-}, s = (e) => {
+}, s = (e, i) => {
+  const n = "name" in e ? e.name : e.originalName, { description: a, errorMessage: r } = e.validator;
+  return i ? `'${n}' (${i})` : r ? `'${n}' (${r})` : a ? `'${n}' (${a})` : `'${n}'`;
+}, o = (e) => {
   const { description: i } = e;
   return i ? `Missing request body (${i}).` : "Missing request body.";
-}, o = (e) => {
+}, d = (e) => {
   const { description: i, errorMessage: n } = e;
   return n ? `Failed request body validation (${n}).` : i ? `Failed request body validation (${i}).` : "Failed request body validation.";
 };
 export {
-  o as getFailedRawBodyValidationMessage,
+  d as getFailedRawBodyValidationMessage,
   t as getMissingParamMessage,
-  s as getMissingRawBodyMessage,
-  r as getValidationResultMessage
+  o as getMissingRawBodyMessage,
+  s as getValidationResultMessage
 };
 //# sourceMappingURL=validationMessages.mjs.map

package/dist/utils/validationMessages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validationMessages.mjs","sources":["../../src/utils/validationMessages.ts"],"sourcesContent":["import { Validator } from '../validators/types'\n\nexport const getMissingParamMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description } = result.validator\n\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getValidationResultMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description, errorMessage } = result.validator\n\n\tif (errorMessage) {\n\t\treturn `'${name}' (${errorMessage})`\n\t}\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getMissingRawBodyMessage = (validator: Validator<unknown>) => {\n\tconst { description } = validator\n\n\tif (description) {\n\t\treturn `Missing request body (${description}).`\n\t}\n\treturn 'Missing request body.'\n}\n\nexport const getFailedRawBodyValidationMessage = (validator: Validator<unknown>) => {\n\tconst { description, errorMessage } = validator\n\n\tif (errorMessage) {\n\t\treturn `Failed request body validation (${errorMessage}).`\n\t}\n\tif (description) {\n\t\treturn `Failed request body validation (${description}).`\n\t}\n\treturn 'Failed request body validation.'\n}\n"],"names":["getMissingParamMessage","result","name","description","getValidationResultMessage","errorMessage","getMissingRawBodyMessage","validator","getFailedRawBodyValidationMessage"],"mappings":"AAEa,MAAAA,IAAyB,CACrCC,MASI;AACJ,QAAMC,IAAO,UAAUD,IAASA,EAAO,OAAOA,EAAO,cAC/C,EAAE,aAAAE,MAAgBF,EAAO;AAE/B,SAAIE,IACI,IAAID,CAAI,MAAMC,CAAW,MAE1B,IAAID,CAAI;AAChB,GAEaE,IAA6B,CACzCH,MASI;AACJ,QAAMC,IAAO,UAAUD,IAASA,EAAO,OAAOA,EAAO,cAC/C,EAAE,aAAAE,GAAa,cAAAE,EAAa,IAAIJ,EAAO;AAE7C,SAAII,IACI,IAAIH,CAAI,MAAMG,CAAY,MAE9BF,IACI,IAAID,CAAI,MAAMC,CAAW,MAE1B,IAAID,CAAI;AAChB,GAEaI,IAA2B,CAACC,MAAkC;AACpE,QAAA,EAAE,aAAAJ,MAAgBI;AAExB,SAAIJ,IACI,yBAAyBA,CAAW,OAErC;AACR,GAEaK,IAAoC,CAACD,MAAkC;AAC7E,QAAA,EAAE,aAAAJ,GAAa,cAAAE,EAAA,IAAiBE;AAEtC,SAAIF,IACI,mCAAmCA,CAAY,OAEnDF,IACI,mCAAmCA,CAAW,OAE/C;AACR;"}
+{"version":3,"file":"validationMessages.mjs","sources":["../../src/utils/validationMessages.ts"],"sourcesContent":["import { Validator } from '../validators/types'\n\nexport const getMissingParamMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description } = result.validator\n\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getValidationResultMessage = (\n\tresult:\n\t\t| {\n\t\t\t\tname: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  }\n\t\t| {\n\t\t\t\toriginalName: string\n\t\t\t\tvalidator: Pick<Validator<unknown>, 'description' | 'errorMessage'>\n\t\t  },\n\texception?: string | null,\n) => {\n\tconst name = 'name' in result ? result.name : result.originalName\n\tconst { description, errorMessage } = result.validator\n\n\tif (exception) {\n\t\treturn `'${name}' (${exception})`\n\t}\n\tif (errorMessage) {\n\t\treturn `'${name}' (${errorMessage})`\n\t}\n\tif (description) {\n\t\treturn `'${name}' (${description})`\n\t}\n\treturn `'${name}'`\n}\n\nexport const getMissingRawBodyMessage = (validator: Validator<unknown>) => {\n\tconst { description } = validator\n\n\tif (description) {\n\t\treturn `Missing request body (${description}).`\n\t}\n\treturn 'Missing request body.'\n}\n\nexport const getFailedRawBodyValidationMessage = (validator: Validator<unknown>) => {\n\tconst { description, errorMessage } = validator\n\n\tif (errorMessage) {\n\t\treturn `Failed request body validation (${errorMessage}).`\n\t}\n\tif (description) {\n\t\treturn `Failed request body validation (${description}).`\n\t}\n\treturn 'Failed request body validation.'\n}\n"],"names":["getMissingParamMessage","result","name","description","getValidationResultMessage","exception","errorMessage","getMissingRawBodyMessage","validator","getFailedRawBodyValidationMessage"],"mappings":"AAEa,MAAAA,IAAyB,CACrCC,MASI;AACJ,QAAMC,IAAO,UAAUD,IAASA,EAAO,OAAOA,EAAO,cAC/C,EAAE,aAAAE,MAAgBF,EAAO;AAE/B,SAAIE,IACI,IAAID,CAAI,MAAMC,CAAW,MAE1B,IAAID,CAAI;AAChB,GAEaE,IAA6B,CACzCH,GASAI,MACI;AACJ,QAAMH,IAAO,UAAUD,IAASA,EAAO,OAAOA,EAAO,cAC/C,EAAE,aAAAE,GAAa,cAAAG,EAAa,IAAIL,EAAO;AAE7C,SAAII,IACI,IAAIH,CAAI,MAAMG,CAAS,MAE3BC,IACI,IAAIJ,CAAI,MAAMI,CAAY,MAE9BH,IACI,IAAID,CAAI,MAAMC,CAAW,MAE1B,IAAID,CAAI;AAChB,GAEaK,IAA2B,CAACC,MAAkC;AACpE,QAAA,EAAE,aAAAL,MAAgBK;AAExB,SAAIL,IACI,yBAAyBA,CAAW,OAErC;AACR,GAEaM,IAAoC,CAACD,MAAkC;AAC7E,QAAA,EAAE,aAAAL,GAAa,cAAAG,EAAA,IAAiBE;AAEtC,SAAIF,IACI,mCAAmCA,CAAY,OAEnDH,IACI,mCAAmCA,CAAW,OAE/C;AACR;"}

package/dist/validators/types.d.ts

@@ -1,3 +1,5 @@
+import { default as z } from 'zod';
+
 type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends Array<infer U> ? Array<DeepPartial<U>> : T[P] extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : DeepPartial<T[P]>;
 };
@@ -14,5 +16,7 @@ export type BuiltInValidator<T, DescriptionT extends string, ErrorMessageT exten
     description: DescriptionT;
     errorMessage: ErrorMessageT;
 };
+export type ValidatorUnion = Omit<Validator<any>, 'optional'> | z.ZodType;
+export type MaybeOptionalValidatorUnion = Validator<any> | z.ZodType;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/validators/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validators/types.ts"],"names":[],"mappings":"AAAA,KAAK,WAAW,CAAC,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACzC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAClC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAElE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAC1B,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAMzC,QAAQ,EAAE,OAAO,CAAA;IAKjB,WAAW,CAAC,EAAE,MAAM,CAAA;IAIpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,YAAY,SAAS,MAAM,EAAE,aAAa,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IAC3G,WAAW,EAAE,YAAY,CAAA;IACzB,YAAY,EAAE,aAAa,CAAA;CAC3B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/validators/types.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAA;AAEnB,KAAK,WAAW,CAAC,CAAC,IAAI;KACpB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACzC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrB,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAClC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAElE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAC1B,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAA;IAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,KAAK,CAAC,CAAA;IAC9B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAMzC,QAAQ,EAAE,OAAO,CAAA;IAKjB,WAAW,CAAC,EAAE,MAAM,CAAA;IAIpB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,YAAY,SAAS,MAAM,EAAE,aAAa,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IAC3G,WAAW,EAAE,YAAY,CAAA;IACzB,YAAY,EAAE,aAAa,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;AACzE,MAAM,MAAM,2BAA2B,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA"}

package/dist/validators/validateMissingParams.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("../node_modules/zod/v4/classic/external.cjs"),g=require("../errors/UserFacingErrors.cjs"),c=require("../utils/validationMessages.cjs");function l(r,a,s,t){const i=r.filter(e=>{let n=s[e.name].optional;return s[e.name]instanceof o.ZodType&&(n=s[e.name].safeParse(void 0).success),a[e.name]===void 0&&!n});if(i.length>0)throw new g.ValidationError(`Missing ${t} params: ${i.map(e=>c.getMissingParamMessage(e)).join(", ")}`)}exports.validateMissingParams=l;
+//# sourceMappingURL=validateMissingParams.cjs.map

package/dist/validators/validateMissingParams.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMissingParams.cjs","sources":["../../src/validators/validateMissingParams.ts"],"sourcesContent":["import z from 'zod'\n\nimport { ValidationError } from '../errors/UserFacingErrors'\nimport { getMissingParamMessage } from '../utils/validationMessages'\nimport { MaybeOptionalValidatorUnion, Validator } from './types'\n\nexport function validateMissingParams<ValidatorsT extends Record<string, MaybeOptionalValidatorUnion>>(\n\tparams: { name: string; validator: Pick<Validator<unknown>, 'description' | 'errorMessage'> }[],\n\tprovidedParams: Record<string, unknown>,\n\tvalidators: ValidatorsT,\n\tsuffix: 'body' | 'query' | 'path',\n) {\n\tconst missingParams = params.filter((param) => {\n\t\tlet isOptional = validators[param.name].optional\n\t\tif (validators[param.name] instanceof z.ZodType) {\n\t\t\tisOptional = (validators[param.name] as z.ZodType).safeParse(undefined).success\n\t\t}\n\n\t\treturn providedParams[param.name] === undefined && !isOptional\n\t})\n\n\tif (missingParams.length > 0) {\n\t\tthrow new ValidationError(\n\t\t\t`Missing ${suffix} params: ${missingParams.map((param) => getMissingParamMessage(param)).join(', ')}`,\n\t\t)\n\t}\n}\n"],"names":["validateMissingParams","params","providedParams","validators","suffix","missingParams","param","isOptional","z","ValidationError","getMissingParamMessage"],"mappings":"wOAMO,SAASA,EACfC,EACAC,EACAC,EACAC,EACC,CACD,MAAMC,EAAgBJ,EAAO,OAAQK,GAAU,CAC9C,IAAIC,EAAaJ,EAAWG,EAAM,IAAI,EAAE,SACxC,OAAIH,EAAWG,EAAM,IAAI,YAAaE,EAAE,UACvCD,EAAcJ,EAAWG,EAAM,IAAI,EAAgB,UAAU,MAAS,EAAE,SAGlEJ,EAAeI,EAAM,IAAI,IAAM,QAAa,CAACC,CAAA,CACpD,EAEG,GAAAF,EAAc,OAAS,EAC1B,MAAM,IAAII,EAAA,gBACT,WAAWL,CAAM,YAAYC,EAAc,IAAKC,GAAUI,EAAAA,uBAAuBJ,CAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EACpG,CAEF"}

package/dist/validators/validateMissingParams.d.ts

@@ -0,0 +1,7 @@
+import { MaybeOptionalValidatorUnion, Validator } from './types';
+
+export declare function validateMissingParams<ValidatorsT extends Record<string, MaybeOptionalValidatorUnion>>(params: {
+    name: string;
+    validator: Pick<Validator<unknown>, 'description' | 'errorMessage'>;
+}[], providedParams: Record<string, unknown>, validators: ValidatorsT, suffix: 'body' | 'query' | 'path'): void;
+//# sourceMappingURL=validateMissingParams.d.ts.map

package/dist/validators/validateMissingParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMissingParams.d.ts","sourceRoot":"","sources":["../../src/validators/validateMissingParams.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,2BAA2B,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEhE,wBAAgB,qBAAqB,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACpG,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAA;CAAE,EAAE,EAC/F,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,UAAU,EAAE,WAAW,EACvB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,QAgBjC"}

package/dist/validators/validateMissingParams.mjs

@@ -0,0 +1,17 @@
+import * as r from "../node_modules/zod/v4/classic/external.mjs";
+import { ValidationError as m } from "../errors/UserFacingErrors.mjs";
+import { getMissingParamMessage as f } from "../utils/validationMessages.mjs";
+function p(o, t, e, a) {
+  const n = o.filter((i) => {
+    let s = e[i.name].optional;
+    return e[i.name] instanceof r.ZodType && (s = e[i.name].safeParse(void 0).success), t[i.name] === void 0 && !s;
+  });
+  if (n.length > 0)
+    throw new m(
+      `Missing ${a} params: ${n.map((i) => f(i)).join(", ")}`
+    );
+}
+export {
+  p as validateMissingParams
+};
+//# sourceMappingURL=validateMissingParams.mjs.map

package/dist/validators/validateMissingParams.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateMissingParams.mjs","sources":["../../src/validators/validateMissingParams.ts"],"sourcesContent":["import z from 'zod'\n\nimport { ValidationError } from '../errors/UserFacingErrors'\nimport { getMissingParamMessage } from '../utils/validationMessages'\nimport { MaybeOptionalValidatorUnion, Validator } from './types'\n\nexport function validateMissingParams<ValidatorsT extends Record<string, MaybeOptionalValidatorUnion>>(\n\tparams: { name: string; validator: Pick<Validator<unknown>, 'description' | 'errorMessage'> }[],\n\tprovidedParams: Record<string, unknown>,\n\tvalidators: ValidatorsT,\n\tsuffix: 'body' | 'query' | 'path',\n) {\n\tconst missingParams = params.filter((param) => {\n\t\tlet isOptional = validators[param.name].optional\n\t\tif (validators[param.name] instanceof z.ZodType) {\n\t\t\tisOptional = (validators[param.name] as z.ZodType).safeParse(undefined).success\n\t\t}\n\n\t\treturn providedParams[param.name] === undefined && !isOptional\n\t})\n\n\tif (missingParams.length > 0) {\n\t\tthrow new ValidationError(\n\t\t\t`Missing ${suffix} params: ${missingParams.map((param) => getMissingParamMessage(param)).join(', ')}`,\n\t\t)\n\t}\n}\n"],"names":["validateMissingParams","params","providedParams","validators","suffix","missingParams","param","isOptional","z","ValidationError","getMissingParamMessage"],"mappings":";;;AAMO,SAASA,EACfC,GACAC,GACAC,GACAC,GACC;AACD,QAAMC,IAAgBJ,EAAO,OAAO,CAACK,MAAU;AAC9C,QAAIC,IAAaJ,EAAWG,EAAM,IAAI,EAAE;AACxC,WAAIH,EAAWG,EAAM,IAAI,aAAaE,EAAE,YACvCD,IAAcJ,EAAWG,EAAM,IAAI,EAAgB,UAAU,MAAS,EAAE,UAGlEJ,EAAeI,EAAM,IAAI,MAAM,UAAa,CAACC;AAAA,EAAA,CACpD;AAEG,MAAAF,EAAc,SAAS;AAC1B,UAAM,IAAII;AAAA,MACT,WAAWL,CAAM,YAAYC,EAAc,IAAI,CAACC,MAAUI,EAAuBJ,CAAK,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA,IACpG;AAEF;"}

package/dist/validators/validateParam.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("../node_modules/zod/v4/classic/external.cjs"),a=require("../utils/getValueAsNullableString.cjs"),c=require("../node_modules/zod/v4/classic/errors.cjs");function o(e,r){try{const t=s(e,r),n=l(e,r),u=f(e,n);return{validated:t&&u,parsedValue:n,exception:null}}catch(t){return{validated:!1,parsedValue:null,exception:p(t)}}}function s(e,r){return"prevalidate"in e&&typeof e.prevalidate=="function"?e.prevalidate(a.getValueAsNullableString(r)):!0}function l(e,r){if(e instanceof i.ZodType){const t=(()=>{try{return typeof r=="string"?JSON.parse(r):r}catch{return r}})();return e.parse(t)}return e.parse(a.getValueAsNullableString(r))}function f(e,r){return"validate"in e&&typeof e.validate=="function"?e.validate(r):!0}function p(e){return e instanceof c.ZodError?i.treeifyError(e).errors.join("; ").replace("Invalid input: ",""):"Validation failed"}exports.validateParam=o;
+//# sourceMappingURL=validateParam.cjs.map

package/dist/validators/validateParam.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateParam.cjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst coercedValue = (() => {\n\t\t\ttry {\n\t\t\t\treturn typeof value === 'string' ? JSON.parse(value) : value\n\t\t\t} catch {\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","z","coercedValue","ZodError"],"mappings":"yPAKgB,SAAAA,EACfC,EACAC,EAKC,CACG,GAAA,CACG,MAAAC,EAAsBC,EAAgBH,EAAWC,CAAK,EACtDG,EAAcC,EAAUL,EAAWC,CAAK,EACxCK,EAAmBC,EAAaP,EAAWI,CAAW,EAErD,MAAA,CACN,UAAWF,GAAuBI,EAClC,YAAAF,EACA,UAAW,IACZ,QACQI,EAAO,CAEf,MAAO,CAAE,UAAW,GAAO,YAAa,KAAM,UAD5BC,EAAgBD,CAAK,CACiB,CAAA,CAE1D,CAEA,SAASL,EAAgBH,EAA2BC,EAAkD,CAErG,MAAI,gBAAiBD,GAAa,OAAOA,EAAU,aAAgB,WAC3DA,EAAU,YAAYU,EAAyB,yBAAAT,CAAK,CAAC,EAGtD,EACR,CAEA,SAASI,EAAUL,EAA2BC,EAAkD,CAE3F,GAAAD,aAAqBW,EAAE,QAAS,CACnC,MAAMC,GAAgB,IAAM,CACvB,GAAA,CACH,OAAO,OAAOX,GAAU,SAAW,KAAK,MAAMA,CAAK,EAAIA,CAAA,MAChD,CACA,OAAAA,CAAA,CACR,GACE,EACI,OAAAD,EAAU,MAAMY,CAAY,CAAA,CAGpC,OAAOZ,EAAU,MAAMU,EAAyB,yBAAAT,CAAK,CAAC,CACvD,CAEA,SAASM,EAAaP,EAA2BI,EAAsB,CAEtE,MAAI,aAAcJ,GAAa,OAAOA,EAAU,UAAa,WACrDA,EAAU,SAASI,CAAW,EAG/B,EACR,CAEA,SAASK,EAAgBD,EAAgB,CACxC,OAAIA,aAAiBK,EAAAA,SACbF,EAAE,aAAaH,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,kBAAmB,EAAE,EAEtE,mBACR"}

package/dist/validators/validateParam.d.ts

@@ -0,0 +1,8 @@
+import { ValidatorUnion } from './types';
+
+export declare function validateParam(validator: ValidatorUnion, value: string | number | boolean | object | null): {
+    validated: boolean;
+    parsedValue: unknown;
+    exception: string | null;
+};
+//# sourceMappingURL=validateParam.d.ts.map

package/dist/validators/validateParam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateParam.d.ts","sourceRoot":"","sources":["../../src/validators/validateParam.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC,wBAAgB,aAAa,CAC5B,SAAS,EAAE,cAAc,EACzB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAC9C;IACF,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAeA"}

package/dist/validators/validateParam.mjs

@@ -0,0 +1,41 @@
+import * as i from "../node_modules/zod/v4/classic/external.mjs";
+import { getValueAsNullableString as o } from "../utils/getValueAsNullableString.mjs";
+import { ZodError as u } from "../node_modules/zod/v4/classic/errors.mjs";
+function m(r, e) {
+  try {
+    const t = c(r, e), n = s(r, e), a = f(r, n);
+    return {
+      validated: t && a,
+      parsedValue: n,
+      exception: null
+    };
+  } catch (t) {
+    return { validated: !1, parsedValue: null, exception: p(t) };
+  }
+}
+function c(r, e) {
+  return "prevalidate" in r && typeof r.prevalidate == "function" ? r.prevalidate(o(e)) : !0;
+}
+function s(r, e) {
+  if (r instanceof i.ZodType) {
+    const t = (() => {
+      try {
+        return typeof e == "string" ? JSON.parse(e) : e;
+      } catch {
+        return e;
+      }
+    })();
+    return r.parse(t);
+  }
+  return r.parse(o(e));
+}
+function f(r, e) {
+  return "validate" in r && typeof r.validate == "function" ? r.validate(e) : !0;
+}
+function p(r) {
+  return r instanceof u ? i.treeifyError(r).errors.join("; ").replace("Invalid input: ", "") : "Validation failed";
+}
+export {
+  m as validateParam
+};
+//# sourceMappingURL=validateParam.mjs.map

package/dist/validators/validateParam.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateParam.mjs","sources":["../../src/validators/validateParam.ts"],"sourcesContent":["import z, { ZodError } from 'zod'\n\nimport { getValueAsNullableString } from '../utils/getValueAsNullableString'\nimport { ValidatorUnion } from './types'\n\nexport function validateParam(\n\tvalidator: ValidatorUnion,\n\tvalue: string | number | boolean | object | null,\n): {\n\tvalidated: boolean\n\tparsedValue: unknown\n\texception: string | null\n} {\n\ttry {\n\t\tconst prevalidatorSuccess = runPrevalidator(validator, value)\n\t\tconst parsedValue = runParser(validator, value)\n\t\tconst validatorSuccess = runValidator(validator, parsedValue)\n\n\t\treturn {\n\t\t\tvalidated: prevalidatorSuccess && validatorSuccess,\n\t\t\tparsedValue,\n\t\t\texception: null,\n\t\t}\n\t} catch (error) {\n\t\tconst exception = getErrorMessage(error)\n\t\treturn { validated: false, parsedValue: null, exception }\n\t}\n}\n\nfunction runPrevalidator(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Legacy validator\n\tif ('prevalidate' in validator && typeof validator.prevalidate === 'function') {\n\t\treturn validator.prevalidate(getValueAsNullableString(value))\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction runParser(validator: ValidatorUnion, value: string | number | boolean | object | null) {\n\t// Zod validator\n\tif (validator instanceof z.ZodType) {\n\t\tconst coercedValue = (() => {\n\t\t\ttry {\n\t\t\t\treturn typeof value === 'string' ? JSON.parse(value) : value\n\t\t\t} catch {\n\t\t\t\treturn value\n\t\t\t}\n\t\t})()\n\t\treturn validator.parse(coercedValue)\n\t}\n\t// Legacy validator\n\treturn validator.parse(getValueAsNullableString(value))\n}\n\nfunction runValidator(validator: ValidatorUnion, parsedValue: unknown) {\n\t// Legacy validator\n\tif ('validate' in validator && typeof validator.validate === 'function') {\n\t\treturn validator.validate(parsedValue)\n\t}\n\t// Zod (skip)\n\treturn true\n}\n\nfunction getErrorMessage(error: unknown) {\n\tif (error instanceof ZodError) {\n\t\treturn z.treeifyError(error).errors.join('; ').replace('Invalid input: ', '')\n\t}\n\treturn 'Validation failed'\n}\n"],"names":["validateParam","validator","value","prevalidatorSuccess","runPrevalidator","parsedValue","runParser","validatorSuccess","runValidator","error","getErrorMessage","getValueAsNullableString","z","coercedValue","ZodError"],"mappings":";;;AAKgB,SAAAA,EACfC,GACAC,GAKC;AACG,MAAA;AACG,UAAAC,IAAsBC,EAAgBH,GAAWC,CAAK,GACtDG,IAAcC,EAAUL,GAAWC,CAAK,GACxCK,IAAmBC,EAAaP,GAAWI,CAAW;AAErD,WAAA;AAAA,MACN,WAAWF,KAAuBI;AAAA,MAClC,aAAAF;AAAA,MACA,WAAW;AAAA,IACZ;AAAA,WACQI,GAAO;AAEf,WAAO,EAAE,WAAW,IAAO,aAAa,MAAM,WAD5BC,EAAgBD,CAAK,EACiB;AAAA,EAAA;AAE1D;AAEA,SAASL,EAAgBH,GAA2BC,GAAkD;AAErG,SAAI,iBAAiBD,KAAa,OAAOA,EAAU,eAAgB,aAC3DA,EAAU,YAAYU,EAAyBT,CAAK,CAAC,IAGtD;AACR;AAEA,SAASI,EAAUL,GAA2BC,GAAkD;AAE3F,MAAAD,aAAqBW,EAAE,SAAS;AACnC,UAAMC,KAAgB,MAAM;AACvB,UAAA;AACH,eAAO,OAAOX,KAAU,WAAW,KAAK,MAAMA,CAAK,IAAIA;AAAA,MAAA,QAChD;AACA,eAAAA;AAAA,MAAA;AAAA,IACR,GACE;AACI,WAAAD,EAAU,MAAMY,CAAY;AAAA,EAAA;AAGpC,SAAOZ,EAAU,MAAMU,EAAyBT,CAAK,CAAC;AACvD;AAEA,SAASM,EAAaP,GAA2BI,GAAsB;AAEtE,SAAI,cAAcJ,KAAa,OAAOA,EAAU,YAAa,aACrDA,EAAU,SAASI,CAAW,IAG/B;AACR;AAEA,SAASK,EAAgBD,GAAgB;AACxC,SAAIA,aAAiBK,IACbF,EAAE,aAAaH,CAAK,EAAE,OAAO,KAAK,IAAI,EAAE,QAAQ,mBAAmB,EAAE,IAEtE;AACR;"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "moonflower",
-	"version": "1.2.0",
+	"version": "1.3.0",
 	"description": "",
 	"author": "tenebrie",
 	"license": "MIT",
@@ -129,7 +129,13 @@
 	"peerDependencies": {
 		"@koa/router": "^13.1.0",
 		"koa": "^2.15.3",
-		"koa-bodyparser": "^4.4.1"
+		"koa-bodyparser": "^4.4.1",
+		"zod": "4.3.6"
+	},
+	"peerDependenciesMeta": {
+		"zod": {
+			"optional": true
+		}
 	},
 	"devDependencies": {
 		"@koa/router": "^13.1.0",
@@ -148,6 +154,7 @@
 		"eslint-plugin-simple-import-sort": "^12.1.1",
 		"eslint-plugin-unused-imports": "^4.1.4",
 		"jest": "29.7.0",
+		"zod": "4.3.6",
 		"koa": "^2.15.3",
 		"koa-bodyparser": "^4.4.1",
 		"node-mocks-http": "^1.16.2",

package/src/errors/UserFacingErrors.ts

@@ -34,12 +34,66 @@ export class InternalServerError extends BaseHttpError {
 	}
 }
 
+export class ForbiddenError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.FORBIDDEN, message)
+	}
+}
+
+export class MethodNotAllowedError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.METHOD_NOT_ALLOWED, message)
+	}
+}
+
+export class ConflictError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.CONFLICT, message)
+	}
+}
+
+export class GoneError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.GONE, message)
+	}
+}
+
+export class UnprocessableEntityError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.UNPROCESSABLE_ENTITY, message)
+	}
+}
+
+export class TooManyRequestsError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.TOO_MANY_REQUESTS, message)
+	}
+}
+
+export class NotImplementedError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.NOT_IMPLEMENTED, message)
+	}
+}
+
+export class BadGatewayError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.BAD_GATEWAY, message)
+	}
+}
+
 export class ServiceUnavailableError extends BaseHttpError {
 	constructor(message: string) {
 		super(StatusCodes.SERVICE_UNAVAILABLE, message)
 	}
 }
 
+export class GatewayTimeoutError extends BaseHttpError {
+	constructor(message: string) {
+		super(StatusCodes.GATEWAY_TIMEOUT, message)
+	}
+}
+
 // To be used later
 // export const errorNameToStatusCode = (name: string): number => {
 // 	switch (name) {

package/src/hooks/usePathParams.spec.ts

@@ -1,3 +1,6 @@
+import { expectTypeOf } from 'vitest'
+import z from 'zod'
+
 import {
 	BooleanValidator,
 	NumberValidator,
@@ -158,4 +161,28 @@ describe('usePathParams', () => {
 		expect(test).toThrow(ValidationError)
 		expect(test).toThrow("Failed route param validation: 'testParam' (Description)")
 	})
+
+	describe('zod validators', () => {
+		it('parses required params when present', () => {
+			const ctx = mockContextPath(mockContext(), '/test/:stringParam/:numberParam/:booleanParam', {
+				stringParam: 'test_string',
+				numberParam: '12',
+				booleanParam: 'true',
+			})
+
+			const params = usePathParams(ctx, {
+				stringParam: z.string(),
+				numberParam: z.number(),
+				booleanParam: z.boolean(),
+			})
+
+			expect(params.stringParam).toEqual('test_string')
+			expect(params.numberParam).toEqual(12)
+			expect(params.booleanParam).toEqual(true)
+
+			expectTypeOf(params.stringParam).toEqualTypeOf<string>()
+			expectTypeOf(params.numberParam).toEqualTypeOf<number>()
+			expectTypeOf(params.booleanParam).toEqualTypeOf<boolean>()
+		})
+	})
 })

package/src/hooks/usePathParams.ts

@@ -5,6 +5,7 @@ import { keysOf } from '../utils/object'
 import { CleanUpPathParam } from '../utils/TypeUtils'
 import { getValidationResultMessage } from '../utils/validationMessages'
 import { Validator } from '../validators/types'
+import { validateParam } from '../validators/validateParam'
 
 type CheckIfOptional<T, B> = B extends string ? (B extends `${string}?` ? T | undefined : T) : never
 
@@ -50,21 +51,12 @@ export const usePathParams = <
 
 		// Param is optional and is not provided - skip validation
 		if (paramValue === undefined) {
-			return { param, validated: true }
+			return { param, validated: true, parsedValue: undefined, exception: null }
 		}
 
-		try {
-			const validatorObject = param.validator
-			const prevalidatorSuccess = !validatorObject.prevalidate || validatorObject.prevalidate(paramValue)
-			const parsedValue = validatorObject.parse(paramValue)
-			const validatorSuccess = !validatorObject.validate || validatorObject.validate(parsedValue)
-			return {
-				param,
-				validated: prevalidatorSuccess && validatorSuccess,
-				parsedValue,
-			}
-		} catch {
-			return { param, validated: false }
+		return {
+			...validateParam(param.validator, paramValue),
+			param,
 		}
 	})