@grest-ts/asyncapi 0.0.24

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Grest Games OÜ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+<!-- GREST-TS-BANNER-START -->
+> Part of the [grest-ts](https://github.com/grest-ts/grest-ts) framework.
+> [Documentation](https://github.com/grest-ts/grest-ts#readme) | [All packages](https://github.com/grest-ts/grest-ts#package-reference)
+<!-- GREST-TS-BANNER-END -->
+

package/dist/src/AsyncApiTypes.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Minimal AsyncAPI 3.0 type definitions.
+ * Only the subset used by @grest-ts/asyncapi — enough for correct spec generation.
+ */
+export interface AsyncAPIDocument {
+    asyncapi: "3.0.0";
+    info: InfoObject;
+    servers?: Record<string, ServerObject>;
+    channels: Record<string, ChannelObject>;
+    operations: Record<string, OperationObject>;
+    components?: ComponentsObject;
+}
+export interface InfoObject {
+    title: string;
+    version: string;
+    description?: string;
+}
+export interface ServerObject {
+    host: string;
+    protocol: "ws" | "wss" | "http" | "https";
+    description?: string;
+}
+export interface ChannelObject {
+    address: string;
+    description?: string;
+    title?: string;
+    messages?: Record<string, MessageObject | ReferenceObject>;
+    bindings?: ChannelBindingsObject;
+}
+export interface ChannelBindingsObject {
+    ws?: WsChannelBinding;
+}
+export interface WsChannelBinding {
+    method?: "GET" | "POST";
+    headers?: SchemaObject;
+    bindingVersion?: string;
+}
+export interface OperationObject {
+    action: "send" | "receive";
+    channel: ReferenceObject;
+    title?: string;
+    summary?: string;
+    description?: string;
+    messages?: ReferenceObject[];
+    reply?: OperationReplyObject;
+    security?: SecurityRequirementObject[];
+}
+export interface OperationReplyObject {
+    channel?: ReferenceObject;
+    messages?: ReferenceObject[];
+}
+export interface MessageObject {
+    name?: string;
+    title?: string;
+    summary?: string;
+    description?: string;
+    payload?: SchemaObject | ReferenceObject;
+    headers?: SchemaObject;
+    contentType?: string;
+}
+export interface ComponentsObject {
+    schemas?: Record<string, SchemaObject>;
+    messages?: Record<string, MessageObject>;
+    securitySchemes?: Record<string, SecuritySchemeObject>;
+}
+export interface SchemaObject {
+    type?: string | string[];
+    properties?: Record<string, SchemaObject | ReferenceObject>;
+    required?: string[];
+    additionalProperties?: boolean | SchemaObject;
+    items?: SchemaObject | ReferenceObject;
+    prefixItems?: (SchemaObject | ReferenceObject)[];
+    oneOf?: (SchemaObject | ReferenceObject)[];
+    anyOf?: (SchemaObject | ReferenceObject)[];
+    allOf?: (SchemaObject | ReferenceObject)[];
+    enum?: unknown[];
+    const?: unknown;
+    format?: string;
+    title?: string;
+    description?: string;
+    example?: unknown;
+    examples?: unknown[];
+    deprecated?: boolean;
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    minItems?: number;
+    maxItems?: number;
+    discriminator?: {
+        propertyName: string;
+    };
+    [key: string]: unknown;
+}
+export interface ReferenceObject {
+    $ref: string;
+}
+export interface SecuritySchemeObject {
+    type: "http" | "apiKey" | "userPassword" | "X509" | "symmetricEncryption" | "asymmetricEncryption" | "plain" | "scramSha256" | "scramSha512" | "gssapi" | "oauth2" | "openIdConnect";
+    scheme?: string;
+    description?: string;
+    name?: string;
+    in?: "user" | "password" | "query" | "header" | "cookie";
+}
+/** AsyncAPI 3.0 security: [{$ref: "#/components/securitySchemes/Name"}] */
+export type SecurityRequirementObject = ReferenceObject | {
+    [name: string]: string[];
+};
+//# sourceMappingURL=AsyncApiTypes.d.ts.map

package/dist/src/AsyncApiTypes.d.ts.map

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

package/dist/src/AsyncApiTypes.js

@@ -0,0 +1,6 @@
+/**
+ * Minimal AsyncAPI 3.0 type definitions.
+ * Only the subset used by @grest-ts/asyncapi — enough for correct spec generation.
+ */
+export {};
+//# sourceMappingURL=AsyncApiTypes.js.map

package/dist/src/AsyncApiTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncApiTypes.js","sourceRoot":"","sources":["../../src/AsyncApiTypes.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/GGAsyncApiDocs.d.ts

@@ -0,0 +1,73 @@
+import type { GGWebSocketSchema } from "@grest-ts/websocket";
+import { GGHttpServer } from "@grest-ts/http";
+import type { AsyncAPIDocument } from "./AsyncApiTypes";
+import { ToAsyncApiOptions } from "./toAsyncApi";
+export interface GGAsyncApiDocsOptions extends ToAsyncApiOptions {
+    /**
+     * Path where the JSON spec is served.
+     * e.g. "/asyncapi.json"
+     */
+    specPath: string;
+    /**
+     * Path where the AsyncAPI Studio UI is served.
+     * e.g. "/asyncapi-docs"
+     */
+    docsPath: string;
+    /**
+     * If true, build spec immediately on construction.
+     * @default false (lazy on first request)
+     */
+    eager?: boolean;
+    /**
+     * Explicit schema list. When provided, overrides server.registeredWebSocketSchemas.
+     */
+    schemas?: GGWebSocketSchema<any, any, any, any, any>[];
+    /**
+     * The HTTP server to register the docs routes on.
+     * When omitted, uses the default GGHttpServer from the locator — the same
+     * fallback as MyApi.register().
+     */
+    http?: GGHttpServer;
+}
+/**
+ * Serves GET /asyncapi.json and GET /asyncapi-docs (AsyncAPI Studio UI)
+ * for all WebSocket schemas registered on a GGHttpServer.
+ *
+ * Schemas are collected automatically from server.registeredWebSocketSchemas,
+ * or can be provided explicitly via options.schemas.
+ *
+ * @example
+ * // Mirrors MyApi.register() exactly — uses locator default when http is omitted:
+ * GGAsyncApiDocs.register({
+ *     title: "My Service Events",
+ *     version: "1.0.0",
+ *     specPath: "/asyncapi.json",
+ *     docsPath: "/asyncapi-docs"
+ * });
+ *
+ * @example
+ * // With explicit server (same as MyApi.register(impl, {http: server})):
+ * GGAsyncApiDocs.register({
+ *     title: "My Service Events",
+ *     specPath: "/asyncapi.json",
+ *     docsPath: "/asyncapi-docs",
+ *     http: server
+ * });
+ */
+export declare class GGAsyncApiDocs {
+    private readonly server;
+    private readonly options;
+    private _spec;
+    /**
+     * Register AsyncAPI docs routes on an HTTP server.
+     * Mirrors the MyApi.register() pattern exactly:
+     *   - options.http — explicit server (optional)
+     *   - when absent, uses the default GGHttpServer from the locator
+     */
+    static register(options: GGAsyncApiDocsOptions): void;
+    constructor(server: GGHttpServer, options: GGAsyncApiDocsOptions);
+    private buildSpec;
+    getSpec(): AsyncAPIDocument;
+    registerWith(server: GGHttpServer): this;
+}
+//# sourceMappingURL=GGAsyncApiDocs.d.ts.map

package/dist/src/GGAsyncApiDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGAsyncApiDocs.d.ts","sourceRoot":"","sources":["../../src/GGAsyncApiDocs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAC,YAAY,EAAiB,MAAM,gBAAgB,CAAC;AAE5D,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAa,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC5D;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAEvD;;;;OAIG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,KAAK,CAA+B;IAE5C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;gBAMzC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,qBAAqB;IAShE,OAAO,CAAC,SAAS;IAMV,OAAO,IAAI,gBAAgB;IAI3B,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;CAgClD"}

package/dist/src/GGAsyncApiDocs.js

@@ -0,0 +1,125 @@
+import { GG_HTTP_SERVER } from "@grest-ts/http";
+import { GGLocator } from "@grest-ts/locator";
+import { toAsyncApi } from "./toAsyncApi.js";
+/**
+ * Serves GET /asyncapi.json and GET /asyncapi-docs (AsyncAPI Studio UI)
+ * for all WebSocket schemas registered on a GGHttpServer.
+ *
+ * Schemas are collected automatically from server.registeredWebSocketSchemas,
+ * or can be provided explicitly via options.schemas.
+ *
+ * @example
+ * // Mirrors MyApi.register() exactly — uses locator default when http is omitted:
+ * GGAsyncApiDocs.register({
+ *     title: "My Service Events",
+ *     version: "1.0.0",
+ *     specPath: "/asyncapi.json",
+ *     docsPath: "/asyncapi-docs"
+ * });
+ *
+ * @example
+ * // With explicit server (same as MyApi.register(impl, {http: server})):
+ * GGAsyncApiDocs.register({
+ *     title: "My Service Events",
+ *     specPath: "/asyncapi.json",
+ *     docsPath: "/asyncapi-docs",
+ *     http: server
+ * });
+ */
+export class GGAsyncApiDocs {
+    server;
+    options;
+    _spec;
+    /**
+     * Register AsyncAPI docs routes on an HTTP server.
+     * Mirrors the MyApi.register() pattern exactly:
+     *   - options.http — explicit server (optional)
+     *   - when absent, uses the default GGHttpServer from the locator
+     */
+    static register(options) {
+        const server = options.http ?? GGLocator.getScope().get(GG_HTTP_SERVER);
+        if (!server)
+            throw new Error("GGAsyncApiDocs.register: no HTTP server found. Pass options.http or create a GGHttpServer first.");
+        new GGAsyncApiDocs(server, options);
+    }
+    constructor(server, options) {
+        this.server = server;
+        this.options = options;
+        if (options.eager) {
+            this._spec = this.buildSpec();
+        }
+        this.registerWith(server);
+    }
+    buildSpec() {
+        const schemas = this.options.schemas
+            ?? this.server.registeredWebSocketSchemas;
+        return toAsyncApi(schemas, this.options);
+    }
+    getSpec() {
+        return this._spec ??= this.buildSpec();
+    }
+    registerWith(server) {
+        const specPath = this.options.specPath;
+        const docsPath = this.options.docsPath;
+        server.registerRoute("GET", specPath, async (_req, res) => {
+            const spec = this.getSpec();
+            const body = JSON.stringify(spec, null, 2);
+            res.writeHead(200, {
+                "Content-Type": "application/json",
+                "Content-Length": Buffer.byteLength(body)
+            });
+            res.end(body);
+        });
+        // AsyncAPI Studio HTML — served for docsPath and all sub-paths so that
+        // sidebar deep-links (e.g. /asyncapi-docs/ChatApi_send_foo) stay on the
+        // same page instead of opening a new tab or returning 404.
+        const serveStudio = async (_req, res) => {
+            const spec = this.getSpec();
+            const html = buildAsyncApiStudioHtml(spec);
+            res.writeHead(200, {
+                "Content-Type": "text/html; charset=utf-8",
+                "Content-Length": Buffer.byteLength(html)
+            });
+            res.end(html);
+        };
+        server.registerRoute("GET", docsPath, serveStudio);
+        // Wildcard for deep-link navigation within the studio
+        server.registerRoute("GET", docsPath + "/*", serveStudio);
+        return this;
+    }
+}
+/**
+ * Build the AsyncAPI Studio HTML page with the spec embedded as inline JSON.
+ *
+ * The spec is passed directly as the schema object (not wrapped in {url:...} or
+ * {source:...}) — this is the correct API for inline document rendering and
+ * avoids both external fetches and internal $ref resolution failures.
+ *
+ * The wildcard route (docsPath/*) is registered alongside docsPath so that
+ * sidebar deep-links stay on the same page instead of opening a new tab.
+ */
+function buildAsyncApiStudioHtml(spec) {
+    // Pass the document directly as schema — AsyncApiStandalone accepts the plain object
+    const specJson = JSON.stringify(spec);
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <title>AsyncAPI Docs</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <link rel="icon" href="https://www.asyncapi.com/favicon.ico" />
+  <link rel="stylesheet" href="https://unpkg.com/@asyncapi/react-component@latest/styles/default.min.css">
+</head>
+<body>
+<div id="asyncapi"></div>
+<script src="https://unpkg.com/@asyncapi/react-component@latest/browser/standalone/index.js"></script>
+<script>
+  AsyncApiStandalone.render(
+    {schema: ${specJson}, config: {show: {sidebar: true}}},
+    document.getElementById('asyncapi')
+  );
+</script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=GGAsyncApiDocs.js.map

package/dist/src/GGAsyncApiDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGAsyncApiDocs.js","sourceRoot":"","sources":["../../src/GGAsyncApiDocs.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAE5C,OAAO,EAAC,UAAU,EAAoB,MAAM,cAAc,CAAC;AAkC3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,cAAc;IACN,MAAM,CAAe;IACrB,OAAO,CAAwB;IACxC,KAAK,CAA+B;IAE5C;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,OAA8B;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;QACjI,IAAI,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,YAAY,MAAoB,EAAE,OAA8B;QAC5D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAEO,SAAS;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO;eAC5B,IAAI,CAAC,MAAM,CAAC,0BAA2E,CAAC;QAChG,OAAO,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;IAC3C,CAAC;IAEM,YAAY,CAAC,MAAoB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAEvC,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;gBACf,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC5C,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,uEAAuE;QACvE,wEAAwE;QACxE,2DAA2D;QAC3D,MAAM,WAAW,GAAG,KAAK,EAAE,IAAS,EAAE,GAAQ,EAAE,EAAE;YAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAC3C,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;gBACf,cAAc,EAAE,0BAA0B;gBAC1C,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC5C,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QACnD,sDAAsD;QACtD,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC;QAE1D,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED;;;;;;;;;GASG;AACH,SAAS,uBAAuB,CAAC,IAAsB;IACnD,qFAAqF;IACrF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO;;;;;;;;;;;;;;eAcI,QAAQ;;;;;QAKf,CAAC;AACT,CAAC"}

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

@@ -0,0 +1,7 @@
+export { toAsyncApi } from "./toAsyncApi";
+export type { ToAsyncApiOptions } from "./toAsyncApi";
+export { GGAsyncApiDocs } from "./GGAsyncApiDocs";
+export type { GGAsyncApiDocsOptions } from "./GGAsyncApiDocs";
+export { GGAsyncApiDocs as GGAsyncApiServer } from "./GGAsyncApiDocs";
+export type { GGAsyncApiDocsOptions as GGAsyncApiServerOptions } from "./GGAsyncApiDocs";
+//# sourceMappingURL=index-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.d.ts","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AACxC,YAAY,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AACpD,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAC,cAAc,IAAI,gBAAgB,EAAC,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAC,qBAAqB,IAAI,uBAAuB,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/src/index-node.js

@@ -0,0 +1,5 @@
+export { toAsyncApi } from "./toAsyncApi.js";
+export { GGAsyncApiDocs } from "./GGAsyncApiDocs.js";
+// Backward-compatible aliases
+export { GGAsyncApiDocs as GGAsyncApiServer } from "./GGAsyncApiDocs.js";
+//# sourceMappingURL=index-node.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index-node.js","sourceRoot":"","sources":["../../src/index-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAExC,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAEhD,8BAA8B;AAC9B,OAAO,EAAC,cAAc,IAAI,gBAAgB,EAAC,MAAM,kBAAkB,CAAC"}

package/dist/src/toAsyncApi.d.ts

@@ -0,0 +1,27 @@
+import type { GGWebSocketSchema } from "@grest-ts/websocket";
+import type { AsyncAPIDocument } from "./AsyncApiTypes";
+export interface ToAsyncApiOptions {
+    title?: string;
+    version?: string;
+    description?: string;
+    servers?: Record<string, {
+        host: string;
+        protocol: "ws" | "wss";
+        description?: string;
+    }>;
+}
+/**
+ * Convert a list of GGWebSocketSchema instances to an AsyncAPI 3.0 document.
+ *
+ * Message patterns:
+ *   - clientToServer with success/errors: request/response (action:send + reply)
+ *   - clientToServer without success/errors: fire-and-forget (action:send, no reply)
+ *   - serverToClient with input: server push (action:receive, no reply)
+ *   - serverToClient with success/errors: server-initiated request (action:receive + reply)
+ *
+ * All patterns are symmetric: reply.messages lists ALL possible response messages
+ * (success + each error type), correctly modelling that both parties can receive
+ * any of them.
+ */
+export declare function toAsyncApi(schemas: GGWebSocketSchema<any, any, any, any, any>[], options?: ToAsyncApiOptions, serverPort?: number): AsyncAPIDocument;
+//# sourceMappingURL=toAsyncApi.d.ts.map

package/dist/src/toAsyncApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toAsyncApi.d.ts","sourceRoot":"","sources":["../../src/toAsyncApi.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAG3D,OAAO,KAAK,EACR,gBAAgB,EAGnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,iBAAiB;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,GAAG,KAAK,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CAC1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACtB,OAAO,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EACrD,OAAO,GAAE,iBAAsB,EAC/B,UAAU,CAAC,EAAE,MAAM,GACpB,gBAAgB,CAwKlB"}