@ez4/gateway 0.35.1 → 0.37.0

package/dist/services/ws/contract.d.ts

@@ -0,0 +1,110 @@
+import type { Service as CommonService } from '@ez4/common';
+import type { LinkedVariables } from '@ez4/project/library';
+import type { AuthProvider as WsAuthProvider } from '../auth/provider';
+import type { AuthResponse as WsAuthResponse } from '../auth/response';
+import type { AuthRequest as WsAuthRequest } from '../auth/request';
+import type { AuthIdentity } from '../auth/identity';
+import type { WebHeaders } from '../headers';
+import type { WebQueryStrings } from '../query';
+import type { WebPreferences } from '../preferences';
+import type { WebJsonBody, WebRawBody } from '../body';
+import type { WsEmptyEvent, WsEmptyRequest } from './utils';
+import type { WsDisconnect } from './disconnect';
+import type { WsDefaults } from './defaults';
+import type { WsIncoming } from './incoming';
+import type { WsListener } from './listener';
+import type { WsResponse } from './response';
+import type { WsRequest } from './request';
+import type { WsHandler } from './handler';
+import type { WsMessage } from './message';
+import type { WsConnect } from './connect';
+import type { WsClient } from './client';
+import type { WsEvent } from './event';
+/**
+ * Provide all contracts for a self-managed WS service.
+ */
+export declare namespace Ws {
+    type Headers = WebHeaders;
+    type Identity = AuthIdentity;
+    type QueryStrings = WebQueryStrings;
+    type JsonBody = WebJsonBody;
+    type RawBody = WebRawBody;
+    type Preferences = WebPreferences;
+    type Request = WsRequest;
+    type Response = WsResponse;
+    type Event = WsEvent;
+    type AuthRequest = WsAuthRequest;
+    type AuthResponse = WsAuthResponse;
+    type AuthProvider = WsAuthProvider;
+    type Incoming<T extends Request | Event> = WsIncoming<T>;
+    type Listener<T extends Request | Event> = WsListener<T>;
+    type Handler<T extends Request | Event> = WsHandler<T>;
+    type Connect<T extends Event = Event, U extends AuthRequest = AuthRequest> = WsConnect<T, U>;
+    type Disconnect<T extends Event = Event> = WsDisconnect<T>;
+    type Message<T extends Request = Request> = WsMessage<T>;
+    type Defaults<T extends Request | Event = any> = WsDefaults<T>;
+    type ServiceEvent<T extends Request | Event = Event> = CommonService.AnyEvent<Incoming<T>>;
+    type EmptyRequest = WsEmptyRequest;
+    type EmptyEvent = WsEmptyEvent;
+    /**
+     * WS Defaults definition.
+     */
+    type UseDefaults<T extends Defaults<any>> = T;
+    /**
+     * WS Preferences definition.
+     */
+    type UsePreferences<T extends Preferences> = T;
+    /**
+     * WS Connect event definition.
+     */
+    type UseConnect<T extends Connect<any, any>> = T;
+    /**
+     * WS Disconnect event definition.
+     */
+    type UseDisconnect<T extends Disconnect<any>> = T;
+    /**
+     * WS Message event definition.
+     */
+    type UseMessage<T extends Message<any>> = T;
+    /**
+     * WS service.
+     */
+    abstract class Service<T extends JsonBody> implements CommonService.Provider {
+        /**
+         * All connection events.
+         */
+        abstract readonly connect: Connect<any, any>;
+        /**
+         * All disconnection events.
+         */
+        abstract readonly disconnect: Disconnect<any>;
+        /**
+         * All message events.
+         */
+        abstract readonly message: Message<any>;
+        /**
+         * Default gateway parameters.
+         */
+        readonly defaults?: Defaults<any>;
+        /**
+         * Display name for the service.
+         */
+        readonly name?: string;
+        /**
+         * Service stage name.
+         */
+        readonly stage?: string;
+        /**
+         * Service schema.
+         */
+        readonly schema: T;
+        /**
+         * Variables associated to all routes.
+         */
+        readonly variables?: LinkedVariables;
+        /**
+         * Service client.
+         */
+        readonly client: WsClient<T>;
+    }
+}

