@ir-kit/asyncapi-typescript 0.1.0

package/dist/orchestrator.js

@@ -0,0 +1,63 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
+import { defaultExtensions, defaultModuleEntryNames, defaultNameConflictResolvers, Project, simpleNameConflictResolver, } from "@hey-api/codegen-core";
+import { assertSafeOutputDir } from "@ir-kit/codegen-core";
+import { RawTextRenderer, TsStatementRenderer } from "./ast/ts-renderer.js";
+import {} from "./plugin.js";
+import { loadDocument } from "./runtime/load-document.js";
+import { orderPlugins } from "./runtime/order-plugins.js";
+import { createPluginInstance } from "./runtime/plugin-instance.js";
+export async function generate(opts) {
+    const document = await loadDocument(opts.input);
+    const outputDir = resolve(opts.output);
+    assertSafeOutputDir(outputDir);
+    // Plugin → renderer side channel; codegen-core File has no metadata slot.
+    const headers = new Map();
+    const project = new Project({
+        root: outputDir,
+        defaultFileName: "index",
+        defaultNameConflictResolver: simpleNameConflictResolver,
+        extensions: defaultExtensions,
+        moduleEntryNames: defaultModuleEntryNames,
+        nameConflictResolvers: defaultNameConflictResolvers,
+        renderers: [new TsStatementRenderer(headers), new RawTextRenderer()],
+    });
+    const apiRegistry = new Map();
+    const filesEmitted = [];
+    for (const reg of orderPlugins(opts.plugins)) {
+        const def = reg.__definition;
+        if (def.api !== undefined)
+            apiRegistry.set(def.name, def.api);
+        const config = def.resolveConfig
+            ? def.resolveConfig(reg.__userConfig, { document })
+            : { ...def.defaultConfig, ...(reg.__userConfig ?? {}) };
+        const instance = createPluginInstance(def.name, config, def.api, {
+            document,
+            project,
+            files: filesEmitted,
+            apiRegistry,
+            headers,
+        });
+        if (def.hooks?.before)
+            await def.hooks.before(instance);
+        await def.handler(instance);
+        if (def.hooks?.after)
+            await def.hooks.after(instance);
+    }
+    project.plan();
+    return writeRenderedFiles(project.render(), outputDir);
+}
+async function writeRenderedFiles(rendered, outputDir) {
+    await mkdir(outputDir, { recursive: true });
+    const written = [];
+    for (const out of rendered) {
+        if (!out.path)
+            continue;
+        const abs = isAbsolute(out.path) ? out.path : join(outputDir, out.path);
+        await mkdir(dirname(abs), { recursive: true });
+        await writeFile(abs, out.content, "utf8");
+        written.push({ path: relative(outputDir, abs), content: out.content });
+    }
+    return { output: outputDir, files: written };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Plugin contract for `@ir-kit/asyncapi-typescript`.
+ *
+ * Shape mirrors `@hey-api/openapi-ts`'s `definePluginConfig` / plugin
+ * instance pattern, adapted to AsyncAPI primitives. Plugins are
+ * authored as definitions and registered via factory call:
+ *
+ *   export const myPlugin = definePluginConfig({
+ *     name: "my-plugin",
+ *     defaultConfig: { ... },
+ *     dependsOn: ["typescript"],
+ *     handler: async (plugin) => {
+ *       for (const ev of plugin.forEach("message")) { ... }
+ *       plugin.emit({ path: "out.gen.ts", content: "..." });
+ *     },
+ *   });
+ *
+ *   // caller:
+ *   generate({ plugins: [myPlugin({ ... }), ...], ... });
+ */
+import type { AsyncAPIDocumentInterface, ChannelInterface, MessageInterface, OperationInterface } from "@asyncapi/parser";
+import type ts from "typescript";
+export interface GeneratedFile {
+    /** Path relative to the configured output directory. */
+    path: string;
+    content: string;
+}
+/**
+ * One named-import group. The `from` path is the logical (extension-free)
+ * file path of another plugin's file in the same project — e.g. the
+ * `events` plugin emits `events.gen.ts`, so reference it as `"events.gen"`.
+ * The renderer resolves that to a relative path between source and importer
+ * at print time.
+ */
+export interface EmitTsImportGroup {
+    /** Logical path of the source file (no extension). */
+    from: string;
+    /** Names being imported. `isType` adds a per-specifier `type` modifier. */
+    names: ReadonlyArray<{
+        name: string;
+        isType?: boolean;
+    }>;
+    /** Top-level `import type { ... }` (vs `import { ..., type X }`). */
+    isType?: boolean;
+}
+export interface EmitTsOptions {
+    header?: string;
+    imports?: ReadonlyArray<EmitTsImportGroup>;
+}
+export type ForEachKind = "message" | "channel" | "operation";
+export type ForEachEvent = {
+    type: "message";
+    message: MessageInterface;
+} | {
+    type: "channel";
+    channel: ChannelInterface;
+} | {
+    type: "operation";
+    operation: OperationInterface;
+};
+/**
+ * What a plugin's handler receives. Strongly typed against the plugin's
+ * own `Config` and `Api` so config / api access doesn't degrade to `any`.
+ */
+export interface PluginInstance<Config = unknown, Api = unknown> {
+    /** Plugin's stable identifier. */
+    readonly name: string;
+    /** Resolved config — defaults merged with user overrides (and `resolveConfig`). */
+    readonly config: Config;
+    /** Plugin's own api object — typed straight through from the definition. */
+    readonly api: Api;
+    /** The parsed AsyncAPI document. */
+    readonly document: AsyncAPIDocumentInterface;
+    /** Files emitted so far (by this and prior plugins). */
+    readonly files: ReadonlyArray<GeneratedFile>;
+    /** Add a file to the output as raw text. Use for Modelina output, copied bundles, etc. */
+    emit(file: GeneratedFile): void;
+    /**
+     * Add a file to the output as a list of `ts.Statement` AST nodes; the
+     * `TsStatementRenderer` prints them at render time. Optional `header`
+     * is attached as a leading comment on the first statement. Use this
+     * over `emit` for plugin output you construct via `ts.factory`.
+     *
+     * Cross-file imports go through `options.imports` (graph-driven), not
+     * inline `ts.factory.createImportDeclaration` calls — the underlying
+     * codegen-core `File.addImport` resolves source files into relative
+     * paths at print time, so imports survive file moves and rename
+     * collision resolution.
+     */
+    emitTs(path: string, statements: ReadonlyArray<ts.Statement>, options?: EmitTsOptions): void;
+    /** Look up another plugin's api by name. Returns `undefined` if absent. */
+    getApi<T = unknown>(name: string): T | undefined;
+    /** Iterate spec entities of the given kinds, in document order. */
+    forEach(...kinds: ForEachKind[]): IterableIterator<ForEachEvent>;
+}
+export interface PluginHooks<Config = unknown, Api = unknown> {
+    before?: (plugin: PluginInstance<Config, Api>) => Promise<void> | void;
+    after?: (plugin: PluginInstance<Config, Api>) => Promise<void> | void;
+}
+/**
+ * Plugin author's contract. Pass to `definePluginConfig` to get a
+ * factory that callers invoke when building their plugin list.
+ */
+export interface PluginDefinition<Name extends string = string, UserConfig = unknown, ResolvedConfig = UserConfig, Api = unknown> {
+    /** Stable identifier — used in `dependsOn`, `getApi`, log messages. */
+    name: Name;
+    /** Baseline config; user overrides are layered on top. */
+    defaultConfig: ResolvedConfig;
+    /**
+     * Optional. Compute the final config from user input + document
+     * context (e.g. inspect installed package versions, infer features
+     * from the spec). Default behavior is shallow-merge of user over
+     * defaults.
+     */
+    resolveConfig?: (user: Partial<UserConfig> | undefined, context: {
+        document: AsyncAPIDocumentInterface;
+    }) => ResolvedConfig;
+    /** API surface other plugins can fetch via `plugin.getApi(name)`. */
+    api?: Api;
+    hooks?: PluginHooks<ResolvedConfig, Api>;
+    /** Names of plugins this one depends on. The orchestrator topologically sorts. */
+    dependsOn?: ReadonlyArray<string>;
+    /** The actual codegen work. */
+    handler: (plugin: PluginInstance<ResolvedConfig, Api>) => Promise<void> | void;
+}
+/** What the orchestrator receives — a sealed instance ready to run. */
+export interface RegisteredPlugin<Name extends string = string, UserConfig = unknown, ResolvedConfig = UserConfig, Api = unknown> {
+    readonly __definition: PluginDefinition<Name, UserConfig, ResolvedConfig, Api>;
+    readonly __userConfig: Partial<UserConfig> | undefined;
+    readonly name: Name;
+}
+/**
+ * Generic-erased view used at orchestration boundaries.
+ *
+ * `RegisteredPlugin<X>` types can't be uniformly stored in an array
+ * because hooks are contravariant in `Config`. This widening alias
+ * uses `any` deliberately — internal to the orchestrator, not exposed
+ * to plugin authors (who keep full type safety).
+ */
+export type AnyRegisteredPlugin = RegisteredPlugin<string, any, any, any>;
+/**
+ * Wrap a plugin definition into a factory. Author exports the returned
+ * factory; caller invokes it (with optional config overrides) when
+ * building the `plugins` array.
+ */
+export declare function definePluginConfig<Name extends string, UserConfig, ResolvedConfig, Api>(def: PluginDefinition<Name, UserConfig, ResolvedConfig, Api>): (config?: Partial<UserConfig>) => RegisteredPlugin<Name, UserConfig, ResolvedConfig, Api>;
+/** Convenience: orchestrator-internal `forEach` implementation. */
+export declare function iterateDocument(document: AsyncAPIDocumentInterface, kinds: ReadonlyArray<ForEachKind>): IterableIterator<ForEachEvent>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAEjC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,KAAK,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzD,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAE9D,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO;IAC7D,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,0FAA0F;IAC1F,IAAI,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC,SAAS,CAAC,EACvC,OAAO,CAAC,EAAE,aAAa,GACtB,IAAI,CAAC;IACR,2EAA2E;IAC3E,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACjD,mEAAmE;IACnE,OAAO,CAAC,GAAG,KAAK,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;CAClE;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,GAAG,GAAG,OAAO;IAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAC/B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,UAAU,GAAG,OAAO,EACpB,cAAc,GAAG,UAAU,EAC3B,GAAG,GAAG,OAAO;IAEb,uEAAuE;IACvE,IAAI,EAAE,IAAI,CAAC;IACX,0DAA0D;IAC1D,aAAa,EAAE,cAAc,CAAC;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CACd,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,EACrC,OAAO,EAAE;QAAE,QAAQ,EAAE,yBAAyB,CAAA;KAAE,KAC7C,cAAc,CAAC;IACpB,qEAAqE;IACrE,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,KAAK,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACzC,kFAAkF;IAClF,SAAS,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,+BAA+B;IAC/B,OAAO,EAAE,CACP,MAAM,EAAE,cAAc,CAAC,cAAc,EAAE,GAAG,CAAC,KACxC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3B;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB,CAC/B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,UAAU,GAAG,OAAO,EACpB,cAAc,GAAG,UAAU,EAC3B,GAAG,GAAG,OAAO;IAEb,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CACrC,IAAI,EACJ,UAAU,EACV,cAAc,EACd,GAAG,CACJ,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,SAAS,MAAM,EACnB,UAAU,EACV,cAAc,EACd,GAAG,EAEH,GAAG,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,CAAC,GAC3D,CACD,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KACzB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,CAAC,CAM3D;AAED,mEAAmE;AACnE,wBAAiB,eAAe,CAC9B,QAAQ,EAAE,yBAAyB,EACnC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,GAChC,gBAAgB,CAAC,YAAY,CAAC,CAgBhC"}

package/dist/plugin.js

@@ -0,0 +1,51 @@
+/**
+ * Plugin contract for `@ir-kit/asyncapi-typescript`.
+ *
+ * Shape mirrors `@hey-api/openapi-ts`'s `definePluginConfig` / plugin
+ * instance pattern, adapted to AsyncAPI primitives. Plugins are
+ * authored as definitions and registered via factory call:
+ *
+ *   export const myPlugin = definePluginConfig({
+ *     name: "my-plugin",
+ *     defaultConfig: { ... },
+ *     dependsOn: ["typescript"],
+ *     handler: async (plugin) => {
+ *       for (const ev of plugin.forEach("message")) { ... }
+ *       plugin.emit({ path: "out.gen.ts", content: "..." });
+ *     },
+ *   });
+ *
+ *   // caller:
+ *   generate({ plugins: [myPlugin({ ... }), ...], ... });
+ */
+/**
+ * Wrap a plugin definition into a factory. Author exports the returned
+ * factory; caller invokes it (with optional config overrides) when
+ * building the `plugins` array.
+ */
+export function definePluginConfig(def) {
+    return (config) => ({
+        __definition: def,
+        __userConfig: config,
+        name: def.name,
+    });
+}
+/** Convenience: orchestrator-internal `forEach` implementation. */
+export function* iterateDocument(document, kinds) {
+    if (kinds.includes("channel")) {
+        for (const channel of document.channels().all()) {
+            yield { type: "channel", channel };
+        }
+    }
+    if (kinds.includes("operation")) {
+        for (const operation of document.operations().all()) {
+            yield { type: "operation", operation };
+        }
+    }
+    if (kinds.includes("message")) {
+        for (const message of document.allMessages().all()) {
+            yield { type: "message", message };
+        }
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwJH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAMhC,GAA4D;IAI5D,OAAO,CAAC,MAA4B,EAAE,EAAE,CAAC,CAAC;QACxC,YAAY,EAAE,GAAG;QACjB,YAAY,EAAE,MAAM;QACpB,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC;AACL,CAAC;AAED,mEAAmE;AACnE,MAAM,SAAS,CAAC,CAAC,eAAe,CAC9B,QAAmC,EACnC,KAAiC;IAEjC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;YAChD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QAChC,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;YACpD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;YACnD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACrC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/plugins/amqplib/bundle/amqp.gen.ts

@@ -0,0 +1,99 @@
+// AUTO-GENERATED by @ir-kit/asyncapi-typescript — do not hand-edit.
+
+import type { Channel, ConsumeMessage } from "amqplib";
+
+export interface EventDescriptor {
+  exchange: string;
+  exchangeType: string;
+  type: string;
+  contentType?: string;
+}
+
+export interface ConsumerLike {
+  bindings: ReadonlyArray<{ exchange: string; routingKey: string }>;
+  dispatch: (raw: ConsumeMessage | null) => Promise<void> | void;
+}
+
+export interface AssertExchangesOptions {
+  durable?: boolean;
+}
+
+export async function assertExchanges(
+  channel: Channel,
+  events: Readonly<Record<string, EventDescriptor>>,
+  opts: AssertExchangesOptions = {},
+) {
+  const seen = new Set<string>();
+  for (const ev of Object.values(events)) {
+    if (seen.has(ev.exchange)) continue;
+    seen.add(ev.exchange);
+    await channel.assertExchange(ev.exchange, ev.exchangeType, {
+      durable: opts.durable,
+    });
+  }
+}
+
+export interface BindAndConsumeOptions {
+  durable?: boolean;
+  exclusive?: boolean;
+  autoDelete?: boolean;
+  noAck?: boolean;
+}
+
+export async function bindAndConsume(
+  channel: Channel,
+  queue: string,
+  registry: ConsumerLike,
+  opts: BindAndConsumeOptions = {},
+) {
+  await channel.assertQueue(queue, {
+    durable: opts.durable,
+    exclusive: opts.exclusive,
+    autoDelete: opts.autoDelete,
+  });
+  for (const { exchange, routingKey } of registry.bindings) {
+    await channel.bindQueue(queue, exchange, routingKey);
+  }
+  return channel.consume(queue, registry.dispatch, {
+    noAck: opts.noAck,
+  });
+}
+
+/**
+ * Encode a typed payload to bytes. Default is JSON.stringify + utf8.
+ * Override to swap in protobuf / msgpack / cbor / etc.
+ */
+export type SerializeFn = <T>(payload: T) => Buffer;
+
+const defaultSerialize: SerializeFn = (payload) =>
+  Buffer.from(JSON.stringify(payload));
+
+export interface PublishOptions {
+  serialize?: SerializeFn;
+  persistent?: boolean;
+  expiration?: number;
+  priority?: number;
+  correlationId?: string;
+  replyTo?: string;
+  headers?: Record<string, unknown>;
+  mandatory?: boolean;
+}
+
+export function publish<T>(
+  channel: Channel,
+  ev: EventDescriptor,
+  payload: T,
+  opts: PublishOptions = {},
+): boolean {
+  const serialize = opts.serialize ?? defaultSerialize;
+  return channel.publish(ev.exchange, ev.type, serialize(payload), {
+    contentType: ev.contentType,
+    persistent: opts.persistent,
+    expiration: opts.expiration?.toString(),
+    priority: opts.priority,
+    correlationId: opts.correlationId,
+    replyTo: opts.replyTo,
+    headers: opts.headers,
+    mandatory: opts.mandatory,
+  });
+}

package/dist/plugins/amqplib/config.d.ts

@@ -0,0 +1,3 @@
+import type { AmqplibResolvedConfig } from "./types.js";
+export declare const defaultConfig: AmqplibResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/plugins/amqplib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/amqplib/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,aAAa,EAAE,qBAAmD,CAAC"}

package/dist/plugins/amqplib/config.js

@@ -0,0 +1,2 @@
+export const defaultConfig = {};
+//# sourceMappingURL=config.js.map

package/dist/plugins/amqplib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/plugins/amqplib/config.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAA0B,EAA2B,CAAC"}

package/dist/plugins/amqplib/index.d.ts

@@ -0,0 +1,3 @@
+export { amqplib } from "./plugin.js";
+export type { AmqplibPluginConfig, AmqplibResolvedConfig } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/amqplib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/amqplib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/plugins/amqplib/index.js

@@ -0,0 +1,2 @@
+export { amqplib } from "./plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/plugins/amqplib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugins/amqplib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/plugins/amqplib/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { AmqplibPluginConfig } from "./types.js";
+/** Emit `assertExchanges` / `bindAndConsume` / `publish` by copying `bundle/`. */
+export declare const amqplib: (config?: Partial<AmqplibPluginConfig> | undefined) => import("../../plugin.js").RegisteredPlugin<"amqplib", AmqplibPluginConfig, Required<AmqplibPluginConfig>, unknown>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/amqplib/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/amqplib/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,YAAY,CAAC;AAI7E,kFAAkF;AAClF,eAAO,MAAM,OAAO,2KAclB,CAAC"}

package/dist/plugins/amqplib/plugin.js

@@ -0,0 +1,18 @@
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { definePluginConfig } from "../../plugin.js";
+import { readBundle } from "../../runtime/copy-bundle.js";
+import { defaultConfig } from "./config.js";
+const bundleDir = resolve(dirname(fileURLToPath(import.meta.url)), "bundle");
+/** Emit `assertExchanges` / `bindAndConsume` / `publish` by copying `bundle/`. */
+export const amqplib = definePluginConfig({
+    name: "amqplib",
+    defaultConfig,
+    dependsOn: ["events"],
+    async handler(plugin) {
+        for (const file of await readBundle(bundleDir)) {
+            plugin.emit(file);
+        }
+    },
+});
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/amqplib/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/plugins/amqplib/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAE7E,kFAAkF;AAClF,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAKvC;IACA,IAAI,EAAE,SAAS;IACf,aAAa;IACb,SAAS,EAAE,CAAC,QAAQ,CAAC;IACrB,KAAK,CAAC,OAAO,CAAC,MAAM;QAClB,KAAK,MAAM,IAAI,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/plugins/amqplib/types.d.ts

@@ -0,0 +1,5 @@
+export interface AmqplibPluginConfig {
+    reserved?: never;
+}
+export type AmqplibResolvedConfig = Required<AmqplibPluginConfig>;
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/amqplib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/amqplib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/plugins/amqplib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/amqplib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/amqplib/types.ts"],"names":[],"mappings":""}

package/dist/plugins/dispatch/bundle/dispatch.gen.ts

@@ -0,0 +1,188 @@
+// AUTO-GENERATED by @ir-kit/asyncapi-typescript — do not hand-edit.
+
+import type { ConsumeMessage } from "amqplib";
+
+export type Handler<T> = (msg: T, raw: ConsumeMessage) => Promise<void> | void;
+
+export interface EventMeta {
+  type: string;
+  exchange: string;
+  routingKey: string;
+}
+
+/**
+ * Decodes a raw message body into the typed shape. Default is
+ * JSON.parse + utf8. Override to plug in a validator (zod/typia/ajv) —
+ * runtime is otherwise unverified and the cast is taken on trust.
+ */
+export type ParseFn = (buf: Buffer) => unknown;
+
+const defaultParse: ParseFn = (buf) => JSON.parse(buf.toString("utf8"));
+
+export interface RegistryOptions {
+  parse?: ParseFn;
+}
+
+export class Registry<
+  // biome-ignore lint/suspicious/noExplicitAny: caller's spec defines its shape
+  EM extends Record<string, any>,
+  Registered extends keyof EM = never,
+> {
+  private handlers = new Map<keyof EM, Handler<unknown>>();
+  private metaByType = new Map<keyof EM, EventMeta>();
+  private parse: ParseFn;
+
+  constructor(
+    events: Readonly<Record<string, EventMeta>>,
+    opts: RegistryOptions = {},
+  ) {
+    for (const meta of Object.values(events)) {
+      this.metaByType.set(meta.type as keyof EM, meta);
+    }
+    this.parse = opts.parse ?? defaultParse;
+  }
+
+  on<K extends keyof EM>(
+    type: K,
+    handler: Handler<EM[K]>,
+  ): Registry<EM, Registered | K> {
+    if (this.handlers.has(type)) {
+      console.warn(
+        `Registry.on: handler for "${String(type)}" was already registered, overwriting`,
+      );
+    }
+    this.handlers.set(type, handler as Handler<unknown>);
+    return this as Registry<EM, Registered | K>;
+  }
+
+  dispatch = (raw: ConsumeMessage | null): void => {
+    if (!raw) return;
+
+    let msg: EM[keyof EM];
+    try {
+      msg = this.parse(raw.content) as EM[keyof EM];
+    } catch (err) {
+      console.error("Registry.dispatch: failed to parse message body", err);
+      return;
+    }
+
+    const incoming = raw.fields.routingKey;
+
+    // Fast path: producer publishes with the concrete event type as the
+    // routing key, so most messages match an exact key in `handlers`.
+    const direct = this.handlers.get(incoming as keyof EM);
+    if (direct) {
+      this.runHandler(direct, msg, raw, incoming);
+      return;
+    }
+
+    // Slow path: incoming key didn't match a registered type literally,
+    // so walk patterns for a wildcard match (`*`, `#`).
+    for (const [type, handler] of this.handlers) {
+      const meta = this.metaByType.get(type);
+      if (!meta) continue;
+      if (matchRoutingKey(meta.routingKey, incoming)) {
+        this.runHandler(handler, msg, raw, String(type));
+        return;
+      }
+    }
+  };
+
+  private runHandler(
+    handler: Handler<unknown>,
+    msg: unknown,
+    raw: ConsumeMessage,
+    label: string,
+  ): void {
+    try {
+      const result = handler(msg, raw);
+      if (result instanceof Promise) {
+        result.catch((err: unknown) => {
+          console.error(`Registry.dispatch: handler for "${label}" threw`, err);
+        });
+      }
+    } catch (err) {
+      console.error(`Registry.dispatch: handler for "${label}" threw`, err);
+    }
+  }
+
+  toCallback<K extends Registered>(
+    type: K,
+  ): (raw: ConsumeMessage | null) => void {
+    const handler = this.handlers.get(type);
+    if (!handler) {
+      throw new Error(
+        `Registry.toCallback: no handler registered for "${String(type)}"`,
+      );
+    }
+    return (raw) => {
+      if (!raw) return;
+      let msg: EM[K];
+      try {
+        msg = this.parse(raw.content) as EM[K];
+      } catch (err) {
+        console.error(
+          `Registry.toCallback("${String(type)}"): failed to parse message body`,
+          err,
+        );
+        return;
+      }
+      this.runHandler(handler, msg as unknown, raw, String(type));
+    };
+  }
+
+  get bindings(): ReadonlyArray<{
+    type: Registered;
+    exchange: string;
+    routingKey: string;
+  }> {
+    const out: Array<{
+      type: Registered;
+      exchange: string;
+      routingKey: string;
+    }> = [];
+    for (const type of this.handlers.keys()) {
+      const meta = this.metaByType.get(type);
+      if (!meta) continue;
+      out.push({
+        type: type as Registered,
+        exchange: meta.exchange,
+        routingKey: meta.routingKey,
+      });
+    }
+    return out;
+  }
+}
+
+export function createRegistry<
+  // biome-ignore lint/suspicious/noExplicitAny: caller's spec defines its shape
+  EM extends Record<string, any>,
+>(
+  events: Readonly<Record<string, EventMeta>>,
+  opts: RegistryOptions = {},
+): Registry<EM> {
+  return new Registry<EM>(events, opts);
+}
+
+/** RabbitMQ topic-exchange routing-key matcher: `*` = one word, `#` = zero or more. */
+function matchRoutingKey(pattern: string, key: string): boolean {
+  return matchSegments(pattern.split("."), key.split("."));
+}
+
+function matchSegments(
+  p: ReadonlyArray<string>,
+  k: ReadonlyArray<string>,
+): boolean {
+  if (p.length === 0) return k.length === 0;
+  const head = p[0];
+  const tail = p.slice(1);
+  if (head === "#") {
+    for (let i = 0; i <= k.length; i++) {
+      if (matchSegments(tail, k.slice(i))) return true;
+    }
+    return false;
+  }
+  if (k.length === 0) return false;
+  if (head === "*" || head === k[0]) return matchSegments(tail, k.slice(1));
+  return false;
+}

package/dist/plugins/dispatch/config.d.ts

@@ -0,0 +1,3 @@
+import type { DispatchResolvedConfig } from "./types.js";
+export declare const defaultConfig: DispatchResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/plugins/dispatch/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/plugins/dispatch/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,eAAO,MAAM,aAAa,EAAE,sBACE,CAAC"}