@nitra/nats 3.0.4 → 3.0.5

package/README.md

@@ -48,7 +48,7 @@ import { publish } from '@nitra/nats'
 await publish('project:subject', { id: 1, foo: 'bar' })
 ```
 
-- Stream буде створено автоматично, якщо не існує.
+- Stream і Consumer будуть створені автоматично, якщо не існують.
 - Повідомлення публікується у subject `stream.project:subject`.
 
 ---
@@ -64,7 +64,6 @@ await finish() // підтвердження (ack) повідомлення
 ```
 
 - Якщо не викликати `finish()`, повідомлення буде повернуто у чергу (`nak`) при завершенні процесу або помилці.
-- Stream і consumer створюються автоматично при першому запуску воркера для кожного subject.
 
 ---
 
@@ -77,20 +76,17 @@ const count = await getPendingCount('project:subject')
 console.log('pending:', count)
 ```
 
-- Якщо consumer для subject ще не існує, він буде створений автоматично.
-
 ---
 
 ## Як це працює
 
 - **publish(subject, data):**
 
-  - Перевіряє/створює stream (один раз за процес).
+  - Перевіряє/створює stream і consumer для subject (один раз за процес).
   - Публікує повідомлення у subject `stream.${subject}`.
 
 - **read(subject):**
 
-  - Перевіряє/створює stream і consumer для subject (один раз за процес).
   - Читає одне повідомлення з черги для subject.
 
 - **finish():**
@@ -98,7 +94,7 @@ console.log('pending:', count)
   - Підтверджує (ack) повідомлення.
 
 - **getPendingCount(subject):**
-  - Повертає кількість непрочитаних повідомлень для consumer `durable_${subject}` (створює його, якщо не існує).
+  - Повертає кількість непрочитаних повідомлень для consumer `durable_${subject}`.
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nitra/nats",
   "description": "nats helper",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "type": "module",
   "files": [
     "src"

package/src/consumer.js

@@ -1,11 +1,16 @@
 import { jsm, AckPolicy } from './nats.js'
+import { ensureStream } from './stream.js'
 
 /**
  * Перевіряє наявність або створює durable consumer для subject.
+ * Stream створюється автоматично, якщо не існує.
  * @param {string} subject - subject у форматі project:subject
  * @returns {Promise<void>}
  */
 export async function ensureConsumer(subject) {
+  // створюємо stream якщо не існує
+  await ensureStream(subject)
+
   try {
     await jsm.consumers.info('stream', `durable_${subject}`)
     console.debug('✅ Durable consumer already exists')

package/src/pending-count.js

@@ -1,24 +1,19 @@
 import { jsm } from './nats.js'
-import { ensureConsumer } from './consumer.js'
 import { checkSubjectFormat } from './utils.js'
 
 /**
  * Повертає кількість непрочитаних (pending) повідомлень для durable consumer, пов’язаного з subject.
- * Consumer створюється автоматично, якщо не існує.
  * @param {string} subject - subject у форматі project:subject
  * @returns {Promise<number>} - кількість непрочитаних повідомлень
  */
 export async function getPendingCount(subject) {
   checkSubjectFormat(subject)
 
-  let info
   try {
-    info = await jsm.consumers.info('stream', `durable_${subject}`)
+    const info = await jsm.consumers.info('stream', `durable_${subject}`)
+    return info.num_pending
   } catch {
-    console.debug('consumer not found. create new one.')
-    await ensureConsumer(subject)
-    info = await jsm.consumers.info('stream', `durable_${subject}`)
+    console.error('consumer not found for subject:', subject)
+    return 0
   }
-
-  return info?.num_pending || 0
 }

package/src/publish.js

@@ -1,20 +1,22 @@
 import { client, jc } from './nats.js'
-import { ensureStream } from './stream.js'
+import { ensureConsumer } from './consumer.js'
+import { checkSubjectFormat } from './utils.js'
 
-let streamReady = new Set()
+const consumerReady = new Set()
 
 /**
  * Публікує повідомлення у JetStream для вказаного subject.
- * Stream створюється автоматично, якщо не існує.
+ * Stream і Consumer створюються автоматично, якщо не існують.
  * @param {string} subject - subject у форматі project:subject
  * @param {object} data - дані для публікації
  * @returns {Promise<void>}
  */
 export async function publish(subject, data) {
-  // Ensure stream if not exists
-  if (!streamReady.has(subject)) {
-    await ensureStream(subject)
-    streamReady.add(subject)
+  // Ensure stream and consumer if not exists
+  if (!consumerReady.has(subject)) {
+    checkSubjectFormat(subject)
+    await ensureConsumer(subject)
+    consumerReady.add(subject)
   }
   console.debug('publish', data)
   // Publish message

package/src/stream.js

@@ -1,5 +1,4 @@
 import { jsm } from './nats.js'
-import { checkSubjectFormat } from './utils.js'
 
 /**
  * Перевіряє наявність або створює JetStream stream.
@@ -7,8 +6,6 @@ import { checkSubjectFormat } from './utils.js'
  * @returns {Promise<void>}
  */
 export async function ensureStream(subject) {
-  checkSubjectFormat(subject)
-
   try {
     await jsm.streams.info('stream')
     console.debug('✅ Stream already exists')

package/src/worker.js

@@ -1,20 +1,22 @@
 import { js, jc } from './nats.js'
-import { ensureStream } from './stream.js'
-import { ensureConsumer } from './consumer.js'
 import { state } from './utils.js'
+import { checkSubjectFormat } from './utils.js'
 
 /**
  * Зчитує одне повідомлення з JetStream для вказаного subject.
- * Consumer створюється автоматично, якщо не існує.
  * @param {string} subject - subject у форматі project:subject
  * @returns {Promise<object>} - декодовані дані повідомлення
  */
 export async function read(subject) {
-  // Ensure stream and consumer if not exists
-  await ensureStream(subject)
-  await ensureConsumer(subject)
+  checkSubjectFormat(subject)
 
-  const consumer = await js.consumers.get('stream', `durable_${subject}`)
+  let consumer
+  try {
+    consumer = await js.consumers.get('stream', `durable_${subject}`)
+  } catch (e) {
+    console.error('consumer not found for subject:', subject)
+    return {}
+  }
 
   const iter = await consumer.fetch({ max_messages: 1 })
   for await (const msg of iter) {