package/dist/services/ws/defaults.d.ts

@@ -0,0 +1,13 @@
+import type { WebDefaults } from '../defaults';
+import type { WsRequest } from './request';
+import type { WsListener } from './listener';
+import type { WsEvent } from './event';
+/**
+ * Default WS service parameters.
+ */
+export interface WsDefaults<T extends WsRequest | WsEvent> extends WebDefaults {
+    /**
+     * Default listener.
+     */
+    readonly listener?: WsListener<T>;
+}

package/dist/services/ws/disconnect.d.ts

@@ -0,0 +1,17 @@
+import type { WebTarget } from '../target';
+import type { WsListener } from './listener';
+import type { WsHandler } from './handler';
+import type { WsEvent } from './event';
+/**
+ * WS disconnect event.
+ */
+export interface WsDisconnect<T extends WsEvent> extends WebTarget {
+    /**
+     * Life-cycle listener function for the event.
+     */
+    readonly listener?: WsListener<T>;
+    /**
+     * Entry-point handler function for the event.
+     */
+    readonly handler: WsHandler<T>;
+}

package/dist/services/ws/event.d.ts

@@ -0,0 +1,20 @@
+import type { AuthIdentity } from '../auth/identity';
+import type { WebQueryStrings } from '../query';
+import type { WebHeaders } from '../headers';
+/**
+ * WS event.
+ */
+export interface WsEvent {
+    /**
+     * Expected HTTP headers.
+     */
+    readonly headers?: WebHeaders;
+    /**
+     * Expected HTTP query strings.
+     */
+    readonly query?: WebQueryStrings;
+    /**
+     * Expected identity.
+     */
+    readonly identity?: AuthIdentity;
+}

package/dist/services/ws/handler.d.ts

@@ -0,0 +1,10 @@
+import type { Service } from '@ez4/common';
+import type { WsIncoming } from './incoming';
+import type { WsResponse } from './response';
+import type { WsRequest } from './request';
+import type { WsEvent } from './event';
+import type { Ws } from './contract';
+/**
+ * WS request handler.
+ */
+export type WsHandler<T extends WsRequest | WsEvent> = (request: WsIncoming<T> | T, context: Service.Context<Ws.Service<any>>) => Promise<WsResponse | void> | WsResponse | void;

package/dist/services/ws/incoming.d.ts

@@ -0,0 +1,19 @@
+import type { WsRequest } from './request';
+import type { WsEvent } from './event';
+/**
+ * Incoming WS event.
+ */
+export type WsIncoming<T extends WsRequest | WsEvent> = T & {
+    /**
+     * Request tracking Id.
+     */
+    readonly requestId: string;
+    /**
+     * Request connection Id.
+     */
+    readonly connectionId: string;
+    /**
+     * Request timestamp.
+     */
+    readonly timestamp: Date;
+};

package/dist/services/ws/listener.d.ts

@@ -0,0 +1,9 @@
+import type { Service } from '@ez4/common';
+import type { WsIncoming } from './incoming';
+import type { WsRequest } from './request';
+import type { WsEvent } from './event';
+import type { Ws } from './contract';
+/**
+ * WS request listener.
+ */
+export type WsListener<T extends WsRequest | WsEvent> = (event: Service.AnyEvent<WsIncoming<T> | T>, context: Service.Context<Ws.Service<any>>) => Promise<void> | void;

package/dist/services/ws/message.d.ts

@@ -0,0 +1,17 @@
+import type { WebTarget } from '../target';
+import type { WsListener } from './listener';
+import type { WsHandler } from './handler';
+import type { WsEvent } from './event';
+/**
+ * WS message event.
+ */
+export interface WsMessage<T extends WsEvent> extends WebTarget {
+    /**
+     * Life-cycle listener function for the event.
+     */
+    readonly listener?: WsListener<T>;
+    /**
+     * Entry-point handler function for the event.
+     */
+    readonly handler: WsHandler<T>;
+}

