@nitra/nats 3.0.7 → 3.1.0

package/README.md

@@ -1,6 +1,6 @@
 # @nitra/nats
 
-NATS JetStream helper для Node.js.  
+NATS JetStream helper для Node.js.
 Простий API для публікації, обробки та моніторингу повідомлень у черзі з автоматичним створенням consumer для кожного subject або кастомного durable consumer.
 
 ---
@@ -19,7 +19,8 @@ npm install @nitra/nats
 
 Пакет використовує такі змінні середовища:
 
-- `NATS_SERVER` — адреса сервера NATS (наприклад, `nats://localhost:4222`)
+- `NATS_URL` — адреса сервера NATS (наприклад, `nats://localhost:4222`)
+- `NATS_STREAM` — назва stream (за замовчуванням `dev`)
 
 ---
 
@@ -54,7 +55,7 @@ await publish('project:subject', { id: 2 }, [
 ```
 
 - Consumer буде створений автоматично, якщо не існує.
-- Повідомлення публікується у subject `topic.project:subject`.
+- Повідомлення публікується у subject `dev.project:subject` (або `${NATS_STREAM}.project:subject`).
 
 ---
 
@@ -97,7 +98,7 @@ console.log('pending for group:', count2)
 - **publish(subject, data, consumers?):**
 
   - Перевіряє/створює consumer-ів (один раз за процес).
-  - Публікує повідомлення у subject `topic.${subject}`.
+  - Публікує повідомлення у subject `${stream}.${subject}`.
   - Якщо передати масив consumers — створює кастомні durable consumer-и з кастомними іменами та фільтрами.
 
 - **read(durableName):**
@@ -115,7 +116,7 @@ console.log('pending for group:', count2)
 
 ## Важливо
 
-- STREAM у NATS завжди один (`nitra`), але subject і durable consumer-и динамічні.
+- STREAM у NATS за замовчуванням `dev` (або значення змінної `NATS_STREAM`), але subject і durable consumer-и динамічні.
 - Для кожного subject або кастомного durable створюється окремий consumer з іменем `durableName`.
 - Пакет розрахований на single-message workflow (одне повідомлення на читання за раз, публікація — необмежена).
 - Для паралельної обробки або кастомних сценаріїв — дивись вихідний код та розширюй під свої задачі.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nitra/nats",
   "description": "nats helper",
-  "version": "3.0.7",
+  "version": "3.1.0",
   "type": "module",
   "files": [
     "src"
@@ -23,7 +23,7 @@
   "dependencies": {
     "@nitra/check-env": "^3.2.0",
     "@nitra/isenv": "^2.0.1",
-    "@nitra/pino": "^1.5.1",
+    "@nitra/pino": "^1.7.1",
     "nats": "^2.29.3"
   },
   "engines": {

package/src/consumer.js

@@ -1,4 +1,4 @@
-import { jsm, AckPolicy } from './nats.js'
+import { jsm, AckPolicy, stream } from './nats.js'
 import { checkSubjectFormat } from './utils.js'
 // import { ensureStream } from './stream.js'
 
@@ -25,7 +25,7 @@ export async function ensureConsumer(subject, consumers = [{ durableName: subjec
   //   await ensureStream()
   // }
 
-  const consumerArr = (await jsm.consumers?.list('nitra')?.next()) || []
+  const consumerArr = (await jsm.consumers?.list(stream)?.next()) || []
   for (const c of consumers) {
     const isExists = consumerArr.some(ca => ca.config.durable_name === c.durableName)
 
@@ -33,10 +33,10 @@ export async function ensureConsumer(subject, consumers = [{ durableName: subjec
     if (isExists) {
       console.debug(`✅ Consumer «${c.durableName}» already exists`)
     } else {
-      await jsm.consumers.add('nitra', {
+      await jsm.consumers.add(stream, {
         durable_name: c.durableName,
         ack_policy: AckPolicy.Explicit, // якщо не підтвердити повідомлення, воно буде повторно надіслано
-        filter_subjects: c.filterSubjects.map(fs => `topic.${fs}`), // якщо не вказати, то consumer буде слухати всі повідомлення зі stream
+        filter_subjects: c.filterSubjects.map(fs => `${stream}.${fs}`), // якщо не вказати, то consumer буде слухати всі повідомлення зі stream
         deliver_policy: 'all' // 'all' - всі непрочитані повідомлення
       })
 

package/src/nats.js

@@ -1,12 +1,12 @@
-import { connect, JSONCodec } from 'nats'
 import { checkEnv, env } from '@nitra/check-env'
+import { connect, JSONCodec } from 'nats'
 // AckPolicy
 export { AckPolicy } from 'nats'
 
-checkEnv(['NATS_SERVER'])
+checkEnv(['NATS_URL'])
 
 // Connect to NATS
-const nc = await connect({ servers: env.NATS_SERVER })
+const nc = await connect({ servers: env.NATS_URL })
 
 // JSONCodec
 export const jc = JSONCodec()
@@ -16,3 +16,6 @@ export const js = nc.jetstream()
 
 // Менеджер JetStream (для створення стрімів, конфігурацій тощо)
 export const jsm = await nc.jetstreamManager()
+
+// Stream name
+export const stream = process.env.NATS_STREAM || 'dev'

package/src/pending-count.js

@@ -1,4 +1,4 @@
-import { jsm } from './nats.js'
+import { jsm, stream } from './nats.js'
 
 /**
  * Повертає кількість непрочитаних (pending) повідомлень для durable consumer.
@@ -7,7 +7,7 @@ import { jsm } from './nats.js'
  */
 export async function getPendingCount(consumer) {
   try {
-    const info = await jsm.consumers.info('nitra', consumer)
+    const info = await jsm.consumers.info(stream, consumer)
     return info.num_pending + info.num_ack_pending
   } catch {
     console.error(`consumer ${consumer} not found`)

package/src/publish.js

@@ -1,4 +1,4 @@
-import { jc, js } from './nats.js'
+import { jc, js, stream } from './nats.js'
 import { ensureConsumer } from './consumer.js'
 
 /**
@@ -15,5 +15,5 @@ export async function publish(subject, data, consumers) {
 
   console.debug('publish:', data)
   // Publish message
-  return js.publish(`topic.${subject}`, jc.encode(data))
+  return js.publish(`${stream}.${subject}`, jc.encode(data))
 }

package/src/stream.js

@@ -1,4 +1,4 @@
-import { jsm } from './nats.js'
+import { jsm, stream } from './nats.js'
 
 /**
  * Перевіряє наявність або створює JetStream stream.
@@ -6,12 +6,12 @@ import { jsm } from './nats.js'
  */
 export async function ensureStream() {
   try {
-    await jsm.streams.info('nitra')
+    await jsm.streams.info(stream)
     console.debug('✅ Stream already exists')
   } catch {
     await jsm.streams.add({
-      name: 'nitra',
-      subjects: ['topic.>'],
+      name: stream,
+      subjects: [`${stream}.>`],
       retention: 'interest', // зберігає повідомлення поки є consumers або поки всі повідомлення не будуть прочитані
       replicas: 1, // кількість реплік у кластері TODO: проговорити кількість реплік
       storage: 'file' //'memory' TODO: проговорити які параметри потрібні для кластера

package/src/worker.js

@@ -1,4 +1,4 @@
-import { js, jc } from './nats.js'
+import { js, jc, stream } from './nats.js'
 import { state } from './utils.js'
 
 /**
@@ -7,7 +7,7 @@ import { state } from './utils.js'
  * @returns {Promise<object>} - декодовані дані повідомлення
  */
 export async function read(consumer) {
-  const consumerObj = await js.consumers.get('nitra', consumer)
+  const consumerObj = await js.consumers.get(stream, consumer)
 
   const iter = await consumerObj.fetch({ max_messages: 1, expires: 1000 })
   for await (const msg of iter) {