@tertiumorganum/typespec-amqp-ws 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 typespec-amqp-ws contributors
+
+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,291 @@
+# @tertiumorganum/typespec-amqp-ws
+
+TypeSpec-эмиттер для генерации **AsyncAPI 3.0** спецификаций из лаконичных TypeSpec-описаний. Поддерживает два транспорта:
+
+- **AMQP** (RabbitMQ): publish в exchange, consume из queue, типы exchange `direct` и `fanout`.
+- **WebSocket**: единый канал `/`, дискриминатор сообщений через literal-типы, request/reply, бинарные сообщения.
+
+Эмиттер сознательно **ограничен** — поддерживает только то подмножество AsyncAPI, которое реально применяется на практике в типичных микросервисах с RabbitMQ и WebSocket. Это упрощает реализацию, валидацию и сопровождение.
+
+## Установка
+
+```bash
+npm install -D @tertiumorganum/typespec-amqp-ws @typespec/compiler @typespec/asset-emitter
+```
+
+Требования: Node.js 22+.
+
+## Конфигурация
+
+В `tspconfig.yaml` сервиса выбирается один из двух emit-таргетов:
+
+```yaml
+# Для сервиса с AMQP/RabbitMQ:
+emit:
+  - "@tertiumorganum/typespec-amqp-ws/amqp"
+options:
+  "@tertiumorganum/typespec-amqp-ws/amqp":
+    file-type: yaml          # yaml | json. Default: yaml
+    output-file: "asyncapi.yaml"
+    new-line: "lf"           # lf | crlf. Default: lf
+output-dir: "{project-root}/tsp-output"
+```
+
+```yaml
+# Для сервиса с WebSocket-API:
+emit:
+  - "@tertiumorganum/typespec-amqp-ws/ws"
+output-dir: "{project-root}/tsp-output"
+```
+
+Запуск:
+
+```bash
+tsp compile .
+```
+
+Полученный `asyncapi.yaml` можно скармливать `@asyncapi/cli` для генерации моделей на Go/TypeScript и `@redocly/cli` для документации.
+
+## Полный AMQP-пример
+
+```typespec
+import "@tertiumorganum/typespec-amqp-ws";
+
+using TspAsyncApi;
+using TspAsyncApi.Amqp;
+
+@service(#{ title: "Notifications Service" })
+@info(#{
+  version: "1.0.0",
+  description: "Сервис рассылки уведомлений через RabbitMQ",
+})
+@server("rabbit", #{
+  host: "rabbit.example.com:5672",
+  pathname: "/notifications",
+  protocol: "amqp",
+  description: "RabbitMQ-сервер",
+})
+namespace Notifications;
+
+@doc("Уведомление пользователю")
+model Notification {
+  @doc("Идентификатор уведомления")
+  notificationId: string;
+
+  @doc("Текст уведомления")
+  text: string;
+}
+
+// PUBLISH: один декоратор содержит всё — routing key, exchange, тип.
+@publish(#{
+  routingKey: "notifications.created",
+  exchange: #{
+    name: "notifications-exchange",
+    type: "direct",
+    durable: true,
+  },
+})
+@summary("Опубликовать новое уведомление")
+op sendNotification(): Notification;
+
+// CONSUME: чтение из именованной очереди, биндинг по routing key.
+@consume(#{
+  routingKey: "notifications.acknowledge",
+  queue: #{
+    name: "notifications-ack-queue",
+    durable: true,
+    autoDelete: false,
+  },
+})
+@summary("Обработать подтверждение доставки")
+op handleAck(): Notification;
+```
+
+Результат компиляции — валидный AsyncAPI 3.0 YAML с двумя каналами, операциями и AMQP-биндингами.
+
+## Полный WebSocket-пример
+
+```typespec
+import "@tertiumorganum/typespec-amqp-ws";
+
+using TspAsyncApi;
+using TspAsyncApi.WebSocket;
+
+@service(#{ title: "Chat WS" })
+@info(#{ version: "1.0.0" })
+@server("public", #{
+  host: "localhost:{port}",
+  protocol: "ws",
+  pathname: "/chat",
+  variables: #{
+    port: #{ `default`: "8080", description: "Порт WS-сервера" },
+  },
+})
+namespace Chat;
+
+// Дискриминатор сообщения — обычное поле литерального типа.
+// Эмиттер выведет { type: "string", const: "userJoined" } в JSON Schema.
+model UserJoined {
+  eventType: "userJoined";
+  msgUid: string;
+  userId: string;
+  nickname: string;
+}
+
+model SendMessage {
+  eventType: "sendMessage";
+  msgUid: string;
+  text: string;
+}
+
+model SendMessageResponse {
+  eventType: "sendMessageResponse";
+  msgUid: string;
+  ok: boolean;
+}
+
+// Receive: сервер получает сообщение от клиента
+@consume
+@summary("Пользователь подключился к чату")
+op userJoined(): UserJoined;
+
+// Send + reply: request/reply pattern
+@publish
+@reply(SendMessageResponse)
+@summary("Отправить сообщение в чат")
+op sendMessage(): SendMessage;
+```
+
+Все WebSocket-операции автоматически складываются на единый канал `/`. Это типичный паттерн WebSocket-API, где дискриминация сообщений происходит через literal-поле модели (например, `eventType`).
+
+## Поддерживаемые TypeSpec-типы
+
+| TypeSpec | JSON Schema | Кодген (Go / TS / C++) |
+|---|---|---|
+| `string` | `{ type: string }` | `string` / `string` / `std::string` |
+| `boolean` | `{ type: boolean }` | `bool` / `boolean` / `bool` |
+| `integer` | `{ type: integer }` | `int32` / `number` / `int` |
+| `bytes` | `{ type: string, format: binary }` | `[]byte` / `Uint8Array` / `std::vector<uint8_t>` |
+| `enum X { A, B }` | `{ type: string, enum: [A, B] }` | string-typedef |
+| `scalar X extends string` | именованная схема `{ type: string }` | string-typedef |
+| `model X { ... }` | `{ type: object, properties, required, additionalProperties: false }` | struct/interface |
+| `T[]` | `{ type: array, items: <T> }` | slice/array |
+| `Record<T>` | `{ type: object, additionalProperties: <T> }` | `map[string]T` / `Record<string, T>` |
+| literal `"foo"` | `{ type: string, const: "foo" }` | константа |
+| `T \| null` | `{ type: [<base>, null] }` | pointer / nullable |
+| `foo?: T` | поле не входит в `required` | опциональное поле |
+
+### Запрещённые типы
+
+Эти типы вызывают **ошибку компиляции** — намеренно, ради переносимости между языками:
+
+| Тип | Почему запрещён |
+|---|---|
+| `int8`/`int16`/`int32`, `uint8`/`uint16`/`uint32` | Codegen всё равно генерирует signed `int32` / `number` для всех ширин. Размер-специфичные типы создают ложное ожидание сохранения семантики. Используйте `integer`. |
+| `int64`/`uint64` | 64-битные числа должны передаваться как `string` (JS не умеет точно представлять 64-битные числа в JSON). Поясните формат в `@doc`. |
+| `float32`/`float64`/`decimal`/`decimal128` | Числа с плавающей точкой — через `string` во избежание потерь точности на границе языков. |
+| `safeint`/`numeric` | Неоднозначно для кодогенерации. Используйте `integer`. |
+| `utcDateTime`/`plainDate`/`plainTime`/`duration` | Дата/время — это `string` в RFC-3339. TypeScript-codegen иначе подставляет `Date`, что ломает разбор в разных локалях. |
+| `url` | URL — это `string`. |
+
+### Запрет анонимных моделей
+
+```typespec
+// ❌ Нельзя — ошибка эмиттера
+model M {
+  payload: { foo: string };
+}
+
+// ✅ Только через явно объявленную модель
+model MPayload { foo: string; }
+model M { payload: MPayload; }
+```
+
+Обоснование: детерминированные имена в выводе важнее лаконичности. `modelina` (генератор моделей AsyncAPI) требует осмысленных имён, и авто-генерация ненадёжна.
+
+## Декораторы
+
+### Сервис
+
+| Декоратор | Назначение |
+|---|---|
+| `@service(#{ title })` | Стандартный из `@typespec/compiler`. Маркирует namespace как сервис. |
+| `@info(#{ version, description?, contact?, license?, externalDocs? })` | Метаданные info-блока AsyncAPI. |
+| `@server(name, #{ host, protocol, pathname?, description?, variables? })` | Описание одного брокера/сервера. Можно вызывать несколько раз. |
+
+### AMQP
+
+| Декоратор | Назначение |
+|---|---|
+| `@publish(#{ channelName?, routingKey?, exchange })` | Операция-publisher → `action: send`. Exchange-типы: `direct`, `fanout`. |
+| `@consume(#{ channelName?, routingKey?, queue })` | Операция-consumer → `action: receive`. |
+| `@summary(text)` | Стандартный из `@typespec/compiler`. Short summary операции. |
+| `@message(#{ name?, summary? })` | Override параметров сгенерированного message. |
+| `@doc(text)` | Стандартный. Длинное описание (description). |
+
+### WebSocket
+
+| Декоратор | Назначение |
+|---|---|
+| `@publish` | Без аргументов. Операция → `action: send`. |
+| `@consume` | Без аргументов. Операция → `action: receive`. |
+| `@reply(MessageModel)` | Указывает модель сообщения-ответа (request/reply pattern). |
+| `@binary` | Помечает сообщение как бинарное → `contentType: application/octet-stream`. |
+| `@message`, `@summary`, `@doc` | Как в AMQP. |
+
+## Принципы преобразования
+
+1. **`additionalProperties: false`** — по умолчанию на всех моделях. Намеренное отличие от `@typespec/openapi3`: мы не разрешаем произвольные поля без явного указания.
+2. **Поле с `@doc`, ссылающееся на скаляр** — оборачивается в `allOf` с описанием. Копия поведения `@typespec/openapi3`: JSON Schema не допускает соседства `$ref` с `description`.
+3. **Namespace prefix**: вложенные namespace дают префикс через точку (`outer.Inner`). Top-level service-namespace в префикс не входит. Соответствует `@typespec/openapi3`.
+4. **AsyncAPI 3.0.0** — выбранная версия. 3.1 backward-совместима, но 3.0 проверена на широкой инструментальной поддержке.
+
+## Диагностика
+
+Все диагностики с префиксом `@tertiumorganum/typespec-amqp-ws/`:
+
+- `unsupported-sized-int`, `unsupported-int64`, `unsupported-float`, `unsupported-fuzzy-numeric`, `unsupported-temporal`, `unsupported-url` — попытка использовать запрещённый тип.
+- `anonymous-model`, `anonymous-return` — анонимная inline-модель.
+- `non-string-enum`, `invalid-enum-value` — некорректный enum.
+- `unknown-exchange-type` — неподдерживаемый тип exchange (только `direct`, `fanout`).
+- `unsupported-union` — union, не являющийся `T | null`.
+- `missing-doc` (warning) — модель/enum без `@doc`.
+
+## Out of scope (v1)
+
+Намеренно **не реализовано** в v1 — добавляется при реальной потребности:
+
+- Транспорты Kafka, MQTT, HTTP/SSE, SNS/SQS.
+- Exchange types `topic`, `headers`.
+- AsyncAPI security schemes.
+- `correlationId`.
+- Traits (`channelTraits`, `operationTraits`, `messageTraits`).
+- AsyncAPI extensions (`x-` properties).
+- Polymorphism: пользовательские `oneOf`/`anyOf`/`allOf`.
+- TypeSpec `@versioned` интеграция.
+- Numeric-валуированные enum.
+- `@tag` на operations.
+- AsyncAPI 3.1.
+- JSON output (только YAML).
+
+## Документация
+
+Подробная документация — в [docs/](docs/):
+- [docs/usage.md](docs/usage.md) — установка, конфигурация, синтаксис, поддерживаемые типы, типичные сценарии.
+- [docs/architecture.md](docs/architecture.md) — внутреннее устройство эмиттера, ключевые решения, точки расширения.
+
+## Примеры
+
+В [examples/](examples/):
+- `amqp-publish.tsp` — простой AMQP publisher.
+- `amqp-consume.tsp` — простой AMQP consumer.
+- `ws-discriminator.tsp` — WebSocket с literal-дискриминатором.
+- `ws-reply.tsp` — WebSocket с request/reply.
+
+## Контрибьюции
+
+Pull-requests и issues приветствуются. Это утилита под конкретный воркфлоу; решения по новым фичам принимаются исходя из того, насколько они вписываются в принцип "узкий набор фич для типичных кейсов".
+
+## Лицензия
+
+[MIT](LICENSE).