package/dist/services/ws/request.d.ts

@@ -0,0 +1,15 @@
+import type { AuthIdentity } from '../auth/identity';
+import type { WebBody } from '../body';
+/**
+ * WS request.
+ */
+export interface WsRequest {
+    /**
+     * Expected identity.
+     */
+    readonly identity?: AuthIdentity;
+    /**
+     * Expected event body.
+     */
+    readonly body?: WebBody;
+}

package/dist/services/ws/response.d.ts

@@ -0,0 +1,10 @@
+import type { WebBody } from '../body';
+/**
+ * WS response.
+ */
+export interface WsResponse {
+    /**
+     * WS body payload.
+     */
+    readonly body?: WebBody;
+}

package/dist/services/ws/utils.d.ts

@@ -0,0 +1,11 @@
+import type { Ws } from './contract';
+/**
+ * WS empty request.
+ */
+export declare class WsEmptyRequest implements Ws.Request {
+}
+/**
+ * WS empty event.
+ */
+export declare class WsEmptyEvent implements Ws.Event {
+}

package/dist/utils/body.d.ts

@@ -1,9 +1,10 @@
+import type { ValidationCustomHandler } from '@ez4/validator';
 import type { AnySchema } from '@ez4/schema';
-import type { Http } from '../services/contract';
+import type { Http } from '../services/http/contract';
 export declare const prepareRequestBody: <T extends Http.JsonBody | Http.RawBody>(input: T, schema?: AnySchema, preferences?: Http.Preferences) => {
     body: string;
     json: boolean;
 };
-export declare const getRequestBody: <T extends Http.JsonBody | Http.RawBody>(input: T | undefined, schema: AnySchema, preferences?: Http.Preferences) => Promise<T>;
+export declare const resolveRequestBody: <T extends Http.JsonBody | Http.RawBody>(input: T | undefined, schema: AnySchema, preferences?: Http.Preferences, onCustomValidation?: ValidationCustomHandler) => Promise<T>;
 export declare const prepareResponseBody: (body: string, schema?: AnySchema, preferences?: Http.Preferences) => unknown;
-export declare const getResponseBody: (body: unknown, schema: AnySchema, preferences?: Http.Preferences) => unknown;
+export declare const resolveResponseBody: (body: unknown, schema: AnySchema, preferences?: Http.Preferences) => unknown;

package/dist/utils/client.d.ts

@@ -1,6 +1,6 @@
 import type { ArraySchema, ObjectSchema, ScalarSchema, UnionSchema, NamingStyle } from '@ez4/schema';
