express-zod-api 11.2.0 → 11.4.0
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 +42 -0
- package/dist/esm/index.d.ts +16 -1
- package/dist/esm/index.js +12 -12
- package/dist/esm/package.json +1 -1
- package/dist/index.d.ts +16 -1
- package/dist/index.js +12 -12
- package/package.json +7 -7
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,48 @@
|
|
|
2
2
|
|
|
3
3
|
## Version 11
|
|
4
4
|
|
|
5
|
+
### v11.4.0
|
|
6
|
+
|
|
7
|
+
- Supporting `z.readonly()` of `zod` v3.22.
|
|
8
|
+
- For the purposes of depicting REST APIs `ZodReadonly` is described the same way as its inner schema.
|
|
9
|
+
|
|
10
|
+
### v11.3.0
|
|
11
|
+
|
|
12
|
+
- Thanks to [@dev-m1-macbook](https://github.com/dev-m1-macbook) who noticed that the method needed for getting
|
|
13
|
+
examples within a custom `ResultHandler` is not exported. This problem is now fixed.
|
|
14
|
+
- Exposing `getExamples()` method having object based parameter with following props:
|
|
15
|
+
- `schema` — the subject to retrieve examples from (previously set by `withMeta().example()` method).
|
|
16
|
+
- `variant` _(optional)_ — either `original` _(default)_ or `parsed` literal. The last one applies possible
|
|
17
|
+
transformations.
|
|
18
|
+
- `validate` _(optional)_ — boolean, filters out invalid examples, enabled for `parsed` variant.
|
|
19
|
+
- **Warning**: Getting parsed or validated examples of `z.lazy()` having circular references must be avoided.
|
|
20
|
+
- Despite having two options for various needs, in case of proxying your examples withing a custom `ResultHandler`
|
|
21
|
+
those are not required. Consider the following approach implemented in the default `ResultHandler`:
|
|
22
|
+
|
|
23
|
+
```ts
|
|
24
|
+
const defaultResultHandler = createResultHandler({
|
|
25
|
+
getPositiveResponse: (output: IOSchema) => {
|
|
26
|
+
// Examples are taken for proxying: no validation needed for this
|
|
27
|
+
const examples = getExamples({ schema: output });
|
|
28
|
+
const responseSchema = withMeta(
|
|
29
|
+
z.object({
|
|
30
|
+
status: z.literal("success"),
|
|
31
|
+
data: output,
|
|
32
|
+
}),
|
|
33
|
+
);
|
|
34
|
+
return examples.reduce<typeof responseSchema>(
|
|
35
|
+
(acc, example) =>
|
|
36
|
+
acc.example({
|
|
37
|
+
status: "success",
|
|
38
|
+
data: example,
|
|
39
|
+
}),
|
|
40
|
+
responseSchema,
|
|
41
|
+
);
|
|
42
|
+
},
|
|
43
|
+
// ...
|
|
44
|
+
});
|
|
45
|
+
```
|
|
46
|
+
|
|
5
47
|
### v11.2.0
|
|
6
48
|
|
|
7
49
|
- `winston` version is 3.10.0.
|
package/dist/esm/index.d.ts
CHANGED
|
@@ -136,6 +136,21 @@ type MethodsDefinition<M extends Method> = {
|
|
|
136
136
|
type FlatObject = Record<string, any>;
|
|
137
137
|
declare function getMessageFromError(error: Error): string;
|
|
138
138
|
declare function getStatusCodeFromError(error: Error): number;
|
|
139
|
+
declare const getExamples: <T extends z.ZodTypeAny, V extends "original" | "parsed" | undefined>({ schema, variant, validate, }: {
|
|
140
|
+
schema: T;
|
|
141
|
+
/**
|
|
142
|
+
* @desc examples variant: original or parsed
|
|
143
|
+
* @example "parsed" — for the case when possible schema transformations should be applied
|
|
144
|
+
* @default "original"
|
|
145
|
+
* @override validate: variant "parsed" activates validation as well
|
|
146
|
+
* */
|
|
147
|
+
variant?: V | undefined;
|
|
148
|
+
/**
|
|
149
|
+
* @desc filters out the examples that do not match the schema
|
|
150
|
+
* @default variant === "parsed"
|
|
151
|
+
* */
|
|
152
|
+
validate?: boolean | undefined;
|
|
153
|
+
}) => readonly (V extends "parsed" ? z.output<T> : z.input<T>)[];
|
|
139
154
|
type ErrMessage = Exclude<Parameters<typeof z.ZodString.prototype.email>[0], undefined>;
|
|
140
155
|
|
|
141
156
|
declare const metaProp = "expressZodApiMeta";
|
|
@@ -841,4 +856,4 @@ declare namespace proprietarySchemas {
|
|
|
841
856
|
};
|
|
842
857
|
}
|
|
843
858
|
|
|
844
|
-
export { AbstractEndpoint, DependsOnMethod, DependsOnMethodError, Documentation, DocumentationError, EndpointsFactory, FlatObject, IOSchema, InputValidationError, Integration, LoggerConfig, Method, OutputValidationError, Routing, RoutingError, ServeStatic, ZodDateInDef, ZodDateOutDef, ZodFileDef, ZodUploadDef, attachRouting, createConfig, createLogger, createMiddleware, createResultHandler, createServer, defaultEndpointsFactory, defaultResultHandler, proprietarySchemas as ez, getMessageFromError, getStatusCodeFromError, testEndpoint, withMeta };
|
|
859
|
+
export { AbstractEndpoint, DependsOnMethod, DependsOnMethodError, Documentation, DocumentationError, EndpointsFactory, FlatObject, IOSchema, InputValidationError, Integration, LoggerConfig, Method, OutputValidationError, Routing, RoutingError, ServeStatic, ZodDateInDef, ZodDateOutDef, ZodFileDef, ZodUploadDef, attachRouting, createConfig, createLogger, createMiddleware, createResultHandler, createServer, defaultEndpointsFactory, defaultResultHandler, proprietarySchemas as ez, getExamples, getMessageFromError, getStatusCodeFromError, testEndpoint, withMeta };
|
package/dist/esm/index.js
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
var Ar=Object.defineProperty;var Ir=(e,
|
|
2
|
-
Caused by ${s?"response":"input"} schema of an Endpoint assigned to ${o.toUpperCase()} method of ${n} path.`;super(a);this.name="DocumentationError"}},v=class extends Error{constructor(){super(...arguments);this.name="IOSchemaError"}}
|
|
1
|
+
var Ar=Object.defineProperty;var Ir=(e,t)=>{for(var r in t)Ar(e,r,{get:t[r],enumerable:!0})};var Cr=(e,t,r)=>{if(!t.has(e))throw TypeError("Cannot "+r)};var w=(e,t,r)=>{if(t.has(e))throw TypeError("Cannot add the same private member more than once");t instanceof WeakSet?t.add(e):t.set(e,r)};var E=(e,t,r)=>(Cr(e,t,"access private method"),r);var It={silent:!0,warn:!0,debug:!0},Mr=e=>e;import{z as j}from"zod";import{createHash as $r}from"crypto";import{HttpError as _r}from"http-errors";import{z as O}from"zod";import{clone as Nr,mergeDeepRight as wr}from"ramda";var b="expressZodApiMeta",Dr=e=>{let t=e.constructor,r=Nr(e._def);return r[b]=r[b]||{examples:[]},new t(r)},B=e=>{let t=Dr(e);return Object.defineProperties(t,{example:{get:()=>r=>{let o=B(t);return o._def[b].examples.push(r),o}}}),t},Ct=e=>b in e._def?typeof e._def[b]=="object"&&e._def[b]!==null:!1;function Mt(e,t){if(!Ct(e))return;let r=e._def;return t in r[b]?r[b][t]:void 0}var Se=(e,t)=>{if(!Ct(e))return t;let r=B(t),o=pe(r._def[b].examples,e._def[b].examples);if(r._def[b].examples=[],o.type==="single")r._def[b].examples=o.value;else for(let[n,s]of o.value)r._def[b].examples.push(wr({...n},{...s}));return r};import zr from"mime";var H=zr.getType("json")||"application/json",ce="multipart/form-data";import{INVALID as vr,OK as jr,ZodIssueCode as Lr,ZodParsedType as kr,ZodType as Ur,addIssueToContext as Hr}from"zod";var Kr="ZodUpload",Fr=e=>typeof e=="object"&&e!==null&&"name"in e&&"encoding"in e&&"mimetype"in e&&"data"in e&&"tempFilePath"in e&&"truncated"in e&&"size"in e&&"md5"in e&&"mv"in e&&typeof e.name=="string"&&typeof e.mimetype=="string"&&typeof e.data=="object"&&typeof e.tempFilePath=="string"&&typeof e.truncated=="boolean"&&typeof e.size=="number"&&typeof e.md5=="string"&&typeof e.mv=="function",Oe=class Oe extends Ur{_parse(t){let{ctx:r}=this._processInputParams(t);return r.parsedType!==kr.object||!Fr(r.data)?(Hr(r,{code:Lr.custom,message:`Expected file upload, received ${r.parsedType}`}),vr):jr(r.data)}};Oe.create=()=>new Oe({typeName:Kr});var Y=Oe;var We=/:([A-Za-z0-9_]+)/g;function Gr(e){let r=(e.header("content-type")||"").slice(0,ce.length).toLowerCase()===ce;return"files"in e&&r}var be={get:["query","params"],post:["body","params","files"],put:["body","params"],patch:["body","params"],delete:["query","params"]},qr=["body","query","params"],Xe=e=>e.method.toLowerCase();function Nt(e,t){let r=Xe(e);if(r==="options")return{};let o=qr;return r in be&&(o=be[r]),t&&r in t&&(o=t[r]||o),o.filter(n=>n==="files"?Gr(e):!0).reduce((n,s)=>({...n,...e[s]}),{})}function et(e){return typeof e=="object"&&"level"in e&&"color"in e&&Object.keys(It).includes(e.level)&&typeof e.color=="boolean"}function Re(e){return!isNaN(e.getTime())}function J(e){return e instanceof Error?e:new Error(typeof e=="symbol"?e.toString():`${e}`)}function K(e){return e instanceof O.ZodError?e.issues.map(({path:t,message:r})=>(t.length?[t.join("/")]:[]).concat(r).join(": ")).join("; "):e instanceof $?`output${e.originalError.issues[0]?.path.length>0?"/":": "}${e.message}`:e.message}function tt(e){return e instanceof _r?e.statusCode:e instanceof z?400:500}var F=({schema:e,variant:t="original",validate:r=t==="parsed"})=>{let o=Mt(e,"examples")||[];if(!r&&t==="original")return o;let n=[];for(let s of o){let a=e.safeParse(s);a.success&&n.push(t==="parsed"?a.data:s)}return n},pe=(e,t)=>{if(e.length===0)return{type:"single",value:t};if(t.length===0)return{type:"single",value:e};let r=[];for(let o of e)for(let n of t)r.push([o,n]);return{type:"tuple",value:r}};function rt(e){let t=e.match(We);return t?t.map(r=>r.slice(1)):[]}var le=e=>e.reduce((t,r)=>t||r,!1);function D(e){return e instanceof O.ZodEffects&&e._def.effect.type!=="refinement"?!0:e instanceof O.ZodUnion?le(e.options.map(D)):e instanceof O.ZodIntersection?le([e._def.left,e._def.right].map(D)):!1}function A(e){return e instanceof Y?!0:e instanceof O.ZodObject?le(Object.values(e.shape).map(A)):e instanceof O.ZodUnion?le(e.options.map(A)):e instanceof O.ZodIntersection?le([e._def.left,e._def.right].map(A)):e instanceof O.ZodOptional||e instanceof O.ZodNullable?A(e.unwrap()):e instanceof O.ZodEffects||e instanceof O.ZodTransformer?A(e._def.schema):e instanceof O.ZodRecord?A(e._def.valueType):e instanceof O.ZodArray?A(e._def.type):e instanceof O.ZodDefault?A(e._def.innerType):!1}var me=e=>"coerce"in e._def&&typeof e._def.coerce=="boolean"?e._def.coerce:!1,I=(e,t,r)=>[t].concat(e.split("/")).concat(r||[]).flatMap(o=>o.split(/[^A-Z0-9]/gi)).map(o=>o.slice(0,1).toUpperCase()+o.slice(1).toLowerCase()).join(""),Pe=e=>$r("sha1").update(JSON.stringify(e),"utf8").digest("hex"),Ze=({effect:e,sample:t})=>{try{return typeof e.transform(t,{addIssue:()=>{},path:[]})}catch{return}},ot=e=>typeof e=="string"?{message:e}:e||{};var Q=class extends Error{constructor(){super(...arguments);this.name="RoutingError"}},ue=class extends Q{constructor(){super(...arguments);this.name="DependsOnMethodError"}},P=class extends Error{constructor({message:r,method:o,path:n,isResponse:s}){let a=`${r}
|
|
2
|
+
Caused by ${s?"response":"input"} schema of an Endpoint assigned to ${o.toUpperCase()} method of ${n} path.`;super(a);this.name="DocumentationError"}},v=class extends Error{constructor(){super(...arguments);this.name="IOSchemaError"}},$=class extends v{constructor(r){super(K(r));this.name="OutputValidationError";this.originalError=r}},z=class extends v{constructor(r){super(K(r));this.name="InputValidationError";this.originalError=r}},W=class extends Error{constructor(r,o){super(r);this.name="ResultHandlerError";this.originalError=o||void 0}};var C=e=>typeof e=="object"&&e!==null,Ee=e=>({and:e.reduce((t,r)=>t.concat(C(r)&&"and"in r?r.and:r),[])}),Ae=(e,t)=>{if(C(e)){if("and"in e)return{and:e.and.map(r=>C(r)&&"or"in r?{or:r.or.map(t)}:t(r))};if("or"in e)return{or:e.or.map(r=>C(r)&&"and"in r?{and:r.and.map(t)}:t(r))}}return t(e)},nt=e=>e.and.reduce((t,r)=>{let o=pe(t.or,C(r)&&"or"in r?r.or:[r]);return o.type==="single"?t.or.push(...o.value):t.or=o.value.map(Ee),t},{or:[]}),X=(e,t)=>{if(C(e)){if("and"in e){if(C(t)){if("and"in t)return Ee([e,t]);if("or"in t)return X(nt(e),t)}return Ee([e,t])}if("or"in e){if(C(t)){if("and"in t)return X(t,e);if("or"in t){let r=pe(e.or,t.or);return{or:r.type==="single"?r.value:r.value.map(Ee)}}}return X(e,{and:[t]})}}return C(t)&&("and"in t||"or"in t)?X(t,e):{and:[e,t]}};import{z as ee}from"zod";var te={positive:200,negative:400},wt=e=>e,re=wt({getPositiveResponse:e=>{let t=F({schema:e}),r=B(ee.object({status:ee.literal("success"),data:e}));return t.reduce((o,n)=>o.example({status:"success",data:n}),r)},getNegativeResponse:()=>B(ee.object({status:ee.literal("error"),error:ee.object({message:ee.string()})})).example({status:"error",error:{message:K(new Error("Sample error message"))}}),handler:({error:e,input:t,output:r,request:o,response:n,logger:s})=>{if(!e){n.status(te.positive).json({status:"success",data:r});return}let a=tt(e);a===500&&s.error(`Internal server error
|
|
3
3
|
${e.stack}
|
|
4
|
-
`,{url:o.url,payload:
|
|
5
|
-
Original error: ${e.originalError.message}.`:""))};var Dt=(e,
|
|
4
|
+
`,{url:o.url,payload:t}),n.status(a).json({status:"error",error:{message:K(e)}})}}),Ie=({error:e,logger:t,response:r})=>{t.error(`Result handler failure: ${e.message}.`),r.status(500).end(`An error occurred while serving the result: ${e.message}.`+(e.originalError?`
|
|
5
|
+
Original error: ${e.originalError.message}.`:""))};var Dt=(e,t=[H])=>{if(e instanceof j.ZodType)return t;let{mimeTypes:r,mimeType:o}=e;return o?[o]:r||t},oe=class{},Me,zt,Ne,vt,we,jt,De,Lt,ze,kt,Ce=class extends oe{constructor({middlewares:r,inputSchema:o,outputSchema:n,handler:s,resultHandler:a,description:d,shortDescription:c,...p}){super();w(this,Me);w(this,Ne);w(this,we);w(this,De);w(this,ze);this.methods=[];this.siblingMethods=[];this.middlewares=[];this.scopes=[];this.tags=[];[{name:"input schema",schema:o},{name:"output schema",schema:n}].forEach(({name:f,schema:x})=>{if(D(x))throw new v(`Using transformations on the top level of endpoint ${f} is not allowed.`)}),this.middlewares=r;let l={positive:a.getPositiveResponse(n),negative:a.getNegativeResponse()};this.mimeTypes={input:A(o)?[ce]:[H],positive:Dt(l.positive),negative:Dt(l.negative)},this.schemas={input:o,output:n,positive:l.positive instanceof j.ZodType?l.positive:l.positive.schema,negative:l.negative instanceof j.ZodType?l.negative:l.negative.schema},this.statusCodes={positive:l.positive instanceof j.ZodType?te.positive:l.positive.statusCode||te.positive,negative:l.negative instanceof j.ZodType?te.negative:l.negative.statusCode||te.negative},this.handler=s,this.resultHandler=a,this.descriptions={long:d,short:c},"scopes"in p&&p.scopes&&this.scopes.push(...p.scopes),"scope"in p&&p.scope&&this.scopes.push(p.scope),"tags"in p&&p.tags&&this.tags.push(...p.tags),"tag"in p&&p.tag&&this.tags.push(p.tag),"methods"in p?this.methods=p.methods:this.methods=[p.method]}_setSiblingMethods(r){this.siblingMethods=r}getDescription(r){return this.descriptions[r]}getMethods(){return this.methods}getSchema(r){return this.schemas[r]}getMimeTypes(r){return this.mimeTypes[r]}getStatusCode(r){return this.statusCodes[r]}getSecurity(){return this.middlewares.reduce((r,o)=>o.security?X(r,o.security):r,{and:[]})}getScopes(){return this.scopes}getTags(){return this.tags}async execute({request:r,response:o,logger:n,config:s}){let a=Xe(r),d,c=null;if(s.cors){let l=E(this,Me,zt).call(this);typeof s.cors=="function"&&(l=await s.cors({request:r,logger:n,endpoint:this,defaultHeaders:l}));for(let f in l)o.set(f,l[f])}let p=Nt(r,s.inputSources);try{let{options:l,isStreamClosed:f}=await E(this,we,jt).call(this,{method:a,input:p,request:r,response:o,logger:n});if(f)return;if(a==="options"){o.status(200).end();return}d=await E(this,Ne,vt).call(this,await E(this,De,Lt).call(this,{input:p,options:l,logger:n}))}catch(l){c=J(l)}await E(this,ze,kt).call(this,{input:p,output:d,request:r,response:o,error:c,logger:n})}};Me=new WeakSet,zt=function(){return{"Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":this.methods.concat(this.siblingMethods).concat("options").join(", ").toUpperCase(),"Access-Control-Allow-Headers":"content-type"}},Ne=new WeakSet,vt=async function(r){try{return await this.schemas.output.parseAsync(r)}catch(o){throw o instanceof j.ZodError?new $(o):o}},we=new WeakSet,jt=async function({method:r,input:o,request:n,response:s,logger:a}){let d={},c=!1;for(let p of this.middlewares){if(r==="options"&&p.type==="proprietary")continue;let l;try{l=await p.input.parseAsync(o)}catch(f){throw f instanceof j.ZodError?new z(f):f}if(Object.assign(d,await p.middleware({input:l,options:d,request:n,response:s,logger:a})),c="writableEnded"in s&&s.writableEnded,c){a.warn(`The middleware ${p.middleware.name} has closed the stream. Accumulated options:`,d);break}}return{options:d,isStreamClosed:c}},De=new WeakSet,Lt=async function({input:r,options:o,logger:n}){let s;try{s=await this.schemas.input.parseAsync(r)}catch(a){throw a instanceof j.ZodError?new z(a):a}return this.handler({input:s,options:o,logger:n})},ze=new WeakSet,kt=async function({error:r,request:o,response:n,logger:s,input:a,output:d}){try{await this.resultHandler.handler({error:r,output:d,request:o,response:n,logger:s,input:a})}catch(c){Ie({logger:s,response:n,error:new W(J(c).message,r)})}};var Ut=["get","post","put","delete","patch"];import{z as Kt}from"zod";var Ht=(e,t)=>{let r=e.map(({input:n})=>n).concat(t),o=r.reduce((n,s)=>n.and(s));return r.reduce((n,s)=>Se(s,n),o)};var st=e=>{if(D(e.input))throw new v("Using transformations on the top level of middleware input schema is not allowed.");return{...e,type:"proprietary"}};var ne,ve,_=class _{constructor(t){this.middlewares=[];this.use=this.addExpressMiddleware;this.resultHandler="resultHandler"in t?t.resultHandler:t}addMiddleware(t){var r;return E(r=_,ne,ve).call(r,this.middlewares.concat(t),this.resultHandler)}addExpressMiddleware(t,r){var a;let o=r?.transformer||(d=>d),n=r?.provider||(()=>({})),s={type:"express",input:Kt.object({}),middleware:async({request:d,response:c})=>new Promise((p,l)=>{t(d,c,x=>{if(x&&x instanceof Error)return l(o(x));p(n(d,c))})})};return E(a=_,ne,ve).call(a,this.middlewares.concat(s),this.resultHandler)}addOptions(t){var r;return E(r=_,ne,ve).call(r,this.middlewares.concat(st({input:Kt.object({}),middleware:async()=>t})),this.resultHandler)}build({input:t,handler:r,output:o,...n}){let{middlewares:s,resultHandler:a}=this;return new Ce({handler:r,middlewares:s,outputSchema:o,resultHandler:a,inputSchema:Ht(s,t),...n})}};ne=new WeakSet,ve=function(t,r){let o=new _(r);return o.middlewares=t,o},w(_,ne);var je=_,Vr=new je(re);import{inspect as Br}from"util";import{LEVEL as Yr,MESSAGE as Jr,SPLAT as Qr}from"triple-beam";import Le from"winston";var{combine:Wr,colorize:Xr,timestamp:eo,printf:to}=Le.format;function ke(e){let t=s=>{let{[Yr]:a,[Jr]:d,[Qr]:c,...p}=s;return Br(p,!1,1,e.color)},r=s=>to(({timestamp:a,message:d,level:c,durationMs:p,...l})=>(typeof d=="object"&&(l={...l,...d},d="[No message]"),`${a} ${c}: ${d}`+(p===void 0?"":` duration: ${p}ms`)+(Object.keys(l).length===0?"":" "+(s?t(l):JSON.stringify(l))))),o=[eo()],n={handleExceptions:!0};switch(e.color&&o.push(Xr()),e.level){case"debug":n.level="debug",o.push(r(!0));break;case"silent":case"warn":default:n.level="warn",o.push(r())}return n.format=Wr(...o),Le.createLogger({silent:e.level==="silent",levels:Le.config.npm.levels,transports:[new Le.transports.Console(n)],exitOnError:!1})}var fe=class{constructor(t){this.methods=t;Object.keys(t).forEach(r=>{if(r in t&&!(t[r]?.getMethods()||[]).includes(r))throw new ue(`The endpoint assigned to the '${r}' parameter must have at least this method in its specification.
|
|
6
6
|
This error should prevent mistakes during the development process.
|
|
7
7
|
Example:
|
|
8
8
|
|
|
9
9
|
new ${this.constructor.name}({
|
|
10
|
-
${
|
|
11
|
-
methods: ['${
|
|
12
|
-
// or method: '${
|
|
10
|
+
${r}: endpointsFactory.build({
|
|
11
|
+
methods: ['${r}', `+((t[r]?.getMethods()||[]).map(n=>`'${n}'`).join(", ")||"...")+`]
|
|
12
|
+
// or method: '${r}'
|
|
13
13
|
...
|
|
14
14
|
})
|
|
15
15
|
});
|
|
16
|
-
`)})}};import ro from"express";var
|
|
17
|
-
The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let
|
|
16
|
+
`)})}};import ro from"express";var ye=class{constructor(...t){this.params=t}apply(t,r){return r(t,ro.static(...this.params))}};var G=({routing:e,onEndpoint:t,onStatic:r,parentPath:o,hasCors:n})=>{Object.entries(e).forEach(([s,a])=>{if(s=s.trim(),s.match(/\//))throw new Q(`Routing elements should not contain '/' character.
|
|
17
|
+
The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let d=`${o||""}${s?`/${s}`:""}`;if(a instanceof oe){let c=a.getMethods().slice();n&&c.push("options"),c.forEach(p=>{t(a,d,p)})}else if(a instanceof ye)r&&a.apply(d,r);else if(a instanceof fe){if(Object.entries(a.methods).forEach(([c,p])=>{t(p,d,c)}),n&&Object.keys(a.methods).length>0){let[c,...p]=Object.keys(a.methods),l=a.methods[c];l._setSiblingMethods(p),t(l,d,"options")}}else G({onEndpoint:t,onStatic:r,hasCors:n,routing:a,parentPath:d})})};var Ft=()=>`
|
|
18
18
|
\x1B[94m\x1B[39m
|
|
19
19
|
\x1B[94m\x1B[39m
|
|
20
20
|
\x1B[94m8888888888 8888888888P 888 d8888 8888888b. 8888888 \x1B[39m
|
|
@@ -31,7 +31,7 @@ The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let
|
|
|
31
31
|
\x1B[90m\x1B[3m Thank you for choosing Express Zod API for your project.\x1B[23m\x1B[39m\x1B[0m\x1B[0m
|
|
32
32
|
\x1B[0m\x1B[0m
|
|
33
33
|
\x1B[0m\x1B[0m
|
|
34
|
-
`.trim();var at=({app:e,logger:r,config:t,routing:o})=>{t.startupLogo!==!1&&console.log(Ft()),_({routing:o,hasCors:!!t.cors,onEndpoint:(n,s,a)=>{e[a](s,async(p,c)=>{r.info(`${p.method}: ${s}`),await n.execute({request:p,response:c,logger:r,config:t})})},onStatic:(n,s)=>{e.use(n,s)}})};import oo,{json as no}from"express";import so from"compression";import io from"express-fileupload";import ao from"https";import $t from"http-errors";var po=(e,r)=>(t,o,n,s)=>{if(!t)return s();e.handler({error:$t(400,Y(t).message),request:o,response:n,logger:r,input:o.body,output:null})},_t=(e,r)=>(t,o)=>{let n=$t(404,`Can not ${t.method} ${t.path}`);try{e.handler({request:t,response:o,logger:r,error:n,input:null,output:null})}catch(s){Ce({response:o,logger:r,error:new Q(Y(s).message,n)})}};function co(e,r){let t=tt(e.logger)?Ue(e.logger):e.logger;at({app:e.app,routing:r,logger:t,config:e});let o=e.errorHandler||te;return{notFoundHandler:_t(o,t),logger:t}}function lo(e,r){let t=tt(e.logger)?Ue(e.logger):e.logger,o=oo();o.disable("x-powered-by");let n=e.errorHandler||te,s=e.server.compression?so({...typeof e.server.compression=="object"?e.server.compression:{}}):void 0,a=e.server.jsonParser||no(),p=e.server.upload?io({...typeof e.server.upload=="object"?e.server.upload:{},abortOnLimit:!1,parseNested:!0}):void 0,c=[].concat(s||[]).concat(a).concat(p||[]);o.use(c),o.use(po(n,t)),at({app:o,routing:r,logger:t,config:e}),o.use(_t(n,t));let d=o.listen(e.server.listen,()=>{t.info(`Listening ${e.server.listen}`)}),l;return e.https&&(l=ao.createServer(e.https.options,o).listen(e.https.listen,()=>{t.info(`Listening ${e.https.listen}`)})),{app:o,httpServer:d,httpsServer:l,logger:t}}import{OpenApiBuilder as Qo}from"openapi3-ts/oas30";import{isReferenceObject as Yt,isSchemaObject as he}from"openapi3-ts/oas30";import{omit as ge}from"ramda";import{z as T}from"zod";import{INVALID as Gt,ZodIssueCode as pt,ZodParsedType as qt,ZodType as mo,addIssueToContext as dt}from"zod";var ct=/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$/,uo="ZodDateIn",Ke=class Ke extends mo{_parse(r){let{status:t,ctx:o}=this._processInputParams(r);if(o.parsedType!==qt.string)return dt(o,{code:pt.invalid_type,expected:qt.string,received:o.parsedType}),Gt;ct.test(o.data)||(dt(o,{code:pt.invalid_string,validation:"regex"}),t.dirty());let n=new Date(o.data);return Re(n)?{status:t.value,value:n}:(dt(o,{code:pt.invalid_date}),Gt)}};Ke.create=()=>new Ke({typeName:uo});var He=Ke;var G=({schema:e,onEach:r,rules:t,onMissing:o,...n})=>{let s="typeName"in e._def?t[e._def.typeName]:void 0,p=s?s({schema:e,...n,next:d=>G({...d,...n,onEach:r,rules:t,onMissing:o})}):o({schema:e,...n}),c=r&&r({schema:e,prev:p,...n});return c?{...p,...c}:p};var Vt=50,Jt="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString",fo={integer:0,number:0,string:"",boolean:!1,object:{},null:null,array:[]},Qt=e=>e.replace(Xe,r=>`{${r.slice(1)}}`),yo=({schema:{_def:{innerType:e,defaultValue:r}},next:t})=>({...t({schema:e}),default:r()}),go=({schema:{_def:{innerType:e}},next:r})=>r({schema:e}),ho=()=>({format:"any"}),xo=e=>{if(e.isResponse)throw new P({message:"Please use z.upload() only for input.",...e});return{type:"string",format:"binary"}},To=({schema:{isBinary:e,isBase64:r},...t})=>{if(!t.isResponse)throw new P({message:"Please use z.file() only within ResultHandler.",...t});return{type:"string",format:e?"binary":r?"byte":"file"}},So=({schema:{options:e},next:r})=>({oneOf:e.map(t=>r({schema:t}))}),Oo=({schema:{options:e,discriminator:r},next:t})=>({discriminator:{propertyName:r},oneOf:Array.from(e.values()).map(o=>t({schema:o}))}),bo=({schema:{_def:{left:e,right:r}},next:t})=>({allOf:[e,r].map(o=>t({schema:o}))}),Ro=({schema:e,next:r})=>r({schema:e.unwrap()}),Po=({schema:e,next:r})=>({nullable:!0,...r({schema:e.unwrap()})}),Bt=({schema:e})=>({type:typeof Object.values(e.enum)[0],enum:Object.values(e.enum)}),Zo=({schema:{value:e}})=>({type:typeof e,enum:[e]}),Eo=({schema:e,isResponse:r,...t})=>{let o=Object.keys(e.shape).filter(n=>{let s=e.shape[n];return!(r&&le(s)?s instanceof T.ZodOptional:s.isOptional())});return{type:"object",properties:Fe({schema:e,isResponse:r,...t}),...o.length?{required:o}:{}}},Ao=()=>({type:"string",nullable:!0,format:"null"}),Io=e=>{if(e.isResponse)throw new P({message:"Please use z.dateOut() for output.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",pattern:ct.source,externalDocs:{url:Jt}}},Co=e=>{if(!e.isResponse)throw new P({message:"Please use z.dateIn() for input.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",externalDocs:{url:Jt}}},Mo=e=>{throw new P({message:`Using z.date() within ${e.isResponse?"output":"input"} schema is forbidden. Please use z.date${e.isResponse?"Out":"In"}() instead. Check out the documentation for details.`,...e})},No=()=>({type:"boolean"}),wo=()=>({type:"integer",format:"bigint"}),Do=({schema:{keySchema:e,valueSchema:r},...t})=>{if(e instanceof T.ZodEnum||e instanceof T.ZodNativeEnum){let o=Object.values(e.enum),n=o.reduce((s,a)=>({...s,[a]:r}),{});return{type:"object",properties:Fe({schema:T.object(n),...t}),...o.length?{required:o}:{}}}if(e instanceof T.ZodLiteral)return{type:"object",properties:Fe({schema:T.object({[e.value]:r}),...t}),required:[e.value]};if(e instanceof T.ZodUnion&&e.options.reduce((n,s)=>n&&s instanceof T.ZodLiteral,!0)){let n=e.options.reduce((s,a)=>({...s,[a.value]:r}),{});return{type:"object",properties:Fe({schema:T.object(n),...t}),required:e.options.map(s=>s.value)}}return{type:"object",additionalProperties:t.next({schema:r})}},zo=({schema:{_def:e,element:r},next:t})=>({type:"array",items:t({schema:r}),...e.minLength!==null&&{minItems:e.minLength.value},...e.maxLength!==null&&{maxItems:e.maxLength.value}}),vo=({schema:{items:e},next:r})=>{let t=e.map(o=>r({schema:o}));return{type:"array",minItems:t.length,maxItems:t.length,items:{oneOf:t,format:"tuple",...t.length>0&&{description:t.map((o,n)=>`${n}: ${he(o)?o.type:o.$ref}`).join(", ")}}}},jo=({schema:{isEmail:e,isURL:r,minLength:t,maxLength:o,isUUID:n,isCUID:s,isCUID2:a,isULID:p,isIP:c,isEmoji:d,isDatetime:l,_def:{checks:f}}})=>{let x=f.find(h=>h.kind==="regex"),g=f.find(h=>h.kind==="datetime"),S=x?x.regex:g?g.offset?new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(([+-]\\d{2}:\\d{2})|Z)$"):new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"):void 0;return{type:"string",...l&&{format:"date-time"},...e&&{format:"email"},...r&&{format:"url"},...n&&{format:"uuid"},...s&&{format:"cuid"},...a&&{format:"cuid2"},...p&&{format:"ulid"},...c&&{format:"ip"},...d&&{format:"emoji"},...t!==null&&{minLength:t},...o!==null&&{maxLength:o},...S&&{pattern:`/${S.source}/${S.flags}`}}},Lo=({schema:e})=>{let r=e._def.checks.find(({kind:s})=>s==="min"),t=r?r.inclusive:!0,o=e._def.checks.find(({kind:s})=>s==="max"),n=o?o.inclusive:!0;return{type:e.isInt?"integer":"number",format:e.isInt?"int64":"double",minimum:e.minValue===null?e.isInt?Number.MIN_SAFE_INTEGER:Number.MIN_VALUE:e.minValue,exclusiveMinimum:!t,maximum:e.maxValue===null?e.isInt?Number.MAX_SAFE_INTEGER:Number.MAX_VALUE:e.maxValue,exclusiveMaximum:!n}},Fe=({schema:{shape:e},next:r})=>Object.keys(e).reduce((t,o)=>({...t,[o]:r({schema:e[o]})}),{}),ko=e=>{let r=Array.isArray(e.type)?e.type[0]:e.type;return fo?.[r]},Uo=({schema:e,isResponse:r,next:t})=>{let o=t({schema:e.innerType()}),{effect:n}=e._def;if(r&&n.type==="transform"&&he(o)){let s=Ee({effect:n,sample:ko(o)});return s&&["number","string","boolean"].includes(s)?{type:s}:t({schema:T.any()})}if(!r&&n.type==="preprocess"&&he(o)){let{type:s,...a}=o;return{...a,format:`${a.format||s} (preprocessed)`}}return o},Ho=({schema:e,isResponse:r,next:t})=>t({schema:e._def[r?"out":"in"]}),Ko=({schema:e,next:r})=>r({schema:e.unwrap()}),Fo=({next:e,schema:r,serializer:t,getRef:o,makeRef:n})=>{let s=t(r.schema);return o(s)||(()=>(n(s,{}),n(s,e({schema:r.schema}))))()},Wt=(e,r,t=[])=>{let o=Pe(e,r);return o.length===0?{}:{examples:o.reduce((n,s,a)=>({...n,[`example${a+1}`]:{value:ge(t,s)}}),{})}},$o=(e,r,t)=>{let o=Pe(e,r);return o.length===0?{}:{examples:o.reduce((n,s,a)=>t in s?{...n,[`example${a+1}`]:{value:s[t]}}:n,{})}};function ye(e,r){if(e instanceof T.ZodObject)return e;let t;if(e instanceof T.ZodUnion||e instanceof T.ZodDiscriminatedUnion)t=Array.from(e.options.values()).map(o=>ye(o,r)).reduce((o,n)=>o.merge(n.partial()),T.object({}));else if(e instanceof T.ZodEffects){if(D(e))throw new P({message:`Using transformations on the top level of ${r.isResponse?"response":"input"} schema is not allowed.`,...r});t=ye(e._def.schema,r)}else t=ye(e._def.left,r).merge(ye(e._def.right,r));return Se(e,t)}var Xt=({path:e,method:r,endpoint:t,inputSources:o,serializer:n,getRef:s,makeRef:a,composition:p,clue:c="parameter"})=>{let d=t.getSchema("input"),l=ye(d,{path:e,method:r,isResponse:!1}).shape,f=ot(e),x=o.includes("query"),g=o.includes("params"),S=h=>g&&f.includes(h);return Object.keys(l).filter(h=>x||S(h)).map(h=>{let y=G({schema:l[h],isResponse:!1,rules:mt,onEach:ut,onMissing:ft,serializer:n,getRef:s,makeRef:a,path:e,method:r}),R=p==="components"?a(I(e,r,`${c} ${h}`),y):y;return{name:h,in:S(h)?"path":"query",required:!l[h].isOptional(),description:he(y)&&y.description||`${r.toUpperCase()} ${e} ${c}`,schema:R,...$o(d,!1,h)}})},mt={ZodString:jo,ZodNumber:Lo,ZodBigInt:wo,ZodBoolean:No,ZodDateIn:Io,ZodDateOut:Co,ZodNull:Ao,ZodArray:zo,ZodTuple:vo,ZodRecord:Do,ZodObject:Eo,ZodLiteral:Zo,ZodIntersection:bo,ZodUnion:So,ZodFile:To,ZodUpload:xo,ZodAny:ho,ZodDefault:yo,ZodEnum:Bt,ZodNativeEnum:Bt,ZodEffects:Uo,ZodOptional:Ro,ZodNullable:Po,ZodDiscriminatedUnion:Oo,ZodBranded:Ko,ZodDate:Mo,ZodCatch:go,ZodPipeline:Ho,ZodLazy:Fo},ut=({schema:e,isResponse:r,prev:t})=>{if(Yt(t))return{};let{description:o}=e,n=e instanceof T.ZodLazy,s=t.type!==void 0,a=r&&le(e),p=!n&&s&&!a&&e.isNullable(),c=n?[]:Pe(e,r);return{...o&&{description:o},...p&&{nullable:!0},...c.length>0&&{example:c[0]}}},ft=({schema:e,...r})=>{throw new P({message:`Zod type ${e.constructor.name} is unsupported.`,...r})},lt=(e,r)=>{if(Yt(e))return e;let t=e.properties?ge(r,e.properties):void 0,o=e.example?ge(r,e.example):void 0,n=e.required?e.required.filter(p=>!r.includes(p)):void 0,s=e.allOf?e.allOf.map(p=>lt(p,r)):void 0,a=e.oneOf?e.oneOf.map(p=>lt(p,r)):void 0;return ge(Object.entries({properties:t,required:n,example:o,allOf:s,oneOf:a}).filter(([{},p])=>p===void 0).map(([p])=>p),{...e,properties:t,required:n,example:o,allOf:s,oneOf:a})},er=e=>he(e)?ge(["example"],e):e,yt=({method:e,path:r,endpoint:t,isPositive:o,serializer:n,getRef:s,makeRef:a,composition:p,clue:c="response"})=>{let d=t.getSchema(o?"positive":"negative"),l=t.getMimeTypes(o?"positive":"negative"),f=er(G({schema:d,isResponse:!0,rules:mt,onEach:ut,onMissing:ft,serializer:n,getRef:s,makeRef:a,path:r,method:e})),x=Wt(d,!0),g=p==="components"?a(I(r,e,c),f):f;return{description:`${e.toUpperCase()} ${r} ${c}`,content:l.reduce((S,h)=>({...S,[h]:{schema:g,...x}}),{})}},_o=()=>({type:"http",scheme:"basic"}),Go=({format:e})=>({type:"http",scheme:"bearer",...e&&{bearerFormat:e}}),qo=({name:e})=>({type:"apiKey",in:"query",name:e}),Vo=({name:e})=>({type:"apiKey",in:"header",name:e}),Bo=({name:e})=>({type:"apiKey",in:"cookie",name:e}),Yo=({url:e})=>({type:"openIdConnect",openIdConnectUrl:e}),Jo=({flows:e={}})=>({type:"oauth2",flows:Object.keys(e).reduce((r,t)=>{let o=e[t];if(!o)return r;let{scopes:n={},...s}=o;return{...r,[t]:{...s,scopes:n}}},{})}),tr=e=>{let r={basic:_o,bearer:Go,input:qo,header:Vo,cookie:Bo,openid:Yo,oauth2:Jo};return Ie(e,t=>r[t.type](t))},$e=e=>{if(typeof e=="object"){if("or"in e)return e.or.map(r=>("and"in r?r.and:[r]).reduce((t,{name:o,scopes:n})=>({...t,[o]:n}),{}));if("and"in e)return $e(st(e))}return $e({or:[e]})},rr=({method:e,path:r,endpoint:t,serializer:o,getRef:n,makeRef:s,composition:a,clue:p="request body"})=>{let c=ot(r),d=er(lt(G({schema:t.getSchema("input"),isResponse:!1,rules:mt,onEach:ut,onMissing:ft,serializer:o,getRef:n,makeRef:s,path:r,method:e}),c)),l=Wt(t.getSchema("input"),!1,c),f=a==="components"?s(I(r,e,p),d):d;return{description:`${e.toUpperCase()} ${r} ${p}`,content:t.getMimeTypes("input").reduce((x,g)=>({...x,[g]:{schema:f,...l}}),{})}},or=e=>Object.keys(e).map(r=>{let t=e[r];return{name:r,description:typeof t=="string"?t:t.description,...typeof t=="object"&&t.url&&{externalDocs:{url:t.url}}}}),gt=e=>e.length<=Vt?e:e.slice(0,Vt-1)+"\u2026";var ht=class extends Qo{constructor({routing:t,config:o,title:n,version:s,serverUrl:a,successfulResponseDescription:p="Successful response",errorResponseDescription:c="Error response",hasSummaryFromDescription:d=!0,composition:l="inline",serializer:f=Ze}){super();this.lastSecuritySchemaIds={};this.lastOperationIdSuffixes={};this.addInfo({title:n,version:s}).addServer({url:a}),_({routing:t,onEndpoint:(g,S,h)=>{let y=h,R={path:S,method:y,endpoint:g,composition:l,serializer:f,getRef:this.getRef.bind(this),makeRef:this.makeRef.bind(this)},[N,q]=["short","long"].map(g.getDescription.bind(g)),ie=o.inputSources?.[y]||be[y],ae=Xt({...R,inputSources:ie}),Z={operationId:this.ensureUniqOperationId(S,y),responses:{[g.getStatusCode("positive")]:yt({...R,clue:p,isPositive:!0}),[g.getStatusCode("negative")]:yt({...R,clue:c,isPositive:!1})}};q&&(Z.description=q,d&&N===void 0&&(Z.summary=gt(q))),N&&(Z.summary=gt(N)),g.getTags().length>0&&(Z.tags=g.getTags()),ae.length>0&&(Z.parameters=ae),ie.includes("body")&&(Z.requestBody=rr(R));let xe=$e(Ie(tr(g.getSecurity()),We=>{let It=this.ensureUniqSecuritySchemaName(We),Er=["oauth2","openIdConnect"].includes(We.type)?g.getScopes():[];return this.addSecurityScheme(It,We),{name:It,scopes:Er}}));xe.length>0&&(Z.security=xe);let Zr=Qt(S);this.addPath(Zr,{[y]:Z})}}),this.rootDoc.tags=o.tags?or(o.tags):[]}makeRef(t,o){return this.addSchema(t,o),this.getRef(t)}getRef(t){return t in(this.rootDoc.components?.schemas||{})?{$ref:`#/components/schemas/${t}`}:void 0}ensureUniqOperationId(t,o){let n=I(t,o);return n in this.lastOperationIdSuffixes?(this.lastOperationIdSuffixes[n]++,`${n}${this.lastOperationIdSuffixes[n]}`):(this.lastOperationIdSuffixes[n]=1,n)}ensureUniqSecuritySchemaName(t){let o=JSON.stringify(t);for(let n in this.rootDoc.components?.securitySchemes||{})if(o===JSON.stringify(this.rootDoc.components?.securitySchemes?.[n]))return n;return this.lastSecuritySchemaIds[t.type]=(this.lastSecuritySchemaIds?.[t.type]||0)+1,`${t.type.toUpperCase()}_${this.lastSecuritySchemaIds[t.type]}`}};import nr from"http";var Wo=e=>({method:"GET",header:jest.fn(()=>H),...e}),Xo=e=>{let r={writableEnded:!1,statusCode:200,statusMessage:nr.STATUS_CODES[200],set:jest.fn(()=>r),status:jest.fn(t=>(r.statusCode=t,r.statusMessage=nr.STATUS_CODES[t],r)),json:jest.fn(()=>r),end:jest.fn(()=>(r.writableEnded=!0,r)),...e};return r},en=async({endpoint:e,requestProps:r,responseProps:t,configProps:o,loggerProps:n,__noJest:s})=>{if(!jest||s)throw new Error("You need to install Jest in order to use testEndpoint().");let a=Wo(r),p=Xo(t),c={info:jest.fn(),warn:jest.fn(),error:jest.fn(),debug:jest.fn(),...n},d={cors:!1,logger:c,...o};return await e.execute({request:a,response:p,config:d,logger:c}),{requestMock:a,responseMock:p,loggerMock:c}};import U from"typescript";import M from"typescript";var i=M.factory,ne=[i.createModifier(M.SyntaxKind.ExportKeyword)],tn=[i.createModifier(M.SyntaxKind.AsyncKeyword)],rn=[i.createModifier(M.SyntaxKind.PublicKeyword),i.createModifier(M.SyntaxKind.ReadonlyKeyword)],sr=[i.createModifier(M.SyntaxKind.ProtectedKeyword),i.createModifier(M.SyntaxKind.ReadonlyKeyword)],on=i.createTemplateHead(""),nn=i.createTemplateTail(""),sn=i.createTemplateMiddle(" "),xt=e=>i.createTemplateLiteralType(on,e.map((r,t)=>i.createTemplateLiteralTypeSpan(i.createTypeReferenceNode(r),t===e.length-1?nn:sn))),Tt=xt(["M","P"]),_e=(e,r,t)=>i.createParameterDeclaration(t,void 0,e,void 0,r),Ge=(e,r)=>Object.keys(e).reduce((t,o)=>t.concat(_e(o,e[o],r)),[]),St=(e,r)=>i.createExpressionWithTypeArguments(i.createIdentifier("Record"),[typeof e=="number"?i.createKeywordTypeNode(e):i.createTypeReferenceNode(e),i.createKeywordTypeNode(r)]),ir=e=>i.createConstructorDeclaration(void 0,e,i.createBlock([])),Ot=(e,r)=>i.createPropertySignature(void 0,`"${e}"`,void 0,i.createTypeReferenceNode(r)),ar=(e,r)=>i.createVariableDeclarationList([i.createVariableDeclaration(e,void 0,void 0,r)],M.NodeFlags.Const),bt=(e,r)=>i.createTypeAliasDeclaration(ne,e,void 0,i.createUnionTypeNode(r.map(t=>i.createLiteralTypeNode(i.createStringLiteral(t))))),qe=(e,r)=>i.createTypeAliasDeclaration(ne,e,void 0,r),pr=(e,r,t)=>i.createPropertyDeclaration(rn,e,void 0,r,t),dr=(e,r,t=[])=>i.createClassDeclaration(ne,e,void 0,void 0,[r,...t]),cr=(e,r)=>i.createTypeReferenceNode("Promise",[i.createIndexedAccessTypeNode(i.createTypeReferenceNode(e),r)]),lr=()=>i.createTypeReferenceNode("Promise",[i.createKeywordTypeNode(M.SyntaxKind.AnyKeyword)]),Rt=(e,r,t)=>i.createInterfaceDeclaration(ne,e,void 0,r,t),mr=e=>Object.keys(e).reduce((r,t)=>r.concat(i.createTypeParameterDeclaration([],t,i.createTypeReferenceNode(e[t]))),[]),ur=(e,r)=>i.createArrowFunction(tn,void 0,e.map(t=>_e(t)),void 0,void 0,i.createCallExpression(i.createPropertyAccessExpression(i.createThis(),"implementation"),void 0,r)),Pt=(e,r,t)=>i.createCallExpression(i.createPropertyAccessExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("Object"),"keys"),void 0,[i.createIdentifier(e)]),"reduce"),void 0,[i.createArrowFunction(void 0,void 0,Ge({acc:void 0,key:void 0}),void 0,void 0,r),t]);import u from"typescript";import{z as pn}from"zod";import L from"typescript";var{factory:Ve}=L,Zt=(e,r)=>{L.addSyntheticLeadingComment(e,L.SyntaxKind.MultiLineCommentTrivia,`* ${r} `,!0)},Be=(e,r,t)=>{let o=Ve.createTypeAliasDeclaration(void 0,Ve.createIdentifier(r),void 0,e);return t&&Zt(o,t),o},fr=(e,r)=>{let t=L.createSourceFile("print.ts","",L.ScriptTarget.Latest,!1,L.ScriptKind.TS);return L.createPrinter(r).printNode(L.EmitHint.Unspecified,e,t)},an=/^[A-Za-z_$][A-Za-z0-9_$]*$/,yr=e=>an.test(e)?Ve.createIdentifier(e):Ve.createStringLiteral(e);var{factory:m}=u,dn={[u.SyntaxKind.AnyKeyword]:"",[u.SyntaxKind.BigIntKeyword]:BigInt(0),[u.SyntaxKind.BooleanKeyword]:!1,[u.SyntaxKind.NumberKeyword]:0,[u.SyntaxKind.ObjectKeyword]:{},[u.SyntaxKind.StringKeyword]:"",[u.SyntaxKind.UndefinedKeyword]:void 0},cn=({schema:{value:e}})=>m.createLiteralTypeNode(typeof e=="number"?m.createNumericLiteral(e):typeof e=="boolean"?e?m.createTrue():m.createFalse():m.createStringLiteral(e)),ln=({schema:{shape:e},isResponse:r,next:t,optionalPropStyle:{withQuestionMark:o}})=>{let n=Object.entries(e).map(([s,a])=>{let p=r&&le(a)?a instanceof pn.ZodOptional:a.isOptional(),c=m.createPropertySignature(void 0,yr(s),p&&o?m.createToken(u.SyntaxKind.QuestionToken):void 0,t({schema:a}));return a.description&&Zt(c,a.description),c});return m.createTypeLiteralNode(n)},mn=({schema:{element:e},next:r})=>m.createArrayTypeNode(r({schema:e})),un=({schema:{options:e}})=>m.createUnionTypeNode(e.map(r=>m.createLiteralTypeNode(m.createStringLiteral(r)))),gr=({schema:{options:e},next:r})=>m.createUnionTypeNode(e.map(t=>r({schema:t}))),fn=e=>dn?.[e.kind],yn=({schema:e,next:r,isResponse:t})=>{let o=r({schema:e.innerType()}),n=e._def.effect;if(t&&n.type==="transform"){let s=Ee({effect:n,sample:fn(o)}),a={number:u.SyntaxKind.NumberKeyword,bigint:u.SyntaxKind.BigIntKeyword,boolean:u.SyntaxKind.BooleanKeyword,string:u.SyntaxKind.StringKeyword,undefined:u.SyntaxKind.UndefinedKeyword,object:u.SyntaxKind.ObjectKeyword};return m.createKeywordTypeNode(s&&a[s]||u.SyntaxKind.AnyKeyword)}return o},gn=({schema:e})=>m.createUnionTypeNode(Object.values(e.enum).map(r=>m.createLiteralTypeNode(typeof r=="number"?m.createNumericLiteral(r):m.createStringLiteral(r)))),hn=({next:e,schema:r,optionalPropStyle:{withUndefined:t}})=>{let o=e({schema:r.unwrap()});return t?m.createUnionTypeNode([o,m.createKeywordTypeNode(u.SyntaxKind.UndefinedKeyword)]):o},xn=({next:e,schema:r})=>m.createUnionTypeNode([e({schema:r.unwrap()}),m.createLiteralTypeNode(m.createNull())]),Tn=({next:e,schema:{items:r}})=>m.createTupleTypeNode(r.map(t=>e({schema:t}))),Sn=({next:e,schema:{keySchema:r,valueSchema:t}})=>m.createExpressionWithTypeArguments(m.createIdentifier("Record"),[e({schema:r}),e({schema:t})]),On=({next:e,schema:r})=>m.createIntersectionTypeNode([r._def.left,r._def.right].map(t=>e({schema:t}))),bn=({next:e,schema:r})=>e({schema:r._def.innerType}),k=e=>()=>m.createKeywordTypeNode(e),Rn=({next:e,schema:r})=>e({schema:r.unwrap()}),Pn=({next:e,schema:r})=>e({schema:r._def.innerType}),Zn=({schema:e,next:r,isResponse:t})=>r({schema:e._def[t?"out":"in"]}),En=()=>m.createLiteralTypeNode(m.createNull()),An=({getAlias:e,makeAlias:r,next:t,serializer:o,schema:n})=>{let s=`Type${o(n.schema)}`;return e(s)||(()=>(r(s,m.createLiteralTypeNode(m.createNull())),r(s,t({schema:n.schema}))))()},In={ZodString:k(u.SyntaxKind.StringKeyword),ZodNumber:k(u.SyntaxKind.NumberKeyword),ZodBigInt:k(u.SyntaxKind.BigIntKeyword),ZodBoolean:k(u.SyntaxKind.BooleanKeyword),ZodDateIn:k(u.SyntaxKind.StringKeyword),ZodDateOut:k(u.SyntaxKind.StringKeyword),ZodNull:En,ZodArray:mn,ZodTuple:Tn,ZodRecord:Sn,ZodObject:ln,ZodLiteral:cn,ZodIntersection:On,ZodUnion:gr,ZodFile:k(u.SyntaxKind.StringKeyword),ZodAny:k(u.SyntaxKind.AnyKeyword),ZodDefault:bn,ZodEnum:un,ZodNativeEnum:gn,ZodEffects:yn,ZodOptional:hn,ZodNullable:xn,ZodDiscriminatedUnion:gr,ZodBranded:Rn,ZodCatch:Pn,ZodPipeline:Zn,ZodLazy:An},Et=({schema:e,...r})=>G({schema:e,rules:In,onMissing:()=>m.createKeywordTypeNode(u.SyntaxKind.AnyKeyword),...r});var At=class{constructor({routing:r,variant:t="client",serializer:o=Ze,optionalPropStyle:n={withQuestionMark:!0,withUndefined:!0}}){this.agg=[];this.registry={};this.paths=[];this.aliases={};_({routing:r,onEndpoint:(y,R,N)=>{let q=I(R,N,"input"),ie=I(R,N,"response"),ae={serializer:o,getAlias:this.getAlias.bind(this),makeAlias:this.makeAlias.bind(this),optionalPropStyle:n},Z=Et({...ae,schema:y.getSchema("input"),isResponse:!1}),xe=Et({...ae,isResponse:!0,schema:y.getSchema("positive").or(y.getSchema("negative"))});this.agg.push(Be(Z,q),Be(xe,ie)),N!=="options"&&(this.paths.push(R),this.registry[`${N} ${R}`]={in:q,out:ie,isJson:y.getMimeTypes("positive").includes(H)})}}),this.agg=Object.values(this.aliases).concat(this.agg);let s=bt("Path",this.paths),a=bt("Method",Ut),p=qe("MethodPath",xt([a.name,s.name])),c=[i.createHeritageClause(U.SyntaxKind.ExtendsKeyword,[St(p.name,U.SyntaxKind.AnyKeyword)])],d=Rt("Input",c,Object.keys(this.registry).map(y=>Ot(y,this.registry[y].in))),l=Rt("Response",c,Object.keys(this.registry).map(y=>Ot(y,this.registry[y].out)));if(this.agg.push(s,a,p,d,l),t==="types")return;let f=i.createVariableStatement(ne,ar("jsonEndpoints",i.createObjectLiteralExpression(Object.keys(this.registry).filter(y=>this.registry[y].isJson).map(y=>i.createPropertyAssignment(`"${y}"`,i.createTrue()))))),x=qe("Provider",i.createFunctionTypeNode(mr({M:a.name,P:s.name}),Ge({method:i.createTypeReferenceNode("M"),path:i.createTypeReferenceNode("P"),params:i.createIndexedAccessTypeNode(i.createTypeReferenceNode(d.name),Tt)}),cr(l.name,Tt))),g=qe("Implementation",i.createFunctionTypeNode(void 0,Ge({method:i.createTypeReferenceNode(a.name),path:i.createKeywordTypeNode(U.SyntaxKind.StringKeyword),params:St(U.SyntaxKind.StringKeyword,U.SyntaxKind.AnyKeyword)}),lr())),S=i.createTemplateExpression(i.createTemplateHead(":"),[i.createTemplateSpan(i.createIdentifier("key"),i.createTemplateTail(""))]),h=dr("ExpressZodAPIClient",ir([_e("implementation",i.createTypeReferenceNode(g.name),sr)]),[pr("provide",i.createTypeReferenceNode(x.name),ur(["method","path","params"],[i.createIdentifier("method"),Pt("params",i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("acc"),"replace"),void 0,[S,i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key"))]),i.createIdentifier("path")),Pt("params",i.createConditionalExpression(i.createBinaryExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("path"),"indexOf"),void 0,[S]),U.SyntaxKind.GreaterThanEqualsToken,i.createNumericLiteral(0)),void 0,i.createIdentifier("acc"),void 0,i.createObjectLiteralExpression([i.createSpreadAssignment(i.createIdentifier("acc")),i.createPropertyAssignment("[key]",i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key")))])),i.createObjectLiteralExpression())]))]);U.addSyntheticLeadingComment(h,U.SyntaxKind.MultiLineCommentTrivia,`
|
|
34
|
+
`.trim();var it=({app:e,logger:t,config:r,routing:o})=>{r.startupLogo!==!1&&console.log(Ft()),G({routing:o,hasCors:!!r.cors,onEndpoint:(n,s,a)=>{e[a](s,async(d,c)=>{t.info(`${d.method}: ${s}`),await n.execute({request:d,response:c,logger:t,config:r})})},onStatic:(n,s)=>{e.use(n,s)}})};import oo,{json as no}from"express";import so from"compression";import io from"express-fileupload";import ao from"https";import $t from"http-errors";var po=(e,t)=>(r,o,n,s)=>{if(!r)return s();e.handler({error:$t(400,J(r).message),request:o,response:n,logger:t,input:o.body,output:null})},_t=(e,t)=>(r,o)=>{let n=$t(404,`Can not ${r.method} ${r.path}`);try{e.handler({request:r,response:o,logger:t,error:n,input:null,output:null})}catch(s){Ie({response:o,logger:t,error:new W(J(s).message,n)})}};function co(e,t){let r=et(e.logger)?ke(e.logger):e.logger;it({app:e.app,routing:t,logger:r,config:e});let o=e.errorHandler||re;return{notFoundHandler:_t(o,r),logger:r}}function lo(e,t){let r=et(e.logger)?ke(e.logger):e.logger,o=oo();o.disable("x-powered-by");let n=e.errorHandler||re,s=e.server.compression?so({...typeof e.server.compression=="object"?e.server.compression:{}}):void 0,a=e.server.jsonParser||no(),d=e.server.upload?io({...typeof e.server.upload=="object"?e.server.upload:{},abortOnLimit:!1,parseNested:!0}):void 0,c=[].concat(s||[]).concat(a).concat(d||[]);o.use(c),o.use(po(n,r)),it({app:o,routing:t,logger:r,config:e}),o.use(_t(n,r));let p=o.listen(e.server.listen,()=>{r.info(`Listening ${e.server.listen}`)}),l;return e.https&&(l=ao.createServer(e.https.options,o).listen(e.https.listen,()=>{r.info(`Listening ${e.https.listen}`)})),{app:o,httpServer:p,httpsServer:l,logger:r}}import{OpenApiBuilder as Wo}from"openapi3-ts/oas30";import{isReferenceObject as Yt,isSchemaObject as xe}from"openapi3-ts/oas30";import{omit as he}from"ramda";import{z as T}from"zod";import{INVALID as Gt,ZodIssueCode as at,ZodParsedType as qt,ZodType as mo,addIssueToContext as dt}from"zod";var pt=/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$/,uo="ZodDateIn",He=class He extends mo{_parse(t){let{status:r,ctx:o}=this._processInputParams(t);if(o.parsedType!==qt.string)return dt(o,{code:at.invalid_type,expected:qt.string,received:o.parsedType}),Gt;pt.test(o.data)||(dt(o,{code:at.invalid_string,validation:"regex"}),r.dirty());let n=new Date(o.data);return Re(n)?{status:r.value,value:n}:(dt(o,{code:at.invalid_date}),Gt)}};He.create=()=>new He({typeName:uo});var Ue=He;var q=({schema:e,onEach:t,rules:r,onMissing:o,...n})=>{let s="typeName"in e._def?r[e._def.typeName]:void 0,d=s?s({schema:e,...n,next:p=>q({...p,...n,onEach:t,rules:r,onMissing:o})}):o({schema:e,...n}),c=t&&t({schema:e,prev:d,...n});return c?{...d,...c}:d};var Vt=50,Jt="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString",fo={integer:0,number:0,string:"",boolean:!1,object:{},null:null,array:[]},Qt=e=>e.replace(We,t=>`{${t.slice(1)}}`),yo=({schema:{_def:{innerType:e,defaultValue:t}},next:r})=>({...r({schema:e}),default:t()}),go=({schema:{_def:{innerType:e}},next:t})=>t({schema:e}),ho=()=>({format:"any"}),xo=e=>{if(e.isResponse)throw new P({message:"Please use z.upload() only for input.",...e});return{type:"string",format:"binary"}},To=({schema:{isBinary:e,isBase64:t},...r})=>{if(!r.isResponse)throw new P({message:"Please use z.file() only within ResultHandler.",...r});return{type:"string",format:e?"binary":t?"byte":"file"}},So=({schema:{options:e},next:t})=>({oneOf:e.map(r=>t({schema:r}))}),Oo=({schema:{options:e,discriminator:t},next:r})=>({discriminator:{propertyName:t},oneOf:Array.from(e.values()).map(o=>r({schema:o}))}),bo=({schema:{_def:{left:e,right:t}},next:r})=>({allOf:[e,t].map(o=>r({schema:o}))}),Ro=({schema:e,next:t})=>t({schema:e.unwrap()}),Po=({schema:e,next:t})=>t({schema:e._def.innerType}),Zo=({schema:e,next:t})=>({nullable:!0,...t({schema:e.unwrap()})}),Bt=({schema:e})=>({type:typeof Object.values(e.enum)[0],enum:Object.values(e.enum)}),Eo=({schema:{value:e}})=>({type:typeof e,enum:[e]}),Ao=({schema:e,isResponse:t,...r})=>{let o=Object.keys(e.shape).filter(n=>{let s=e.shape[n];return!(t&&me(s)?s instanceof T.ZodOptional:s.isOptional())});return{type:"object",properties:Ke({schema:e,isResponse:t,...r}),...o.length?{required:o}:{}}},Io=()=>({type:"string",nullable:!0,format:"null"}),Co=e=>{if(e.isResponse)throw new P({message:"Please use z.dateOut() for output.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",pattern:pt.source,externalDocs:{url:Jt}}},Mo=e=>{if(!e.isResponse)throw new P({message:"Please use z.dateIn() for input.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",externalDocs:{url:Jt}}},No=e=>{throw new P({message:`Using z.date() within ${e.isResponse?"output":"input"} schema is forbidden. Please use z.date${e.isResponse?"Out":"In"}() instead. Check out the documentation for details.`,...e})},wo=()=>({type:"boolean"}),Do=()=>({type:"integer",format:"bigint"}),zo=({schema:{keySchema:e,valueSchema:t},...r})=>{if(e instanceof T.ZodEnum||e instanceof T.ZodNativeEnum){let o=Object.values(e.enum),n=o.reduce((s,a)=>({...s,[a]:t}),{});return{type:"object",properties:Ke({schema:T.object(n),...r}),...o.length?{required:o}:{}}}if(e instanceof T.ZodLiteral)return{type:"object",properties:Ke({schema:T.object({[e.value]:t}),...r}),required:[e.value]};if(e instanceof T.ZodUnion&&e.options.reduce((n,s)=>n&&s instanceof T.ZodLiteral,!0)){let n=e.options.reduce((s,a)=>({...s,[a.value]:t}),{});return{type:"object",properties:Ke({schema:T.object(n),...r}),required:e.options.map(s=>s.value)}}return{type:"object",additionalProperties:r.next({schema:t})}},vo=({schema:{_def:e,element:t},next:r})=>({type:"array",items:r({schema:t}),...e.minLength!==null&&{minItems:e.minLength.value},...e.maxLength!==null&&{maxItems:e.maxLength.value}}),jo=({schema:{items:e},next:t})=>{let r=e.map(o=>t({schema:o}));return{type:"array",minItems:r.length,maxItems:r.length,items:{oneOf:r,format:"tuple",...r.length>0&&{description:r.map((o,n)=>`${n}: ${xe(o)?o.type:o.$ref}`).join(", ")}}}},Lo=({schema:{isEmail:e,isURL:t,minLength:r,maxLength:o,isUUID:n,isCUID:s,isCUID2:a,isULID:d,isIP:c,isEmoji:p,isDatetime:l,_def:{checks:f}}})=>{let x=f.find(h=>h.kind==="regex"),g=f.find(h=>h.kind==="datetime"),S=x?x.regex:g?g.offset?new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(([+-]\\d{2}:\\d{2})|Z)$"):new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"):void 0;return{type:"string",...l&&{format:"date-time"},...e&&{format:"email"},...t&&{format:"url"},...n&&{format:"uuid"},...s&&{format:"cuid"},...a&&{format:"cuid2"},...d&&{format:"ulid"},...c&&{format:"ip"},...p&&{format:"emoji"},...r!==null&&{minLength:r},...o!==null&&{maxLength:o},...S&&{pattern:`/${S.source}/${S.flags}`}}},ko=({schema:e})=>{let t=e._def.checks.find(({kind:s})=>s==="min"),r=t?t.inclusive:!0,o=e._def.checks.find(({kind:s})=>s==="max"),n=o?o.inclusive:!0;return{type:e.isInt?"integer":"number",format:e.isInt?"int64":"double",minimum:e.minValue===null?e.isInt?Number.MIN_SAFE_INTEGER:Number.MIN_VALUE:e.minValue,exclusiveMinimum:!r,maximum:e.maxValue===null?e.isInt?Number.MAX_SAFE_INTEGER:Number.MAX_VALUE:e.maxValue,exclusiveMaximum:!n}},Ke=({schema:{shape:e},next:t})=>Object.keys(e).reduce((r,o)=>({...r,[o]:t({schema:e[o]})}),{}),Uo=e=>{let t=Array.isArray(e.type)?e.type[0]:e.type;return fo?.[t]},Ho=({schema:e,isResponse:t,next:r})=>{let o=r({schema:e.innerType()}),{effect:n}=e._def;if(t&&n.type==="transform"&&xe(o)){let s=Ze({effect:n,sample:Uo(o)});return s&&["number","string","boolean"].includes(s)?{type:s}:r({schema:T.any()})}if(!t&&n.type==="preprocess"&&xe(o)){let{type:s,...a}=o;return{...a,format:`${a.format||s} (preprocessed)`}}return o},Ko=({schema:e,isResponse:t,next:r})=>r({schema:e._def[t?"out":"in"]}),Fo=({schema:e,next:t})=>t({schema:e.unwrap()}),$o=({next:e,schema:t,serializer:r,getRef:o,makeRef:n})=>{let s=r(t.schema);return o(s)||(()=>(n(s,{}),n(s,e({schema:t.schema}))))()},Wt=(e,t,r=[])=>{let o=F({schema:e,variant:t?"parsed":"original",validate:!0});return o.length===0?{}:{examples:o.reduce((n,s,a)=>({...n,[`example${a+1}`]:{value:he(r,s)}}),{})}},_o=(e,t,r)=>{let o=F({schema:e,variant:t?"parsed":"original",validate:!0});return o.length===0?{}:{examples:o.reduce((n,s,a)=>r in s?{...n,[`example${a+1}`]:{value:s[r]}}:n,{})}};function ge(e,t){if(e instanceof T.ZodObject)return e;let r;if(e instanceof T.ZodUnion||e instanceof T.ZodDiscriminatedUnion)r=Array.from(e.options.values()).map(o=>ge(o,t)).reduce((o,n)=>o.merge(n.partial()),T.object({}));else if(e instanceof T.ZodEffects){if(D(e))throw new P({message:`Using transformations on the top level of ${t.isResponse?"response":"input"} schema is not allowed.`,...t});r=ge(e._def.schema,t)}else r=ge(e._def.left,t).merge(ge(e._def.right,t));return Se(e,r)}var Xt=({path:e,method:t,endpoint:r,inputSources:o,serializer:n,getRef:s,makeRef:a,composition:d,clue:c="parameter"})=>{let p=r.getSchema("input"),l=ge(p,{path:e,method:t,isResponse:!1}).shape,f=rt(e),x=o.includes("query"),g=o.includes("params"),S=h=>g&&f.includes(h);return Object.keys(l).filter(h=>x||S(h)).map(h=>{let y=q({schema:l[h],isResponse:!1,rules:lt,onEach:mt,onMissing:ut,serializer:n,getRef:s,makeRef:a,path:e,method:t}),R=d==="components"?a(I(e,t,`${c} ${h}`),y):y;return{name:h,in:S(h)?"path":"query",required:!l[h].isOptional(),description:xe(y)&&y.description||`${t.toUpperCase()} ${e} ${c}`,schema:R,..._o(p,!1,h)}})},lt={ZodString:Lo,ZodNumber:ko,ZodBigInt:Do,ZodBoolean:wo,ZodDateIn:Co,ZodDateOut:Mo,ZodNull:Io,ZodArray:vo,ZodTuple:jo,ZodRecord:zo,ZodObject:Ao,ZodLiteral:Eo,ZodIntersection:bo,ZodUnion:So,ZodFile:To,ZodUpload:xo,ZodAny:ho,ZodDefault:yo,ZodEnum:Bt,ZodNativeEnum:Bt,ZodEffects:Ho,ZodOptional:Ro,ZodNullable:Zo,ZodDiscriminatedUnion:Oo,ZodBranded:Fo,ZodDate:No,ZodCatch:go,ZodPipeline:Ko,ZodLazy:$o,ZodReadonly:Po},mt=({schema:e,isResponse:t,prev:r})=>{if(Yt(r))return{};let{description:o}=e,n=e instanceof T.ZodLazy,s=r.type!==void 0,a=t&&me(e),d=!n&&s&&!a&&e.isNullable(),c=n?[]:F({schema:e,variant:t?"parsed":"original",validate:!0});return{...o&&{description:o},...d&&{nullable:!0},...c.length>0&&{example:c[0]}}},ut=({schema:e,...t})=>{throw new P({message:`Zod type ${e.constructor.name} is unsupported.`,...t})},ct=(e,t)=>{if(Yt(e))return e;let r=e.properties?he(t,e.properties):void 0,o=e.example?he(t,e.example):void 0,n=e.required?e.required.filter(d=>!t.includes(d)):void 0,s=e.allOf?e.allOf.map(d=>ct(d,t)):void 0,a=e.oneOf?e.oneOf.map(d=>ct(d,t)):void 0;return he(Object.entries({properties:r,required:n,example:o,allOf:s,oneOf:a}).filter(([{},d])=>d===void 0).map(([d])=>d),{...e,properties:r,required:n,example:o,allOf:s,oneOf:a})},er=e=>xe(e)?he(["example"],e):e,ft=({method:e,path:t,endpoint:r,isPositive:o,serializer:n,getRef:s,makeRef:a,composition:d,clue:c="response"})=>{let p=r.getSchema(o?"positive":"negative"),l=r.getMimeTypes(o?"positive":"negative"),f=er(q({schema:p,isResponse:!0,rules:lt,onEach:mt,onMissing:ut,serializer:n,getRef:s,makeRef:a,path:t,method:e})),x=Wt(p,!0),g=d==="components"?a(I(t,e,c),f):f;return{description:`${e.toUpperCase()} ${t} ${c}`,content:l.reduce((S,h)=>({...S,[h]:{schema:g,...x}}),{})}},Go=()=>({type:"http",scheme:"basic"}),qo=({format:e})=>({type:"http",scheme:"bearer",...e&&{bearerFormat:e}}),Vo=({name:e})=>({type:"apiKey",in:"query",name:e}),Bo=({name:e})=>({type:"apiKey",in:"header",name:e}),Yo=({name:e})=>({type:"apiKey",in:"cookie",name:e}),Jo=({url:e})=>({type:"openIdConnect",openIdConnectUrl:e}),Qo=({flows:e={}})=>({type:"oauth2",flows:Object.keys(e).reduce((t,r)=>{let o=e[r];if(!o)return t;let{scopes:n={},...s}=o;return{...t,[r]:{...s,scopes:n}}},{})}),tr=e=>{let t={basic:Go,bearer:qo,input:Vo,header:Bo,cookie:Yo,openid:Jo,oauth2:Qo};return Ae(e,r=>t[r.type](r))},Fe=e=>{if(typeof e=="object"){if("or"in e)return e.or.map(t=>("and"in t?t.and:[t]).reduce((r,{name:o,scopes:n})=>({...r,[o]:n}),{}));if("and"in e)return Fe(nt(e))}return Fe({or:[e]})},rr=({method:e,path:t,endpoint:r,serializer:o,getRef:n,makeRef:s,composition:a,clue:d="request body"})=>{let c=rt(t),p=er(ct(q({schema:r.getSchema("input"),isResponse:!1,rules:lt,onEach:mt,onMissing:ut,serializer:o,getRef:n,makeRef:s,path:t,method:e}),c)),l=Wt(r.getSchema("input"),!1,c),f=a==="components"?s(I(t,e,d),p):p;return{description:`${e.toUpperCase()} ${t} ${d}`,content:r.getMimeTypes("input").reduce((x,g)=>({...x,[g]:{schema:f,...l}}),{})}},or=e=>Object.keys(e).map(t=>{let r=e[t];return{name:t,description:typeof r=="string"?r:r.description,...typeof r=="object"&&r.url&&{externalDocs:{url:r.url}}}}),yt=e=>e.length<=Vt?e:e.slice(0,Vt-1)+"\u2026";var gt=class extends Wo{constructor({routing:r,config:o,title:n,version:s,serverUrl:a,successfulResponseDescription:d="Successful response",errorResponseDescription:c="Error response",hasSummaryFromDescription:p=!0,composition:l="inline",serializer:f=Pe}){super();this.lastSecuritySchemaIds={};this.lastOperationIdSuffixes={};this.addInfo({title:n,version:s}).addServer({url:a}),G({routing:r,onEndpoint:(g,S,h)=>{let y=h,R={path:S,method:y,endpoint:g,composition:l,serializer:f,getRef:this.getRef.bind(this),makeRef:this.makeRef.bind(this)},[N,V]=["short","long"].map(g.getDescription.bind(g)),ae=o.inputSources?.[y]||be[y],de=Xt({...R,inputSources:ae}),Z={operationId:this.ensureUniqOperationId(S,y),responses:{[g.getStatusCode("positive")]:ft({...R,clue:d,isPositive:!0}),[g.getStatusCode("negative")]:ft({...R,clue:c,isPositive:!1})}};V&&(Z.description=V,p&&N===void 0&&(Z.summary=yt(V))),N&&(Z.summary=yt(N)),g.getTags().length>0&&(Z.tags=g.getTags()),de.length>0&&(Z.parameters=de),ae.includes("body")&&(Z.requestBody=rr(R));let Te=Fe(Ae(tr(g.getSecurity()),Qe=>{let At=this.ensureUniqSecuritySchemaName(Qe),Er=["oauth2","openIdConnect"].includes(Qe.type)?g.getScopes():[];return this.addSecurityScheme(At,Qe),{name:At,scopes:Er}}));Te.length>0&&(Z.security=Te);let Zr=Qt(S);this.addPath(Zr,{[y]:Z})}}),this.rootDoc.tags=o.tags?or(o.tags):[]}makeRef(r,o){return this.addSchema(r,o),this.getRef(r)}getRef(r){return r in(this.rootDoc.components?.schemas||{})?{$ref:`#/components/schemas/${r}`}:void 0}ensureUniqOperationId(r,o){let n=I(r,o);return n in this.lastOperationIdSuffixes?(this.lastOperationIdSuffixes[n]++,`${n}${this.lastOperationIdSuffixes[n]}`):(this.lastOperationIdSuffixes[n]=1,n)}ensureUniqSecuritySchemaName(r){let o=JSON.stringify(r);for(let n in this.rootDoc.components?.securitySchemes||{})if(o===JSON.stringify(this.rootDoc.components?.securitySchemes?.[n]))return n;return this.lastSecuritySchemaIds[r.type]=(this.lastSecuritySchemaIds?.[r.type]||0)+1,`${r.type.toUpperCase()}_${this.lastSecuritySchemaIds[r.type]}`}};import nr from"http";var Xo=e=>({method:"GET",header:jest.fn(()=>H),...e}),en=e=>{let t={writableEnded:!1,statusCode:200,statusMessage:nr.STATUS_CODES[200],set:jest.fn(()=>t),status:jest.fn(r=>(t.statusCode=r,t.statusMessage=nr.STATUS_CODES[r],t)),json:jest.fn(()=>t),end:jest.fn(()=>(t.writableEnded=!0,t)),...e};return t},tn=async({endpoint:e,requestProps:t,responseProps:r,configProps:o,loggerProps:n,__noJest:s})=>{if(!jest||s)throw new Error("You need to install Jest in order to use testEndpoint().");let a=Xo(t),d=en(r),c={info:jest.fn(),warn:jest.fn(),error:jest.fn(),debug:jest.fn(),...n},p={cors:!1,logger:c,...o};return await e.execute({request:a,response:d,config:p,logger:c}),{requestMock:a,responseMock:d,loggerMock:c}};import U from"typescript";import M from"typescript";var i=M.factory,se=[i.createModifier(M.SyntaxKind.ExportKeyword)],rn=[i.createModifier(M.SyntaxKind.AsyncKeyword)],on=[i.createModifier(M.SyntaxKind.PublicKeyword),i.createModifier(M.SyntaxKind.ReadonlyKeyword)],sr=[i.createModifier(M.SyntaxKind.ProtectedKeyword),i.createModifier(M.SyntaxKind.ReadonlyKeyword)],nn=i.createTemplateHead(""),sn=i.createTemplateTail(""),an=i.createTemplateMiddle(" "),ht=e=>i.createTemplateLiteralType(nn,e.map((t,r)=>i.createTemplateLiteralTypeSpan(i.createTypeReferenceNode(t),r===e.length-1?sn:an))),xt=ht(["M","P"]),$e=(e,t,r)=>i.createParameterDeclaration(r,void 0,e,void 0,t),_e=(e,t)=>Object.keys(e).reduce((r,o)=>r.concat($e(o,e[o],t)),[]),Tt=(e,t)=>i.createExpressionWithTypeArguments(i.createIdentifier("Record"),[typeof e=="number"?i.createKeywordTypeNode(e):i.createTypeReferenceNode(e),i.createKeywordTypeNode(t)]),ir=e=>i.createConstructorDeclaration(void 0,e,i.createBlock([])),St=(e,t)=>i.createPropertySignature(void 0,`"${e}"`,void 0,i.createTypeReferenceNode(t)),ar=(e,t)=>i.createVariableDeclarationList([i.createVariableDeclaration(e,void 0,void 0,t)],M.NodeFlags.Const),Ot=(e,t)=>i.createTypeAliasDeclaration(se,e,void 0,i.createUnionTypeNode(t.map(r=>i.createLiteralTypeNode(i.createStringLiteral(r))))),Ge=(e,t)=>i.createTypeAliasDeclaration(se,e,void 0,t),dr=(e,t,r)=>i.createPropertyDeclaration(on,e,void 0,t,r),pr=(e,t,r=[])=>i.createClassDeclaration(se,e,void 0,void 0,[t,...r]),cr=(e,t)=>i.createTypeReferenceNode("Promise",[i.createIndexedAccessTypeNode(i.createTypeReferenceNode(e),t)]),lr=()=>i.createTypeReferenceNode("Promise",[i.createKeywordTypeNode(M.SyntaxKind.AnyKeyword)]),bt=(e,t,r)=>i.createInterfaceDeclaration(se,e,void 0,t,r),mr=e=>Object.keys(e).reduce((t,r)=>t.concat(i.createTypeParameterDeclaration([],r,i.createTypeReferenceNode(e[r]))),[]),ur=(e,t)=>i.createArrowFunction(rn,void 0,e.map(r=>$e(r)),void 0,void 0,i.createCallExpression(i.createPropertyAccessExpression(i.createThis(),"implementation"),void 0,t)),Rt=(e,t,r)=>i.createCallExpression(i.createPropertyAccessExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("Object"),"keys"),void 0,[i.createIdentifier(e)]),"reduce"),void 0,[i.createArrowFunction(void 0,void 0,_e({acc:void 0,key:void 0}),void 0,void 0,t),r]);import u from"typescript";import{z as pn}from"zod";import L from"typescript";var{factory:qe}=L,Pt=(e,t)=>{L.addSyntheticLeadingComment(e,L.SyntaxKind.MultiLineCommentTrivia,`* ${t} `,!0)},Ve=(e,t,r)=>{let o=qe.createTypeAliasDeclaration(void 0,qe.createIdentifier(t),void 0,e);return r&&Pt(o,r),o},fr=(e,t)=>{let r=L.createSourceFile("print.ts","",L.ScriptTarget.Latest,!1,L.ScriptKind.TS);return L.createPrinter(t).printNode(L.EmitHint.Unspecified,e,r)},dn=/^[A-Za-z_$][A-Za-z0-9_$]*$/,yr=e=>dn.test(e)?qe.createIdentifier(e):qe.createStringLiteral(e);var{factory:m}=u,cn={[u.SyntaxKind.AnyKeyword]:"",[u.SyntaxKind.BigIntKeyword]:BigInt(0),[u.SyntaxKind.BooleanKeyword]:!1,[u.SyntaxKind.NumberKeyword]:0,[u.SyntaxKind.ObjectKeyword]:{},[u.SyntaxKind.StringKeyword]:"",[u.SyntaxKind.UndefinedKeyword]:void 0},ln=({schema:{value:e}})=>m.createLiteralTypeNode(typeof e=="number"?m.createNumericLiteral(e):typeof e=="boolean"?e?m.createTrue():m.createFalse():m.createStringLiteral(e)),mn=({schema:{shape:e},isResponse:t,next:r,optionalPropStyle:{withQuestionMark:o}})=>{let n=Object.entries(e).map(([s,a])=>{let d=t&&me(a)?a instanceof pn.ZodOptional:a.isOptional(),c=m.createPropertySignature(void 0,yr(s),d&&o?m.createToken(u.SyntaxKind.QuestionToken):void 0,r({schema:a}));return a.description&&Pt(c,a.description),c});return m.createTypeLiteralNode(n)},un=({schema:{element:e},next:t})=>m.createArrayTypeNode(t({schema:e})),fn=({schema:{options:e}})=>m.createUnionTypeNode(e.map(t=>m.createLiteralTypeNode(m.createStringLiteral(t)))),gr=({schema:{options:e},next:t})=>m.createUnionTypeNode(e.map(r=>t({schema:r}))),yn=e=>cn?.[e.kind],gn=({schema:e,next:t,isResponse:r})=>{let o=t({schema:e.innerType()}),n=e._def.effect;if(r&&n.type==="transform"){let s=Ze({effect:n,sample:yn(o)}),a={number:u.SyntaxKind.NumberKeyword,bigint:u.SyntaxKind.BigIntKeyword,boolean:u.SyntaxKind.BooleanKeyword,string:u.SyntaxKind.StringKeyword,undefined:u.SyntaxKind.UndefinedKeyword,object:u.SyntaxKind.ObjectKeyword};return m.createKeywordTypeNode(s&&a[s]||u.SyntaxKind.AnyKeyword)}return o},hn=({schema:e})=>m.createUnionTypeNode(Object.values(e.enum).map(t=>m.createLiteralTypeNode(typeof t=="number"?m.createNumericLiteral(t):m.createStringLiteral(t)))),xn=({next:e,schema:t,optionalPropStyle:{withUndefined:r}})=>{let o=e({schema:t.unwrap()});return r?m.createUnionTypeNode([o,m.createKeywordTypeNode(u.SyntaxKind.UndefinedKeyword)]):o},Tn=({next:e,schema:t})=>m.createUnionTypeNode([e({schema:t.unwrap()}),m.createLiteralTypeNode(m.createNull())]),Sn=({next:e,schema:{items:t}})=>m.createTupleTypeNode(t.map(r=>e({schema:r}))),On=({next:e,schema:{keySchema:t,valueSchema:r}})=>m.createExpressionWithTypeArguments(m.createIdentifier("Record"),[e({schema:t}),e({schema:r})]),bn=({next:e,schema:t})=>m.createIntersectionTypeNode([t._def.left,t._def.right].map(r=>e({schema:r}))),Rn=({next:e,schema:t})=>e({schema:t._def.innerType}),k=e=>()=>m.createKeywordTypeNode(e),Pn=({next:e,schema:t})=>e({schema:t.unwrap()}),Zn=({next:e,schema:t})=>e({schema:t._def.innerType}),En=({next:e,schema:t})=>e({schema:t._def.innerType}),An=({schema:e,next:t,isResponse:r})=>t({schema:e._def[r?"out":"in"]}),In=()=>m.createLiteralTypeNode(m.createNull()),Cn=({getAlias:e,makeAlias:t,next:r,serializer:o,schema:n})=>{let s=`Type${o(n.schema)}`;return e(s)||(()=>(t(s,m.createLiteralTypeNode(m.createNull())),t(s,r({schema:n.schema}))))()},Mn={ZodString:k(u.SyntaxKind.StringKeyword),ZodNumber:k(u.SyntaxKind.NumberKeyword),ZodBigInt:k(u.SyntaxKind.BigIntKeyword),ZodBoolean:k(u.SyntaxKind.BooleanKeyword),ZodDateIn:k(u.SyntaxKind.StringKeyword),ZodDateOut:k(u.SyntaxKind.StringKeyword),ZodNull:In,ZodArray:un,ZodTuple:Sn,ZodRecord:On,ZodObject:mn,ZodLiteral:ln,ZodIntersection:bn,ZodUnion:gr,ZodFile:k(u.SyntaxKind.StringKeyword),ZodAny:k(u.SyntaxKind.AnyKeyword),ZodDefault:Rn,ZodEnum:fn,ZodNativeEnum:hn,ZodEffects:gn,ZodOptional:xn,ZodNullable:Tn,ZodDiscriminatedUnion:gr,ZodBranded:Pn,ZodCatch:En,ZodPipeline:An,ZodLazy:Cn,ZodReadonly:Zn},Zt=({schema:e,...t})=>q({schema:e,rules:Mn,onMissing:()=>m.createKeywordTypeNode(u.SyntaxKind.AnyKeyword),...t});var Et=class{constructor({routing:t,variant:r="client",serializer:o=Pe,optionalPropStyle:n={withQuestionMark:!0,withUndefined:!0}}){this.agg=[];this.registry={};this.paths=[];this.aliases={};G({routing:t,onEndpoint:(y,R,N)=>{let V=I(R,N,"input"),ae=I(R,N,"response"),de={serializer:o,getAlias:this.getAlias.bind(this),makeAlias:this.makeAlias.bind(this),optionalPropStyle:n},Z=Zt({...de,schema:y.getSchema("input"),isResponse:!1}),Te=Zt({...de,isResponse:!0,schema:y.getSchema("positive").or(y.getSchema("negative"))});this.agg.push(Ve(Z,V),Ve(Te,ae)),N!=="options"&&(this.paths.push(R),this.registry[`${N} ${R}`]={in:V,out:ae,isJson:y.getMimeTypes("positive").includes(H)})}}),this.agg=Object.values(this.aliases).concat(this.agg);let s=Ot("Path",this.paths),a=Ot("Method",Ut),d=Ge("MethodPath",ht([a.name,s.name])),c=[i.createHeritageClause(U.SyntaxKind.ExtendsKeyword,[Tt(d.name,U.SyntaxKind.AnyKeyword)])],p=bt("Input",c,Object.keys(this.registry).map(y=>St(y,this.registry[y].in))),l=bt("Response",c,Object.keys(this.registry).map(y=>St(y,this.registry[y].out)));if(this.agg.push(s,a,d,p,l),r==="types")return;let f=i.createVariableStatement(se,ar("jsonEndpoints",i.createObjectLiteralExpression(Object.keys(this.registry).filter(y=>this.registry[y].isJson).map(y=>i.createPropertyAssignment(`"${y}"`,i.createTrue()))))),x=Ge("Provider",i.createFunctionTypeNode(mr({M:a.name,P:s.name}),_e({method:i.createTypeReferenceNode("M"),path:i.createTypeReferenceNode("P"),params:i.createIndexedAccessTypeNode(i.createTypeReferenceNode(p.name),xt)}),cr(l.name,xt))),g=Ge("Implementation",i.createFunctionTypeNode(void 0,_e({method:i.createTypeReferenceNode(a.name),path:i.createKeywordTypeNode(U.SyntaxKind.StringKeyword),params:Tt(U.SyntaxKind.StringKeyword,U.SyntaxKind.AnyKeyword)}),lr())),S=i.createTemplateExpression(i.createTemplateHead(":"),[i.createTemplateSpan(i.createIdentifier("key"),i.createTemplateTail(""))]),h=pr("ExpressZodAPIClient",ir([$e("implementation",i.createTypeReferenceNode(g.name),sr)]),[dr("provide",i.createTypeReferenceNode(x.name),ur(["method","path","params"],[i.createIdentifier("method"),Rt("params",i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("acc"),"replace"),void 0,[S,i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key"))]),i.createIdentifier("path")),Rt("params",i.createConditionalExpression(i.createBinaryExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("path"),"indexOf"),void 0,[S]),U.SyntaxKind.GreaterThanEqualsToken,i.createNumericLiteral(0)),void 0,i.createIdentifier("acc"),void 0,i.createObjectLiteralExpression([i.createSpreadAssignment(i.createIdentifier("acc")),i.createPropertyAssignment("[key]",i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key")))])),i.createObjectLiteralExpression())]))]);U.addSyntheticLeadingComment(h,U.SyntaxKind.MultiLineCommentTrivia,`
|
|
35
35
|
export const exampleImplementation: Implementation = async (
|
|
36
36
|
method,
|
|
37
37
|
path,
|
|
@@ -52,6 +52,6 @@ export const exampleImplementation: Implementation = async (
|
|
|
52
52
|
|
|
53
53
|
const client = new ExpressZodAPIClient(exampleImplementation);
|
|
54
54
|
client.provide("get", "/v1/user/retrieve", { id: "10" });
|
|
55
|
-
`,!0),this.agg.push(f,x,g,h)}getAlias(
|
|
55
|
+
`,!0),this.agg.push(f,x,g,h)}getAlias(t){return t in this.aliases?i.createTypeReferenceNode(t):void 0}makeAlias(t,r){return this.aliases[t]=Ve(r,t),this.getAlias(t)}print(t){return this.agg.map(r=>fr(r,t)).join(`
|
|
56
56
|
|
|
57
|
-
`)}};var Pr={};Ir(Pr,{dateIn:()=>
|
|
57
|
+
`)}};var Pr={};Ir(Pr,{dateIn:()=>Un,dateOut:()=>Hn,file:()=>Ln,upload:()=>kn});import{INVALID as hr,ZodIssueCode as xr,ZodParsedType as Tr,ZodType as Nn,addIssueToContext as Sr}from"zod";var wn="ZodDateOut",Ye=class Ye extends Nn{_parse(t){let{status:r,ctx:o}=this._processInputParams(t);return o.parsedType!==Tr.date?(Sr(o,{code:xr.invalid_type,expected:Tr.date,received:o.parsedType}),hr):Re(o.data)?{status:r.value,value:o.data.toISOString()}:(Sr(o,{code:xr.invalid_date}),hr)}};Ye.create=()=>new Ye({typeName:wn});var Be=Ye;import{INVALID as Dn,ZodIssueCode as Or,ZodParsedType as br,ZodType as zn,addIssueToContext as Rr}from"zod";var vn="ZodFile",jn=/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,ie=class ie extends zn{constructor(){super(...arguments);this.binary=r=>new ie({...this._def,checks:[...this._def.checks,{kind:"binary",...ot(r)}]});this.base64=r=>new ie({...this._def,checks:[...this._def.checks,{kind:"base64",...ot(r)}]})}_parse(r){let{status:o,ctx:n}=this._processInputParams(r);if(n.parsedType!==br.string)return Rr(n,{code:Or.invalid_type,expected:br.string,received:n.parsedType}),Dn;for(let s of this._def.checks)s.kind==="base64"&&(jn.test(n.data)||(Rr(n,{code:Or.custom,message:s.message}),o.dirty()));return{status:o.value,value:n.data}}get isBinary(){return!!this._def.checks.find(r=>r.kind==="binary")}get isBase64(){return!!this._def.checks.find(r=>r.kind==="base64")}};ie.create=()=>new ie({checks:[],typeName:vn});var Je=ie;var Ln=Je.create,kn=Y.create,Un=Ue.create,Hn=Be.create;import yd from"http-errors";export{oe as AbstractEndpoint,fe as DependsOnMethod,ue as DependsOnMethodError,gt as Documentation,P as DocumentationError,je as EndpointsFactory,z as InputValidationError,Et as Integration,$ as OutputValidationError,Q as RoutingError,ye as ServeStatic,co as attachRouting,Mr as createConfig,yd as createHttpError,ke as createLogger,st as createMiddleware,wt as createResultHandler,lo as createServer,Vr as defaultEndpointsFactory,re as defaultResultHandler,Pr as ez,F as getExamples,K as getMessageFromError,tt as getStatusCodeFromError,tn as testEndpoint,B as withMeta};
|
package/dist/esm/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"type":"module","version":"11.
|
|
1
|
+
{"type":"module","version":"11.4.0"}
|
package/dist/index.d.ts
CHANGED
|
@@ -136,6 +136,21 @@ type MethodsDefinition<M extends Method> = {
|
|
|
136
136
|
type FlatObject = Record<string, any>;
|
|
137
137
|
declare function getMessageFromError(error: Error): string;
|
|
138
138
|
declare function getStatusCodeFromError(error: Error): number;
|
|
139
|
+
declare const getExamples: <T extends z.ZodTypeAny, V extends "original" | "parsed" | undefined>({ schema, variant, validate, }: {
|
|
140
|
+
schema: T;
|
|
141
|
+
/**
|
|
142
|
+
* @desc examples variant: original or parsed
|
|
143
|
+
* @example "parsed" — for the case when possible schema transformations should be applied
|
|
144
|
+
* @default "original"
|
|
145
|
+
* @override validate: variant "parsed" activates validation as well
|
|
146
|
+
* */
|
|
147
|
+
variant?: V | undefined;
|
|
148
|
+
/**
|
|
149
|
+
* @desc filters out the examples that do not match the schema
|
|
150
|
+
* @default variant === "parsed"
|
|
151
|
+
* */
|
|
152
|
+
validate?: boolean | undefined;
|
|
153
|
+
}) => readonly (V extends "parsed" ? z.output<T> : z.input<T>)[];
|
|
139
154
|
type ErrMessage = Exclude<Parameters<typeof z.ZodString.prototype.email>[0], undefined>;
|
|
140
155
|
|
|
141
156
|
declare const metaProp = "expressZodApiMeta";
|
|
@@ -841,4 +856,4 @@ declare namespace proprietarySchemas {
|
|
|
841
856
|
};
|
|
842
857
|
}
|
|
843
858
|
|
|
844
|
-
export { AbstractEndpoint, DependsOnMethod, DependsOnMethodError, Documentation, DocumentationError, EndpointsFactory, FlatObject, IOSchema, InputValidationError, Integration, LoggerConfig, Method, OutputValidationError, Routing, RoutingError, ServeStatic, ZodDateInDef, ZodDateOutDef, ZodFileDef, ZodUploadDef, attachRouting, createConfig, createLogger, createMiddleware, createResultHandler, createServer, defaultEndpointsFactory, defaultResultHandler, proprietarySchemas as ez, getMessageFromError, getStatusCodeFromError, testEndpoint, withMeta };
|
|
859
|
+
export { AbstractEndpoint, DependsOnMethod, DependsOnMethodError, Documentation, DocumentationError, EndpointsFactory, FlatObject, IOSchema, InputValidationError, Integration, LoggerConfig, Method, OutputValidationError, Routing, RoutingError, ServeStatic, ZodDateInDef, ZodDateOutDef, ZodFileDef, ZodUploadDef, attachRouting, createConfig, createLogger, createMiddleware, createResultHandler, createServer, defaultEndpointsFactory, defaultResultHandler, proprietarySchemas as ez, getExamples, getMessageFromError, getStatusCodeFromError, testEndpoint, withMeta };
|
package/dist/index.js
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
"use strict";var Fr=Object.create;var
|
|
2
|
-
Caused by ${s?"response":"input"} schema of an Endpoint assigned to ${o.toUpperCase()} method of ${n} path.`;super(a);this.name="DocumentationError"}},
|
|
1
|
+
"use strict";var Fr=Object.create;var Ce=Object.defineProperty;var $r=Object.getOwnPropertyDescriptor;var _r=Object.getOwnPropertyNames;var Gr=Object.getPrototypeOf,qr=Object.prototype.hasOwnProperty;var Ht=(e,t)=>{for(var r in t)Ce(e,r,{get:t[r],enumerable:!0})},Kt=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of _r(t))!qr.call(e,n)&&n!==r&&Ce(e,n,{get:()=>t[n],enumerable:!(o=$r(t,n))||o.enumerable});return e};var R=(e,t,r)=>(r=e!=null?Fr(Gr(e)):{},Kt(t||!e||!e.__esModule?Ce(r,"default",{value:e,enumerable:!0}):r,e)),Vr=e=>Kt(Ce({},"__esModule",{value:!0}),e);var Br=(e,t,r)=>{if(!t.has(e))throw TypeError("Cannot "+r)};var F=(e,t,r)=>{if(t.has(e))throw TypeError("Cannot add the same private member more than once");t instanceof WeakSet?t.add(e):t.set(e,r)};var N=(e,t,r)=>(Br(e,t,"access private method"),r);var In={};Ht(In,{AbstractEndpoint:()=>ee,DependsOnMethod:()=>ue,DependsOnMethodError:()=>ae,Documentation:()=>et,DocumentationError:()=>I,EndpointsFactory:()=>Pe,InputValidationError:()=>v,Integration:()=>it,OutputValidationError:()=>q,RoutingError:()=>Q,ServeStatic:()=>fe,attachRouting:()=>mr,createConfig:()=>$t,createHttpError:()=>Ur.default,createLogger:()=>Ee,createMiddleware:()=>Ve,createResultHandler:()=>ht,createServer:()=>ur,defaultEndpointsFactory:()=>nr,defaultResultHandler:()=>X,ez:()=>kt,getExamples:()=>G,getMessageFromError:()=>_,getStatusCodeFromError:()=>ve,testEndpoint:()=>Zr,withMeta:()=>Y});module.exports=Vr(In);var Ft={silent:!0,warn:!0,debug:!0},$t=e=>e;var L=require("zod");var Vt=require("crypto"),Bt=require("http-errors"),b=require("zod");var Me=require("ramda"),Z="expressZodApiMeta",Yr=e=>{let t=e.constructor,r=(0,Me.clone)(e._def);return r[Z]=r[Z]||{examples:[]},new t(r)},Y=e=>{let t=Yr(e);return Object.defineProperties(t,{example:{get:()=>r=>{let o=Y(t);return o._def[Z].examples.push(r),o}}}),t},_t=e=>Z in e._def?typeof e._def[Z]=="object"&&e._def[Z]!==null:!1;function Gt(e,t){if(!_t(e))return;let r=e._def;return t in r[Z]?r[Z][t]:void 0}var Ne=(e,t)=>{if(!_t(e))return t;let r=Y(t),o=Se(r._def[Z].examples,e._def[Z].examples);if(r._def[Z].examples=[],o.type==="single")r._def[Z].examples=o.value;else for(let[n,s]of o.value)r._def[Z].examples.push((0,Me.mergeDeepRight)({...n},{...s}));return r};var qt=R(require("mime")),J=qt.default.getType("json")||"application/json",Oe="multipart/form-data";var A=require("zod"),Jr="ZodUpload",Qr=e=>typeof e=="object"&&e!==null&&"name"in e&&"encoding"in e&&"mimetype"in e&&"data"in e&&"tempFilePath"in e&&"truncated"in e&&"size"in e&&"md5"in e&&"mv"in e&&typeof e.name=="string"&&typeof e.mimetype=="string"&&typeof e.data=="object"&&typeof e.tempFilePath=="string"&&typeof e.truncated=="boolean"&&typeof e.size=="number"&&typeof e.md5=="string"&&typeof e.mv=="function",we=class we extends A.ZodType{_parse(t){let{ctx:r}=this._processInputParams(t);return r.parsedType!==A.ZodParsedType.object||!Qr(r.data)?((0,A.addIssueToContext)(r,{code:A.ZodIssueCode.custom,message:`Expected file upload, received ${r.parsedType}`}),A.INVALID):(0,A.OK)(r.data)}};we.create=()=>new we({typeName:Jr});var se=we;var lt=/:([A-Za-z0-9_]+)/g;function Wr(e){let r=(e.header("content-type")||"").slice(0,Oe.length).toLowerCase()===Oe;return"files"in e&&r}var De={get:["query","params"],post:["body","params","files"],put:["body","params"],patch:["body","params"],delete:["query","params"]},Xr=["body","query","params"],mt=e=>e.method.toLowerCase();function Yt(e,t){let r=mt(e);if(r==="options")return{};let o=Xr;return r in De&&(o=De[r]),t&&r in t&&(o=t[r]||o),o.filter(n=>n==="files"?Wr(e):!0).reduce((n,s)=>({...n,...e[s]}),{})}function ut(e){return typeof e=="object"&&"level"in e&&"color"in e&&Object.keys(Ft).includes(e.level)&&typeof e.color=="boolean"}function ze(e){return!isNaN(e.getTime())}function ie(e){return e instanceof Error?e:new Error(typeof e=="symbol"?e.toString():`${e}`)}function _(e){return e instanceof b.z.ZodError?e.issues.map(({path:t,message:r})=>(t.length?[t.join("/")]:[]).concat(r).join(": ")).join("; "):e instanceof q?`output${e.originalError.issues[0]?.path.length>0?"/":": "}${e.message}`:e.message}function ve(e){return e instanceof Bt.HttpError?e.statusCode:e instanceof v?400:500}var G=({schema:e,variant:t="original",validate:r=t==="parsed"})=>{let o=Gt(e,"examples")||[];if(!r&&t==="original")return o;let n=[];for(let s of o){let a=e.safeParse(s);a.success&&n.push(t==="parsed"?a.data:s)}return n},Se=(e,t)=>{if(e.length===0)return{type:"single",value:t};if(t.length===0)return{type:"single",value:e};let r=[];for(let o of e)for(let n of t)r.push([o,n]);return{type:"tuple",value:r}};function ft(e){let t=e.match(lt);return t?t.map(r=>r.slice(1)):[]}var be=e=>e.reduce((t,r)=>t||r,!1);function $(e){return e instanceof b.z.ZodEffects&&e._def.effect.type!=="refinement"?!0:e instanceof b.z.ZodUnion?be(e.options.map($)):e instanceof b.z.ZodIntersection?be([e._def.left,e._def.right].map($)):!1}function w(e){return e instanceof se?!0:e instanceof b.z.ZodObject?be(Object.values(e.shape).map(w)):e instanceof b.z.ZodUnion?be(e.options.map(w)):e instanceof b.z.ZodIntersection?be([e._def.left,e._def.right].map(w)):e instanceof b.z.ZodOptional||e instanceof b.z.ZodNullable?w(e.unwrap()):e instanceof b.z.ZodEffects||e instanceof b.z.ZodTransformer?w(e._def.schema):e instanceof b.z.ZodRecord?w(e._def.valueType):e instanceof b.z.ZodArray?w(e._def.type):e instanceof b.z.ZodDefault?w(e._def.innerType):!1}var Re=e=>"coerce"in e._def&&typeof e._def.coerce=="boolean"?e._def.coerce:!1,z=(e,t,r)=>[t].concat(e.split("/")).concat(r||[]).flatMap(o=>o.split(/[^A-Z0-9]/gi)).map(o=>o.slice(0,1).toUpperCase()+o.slice(1).toLowerCase()).join(""),je=e=>(0,Vt.createHash)("sha1").update(JSON.stringify(e),"utf8").digest("hex"),Le=({effect:e,sample:t})=>{try{return typeof e.transform(t,{addIssue:()=>{},path:[]})}catch{return}},yt=e=>typeof e=="string"?{message:e}:e||{};var Q=class extends Error{constructor(){super(...arguments);this.name="RoutingError"}},ae=class extends Q{constructor(){super(...arguments);this.name="DependsOnMethodError"}},I=class extends Error{constructor({message:r,method:o,path:n,isResponse:s}){let a=`${r}
|
|
2
|
+
Caused by ${s?"response":"input"} schema of an Endpoint assigned to ${o.toUpperCase()} method of ${n} path.`;super(a);this.name="DocumentationError"}},V=class extends Error{constructor(){super(...arguments);this.name="IOSchemaError"}},q=class extends V{constructor(r){super(_(r));this.name="OutputValidationError";this.originalError=r}},v=class extends V{constructor(r){super(_(r));this.name="InputValidationError";this.originalError=r}},de=class extends Error{constructor(r,o){super(r);this.name="ResultHandlerError";this.originalError=o||void 0}};var j=e=>typeof e=="object"&&e!==null,ke=e=>({and:e.reduce((t,r)=>t.concat(j(r)&&"and"in r?r.and:r),[])}),Ue=(e,t)=>{if(j(e)){if("and"in e)return{and:e.and.map(r=>j(r)&&"or"in r?{or:r.or.map(t)}:t(r))};if("or"in e)return{or:e.or.map(r=>j(r)&&"and"in r?{and:r.and.map(t)}:t(r))}}return t(e)},gt=e=>e.and.reduce((t,r)=>{let o=Se(t.or,j(r)&&"or"in r?r.or:[r]);return o.type==="single"?t.or.push(...o.value):t.or=o.value.map(ke),t},{or:[]}),pe=(e,t)=>{if(j(e)){if("and"in e){if(j(t)){if("and"in t)return ke([e,t]);if("or"in t)return pe(gt(e),t)}return ke([e,t])}if("or"in e){if(j(t)){if("and"in t)return pe(t,e);if("or"in t){let r=Se(e.or,t.or);return{or:r.type==="single"?r.value:r.value.map(ke)}}}return pe(e,{and:[t]})}}return j(t)&&("and"in t||"or"in t)?pe(t,e):{and:[e,t]}};var W=require("zod");var ce={positive:200,negative:400},ht=e=>e,X=ht({getPositiveResponse:e=>{let t=G({schema:e}),r=Y(W.z.object({status:W.z.literal("success"),data:e}));return t.reduce((o,n)=>o.example({status:"success",data:n}),r)},getNegativeResponse:()=>Y(W.z.object({status:W.z.literal("error"),error:W.z.object({message:W.z.string()})})).example({status:"error",error:{message:_(new Error("Sample error message"))}}),handler:({error:e,input:t,output:r,request:o,response:n,logger:s})=>{if(!e){n.status(ce.positive).json({status:"success",data:r});return}let a=ve(e);a===500&&s.error(`Internal server error
|
|
3
3
|
${e.stack}
|
|
4
|
-
`,{url:o.url,payload:
|
|
5
|
-
Original error: ${e.originalError.message}.`:""))};var Jt=(e,
|
|
4
|
+
`,{url:o.url,payload:t}),n.status(a).json({status:"error",error:{message:_(e)}})}}),He=({error:e,logger:t,response:r})=>{t.error(`Result handler failure: ${e.message}.`),r.status(500).end(`An error occurred while serving the result: ${e.message}.`+(e.originalError?`
|
|
5
|
+
Original error: ${e.originalError.message}.`:""))};var Jt=(e,t=[J])=>{if(e instanceof L.z.ZodType)return t;let{mimeTypes:r,mimeType:o}=e;return o?[o]:r||t},ee=class{},Fe,Qt,$e,Wt,_e,Xt,Ge,er,qe,tr,Ke=class extends ee{constructor({middlewares:r,inputSchema:o,outputSchema:n,handler:s,resultHandler:a,description:d,shortDescription:c,...p}){super();F(this,Fe);F(this,$e);F(this,_e);F(this,Ge);F(this,qe);this.methods=[];this.siblingMethods=[];this.middlewares=[];this.scopes=[];this.tags=[];[{name:"input schema",schema:o},{name:"output schema",schema:n}].forEach(({name:f,schema:x})=>{if($(x))throw new V(`Using transformations on the top level of endpoint ${f} is not allowed.`)}),this.middlewares=r;let l={positive:a.getPositiveResponse(n),negative:a.getNegativeResponse()};this.mimeTypes={input:w(o)?[Oe]:[J],positive:Jt(l.positive),negative:Jt(l.negative)},this.schemas={input:o,output:n,positive:l.positive instanceof L.z.ZodType?l.positive:l.positive.schema,negative:l.negative instanceof L.z.ZodType?l.negative:l.negative.schema},this.statusCodes={positive:l.positive instanceof L.z.ZodType?ce.positive:l.positive.statusCode||ce.positive,negative:l.negative instanceof L.z.ZodType?ce.negative:l.negative.statusCode||ce.negative},this.handler=s,this.resultHandler=a,this.descriptions={long:d,short:c},"scopes"in p&&p.scopes&&this.scopes.push(...p.scopes),"scope"in p&&p.scope&&this.scopes.push(p.scope),"tags"in p&&p.tags&&this.tags.push(...p.tags),"tag"in p&&p.tag&&this.tags.push(p.tag),"methods"in p?this.methods=p.methods:this.methods=[p.method]}_setSiblingMethods(r){this.siblingMethods=r}getDescription(r){return this.descriptions[r]}getMethods(){return this.methods}getSchema(r){return this.schemas[r]}getMimeTypes(r){return this.mimeTypes[r]}getStatusCode(r){return this.statusCodes[r]}getSecurity(){return this.middlewares.reduce((r,o)=>o.security?pe(r,o.security):r,{and:[]})}getScopes(){return this.scopes}getTags(){return this.tags}async execute({request:r,response:o,logger:n,config:s}){let a=mt(r),d,c=null;if(s.cors){let l=N(this,Fe,Qt).call(this);typeof s.cors=="function"&&(l=await s.cors({request:r,logger:n,endpoint:this,defaultHeaders:l}));for(let f in l)o.set(f,l[f])}let p=Yt(r,s.inputSources);try{let{options:l,isStreamClosed:f}=await N(this,_e,Xt).call(this,{method:a,input:p,request:r,response:o,logger:n});if(f)return;if(a==="options"){o.status(200).end();return}d=await N(this,$e,Wt).call(this,await N(this,Ge,er).call(this,{input:p,options:l,logger:n}))}catch(l){c=ie(l)}await N(this,qe,tr).call(this,{input:p,output:d,request:r,response:o,error:c,logger:n})}};Fe=new WeakSet,Qt=function(){return{"Access-Control-Allow-Origin":"*","Access-Control-Allow-Methods":this.methods.concat(this.siblingMethods).concat("options").join(", ").toUpperCase(),"Access-Control-Allow-Headers":"content-type"}},$e=new WeakSet,Wt=async function(r){try{return await this.schemas.output.parseAsync(r)}catch(o){throw o instanceof L.z.ZodError?new q(o):o}},_e=new WeakSet,Xt=async function({method:r,input:o,request:n,response:s,logger:a}){let d={},c=!1;for(let p of this.middlewares){if(r==="options"&&p.type==="proprietary")continue;let l;try{l=await p.input.parseAsync(o)}catch(f){throw f instanceof L.z.ZodError?new v(f):f}if(Object.assign(d,await p.middleware({input:l,options:d,request:n,response:s,logger:a})),c="writableEnded"in s&&s.writableEnded,c){a.warn(`The middleware ${p.middleware.name} has closed the stream. Accumulated options:`,d);break}}return{options:d,isStreamClosed:c}},Ge=new WeakSet,er=async function({input:r,options:o,logger:n}){let s;try{s=await this.schemas.input.parseAsync(r)}catch(a){throw a instanceof L.z.ZodError?new v(a):a}return this.handler({input:s,options:o,logger:n})},qe=new WeakSet,tr=async function({error:r,request:o,response:n,logger:s,input:a,output:d}){try{await this.resultHandler.handler({error:r,output:d,request:o,response:n,logger:s,input:a})}catch(c){He({logger:s,response:n,error:new de(ie(c).message,r)})}};var rr=["get","post","put","delete","patch"];var xt=require("zod");var or=(e,t)=>{let r=e.map(({input:n})=>n).concat(t),o=r.reduce((n,s)=>n.and(s));return r.reduce((n,s)=>Ne(s,n),o)};var Ve=e=>{if($(e.input))throw new V("Using transformations on the top level of middleware input schema is not allowed.");return{...e,type:"proprietary"}};var le,Be,te=class te{constructor(t){this.middlewares=[];this.use=this.addExpressMiddleware;this.resultHandler="resultHandler"in t?t.resultHandler:t}addMiddleware(t){var r;return N(r=te,le,Be).call(r,this.middlewares.concat(t),this.resultHandler)}addExpressMiddleware(t,r){var a;let o=r?.transformer||(d=>d),n=r?.provider||(()=>({})),s={type:"express",input:xt.z.object({}),middleware:async({request:d,response:c})=>new Promise((p,l)=>{t(d,c,x=>{if(x&&x instanceof Error)return l(o(x));p(n(d,c))})})};return N(a=te,le,Be).call(a,this.middlewares.concat(s),this.resultHandler)}addOptions(t){var r;return N(r=te,le,Be).call(r,this.middlewares.concat(Ve({input:xt.z.object({}),middleware:async()=>t})),this.resultHandler)}build({input:t,handler:r,output:o,...n}){let{middlewares:s,resultHandler:a}=this;return new Ke({handler:r,middlewares:s,outputSchema:o,resultHandler:a,inputSchema:or(s,t),...n})}};le=new WeakSet,Be=function(t,r){let o=new te(r);return o.middlewares=t,o},F(te,le);var Pe=te,nr=new Pe(X);var sr=require("util"),me=require("triple-beam"),Ze=R(require("winston")),{combine:eo,colorize:to,timestamp:ro,printf:oo}=Ze.default.format;function Ee(e){let t=s=>{let{[me.LEVEL]:a,[me.MESSAGE]:d,[me.SPLAT]:c,...p}=s;return(0,sr.inspect)(p,!1,1,e.color)},r=s=>oo(({timestamp:a,message:d,level:c,durationMs:p,...l})=>(typeof d=="object"&&(l={...l,...d},d="[No message]"),`${a} ${c}: ${d}`+(p===void 0?"":` duration: ${p}ms`)+(Object.keys(l).length===0?"":" "+(s?t(l):JSON.stringify(l))))),o=[ro()],n={handleExceptions:!0};switch(e.color&&o.push(to()),e.level){case"debug":n.level="debug",o.push(r(!0));break;case"silent":case"warn":default:n.level="warn",o.push(r())}return n.format=eo(...o),Ze.default.createLogger({silent:e.level==="silent",levels:Ze.default.config.npm.levels,transports:[new Ze.default.transports.Console(n)],exitOnError:!1})}var ue=class{constructor(t){this.methods=t;Object.keys(t).forEach(r=>{if(r in t&&!(t[r]?.getMethods()||[]).includes(r))throw new ae(`The endpoint assigned to the '${r}' parameter must have at least this method in its specification.
|
|
6
6
|
This error should prevent mistakes during the development process.
|
|
7
7
|
Example:
|
|
8
8
|
|
|
9
9
|
new ${this.constructor.name}({
|
|
10
|
-
${
|
|
11
|
-
methods: ['${
|
|
12
|
-
// or method: '${
|
|
10
|
+
${r}: endpointsFactory.build({
|
|
11
|
+
methods: ['${r}', `+((t[r]?.getMethods()||[]).map(n=>`'${n}'`).join(", ")||"...")+`]
|
|
12
|
+
// or method: '${r}'
|
|
13
13
|
...
|
|
14
14
|
})
|
|
15
15
|
});
|
|
16
|
-
`)})}};var ir=R(require("express")),
|
|
17
|
-
The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let
|
|
16
|
+
`)})}};var ir=R(require("express")),fe=class{constructor(...t){this.params=t}apply(t,r){return r(t,ir.default.static(...this.params))}};var re=({routing:e,onEndpoint:t,onStatic:r,parentPath:o,hasCors:n})=>{Object.entries(e).forEach(([s,a])=>{if(s=s.trim(),s.match(/\//))throw new Q(`Routing elements should not contain '/' character.
|
|
17
|
+
The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let d=`${o||""}${s?`/${s}`:""}`;if(a instanceof ee){let c=a.getMethods().slice();n&&c.push("options"),c.forEach(p=>{t(a,d,p)})}else if(a instanceof fe)r&&a.apply(d,r);else if(a instanceof ue){if(Object.entries(a.methods).forEach(([c,p])=>{t(p,d,c)}),n&&Object.keys(a.methods).length>0){let[c,...p]=Object.keys(a.methods),l=a.methods[c];l._setSiblingMethods(p),t(l,d,"options")}}else re({onEndpoint:t,onStatic:r,hasCors:n,routing:a,parentPath:d})})};var ar=()=>`
|
|
18
18
|
\x1B[94m\x1B[39m
|
|
19
19
|
\x1B[94m\x1B[39m
|
|
20
20
|
\x1B[94m8888888888 8888888888P 888 d8888 8888888b. 8888888 \x1B[39m
|
|
@@ -31,7 +31,7 @@ The error caused by ${o?`'${o}' route that has a '${s}'`:`'${s}'`} entry.`);let
|
|
|
31
31
|
\x1B[90m\x1B[3m Thank you for choosing Express Zod API for your project.\x1B[23m\x1B[39m\x1B[0m\x1B[0m
|
|
32
32
|
\x1B[0m\x1B[0m
|
|
33
33
|
\x1B[0m\x1B[0m
|
|
34
|
-
`.trim();var St=({app:e,logger:r,config:t,routing:o})=>{t.startupLogo!==!1&&console.log(ar()),te({routing:o,hasCors:!!t.cors,onEndpoint:(n,s,a)=>{e[a](s,async(p,c)=>{r.info(`${p.method}: ${s}`),await n.execute({request:p,response:c,logger:r,config:t})})},onStatic:(n,s)=>{e.use(n,s)}})};var Je=R(require("express")),pr=R(require("compression")),dr=R(require("express-fileupload")),cr=R(require("https"));var Ot=R(require("http-errors")),no=(e,r)=>(t,o,n,s)=>{if(!t)return s();e.handler({error:(0,Ot.default)(400,se(t).message),request:o,response:n,logger:r,input:o.body,output:null})},lr=(e,r)=>(t,o)=>{let n=(0,Ot.default)(404,`Can not ${t.method} ${t.path}`);try{e.handler({request:t,response:o,logger:r,error:n,input:null,output:null})}catch(s){Ke({response:o,logger:r,error:new ae(se(s).message,n)})}};function mr(e,r){let t=ft(e.logger)?Ze(e.logger):e.logger;St({app:e.app,routing:r,logger:t,config:e});let o=e.errorHandler||W;return{notFoundHandler:lr(o,t),logger:t}}function ur(e,r){let t=ft(e.logger)?Ze(e.logger):e.logger,o=(0,Je.default)();o.disable("x-powered-by");let n=e.errorHandler||W,s=e.server.compression?(0,pr.default)({...typeof e.server.compression=="object"?e.server.compression:{}}):void 0,a=e.server.jsonParser||(0,Je.json)(),p=e.server.upload?(0,dr.default)({...typeof e.server.upload=="object"?e.server.upload:{},abortOnLimit:!1,parseNested:!0}):void 0,c=[].concat(s||[]).concat(a).concat(p||[]);o.use(c),o.use(no(n,t)),St({app:o,routing:r,logger:t,config:e}),o.use(lr(n,t));let d=o.listen(e.server.listen,()=>{t.info(`Listening ${e.server.listen}`)}),l;return e.https&&(l=cr.default.createServer(e.https.options,o).listen(e.https.listen,()=>{t.info(`Listening ${e.https.listen}`)})),{app:o,httpServer:d,httpsServer:l,logger:t}}var Pr=require("openapi3-ts/oas30");var k=require("openapi3-ts/oas30"),fe=require("ramda"),T=require("zod");var S=require("zod");var bt=/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$/,so="ZodDateIn",We=class We extends S.ZodType{_parse(r){let{status:t,ctx:o}=this._processInputParams(r);if(o.parsedType!==S.ZodParsedType.string)return(0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_type,expected:S.ZodParsedType.string,received:o.parsedType}),S.INVALID;bt.test(o.data)||((0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_string,validation:"regex"}),t.dirty());let n=new Date(o.data);return ze(n)?{status:t.value,value:n}:((0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_date}),S.INVALID)}};We.create=()=>new We({typeName:so});var Qe=We;var re=({schema:e,onEach:r,rules:t,onMissing:o,...n})=>{let s="typeName"in e._def?t[e._def.typeName]:void 0,p=s?s({schema:e,...n,next:d=>re({...d,...n,onEach:r,rules:t,onMissing:o})}):o({schema:e,...n}),c=r&&r({schema:e,prev:p,...n});return c?{...p,...c}:p};var fr=50,gr="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString",io={integer:0,number:0,string:"",boolean:!1,object:{},null:null,array:[]},hr=e=>e.replace(mt,r=>`{${r.slice(1)}}`),ao=({schema:{_def:{innerType:e,defaultValue:r}},next:t})=>({...t({schema:e}),default:r()}),po=({schema:{_def:{innerType:e}},next:r})=>r({schema:e}),co=()=>({format:"any"}),lo=e=>{if(e.isResponse)throw new I({message:"Please use z.upload() only for input.",...e});return{type:"string",format:"binary"}},mo=({schema:{isBinary:e,isBase64:r},...t})=>{if(!t.isResponse)throw new I({message:"Please use z.file() only within ResultHandler.",...t});return{type:"string",format:e?"binary":r?"byte":"file"}},uo=({schema:{options:e},next:r})=>({oneOf:e.map(t=>r({schema:t}))}),fo=({schema:{options:e,discriminator:r},next:t})=>({discriminator:{propertyName:r},oneOf:Array.from(e.values()).map(o=>t({schema:o}))}),yo=({schema:{_def:{left:e,right:r}},next:t})=>({allOf:[e,r].map(o=>t({schema:o}))}),go=({schema:e,next:r})=>r({schema:e.unwrap()}),ho=({schema:e,next:r})=>({nullable:!0,...r({schema:e.unwrap()})}),yr=({schema:e})=>({type:typeof Object.values(e.enum)[0],enum:Object.values(e.enum)}),xo=({schema:{value:e}})=>({type:typeof e,enum:[e]}),To=({schema:e,isResponse:r,...t})=>{let o=Object.keys(e.shape).filter(n=>{let s=e.shape[n];return!(r&&be(s)?s instanceof T.z.ZodOptional:s.isOptional())});return{type:"object",properties:Xe({schema:e,isResponse:r,...t}),...o.length?{required:o}:{}}},So=()=>({type:"string",nullable:!0,format:"null"}),Oo=e=>{if(e.isResponse)throw new I({message:"Please use z.dateOut() for output.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",pattern:bt.source,externalDocs:{url:gr}}},bo=e=>{if(!e.isResponse)throw new I({message:"Please use z.dateIn() for input.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",externalDocs:{url:gr}}},Ro=e=>{throw new I({message:`Using z.date() within ${e.isResponse?"output":"input"} schema is forbidden. Please use z.date${e.isResponse?"Out":"In"}() instead. Check out the documentation for details.`,...e})},Po=()=>({type:"boolean"}),Zo=()=>({type:"integer",format:"bigint"}),Eo=({schema:{keySchema:e,valueSchema:r},...t})=>{if(e instanceof T.z.ZodEnum||e instanceof T.z.ZodNativeEnum){let o=Object.values(e.enum),n=o.reduce((s,a)=>({...s,[a]:r}),{});return{type:"object",properties:Xe({schema:T.z.object(n),...t}),...o.length?{required:o}:{}}}if(e instanceof T.z.ZodLiteral)return{type:"object",properties:Xe({schema:T.z.object({[e.value]:r}),...t}),required:[e.value]};if(e instanceof T.z.ZodUnion&&e.options.reduce((n,s)=>n&&s instanceof T.z.ZodLiteral,!0)){let n=e.options.reduce((s,a)=>({...s,[a.value]:r}),{});return{type:"object",properties:Xe({schema:T.z.object(n),...t}),required:e.options.map(s=>s.value)}}return{type:"object",additionalProperties:t.next({schema:r})}},Ao=({schema:{_def:e,element:r},next:t})=>({type:"array",items:t({schema:r}),...e.minLength!==null&&{minItems:e.minLength.value},...e.maxLength!==null&&{maxItems:e.maxLength.value}}),Io=({schema:{items:e},next:r})=>{let t=e.map(o=>r({schema:o}));return{type:"array",minItems:t.length,maxItems:t.length,items:{oneOf:t,format:"tuple",...t.length>0&&{description:t.map((o,n)=>`${n}: ${(0,k.isSchemaObject)(o)?o.type:o.$ref}`).join(", ")}}}},Co=({schema:{isEmail:e,isURL:r,minLength:t,maxLength:o,isUUID:n,isCUID:s,isCUID2:a,isULID:p,isIP:c,isEmoji:d,isDatetime:l,_def:{checks:f}}})=>{let x=f.find(h=>h.kind==="regex"),g=f.find(h=>h.kind==="datetime"),O=x?x.regex:g?g.offset?new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(([+-]\\d{2}:\\d{2})|Z)$"):new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"):void 0;return{type:"string",...l&&{format:"date-time"},...e&&{format:"email"},...r&&{format:"url"},...n&&{format:"uuid"},...s&&{format:"cuid"},...a&&{format:"cuid2"},...p&&{format:"ulid"},...c&&{format:"ip"},...d&&{format:"emoji"},...t!==null&&{minLength:t},...o!==null&&{maxLength:o},...O&&{pattern:`/${O.source}/${O.flags}`}}},Mo=({schema:e})=>{let r=e._def.checks.find(({kind:s})=>s==="min"),t=r?r.inclusive:!0,o=e._def.checks.find(({kind:s})=>s==="max"),n=o?o.inclusive:!0;return{type:e.isInt?"integer":"number",format:e.isInt?"int64":"double",minimum:e.minValue===null?e.isInt?Number.MIN_SAFE_INTEGER:Number.MIN_VALUE:e.minValue,exclusiveMinimum:!t,maximum:e.maxValue===null?e.isInt?Number.MAX_SAFE_INTEGER:Number.MAX_VALUE:e.maxValue,exclusiveMaximum:!n}},Xe=({schema:{shape:e},next:r})=>Object.keys(e).reduce((t,o)=>({...t,[o]:r({schema:e[o]})}),{}),No=e=>{let r=Array.isArray(e.type)?e.type[0]:e.type;return io?.[r]},wo=({schema:e,isResponse:r,next:t})=>{let o=t({schema:e.innerType()}),{effect:n}=e._def;if(r&&n.type==="transform"&&(0,k.isSchemaObject)(o)){let s=ke({effect:n,sample:No(o)});return s&&["number","string","boolean"].includes(s)?{type:s}:t({schema:T.z.any()})}if(!r&&n.type==="preprocess"&&(0,k.isSchemaObject)(o)){let{type:s,...a}=o;return{...a,format:`${a.format||s} (preprocessed)`}}return o},Do=({schema:e,isResponse:r,next:t})=>t({schema:e._def[r?"out":"in"]}),zo=({schema:e,next:r})=>r({schema:e.unwrap()}),vo=({next:e,schema:r,serializer:t,getRef:o,makeRef:n})=>{let s=t(r.schema);return o(s)||(()=>(n(s,{}),n(s,e({schema:r.schema}))))()},xr=(e,r,t=[])=>{let o=je(e,r);return o.length===0?{}:{examples:o.reduce((n,s,a)=>({...n,[`example${a+1}`]:{value:(0,fe.omit)(t,s)}}),{})}},jo=(e,r,t)=>{let o=je(e,r);return o.length===0?{}:{examples:o.reduce((n,s,a)=>t in s?{...n,[`example${a+1}`]:{value:s[t]}}:n,{})}};function Ee(e,r){if(e instanceof T.z.ZodObject)return e;let t;if(e instanceof T.z.ZodUnion||e instanceof T.z.ZodDiscriminatedUnion)t=Array.from(e.options.values()).map(o=>Ee(o,r)).reduce((o,n)=>o.merge(n.partial()),T.z.object({}));else if(e instanceof T.z.ZodEffects){if($(e))throw new I({message:`Using transformations on the top level of ${r.isResponse?"response":"input"} schema is not allowed.`,...r});t=Ee(e._def.schema,r)}else t=Ee(e._def.left,r).merge(Ee(e._def.right,r));return Ne(e,t)}var Tr=({path:e,method:r,endpoint:t,inputSources:o,serializer:n,getRef:s,makeRef:a,composition:p,clue:c="parameter"})=>{let d=t.getSchema("input"),l=Ee(d,{path:e,method:r,isResponse:!1}).shape,f=yt(e),x=o.includes("query"),g=o.includes("params"),O=h=>g&&f.includes(h);return Object.keys(l).filter(h=>x||O(h)).map(h=>{let y=re({schema:l[h],isResponse:!1,rules:Pt,onEach:Zt,onMissing:Et,serializer:n,getRef:s,makeRef:a,path:e,method:r}),C=p==="components"?a(z(e,r,`${c} ${h}`),y):y;return{name:h,in:O(h)?"path":"query",required:!l[h].isOptional(),description:(0,k.isSchemaObject)(y)&&y.description||`${r.toUpperCase()} ${e} ${c}`,schema:C,...jo(d,!1,h)}})},Pt={ZodString:Co,ZodNumber:Mo,ZodBigInt:Zo,ZodBoolean:Po,ZodDateIn:Oo,ZodDateOut:bo,ZodNull:So,ZodArray:Ao,ZodTuple:Io,ZodRecord:Eo,ZodObject:To,ZodLiteral:xo,ZodIntersection:yo,ZodUnion:uo,ZodFile:mo,ZodUpload:lo,ZodAny:co,ZodDefault:ao,ZodEnum:yr,ZodNativeEnum:yr,ZodEffects:wo,ZodOptional:go,ZodNullable:ho,ZodDiscriminatedUnion:fo,ZodBranded:zo,ZodDate:Ro,ZodCatch:po,ZodPipeline:Do,ZodLazy:vo},Zt=({schema:e,isResponse:r,prev:t})=>{if((0,k.isReferenceObject)(t))return{};let{description:o}=e,n=e instanceof T.z.ZodLazy,s=t.type!==void 0,a=r&&be(e),p=!n&&s&&!a&&e.isNullable(),c=n?[]:je(e,r);return{...o&&{description:o},...p&&{nullable:!0},...c.length>0&&{example:c[0]}}},Et=({schema:e,...r})=>{throw new I({message:`Zod type ${e.constructor.name} is unsupported.`,...r})},Rt=(e,r)=>{if((0,k.isReferenceObject)(e))return e;let t=e.properties?(0,fe.omit)(r,e.properties):void 0,o=e.example?(0,fe.omit)(r,e.example):void 0,n=e.required?e.required.filter(p=>!r.includes(p)):void 0,s=e.allOf?e.allOf.map(p=>Rt(p,r)):void 0,a=e.oneOf?e.oneOf.map(p=>Rt(p,r)):void 0;return(0,fe.omit)(Object.entries({properties:t,required:n,example:o,allOf:s,oneOf:a}).filter(([{},p])=>p===void 0).map(([p])=>p),{...e,properties:t,required:n,example:o,allOf:s,oneOf:a})},Sr=e=>(0,k.isSchemaObject)(e)?(0,fe.omit)(["example"],e):e,At=({method:e,path:r,endpoint:t,isPositive:o,serializer:n,getRef:s,makeRef:a,composition:p,clue:c="response"})=>{let d=t.getSchema(o?"positive":"negative"),l=t.getMimeTypes(o?"positive":"negative"),f=Sr(re({schema:d,isResponse:!0,rules:Pt,onEach:Zt,onMissing:Et,serializer:n,getRef:s,makeRef:a,path:r,method:e})),x=xr(d,!0),g=p==="components"?a(z(r,e,c),f):f;return{description:`${e.toUpperCase()} ${r} ${c}`,content:l.reduce((O,h)=>({...O,[h]:{schema:g,...x}}),{})}},Lo=()=>({type:"http",scheme:"basic"}),ko=({format:e})=>({type:"http",scheme:"bearer",...e&&{bearerFormat:e}}),Uo=({name:e})=>({type:"apiKey",in:"query",name:e}),Ho=({name:e})=>({type:"apiKey",in:"header",name:e}),Ko=({name:e})=>({type:"apiKey",in:"cookie",name:e}),Fo=({url:e})=>({type:"openIdConnect",openIdConnectUrl:e}),$o=({flows:e={}})=>({type:"oauth2",flows:Object.keys(e).reduce((r,t)=>{let o=e[t];if(!o)return r;let{scopes:n={},...s}=o;return{...r,[t]:{...s,scopes:n}}},{})}),Or=e=>{let r={basic:Lo,bearer:ko,input:Uo,header:Ho,cookie:Ko,openid:Fo,oauth2:$o};return He(e,t=>r[t.type](t))},et=e=>{if(typeof e=="object"){if("or"in e)return e.or.map(r=>("and"in r?r.and:[r]).reduce((t,{name:o,scopes:n})=>({...t,[o]:n}),{}));if("and"in e)return et(ht(e))}return et({or:[e]})},br=({method:e,path:r,endpoint:t,serializer:o,getRef:n,makeRef:s,composition:a,clue:p="request body"})=>{let c=yt(r),d=Sr(Rt(re({schema:t.getSchema("input"),isResponse:!1,rules:Pt,onEach:Zt,onMissing:Et,serializer:o,getRef:n,makeRef:s,path:r,method:e}),c)),l=xr(t.getSchema("input"),!1,c),f=a==="components"?s(z(r,e,p),d):d;return{description:`${e.toUpperCase()} ${r} ${p}`,content:t.getMimeTypes("input").reduce((x,g)=>({...x,[g]:{schema:f,...l}}),{})}},Rr=e=>Object.keys(e).map(r=>{let t=e[r];return{name:r,description:typeof t=="string"?t:t.description,...typeof t=="object"&&t.url&&{externalDocs:{url:t.url}}}}),It=e=>e.length<=fr?e:e.slice(0,fr-1)+"\u2026";var tt=class extends Pr.OpenApiBuilder{constructor({routing:t,config:o,title:n,version:s,serverUrl:a,successfulResponseDescription:p="Successful response",errorResponseDescription:c="Error response",hasSummaryFromDescription:d=!0,composition:l="inline",serializer:f=Le}){super();this.lastSecuritySchemaIds={};this.lastOperationIdSuffixes={};this.addInfo({title:n,version:s}).addServer({url:a}),te({routing:t,onEndpoint:(g,O,h)=>{let y=h,C={path:O,method:y,endpoint:g,composition:l,serializer:f,getRef:this.getRef.bind(this),makeRef:this.makeRef.bind(this)},[K,oe]=["short","long"].map(g.getDescription.bind(g)),he=o.inputSources?.[y]||De[y],xe=Tr({...C,inputSources:he}),M={operationId:this.ensureUniqOperationId(O,y),responses:{[g.getStatusCode("positive")]:At({...C,clue:p,isPositive:!0}),[g.getStatusCode("negative")]:At({...C,clue:c,isPositive:!1})}};oe&&(M.description=oe,d&&K===void 0&&(M.summary=It(oe))),K&&(M.summary=It(K)),g.getTags().length>0&&(M.tags=g.getTags()),xe.length>0&&(M.parameters=xe),he.includes("body")&&(M.requestBody=br(C));let Ae=et(He(Or(g.getSecurity()),lt=>{let Ht=this.ensureUniqSecuritySchemaName(lt),Kr=["oauth2","openIdConnect"].includes(lt.type)?g.getScopes():[];return this.addSecurityScheme(Ht,lt),{name:Ht,scopes:Kr}}));Ae.length>0&&(M.security=Ae);let Hr=hr(O);this.addPath(Hr,{[y]:M})}}),this.rootDoc.tags=o.tags?Rr(o.tags):[]}makeRef(t,o){return this.addSchema(t,o),this.getRef(t)}getRef(t){return t in(this.rootDoc.components?.schemas||{})?{$ref:`#/components/schemas/${t}`}:void 0}ensureUniqOperationId(t,o){let n=z(t,o);return n in this.lastOperationIdSuffixes?(this.lastOperationIdSuffixes[n]++,`${n}${this.lastOperationIdSuffixes[n]}`):(this.lastOperationIdSuffixes[n]=1,n)}ensureUniqSecuritySchemaName(t){let o=JSON.stringify(t);for(let n in this.rootDoc.components?.securitySchemes||{})if(o===JSON.stringify(this.rootDoc.components?.securitySchemes?.[n]))return n;return this.lastSecuritySchemaIds[t.type]=(this.lastSecuritySchemaIds?.[t.type]||0)+1,`${t.type.toUpperCase()}_${this.lastSecuritySchemaIds[t.type]}`}};var Ct=R(require("http"));var _o=e=>({method:"GET",header:jest.fn(()=>Y),...e}),Go=e=>{let r={writableEnded:!1,statusCode:200,statusMessage:Ct.default.STATUS_CODES[200],set:jest.fn(()=>r),status:jest.fn(t=>(r.statusCode=t,r.statusMessage=Ct.default.STATUS_CODES[t],r)),json:jest.fn(()=>r),end:jest.fn(()=>(r.writableEnded=!0,r)),...e};return r},Zr=async({endpoint:e,requestProps:r,responseProps:t,configProps:o,loggerProps:n,__noJest:s})=>{if(!jest||s)throw new Error("You need to install Jest in order to use testEndpoint().");let a=_o(r),p=Go(t),c={info:jest.fn(),warn:jest.fn(),error:jest.fn(),debug:jest.fn(),...n},d={cors:!1,logger:c,...o};return await e.execute({request:a,response:p,config:d,logger:c}),{requestMock:a,responseMock:p,loggerMock:c}};var H=R(require("typescript"));var D=R(require("typescript")),i=D.default.factory,ye=[i.createModifier(D.default.SyntaxKind.ExportKeyword)],qo=[i.createModifier(D.default.SyntaxKind.AsyncKeyword)],Vo=[i.createModifier(D.default.SyntaxKind.PublicKeyword),i.createModifier(D.default.SyntaxKind.ReadonlyKeyword)],Er=[i.createModifier(D.default.SyntaxKind.ProtectedKeyword),i.createModifier(D.default.SyntaxKind.ReadonlyKeyword)],Bo=i.createTemplateHead(""),Yo=i.createTemplateTail(""),Jo=i.createTemplateMiddle(" "),Mt=e=>i.createTemplateLiteralType(Bo,e.map((r,t)=>i.createTemplateLiteralTypeSpan(i.createTypeReferenceNode(r),t===e.length-1?Yo:Jo))),Nt=Mt(["M","P"]),rt=(e,r,t)=>i.createParameterDeclaration(t,void 0,e,void 0,r),ot=(e,r)=>Object.keys(e).reduce((t,o)=>t.concat(rt(o,e[o],r)),[]),wt=(e,r)=>i.createExpressionWithTypeArguments(i.createIdentifier("Record"),[typeof e=="number"?i.createKeywordTypeNode(e):i.createTypeReferenceNode(e),i.createKeywordTypeNode(r)]),Ar=e=>i.createConstructorDeclaration(void 0,e,i.createBlock([])),Dt=(e,r)=>i.createPropertySignature(void 0,`"${e}"`,void 0,i.createTypeReferenceNode(r)),Ir=(e,r)=>i.createVariableDeclarationList([i.createVariableDeclaration(e,void 0,void 0,r)],D.default.NodeFlags.Const),zt=(e,r)=>i.createTypeAliasDeclaration(ye,e,void 0,i.createUnionTypeNode(r.map(t=>i.createLiteralTypeNode(i.createStringLiteral(t))))),nt=(e,r)=>i.createTypeAliasDeclaration(ye,e,void 0,r),Cr=(e,r,t)=>i.createPropertyDeclaration(Vo,e,void 0,r,t),Mr=(e,r,t=[])=>i.createClassDeclaration(ye,e,void 0,void 0,[r,...t]),Nr=(e,r)=>i.createTypeReferenceNode("Promise",[i.createIndexedAccessTypeNode(i.createTypeReferenceNode(e),r)]),wr=()=>i.createTypeReferenceNode("Promise",[i.createKeywordTypeNode(D.default.SyntaxKind.AnyKeyword)]),vt=(e,r,t)=>i.createInterfaceDeclaration(ye,e,void 0,r,t),Dr=e=>Object.keys(e).reduce((r,t)=>r.concat(i.createTypeParameterDeclaration([],t,i.createTypeReferenceNode(e[t]))),[]),zr=(e,r)=>i.createArrowFunction(qo,void 0,e.map(t=>rt(t)),void 0,void 0,i.createCallExpression(i.createPropertyAccessExpression(i.createThis(),"implementation"),void 0,r)),jt=(e,r,t)=>i.createCallExpression(i.createPropertyAccessExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("Object"),"keys"),void 0,[i.createIdentifier(e)]),"reduce"),void 0,[i.createArrowFunction(void 0,void 0,ot({acc:void 0,key:void 0}),void 0,void 0,r),t]);var u=R(require("typescript")),kr=require("zod");var U=R(require("typescript")),{factory:st}=U.default,Lt=(e,r)=>{U.default.addSyntheticLeadingComment(e,U.default.SyntaxKind.MultiLineCommentTrivia,`* ${r} `,!0)},it=(e,r,t)=>{let o=st.createTypeAliasDeclaration(void 0,st.createIdentifier(r),void 0,e);return t&&Lt(o,t),o},vr=(e,r)=>{let t=U.default.createSourceFile("print.ts","",U.default.ScriptTarget.Latest,!1,U.default.ScriptKind.TS);return U.default.createPrinter(r).printNode(U.default.EmitHint.Unspecified,e,t)},Qo=/^[A-Za-z_$][A-Za-z0-9_$]*$/,jr=e=>Qo.test(e)?st.createIdentifier(e):st.createStringLiteral(e);var{factory:m}=u.default,Wo={[u.default.SyntaxKind.AnyKeyword]:"",[u.default.SyntaxKind.BigIntKeyword]:BigInt(0),[u.default.SyntaxKind.BooleanKeyword]:!1,[u.default.SyntaxKind.NumberKeyword]:0,[u.default.SyntaxKind.ObjectKeyword]:{},[u.default.SyntaxKind.StringKeyword]:"",[u.default.SyntaxKind.UndefinedKeyword]:void 0},Xo=({schema:{value:e}})=>m.createLiteralTypeNode(typeof e=="number"?m.createNumericLiteral(e):typeof e=="boolean"?e?m.createTrue():m.createFalse():m.createStringLiteral(e)),en=({schema:{shape:e},isResponse:r,next:t,optionalPropStyle:{withQuestionMark:o}})=>{let n=Object.entries(e).map(([s,a])=>{let p=r&&be(a)?a instanceof kr.z.ZodOptional:a.isOptional(),c=m.createPropertySignature(void 0,jr(s),p&&o?m.createToken(u.default.SyntaxKind.QuestionToken):void 0,t({schema:a}));return a.description&&Lt(c,a.description),c});return m.createTypeLiteralNode(n)},tn=({schema:{element:e},next:r})=>m.createArrayTypeNode(r({schema:e})),rn=({schema:{options:e}})=>m.createUnionTypeNode(e.map(r=>m.createLiteralTypeNode(m.createStringLiteral(r)))),Lr=({schema:{options:e},next:r})=>m.createUnionTypeNode(e.map(t=>r({schema:t}))),on=e=>Wo?.[e.kind],nn=({schema:e,next:r,isResponse:t})=>{let o=r({schema:e.innerType()}),n=e._def.effect;if(t&&n.type==="transform"){let s=ke({effect:n,sample:on(o)}),a={number:u.default.SyntaxKind.NumberKeyword,bigint:u.default.SyntaxKind.BigIntKeyword,boolean:u.default.SyntaxKind.BooleanKeyword,string:u.default.SyntaxKind.StringKeyword,undefined:u.default.SyntaxKind.UndefinedKeyword,object:u.default.SyntaxKind.ObjectKeyword};return m.createKeywordTypeNode(s&&a[s]||u.default.SyntaxKind.AnyKeyword)}return o},sn=({schema:e})=>m.createUnionTypeNode(Object.values(e.enum).map(r=>m.createLiteralTypeNode(typeof r=="number"?m.createNumericLiteral(r):m.createStringLiteral(r)))),an=({next:e,schema:r,optionalPropStyle:{withUndefined:t}})=>{let o=e({schema:r.unwrap()});return t?m.createUnionTypeNode([o,m.createKeywordTypeNode(u.default.SyntaxKind.UndefinedKeyword)]):o},pn=({next:e,schema:r})=>m.createUnionTypeNode([e({schema:r.unwrap()}),m.createLiteralTypeNode(m.createNull())]),dn=({next:e,schema:{items:r}})=>m.createTupleTypeNode(r.map(t=>e({schema:t}))),cn=({next:e,schema:{keySchema:r,valueSchema:t}})=>m.createExpressionWithTypeArguments(m.createIdentifier("Record"),[e({schema:r}),e({schema:t})]),ln=({next:e,schema:r})=>m.createIntersectionTypeNode([r._def.left,r._def.right].map(t=>e({schema:t}))),mn=({next:e,schema:r})=>e({schema:r._def.innerType}),V=e=>()=>m.createKeywordTypeNode(e),un=({next:e,schema:r})=>e({schema:r.unwrap()}),fn=({next:e,schema:r})=>e({schema:r._def.innerType}),yn=({schema:e,next:r,isResponse:t})=>r({schema:e._def[t?"out":"in"]}),gn=()=>m.createLiteralTypeNode(m.createNull()),hn=({getAlias:e,makeAlias:r,next:t,serializer:o,schema:n})=>{let s=`Type${o(n.schema)}`;return e(s)||(()=>(r(s,m.createLiteralTypeNode(m.createNull())),r(s,t({schema:n.schema}))))()},xn={ZodString:V(u.default.SyntaxKind.StringKeyword),ZodNumber:V(u.default.SyntaxKind.NumberKeyword),ZodBigInt:V(u.default.SyntaxKind.BigIntKeyword),ZodBoolean:V(u.default.SyntaxKind.BooleanKeyword),ZodDateIn:V(u.default.SyntaxKind.StringKeyword),ZodDateOut:V(u.default.SyntaxKind.StringKeyword),ZodNull:gn,ZodArray:tn,ZodTuple:dn,ZodRecord:cn,ZodObject:en,ZodLiteral:Xo,ZodIntersection:ln,ZodUnion:Lr,ZodFile:V(u.default.SyntaxKind.StringKeyword),ZodAny:V(u.default.SyntaxKind.AnyKeyword),ZodDefault:mn,ZodEnum:rn,ZodNativeEnum:sn,ZodEffects:nn,ZodOptional:an,ZodNullable:pn,ZodDiscriminatedUnion:Lr,ZodBranded:un,ZodCatch:fn,ZodPipeline:yn,ZodLazy:hn},kt=({schema:e,...r})=>re({schema:e,rules:xn,onMissing:()=>m.createKeywordTypeNode(u.default.SyntaxKind.AnyKeyword),...r});var at=class{constructor({routing:r,variant:t="client",serializer:o=Le,optionalPropStyle:n={withQuestionMark:!0,withUndefined:!0}}){this.agg=[];this.registry={};this.paths=[];this.aliases={};te({routing:r,onEndpoint:(y,C,K)=>{let oe=z(C,K,"input"),he=z(C,K,"response"),xe={serializer:o,getAlias:this.getAlias.bind(this),makeAlias:this.makeAlias.bind(this),optionalPropStyle:n},M=kt({...xe,schema:y.getSchema("input"),isResponse:!1}),Ae=kt({...xe,isResponse:!0,schema:y.getSchema("positive").or(y.getSchema("negative"))});this.agg.push(it(M,oe),it(Ae,he)),K!=="options"&&(this.paths.push(C),this.registry[`${K} ${C}`]={in:oe,out:he,isJson:y.getMimeTypes("positive").includes(Y)})}}),this.agg=Object.values(this.aliases).concat(this.agg);let s=zt("Path",this.paths),a=zt("Method",rr),p=nt("MethodPath",Mt([a.name,s.name])),c=[i.createHeritageClause(H.default.SyntaxKind.ExtendsKeyword,[wt(p.name,H.default.SyntaxKind.AnyKeyword)])],d=vt("Input",c,Object.keys(this.registry).map(y=>Dt(y,this.registry[y].in))),l=vt("Response",c,Object.keys(this.registry).map(y=>Dt(y,this.registry[y].out)));if(this.agg.push(s,a,p,d,l),t==="types")return;let f=i.createVariableStatement(ye,Ir("jsonEndpoints",i.createObjectLiteralExpression(Object.keys(this.registry).filter(y=>this.registry[y].isJson).map(y=>i.createPropertyAssignment(`"${y}"`,i.createTrue()))))),x=nt("Provider",i.createFunctionTypeNode(Dr({M:a.name,P:s.name}),ot({method:i.createTypeReferenceNode("M"),path:i.createTypeReferenceNode("P"),params:i.createIndexedAccessTypeNode(i.createTypeReferenceNode(d.name),Nt)}),Nr(l.name,Nt))),g=nt("Implementation",i.createFunctionTypeNode(void 0,ot({method:i.createTypeReferenceNode(a.name),path:i.createKeywordTypeNode(H.default.SyntaxKind.StringKeyword),params:wt(H.default.SyntaxKind.StringKeyword,H.default.SyntaxKind.AnyKeyword)}),wr())),O=i.createTemplateExpression(i.createTemplateHead(":"),[i.createTemplateSpan(i.createIdentifier("key"),i.createTemplateTail(""))]),h=Mr("ExpressZodAPIClient",Ar([rt("implementation",i.createTypeReferenceNode(g.name),Er)]),[Cr("provide",i.createTypeReferenceNode(x.name),zr(["method","path","params"],[i.createIdentifier("method"),jt("params",i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("acc"),"replace"),void 0,[O,i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key"))]),i.createIdentifier("path")),jt("params",i.createConditionalExpression(i.createBinaryExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("path"),"indexOf"),void 0,[O]),H.default.SyntaxKind.GreaterThanEqualsToken,i.createNumericLiteral(0)),void 0,i.createIdentifier("acc"),void 0,i.createObjectLiteralExpression([i.createSpreadAssignment(i.createIdentifier("acc")),i.createPropertyAssignment("[key]",i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key")))])),i.createObjectLiteralExpression())]))]);H.default.addSyntheticLeadingComment(h,H.default.SyntaxKind.MultiLineCommentTrivia,`
|
|
34
|
+
`.trim();var Tt=({app:e,logger:t,config:r,routing:o})=>{r.startupLogo!==!1&&console.log(ar()),re({routing:o,hasCors:!!r.cors,onEndpoint:(n,s,a)=>{e[a](s,async(d,c)=>{t.info(`${d.method}: ${s}`),await n.execute({request:d,response:c,logger:t,config:r})})},onStatic:(n,s)=>{e.use(n,s)}})};var Ye=R(require("express")),dr=R(require("compression")),pr=R(require("express-fileupload")),cr=R(require("https"));var St=R(require("http-errors")),no=(e,t)=>(r,o,n,s)=>{if(!r)return s();e.handler({error:(0,St.default)(400,ie(r).message),request:o,response:n,logger:t,input:o.body,output:null})},lr=(e,t)=>(r,o)=>{let n=(0,St.default)(404,`Can not ${r.method} ${r.path}`);try{e.handler({request:r,response:o,logger:t,error:n,input:null,output:null})}catch(s){He({response:o,logger:t,error:new de(ie(s).message,n)})}};function mr(e,t){let r=ut(e.logger)?Ee(e.logger):e.logger;Tt({app:e.app,routing:t,logger:r,config:e});let o=e.errorHandler||X;return{notFoundHandler:lr(o,r),logger:r}}function ur(e,t){let r=ut(e.logger)?Ee(e.logger):e.logger,o=(0,Ye.default)();o.disable("x-powered-by");let n=e.errorHandler||X,s=e.server.compression?(0,dr.default)({...typeof e.server.compression=="object"?e.server.compression:{}}):void 0,a=e.server.jsonParser||(0,Ye.json)(),d=e.server.upload?(0,pr.default)({...typeof e.server.upload=="object"?e.server.upload:{},abortOnLimit:!1,parseNested:!0}):void 0,c=[].concat(s||[]).concat(a).concat(d||[]);o.use(c),o.use(no(n,r)),Tt({app:o,routing:t,logger:r,config:e}),o.use(lr(n,r));let p=o.listen(e.server.listen,()=>{r.info(`Listening ${e.server.listen}`)}),l;return e.https&&(l=cr.default.createServer(e.https.options,o).listen(e.https.listen,()=>{r.info(`Listening ${e.https.listen}`)})),{app:o,httpServer:p,httpsServer:l,logger:r}}var Pr=require("openapi3-ts/oas30");var k=require("openapi3-ts/oas30"),ye=require("ramda"),T=require("zod");var S=require("zod");var Ot=/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?)?Z?$/,so="ZodDateIn",Qe=class Qe extends S.ZodType{_parse(t){let{status:r,ctx:o}=this._processInputParams(t);if(o.parsedType!==S.ZodParsedType.string)return(0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_type,expected:S.ZodParsedType.string,received:o.parsedType}),S.INVALID;Ot.test(o.data)||((0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_string,validation:"regex"}),r.dirty());let n=new Date(o.data);return ze(n)?{status:r.value,value:n}:((0,S.addIssueToContext)(o,{code:S.ZodIssueCode.invalid_date}),S.INVALID)}};Qe.create=()=>new Qe({typeName:so});var Je=Qe;var oe=({schema:e,onEach:t,rules:r,onMissing:o,...n})=>{let s="typeName"in e._def?r[e._def.typeName]:void 0,d=s?s({schema:e,...n,next:p=>oe({...p,...n,onEach:t,rules:r,onMissing:o})}):o({schema:e,...n}),c=t&&t({schema:e,prev:d,...n});return c?{...d,...c}:d};var fr=50,gr="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString",io={integer:0,number:0,string:"",boolean:!1,object:{},null:null,array:[]},hr=e=>e.replace(lt,t=>`{${t.slice(1)}}`),ao=({schema:{_def:{innerType:e,defaultValue:t}},next:r})=>({...r({schema:e}),default:t()}),po=({schema:{_def:{innerType:e}},next:t})=>t({schema:e}),co=()=>({format:"any"}),lo=e=>{if(e.isResponse)throw new I({message:"Please use z.upload() only for input.",...e});return{type:"string",format:"binary"}},mo=({schema:{isBinary:e,isBase64:t},...r})=>{if(!r.isResponse)throw new I({message:"Please use z.file() only within ResultHandler.",...r});return{type:"string",format:e?"binary":t?"byte":"file"}},uo=({schema:{options:e},next:t})=>({oneOf:e.map(r=>t({schema:r}))}),fo=({schema:{options:e,discriminator:t},next:r})=>({discriminator:{propertyName:t},oneOf:Array.from(e.values()).map(o=>r({schema:o}))}),yo=({schema:{_def:{left:e,right:t}},next:r})=>({allOf:[e,t].map(o=>r({schema:o}))}),go=({schema:e,next:t})=>t({schema:e.unwrap()}),ho=({schema:e,next:t})=>t({schema:e._def.innerType}),xo=({schema:e,next:t})=>({nullable:!0,...t({schema:e.unwrap()})}),yr=({schema:e})=>({type:typeof Object.values(e.enum)[0],enum:Object.values(e.enum)}),To=({schema:{value:e}})=>({type:typeof e,enum:[e]}),So=({schema:e,isResponse:t,...r})=>{let o=Object.keys(e.shape).filter(n=>{let s=e.shape[n];return!(t&&Re(s)?s instanceof T.z.ZodOptional:s.isOptional())});return{type:"object",properties:We({schema:e,isResponse:t,...r}),...o.length?{required:o}:{}}},Oo=()=>({type:"string",nullable:!0,format:"null"}),bo=e=>{if(e.isResponse)throw new I({message:"Please use z.dateOut() for output.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",pattern:Ot.source,externalDocs:{url:gr}}},Ro=e=>{if(!e.isResponse)throw new I({message:"Please use z.dateIn() for input.",...e});return{description:"YYYY-MM-DDTHH:mm:ss.sssZ",type:"string",format:"date-time",externalDocs:{url:gr}}},Po=e=>{throw new I({message:`Using z.date() within ${e.isResponse?"output":"input"} schema is forbidden. Please use z.date${e.isResponse?"Out":"In"}() instead. Check out the documentation for details.`,...e})},Zo=()=>({type:"boolean"}),Eo=()=>({type:"integer",format:"bigint"}),Ao=({schema:{keySchema:e,valueSchema:t},...r})=>{if(e instanceof T.z.ZodEnum||e instanceof T.z.ZodNativeEnum){let o=Object.values(e.enum),n=o.reduce((s,a)=>({...s,[a]:t}),{});return{type:"object",properties:We({schema:T.z.object(n),...r}),...o.length?{required:o}:{}}}if(e instanceof T.z.ZodLiteral)return{type:"object",properties:We({schema:T.z.object({[e.value]:t}),...r}),required:[e.value]};if(e instanceof T.z.ZodUnion&&e.options.reduce((n,s)=>n&&s instanceof T.z.ZodLiteral,!0)){let n=e.options.reduce((s,a)=>({...s,[a.value]:t}),{});return{type:"object",properties:We({schema:T.z.object(n),...r}),required:e.options.map(s=>s.value)}}return{type:"object",additionalProperties:r.next({schema:t})}},Io=({schema:{_def:e,element:t},next:r})=>({type:"array",items:r({schema:t}),...e.minLength!==null&&{minItems:e.minLength.value},...e.maxLength!==null&&{maxItems:e.maxLength.value}}),Co=({schema:{items:e},next:t})=>{let r=e.map(o=>t({schema:o}));return{type:"array",minItems:r.length,maxItems:r.length,items:{oneOf:r,format:"tuple",...r.length>0&&{description:r.map((o,n)=>`${n}: ${(0,k.isSchemaObject)(o)?o.type:o.$ref}`).join(", ")}}}},Mo=({schema:{isEmail:e,isURL:t,minLength:r,maxLength:o,isUUID:n,isCUID:s,isCUID2:a,isULID:d,isIP:c,isEmoji:p,isDatetime:l,_def:{checks:f}}})=>{let x=f.find(h=>h.kind==="regex"),g=f.find(h=>h.kind==="datetime"),O=x?x.regex:g?g.offset?new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(([+-]\\d{2}:\\d{2})|Z)$"):new RegExp("^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"):void 0;return{type:"string",...l&&{format:"date-time"},...e&&{format:"email"},...t&&{format:"url"},...n&&{format:"uuid"},...s&&{format:"cuid"},...a&&{format:"cuid2"},...d&&{format:"ulid"},...c&&{format:"ip"},...p&&{format:"emoji"},...r!==null&&{minLength:r},...o!==null&&{maxLength:o},...O&&{pattern:`/${O.source}/${O.flags}`}}},No=({schema:e})=>{let t=e._def.checks.find(({kind:s})=>s==="min"),r=t?t.inclusive:!0,o=e._def.checks.find(({kind:s})=>s==="max"),n=o?o.inclusive:!0;return{type:e.isInt?"integer":"number",format:e.isInt?"int64":"double",minimum:e.minValue===null?e.isInt?Number.MIN_SAFE_INTEGER:Number.MIN_VALUE:e.minValue,exclusiveMinimum:!r,maximum:e.maxValue===null?e.isInt?Number.MAX_SAFE_INTEGER:Number.MAX_VALUE:e.maxValue,exclusiveMaximum:!n}},We=({schema:{shape:e},next:t})=>Object.keys(e).reduce((r,o)=>({...r,[o]:t({schema:e[o]})}),{}),wo=e=>{let t=Array.isArray(e.type)?e.type[0]:e.type;return io?.[t]},Do=({schema:e,isResponse:t,next:r})=>{let o=r({schema:e.innerType()}),{effect:n}=e._def;if(t&&n.type==="transform"&&(0,k.isSchemaObject)(o)){let s=Le({effect:n,sample:wo(o)});return s&&["number","string","boolean"].includes(s)?{type:s}:r({schema:T.z.any()})}if(!t&&n.type==="preprocess"&&(0,k.isSchemaObject)(o)){let{type:s,...a}=o;return{...a,format:`${a.format||s} (preprocessed)`}}return o},zo=({schema:e,isResponse:t,next:r})=>r({schema:e._def[t?"out":"in"]}),vo=({schema:e,next:t})=>t({schema:e.unwrap()}),jo=({next:e,schema:t,serializer:r,getRef:o,makeRef:n})=>{let s=r(t.schema);return o(s)||(()=>(n(s,{}),n(s,e({schema:t.schema}))))()},xr=(e,t,r=[])=>{let o=G({schema:e,variant:t?"parsed":"original",validate:!0});return o.length===0?{}:{examples:o.reduce((n,s,a)=>({...n,[`example${a+1}`]:{value:(0,ye.omit)(r,s)}}),{})}},Lo=(e,t,r)=>{let o=G({schema:e,variant:t?"parsed":"original",validate:!0});return o.length===0?{}:{examples:o.reduce((n,s,a)=>r in s?{...n,[`example${a+1}`]:{value:s[r]}}:n,{})}};function Ae(e,t){if(e instanceof T.z.ZodObject)return e;let r;if(e instanceof T.z.ZodUnion||e instanceof T.z.ZodDiscriminatedUnion)r=Array.from(e.options.values()).map(o=>Ae(o,t)).reduce((o,n)=>o.merge(n.partial()),T.z.object({}));else if(e instanceof T.z.ZodEffects){if($(e))throw new I({message:`Using transformations on the top level of ${t.isResponse?"response":"input"} schema is not allowed.`,...t});r=Ae(e._def.schema,t)}else r=Ae(e._def.left,t).merge(Ae(e._def.right,t));return Ne(e,r)}var Tr=({path:e,method:t,endpoint:r,inputSources:o,serializer:n,getRef:s,makeRef:a,composition:d,clue:c="parameter"})=>{let p=r.getSchema("input"),l=Ae(p,{path:e,method:t,isResponse:!1}).shape,f=ft(e),x=o.includes("query"),g=o.includes("params"),O=h=>g&&f.includes(h);return Object.keys(l).filter(h=>x||O(h)).map(h=>{let y=oe({schema:l[h],isResponse:!1,rules:Rt,onEach:Pt,onMissing:Zt,serializer:n,getRef:s,makeRef:a,path:e,method:t}),C=d==="components"?a(z(e,t,`${c} ${h}`),y):y;return{name:h,in:O(h)?"path":"query",required:!l[h].isOptional(),description:(0,k.isSchemaObject)(y)&&y.description||`${t.toUpperCase()} ${e} ${c}`,schema:C,...Lo(p,!1,h)}})},Rt={ZodString:Mo,ZodNumber:No,ZodBigInt:Eo,ZodBoolean:Zo,ZodDateIn:bo,ZodDateOut:Ro,ZodNull:Oo,ZodArray:Io,ZodTuple:Co,ZodRecord:Ao,ZodObject:So,ZodLiteral:To,ZodIntersection:yo,ZodUnion:uo,ZodFile:mo,ZodUpload:lo,ZodAny:co,ZodDefault:ao,ZodEnum:yr,ZodNativeEnum:yr,ZodEffects:Do,ZodOptional:go,ZodNullable:xo,ZodDiscriminatedUnion:fo,ZodBranded:vo,ZodDate:Po,ZodCatch:po,ZodPipeline:zo,ZodLazy:jo,ZodReadonly:ho},Pt=({schema:e,isResponse:t,prev:r})=>{if((0,k.isReferenceObject)(r))return{};let{description:o}=e,n=e instanceof T.z.ZodLazy,s=r.type!==void 0,a=t&&Re(e),d=!n&&s&&!a&&e.isNullable(),c=n?[]:G({schema:e,variant:t?"parsed":"original",validate:!0});return{...o&&{description:o},...d&&{nullable:!0},...c.length>0&&{example:c[0]}}},Zt=({schema:e,...t})=>{throw new I({message:`Zod type ${e.constructor.name} is unsupported.`,...t})},bt=(e,t)=>{if((0,k.isReferenceObject)(e))return e;let r=e.properties?(0,ye.omit)(t,e.properties):void 0,o=e.example?(0,ye.omit)(t,e.example):void 0,n=e.required?e.required.filter(d=>!t.includes(d)):void 0,s=e.allOf?e.allOf.map(d=>bt(d,t)):void 0,a=e.oneOf?e.oneOf.map(d=>bt(d,t)):void 0;return(0,ye.omit)(Object.entries({properties:r,required:n,example:o,allOf:s,oneOf:a}).filter(([{},d])=>d===void 0).map(([d])=>d),{...e,properties:r,required:n,example:o,allOf:s,oneOf:a})},Sr=e=>(0,k.isSchemaObject)(e)?(0,ye.omit)(["example"],e):e,Et=({method:e,path:t,endpoint:r,isPositive:o,serializer:n,getRef:s,makeRef:a,composition:d,clue:c="response"})=>{let p=r.getSchema(o?"positive":"negative"),l=r.getMimeTypes(o?"positive":"negative"),f=Sr(oe({schema:p,isResponse:!0,rules:Rt,onEach:Pt,onMissing:Zt,serializer:n,getRef:s,makeRef:a,path:t,method:e})),x=xr(p,!0),g=d==="components"?a(z(t,e,c),f):f;return{description:`${e.toUpperCase()} ${t} ${c}`,content:l.reduce((O,h)=>({...O,[h]:{schema:g,...x}}),{})}},ko=()=>({type:"http",scheme:"basic"}),Uo=({format:e})=>({type:"http",scheme:"bearer",...e&&{bearerFormat:e}}),Ho=({name:e})=>({type:"apiKey",in:"query",name:e}),Ko=({name:e})=>({type:"apiKey",in:"header",name:e}),Fo=({name:e})=>({type:"apiKey",in:"cookie",name:e}),$o=({url:e})=>({type:"openIdConnect",openIdConnectUrl:e}),_o=({flows:e={}})=>({type:"oauth2",flows:Object.keys(e).reduce((t,r)=>{let o=e[r];if(!o)return t;let{scopes:n={},...s}=o;return{...t,[r]:{...s,scopes:n}}},{})}),Or=e=>{let t={basic:ko,bearer:Uo,input:Ho,header:Ko,cookie:Fo,openid:$o,oauth2:_o};return Ue(e,r=>t[r.type](r))},Xe=e=>{if(typeof e=="object"){if("or"in e)return e.or.map(t=>("and"in t?t.and:[t]).reduce((r,{name:o,scopes:n})=>({...r,[o]:n}),{}));if("and"in e)return Xe(gt(e))}return Xe({or:[e]})},br=({method:e,path:t,endpoint:r,serializer:o,getRef:n,makeRef:s,composition:a,clue:d="request body"})=>{let c=ft(t),p=Sr(bt(oe({schema:r.getSchema("input"),isResponse:!1,rules:Rt,onEach:Pt,onMissing:Zt,serializer:o,getRef:n,makeRef:s,path:t,method:e}),c)),l=xr(r.getSchema("input"),!1,c),f=a==="components"?s(z(t,e,d),p):p;return{description:`${e.toUpperCase()} ${t} ${d}`,content:r.getMimeTypes("input").reduce((x,g)=>({...x,[g]:{schema:f,...l}}),{})}},Rr=e=>Object.keys(e).map(t=>{let r=e[t];return{name:t,description:typeof r=="string"?r:r.description,...typeof r=="object"&&r.url&&{externalDocs:{url:r.url}}}}),At=e=>e.length<=fr?e:e.slice(0,fr-1)+"\u2026";var et=class extends Pr.OpenApiBuilder{constructor({routing:r,config:o,title:n,version:s,serverUrl:a,successfulResponseDescription:d="Successful response",errorResponseDescription:c="Error response",hasSummaryFromDescription:p=!0,composition:l="inline",serializer:f=je}){super();this.lastSecuritySchemaIds={};this.lastOperationIdSuffixes={};this.addInfo({title:n,version:s}).addServer({url:a}),re({routing:r,onEndpoint:(g,O,h)=>{let y=h,C={path:O,method:y,endpoint:g,composition:l,serializer:f,getRef:this.getRef.bind(this),makeRef:this.makeRef.bind(this)},[K,ne]=["short","long"].map(g.getDescription.bind(g)),xe=o.inputSources?.[y]||De[y],Te=Tr({...C,inputSources:xe}),M={operationId:this.ensureUniqOperationId(O,y),responses:{[g.getStatusCode("positive")]:Et({...C,clue:d,isPositive:!0}),[g.getStatusCode("negative")]:Et({...C,clue:c,isPositive:!1})}};ne&&(M.description=ne,p&&K===void 0&&(M.summary=At(ne))),K&&(M.summary=At(K)),g.getTags().length>0&&(M.tags=g.getTags()),Te.length>0&&(M.parameters=Te),xe.includes("body")&&(M.requestBody=br(C));let Ie=Xe(Ue(Or(g.getSecurity()),ct=>{let Ut=this.ensureUniqSecuritySchemaName(ct),Kr=["oauth2","openIdConnect"].includes(ct.type)?g.getScopes():[];return this.addSecurityScheme(Ut,ct),{name:Ut,scopes:Kr}}));Ie.length>0&&(M.security=Ie);let Hr=hr(O);this.addPath(Hr,{[y]:M})}}),this.rootDoc.tags=o.tags?Rr(o.tags):[]}makeRef(r,o){return this.addSchema(r,o),this.getRef(r)}getRef(r){return r in(this.rootDoc.components?.schemas||{})?{$ref:`#/components/schemas/${r}`}:void 0}ensureUniqOperationId(r,o){let n=z(r,o);return n in this.lastOperationIdSuffixes?(this.lastOperationIdSuffixes[n]++,`${n}${this.lastOperationIdSuffixes[n]}`):(this.lastOperationIdSuffixes[n]=1,n)}ensureUniqSecuritySchemaName(r){let o=JSON.stringify(r);for(let n in this.rootDoc.components?.securitySchemes||{})if(o===JSON.stringify(this.rootDoc.components?.securitySchemes?.[n]))return n;return this.lastSecuritySchemaIds[r.type]=(this.lastSecuritySchemaIds?.[r.type]||0)+1,`${r.type.toUpperCase()}_${this.lastSecuritySchemaIds[r.type]}`}};var It=R(require("http"));var Go=e=>({method:"GET",header:jest.fn(()=>J),...e}),qo=e=>{let t={writableEnded:!1,statusCode:200,statusMessage:It.default.STATUS_CODES[200],set:jest.fn(()=>t),status:jest.fn(r=>(t.statusCode=r,t.statusMessage=It.default.STATUS_CODES[r],t)),json:jest.fn(()=>t),end:jest.fn(()=>(t.writableEnded=!0,t)),...e};return t},Zr=async({endpoint:e,requestProps:t,responseProps:r,configProps:o,loggerProps:n,__noJest:s})=>{if(!jest||s)throw new Error("You need to install Jest in order to use testEndpoint().");let a=Go(t),d=qo(r),c={info:jest.fn(),warn:jest.fn(),error:jest.fn(),debug:jest.fn(),...n},p={cors:!1,logger:c,...o};return await e.execute({request:a,response:d,config:p,logger:c}),{requestMock:a,responseMock:d,loggerMock:c}};var H=R(require("typescript"));var D=R(require("typescript")),i=D.default.factory,ge=[i.createModifier(D.default.SyntaxKind.ExportKeyword)],Vo=[i.createModifier(D.default.SyntaxKind.AsyncKeyword)],Bo=[i.createModifier(D.default.SyntaxKind.PublicKeyword),i.createModifier(D.default.SyntaxKind.ReadonlyKeyword)],Er=[i.createModifier(D.default.SyntaxKind.ProtectedKeyword),i.createModifier(D.default.SyntaxKind.ReadonlyKeyword)],Yo=i.createTemplateHead(""),Jo=i.createTemplateTail(""),Qo=i.createTemplateMiddle(" "),Ct=e=>i.createTemplateLiteralType(Yo,e.map((t,r)=>i.createTemplateLiteralTypeSpan(i.createTypeReferenceNode(t),r===e.length-1?Jo:Qo))),Mt=Ct(["M","P"]),tt=(e,t,r)=>i.createParameterDeclaration(r,void 0,e,void 0,t),rt=(e,t)=>Object.keys(e).reduce((r,o)=>r.concat(tt(o,e[o],t)),[]),Nt=(e,t)=>i.createExpressionWithTypeArguments(i.createIdentifier("Record"),[typeof e=="number"?i.createKeywordTypeNode(e):i.createTypeReferenceNode(e),i.createKeywordTypeNode(t)]),Ar=e=>i.createConstructorDeclaration(void 0,e,i.createBlock([])),wt=(e,t)=>i.createPropertySignature(void 0,`"${e}"`,void 0,i.createTypeReferenceNode(t)),Ir=(e,t)=>i.createVariableDeclarationList([i.createVariableDeclaration(e,void 0,void 0,t)],D.default.NodeFlags.Const),Dt=(e,t)=>i.createTypeAliasDeclaration(ge,e,void 0,i.createUnionTypeNode(t.map(r=>i.createLiteralTypeNode(i.createStringLiteral(r))))),ot=(e,t)=>i.createTypeAliasDeclaration(ge,e,void 0,t),Cr=(e,t,r)=>i.createPropertyDeclaration(Bo,e,void 0,t,r),Mr=(e,t,r=[])=>i.createClassDeclaration(ge,e,void 0,void 0,[t,...r]),Nr=(e,t)=>i.createTypeReferenceNode("Promise",[i.createIndexedAccessTypeNode(i.createTypeReferenceNode(e),t)]),wr=()=>i.createTypeReferenceNode("Promise",[i.createKeywordTypeNode(D.default.SyntaxKind.AnyKeyword)]),zt=(e,t,r)=>i.createInterfaceDeclaration(ge,e,void 0,t,r),Dr=e=>Object.keys(e).reduce((t,r)=>t.concat(i.createTypeParameterDeclaration([],r,i.createTypeReferenceNode(e[r]))),[]),zr=(e,t)=>i.createArrowFunction(Vo,void 0,e.map(r=>tt(r)),void 0,void 0,i.createCallExpression(i.createPropertyAccessExpression(i.createThis(),"implementation"),void 0,t)),vt=(e,t,r)=>i.createCallExpression(i.createPropertyAccessExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("Object"),"keys"),void 0,[i.createIdentifier(e)]),"reduce"),void 0,[i.createArrowFunction(void 0,void 0,rt({acc:void 0,key:void 0}),void 0,void 0,t),r]);var u=R(require("typescript")),kr=require("zod");var U=R(require("typescript")),{factory:nt}=U.default,jt=(e,t)=>{U.default.addSyntheticLeadingComment(e,U.default.SyntaxKind.MultiLineCommentTrivia,`* ${t} `,!0)},st=(e,t,r)=>{let o=nt.createTypeAliasDeclaration(void 0,nt.createIdentifier(t),void 0,e);return r&&jt(o,r),o},vr=(e,t)=>{let r=U.default.createSourceFile("print.ts","",U.default.ScriptTarget.Latest,!1,U.default.ScriptKind.TS);return U.default.createPrinter(t).printNode(U.default.EmitHint.Unspecified,e,r)},Wo=/^[A-Za-z_$][A-Za-z0-9_$]*$/,jr=e=>Wo.test(e)?nt.createIdentifier(e):nt.createStringLiteral(e);var{factory:m}=u.default,Xo={[u.default.SyntaxKind.AnyKeyword]:"",[u.default.SyntaxKind.BigIntKeyword]:BigInt(0),[u.default.SyntaxKind.BooleanKeyword]:!1,[u.default.SyntaxKind.NumberKeyword]:0,[u.default.SyntaxKind.ObjectKeyword]:{},[u.default.SyntaxKind.StringKeyword]:"",[u.default.SyntaxKind.UndefinedKeyword]:void 0},en=({schema:{value:e}})=>m.createLiteralTypeNode(typeof e=="number"?m.createNumericLiteral(e):typeof e=="boolean"?e?m.createTrue():m.createFalse():m.createStringLiteral(e)),tn=({schema:{shape:e},isResponse:t,next:r,optionalPropStyle:{withQuestionMark:o}})=>{let n=Object.entries(e).map(([s,a])=>{let d=t&&Re(a)?a instanceof kr.z.ZodOptional:a.isOptional(),c=m.createPropertySignature(void 0,jr(s),d&&o?m.createToken(u.default.SyntaxKind.QuestionToken):void 0,r({schema:a}));return a.description&&jt(c,a.description),c});return m.createTypeLiteralNode(n)},rn=({schema:{element:e},next:t})=>m.createArrayTypeNode(t({schema:e})),on=({schema:{options:e}})=>m.createUnionTypeNode(e.map(t=>m.createLiteralTypeNode(m.createStringLiteral(t)))),Lr=({schema:{options:e},next:t})=>m.createUnionTypeNode(e.map(r=>t({schema:r}))),nn=e=>Xo?.[e.kind],sn=({schema:e,next:t,isResponse:r})=>{let o=t({schema:e.innerType()}),n=e._def.effect;if(r&&n.type==="transform"){let s=Le({effect:n,sample:nn(o)}),a={number:u.default.SyntaxKind.NumberKeyword,bigint:u.default.SyntaxKind.BigIntKeyword,boolean:u.default.SyntaxKind.BooleanKeyword,string:u.default.SyntaxKind.StringKeyword,undefined:u.default.SyntaxKind.UndefinedKeyword,object:u.default.SyntaxKind.ObjectKeyword};return m.createKeywordTypeNode(s&&a[s]||u.default.SyntaxKind.AnyKeyword)}return o},an=({schema:e})=>m.createUnionTypeNode(Object.values(e.enum).map(t=>m.createLiteralTypeNode(typeof t=="number"?m.createNumericLiteral(t):m.createStringLiteral(t)))),dn=({next:e,schema:t,optionalPropStyle:{withUndefined:r}})=>{let o=e({schema:t.unwrap()});return r?m.createUnionTypeNode([o,m.createKeywordTypeNode(u.default.SyntaxKind.UndefinedKeyword)]):o},pn=({next:e,schema:t})=>m.createUnionTypeNode([e({schema:t.unwrap()}),m.createLiteralTypeNode(m.createNull())]),cn=({next:e,schema:{items:t}})=>m.createTupleTypeNode(t.map(r=>e({schema:r}))),ln=({next:e,schema:{keySchema:t,valueSchema:r}})=>m.createExpressionWithTypeArguments(m.createIdentifier("Record"),[e({schema:t}),e({schema:r})]),mn=({next:e,schema:t})=>m.createIntersectionTypeNode([t._def.left,t._def.right].map(r=>e({schema:r}))),un=({next:e,schema:t})=>e({schema:t._def.innerType}),B=e=>()=>m.createKeywordTypeNode(e),fn=({next:e,schema:t})=>e({schema:t.unwrap()}),yn=({next:e,schema:t})=>e({schema:t._def.innerType}),gn=({next:e,schema:t})=>e({schema:t._def.innerType}),hn=({schema:e,next:t,isResponse:r})=>t({schema:e._def[r?"out":"in"]}),xn=()=>m.createLiteralTypeNode(m.createNull()),Tn=({getAlias:e,makeAlias:t,next:r,serializer:o,schema:n})=>{let s=`Type${o(n.schema)}`;return e(s)||(()=>(t(s,m.createLiteralTypeNode(m.createNull())),t(s,r({schema:n.schema}))))()},Sn={ZodString:B(u.default.SyntaxKind.StringKeyword),ZodNumber:B(u.default.SyntaxKind.NumberKeyword),ZodBigInt:B(u.default.SyntaxKind.BigIntKeyword),ZodBoolean:B(u.default.SyntaxKind.BooleanKeyword),ZodDateIn:B(u.default.SyntaxKind.StringKeyword),ZodDateOut:B(u.default.SyntaxKind.StringKeyword),ZodNull:xn,ZodArray:rn,ZodTuple:cn,ZodRecord:ln,ZodObject:tn,ZodLiteral:en,ZodIntersection:mn,ZodUnion:Lr,ZodFile:B(u.default.SyntaxKind.StringKeyword),ZodAny:B(u.default.SyntaxKind.AnyKeyword),ZodDefault:un,ZodEnum:on,ZodNativeEnum:an,ZodEffects:sn,ZodOptional:dn,ZodNullable:pn,ZodDiscriminatedUnion:Lr,ZodBranded:fn,ZodCatch:gn,ZodPipeline:hn,ZodLazy:Tn,ZodReadonly:yn},Lt=({schema:e,...t})=>oe({schema:e,rules:Sn,onMissing:()=>m.createKeywordTypeNode(u.default.SyntaxKind.AnyKeyword),...t});var it=class{constructor({routing:t,variant:r="client",serializer:o=je,optionalPropStyle:n={withQuestionMark:!0,withUndefined:!0}}){this.agg=[];this.registry={};this.paths=[];this.aliases={};re({routing:t,onEndpoint:(y,C,K)=>{let ne=z(C,K,"input"),xe=z(C,K,"response"),Te={serializer:o,getAlias:this.getAlias.bind(this),makeAlias:this.makeAlias.bind(this),optionalPropStyle:n},M=Lt({...Te,schema:y.getSchema("input"),isResponse:!1}),Ie=Lt({...Te,isResponse:!0,schema:y.getSchema("positive").or(y.getSchema("negative"))});this.agg.push(st(M,ne),st(Ie,xe)),K!=="options"&&(this.paths.push(C),this.registry[`${K} ${C}`]={in:ne,out:xe,isJson:y.getMimeTypes("positive").includes(J)})}}),this.agg=Object.values(this.aliases).concat(this.agg);let s=Dt("Path",this.paths),a=Dt("Method",rr),d=ot("MethodPath",Ct([a.name,s.name])),c=[i.createHeritageClause(H.default.SyntaxKind.ExtendsKeyword,[Nt(d.name,H.default.SyntaxKind.AnyKeyword)])],p=zt("Input",c,Object.keys(this.registry).map(y=>wt(y,this.registry[y].in))),l=zt("Response",c,Object.keys(this.registry).map(y=>wt(y,this.registry[y].out)));if(this.agg.push(s,a,d,p,l),r==="types")return;let f=i.createVariableStatement(ge,Ir("jsonEndpoints",i.createObjectLiteralExpression(Object.keys(this.registry).filter(y=>this.registry[y].isJson).map(y=>i.createPropertyAssignment(`"${y}"`,i.createTrue()))))),x=ot("Provider",i.createFunctionTypeNode(Dr({M:a.name,P:s.name}),rt({method:i.createTypeReferenceNode("M"),path:i.createTypeReferenceNode("P"),params:i.createIndexedAccessTypeNode(i.createTypeReferenceNode(p.name),Mt)}),Nr(l.name,Mt))),g=ot("Implementation",i.createFunctionTypeNode(void 0,rt({method:i.createTypeReferenceNode(a.name),path:i.createKeywordTypeNode(H.default.SyntaxKind.StringKeyword),params:Nt(H.default.SyntaxKind.StringKeyword,H.default.SyntaxKind.AnyKeyword)}),wr())),O=i.createTemplateExpression(i.createTemplateHead(":"),[i.createTemplateSpan(i.createIdentifier("key"),i.createTemplateTail(""))]),h=Mr("ExpressZodAPIClient",Ar([tt("implementation",i.createTypeReferenceNode(g.name),Er)]),[Cr("provide",i.createTypeReferenceNode(x.name),zr(["method","path","params"],[i.createIdentifier("method"),vt("params",i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("acc"),"replace"),void 0,[O,i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key"))]),i.createIdentifier("path")),vt("params",i.createConditionalExpression(i.createBinaryExpression(i.createCallExpression(i.createPropertyAccessExpression(i.createIdentifier("path"),"indexOf"),void 0,[O]),H.default.SyntaxKind.GreaterThanEqualsToken,i.createNumericLiteral(0)),void 0,i.createIdentifier("acc"),void 0,i.createObjectLiteralExpression([i.createSpreadAssignment(i.createIdentifier("acc")),i.createPropertyAssignment("[key]",i.createElementAccessExpression(i.createIdentifier("params"),i.createIdentifier("key")))])),i.createObjectLiteralExpression())]))]);H.default.addSyntheticLeadingComment(h,H.default.SyntaxKind.MultiLineCommentTrivia,`
|
|
35
35
|
export const exampleImplementation: Implementation = async (
|
|
36
36
|
method,
|
|
37
37
|
path,
|
|
@@ -52,6 +52,6 @@ export const exampleImplementation: Implementation = async (
|
|
|
52
52
|
|
|
53
53
|
const client = new ExpressZodAPIClient(exampleImplementation);
|
|
54
54
|
client.provide("get", "/v1/user/retrieve", { id: "10" });
|
|
55
|
-
`,!0),this.agg.push(f,x,g,h)}getAlias(
|
|
55
|
+
`,!0),this.agg.push(f,x,g,h)}getAlias(t){return t in this.aliases?i.createTypeReferenceNode(t):void 0}makeAlias(t,r){return this.aliases[t]=st(r,t),this.getAlias(t)}print(t){return this.agg.map(r=>vr(r,t)).join(`
|
|
56
56
|
|
|
57
|
-
`)}};var
|
|
57
|
+
`)}};var kt={};Ht(kt,{dateIn:()=>En,dateOut:()=>An,file:()=>Pn,upload:()=>Zn});var P=require("zod");var On="ZodDateOut",dt=class dt extends P.ZodType{_parse(t){let{status:r,ctx:o}=this._processInputParams(t);return o.parsedType!==P.ZodParsedType.date?((0,P.addIssueToContext)(o,{code:P.ZodIssueCode.invalid_type,expected:P.ZodParsedType.date,received:o.parsedType}),P.INVALID):ze(o.data)?{status:r.value,value:o.data.toISOString()}:((0,P.addIssueToContext)(o,{code:P.ZodIssueCode.invalid_date}),P.INVALID)}};dt.create=()=>new dt({typeName:On});var at=dt;var E=require("zod");var bn="ZodFile",Rn=/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/,he=class he extends E.ZodType{constructor(){super(...arguments);this.binary=r=>new he({...this._def,checks:[...this._def.checks,{kind:"binary",...yt(r)}]});this.base64=r=>new he({...this._def,checks:[...this._def.checks,{kind:"base64",...yt(r)}]})}_parse(r){let{status:o,ctx:n}=this._processInputParams(r);if(n.parsedType!==E.ZodParsedType.string)return(0,E.addIssueToContext)(n,{code:E.ZodIssueCode.invalid_type,expected:E.ZodParsedType.string,received:n.parsedType}),E.INVALID;for(let s of this._def.checks)s.kind==="base64"&&(Rn.test(n.data)||((0,E.addIssueToContext)(n,{code:E.ZodIssueCode.custom,message:s.message}),o.dirty()));return{status:o.value,value:n.data}}get isBinary(){return!!this._def.checks.find(r=>r.kind==="binary")}get isBase64(){return!!this._def.checks.find(r=>r.kind==="base64")}};he.create=()=>new he({checks:[],typeName:bn});var pt=he;var Pn=pt.create,Zn=se.create,En=Je.create,An=at.create;var Ur=R(require("http-errors"));0&&(module.exports={AbstractEndpoint,DependsOnMethod,DependsOnMethodError,Documentation,DocumentationError,EndpointsFactory,InputValidationError,Integration,OutputValidationError,RoutingError,ServeStatic,attachRouting,createConfig,createHttpError,createLogger,createMiddleware,createResultHandler,createServer,defaultEndpointsFactory,defaultResultHandler,ez,getExamples,getMessageFromError,getStatusCodeFromError,testEndpoint,withMeta});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "express-zod-api",
|
|
3
|
-
"version": "11.
|
|
3
|
+
"version": "11.4.0",
|
|
4
4
|
"description": "A Typescript library 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
|
"scripts": {
|
|
@@ -91,17 +91,17 @@
|
|
|
91
91
|
"@types/node-fetch": "^2.6.4",
|
|
92
92
|
"@types/ramda": "^0.29.0",
|
|
93
93
|
"@types/triple-beam": "^1.3.2",
|
|
94
|
-
"@typescript-eslint/eslint-plugin": "^
|
|
95
|
-
"@typescript-eslint/parser": "^
|
|
94
|
+
"@typescript-eslint/eslint-plugin": "^6.0.0",
|
|
95
|
+
"@typescript-eslint/parser": "^6.0.0",
|
|
96
96
|
"chalk": "^4.1.2",
|
|
97
97
|
"cors": "^2.8.5",
|
|
98
98
|
"eslint": "^8.23.0",
|
|
99
99
|
"eslint-config-airbnb-base": "^15.0.0",
|
|
100
|
-
"eslint-config-airbnb-typescript": "^17.
|
|
101
|
-
"eslint-config-prettier": "^
|
|
100
|
+
"eslint-config-airbnb-typescript": "^17.1.0",
|
|
101
|
+
"eslint-config-prettier": "^9.0.0",
|
|
102
102
|
"eslint-plugin-import": "^2.26.0",
|
|
103
|
-
"eslint-plugin-local-rules": "^1.3.2",
|
|
104
103
|
"eslint-plugin-prettier": "^5.0.0",
|
|
104
|
+
"eslint-plugin-unicorn": "^48.0.0",
|
|
105
105
|
"express": "^4.18.2",
|
|
106
106
|
"form-data": "^4.0.0",
|
|
107
107
|
"has-ansi": "^4.0.1",
|
|
@@ -110,7 +110,7 @@
|
|
|
110
110
|
"make-coverage-badge": "^1.2.0",
|
|
111
111
|
"mockdate": "^3.0.5",
|
|
112
112
|
"node-fetch": "^2.6.11",
|
|
113
|
-
"prettier": "3.0.
|
|
113
|
+
"prettier": "3.0.2",
|
|
114
114
|
"strip-ansi": "^6.0.1",
|
|
115
115
|
"ts-node": "^10.9.1",
|
|
116
116
|
"tsd": "^0.28.0",
|