@ez4/gateway 0.30.0 → 0.31.0

package/dist/main.cjs

@@ -1,17 +1,17 @@
-"use strict";var c=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(s,e)=>c(s,"name",{value:e,configurable:!0});var S=(s,e)=>{for(var t in e)c(s,t,{get:e[t],enumerable:!0})},A=(s,e,t,n)=>{if(e&&
+"use strict";var c=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(s,e)=>c(s,"name",{value:e,configurable:!0});var S=(s,e)=>{for(var t in e)c(s,t,{get:e[t],enumerable:!0})},f=(s,e,t,n)=>{if(e&&
 typeof e=="object"||typeof e=="function")for(let o of h(e))!g.call(s,o)&&o!==t&&
-c(s,o,{get:()=>e[o],enumerable:!(n=l(e,o))||n.enumerable});return s};var q=s=>A(c({},"__esModule",{value:!0}),s);var f={};S(f,{Http:()=>d,HttpBadRequestError:()=>u,HttpError:()=>r,HttpForbiddenError:()=>a,
-HttpInternalServerError:()=>H,HttpNotFoundError:()=>x,HttpUnauthorizedError:()=>i,
-HttpUnprocessableEntityError:()=>y,HttpUnsupportedMediaTypeError:()=>m});module.
-exports=q(f);var d;(s=>{})(d||={});var R=require("@ez4/common");var r=class extends R.ServiceError{constructor(t,n,o){super(n,o);this.status=t}static{
+c(s,o,{get:()=>e[o],enumerable:!(n=R(e,o))||n.enumerable});return s};var v=s=>f(c({},"__esModule",{value:!0}),s);var q={};S(q,{Http:()=>H,HttpBadRequestError:()=>u,HttpError:()=>r,HttpForbiddenError:()=>a,
+HttpInternalServerError:()=>d,HttpNotFoundError:()=>m,HttpUnauthorizedError:()=>i,
+HttpUnprocessableEntityError:()=>y,HttpUnsupportedMediaTypeError:()=>x});module.
+exports=v(q);var H;(s=>{})(H||={});var l=require("@ez4/common");var r=class extends l.ServiceError{constructor(t,n,o){super(n,o);this.status=t}static{
 p(this,"HttpError")}},u=class extends r{static{p(this,"HttpBadRequestError")}constructor(e,t){
 super(400,e||"Bad request",t)}},i=class extends r{static{p(this,"HttpUnauthorize\
 dError")}constructor(e,t){super(401,e||"Unauthorized",t)}},a=class extends r{static{
-p(this,"HttpForbiddenError")}constructor(e,t){super(403,e||"Forbidden",t)}},x=class extends r{static{
-p(this,"HttpNotFoundError")}constructor(e,t){super(404,e||"Not found",t)}},m=class extends r{static{
+p(this,"HttpForbiddenError")}constructor(e,t){super(403,e||"Forbidden",t)}},m=class extends r{static{
+p(this,"HttpNotFoundError")}constructor(e,t){super(404,e||"Not found",t)}},x=class extends r{static{
 p(this,"HttpUnsupportedMediaTypeError")}constructor(e,t){super(415,e||"Unsupport\
 ed media type",t)}},y=class extends r{static{p(this,"HttpUnprocessableEntityErro\
-r")}constructor(e,t){super(422,e||"Unprocessable entity",t)}},H=class extends r{static{
+r")}constructor(e,t){super(422,e||"Unprocessable entity",t)}},d=class extends r{static{
 p(this,"HttpInternalServerError")}constructor(e,t){super(500,e||"Internal server\
  error",t)}};0&&(module.exports={Http,HttpBadRequestError,HttpError,HttpForbiddenError,HttpInternalServerError,
 HttpNotFoundError,HttpUnauthorizedError,HttpUnprocessableEntityError,HttpUnsupportedMediaTypeError});

package/dist/main.d.ts

@@ -1,2 +1,3 @@
 export * from './services/contract';
 export * from './services/errors';
+export { Client, ClientRequest, ClientResponse } from './services/client';

package/dist/main.mjs

@@ -1,4 +1,4 @@
-var H=Object.defineProperty;var r=(s,e)=>H(s,"name",{value:e,configurable:!0});var d;(s=>{})(d||={});import{ServiceError as R}from"@ez4/common";var p=class extends R{constructor(t,m,y){super(m,y);this.status=t}static{r(this,
+var d=Object.defineProperty;var r=(s,e)=>d(s,"name",{value:e,configurable:!0});var H;(s=>{})(H||={});import{ServiceError as l}from"@ez4/common";var p=class extends l{constructor(t,x,y){super(x,y);this.status=t}static{r(this,
 "HttpError")}},o=class extends p{static{r(this,"HttpBadRequestError")}constructor(e,t){
 super(400,e||"Bad request",t)}},n=class extends p{static{r(this,"HttpUnauthorize\
 dError")}constructor(e,t){super(401,e||"Unauthorized",t)}},c=class extends p{static{
@@ -6,9 +6,9 @@ r(this,"HttpForbiddenError")}constructor(e,t){super(403,e||"Forbidden",t)}},u=cl
 r(this,"HttpNotFoundError")}constructor(e,t){super(404,e||"Not found",t)}},i=class extends p{static{
 r(this,"HttpUnsupportedMediaTypeError")}constructor(e,t){super(415,e||"Unsupport\
 ed media type",t)}},a=class extends p{static{r(this,"HttpUnprocessableEntityErro\
-r")}constructor(e,t){super(422,e||"Unprocessable entity",t)}},x=class extends p{static{
+r")}constructor(e,t){super(422,e||"Unprocessable entity",t)}},m=class extends p{static{
 r(this,"HttpInternalServerError")}constructor(e,t){super(500,e||"Internal server\
- error",t)}};export{d as Http,o as HttpBadRequestError,p as HttpError,c as HttpForbiddenError,
-x as HttpInternalServerError,u as HttpNotFoundError,n as HttpUnauthorizedError,a as HttpUnprocessableEntityError,
+ error",t)}};export{H as Http,o as HttpBadRequestError,p as HttpError,c as HttpForbiddenError,
+m as HttpInternalServerError,u as HttpNotFoundError,n as HttpUnauthorizedError,a as HttpUnprocessableEntityError,
 i as HttpUnsupportedMediaTypeError};
 //# sourceMappingURL=main.mjs.map

package/dist/metadata/access.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpAccess } from '../types/common';
-export declare const getHttpAccess: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpAccess | null;
+export declare const getHttpAccess: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpAccess | undefined;

package/dist/metadata/authorizer.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpAuthorizer } from '../types/common';
-export declare const getHttpAuthorizer: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpAuthorizer | null;
+export declare const getHttpAuthorizer: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpAuthorizer | undefined;

package/dist/metadata/body.d.ts

@@ -1,5 +1,5 @@
 import type { AllType, SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
 import type { ArraySchema, ObjectSchema, UnionSchema } from '@ez4/schema/library';
 type TypeParent = TypeObject | TypeModel | TypeIntersection;
-export declare const getHttpBody: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => ObjectSchema | UnionSchema | ArraySchema | import("@ez4/schema").BooleanSchema | import("@ez4/schema").NumberSchema | import("@ez4/schema").StringSchema | null;
+export declare const getHttpBody: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => ObjectSchema | UnionSchema | ArraySchema | import("@ez4/schema").BooleanSchema | import("@ez4/schema").NumberSchema | import("@ez4/schema").StringSchema | undefined;
 export {};

package/dist/metadata/cache.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpCache } from '../types/common';
-export declare const getHttpCache: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpCache | null;
+export declare const getHttpCache: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpCache | undefined;

package/dist/metadata/cors.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpCors } from '../types/common';
-export declare const getHttpCors: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpCors | null;
+export declare const getHttpCors: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpCors | undefined;

package/dist/metadata/defaults.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpDefaults } from '../types/common';
-export declare const getHttpDefaults: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpDefaults | null;
+export declare const getHttpDefaults: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpDefaults | undefined;

