@eventferry/kafka 3.2.1 → 3.3.1

package/CHANGELOG.md

@@ -0,0 +1,426 @@
+# @eventferry/kafka
+
+## 3.3.1
+
+### Patch Changes
+
+- 3c33f71: **chore: ship `CHANGELOG.md` inside the npm tarball**
+
+  Previously, each package's `files` allowlist contained only `"dist"` (and `"sql"` for `@eventferry/postgres`), so the auto-generated `CHANGELOG.md` was never published. Users browsing the package on npmjs.com or unpacking the tarball couldn't see release notes — they had to navigate to the GitHub repo.
+
+  This release adds `"CHANGELOG.md"` to the `files` array of every publishable package. Starting with this version, the per-version release notes are accessible:
+
+  - Directly in `node_modules/@eventferry/<pkg>/CHANGELOG.md` after `npm install`
+  - In the file listing on npmjs.com (under the "Code" / "Files" tab, depending on the npm UI)
+  - Inside the tarball downloaded from `https://registry.npmjs.org/...`
+
+  No code or API surface changes.
+
+- Updated dependencies [3c33f71]
+  - @eventferry/core@3.3.1
+
+## 3.3.0
+
+### Minor Changes
+
+- cdc20cf: **feat: DLQ enrichment + backpressure runtime + quota multiplier — Tier 1 of the reliability gap closed**
+
+  ### DLQ enrichment
+
+  Records routed to the dead-letter queue now carry the full context an operator needs to triage:
+
+  | Header                      | Set by    | Note                                                                                             |
+  | --------------------------- | --------- | ------------------------------------------------------------------------------------------------ |
+  | `original-topic`            | relay     | already existed                                                                                  |
+  | `dlq-reason`                | publisher | already existed (`error.message`)                                                                |
+  | `dlq-failed-at`             | publisher | already existed (ISO timestamp)                                                                  |
+  | `dlq-error-class`           | publisher | **new** — `error.name` / constructor name                                                        |
+  | `dlq-attempts`              | relay     | **new** — string-encoded `attempts` count                                                        |
+  | `dlq-original-aggregate-id` | relay     | **new** — for joining with business state                                                        |
+  | `dlq-original-message-id`   | relay     | **new** — for dedup / idempotency lookups                                                        |
+  | `dlq-error-stack`           | relay     | **new** — opt-in via `DlqConfig.includeStackTraces`, truncated to `maxStackBytes` (default 4 KB) |
+
+  ```ts
+  new Relay({
+    store,
+    publisher,
+    dlq: { topic: "orders.dlq", includeStackTraces: true, maxStackBytes: 4096 },
+  });
+  ```
+
+  ### Backpressure runtime behavior
+
+  When the driver classifies a failure as `errorKind: "backpressure"` (client-side producer queue full), the relay no longer treats it like a regular retriable failure. Instead:
+
+  - The record is re-queued via the new `OutboxStore.requeue(id, retryAt)` method,
+  - `attempts` is **not incremented** — the buffer being full is a "slow down" signal, not the record's fault,
+  - The retry is scheduled `RetryConfig.backpressureDelayMs` ms ahead (default 1000 ms).
+
+  Stores that don't implement `requeue` fall back to `markFailed` (with attempts++); both `@eventferry/postgres` and `@eventferry/mysql` ship a real implementation.
+
+  ### Quota multiplier
+
+  When the driver classifies a failure as `errorKind: "quota"` (broker `THROTTLING_QUOTA_EXCEEDED`), the scheduled retry delay is multiplied by `RetryConfig.quotaMultiplier` (default 5) so the producer gives the broker breathing room. Quota failures DO count as attempts — after the budget is exhausted the record routes to DLQ + `dead`.
+
+  ### New / changed types
+
+  - `RetryConfig` gains `backpressureDelayMs?` and `quotaMultiplier?`.
+  - `DlqConfig` gains `includeStackTraces?` and `maxStackBytes?`.
+  - `OutboxStore.requeue?(recordId, retryAt)` is a new **optional** method. Stores without it fall through to `markFailed`.
+
+  ### Backward compatibility
+
+  Pure-additive everywhere. Default behavior matches the prior release:
+
+  - A `RetryConfig` without `backpressureDelayMs` uses 1000 ms (sensible default).
+  - A `DlqConfig` without `includeStackTraces` keeps DLQ messages small (default off).
+  - An `OutboxStore` without `requeue` falls back to `markFailed` — same as before, just with a documented quirk.
+
+  This closes the last three Tier 1 items in `docs/kafka-gap-analysis/reliability.md`. Phase A reliability surface is now ~100% complete.
+
+### Patch Changes
+
+- Updated dependencies [cdc20cf]
+  - @eventferry/core@3.3.0
+
+## 3.2.1
+
+### Patch Changes
+
+- 9beb3e2: **chore: migrate to independent versioning (Astro pattern)**
+
+  Fixes the major-version inflation that produced four consecutive surprise majors (`1.0.4 → 2.0.0`, `2.0.0 → 3.0.0`, `3.0.0 → 4.0.0 corrected to 3.1.0`, `3.1.0 → 4.0.0 corrected to 3.2.0`) from changesets whose frontmatter only asked for `minor`.
+
+  **Root cause** (cited in [changesets/changesets#1759](https://github.com/changesets/changesets/issues/1759) and [docs/decisions.md](https://github.com/changesets/changesets/blob/main/docs/decisions.md)): the adapters listed `@eventferry/core` as a `peerDependency` with `workspace:*`. Changesets' documented rule is that an internal bump of a peer forces a major bump on the dependent — and the `fixed: [["@eventferry/*"]]` group reconciler then propagated that major across every package in the group.
+
+  **Fix** (exactly the [Astro config](https://github.com/withastro/astro/blob/main/.changeset/config.json)):
+
+  1. `.changeset/config.json` — drop `fixed`, set `linked: []`, enable
+     `___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH.onlyUpdatePeerDependentsWhenOutOfRange: true`.
+  2. Move `@eventferry/core` from `peerDependencies` to `dependencies` in
+     `@eventferry/postgres`, `@eventferry/mysql`, `@eventferry/kafka`, and
+     `@eventferry/schema-registry`. External user-facing peers (`pg`,
+     `mysql2`, `kafkajs`, `@confluentinc/kafka-javascript`,
+     `@kafkajs/confluent-schema-registry`) stay unchanged.
+
+  **Effect on releases.** Packages now evolve at independent semver tempos: a `core: minor` changeset produces `core@3.3.0` alongside `postgres@3.2.1` (patch, from "Updated dependencies"). No more major surprises. No more manual force-push corrections.
+
+  **Effect on consumers.** Pure-additive at the install boundary: `npm i @eventferry/kafka` now resolves `@eventferry/core` automatically (it's a regular dep). Previously consumers had to install it themselves as a peer; the typical flow already did this. No source-code changes required.
+
+- Updated dependencies [9beb3e2]
+  - @eventferry/core@3.2.1
+
+## 3.2.0
+
+### Minor Changes
+
+- 0208275: **feat: OpenTelemetry publish span + hook surface + logger passthrough**
+
+  ### OpenTelemetry tracing
+
+  `KafkaPublisher` now accepts an optional `tracer` that follows the current stable [OpenTelemetry messaging semantic conventions](https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md). One span per `publish()` call, named `"{topic} publish"`, with `messaging.system=kafka`, `messaging.operation.type=publish`, `messaging.destination.name=<topic>`, and `messaging.batch.message_count=<n>`. No dependency on `@opentelemetry/api` — wire through a 10-line adapter:
+
+  ```ts
+  import { trace, SpanKind, SpanStatusCode } from "@opentelemetry/api";
+  import type { KafkaTracer } from "@eventferry/kafka";
+
+  const otel = trace.getTracer("@eventferry/kafka");
+  const tracer: KafkaTracer = {
+    startPublishSpan(name, attributes) {
+      const span = otel.startSpan(name, {
+        kind: SpanKind.PRODUCER,
+        attributes,
+      });
+      return {
+        /* setAttribute, setStatus, recordException, end */
+      };
+    },
+  };
+
+  new KafkaPublisher({ brokers, tracer });
+  ```
+
+  ### Hook surface
+
+  `KafkaPublisher` now accepts `hooks` for observability and metrics integration:
+
+  ```ts
+  new KafkaPublisher({
+    brokers,
+    hooks: {
+      onConnect,
+      onDisconnect,
+      onPublish,
+      onError,
+      onTransactionAbort,
+    },
+  });
+  ```
+
+  Hooks are **safe by construction**: a throwing hook never breaks publishing — the publisher catches and logs via the configured `logger`.
+
+  ### Logger passthrough
+
+  A new optional `logger?: Logger` field on `KafkaPublisherOptions` (same `Logger` interface as `@eventferry/core`). Routes the publisher's own diagnostics (driver warnings about unsupported tuning, hook failures) through your logging stack instead of `console.warn`. When omitted, behavior matches today (drivers still fall back to `console.warn`).
+
+  ### Backward compatibility
+
+  100% additive. Existing call sites (no hooks, no tracer, no logger) work unchanged — the tracer defaults to a `NoopKafkaTracer`, the hook map defaults to `{}`, and the logger stays undefined.
+
+- ae64a98: **feat: callable `transactionalId` + abort-aware tx hook**
+
+  ### Callable `transactionalId`
+
+  `transactionalId` accepts a sync or async resolver in addition to a plain string:
+
+  ```ts
+  new KafkaPublisher({
+    brokers,
+    transactional: true,
+    transactionalId: () =>
+      `${process.env.POD_NAME}-${process.env.REPLICA_INDEX}`,
+  });
+  ```
+
+  Useful when the id depends on runtime context that isn't known at construction time (pod name, AZ + replica index, k8s ordinal). For multi-instance EOS, the resolved id MUST be stable across a single instance's restarts but UNIQUE across instances. The plain-string form remains supported and unchanged.
+
+  ### Abort-aware `onTransactionAbort` hook
+
+  When a transactional `sendBatch` triggers the abort path, the publisher fires `hooks.onTransactionAbort(err)` so dashboards and metrics catch EOS failure rates:
+
+  ```ts
+  new KafkaPublisher({
+    brokers,
+    transactional: true,
+    transactionalId: "orders-tx",
+    hooks: {
+      onTransactionAbort: (err) => metrics.txAborts.inc({ reason: err.name }),
+    },
+  });
+  ```
+
+  Best-effort: the hook is safe-wrapped (a throwing hook never breaks the abort path); both `kafkajs` and `@confluentinc/kafka-javascript` drivers fire it from their transaction catch blocks.
+
+  ### Backward compatibility
+
+  100% additive. Existing call sites — string `transactionalId`, no hooks — work unchanged.
+
+### Patch Changes
+
+- @eventferry/core@3.2.0
+
+## 3.1.0
+
+### Minor Changes
+
+- da39b08: **feat: producer tuning passthrough + per-message partition override + kafkajs partitioner choice**
+
+  ### Producer tuning
+
+  `KafkaPublisher` now accepts the full set of producer tuning knobs every serious Kafka deployment eventually needs:
+
+  ```ts
+  new KafkaPublisher({
+    driver: "confluent",
+    brokers,
+    lingerMs: 25, // ⚠ confluent only
+    batchSize: 131_072, // ⚠ confluent only
+    maxInFlightRequests: 5,
+    requestTimeoutMs: 30_000,
+    deliveryTimeoutMs: 120_000, // ⚠ confluent only
+    maxRequestSize: 2_000_000, // ⚠ confluent only
+    transactionTimeoutMs: 90_000,
+  });
+  ```
+
+  **Driver asymmetry:** `kafkajs` has no producer-level config for `lingerMs`, `batchSize`, `deliveryTimeoutMs`, or `maxRequestSize` — its batching is sticky-partitioner + hardcoded internals. The typed API stays uniform; on the kafkajs driver, those four knobs log a **one-time** warning (deduped process-wide) and are otherwise ignored. For fine-grained tuning, switch to the confluent driver.
+
+  ### Per-message partition override
+
+  `PublishableMessage` gains an optional `partition?: number` field. When set, the publisher routes that record to the exact partition, bypassing the configured partitioner. Use cases: compacted topics with application-managed sharding, tenant-affinity routing, geo-pinning. Both drivers honor it.
+
+  ### kafkajs partitioner choice
+
+  Silences the noisy `KafkaJSPartitionerNotSpecified` warning kafkajs v2 emits on every producer instance, by letting you pick a partitioner explicitly:
+
+  ```ts
+  new KafkaPublisher({
+    driver: "kafkajs",
+    brokers,
+    partitioner: "java-compatible", // (default) | "legacy" | "default"
+  });
+  ```
+
+  - `"java-compatible"` is the new greenfield default (matches the Java client's murmur2).
+  - `"legacy"` preserves pre-v2 hash continuity for existing topics.
+  - `"default"` follows kafkajs's current default.
+
+  ### Backward compatibility
+
+  Pure-additive. Existing call sites continue to work unchanged; the partitioner-choice default (`"java-compatible"`) is what kafkajs v2's migration guide recommends for new producers.
+
+- bbb1792: **feat: mTLS + SASL/OAUTHBEARER support**
+
+  Two new authentication paths for managed and enterprise Kafka clusters.
+
+  ### mTLS (mutual TLS)
+
+  The `ssl` option now accepts a full `TlsConfig` in addition to the boolean shorthand:
+
+  ```ts
+  new KafkaPublisher({
+    brokers: ["broker:9093"],
+    ssl: {
+      ca: readFileSync("/etc/ssl/kafka-ca.pem"),
+      cert: readFileSync("/etc/ssl/client.pem"),
+      key: readFileSync("/etc/ssl/client-key.pem"),
+      passphrase: "optional",
+      servername: "broker.example.com", // SNI override
+    },
+  });
+  ```
+
+  Buffer and PEM-string inputs are both supported. `ssl: true` continues to work unchanged (one-way TLS using the driver's default trust store).
+
+  > `rejectUnauthorized` is intentionally NOT exposed. TLS verification is non-negotiable; pass the cluster CA via `ca` for dev clusters with self-signed certs.
+
+  ### SASL/OAUTHBEARER
+
+  Required for Azure Event Hubs, Confluent Cloud with OAuth/SSO, and any OIDC-fronted cluster. Bring your own token provider:
+
+  ```ts
+  new KafkaPublisher({
+    brokers: ["broker:9093"],
+    ssl: true,
+    sasl: {
+      mechanism: "oauthbearer",
+      oauthBearerProvider: async () => ({
+        value: bearerToken,
+        principal: "user@realm", // required on confluent
+        lifetime: 3600_000, // ms — required on confluent
+        extensions: { scope: "read,write" },
+      }),
+    },
+  });
+  ```
+
+  **Driver asymmetry to know about:** `kafkajs` reads only `value`; `@confluentinc/kafka-javascript` requires `value` + `principal` + `lifetime` (ms) and accepts an optional `extensions` map. Cross-driver portable providers should populate all four.
+
+  ### Confluent driver internals
+
+  `@confluentinc/kafka-javascript` integrates via a small translator: simple `ssl: true` and SASL configs go through the kafkajs-compat layer, but a custom `TlsConfig` is mapped to the librdkafka PEM keys (`ssl.ca.pem`, `ssl.certificate.pem`, `ssl.key.pem`, `ssl.key.password`) and `security.protocol` is auto-derived (`ssl` / `sasl_plaintext` / `sasl_ssl`). Buffer inputs are coerced to UTF-8 strings (librdkafka does not accept Buffers).
+
+  ### Backward compatibility
+
+  Pure-additive. Existing configs (`ssl: true | false | undefined`, password SASL) work unchanged.
+
+### Patch Changes
+
+- Updated dependencies [da39b08]
+  - @eventferry/core@3.1.0
+
+## 3.0.0
+
+### Minor Changes
+
+- f0c7483: **feat: error classification for smarter retry, DLQ, and pause behavior**
+
+  Publisher implementations can now tag each failed `PublishResult` with an `errorKind` so the relay knows whether the error is worth retrying.
+
+  **New in `@eventferry/core`:**
+
+  - `PublishErrorKind = "retriable" | "fatal" | "poison" | "backpressure" | "quota"` — opt-in classification surface on `PublishResult.errorKind`.
+  - The `Relay` now reads `errorKind`:
+    - `"fatal"` (auth denied, fenced epoch, transactional id rejected) and `"poison"` (oversized record, corrupt payload, schema rejected) **short-circuit retries** straight to the DLQ + `dead` status. No more burning the retry budget on errors that cannot succeed.
+    - `"retriable"`, `"backpressure"`, `"quota"`, and absent (`undefined`) continue to use the existing backoff schedule, preserving backward compatibility. Smarter `backpressure` / `quota` handling (pause polling, longer backoff) is planned for a follow-up release.
+
+  **New in `@eventferry/kafka`:**
+
+  - `classifyKafkajsError(err): PublishErrorKind` — maps the most-common `KafkaJSProtocolError` types/codes and the `KafkaJSConnectionError` / `KafkaJSRequestTimeoutError` / `KafkaJSNonRetriableError` subclasses to a category. Verified against `kafkajs/src/errors.js`.
+  - `classifyConfluentError(err): PublishErrorKind` — maps the librdkafka `RD_KAFKA_RESP_ERR_*` codes (both negative internal codes and Kafka wire-protocol codes) to a category. Verified against `librdkafka/src/rdkafka.h`. Includes the dedicated `"backpressure"` mapping for `ERR__QUEUE_FULL` (-184) and `"quota"` for `ERR_THROTTLING_QUOTA_EXCEEDED` (89).
+  - Both drivers (`KafkaJsDriver`, `ConfluentDriver`) now call their respective classifier in the catch path and emit the `errorKind` on every failed `PublishResult`.
+
+  **Backward compatibility:** `errorKind` is optional everywhere. Existing publisher implementations that don't set it continue to work unchanged — the relay treats absent `errorKind` as `"retriable"`, which is what the relay did before this change.
+
+  **Migration:** none required.
+
+### Patch Changes
+
+- Updated dependencies [f0c7483]
+  - @eventferry/core@3.0.0
+
+## 2.0.0
+
+### Patch Changes
+
+- @eventferry/core@2.0.0
+
+## 1.0.4
+
+### Patch Changes
+
+- Updated dependencies [64d115d]
+  - @eventferry/core@1.0.4
+
+## 1.0.3
+
+### Patch Changes
+
+- Updated dependencies [aaca9a2]
+  - @eventferry/core@1.0.3
+
+## 1.0.2
+
+### Patch Changes
+
+- 89f1867: Declare `engines.node` (>=18) so npm shows the supported Node version and tooling can warn on unsupported runtimes.
+- Updated dependencies [89f1867]
+  - @eventferry/core@1.0.2
+
+## 1.0.1
+
+### Patch Changes
+
+- docs: polish per-package READMEs (npm page content). No code changes.
+- Updated dependencies
+  - @eventferry/core@1.0.1
+
+## 1.0.0
+
+### Minor Changes
+
+- b06f8ec: Strict per-aggregate ordering, crash recovery, and driver/packaging fixes.
+
+  - **postgres:** the claim query now enforces strict per-aggregate ordering by
+    only taking the _head_ of each aggregate (no earlier unfinished row for the
+    same `aggregateId`). At most one in-flight message per aggregate; failed
+    messages block their successors until resolved.
+  - **postgres:** added a `claimed_at` column and a visibility-timeout reaper
+    (`claimTimeoutMs`, default 60s) so rows orphaned by a crashed relay are
+    reclaimed instead of stuck in `processing` forever. Migration is upgrade-safe
+    (`ADD COLUMN IF NOT EXISTS`); the partial indexes were retuned for the new
+    ordered, reaper-aware claim.
+  - **core:** dead-lettered messages now carry the real `original-topic` header
+    (previously always empty); `ConsoleLogger` routes warn/error to the matching
+    `console` methods.
+  - **kafka:** the confluent driver now honors `acks` and `compression` (it
+    silently ignored them before), matching the kafkajs driver.
+  - **packaging:** the `@eventferry/postgres/migrations` subpath export now
+    advertises its types; `pnpm-workspace.yaml` dropped an invalid placeholder
+    block.
+
+  Note: `claimTimeoutMs` should exceed your worst-case publish latency. This is
+  an at-least-once system — pair it with idempotent producers/consumers.
+
+### Patch Changes
+
+- b06f8ec: Fix the kafkajs driver using `producer.send` with a multi-topic `topicMessages`
+  payload, which kafkajs rejects with "Invalid topic" — the `topicMessages` form is
+  `producer.sendBatch`. Batches now publish correctly (caught by the new integration
+  suite against real Redpanda; unit tests used a fake producer that didn't validate).
+- Updated dependencies [b06f8ec]
+- Updated dependencies [b06f8ec]
+- Updated dependencies [b06f8ec]
+- Updated dependencies [b06f8ec]
+- Updated dependencies [b06f8ec]
+  - @eventferry/core@1.0.0

package/dist/index.cjs

@@ -707,6 +707,9 @@ var KafkaPublisher = class {
       headers: {
         ...message.headers,
         "dlq-reason": error.message,
+        // Error class name (e.g. "KafkaJSProtocolError", "RecordTooLargeException"),
+        // useful for downstream alert routing without parsing the reason string.
+        "dlq-error-class": error.name || error.constructor?.name || "Error",
         "dlq-original-topic": message.headers["original-topic"] ?? "",
         "dlq-failed-at": (/* @__PURE__ */ new Date()).toISOString()
       }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/kafkajs-classifier.ts","../src/transactional-id.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-config.ts","../src/confluent-driver.ts","../src/hooks.ts","../src/tracing.ts","../src/publisher.ts"],"sourcesContent":["export * from \"./driver.js\";\nexport * from \"./kafkajs-driver.js\";\nexport * from \"./kafkajs-classifier.js\";\nexport * from \"./confluent-driver.js\";\nexport * from \"./confluent-classifier.js\";\nexport * from \"./confluent-config.js\";\nexport * from \"./hooks.js\";\nexport * from \"./tracing.js\";\nexport * from \"./publisher.js\";\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","/**\n * Resolve a {@link KafkaConnectionConfig}-style `transactionalId` into the\n * concrete string the underlying driver expects.\n *\n * Accepts:\n *   - `string`           — used verbatim.\n *   - `() => string`     — invoked once at connect time.\n *   - `() => Promise<string>` — awaited at connect time.\n *\n * Throws when the input is undefined (caller should pre-validate) or when\n * the callable yields an empty string.\n */\nexport async function resolveTransactionalId(\n  input: string | (() => string | Promise<string>) | undefined,\n): Promise<string> {\n  if (input === undefined) {\n    throw new Error(\"transactionalId is required when transactional=true\");\n  }\n  const raw = typeof input === \"function\" ? await input() : input;\n  if (typeof raw !== \"string\" || raw.length === 0) {\n    throw new Error(\n      \"transactionalId resolver must return a non-empty string\",\n    );\n  }\n  return raw;\n}\n","import type {\n  Logger,\n  PublishableMessage,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  KafkaJsPartitionerChoice,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n// kafkajs's `Partitioners` namespace: three factory functions; we pluck them\n// at runtime rather than depending on the kafkajs types.\ninterface KjsPartitionersNamespace {\n  DefaultPartitioner: () => unknown;\n  LegacyPartitioner: () => unknown;\n  JavaCompatiblePartitioner: () => unknown;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /**\n   * Optional logger for the driver's own diagnostics (e.g. warnings about\n   * unsupported tuning options). When absent the driver falls back to\n   * `console.warn` so existing users see the same output.\n   */\n  logger?: Logger;\n}\n\n/**\n * kafkajs producer-level knobs we expose on the typed API that kafkajs does\n * NOT actually support. On this driver these are warn-and-ignore; users\n * who need them should switch to the confluent driver.\n */\nconst UNSUPPORTED_BY_KAFKAJS = [\n  \"lingerMs\",\n  \"batchSize\",\n  \"deliveryTimeoutMs\",\n  \"maxRequestSize\",\n] as const;\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n    warnUnsupportedKafkajsOptions(opts);\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM\n      // string both supported. Our TlsConfig is a structural subset of that\n      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via\n      // `ca`). No translation needed.\n      ssl: this.opts.ssl,\n      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's\n      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from\n      // the provider's returned token (other fields are ignored).\n      sasl: this.opts.sasl,\n    });\n    const createPartitioner = resolveCreatePartitioner(\n      mod.Partitioners,\n      this.opts.partitioner,\n      this.transactional,\n    );\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      // Idempotent / transactional producers cap maxInFlight at 5. When the\n      // user picks transactional we force 1 to keep strict ordering across\n      // retries on classic (non-idempotent) clusters that haven't migrated\n      // to the broker-side fence.\n      maxInFlightRequests: this.transactional\n        ? 1\n        : this.opts.maxInFlightRequests,\n      transactionalId: resolvedTxId,\n      // kafkajs accepts these directly when set; undefined falls through to\n      // the kafkajs default.\n      requestTimeout: this.opts.requestTimeoutMs,\n      transactionTimeout: this.opts.transactionTimeoutMs,\n      // Setting any partitioner choice silences kafkajs's\n      // KafkaJSPartitionerNotSpecified warning.\n      createPartitioner,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        // Notify the abort hook BEFORE returning failedResults. The hook is\n        // best-effort: try/catch around it so a misbehaving hook can't make\n        // the abort path itself throw.\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — already documented as best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. When set, kafkajs routes the record\n      // to this exact partition; when undefined, the configured partitioner\n      // chooses. We keep the key here too because compacted topics need it\n      // even when partition is pinned.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\n/**\n * Resolve the `createPartitioner` factory kafkajs expects on\n * `producer({...})`. Returns `undefined` to fall through to the kafkajs\n * default when no choice is made AND the producer is non-transactional\n * (transactional producers don't trigger the no-partitioner warning).\n */\nfunction resolveCreatePartitioner(\n  partitioners: KjsPartitionersNamespace | undefined,\n  choice: KafkaJsPartitionerChoice | undefined,\n  transactional: boolean,\n): (() => unknown) | undefined {\n  if (!partitioners) return undefined;\n  // Default to the java-compatible partitioner when the caller didn't pick.\n  // It matches the Java client (murmur2) and silences the noisy warning;\n  // for transactional producers we leave the kafkajs default alone since\n  // EOS ordering is partitioner-agnostic and the warning doesn't fire there.\n  const effective: KafkaJsPartitionerChoice =\n    choice ?? (transactional ? \"default\" : \"java-compatible\");\n  switch (effective) {\n    case \"java-compatible\":\n      return partitioners.JavaCompatiblePartitioner;\n    case \"legacy\":\n      return partitioners.LegacyPartitioner;\n    case \"default\":\n      return partitioners.DefaultPartitioner;\n  }\n}\n\n/** Process-wide dedup so we never warn for the same option twice. */\nconst warnedKafkajsKeys = new Set<string>();\n\nfunction warnUnsupportedKafkajsOptions(opts: KafkaJsDriverOptions): void {\n  for (const key of UNSUPPORTED_BY_KAFKAJS) {\n    if (opts[key] === undefined) continue;\n    if (warnedKafkajsKeys.has(key)) continue;\n    warnedKafkajsKeys.add(key);\n    const message =\n      `'${key}' is not configurable on the kafkajs driver and was ignored. ` +\n      `Switch to the confluent driver (driver: \"confluent\") for fine-grained tuning, ` +\n      `or remove the option to silence this warning.`;\n    // Route through the configured logger when present; otherwise fall back\n    // to console.warn so users who never plumbed a logger still see the\n    // diagnostic (matches the prior behavior).\n    if (opts.logger) {\n      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });\n    } else {\n      console.warn(`[@eventferry/kafka] ${message}`);\n    }\n  }\n}\n\n/** Internal — used by tests. Resets the dedup so warnings can be observed in isolation. */\nexport function _resetKafkajsWarnDedup(): void {\n  warnedKafkajsKeys.clear();\n}\n\nasync function importKafkaJs(): Promise<{\n  Kafka: new (cfg: unknown) => KjsKafka;\n  Partitioners: KjsPartitionersNamespace;\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type {\n  KafkaConnectionConfig,\n  ProducerBehaviorConfig,\n  TlsConfig,\n} from \"./driver.js\";\n\n/**\n * Translate eventferry's normalized `KafkaConnectionConfig` into the shape\n * expected by `@confluentinc/kafka-javascript`'s `KafkaJS.Kafka` constructor.\n *\n * Returns an object with two parts:\n *   - `kafkaJS`: the kafkajs-compatible config layer (clientId, brokers, and\n *     simple ssl/sasl when no advanced TLS is needed).\n *   - top-level keys: librdkafka-style config (e.g. `ssl.ca.pem`,\n *     `security.protocol`) used when the user supplies a {@link TlsConfig}.\n *\n * Why a separate translator: the kafkajs-compat layer accepts the simple\n * `ssl: true` boolean but the verified path for mTLS (CA + cert + key) is\n * librdkafka's `ssl.*.pem` keys. The translator picks the right surface\n * based on what the caller supplied. Buffer inputs are coerced to strings —\n * librdkafka accepts PEM strings, NOT Buffers.\n */\nexport interface ConfluentClientConfig {\n  kafkaJS: Record<string, unknown>;\n  // librdkafka top-level keys; kept as a Record so we can spread them.\n  librdkafka: Record<string, unknown>;\n}\n\nexport function buildConfluentClientConfig(\n  opts: KafkaConnectionConfig & ProducerBehaviorConfig,\n): ConfluentClientConfig {\n  const kafkaJS: Record<string, unknown> = {\n    clientId: opts.clientId ?? \"eventferry\",\n    brokers: opts.brokers,\n  };\n  const librdkafka: Record<string, unknown> = {};\n\n  // ── Producer tuning passthrough (librdkafka config keys) ─────────────\n  if (opts.lingerMs !== undefined) librdkafka[\"linger.ms\"] = opts.lingerMs;\n  if (opts.batchSize !== undefined) librdkafka[\"batch.size\"] = opts.batchSize;\n  if (opts.maxInFlightRequests !== undefined) {\n    librdkafka[\"max.in.flight.requests.per.connection\"] =\n      opts.maxInFlightRequests;\n  }\n  if (opts.requestTimeoutMs !== undefined) {\n    librdkafka[\"request.timeout.ms\"] = opts.requestTimeoutMs;\n  }\n  if (opts.deliveryTimeoutMs !== undefined) {\n    librdkafka[\"delivery.timeout.ms\"] = opts.deliveryTimeoutMs;\n  }\n  if (opts.maxRequestSize !== undefined) {\n    librdkafka[\"message.max.bytes\"] = opts.maxRequestSize;\n  }\n  if (opts.transactionTimeoutMs !== undefined) {\n    librdkafka[\"transaction.timeout.ms\"] = opts.transactionTimeoutMs;\n  }\n\n  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);\n  const saslRequested = !!opts.sasl;\n\n  if (saslRequested && tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_ssl\";\n  } else if (tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"ssl\";\n  } else if (saslRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_plaintext\";\n  } // else: leave as default (plaintext)\n\n  if (isTlsConfig(opts.ssl)) {\n    // Custom TLS — explicit librdkafka PEM keys. Buffers are coerced to\n    // strings (librdkafka does not accept Buffer).\n    const tls = opts.ssl;\n    if (tls.ca !== undefined) {\n      librdkafka[\"ssl.ca.pem\"] = stringifyPem(tls.ca);\n    }\n    if (tls.cert !== undefined) {\n      librdkafka[\"ssl.certificate.pem\"] = stringifyPem(tls.cert);\n    }\n    if (tls.key !== undefined) {\n      librdkafka[\"ssl.key.pem\"] = stringifyPem(tls.key);\n    }\n    if (tls.passphrase !== undefined) {\n      librdkafka[\"ssl.key.password\"] = tls.passphrase;\n    }\n    // servername (SNI) — librdkafka derives SNI from `ssl.endpoint.identification.algorithm`;\n    // explicit SNI override is not documented in the v1.x kafkaJS-compat surface, so we\n    // honor it as a no-op for now and document the limitation in the gap analysis.\n  } else if (opts.ssl === true) {\n    // Simple TLS — kafkajs-compat boolean is sufficient.\n    kafkaJS[\"ssl\"] = true;\n  }\n\n  if (opts.sasl) {\n    // SASL — kafkajs-compat shape works for both password mechanisms and\n    // OAUTHBEARER (the confluent client implements the provider callback).\n    kafkaJS[\"sasl\"] = opts.sasl;\n  }\n\n  return { kafkaJS, librdkafka };\n}\n\nfunction isTlsConfig(v: unknown): v is TlsConfig {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction stringifyPem(input: string | Buffer | Array<string | Buffer>): string {\n  if (Array.isArray(input)) {\n    return input.map((x) => (typeof x === \"string\" ? x : x.toString(\"utf8\"))).join(\"\\n\");\n  }\n  return typeof input === \"string\" ? input : input.toString(\"utf8\");\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\nimport { buildConfluentClientConfig } from \"./confluent-config.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS,\n      ...librdkafka,\n    });\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(resolvedTxId ? { transactionalId: resolvedTxId } : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — abort hook is best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. librdkafka honors an explicit\n      // partition value; undefined leaves the default partitioner in charge.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult, Logger } from \"@eventferry/core\";\n\n/**\n * Lifecycle hooks fired by `KafkaPublisher`. Every hook is optional. The\n * publisher wraps each invocation in a try/catch and logs (via the\n * configured logger) on failure — a misbehaving hook will NEVER break\n * publishing.\n *\n * Typical wiring:\n *   - Custom observability stacks (Datadog APM, New Relic) → `onPublish`,\n *     `onError`, `onTransactionAbort`.\n *   - Connection-aware readiness probes → `onConnect` / `onDisconnect`.\n *   - Audit logs of every published record → `onPublish`.\n */\nexport interface KafkaPublisherHooks {\n  /** Fires after the underlying client successfully connects. */\n  onConnect?(): void | Promise<void>;\n  /** Fires after the underlying client disconnects (clean shutdown). */\n  onDisconnect?(): void | Promise<void>;\n  /**\n   * Fires once per record after a publish attempt — both successes and\n   * failures. The `result.ok` flag distinguishes them.\n   */\n  onPublish?(\n    result: PublishResult,\n    message: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires for any error surfaced from the publish path — driver-thrown\n   * errors, transaction abort errors, etc. `message` is set when the error\n   * is per-record; absent for batch-level errors (e.g. connect failure).\n   */\n  onError?(\n    error: Error,\n    message?: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires when a transactional sendBatch's inner abort path is taken.\n   * Useful for observability dashboards that track EOS failure rates.\n   */\n  onTransactionAbort?(error: Error): void | Promise<void>;\n}\n\n/**\n * Invoke a hook safely. Never throws back into the caller — logs the hook's\n * failure via the configured logger (or no-op when logger is absent).\n */\nexport async function safeHook(\n  logger: Logger | undefined,\n  hookName: keyof KafkaPublisherHooks,\n  invoke: () => void | Promise<void> | undefined,\n): Promise<void> {\n  try {\n    const r = invoke();\n    if (r && typeof (r as Promise<void>).then === \"function\") {\n      await r;\n    }\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {\n      error: error.message,\n    });\n  }\n}\n","/**\n * Tracing surface for the publisher.\n *\n * eventferry deliberately does not depend on `@opentelemetry/api` — instead\n * users wire a thin adapter over their tracing system (OpenTelemetry,\n * Datadog, internal, …). This file defines the minimal contract; an\n * OpenTelemetry adapter is ~10 lines (see the README).\n *\n * The contract follows the **current stable** OpenTelemetry messaging\n * semantic conventions\n * ({@link https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md spec}):\n *\n *   - Span name: `\"{topic} publish\"`\n *   - `SpanKind.PRODUCER`\n *   - Required attributes: `messaging.system=kafka`,\n *     `messaging.operation.type=publish`, `messaging.destination.name=<topic>`\n *   - Recommended: `messaging.batch.message_count`, `messaging.kafka.partition`,\n *     `server.address`, `server.port`\n *   - One span per batch (NOT per message — per-message spans cause\n *     cardinality explosion and the spec actively warns against this)\n */\n\n/** Attribute values the spec allows. */\nexport type SpanAttributeValue = string | number | boolean;\n\n/**\n * Minimal span surface the publisher needs. Implementations wrap a\n * tracing-system-specific span; methods MUST never throw out of the\n * publisher's hot path (wrap your own SDK calls in try/catch).\n */\nexport interface SpanLike {\n  setAttribute(key: string, value: SpanAttributeValue): void;\n  setAttributes(attrs: Record<string, SpanAttributeValue>): void;\n  /** OK on success; ERROR on failure. The `message` is the error message. */\n  setStatus(status: { code: \"ok\" | \"error\"; message?: string }): void;\n  /** Attach an exception to the span (OpenTelemetry `recordException`). */\n  recordException(error: Error): void;\n  end(): void;\n}\n\n/**\n * Factory the publisher calls once per `sendBatch` to start a span.\n * Implementations MUST set `SpanKind.PRODUCER` and the messaging semconv\n * attributes on the returned span before returning it.\n */\nexport interface KafkaTracer {\n  /**\n   * Start a publish span.\n   * @param name        Recommended format: `\"{topic} publish\"`.\n   * @param attributes  Initial attributes (the publisher supplies the messaging\n   *                    semconv set: system, destination.name, operation.type,\n   *                    batch.message_count, plus optional kafka.partition and\n   *                    server.address/port).\n   */\n  startPublishSpan(\n    name: string,\n    attributes: Record<string, SpanAttributeValue>,\n  ): SpanLike;\n}\n\n/**\n * No-op tracer. Used when the user does not configure one. Cheap allocation\n * — never touches I/O.\n */\nexport class NoopKafkaTracer implements KafkaTracer {\n  startPublishSpan(): SpanLike {\n    return NOOP_SPAN;\n  }\n}\n\nconst NOOP_SPAN: SpanLike = {\n  setAttribute() {},\n  setAttributes() {},\n  setStatus() {},\n  recordException() {},\n  end() {},\n};\n","import type {\n  Logger,\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\nimport { safeHook } from \"./hooks.js\";\nimport type { KafkaPublisherHooks } from \"./hooks.js\";\nimport { NoopKafkaTracer } from \"./tracing.js\";\nimport type { KafkaTracer, SpanLike } from \"./tracing.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n  /**\n   * Optional structured logger. When set, the publisher routes its own\n   * diagnostics (driver warnings, hook failures) through it. When omitted,\n   * the publisher is silent — only the underlying drivers may still log.\n   */\n  logger?: Logger;\n  /**\n   * Optional lifecycle hooks. Every hook is invoked safely (try/catch +\n   * logged via `logger`) and a misbehaving hook will never break publishing.\n   */\n  hooks?: KafkaPublisherHooks;\n  /**\n   * Optional tracer. When set, `publish()` wraps each batch in a span that\n   * follows the current stable OpenTelemetry messaging semantic conventions.\n   * Use a thin adapter over your tracing SDK (see {@link KafkaTracer}).\n   */\n  tracer?: KafkaTracer;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and adds\n * dead-letter routing, observability hooks, and OpenTelemetry-shaped publish\n * spans. Works against Kafka and Redpanda identically (Redpanda is Kafka-API\n * compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n  private readonly logger: Logger | undefined;\n  private readonly hooks: KafkaPublisherHooks;\n  private readonly tracer: KafkaTracer;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.logger = opts.logger;\n    this.hooks = opts.hooks ?? {};\n    this.tracer = opts.tracer ?? new NoopKafkaTracer();\n    // Plumb the logger into driver construction so driver-side diagnostics\n    // (e.g. kafkajs unsupported-tuning warnings) route through it too.\n    // Plumb a safe-wrapped onTransactionAbort callback so the driver-level\n    // transaction abort path fans out to the user-supplied hook safely.\n    const onTransactionAbort = this.hooks.onTransactionAbort\n      ? (error: Error) => {\n          void safeHook(this.logger, \"onTransactionAbort\", () =>\n            this.hooks.onTransactionAbort?.(error),\n          );\n        }\n      : undefined;\n    this.driver =\n      opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });\n  }\n\n  async connect(): Promise<void> {\n    await this.driver.connect();\n    await safeHook(this.logger, \"onConnect\", () => this.hooks.onConnect?.());\n  }\n\n  async disconnect(): Promise<void> {\n    await this.driver.disconnect();\n    await safeHook(this.logger, \"onDisconnect\", () =>\n      this.hooks.onDisconnect?.(),\n    );\n  }\n\n  async publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (messages.length === 0) return [];\n\n    const span = this.startBatchSpan(messages);\n    let results: PublishResult[];\n    try {\n      results = await this.driver.sendBatch(messages);\n    } catch (err) {\n      // Driver-level throw — every record is a failure attributed to the\n      // batch-level error. Record on the span, fire hook, rethrow.\n      const error = err instanceof Error ? err : new Error(String(err));\n      span.setStatus({ code: \"error\", message: error.message });\n      span.recordException(error);\n      span.end();\n      await safeHook(this.logger, \"onError\", () => this.hooks.onError?.(error));\n      throw err;\n    }\n\n    // Per-record hooks. Walk by index so the original message is available.\n    const byId = new Map(messages.map((m) => [m.recordId, m]));\n    let allOk = true;\n    for (const r of results) {\n      const msg = byId.get(r.recordId);\n      if (!msg) continue;\n      await safeHook(this.logger, \"onPublish\", () =>\n        this.hooks.onPublish?.(r, msg),\n      );\n      if (!r.ok) {\n        allOk = false;\n        const err = r.error ?? new Error(\"publish failed\");\n        await safeHook(this.logger, \"onError\", () =>\n          this.hooks.onError?.(err, msg),\n        );\n      }\n    }\n\n    span.setStatus(allOk ? { code: \"ok\" } : { code: \"error\" });\n    span.end();\n    return results;\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n\n  /**\n   * Start a span for the batch following the OTel messaging conventions.\n   *\n   * Multi-topic batches: per the OTel spec, the span name uses the\n   * destination — we pick the FIRST topic in the batch and document the\n   * limitation. Callers that publish heterogeneous batches and care about\n   * per-topic spans should split their batches upstream.\n   */\n  private startBatchSpan(messages: PublishableMessage[]): SpanLike {\n    const topic = messages[0]?.topic ?? \"unknown\";\n    return this.tracer.startPublishSpan(`${topic} publish`, {\n      \"messaging.system\": \"kafka\",\n      \"messaging.operation.type\": \"publish\",\n      \"messaging.destination.name\": topic,\n      \"messaging.batch.message_count\": messages.length,\n    });\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["CODE_TO_KIND","groupByTopic","failedResults"]}
+{"version":3,"sources":["../src/index.ts","../src/kafkajs-classifier.ts","../src/transactional-id.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-config.ts","../src/confluent-driver.ts","../src/hooks.ts","../src/tracing.ts","../src/publisher.ts"],"sourcesContent":["export * from \"./driver.js\";\nexport * from \"./kafkajs-driver.js\";\nexport * from \"./kafkajs-classifier.js\";\nexport * from \"./confluent-driver.js\";\nexport * from \"./confluent-classifier.js\";\nexport * from \"./confluent-config.js\";\nexport * from \"./hooks.js\";\nexport * from \"./tracing.js\";\nexport * from \"./publisher.js\";\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","/**\n * Resolve a {@link KafkaConnectionConfig}-style `transactionalId` into the\n * concrete string the underlying driver expects.\n *\n * Accepts:\n *   - `string`           — used verbatim.\n *   - `() => string`     — invoked once at connect time.\n *   - `() => Promise<string>` — awaited at connect time.\n *\n * Throws when the input is undefined (caller should pre-validate) or when\n * the callable yields an empty string.\n */\nexport async function resolveTransactionalId(\n  input: string | (() => string | Promise<string>) | undefined,\n): Promise<string> {\n  if (input === undefined) {\n    throw new Error(\"transactionalId is required when transactional=true\");\n  }\n  const raw = typeof input === \"function\" ? await input() : input;\n  if (typeof raw !== \"string\" || raw.length === 0) {\n    throw new Error(\n      \"transactionalId resolver must return a non-empty string\",\n    );\n  }\n  return raw;\n}\n","import type {\n  Logger,\n  PublishableMessage,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  KafkaJsPartitionerChoice,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n// kafkajs's `Partitioners` namespace: three factory functions; we pluck them\n// at runtime rather than depending on the kafkajs types.\ninterface KjsPartitionersNamespace {\n  DefaultPartitioner: () => unknown;\n  LegacyPartitioner: () => unknown;\n  JavaCompatiblePartitioner: () => unknown;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /**\n   * Optional logger for the driver's own diagnostics (e.g. warnings about\n   * unsupported tuning options). When absent the driver falls back to\n   * `console.warn` so existing users see the same output.\n   */\n  logger?: Logger;\n}\n\n/**\n * kafkajs producer-level knobs we expose on the typed API that kafkajs does\n * NOT actually support. On this driver these are warn-and-ignore; users\n * who need them should switch to the confluent driver.\n */\nconst UNSUPPORTED_BY_KAFKAJS = [\n  \"lingerMs\",\n  \"batchSize\",\n  \"deliveryTimeoutMs\",\n  \"maxRequestSize\",\n] as const;\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n    warnUnsupportedKafkajsOptions(opts);\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM\n      // string both supported. Our TlsConfig is a structural subset of that\n      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via\n      // `ca`). No translation needed.\n      ssl: this.opts.ssl,\n      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's\n      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from\n      // the provider's returned token (other fields are ignored).\n      sasl: this.opts.sasl,\n    });\n    const createPartitioner = resolveCreatePartitioner(\n      mod.Partitioners,\n      this.opts.partitioner,\n      this.transactional,\n    );\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      // Idempotent / transactional producers cap maxInFlight at 5. When the\n      // user picks transactional we force 1 to keep strict ordering across\n      // retries on classic (non-idempotent) clusters that haven't migrated\n      // to the broker-side fence.\n      maxInFlightRequests: this.transactional\n        ? 1\n        : this.opts.maxInFlightRequests,\n      transactionalId: resolvedTxId,\n      // kafkajs accepts these directly when set; undefined falls through to\n      // the kafkajs default.\n      requestTimeout: this.opts.requestTimeoutMs,\n      transactionTimeout: this.opts.transactionTimeoutMs,\n      // Setting any partitioner choice silences kafkajs's\n      // KafkaJSPartitionerNotSpecified warning.\n      createPartitioner,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        // Notify the abort hook BEFORE returning failedResults. The hook is\n        // best-effort: try/catch around it so a misbehaving hook can't make\n        // the abort path itself throw.\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — already documented as best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. When set, kafkajs routes the record\n      // to this exact partition; when undefined, the configured partitioner\n      // chooses. We keep the key here too because compacted topics need it\n      // even when partition is pinned.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\n/**\n * Resolve the `createPartitioner` factory kafkajs expects on\n * `producer({...})`. Returns `undefined` to fall through to the kafkajs\n * default when no choice is made AND the producer is non-transactional\n * (transactional producers don't trigger the no-partitioner warning).\n */\nfunction resolveCreatePartitioner(\n  partitioners: KjsPartitionersNamespace | undefined,\n  choice: KafkaJsPartitionerChoice | undefined,\n  transactional: boolean,\n): (() => unknown) | undefined {\n  if (!partitioners) return undefined;\n  // Default to the java-compatible partitioner when the caller didn't pick.\n  // It matches the Java client (murmur2) and silences the noisy warning;\n  // for transactional producers we leave the kafkajs default alone since\n  // EOS ordering is partitioner-agnostic and the warning doesn't fire there.\n  const effective: KafkaJsPartitionerChoice =\n    choice ?? (transactional ? \"default\" : \"java-compatible\");\n  switch (effective) {\n    case \"java-compatible\":\n      return partitioners.JavaCompatiblePartitioner;\n    case \"legacy\":\n      return partitioners.LegacyPartitioner;\n    case \"default\":\n      return partitioners.DefaultPartitioner;\n  }\n}\n\n/** Process-wide dedup so we never warn for the same option twice. */\nconst warnedKafkajsKeys = new Set<string>();\n\nfunction warnUnsupportedKafkajsOptions(opts: KafkaJsDriverOptions): void {\n  for (const key of UNSUPPORTED_BY_KAFKAJS) {\n    if (opts[key] === undefined) continue;\n    if (warnedKafkajsKeys.has(key)) continue;\n    warnedKafkajsKeys.add(key);\n    const message =\n      `'${key}' is not configurable on the kafkajs driver and was ignored. ` +\n      `Switch to the confluent driver (driver: \"confluent\") for fine-grained tuning, ` +\n      `or remove the option to silence this warning.`;\n    // Route through the configured logger when present; otherwise fall back\n    // to console.warn so users who never plumbed a logger still see the\n    // diagnostic (matches the prior behavior).\n    if (opts.logger) {\n      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });\n    } else {\n      console.warn(`[@eventferry/kafka] ${message}`);\n    }\n  }\n}\n\n/** Internal — used by tests. Resets the dedup so warnings can be observed in isolation. */\nexport function _resetKafkajsWarnDedup(): void {\n  warnedKafkajsKeys.clear();\n}\n\nasync function importKafkaJs(): Promise<{\n  Kafka: new (cfg: unknown) => KjsKafka;\n  Partitioners: KjsPartitionersNamespace;\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type {\n  KafkaConnectionConfig,\n  ProducerBehaviorConfig,\n  TlsConfig,\n} from \"./driver.js\";\n\n/**\n * Translate eventferry's normalized `KafkaConnectionConfig` into the shape\n * expected by `@confluentinc/kafka-javascript`'s `KafkaJS.Kafka` constructor.\n *\n * Returns an object with two parts:\n *   - `kafkaJS`: the kafkajs-compatible config layer (clientId, brokers, and\n *     simple ssl/sasl when no advanced TLS is needed).\n *   - top-level keys: librdkafka-style config (e.g. `ssl.ca.pem`,\n *     `security.protocol`) used when the user supplies a {@link TlsConfig}.\n *\n * Why a separate translator: the kafkajs-compat layer accepts the simple\n * `ssl: true` boolean but the verified path for mTLS (CA + cert + key) is\n * librdkafka's `ssl.*.pem` keys. The translator picks the right surface\n * based on what the caller supplied. Buffer inputs are coerced to strings —\n * librdkafka accepts PEM strings, NOT Buffers.\n */\nexport interface ConfluentClientConfig {\n  kafkaJS: Record<string, unknown>;\n  // librdkafka top-level keys; kept as a Record so we can spread them.\n  librdkafka: Record<string, unknown>;\n}\n\nexport function buildConfluentClientConfig(\n  opts: KafkaConnectionConfig & ProducerBehaviorConfig,\n): ConfluentClientConfig {\n  const kafkaJS: Record<string, unknown> = {\n    clientId: opts.clientId ?? \"eventferry\",\n    brokers: opts.brokers,\n  };\n  const librdkafka: Record<string, unknown> = {};\n\n  // ── Producer tuning passthrough (librdkafka config keys) ─────────────\n  if (opts.lingerMs !== undefined) librdkafka[\"linger.ms\"] = opts.lingerMs;\n  if (opts.batchSize !== undefined) librdkafka[\"batch.size\"] = opts.batchSize;\n  if (opts.maxInFlightRequests !== undefined) {\n    librdkafka[\"max.in.flight.requests.per.connection\"] =\n      opts.maxInFlightRequests;\n  }\n  if (opts.requestTimeoutMs !== undefined) {\n    librdkafka[\"request.timeout.ms\"] = opts.requestTimeoutMs;\n  }\n  if (opts.deliveryTimeoutMs !== undefined) {\n    librdkafka[\"delivery.timeout.ms\"] = opts.deliveryTimeoutMs;\n  }\n  if (opts.maxRequestSize !== undefined) {\n    librdkafka[\"message.max.bytes\"] = opts.maxRequestSize;\n  }\n  if (opts.transactionTimeoutMs !== undefined) {\n    librdkafka[\"transaction.timeout.ms\"] = opts.transactionTimeoutMs;\n  }\n\n  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);\n  const saslRequested = !!opts.sasl;\n\n  if (saslRequested && tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_ssl\";\n  } else if (tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"ssl\";\n  } else if (saslRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_plaintext\";\n  } // else: leave as default (plaintext)\n\n  if (isTlsConfig(opts.ssl)) {\n    // Custom TLS — explicit librdkafka PEM keys. Buffers are coerced to\n    // strings (librdkafka does not accept Buffer).\n    const tls = opts.ssl;\n    if (tls.ca !== undefined) {\n      librdkafka[\"ssl.ca.pem\"] = stringifyPem(tls.ca);\n    }\n    if (tls.cert !== undefined) {\n      librdkafka[\"ssl.certificate.pem\"] = stringifyPem(tls.cert);\n    }\n    if (tls.key !== undefined) {\n      librdkafka[\"ssl.key.pem\"] = stringifyPem(tls.key);\n    }\n    if (tls.passphrase !== undefined) {\n      librdkafka[\"ssl.key.password\"] = tls.passphrase;\n    }\n    // servername (SNI) — librdkafka derives SNI from `ssl.endpoint.identification.algorithm`;\n    // explicit SNI override is not documented in the v1.x kafkaJS-compat surface, so we\n    // honor it as a no-op for now and document the limitation in the gap analysis.\n  } else if (opts.ssl === true) {\n    // Simple TLS — kafkajs-compat boolean is sufficient.\n    kafkaJS[\"ssl\"] = true;\n  }\n\n  if (opts.sasl) {\n    // SASL — kafkajs-compat shape works for both password mechanisms and\n    // OAUTHBEARER (the confluent client implements the provider callback).\n    kafkaJS[\"sasl\"] = opts.sasl;\n  }\n\n  return { kafkaJS, librdkafka };\n}\n\nfunction isTlsConfig(v: unknown): v is TlsConfig {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction stringifyPem(input: string | Buffer | Array<string | Buffer>): string {\n  if (Array.isArray(input)) {\n    return input.map((x) => (typeof x === \"string\" ? x : x.toString(\"utf8\"))).join(\"\\n\");\n  }\n  return typeof input === \"string\" ? input : input.toString(\"utf8\");\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\nimport { buildConfluentClientConfig } from \"./confluent-config.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS,\n      ...librdkafka,\n    });\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(resolvedTxId ? { transactionalId: resolvedTxId } : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — abort hook is best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. librdkafka honors an explicit\n      // partition value; undefined leaves the default partitioner in charge.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult, Logger } from \"@eventferry/core\";\n\n/**\n * Lifecycle hooks fired by `KafkaPublisher`. Every hook is optional. The\n * publisher wraps each invocation in a try/catch and logs (via the\n * configured logger) on failure — a misbehaving hook will NEVER break\n * publishing.\n *\n * Typical wiring:\n *   - Custom observability stacks (Datadog APM, New Relic) → `onPublish`,\n *     `onError`, `onTransactionAbort`.\n *   - Connection-aware readiness probes → `onConnect` / `onDisconnect`.\n *   - Audit logs of every published record → `onPublish`.\n */\nexport interface KafkaPublisherHooks {\n  /** Fires after the underlying client successfully connects. */\n  onConnect?(): void | Promise<void>;\n  /** Fires after the underlying client disconnects (clean shutdown). */\n  onDisconnect?(): void | Promise<void>;\n  /**\n   * Fires once per record after a publish attempt — both successes and\n   * failures. The `result.ok` flag distinguishes them.\n   */\n  onPublish?(\n    result: PublishResult,\n    message: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires for any error surfaced from the publish path — driver-thrown\n   * errors, transaction abort errors, etc. `message` is set when the error\n   * is per-record; absent for batch-level errors (e.g. connect failure).\n   */\n  onError?(\n    error: Error,\n    message?: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires when a transactional sendBatch's inner abort path is taken.\n   * Useful for observability dashboards that track EOS failure rates.\n   */\n  onTransactionAbort?(error: Error): void | Promise<void>;\n}\n\n/**\n * Invoke a hook safely. Never throws back into the caller — logs the hook's\n * failure via the configured logger (or no-op when logger is absent).\n */\nexport async function safeHook(\n  logger: Logger | undefined,\n  hookName: keyof KafkaPublisherHooks,\n  invoke: () => void | Promise<void> | undefined,\n): Promise<void> {\n  try {\n    const r = invoke();\n    if (r && typeof (r as Promise<void>).then === \"function\") {\n      await r;\n    }\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {\n      error: error.message,\n    });\n  }\n}\n","/**\n * Tracing surface for the publisher.\n *\n * eventferry deliberately does not depend on `@opentelemetry/api` — instead\n * users wire a thin adapter over their tracing system (OpenTelemetry,\n * Datadog, internal, …). This file defines the minimal contract; an\n * OpenTelemetry adapter is ~10 lines (see the README).\n *\n * The contract follows the **current stable** OpenTelemetry messaging\n * semantic conventions\n * ({@link https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md spec}):\n *\n *   - Span name: `\"{topic} publish\"`\n *   - `SpanKind.PRODUCER`\n *   - Required attributes: `messaging.system=kafka`,\n *     `messaging.operation.type=publish`, `messaging.destination.name=<topic>`\n *   - Recommended: `messaging.batch.message_count`, `messaging.kafka.partition`,\n *     `server.address`, `server.port`\n *   - One span per batch (NOT per message — per-message spans cause\n *     cardinality explosion and the spec actively warns against this)\n */\n\n/** Attribute values the spec allows. */\nexport type SpanAttributeValue = string | number | boolean;\n\n/**\n * Minimal span surface the publisher needs. Implementations wrap a\n * tracing-system-specific span; methods MUST never throw out of the\n * publisher's hot path (wrap your own SDK calls in try/catch).\n */\nexport interface SpanLike {\n  setAttribute(key: string, value: SpanAttributeValue): void;\n  setAttributes(attrs: Record<string, SpanAttributeValue>): void;\n  /** OK on success; ERROR on failure. The `message` is the error message. */\n  setStatus(status: { code: \"ok\" | \"error\"; message?: string }): void;\n  /** Attach an exception to the span (OpenTelemetry `recordException`). */\n  recordException(error: Error): void;\n  end(): void;\n}\n\n/**\n * Factory the publisher calls once per `sendBatch` to start a span.\n * Implementations MUST set `SpanKind.PRODUCER` and the messaging semconv\n * attributes on the returned span before returning it.\n */\nexport interface KafkaTracer {\n  /**\n   * Start a publish span.\n   * @param name        Recommended format: `\"{topic} publish\"`.\n   * @param attributes  Initial attributes (the publisher supplies the messaging\n   *                    semconv set: system, destination.name, operation.type,\n   *                    batch.message_count, plus optional kafka.partition and\n   *                    server.address/port).\n   */\n  startPublishSpan(\n    name: string,\n    attributes: Record<string, SpanAttributeValue>,\n  ): SpanLike;\n}\n\n/**\n * No-op tracer. Used when the user does not configure one. Cheap allocation\n * — never touches I/O.\n */\nexport class NoopKafkaTracer implements KafkaTracer {\n  startPublishSpan(): SpanLike {\n    return NOOP_SPAN;\n  }\n}\n\nconst NOOP_SPAN: SpanLike = {\n  setAttribute() {},\n  setAttributes() {},\n  setStatus() {},\n  recordException() {},\n  end() {},\n};\n","import type {\n  Logger,\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\nimport { safeHook } from \"./hooks.js\";\nimport type { KafkaPublisherHooks } from \"./hooks.js\";\nimport { NoopKafkaTracer } from \"./tracing.js\";\nimport type { KafkaTracer, SpanLike } from \"./tracing.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n  /**\n   * Optional structured logger. When set, the publisher routes its own\n   * diagnostics (driver warnings, hook failures) through it. When omitted,\n   * the publisher is silent — only the underlying drivers may still log.\n   */\n  logger?: Logger;\n  /**\n   * Optional lifecycle hooks. Every hook is invoked safely (try/catch +\n   * logged via `logger`) and a misbehaving hook will never break publishing.\n   */\n  hooks?: KafkaPublisherHooks;\n  /**\n   * Optional tracer. When set, `publish()` wraps each batch in a span that\n   * follows the current stable OpenTelemetry messaging semantic conventions.\n   * Use a thin adapter over your tracing SDK (see {@link KafkaTracer}).\n   */\n  tracer?: KafkaTracer;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and adds\n * dead-letter routing, observability hooks, and OpenTelemetry-shaped publish\n * spans. Works against Kafka and Redpanda identically (Redpanda is Kafka-API\n * compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n  private readonly logger: Logger | undefined;\n  private readonly hooks: KafkaPublisherHooks;\n  private readonly tracer: KafkaTracer;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.logger = opts.logger;\n    this.hooks = opts.hooks ?? {};\n    this.tracer = opts.tracer ?? new NoopKafkaTracer();\n    // Plumb the logger into driver construction so driver-side diagnostics\n    // (e.g. kafkajs unsupported-tuning warnings) route through it too.\n    // Plumb a safe-wrapped onTransactionAbort callback so the driver-level\n    // transaction abort path fans out to the user-supplied hook safely.\n    const onTransactionAbort = this.hooks.onTransactionAbort\n      ? (error: Error) => {\n          void safeHook(this.logger, \"onTransactionAbort\", () =>\n            this.hooks.onTransactionAbort?.(error),\n          );\n        }\n      : undefined;\n    this.driver =\n      opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });\n  }\n\n  async connect(): Promise<void> {\n    await this.driver.connect();\n    await safeHook(this.logger, \"onConnect\", () => this.hooks.onConnect?.());\n  }\n\n  async disconnect(): Promise<void> {\n    await this.driver.disconnect();\n    await safeHook(this.logger, \"onDisconnect\", () =>\n      this.hooks.onDisconnect?.(),\n    );\n  }\n\n  async publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (messages.length === 0) return [];\n\n    const span = this.startBatchSpan(messages);\n    let results: PublishResult[];\n    try {\n      results = await this.driver.sendBatch(messages);\n    } catch (err) {\n      // Driver-level throw — every record is a failure attributed to the\n      // batch-level error. Record on the span, fire hook, rethrow.\n      const error = err instanceof Error ? err : new Error(String(err));\n      span.setStatus({ code: \"error\", message: error.message });\n      span.recordException(error);\n      span.end();\n      await safeHook(this.logger, \"onError\", () => this.hooks.onError?.(error));\n      throw err;\n    }\n\n    // Per-record hooks. Walk by index so the original message is available.\n    const byId = new Map(messages.map((m) => [m.recordId, m]));\n    let allOk = true;\n    for (const r of results) {\n      const msg = byId.get(r.recordId);\n      if (!msg) continue;\n      await safeHook(this.logger, \"onPublish\", () =>\n        this.hooks.onPublish?.(r, msg),\n      );\n      if (!r.ok) {\n        allOk = false;\n        const err = r.error ?? new Error(\"publish failed\");\n        await safeHook(this.logger, \"onError\", () =>\n          this.hooks.onError?.(err, msg),\n        );\n      }\n    }\n\n    span.setStatus(allOk ? { code: \"ok\" } : { code: \"error\" });\n    span.end();\n    return results;\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        // Error class name (e.g. \"KafkaJSProtocolError\", \"RecordTooLargeException\"),\n        // useful for downstream alert routing without parsing the reason string.\n        \"dlq-error-class\": error.name || error.constructor?.name || \"Error\",\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n\n  /**\n   * Start a span for the batch following the OTel messaging conventions.\n   *\n   * Multi-topic batches: per the OTel spec, the span name uses the\n   * destination — we pick the FIRST topic in the batch and document the\n   * limitation. Callers that publish heterogeneous batches and care about\n   * per-topic spans should split their batches upstream.\n   */\n  private startBatchSpan(messages: PublishableMessage[]): SpanLike {\n    const topic = messages[0]?.topic ?? \"unknown\";\n    return this.tracer.startPublishSpan(`${topic} publish`, {\n      \"messaging.system\": \"kafka\",\n      \"messaging.operation.type\": \"publish\",\n      \"messaging.destination.name\": topic,\n      \"messaging.batch.message_count\": messages.length,\n    });\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["CODE_TO_KIND","groupByTopic","failedResults"]}

package/dist/index.js

@@ -663,6 +663,9 @@ var KafkaPublisher = class {
       headers: {
         ...message.headers,
         "dlq-reason": error.message,
+        // Error class name (e.g. "KafkaJSProtocolError", "RecordTooLargeException"),
+        // useful for downstream alert routing without parsing the reason string.
+        "dlq-error-class": error.name || error.constructor?.name || "Error",
         "dlq-original-topic": message.headers["original-topic"] ?? "",
         "dlq-failed-at": (/* @__PURE__ */ new Date()).toISOString()
       }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/kafkajs-classifier.ts","../src/transactional-id.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-config.ts","../src/confluent-driver.ts","../src/hooks.ts","../src/tracing.ts","../src/publisher.ts"],"sourcesContent":["import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","/**\n * Resolve a {@link KafkaConnectionConfig}-style `transactionalId` into the\n * concrete string the underlying driver expects.\n *\n * Accepts:\n *   - `string`           — used verbatim.\n *   - `() => string`     — invoked once at connect time.\n *   - `() => Promise<string>` — awaited at connect time.\n *\n * Throws when the input is undefined (caller should pre-validate) or when\n * the callable yields an empty string.\n */\nexport async function resolveTransactionalId(\n  input: string | (() => string | Promise<string>) | undefined,\n): Promise<string> {\n  if (input === undefined) {\n    throw new Error(\"transactionalId is required when transactional=true\");\n  }\n  const raw = typeof input === \"function\" ? await input() : input;\n  if (typeof raw !== \"string\" || raw.length === 0) {\n    throw new Error(\n      \"transactionalId resolver must return a non-empty string\",\n    );\n  }\n  return raw;\n}\n","import type {\n  Logger,\n  PublishableMessage,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  KafkaJsPartitionerChoice,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n// kafkajs's `Partitioners` namespace: three factory functions; we pluck them\n// at runtime rather than depending on the kafkajs types.\ninterface KjsPartitionersNamespace {\n  DefaultPartitioner: () => unknown;\n  LegacyPartitioner: () => unknown;\n  JavaCompatiblePartitioner: () => unknown;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /**\n   * Optional logger for the driver's own diagnostics (e.g. warnings about\n   * unsupported tuning options). When absent the driver falls back to\n   * `console.warn` so existing users see the same output.\n   */\n  logger?: Logger;\n}\n\n/**\n * kafkajs producer-level knobs we expose on the typed API that kafkajs does\n * NOT actually support. On this driver these are warn-and-ignore; users\n * who need them should switch to the confluent driver.\n */\nconst UNSUPPORTED_BY_KAFKAJS = [\n  \"lingerMs\",\n  \"batchSize\",\n  \"deliveryTimeoutMs\",\n  \"maxRequestSize\",\n] as const;\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n    warnUnsupportedKafkajsOptions(opts);\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM\n      // string both supported. Our TlsConfig is a structural subset of that\n      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via\n      // `ca`). No translation needed.\n      ssl: this.opts.ssl,\n      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's\n      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from\n      // the provider's returned token (other fields are ignored).\n      sasl: this.opts.sasl,\n    });\n    const createPartitioner = resolveCreatePartitioner(\n      mod.Partitioners,\n      this.opts.partitioner,\n      this.transactional,\n    );\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      // Idempotent / transactional producers cap maxInFlight at 5. When the\n      // user picks transactional we force 1 to keep strict ordering across\n      // retries on classic (non-idempotent) clusters that haven't migrated\n      // to the broker-side fence.\n      maxInFlightRequests: this.transactional\n        ? 1\n        : this.opts.maxInFlightRequests,\n      transactionalId: resolvedTxId,\n      // kafkajs accepts these directly when set; undefined falls through to\n      // the kafkajs default.\n      requestTimeout: this.opts.requestTimeoutMs,\n      transactionTimeout: this.opts.transactionTimeoutMs,\n      // Setting any partitioner choice silences kafkajs's\n      // KafkaJSPartitionerNotSpecified warning.\n      createPartitioner,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        // Notify the abort hook BEFORE returning failedResults. The hook is\n        // best-effort: try/catch around it so a misbehaving hook can't make\n        // the abort path itself throw.\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — already documented as best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. When set, kafkajs routes the record\n      // to this exact partition; when undefined, the configured partitioner\n      // chooses. We keep the key here too because compacted topics need it\n      // even when partition is pinned.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\n/**\n * Resolve the `createPartitioner` factory kafkajs expects on\n * `producer({...})`. Returns `undefined` to fall through to the kafkajs\n * default when no choice is made AND the producer is non-transactional\n * (transactional producers don't trigger the no-partitioner warning).\n */\nfunction resolveCreatePartitioner(\n  partitioners: KjsPartitionersNamespace | undefined,\n  choice: KafkaJsPartitionerChoice | undefined,\n  transactional: boolean,\n): (() => unknown) | undefined {\n  if (!partitioners) return undefined;\n  // Default to the java-compatible partitioner when the caller didn't pick.\n  // It matches the Java client (murmur2) and silences the noisy warning;\n  // for transactional producers we leave the kafkajs default alone since\n  // EOS ordering is partitioner-agnostic and the warning doesn't fire there.\n  const effective: KafkaJsPartitionerChoice =\n    choice ?? (transactional ? \"default\" : \"java-compatible\");\n  switch (effective) {\n    case \"java-compatible\":\n      return partitioners.JavaCompatiblePartitioner;\n    case \"legacy\":\n      return partitioners.LegacyPartitioner;\n    case \"default\":\n      return partitioners.DefaultPartitioner;\n  }\n}\n\n/** Process-wide dedup so we never warn for the same option twice. */\nconst warnedKafkajsKeys = new Set<string>();\n\nfunction warnUnsupportedKafkajsOptions(opts: KafkaJsDriverOptions): void {\n  for (const key of UNSUPPORTED_BY_KAFKAJS) {\n    if (opts[key] === undefined) continue;\n    if (warnedKafkajsKeys.has(key)) continue;\n    warnedKafkajsKeys.add(key);\n    const message =\n      `'${key}' is not configurable on the kafkajs driver and was ignored. ` +\n      `Switch to the confluent driver (driver: \"confluent\") for fine-grained tuning, ` +\n      `or remove the option to silence this warning.`;\n    // Route through the configured logger when present; otherwise fall back\n    // to console.warn so users who never plumbed a logger still see the\n    // diagnostic (matches the prior behavior).\n    if (opts.logger) {\n      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });\n    } else {\n      console.warn(`[@eventferry/kafka] ${message}`);\n    }\n  }\n}\n\n/** Internal — used by tests. Resets the dedup so warnings can be observed in isolation. */\nexport function _resetKafkajsWarnDedup(): void {\n  warnedKafkajsKeys.clear();\n}\n\nasync function importKafkaJs(): Promise<{\n  Kafka: new (cfg: unknown) => KjsKafka;\n  Partitioners: KjsPartitionersNamespace;\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type {\n  KafkaConnectionConfig,\n  ProducerBehaviorConfig,\n  TlsConfig,\n} from \"./driver.js\";\n\n/**\n * Translate eventferry's normalized `KafkaConnectionConfig` into the shape\n * expected by `@confluentinc/kafka-javascript`'s `KafkaJS.Kafka` constructor.\n *\n * Returns an object with two parts:\n *   - `kafkaJS`: the kafkajs-compatible config layer (clientId, brokers, and\n *     simple ssl/sasl when no advanced TLS is needed).\n *   - top-level keys: librdkafka-style config (e.g. `ssl.ca.pem`,\n *     `security.protocol`) used when the user supplies a {@link TlsConfig}.\n *\n * Why a separate translator: the kafkajs-compat layer accepts the simple\n * `ssl: true` boolean but the verified path for mTLS (CA + cert + key) is\n * librdkafka's `ssl.*.pem` keys. The translator picks the right surface\n * based on what the caller supplied. Buffer inputs are coerced to strings —\n * librdkafka accepts PEM strings, NOT Buffers.\n */\nexport interface ConfluentClientConfig {\n  kafkaJS: Record<string, unknown>;\n  // librdkafka top-level keys; kept as a Record so we can spread them.\n  librdkafka: Record<string, unknown>;\n}\n\nexport function buildConfluentClientConfig(\n  opts: KafkaConnectionConfig & ProducerBehaviorConfig,\n): ConfluentClientConfig {\n  const kafkaJS: Record<string, unknown> = {\n    clientId: opts.clientId ?? \"eventferry\",\n    brokers: opts.brokers,\n  };\n  const librdkafka: Record<string, unknown> = {};\n\n  // ── Producer tuning passthrough (librdkafka config keys) ─────────────\n  if (opts.lingerMs !== undefined) librdkafka[\"linger.ms\"] = opts.lingerMs;\n  if (opts.batchSize !== undefined) librdkafka[\"batch.size\"] = opts.batchSize;\n  if (opts.maxInFlightRequests !== undefined) {\n    librdkafka[\"max.in.flight.requests.per.connection\"] =\n      opts.maxInFlightRequests;\n  }\n  if (opts.requestTimeoutMs !== undefined) {\n    librdkafka[\"request.timeout.ms\"] = opts.requestTimeoutMs;\n  }\n  if (opts.deliveryTimeoutMs !== undefined) {\n    librdkafka[\"delivery.timeout.ms\"] = opts.deliveryTimeoutMs;\n  }\n  if (opts.maxRequestSize !== undefined) {\n    librdkafka[\"message.max.bytes\"] = opts.maxRequestSize;\n  }\n  if (opts.transactionTimeoutMs !== undefined) {\n    librdkafka[\"transaction.timeout.ms\"] = opts.transactionTimeoutMs;\n  }\n\n  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);\n  const saslRequested = !!opts.sasl;\n\n  if (saslRequested && tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_ssl\";\n  } else if (tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"ssl\";\n  } else if (saslRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_plaintext\";\n  } // else: leave as default (plaintext)\n\n  if (isTlsConfig(opts.ssl)) {\n    // Custom TLS — explicit librdkafka PEM keys. Buffers are coerced to\n    // strings (librdkafka does not accept Buffer).\n    const tls = opts.ssl;\n    if (tls.ca !== undefined) {\n      librdkafka[\"ssl.ca.pem\"] = stringifyPem(tls.ca);\n    }\n    if (tls.cert !== undefined) {\n      librdkafka[\"ssl.certificate.pem\"] = stringifyPem(tls.cert);\n    }\n    if (tls.key !== undefined) {\n      librdkafka[\"ssl.key.pem\"] = stringifyPem(tls.key);\n    }\n    if (tls.passphrase !== undefined) {\n      librdkafka[\"ssl.key.password\"] = tls.passphrase;\n    }\n    // servername (SNI) — librdkafka derives SNI from `ssl.endpoint.identification.algorithm`;\n    // explicit SNI override is not documented in the v1.x kafkaJS-compat surface, so we\n    // honor it as a no-op for now and document the limitation in the gap analysis.\n  } else if (opts.ssl === true) {\n    // Simple TLS — kafkajs-compat boolean is sufficient.\n    kafkaJS[\"ssl\"] = true;\n  }\n\n  if (opts.sasl) {\n    // SASL — kafkajs-compat shape works for both password mechanisms and\n    // OAUTHBEARER (the confluent client implements the provider callback).\n    kafkaJS[\"sasl\"] = opts.sasl;\n  }\n\n  return { kafkaJS, librdkafka };\n}\n\nfunction isTlsConfig(v: unknown): v is TlsConfig {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction stringifyPem(input: string | Buffer | Array<string | Buffer>): string {\n  if (Array.isArray(input)) {\n    return input.map((x) => (typeof x === \"string\" ? x : x.toString(\"utf8\"))).join(\"\\n\");\n  }\n  return typeof input === \"string\" ? input : input.toString(\"utf8\");\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\nimport { buildConfluentClientConfig } from \"./confluent-config.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS,\n      ...librdkafka,\n    });\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(resolvedTxId ? { transactionalId: resolvedTxId } : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — abort hook is best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. librdkafka honors an explicit\n      // partition value; undefined leaves the default partitioner in charge.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult, Logger } from \"@eventferry/core\";\n\n/**\n * Lifecycle hooks fired by `KafkaPublisher`. Every hook is optional. The\n * publisher wraps each invocation in a try/catch and logs (via the\n * configured logger) on failure — a misbehaving hook will NEVER break\n * publishing.\n *\n * Typical wiring:\n *   - Custom observability stacks (Datadog APM, New Relic) → `onPublish`,\n *     `onError`, `onTransactionAbort`.\n *   - Connection-aware readiness probes → `onConnect` / `onDisconnect`.\n *   - Audit logs of every published record → `onPublish`.\n */\nexport interface KafkaPublisherHooks {\n  /** Fires after the underlying client successfully connects. */\n  onConnect?(): void | Promise<void>;\n  /** Fires after the underlying client disconnects (clean shutdown). */\n  onDisconnect?(): void | Promise<void>;\n  /**\n   * Fires once per record after a publish attempt — both successes and\n   * failures. The `result.ok` flag distinguishes them.\n   */\n  onPublish?(\n    result: PublishResult,\n    message: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires for any error surfaced from the publish path — driver-thrown\n   * errors, transaction abort errors, etc. `message` is set when the error\n   * is per-record; absent for batch-level errors (e.g. connect failure).\n   */\n  onError?(\n    error: Error,\n    message?: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires when a transactional sendBatch's inner abort path is taken.\n   * Useful for observability dashboards that track EOS failure rates.\n   */\n  onTransactionAbort?(error: Error): void | Promise<void>;\n}\n\n/**\n * Invoke a hook safely. Never throws back into the caller — logs the hook's\n * failure via the configured logger (or no-op when logger is absent).\n */\nexport async function safeHook(\n  logger: Logger | undefined,\n  hookName: keyof KafkaPublisherHooks,\n  invoke: () => void | Promise<void> | undefined,\n): Promise<void> {\n  try {\n    const r = invoke();\n    if (r && typeof (r as Promise<void>).then === \"function\") {\n      await r;\n    }\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {\n      error: error.message,\n    });\n  }\n}\n","/**\n * Tracing surface for the publisher.\n *\n * eventferry deliberately does not depend on `@opentelemetry/api` — instead\n * users wire a thin adapter over their tracing system (OpenTelemetry,\n * Datadog, internal, …). This file defines the minimal contract; an\n * OpenTelemetry adapter is ~10 lines (see the README).\n *\n * The contract follows the **current stable** OpenTelemetry messaging\n * semantic conventions\n * ({@link https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md spec}):\n *\n *   - Span name: `\"{topic} publish\"`\n *   - `SpanKind.PRODUCER`\n *   - Required attributes: `messaging.system=kafka`,\n *     `messaging.operation.type=publish`, `messaging.destination.name=<topic>`\n *   - Recommended: `messaging.batch.message_count`, `messaging.kafka.partition`,\n *     `server.address`, `server.port`\n *   - One span per batch (NOT per message — per-message spans cause\n *     cardinality explosion and the spec actively warns against this)\n */\n\n/** Attribute values the spec allows. */\nexport type SpanAttributeValue = string | number | boolean;\n\n/**\n * Minimal span surface the publisher needs. Implementations wrap a\n * tracing-system-specific span; methods MUST never throw out of the\n * publisher's hot path (wrap your own SDK calls in try/catch).\n */\nexport interface SpanLike {\n  setAttribute(key: string, value: SpanAttributeValue): void;\n  setAttributes(attrs: Record<string, SpanAttributeValue>): void;\n  /** OK on success; ERROR on failure. The `message` is the error message. */\n  setStatus(status: { code: \"ok\" | \"error\"; message?: string }): void;\n  /** Attach an exception to the span (OpenTelemetry `recordException`). */\n  recordException(error: Error): void;\n  end(): void;\n}\n\n/**\n * Factory the publisher calls once per `sendBatch` to start a span.\n * Implementations MUST set `SpanKind.PRODUCER` and the messaging semconv\n * attributes on the returned span before returning it.\n */\nexport interface KafkaTracer {\n  /**\n   * Start a publish span.\n   * @param name        Recommended format: `\"{topic} publish\"`.\n   * @param attributes  Initial attributes (the publisher supplies the messaging\n   *                    semconv set: system, destination.name, operation.type,\n   *                    batch.message_count, plus optional kafka.partition and\n   *                    server.address/port).\n   */\n  startPublishSpan(\n    name: string,\n    attributes: Record<string, SpanAttributeValue>,\n  ): SpanLike;\n}\n\n/**\n * No-op tracer. Used when the user does not configure one. Cheap allocation\n * — never touches I/O.\n */\nexport class NoopKafkaTracer implements KafkaTracer {\n  startPublishSpan(): SpanLike {\n    return NOOP_SPAN;\n  }\n}\n\nconst NOOP_SPAN: SpanLike = {\n  setAttribute() {},\n  setAttributes() {},\n  setStatus() {},\n  recordException() {},\n  end() {},\n};\n","import type {\n  Logger,\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\nimport { safeHook } from \"./hooks.js\";\nimport type { KafkaPublisherHooks } from \"./hooks.js\";\nimport { NoopKafkaTracer } from \"./tracing.js\";\nimport type { KafkaTracer, SpanLike } from \"./tracing.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n  /**\n   * Optional structured logger. When set, the publisher routes its own\n   * diagnostics (driver warnings, hook failures) through it. When omitted,\n   * the publisher is silent — only the underlying drivers may still log.\n   */\n  logger?: Logger;\n  /**\n   * Optional lifecycle hooks. Every hook is invoked safely (try/catch +\n   * logged via `logger`) and a misbehaving hook will never break publishing.\n   */\n  hooks?: KafkaPublisherHooks;\n  /**\n   * Optional tracer. When set, `publish()` wraps each batch in a span that\n   * follows the current stable OpenTelemetry messaging semantic conventions.\n   * Use a thin adapter over your tracing SDK (see {@link KafkaTracer}).\n   */\n  tracer?: KafkaTracer;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and adds\n * dead-letter routing, observability hooks, and OpenTelemetry-shaped publish\n * spans. Works against Kafka and Redpanda identically (Redpanda is Kafka-API\n * compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n  private readonly logger: Logger | undefined;\n  private readonly hooks: KafkaPublisherHooks;\n  private readonly tracer: KafkaTracer;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.logger = opts.logger;\n    this.hooks = opts.hooks ?? {};\n    this.tracer = opts.tracer ?? new NoopKafkaTracer();\n    // Plumb the logger into driver construction so driver-side diagnostics\n    // (e.g. kafkajs unsupported-tuning warnings) route through it too.\n    // Plumb a safe-wrapped onTransactionAbort callback so the driver-level\n    // transaction abort path fans out to the user-supplied hook safely.\n    const onTransactionAbort = this.hooks.onTransactionAbort\n      ? (error: Error) => {\n          void safeHook(this.logger, \"onTransactionAbort\", () =>\n            this.hooks.onTransactionAbort?.(error),\n          );\n        }\n      : undefined;\n    this.driver =\n      opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });\n  }\n\n  async connect(): Promise<void> {\n    await this.driver.connect();\n    await safeHook(this.logger, \"onConnect\", () => this.hooks.onConnect?.());\n  }\n\n  async disconnect(): Promise<void> {\n    await this.driver.disconnect();\n    await safeHook(this.logger, \"onDisconnect\", () =>\n      this.hooks.onDisconnect?.(),\n    );\n  }\n\n  async publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (messages.length === 0) return [];\n\n    const span = this.startBatchSpan(messages);\n    let results: PublishResult[];\n    try {\n      results = await this.driver.sendBatch(messages);\n    } catch (err) {\n      // Driver-level throw — every record is a failure attributed to the\n      // batch-level error. Record on the span, fire hook, rethrow.\n      const error = err instanceof Error ? err : new Error(String(err));\n      span.setStatus({ code: \"error\", message: error.message });\n      span.recordException(error);\n      span.end();\n      await safeHook(this.logger, \"onError\", () => this.hooks.onError?.(error));\n      throw err;\n    }\n\n    // Per-record hooks. Walk by index so the original message is available.\n    const byId = new Map(messages.map((m) => [m.recordId, m]));\n    let allOk = true;\n    for (const r of results) {\n      const msg = byId.get(r.recordId);\n      if (!msg) continue;\n      await safeHook(this.logger, \"onPublish\", () =>\n        this.hooks.onPublish?.(r, msg),\n      );\n      if (!r.ok) {\n        allOk = false;\n        const err = r.error ?? new Error(\"publish failed\");\n        await safeHook(this.logger, \"onError\", () =>\n          this.hooks.onError?.(err, msg),\n        );\n      }\n    }\n\n    span.setStatus(allOk ? { code: \"ok\" } : { code: \"error\" });\n    span.end();\n    return results;\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n\n  /**\n   * Start a span for the batch following the OTel messaging conventions.\n   *\n   * Multi-topic batches: per the OTel spec, the span name uses the\n   * destination — we pick the FIRST topic in the batch and document the\n   * limitation. Callers that publish heterogeneous batches and care about\n   * per-topic spans should split their batches upstream.\n   */\n  private startBatchSpan(messages: PublishableMessage[]): SpanLike {\n    const topic = messages[0]?.topic ?? \"unknown\";\n    return this.tracer.startPublishSpan(`${topic} publish`, {\n      \"messaging.system\": \"kafka\",\n      \"messaging.operation.type\": \"publish\",\n      \"messaging.destination.name\": topic,\n      \"messaging.batch.message_count\": messages.length,\n    });\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["CODE_TO_KIND","groupByTopic","failedResults"]}
+{"version":3,"sources":["../src/kafkajs-classifier.ts","../src/transactional-id.ts","../src/kafkajs-driver.ts","../src/confluent-classifier.ts","../src/confluent-config.ts","../src/confluent-driver.ts","../src/hooks.ts","../src/tracing.ts","../src/publisher.ts"],"sourcesContent":["import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a kafkajs producer error into a {@link PublishErrorKind} so the\n * core relay can decide whether to retry, short-circuit to the DLQ, or pause\n * polling.\n *\n * Mapping verified against `kafkajs/src/errors.js` (v2.x). Protocol error\n * codes match the Kafka Protocol error-code registry. Library-specific\n * subclasses (`KafkaJSRequestTimeoutError`, `KafkaJSConnectionError`,\n * `KafkaJSNonRetriableError`) are matched by the `name` property kafkajs\n * sets on its Error subclasses.\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias. At worst we\n * retry an error that should have been skipped; in practice we'd rather\n * over-retry than mis-classify a transient blip as terminal.\n */\nexport function classifyKafkajsError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { name?: string; type?: string; code?: number };\n\n  // Class-based first — these don't carry a protocol error code.\n  if (e.name === \"KafkaJSConnectionError\") return \"retriable\";\n  if (e.name === \"KafkaJSRequestTimeoutError\") return \"retriable\";\n  if (e.name === \"KafkaJSNonRetriableError\") return \"fatal\";\n\n  // Protocol error type (string) — kafkajs's KafkaJSProtocolError exposes\n  // both `type` (uppercase string) and `code` (number). Use `type` first\n  // for readability and fall back to `code` for codes that lack a stable\n  // string label.\n  const type = typeof e.type === \"string\" ? e.type : undefined;\n  if (type) {\n    if (RETRIABLE_TYPES.has(type)) return \"retriable\";\n    if (POISON_TYPES.has(type)) return \"poison\";\n    if (FATAL_TYPES.has(type)) return \"fatal\";\n  }\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\nconst RETRIABLE_TYPES = new Set<string>([\n  \"NOT_LEADER_FOR_PARTITION\",\n  \"LEADER_NOT_AVAILABLE\",\n  \"UNKNOWN_TOPIC_OR_PARTITION\",\n  \"NETWORK_EXCEPTION\",\n  \"REQUEST_TIMED_OUT\",\n  \"REPLICA_NOT_AVAILABLE\",\n  \"NOT_ENOUGH_REPLICAS\",\n  \"NOT_ENOUGH_REPLICAS_AFTER_APPEND\",\n  \"FENCED_LEADER_EPOCH\",\n  \"UNKNOWN_LEADER_EPOCH\",\n  \"BROKER_NOT_AVAILABLE\",\n  \"COORDINATOR_LOAD_IN_PROGRESS\",\n  \"COORDINATOR_NOT_AVAILABLE\",\n]);\n\nconst POISON_TYPES = new Set<string>([\n  \"CORRUPT_MESSAGE\",\n  \"MESSAGE_TOO_LARGE\",\n  \"INVALID_RECORD\",\n  \"UNSUPPORTED_COMPRESSION_TYPE\",\n  \"INVALID_REQUIRED_ACKS\",\n  \"INVALID_PARTITIONS\",\n]);\n\nconst FATAL_TYPES = new Set<string>([\n  \"INVALID_PRODUCER_EPOCH\",\n  \"PRODUCER_FENCED\",\n  \"TOPIC_AUTHORIZATION_FAILED\",\n  \"CLUSTER_AUTHORIZATION_FAILED\",\n  \"TRANSACTIONAL_ID_AUTHORIZATION_FAILED\",\n  \"SASL_AUTHENTICATION_FAILED\",\n  \"INVALID_TRANSACTION_STATE\",\n  \"UNSUPPORTED_VERSION\",\n]);\n\n/** Numeric fallback for clusters that only return the wire code. */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n]);\n","/**\n * Resolve a {@link KafkaConnectionConfig}-style `transactionalId` into the\n * concrete string the underlying driver expects.\n *\n * Accepts:\n *   - `string`           — used verbatim.\n *   - `() => string`     — invoked once at connect time.\n *   - `() => Promise<string>` — awaited at connect time.\n *\n * Throws when the input is undefined (caller should pre-validate) or when\n * the callable yields an empty string.\n */\nexport async function resolveTransactionalId(\n  input: string | (() => string | Promise<string>) | undefined,\n): Promise<string> {\n  if (input === undefined) {\n    throw new Error(\"transactionalId is required when transactional=true\");\n  }\n  const raw = typeof input === \"function\" ? await input() : input;\n  if (typeof raw !== \"string\" || raw.length === 0) {\n    throw new Error(\n      \"transactionalId resolver must return a non-empty string\",\n    );\n  }\n  return raw;\n}\n","import type {\n  Logger,\n  PublishableMessage,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { classifyKafkajsError } from \"./kafkajs-classifier.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  KafkaJsPartitionerChoice,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Loosely-typed structural references to the kafkajs API so this file\n// compiles without kafkajs installed (it's an optional peer dep).\ninterface KjsProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  // kafkajs: sendBatch takes { topicMessages }, send takes a single { topic, messages }.\n  sendBatch(args: unknown): Promise<unknown>;\n  transaction(): Promise<KjsTransaction>;\n}\ninterface KjsTransaction {\n  sendBatch(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface KjsKafka {\n  producer(args?: unknown): KjsProducer;\n}\n// kafkajs's `Partitioners` namespace: three factory functions; we pluck them\n// at runtime rather than depending on the kafkajs types.\ninterface KjsPartitionersNamespace {\n  DefaultPartitioner: () => unknown;\n  LegacyPartitioner: () => unknown;\n  JavaCompatiblePartitioner: () => unknown;\n}\n\nexport interface KafkaJsDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /**\n   * Optional logger for the driver's own diagnostics (e.g. warnings about\n   * unsupported tuning options). When absent the driver falls back to\n   * `console.warn` so existing users see the same output.\n   */\n  logger?: Logger;\n}\n\n/**\n * kafkajs producer-level knobs we expose on the typed API that kafkajs does\n * NOT actually support. On this driver these are warn-and-ignore; users\n * who need them should switch to the confluent driver.\n */\nconst UNSUPPORTED_BY_KAFKAJS = [\n  \"lingerMs\",\n  \"batchSize\",\n  \"deliveryTimeoutMs\",\n  \"maxRequestSize\",\n] as const;\n\n/**\n * Driver backed by the pure-JS `kafkajs` client. Simple, zero native deps.\n */\nexport class KafkaJsDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: KjsProducer | null = null;\n  private readonly opts: KafkaJsDriverOptions;\n\n  constructor(opts: KafkaJsDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"KafkaJsDriver: transactionalId is required when transactional=true\",\n      );\n    }\n    warnUnsupportedKafkajsOptions(opts);\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying kafkajs producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<KjsProducer> {\n    const mod = await importKafkaJs();\n    const kafka: KjsKafka = new mod.Kafka({\n      clientId: this.opts.clientId ?? \"eventferry\",\n      brokers: this.opts.brokers,\n      // kafkajs accepts `ssl: tls.ConnectionOptions` directly — Buffer + PEM\n      // string both supported. Our TlsConfig is a structural subset of that\n      // (`rejectUnauthorized` intentionally omitted; the cluster CA goes via\n      // `ca`). No translation needed.\n      ssl: this.opts.ssl,\n      // SASL: PLAIN / SCRAM-SHA-256 / SCRAM-SHA-512 / OAUTHBEARER. kafkajs's\n      // shape matches ours; for OAUTHBEARER kafkajs reads only `value` from\n      // the provider's returned token (other fields are ignored).\n      sasl: this.opts.sasl,\n    });\n    const createPartitioner = resolveCreatePartitioner(\n      mod.Partitioners,\n      this.opts.partitioner,\n      this.transactional,\n    );\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      idempotent: this.opts.idempotent ?? true,\n      // Idempotent / transactional producers cap maxInFlight at 5. When the\n      // user picks transactional we force 1 to keep strict ordering across\n      // retries on classic (non-idempotent) clusters that haven't migrated\n      // to the broker-side fence.\n      maxInFlightRequests: this.transactional\n        ? 1\n        : this.opts.maxInFlightRequests,\n      transactionalId: resolvedTxId,\n      // kafkajs accepts these directly when set; undefined falls through to\n      // the kafkajs default.\n      requestTimeout: this.opts.requestTimeoutMs,\n      transactionTimeout: this.opts.transactionTimeoutMs,\n      // Setting any partitioner choice silences kafkajs's\n      // KafkaJSPartitionerNotSpecified warning.\n      createPartitioner,\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"KafkaJsDriver not connected\");\n    const topicMessages = groupByTopic(messages, this.opts.compression);\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await txn.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        // Notify the abort hook BEFORE returning failedResults. The hook is\n        // best-effort: try/catch around it so a misbehaving hook can't make\n        // the abort path itself throw.\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — already documented as best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await this.producer.sendBatch({ topicMessages, acks: this.opts.acks ?? -1 });\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyKafkajsError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[], compression?: string) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. When set, kafkajs routes the record\n      // to this exact partition; when undefined, the configured partitioner\n      // chooses. We keep the key here too because compacted topics need it\n      // even when partition is pinned.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n    ...(compression && compression !== \"none\" ? { compression } : {}),\n  }));\n}\n\n/**\n * Resolve the `createPartitioner` factory kafkajs expects on\n * `producer({...})`. Returns `undefined` to fall through to the kafkajs\n * default when no choice is made AND the producer is non-transactional\n * (transactional producers don't trigger the no-partitioner warning).\n */\nfunction resolveCreatePartitioner(\n  partitioners: KjsPartitionersNamespace | undefined,\n  choice: KafkaJsPartitionerChoice | undefined,\n  transactional: boolean,\n): (() => unknown) | undefined {\n  if (!partitioners) return undefined;\n  // Default to the java-compatible partitioner when the caller didn't pick.\n  // It matches the Java client (murmur2) and silences the noisy warning;\n  // for transactional producers we leave the kafkajs default alone since\n  // EOS ordering is partitioner-agnostic and the warning doesn't fire there.\n  const effective: KafkaJsPartitionerChoice =\n    choice ?? (transactional ? \"default\" : \"java-compatible\");\n  switch (effective) {\n    case \"java-compatible\":\n      return partitioners.JavaCompatiblePartitioner;\n    case \"legacy\":\n      return partitioners.LegacyPartitioner;\n    case \"default\":\n      return partitioners.DefaultPartitioner;\n  }\n}\n\n/** Process-wide dedup so we never warn for the same option twice. */\nconst warnedKafkajsKeys = new Set<string>();\n\nfunction warnUnsupportedKafkajsOptions(opts: KafkaJsDriverOptions): void {\n  for (const key of UNSUPPORTED_BY_KAFKAJS) {\n    if (opts[key] === undefined) continue;\n    if (warnedKafkajsKeys.has(key)) continue;\n    warnedKafkajsKeys.add(key);\n    const message =\n      `'${key}' is not configurable on the kafkajs driver and was ignored. ` +\n      `Switch to the confluent driver (driver: \"confluent\") for fine-grained tuning, ` +\n      `or remove the option to silence this warning.`;\n    // Route through the configured logger when present; otherwise fall back\n    // to console.warn so users who never plumbed a logger still see the\n    // diagnostic (matches the prior behavior).\n    if (opts.logger) {\n      opts.logger.warn(`[@eventferry/kafka] ${message}`, { option: key });\n    } else {\n      console.warn(`[@eventferry/kafka] ${message}`);\n    }\n  }\n}\n\n/** Internal — used by tests. Resets the dedup so warnings can be observed in isolation. */\nexport function _resetKafkajsWarnDedup(): void {\n  warnedKafkajsKeys.clear();\n}\n\nasync function importKafkaJs(): Promise<{\n  Kafka: new (cfg: unknown) => KjsKafka;\n  Partitioners: KjsPartitionersNamespace;\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"kafkajs\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"kafkajs\" selected but the \"kafkajs\" package is not installed. Run: npm i kafkajs',\n    );\n  }\n}\n","import type { PublishErrorKind } from \"@eventferry/core\";\n\n/**\n * Classify a `@confluentinc/kafka-javascript` (librdkafka) producer error\n * into a {@link PublishErrorKind} so the core relay can decide whether to\n * retry, short-circuit to the DLQ, or pause polling.\n *\n * librdkafka exposes errors as numeric `RD_KAFKA_RESP_ERR_*` codes — negative\n * codes are library-internal (transport, queue-full, ssl), non-negative\n * codes are wire-protocol errors that match the Kafka protocol's error-code\n * registry. The confluent driver surfaces these on `err.code` (alongside\n * an `err.name` for the symbolic form).\n *\n * Unknown errors fall back to `\"retriable\"` — the safe bias.\n */\nexport function classifyConfluentError(err: unknown): PublishErrorKind {\n  if (!err || typeof err !== \"object\") return \"retriable\";\n  const e = err as { code?: number; name?: string };\n\n  if (typeof e.code === \"number\") {\n    const k = CODE_TO_KIND.get(e.code);\n    if (k) return k;\n  }\n\n  if (typeof e.name === \"string\") {\n    const k = NAME_TO_KIND.get(e.name);\n    if (k) return k;\n  }\n\n  return \"retriable\";\n}\n\n/**\n * Authoritative mapping for the most-common librdkafka producer error codes.\n * Sources: `librdkafka/src/rdkafka.h` (`RD_KAFKA_RESP_ERR_*` enum) and the\n * Kafka Protocol error-code registry. Adding a code here is a one-line\n * change — start narrow, broaden as production exposes new codes.\n */\nconst CODE_TO_KIND: ReadonlyMap<number, PublishErrorKind> = new Map([\n  // Library-internal (negative codes)\n  [-184, \"backpressure\"], // ERR__QUEUE_FULL — our outbound buffer is full\n  [-185, \"retriable\"], // ERR__TIMED_OUT\n  [-187, \"retriable\"], // ERR__ALL_BROKERS_DOWN\n  [-188, \"poison\"], // ERR__UNKNOWN_TOPIC — topic doesn't exist on broker\n  [-190, \"poison\"], // ERR__UNKNOWN_PARTITION\n  [-192, \"retriable\"], // ERR__MSG_TIMED_OUT\n  [-195, \"retriable\"], // ERR__TRANSPORT\n  [-198, \"poison\"], // ERR__BAD_COMPRESSION\n  [-144, \"fatal\"], // ERR__FENCED — producer fenced by another with same txn id\n  [-150, \"fatal\"], // ERR__FATAL — unrecoverable librdkafka error\n  [-169, \"fatal\"], // ERR__AUTHENTICATION\n  [-181, \"fatal\"], // ERR__SSL\n  [-196, \"retriable\"], // ERR__FAIL — catch-all, safe-default to retriable\n\n  // Wire-protocol (non-negative codes — Kafka error-code registry)\n  [2, \"poison\"], // CORRUPT_MESSAGE\n  [3, \"retriable\"], // UNKNOWN_TOPIC_OR_PARTITION\n  [5, \"retriable\"], // LEADER_NOT_AVAILABLE\n  [6, \"retriable\"], // NOT_LEADER_FOR_PARTITION\n  [7, \"retriable\"], // REQUEST_TIMED_OUT\n  [9, \"retriable\"], // REPLICA_NOT_AVAILABLE\n  [10, \"poison\"], // MESSAGE_TOO_LARGE\n  [13, \"retriable\"], // NETWORK_EXCEPTION\n  [19, \"retriable\"], // NOT_ENOUGH_REPLICAS\n  [29, \"fatal\"], // TOPIC_AUTHORIZATION_FAILED\n  [31, \"fatal\"], // CLUSTER_AUTHORIZATION_FAILED\n  [47, \"fatal\"], // INVALID_PRODUCER_EPOCH\n  [58, \"fatal\"], // SASL_AUTHENTICATION_FAILED\n  [74, \"retriable\"], // FENCED_LEADER_EPOCH\n  [76, \"poison\"], // UNSUPPORTED_COMPRESSION_TYPE\n  [87, \"poison\"], // INVALID_RECORD\n  [89, \"quota\"], // THROTTLING_QUOTA_EXCEEDED\n]);\n\n/** Symbolic name fallback for clients that surface `err.name` only. */\nconst NAME_TO_KIND: ReadonlyMap<string, PublishErrorKind> = new Map([\n  [\"ERR__QUEUE_FULL\", \"backpressure\"],\n  [\"ERR__FENCED\", \"fatal\"],\n  [\"ERR__FATAL\", \"fatal\"],\n  [\"ERR__AUTHENTICATION\", \"fatal\"],\n  [\"ERR__SSL\", \"fatal\"],\n  [\"ERR__UNKNOWN_TOPIC\", \"poison\"],\n  [\"ERR__UNKNOWN_PARTITION\", \"poison\"],\n  [\"ERR__BAD_COMPRESSION\", \"poison\"],\n  [\"ERR_TOPIC_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_CLUSTER_AUTHORIZATION_FAILED\", \"fatal\"],\n  [\"ERR_INVALID_PRODUCER_EPOCH\", \"fatal\"],\n  [\"ERR_SASL_AUTHENTICATION_FAILED\", \"fatal\"],\n  [\"ERR_CORRUPT_MESSAGE\", \"poison\"],\n  [\"ERR_MSG_SIZE_TOO_LARGE\", \"poison\"],\n  [\"ERR_INVALID_RECORD\", \"poison\"],\n  [\"ERR_UNSUPPORTED_COMPRESSION_TYPE\", \"poison\"],\n  [\"ERR_THROTTLING_QUOTA_EXCEEDED\", \"quota\"],\n]);\n","import type {\n  KafkaConnectionConfig,\n  ProducerBehaviorConfig,\n  TlsConfig,\n} from \"./driver.js\";\n\n/**\n * Translate eventferry's normalized `KafkaConnectionConfig` into the shape\n * expected by `@confluentinc/kafka-javascript`'s `KafkaJS.Kafka` constructor.\n *\n * Returns an object with two parts:\n *   - `kafkaJS`: the kafkajs-compatible config layer (clientId, brokers, and\n *     simple ssl/sasl when no advanced TLS is needed).\n *   - top-level keys: librdkafka-style config (e.g. `ssl.ca.pem`,\n *     `security.protocol`) used when the user supplies a {@link TlsConfig}.\n *\n * Why a separate translator: the kafkajs-compat layer accepts the simple\n * `ssl: true` boolean but the verified path for mTLS (CA + cert + key) is\n * librdkafka's `ssl.*.pem` keys. The translator picks the right surface\n * based on what the caller supplied. Buffer inputs are coerced to strings —\n * librdkafka accepts PEM strings, NOT Buffers.\n */\nexport interface ConfluentClientConfig {\n  kafkaJS: Record<string, unknown>;\n  // librdkafka top-level keys; kept as a Record so we can spread them.\n  librdkafka: Record<string, unknown>;\n}\n\nexport function buildConfluentClientConfig(\n  opts: KafkaConnectionConfig & ProducerBehaviorConfig,\n): ConfluentClientConfig {\n  const kafkaJS: Record<string, unknown> = {\n    clientId: opts.clientId ?? \"eventferry\",\n    brokers: opts.brokers,\n  };\n  const librdkafka: Record<string, unknown> = {};\n\n  // ── Producer tuning passthrough (librdkafka config keys) ─────────────\n  if (opts.lingerMs !== undefined) librdkafka[\"linger.ms\"] = opts.lingerMs;\n  if (opts.batchSize !== undefined) librdkafka[\"batch.size\"] = opts.batchSize;\n  if (opts.maxInFlightRequests !== undefined) {\n    librdkafka[\"max.in.flight.requests.per.connection\"] =\n      opts.maxInFlightRequests;\n  }\n  if (opts.requestTimeoutMs !== undefined) {\n    librdkafka[\"request.timeout.ms\"] = opts.requestTimeoutMs;\n  }\n  if (opts.deliveryTimeoutMs !== undefined) {\n    librdkafka[\"delivery.timeout.ms\"] = opts.deliveryTimeoutMs;\n  }\n  if (opts.maxRequestSize !== undefined) {\n    librdkafka[\"message.max.bytes\"] = opts.maxRequestSize;\n  }\n  if (opts.transactionTimeoutMs !== undefined) {\n    librdkafka[\"transaction.timeout.ms\"] = opts.transactionTimeoutMs;\n  }\n\n  const tlsRequested = opts.ssl === true || isTlsConfig(opts.ssl);\n  const saslRequested = !!opts.sasl;\n\n  if (saslRequested && tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_ssl\";\n  } else if (tlsRequested) {\n    librdkafka[\"security.protocol\"] = \"ssl\";\n  } else if (saslRequested) {\n    librdkafka[\"security.protocol\"] = \"sasl_plaintext\";\n  } // else: leave as default (plaintext)\n\n  if (isTlsConfig(opts.ssl)) {\n    // Custom TLS — explicit librdkafka PEM keys. Buffers are coerced to\n    // strings (librdkafka does not accept Buffer).\n    const tls = opts.ssl;\n    if (tls.ca !== undefined) {\n      librdkafka[\"ssl.ca.pem\"] = stringifyPem(tls.ca);\n    }\n    if (tls.cert !== undefined) {\n      librdkafka[\"ssl.certificate.pem\"] = stringifyPem(tls.cert);\n    }\n    if (tls.key !== undefined) {\n      librdkafka[\"ssl.key.pem\"] = stringifyPem(tls.key);\n    }\n    if (tls.passphrase !== undefined) {\n      librdkafka[\"ssl.key.password\"] = tls.passphrase;\n    }\n    // servername (SNI) — librdkafka derives SNI from `ssl.endpoint.identification.algorithm`;\n    // explicit SNI override is not documented in the v1.x kafkaJS-compat surface, so we\n    // honor it as a no-op for now and document the limitation in the gap analysis.\n  } else if (opts.ssl === true) {\n    // Simple TLS — kafkajs-compat boolean is sufficient.\n    kafkaJS[\"ssl\"] = true;\n  }\n\n  if (opts.sasl) {\n    // SASL — kafkajs-compat shape works for both password mechanisms and\n    // OAUTHBEARER (the confluent client implements the provider callback).\n    kafkaJS[\"sasl\"] = opts.sasl;\n  }\n\n  return { kafkaJS, librdkafka };\n}\n\nfunction isTlsConfig(v: unknown): v is TlsConfig {\n  return typeof v === \"object\" && v !== null;\n}\n\nfunction stringifyPem(input: string | Buffer | Array<string | Buffer>): string {\n  if (Array.isArray(input)) {\n    return input.map((x) => (typeof x === \"string\" ? x : x.toString(\"utf8\"))).join(\"\\n\");\n  }\n  return typeof input === \"string\" ? input : input.toString(\"utf8\");\n}\n","import type { PublishableMessage, PublishResult } from \"@eventferry/core\";\nimport { classifyConfluentError } from \"./confluent-classifier.js\";\nimport { buildConfluentClientConfig } from \"./confluent-config.js\";\nimport { resolveTransactionalId } from \"./transactional-id.js\";\nimport type {\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\n\n// Structural typing of the confluent KafkaJS-compatible API surface so this\n// file compiles without the optional native dep installed.\ninterface CkProducer {\n  connect(): Promise<void>;\n  disconnect(): Promise<void>;\n  send(args: unknown): Promise<unknown>;\n  transaction(): Promise<CkTransaction>;\n}\ninterface CkTransaction {\n  send(args: unknown): Promise<unknown>;\n  commit(): Promise<void>;\n  abort(): Promise<void>;\n}\ninterface CkKafka {\n  producer(args?: unknown): CkProducer;\n}\n\nexport interface ConfluentDriverOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {}\n\n/**\n * Driver backed by `@confluentinc/kafka-javascript` (librdkafka wrapper).\n * Higher throughput; uses the KafkaJS-compatible promisified API so the\n * adapter mirrors the kafkajs driver closely.\n */\nexport class ConfluentDriver implements KafkaDriver {\n  readonly transactional: boolean;\n  private producer: CkProducer | null = null;\n  private readonly opts: ConfluentDriverOptions;\n\n  constructor(opts: ConfluentDriverOptions) {\n    this.opts = opts;\n    this.transactional = opts.transactional ?? false;\n    if (this.transactional && !opts.transactionalId) {\n      throw new Error(\n        \"ConfluentDriver: transactionalId is required when transactional=true\",\n      );\n    }\n  }\n\n  async connect(): Promise<void> {\n    this.producer = await this.createProducer();\n    await this.producer.connect();\n  }\n\n  /**\n   * Construct the underlying confluent producer. Overridable as a test seam so\n   * the send/transaction logic can be exercised without a real broker.\n   */\n  protected async createProducer(): Promise<CkProducer> {\n    const mod = await importConfluent();\n    const { kafkaJS, librdkafka } = buildConfluentClientConfig(this.opts);\n    const kafka: CkKafka = new mod.KafkaJS.Kafka({\n      kafkaJS,\n      ...librdkafka,\n    });\n    // Resolve a callable transactionalId — async-safe so runtime context\n    // (pod name, AZ index, k8s ordinal) can be derived at connect time.\n    const resolvedTxId = this.transactional\n      ? await resolveTransactionalId(this.opts.transactionalId)\n      : undefined;\n    return kafka.producer({\n      kafkaJS: {\n        idempotent: this.opts.idempotent ?? true,\n        ...(resolvedTxId ? { transactionalId: resolvedTxId } : {}),\n      },\n    });\n  }\n\n  async disconnect(): Promise<void> {\n    await this.producer?.disconnect();\n    this.producer = null;\n  }\n\n  async sendBatch(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (!this.producer) throw new Error(\"ConfluentDriver not connected\");\n    const topicMessages = groupByTopic(messages);\n    const acks = this.opts.acks ?? -1;\n    const compression = this.opts.compression;\n\n    const doSends = async (target: CkProducer | CkTransaction) => {\n      for (const tm of topicMessages) {\n        await target.send({\n          topic: tm.topic,\n          messages: tm.messages,\n          acks,\n          ...(compression && compression !== \"none\" ? { compression } : {}),\n        });\n      }\n    };\n\n    if (this.transactional) {\n      const txn = await this.producer.transaction();\n      try {\n        await doSends(txn);\n        await txn.commit();\n        return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n      } catch (err) {\n        await txn.abort().catch(() => undefined);\n        const error = err instanceof Error ? err : new Error(String(err));\n        try {\n          this.opts.onTransactionAbort?.(error);\n        } catch {\n          // swallow — abort hook is best-effort\n        }\n        return failedResults(messages, err);\n      }\n    }\n\n    try {\n      await doSends(this.producer);\n      return messages.map((m) => ({ recordId: m.recordId, ok: true }));\n    } catch (err) {\n      return failedResults(messages, err);\n    }\n  }\n}\n\nfunction failedResults(\n  messages: PublishableMessage[],\n  err: unknown,\n): PublishResult[] {\n  const error = err instanceof Error ? err : new Error(String(err));\n  const errorKind = classifyConfluentError(err);\n  return messages.map((m) => ({\n    recordId: m.recordId,\n    ok: false,\n    error,\n    errorKind,\n  }));\n}\n\nfunction groupByTopic(messages: PublishableMessage[]) {\n  const byTopic = new Map<string, unknown[]>();\n  for (const m of messages) {\n    const arr = byTopic.get(m.topic) ?? [];\n    arr.push({\n      key: m.key,\n      value: m.value,\n      headers: m.headers,\n      // Per-message partition override. librdkafka honors an explicit\n      // partition value; undefined leaves the default partitioner in charge.\n      ...(m.partition !== undefined ? { partition: m.partition } : {}),\n    });\n    byTopic.set(m.topic, arr);\n  }\n  return [...byTopic.entries()].map(([topic, msgs]) => ({\n    topic,\n    messages: msgs,\n  }));\n}\n\nasync function importConfluent(): Promise<{\n  KafkaJS: { Kafka: new (cfg: unknown) => CkKafka };\n}> {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    return (await import(\"@confluentinc/kafka-javascript\")) as any;\n  } catch {\n    throw new Error(\n      'Driver \"confluent\" selected but \"@confluentinc/kafka-javascript\" is not installed. Run: npm i @confluentinc/kafka-javascript',\n    );\n  }\n}\n","import type { PublishableMessage, PublishResult, Logger } from \"@eventferry/core\";\n\n/**\n * Lifecycle hooks fired by `KafkaPublisher`. Every hook is optional. The\n * publisher wraps each invocation in a try/catch and logs (via the\n * configured logger) on failure — a misbehaving hook will NEVER break\n * publishing.\n *\n * Typical wiring:\n *   - Custom observability stacks (Datadog APM, New Relic) → `onPublish`,\n *     `onError`, `onTransactionAbort`.\n *   - Connection-aware readiness probes → `onConnect` / `onDisconnect`.\n *   - Audit logs of every published record → `onPublish`.\n */\nexport interface KafkaPublisherHooks {\n  /** Fires after the underlying client successfully connects. */\n  onConnect?(): void | Promise<void>;\n  /** Fires after the underlying client disconnects (clean shutdown). */\n  onDisconnect?(): void | Promise<void>;\n  /**\n   * Fires once per record after a publish attempt — both successes and\n   * failures. The `result.ok` flag distinguishes them.\n   */\n  onPublish?(\n    result: PublishResult,\n    message: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires for any error surfaced from the publish path — driver-thrown\n   * errors, transaction abort errors, etc. `message` is set when the error\n   * is per-record; absent for batch-level errors (e.g. connect failure).\n   */\n  onError?(\n    error: Error,\n    message?: PublishableMessage,\n  ): void | Promise<void>;\n  /**\n   * Fires when a transactional sendBatch's inner abort path is taken.\n   * Useful for observability dashboards that track EOS failure rates.\n   */\n  onTransactionAbort?(error: Error): void | Promise<void>;\n}\n\n/**\n * Invoke a hook safely. Never throws back into the caller — logs the hook's\n * failure via the configured logger (or no-op when logger is absent).\n */\nexport async function safeHook(\n  logger: Logger | undefined,\n  hookName: keyof KafkaPublisherHooks,\n  invoke: () => void | Promise<void> | undefined,\n): Promise<void> {\n  try {\n    const r = invoke();\n    if (r && typeof (r as Promise<void>).then === \"function\") {\n      await r;\n    }\n  } catch (err) {\n    const error = err instanceof Error ? err : new Error(String(err));\n    logger?.warn(`[@eventferry/kafka] hook ${hookName} threw; ignored`, {\n      error: error.message,\n    });\n  }\n}\n","/**\n * Tracing surface for the publisher.\n *\n * eventferry deliberately does not depend on `@opentelemetry/api` — instead\n * users wire a thin adapter over their tracing system (OpenTelemetry,\n * Datadog, internal, …). This file defines the minimal contract; an\n * OpenTelemetry adapter is ~10 lines (see the README).\n *\n * The contract follows the **current stable** OpenTelemetry messaging\n * semantic conventions\n * ({@link https://github.com/open-telemetry/semantic-conventions/blob/main/docs/messaging/kafka.md spec}):\n *\n *   - Span name: `\"{topic} publish\"`\n *   - `SpanKind.PRODUCER`\n *   - Required attributes: `messaging.system=kafka`,\n *     `messaging.operation.type=publish`, `messaging.destination.name=<topic>`\n *   - Recommended: `messaging.batch.message_count`, `messaging.kafka.partition`,\n *     `server.address`, `server.port`\n *   - One span per batch (NOT per message — per-message spans cause\n *     cardinality explosion and the spec actively warns against this)\n */\n\n/** Attribute values the spec allows. */\nexport type SpanAttributeValue = string | number | boolean;\n\n/**\n * Minimal span surface the publisher needs. Implementations wrap a\n * tracing-system-specific span; methods MUST never throw out of the\n * publisher's hot path (wrap your own SDK calls in try/catch).\n */\nexport interface SpanLike {\n  setAttribute(key: string, value: SpanAttributeValue): void;\n  setAttributes(attrs: Record<string, SpanAttributeValue>): void;\n  /** OK on success; ERROR on failure. The `message` is the error message. */\n  setStatus(status: { code: \"ok\" | \"error\"; message?: string }): void;\n  /** Attach an exception to the span (OpenTelemetry `recordException`). */\n  recordException(error: Error): void;\n  end(): void;\n}\n\n/**\n * Factory the publisher calls once per `sendBatch` to start a span.\n * Implementations MUST set `SpanKind.PRODUCER` and the messaging semconv\n * attributes on the returned span before returning it.\n */\nexport interface KafkaTracer {\n  /**\n   * Start a publish span.\n   * @param name        Recommended format: `\"{topic} publish\"`.\n   * @param attributes  Initial attributes (the publisher supplies the messaging\n   *                    semconv set: system, destination.name, operation.type,\n   *                    batch.message_count, plus optional kafka.partition and\n   *                    server.address/port).\n   */\n  startPublishSpan(\n    name: string,\n    attributes: Record<string, SpanAttributeValue>,\n  ): SpanLike;\n}\n\n/**\n * No-op tracer. Used when the user does not configure one. Cheap allocation\n * — never touches I/O.\n */\nexport class NoopKafkaTracer implements KafkaTracer {\n  startPublishSpan(): SpanLike {\n    return NOOP_SPAN;\n  }\n}\n\nconst NOOP_SPAN: SpanLike = {\n  setAttribute() {},\n  setAttributes() {},\n  setStatus() {},\n  recordException() {},\n  end() {},\n};\n","import type {\n  Logger,\n  PublishableMessage,\n  Publisher,\n  PublishResult,\n} from \"@eventferry/core\";\nimport { ConfluentDriver } from \"./confluent-driver.js\";\nimport type {\n  DriverKind,\n  KafkaConnectionConfig,\n  KafkaDriver,\n  ProducerBehaviorConfig,\n} from \"./driver.js\";\nimport { KafkaJsDriver } from \"./kafkajs-driver.js\";\nimport { safeHook } from \"./hooks.js\";\nimport type { KafkaPublisherHooks } from \"./hooks.js\";\nimport { NoopKafkaTracer } from \"./tracing.js\";\nimport type { KafkaTracer, SpanLike } from \"./tracing.js\";\n\nexport interface KafkaPublisherOptions\n  extends KafkaConnectionConfig,\n    ProducerBehaviorConfig {\n  /** Which underlying client to use. Default \"kafkajs\". */\n  driver?: DriverKind;\n  /**\n   * Provide a fully custom driver instance instead of the built-ins.\n   * Useful for testing or unsupported clients.\n   */\n  customDriver?: KafkaDriver;\n  /**\n   * Optional structured logger. When set, the publisher routes its own\n   * diagnostics (driver warnings, hook failures) through it. When omitted,\n   * the publisher is silent — only the underlying drivers may still log.\n   */\n  logger?: Logger;\n  /**\n   * Optional lifecycle hooks. Every hook is invoked safely (try/catch +\n   * logged via `logger`) and a misbehaving hook will never break publishing.\n   */\n  hooks?: KafkaPublisherHooks;\n  /**\n   * Optional tracer. When set, `publish()` wraps each batch in a span that\n   * follows the current stable OpenTelemetry messaging semantic conventions.\n   * Use a thin adapter over your tracing SDK (see {@link KafkaTracer}).\n   */\n  tracer?: KafkaTracer;\n}\n\n/**\n * The Publisher the Relay talks to. Wraps a pluggable KafkaDriver and adds\n * dead-letter routing, observability hooks, and OpenTelemetry-shaped publish\n * spans. Works against Kafka and Redpanda identically (Redpanda is Kafka-API\n * compatible).\n */\nexport class KafkaPublisher implements Publisher {\n  private readonly driver: KafkaDriver;\n  private readonly logger: Logger | undefined;\n  private readonly hooks: KafkaPublisherHooks;\n  private readonly tracer: KafkaTracer;\n\n  constructor(opts: KafkaPublisherOptions) {\n    this.logger = opts.logger;\n    this.hooks = opts.hooks ?? {};\n    this.tracer = opts.tracer ?? new NoopKafkaTracer();\n    // Plumb the logger into driver construction so driver-side diagnostics\n    // (e.g. kafkajs unsupported-tuning warnings) route through it too.\n    // Plumb a safe-wrapped onTransactionAbort callback so the driver-level\n    // transaction abort path fans out to the user-supplied hook safely.\n    const onTransactionAbort = this.hooks.onTransactionAbort\n      ? (error: Error) => {\n          void safeHook(this.logger, \"onTransactionAbort\", () =>\n            this.hooks.onTransactionAbort?.(error),\n          );\n        }\n      : undefined;\n    this.driver =\n      opts.customDriver ?? selectDriver({ ...opts, onTransactionAbort });\n  }\n\n  async connect(): Promise<void> {\n    await this.driver.connect();\n    await safeHook(this.logger, \"onConnect\", () => this.hooks.onConnect?.());\n  }\n\n  async disconnect(): Promise<void> {\n    await this.driver.disconnect();\n    await safeHook(this.logger, \"onDisconnect\", () =>\n      this.hooks.onDisconnect?.(),\n    );\n  }\n\n  async publish(messages: PublishableMessage[]): Promise<PublishResult[]> {\n    if (messages.length === 0) return [];\n\n    const span = this.startBatchSpan(messages);\n    let results: PublishResult[];\n    try {\n      results = await this.driver.sendBatch(messages);\n    } catch (err) {\n      // Driver-level throw — every record is a failure attributed to the\n      // batch-level error. Record on the span, fire hook, rethrow.\n      const error = err instanceof Error ? err : new Error(String(err));\n      span.setStatus({ code: \"error\", message: error.message });\n      span.recordException(error);\n      span.end();\n      await safeHook(this.logger, \"onError\", () => this.hooks.onError?.(error));\n      throw err;\n    }\n\n    // Per-record hooks. Walk by index so the original message is available.\n    const byId = new Map(messages.map((m) => [m.recordId, m]));\n    let allOk = true;\n    for (const r of results) {\n      const msg = byId.get(r.recordId);\n      if (!msg) continue;\n      await safeHook(this.logger, \"onPublish\", () =>\n        this.hooks.onPublish?.(r, msg),\n      );\n      if (!r.ok) {\n        allOk = false;\n        const err = r.error ?? new Error(\"publish failed\");\n        await safeHook(this.logger, \"onError\", () =>\n          this.hooks.onError?.(err, msg),\n        );\n      }\n    }\n\n    span.setStatus(allOk ? { code: \"ok\" } : { code: \"error\" });\n    span.end();\n    return results;\n  }\n\n  /**\n   * Send a single dead-lettered message. The message already carries the\n   * DLQ topic (the Relay rewrites it), plus the failure reason as a header.\n   */\n  async publishToDlq(message: PublishableMessage, error: Error): Promise<void> {\n    const dlqMessage: PublishableMessage = {\n      ...message,\n      headers: {\n        ...message.headers,\n        \"dlq-reason\": error.message,\n        // Error class name (e.g. \"KafkaJSProtocolError\", \"RecordTooLargeException\"),\n        // useful for downstream alert routing without parsing the reason string.\n        \"dlq-error-class\": error.name || error.constructor?.name || \"Error\",\n        \"dlq-original-topic\": message.headers[\"original-topic\"] ?? \"\",\n        \"dlq-failed-at\": new Date().toISOString(),\n      },\n    };\n    const [result] = await this.driver.sendBatch([dlqMessage]);\n    if (result && !result.ok) {\n      throw result.error ?? new Error(\"DLQ publish failed\");\n    }\n  }\n\n  /** Whether the configured driver provides atomic (EOS) batch sends. */\n  get transactional(): boolean {\n    return this.driver.transactional;\n  }\n\n  /**\n   * Start a span for the batch following the OTel messaging conventions.\n   *\n   * Multi-topic batches: per the OTel spec, the span name uses the\n   * destination — we pick the FIRST topic in the batch and document the\n   * limitation. Callers that publish heterogeneous batches and care about\n   * per-topic spans should split their batches upstream.\n   */\n  private startBatchSpan(messages: PublishableMessage[]): SpanLike {\n    const topic = messages[0]?.topic ?? \"unknown\";\n    return this.tracer.startPublishSpan(`${topic} publish`, {\n      \"messaging.system\": \"kafka\",\n      \"messaging.operation.type\": \"publish\",\n      \"messaging.destination.name\": topic,\n      \"messaging.batch.message_count\": messages.length,\n    });\n  }\n}\n\nfunction selectDriver(opts: KafkaPublisherOptions): KafkaDriver {\n  const kind = opts.driver ?? \"kafkajs\";\n  switch (kind) {\n    case \"kafkajs\":\n      return new KafkaJsDriver(opts);\n    case \"confluent\":\n      return new ConfluentDriver(opts);\n    default:\n      throw new Error(`Unknown driver \"${kind}\"`);\n  }\n}\n"],"mappings":"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","names":["CODE_TO_KIND","groupByTopic","failedResults"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eventferry/kafka",
-  "version": "3.2.1",
+  "version": "3.3.1",
   "description": "Kafka/Redpanda publisher for @eventferry (kafkajs + confluent drivers)",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -14,7 +14,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "CHANGELOG.md"
   ],
   "keywords": [
     "outbox",
@@ -47,7 +48,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@eventferry/core": "3.2.1"
+    "@eventferry/core": "3.3.1"
   },
   "peerDependencies": {
     "kafkajs": "^2.0.0",
@@ -66,7 +67,7 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@eventferry/core": "3.2.1"
+    "@eventferry/core": "3.3.1"
   },
   "scripts": {
     "build": "tsup",