package/dist/src/amqp/builder.d.ts

@@ -0,0 +1,4 @@
+import type { Program } from "@typespec/compiler";
+import type { AsyncApiDoc } from "../shared/document.js";
+export declare function buildAmqp(program: Program, doc: AsyncApiDoc): void;
+//# sourceMappingURL=builder.d.ts.map

package/dist/src/amqp/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/amqp/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,oBAAoB,CAAC;AAG7D,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,uBAAuB,CAAC;AAU/B,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CASlE"}

package/dist/src/amqp/builder.js

@@ -0,0 +1,121 @@
+import { navigateProgram, getDoc, getSummary } from "@typespec/compiler";
+import { AmqpPublishKey, AmqpConsumeKey, MessageKey } from "../shared/state.js";
+import { reportDiagnostic } from "../shared/lib.js";
+export function buildAmqp(program, doc) {
+    navigateProgram(program, {
+        operation(op) {
+            const pub = program.stateMap(AmqpPublishKey).get(op);
+            const con = program.stateMap(AmqpConsumeKey).get(op);
+            if (pub)
+                attachPublish(program, doc, op, pub);
+            else if (con)
+                attachConsume(program, doc, op, con);
+        },
+    });
+}
+function attachPublish(program, doc, op, config) {
+    const ctx = prepareCommon(program, doc, op, config.channelName);
+    if (!ctx)
+        return;
+    const { channelKey, messageKey, returnTypeName } = ctx;
+    const channel = doc.channels[channelKey] ?? {};
+    if (config.routingKey)
+        channel.address = config.routingKey;
+    channel.bindings = {
+        ...(channel.bindings ?? {}),
+        amqp: {
+            is: "routingKey",
+            exchange: cleanExchange(config.exchange),
+        },
+    };
+    channel.messages = channel.messages ?? {};
+    channel.messages[messageKey] = { $ref: `#/components/messages/${messageKey}` };
+    doc.channels[channelKey] = channel;
+    registerMessage(program, doc, op, messageKey, returnTypeName);
+    registerOperation(program, doc, op, channelKey, messageKey, "send");
+}
+function attachConsume(program, doc, op, config) {
+    const ctx = prepareCommon(program, doc, op, config.channelName);
+    if (!ctx)
+        return;
+    const { channelKey, messageKey, returnTypeName } = ctx;
+    const channel = doc.channels[channelKey] ?? {};
+    if (config.routingKey)
+        channel.address = config.routingKey;
+    channel.bindings = {
+        ...(channel.bindings ?? {}),
+        amqp: {
+            is: "queue",
+            queue: cleanQueue(config.queue),
+        },
+    };
+    channel.messages = channel.messages ?? {};
+    channel.messages[messageKey] = { $ref: `#/components/messages/${messageKey}` };
+    doc.channels[channelKey] = channel;
+    registerMessage(program, doc, op, messageKey, returnTypeName);
+    registerOperation(program, doc, op, channelKey, messageKey, "receive");
+}
+function prepareCommon(program, doc, op, channelNameOverride) {
+    const rt = op.returnType;
+    if (rt.kind !== "Model" || !rt.name) {
+        reportDiagnostic(program, {
+            code: "anonymous-return",
+            target: op,
+            format: { op: op.name },
+        });
+        return undefined;
+    }
+    const channelKey = channelNameOverride ?? op.name;
+    const override = program.stateMap(MessageKey).get(op);
+    const messageKey = override?.name ?? lowerFirst(rt.name);
+    doc.channels = doc.channels ?? {};
+    doc.operations = doc.operations ?? {};
+    doc.components = doc.components ?? {};
+    doc.components.messages = doc.components.messages ?? {};
+    return { channelKey, messageKey, returnTypeName: rt.name };
+}
+function registerMessage(program, doc, op, messageKey, returnTypeName) {
+    const override = program.stateMap(MessageKey).get(op);
+    const message = {
+        payload: { $ref: `#/components/schemas/${returnTypeName}` },
+    };
+    if (override?.summary)
+        message.summary = override.summary;
+    doc.components.messages[messageKey] = message;
+}
+function registerOperation(program, doc, op, channelKey, messageKey, action) {
+    const summary = getSummary(program, op);
+    const description = getDoc(program, op);
+    const operation = {
+        action,
+        channel: { $ref: `#/channels/${channelKey}` },
+        messages: [{ $ref: `#/channels/${channelKey}/messages/${messageKey}` }],
+    };
+    if (summary)
+        operation.summary = summary;
+    if (description)
+        operation.description = description;
+    doc.operations[op.name] = operation;
+}
+function cleanExchange(e) {
+    const out = { name: e.name, type: e.type };
+    if (e.durable !== undefined)
+        out.durable = e.durable;
+    if (e.autoDelete !== undefined)
+        out.autoDelete = e.autoDelete;
+    return out;
+}
+function cleanQueue(q) {
+    const out = { name: q.name };
+    if (q.durable !== undefined)
+        out.durable = q.durable;
+    if (q.autoDelete !== undefined)
+        out.autoDelete = q.autoDelete;
+    if (q.exclusive !== undefined)
+        out.exclusive = q.exclusive;
+    return out;
+}
+function lowerFirst(s) {
+    return s.length === 0 ? s : s[0].toLowerCase() + s.slice(1);
+}
+//# sourceMappingURL=builder.js.map

