@grest-ts/http 0.0.5

package/dist/src/schema/GGHttpSchema.d.ts

@@ -0,0 +1,68 @@
+import { ERROR, ERROR_JSON, GGContractApiDefinition, GGContractClass, GGContractMethod, OK } from "@grest-ts/schema";
+import type { HttpMethod } from "@grest-ts/common";
+import type http from "http";
+import type { GGHttpServerMiddleware } from "../server/GGHttpSchema.startServer";
+export declare class GGHttpSchema<TContract extends GGContractApiDefinition, TContext> {
+    readonly name: string;
+    readonly pathPrefix: string;
+    readonly apiMiddlewares: readonly GGHttpTransportMiddleware[];
+    readonly codec: Record<keyof TContract, GGHttpCodec>;
+    readonly contract: GGContractClass<TContract> | null;
+    constructor(pathPrefix: string, contract: GGContractClass<TContract>, wireCodec: Record<keyof TContract, GGHttpCodec>, middlewares?: readonly GGHttpTransportMiddleware[]);
+}
+export interface ClientHttpRouteToRpcTransformClientConfig {
+    pathPrefix: string;
+    contract: GGContractMethod;
+    middlewares: readonly GGHttpTransportMiddleware[];
+}
+export interface ClientHttpRouteToRpcTransformClientCodec {
+    createRequest: (data: unknown) => GGHttpFetchRequest | Promise<GGHttpFetchRequest>;
+    parseResponse: (response: Response) => Promise<OK<unknown> | ERROR_JSON<string, unknown>>;
+}
+export interface GGHttpFetchRequest {
+    url: string;
+    method: HttpMethod;
+    headers: Record<string, string>;
+    body: string | FormData | undefined;
+}
+export interface ClientHttpRouteToRpcTransformServerConfig {
+    contract: GGContractMethod;
+    apiMiddlewares: readonly GGHttpTransportMiddleware[];
+    serverMiddlewares: readonly GGHttpServerMiddleware[];
+}
+export interface ClientHttpRouteToRpcTransformServerCodec {
+    parseRequest: (req: http.IncomingMessage) => Promise<unknown>;
+    sendResponse: (res: http.ServerResponse, rpcResult: ERROR<string, unknown> | OK<unknown>) => Promise<void>;
+}
+export interface GGHttpCodec {
+    readonly method: HttpMethod;
+    readonly path: string;
+    createForClient(config: ClientHttpRouteToRpcTransformClientConfig): ClientHttpRouteToRpcTransformClientCodec;
+    createForServer(config: ClientHttpRouteToRpcTransformServerConfig): ClientHttpRouteToRpcTransformServerCodec;
+}
+export interface GGHttpTransportMiddleware {
+    /**
+     * Client-side: modify outgoing request (add headers, etc.)
+     */
+    updateRequest?(req: GGHttpRequest): void;
+    /**
+     * Server-side: parse incoming request (extract context from headers, etc.)
+     */
+    parseRequest?(req: GGHttpRequest): void;
+    /**
+     * Server-side: modify outgoing response
+     */
+    updateResponse?(res: GGHttpResponse): void;
+    /**
+     * Client-side: parse incoming response
+     */
+    parseResponse?(res: GGHttpResponse): void;
+}
+export interface GGHttpRequest {
+    headers?: Record<string, string | string[]>;
+    queryArgs?: Record<string, string | string[]>;
+}
+export interface GGHttpResponse {
+    headers: Record<string, string | string[]>;
+}
+//# sourceMappingURL=GGHttpSchema.d.ts.map

package/dist/src/schema/GGHttpSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpSchema.d.ts","sourceRoot":"","sources":["../../../src/schema/GGHttpSchema.ts"],"names":[],"mappings":"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"}

package/dist/src/schema/GGHttpSchema.js