-import type { ClientRequest, ClientResponse } from '../services/client';
-export type ClientRequestUrl = ClientRequest & {
+import type { HttpClientRequest, HttpClientResponse } from '../services/http/client';
+export type ClientRequestUrl = HttpClientRequest & {
     querySchema?: ObjectSchema;
     namingStyle?: NamingStyle;
 };
@@ -9,10 +9,10 @@ export type RequestAuthorization = {
     header: string;
     value: string;
 };
-export type ClientRequestInput = ClientRequest & {
+export type ClientRequestInput = HttpClientRequest & {
     authorization?: RequestAuthorization;
     responseSchema?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema;
     bodySchema?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema;
     namingStyle?: NamingStyle;
 };
-export declare const sendClientRequest: (url: string, method: string, request: ClientRequestInput) => Promise<ClientResponse>;
+export declare const sendClientRequest: (url: string, method: string, request: ClientRequestInput) => Promise<HttpClientResponse>;

package/dist/utils/errors.d.ts

@@ -7,6 +7,7 @@ import { HttpError } from '@ez4/gateway';
 export declare const getJsonError: ({ status, message, details }: HttpError) => {
     status: number;
     body: {
+        type: string;
         message: string;
         details: string[] | undefined;
     };

package/dist/utils/headers.d.ts

@@ -1,3 +1,4 @@
+import type { ValidationCustomHandler } from '@ez4/validator';
 import type { ObjectSchema } from '@ez4/schema';
-import type { Http } from '../services/contract';
-export declare const getHeaders: <T extends Http.Headers>(input: T, schema: ObjectSchema) => Promise<T>;
+import type { Http } from '../services/http/contract';
+export declare const resolveHeaders: <T extends Http.Headers>(input: T, schema: ObjectSchema, onCustomValidation?: ValidationCustomHandler) => Promise<T>;

package/dist/utils/identity.d.ts

@@ -1,3 +1,4 @@
+import type { ValidationCustomHandler } from '@ez4/validator';
 import type { ObjectSchema, UnionSchema } from '@ez4/schema';
-import type { Http } from '../services/contract';
-export declare const getIdentity: <T extends Http.Identity>(input: T, schema: ObjectSchema | UnionSchema) => Promise<T>;
+import type { Http } from '../services/http/contract';
+export declare const resolveIdentity: <T extends Http.Identity>(input: T, schema: ObjectSchema | UnionSchema, onCustomValidation?: ValidationCustomHandler) => Promise<T>;

package/dist/utils/parameters.d.ts

@@ -1,4 +1,5 @@
+import type { ValidationCustomHandler } from '@ez4/validator';
 import type { ObjectSchema } from '@ez4/schema';
-import type { Http } from '../services/contract';
+import type { Http } from '../services/http/contract';
 export declare const preparePathParameters: (path: string, parameters: Record<string, string>) => string;
-export declare const getPathParameters: <T extends Http.PathParameters>(input: T, schema: ObjectSchema) => Promise<T>;
+export declare const resolvePathParameters: <T extends Http.PathParameters>(input: T, schema: ObjectSchema, onCustomValidation?: ValidationCustomHandler) => Promise<T>;

package/dist/utils/query.d.ts

@@ -1,4 +1,5 @@
+import type { ValidationCustomHandler } from '@ez4/validator';
 import type { ObjectSchema } from '@ez4/schema';
-import type { Http } from '../services/contract';
+import type { Http } from '../services/http/contract';
 export declare const prepareQueryStrings: <T extends Http.QueryStrings>(input: T, schema?: ObjectSchema, preferences?: Http.Preferences) => string | undefined;
-export declare const getQueryStrings: <T extends Http.QueryStrings>(input: T, schema: ObjectSchema, preferences?: Http.Preferences) => Promise<T>;
+export declare const resolveQueryStrings: <T extends Http.QueryStrings>(input: T, schema: ObjectSchema, preferences?: Http.Preferences, onCustomValidation?: ValidationCustomHandler) => Promise<T>;

package/dist/utils/validation.d.ts

@@ -0,0 +1,2 @@
+import type { AnyObject } from '@ez4/utils';
+export declare const resolveValidation: (input: unknown, validators: AnyObject, name: string) => Promise<void>;

package/dist/utils.cjs

@@ -1,56 +1,63 @@
-"use strict";var w=Object.defineProperty;var k=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var D=Object.prototype.hasOwnProperty;var s=(e,t)=>w(e,"name",{value:t,configurable:!0});var _=(e,t)=>{for(var r in t)w(e,r,{get:t[r],enumerable:!0})},G=(e,t,r,o)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let n of F(t))!D.call(e,n)&&n!==r&&
-w(e,n,{get:()=>t[n],enumerable:!(o=k(t,n))||o.enumerable});return e};var K=e=>G(w({},"__esModule",{value:!0}),e);var nt={};_(nt,{getClientRequestUrl:()=>tt,getHeaders:()=>rt,getHttpException:()=>v,
-getIdentity:()=>ot,getJsonError:()=>Z,getPathParameters:()=>Y,getQueryStrings:()=>L,
-getRequestBody:()=>W,getResponseBody:()=>X,preparePathParameters:()=>P,prepareQueryStrings:()=>C,
-prepareRequestBody:()=>E,prepareResponseBody:()=>j,sendClientRequest:()=>et});module.
-exports=K(nt);var M=require("@ez4/gateway"),u=require("@ez4/transform"),f=require("@ez4/validator"),
-d=require("@ez4/utils"),q=require("@ez4/schema");var C=s((e,t,r)=>{if(!t)return B(e);let o=(0,u.createTransformContext)({inputStyle:r?.
-namingStyle,convert:!1}),n=(0,u.transform)(e,t,o);return B(n,t)},"prepareQuerySt\
-rings"),L=s(async(e,t,r)=>{let o=r?.namingStyle,n=(0,u.createTransformContext)({
-convert:!0,inputStyle:o}),i=(0,u.transform)(e,t,n),y=(0,f.createValidatorContext)(
-{property:"$query",pathStyle:o}),m=await(0,f.validate)(i,t,y);if(m.length){let p=(0,f.getUniqueErrorMessages)(
-m);throw new M.HttpBadRequestError("Malformed query strings.",p)}return i},"getQ\
-ueryStrings"),B=s((e,t)=>{let r=[];for(let o in e){let n=t&&(0,q.getSchemaProperty)(
-t,o),i=N(e[o],n);i&&r.push(`${o}=${encodeURIComponent(i)}`)}if(r.length)return r.
-join("&")},"serializeQueryStrings"),N=s((e,t)=>{if(!(0,d.isNullish)(e))return e instanceof
-Date?e.toISOString():e instanceof Array&&(!t||!(0,q.isArraySchema)(t)||!t.definitions?.
-encoded)?e.map(n=>N(n,t)).filter(n=>(0,d.isNotNullish)(n)).join(","):e instanceof
-Object?(0,d.base64Encode)(JSON.stringify(e)):`${e}`},"serializeQueryStringValue");var c=require("@ez4/transform"),l=require("@ez4/validator"),T=require("@ez4/schema"),
-$=require("@ez4/gateway");var E=s((e,t,r)=>{if(!t||(0,T.isScalarSchema)(t))return{body:e.toString(),json:!1};
-let o=(0,c.createTransformContext)({outputStyle:r?.namingStyle,convert:!1}),n=(0,c.transform)(
-e,t,o);return{body:JSON.stringify(n),json:!0}},"prepareRequestBody"),W=s(async(e,t,r)=>{
-let o=r?.namingStyle,n=(0,l.createValidatorContext)({property:"$body",inputStyle:o}),
-i=await(0,l.validate)(e,t,n);if(i.length){let p=(0,l.getUniqueErrorMessages)(i);
-throw new $.HttpBadRequestError("Malformed body payload.",p)}let y=(0,c.createTransformContext)(
-{convert:!1,inputStyle:o});return(0,c.transform)(e,t,y)},"getRequestBody"),j=s((e,t,r)=>{
-if(!t||(0,T.isScalarSchema)(t))return e;let o=JSON.parse(e),n=(0,c.createTransformContext)(
-{outputStyle:T.NamingStyle.Preserve,inputStyle:r?.namingStyle,convert:!1});return(0,c.transform)(
-o,t,n)},"prepareResponseBody"),X=s((e,t,r)=>{let o=r?.namingStyle,n=(0,c.createTransformContext)(
-{convert:!1,outputStyle:o});return(0,c.transform)(e,t,n)},"getResponseBody");var b=require("@ez4/transform"),S=require("@ez4/validator"),Q=require("@ez4/gateway");var P=s((e,t)=>e.replaceAll(/\{(\w+)\}/g,(r,o)=>o in t?`${t[o]}`:`{${o}}`),"prep\
-arePathParameters"),Y=s(async(e,t)=>{let r=(0,b.transform)(e,t,(0,b.createTransformContext)(
-{convert:!1})),o=await(0,S.validate)(r,t,(0,S.createValidatorContext)({property:"\
-$path"}));if(o.length){let n=(0,S.getUniqueErrorMessages)(o);throw new Q.HttpBadRequestError(
-"Malformed path parameters.",n)}return r},"getPathParameters");var a=require("@ez4/gateway");var Z=s(({status:e,message:t,details:r})=>({status:e,body:{message:t,details:r}}),
-"getJsonError"),v=s((e,t,r)=>{switch(e){case 400:return new a.HttpBadRequestError(
-t,r);case 401:return new a.HttpUnauthorizedError(t,r);case 403:return new a.HttpForbiddenError(
-t,r);case 404:return new a.HttpNotFoundError(t,r);case 415:return new a.HttpUnsupportedMediaTypeError(
-t,r);case 422:return new a.HttpUnprocessableEntityError(t,r);default:return new a.HttpError(
-e,t,r)}},"getHttpException");var tt=s((e,t,r)=>{let{parameters:o,query:n,querySchema:i,namingStyle:y}=r,m=o?P(
-t,o):t,p=n&&C(n,i,{namingStyle:y}),x=[e];return m&&x.push(m),p&&x.push("?",p),x.
-join("")},"getClientRequestUrl"),et=s(async(e,t,r)=>{let{authorization:o,headers:n,
-body:i,bodySchema:y,responseSchema:m,namingStyle:p,timeout:x=20}=r,O=i?E(i,y,{namingStyle:p}):
-void 0,U=new AbortController,V=setTimeout(()=>U?.abort("Request timed out"),x*1e3),
-H=await fetch(e,{signal:U?.signal,body:O?.body,method:t,headers:{...n,...o&&{[o.
-header]:o.value},...O?.json&&{"content-type":"application/json"}}});if(clearTimeout(
-V),!H.ok){let A=await H.json();throw v(H.status,A.message,A.details)}let z=await H.
-text();return{status:H.status,...z&&{body:j(z,m,{namingStyle:p})}}},"sendClientR\
-equest");var R=require("@ez4/transform"),h=require("@ez4/validator"),I=require("@ez4/gateway");var rt=s(async(e,t)=>{let r=(0,R.transform)(e,t,(0,R.createTransformContext)({convert:!1})),
-o=await(0,h.validate)(r,t,(0,h.createValidatorContext)({property:"$header"}));if(o.
-length){let n=(0,h.getUniqueErrorMessages)(o);throw new I.HttpBadRequestError("M\
-alformed request headers.",n)}return r},"getHeaders");var g=require("@ez4/validator"),J=require("@ez4/gateway");var ot=s(async(e,t)=>{let r=await(0,g.validate)(e,t,(0,g.createValidatorContext)(
-{property:"$identity"}));if(r.length){let o=(0,g.getUniqueErrorMessages)(r);throw new J.HttpBadRequestError(
-"Malformed authorizer identity.",o)}return e},"getIdentity");0&&(module.exports={getClientRequestUrl,getHeaders,getHttpException,getIdentity,
-getJsonError,getPathParameters,getQueryStrings,getRequestBody,getResponseBody,preparePathParameters,
-prepareQueryStrings,prepareRequestBody,prepareResponseBody,sendClientRequest});
+"use strict";var T=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var G=Object.prototype.hasOwnProperty;var a=(e,t)=>T(e,"name",{value:t,configurable:!0});var K=(e,t)=>{for(var r in t)T(e,r,{get:t[r],enumerable:!0})},L=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let n of _(t))!G.call(e,n)&&n!==r&&
+T(e,n,{get:()=>t[n],enumerable:!(o=D(t,n))||o.enumerable});return e};var W=e=>L(T({},"__esModule",{value:!0}),e);var it={};K(it,{getClientRequestUrl:()=>rt,getHttpException:()=>O,getJsonError:()=>et,
+preparePathParameters:()=>z,prepareQueryStrings:()=>j,prepareRequestBody:()=>P,prepareResponseBody:()=>V,
+resolveHeaders:()=>nt,resolveIdentity:()=>at,resolvePathParameters:()=>tt,resolveQueryStrings:()=>X,
+resolveRequestBody:()=>Y,resolveResponseBody:()=>Z,resolveValidation:()=>st,sendClientRequest:()=>ot});
+module.exports=W(it);var f=require("@ez4/transform"),S=require("@ez4/validator"),h=require("@ez4/utils"),
+b=require("@ez4/schema"),N=require("@ez4/gateway");var j=a((e,t,r)=>{if(!t)return B(e);let o=(0,f.createTransformContext)({inputStyle:r?.
+namingStyle,convert:!1}),n=(0,f.transform)(e,t,o);return B(n,t)},"prepareQuerySt\
+rings"),X=a(async(e,t,r,o)=>{let n=r?.namingStyle,s=(0,f.createTransformContext)(
+{convert:!0,inputStyle:n}),p=(0,f.transform)(e,t,s),d=(0,S.createValidatorContext)(
+{property:"$query",pathStyle:n,onCustomValidation:o}),c=await(0,S.validate)(p,t,
+d);if(c.length){let u=(0,S.getUniqueErrorMessages)(c);throw new N.HttpBadRequestError(
+"Malformed query strings.",u)}return p},"resolveQueryStrings"),B=a((e,t)=>{let r=[];
+for(let o in e){let n=t&&(0,b.getSchemaProperty)(t,o),s=$(e[o],n);s&&r.push(`${o}\
+=${encodeURIComponent(s)}`)}if(r.length)return r.join("&")},"serializeQueryStrin\
+gs"),$=a((e,t)=>{if(!(0,h.isNullish)(e))return e instanceof Date?e.toISOString():
+e instanceof Array&&(!t||!(0,b.isArraySchema)(t)||!t.definitions?.encoded)?e.map(
+n=>$(n,t)).filter(n=>(0,h.isNotNullish)(n)).join(","):e instanceof Object?(0,h.base64Encode)(
+JSON.stringify(e)):`${e}`},"serializeQueryStringValue");var m=require("@ez4/transform"),g=require("@ez4/validator"),w=require("@ez4/schema"),
+q=require("@ez4/utils"),M=require("@ez4/gateway");var P=a((e,t,r)=>{if(!t||(0,w.isScalarSchema)(t))return{body:e.toString(),json:!1};
+let o=(0,m.createTransformContext)({outputStyle:r?.namingStyle,convert:!1}),n=(0,m.transform)(
+e,t,o);return{body:JSON.stringify(n),json:!0}},"prepareRequestBody"),Y=a(async(e,t,r,o)=>{
+let n=r?.namingStyle,s=(0,m.createTransformContext)({convert:!1,inputStyle:n}),d=(0,g.createValidatorContext)(
+{onCustomValidation:a((l,y)=>(0,q.isAnyObject)(l)||(0,q.isAnyArray)(l)?o?.((0,m.transform)(
+l,y.schema,s),y):o?.(l,y),"useCustomValidation"),property:"$body",inputStyle:n}),
+c=await(0,g.validate)(e,t,d);if(c.length){let l=(0,g.getUniqueErrorMessages)(c);
+throw new M.HttpBadRequestError("Malformed body payload.",l)}return(0,m.transform)(
+e,t,s)},"resolveRequestBody"),V=a((e,t,r)=>{if(!t||(0,w.isScalarSchema)(t))return e;
+let o=JSON.parse(e),n=(0,m.createTransformContext)({outputStyle:w.NamingStyle.Preserve,
+inputStyle:r?.namingStyle,convert:!1});return(0,m.transform)(o,t,n)},"prepareRes\
+ponseBody"),Z=a((e,t,r)=>{let o=r?.namingStyle,n=(0,m.createTransformContext)({convert:!1,
+outputStyle:o});return(0,m.transform)(e,t,n)},"resolveResponseBody");var R=require("@ez4/transform"),x=require("@ez4/validator"),Q=require("@ez4/gateway");var z=a((e,t)=>e.replaceAll(/\{(\w+)\}/g,(r,o)=>o in t?`${t[o]}`:`{${o}}`),"prep\
+arePathParameters"),tt=a(async(e,t,r)=>{let o=(0,R.transform)(e,t,(0,R.createTransformContext)(
+{convert:!1})),n=(0,x.createValidatorContext)({property:"$path",onCustomValidation:r}),
+s=await(0,x.validate)(o,t,n);if(s.length){let p=(0,x.getUniqueErrorMessages)(s);
+throw new Q.HttpBadRequestError("Malformed path parameters.",p)}return o},"resol\
+vePathParameters");var i=require("@ez4/gateway");var et=a(({status:e,message:t,details:r})=>({status:e,body:{type:"error",message:t,
+details:r}}),"getJsonError"),O=a((e,t,r)=>{switch(e){case 400:return new i.HttpBadRequestError(
+t,r);case 401:return new i.HttpUnauthorizedError(t,r);case 403:return new i.HttpForbiddenError(
+t,r);case 404:return new i.HttpNotFoundError(t,r);case 415:return new i.HttpUnsupportedMediaTypeError(
+t,r);case 422:return new i.HttpUnprocessableEntityError(t,r);default:return new i.HttpError(
+e,t,r)}},"getHttpException");var rt=a((e,t,r)=>{let{parameters:o,query:n,querySchema:s,namingStyle:p}=r,d=o?z(
+t,o):t,c=n&&j(n,s,{namingStyle:p}),u=[e];return d&&u.push(d),c&&u.push("?",c),u.
+join("")},"getClientRequestUrl"),ot=a(async(e,t,r)=>{let{authorization:o,headers:n,
+body:s,bodySchema:p,responseSchema:d,namingStyle:c,timeout:u=20}=r,l=s?P(s,p,{namingStyle:c}):
+void 0,y=new AbortController,F=setTimeout(()=>y?.abort("Request timed out"),u*1e3),
+v=await fetch(e,{signal:y?.signal,body:l?.body,method:t,headers:{...n,...o&&{[o.
+header]:o.value},...l?.json&&{"content-type":"application/json"}}});if(clearTimeout(
+F),!v.ok){let U=await v.json();throw O(v.status,U.message,U.details)}let A=await v.
+text();return{status:v.status,...A&&{body:V(A,d,{namingStyle:c})}}},"sendClientR\
+equest");var E=require("@ez4/transform"),H=require("@ez4/validator"),I=require("@ez4/gateway");var nt=a(async(e,t,r)=>{let o=(0,E.transform)(e,t,(0,E.createTransformContext)({
+convert:!1})),n=(0,H.createValidatorContext)({property:"$header",onCustomValidation:r}),
+s=await(0,H.validate)(o,t,n);if(s.length){let p=(0,H.getUniqueErrorMessages)(s);
+throw new I.HttpBadRequestError("Malformed request headers.",p)}return o},"resol\
+veHeaders");var C=require("@ez4/validator"),J=require("@ez4/gateway");var at=a(async(e,t,r)=>{let o=(0,C.createValidatorContext)({property:"$identity",
+onCustomValidation:r}),n=await(0,C.validate)(e,t,o);if(n.length){let s=(0,C.getUniqueErrorMessages)(
+n);throw new J.HttpBadRequestError("Malformed authorizer identity.",s)}return e},
+"resolveIdentity");var k=a(e=>`@${e}`,"getValidatorName");var st=a(async(e,t,r)=>{let o=t[k(r)];o&&await o.validate(e)},"resolveValidation");0&&(module.exports={getClientRequestUrl,getHttpException,getJsonError,preparePathParameters,
+prepareQueryStrings,prepareRequestBody,prepareResponseBody,resolveHeaders,resolveIdentity,
+resolvePathParameters,resolveQueryStrings,resolveRequestBody,resolveResponseBody,
+resolveValidation,sendClientRequest});
 //# sourceMappingURL=utils.cjs.map

package/dist/utils.d.ts

@@ -1,7 +1,8 @@
 export * from './utils/client';
+export * from './utils/headers';
 export * from './utils/parameters';
 export * from './utils/query';
-export * from './utils/headers';
 export * from './utils/identity';
 export * from './utils/body';
+export * from './utils/validation';
 export * from './utils/errors';