@miiajs/messaging 0.1.0

package/dist/messaging.module.js

@@ -0,0 +1,74 @@
+import { resolveOptions } from '@miiajs/core';
+import { MessageBus } from './message-bus.js';
+import {} from './idempotency.js';
+import { getMessageBusToken, getMessageTransportToken, getIdempotencyStoreToken } from './tokens.js';
+import {} from './types.js';
+/**
+ * Dynamic module that registers a message transport, optional idempotency
+ * store, and `MessageBus` in the container.
+ *
+ * Pass an optional `name` to register a **named bus** alongside the default
+ * one - useful when an app needs more than one transport (Kafka + Redis,
+ * internal in-memory bus + external Redis, etc.). Handlers target a specific
+ * bus via `@On(topic, { bus: name })`.
+ *
+ * @example
+ * ```ts
+ * // Static form, default bus
+ * MessagingModule.configure({ transport: inMemoryTransport() })
+ *
+ * // Factory form with DI access
+ * MessagingModule.configure((resolve) => ({
+ *   transport: redisStreamsTransport({
+ *     url: resolve(ConfigService).getOrThrow('REDIS_URL'),
+ *   }),
+ * }))
+ *
+ * // Multi-bus: default + named
+ * MessagingModule.configure({ transport: redisStreamsTransport({ url: '...' }) })
+ * MessagingModule.configure({ transport: kafkaTransport({ ... }) }, 'kafka')
+ *
+ * // In a handler
+ * @On('order.placed')                      // default bus
+ * @On('legacy.user', { bus: 'kafka' })     // named bus
+ * ```
+ */
+export class MessagingModule {
+    static configure(optionsOrFactory, name) {
+        const transportToken = getMessageTransportToken(name);
+        const storeToken = getIdempotencyStoreToken(name);
+        const busToken = getMessageBusToken(name);
+        // Anonymous module class per name so the DI module loader does not flag
+        // a duplicate when configure() is called twice with different names.
+        const ModuleClass = name ? class MessagingNamedModule {
+        } : MessagingModule;
+        return {
+            module: ModuleClass,
+            providers: [
+                {
+                    token: transportToken,
+                    factory: (resolve) => resolveOptions(optionsOrFactory, { resolve }).transport,
+                },
+                {
+                    // Always registered so MessageBus's optional read resolves cleanly.
+                    // Value is `null` when the user did not configure a store.
+                    token: storeToken,
+                    factory: (resolve) => resolveOptions(optionsOrFactory, { resolve }).idempotency ?? null,
+                },
+                {
+                    token: busToken,
+                    factory: (resolve) => {
+                        const transport = resolve(transportToken);
+                        const store = resolve(storeToken);
+                        const opts = resolveOptions(optionsOrFactory, { resolve });
+                        return new MessageBus(transport, store, name ?? null, {
+                            dispatch: opts.dispatch ?? null,
+                            appName: opts.appName ?? null,
+                        });
+                    },
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=messaging.module.js.map

package/dist/messaging.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.module.js","sourceRoot":"","sources":["../src/messaging.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAyB,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAA4C,MAAM,YAAY,CAAA;AA2CrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,SAAS,CAAC,gBAA0D,EAAE,IAAa;QACxF,MAAM,cAAc,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAA;QACrD,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAA;QACjD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAEzC,wEAAwE;QACxE,qEAAqE;QACrE,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAE,MAAM,oBAAoB;SAAmB,CAAC,CAAC,CAAC,eAAe,CAAA;QAE3F,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE;gBACT;oBACE,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS;iBAC9E;gBACD;oBACE,oEAAoE;oBACpE,2DAA2D;oBAC3D,KAAK,EAAE,UAAU;oBACjB,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;iBACxF;gBACD;oBACE,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;wBACnB,MAAM,SAAS,GAAG,OAAO,CAAmB,cAAc,CAAC,CAAA;wBAC3D,MAAM,KAAK,GAAG,OAAO,CAA0B,UAAU,CAAC,CAAA;wBAC1D,MAAM,IAAI,GAAG,cAAc,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;wBAC1D,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,IAAI,IAAI,EAAE;4BACpD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;4BAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;yBAC9B,CAAC,CAAA;oBACJ,CAAC;iBACF;aACF;SACF,CAAA;IACH,CAAC;CACF"}

package/dist/retry.d.ts

@@ -0,0 +1,7 @@
+import type { RetryConfig } from './types.js';
+/**
+ * Exponential backoff: attempt=1 → base, attempt=2 → base*mult, ...
+ */
+export declare function nextBackoffMs(attempt: number, config: RetryConfig): number;
+export declare function dlqTopic(topic: string): string;
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAE1E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C"}

package/dist/retry.js

@@ -0,0 +1,10 @@
+/**
+ * Exponential backoff: attempt=1 → base, attempt=2 → base*mult, ...
+ */
+export function nextBackoffMs(attempt, config) {
+    return config.backoffMs * Math.pow(config.backoffMultiplier, attempt - 1);
+}
+export function dlqTopic(topic) {
+    return `${topic}.dlq`;
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,MAAmB;IAChE,OAAO,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,GAAG,KAAK,MAAM,CAAA;AACvB,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,19 @@
+import type { Constructor } from '@miiajs/core';
+import { MessageBus } from './message-bus.js';
+/**
+ * DI token for the message transport of a (default or named) bus.
+ * Returns the default `MESSAGE_TRANSPORT` constant when called without name.
+ */
+export declare function getMessageTransportToken(name?: string): string;
+/**
+ * DI token for the optional idempotency store of a (default or named) bus.
+ * Returns the default `IDEMPOTENCY_STORE` constant when called without name.
+ */
+export declare function getIdempotencyStoreToken(name?: string): string;
+/**
+ * DI token for the MessageBus instance of a (default or named) bus.
+ * - default: returns the `MessageBus` class itself, so `inject(MessageBus)` works.
+ * - named: returns a string token; use `inject<MessageBus>(getMessageBusToken('kafka'))`.
+ */
+export declare function getMessageBusToken(name?: string): string | Constructor<MessageBus>;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAI7C;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,CAElF"}

package/dist/tokens.js

@@ -0,0 +1,26 @@
+import { MessageBus } from './message-bus.js';
+import { IDEMPOTENCY_STORE } from './idempotency.js';
+import { MESSAGE_TRANSPORT } from './types.js';
+/**
+ * DI token for the message transport of a (default or named) bus.
+ * Returns the default `MESSAGE_TRANSPORT` constant when called without name.
+ */
+export function getMessageTransportToken(name) {
+    return name ? `miia:messaging:transport:${name}` : MESSAGE_TRANSPORT;
+}
+/**
+ * DI token for the optional idempotency store of a (default or named) bus.
+ * Returns the default `IDEMPOTENCY_STORE` constant when called without name.
+ */
+export function getIdempotencyStoreToken(name) {
+    return name ? `miia:messaging:idempotency-store:${name}` : IDEMPOTENCY_STORE;
+}
+/**
+ * DI token for the MessageBus instance of a (default or named) bus.
+ * - default: returns the `MessageBus` class itself, so `inject(MessageBus)` works.
+ * - named: returns a string token; use `inject<MessageBus>(getMessageBusToken('kafka'))`.
+ */
+export function getMessageBusToken(name) {
+    return name ? `miia:messaging:bus:${name}` : MessageBus;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,OAAO,IAAI,CAAC,CAAC,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,OAAO,IAAI,CAAC,CAAC,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAA;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAA;AACzD,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Full envelope shape that transports publish and deliver. All fields
+ * except `payload` are framework-managed. User code only sees `payload`
+ * (and optionally `meta`) inside `@On` handlers.
+ */
+export interface MessageEnvelope<T = unknown> {
+    id: string;
+    topic: string;
+    payload: T;
+    meta: MessageMeta;
+}
+export interface MessageMeta {
+    /** Epoch milliseconds at first publish. Does not change on retry. */
+    timestamp: number;
+    /** 1 on first delivery, incremented by the transport on each retry. */
+    attempt: number;
+    correlationId?: string;
+    causationId?: string;
+    /**
+     * W3C Trace Context traceparent header value.
+     * Format: `00-<traceId>-<spanId>-<flags>` (e.g. `00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01`).
+     *
+     * Populate at publish time from your tracing library (OpenTelemetry, Datadog,
+     * Sentry, etc.). Consumers can restore span context to continue the
+     * distributed trace across service boundaries.
+     *
+     * Pass `undefined` to skip; do not pass an empty string (it would serialize
+     * as a truthy-looking invalid value on the consumer side).
+     *
+     * @see https://www.w3.org/TR/trace-context/#traceparent-header
+     */
+    traceparent?: string;
+    /**
+     * W3C Trace Context tracestate header. Vendor-specific key/value pairs that
+     * accompany `traceparent`.
+     *
+     * @see https://www.w3.org/TR/trace-context/#tracestate-header
+     */
+    tracestate?: string;
+    /** Populated only when the envelope is moved to the DLQ. */
+    lastError?: string;
+}
+/**
+ * Dispatch behavior for a subscription's message-pump loop.
+ *
+ * - `'batch'` - read up to `concurrency` messages, run them through
+ *   `Promise.allSettled`, then read again. The slowest handler in the batch
+ *   blocks the next read (head-of-line). Best for high-throughput uniform
+ *   workloads with negligible per-message variance.
+ * - `'sliding'` - each in-flight message progresses independently; the
+ *   subscription pulls the next message as soon as a slot frees, without
+ *   waiting for the rest of the batch. Best when handler runtimes vary.
+ *
+ * Each transport declares its `supportedModes` and `defaultMode`; the bus
+ * validates handler-requested modes against that capability set on startup.
+ */
+export type DispatchMode = 'batch' | 'sliding';
+export interface SubscribeOptions {
+    /**
+     * Consumer group for load-balancing between replicas/processes.
+     * Identical `group` across replicas = broker delivers each message to
+     * exactly one replica in the group. Different groups = fan-out (every
+     * group gets a copy). In-memory transport ignores this - within a single
+     * process local fan-out always runs every matching handler.
+     */
+    group?: string;
+    /**
+     * Prefetch-style: how many messages the transport may pull / process
+     * in parallel within one subscription. Redis Streams: XREADGROUP COUNT
+     * (batch) or number of sliding lanes. RabbitMQ: basic.qos prefetch.
+     * NATS: max_in_flight. Ignored by in-memory.
+     */
+    concurrency?: number;
+    /**
+     * Resolved effective dispatch mode for this subscription. The bus
+     * resolves this from `@On({ mode })` > bus default > `transport.defaultMode`
+     * and validates against `transport.supportedModes` before calling
+     * `subscribe()`. Transports may assume the value is in `supportedModes`.
+     */
+    mode?: DispatchMode;
+    /**
+     * Marker that the group name encodes a per-process suffix (`@On({ broadcast: true })`).
+     * Transports that maintain stateful broker-side groups (Redis Streams, Kafka)
+     * use this flag to clean up orphaned groups from previous process incarnations
+     * on subscribe and to destroy the current group on shutdown. Transports
+     * without broker state (in-memory) ignore it.
+     */
+    broadcast?: boolean;
+}
+export type HandlerResult = {
+    status: 'ack';
+} | {
+    status: 'nack';
+    error: Error;
+};
+export interface Subscription {
+    unsubscribe(): Promise<void>;
+}
+export interface RetryConfig {
+    /** Maximum delivery attempts before moving to DLQ (or dropping). Default 5. */
+    maxAttempts: number;
+    /** Base delay in ms for the first retry. Default 1000. */
+    backoffMs: number;
+    /** Exponential multiplier applied per attempt. Default 2 (1s, 2s, 4s, 8s...). */
+    backoffMultiplier: number;
+    /**
+     * When true, exhausted messages are published to `<topic>.dlq` with the
+     * last error recorded in `meta.lastError`. When false, exhausted messages
+     * are acked and logged as errors. Default true.
+     */
+    dlq: boolean;
+}
+export declare const DEFAULT_RETRY: RetryConfig;
+/**
+ * Transport contract. Concrete implementations:
+ * - `InMemoryTransport` (shipped in this package; default for dev and tests)
+ * - `RedisStreamsTransport` from `@miiajs/messaging-redis`
+ * - Future: NATS, RabbitMQ, Kafka
+ *
+ * Retry/DLQ logic lives INSIDE each transport - different brokers have
+ * different primitives (Redis ZSET scheduler, RabbitMQ DLX, NATS max_deliver).
+ * Handlers simply return ack/nack; transport decides what to do next.
+ */
+export interface MessageTransport {
+    /**
+     * Dispatch modes this transport can implement. The bus reads this list to
+     * validate handler-requested modes during `MessageBus.onReady()`. Transports
+     * declare only modes for which they have a meaningful primitive - emulating
+     * a missing primitive (e.g. fake batch on a single-process transport) just
+     * adds an artificial barrier without value.
+     */
+    readonly supportedModes: readonly DispatchMode[];
+    /**
+     * Mode used when neither the handler nor the bus configuration specifies
+     * one. Must be a member of `supportedModes`.
+     */
+    readonly defaultMode: DispatchMode;
+    /**
+     * Whether the broker supports competing consumers within a single group:
+     * a single message is delivered to exactly one consumer in the group
+     * (round-robin / load balancing). When `true`, users can pass an explicit
+     * `@On({ group: '...' })` to share work between multiple handlers or
+     * replicas. When `false`, only fan-out semantics work; bus rejects explicit
+     * `group` at startup with a helpful error.
+     *
+     * Examples:
+     * - `true`: Redis Streams, Kafka, RabbitMQ, NATS Core queue groups, JetStream
+     * - `false`: InMemoryTransport (single process, no broker), Redis Pub/Sub
+     *   (no durable groups)
+     */
+    readonly supportsCompetingConsumers: boolean;
+    publish(envelope: MessageEnvelope): Promise<void>;
+    subscribe(topic: string, handler: (envelope: MessageEnvelope) => Promise<HandlerResult>, options: SubscribeOptions): Promise<Subscription>;
+    onInit?(): Promise<void>;
+    onDestroy?(): Promise<void>;
+}
+/**
+ * DI token for the message transport. String token because an abstract class
+ * is not type-compatible with core's `Constructor<T>` (abstract `new` vs
+ * plain `new`). Matches the `JWT_OPTIONS` pattern in `@miiajs/jwt`.
+ *
+ * Usage: `private transport = inject<MessageTransport>(MESSAGE_TRANSPORT)`.
+ */
+export declare const MESSAGE_TRANSPORT = "miia:messaging:transport";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,CAAA;AAE9C,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IAEnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAEhF,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,GAAG,EAAE,OAAO,CAAA;CACb;AAED,eAAO,MAAM,aAAa,EAAE,WAK3B,CAAA;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,SAAS,YAAY,EAAE,CAAA;IAEhD;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;IAElC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAA;IAE5C,OAAO,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD,SAAS,CACP,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,OAAO,CAAC,aAAa,CAAC,EAC9D,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CAAA;IAExB,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,6BAA6B,CAAA"}

package/dist/types.js

@@ -0,0 +1,15 @@
+export const DEFAULT_RETRY = {
+    maxAttempts: 5,
+    backoffMs: 1000,
+    backoffMultiplier: 2,
+    dlq: true,
+};
+/**
+ * DI token for the message transport. String token because an abstract class
+ * is not type-compatible with core's `Constructor<T>` (abstract `new` vs
+ * plain `new`). Matches the `JWT_OPTIONS` pattern in `@miiajs/jwt`.
+ *
+ * Usage: `private transport = inject<MessageTransport>(MESSAGE_TRANSPORT)`.
+ */
+export const MESSAGE_TRANSPORT = 'miia:messaging:transport';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqHA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,IAAI;IACf,iBAAiB,EAAE,CAAC;IACpB,GAAG,EAAE,IAAI;CACV,CAAA;AAuDD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAA"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@miiajs/messaging",
+  "version": "0.1.0",
+  "author": "Ruslan Matiushev",
+  "license": "MIT",
+  "description": "Messaging for MiiaJS - decorator-driven event bus, retry with auto-DLQ, idempotency, named buses, pluggable transports.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/miiajs/miia.git",
+    "directory": "packages/messaging"
+  },
+  "homepage": "https://github.com/miiajs/miia/tree/main/packages/messaging#readme",
+  "bugs": {
+    "url": "https://github.com/miiajs/miia/issues"
+  },
+  "keywords": [
+    "miiajs",
+    "miia",
+    "messaging",
+    "events",
+    "event-bus",
+    "pubsub",
+    "decorator"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.22.1",
+    "bun": ">=1.3.11",
+    "deno": ">=2.6.1"
+  },
+  "dependencies": {
+    "@miiajs/core": "workspace:*"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "tsc --build --clean"
+  }
+}