package/dist/src/amqp/builder.js.map

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

package/dist/src/amqp/decorators.d.ts

@@ -0,0 +1,32 @@
+import type { DecoratorContext, Operation } from "@typespec/compiler";
+export declare const namespace = "TspAsyncApi.Amqp";
+export interface ExchangeConfig {
+    name: string;
+    type: string;
+    durable?: boolean;
+    autoDelete?: boolean;
+}
+export interface QueueConfig {
+    name: string;
+    durable?: boolean;
+    autoDelete?: boolean;
+    exclusive?: boolean;
+}
+export interface PublishConfig {
+    channelName?: string;
+    routingKey?: string;
+    exchange?: ExchangeConfig;
+}
+export interface ConsumeConfig {
+    channelName?: string;
+    routingKey?: string;
+    queue?: QueueConfig;
+}
+export declare function $publish(context: DecoratorContext, target: Operation, config: PublishConfig): void;
+export declare function $consume(context: DecoratorContext, target: Operation, config: ConsumeConfig): void;
+export interface MessageOverride {
+    name?: string;
+    summary?: string;
+}
+export declare function $message(context: DecoratorContext, target: Operation, config: MessageOverride): void;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/src/amqp/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/amqp/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAItE,eAAO,MAAM,SAAS,qBAAqB,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAID,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,GACpB,IAAI,CAkBN;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,GACpB,IAAI,CAUN;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,QAAQ,CACtB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,eAAe,GACtB,IAAI,CAEN"}

