@venizia/ignis-helpers 0.2.0-2 → 0.2.0-21

package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.platformaticRequirePlugin = void 0;
 const common_1 = require("./common");
-/** `@platformatic/kafka` resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with "Cannot find package" before boot - this plugin hoists those calls to static imports at bundle time. */
+/** `@platformatic/kafka` 2.8-2.9 resolves some dependencies through `createRequire(import.meta.url)` at module scope; `bun build --compile` cannot see through that, so the specifier stays unresolved and the binary dies with "Cannot find package" before boot - this plugin hoists those calls to static imports at bundle time. 2.10 removed the module-scope require(), so on >= 2.10 the plugin matches nothing and is inert. */
 const platformaticRequirePlugin = () => ({
     name: common_1.KafkaBundlerPluginNames.PLATFORMATIC_REQUIRE,
     setup(build) {

package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"platformatic-require.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":";;;AACA,qCAAkF;AAElF,gUAAgU;AACzT,MAAM,yBAAyB,GAAG,GAAc,EAAE,CAAC,CAAC;IACzD,IAAI,EAAE,gCAAuB,CAAC,oBAAoB;IAClD,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,sCAA6B,CAAC,aAAa,EAAE,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACjF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC7B,sCAA6B,CAAC,eAAe,EAC7C,CAAC,OAAO,EAAE,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE;gBAC9D,IAAI,sCAA6B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzE,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,sCAA6B,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAEnE,uFAAuF;gBACvF,wFAAwF;gBACxF,8EAA8E;gBAC9E,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG,CAAC;YACxC,CAAC,CACF,CAAC;YAEF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAhCU,QAAA,yBAAyB,6BAgCnC"}
+{"version":3,"file":"platformatic-require.plugin.js","sourceRoot":"","sources":["../../../../../../src/modules/queue/kafka/bundler/platformatic-require.plugin.ts"],"names":[],"mappings":";;;AACA,qCAAkF;AAElF,waAAwa;AACja,MAAM,yBAAyB,GAAG,GAAc,EAAE,CAAC,CAAC;IACzD,IAAI,EAAE,gCAAuB,CAAC,oBAAoB;IAClD,KAAK,CAAC,KAAK;QACT,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,sCAA6B,CAAC,aAAa,EAAE,EAAE,KAAK,EAAC,IAAI,EAAC,EAAE;YACjF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,MAAM,OAAO,GAAa,EAAE,CAAC;YAE7B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAC7B,sCAA6B,CAAC,eAAe,EAC7C,CAAC,OAAO,EAAE,OAAe,EAAE,MAAc,EAAE,SAAiB,EAAE,EAAE;gBAC9D,IAAI,sCAA6B,CAAC,kBAAkB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACzE,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,KAAK,GAAG,GAAG,sCAA6B,CAAC,mBAAmB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;gBACtF,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBAEnE,uFAAuF;gBACvF,wFAAwF;gBACxF,8EAA8E;gBAC9E,OAAO,SAAS,OAAO,MAAM,KAAK,GAAG,CAAC;YACxC,CAAC,CACF,CAAC;YAEF,kFAAkF;YAClF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC;AAhCU,QAAA,yBAAyB,6BAgCnC"}

package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.platformaticWasmPlugin = void 0;
-const error_1 = require("../../../../modules/error");
+const error_1 = require("../../../error");
 const node_path_1 = require("node:path");
 const common_1 = require("./common");
 /** `@platformatic/wasm-utils`'s default entrypoint reads `native.wasm` from disk at module load and `bun build --compile` embeds JS only, so it resolves against `/$bunfs` and the binary dies with ENOENT - this plugin redirects the import to the `/bundled` entrypoint (wasm inlined). */

package/dist/cjs/modules/queue/kafka/common/types/admin.d.ts

@@ -0,0 +1,9 @@
+import { TKafkaBrokerEventCallback } from './callbacks';
+import { IKafkaConnectionOptions } from './connection';
+export interface IKafkaAdminOptions extends IKafkaConnectionOptions {
+    identifier?: string;
+    shutdownTimeout?: number;
+    onBrokerConnect?: TKafkaBrokerEventCallback;
+    onBrokerDisconnect?: TKafkaBrokerEventCallback;
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;CAChD"}

package/dist/cjs/modules/queue/kafka/common/types/admin.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=admin.js.map

package/dist/cjs/modules/queue/kafka/common/types/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/admin.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/queue/kafka/common/types/callbacks.d.ts

@@ -0,0 +1,56 @@
+import { ValueOrPromise } from '../../../../../common/types';
+import type { Broker, Consumer, Message, Offsets, ProduceResult, Producer, SendOptions } from '@platformatic/kafka';
+export type TKafkaBrokerEventCallback = (opts: {
+    broker: Broker;
+}) => ValueOrPromise<void>;
+export type TKafkaMessageCallback<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> = (opts: {
+    message: Message<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+}) => ValueOrPromise<void>;
+export type TKafkaMessageDoneCallback<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> = (opts: {
+    message: Message<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+}) => ValueOrPromise<void>;
+export type TKafkaMessageErrorCallback<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> = (opts: {
+    error: Error;
+    message?: Message<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+}) => ValueOrPromise<void>;
+/** The stream 'error' event - falls back to `onMessageError` when unset. */
+export type TKafkaStreamErrorCallback = (opts: {
+    error: Error;
+}) => ValueOrPromise<void>;
+/** A reconnect failure (client rebuild or the reconnect attempt itself) - falls back to `onMessageError` when unset. */
+export type TKafkaReconnectErrorCallback = (opts: {
+    error: Error;
+    attempt: number;
+    maxAttempts: number;
+}) => ValueOrPromise<void>;
+export type TKafkaGroupJoinCallback = (opts: {
+    groupId: string;
+    memberId: string;
+    generationId?: number;
+}) => ValueOrPromise<void>;
+export type TKafkaGroupLeaveCallback = (opts: {
+    groupId: string;
+    memberId: string | null;
+}) => ValueOrPromise<void>;
+export type TKafkaGroupRebalanceCallback = (opts: {
+    groupId: string;
+}) => ValueOrPromise<void>;
+export type TKafkaHeartbeatErrorCallback = (opts: {
+    error: Error;
+    groupId?: string;
+    memberId?: string | null;
+}) => ValueOrPromise<void>;
+export type TKafkaLagCallback = (opts: {
+    lag: Offsets;
+}) => ValueOrPromise<void>;
+export type TKafkaLagErrorCallback = (opts: {
+    error: Error;
+}) => ValueOrPromise<void>;
+export type TKafkaTransactionCallback<ResultType, KeyType, ValueType, HeaderKeyType, HeaderValueType> = (ctx: IKafkaTransactionContext<KeyType, ValueType, HeaderKeyType, HeaderValueType>) => Promise<ResultType>;
+export interface IKafkaTransactionContext<KeyType, ValueType, HeaderKeyType, HeaderValueType> {
+    transaction: Awaited<ReturnType<Producer<KeyType, ValueType, HeaderKeyType, HeaderValueType>['beginTransaction']>>;
+    send: (opts: SendOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>) => Promise<ProduceResult>;
+    addConsumer: <ConsumerKeyType, ConsumerValueType, ConsumerHeaderKeyType, ConsumerHeaderValueType>(consumer: Consumer<ConsumerKeyType, ConsumerValueType, ConsumerHeaderKeyType, ConsumerHeaderValueType>) => Promise<void>;
+    addOffset: <MessageKeyType, MessageValueType, MessageHeaderKeyType, MessageHeaderValueType>(message: Message<MessageKeyType, MessageValueType, MessageHeaderKeyType, MessageHeaderValueType>) => Promise<void>;
+}
+//# sourceMappingURL=callbacks.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/callbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/callbacks.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/queue/kafka/common/types/callbacks.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=callbacks.js.map

package/dist/cjs/modules/queue/kafka/common/types/callbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/callbacks.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/queue/kafka/common/types/connection.d.ts

@@ -0,0 +1,11 @@
+import type { ConfluentSchemaRegistryOptions, ConnectionOptions } from '@platformatic/kafka';
+export interface IKafkaConnectionOptions extends ConnectionOptions {
+    bootstrapBrokers: string[];
+    clientId: string;
+    retries?: number;
+    retryDelay?: number;
+}
+export interface IKafkaSchemaRegistryOptions extends ConfluentSchemaRegistryOptions {
+    identifier?: string;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/connection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7F,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA4B,SAAQ,8BAA8B;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/cjs/modules/queue/kafka/common/types/connection.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=connection.js.map

package/dist/cjs/modules/queue/kafka/common/types/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/connection.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/queue/kafka/common/types/consumer.d.ts

@@ -0,0 +1,45 @@
+import type { Deserializers, MessagesStreamFallbackModeValue, MessagesStreamModeValue, SchemaRegistry } from '@platformatic/kafka';
+import { TKafkaGroupProtocol } from '../constants';
+import { TKafkaBrokerEventCallback, TKafkaGroupJoinCallback, TKafkaGroupLeaveCallback, TKafkaGroupRebalanceCallback, TKafkaHeartbeatErrorCallback, TKafkaLagCallback, TKafkaLagErrorCallback, TKafkaMessageCallback, TKafkaMessageDoneCallback, TKafkaMessageErrorCallback, TKafkaReconnectErrorCallback, TKafkaStreamErrorCallback } from './callbacks';
+import { IKafkaConnectionOptions } from './connection';
+export interface IKafkaConsumerOptions<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> extends IKafkaConnectionOptions {
+    groupId: string;
+    identifier?: string;
+    deserializers?: Partial<Deserializers<KeyType, ValueType, HeaderKeyType, HeaderValueType>>;
+    autocommit?: boolean | number;
+    sessionTimeout?: number;
+    heartbeatInterval?: number;
+    rebalanceTimeout?: number;
+    highWaterMark?: number;
+    minBytes?: number;
+    maxBytes?: number;
+    maxWaitTime?: number;
+    metadataMaxAge?: number;
+    groupProtocol?: TKafkaGroupProtocol;
+    groupInstanceId?: string;
+    shutdownTimeout?: number;
+    registry?: SchemaRegistry<unknown, unknown, KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    onBrokerConnect?: TKafkaBrokerEventCallback;
+    onBrokerDisconnect?: TKafkaBrokerEventCallback;
+    onMessage?: TKafkaMessageCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    onMessageDone?: TKafkaMessageDoneCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    onMessageError?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    /** Stream 'error' events; falls back to `onMessageError` when unset. */
+    onStreamError?: TKafkaStreamErrorCallback;
+    /** Reconnect failures (client rebuild or the reconnect attempt); falls back to `onMessageError` when unset. */
+    onReconnectError?: TKafkaReconnectErrorCallback;
+    onGroupJoin?: TKafkaGroupJoinCallback;
+    onGroupLeave?: TKafkaGroupLeaveCallback;
+    onGroupRebalance?: TKafkaGroupRebalanceCallback;
+    onHeartbeatError?: TKafkaHeartbeatErrorCallback;
+    onLag?: TKafkaLagCallback;
+    onLagError?: TKafkaLagErrorCallback;
+}
+export interface IKafkaConsumeStartOptions {
+    topics: string[];
+    mode?: MessagesStreamModeValue;
+    fallbackMode?: MessagesStreamFallbackModeValue;
+    reconnectDelayMs?: number;
+    maxReconnectAttempts?: number;
+}
+//# sourceMappingURL=consumer.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,+BAA+B,EAC/B,uBAAuB,EACvB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,qBAAqB,CACpC,OAAO,GAAG,MAAM,EAChB,SAAS,GAAG,MAAM,EAClB,aAAa,GAAG,MAAM,EACtB,eAAe,GAAG,MAAM,CACxB,SAAQ,uBAAuB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;IAC3F,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IAEhG,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAE/C,SAAS,CAAC,EAAE,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IACtF,aAAa,CAAC,EAAE,yBAAyB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IAC9F,cAAc,CAAC,EAAE,0BAA0B,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IAChG,wEAAwE;IACxE,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,+GAA+G;IAC/G,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAEhD,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAEhD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,uBAAuB,CAAC;IAC/B,YAAY,CAAC,EAAE,+BAA+B,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B"}

package/dist/cjs/modules/queue/kafka/common/types/consumer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=consumer.js.map

package/dist/cjs/modules/queue/kafka/common/types/consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/consumer.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/queue/kafka/common/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './admin';
+export * from './callbacks';
+export * from './connection';
+export * from './consumer';
+export * from './producer';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/cjs/modules/queue/kafka/common/types/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./admin"), exports);
+__exportStar(require("./callbacks"), exports);
+__exportStar(require("./connection"), exports);
+__exportStar(require("./consumer"), exports);
+__exportStar(require("./producer"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/modules/queue/kafka/common/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,6CAA2B"}

package/dist/cjs/modules/queue/kafka/common/types/producer.d.ts

@@ -0,0 +1,19 @@
+import type { CompressionAlgorithmValue, SchemaRegistry, Serializers } from '@platformatic/kafka';
+import { TKafkaAcks } from '../constants';
+import { TKafkaBrokerEventCallback } from './callbacks';
+import { IKafkaConnectionOptions } from './connection';
+export interface IKafkaProducerOptions<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> extends IKafkaConnectionOptions {
+    identifier?: string;
+    serializers?: Partial<Serializers<KeyType, ValueType, HeaderKeyType, HeaderValueType>>;
+    compression?: CompressionAlgorithmValue;
+    acks?: TKafkaAcks;
+    idempotent?: boolean;
+    transactionalId?: string;
+    strict?: boolean;
+    autocreateTopics?: boolean;
+    shutdownTimeout?: number;
+    registry?: SchemaRegistry<unknown, unknown, KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    onBrokerConnect?: TKafkaBrokerEventCallback;
+    onBrokerDisconnect?: TKafkaBrokerEventCallback;
+}
+//# sourceMappingURL=producer.d.ts.map

package/dist/cjs/modules/queue/kafka/common/types/producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.d.ts","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/producer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,MAAM,WAAW,qBAAqB,CACpC,OAAO,GAAG,MAAM,EAChB,SAAS,GAAG,MAAM,EAClB,aAAa,GAAG,MAAM,EACtB,eAAe,GAAG,MAAM,CACxB,SAAQ,uBAAuB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;IACvF,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IAChG,eAAe,CAAC,EAAE,yBAAyB,CAAC;IAC5C,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;CAChD"}

package/dist/cjs/modules/queue/kafka/common/types/producer.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=producer.js.map

package/dist/cjs/modules/queue/kafka/common/types/producer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.js","sourceRoot":"","sources":["../../../../../../../src/modules/queue/kafka/common/types/producer.ts"],"names":[],"mappings":""}

package/dist/cjs/modules/queue/kafka/consumer.d.ts

@@ -1,28 +1,41 @@
 import type { MessagesStream } from '@platformatic/kafka';
 import { Consumer } from '@platformatic/kafka';
 import { BaseKafkaHelper } from './base';
-import type { IKafkaConsumeStartOptions, IKafkaConsumerOptions } from './common/types';
-/** Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring. */
+import type { IKafkaConsumeStartOptions, IKafkaConsumerOptions, TKafkaGroupJoinCallback, TKafkaGroupLeaveCallback, TKafkaGroupRebalanceCallback, TKafkaHeartbeatErrorCallback, TKafkaLagCallback, TKafkaLagErrorCallback, TKafkaMessageCallback, TKafkaMessageDoneCallback, TKafkaMessageErrorCallback, TKafkaReconnectErrorCallback, TKafkaStreamErrorCallback } from './common/types';
+/**
+ * Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring.
+ *
+ * Every member below is `protected`, not `private`, so a consumer extends this class instead of forking it. That visibility is not a stable contract between minor versions.
+ */
 export declare class KafkaConsumerHelper<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string> extends BaseKafkaHelper<Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>> {
-    private stream;
-    private consumeLoop;
-    private consumeStartOptions;
-    private lagMonitoringActive;
-    private lagMonitoringOptions;
-    private sessionLikelyStale;
-    private readonly onMessage?;
-    private readonly onMessageDone?;
-    private readonly onMessageError?;
-    private readonly onGroupJoin?;
-    private readonly onGroupLeave?;
-    private readonly onGroupRebalance?;
-    private readonly onHeartbeatError?;
-    private readonly onLag?;
-    private readonly onLagError?;
-    private readonly initialOptions;
+    protected stream: MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null;
+    protected consumeLoop: Promise<void> | null;
+    protected consumeStartOptions: IKafkaConsumeStartOptions | null;
+    protected lagMonitoringActive: boolean;
+    protected lagMonitoringOptions: {
+        topics: string[];
+        interval?: number;
+    } | null;
+    protected sessionLikelyStale: boolean;
+    protected readonly onMessage?: TKafkaMessageCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    protected readonly onMessageDone?: TKafkaMessageDoneCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    protected readonly onMessageError?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    protected readonly onStreamError?: TKafkaStreamErrorCallback;
+    protected readonly onReconnectError?: TKafkaReconnectErrorCallback;
+    protected readonly onGroupJoin?: TKafkaGroupJoinCallback;
+    protected readonly onGroupLeave?: TKafkaGroupLeaveCallback;
+    protected readonly onGroupRebalance?: TKafkaGroupRebalanceCallback;
+    protected readonly onHeartbeatError?: TKafkaHeartbeatErrorCallback;
+    protected readonly onLag?: TKafkaLagCallback;
+    protected readonly onLagError?: TKafkaLagErrorCallback;
+    protected readonly initialOptions: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
     constructor(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>);
     static newInstance<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string>(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>): KafkaConsumerHelper<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
-    private static buildConsumerClient;
+    /** The instance seam every rebuild goes through; the constructor alone uses the static factory because no instance exists yet. Override this to hand a rebuilt consumer different options or a test double. */
+    protected buildClient(opts: {
+        options: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    }): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    protected static buildConsumerClient<KeyType = string, ValueType = string, HeaderKeyType = string, HeaderValueType = string>(opts: IKafkaConsumerOptions<KeyType, ValueType, HeaderKeyType, HeaderValueType>): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
     getConsumer(): Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
     getStream(): MessagesStream<KeyType, ValueType, HeaderKeyType, HeaderValueType> | null;
     isReady(): boolean;
@@ -36,15 +49,38 @@ export declare class KafkaConsumerHelper<KeyType = string, ValueType = string, H
     close(opts?: {
         isForce?: boolean;
     }): Promise<void>;
-    private startConsumeLoop;
-    private consumeMessages;
-    private drainStream;
-    private attemptReconnect;
-    private rebuildClient;
-    private closeOldClient;
-    private handleAllBrokersDown;
-    private destroyDeadStream;
-    private closeStream;
+    protected startConsumeLoop(opts: {
+        messageHandler: TKafkaMessageCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+        doneHandler?: TKafkaMessageDoneCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+        errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+        reconnectDelayMs: number;
+        maxReconnectAttempts: number;
+    }): Promise<void>;
+    protected consumeMessages(opts: {
+        reconnectDelayMs: number;
+        maxReconnectAttempts: number;
+        errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    }): AsyncGenerator<import("@platformatic/kafka", { with: { "resolution-mode": "import" } }).Message<KeyType, ValueType, HeaderKeyType, HeaderValueType>, void, any>;
+    /** Silent only while the consume loop is alive AND the erroring stream is the one it drains - the iterator then reports the same error once. A dead or replaced stream, or pull mode, reports here. */
+    protected reportStreamError(opts: {
+        error: Error;
+        scope: string;
+        stream: unknown;
+    }): void;
+    protected drainStream(opts: {
+        errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    }): AsyncGenerator<import("@platformatic/kafka", { with: { "resolution-mode": "import" } }).Message<KeyType, ValueType, HeaderKeyType, HeaderValueType>, void, any>;
+    protected attemptReconnect(opts: {
+        attempt: number;
+        maxAttempts: number;
+        delayMs: number;
+        errorHandler?: TKafkaMessageErrorCallback<KeyType, ValueType, HeaderKeyType, HeaderValueType>;
+    }): Promise<void>;
+    protected rebuildClient(): Promise<void>;
+    protected closeOldClient(oldClient: Consumer<KeyType, ValueType, HeaderKeyType, HeaderValueType>): Promise<void>;
+    protected handleAllBrokersDown(reason: 'disconnected' | 'failed'): void;
+    protected destroyDeadStream(): void;
+    protected closeStream(): Promise<void>;
     protected unconfigureBrokerEvents(): void;
     protected configureBrokerEvents(): void;
 }

package/dist/cjs/modules/queue/kafka/consumer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/consumer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAKV,cAAc,EAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EAUtB,MAAM,gBAAgB,CAAC;AAExB,0JAA0J;AAC1J,qBAAa,mBAAmB,CAC9B,OAAO,GAAG,MAAM,EAChB,SAAS,GAAG,MAAM,EAClB,aAAa,GAAG,MAAM,EACtB,eAAe,GAAG,MAAM,CACxB,SAAQ,eAAe,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC;IACrF,OAAO,CAAC,MAAM,CAAmF;IACjG,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,mBAAmB,CAA0C;IACrE,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,oBAAoB,CAAwD;IACpF,OAAO,CAAC,kBAAkB,CAAS;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAKzB;IACF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAK7B;IACF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAK9B;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAA+B;IACjE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAA+B;IAEjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAyB;IAErD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAK7B;gBAEU,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC;IA+B3F,MAAM,CAAC,WAAW,CAChB,OAAO,GAAG,MAAM,EAChB,SAAS,GAAG,MAAM,EAClB,aAAa,GAAG,MAAM,EACtB,eAAe,GAAG,MAAM,EACxB,IAAI,EAAE,qBAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC;IAIjF,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAoClC,WAAW,IAAI,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC;IAI3E,SAAS,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,CAAC,GAAG,IAAI;IAI7E,OAAO,IAAI,OAAO;IAIrB,KAAK,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0C3D,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBvE,iBAAiB,IAAI,IAAI;cAYN,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzC,KAAK,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAqB1C,gBAAgB;YAiCf,eAAe;YAgDf,WAAW;YA4BZ,gBAAgB;YAgGhB,aAAa;YAoCb,cAAc;IA0B5B,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,iBAAiB;YAKX,WAAW;cAeN,uBAAuB,IAAI,IAAI;cAU/B,qBAAqB,IAAI,IAAI;CAoGjD"}
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../../../../src/modules/queue/kafka/consumer.ts"],"names":[],"mappings":"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"}

package/dist/cjs/modules/queue/kafka/consumer.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KafkaConsumerHelper = void 0;
-const error_1 = require("../../../modules/error");
+const error_1 = require("../../error");
 const date_utility_1 = require("../../../utilities/date.utility");
 const promise_utility_1 = require("../../../utilities/promise.utility");
 const kafka_1 = require("@platformatic/kafka");
 const common_1 = require("../common");
 const base_1 = require("./base");
 const constants_1 = require("./common/constants");
-/** Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring. */
+/**
+ * Wrapper around `@platformatic/kafka` Consumer with lifecycle management, health tracking, graceful shutdown, message callbacks, and lag monitoring.
+ *
+ * Every member below is `protected`, not `private`, so a consumer extends this class instead of forking it. That visibility is not a stable contract between minor versions.
+ */
 class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
     constructor(opts) {
         super({
@@ -29,6 +33,8 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
         this.onMessage = opts.onMessage;
         this.onMessageDone = opts.onMessageDone;
         this.onMessageError = opts.onMessageError;
+        this.onStreamError = opts.onStreamError;
+        this.onReconnectError = opts.onReconnectError;
         this.onGroupJoin = opts.onGroupJoin;
         this.onGroupLeave = opts.onGroupLeave;
         this.onGroupRebalance = opts.onGroupRebalance;
@@ -41,6 +47,10 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
     static newInstance(opts) {
         return new KafkaConsumerHelper(opts);
     }
+    /** The instance seam every rebuild goes through; the constructor alone uses the static factory because no instance exists yet. Override this to hand a rebuilt consumer different options or a test double. */
+    buildClient(opts) {
+        return KafkaConsumerHelper.buildConsumerClient(opts.options);
+    }
     static buildConsumerClient(opts) {
         return new kafka_1.Consumer({
             clientId: opts.clientId,
@@ -92,22 +102,25 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
         // Successful consume() means we're freshly joined to the group; clear any stale-session flag set during initial broker negotiation (e.g. a transient BROKER_DISCONNECT during bootstrap).
         this.sessionLikelyStale = false;
         // Always attached, hook or not: a stream 'error' with ZERO listeners is rethrown by EventEmitter as an uncaught exception, so a pull-style consumer (start() + getStream(), no onMessage/onMessageError) would take the whole process down on the first broker drop.
-        this.stream.on(constants_1.KafkaClientEvents.STREAM_ERROR, (streamError) => {
+        const startedStream = this.stream;
+        startedStream.on(constants_1.KafkaClientEvents.STREAM_ERROR, (streamError) => {
             this.logger.for('start').error('Kafka stream ERROR | Error: %s', streamError);
-            (0, common_1.invokeHook)({
-                logger: this.logger,
-                scope: 'start',
-                execution: () => this.onMessageError?.({ error: streamError }),
-            });
+            this.reportStreamError({ error: streamError, scope: 'start', stream: startedStream });
         });
         if (this.onMessage) {
-            this.consumeLoop = this.startConsumeLoop({
+            const loop = this.startConsumeLoop({
                 messageHandler: this.onMessage,
                 doneHandler: this.onMessageDone,
                 errorHandler: this.onMessageError,
                 reconnectDelayMs: opts.reconnectDelayMs ?? constants_1.KafkaDefaults.RECONNECT_DELAY,
                 maxReconnectAttempts: opts.maxReconnectAttempts ?? constants_1.KafkaDefaults.MAX_RECONNECT_ATTEMPTS,
+            }).finally(() => {
+                // A finished loop (exhausted reconnects or shutdown) no longer reports stream errors; the listeners take over.
+                if (this.consumeLoop === loop) {
+                    this.consumeLoop = null;
+                }
             });
+            this.consumeLoop = loop;
         }
         this.logger.info('[start] Consumer started | Topics: %j', opts.topics);
     }
@@ -206,6 +219,19 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
             }
         }
     }
+    /** Silent only while the consume loop is alive AND the erroring stream is the one it drains - the iterator then reports the same error once. A dead or replaced stream, or pull mode, reports here. */
+    reportStreamError(opts) {
+        if (this.consumeLoop && this.stream === opts.stream) {
+            return;
+        }
+        (0, common_1.invokeHook)({
+            logger: this.logger,
+            scope: opts.scope,
+            execution: () => this.onStreamError
+                ? this.onStreamError({ error: opts.error })
+                : this.onMessageError?.({ error: opts.error }),
+        });
+    }
     async *drainStream(opts) {
         this.logger.debug('[drainStream] Consuming | Topics: %j', this.consumeStartOptions?.topics);
         try {
@@ -218,7 +244,9 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
             (0, common_1.invokeHook)({
                 logger: this.logger,
                 scope: 'drainStream',
-                execution: () => opts.errorHandler?.({ error: normalizedError }),
+                execution: () => this.onStreamError
+                    ? this.onStreamError({ error: normalizedError })
+                    : opts.errorHandler?.({ error: normalizedError }),
             });
         }
         this.destroyDeadStream();
@@ -245,7 +273,9 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
                 (0, common_1.invokeHook)({
                     logger: this.logger,
                     scope: 'attemptReconnect',
-                    execution: () => errorHandler?.({ error: normalizedError }),
+                    execution: () => this.onReconnectError
+                        ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })
+                        : errorHandler?.({ error: normalizedError }),
                 });
                 return;
             }
@@ -256,15 +286,16 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
                 mode: this.consumeStartOptions.mode ?? constants_1.KafkaDefaults.CONSUME_MODE,
                 fallbackMode: this.consumeStartOptions.fallbackMode ?? constants_1.KafkaDefaults.CONSUME_FALLBACK_MODE,
             });
-            if (this.onMessageError) {
-                this.stream.on(constants_1.KafkaClientEvents.STREAM_ERROR, (normalizedError) => {
-                    (0, common_1.invokeHook)({
-                        logger: this.logger,
-                        scope: 'attemptReconnect',
-                        execution: () => this.onMessageError?.({ error: normalizedError }),
-                    });
+            // Always attached, hook or not, like the listener in start(): a stream 'error' with ZERO listeners is rethrown by EventEmitter and takes the process down.
+            const reconnectedStream = this.stream;
+            reconnectedStream.on(constants_1.KafkaClientEvents.STREAM_ERROR, (streamError) => {
+                this.logger.for('attemptReconnect').error('Kafka stream ERROR | Error: %s', streamError);
+                this.reportStreamError({
+                    error: streamError,
+                    scope: 'attemptReconnect',
+                    stream: reconnectedStream,
                 });
-            }
+            });
             this.sessionLikelyStale = false;
             this.logger.info('[attemptReconnect] Reconnected successfully | Topics: %j | Attempt: %d | Rebuilt: %s', this.consumeStartOptions.topics, attempt, shouldRebuildClient);
         }
@@ -274,7 +305,9 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
             (0, common_1.invokeHook)({
                 logger: this.logger,
                 scope: 'attemptReconnect',
-                execution: () => errorHandler?.({ error: normalizedError }),
+                execution: () => this.onReconnectError
+                    ? this.onReconnectError({ error: normalizedError, attempt, maxAttempts })
+                    : errorHandler?.({ error: normalizedError }),
             });
         }
     }
@@ -282,7 +315,7 @@ class KafkaConsumerHelper extends base_1.BaseKafkaHelper {
         this.logger.warn('[rebuildClient] All brokers were disconnected; rebuilding @platformatic/kafka ' +
             'Consumer to force a clean group rejoin (cached session state is stale)');
         const oldClient = this.client;
-        const newClient = KafkaConsumerHelper.buildConsumerClient(this.initialOptions);
+        const newClient = this.buildClient({ options: this.initialOptions });
         this.swapClient(newClient);
         if (this.lagMonitoringOptions) {
             const opts = this.lagMonitoringOptions;