nats.do 0.1.0

package/README.md

@@ -0,0 +1,298 @@
+# NATS.do
+
+NATS/JetStream on Cloudflare Durable Objects
+
+NATS.do implements [NATS](https://nats.io/) Core messaging and [JetStream](https://docs.nats.io/nats-concepts/jetstream) persistence using Cloudflare Workers and Durable Objects with SQLite storage. It provides a `nats.js`-compatible API accessible via JSON-RPC 2.0 over HTTP, WebSockets, or Cloudflare Workers Service Bindings.
+
+## Features
+
+- **NATS Core**: Publish/subscribe messaging with subject wildcards (`*`, `>`)
+- **JetStream Streams**: Persistent message storage with configurable retention policies
+- **JetStream Consumers**: Pull and push consumers with acknowledgment tracking
+- **MCP Integration**: Model Context Protocol tools for AI agent access
+- **Edge-Native**: Runs entirely on Cloudflare's global network
+
+## Installation
+
+```bash
+npm install nats.do
+```
+
+## Quick Start
+
+### Basic Pub/Sub
+
+```typescript
+import { StringCodec, JSONCodec } from 'nats.do'
+
+const sc = StringCodec()
+const jc = JSONCodec()
+
+// Publish a message
+nc.publish('orders.new', sc.encode('Hello NATS!'))
+
+// Subscribe with wildcards
+const sub = nc.subscribe('orders.*')
+for await (const msg of sub) {
+  console.log(`Received: ${sc.decode(msg.data)}`)
+}
+
+// Request/Reply pattern
+const response = await nc.request('api.users.get', jc.encode({ id: 123 }))
+console.log(jc.decode(response.data))
+```
+
+### JetStream Streams
+
+```typescript
+// Create a stream
+const jsm = nc.jetstreamManager()
+await jsm.streams.add({
+  name: 'ORDERS',
+  subjects: ['orders.*'],
+  retention: 'workqueue',
+  max_msgs: 10000,
+  max_age: 24 * 60 * 60 * 1_000_000_000, // 24 hours in nanoseconds
+})
+
+// Publish with acknowledgment
+const js = nc.jetstream()
+const ack = await js.publish('orders.new', sc.encode('{"id": 456}'))
+console.log(`Published to ${ack.stream} at seq ${ack.seq}`)
+```
+
+### JetStream Consumers
+
+```typescript
+// Create a durable consumer
+await jsm.consumers.add('ORDERS', {
+  durable_name: 'order-processor',
+  ack_policy: 'explicit',
+  deliver_policy: 'all',
+})
+
+// Fetch messages
+const consumer = await js.consumers.get('ORDERS', 'order-processor')
+const messages = await consumer.fetch({ max_messages: 10 })
+
+for await (const msg of messages) {
+  console.log(`Processing: ${sc.decode(msg.data)}`)
+  msg.ack()
+}
+```
+
+## API Reference
+
+### Core Types
+
+```typescript
+// Connection options
+interface ConnectionOptions {
+  servers: string | string[]
+  name?: string
+  token?: string
+  timeout?: number
+}
+
+// Message
+interface Msg {
+  subject: string
+  data: Uint8Array
+  reply?: string
+  headers?: MsgHdrs
+  respond(data?: Uint8Array): boolean
+}
+
+// Subscription
+interface Subscription extends AsyncIterable<Msg> {
+  getSubject(): string
+  unsubscribe(max?: number): void
+  drain(): Promise<void>
+}
+```
+
+### JetStream Types
+
+```typescript
+// Stream configuration
+interface StreamConfig {
+  name: string
+  subjects: string[]
+  retention?: 'limits' | 'interest' | 'workqueue'
+  storage?: 'file' | 'memory'
+  max_msgs?: number
+  max_bytes?: number
+  max_age?: number // nanoseconds
+  discard?: 'old' | 'new'
+}
+
+// Consumer configuration
+interface ConsumerConfig {
+  name?: string
+  durable_name?: string
+  ack_policy: 'none' | 'all' | 'explicit'
+  deliver_policy?: 'all' | 'last' | 'new' | 'by_start_sequence' | 'by_start_time'
+  filter_subject?: string
+  max_deliver?: number
+  ack_wait?: number // nanoseconds
+}
+
+// Publish acknowledgment
+interface PubAck {
+  stream: string
+  seq: number
+  duplicate?: boolean
+}
+```
+
+### Codecs
+
+```typescript
+import { StringCodec, JSONCodec, Empty } from 'nats.do'
+
+const sc = StringCodec()
+sc.encode('hello')  // Uint8Array
+sc.decode(data)     // string
+
+const jc = JSONCodec<MyType>()
+jc.encode({ key: 'value' })  // Uint8Array
+jc.decode(data)              // MyType
+
+Empty  // Empty Uint8Array for messages without payload
+```
+
+### Subject Wildcards
+
+NATS.do supports NATS subject wildcards for subscriptions:
+
+- `*` matches exactly one token: `orders.*` matches `orders.new` but not `orders.us.new`
+- `>` matches one or more tokens (must be last): `orders.>` matches `orders.new` and `orders.us.new`
+
+```typescript
+import { matchSubject, isValidSubject, isValidWildcard } from 'nats.do/utils'
+
+matchSubject('orders.*', 'orders.new')     // true
+matchSubject('orders.*', 'orders.us.new')  // false
+matchSubject('orders.>', 'orders.us.new')  // true
+```
+
+## Architecture
+
+NATS.do uses three Durable Object classes:
+
+| Durable Object | Scope | Responsibility |
+|---------------|-------|----------------|
+| `NatsCoordinator` | Global singleton | Stream registry, consumer discovery, cluster metadata |
+| `NatsPubSub` | Per region | Core NATS pub/sub, WebSocket connections, request/reply |
+| `StreamDO` | Per stream | Message storage, consumer state, ack tracking, retention |
+
+### RPC Protocol
+
+NATS.do uses JSON-RPC 2.0 for communication:
+
+```typescript
+// Request
+{
+  "jsonrpc": "2.0",
+  "method": "nats.publish",
+  "params": { "subject": "orders.new", "data": "base64..." },
+  "id": 1
+}
+
+// Response
+{
+  "jsonrpc": "2.0",
+  "result": { "success": true },
+  "id": 1
+}
+```
+
+## MCP Tools
+
+NATS.do exposes MCP (Model Context Protocol) tools for AI agent integration:
+
+| Tool | Description |
+|------|-------------|
+| `nats_publish` | Publish a message to a subject |
+| `nats_subscribe` | Subscribe to a subject |
+| `nats_request` | Send a request and wait for response |
+| `jetstream_publish` | Publish to JetStream with acknowledgment |
+| `jetstream_stream_create` | Create a new stream |
+| `jetstream_stream_info` | Get stream information |
+| `jetstream_consumer_create` | Create a consumer |
+| `jetstream_consumer_fetch` | Fetch messages from a consumer |
+
+## Cloudflare Workers Deployment
+
+### wrangler.jsonc
+
+```jsonc
+{
+  "name": "nats.do",
+  "main": "src/index.ts",
+  "compatibility_date": "2024-01-01",
+  "compatibility_flags": ["nodejs_compat"],
+
+  "durable_objects": {
+    "bindings": [
+      { "name": "NATS_COORDINATOR", "class_name": "NatsCoordinator" },
+      { "name": "NATS_PUBSUB", "class_name": "NatsPubSub" },
+      { "name": "STREAM_DO", "class_name": "StreamDO" }
+    ]
+  },
+
+  "migrations": [
+    {
+      "tag": "v1",
+      "new_sqlite_classes": ["NatsCoordinator", "NatsPubSub", "StreamDO"]
+    }
+  ]
+}
+```
+
+### Service Binding Usage
+
+```typescript
+// In another Worker
+export default {
+  async fetch(request: Request, env: Env) {
+    const id = env.NATS_COORDINATOR.idFromName('global')
+    const stub = env.NATS_COORDINATOR.get(id)
+
+    const response = await stub.fetch(new Request('http://internal/rpc', {
+      method: 'POST',
+      body: JSON.stringify({
+        jsonrpc: '2.0',
+        method: 'consumers.list',
+        params: { streamName: 'ORDERS' },
+        id: 1
+      })
+    }))
+
+    return response
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+
+# Type checking
+npm run typecheck
+
+# Local development
+npm run dev
+```
+
+## License
+
+MIT

package/dist/env-Ds3wIkQg.d.cts

@@ -0,0 +1,28 @@
+/**
+ * Cloudflare Workers Environment Type
+ *
+ * Defines the environment bindings for the NatDO worker,
+ * including Durable Object namespace bindings.
+ */
+/**
+ * Environment interface for NatDO worker.
+ * Contains bindings for Durable Objects used in the application.
+ */
+interface Env {
+    /**
+     * Durable Object namespace for NATS coordination.
+     * Manages consumer registry with SQLite storage.
+     */
+    NATS_COORDINATOR: DurableObjectNamespace;
+    /**
+     * Durable Object namespace for NATS publish/subscribe operations.
+     */
+    NATS_PUBSUB: DurableObjectNamespace;
+    /**
+     * Durable Object namespace for stream-specific operations.
+     * Each stream gets its own instance for fetching and acking messages.
+     */
+    STREAM_DO: DurableObjectNamespace;
+}
+
+export type { Env as E };

package/dist/env-Ds3wIkQg.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cloudflare Workers Environment Type
+ *
+ * Defines the environment bindings for the NatDO worker,
+ * including Durable Object namespace bindings.
+ */
+/**
+ * Environment interface for NatDO worker.
+ * Contains bindings for Durable Objects used in the application.
+ */
+interface Env {
+    /**
+     * Durable Object namespace for NATS coordination.
+     * Manages consumer registry with SQLite storage.
+     */
+    NATS_COORDINATOR: DurableObjectNamespace;
+    /**
+     * Durable Object namespace for NATS publish/subscribe operations.
+     */
+    NATS_PUBSUB: DurableObjectNamespace;
+    /**
+     * Durable Object namespace for stream-specific operations.
+     * Each stream gets its own instance for fetching and acking messages.
+     */
+    STREAM_DO: DurableObjectNamespace;
+}
+
+export type { Env as E };

package/dist/index.cjs

@@ -0,0 +1,235 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var cloudflare_workers = require('cloudflare:workers');
+
+// src/durable-objects/nats-coordinator.ts
+
+// src/types/rpc.ts
+var RPC_ERROR_CODES = {
+  // Standard JSON-RPC errors
+  PARSE_ERROR: -32700,
+  METHOD_NOT_FOUND: -32601,
+  INVALID_PARAMS: -32602,
+  CONSUMER_NOT_FOUND: -32002,
+  CONSUMER_EXISTS: -32007};
+function createRpcError(code, message, id, data) {
+  return {
+    jsonrpc: "2.0",
+    error: {
+      code,
+      message,
+      ...data !== void 0
+    },
+    id: id ?? null
+  };
+}
+function createRpcSuccess(result, id) {
+  return {
+    jsonrpc: "2.0",
+    result,
+    id
+  };
+}
+
+// src/durable-objects/nats-coordinator.ts
+var NatsCoordinator = class extends cloudflare_workers.DurableObject {
+  sql;
+  constructor(ctx, env) {
+    super(ctx, env);
+    this.sql = ctx.storage.sql;
+    this.initSchema();
+  }
+  initSchema() {
+    this.sql.exec(`
+      CREATE TABLE IF NOT EXISTS consumers (
+        stream_name TEXT NOT NULL,
+        name TEXT NOT NULL,
+        config TEXT NOT NULL,
+        durable INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        last_active_at INTEGER,
+        PRIMARY KEY (stream_name, name)
+      )
+    `);
+  }
+  async fetch(request) {
+    if (request.method !== "POST") {
+      return new Response("Method not allowed", { status: 405 });
+    }
+    try {
+      const body = await request.json();
+      const { method, params, id } = body;
+      const result = await this.handleRpc(method, params || {}, id);
+      return new Response(JSON.stringify(result), {
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch (error) {
+      const errorResponse = createRpcError(
+        RPC_ERROR_CODES.PARSE_ERROR,
+        "Invalid JSON",
+        null
+      );
+      return new Response(JSON.stringify(errorResponse), {
+        headers: { "Content-Type": "application/json" }
+      });
+    }
+  }
+  async handleRpc(method, params, id) {
+    switch (method) {
+      case "consumers.register":
+        return this.registerConsumer(params, id);
+      case "consumers.get":
+        return this.getConsumer(params, id);
+      case "consumers.delete":
+        return this.deleteConsumer(params, id);
+      case "consumers.list":
+        return this.listConsumers(params, id);
+      case "consumers.updateLastActive":
+        return this.updateConsumerLastActive(params, id);
+      default:
+        return createRpcError(
+          RPC_ERROR_CODES.METHOD_NOT_FOUND,
+          `Method not found: ${method}`,
+          id
+        );
+    }
+  }
+  registerConsumer(params, id) {
+    const streamName = params.streamName;
+    const config = params.config;
+    const consumerName = config.name || config.durable_name;
+    if (!consumerName) {
+      return createRpcError(
+        RPC_ERROR_CODES.INVALID_PARAMS,
+        "Consumer name is required (name or durable_name)",
+        id
+      );
+    }
+    const existing = this.sql.exec("SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?", streamName, consumerName).toArray();
+    if (existing.length > 0) {
+      return createRpcError(
+        RPC_ERROR_CODES.CONSUMER_EXISTS,
+        `Consumer ${consumerName} already exists on stream ${streamName}`,
+        id
+      );
+    }
+    const now = Date.now();
+    const isDurable = !!config.durable_name;
+    this.sql.exec(
+      `INSERT INTO consumers (stream_name, name, config, durable, created_at, last_active_at)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+      streamName,
+      consumerName,
+      JSON.stringify(config),
+      isDurable ? 1 : 0,
+      now,
+      null
+    );
+    const entry = {
+      stream_name: streamName,
+      name: consumerName,
+      config,
+      durable: isDurable,
+      created_at: now,
+      last_active_at: null
+    };
+    return createRpcSuccess(entry, id);
+  }
+  getConsumer(params, id) {
+    const streamName = params.streamName;
+    const consumerName = params.consumerName;
+    const rows = this.sql.exec(
+      "SELECT stream_name, name, config, durable, created_at, last_active_at FROM consumers WHERE stream_name = ? AND name = ?",
+      streamName,
+      consumerName
+    ).toArray();
+    if (rows.length === 0) {
+      return createRpcError(
+        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,
+        `Consumer ${consumerName} not found on stream ${streamName}`,
+        id
+      );
+    }
+    const row = rows[0];
+    const entry = {
+      stream_name: row.stream_name,
+      name: row.name,
+      config: JSON.parse(row.config),
+      durable: row.durable === 1,
+      created_at: row.created_at,
+      last_active_at: row.last_active_at
+    };
+    return createRpcSuccess(entry, id);
+  }
+  deleteConsumer(params, id) {
+    const streamName = params.streamName;
+    const consumerName = params.consumerName;
+    const existing = this.sql.exec("SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?", streamName, consumerName).toArray();
+    if (existing.length === 0) {
+      return createRpcError(
+        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,
+        `Consumer ${consumerName} not found on stream ${streamName}`,
+        id
+      );
+    }
+    this.sql.exec(
+      "DELETE FROM consumers WHERE stream_name = ? AND name = ?",
+      streamName,
+      consumerName
+    );
+    return createRpcSuccess({ success: true }, id);
+  }
+  listConsumers(params, id) {
+    const streamName = params.streamName;
+    const rows = this.sql.exec(
+      "SELECT stream_name, name, config, durable, created_at, last_active_at FROM consumers WHERE stream_name = ? ORDER BY name",
+      streamName
+    ).toArray();
+    const consumers = rows.map((row) => {
+      const r = row;
+      return {
+        stream_name: r.stream_name,
+        name: r.name,
+        config: JSON.parse(r.config),
+        durable: r.durable === 1,
+        created_at: r.created_at,
+        last_active_at: r.last_active_at
+      };
+    });
+    return createRpcSuccess(consumers, id);
+  }
+  updateConsumerLastActive(params, id) {
+    const streamName = params.streamName;
+    const consumerName = params.consumerName;
+    const existing = this.sql.exec("SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?", streamName, consumerName).toArray();
+    if (existing.length === 0) {
+      return createRpcError(
+        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,
+        `Consumer ${consumerName} not found on stream ${streamName}`,
+        id
+      );
+    }
+    const now = Date.now();
+    this.sql.exec(
+      "UPDATE consumers SET last_active_at = ? WHERE stream_name = ? AND name = ?",
+      now,
+      streamName,
+      consumerName
+    );
+    return createRpcSuccess({ last_active_at: now }, id);
+  }
+};
+
+// src/index.ts
+var src_default = {
+  async fetch(_request, _env) {
+    return new Response("NatDO - Not yet implemented", { status: 501 });
+  }
+};
+
+exports.NatsCoordinator = NatsCoordinator;
+exports.default = src_default;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/rpc.ts","../src/durable-objects/nats-coordinator.ts","../src/index.ts"],"names":["DurableObject"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * RPC Types\n *\n * JSON-RPC 2.0 types for NatDO communication.\n */\n\n// Request ID type\nexport type RpcId = string | number\n\n// RPC Request\nexport interface RpcRequest {\n  jsonrpc: '2.0'\n  method: string\n  params?: Record<string, unknown> | unknown[]\n  id: RpcId\n}\n\n// RPC Notification (no id)\nexport interface RpcNotification {\n  jsonrpc: '2.0'\n  method: string\n  params?: Record<string, unknown> | unknown[]\n}\n\n// RPC Error\nexport interface RpcError {\n  code: number\n  message: string\n  data?: unknown\n}\n\n// RPC Response\nexport interface RpcResponse {\n  jsonrpc: '2.0'\n  result?: unknown\n  error?: RpcError\n  id: RpcId | null\n}\n\n// Batch types\nexport type RpcBatchRequest = Array<RpcRequest | RpcNotification>\nexport type RpcBatchResponse = RpcResponse[]\n\n// Standard JSON-RPC 2.0 error codes\nexport const RPC_ERROR_CODES = {\n  // Standard JSON-RPC errors\n  PARSE_ERROR: -32700,\n  INVALID_REQUEST: -32600,\n  METHOD_NOT_FOUND: -32601,\n  INVALID_PARAMS: -32602,\n  INTERNAL_ERROR: -32603,\n\n  // NATS-specific error codes (-32001 to -32099)\n  STREAM_NOT_FOUND: -32001,\n  CONSUMER_NOT_FOUND: -32002,\n  NO_RESPONDERS: -32003,\n  TIMEOUT: -32004,\n  MESSAGE_NOT_FOUND: -32005,\n  STREAM_EXISTS: -32006,\n  CONSUMER_EXISTS: -32007,\n  INVALID_SUBJECT: -32008,\n  PERMISSION_DENIED: -32009,\n  MAX_PAYLOAD_EXCEEDED: -32010,\n  DUPLICATE_MESSAGE: -32011,\n  STREAM_SEALED: -32012,\n  CONSUMER_DELETED: -32013,\n} as const\n\n// Type guard for error responses\nexport function isRpcError(response: RpcResponse): response is RpcResponse & { error: RpcError } {\n  return 'error' in response && response.error !== undefined\n}\n\n// Type guard for success responses\nexport function isRpcSuccess(response: RpcResponse): response is RpcResponse & { result: unknown } {\n  return !isRpcError(response)\n}\n\n// Request ID counter for auto-incrementing IDs\nlet requestIdCounter = 0\n\n// Create RPC request helper\nexport function createRpcRequest(\n  method: string,\n  opts?: { params?: Record<string, unknown> | unknown[]; id?: RpcId }\n): RpcRequest {\n  return {\n    jsonrpc: '2.0',\n    method,\n    ...(opts?.params && { params: opts.params }),\n    id: opts?.id ?? ++requestIdCounter,\n  }\n}\n\n// Create RPC error response helper\nexport function createRpcError(\n  code: number,\n  message: string,\n  id?: RpcId | null,\n  data?: unknown\n): RpcResponse {\n  return {\n    jsonrpc: '2.0',\n    error: {\n      code,\n      message,\n      ...(data !== undefined && { data }),\n    },\n    id: id ?? null,\n  }\n}\n\n// Create RPC success response helper\nexport function createRpcSuccess(result: unknown, id: RpcId): RpcResponse {\n  return {\n    jsonrpc: '2.0',\n    result,\n    id,\n  }\n}\n\n// Reset request ID counter (for testing)\nexport function resetRequestIdCounter(): void {\n  requestIdCounter = 0\n}\n","/**\n * NatsCoordinator Durable Object\n *\n * Central coordinator for NATS/JetStream operations.\n * Manages consumer registry with SQLite storage.\n */\n\nimport { DurableObject } from 'cloudflare:workers'\nimport type { ConsumerConfig } from '../types/jetstream'\nimport { RPC_ERROR_CODES, createRpcError, createRpcSuccess } from '../types/rpc'\nimport type { Env } from '../types/env'\n\n// Consumer registry entry stored in SQLite\ninterface ConsumerEntry {\n  stream_name: string\n  name: string\n  config: ConsumerConfig\n  durable: boolean\n  created_at: number\n  last_active_at: number | null\n}\n\n// RPC request structure\ninterface RpcRequest {\n  jsonrpc: '2.0'\n  method: string\n  params?: Record<string, unknown>\n  id: number | string\n}\n\nexport class NatsCoordinator extends DurableObject<Env> {\n  private sql: SqlStorage\n\n  constructor(ctx: DurableObjectState, env: Env) {\n    super(ctx, env)\n    this.sql = ctx.storage.sql\n\n    // Initialize schema\n    this.initSchema()\n  }\n\n  private initSchema(): void {\n    this.sql.exec(`\n      CREATE TABLE IF NOT EXISTS consumers (\n        stream_name TEXT NOT NULL,\n        name TEXT NOT NULL,\n        config TEXT NOT NULL,\n        durable INTEGER NOT NULL DEFAULT 0,\n        created_at INTEGER NOT NULL,\n        last_active_at INTEGER,\n        PRIMARY KEY (stream_name, name)\n      )\n    `)\n  }\n\n  async fetch(request: Request): Promise<Response> {\n    if (request.method !== 'POST') {\n      return new Response('Method not allowed', { status: 405 })\n    }\n\n    try {\n      const body = await request.json() as RpcRequest\n      const { method, params, id } = body\n\n      const result = await this.handleRpc(method, params || {}, id)\n      return new Response(JSON.stringify(result), {\n        headers: { 'Content-Type': 'application/json' },\n      })\n    } catch (error) {\n      const errorResponse = createRpcError(\n        RPC_ERROR_CODES.PARSE_ERROR,\n        'Invalid JSON',\n        null\n      )\n      return new Response(JSON.stringify(errorResponse), {\n        headers: { 'Content-Type': 'application/json' },\n      })\n    }\n  }\n\n  private async handleRpc(\n    method: string,\n    params: Record<string, unknown>,\n    id: number | string\n  ) {\n    switch (method) {\n      case 'consumers.register':\n        return this.registerConsumer(params, id)\n      case 'consumers.get':\n        return this.getConsumer(params, id)\n      case 'consumers.delete':\n        return this.deleteConsumer(params, id)\n      case 'consumers.list':\n        return this.listConsumers(params, id)\n      case 'consumers.updateLastActive':\n        return this.updateConsumerLastActive(params, id)\n      default:\n        return createRpcError(\n          RPC_ERROR_CODES.METHOD_NOT_FOUND,\n          `Method not found: ${method}`,\n          id\n        )\n    }\n  }\n\n  private registerConsumer(params: Record<string, unknown>, id: number | string) {\n    const streamName = params.streamName as string\n    const config = params.config as ConsumerConfig\n\n    // Validate consumer name\n    const consumerName = config.name || config.durable_name\n    if (!consumerName) {\n      return createRpcError(\n        RPC_ERROR_CODES.INVALID_PARAMS,\n        'Consumer name is required (name or durable_name)',\n        id\n      )\n    }\n\n    // Check if consumer already exists\n    const existing = this.sql\n      .exec('SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?', streamName, consumerName)\n      .toArray()\n\n    if (existing.length > 0) {\n      return createRpcError(\n        RPC_ERROR_CODES.CONSUMER_EXISTS,\n        `Consumer ${consumerName} already exists on stream ${streamName}`,\n        id\n      )\n    }\n\n    const now = Date.now()\n    const isDurable = !!config.durable_name\n\n    // Store the consumer\n    this.sql.exec(\n      `INSERT INTO consumers (stream_name, name, config, durable, created_at, last_active_at)\n       VALUES (?, ?, ?, ?, ?, ?)`,\n      streamName,\n      consumerName,\n      JSON.stringify(config),\n      isDurable ? 1 : 0,\n      now,\n      null\n    )\n\n    const entry: ConsumerEntry = {\n      stream_name: streamName,\n      name: consumerName,\n      config,\n      durable: isDurable,\n      created_at: now,\n      last_active_at: null,\n    }\n\n    return createRpcSuccess(entry, id)\n  }\n\n  private getConsumer(params: Record<string, unknown>, id: number | string) {\n    const streamName = params.streamName as string\n    const consumerName = params.consumerName as string\n\n    const rows = this.sql\n      .exec(\n        'SELECT stream_name, name, config, durable, created_at, last_active_at FROM consumers WHERE stream_name = ? AND name = ?',\n        streamName,\n        consumerName\n      )\n      .toArray()\n\n    if (rows.length === 0) {\n      return createRpcError(\n        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,\n        `Consumer ${consumerName} not found on stream ${streamName}`,\n        id\n      )\n    }\n\n    const row = rows[0] as {\n      stream_name: string\n      name: string\n      config: string\n      durable: number\n      created_at: number\n      last_active_at: number | null\n    }\n\n    const entry: ConsumerEntry = {\n      stream_name: row.stream_name,\n      name: row.name,\n      config: JSON.parse(row.config) as ConsumerConfig,\n      durable: row.durable === 1,\n      created_at: row.created_at,\n      last_active_at: row.last_active_at,\n    }\n\n    return createRpcSuccess(entry, id)\n  }\n\n  private deleteConsumer(params: Record<string, unknown>, id: number | string) {\n    const streamName = params.streamName as string\n    const consumerName = params.consumerName as string\n\n    // Check if consumer exists\n    const existing = this.sql\n      .exec('SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?', streamName, consumerName)\n      .toArray()\n\n    if (existing.length === 0) {\n      return createRpcError(\n        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,\n        `Consumer ${consumerName} not found on stream ${streamName}`,\n        id\n      )\n    }\n\n    this.sql.exec(\n      'DELETE FROM consumers WHERE stream_name = ? AND name = ?',\n      streamName,\n      consumerName\n    )\n\n    return createRpcSuccess({ success: true }, id)\n  }\n\n  private listConsumers(params: Record<string, unknown>, id: number | string) {\n    const streamName = params.streamName as string\n\n    const rows = this.sql\n      .exec(\n        'SELECT stream_name, name, config, durable, created_at, last_active_at FROM consumers WHERE stream_name = ? ORDER BY name',\n        streamName\n      )\n      .toArray()\n\n    const consumers: ConsumerEntry[] = rows.map((row) => {\n      const r = row as {\n        stream_name: string\n        name: string\n        config: string\n        durable: number\n        created_at: number\n        last_active_at: number | null\n      }\n      return {\n        stream_name: r.stream_name,\n        name: r.name,\n        config: JSON.parse(r.config) as ConsumerConfig,\n        durable: r.durable === 1,\n        created_at: r.created_at,\n        last_active_at: r.last_active_at,\n      }\n    })\n\n    return createRpcSuccess(consumers, id)\n  }\n\n  private updateConsumerLastActive(params: Record<string, unknown>, id: number | string) {\n    const streamName = params.streamName as string\n    const consumerName = params.consumerName as string\n\n    // Check if consumer exists\n    const existing = this.sql\n      .exec('SELECT 1 FROM consumers WHERE stream_name = ? AND name = ?', streamName, consumerName)\n      .toArray()\n\n    if (existing.length === 0) {\n      return createRpcError(\n        RPC_ERROR_CODES.CONSUMER_NOT_FOUND,\n        `Consumer ${consumerName} not found on stream ${streamName}`,\n        id\n      )\n    }\n\n    const now = Date.now()\n    this.sql.exec(\n      'UPDATE consumers SET last_active_at = ? WHERE stream_name = ? AND name = ?',\n      now,\n      streamName,\n      consumerName\n    )\n\n    return createRpcSuccess({ last_active_at: now }, id)\n  }\n}\n","/**\n * NatDO - NATS/JetStream on Cloudflare Durable Objects\n *\n * This is the main entry point for the worker.\n */\n\nexport { NatsCoordinator } from './durable-objects/nats-coordinator'\n\nexport default {\n  async fetch(_request: Request, _env: unknown): Promise<Response> {\n    return new Response('NatDO - Not yet implemented', { status: 501 })\n  },\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { DurableObject } from 'cloudflare:workers';
+import { E as Env } from './env-Ds3wIkQg.cjs';
+
+/**
+ * NatsCoordinator Durable Object
+ *
+ * Central coordinator for NATS/JetStream operations.
+ * Manages consumer registry with SQLite storage.
+ */
+
+declare class NatsCoordinator extends DurableObject<Env> {
+    private sql;
+    constructor(ctx: DurableObjectState, env: Env);
+    private initSchema;
+    fetch(request: Request): Promise<Response>;
+    private handleRpc;
+    private registerConsumer;
+    private getConsumer;
+    private deleteConsumer;
+    private listConsumers;
+    private updateConsumerLastActive;
+}
+
+/**
+ * NatDO - NATS/JetStream on Cloudflare Durable Objects
+ *
+ * This is the main entry point for the worker.
+ */
+
+declare const _default: {
+    fetch(_request: Request, _env: unknown): Promise<Response>;
+};
+
+export { NatsCoordinator, _default as default };

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { DurableObject } from 'cloudflare:workers';
+import { E as Env } from './env-Ds3wIkQg.js';
+
+/**
+ * NatsCoordinator Durable Object
+ *
+ * Central coordinator for NATS/JetStream operations.
+ * Manages consumer registry with SQLite storage.
+ */
+
+declare class NatsCoordinator extends DurableObject<Env> {
+    private sql;
+    constructor(ctx: DurableObjectState, env: Env);
+    private initSchema;
+    fetch(request: Request): Promise<Response>;
+    private handleRpc;
+    private registerConsumer;
+    private getConsumer;
+    private deleteConsumer;
+    private listConsumers;
+    private updateConsumerLastActive;
+}
+
+/**
+ * NatDO - NATS/JetStream on Cloudflare Durable Objects
+ *
+ * This is the main entry point for the worker.
+ */
+
+declare const _default: {
+    fetch(_request: Request, _env: unknown): Promise<Response>;
+};
+
+export { NatsCoordinator, _default as default };