package/dist/src/amqp/decorators.js

@@ -0,0 +1,38 @@
+import { AmqpPublishKey, AmqpConsumeKey, MessageKey } from "../shared/state.js";
+import { reportDiagnostic } from "../shared/lib.js";
+export const namespace = "TspAsyncApi.Amqp";
+const ALLOWED_EXCHANGE_TYPES = new Set(["direct", "fanout"]);
+export function $publish(context, target, config) {
+    if (!config.exchange) {
+        reportDiagnostic(context.program, {
+            code: "publish-without-exchange",
+            target,
+            format: {},
+        });
+        return;
+    }
+    if (!ALLOWED_EXCHANGE_TYPES.has(config.exchange.type)) {
+        reportDiagnostic(context.program, {
+            code: "unknown-exchange-type",
+            target,
+            format: { type: config.exchange.type },
+        });
+        return;
+    }
+    context.program.stateMap(AmqpPublishKey).set(target, config);
+}
+export function $consume(context, target, config) {
+    if (!config.queue) {
+        reportDiagnostic(context.program, {
+            code: "consume-without-queue",
+            target,
+            format: {},
+        });
+        return;
+    }
+    context.program.stateMap(AmqpConsumeKey).set(target, config);
+}
+export function $message(context, target, config) {
+    context.program.stateMap(MessageKey).set(target, config);
+}
+//# sourceMappingURL=decorators.js.map