@@ -0,0 +1,18 @@
+export class GGHttpSchema {
+    name;
+    pathPrefix;
+    apiMiddlewares;
+    codec;
+    contract = null;
+    constructor(pathPrefix, contract, wireCodec, middlewares = []) {
+        this.name = contract.name;
+        this.pathPrefix = pathPrefix;
+        this.apiMiddlewares = middlewares;
+        this.codec = wireCodec;
+        this.contract = contract;
+        Object.freeze(this.apiMiddlewares);
+        Object.freeze(this.codec);
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=GGHttpSchema.js.map

package/dist/src/schema/GGHttpSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpSchema.js","sourceRoot":"","sources":["../../../src/schema/GGHttpSchema.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IAEL,IAAI,CAAQ;IACZ,UAAU,CAAQ;IAClB,cAAc,CAAsC;IACpD,KAAK,CAAsC;IAC3C,QAAQ,GAAsC,IAAI,CAAA;IAElE,YACI,UAAkB,EAClB,QAAoC,EACpC,SAA+C,EAC/C,cAAoD,EAAE;QAEtD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,cAAc,GAAG,WAAW,CAAA;QACjC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QACtB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACzB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC;CACJ"}

package/dist/src/schema/httpSchema.d.ts

@@ -0,0 +1,43 @@
+import { GGHttpCodec, GGHttpSchema } from "./GGHttpSchema";
+import { GGHttpTransportMiddleware } from "./GGHttpSchema";
+import { GGContractApiDefinition, GGContractClass } from "@grest-ts/schema";
+import { GGContextKey } from "@grest-ts/context";
+/**
+ * Create an HTTP API schema builder from a contract.
+ *
+ * @example
+ * export const MyApiContract = defineApi("MyApi", () => ({
+ *     list: {
+ *         success: IsArray(IsItem),
+ *         errors: [NOT_AUTHORIZED, SERVER_ERROR]
+ *     },
+ *     create: {
+ *         input: IsCreateRequest,
+ *         success: IsItem,
+ *         errors: [NOT_AUTHORIZED, VALIDATION_ERROR, SERVER_ERROR]
+ *     }
+ * }))
+ *
+ * export const MyApi = httpApi(MyApiContract)
+ *     .pathPrefix("api/items")
+ *     .use(AuthMiddleware)
+ *     .routes({
+ *         list: GGRpc.GET("list"),
+ *         create: GGRpc.POST("create")
+ *     })
+ */
+export declare function httpSchema<TContract extends GGContractApiDefinition>(contract: GGContractClass<TContract>): GGHttpSchemaBuilder<TContract>;
+declare class GGHttpSchemaBuilder<TContract extends GGContractApiDefinition, TContext = undefined> {
+    private readonly _contract;
+    private _pathPrefix;
+    private _middlewares;
+    constructor(contract: GGContractClass<TContract>);
+    pathPrefix(prefix: string): this;
+    use<M extends GGHttpTransportMiddleware>(middleware: M): GGHttpSchemaBuilder<TContract, TContext | M>;
+    useHeader<Input>(contextKey: GGContextKey<Input>): GGHttpSchemaBuilder<TContract, TContext | Input>;
+    routes(mapping: {
+        [K in keyof TContract]: GGHttpCodec;
+    }): GGHttpSchema<TContract, TContext>;
+}
+export {};
+//# sourceMappingURL=httpSchema.d.ts.map

package/dist/src/schema/httpSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSchema.d.ts","sourceRoot":"","sources":["../../../src/schema/httpSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAgB,yBAAyB,EAAC,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAC,uBAAuB,EAAE,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,SAAS,SAAS,uBAAuB,EAChE,QAAQ,EAAE,eAAe,CAAC,SAAS,CAAC,GACrC,mBAAmB,CAAC,SAAS,CAAC,CAEhC;AAED,cAAM,mBAAmB,CAAC,SAAS,SAAS,uBAAuB,EAAE,QAAQ,GAAG,SAAS;IAErF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,YAAY,CAAkC;gBAE1C,QAAQ,EAAE,eAAe,CAAC,SAAS,CAAC;IAIhD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC,GAAG,CAAC,CAAC,SAAS,yBAAyB,EAAE,UAAU,EAAE,CAAC,GAAG,mBAAmB,CAAC,SAAS,EAAE,QAAQ,GAAG,CAAC,CAAC;IAKrG,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,mBAAmB,CAAC,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAuCnG,MAAM,CAAC,OAAO,EAAE;SAAG,CAAC,IAAI,MAAM,SAAS,GAAG,WAAW;KAAE,GAAG,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC;CAG9F"}

package/dist/src/schema/httpSchema.js

@@ -0,0 +1,85 @@
+import { GGHttpSchema } from "./GGHttpSchema.js";
+/**
+ * Create an HTTP API schema builder from a contract.
+ *
+ * @example
+ * export const MyApiContract = defineApi("MyApi", () => ({
+ *     list: {
+ *         success: IsArray(IsItem),
+ *         errors: [NOT_AUTHORIZED, SERVER_ERROR]
+ *     },
+ *     create: {
+ *         input: IsCreateRequest,
+ *         success: IsItem,
+ *         errors: [NOT_AUTHORIZED, VALIDATION_ERROR, SERVER_ERROR]
+ *     }
+ * }))
+ *
+ * export const MyApi = httpApi(MyApiContract)
+ *     .pathPrefix("api/items")
+ *     .use(AuthMiddleware)
+ *     .routes({
+ *         list: GGRpc.GET("list"),
+ *         create: GGRpc.POST("create")
+ *     })
+ */
+export function httpSchema(contract) {
+    return new GGHttpSchemaBuilder(contract);
+}
+class GGHttpSchemaBuilder {
+    _contract;
+    _pathPrefix = "";
+    _middlewares = [];
+    constructor(contract) {
+        this._contract = contract;
+    }
+    pathPrefix(prefix) {
+        this._pathPrefix = prefix;
+        return this;
+    }
+    use(middleware) {
+        this._middlewares.push(middleware);
+        return this;
+    }
+    useHeader(contextKey) {
+        const codec = contextKey.getCodec("http");
+        if (!codec) {
+            throw new Error(`Context key '${contextKey.name}' does not have an 'http-header' codec registered.`);
+        }
+        const middleware = {
+            updateRequest(req) {
+                // Client-side: context -> headers
+                const contextValue = contextKey.get();
+                if (contextValue !== undefined) {
+                    const result = codec.decode(contextValue);
+                    if (result.success) {
+                        Object.assign(req.headers, result.value);
+                    }
+                }
+                else {
+                    // Clear any default headers by decoding an empty context
+                    const emptyResult = codec.decode({});
+                    if (emptyResult.success) {
+                        for (const key of Object.keys(emptyResult.value)) {
+                            delete req.headers[key];
+                        }
+                    }
+                }
+            },
+            parseRequest(req) {
+                // Server-side: headers -> context
+                const headers = req.headers;
+                const result = codec.encode(headers);
+                if (result.success) {
+                    contextKey.set(result.value);
+                }
+            }
+        };
+        this._middlewares.push(middleware);
+        return this;
+    }
+    routes(mapping) {
+        return new GGHttpSchema(this._pathPrefix, this._contract, mapping, this._middlewares);
+    }
+}
+//# sourceMappingURL=httpSchema.js.map

package/dist/src/schema/httpSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpSchema.js","sourceRoot":"","sources":["../../../src/schema/httpSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,UAAU,CACtB,QAAoC;IAEpC,OAAO,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAA;AAC5C,CAAC;AAED,MAAM,mBAAmB;IAEJ,SAAS,CAA4B;IAC9C,WAAW,GAAW,EAAE,CAAA;IACxB,YAAY,GAAgC,EAAE,CAAA;IAEtD,YAAY,QAAoC;QAC5C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,UAAU,CAAC,MAAc;QACrB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAA;QACzB,OAAO,IAAI,CAAA;IACf,CAAC;IAED,GAAG,CAAsC,UAAa;QAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAClC,OAAO,IAA+D,CAAA;IAC1E,CAAC;IAED,SAAS,CAAQ,UAA+B;QAC5C,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,gBAAgB,UAAU,CAAC,IAAI,oDAAoD,CAAC,CAAC;QACzG,CAAC;QAED,MAAM,UAAU,GAA8B;YAC1C,aAAa,CAAC,GAAkB;gBAC5B,kCAAkC;gBAClC,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;gBACtC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBAC1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;wBACjB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC7C,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,yDAAyD;oBACzD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,EAAW,CAAC,CAAC;oBAC9C,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;wBACtB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAe,CAAC,EAAE,CAAC;4BACzD,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;wBAC5B,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YACD,YAAY,CAAC,GAAyB;gBAClC,kCAAkC;gBAClC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAiC,CAAC;gBACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACrC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACjB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACL,CAAC;SACJ,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnC,OAAO,IAAmE,CAAC;IAC/E,CAAC;IAED,MAAM,CAAC,OAAgD;QACnD,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IACzF,CAAC;CACJ"}

package/dist/src/server/GGHttp.d.ts

@@ -0,0 +1,12 @@
+import { GGHttpSchema } from "../schema/GGHttpSchema";
+import { GGContractApiDefinition, GGContractImplementation } from "@grest-ts/schema";
+import { GGHttpServerMiddleware } from "./GGHttpSchema.startServer";
+import { GGHttpServer } from "./GGHttpServer";
+export declare class GGHttp<TContext = undefined> {
+    private readonly httpServer;
+    private readonly middlewares;
+    constructor(httpServer: GGHttpServer);
+    use<M extends GGHttpServerMiddleware>(middleware: M): GGHttp<TContext | M>;
+    http<TContract extends GGContractApiDefinition, TSchemaContext>(schema: GGHttpSchema<TContract, TSchemaContext>, implementation: GGContractImplementation<TContract>): this;
+}
+//# sourceMappingURL=GGHttp.d.ts.map

package/dist/src/server/GGHttp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttp.d.ts","sourceRoot":"","sources":["../../../src/server/GGHttp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAC,uBAAuB,EAAE,wBAAwB,EAAC,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAE5C,qBAAa,MAAM,CAAC,QAAQ,GAAG,SAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;gBAEhD,UAAU,EAAE,YAAY;IAI7B,GAAG,CAAC,CAAC,SAAS,sBAAsB,EAAE,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;IAK1E,IAAI,CAAC,SAAS,SAAS,uBAAuB,EAAE,cAAc,EACjE,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,EAC/C,cAAc,EAAE,wBAAwB,CAAC,SAAS,CAAC,GACpD,IAAI;CAIV"}

package/dist/src/server/GGHttp.js

@@ -0,0 +1,16 @@
+export class GGHttp {
+    httpServer;
+    middlewares = [];
+    constructor(httpServer) {
+        this.httpServer = httpServer;
+    }
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    http(schema, implementation) {
+        schema.register(implementation, { http: this.httpServer, middlewares: this.middlewares });
+        return this;
+    }
+}
+//# sourceMappingURL=GGHttp.js.map

package/dist/src/server/GGHttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttp.js","sourceRoot":"","sources":["../../../src/server/GGHttp.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,MAAM;IAEE,UAAU,CAAc;IACxB,WAAW,GAA6B,EAAE,CAAC;IAE5D,YAAY,UAAwB;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IAEM,GAAG,CAAmC,UAAa;QACtD,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAW,CAAC;IACvB,CAAC;IAEM,IAAI,CACP,MAA+C,EAC/C,cAAmD;QAEnD,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAC,CAAC,CAAC;QACxF,OAAO,IAAW,CAAC;IACvB,CAAC;CACJ"}

package/dist/src/server/GGHttpMetrics.d.ts

@@ -0,0 +1,22 @@
+import { GGCounterKey, GGHistogramKey } from "@grest-ts/metrics";
+import { EXISTS, FORBIDDEN, NOT_AUTHORIZED, NOT_FOUND, OK, ROUTE_NOT_FOUND, SERVER_ERROR, VALIDATION_ERROR } from "@grest-ts/schema";
+/**
+ * Result type for HTTP operations.
+ * Known types listed for documentation, but accepts any string for custom error types.
+ */
+type ResultType = typeof OK.TYPE | typeof VALIDATION_ERROR.TYPE | typeof NOT_AUTHORIZED.TYPE | typeof FORBIDDEN.TYPE | typeof NOT_FOUND.TYPE | typeof ROUTE_NOT_FOUND.TYPE | typeof EXISTS.TYPE | typeof SERVER_ERROR.TYPE | string;
+export declare const GGHttpMetrics: import("@grest-ts/metrics").GGMetricsDefinition<{
+    requests: GGCounterKey<{
+        api: string;
+        method: string;
+        path: string;
+        result: ResultType;
+    }>;
+    requestDuration: GGHistogramKey<{
+        api: string;
+        method: string;
+        path: string;
+    }>;
+}>;
+export {};
+//# sourceMappingURL=GGHttpMetrics.d.ts.map

package/dist/src/server/GGHttpMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpMetrics.d.ts","sourceRoot":"","sources":["../../../src/server/GGHttpMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,cAAc,EAAY,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAC,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AAEnI;;;GAGG;AACH,KAAK,UAAU,GACT,OAAO,EAAE,CAAC,IAAI,GACd,OAAO,gBAAgB,CAAC,IAAI,GAC5B,OAAO,cAAc,CAAC,IAAI,GAC1B,OAAO,SAAS,CAAC,IAAI,GACrB,OAAO,SAAS,CAAC,IAAI,GACrB,OAAO,eAAe,CAAC,IAAI,GAC3B,OAAO,MAAM,CAAC,IAAI,GAClB,OAAO,YAAY,CAAC,IAAI,GACxB,MAAM,CAAC;AAEb,eAAO,MAAM,aAAa;;aACY,MAAM;gBAAU,MAAM;cAAQ,MAAM;gBAAU,UAAU;;;aAK/C,MAAM;gBAAU,MAAM;cAAQ,MAAM;;EAMhF,CAAC"}

package/dist/src/server/GGHttpMetrics.js

@@ -0,0 +1,15 @@
+import { GGCounterKey, GGHistogramKey, GGMetrics } from "@grest-ts/metrics";
+export const GGHttpMetrics = GGMetrics.define('/http/', () => ({
+    requests: new GGCounterKey('requests_total', {
+        help: 'Total HTTP requests after contract validation',
+        labelNames: ['api', 'method', 'path', 'result'],
+        groupBy: { labels: ["api", "method"], template: "{api}.{method}" }
+    }),
+    requestDuration: new GGHistogramKey('request_duration_ms', {
+        help: 'HTTP request duration in milliseconds',
+        labelNames: ['api', 'method', 'path'],
+        buckets: [5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000],
+        groupBy: { labels: ["api", "method"], template: "{api}.{method}" }
+    }),
+}));
+//# sourceMappingURL=GGHttpMetrics.js.map

package/dist/src/server/GGHttpMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpMetrics.js","sourceRoot":"","sources":["../../../src/server/GGHttpMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,cAAc,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAkB1E,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3D,QAAQ,EAAE,IAAI,YAAY,CAAoE,gBAAgB,EAAE;QAC5G,IAAI,EAAE,+CAA+C;QACrD,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;QAC/C,OAAO,EAAE,EAAC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAC;KACnE,CAAC;IACF,eAAe,EAAE,IAAI,cAAc,CAAgD,qBAAqB,EAAE;QACtG,IAAI,EAAE,uCAAuC;QAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;QACrC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACzD,OAAO,EAAE,EAAC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAC;KACnE,CAAC;CACL,CAAC,CAAC,CAAC"}

package/dist/src/server/GGHttpSchema.startServer.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server extension for HttpApiSchema - adds register method.
+ * This file should only be imported in server (Node.js) context.
+ */
+import { GGContractApiDefinition, GGContractImplementation } from "@grest-ts/schema";
+import { GGHttpServer } from "./GGHttpServer";
+export interface GGHttpSchemaConfig {
+    /**
+     * The HTTP request handler to register with.
+     */
+    http?: GGHttpServer;
+    /**
+     * Additional middlewares to apply to all routes.
+     */
+    middlewares?: GGHttpServerMiddleware[];
+}
+export interface GGHttpServerMiddleware {
+    process?(): Promise<void>;
+}
+declare module "../schema/GGHttpSchema" {
+    interface GGHttpSchema<TContract extends GGContractApiDefinition> {
+        /**
+         * Start server with direct implementation.
+         * Uses parseRequest from use classes without transform.
+         * For custom transforms, use createServer() instead.
+         */
+        register(implementation: GGContractImplementation<TContract>, config?: GGHttpSchemaConfig): void;
+    }
+}
+//# sourceMappingURL=GGHttpSchema.startServer.d.ts.map

package/dist/src/server/GGHttpSchema.startServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpSchema.startServer.d.ts","sourceRoot":"","sources":["../../../src/server/GGHttpSchema.startServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAQ,uBAAuB,EAAE,wBAAwB,EAAqC,MAAM,kBAAkB,CAAC;AAS9H,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAG5C,MAAM,WAAW,kBAAkB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACnC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED,OAAO,QAAQ,wBAAwB,CAAC;IACpC,UAAU,YAAY,CAAC,SAAS,SAAS,uBAAuB;QAC5D;;;;WAIG;QACH,QAAQ,CAAC,cAAc,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;KACnG;CACJ"}

package/dist/src/server/GGHttpSchema.startServer.js

@@ -0,0 +1,114 @@
+/**
+ * Server extension for HttpApiSchema - adds register method.
+ * This file should only be imported in server (Node.js) context.
+ */
+import { GGLocator } from "@grest-ts/locator";
+import { GGHttpSchema } from "../schema/GGHttpSchema.js";
+import { ERROR, SERVER_ERROR } from "@grest-ts/schema";
+import { GG_DISCOVERY } from "@grest-ts/discovery";
+import { GGContext, GGContextStore } from "@grest-ts/context";
+import { GG_TRACE } from "@grest-ts/trace";
+import { GG_HTTP_REQUEST } from "./GG_HTTP_REQUEST.js";
+import { GG_METRICS } from "@grest-ts/metrics";
+import { GGHttpMetrics } from "./GGHttpMetrics.js";
+import { GG_HTTP_SERVER } from "./GG_HTTP_SERVER.js";
+import { GGLog } from "@grest-ts/logger";
+GGHttpSchema.prototype.register = function (implementation, config) {
+    return setupRoutes(this, implementation, config);
+};
+function setupRoutes(httpSchema, implementation, config) {
+    config ??= {};
+    config.middlewares ??= [];
+    if (!httpSchema.contract)
+        throw new Error(`HttpApiSchema "${httpSchema.name}" has no contract.`);
+    const server = config.http ?? GGLocator.getScope().get(GG_HTTP_SERVER);
+    if (!server)
+        throw new Error(`No HTTP server found. Make sure to register GGHttpServerAdapter in the scope or pass handler via config`);
+    const pathPrefix = "/" + httpSchema.pathPrefix + "/";
+    const apiMiddlewares = httpSchema.apiMiddlewares;
+    const scope = GGLocator.getScope();
+    const parentContext = GGContextStore.tryGetContext();
+    server.onStart(() => {
+        GG_DISCOVERY.tryGet()?.registerRoutes([{
+                runtime: scope.serviceName,
+                api: httpSchema.name,
+                pathPrefix: pathPrefix,
+                protocol: "http",
+                port: server.port
+            }]);
+    });
+    // Info: Contract instance is auto-registered in GGLocator via patched implement()
+    // @TODO This is not really used and only for testkit so it would register implementation of the contract... Not cool
+    httpSchema.contract.implement(implementation);
+    for (const methodName in httpSchema.codec) {
+        // Wire format.
+        const codec = httpSchema.codec[methodName];
+        if (!codec)
+            throw new Error(`Contract for "${httpSchema.name}.${methodName}" is missing wire format!`);
+        // Implementation function
+        const implFn = implementation[methodName]?.bind(implementation);
+        if (!implFn)
+            throw new Error(`Implementation for "${httpSchema.name}.${methodName}" is missing implementation method!`);
+        // Input schema
+        const contractFunctionSchema = httpSchema.contract.methods[methodName];
+        if (!contractFunctionSchema)
+            throw new Error(`Contract for "${httpSchema.name}.${methodName}" is missing contract function schema!`);
+        // build request mapping
+        const requestParser = codec.createForServer({
+            contract: contractFunctionSchema,
+            apiMiddlewares: apiMiddlewares,
+            serverMiddlewares: config.middlewares
+        });
+        server.registerRoute(codec.method, pathPrefix + codec.path, async (req, res) => {
+            scope.ensureEntered();
+            return new GGContext("REQ", parentContext).run(async () => {
+                GG_TRACE.init();
+                GG_HTTP_REQUEST.set({ port: server.port, method: req.method, path: req.url });
+                const startTime = performance.now();
+                let rpcResult;
+                try {
+                    const rpcInput = await requestParser.parseRequest(req);
+                    try {
+                        rpcResult = { success: true, type: "OK", data: await implFn(rpcInput) };
+                        // GGLog.debug(httpSchema, "Response", rpcResult) // This is very slow to log this (like 3x performance loss)
+                    }
+                    catch (error) {
+                        rpcResult = ERROR.fromUnknown(error);
+                        if (rpcResult instanceof SERVER_ERROR) {
+                            GGLog.error(httpSchema, rpcResult);
+                        }
+                        else {
+                            // GGLog.debug(httpSchema, "Response", rpcResult) // This is very slow to log this (like 3x performance loss)
+                        }
+                    }
+                    await requestParser.sendResponse(res, rpcResult); // can throw
+                }
+                catch (error) {
+                    rpcResult = ERROR.fromUnknown(error);
+                    await requestParser.sendResponse(res, rpcResult); // Does not throw
+                    GGLog.error(httpSchema, rpcResult);
+                }
+                finally {
+                    metrics(rpcResult?.type, httpSchema.name, codec.method, pathPrefix, codec.path, startTime);
+                }
+            });
+        });
+    }
+}
+function metrics(resultType, apiName, method, pathPrefix, pathSuffix, startTime) {
+    if (GG_METRICS.has()) {
+        const path = method + " " + pathPrefix + pathSuffix;
+        GGHttpMetrics.requests.inc(1, {
+            api: apiName,
+            method: pathSuffix,
+            path: path,
+            result: resultType
+        });
+        GGHttpMetrics.requestDuration.observe(performance.now() - startTime, {
+            api: apiName,
+            method: pathSuffix,
+            path: path
+        });
+    }
+}
+//# sourceMappingURL=GGHttpSchema.startServer.js.map

package/dist/src/server/GGHttpSchema.startServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpSchema.startServer.js","sourceRoot":"","sources":["../../../src/server/GGHttpSchema.startServer.ts"],"names":[],"mappings":"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"}

package/dist/src/server/GGHttpServer.d.ts

@@ -0,0 +1,32 @@
+import http from "http";
+import { HttpMethod } from "@grest-ts/common";
+import { GGLocatorKey, GGLocatorScope } from "@grest-ts/locator";
+export interface GGHttpServerAdapterConfig {
+    key?: GGLocatorKey<GGHttpServer>;
+    port?: number;
+}
+export declare class GGHttpServer {
+    protected _port: number | undefined;
+    protected teardownPromise: Promise<void> | undefined;
+    protected readonly scope: GGLocatorScope;
+    protected readonly runtimeName: string;
+    private readonly configuredPort;
+    private readonly _onStart;
+    private readonly _onTeardown;
+    readonly httpServer: http.Server;
+    private activeRequests;
+    private router;
+    constructor(config?: GGHttpServerAdapterConfig);
+    /**
+     * Current port the server is listening to.
+     * May be undefined before start() is called.
+     */
+    get port(): number | undefined;
+    registerRoute(method: HttpMethod, path: string, handler: GGHttpRequestCallback): void;
+    start(): Promise<void>;
+    teardown(): Promise<void>;
+    onStart(callback: () => Promise<void> | void): this;
+    onTeardown(callback: () => Promise<void> | void): this;
+}
+export type GGHttpRequestCallback = (req: http.IncomingMessage, res: http.ServerResponse) => Promise<void>;
+//# sourceMappingURL=GGHttpServer.d.ts.map

package/dist/src/server/GGHttpServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGHttpServer.d.ts","sourceRoot":"","sources":["../../../src/server/GGHttpServer.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAC,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAY,YAAY,EAAE,cAAc,EAAuB,MAAM,mBAAmB,CAAC;AAKhG,MAAM,WAAW,yBAAyB;IACtC,GAAG,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,YAAY;IAErB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IACrD,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IAErD,SAAgB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;IACxC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAyC;gBAE3C,MAAM,CAAC,EAAE,yBAAyB;IAgD9C;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAMM,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAI/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IActB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B,OAAO,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;IAKnD,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI;CAIhE;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/src/server/GGHttpServer.js

@@ -0,0 +1,116 @@
+import http from "http";
+import { HttpStatusCode } from "@grest-ts/common";
+import { GGLocator, GGLocatorServiceType } from "@grest-ts/locator";
+import { GG_HTTP_SERVER } from "./GG_HTTP_SERVER.js";
+import { GGLog } from "@grest-ts/logger";
+import findMyWay from "find-my-way";
+export class GGHttpServer {
+    _port;
+    teardownPromise;
+    scope;
+    runtimeName;
+    configuredPort;
+    _onStart = [];
+    _onTeardown = [];
+    httpServer;
+    activeRequests = 0;
+    router = findMyWay();
+    constructor(config) {
+        this.runtimeName = GGLocator.getScope().serviceName;
+        this.scope = GGLocator.getScope();
+        this.configuredPort = config?.port ?? (process.env.PORT ? Number(process.env.PORT) : 0);
+        GGLocator.getScope().setWithLifecycle(config?.key ?? GG_HTTP_SERVER, this, {
+            type: GGLocatorServiceType.HTTP,
+            start: this.start.bind(this),
+            teardown: this.teardown.bind(this)
+        });
+        this.httpServer = http.createServer(async (req, res) => {
+            if (this.teardownPromise) {
+                res.statusCode = HttpStatusCode.ServerTemporarilyNotAvailable503;
+                res.end();
+                return;
+            }
+            this.activeRequests++;
+            try {
+                if (req.headers.origin) { // For browsers
+                    res.setHeader('Access-Control-Allow-Origin', '*');
+                    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, OPTIONS');
+                    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, x-company-auth'); // @TODO Remove x-company-auth
+                    res.setHeader('Access-Control-Expose-Headers', 'Content-Disposition');
+                }
+                if (req.method === 'OPTIONS') {
+                    res.writeHead(204);
+                    res.end();
+                }
+                else {
+                    const resolved = this.router.find(req.method, req.url);
+                    if (resolved) {
+                        await resolved.handler(req, res);
+                    }
+                    else {
+                        res.writeHead(404);
+                        res.end();
+                    }
+                }
+            }
+            catch (error) {
+                GGLog.error(this, error);
+                res.writeHead(500);
+                res.end();
+            }
+            finally {
+                this.activeRequests--;
+            }
+        });
+    }
+    /**
+     * Current port the server is listening to.
+     * May be undefined before start() is called.
+     */
+    get port() {
+        return this._port;
+    }
+    // =========================================================================
+    // Common implementation
+    // =========================================================================
+    registerRoute(method, path, handler) {
+        this.router.on(method, path, handler);
+    }
+    async start() {
+        this._port = await new Promise((resolve) => {
+            this.httpServer.listen(this.configuredPort, '0.0.0.0', () => {
+                const port = this.httpServer.address().port;
+                resolve(port);
+            });
+        });
+        this._onStart.forEach(callback => callback());
+        GGLog.info(this, `HTTP server started`, {
+            port: this._port,
+            runtime: this.runtimeName
+        });
+    }
+    async teardown() {
+        if (this.teardownPromise) {
+            return this.teardownPromise;
+        }
+        return this.teardownPromise = (async () => {
+            await Promise.all(this._onTeardown.map(callback => callback()));
+            this.httpServer.close();
+            const maxWaitTime = 3000;
+            const deadline = performance.now() + maxWaitTime;
+            while (this.activeRequests > 0 && performance.now() < deadline) {
+                await new Promise(resolve => setTimeout(resolve, 25));
+            }
+            GGLog.info(this, `HTTP server stopped`);
+        })();
+    }
+    onStart(callback) {
+        this._onStart.push(callback);
+        return this;
+    }
+    onTeardown(callback) {
+        this._onTeardown.push(callback);
+        return this;
+    }
+}
+//# sourceMappingURL=GGHttpServer.js.map