express-zod-api 30.0.0-beta.1 → 30.0.0-beta.2
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/CHANGELOG.md +3 -4
- package/dist/index.js +2 -2
- package/dist/integration.d.ts +2 -2
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -36,8 +36,7 @@ const { status, discriminator, data } = await client.provide(
|
|
|
36
36
|
"get /v1/user/retrieve",
|
|
37
37
|
{ id: "10" },
|
|
38
38
|
);
|
|
39
|
-
if (status === 200)
|
|
40
|
-
console.log(data.name); // success
|
|
39
|
+
if (status === 200) console.log(data.name); // success
|
|
41
40
|
else if (status === 400 || discriminator === "error")
|
|
42
41
|
console.error(data.message); // error
|
|
43
42
|
```
|
|
@@ -3475,9 +3474,9 @@ new Documentation({
|
|
|
3475
3474
|
});
|
|
3476
3475
|
|
|
3477
3476
|
// regular unformatted integration remains:
|
|
3478
|
-
new Integration(
|
|
3477
|
+
new Integration().print();
|
|
3479
3478
|
// featuring the formatted one, detects prettier automatically:
|
|
3480
|
-
await new Integration(
|
|
3479
|
+
await new Integration().printFormatted();
|
|
3481
3480
|
// featuring, splitted response types:
|
|
3482
3481
|
new Integration({ splitResponse: true });
|
|
3483
3482
|
```
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import{A as e,B as t,C as n,D as r,E as i,H as a,L as o,M as s,O as c,P as l,Q as u,T as d,U as f,V as p,W as ee,_ as te,a as ne,c as m,d as re,f as h,g,h as _,k as ie,l as v,m as ae,nt as oe,o as se,p as ce,q as y,rt as b,s as x,t as le,u as S,v as C,x as ue,z as w}from"./routing-walker-BpLERmiE.js";import{t as T}from"./peer-helpers-CURhdLch.js";import{h as de,l as fe,m as pe,p as me}from"./documentation-helpers-Df2sKJq9.js";import{globalRegistry as E,z as D}from"zod";import*as he from"ramda";import O,{isHttpError as ge}from"http-errors";import _e,{blue as ve,cyanBright as ye,green as be,hex as k,italic as xe,red as Se,whiteBright as A}from"ansis";import{inspect as Ce}from"node:util";import{performance as we}from"node:perf_hooks";import j from"express";import Te from"node:http";import Ee from"node:https";import{setInterval as De}from"node:timers/promises";import{createRequest as Oe,createResponse as ke}from"node-mocks-http";function Ae(e){return e}const je=(e,t)=>e&&t?e.and(t):e||t,Me=(e,t)=>w(e?e.and(t):t);var Ne=class e{#e;constructor(e){this.#e=e}async execute(...t){try{return await this.#e(...t)}catch(n){let{response:r,logger:i,error:a}=t[0],o=new c(p(n),a||void 0);e.lastResort({response:r,logger:i,error:o})}}static lastResort({error:e,logger:t,response:n}){t.error(`Result handler failure`,e);let r=m(O(500,`An error occurred while serving the result: ${e.message}.`+(e.handled?`\nOriginal error: ${e.handled.message}.`:``),{expose:ge(e.cause)?e.cause.expose:!1}));n.status(500).type(`text/plain`).end(r)}},M=class extends Ne{#e;#t;constructor(e){super(e.handler),this.#e=e.positive,this.#t=e.negative}getPositiveResponse(e){return S(this.#e,{variant:`positive`,args:[e]})}getNegativeResponse(){return S(this.#t,{variant:`negative`,args:[]})}};const Pe=D.object({message:D.string()});E.add(Pe,{examples:[{message:`Sample error message`}]});const N=new M({positive:e=>e,negative:Pe,handler:({error:e,input:t,output:n,request:r,response:i,logger:a})=>{if(e){let n=x(e);v(n,a,r,t),i.status(n.statusCode).set(n.headers).json({message:m(n)});return}i.status(h.positive).json(n)}}),P=D.object({status:D.literal(`error`),error:D.object({message:D.string()})});E.add(P,{examples:[{status:`error`,error:{message:`Sample error message`}}]});const F=new M({positive:e=>{let t=D.object({status:D.literal(`success`),data:e}),n=o(e);return n.length&&E.add(t,{examples:n.map(e=>({status:`success`,data:e}))}),t},negative:P,handler:({error:e,input:t,output:n,request:r,response:i,logger:a})=>{if(e){let n=x(e);v(n,a,r,t),i.status(n.statusCode).set(n.headers).json({status:`error`,error:{message:m(n)}});return}i.status(h.positive).json({status:`success`,data:n})}}),I=D.string();E.add(I,{examples:[`Sample error message`]});const L=new M({positive:e=>{let t=e instanceof D.ZodObject&&`items`in e.shape&&e.shape.items instanceof D.ZodArray?e.shape.items:D.array(D.any());if(o(t).length)return t;let n=o(e).filter(e=>y(e)&&`items`in e&&Array.isArray(e.items)).map(e=>e.items);if(n?.length){let e=t.meta();E.remove(t).add(t,{...e,examples:n})}return t},negative:{schema:I,mimeType:`text/plain`},handler:({response:e,output:t,error:n,logger:r,request:i,input:a})=>{if(n){let t=x(n);v(t,r,i,a),e.status(t.statusCode).type(`text/plain`).send(m(t));return}if(`items`in t&&Array.isArray(t.items)){e.status(h.positive).json(t.items);return}throw Error(`Property 'items' is missing in the endpoint output`)}}),R=e=>{let t=[];return e.scope&&t.push(e.scope),e.noStore&&t.push(`no-store`),e.noCache&&t.push(`no-cache`),e.maxAge!==void 0&&t.push(`max-age=${e.maxAge}`),e.sMaxAge!==void 0&&t.push(`s-maxage=${e.sMaxAge}`),e.mustRevalidate&&t.push(`must-revalidate`),e.proxyRevalidate&&t.push(`proxy-revalidate`),e.mustUnderstand&&t.push(`must-understand`),e.immutable&&t.push(`immutable`),e.noTransform&&t.push(`no-transform`),e.staleWhileRevalidate!==void 0&&t.push(`stale-while-revalidate=${e.staleWhileRevalidate}`),e.staleIfError!==void 0&&t.push(`stale-if-error=${e.staleIfError}`),t.join(`, `)},Fe={"max-age":`maxAge`,"max-stale":`maxStale`,"min-fresh":`minFresh`,"stale-if-error":`staleIfError`},Ie={"no-cache":`noCache`,"no-store":`noStore`,"no-transform":`noTransform`,"only-if-cached":`onlyIfCached`},Le=e=>{if(!e)return;let t={};for(let n of e.toLowerCase().split(`,`)){let[e,r]=n.split(`=`),i=Fe[e.trim()];if(i){let e=parseInt(r?.trim()??``,10);isNaN(e)||(t[i]=e);continue}let a=Ie[e.trim()];a&&(t[a]=!0)}return t},z=e=>new _({handler:async({request:t,response:n})=>(e&&n.setHeader(`Cache-Control`,R(e)),{get ifNoneMatch(){let e=t.headers[`if-none-match`];if(!e)return;let n=e.trim();return n===`*`?n:n.split(`,`).map(e=>e.trim().replace(/^(?:W\/)?"/,``).replace(/"$/,``))},get ifModifiedSince(){let e=t.headers[`if-modified-since`];if(!e)return;let n=new Date(e);return isNaN(n.getTime())?void 0:n},get cacheControl(){return Le(t.headers[`cache-control`])},addCachePolicy:t=>{n.setHeader(`Cache-Control`,R({...e,...t}))},setETag:e=>{n.setHeader(`ETag`,e.startsWith(`"`)?e:`"${e}"`)},setLastModified:e=>{n.setHeader(`Last-Modified`,e.toUTCString())},setVary:(...e)=>{n.setHeader(`Vary`,e.join(`, `))},setExpires:e=>{n.setHeader(`Expires`,e.toUTCString())},clearSiteData:()=>{n.setHeader(`Clear-Site-Data`,`"cache"`)},notModified:()=>{n.status(304).end()}})}),B=e=>new _({handler:async({request:t,response:n})=>({getCookie:e=>t.signedCookies?.[e]??t.cookies?.[e],setCookie:(t,r,i)=>{n.cookie(t,r,{...e,...i})},clearCookie:(t,r)=>{n.clearCookie(t,{...e,...r})}})}),V=e=>{let t=T(`express-rate-limit`)({statusCode:429,...e,handler:(e,t,n,r)=>{n(O(r.statusCode,r.message))}}),{getKey:n,resetKey:r}=t,i={getKey:n,resetKey:r};return new ae(t,{statusCode:e?.statusCode??429,provider:t=>({rateLimit:{...i,...t[e?.requestPropertyName??`rateLimit`]}})})};var H=class e{resultHandler;schema=void 0;statusCodes=/* @__PURE__ */ new Set;middlewares=[];constructor(e){this.resultHandler=e}#e(t){let n=new e(this.resultHandler);return n.middlewares=this.middlewares.concat(t),n.schema=je(this.schema,t.schema),n.statusCodes=this.statusCodes.union(t.statusCodes),n}addMiddleware(e){return this.#e(e instanceof _?e:new _(e))}useCookies(...e){return this.#e(B(...e))}useCache(...e){return this.#e(z(...e))}useRateLimit(...e){return this.#e(V(...e))}use=this.addExpressMiddleware;addExpressMiddleware(...e){return this.#e(new ae(...e))}addContext(e){return this.#e(new _({handler:({ctx:t})=>e(t)}))}build({input:e=t,output:n,operationId:r,scope:i,tag:a,method:o,statusCode:s,...c}){let{middlewares:l,resultHandler:u}=this,d=new g(typeof o==`string`?[o]:o),f=typeof r==`function`?r:e=>r&&`${r}${e===`head`?`__HEAD`:``}`,p=new g(typeof i==`string`?[i]:i),ee=new g(typeof a==`string`?[a]:a);return new se({...c,middlewares:l,resultHandler:u,scopes:p,tags:ee,methods:d,getOperationId:f,inputSchema:Me(this.schema,e),outputSchema:w(n),statusCodes:this.statusCodes.union(new Set(typeof s==`number`?[s]:s||[]))})}buildVoid({handler:e,...n}){return this.build({...n,output:t,handler:async t=>(await e(t),{})})}};const Re=new H(N),ze=new H(F),Be=new H(L),U={debug:ve,info:be,warn:k(`#FFA500`),error:Se,ctx:ye},W={debug:10,info:20,warn:30,error:40},Ve=e=>y(e)&&Object.keys(W).some(t=>t in e),G=e=>e in W,He=(e,t)=>W[e]<W[t],K=he.memoizeWith((e,t)=>`${e}${t}`,(e,t=0)=>Intl.NumberFormat(void 0,{useGrouping:!1,minimumFractionDigits:0,maximumFractionDigits:t,style:`unit`,unitDisplay:`long`,unit:e})),Ue=e=>e<1e-6?K(`nanosecond`,3).format(e/1e-6):e<.001?K(`nanosecond`).format(e/1e-6):e<1?K(`microsecond`).format(e/.001):e<1e3?K(`millisecond`).format(e):e<6e4?K(`second`,2).format(e/1e3):K(`minute`,2).format(e/6e4);var q=class e{config;constructor({color:e=_e.isSupported(),level:t=u.isProduction?`warn`:`debug`,depth:n=2,ctx:r={}}={}){this.config={color:e,level:t,depth:n,ctx:r}}format(e){let{depth:t,color:n,level:r}=this.config;return Ce(e,{depth:t,colors:n,breakLength:r===`debug`?80:1/0,compact:r!==`debug`||3})}print(e,t,n){let{level:r,ctx:{requestId:i,...a},color:o}=this.config;if(r===`silent`||He(e,r))return;let s=[(/* @__PURE__ */ new Date()).toISOString()];i&&s.push(o?U.ctx(i):i),s.push(o?`${U[e](e)}:`:`${e}:`,t),n!==void 0&&s.push(this.format(n)),Object.keys(a).length>0&&s.push(this.format(a)),console.log(s.join(` `))}debug(e,t){this.print(`debug`,e,t)}info(e,t){this.print(`info`,e,t)}warn(e,t){this.print(`warn`,e,t)}error(e,t){this.print(`error`,e,t)}child(t){return new e({...this.config,ctx:t})}get ctx(){return this.config.ctx}profile(e){let t=we.now();return()=>{let n=we.now()-t,{message:r,severity:i=`debug`,formatter:a=Ue}=typeof e==`object`?e:{message:e};this.print(typeof i==`function`?i(n):i,r,a(n))}}},We=class{logger;config;#e=/* @__PURE__ */ new WeakMap;constructor(e,t){this.logger=e,this.config=t}#t(e,t,n){if(!e.isSchemaChecked){for(let e of[`input`,`output`]){let r=[D.toJSONSchema(t[`${e}Schema`],{unrepresentable:`any`})];for(let t of r){t.type&&t.type!==`object`&&this.logger.warn(`Endpoint ${e} schema is not object-based`,n);for(let e of[`allOf`,`oneOf`,`anyOf`])t[e]&&r.push(...t[e])}}if(t.getProbableRequestType()===`json`){let e=C(t.inputSchema,`input`);e&&this.logger.warn(`The final input schema of the endpoint contains an unsupported JSON payload type.`,{...n,reason:e})}for(let e of ce)for(let{mimeTypes:r,schema:i}of t.getResponses(e)){if(!r?.includes(b.json))continue;let t=C(i,`output`);t&&this.logger.warn(`The final ${e} response schema of the endpoint contains an unsupported JSON payload type.`,{...n,reason:t})}e.isSchemaChecked=!0}}#n(e,t,n,r,i){if(e.paths.has(r))return;let{pathParams:a,getLocation:o,isQueryEnabled:s}=fe({method:n,path:r,security:t.security,inputSources:f(n,this.config.inputSources)});if(a.size!==0||s){e.flat??=pe(D.toJSONSchema(t.inputSchema,{unrepresentable:`any`,io:`input`,override:({zodSchema:e,jsonSchema:t})=>{(e._zod.traits.has(`$ZodPreprocess`)||`coerce`in e._zod.def&&e._zod.def.coerce)&&(t[me]=!0)}}));for(let[t,n]of Object.entries(e.flat.properties)){if(!y(n))continue;let r=o(t);(r===`path`||r===`query`)&&(r===`path`&&!e.flat.required?.includes(t)&&this.logger.warn(`The path parameter "${t}" is declared optional in the input schema, but path parameters are always required since Express matches the route only when the segment is present.`,{...i,name:t}),!de(n,r)&&this.logger.warn(`The ${r} parameter "${t}" has a schema that most likely would not accept the parsed data, ${r===`path`?`since path parameters always arrive as strings`:`depending on the "queryParser" config option`}. Convert the parsed value from "z.string()" using ".transform()" method, or use "z.coerce" at least.`,{...i,name:t,jsonSchema:n}))}for(let e of a)this.logger.warn(`The input schema of the endpoint is most likely missing the parameter of the path it's assigned to.`,{...i,param:e});e.paths.add(r)}}check=(e,t,n)=>{let r=this.#e.get(n);r||(r={isSchemaChecked:!1,paths:/* @__PURE__ */ new Set},this.#e.set(n,r)),this.#t(r,n,{method:e,path:t}),this.#n(r,n,e,t,{method:e,path:t})}};const J=e=>e.sort((e,t)=>+oe(t)-oe(e)||e.localeCompare(t)).join(`, `).toUpperCase(),Ge=e=>({method:t},n,r)=>{let i=J(e);n.set({Allow:i}),r(O(405,`${t} is not allowed`,{headers:{Allow:i}}))},Ke=({app:e,getLogger:t,config:n,routing:r})=>{let i=u.isProduction?void 0:new We(t(),n),a=/* @__PURE__ */ new Map;return le({routing:r,config:n,onEndpoint:(e,t,r)=>{i?.check(e,t,r),a.has(t)||a.set(t,new Map(n.cors?[[`options`,r]]:[])),a.get(t)?.set(e,r)},onStatic:e.use.bind(e)}),a},Y=({app:e,config:t,getLogger:n,...r})=>{let i=Ke({app:e,getLogger:n,config:t,...r}),a=/* @__PURE__ */ new Map;for(let[r,o]of i){let i=Array.from(o.keys());i.includes(`get`)&&i.push(`head`);for(let[a,s]of o){let o=[];t.cors&&o.push((e,t,n)=>{t.set(`Access-Control-Allow-Methods`,J(i)),n()}),o.push(async(e,r)=>{let i=n(e);return s.execute({request:e,response:r,logger:i,config:t})}),e[a]?.(r,...o)}t.hintAllowedMethods!==!1&&a.set(r,Ge(i))}for(let[t,n]of a)e.all(t,n)},qe=e=>`_httpMessage`in e&&typeof e._httpMessage==`object`&&e._httpMessage!==null&&`headersSent`in e._httpMessage&&typeof e._httpMessage.headersSent==`boolean`&&`setHeader`in e._httpMessage&&typeof e._httpMessage.setHeader==`function`,Je=e=>`server`in e&&typeof e.server==`object`&&e.server!==null&&`close`in e.server&&typeof e.server.close==`function`,Ye=e=>`encrypted`in e&&typeof e.encrypted==`boolean`&&e.encrypted,Xe=({},e)=>void(!e.headersSent&&e.setHeader(`connection`,`close`)),Ze=e=>{let{promise:t,resolve:n,reject:r}=Promise.withResolvers();return e.close(e=>e?r(e):n()),t},Qe=({timeout:e=1e3,logger:t}={})=>{let n,r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=e=>void i.delete(e),o=e=>a(e.destroy()),s=e=>void(qe(e)?!e._httpMessage.headersSent&&e._httpMessage.setHeader(`connection`,`close`):/* v8 ignore next -- unreachable */o(e)),c=e=>void(n?/* v8 ignore next -- unstable */e.destroy():i.add(e.once(`close`,()=>a(e)).once(`error`,()=>o(e)))),l=async()=>{for(let e of r)e.on(`request`,Xe);t?.info(`Graceful shutdown`,{sockets:i.size,timeout:e});for(let e of i)(Ye(e)||Je(e))&&s(e);for await(let t of De(10,Date.now()))if(i.size===0||Date.now()-t>=e)break;for(let e of i)o(e);return Promise.allSettled(r.values().map(Ze))},u={sockets:i,add:(...e)=>{for(let t of e)if(!r.has(t)){r.add(t);for(let e of[`connection`,`secureConnection`])t.on(e,c)}return u},shutdown:()=>n??=l(),get isShuttingDown(){return!!n}};return u},$e=Symbol.for(`express-zod-api`),et=({errorHandler:e,getLogger:t})=>async(n,r,i,a)=>n?e.execute({error:p(n),request:r,response:i,input:null,output:null,ctx:{},logger:t(r)}):a(),tt=({errorHandler:e,getLogger:t})=>async(n,r)=>{let i=O(404,`Can not ${n.method} ${n.path}`),a=t(n);await e.execute({request:n,response:r,logger:a,error:i,input:null,output:null,ctx:{}})},nt=e=>(t,{},n)=>{if(Object.values(t?.files||[]).flat().find(({truncated:e})=>e))return n(e);n()},rt=({config:e})=>{let t=T(`cookie-parser`),{secret:n,...r}={...typeof e.cookies==`object`&&e.cookies};return t(n,Object.keys(r).length?r:void 0)},it=e=>typeof e==`function`?e:({},e,t)=>{e.set({"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Headers":`content-type`}),t()},at=e=>({log:t=>{/not eligible/i.test(t)||e.debug(t)}}),ot=({getLogger:e,config:t})=>{let n=T(`express-fileupload`),{limitError:r,beforeUpload:i,...a}={...typeof t.upload==`object`&&t.upload},o=[];return o.push(async(t,r,o)=>{let s=e(t);return await i?.({request:t,logger:s}),n({debug:!0,...a,abortOnLimit:!1,parseNested:!0,logger:at(s)})(t,r,o)}),r&&o.push(nt(r)),o},st=(e,{},t)=>{Buffer.isBuffer(e.body)&&(e.body={raw:e.body}),t()},ct=({logger:e,config:{childLoggerProvider:t,accessLogger:n=({method:e,path:t},n)=>n.debug(`${e}: ${t}`)}})=>async(r,i,a)=>{let o=await t?.({request:r,parent:e})||e;n?.(r,o),r.res&&(r.res.locals[$e]={logger:o}),a()},lt=e=>t=>t?.res?.locals[$e]?.logger||e;let ut=!1;const dt=e=>{ut||(ut=!0,process.on(`deprecation`,({message:t,namespace:n,name:r,stack:i})=>e.warn(`${r} (${n}): ${t}`,i.split(`
|
|
1
|
+
import{A as e,B as t,C as n,D as r,E as i,H as a,L as o,M as s,O as c,P as l,Q as u,T as d,U as f,V as p,W as ee,_ as te,a as ne,c as m,d as re,f as h,g,h as _,k as ie,l as v,m as ae,nt as oe,o as se,p as ce,q as y,rt as b,s as x,t as le,u as S,v as C,x as ue,z as w}from"./routing-walker-BpLERmiE.js";import{t as T}from"./peer-helpers-CURhdLch.js";import{h as de,l as fe,m as pe,p as me}from"./documentation-helpers-Df2sKJq9.js";import{globalRegistry as E,z as D}from"zod";import*as he from"ramda";import O,{isHttpError as ge}from"http-errors";import _e,{blue as ve,cyanBright as ye,green as be,hex as k,italic as xe,red as Se,whiteBright as A}from"ansis";import{inspect as Ce}from"node:util";import{performance as we}from"node:perf_hooks";import j from"express";import Te from"node:http";import Ee from"node:https";import{setInterval as De}from"node:timers/promises";import{createRequest as Oe,createResponse as ke}from"node-mocks-http";function Ae(e){return e}const je=(e,t)=>e&&t?e.and(t):e||t,Me=(e,t)=>w(e?e.and(t):t);var Ne=class e{#e;constructor(e){this.#e=e}async execute(...t){try{return await this.#e(...t)}catch(n){let{response:r,logger:i,error:a}=t[0],o=new c(p(n),a||void 0);e.lastResort({response:r,logger:i,error:o})}}static lastResort({error:e,logger:t,response:n}){t.error(`Result handler failure`,e);let r=m(O(500,`An error occurred while serving the result: ${e.message}.`+(e.handled?`\nOriginal error: ${e.handled.message}.`:``),{expose:ge(e.cause)?e.cause.expose:!1}));n.status(500).type(`text/plain`).end(r)}},M=class extends Ne{#e;#t;constructor(e){super(e.handler),this.#e=e.positive,this.#t=e.negative}getPositiveResponse(e){return S(this.#e,{variant:`positive`,args:[e]})}getNegativeResponse(){return S(this.#t,{variant:`negative`,args:[]})}};const Pe=D.object({message:D.string()});E.add(Pe,{examples:[{message:`Sample error message`}]});const N=new M({positive:e=>e,negative:Pe,handler:({error:e,input:t,output:n,request:r,response:i,logger:a})=>{if(e){let n=x(e);v(n,a,r,t),i.status(n.statusCode).set(n.headers).json({message:m(n)})}else i.status(h.positive).json(n)}}),P=D.object({status:D.literal(`error`),error:D.object({message:D.string()})});E.add(P,{examples:[{status:`error`,error:{message:`Sample error message`}}]});const F=new M({positive:e=>{let t=D.object({status:D.literal(`success`),data:e}),n=o(e);return n.length&&E.add(t,{examples:n.map(e=>({status:`success`,data:e}))}),t},negative:P,handler:({error:e,input:t,output:n,request:r,response:i,logger:a})=>{if(e){let n=x(e);v(n,a,r,t),i.status(n.statusCode).set(n.headers).json({status:`error`,error:{message:m(n)}})}else i.status(h.positive).json({status:`success`,data:n})}}),I=D.string();E.add(I,{examples:[`Sample error message`]});const L=new M({positive:e=>{let t=e instanceof D.ZodObject&&`items`in e.shape&&e.shape.items instanceof D.ZodArray?e.shape.items:D.array(D.any());if(o(t).length)return t;let n=o(e).filter(e=>y(e)&&`items`in e&&Array.isArray(e.items)).map(e=>e.items);if(n?.length){let e=t.meta();E.remove(t).add(t,{...e,examples:n})}return t},negative:{schema:I,mimeType:`text/plain`},handler:({response:e,output:t,error:n,logger:r,request:i,input:a})=>{if(n){let t=x(n);v(t,r,i,a),e.status(t.statusCode).type(`text/plain`).send(m(t))}else if(`items`in t&&Array.isArray(t.items))e.status(h.positive).json(t.items);else throw Error(`Property 'items' is missing in the endpoint output`)}}),R=e=>{let t=[];return e.scope&&t.push(e.scope),e.noStore&&t.push(`no-store`),e.noCache&&t.push(`no-cache`),e.maxAge!==void 0&&t.push(`max-age=${e.maxAge}`),e.sMaxAge!==void 0&&t.push(`s-maxage=${e.sMaxAge}`),e.mustRevalidate&&t.push(`must-revalidate`),e.proxyRevalidate&&t.push(`proxy-revalidate`),e.mustUnderstand&&t.push(`must-understand`),e.immutable&&t.push(`immutable`),e.noTransform&&t.push(`no-transform`),e.staleWhileRevalidate!==void 0&&t.push(`stale-while-revalidate=${e.staleWhileRevalidate}`),e.staleIfError!==void 0&&t.push(`stale-if-error=${e.staleIfError}`),t.join(`, `)},Fe={"max-age":`maxAge`,"max-stale":`maxStale`,"min-fresh":`minFresh`,"stale-if-error":`staleIfError`},Ie={"no-cache":`noCache`,"no-store":`noStore`,"no-transform":`noTransform`,"only-if-cached":`onlyIfCached`},Le=e=>{if(!e)return;let t={};for(let n of e.toLowerCase().split(`,`)){let[e,r]=n.split(`=`),i=Fe[e.trim()];if(i){let e=parseInt(r?.trim()??``,10);isNaN(e)||(t[i]=e);continue}let a=Ie[e.trim()];a&&(t[a]=!0)}return t},z=e=>new _({handler:async({request:t,response:n})=>(e&&n.setHeader(`Cache-Control`,R(e)),{get ifNoneMatch(){let e=t.headers[`if-none-match`];if(!e)return;let n=e.trim();return n===`*`?n:n.split(`,`).map(e=>e.trim().replace(/^(?:W\/)?"/,``).replace(/"$/,``))},get ifModifiedSince(){let e=t.headers[`if-modified-since`];if(!e)return;let n=new Date(e);return isNaN(n.getTime())?void 0:n},get cacheControl(){return Le(t.headers[`cache-control`])},addCachePolicy:t=>{n.setHeader(`Cache-Control`,R({...e,...t}))},setETag:e=>{n.setHeader(`ETag`,e.startsWith(`"`)?e:`"${e}"`)},setLastModified:e=>{n.setHeader(`Last-Modified`,e.toUTCString())},setVary:(...e)=>{n.setHeader(`Vary`,e.join(`, `))},setExpires:e=>{n.setHeader(`Expires`,e.toUTCString())},clearSiteData:()=>{n.setHeader(`Clear-Site-Data`,`"cache"`)},notModified:()=>{n.status(304).end()}})}),B=e=>new _({handler:async({request:t,response:n})=>({getCookie:e=>t.signedCookies?.[e]??t.cookies?.[e],setCookie:(t,r,i)=>{n.cookie(t,r,{...e,...i})},clearCookie:(t,r)=>{n.clearCookie(t,{...e,...r})}})}),V=e=>{let t=T(`express-rate-limit`)({statusCode:429,...e,handler:(e,t,n,r)=>{n(O(r.statusCode,r.message))}}),{getKey:n,resetKey:r}=t,i={getKey:n,resetKey:r};return new ae(t,{statusCode:e?.statusCode??429,provider:t=>({rateLimit:{...i,...t[e?.requestPropertyName??`rateLimit`]}})})};var H=class e{resultHandler;schema=void 0;statusCodes=/* @__PURE__ */ new Set;middlewares=[];constructor(e){this.resultHandler=e}#e(t){let n=new e(this.resultHandler);return n.middlewares=this.middlewares.concat(t),n.schema=je(this.schema,t.schema),n.statusCodes=this.statusCodes.union(t.statusCodes),n}addMiddleware(e){return this.#e(e instanceof _?e:new _(e))}useCookies(...e){return this.#e(B(...e))}useCache(...e){return this.#e(z(...e))}useRateLimit(...e){return this.#e(V(...e))}use=this.addExpressMiddleware;addExpressMiddleware(...e){return this.#e(new ae(...e))}addContext(e){return this.#e(new _({handler:({ctx:t})=>e(t)}))}build({input:e=t,output:n,operationId:r,scope:i,tag:a,method:o,statusCode:s,...c}){let{middlewares:l,resultHandler:u}=this,d=new g(typeof o==`string`?[o]:o),f=typeof r==`function`?r:e=>r&&`${r}${e===`head`?`__HEAD`:``}`,p=new g(typeof i==`string`?[i]:i),ee=new g(typeof a==`string`?[a]:a);return new se({...c,middlewares:l,resultHandler:u,scopes:p,tags:ee,methods:d,getOperationId:f,inputSchema:Me(this.schema,e),outputSchema:w(n),statusCodes:this.statusCodes.union(new Set(typeof s==`number`?[s]:s||[]))})}buildVoid({handler:e,...n}){return this.build({...n,output:t,handler:async t=>(await e(t),{})})}};const Re=new H(N),ze=new H(F),Be=new H(L),U={debug:ve,info:be,warn:k(`#FFA500`),error:Se,ctx:ye},W={debug:10,info:20,warn:30,error:40},Ve=e=>y(e)&&Object.keys(W).some(t=>t in e),G=e=>e in W,He=(e,t)=>W[e]<W[t],K=he.memoizeWith((e,t)=>`${e}${t}`,(e,t=0)=>Intl.NumberFormat(void 0,{useGrouping:!1,minimumFractionDigits:0,maximumFractionDigits:t,style:`unit`,unitDisplay:`long`,unit:e})),Ue=e=>e<1e-6?K(`nanosecond`,3).format(e/1e-6):e<.001?K(`nanosecond`).format(e/1e-6):e<1?K(`microsecond`).format(e/.001):e<1e3?K(`millisecond`).format(e):e<6e4?K(`second`,2).format(e/1e3):K(`minute`,2).format(e/6e4);var q=class e{config;constructor({color:e=_e.isSupported(),level:t=u.isProduction?`warn`:`debug`,depth:n=2,ctx:r={}}={}){this.config={color:e,level:t,depth:n,ctx:r}}format(e){let{depth:t,color:n,level:r}=this.config;return Ce(e,{depth:t,colors:n,breakLength:r===`debug`?80:1/0,compact:r!==`debug`||3})}print(e,t,n){let{level:r,ctx:{requestId:i,...a},color:o}=this.config;if(r===`silent`||He(e,r))return;let s=[(/* @__PURE__ */ new Date()).toISOString()];i&&s.push(o?U.ctx(i):i),s.push(o?`${U[e](e)}:`:`${e}:`,t),n!==void 0&&s.push(this.format(n)),Object.keys(a).length>0&&s.push(this.format(a)),console.log(s.join(` `))}debug(e,t){this.print(`debug`,e,t)}info(e,t){this.print(`info`,e,t)}warn(e,t){this.print(`warn`,e,t)}error(e,t){this.print(`error`,e,t)}child(t){return new e({...this.config,ctx:t})}get ctx(){return this.config.ctx}profile(e){let t=we.now();return()=>{let n=we.now()-t,{message:r,severity:i=`debug`,formatter:a=Ue}=typeof e==`object`?e:{message:e};this.print(typeof i==`function`?i(n):i,r,a(n))}}},We=class{logger;config;#e=/* @__PURE__ */ new WeakMap;constructor(e,t){this.logger=e,this.config=t}#t(e,t,n){if(!e.isSchemaChecked){for(let e of[`input`,`output`]){let r=[D.toJSONSchema(t[`${e}Schema`],{unrepresentable:`any`})];for(let t of r){t.type&&t.type!==`object`&&this.logger.warn(`Endpoint ${e} schema is not object-based`,n);for(let e of[`allOf`,`oneOf`,`anyOf`])t[e]&&r.push(...t[e])}}if(t.getProbableRequestType()===`json`){let e=C(t.inputSchema,`input`);e&&this.logger.warn(`The final input schema of the endpoint contains an unsupported JSON payload type.`,{...n,reason:e})}for(let e of ce)for(let{mimeTypes:r,schema:i}of t.getResponses(e)){if(!r?.includes(b.json))continue;let t=C(i,`output`);t&&this.logger.warn(`The final ${e} response schema of the endpoint contains an unsupported JSON payload type.`,{...n,reason:t})}e.isSchemaChecked=!0}}#n(e,t,n,r,i){if(e.paths.has(r))return;let{pathParams:a,getLocation:o,isQueryEnabled:s}=fe({method:n,path:r,security:t.security,inputSources:f(n,this.config.inputSources)});if(a.size!==0||s){e.flat??=pe(D.toJSONSchema(t.inputSchema,{unrepresentable:`any`,io:`input`,override:({zodSchema:e,jsonSchema:t})=>{(e._zod.traits.has(`$ZodPreprocess`)||`coerce`in e._zod.def&&e._zod.def.coerce)&&(t[me]=!0)}}));for(let[t,n]of Object.entries(e.flat.properties)){if(!y(n))continue;let r=o(t);(r===`path`||r===`query`)&&(r===`path`&&!e.flat.required?.includes(t)&&this.logger.warn(`The path parameter "${t}" is declared optional in the input schema, but path parameters are always required since Express matches the route only when the segment is present.`,{...i,name:t}),!de(n,r)&&this.logger.warn(`The ${r} parameter "${t}" has a schema that most likely would not accept the parsed data, ${r===`path`?`since path parameters always arrive as strings`:`depending on the "queryParser" config option`}. Convert the parsed value from "z.string()" using ".transform()" method, or use "z.coerce" at least.`,{...i,name:t,jsonSchema:n}))}for(let e of a)this.logger.warn(`The input schema of the endpoint is most likely missing the parameter of the path it's assigned to.`,{...i,param:e});e.paths.add(r)}}check=(e,t,n)=>{let r=this.#e.get(n);r||(r={isSchemaChecked:!1,paths:/* @__PURE__ */ new Set},this.#e.set(n,r)),this.#t(r,n,{method:e,path:t}),this.#n(r,n,e,t,{method:e,path:t})}};const J=e=>e.sort((e,t)=>+oe(t)-oe(e)||e.localeCompare(t)).join(`, `).toUpperCase(),Ge=e=>({method:t},n,r)=>{let i=J(e);n.set({Allow:i}),r(O(405,`${t} is not allowed`,{headers:{Allow:i}}))},Ke=({app:e,getLogger:t,config:n,routing:r})=>{let i=u.isProduction?void 0:new We(t(),n),a=/* @__PURE__ */ new Map;return le({routing:r,config:n,onEndpoint:(e,t,r)=>{i?.check(e,t,r),a.has(t)||a.set(t,new Map(n.cors?[[`options`,r]]:[])),a.get(t)?.set(e,r)},onStatic:e.use.bind(e)}),a},Y=({app:e,config:t,getLogger:n,...r})=>{let i=Ke({app:e,getLogger:n,config:t,...r}),a=/* @__PURE__ */ new Map;for(let[r,o]of i){let i=Array.from(o.keys());i.includes(`get`)&&i.push(`head`);for(let[a,s]of o){let o=[];t.cors&&o.push((e,t,n)=>{t.set(`Access-Control-Allow-Methods`,J(i)),n()}),o.push(async(e,r)=>{let i=n(e);return s.execute({request:e,response:r,logger:i,config:t})}),e[a]?.(r,...o)}t.hintAllowedMethods!==!1&&a.set(r,Ge(i))}for(let[t,n]of a)e.all(t,n)},qe=e=>`_httpMessage`in e&&typeof e._httpMessage==`object`&&e._httpMessage!==null&&`headersSent`in e._httpMessage&&typeof e._httpMessage.headersSent==`boolean`&&`setHeader`in e._httpMessage&&typeof e._httpMessage.setHeader==`function`,Je=e=>`server`in e&&typeof e.server==`object`&&e.server!==null&&`close`in e.server&&typeof e.server.close==`function`,Ye=e=>`encrypted`in e&&typeof e.encrypted==`boolean`&&e.encrypted,Xe=({},e)=>void(!e.headersSent&&e.setHeader(`connection`,`close`)),Ze=e=>{let{promise:t,resolve:n,reject:r}=Promise.withResolvers();return e.close(e=>e?r(e):n()),t},Qe=({timeout:e=1e3,logger:t}={})=>{let n,r=/* @__PURE__ */ new Set,i=/* @__PURE__ */ new Set,a=e=>void i.delete(e),o=e=>a(e.destroy()),s=e=>void(qe(e)?!e._httpMessage.headersSent&&e._httpMessage.setHeader(`connection`,`close`):/* v8 ignore next -- unreachable */o(e)),c=e=>void(n?/* v8 ignore next -- unstable */e.destroy():i.add(e.once(`close`,()=>a(e)).once(`error`,()=>o(e)))),l=async()=>{for(let e of r)e.on(`request`,Xe);t?.info(`Graceful shutdown`,{sockets:i.size,timeout:e});for(let e of i)(Ye(e)||Je(e))&&s(e);for await(let t of De(10,Date.now()))if(i.size===0||Date.now()-t>=e)break;for(let e of i)o(e);return Promise.allSettled(r.values().map(Ze))},u={sockets:i,add:(...e)=>{for(let t of e)if(!r.has(t)){r.add(t);for(let e of[`connection`,`secureConnection`])t.on(e,c)}return u},shutdown:()=>n??=l(),get isShuttingDown(){return!!n}};return u},$e=Symbol.for(`express-zod-api`),et=({errorHandler:e,getLogger:t})=>async(n,r,i,a)=>n?e.execute({error:p(n),request:r,response:i,input:null,output:null,ctx:{},logger:t(r)}):a(),tt=({errorHandler:e,getLogger:t})=>async(n,r)=>{let i=O(404,`Can not ${n.method} ${n.path}`),a=t(n);await e.execute({request:n,response:r,logger:a,error:i,input:null,output:null,ctx:{}})},nt=e=>(t,{},n)=>{if(Object.values(t?.files||[]).flat().find(({truncated:e})=>e))return n(e);n()},rt=({config:e})=>{let t=T(`cookie-parser`),{secret:n,...r}={...typeof e.cookies==`object`&&e.cookies};return t(n,Object.keys(r).length?r:void 0)},it=e=>typeof e==`function`?e:({},e,t)=>{e.set({"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Headers":`content-type`}),t()},at=e=>({log:t=>{/not eligible/i.test(t)||e.debug(t)}}),ot=({getLogger:e,config:t})=>{let n=T(`express-fileupload`),{limitError:r,beforeUpload:i,...a}={...typeof t.upload==`object`&&t.upload},o=[];return o.push(async(t,r,o)=>{let s=e(t);return await i?.({request:t,logger:s}),n({debug:!0,...a,abortOnLimit:!1,parseNested:!0,logger:at(s)})(t,r,o)}),r&&o.push(nt(r)),o},st=(e,{},t)=>{Buffer.isBuffer(e.body)&&(e.body={raw:e.body}),t()},ct=({logger:e,config:{childLoggerProvider:t,accessLogger:n=({method:e,path:t},n)=>n.debug(`${e}: ${t}`)}})=>async(r,i,a)=>{let o=await t?.({request:r,parent:e})||e;n?.(r,o),r.res&&(r.res.locals[$e]={logger:o}),a()},lt=e=>t=>t?.res?.locals[$e]?.logger||e;let ut=!1;const dt=e=>{ut||(ut=!0,process.on(`deprecation`,({message:t,namespace:n,name:r,stack:i})=>e.warn(`${r} (${n}): ${t}`,i.split(`
|
|
2
2
|
`).slice(1))))};let X,Z,Q;const ft=({servers:e,logger:t,options:{timeout:n,beforeExit:r,events:i=[`SIGINT`,`SIGTERM`]}})=>{X??=Qe({logger:t,timeout:n}),X.add(...e),r&&(Q??=/* @__PURE__ */ new Set).add(r),Z??=async()=>{X?.isShuttingDown||(await X?.shutdown(),Q&&await Promise.allSettled(Q.values().map(async e=>e())),process.exit())};for(let e of i)process.listeners(e).includes(Z)||process.on(e,Z)},pt=e=>{if(e.columns<62)return;let t=xe(`for Rita`.padStart(52)),n=k(`#F5A9B8`),r=k(`#5BCEFA`),i=[r`8888888888${t}`,r`888`,r`888`,r`8888888 888 888 88888b. 888d888 .d88b. .d8888b .d8888b`,n`888 `Y8bd8P' 888 "88b 888P" d8P Y8b 88K 88K`,n`888 X88K 888 888 888 88888888 "Y8888b. "Y8888b.`,n`888 .d8""8b. 888 d88P 888 Y8b. X88 X88`,A`8888888888 888 888 88888P" 888 "Y8888 88888P' 88888P'`,A` 888`,A`8888888888P 888 888 d8888 8888888b. 8888888`,A` d88P 888 d88888 888 Y88b 888`,n` d88P 888 d88P888 888 888 888`,n` d88P .d88b. .d88888 d88P 888 888 d88P 888`,n` d88P d88""88b d88" 888 d88P 888 8888888P" 888`,r` d88P 888 888 888 888 d88P 888 888 888`,r` d88P Y88..88P Y88b 888 d8888888888 888 888`,r`d8888888888 "Y88P" "Y88888 d88P 888 888 8888888`];e.write(`
|
|
3
3
|
`+i.join(`
|
|
4
4
|
`)+`
|
|
5
5
|
|
|
6
|
-
`)},$=e=>{e.startupLogo!==!1&&pt(process.stdout);let t=e.errorHandler||N,n=Ve(e.logger)?e.logger:new q(e.logger);n.debug(`Running`,{build:`v30.0.0-beta.
|
|
6
|
+
`)},$=e=>{e.startupLogo!==!1&&pt(process.stdout);let t=e.errorHandler||N,n=Ve(e.logger)?e.logger:new q(e.logger);n.debug(`Running`,{build:`v30.0.0-beta.2`,env:u.env}),u.isProduction&&n instanceof q&&n.warn(`Using the built-in logger in production may degrade performance due to synchronous printing. Consider installing a professional logging solution, such as Pino or Winston.`),dt(n);let r=ct({logger:n,config:e}),i={getLogger:lt(n),errorHandler:t},a=tt(i),o=et(i);return{...i,logger:n,notFoundHandler:a,catcher:o,loggingMiddleware:r}},mt=(e,t)=>{let{logger:n,getLogger:r,notFoundHandler:i,loggingMiddleware:a}=$(e),o=e.app.use(a);return e.cors&&o.use(it(e.cors)),Y({app:o,routing:t,getLogger:r,config:e}),{notFoundHandler:i,logger:n}},ht=(e,t)=>{let{logger:n,getLogger:r,notFoundHandler:i,catcher:a,loggingMiddleware:o}=$(e),s=j().disable(`x-powered-by`).set(`query parser`,e.queryParser??`simple`).use(o);if(e.beforeParsers?.({app:s,getLogger:r}),e.compression){let t=T(`compression`);s.use(t(typeof e.compression==`object`?e.compression:void 0))}return e.cookies&&s.use(rt({config:e})),e.cors&&s.use(it(e.cors)),s.use(e.jsonParser||j.json()).use(e.formParser||j.urlencoded()).use(e.rawParser||j.raw(),st),e.upload&&s.use(...ot({config:e,getLogger:r})),e.beforeRouting?.({app:s,getLogger:r}),Y({app:s,routing:t,getLogger:r,config:e}),e.afterRouting?.({app:s,getLogger:r}),s.use(a,i),{app:s,logger:n}},gt=(e,t)=>{let{app:n,logger:r}=ht(e,t),i=[],a=(e,t)=>()=>e.listen(t,()=>r.info(`Listening`,t)),o=[];if(e.http){let t=Te.createServer(n);i.push(t),o.push(a(t,e.http.listen))}if(e.https){let t=Ee.createServer(e.https.options,n);i.push(t),o.push(a(t,e.https.listen))}return i.length||r.warn(`No servers configured.`),e.gracefulShutdown&&ft({logger:r,servers:i,options:e.gracefulShutdown===!0?{}:e.gracefulShutdown}),{app:n,logger:r,servers:o.map(e=>e())}},_t=e=>Oe({...e,headers:{"content-type":b.json,...e?.headers}}),vt=e=>ke(e),yt=e=>{let t={warn:[],error:[],info:[],debug:[]};return new Proxy(e||{},{get(e,n,r){return n===`_getLogs`?()=>t:G(n)?(...e)=>t[n].push(e):Reflect.get(e,n,r)},has(e,t){return G(t)||t===`_getLogs`?!0:Reflect.has(e,t)}})},bt=({requestProps:e,responseOptions:t,configProps:n,loggerProps:r})=>{let i=_t(e),a=vt({req:i,...t});a.req=t?.req||i,i.res=a;let o=yt(r);return{requestMock:i,responseMock:a,loggerMock:o,configMock:{cors:!1,logger:o,...n}}},xt=async({endpoint:e,...t})=>{let{requestMock:n,responseMock:r,loggerMock:i,configMock:a}=bt(t);return await e.execute({request:n,response:r,config:a,logger:i}),{requestMock:n,responseMock:r,loggerMock:i}},St=async({middleware:e,ctx:t={},...n})=>{let{configMock:r,...i}=bt(n),{inputSources:o,errorHandler:s=N}=r,c=a(i.requestMock,o),l={request:i.requestMock,response:i.responseMock,logger:i.loggerMock,input:c,ctx:t};try{let t=await e.execute({...l,config:r});return{...i,output:t}}catch(e){return await s.execute({...l,error:p(e),output:null}),{...i,output:{}}}},Ct=(e,t)=>D.object({data:t,event:D.literal(e),id:D.string().optional(),retry:D.int().positive().optional()}),wt=/[\r\n\0]/g,Tt=({events:e,event:t,data:n,id:r,retry:i})=>{if(!Object.prototype.hasOwnProperty.call(e,t))throw Error(`Unknown event: ${t}`);let a=e[t].parse(n),o=`event: ${t}\n`;return r!==void 0&&(o+=`id: ${r}\n`),i!==void 0&&(o+=`retry: ${i}\n`),o+`data: ${JSON.stringify(a)}\n\n`},Et=e=>e.headersSent||e.writeHead(200,{connection:`keep-alive`,"content-type":b.sse,"cache-control":`no-cache`}),Dt=(e,{eventId:t=!1,retry:n}={})=>{let r=0,i;if(n!==void 0&&!(Number.isInteger(n)&&n>0))throw Error(`Invalid SSE retry value "${n}": must be a positive integer.`);return t&&(i=typeof t==`function`?(e,n)=>t(e,n).replace(wt,``):(e,t)=>`${e}##${t}`),new _({handler:async({request:t,response:a})=>{let o=new AbortController,s=setTimeout(()=>Et(a),1e4);return t.once(`close`,()=>{clearTimeout(s),o.abort()}),{isClosed:()=>a.writableEnded||a.closed,signal:o.signal,lastEventId:i&&t.get(`last-event-id`),emit:(t,o)=>{Et(a);let s=Tt({events:e,data:o,retry:n,id:i&&i(String(t),++r),event:String(t)});a.write(s,`utf-8`),a.flush?.()}}}})},Ot=e=>new M({positive:()=>{let[t,...n]=Object.entries(e).map(([e,t])=>Ct(e,t));if(!t)throw new c(/* @__PURE__ */ Error(`At least one SSE event is required.`));return{mimeType:b.sse,schema:n.length?D.discriminatedUnion(`event`,[t,...n]):t}},negative:{mimeType:`text/plain`,schema:D.string()},handler:async({response:e,error:t,logger:n,request:r,input:i})=>{if(t){let a=x(t);v(a,n,r,i),e.headersSent||e.status(a.statusCode).type(`text/plain`).write(m(a),`utf-8`)}e.end()}});var kt=class extends H{constructor(e,t){let n=Object.fromEntries(Object.entries(e).map(([e,t])=>{if(e.match(wt))throw Error(`Invalid SSE event name "${e}": must not contain line breaks or null characters.`);return[e,w(t)]}));super(Ot(n)),this.middlewares=[Dt(n,t)]}};const At=[`total`,`limit`,`offset`],jt=[`nextCursor`,`limit`];function Mt({style:e,itemSchema:t,itemsName:n=`items`,maxLimit:r=100,defaultLimit:i=20}){if(!Number.isInteger(r)||r<1)throw Error(`ez.paginated: maxLimit must be a positive integer`);if(!Number.isInteger(i)||i<1)throw Error(`ez.paginated: defaultLimit must be a positive integer`);if(i>r)throw Error(`ez.paginated: defaultLimit must not be greater than maxLimit`);if(e===`offset`&&At.includes(n))throw Error(`ez.paginated: itemsName must not match reserved keys for offset output (${At.join(`, `)})`);if(e===`cursor`&&jt.includes(n))throw Error(`ez.paginated: itemsName must not match reserved keys for cursor output (${jt.join(`, `)})`);let a=D.coerce.number().int().min(1).max(r).default(i).describe(`Page size (number of ${n} per page)`);if(e===`offset`){let e=D.coerce.number().int().min(0).default(0).describe(`Number of ${n} to skip`);return{input:D.object({limit:a,offset:e}),output:D.object({[n]:D.array(t).describe(`Page of ${n}`),total:D.number().int().min(0).describe(`Total number of ${n}`),limit:D.number().int().min(1).describe(`Page size used`),offset:D.number().int().min(0).describe(`Offset used`)})}}let o=D.string().optional().describe(`Cursor for the next page; omit for first page`);return{input:D.object({cursor:o,limit:a}),output:D.object({[n]:D.array(t).describe(`Page of ${n}`),nextCursor:D.string().nullable().describe(`Cursor for the next page, or null if no more pages`),limit:D.number().int().min(1).describe(`Page size used`)})}}const Nt={dateIn:s,dateOut:e,form:te,upload:n,raw:ue,buffer:l,paginated:Mt};export{q as BuiltinLogger,H as EndpointsFactory,kt as EventStreamFactory,d as InputValidationError,_ as Middleware,i as MissingPeerError,r as OutputValidationError,M as ResultHandler,ie as RoutingError,ne as ServeStatic,Be as arrayEndpointsFactory,L as arrayResultHandler,mt as attachRouting,re as createApiResponse,z as createCacheMiddleware,Ae as createConfig,B as createCookieMiddleware,V as createRateLimitMiddleware,gt as createServer,Re as defaultEndpointsFactory,N as defaultResultHandler,x as ensureHttpError,Nt as ez,ee as getMessageFromError,ze as legacyEndpointsFactory,F as legacyResultHandler,xt as testEndpoint,St as testMiddleware};
|
package/dist/integration.d.ts
CHANGED
|
@@ -4,8 +4,8 @@ import ts, { default as ts$1 } from "typescript";
|
|
|
4
4
|
interface NextHandlerInc<U> {
|
|
5
5
|
next: (schema: z.core.$ZodType) => U;
|
|
6
6
|
}
|
|
7
|
-
type SchemaHandler<U, Context extends FlatObject = EmptyObject, Variant extends "regular" | "last" = "regular"> = (schema: any // oxlint-disable-line typescript/no-explicit-any -- for assignment compatibility
|
|
8
|
-
|
|
7
|
+
type SchemaHandler<U, Context extends FlatObject = EmptyObject, Variant extends "regular" | "last" = "regular"> = (schema: any, // oxlint-disable-line typescript/no-explicit-any -- for assignment compatibility
|
|
8
|
+
ctx: Context & (Variant extends "regular" ? NextHandlerInc<U> : Context)) => U;
|
|
9
9
|
type HandlingRules<U, Context extends FlatObject = EmptyObject, K extends string | symbol = string | symbol> = Partial<Record<K, SchemaHandler<U, Context>>>;
|
|
10
10
|
interface ZTSContext extends FlatObject {
|
|
11
11
|
isResponse: boolean;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "express-zod-api",
|
|
3
|
-
"version": "30.0.0-beta.
|
|
3
|
+
"version": "30.0.0-beta.2",
|
|
4
4
|
"description": "A Typescript framework to help you get an API server up and running with I/O schema validation and custom middlewares in minutes.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -112,7 +112,6 @@
|
|
|
112
112
|
"@types/http-errors": "^2.0.5",
|
|
113
113
|
"@types/node-forge": "^1.3.14",
|
|
114
114
|
"@types/ramda": "^0.32.0",
|
|
115
|
-
"@typescript/native-preview": "npm:typescript@^7.0.2",
|
|
116
115
|
"camelize-ts": "^3.0.0",
|
|
117
116
|
"compression": "^1.8.1",
|
|
118
117
|
"cookie-parser": "^1.4.7",
|
|
@@ -124,6 +123,7 @@
|
|
|
124
123
|
"http-errors": "^2.0.1",
|
|
125
124
|
"node-forge": "^1.3.3",
|
|
126
125
|
"snakify-ts": "^2.3.0",
|
|
126
|
+
"tsgo": "npm:typescript@7.1.0-beta",
|
|
127
127
|
"typescript": "npm:@typescript/typescript6@^6.0.2",
|
|
128
128
|
"undici": "^8.2.0",
|
|
129
129
|
"zod": "^4.6.0"
|