package/dist/src/amqp/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../src/amqp/decorators.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,CAAC,MAAM,SAAS,GAAG,kBAAkB,CAAC;AA4B5C,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7D,MAAM,UAAU,QAAQ,CACtB,OAAyB,EACzB,MAAiB,EACjB,MAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE;YAChC,IAAI,EAAE,0BAA0B;YAChC,MAAM;YACN,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE;YAChC,IAAI,EAAE,uBAAuB;YAC7B,MAAM;YACN,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;SACvC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,OAAyB,EACzB,MAAiB,EACjB,MAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE;YAChC,IAAI,EAAE,uBAAuB;YAC7B,MAAM;YACN,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAOD,MAAM,UAAU,QAAQ,CACtB,OAAyB,EACzB,MAAiB,EACjB,MAAuB;IAEvB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/amqp/index.d.ts

@@ -0,0 +1,5 @@
+import type { EmitContext } from "@typespec/compiler";
+import { $lib, type EmitterOptions } from "../shared/lib.js";
+export { $lib };
+export declare function $onEmit(context: EmitContext<EmitterOptions>): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/amqp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/amqp/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG7D,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjF"}

package/dist/src/amqp/index.js

@@ -0,0 +1,7 @@
+import { $lib } from "../shared/lib.js";
+import { emitAsyncApi } from "../shared/asyncapi-emitter.js";
+export { $lib };
+export async function $onEmit(context) {
+    await emitAsyncApi(context, "amqp");
+}
+//# sourceMappingURL=index.js.map

