@nitra/nats 3.1.3 → 3.2.0

package/README.md

@@ -8,7 +8,7 @@ NATS JetStream helper для Node.js.
 ## Встановлення
 
 ```sh
-yarn add @nitra/nats
+bun add @nitra/nats
 # або
 npm install @nitra/nats
 ```
@@ -96,17 +96,14 @@ console.log('pending for group:', count2)
 ## Як це працює
 
 - **publish(subject, data, consumers?):**
-
   - Перевіряє/створює consumer-ів (один раз за процес).
   - Публікує повідомлення у subject `${stream}.${subject}`.
   - Якщо передати масив consumers — створює кастомні durable consumer-и з кастомними іменами та фільтрами.
 
 - **read(durableName):**
-
   - Читає одне повідомлення з черги для durable consumer (за замовчуванням durable_name = subject).
 
 - **finish():**
-
   - Підтверджує (ack) повідомлення.
 
 - **getPendingCount(durableName):**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nitra/nats",
   "description": "nats helper",
-  "version": "3.1.3",
+  "version": "3.2.0",
   "type": "module",
   "files": [
     "src"
@@ -21,8 +21,8 @@
   "homepage": "https://github.com/nitra/nats",
   "license": "MIT",
   "dependencies": {
-    "@nitra/check-env": "^4.0.0",
-    "@nitra/pino": "^2.3.0",
+    "@nitra/check-env": "^4.1.0",
+    "@nitra/pino": "^2.7.4",
     "nats": "^2.29.3"
   },
   "engines": {

package/src/nats.js

@@ -1,13 +1,26 @@
-import { checkEnv, env } from '@nitra/check-env'
+import { checkEnv } from '@nitra/check-env'
 import { connect, JSONCodec } from 'nats'
-
-checkEnv(['NATS_URL', 'NATS_STREAM'])
+import { env } from 'node:process'
 
 // AckPolicy
 export { AckPolicy } from 'nats'
 
-// Connect to NATS
-const nc = await connect({ servers: env.NATS_URL })
+let nc
+
+// якщо задані демо дані, то використовуємо фейковий NATS
+if (env.NATS_FAKE_DATA) {
+  nc = {
+    jetstream: () => {},
+    jetstreamManager: async () => {
+      Promise.resolve()
+    }
+  }
+} else {
+  checkEnv(['NATS_URL', 'NATS_STREAM'])
+
+  // Connect to NATS
+  nc = await connect({ servers: env.NATS_URL })
+}
 
 // JSONCodec
 export const jc = JSONCodec()

package/src/pending-count.js

@@ -1,5 +1,6 @@
 import { jsm, stream } from './nats.js'
 import { log } from '@nitra/pino'
+import { env } from 'node:process'
 
 /**
  * Повертає кількість непрочитаних (pending) повідомлень для durable consumer.
@@ -7,6 +8,11 @@ import { log } from '@nitra/pino'
  * @returns {Promise<number>} - кількість непрочитаних повідомлень
  */
 export async function getPendingCount(consumer) {
+  // якщо задані демо дані, то завжди повертаємо 0
+  if (env.NATS_FAKE_DATA) {
+    return 0
+  }
+
   try {
     const info = await jsm.consumers.info(stream, consumer)
     return info.num_pending + info.num_ack_pending

package/src/publish.js

@@ -1,6 +1,7 @@
 import { jc, js, stream } from './nats.js'
 import { ensureConsumer } from './consumer.js'
 import { log } from '@nitra/pino'
+import { env } from 'node:process'
 
 /**
  * Публікує повідомлення у JetStream для вказаного subject.
@@ -11,6 +12,11 @@ import { log } from '@nitra/pino'
  * @returns {Promise<void>}
  */
 export async function publish(subject, data, consumers) {
+  // якщо задані демо дані, то ігноримо запис
+  if (env.NATS_FAKE_DATA) {
+    return Promise.resolve()
+  }
+
   // Ensure consumer if not exists
   await ensureConsumer(subject, consumers)
 

package/src/worker.js

@@ -2,6 +2,7 @@ import { js, jc, stream } from './nats.js'
 import { state } from './utils.js'
 import { exit } from 'node:process'
 import { log } from '@nitra/pino'
+import { env } from 'node:process'
 
 /**
  * Зчитує одне повідомлення з JetStream для вказаного consumer-а.
@@ -9,6 +10,12 @@ import { log } from '@nitra/pino'
  * @returns {Promise<object>} - декодовані дані повідомлення
  */
 export async function read(consumer) {
+  // якщо задані демо дані, то повертаємо їх
+  if (env.NATS_FAKE_DATA) {
+    console.log('env.NATS_FAKE_DATA:', env.NATS_FAKE_DATA)
+    return JSON.parse(env.NATS_FAKE_DATA)
+  }
+
   const consumerObj = await js.consumers.get(stream, consumer)
 
   const iter = await consumerObj.fetch({ max_messages: 1, expires: 1000 })