@tertiumorganum/typespec-amqp-ws 0.0.2

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

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

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

@@ -0,0 +1,12 @@
+import type { DecoratorContext, Operation, Model } from "@typespec/compiler";
+export declare const namespace = "TspAsyncApi.WebSocket";
+export declare function $publish(context: DecoratorContext, target: Operation): void;
+export declare function $consume(context: DecoratorContext, target: Operation): void;
+export declare function $reply(context: DecoratorContext, target: Operation, replyType: Model): void;
+export declare function $binary(context: DecoratorContext, target: Operation): 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/ws/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/ws/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAS7E,eAAO,MAAM,SAAS,0BAA0B,CAAC;AAEjD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAE3E;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAE3F;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAE1E;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/ws/decorators.js

@@ -0,0 +1,18 @@
+import { WsPublishKey, WsConsumeKey, WsReplyKey, WsBinaryKey, MessageKey, } from "../shared/state.js";
+export const namespace = "TspAsyncApi.WebSocket";
+export function $publish(context, target) {
+    context.program.stateMap(WsPublishKey).set(target, true);
+}
+export function $consume(context, target) {
+    context.program.stateMap(WsConsumeKey).set(target, true);
+}
+export function $reply(context, target, replyType) {
+    context.program.stateMap(WsReplyKey).set(target, replyType);
+}
+export function $binary(context, target) {
+    context.program.stateMap(WsBinaryKey).set(target, true);
+}
+export function $message(context, target, config) {
+    context.program.stateMap(MessageKey).set(target, config);
+}
+//# sourceMappingURL=decorators.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../../src/ws/decorators.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,oBAAoB,CAAC;AAE5B,MAAM,CAAC,MAAM,SAAS,GAAG,uBAAuB,CAAC;AAEjD,MAAM,UAAU,QAAQ,CAAC,OAAyB,EAAE,MAAiB;IACnE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAyB,EAAE,MAAiB;IACnE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAyB,EAAE,MAAiB,EAAE,SAAgB;IACnF,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAyB,EAAE,MAAiB;IAClE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC1D,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/ws/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/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ws/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/ws/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, "ws");
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ws/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,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/lib/amqp.tsp

@@ -0,0 +1,83 @@
+import "../dist/src/amqp/decorators.js";
+
+using TypeSpec.Reflection;
+
+namespace TspAsyncApi.Amqp;
+
+@doc("Конфиг AMQP-обменника (exchange)")
+model ExchangeConfig {
+  @doc("Имя exchange в RabbitMQ")
+  name: string;
+
+  @doc("Тип exchange: direct либо fanout")
+  type: string;
+
+  @doc("Переживает рестарт брокера")
+  durable?: boolean;
+
+  @doc("Удаляется когда последний биндинг отвалился")
+  autoDelete?: boolean;
+}
+
+@doc("Конфиг AMQP-очереди (queue)")
+model QueueConfig {
+  @doc("Имя очереди в RabbitMQ")
+  name: string;
+
+  @doc("Переживает рестарт брокера")
+  durable?: boolean;
+
+  @doc("Удаляется когда последний consumer отвалился")
+  autoDelete?: boolean;
+
+  @doc("Эксклюзивная — только один consumer")
+  exclusive?: boolean;
+}
+
+@doc("Конфиг операции-publisher (action: send)")
+model PublishConfig {
+  @doc("Имя канала в YAML (override). Default — имя операции верзатим")
+  channelName?: string;
+
+  @doc("Routing key. Может быть опущен для fanout exchange")
+  routingKey?: string;
+
+  @doc("Exchange, в который публикуется сообщение")
+  exchange: ExchangeConfig;
+}
+
+@doc("Конфиг операции-consumer (action: receive)")
+model ConsumeConfig {
+  @doc("Имя канала в YAML (override)")
+  channelName?: string;
+
+  @doc("Routing key (биндинг очереди к exchange)")
+  routingKey?: string;
+
+  @doc("Очередь, из которой читаются сообщения")
+  queue: QueueConfig;
+}
+
+@doc("Override параметров сообщения")
+model MessageOverride {
+  @doc("Имя ключа сообщения в YAML")
+  name?: string;
+
+  @doc("Краткое описание сообщения")
+  summary?: string;
+}
+
+/**
+ * Операция-publisher: сервис отправляет сообщение в exchange.
+ * → AsyncAPI action: send.
+ */
+extern dec publish(target: Operation, config: valueof PublishConfig);
+
+/**
+ * Операция-consumer: сервис читает сообщения из очереди.
+ * → AsyncAPI action: receive.
+ */
+extern dec consume(target: Operation, config: valueof ConsumeConfig);
+
+/** Override параметров сообщения, выводимого эмиттером */
+extern dec message(target: Operation, config: valueof MessageOverride);

