actor-ts 0.9.1 → 0.11.0

package/dist/io/broker/KafkaOptions.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Fluent builder for {@link KafkaOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.kafka` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+import type { BrokerCommonOptionsType } from './BrokerOptions.js';
+import type { ActorRef } from '../../ActorRef.js';
+import type { KafkaCommitMode, KafkaRecord } from './KafkaActor.js';
+export interface KafkaOptionsType extends BrokerCommonOptionsType {
+    /** Bootstrap servers (`'kafka-1:9092,kafka-2:9092'` or array). */
+    readonly brokers?: ReadonlyArray<string> | string;
+    /** Stable client id reported to the broker. */
+    readonly clientId?: string;
+    /** Optional SASL credentials. */
+    readonly sasl?: {
+        readonly mechanism: 'plain' | 'scram-sha-256' | 'scram-sha-512';
+        readonly username: string;
+        readonly password: string;
+    };
+    /** Enable TLS. */
+    readonly ssl?: boolean;
+    /** Producer options. */
+    readonly producer?: {
+        readonly idempotent?: boolean;
+        readonly allowAutoTopicCreation?: boolean;
+    };
+    /** Consumer options.  `groupId` is required to start a consumer. */
+    readonly consumer?: {
+        readonly groupId?: string;
+        readonly fromBeginning?: boolean;
+        /**
+         * Offset-commit policy.  Default `'auto'` — kafkajs auto-commits
+         * after the handler returns (at-least-once).  See
+         * {@link KafkaCommitMode} for the `'manual'` (exactly-once-with-
+         * processing) shape.
+         */
+        readonly commitMode?: KafkaCommitMode;
+        /**
+         * Max time in ms the manual-commit pump waits for an external
+         * `commit` / `nack` before giving up on a message and letting
+         * kafkajs reject it (which triggers a rebalance and re-delivery).
+         * Only used when `commitMode === 'manual'`.  Default 30s.
+         */
+        readonly commitTimeoutMs?: number;
+    };
+    /** Subscriber that receives every consumed record. */
+    readonly target?: ActorRef<KafkaRecord>;
+    /** Topics the consumer subscribes to at connect time. */
+    readonly topics?: ReadonlyArray<string>;
+}
+export declare class KafkaOptionsBuilder extends BrokerOptionsBuilder<KafkaOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new KafkaOptionsBuilder()`. */
+    static create(): KafkaOptionsBuilder;
+    /** Bootstrap servers (`'kafka-1:9092,kafka-2:9092'` or array). */
+    withBrokers(brokers: ReadonlyArray<string> | string): this;
+    /** Stable client id reported to the broker. */
+    withClientId(clientId: string): this;
+    /** SASL credentials. */
+    withSasl(sasl: NonNullable<KafkaOptionsType['sasl']>): this;
+    /** Enable TLS.  Default `false`. */
+    withSsl(on?: boolean): this;
+    /** Producer options (idempotence / auto-topic-creation). */
+    withProducer(producer: NonNullable<KafkaOptionsType['producer']>): this;
+    /** Consumer options.  `groupId` is required to start a consumer. */
+    withConsumer(consumer: NonNullable<KafkaOptionsType['consumer']>): this;
+    /** Subscriber that receives every consumed record. */
+    withTarget(target: ActorRef<KafkaRecord>): this;
+    /** Topics the consumer subscribes to at connect time. */
+    withTopics(topics: ReadonlyArray<string>): this;
+}
+/** Validates resolved {@link KafkaOptionsType} settings. */
+export declare class KafkaOptionsValidator extends BrokerOptionsValidator<KafkaOptionsType> {
+    constructor();
+    protected rules(s: Partial<KafkaOptionsType>): void;
+}
+/**
+ * Accepted input for any Kafka-configurable constructor: the fluent
+ * {@link KafkaOptionsBuilder} OR a plain {@link KafkaOptionsType} object.
+ */
+export type KafkaOptions = KafkaOptionsBuilder | Partial<KafkaOptionsType>;
+/** Value alias so `KafkaOptions.create()` / `new KafkaOptions()` resolve to the builder. */
+export declare const KafkaOptions: typeof KafkaOptionsBuilder;
+//# sourceMappingURL=KafkaOptions.d.ts.map

