@autofleet/kafka 0.0.2 → 0.0.3

package/README.md

@@ -35,6 +35,7 @@ pnpm add @autofleet/kafka
 - **Custom Headers** - Attach metadata to messages
 - **Graceful Shutdown** - Automatic cleanup on process termination
 - **Type Safety** - Full TypeScript support
+- **ESM & CommonJS Compatible** - Works in both ESM and CommonJS projects via dynamic imports
 - **Production Ready** - Built with reliability and performance in mind
 
 ## Quick Start
@@ -42,8 +43,8 @@ pnpm add @autofleet/kafka
 ```typescript
 import AfKafka from '@autofleet/kafka';
 
-// Initialize the producer
-const kafka = new AfKafka({
+// Initialize the producer (async factory)
+const kafka = await AfKafka.create({
   brokers: ['localhost:9092'],
   clientId: 'my-service',
 });
@@ -75,7 +76,7 @@ await kafka.disconnect();
 #### Basic Publishing
 
 ```typescript
-const kafka = new AfKafka({
+const kafka = await AfKafka.create({
   brokers: ['localhost:9092', 'localhost:9093'],
   clientId: 'user-service',
 });
@@ -191,7 +192,7 @@ interface KafkaOptions {
 }
 ```
 
-The package uses [@platformatic/kafka](https://www.npmjs.com/package/@platformatic/kafka) with `jsonSerializer` for automatic JSON serialization of message values.
+The package uses [@platformatic/kafka](https://www.npmjs.com/package/@platformatic/kafka) with `stringSerializers` for automatic serialization. The ESM-only `@platformatic/kafka` library is loaded via dynamic imports, ensuring compatibility with both ESM and CommonJS environments.
 
 ## Advanced Features
 
@@ -260,16 +261,18 @@ await kafka.publish('events', data, {
 
 ## API Reference
 
-### `new AfKafka(options)`
+### `AfKafka.create(options): Promise<AfKafka>`
 
-Creates a new Kafka producer instance.
+Creates a new Kafka producer instance using an async factory pattern. This method dynamically imports the ESM-only `@platformatic/kafka` library, making it compatible with both ESM and CommonJS environments.
 
 **Parameters:**
 - `options` - Configuration options (see [Configuration](#configuration))
 
+**Returns:** A Promise that resolves to an `AfKafka` instance
+
 **Example:**
 ```typescript
-const kafka = new AfKafka({
+const kafka = await AfKafka.create({
   brokers: ['localhost:9092'],
   clientId: 'my-service',
 });
@@ -409,7 +412,7 @@ try {
 ### 6. Use Multiple Brokers for High Availability
 
 ```typescript
-const kafka = new AfKafka({
+const kafka = await AfKafka.create({
   brokers: ['kafka1:9092', 'kafka2:9092', 'kafka3:9092'],
   clientId: 'my-service',
 });
@@ -452,8 +455,8 @@ import AfKafka from '@autofleet/kafka';
 describe('MyKafkaService', () => {
   let kafka: AfKafka;
 
-  beforeEach(() => {
-    kafka = new AfKafka({
+  beforeEach(async () => {
+    kafka = await AfKafka.create({
       brokers: ['localhost:9092'],
       clientId: 'test-client',
     });
@@ -489,7 +492,7 @@ KAFKA_SASL_PASSWORD=pass
 Usage:
 
 ```typescript
-const kafka = new AfKafka({
+const kafka = await AfKafka.create({
   brokers: process.env.KAFKA_BROKERS?.split(',') || ['localhost:9092'],
   clientId: process.env.KAFKA_CLIENT_ID || 'default-client',
 });
@@ -552,7 +555,7 @@ try {
 
 ```typescript
 // Use multiple brokers for redundancy
-const kafka = new AfKafka({
+const kafka = await AfKafka.create({
   brokers: ['kafka1:9092', 'kafka2:9092', 'kafka3:9092'],
   clientId: 'my-service',
 });

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["fallbackLogger: LoggerInstanceManager","fallbackLogger","headers: Record<string, string>","result: ProduceResult"],"sources":["../src/logger.ts","../src/kafkaError.ts","../src/consts.ts","../src/index.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\n\n/* eslint-disable no-console */\nconst fallbackLogger: LoggerInstanceManager = {\n  info: (...args: unknown[]) => console.log('[INFO]', ...args),\n  error: (...args: unknown[]) => console.error('[ERROR]', ...args),\n  warn: (...args: unknown[]) => console.warn('[WARN]', ...args),\n  debug: (...args: unknown[]) => console.debug('[DEBUG]', ...args),\n} as LoggerInstanceManager;\n/* eslint-enable no-console */\n\nexport default fallbackLogger;\n","export default class KafkaError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'KafkaError';\n  }\n}\n","export const TIMESTAMP_HEADER = 'x-timestamp';\nexport const CORRELATION_ID_HEADER = 'x-correlation-id';\nexport const SOURCE_HEADER = 'x-source';\n\nexport const DEFAULT_CLIENT_ID = 'autofleet-kafka-producer';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const DEFAULT_RETRY = {\n  retries: 5,\n  initialRetryTime: 300,\n  maxRetryTime: 30000,\n};\n","import type { LoggerInstanceManager } from '@autofleet/logger';\nimport fallbackLogger from './logger';\nimport KafkaError from './kafkaError';\nimport {\n  DEFAULT_CLIENT_ID,\n  TIMESTAMP_HEADER,\n} from './consts';\nimport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n} from './types';\n\ntype Producer = any; // Will be typed at runtime from dynamic import\ntype ProduceResult = any;\n\nexport interface IAfKafka {\n  isConnected: boolean;\n  ping(): Promise<void>;\n  publish<T = unknown>(topic: string, value: T, options?: PublishOptions): Promise<RecordMetadata[]>;\n  publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]>;\n  disconnect(): Promise<void>;\n}\n\nclass AfKafka implements IAfKafka {\n  private producer!: Producer;\n  private readonly logger: LoggerInstanceManager;\n  private _isConnected = false;\n  private gracefulShutdownStarted = false;\n\n  private constructor(options: KafkaOptions, producer: Producer) {\n    this.logger = options.logger ?? fallbackLogger;\n    this.producer = producer;\n\n    this.logger.info('Kafka: Initialized Kafka producer', {\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      brokers: options.brokers,\n    });\n\n    if (!options.dontGracefulShutdown) {\n      this.setupGracefulShutdown();\n    }\n  }\n\n  /**\n   * Create a new Kafka producer instance\n   */\n  static async create(options: KafkaOptions): Promise<AfKafka> {\n    if (!options.brokers || options.brokers.length === 0) {\n      throw new KafkaError('At least one broker is required');\n    }\n\n    // Dynamic import of ESM-only package\n    const { Producer, stringSerializers } = await import('@platformatic/kafka');\n\n    const producer = new Producer({\n      bootstrapBrokers: options.brokers,\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      serializers: stringSerializers,\n    });\n\n    return new AfKafka(options, producer);\n  }\n\n  private setupGracefulShutdown(): void {\n    this.logger.info(`Kafka: [graceful-shutdown] adding graceful shutdown for process.pid ${process.pid}`);\n\n    process.on('SIGTERM', async () => {\n      await this.gracefulShutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.gracefulShutdown('SIGINT');\n    });\n  }\n\n  private async gracefulShutdown(signal: string): Promise<void> {\n    if (this.gracefulShutdownStarted) {\n      return;\n    }\n\n    this.gracefulShutdownStarted = true;\n\n    this.logger.info(`Kafka: [graceful-shutdown] received ${signal}! Disconnecting producer...`);\n\n    try {\n      await this.disconnect();\n      this.logger.info('Kafka: [graceful-shutdown] producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: [graceful-shutdown] error during shutdown', { error });\n      throw error;\n    }\n  }\n\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Ping Kafka brokers to verify connectivity\n   */\n  async ping(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    try {\n      // Fetch metadata to verify connection\n      const metadata = await this.producer.metadata({ topics: [] });\n      this._isConnected = true;\n\n      this.logger.info('Kafka: Successfully connected to cluster', {\n        clusterId: metadata.id,\n        brokers: metadata.brokers.size,\n      });\n    } catch (error) {\n      this.logger.error('Kafka: Failed to connect to brokers', { error });\n      throw new KafkaError(`Failed to connect to Kafka brokers: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Publish a single message to a topic\n   */\n  async publish<T = unknown>(\n    topic: string,\n    value: T,\n    options?: PublishOptions,\n  ): Promise<RecordMetadata[]> {\n    if (!topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    await this.ping();\n\n    try {\n      const headers: Record<string, string> = {\n        [TIMESTAMP_HEADER]: Date.now().toString(),\n        ...options?.headers,\n      };\n\n      const result: ProduceResult = await this.producer.send({\n        messages: [{\n          topic,\n          value: JSON.stringify(value),\n          key: options?.key,\n          partition: options?.partition,\n          headers,\n        }],\n      });\n\n      this.logger.debug(`Kafka: Published message to topic ${topic}`, {\n        topic,\n      });\n\n      // Map ProduceResult to RecordMetadata\n      return [{\n        topic,\n        partition: options?.partition ?? 0,\n        offset: result?.offsets?.[0]?.offset?.toString() ?? '0',\n      }];\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing to topic ${topic}`, { error, value });\n      throw new KafkaError(`Failed to publish to topic ${topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Publish multiple messages in a batch\n   */\n  async publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]> {\n    if (!options.topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    if (!options.messages || options.messages.length === 0) {\n      throw new KafkaError('At least one message is required');\n    }\n\n    await this.ping();\n\n    try {\n      const messages = options.messages.map(msg => ({\n        topic: options.topic,\n        value: JSON.stringify(msg.value),\n        key: msg.key,\n        partition: msg.partition,\n        headers: {\n          [TIMESTAMP_HEADER]: Date.now().toString(),\n          ...msg.headers,\n        },\n      }));\n\n      const result: ProduceResult = await this.producer.send({ messages });\n\n      this.logger.debug(`Kafka: Published ${messages.length} messages to topic ${options.topic}`, {\n        topic: options.topic,\n        count: messages.length,\n      });\n\n      // Map ProduceResult to RecordMetadata array\n      return messages.map((msg, idx) => ({\n        topic: options.topic,\n        partition: msg.partition ?? 0,\n        offset: result?.offsets?.[idx]?.offset?.toString() ?? idx.toString(),\n      }));\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing batch to topic ${options.topic}`, { error });\n      throw new KafkaError(`Failed to publish batch to topic ${options.topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Disconnect the producer and clean up resources\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      this.logger.debug('Kafka: Producer already disconnected');\n      return;\n    }\n\n    this.logger.info('Kafka: Disconnecting producer');\n\n    try {\n      await this.producer.close();\n      this._isConnected = false;\n      this.logger.info('Kafka: Producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: Error disconnecting producer', { error });\n      throw new KafkaError(`Failed to disconnect producer: ${(error as Error).message}`);\n    }\n  }\n}\n\nexport default AfKafka;\nexport { KafkaError };\nexport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["fallbackLogger: LoggerInstanceManager","fallbackLogger","headers: Record<string, string>"],"sources":["../src/logger.ts","../src/kafkaError.ts","../src/consts.ts","../src/index.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\n\n/* eslint-disable no-console */\nconst fallbackLogger: LoggerInstanceManager = {\n  info: (...args: unknown[]) => console.log('[INFO]', ...args),\n  error: (...args: unknown[]) => console.error('[ERROR]', ...args),\n  warn: (...args: unknown[]) => console.warn('[WARN]', ...args),\n  debug: (...args: unknown[]) => console.debug('[DEBUG]', ...args),\n} as LoggerInstanceManager;\n/* eslint-enable no-console */\n\nexport default fallbackLogger;\n","export default class KafkaError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'KafkaError';\n  }\n}\n","export const TIMESTAMP_HEADER = 'x-timestamp';\nexport const CORRELATION_ID_HEADER = 'x-correlation-id';\nexport const SOURCE_HEADER = 'x-source';\n\nexport const DEFAULT_CLIENT_ID = 'autofleet-kafka-producer';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const DEFAULT_RETRY = {\n  retries: 5,\n  initialRetryTime: 300,\n  maxRetryTime: 30000,\n};\n","import type { LoggerInstanceManager } from '@autofleet/logger';\nimport type { Producer } from '@platformatic/kafka/dist/clients/producer/index.ts';\nimport fallbackLogger from './logger';\nimport KafkaError from './kafkaError';\nimport {\n  DEFAULT_CLIENT_ID,\n  TIMESTAMP_HEADER,\n} from './consts';\nimport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n} from './types';\n\nexport interface IAfKafka {\n  isConnected: boolean;\n  ping(): Promise<void>;\n  publish<T = unknown>(topic: string, value: T, options?: PublishOptions): Promise<RecordMetadata[]>;\n  publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]>;\n  disconnect(): Promise<void>;\n}\n\nclass AfKafka implements IAfKafka {\n  private producer!: Producer<string, string, string, string>;\n  private readonly logger: LoggerInstanceManager;\n  private _isConnected = false;\n  private gracefulShutdownStarted = false;\n\n  private constructor(options: KafkaOptions, producer: Producer<string, string, string, string>) {\n    this.logger = options.logger ?? fallbackLogger;\n    this.producer = producer;\n\n    this.logger.info('Kafka: Initialized Kafka producer', {\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      brokers: options.brokers,\n    });\n\n    if (!options.dontGracefulShutdown) {\n      this.setupGracefulShutdown();\n    }\n  }\n\n  /**\n   * Create a new Kafka producer instance\n   */\n  static async create(options: KafkaOptions): Promise<AfKafka> {\n    if (!options.brokers || options.brokers.length === 0) {\n      throw new KafkaError('At least one broker is required');\n    }\n\n    // Dynamic import of ESM-only package\n    const { Producer, stringSerializers } = await import('@platformatic/kafka');\n\n    const producer = new Producer({\n      bootstrapBrokers: options.brokers,\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      serializers: stringSerializers,\n    });\n\n    return new AfKafka(options, producer);\n  }\n\n  private setupGracefulShutdown(): void {\n    this.logger.info(`Kafka: [graceful-shutdown] adding graceful shutdown for process.pid ${process.pid}`);\n\n    process.on('SIGTERM', async () => {\n      await this.gracefulShutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.gracefulShutdown('SIGINT');\n    });\n  }\n\n  private async gracefulShutdown(signal: string): Promise<void> {\n    if (this.gracefulShutdownStarted) {\n      return;\n    }\n\n    this.gracefulShutdownStarted = true;\n\n    this.logger.info(`Kafka: [graceful-shutdown] received ${signal}! Disconnecting producer...`);\n\n    try {\n      await this.disconnect();\n      this.logger.info('Kafka: [graceful-shutdown] producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: [graceful-shutdown] error during shutdown', { error });\n      throw error;\n    }\n  }\n\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Ping Kafka brokers to verify connectivity\n   */\n  async ping(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    try {\n      // Fetch metadata to verify connection\n      const metadata = await this.producer.metadata({ topics: [] });\n      this._isConnected = true;\n\n      this.logger.info('Kafka: Successfully connected to cluster', {\n        clusterId: metadata.id,\n        brokers: metadata.brokers.size,\n      });\n    } catch (error) {\n      this.logger.error('Kafka: Failed to connect to brokers', { error });\n      throw new KafkaError(`Failed to connect to Kafka brokers: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Publish a single message to a topic\n   */\n  async publish<T = unknown>(\n    topic: string,\n    value: T,\n    options?: PublishOptions,\n  ): Promise<RecordMetadata[]> {\n    if (!topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    await this.ping();\n\n    try {\n      const headers: Record<string, string> = {\n        [TIMESTAMP_HEADER]: Date.now().toString(),\n        ...options?.headers,\n      };\n\n      const result = await this.producer.send({\n        messages: [{\n          topic,\n          value: JSON.stringify(value),\n          key: options?.key,\n          partition: options?.partition,\n          headers,\n        }],\n      });\n\n      this.logger.debug(`Kafka: Published message to topic ${topic}`, {\n        topic,\n      });\n\n      // Map ProduceResult to RecordMetadata\n      return [{\n        topic,\n        partition: options?.partition ?? 0,\n        offset: result?.offsets?.[0]?.offset?.toString() ?? '0',\n      }];\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing to topic ${topic}`, { error, value });\n      throw new KafkaError(`Failed to publish to topic ${topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Publish multiple messages in a batch\n   */\n  async publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]> {\n    if (!options.topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    if (!options.messages || options.messages.length === 0) {\n      throw new KafkaError('At least one message is required');\n    }\n\n    await this.ping();\n\n    try {\n      const messages = options.messages.map(msg => ({\n        topic: options.topic,\n        value: JSON.stringify(msg.value),\n        key: msg.key,\n        partition: msg.partition,\n        headers: {\n          [TIMESTAMP_HEADER]: Date.now().toString(),\n          ...msg.headers,\n        },\n      }));\n\n      const result = await this.producer.send({ messages });\n\n      this.logger.debug(`Kafka: Published ${messages.length} messages to topic ${options.topic}`, {\n        topic: options.topic,\n        count: messages.length,\n      });\n\n      // Map ProduceResult to RecordMetadata array\n      return messages.map((msg, idx) => ({\n        topic: options.topic,\n        partition: msg.partition ?? 0,\n        offset: result?.offsets?.[idx]?.offset?.toString() ?? idx.toString(),\n      }));\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing batch to topic ${options.topic}`, { error });\n      throw new KafkaError(`Failed to publish batch to topic ${options.topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Disconnect the producer and clean up resources\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      this.logger.debug('Kafka: Producer already disconnected');\n      return;\n    }\n\n    this.logger.info('Kafka: Disconnecting producer');\n\n    try {\n      await this.producer.close();\n      this._isConnected = false;\n      this.logger.info('Kafka: Producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: Error disconnecting producer', { error });\n      throw new KafkaError(`Failed to disconnect producer: ${(error as Error).message}`);\n    }\n  }\n}\n\nexport default AfKafka;\nexport { KafkaError };\nexport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n};\n"],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["fallbackLogger: LoggerInstanceManager","fallbackLogger","headers: Record<string, string>","result: ProduceResult"],"sources":["../src/logger.ts","../src/kafkaError.ts","../src/consts.ts","../src/index.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\n\n/* eslint-disable no-console */\nconst fallbackLogger: LoggerInstanceManager = {\n  info: (...args: unknown[]) => console.log('[INFO]', ...args),\n  error: (...args: unknown[]) => console.error('[ERROR]', ...args),\n  warn: (...args: unknown[]) => console.warn('[WARN]', ...args),\n  debug: (...args: unknown[]) => console.debug('[DEBUG]', ...args),\n} as LoggerInstanceManager;\n/* eslint-enable no-console */\n\nexport default fallbackLogger;\n","export default class KafkaError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'KafkaError';\n  }\n}\n","export const TIMESTAMP_HEADER = 'x-timestamp';\nexport const CORRELATION_ID_HEADER = 'x-correlation-id';\nexport const SOURCE_HEADER = 'x-source';\n\nexport const DEFAULT_CLIENT_ID = 'autofleet-kafka-producer';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const DEFAULT_RETRY = {\n  retries: 5,\n  initialRetryTime: 300,\n  maxRetryTime: 30000,\n};\n","import type { LoggerInstanceManager } from '@autofleet/logger';\nimport fallbackLogger from './logger';\nimport KafkaError from './kafkaError';\nimport {\n  DEFAULT_CLIENT_ID,\n  TIMESTAMP_HEADER,\n} from './consts';\nimport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n} from './types';\n\ntype Producer = any; // Will be typed at runtime from dynamic import\ntype ProduceResult = any;\n\nexport interface IAfKafka {\n  isConnected: boolean;\n  ping(): Promise<void>;\n  publish<T = unknown>(topic: string, value: T, options?: PublishOptions): Promise<RecordMetadata[]>;\n  publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]>;\n  disconnect(): Promise<void>;\n}\n\nclass AfKafka implements IAfKafka {\n  private producer!: Producer;\n  private readonly logger: LoggerInstanceManager;\n  private _isConnected = false;\n  private gracefulShutdownStarted = false;\n\n  private constructor(options: KafkaOptions, producer: Producer) {\n    this.logger = options.logger ?? fallbackLogger;\n    this.producer = producer;\n\n    this.logger.info('Kafka: Initialized Kafka producer', {\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      brokers: options.brokers,\n    });\n\n    if (!options.dontGracefulShutdown) {\n      this.setupGracefulShutdown();\n    }\n  }\n\n  /**\n   * Create a new Kafka producer instance\n   */\n  static async create(options: KafkaOptions): Promise<AfKafka> {\n    if (!options.brokers || options.brokers.length === 0) {\n      throw new KafkaError('At least one broker is required');\n    }\n\n    // Dynamic import of ESM-only package\n    const { Producer, stringSerializers } = await import('@platformatic/kafka');\n\n    const producer = new Producer({\n      bootstrapBrokers: options.brokers,\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      serializers: stringSerializers,\n    });\n\n    return new AfKafka(options, producer);\n  }\n\n  private setupGracefulShutdown(): void {\n    this.logger.info(`Kafka: [graceful-shutdown] adding graceful shutdown for process.pid ${process.pid}`);\n\n    process.on('SIGTERM', async () => {\n      await this.gracefulShutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.gracefulShutdown('SIGINT');\n    });\n  }\n\n  private async gracefulShutdown(signal: string): Promise<void> {\n    if (this.gracefulShutdownStarted) {\n      return;\n    }\n\n    this.gracefulShutdownStarted = true;\n\n    this.logger.info(`Kafka: [graceful-shutdown] received ${signal}! Disconnecting producer...`);\n\n    try {\n      await this.disconnect();\n      this.logger.info('Kafka: [graceful-shutdown] producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: [graceful-shutdown] error during shutdown', { error });\n      throw error;\n    }\n  }\n\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Ping Kafka brokers to verify connectivity\n   */\n  async ping(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    try {\n      // Fetch metadata to verify connection\n      const metadata = await this.producer.metadata({ topics: [] });\n      this._isConnected = true;\n\n      this.logger.info('Kafka: Successfully connected to cluster', {\n        clusterId: metadata.id,\n        brokers: metadata.brokers.size,\n      });\n    } catch (error) {\n      this.logger.error('Kafka: Failed to connect to brokers', { error });\n      throw new KafkaError(`Failed to connect to Kafka brokers: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Publish a single message to a topic\n   */\n  async publish<T = unknown>(\n    topic: string,\n    value: T,\n    options?: PublishOptions,\n  ): Promise<RecordMetadata[]> {\n    if (!topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    await this.ping();\n\n    try {\n      const headers: Record<string, string> = {\n        [TIMESTAMP_HEADER]: Date.now().toString(),\n        ...options?.headers,\n      };\n\n      const result: ProduceResult = await this.producer.send({\n        messages: [{\n          topic,\n          value: JSON.stringify(value),\n          key: options?.key,\n          partition: options?.partition,\n          headers,\n        }],\n      });\n\n      this.logger.debug(`Kafka: Published message to topic ${topic}`, {\n        topic,\n      });\n\n      // Map ProduceResult to RecordMetadata\n      return [{\n        topic,\n        partition: options?.partition ?? 0,\n        offset: result?.offsets?.[0]?.offset?.toString() ?? '0',\n      }];\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing to topic ${topic}`, { error, value });\n      throw new KafkaError(`Failed to publish to topic ${topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Publish multiple messages in a batch\n   */\n  async publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]> {\n    if (!options.topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    if (!options.messages || options.messages.length === 0) {\n      throw new KafkaError('At least one message is required');\n    }\n\n    await this.ping();\n\n    try {\n      const messages = options.messages.map(msg => ({\n        topic: options.topic,\n        value: JSON.stringify(msg.value),\n        key: msg.key,\n        partition: msg.partition,\n        headers: {\n          [TIMESTAMP_HEADER]: Date.now().toString(),\n          ...msg.headers,\n        },\n      }));\n\n      const result: ProduceResult = await this.producer.send({ messages });\n\n      this.logger.debug(`Kafka: Published ${messages.length} messages to topic ${options.topic}`, {\n        topic: options.topic,\n        count: messages.length,\n      });\n\n      // Map ProduceResult to RecordMetadata array\n      return messages.map((msg, idx) => ({\n        topic: options.topic,\n        partition: msg.partition ?? 0,\n        offset: result?.offsets?.[idx]?.offset?.toString() ?? idx.toString(),\n      }));\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing batch to topic ${options.topic}`, { error });\n      throw new KafkaError(`Failed to publish batch to topic ${options.topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Disconnect the producer and clean up resources\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      this.logger.debug('Kafka: Producer already disconnected');\n      return;\n    }\n\n    this.logger.info('Kafka: Disconnecting producer');\n\n    try {\n      await this.producer.close();\n      this._isConnected = false;\n      this.logger.info('Kafka: Producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: Error disconnecting producer', { error });\n      throw new KafkaError(`Failed to disconnect producer: ${(error as Error).message}`);\n    }\n  }\n}\n\nexport default AfKafka;\nexport { KafkaError };\nexport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["fallbackLogger: LoggerInstanceManager","fallbackLogger","headers: Record<string, string>"],"sources":["../src/logger.ts","../src/kafkaError.ts","../src/consts.ts","../src/index.ts"],"sourcesContent":["import type { LoggerInstanceManager } from '@autofleet/logger';\n\n/* eslint-disable no-console */\nconst fallbackLogger: LoggerInstanceManager = {\n  info: (...args: unknown[]) => console.log('[INFO]', ...args),\n  error: (...args: unknown[]) => console.error('[ERROR]', ...args),\n  warn: (...args: unknown[]) => console.warn('[WARN]', ...args),\n  debug: (...args: unknown[]) => console.debug('[DEBUG]', ...args),\n} as LoggerInstanceManager;\n/* eslint-enable no-console */\n\nexport default fallbackLogger;\n","export default class KafkaError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'KafkaError';\n  }\n}\n","export const TIMESTAMP_HEADER = 'x-timestamp';\nexport const CORRELATION_ID_HEADER = 'x-correlation-id';\nexport const SOURCE_HEADER = 'x-source';\n\nexport const DEFAULT_CLIENT_ID = 'autofleet-kafka-producer';\nexport const DEFAULT_TIMEOUT = 30000; // 30 seconds\nexport const DEFAULT_RETRY = {\n  retries: 5,\n  initialRetryTime: 300,\n  maxRetryTime: 30000,\n};\n","import type { LoggerInstanceManager } from '@autofleet/logger';\nimport type { Producer } from '@platformatic/kafka/dist/clients/producer/index.ts';\nimport fallbackLogger from './logger';\nimport KafkaError from './kafkaError';\nimport {\n  DEFAULT_CLIENT_ID,\n  TIMESTAMP_HEADER,\n} from './consts';\nimport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n} from './types';\n\nexport interface IAfKafka {\n  isConnected: boolean;\n  ping(): Promise<void>;\n  publish<T = unknown>(topic: string, value: T, options?: PublishOptions): Promise<RecordMetadata[]>;\n  publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]>;\n  disconnect(): Promise<void>;\n}\n\nclass AfKafka implements IAfKafka {\n  private producer!: Producer<string, string, string, string>;\n  private readonly logger: LoggerInstanceManager;\n  private _isConnected = false;\n  private gracefulShutdownStarted = false;\n\n  private constructor(options: KafkaOptions, producer: Producer<string, string, string, string>) {\n    this.logger = options.logger ?? fallbackLogger;\n    this.producer = producer;\n\n    this.logger.info('Kafka: Initialized Kafka producer', {\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      brokers: options.brokers,\n    });\n\n    if (!options.dontGracefulShutdown) {\n      this.setupGracefulShutdown();\n    }\n  }\n\n  /**\n   * Create a new Kafka producer instance\n   */\n  static async create(options: KafkaOptions): Promise<AfKafka> {\n    if (!options.brokers || options.brokers.length === 0) {\n      throw new KafkaError('At least one broker is required');\n    }\n\n    // Dynamic import of ESM-only package\n    const { Producer, stringSerializers } = await import('@platformatic/kafka');\n\n    const producer = new Producer({\n      bootstrapBrokers: options.brokers,\n      clientId: options.clientId || DEFAULT_CLIENT_ID,\n      serializers: stringSerializers,\n    });\n\n    return new AfKafka(options, producer);\n  }\n\n  private setupGracefulShutdown(): void {\n    this.logger.info(`Kafka: [graceful-shutdown] adding graceful shutdown for process.pid ${process.pid}`);\n\n    process.on('SIGTERM', async () => {\n      await this.gracefulShutdown('SIGTERM');\n    });\n\n    process.on('SIGINT', async () => {\n      await this.gracefulShutdown('SIGINT');\n    });\n  }\n\n  private async gracefulShutdown(signal: string): Promise<void> {\n    if (this.gracefulShutdownStarted) {\n      return;\n    }\n\n    this.gracefulShutdownStarted = true;\n\n    this.logger.info(`Kafka: [graceful-shutdown] received ${signal}! Disconnecting producer...`);\n\n    try {\n      await this.disconnect();\n      this.logger.info('Kafka: [graceful-shutdown] producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: [graceful-shutdown] error during shutdown', { error });\n      throw error;\n    }\n  }\n\n  get isConnected(): boolean {\n    return this._isConnected;\n  }\n\n  /**\n   * Ping Kafka brokers to verify connectivity\n   */\n  async ping(): Promise<void> {\n    if (this._isConnected) {\n      return;\n    }\n\n    try {\n      // Fetch metadata to verify connection\n      const metadata = await this.producer.metadata({ topics: [] });\n      this._isConnected = true;\n\n      this.logger.info('Kafka: Successfully connected to cluster', {\n        clusterId: metadata.id,\n        brokers: metadata.brokers.size,\n      });\n    } catch (error) {\n      this.logger.error('Kafka: Failed to connect to brokers', { error });\n      throw new KafkaError(`Failed to connect to Kafka brokers: ${(error as Error).message}`);\n    }\n  }\n\n  /**\n   * Publish a single message to a topic\n   */\n  async publish<T = unknown>(\n    topic: string,\n    value: T,\n    options?: PublishOptions,\n  ): Promise<RecordMetadata[]> {\n    if (!topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    await this.ping();\n\n    try {\n      const headers: Record<string, string> = {\n        [TIMESTAMP_HEADER]: Date.now().toString(),\n        ...options?.headers,\n      };\n\n      const result = await this.producer.send({\n        messages: [{\n          topic,\n          value: JSON.stringify(value),\n          key: options?.key,\n          partition: options?.partition,\n          headers,\n        }],\n      });\n\n      this.logger.debug(`Kafka: Published message to topic ${topic}`, {\n        topic,\n      });\n\n      // Map ProduceResult to RecordMetadata\n      return [{\n        topic,\n        partition: options?.partition ?? 0,\n        offset: result?.offsets?.[0]?.offset?.toString() ?? '0',\n      }];\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing to topic ${topic}`, { error, value });\n      throw new KafkaError(`Failed to publish to topic ${topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Publish multiple messages in a batch\n   */\n  async publishBatch(options: PublishBatchOptions): Promise<RecordMetadata[]> {\n    if (!options.topic) {\n      throw new KafkaError('Topic name is required');\n    }\n\n    if (!options.messages || options.messages.length === 0) {\n      throw new KafkaError('At least one message is required');\n    }\n\n    await this.ping();\n\n    try {\n      const messages = options.messages.map(msg => ({\n        topic: options.topic,\n        value: JSON.stringify(msg.value),\n        key: msg.key,\n        partition: msg.partition,\n        headers: {\n          [TIMESTAMP_HEADER]: Date.now().toString(),\n          ...msg.headers,\n        },\n      }));\n\n      const result = await this.producer.send({ messages });\n\n      this.logger.debug(`Kafka: Published ${messages.length} messages to topic ${options.topic}`, {\n        topic: options.topic,\n        count: messages.length,\n      });\n\n      // Map ProduceResult to RecordMetadata array\n      return messages.map((msg, idx) => ({\n        topic: options.topic,\n        partition: msg.partition ?? 0,\n        offset: result?.offsets?.[idx]?.offset?.toString() ?? idx.toString(),\n      }));\n    } catch (error) {\n      const err = error as { message?: string; };\n      this.logger.error(`Kafka: Error publishing batch to topic ${options.topic}`, { error });\n      throw new KafkaError(`Failed to publish batch to topic ${options.topic}: ${err.message || 'Unknown error'}`);\n    }\n  }\n\n  /**\n   * Disconnect the producer and clean up resources\n   */\n  async disconnect(): Promise<void> {\n    if (!this._isConnected) {\n      this.logger.debug('Kafka: Producer already disconnected');\n      return;\n    }\n\n    this.logger.info('Kafka: Disconnecting producer');\n\n    try {\n      await this.producer.close();\n      this._isConnected = false;\n      this.logger.info('Kafka: Producer disconnected successfully');\n    } catch (error) {\n      this.logger.error('Kafka: Error disconnecting producer', { error });\n      throw new KafkaError(`Failed to disconnect producer: ${(error as Error).message}`);\n    }\n  }\n}\n\nexport default AfKafka;\nexport { KafkaError };\nexport type {\n  KafkaOptions,\n  PublishOptions,\n  PublishBatchOptions,\n  RecordMetadata,\n};\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autofleet/kafka",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Internal wrapper for Apache Kafka producer",
   "type": "module",
   "main": "dist/index.js",