package/dist/src/amqp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/amqp/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAuB,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAoC;IAChE,MAAM,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { $lib } from "./shared/lib.js";
+export type { EmitterOptions } from "./shared/lib.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,5 @@
+// Корневая точка пакета. Регистрирует $lib (общая на оба emit-таргета).
+// Декораторы JS реализованы в отдельных модулях (./shared/decorators-service.ts, ./amqp/decorators.ts, ./ws/decorators.ts),
+// чтобы у каждого было своё `export const namespace = "..."` для TypeSpec-связки.
+export { $lib } from "./shared/lib.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,4HAA4H;AAC5H,kFAAkF;AAElF,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/shared/asyncapi-emitter.d.ts

@@ -0,0 +1,5 @@
+import type { EmitContext } from "@typespec/compiler";
+import type { EmitterOptions } from "./options.js";
+export type EmitTarget = "amqp" | "ws";
+export declare function emitAsyncApi(context: EmitContext<EmitterOptions>, target: EmitTarget): Promise<void>;
+//# sourceMappingURL=asyncapi-emitter.d.ts.map

package/dist/src/shared/asyncapi-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncapi-emitter.d.ts","sourceRoot":"","sources":["../../../src/shared/asyncapi-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,oBAAoB,CAAC;AAcjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;AAEvC,wBAAsB,YAAY,CAChC,OAAO,EAAE,WAAW,CAAC,cAAc,CAAC,EACpC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCf"}