@onebun/nats 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @onebun/nats
+
+NATS and JetStream integration for OneBun framework.
+
+## Installation
+
+```bash
+bun add @onebun/nats
+```
+
+## Features
+
+- **NatsQueueAdapter** - Basic pub/sub messaging (no persistence)
+- **JetStreamQueueAdapter** - Persistent messaging with acknowledgments
+
+## Usage
+
+### Basic NATS (Pub/Sub)
+
+```typescript
+import { OneBunApplication } from '@onebun/core';
+import { NatsQueueAdapter } from '@onebun/nats';
+
+const app = await OneBunApplication.create(AppModule, {
+  queue: {
+    adapter: NatsQueueAdapter,
+    options: {
+      servers: 'nats://localhost:4222',
+    },
+  },
+});
+```
+
+### JetStream (Persistent)
+
+```typescript
+import { OneBunApplication } from '@onebun/core';
+import { JetStreamQueueAdapter } from '@onebun/nats';
+
+const app = await OneBunApplication.create(AppModule, {
+  queue: {
+    adapter: JetStreamQueueAdapter,
+    options: {
+      servers: 'nats://localhost:4222',
+      stream: 'EVENTS',
+      createStream: true,
+      streamConfig: {
+        subjects: ['events.>'],
+        retention: 'limits',
+        maxMsgs: 1000000,
+      },
+    },
+  },
+});
+```
+
+### Service with Queue Handlers
+
+```typescript
+import { Subscribe, Message, OnQueueReady } from '@onebun/core';
+
+export class OrderService {
+  @OnQueueReady()
+  handleReady() {
+    console.log('Connected to NATS');
+  }
+
+  @Subscribe('orders.created')
+  async handleOrderCreated(message: Message<OrderData>) {
+    console.log('New order:', message.data);
+  }
+
+  @Subscribe('orders.*', { ackMode: 'manual', group: 'order-processors' })
+  async handleOrder(message: Message<OrderData>) {
+    try {
+      await this.processOrder(message.data);
+      await message.ack();
+    } catch (error) {
+      await message.nack(true); // requeue
+    }
+  }
+}
+```
+
+## Feature Comparison
+
+| Feature | NatsQueueAdapter | JetStreamQueueAdapter |
+|---------|------------------|----------------------|
+| Pattern subscriptions | Yes | Yes |
+| Consumer groups | Yes | Yes |
+| Persistence | No | Yes |
+| Acknowledgments | No | Yes |
+| Dead Letter Queue | No | Yes |
+| Retry | No | Yes |
+| Delayed messages | No | No |
+| Priority | No | No |
+
+## Configuration Options
+
+### NatsConnectionOptions
+
+```typescript
+interface NatsConnectionOptions {
+  servers: string | string[];  // NATS server URL(s)
+  name?: string;               // Connection name
+  token?: string;              // Auth token
+  user?: string;               // Username
+  pass?: string;               // Password
+  maxReconnectAttempts?: number;
+  reconnectTimeWait?: number;
+  timeout?: number;
+  tls?: boolean;
+}
+```
+
+### JetStreamAdapterOptions
+
+```typescript
+interface JetStreamAdapterOptions extends NatsConnectionOptions {
+  stream: string;              // Stream name
+  createStream?: boolean;      // Create stream if not exists
+  streamConfig?: {
+    subjects?: string[];       // Subjects to store
+    retention?: 'limits' | 'interest' | 'workqueue';
+    maxMsgs?: number;
+    maxBytes?: number;
+    maxAge?: number;
+    storage?: 'file' | 'memory';
+    replicas?: number;
+  };
+  consumerConfig?: {
+    ackWait?: number;          // Ack timeout (nanoseconds)
+    maxDeliver?: number;       // Max delivery attempts
+    maxAckPending?: number;
+  };
+}
+```
+
+## License
+
+LGPL-3.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@onebun/nats",
+  "version": "0.1.0",
+  "description": "NATS and JetStream integration for OneBun framework",
+  "license": "LGPL-3.0",
+  "author": "RemRyahirev",
+  "keywords": [
+    "onebun",
+    "nats",
+    "jetstream",
+    "message-queue",
+    "bun",
+    "typescript",
+    "effect"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RemRyahirev/onebun.git",
+    "directory": "packages/nats"
+  },
+  "bugs": {
+    "url": "https://github.com/RemRyahirev/onebun/issues"
+  },
+  "homepage": "https://github.com/RemRyahirev/onebun/tree/master/packages/nats#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "types": "src/index.ts",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@onebun/core": "workspace:*",
+    "@nats-io/transport-node": "^3.0.0-31",
+    "@nats-io/jetstream": "^3.0.0-31",
+    "effect": "^3.13.10"
+  },
+  "devDependencies": {
+    "bun-types": "^1.2.20"
+  },
+  "engines": {
+    "bun": ">=1.2.9"
+  }
+}

package/src/index.ts

@@ -0,0 +1,26 @@
+/**
+ * NATS and JetStream Module
+ *
+ * Provides queue adapters for NATS pub/sub and JetStream.
+ */
+
+// Types
+export type {
+  NatsConnectionOptions,
+  NatsAdapterOptions,
+  JetStreamAdapterOptions,
+} from './types';
+
+// NATS Client
+export {
+  NatsClient,
+  createNatsClient,
+  type NatsMessage,
+  type NatsSubscriptionHandle,
+} from './nats-client';
+
+// NATS Queue Adapter (pub/sub)
+export { NatsQueueAdapter, createNatsQueueAdapter } from './nats.adapter';
+
+// JetStream Queue Adapter (persistent)
+export { JetStreamQueueAdapter, createJetStreamQueueAdapter } from './jetstream.adapter';