package/dist/io/broker/KafkaOptions.d.ts.map

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

package/dist/io/broker/KafkaOptions.js

@@ -0,0 +1,61 @@
+/**
+ * Fluent builder for {@link KafkaOptionsType}.  Protocol-specific
+ * methods only; the common broker fields (`withReconnect` /
+ * `withCircuitBreaker` / `withOutboundBuffer`) come from
+ * {@link BrokerOptionsBuilder}.  `build()` snapshots the accumulated partial
+ * and feeds the same three-layer merge (constructor > HOCON under
+ * `actor-ts.io.broker.kafka` > built-in defaults).
+ */
+import { BrokerOptionsBuilder, BrokerOptionsValidator } from './BrokerOptions.js';
+export class KafkaOptionsBuilder extends BrokerOptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new KafkaOptionsBuilder()`. */
+    static create() {
+        return new KafkaOptionsBuilder();
+    }
+    /** Bootstrap servers (`'kafka-1:9092,kafka-2:9092'` or array). */
+    withBrokers(brokers) {
+        return this.set('brokers', brokers);
+    }
+    /** Stable client id reported to the broker. */
+    withClientId(clientId) {
+        return this.set('clientId', clientId);
+    }
+    /** SASL credentials. */
+    withSasl(sasl) {
+        return this.set('sasl', sasl);
+    }
+    /** Enable TLS.  Default `false`. */
+    withSsl(on = true) {
+        return this.set('ssl', on);
+    }
+    /** Producer options (idempotence / auto-topic-creation). */
+    withProducer(producer) {
+        return this.set('producer', producer);
+    }
+    /** Consumer options.  `groupId` is required to start a consumer. */
+    withConsumer(consumer) {
+        return this.set('consumer', consumer);
+    }
+    /** Subscriber that receives every consumed record. */
+    withTarget(target) {
+        return this.set('target', target);
+    }
+    /** Topics the consumer subscribes to at connect time. */
+    withTopics(topics) {
+        return this.set('topics', topics);
+    }
+}
+/** Validates resolved {@link KafkaOptionsType} settings. */
+export class KafkaOptionsValidator extends BrokerOptionsValidator {
+    constructor() {
+        super('KafkaOptions');
+    }
+    rules(s) {
+        this.commonRules(s);
+        this.nonEmptyStringOrArray('brokers', s.brokers);
+        this.nestedPositive('consumer.commitTimeoutMs', s.consumer?.commitTimeoutMs);
+    }
+}
+/** Value alias so `KafkaOptions.create()` / `new KafkaOptions()` resolve to the builder. */
+export const KafkaOptions = KafkaOptionsBuilder;
+//# sourceMappingURL=KafkaOptions.js.map

package/dist/io/broker/KafkaOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KafkaOptions.js","sourceRoot":"","sources":["../../../src/io/broker/KafkaOptions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAgDlF,MAAM,OAAO,mBAAoB,SAAQ,oBAAsC;IAC7E,yEAAyE;IACzE,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACnC,CAAC;IAED,kEAAkE;IAClE,WAAW,CAAC,OAAuC;QACjD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,+CAA+C;IAC/C,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,wBAAwB;IACxB,QAAQ,CAAC,IAA2C;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,oCAAoC;IACpC,OAAO,CAAC,EAAE,GAAG,IAAI;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,4DAA4D;IAC5D,YAAY,CAAC,QAAmD;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,oEAAoE;IACpE,YAAY,CAAC,QAAmD;QAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,sDAAsD;IACtD,UAAU,CAAC,MAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,yDAAyD;IACzD,UAAU,CAAC,MAA6B;QACtC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,qBAAsB,SAAQ,sBAAwC;IACjF;QACE,KAAK,CAAC,cAAc,CAAC,CAAC;IACxB,CAAC;IACS,KAAK,CAAC,CAA4B;QAC1C,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,qBAAqB,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,CAAC,0BAA0B,EAAE,CAAC,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC/E,CAAC;CACF;AAOD,4FAA4F;AAC5F,MAAM,CAAC,MAAM,YAAY,GAAG,mBAAmB,CAAC"}

package/dist/io/broker/MqttActor.d.ts

@@ -1,149 +1,211 @@
 import type { Config } from '../../config/Config.js';
 import type { ActorRef } from '../../ActorRef.js';
 import { BrokerActor, type OutboundEnvelope } from './BrokerActor.js';
-import type { BrokerCommonSettings } from './BrokerSettings.js';
-/** MQTT QoS levels.  0 = at-most-once, 1 = at-least-once, 2 = exactly-once. */
-export type MqttQos = 0 | 1 | 2;
-export interface MqttSubscription {
-    readonly topic: string;
+import { MqttDecodeError, type MqttCodec } from './MqttCodec.js';
+import { MqttOptionsValidator } from './MqttOptions.js';
+import type { MqttOptions, MqttOptionsType } from './MqttOptions.js';
+import { type MqttActorMessage, type MqttMessage, type MqttPublish, type MqttQos, type MqttUserProperties } from './MqttMessages.js';
+export type { MqttQos, MqttUserProperties, MqttMessage, MqttPublish, MqttCommand } from './MqttMessages.js';
+/** Per-publish overrides. */
+export interface MqttPublishOptions {
     readonly qos?: MqttQos;
-    readonly target: ActorRef<MqttMessage>;
+    readonly retain?: boolean;
+    readonly userProperties?: MqttUserProperties;
 }
 /**
- * Multi-valued user-property bag carried alongside an MQTT 5.0
- * message.  Same shape as the underlying mqtt-packet's
- * `properties.userProperties` field — a single key may map to one
- * value or an array of values (the protocol allows duplicates).
- * Absent when the broker / client is on MQTT 3.1.1.
+ * Typed, subclass-first MQTT 3.1.1 / 5.0 actor backed by the `mqtt`
+ * peer-dep — the MQTT counterpart to `WebsocketClientActor`.  Extend it,
+ * declare subscriptions in the constructor, and handle inbound traffic
+ * in `onMessage`:
+ *
+ *     class MyClient extends MqttActor {
+ *       constructor(opts: MqttOptions) {
+ *         super(opts.withQos(1).withClientId('my-client'));
+ *         this.subscribe('some/thing/#');
+ *       }
+ *       override onMessage(msg: MqttMessage): void {
+ *         this.log.info(msg.payload.text());
+ *         this.publish(msg.topic, 'pong');
+ *       }
+ *     }
+ *
+ * `T` types the inbound payload (`msg.payload.entity(): T`); `TSelf`
+ * types application messages other actors may `tell` this ref (defaults
+ * to `never`).  It is still externally controllable: `ref.tell(cmd)`
+ * with a {@link MqttCommand} publishes / subscribes / unsubscribes; a
+ * `subscribe` command with no `target` routes to this actor's own
+ * `onMessage`, with a `target` fans out to that actor.
+ *
+ * Lifecycle events (inbound / connected / disconnected) are delivered
+ * through the mailbox, so `onMessage` and the hooks always run on the
+ * actor thread (single-threaded, per-connection order preserved).
  */
-export type MqttUserProperties = Record<string, string | string[]>;
-/** Inbound MQTT message handed to subscribers. */
-export interface MqttMessage {
-    readonly topic: string;
-    readonly payload: Uint8Array;
-    readonly qos: MqttQos;
-    readonly retain: boolean;
+export declare abstract class MqttActor<T = unknown, TSelf = never> extends BrokerActor<MqttOptionsType, MqttActorMessage<T, TSelf>, MqttPublish> {
+    private client;
+    private _codec;
+    /** False until `preStart` — before that `subscribe()` only records. */
+    private _started;
+    /** Single source of truth: pattern → routing entry. */
+    private readonly registry;
+    /** Deathwatch bookkeeping: ref.path → its watched ref + the patterns it consumes. */
+    private readonly watched;
+    /** Subscriptions requested in the constructor, flushed in `preStart`. */
+    private pendingSubs;
+    constructor(options?: MqttOptions);
+    /** Handle one inbound message on this actor's own subscriptions. */
+    abstract onMessage(msg: MqttMessage<T>): void | Promise<void>;
+    /** The connection (re)opened; the registry has been re-applied on the broker. */
+    protected onConnected(): void | Promise<void>;
+    /** The connection dropped; a reconnect cycle may follow (per options). */
+    protected onDisconnected(_cause?: Error): void | Promise<void>;
     /**
-     * MQTT 5.0 user properties on the inbound packet, if any.  Always
-     * `undefined` for MQTT 3.1.1 traffic — the protocol doesn't carry
-     * them.  See {@link MqttActorSettings.protocolVersion}.
+     * `onMessage` threw an {@link MqttDecodeError} — typically from a lazy
+     * `payload.entity()` on a malformed payload.  Default: log + drop (bad
+     * wire data shouldn't restart the actor).  Rethrow to escalate to the
+     * supervisor.
      */
-    readonly userProperties?: MqttUserProperties;
+    protected onInvalidMessage(error: MqttDecodeError, _msg: MqttMessage<T>): void | Promise<void>;
+    /** App-level message told to this actor's ref (reachable only when TSelf ≠ never). */
+    protected onSelfMessage(msg: TSelf): void | Promise<void>;
     /**
-     * MQTT 5.0 PUBACK / PUBREC reason code attached to the message,
-     * if the broker emitted one.  `undefined` for MQTT 3.1.1 or for
-     * unprompted publishes.  See the MQTT 5.0 spec § 2.4 "Reason Code"
-     * for the value space.
+     * Register a subscription.  Constructor-safe: before start it is only
+     * recorded (no context/options access) and flushed on first connect.
+     * At runtime it also issues a broker SUBSCRIBE when connected;
+     * otherwise the registry entry is applied on the next connect.  Omit
+     * `target` to deliver to this actor's own `onMessage`.
      */
-    readonly reasonCode?: number;
-}
-/** Outbound publish envelope. */
-export interface MqttPublish {
-    readonly topic: string;
-    readonly payload: Uint8Array | string;
-    readonly qos?: MqttQos;
-    readonly retain?: boolean;
+    protected subscribe(topic: string, opts?: {
+        qos?: MqttQos;
+        target?: ActorRef<MqttMessage<T>>;
+    }): void;
     /**
-     * MQTT 5.0 user properties to attach to the PUBLISH packet.
-     * Silently dropped when the actor's `protocolVersion` is 4 — the
-     * 3.1.1 wire format has no way to carry them.
+     * Remove a subscription.  With `target`, removes that foreign target;
+     * without, removes this actor's own `onMessage` delivery for `topic`.
+     * A broker UNSUBSCRIBE fires once the pattern has no consumers left.
      */
-    readonly userProperties?: MqttUserProperties;
-}
-export interface MqttCredentials {
-    readonly username?: string;
-    readonly password?: string;
-}
-export interface MqttActorSettings extends BrokerCommonSettings {
-    /** Broker URL — `mqtt://`, `mqtts://`, `ws://`, `wss://`. */
-    readonly brokerUrl?: string;
-    /** Stable client id.  When omitted the broker assigns one. */
-    readonly clientId?: string;
-    readonly credentials?: MqttCredentials;
-    /** Default QoS used by `publish` / `subscribe` when not overridden per call. */
-    readonly defaultQos?: MqttQos;
-    /** Initial subscriptions wired up immediately after connect. */
-    readonly subscriptions?: ReadonlyArray<MqttSubscription>;
-    /** Last-will-and-testament published by the broker if the actor disconnects ungracefully. */
-    readonly will?: {
-        readonly topic: string;
-        readonly payload: Uint8Array | string;
-        readonly qos?: MqttQos;
-        readonly retain?: boolean;
-    };
-    /** Clean-session flag.  Default `true`. */
-    readonly cleanSession?: boolean;
-    /** Keep-alive interval in seconds.  Default 60. */
-    readonly keepAliveSec?: number;
+    protected unsubscribe(topic: string, opts?: {
+        target?: ActorRef<MqttMessage<T>>;
+    }): void;
     /**
-     * MQTT protocol version negotiated with the broker.  Default `4`
-     * (MQTT 3.1.1) for back-compat with every existing config; set to
-     * `5` to opt in to MQTT 5.0 features (user properties + reason
-     * codes — see {@link MqttPublish.userProperties} +
-     * {@link MqttMessage.reasonCode}).  The peer-dep `mqtt` handles
-     * the wire negotiation; we only flip the flag.
+     * Publish to `topic`.  A `string` or `Uint8Array` payload is sent
+     * as-is; any other value is encoded via the actor's codec (default
+     * JSON).  Returns false if the message was dropped (encode failure or
+     * outbound-buffer overflow).
+     *
+     * To publish a bare string *as a codec entity* (JSON `"pong"` rather
+     * than the raw bytes `pong`), encode it explicitly:
+     * `this.publish(topic, this.codec().encode('pong'))`.
      */