package/lib/main.tsp

@@ -0,0 +1,65 @@
+import "../dist/src/index.js";
+import "../dist/src/shared/decorators-service.js";
+
+import "./amqp.tsp";
+import "./ws.tsp";
+
+using TypeSpec.Reflection;
+
+namespace TspAsyncApi;
+
+@doc("Контактные данные владельца API")
+model ContactInfo {
+  name?: string;
+  url?: string;
+  email?: string;
+}
+
+@doc("Лицензия API")
+model LicenseInfo {
+  name: string;
+  url?: string;
+}
+
+@doc("Ссылка на внешнюю документацию")
+model ExternalDocs {
+  url: string;
+  description?: string;
+}
+
+@doc("Блок info AsyncAPI документа")
+model InfoConfig {
+  version: string;
+  description?: string;
+  contact?: ContactInfo;
+  license?: LicenseInfo;
+  externalDocs?: ExternalDocs;
+}
+
+@doc("Переменная в шаблоне URL сервера (например, {port})")
+model ServerVariable {
+  `default`?: string;
+  description?: string;
+  `enum`?: string[];
+}
+
+@doc("Описание сервера (брокера). Соответствует одному ключу в servers AsyncAPI")
+model ServerConfig {
+  host: string;
+  protocol: string;
+  pathname?: string;
+  description?: string;
+  variables?: Record<ServerVariable>;
+}
+
+/**
+ * Заполняет блок info AsyncAPI документа.
+ * Применяется к корневому namespace сервиса (тому же, к которому @service).
+ */
+extern dec info(target: Namespace, options: valueof InfoConfig);
+
+/**
+ * Добавляет одну запись в блок servers AsyncAPI документа.
+ * Можно вызывать многократно для нескольких серверов.
+ */
+extern dec server(target: Namespace, name: valueof string, options: valueof ServerConfig);

package/lib/ws.tsp

@@ -0,0 +1,42 @@
+import "../dist/src/ws/decorators.js";
+
+using TypeSpec.Reflection;
+
+namespace TspAsyncApi.WebSocket;
+
+@doc("Override параметров сообщения")
+model MessageOverride {
+  @doc("Имя ключа сообщения в YAML")
+  name?: string;
+
+  @doc("Краткое описание сообщения")
+  summary?: string;
+}
+
+/**
+ * Операция-publisher: сервис отправляет сообщение.
+ * → AsyncAPI action: send.
+ * Все WS-операции по умолчанию на канале "/".
+ */
+extern dec publish(target: Operation);
+
+/**
+ * Операция-consumer: сервис принимает сообщение.
+ * → AsyncAPI action: receive.
+ */
+extern dec consume(target: Operation);
+
+/**
+ * Указывает модель ответного сообщения (request/reply pattern).
+ * Реплай-сообщение автоматически добавится в канал и components.messages.
+ */
+extern dec reply(target: Operation, replyType: Model);
+
+/**
+ * Помечает сообщение операции как бинарное.
+ * → components.messages.X.contentType: application/octet-stream
+ */
+extern dec binary(target: Operation);
+
+/** Override параметров сообщения */
+extern dec message(target: Operation, config: valueof MessageOverride);

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@tertiumorganum/typespec-amqp-ws",
+  "version": "0.0.2",
+  "description": "TypeSpec emitter for AsyncAPI 3.0 covering AMQP (RabbitMQ) and WebSocket transports",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./amqp": {
+      "import": "./dist/src/amqp/index.js",
+      "types": "./dist/src/amqp/index.d.ts"
+    },
+    "./ws": {
+      "import": "./dist/src/ws/index.js",
+      "types": "./dist/src/ws/index.d.ts"
+    },
+    "./testing": {
+      "import": "./dist/src/testing.js",
+      "types": "./dist/src/testing.d.ts"
+    }
+  },
+  "tspMain": "./lib/main.tsp",
+  "scripts": {
+    "build": "tsc -b",
+    "watch": "tsc -b --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist coverage *.tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@typespec/compiler": "^1.12.0",
+    "@typespec/asset-emitter": "^0.79.0"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@typespec/compiler": "^1.12.0",
+    "@typespec/asset-emitter": "^0.79.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "files": [
+    "dist/src/**",
+    "lib/**",
+    "README.md",
+    "LICENSE"
+  ]
+}