@grest-ts/http 0.0.23 → 0.0.25

package/README.md

@@ -235,6 +235,8 @@ export const GG_CLIENT_INFO = new GGContextKey<ClientInfo>('clientInfo', IsObjec
 }))
 
 export const ClientInfoMiddleware: GGHttpTransportMiddleware = {
+    headers: ['x-client-version', 'x-client-platform'],
+    responseHeaders: [],
     updateRequest(req: GGHttpRequest): void {
         const info = GG_CLIENT_INFO.get()
         if (info) {
@@ -409,6 +411,49 @@ protected compose(): void {
 }
 ```
 
+### CORS Headers
+
+CORS `Access-Control-Allow-Headers` are auto-discovered from middleware and codecs.
+Only `Content-Type` is included by default (it's set by the framework's RPC layer).
+All other headers — including `Authorization` — are registered automatically when
+middleware declares them via `headers` or when `useHeader()` extracts them from codecs.
+
+When using `useHeader()`, header names are extracted from the codec's input schema automatically:
+
+```typescript
+const HeaderType = IsObject({
+    "x-org-token": IsString.orUndefined  // Auto-discovered as CORS header
+})
+GG_ORG_TOKEN.addCodec("http", HeaderType.codecTo(...))
+
+httpSchema(Contract)
+    .useHeader(GG_ORG_TOKEN)  // "x-org-token" added to CORS Allow-Headers
+    .routes({ ... })
+```
+
+Both `headers` (request) and `responseHeaders` (response) are required on middleware and codecs —
+TypeScript enforces this at compile time. Use `[]` when not applicable:
+
+```typescript
+export const MyMiddleware: GGHttpTransportMiddleware = {
+    headers: ['x-custom-header'],
+    responseHeaders: [],
+    updateRequest(req) { ... },
+    parseRequest(req) { ... }
+}
+```
+
+Codecs also declare `responseHeaders`. For example, `GGFileDownload` declares
+`['Content-Disposition']` which is automatically added to `Access-Control-Expose-Headers`.
+
+You can also register headers manually on the server:
+
+```typescript
+const httpServer = new GGHttpServer()
+httpServer.registerCorsHeaders(['x-custom-header'])
+httpServer.registerCorsExposeHeaders(['x-custom-response-header'])
+```
+
 ## HTTP Client
 
 ### Creating Clients

package/dist/src/client/GGHttpSchema.createClient.d.ts

@@ -5,10 +5,36 @@ declare module "../schema/GGHttpSchema" {
         createClient(config?: GGHttpClientConfig): GGContractClient<TContract>;
     }
 }
+/**
+ * HTTP transport function. The signature mirrors `fetch` (URL string + init bag),
+ * which lets the default implementation just be `fetch`. Pass a custom transport
+ * to plug in pinned-TLS dialing, custom dispatchers, signed-request proxies,
+ * or any other wire-layer concern that `fetch` can't accommodate.
+ *
+ * The `url` arg is `(config.url ?? "") + path-built-from-schema`, so when you
+ * pass `url: ""` (or rely on transport-implies-empty), your transport receives
+ * just the request path and decides the host itself.
+ *
+ * The init bag is a fetch-compatible subset: only the fields createClient
+ * actually populates. Extending it later is a non-breaking change.
+ */
+export type GGHttpTransport = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string | FormData | undefined;
+    signal: AbortSignal;
+}) => Promise<Response>;
 export interface GGHttpClientConfig {
     url?: string;
     timeout?: number;
     noValidation?: boolean;
+    /**
+     * Override the wire-layer call. Defaults to `fetch`. When provided,
+     * service discovery is skipped (the transport is presumed to know how
+     * to reach the target) and `url` defaults to `""` so the transport sees
+     * just the schema-built path.
+     */
+    transport?: GGHttpTransport;
 }
 export declare function createClient<TContract extends GGContractApiDefinition, TContext>(httpSchema: GGHttpSchema<TContract, TContext>, config?: GGHttpClientConfig): GGContractClient<TContract>;
 //# sourceMappingURL=GGHttpSchema.createClient.d.ts.map

package/dist/src/client/GGHttpSchema.createClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GGHttpSchema.createClient.d.ts","sourceRoot":"","sources":["../../../src/client/GGHttpSchema.createClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,uBAAuB,EAAE,gBAAgB,EAA4E,MAAM,kBAAkB,CAAA;AACvK,OAAO,EAAwD,YAAY,EAAC,MAAM,wBAAwB,CAAC;AAI3G,OAAO,QAAQ,wBAAwB,CAAC;IACpC,UAAU,YAAY,CAAC,SAAS,SAAS,uBAAuB,EAAE,QAAQ,GAAG,EAAE;QAC3E,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;KACzE;CACJ;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAA;CACzB;AASD,wBAAgB,YAAY,CAAC,SAAS,SAAS,uBAAuB,EAAE,QAAQ,EAC5E,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,EAC7C,MAAM,CAAC,EAAE,kBAAkB,GAC5B,gBAAgB,CAAC,SAAS,CAAC,CA+E7B"}
+{"version":3,"file":"GGHttpSchema.createClient.d.ts","sourceRoot":"","sources":["../../../src/client/GGHttpSchema.createClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,uBAAuB,EAAE,gBAAgB,EAA4E,MAAM,kBAAkB,CAAA;AACvK,OAAO,EAAwD,YAAY,EAAC,MAAM,wBAAwB,CAAC;AAI3G,OAAO,QAAQ,wBAAwB,CAAC;IACpC,UAAU,YAAY,CAAC,SAAS,SAAS,uBAAuB,EAAE,QAAQ,GAAG,EAAE;QAC3E,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAA;KACzE;CACJ;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACF,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAA;IACnC,MAAM,EAAE,WAAW,CAAA;CACtB,KACA,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEtB,MAAM,WAAW,kBAAkB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;CAC9B;AASD,wBAAgB,YAAY,CAAC,SAAS,SAAS,uBAAuB,EAAE,QAAQ,EAC5E,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,QAAQ,CAAC,EAC7C,MAAM,CAAC,EAAE,kBAAkB,GAC5B,gBAAgB,CAAC,SAAS,CAAC,CAuF7B"}

package/dist/src/client/GGHttpSchema.createClient.js

@@ -7,6 +7,13 @@ GGHttpSchema.prototype.createClient = function (config) {
 export function createClient(httpSchema, config) {
     config ??= {};
     config.timeout ??= 15000;
+    // A custom transport implies "I take over the wire layer" — discovery is
+    // off the table (the transport knows how to find the target), and the
+    // default base URL becomes "" so the transport sees just the request path.
+    const transport = config.transport ?? defaultFetchTransport;
+    if (config.transport && config.url === undefined) {
+        config.url = "";
+    }
     if (config.url === undefined && isBrowser()) {
         throw new Error("Must define URL for GGHttpClient when running in browser! Use empty string for same-origin requests.");
     }
@@ -41,7 +48,7 @@ export function createClient(httpSchema, config) {
                 const fetchRequest = await wireFormat.createRequest(validatedInput);
                 const controller = new AbortController();
                 const timeoutId = setTimeout(() => controller.abort(), config.timeout);
-                const wireResponse = await fetch(baseUrl + fetchRequest.url, {
+                const wireResponse = await transport(baseUrl + fetchRequest.url, {
                     method: fetchRequest.method,
                     signal: controller.signal,
                     headers: fetchRequest.headers,
@@ -73,8 +80,9 @@ export function createClient(httpSchema, config) {
             return new GGPromise(implementation(data));
         };
     }
-    // @TODO Next line is just so test would register it correctly.
-    httpSchema.contract.implement(transportImplementation);
+    // Per-client stub — doesn't belong in the callOn registry (server's impl does).
+    httpSchema.contract.implement(transportImplementation, { skipLocatorRegistration: true });
     return transportImplementation;
 }
+const defaultFetchTransport = (url, init) => fetch(url, init);
 //# sourceMappingURL=GGHttpSchema.createClient.js.map

package/dist/src/client/GGHttpSchema.createClient.js.map

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

package/dist/src/index-node.d.ts

@@ -3,6 +3,8 @@ export * from "./server/GG_HTTP_REQUEST";
 export * from "./schema/GGHttpSchema";
 export * from "./schema/httpSchema";
 export * from "./rpc/GGHttpRouteRPC";
+export * from "./rpc/openApiSuccessResponse";
+export * from "./rpc/openApiHelpers";
 export * from "./rpc/RpcRequest/GGRpcRequestBuilder";
 export * from "./rpc/RpcRequest/GGRpcRequestParser";
 export * from "./rpc/RpcResponse/GGRpcResponseBuilder";

package/dist/src/index-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAUA,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAIlD,OAAO,oCAAoC,CAAC;AAC5C,OAAO,mCAAmC,CAAC"}
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAUA,cAAc,wBAAwB,CAAC;AAGvC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AAGtD,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAIlD,OAAO,oCAAoC,CAAC;AAC5C,OAAO,mCAAmC,CAAC"}

package/dist/src/index-node.js

@@ -14,6 +14,8 @@ export * from "./server/GG_HTTP_REQUEST.js";
 export * from "./schema/GGHttpSchema.js";
 export * from "./schema/httpSchema.js";
 export * from "./rpc/GGHttpRouteRPC.js";
+export * from "./rpc/openApiSuccessResponse.js";
+export * from "./rpc/openApiHelpers.js";
 export * from "./rpc/RpcRequest/GGRpcRequestBuilder.js";
 export * from "./rpc/RpcRequest/GGRpcRequestParser.js";
 export * from "./rpc/RpcResponse/GGRpcResponseBuilder.js";

package/dist/src/index-node.js.map

@@ -1 +1 @@
-{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAC,8BAA8B,EAAC,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,kBAAkB,EAAC,MAAM,qCAAqC,CAAC;AACvE,8BAA8B,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,YAAY,EAAE,IAAI,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,YAAY;IACvE,YAAY,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC,YAAY;CAC9D,CAAC,CAAC,CAAC;AAEJ,UAAU;AACV,cAAc,wBAAwB,CAAC;AAEvC,UAAU;AACV,cAAc,0BAA0B,CAAC;AAEzC,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AAEtD,+BAA+B;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC,SAAS;AACT,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAGlD,aAAa;AACb,OAAO,oCAAoC,CAAC;AAC5C,OAAO,mCAAmC,CAAC"}
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,OAAO,EAAC,8BAA8B,EAAC,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,kBAAkB,EAAC,MAAM,qCAAqC,CAAC;AACvE,8BAA8B,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACtD,YAAY,EAAE,IAAI,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,YAAY;IACvE,YAAY,EAAE,IAAI,oBAAoB,CAAC,MAAM,CAAC,CAAC,YAAY;CAC9D,CAAC,CAAC,CAAC;AAEJ,UAAU;AACV,cAAc,wBAAwB,CAAC;AAEvC,UAAU;AACV,cAAc,0BAA0B,CAAC;AAEzC,aAAa;AACb,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AACrC,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,uCAAuC,CAAC;AAEtD,+BAA+B;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AAExC,SAAS;AACT,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAGlD,aAAa;AACb,OAAO,oCAAoC,CAAC;AAC5C,OAAO,mCAAmC,CAAC"}

package/dist/src/rpc/GGHttpRouteRPC.d.ts

@@ -1,19 +1,32 @@
 import { HttpMethod } from "@grest-ts/common";
-import { ClientHttpRouteToRpcTransformClientCodec, ClientHttpRouteToRpcTransformClientConfig, ClientHttpRouteToRpcTransformServerCodec, ClientHttpRouteToRpcTransformServerConfig, GGHttpCodec } from "../schema/GGHttpSchema";
+import { ClientHttpRouteToRpcTransformClientCodec, ClientHttpRouteToRpcTransformClientConfig, ClientHttpRouteToRpcTransformServerCodec, ClientHttpRouteToRpcTransformServerConfig, GGHttpCodec, GGHttpCodecOpenApiConfig } from "../schema/GGHttpSchema";
+import type { OpenAPIV3_1 } from "openapi-types";
+import { GGSchema } from "@grest-ts/schema";
 export type GGRpcServerCodecFactory = (method: HttpMethod, path: string, config: ClientHttpRouteToRpcTransformServerConfig) => ClientHttpRouteToRpcTransformServerCodec;
 export declare function _registerRpcServerCodecFactory(factory: GGRpcServerCodecFactory): void;
 export declare const GGRpc: {
-    GET: (path: string) => GGHttpRpcCodec;
-    DELETE: (path: string) => GGHttpRpcCodec;
-    POST: (path: string) => GGHttpRpcCodec;
-    PUT: (path: string) => GGHttpRpcCodec;
+    GET: (path: string, opts?: {
+        deprecated?: boolean;
+    }) => GGHttpRpcCodec;
+    DELETE: (path: string, opts?: {
+        deprecated?: boolean;
+    }) => GGHttpRpcCodec;
+    POST: (path: string, opts?: {
+        deprecated?: boolean;
+    }) => GGHttpRpcCodec;
+    PUT: (path: string, opts?: {
+        deprecated?: boolean;
+    }) => GGHttpRpcCodec;
 };
 declare class GGHttpRpcCodec implements GGHttpCodec {
     readonly method: HttpMethod;
     readonly path: string;
-    constructor(method: HttpMethod, path: string);
+    readonly deprecated: boolean | undefined;
+    readonly responseHeaders: Record<string, GGSchema<string | undefined>>;
+    constructor(method: HttpMethod, path: string, deprecated?: boolean);
     createForClient(config: ClientHttpRouteToRpcTransformClientConfig): ClientHttpRouteToRpcTransformClientCodec;
     createForServer(config: ClientHttpRouteToRpcTransformServerConfig): ClientHttpRouteToRpcTransformServerCodec;
+    toOpenApiOperation(config: GGHttpCodecOpenApiConfig): Partial<OpenAPIV3_1.OperationObject>;
 }
 export {};
 //# sourceMappingURL=GGHttpRouteRPC.d.ts.map

package/dist/src/rpc/GGHttpRouteRPC.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GGHttpRouteRPC.d.ts","sourceRoot":"","sources":["../../../src/rpc/GGHttpRouteRPC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,wCAAwC,EAAE,yCAAyC,EAAE,wCAAwC,EAAE,yCAAyC,EAAE,WAAW,EAAC,MAAM,wBAAwB,CAAA;AAI5N,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,yCAAyC,KAAK,wCAAwC,CAAC;AAIxK,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAErF;AAED,eAAO,MAAM,KAAK;gBACF,MAAM;mBACH,MAAM;iBACR,MAAM;gBACP,MAAM;CACrB,CAAA;AAED,cAAM,cAAe,YAAW,WAAW;IAEvC,SAAgB,MAAM,EAAE,UAAU,CAAA;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAEhB,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAKrC,eAAe,CAAC,MAAM,EAAE,yCAAyC,GAAG,wCAAwC;IAO5G,eAAe,CAAC,MAAM,EAAE,yCAAyC,GAAG,wCAAwC;CAItH"}
+{"version":3,"file":"GGHttpRouteRPC.d.ts","sourceRoot":"","sources":["../../../src/rpc/GGHttpRouteRPC.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAC,wCAAwC,EAAE,yCAAyC,EAAE,wCAAwC,EAAE,yCAAyC,EAAE,WAAW,EAAE,wBAAwB,EAAC,MAAM,wBAAwB,CAAA;AAGtP,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAI1C,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,yCAAyC,KAAK,wCAAwC,CAAC;AAIxK,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAErF;AAED,eAAO,MAAM,KAAK;gBACC,MAAM,SAAS;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAC;mBACrC,MAAM,SAAS;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAC;iBACrC,MAAM,SAAS;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAC;gBACrC,MAAM,SAAS;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAC;CACvD,CAAA;AAED,cAAM,cAAe,YAAW,WAAW;IAEvC,SAAgB,MAAM,EAAE,UAAU,CAAA;IAClC,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,SAAgB,UAAU,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/C,SAAgB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC,CAAK;gBAEtE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO;IAM3D,eAAe,CAAC,MAAM,EAAE,yCAAyC,GAAG,wCAAwC;IAO5G,eAAe,CAAC,MAAM,EAAE,yCAAyC,GAAG,wCAAwC;IAK5G,kBAAkB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC;CAoBpG"}

package/dist/src/rpc/GGHttpRouteRPC.js

@@ -1,21 +1,26 @@
 import { GGRpcRequestBuilder } from "./RpcRequest/GGRpcRequestBuilder.js";
 import { GGRpcResponseParser } from "./RpcResponse/GGRpcResponseParser.js";
+import { buildRpcSuccessResponses } from "./openApiSuccessResponse.js";
+import { buildOpenApiParameters } from "./openApiHelpers.js";
 let _serverCodecFactory;
 export function _registerRpcServerCodecFactory(factory) {
     _serverCodecFactory = factory;
 }
 export const GGRpc = {
-    GET: (path) => new GGHttpRpcCodec("GET", path),
-    DELETE: (path) => new GGHttpRpcCodec("DELETE", path),
-    POST: (path) => new GGHttpRpcCodec("POST", path),
-    PUT: (path) => new GGHttpRpcCodec("PUT", path),
+    GET: (path, opts) => new GGHttpRpcCodec("GET", path, opts?.deprecated),
+    DELETE: (path, opts) => new GGHttpRpcCodec("DELETE", path, opts?.deprecated),
+    POST: (path, opts) => new GGHttpRpcCodec("POST", path, opts?.deprecated),
+    PUT: (path, opts) => new GGHttpRpcCodec("PUT", path, opts?.deprecated),
 };
 class GGHttpRpcCodec {
     method;
     path;
-    constructor(method, path) {
+    deprecated;
+    responseHeaders = {};
+    constructor(method, path, deprecated) {
         this.method = method;
         this.path = path;
+        this.deprecated = deprecated;
     }
     createForClient(config) {
         return {
@@ -28,5 +33,22 @@ class GGHttpRpcCodec {
             throw new Error("Server RPC codec not available. Ensure @grest-ts/http server entry is imported.");
         return _serverCodecFactory(this.method, this.path, config);
     }
+    toOpenApiOperation(config) {
+        const hasBody = this.method === "POST" || this.method === "PUT" || this.method === "PATCH";
+        const operationId = config.methodName;
+        const parameters = buildOpenApiParameters(this.path, hasBody, config.contract.input ?? undefined, config.schemaResolver);
+        const operation = {
+            operationId,
+            parameters,
+            responses: buildRpcSuccessResponses(config.contract, config.schemaResolver)
+        };
+        if (hasBody && config.contract.input) {
+            operation.requestBody = {
+                required: true,
+                content: { 'application/json': { schema: config.schemaResolver(config.contract.input.toSchemaDescription()) } }
+            };
+        }
+        return operation;
+    }
 }
 //# sourceMappingURL=GGHttpRouteRPC.js.map

package/dist/src/rpc/GGHttpRouteRPC.js.map

@@ -1 +1 @@
-{"version":3,"file":"GGHttpRouteRPC.js","sourceRoot":"","sources":["../../../src/rpc/GGHttpRouteRPC.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,mBAAmB,EAAC,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAC,mBAAmB,EAAC,MAAM,mCAAmC,CAAC;AAItE,IAAI,mBAAwD,CAAC;AAE7D,MAAM,UAAU,8BAA8B,CAAC,OAAgC;IAC3E,mBAAmB,GAAG,OAAO,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;IACtD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;IACxD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;CACzD,CAAA;AAED,MAAM,cAAc;IAEA,MAAM,CAAY;IAClB,IAAI,CAAQ;IAE5B,YAAY,MAAkB,EAAE,IAAY;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;IAEM,eAAe,CAAC,MAAiD;QACpE,OAAO;YACH,aAAa,EAAE,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,aAAa;YACpF,aAAa,EAAE,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC,aAAa;SAC/D,CAAA;IACL,CAAC;IAEM,eAAe,CAAC,MAAiD;QACpE,IAAI,CAAC,mBAAmB;YAAE,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QAC7H,OAAO,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;CACJ"}
+{"version":3,"file":"GGHttpRouteRPC.js","sourceRoot":"","sources":["../../../src/rpc/GGHttpRouteRPC.ts"],"names":[],"mappings":"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"}

package/dist/src/rpc/openApiHelpers.d.ts

@@ -0,0 +1,21 @@
+import type { GGSchema } from "@grest-ts/schema";
+import type { GGOpenApiSchemaResolver } from "../schema/GGHttpSchema";
+import type { OpenAPIV3_1 } from "openapi-types";
+/**
+ * Build OpenAPI parameter objects for a route from the contract's input schema.
+ *
+ * Path parameters are extracted from the path template (:id → {id}).
+ * For GET/DELETE (no body), remaining input fields become query parameters.
+ *
+ * Uses toSchemaDescription() to walk the input object's fields as
+ * GGSchemaDescription instances, then passes each to schemaResolver so named
+ * schemas are emitted as $ref where applicable.
+ *
+ * Type-cast note: openapi-types@12 defines OpenAPIV3_1.ParameterObject as a
+ * direct alias of OpenAPIV3.ParameterObject, whose `schema` field resolves to
+ * V3 schema types (missing `type:"null"` as a valid NonArraySchemaObjectType).
+ * The casts to ParameterObject["schema"] are the precise boundary of that
+ * typedef limitation — runtime objects are fully valid OpenAPI 3.1 parameters.
+ */
+export declare function buildOpenApiParameters(pathTemplate: string, hasBody: boolean, inputSchema: GGSchema<unknown> | undefined, schemaResolver: GGOpenApiSchemaResolver): OpenAPIV3_1.ParameterObject[];
+//# sourceMappingURL=openApiHelpers.d.ts.map

package/dist/src/rpc/openApiHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiHelpers.d.ts","sourceRoot":"","sources":["../../../src/rpc/openApiHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAsB,MAAM,kBAAkB,CAAC;AACpE,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAE/C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,SAAS,EAC1C,cAAc,EAAE,uBAAuB,GACxC,WAAW,CAAC,eAAe,EAAE,CAuC/B"}

package/dist/src/rpc/openApiHelpers.js

@@ -0,0 +1,70 @@
+/**
+ * Build OpenAPI parameter objects for a route from the contract's input schema.
+ *
+ * Path parameters are extracted from the path template (:id → {id}).
+ * For GET/DELETE (no body), remaining input fields become query parameters.
+ *
+ * Uses toSchemaDescription() to walk the input object's fields as
+ * GGSchemaDescription instances, then passes each to schemaResolver so named
+ * schemas are emitted as $ref where applicable.
+ *
+ * Type-cast note: openapi-types@12 defines OpenAPIV3_1.ParameterObject as a
+ * direct alias of OpenAPIV3.ParameterObject, whose `schema` field resolves to
+ * V3 schema types (missing `type:"null"` as a valid NonArraySchemaObjectType).
+ * The casts to ParameterObject["schema"] are the precise boundary of that
+ * typedef limitation — runtime objects are fully valid OpenAPI 3.1 parameters.
+ */
+export function buildOpenApiParameters(pathTemplate, hasBody, inputSchema, schemaResolver) {
+    const pathParams = (pathTemplate.match(/:(\w+)/g) || []).map(m => m.slice(1));
+    if (!inputSchema)
+        return pathParams.map(name => buildPathParam(name, undefined, schemaResolver));
+    // Use toSchemaDescription() to get GGSchemaDescription instances per field.
+    // This gives us the format-agnostic tree without coupling to internal def structure.
+    const desc = inputSchema.toSchemaDescription();
+    if (desc.node.kind !== 'object') {
+        // Input schemas must be object schemas so their fields can be mapped to
+        // path/query parameters. Any other kind is a contract definition error.
+        throw new Error(`buildOpenApiParameters: input schema must be an object schema (kind='object'), ` +
+            `got kind='${desc.node.kind}'. Contract input schemas must use IsObject({...}).`);
+    }
+    const properties = desc.node.properties;
+    const params = pathParams.map(name => buildPathParam(name, properties[name], schemaResolver));
+    if (!hasBody) {
+        for (const [name, fieldDesc] of Object.entries(properties)) {
+            if (pathParams.includes(name))
+                continue;
+            const resolved = schemaResolver(fieldDesc);
+            const { description, ...schemaWithoutDescription } = resolved;
+            const isRequired = !fieldDesc.optional && resolved.default === undefined;
+            const param = {
+                name,
+                in: 'query',
+                required: isRequired,
+                schema: schemaWithoutDescription
+            };
+            if (description)
+                param.description = description;
+            params.push(param);
+        }
+    }
+    return params;
+}
+function buildPathParam(name, fieldDesc, schemaResolver) {
+    if (!fieldDesc) {
+        // Path params are always non-empty — an empty segment cannot be routed.
+        return { name, in: 'path', required: true,
+            schema: { type: 'string', minLength: 1 } };
+    }
+    const resolved = schemaResolver(fieldDesc);
+    const { description, ...schemaWithoutDescription } = resolved;
+    const param = {
+        name,
+        in: 'path',
+        required: true,
+        schema: schemaWithoutDescription
+    };
+    if (description)
+        param.description = description;
+    return param;
+}
+//# sourceMappingURL=openApiHelpers.js.map

package/dist/src/rpc/openApiHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiHelpers.js","sourceRoot":"","sources":["../../../src/rpc/openApiHelpers.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB,CAClC,YAAoB,EACpB,OAAgB,EAChB,WAA0C,EAC1C,cAAuC;IAEvC,MAAM,UAAU,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,CAAC,WAAW;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAEjG,4EAA4E;IAC5E,qFAAqF;IACrF,MAAM,IAAI,GAAG,WAAW,CAAC,mBAAmB,EAAE,CAAC;IAC/C,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,IAAI,KAAK,CACX,iFAAiF;YACjF,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,qDAAqD,CACnF,CAAC;IACN,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;IAExC,MAAM,MAAM,GAAkC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAChE,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CACzD,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,SAAS;YACxC,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YAC3C,MAAM,EAAC,WAAW,EAAE,GAAG,wBAAwB,EAAC,GAAG,QAAe,CAAC;YACnE,MAAM,UAAU,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAK,QAAgB,CAAC,OAAO,KAAK,SAAS,CAAC;YAClF,MAAM,KAAK,GAAgC;gBACvC,IAAI;gBACJ,EAAE,EAAE,OAAgB;gBACpB,QAAQ,EAAE,UAAU;gBACpB,MAAM,EAAE,wBAAiE;aAC5E,CAAC;YACF,IAAI,WAAW;gBAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED,SAAS,cAAc,CACnB,IAAY,EACZ,SAA0C,EAC1C,cAAuC;IAEvC,IAAI,CAAC,SAAS,EAAE,CAAC;QACb,wEAAwE;QACxE,OAAO,EAAC,IAAI,EAAE,EAAE,EAAE,MAAe,EAAE,QAAQ,EAAE,IAAa;YACtD,MAAM,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAA0C,EAAC,CAAC;IACzF,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,EAAC,WAAW,EAAE,GAAG,wBAAwB,EAAC,GAAG,QAAe,CAAC;IACnE,MAAM,KAAK,GAAgC;QACvC,IAAI;QACJ,EAAE,EAAE,MAAe;QACnB,QAAQ,EAAE,IAAa;QACvB,MAAM,EAAE,wBAAiE;KAC5E,CAAC;IACF,IAAI,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;IACjD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/src/rpc/openApiSuccessResponse.d.ts

@@ -0,0 +1,15 @@
+import type { GGContractMethod } from "@grest-ts/schema";
+import type { OpenAPIV3_1 } from "openapi-types";
+import type { GGOpenApiSchemaResolver } from "../schema/GGHttpSchema";
+/**
+ * Builds the standard GGRpc JSON-envelope success response for OpenAPI.
+ *
+ * On-wire the response is always:
+ *   { success: true, type: "OK", data: <success schema> }   (200)
+ *   or no body                                               (204 when no success schema)
+ *
+ * The resolver is used to emit $ref for named success schemas rather than
+ * inlining them. Pass config.schemaResolver from toOpenApiOperation().
+ */
+export declare function buildRpcSuccessResponses(contract: GGContractMethod, resolver: GGOpenApiSchemaResolver): OpenAPIV3_1.ResponsesObject;
+//# sourceMappingURL=openApiSuccessResponse.d.ts.map

package/dist/src/rpc/openApiSuccessResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSuccessResponse.d.ts","sourceRoot":"","sources":["../../../src/rpc/openApiSuccessResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAC,uBAAuB,EAAC,MAAM,wBAAwB,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,uBAAuB,GAClC,WAAW,CAAC,eAAe,CAoB7B"}

package/dist/src/rpc/openApiSuccessResponse.js

@@ -0,0 +1,32 @@
+/**
+ * Builds the standard GGRpc JSON-envelope success response for OpenAPI.
+ *
+ * On-wire the response is always:
+ *   { success: true, type: "OK", data: <success schema> }   (200)
+ *   or no body                                               (204 when no success schema)
+ *
+ * The resolver is used to emit $ref for named success schemas rather than
+ * inlining them. Pass config.schemaResolver from toOpenApiOperation().
+ */
+export function buildRpcSuccessResponses(contract, resolver) {
+    if (contract.success) {
+        const dataSchema = resolver(contract.success.toSchemaDescription());
+        const successSchema = {
+            type: "object",
+            properties: {
+                success: { type: "boolean", enum: [true] },
+                type: { type: "string", enum: ["OK"] },
+                data: dataSchema
+            },
+            required: ["success", "type", "data"]
+        };
+        return {
+            "200": {
+                description: "Success",
+                content: { "application/json": { schema: successSchema } }
+            }
+        };
+    }
+    return { "204": { description: "No content" } };
+}
+//# sourceMappingURL=openApiSuccessResponse.js.map

package/dist/src/rpc/openApiSuccessResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiSuccessResponse.js","sourceRoot":"","sources":["../../../src/rpc/openApiSuccessResponse.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,UAAU,wBAAwB,CACpC,QAA0B,EAC1B,QAAiC;IAEjC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;QACpE,MAAM,aAAa,GAAqC;YACpD,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,OAAO,EAAE,EAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAC;gBACxC,IAAI,EAAE,EAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,EAAC;gBACpC,IAAI,EAAE,UAAU;aACnB;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;SACxC,CAAC;QACF,OAAO;YACH,KAAK,EAAE;gBACH,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE,EAAC,kBAAkB,EAAE,EAAC,MAAM,EAAE,aAAa,EAAC,EAAC;aACzD;SACJ,CAAC;IACN,CAAC;IACD,OAAO,EAAC,KAAK,EAAE,EAAC,WAAW,EAAE,YAAY,EAAC,EAAC,CAAC;AAChD,CAAC"}

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

@@ -1,7 +1,8 @@
-import { ERROR, ERROR_JSON, GGContractApiDefinition, GGContractClass, GGContractMethod, OK } from "@grest-ts/schema";
+import { ERROR, ERROR_JSON, GGContractApiDefinition, GGContractClass, GGContractMethod, GGSchema, GGSchemaDescription, OK } from "@grest-ts/schema";
 import type { HttpMethod } from "@grest-ts/common";
 import type http from "http";
 import type { GGHttpServerMiddleware } from "../server/GGHttpSchema.startServer";
+import type { OpenAPIV3_1 } from "openapi-types";
 export declare class GGHttpSchema<TContract extends GGContractApiDefinition, TContext> {
     readonly name: string;
     readonly pathPrefix: string;
@@ -34,13 +35,77 @@ export interface ClientHttpRouteToRpcTransformServerCodec {
     parseRequest: (req: http.IncomingMessage) => Promise<unknown>;
     sendResponse: (res: http.ServerResponse, rpcResult: ERROR<string, unknown> | OK<unknown>) => Promise<void>;
 }
+/**
+ * Config passed to toOpenApiOperation? — gives the codec access to the contract and route context
+ * so it can produce accurate OpenAPI operation metadata.
+ */
+/**
+ * Resolves a GGSchemaDescription to an OpenAPI SchemaObject or ReferenceObject.
+ * When provided via GGHttpCodecOpenApiConfig, codecs should use this for all schema
+ * conversions — it enables $ref extraction for named schemas.
+ * For standalone use (tests, custom tools), use inlineSchemaResolver from @grest-ts/openapi.
+ */
+export type GGOpenApiSchemaResolver = (desc: GGSchemaDescription) => OpenAPIV3_1.SchemaObject | OpenAPIV3_1.ReferenceObject;
+export interface GGHttpCodecOpenApiConfig {
+    readonly pathPrefix: string;
+    readonly methodName: string;
+    readonly contract: GGContractMethod;
+    /**
+     * Resolves a GGSchema to an OpenAPI SchemaObject or ReferenceObject.
+     * Provided by the document builder (toOpenApi) as registry.schemaOrRef.
+     * For standalone codec use or tests, pass inlineSchemaResolver from @grest-ts/openapi.
+     */
+    readonly schemaResolver: GGOpenApiSchemaResolver;
+}
 export interface GGHttpCodec {
     readonly method: HttpMethod;
     readonly path: string;
+    /**
+     * Mark this operation as deprecated in the OpenAPI spec.
+     * Swagger UI renders deprecated operations with a strikethrough.
+     * @default false
+     */
+    readonly deprecated?: boolean;
+    /**
+     * Response headers this codec sets, mapped to their value schemas.
+     * Keys are header names; values describe the header value format.
+     * Used for CORS Access-Control-Expose-Headers and OpenAPI response header docs.
+     * Use {} if the codec sets no custom response headers.
+     */
+    readonly responseHeaders: Record<string, GGSchema<string | undefined>>;
     createForClient(config: ClientHttpRouteToRpcTransformClientConfig): ClientHttpRouteToRpcTransformClientCodec;
     createForServer(config: ClientHttpRouteToRpcTransformServerConfig): ClientHttpRouteToRpcTransformServerCodec;
+    /**
+     * Optional hook for custom codecs to describe their OpenAPI operation semantics.
+     * The returned partial is merged on top of the auto-generated operation object,
+     * allowing overrides for requestBody content type, security schemes, etc.
+     *
+     * Built-in GGRpc.* codecs implement this automatically.
+     * Custom codec authors (e.g. GGFileUpload) may implement it for accurate docs.
+     */
+    toOpenApiOperation?(config: GGHttpCodecOpenApiConfig): Partial<OpenAPIV3_1.OperationObject>;
 }
 export interface GGHttpTransportMiddleware {
+    /**
+     * Request headers this middleware reads or writes, mapped to their value schemas.
+     * Keys are header names; values describe the header value format for validation and docs.
+     * Used for CORS Access-Control-Allow-Headers and OpenAPI parameter docs.
+     * Use {} if the middleware touches no custom request headers.
+     *
+     * @example
+     * headers: {
+     *   "authorization": IsString.nonEmpty.docs({title: "Bearer token", example: "Bearer ..."}),
+     *   "accept-language": IsLocale.orUndefined
+     * }
+     */
+    readonly headers: Record<string, GGSchema<string | undefined>>;
+    /**
+     * Response headers this middleware sets, mapped to their value schemas.
+     * Keys are header names; values describe the header value format for validation and docs.
+     * Used for CORS Access-Control-Expose-Headers and OpenAPI response header docs.
+     * Use {} if the middleware sets no custom response headers.
+     */
+    readonly responseHeaders: Record<string, GGSchema<string | undefined>>;
     /**
      * Client-side: modify outgoing request (add headers, etc.)
      */

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

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

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

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

@@ -1 +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"}
+{"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,EAAW,MAAM,kBAAkB,CAAC;AACpF,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;IAmDnG,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

@@ -46,9 +46,22 @@ class GGHttpSchemaBuilder {
         if (!codec) {
             throw new Error(`Context key '${contextKey.name}' does not have an 'http-header' codec registered.`);
         }
+        // Build the typed header map from codec.inputSchema — the IsObject({headerName: schema})
+        // that describes which headers this codec reads and what format each value has.
+        const inputSchema = codec.inputSchema;
+        const headers = {};
+        if (inputSchema) {
+            const desc = inputSchema.toSchemaDescription();
+            if (desc.node.kind === 'object') {
+                for (const [k, fieldDesc] of Object.entries(desc.node.properties)) {
+                    headers[k] = fieldDesc.schema;
+                }
+            }
+        }
         const middleware = {
+            headers,
+            responseHeaders: {},
             updateRequest(req) {
-                // Client-side: context -> headers
                 const contextValue = contextKey.get();
                 if (contextValue !== undefined) {
                     const result = codec.decode(contextValue);
@@ -57,7 +70,6 @@ class GGHttpSchemaBuilder {
                     }
                 }
                 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)) {
@@ -67,7 +79,6 @@ class GGHttpSchemaBuilder {
                 }
             },
             parseRequest(req) {
-                // Server-side: headers -> context
                 const headers = req.headers;
                 const result = codec.encode(headers);
                 if (result.success) {