-    readonly protocolVersion?: 4 | 5;
-}
-export type MqttCmd = {
-    readonly kind: 'publish';
-    readonly publish: MqttPublish;
-} | {
-    readonly kind: 'subscribe';
-    readonly topic: string;
-    readonly target: ActorRef<MqttMessage>;
-    readonly qos?: MqttQos;
-} | {
-    readonly kind: 'unsubscribe';
-    readonly topic: string;
-    readonly target?: ActorRef<MqttMessage>;
-};
-/**
- * MQTT 3.1.1 / 5.0 actor backed by the `mqtt` peer-dep.  Inbound
- * messages are routed to subscribers via the base class' fan-out;
- * wildcard subscriptions (`+`, `#`) are honoured on the broker side
- * and locally we deliver based on the *concrete* topic the message
- * was received on (matching Paho/mqtt.js semantics).
- *
- * The `subscriptions` setting wires up topic→actor mappings at
- * connect-time; runtime `tell({ kind: 'subscribe', ... })` adds more.
- */
-export declare class MqttActor extends BrokerActor<MqttActorSettings, MqttCmd, MqttPublish> {
-    private client;
+    protected publish(topic: string, payload: string | Uint8Array, opts?: MqttPublishOptions): boolean;
+    protected publish<E>(topic: string, entity: E, opts?: MqttPublishOptions): boolean;
+    /**
+     * The actor's payload codec (default {@link mqttJsonCodec}).  Exposed
+     * so subclasses can encode/decode explicitly — e.g. to publish a bare
+     * string as a JSON entity.  Only valid after `preStart`.
+     */
+    protected codec(): MqttCodec<unknown>;
+    /** @internal Sealed — override onMessage + hooks instead. */
+    onReceive(cmd: MqttActorMessage<T, TSelf>): void | Promise<void>;
+    private handleCommand;
+    private routeInbound;
+    private registerSubscription;
     /**
-     * topic-pattern → subscribers.  Patterns can be wildcard (`a/+/c`,
-     * `a/#`).  We test inbound topics against every pattern at delivery
-     * time — O(n) but n is small in practice (sub-100 patterns).
+     * @param fromExternal true for an external `unsubscribe` command with
+     *   no target — drops all foreign targets but keeps the actor's own
+     *   subscription (a controller must not be able to silence the
+     *   subclass's constructor-declared subscription).  false for the
+     *   protected `unsubscribe(topic)` — drops only the own delivery.
      */
-    private readonly patternSubs;
-    constructor(settings?: Partial<MqttActorSettings>);
+    private removeSubscription;
+    private removeTerminatedTarget;
+    private watchTarget;
+    private unwatchTarget;
+    private brokerSubscribe;
+    private brokerUnsubscribe;
+    preStart(): Promise<void>;
     protected configKey(): string;
-    protected builtInDefaults(): Partial<MqttActorSettings>;
-    protected readSettingsFromConfig(c: Config): Partial<MqttActorSettings>;
-    protected requiredSettings(): ReadonlyArray<keyof MqttActorSettings>;
+    protected builtInDefaultOptions(): Partial<MqttOptionsType>;
+    protected readOptionsFromConfig(config: Config): Partial<MqttOptionsType>;
+    protected requiredOptions(): ReadonlyArray<keyof MqttOptionsType>;
+    protected optionsValidator(): MqttOptionsValidator;
     protected endpointLabel(): string;
-    protected connectImpl(): Promise<void>;
-    protected disconnectImpl(): Promise<void>;
+    /** @internal Test seam — override to inject a fake mqtt module. */
+    protected mqttModule(): Promise<MqttModuleLike>;
+    protected connectImplementation(): Promise<void>;
+    protected disconnectImplementation(): Promise<void>;
     protected dispatchOutgoing(env: OutboundEnvelope<MqttPublish>): Promise<void>;
-    onReceive(cmd: MqttCmd): void;
-    private patternSubscribe;
-    private patternUnsubscribe;
-    private dispatchInbound;
 }
 /**
  * Build the mqtt-packet `properties` object for an outbound publish,
  * or `undefined` if there's nothing v5-specific to attach.  Pure
- * function — testable without a real broker or mqtt.js install
- * (see `tests/unit/io/broker/MqttActor.test.ts`).
+ * function — testable without a real broker or mqtt.js install.
  *
  * `protocolVersion < 5` always returns undefined: the 3.1.1 wire
- * format has no slot for user properties, so we drop them rather
- * than letting them leak into the publish callsite and confuse
- * downstream tooling.
+ * format has no slot for user properties, so we drop them rather than
+ * letting them leak into the publish callsite.
  */
 export declare function buildPublishProperties(p: MqttPublish, protocolVersion: 4 | 5): {
     userProperties?: MqttUserProperties;
 } | undefined;
 /** Standard MQTT pattern match: `+` matches one segment, `#` matches the rest. */
 export declare function matchesMqttPattern(pattern: string, topic: string): boolean;