package/dist/metadata/errors.d.ts

@@ -1,4 +1,4 @@
 import type { AllType, ModelProperty, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpErrors } from '../types/common';
-export declare const getHttpErrors: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpErrors | null;
+export declare const getHttpErrors: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpErrors | undefined;
 export declare const getErrorClasses: (member: ModelProperty, errorCode: number, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpErrors;

package/dist/metadata/handler.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpHandler } from '../types/common';
-export declare const getHttpHandler: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpHandler | null;
+export declare const getHttpHandler: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[], external: boolean) => HttpHandler | undefined;

package/dist/metadata/headers.d.ts

@@ -1,4 +1,4 @@
 import type { AllType, SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
 type TypeParent = TypeObject | TypeModel | TypeIntersection;
-export declare const getHttpHeaders: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | null;
+export declare const getHttpHeaders: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | undefined;
 export {};

package/dist/metadata/identity.d.ts

@@ -1,5 +1,5 @@
 import type { AllType, SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
 import type { ObjectSchema, UnionSchema } from '@ez4/schema/library';
 type TypeParent = TypeObject | TypeModel | TypeIntersection;
-export declare const getHttpIdentity: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => ObjectSchema | UnionSchema | null;
+export declare const getHttpIdentity: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => ObjectSchema | UnionSchema | undefined;
 export {};

package/dist/metadata/import.d.ts

@@ -0,0 +1,6 @@
+import type { SourceMap } from '@ez4/reflection';
+import type { HttpImport } from '../types/import';
+export declare const getHttpImports: (reflection: SourceMap) => {
+    services: Record<string, HttpImport>;
+    errors: Error[];
+};

package/dist/metadata/parameters.d.ts

@@ -1,4 +1,4 @@
 import type { AllType, SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
 type TypeParent = TypeObject | TypeModel | TypeIntersection;
-export declare const getHttpParameters: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | null;
+export declare const getHttpParameters: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | undefined;
 export {};

package/dist/metadata/provider.d.ts

@@ -1,3 +1,3 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpProvider } from '../types/common';
-export declare const getHttpProvider: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpProvider | null;
+export declare const getHttpProvider: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpProvider | undefined;

package/dist/metadata/query.d.ts

@@ -1,4 +1,4 @@
 import type { AllType, SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
 type TypeParent = TypeObject | TypeModel | TypeIntersection;
-export declare const getHttpQuery: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | null;
+export declare const getHttpQuery: (type: AllType, parent: TypeParent, reflection: SourceMap, errorList: Error[]) => import("@ez4/schema").ObjectSchema | undefined;
 export {};

package/dist/metadata/request.d.ts

@@ -1,4 +1,4 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpAuthRequest, HttpRequest } from '../types/common';
-export declare const getHttpAuthRequest: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => (HttpAuthRequest & HttpRequest) | null;
-export declare const getHttpHandlerRequest: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => (HttpAuthRequest & HttpRequest) | null;
+export declare const getHttpAuthRequest: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => (HttpAuthRequest & HttpRequest) | undefined;
+export declare const getHttpHandlerRequest: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => (HttpAuthRequest & HttpRequest) | undefined;

package/dist/metadata/response.d.ts

@@ -1,5 +1,4 @@
 import type { AllType, SourceMap, TypeModel } from '@ez4/reflection';
-import type { Incomplete } from '@ez4/utils';
 import type { HttpAuthResponse, HttpResponse } from '../types/common';
-export declare const getHttpAuthResponse: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => Incomplete<HttpAuthResponse & HttpResponse> | null;
-export declare const getHttpHandlerResponse: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpResponse | null;
+export declare const getHttpAuthResponse: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpAuthResponse | undefined;
+export declare const getHttpHandlerResponse: (type: AllType, parent: TypeModel, reflection: SourceMap, errorList: Error[]) => HttpResponse | undefined;

package/dist/metadata/route.d.ts

@@ -1,3 +1,4 @@
 import type { ModelProperty, SourceMap, TypeModel } from '@ez4/reflection';
 import type { HttpRoute } from '../types/common';
-export declare const getHttpRoutes: (parent: TypeModel, member: ModelProperty, reflection: SourceMap, errorList: Error[]) => HttpRoute[];
+export declare const getHttpLocalRoutes: (parent: TypeModel, member: ModelProperty, reflection: SourceMap, errorList: Error[]) => HttpRoute[] | undefined;
+export declare const getHttpRemoteRoutes: (parent: TypeModel, member: ModelProperty, reflection: SourceMap, errorList: Error[]) => HttpRoute[] | undefined;

package/dist/metadata/schema.d.ts

@@ -1,2 +1,2 @@
 import type { SourceMap, TypeIntersection, TypeModel, TypeObject } from '@ez4/reflection';
-export declare const getSchemaFromType: (type: TypeObject | TypeModel | TypeIntersection, reflection: SourceMap) => import("@ez4/schema").ObjectSchema | null;
+export declare const getSchemaFromType: (type: TypeObject | TypeModel | TypeIntersection, reflection: SourceMap) => import("@ez4/schema").ObjectSchema | undefined;

package/dist/metadata/utils.d.ts

@@ -2,6 +2,7 @@ import type { AllType, TypeCallback, TypeClass, TypeFunction, TypeModel } from '
 import type { HttpPath } from '../types/common';
 export declare const isHttpPath: (path: string) => path is HttpPath;
 export declare const isHttpService: (type: AllType) => type is TypeClass;
+export declare const isHttpImport: (type: AllType) => type is TypeClass;
 export declare const isHttpProvider: (type: AllType) => type is TypeModel;
 export declare const isHttpRoute: (type: AllType) => type is TypeModel;
 export declare const isHttpAuthorizerRequest: (type: TypeModel) => boolean;

package/dist/services/client.d.ts

@@ -0,0 +1,73 @@
+import type { AnyObject, Prettify } from '@ez4/utils';
+import type { Http } from './contract';
+/**
+ * HTTP client.
+ */
+export type Client<T extends Http.Service> = {
+    [P in ClientRoutes<T> as P extends {
+        name: infer N;
+    } ? (N extends string ? N : never) : never]: P extends {
+        handler: infer H;
+        authorizer: infer A;
+    } ? AuthorizedClientOperation<H, A> : P extends {
+        handler: infer H;
+    } ? ClientOperation<H> : never;
+};
+/**
+ * Default HTTP client request.
+ */
+export type ClientRequest = RequestOptions & {
+    headers?: Record<string, string>;
+    parameters?: Record<string, string>;
+    query?: Record<string, string>;
+    body?: string | AnyObject;
+};
+/**
+ * Default HTTP response.
+ */
+export type ClientResponse = {
+    status: number;
+    body?: unknown;
+};
+/**
+ * Given a HTTP service `T`, it produces a union type containing all gateway routes.
+ */
+type ClientRoutes<T extends Http.Service> = T extends {
+    routes: (infer R)[];
+} ? R : never;
+/**
+ * Given a handler type `T`, it produces a callback to invoke the operation.
+ */
+type ClientOperation<T> = T extends (...args: any) => any ? (request: OperationRequest<T>) => OperationResponse<T> : never;
+/**
+ * Given a handler type `T`, it produces a request type.
+ */
+type OperationRequest<T extends (...args: any) => any> = Prettify<RequestSchema<Parameters<T>[0]> & RequestOptions>;
+/**
+ * Given a handler type `T`, it produces a callback to invoke the operation.
+ */
+type AuthorizedClientOperation<T, U> = T extends (...args: any) => any ? U extends (...args: any) => any ? (request: AuthorizedOperationRequest<T, U>) => OperationResponse<T> : never : never;
+/**
+ * Given a handler type `T`, it produces a request type.
+ */
+type AuthorizedOperationRequest<T extends (...args: any) => any, U extends (...args: any) => any> = Prettify<RequestSchema<Parameters<T>[0]> & RequestSchema<Parameters<U>[0]> & RequestOptions>;
+/**
+ * Given a handler type `T`, it produces a response type.
+ */
+type OperationResponse<T extends (...args: any) => any> = Promise<Awaited<ReturnType<T>>>;
+/**
+ * Given a request type `T`, it produces a request schema containing only valid parameters.
+ */
+type RequestSchema<T> = T extends AnyObject ? {
+    [P in keyof T as P extends 'parameters' | 'headers' | 'query' | 'body' ? P : never]: T[P];
+} : never;
+/**
+ * All request options.
+ */
+type RequestOptions = {
+    /**
+     * Maximum wait time for a response.
+     */
+    timeout?: number;
+};
+export {};

package/dist/services/common.d.ts

@@ -1,5 +1,6 @@
-import type { Service } from '@ez4/common';
+import type { LinkedVariables } from '@ez4/project/library';
 import type { NamingStyle } from '@ez4/schema';
+import type { Service } from '@ez4/common';
 import type { Http } from './contract';
 /**
  * Contract for HTTP preferences.
@@ -167,6 +168,10 @@ export interface HttpResponse {
     body?: HttpJsonBody | HttpRawBody;
 }
 export interface HttpProvider {
+    /**
+     * Variables associated to the provider.
+     */
+    variables?: LinkedVariables;
     /**
      * All services associated to the provider.
      */

package/dist/services/contract.d.ts

@@ -2,6 +2,7 @@ import type { Service as CommonService } from '@ez4/common';
 import type { LinkedVariables } from '@ez4/project/library';
 import type { HttpPath } from '../types/common';
 import type { HttpSuccessStatuses, HttpSuccessEmptyResponse, HttpSuccessResponse } from './utils';
+import type { Client } from './client';
 import type { HttpHeaders, HttpIdentity, HttpPathParameters, HttpQueryStrings, HttpJsonBody, HttpRawBody, HttpPreferences, HttpAuthRequest, HttpAuthResponse, HttpRequest, HttpResponse, HttpErrors, HttpProvider, HttpIncoming, HttpListener, HttpAuthorizer, HttpHandler, HttpCache, HttpAccess, HttpCors } from './common';
 /**
  * Provide all contracts for a self-managed HTTP service.
@@ -34,6 +35,10 @@ export declare namespace Http {
      * HTTP route.
      */
     interface Route<T extends Request = Request, U extends AuthRequest = AuthRequest> {
+        /**
+         * Route name.
+         */
+        name?: string;
         /**
          * Route path.
          */
@@ -139,6 +144,43 @@ export declare namespace Http {
         /**
          * Service client.
          */
-        client: never;
+        client: Client<Service>;
+    }
+    /**
+     * Imported HTTP service.
+     */
+    abstract class Import<T extends Service> implements CommonService.Provider {
+        /**
+         * Name of the imported project defined in the project options file.
+         */
+        abstract project: string;
+        /**
+         * Imported service reference.
+         */
+        reference: T;
+        /**
+         * All routes attached to the imported service (do not replace).
+         */
+        routes: T['routes'];
+        /**
+         * Display name for the service imported service (do not replace).
+         */
+        name: T['name'];
+        /**
+         * All default configurations attached to the imported service (do not replace).
+         */
+        defaults: T['defaults'];
+        /**
+         * Imported service client (do not replace).
+         */
+        client: Client<T>;
+        /**
+         * Variables are not allowed.
+         */
+        variables: never;
+        /**
+         * Services are not allowed.
+         */
+        service: never;
     }
 }

package/dist/triggers/service.d.ts

@@ -1,2 +1,3 @@
 import type { TypeClass } from '@ez4/reflection';
 export declare const getLinkedService: (declaration: TypeClass) => string | null;
+export declare const getLinkedImport: (declaration: TypeClass) => string | null;

package/dist/types/common.d.ts

@@ -7,24 +7,24 @@ export type HttpPreferences = {
     namingStyle?: NamingStyle;
 };
 export type HttpAuthRequest = {
-    headers?: ObjectSchema | null;
-    parameters?: ObjectSchema | null;
-    query?: ObjectSchema | null;
+    headers?: ObjectSchema;
+    parameters?: ObjectSchema;
+    query?: ObjectSchema;
 };
 export type HttpAuthResponse = {
-    identity?: ObjectSchema | UnionSchema | null;
+    identity?: ObjectSchema | UnionSchema;
 };
 export type HttpRequest = {
-    identity?: ObjectSchema | UnionSchema | null;
-    headers?: ObjectSchema | null;
-    parameters?: ObjectSchema | null;
-    query?: ObjectSchema | null;
-    body?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema | null;
+    identity?: ObjectSchema | UnionSchema;
+    headers?: ObjectSchema;
+    parameters?: ObjectSchema;
+    query?: ObjectSchema;
+    body?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema;
 };
 export type HttpResponse = {
     status: number | number[];
-    headers?: ObjectSchema | null;
-    body?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema | null;
+    headers?: ObjectSchema;
+    body?: ObjectSchema | UnionSchema | ArraySchema | ScalarSchema;
 };
 export type HttpHandler = {
     name: string;
@@ -47,25 +47,26 @@ export type HttpErrors = {
     [name: string]: number;
 };
 export type HttpRoute = {
+    name?: string;
     path: HttpPath;
     handler: HttpHandler;
-    listener?: ServiceListener | null;
-    authorizer?: HttpAuthorizer | null;
-    variables?: LinkedVariables | null;
-    httpErrors?: HttpErrors | null;
+    listener?: ServiceListener;
+    authorizer?: HttpAuthorizer;
+    variables?: LinkedVariables;
+    httpErrors?: HttpErrors;
     preferences?: HttpPreferences;
-    logRetention?: number | null;
-    timeout?: number | null;
-    memory?: number | null;
-    cors?: boolean | null;
+    logRetention?: number;
+    timeout?: number;
+    memory?: number;
+    cors?: boolean;
 };
 export type HttpDefaults = {
-    listener?: ServiceListener | null;
-    httpErrors?: HttpErrors | null;
+    listener?: ServiceListener;
+    httpErrors?: HttpErrors;
     preferences?: HttpPreferences;
-    logRetention?: number | null;
-    timeout?: number | null;
-    memory?: number | null;
+    logRetention?: number;
+    timeout?: number;
+    memory?: number;
 };
 export type HttpCache = {
     authorizerTTL?: number;
@@ -82,5 +83,6 @@ export type HttpCors = {
     maxAge?: number;
 };
 export type HttpProvider = {
+    variables?: LinkedVariables;
     services?: LinkedServices;
 };

package/dist/types/import.d.ts

@@ -0,0 +1,13 @@
+import type { ServiceMetadata } from '@ez4/project/library';
+import type { HttpRoute, HttpDefaults } from './common';
+export declare const ImportType = "@ez4/import:http";
+export type HttpImport = ServiceMetadata & {
+    type: typeof ImportType;
+    reference: string;
+    project: string;
+    displayName?: string;
+    description?: string;
+    defaults?: HttpDefaults;
+    routes: HttpRoute[];
+};
+export declare const isHttpImport: (service: ServiceMetadata) => service is HttpImport;

package/dist/utils/body.d.ts

@@ -2,3 +2,7 @@ import type { AnySchema } from '@ez4/schema';
 import type { Http } from '../services/contract';
 export declare const getRequestBody: <T extends Http.JsonBody | Http.RawBody>(input: T | undefined, schema: AnySchema, preferences?: Http.Preferences | null) => Promise<T>;
 export declare const getResponseBody: (body: unknown, schema: AnySchema, preferences?: Http.Preferences) => unknown;
+export declare const prepareBodyRequest: (body: unknown) => {
+    body: string;
+    json: boolean;
+};

package/dist/utils/client.d.ts

@@ -0,0 +1,8 @@
+import { type AnySchema, type NamingStyle } from '@ez4/schema';
+import type { ClientRequest, ClientResponse } from '../services/client';
+export declare const getClientRequestUrl: (host: string, path: string, request: ClientRequest) => string;
+export type SendClientRequest = ClientRequest & {
+    responseSchema?: AnySchema;
+    namingStyle?: NamingStyle;
+};
+export declare const sendClientRequest: (url: string, method: string, request: SendClientRequest) => Promise<ClientResponse>;

package/dist/utils/errors.d.ts

@@ -1,4 +1,4 @@
-import type { HttpError } from '@ez4/gateway';
+import { HttpError } from '@ez4/gateway';
 /**
  * Get a JSON error response for the given HTTP error.
  *
@@ -11,3 +11,12 @@ export declare const getJsonError: ({ status, message, details }: HttpError) =>
         details: string[] | undefined;
     };
 };
+/**
+ * Get a exception based on the given HTTP status code.
+ *
+ * @param status HTTP status code.
+ * @param message Exception message.
+ * @param details Exception details.
+ * @returns Returns the corresponding exception.
+ */
+export declare const getHttpException: (status: number, message: string, details?: string[]) => HttpError;

package/dist/utils/headers.d.ts

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

package/dist/utils/identity.d.ts

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

package/dist/utils/parameters.d.ts

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

package/dist/utils/query.d.ts

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

package/dist/utils/request.d.ts

@@ -0,0 +1,6 @@
+import type { ClientRequest } from '../services/client';
+export declare const prepareRequestUrl: (host: string, path: string, request: ClientRequest) => string;
+export declare const sendClientRequest: (url: string, method: string, request: ClientRequest) => Promise<{
+    body?: any;
+    status: number;
+}>;

package/dist/utils.cjs

@@ -1,25 +1,48 @@
-"use strict";var d=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var n=(e,t)=>d(e,"name",{value:t,configurable:!0});var b=(e,t)=>{for(var r in t)d(e,r,{get:t[r],enumerable:!0})},z=(e,t,r,o)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let a of C(t))!P.call(e,a)&&a!==r&&
-d(e,a,{get:()=>t[a],enumerable:!(o=q(t,a))||o.enumerable});return e};var M=e=>z(d({},"__esModule",{value:!0}),e);var A={};b(A,{getHeaders:()=>O,getIdentity:()=>R,getJsonError:()=>$,getPathParameters:()=>B,
-getQueryStrings:()=>j,getRequestBody:()=>U,getResponseBody:()=>V});module.exports=
-M(A);var l=require("@ez4/transform"),s=require("@ez4/validator"),H=require("@ez4/gateway");var B=n(async(e,t)=>{let r=(0,l.transform)(e,t,(0,l.createTransformContext)({convert:!1})),
-o=await(0,s.validate)(r,t,(0,s.createValidatorContext)({property:"$path"}));if(o.
-length){let a=(0,s.getUniqueErrorMessages)(o);throw new H.HttpBadRequestError("M\
-alformed path parameters.",a)}return r},"getPathParameters");var g=require("@ez4/transform"),m=require("@ez4/validator"),w=require("@ez4/gateway");var j=n(async(e,t,r)=>{let o=r?.namingStyle,a=(0,g.createTransformContext)({convert:!0,
-inputStyle:o}),y=(0,g.transform)(e,t,a),x=(0,m.createValidatorContext)({property:"\
-$query",pathStyle:o}),u=await(0,m.validate)(y,t,x);if(u.length){let T=(0,m.getUniqueErrorMessages)(
-u);throw new w.HttpBadRequestError("Malformed query strings.",T)}return y},"getQ\
-ueryStrings");var h=require("@ez4/transform"),p=require("@ez4/validator"),S=require("@ez4/gateway");var O=n(async(e,t)=>{let r=(0,h.transform)(e,t,(0,h.createTransformContext)({convert:!1})),
-o=await(0,p.validate)(r,t,(0,p.createValidatorContext)({property:"$header"}));if(o.
-length){let a=(0,p.getUniqueErrorMessages)(o);throw new S.HttpBadRequestError("M\
-alformed request headers.",a)}return r},"getHeaders");var i=require("@ez4/validator"),v=require("@ez4/gateway");var R=n(async(e,t)=>{let r=await(0,i.validate)(e,t,(0,i.createValidatorContext)(
-{property:"$identity"}));if(r.length){let o=(0,i.getUniqueErrorMessages)(r);throw new v.HttpBadRequestError(
-"Malformed authorizer identity.",o)}return e},"getIdentity");var c=require("@ez4/transform"),f=require("@ez4/validator"),E=require("@ez4/gateway");var U=n(async(e,t,r)=>{let o=r?.namingStyle,a=(0,f.createValidatorContext)({property:"\
-$body",inputStyle:o}),y=await(0,f.validate)(e,t,a);if(y.length){let T=(0,f.getUniqueErrorMessages)(
-y);throw new E.HttpBadRequestError("Malformed body payload.",T)}let x=(0,c.createTransformContext)(
-{convert:!1,inputStyle:o});return(0,c.transform)(e,t,x)},"getRequestBody"),V=n((e,t,r)=>{
-let o=r?.namingStyle,a=(0,c.createTransformContext)({convert:!1,outputStyle:o});
-return(0,c.transform)(e,t,a)},"getResponseBody");var $=n(({status:e,message:t,details:r})=>({status:e,body:{message:t,details:r}}),
-"getJsonError");0&&(module.exports={getHeaders,getIdentity,getJsonError,getPathParameters,getQueryStrings,
-getRequestBody,getResponseBody});
+"use strict";var x=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var Q=Object.getOwnPropertyNames;var V=Object.prototype.hasOwnProperty;var s=(e,t)=>x(e,"name",{value:t,configurable:!0});var J=(e,t)=>{for(var r in t)x(e,r,{get:t[r],enumerable:!0})},k=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let n of Q(t))!V.call(e,n)&&n!==r&&
+x(e,n,{get:()=>t[n],enumerable:!(o=N(t,n))||o.enumerable});return e};var F=e=>k(x({},"__esModule",{value:!0}),e);var et={};J(et,{getClientRequestUrl:()=>W,getHeaders:()=>Z,getHttpException:()=>C,
+getIdentity:()=>tt,getJsonError:()=>D,getPathParameters:()=>_,getQueryStrings:()=>G,
+getRequestBody:()=>K,getResponseBody:()=>L,prepareBodyRequest:()=>E,preparePathParameters:()=>q,
+prepareQueryStrings:()=>R,sendClientRequest:()=>X});module.exports=F(et);var O=require("@ez4/schema"),H=require("@ez4/transform");var a=require("@ez4/gateway");var D=s(({status:e,message:t,details:r})=>({status:e,body:{message:t,details:r}}),
+"getJsonError"),C=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 S=require("@ez4/transform"),f=require("@ez4/validator"),j=require("@ez4/gateway");var _=s(async(e,t)=>{let r=(0,S.transform)(e,t,(0,S.createTransformContext)({convert:!1})),
+o=await(0,f.validate)(r,t,(0,f.createValidatorContext)({property:"$path"}));if(o.
+length){let n=(0,f.getUniqueErrorMessages)(o);throw new j.HttpBadRequestError("M\
+alformed path parameters.",n)}return r},"getPathParameters"),q=s((e,t)=>e.replaceAll(
+/\{(\w+)\}/g,(r,o)=>o in t?`${t[o]}`:`{${o}}`),"preparePathParameters");var w=require("@ez4/transform"),u=require("@ez4/validator"),U=require("@ez4/gateway"),
+$=require("@ez4/utils");var G=s(async(e,t,r)=>{let o=r?.namingStyle,n=(0,w.createTransformContext)({convert:!0,
+inputStyle:o}),i=(0,w.transform)(e,t,n),c=(0,u.createValidatorContext)({property:"\
+$query",pathStyle:o}),p=await(0,u.validate)(i,t,c);if(p.length){let m=(0,u.getUniqueErrorMessages)(
+p);throw new U.HttpBadRequestError("Malformed query strings.",m)}return i},"getQ\
+ueryStrings"),R=s(e=>{let t=[];for(let r in e){let o=e[r];if(!(0,$.isNullish)(o)){
+if(o instanceof Date){t.push(`${r}=${encodeURIComponent(o.toISOString())}`);continue}
+if(o instanceof Array){t.push(`${r}=${encodeURIComponent(o.join(","))}`);continue}
+t.push(`${r}=${encodeURIComponent(`${o}`)}`)}}if(t.length)return t.join("&")},"p\
+repareQueryStrings");var y=require("@ez4/transform"),d=require("@ez4/validator"),B=require("@ez4/gateway"),
+M=require("@ez4/utils");var K=s(async(e,t,r)=>{let o=r?.namingStyle,n=(0,d.createValidatorContext)({property:"\
+$body",inputStyle:o}),i=await(0,d.validate)(e,t,n);if(i.length){let m=(0,d.getUniqueErrorMessages)(
+i);throw new B.HttpBadRequestError("Malformed body payload.",m)}let c=(0,y.createTransformContext)(
+{convert:!1,inputStyle:o});return(0,y.transform)(e,t,c)},"getRequestBody"),L=s((e,t,r)=>{
+let o=r?.namingStyle,n=(0,y.createTransformContext)({convert:!1,outputStyle:o});
+return(0,y.transform)(e,t,n)},"getResponseBody"),E=s(e=>(0,M.isAnyString)(e)?{json:!1,
+body:e}:{body:JSON.stringify(e),json:!0},"prepareBodyRequest");var W=s((e,t,r)=>{let{parameters:o,query:n}=r,i=o?q(t,o):t,c=n&&R(n),p=[e];return i&&
+p.push(i),c&&p.push("?",c),p.join("")},"getClientRequestUrl"),X=s(async(e,t,r)=>{
+let{headers:o,body:n,responseSchema:i,namingStyle:c,timeout:p=20}=r,m=n?E(n):void 0,
+v=new AbortController,I=setTimeout(()=>v?.abort("Request timed out"),p),h=await fetch(
+e,{signal:v?.signal,body:m?.body,method:t,headers:{...o,...m?.json&&{"content-ty\
+pe":"application/json"}}});if(clearTimeout(I),!h.ok){let P=await h.json();throw C(
+h.status,P.message,P.details)}let b=await h.text();return{status:h.status,...b&&
+{body:Y(b,i,c)}}},"sendClientRequest"),Y=s((e,t,r)=>{if(!t||(0,O.isScalarSchema)(
+t))return e;let o=JSON.parse(e),n=(0,H.createTransformContext)({inputStyle:r,convert:!1});
+return(0,H.transform)(o,t,n)},"getResponseBody");var T=require("@ez4/transform"),l=require("@ez4/validator"),A=require("@ez4/gateway");var Z=s(async(e,t)=>{let r=(0,T.transform)(e,t,(0,T.createTransformContext)({convert:!1})),
+o=await(0,l.validate)(r,t,(0,l.createValidatorContext)({property:"$header"}));if(o.
+length){let n=(0,l.getUniqueErrorMessages)(o);throw new A.HttpBadRequestError("M\
+alformed request headers.",n)}return r},"getHeaders");var g=require("@ez4/validator"),z=require("@ez4/gateway");var tt=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 z.HttpBadRequestError(
+"Malformed authorizer identity.",o)}return e},"getIdentity");0&&(module.exports={getClientRequestUrl,getHeaders,getHttpException,getIdentity,
+getJsonError,getPathParameters,getQueryStrings,getRequestBody,getResponseBody,prepareBodyRequest,
+preparePathParameters,prepareQueryStrings,sendClientRequest});
 //# sourceMappingURL=utils.cjs.map