+interface MqttConnectOptions {
+    clientId?: string;
+    username?: string;
+    password?: string;
+    clean?: boolean;
+    keepalive?: number;
+    /** mqtt.js: 4 (3.1.1), 5 (5.0).  We allow 4 and 5. */
+    protocolVersion?: 4 | 5;
+    will?: {
+        topic: string;
+        payload: Uint8Array | string;
+        qos: MqttQos;
+        retain: boolean;
+    };
+}
+interface MqttPubOpts {
+    qos: MqttQos;
+    retain: boolean;
+    /** mqtt-packet v5 properties — attached only when protocolVersion=5. */
+    properties?: {
+        userProperties?: MqttUserProperties;
+    };
+}
+/**
+ * Inbound packet shape read off mqtt.js.  v5 nests user properties +
+ * reason codes under `properties`; absent on 3.1.1.  Exported as a test
+ * seam so a fake client can build the same shape.
+ */
+export interface MqttInboundPacketLike {
+    qos?: number;
+    retain?: boolean;
+    properties?: {
+        userProperties?: MqttUserProperties;
+        reasonCode?: number;
+    };
+}
+/**
+ * Minimal surface of the mqtt.js client we rely on.  Exported as a test
+ * seam so subclasses overriding {@link MqttActor.mqttModule} can satisfy
+ * the same shape without the real peer-dep.
+ */
+export interface MqttClientLike {
+    on(event: 'message', cb: (topic: string, payload: Uint8Array, packet?: MqttInboundPacketLike) => void): void;
+    on(event: 'error', cb: (err: Error) => void): void;
+    on(event: 'close', cb: () => void): void;
+    once(event: 'connect', cb: () => void): void;
+    once(event: 'error', cb: (err: Error) => void): void;
+    removeAllListeners(event?: string): void;
+    publish(topic: string, payload: string | Uint8Array, opts: MqttPubOpts, cb?: (err?: Error) => void): void;
+    subscribe(topic: string, opts: {
+        qos: MqttQos;
+    }, cb?: (err?: Error) => void): void;
+    unsubscribe(topic: string, opts: undefined, cb?: (err?: Error) => void): void;
+    end(force?: boolean, opts?: object, cb?: () => void): void;
+}
+/** The `mqtt` module surface we use.  Exported as a test seam. */
+export interface MqttModuleLike {
+    connect(url: string, opts?: MqttConnectOptions): MqttClientLike;
+}
 //# sourceMappingURL=MqttActor.d.ts.map

package/dist/io/broker/MqttActor.d.ts.map

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