nats.do 0.1.0

package/dist/utils.cjs

@@ -0,0 +1,362 @@
+'use strict';
+
+// src/utils/subject-matcher.ts
+var VALID_TOKEN_CHARS = /^[a-zA-Z0-9_-]+$/;
+var SINGLE_WILDCARD = "*";
+var MULTI_WILDCARD = ">";
+var TOKEN_SEPARATOR = ".";
+function tokenizeSubject(subject) {
+  return subject.split(TOKEN_SEPARATOR);
+}
+function parseSubject(subject) {
+  const tokens = tokenizeSubject(subject);
+  return {
+    tokens,
+    tokenCount: tokens.length,
+    hasWildcard: tokens.includes(SINGLE_WILDCARD),
+    hasGreater: tokens.includes(MULTI_WILDCARD)
+  };
+}
+function isValidSubject(subject) {
+  if (!subject || subject.length === 0) {
+    return false;
+  }
+  if (subject.includes("\0")) {
+    return false;
+  }
+  if (subject.includes(" ")) {
+    return false;
+  }
+  if (subject.startsWith(TOKEN_SEPARATOR) || subject.endsWith(TOKEN_SEPARATOR)) {
+    return false;
+  }
+  if (subject.includes("..")) {
+    return false;
+  }
+  const tokens = tokenizeSubject(subject);
+  for (const token of tokens) {
+    if (token.length === 0) {
+      return false;
+    }
+    if (token === SINGLE_WILDCARD || token === MULTI_WILDCARD) {
+      return false;
+    }
+    if (!VALID_TOKEN_CHARS.test(token)) {
+      return false;
+    }
+  }
+  return true;
+}
+function isValidWildcard(pattern) {
+  if (!pattern || pattern.length === 0) {
+    return false;
+  }
+  if (pattern.includes(" ")) {
+    return false;
+  }
+  if (pattern.startsWith(TOKEN_SEPARATOR) || pattern.endsWith(TOKEN_SEPARATOR)) {
+    return false;
+  }
+  if (pattern.includes("..")) {
+    return false;
+  }
+  const tokens = tokenizeSubject(pattern);
+  let foundGreater = false;
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    if (token.length === 0) {
+      return false;
+    }
+    if (foundGreater) {
+      return false;
+    }
+    if (token === MULTI_WILDCARD) {
+      foundGreater = true;
+      continue;
+    }
+    if (token === SINGLE_WILDCARD) {
+      continue;
+    }
+    if (token.includes(SINGLE_WILDCARD) || token.includes(MULTI_WILDCARD)) {
+      return false;
+    }
+    if (!VALID_TOKEN_CHARS.test(token)) {
+      return false;
+    }
+  }
+  return true;
+}
+function matchSubject(pattern, subject) {
+  if (!pattern || !subject) {
+    return false;
+  }
+  const patternTokens = tokenizeSubject(pattern);
+  const subjectTokens = tokenizeSubject(subject);
+  let patternIdx = 0;
+  let subjectIdx = 0;
+  while (patternIdx < patternTokens.length && subjectIdx < subjectTokens.length) {
+    const patternToken = patternTokens[patternIdx];
+    const subjectToken = subjectTokens[subjectIdx];
+    if (patternToken === MULTI_WILDCARD) {
+      return subjectIdx < subjectTokens.length;
+    }
+    if (patternToken === SINGLE_WILDCARD) {
+      patternIdx++;
+      subjectIdx++;
+      continue;
+    }
+    if (patternToken !== subjectToken) {
+      return false;
+    }
+    patternIdx++;
+    subjectIdx++;
+  }
+  if (patternIdx < patternTokens.length) {
+    if (patternTokens[patternIdx] === MULTI_WILDCARD && patternIdx === patternTokens.length - 1) {
+      return false;
+    }
+    return false;
+  }
+  if (subjectIdx < subjectTokens.length) {
+    return false;
+  }
+  return true;
+}
+function subjectToRegex(pattern) {
+  const tokens = tokenizeSubject(pattern);
+  const regexParts = [];
+  for (const token of tokens) {
+    if (token === SINGLE_WILDCARD) {
+      regexParts.push("[^.]+");
+    } else if (token === MULTI_WILDCARD) {
+      regexParts.push(".+");
+    } else {
+      regexParts.push(escapeRegex(token));
+    }
+  }
+  return new RegExp(`^${regexParts.join("\\.")}$`);
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/utils/nuid.ts
+var DIGITS = "0123456789abcdefghijklmnopqrstuvwxyz";
+var BASE = 36;
+var PREFIX_LENGTH = 12;
+var SEQ_LENGTH = 10;
+var MAX_SEQ = Math.pow(BASE, SEQ_LENGTH);
+var NUID = class {
+  prefix;
+  seq;
+  inc;
+  constructor() {
+    this.prefix = this.randomPrefix();
+    this.seq = Math.floor(Math.random() * MAX_SEQ);
+    this.inc = Math.floor(Math.random() * 33) + 22;
+  }
+  /**
+   * Generate the next NUID
+   */
+  next() {
+    this.seq += this.inc;
+    if (this.seq >= MAX_SEQ) {
+      this.prefix = this.randomPrefix();
+      this.seq = Math.floor(Math.random() * MAX_SEQ);
+    }
+    return this.prefix + this.formatSeq(this.seq);
+  }
+  /**
+   * Generate a random prefix
+   */
+  randomPrefix() {
+    const bytes = new Uint8Array(PREFIX_LENGTH);
+    crypto.getRandomValues(bytes);
+    let result = "";
+    for (let i = 0; i < PREFIX_LENGTH; i++) {
+      result += DIGITS[bytes[i] % BASE];
+    }
+    return result;
+  }
+  /**
+   * Format sequence number as fixed-length base36
+   */
+  formatSeq(n) {
+    let result = "";
+    for (let i = 0; i < SEQ_LENGTH; i++) {
+      result = DIGITS[n % BASE] + result;
+      n = Math.floor(n / BASE);
+    }
+    return result;
+  }
+  /**
+   * Reset with new random state
+   */
+  reset() {
+    this.prefix = this.randomPrefix();
+    this.seq = Math.floor(Math.random() * MAX_SEQ);
+    this.inc = Math.floor(Math.random() * 33) + 22;
+  }
+};
+var globalNuid = new NUID();
+function nuid() {
+  return globalNuid.next();
+}
+function createInbox(prefix = "_INBOX") {
+  return `${prefix}.${nuid()}`;
+}
+
+// src/utils/errors.ts
+var NatsError = class extends Error {
+  code;
+  name = "NatsError";
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var JetStreamError = class extends NatsError {
+  name = "JetStreamError";
+  stream;
+  consumer;
+  constructor(message, code, opts) {
+    super(message, code);
+    this.stream = opts?.stream;
+    this.consumer = opts?.consumer;
+  }
+};
+var TimeoutError = class extends NatsError {
+  name = "TimeoutError";
+  timeout;
+  constructor(timeout, message) {
+    super(message || `Operation timed out after ${timeout}ms`, "TIMEOUT");
+    this.timeout = timeout;
+  }
+};
+var NoRespondersError = class extends NatsError {
+  name = "NoRespondersError";
+  subject;
+  constructor(subject) {
+    super(`No responders for subject "${subject}"`, "NO_RESPONDERS");
+    this.subject = subject;
+  }
+};
+var ConnectionError = class extends NatsError {
+  name = "ConnectionError";
+  constructor(message) {
+    super(message, "CONNECTION_ERROR");
+  }
+};
+var PermissionError = class extends NatsError {
+  name = "PermissionError";
+  operation;
+  subject;
+  constructor(message, opts) {
+    super(message, "PERMISSION_DENIED");
+    this.operation = opts?.operation;
+    this.subject = opts?.subject;
+  }
+};
+var StreamNotFoundError = class extends JetStreamError {
+  name = "StreamNotFoundError";
+  constructor(stream) {
+    super(`Stream "${stream}" not found`, "STREAM_NOT_FOUND", { stream });
+  }
+};
+var ConsumerNotFoundError = class extends JetStreamError {
+  name = "ConsumerNotFoundError";
+  constructor(stream, consumer) {
+    super(
+      `Consumer "${consumer}" not found on stream "${stream}"`,
+      "CONSUMER_NOT_FOUND",
+      { stream, consumer }
+    );
+  }
+};
+var MessageNotFoundError = class extends JetStreamError {
+  name = "MessageNotFoundError";
+  seq;
+  constructor(stream, seq) {
+    super(`Message ${seq} not found in stream "${stream}"`, "MESSAGE_NOT_FOUND", {
+      stream
+    });
+    this.seq = seq;
+  }
+};
+var StreamExistsError = class extends JetStreamError {
+  name = "StreamExistsError";
+  constructor(stream) {
+    super(`Stream "${stream}" already exists`, "STREAM_EXISTS", { stream });
+  }
+};
+var ConsumerExistsError = class extends JetStreamError {
+  name = "ConsumerExistsError";
+  constructor(stream, consumer) {
+    super(
+      `Consumer "${consumer}" already exists on stream "${stream}"`,
+      "CONSUMER_EXISTS",
+      { stream, consumer }
+    );
+  }
+};
+var InvalidSubjectError = class extends NatsError {
+  name = "InvalidSubjectError";
+  subject;
+  constructor(subject) {
+    super(`Invalid subject: "${subject}"`, "INVALID_SUBJECT");
+    this.subject = subject;
+  }
+};
+var MaxPayloadError = class extends NatsError {
+  name = "MaxPayloadError";
+  size;
+  maxSize;
+  constructor(size, maxSize) {
+    super(
+      `Message size ${size} exceeds maximum allowed ${maxSize}`,
+      "MAX_PAYLOAD_EXCEEDED"
+    );
+    this.size = size;
+    this.maxSize = maxSize;
+  }
+};
+var ErrorCodes = {
+  TIMEOUT: "TIMEOUT",
+  NO_RESPONDERS: "NO_RESPONDERS",
+  CONNECTION_ERROR: "CONNECTION_ERROR",
+  PERMISSION_DENIED: "PERMISSION_DENIED",
+  STREAM_NOT_FOUND: "STREAM_NOT_FOUND",
+  CONSUMER_NOT_FOUND: "CONSUMER_NOT_FOUND",
+  MESSAGE_NOT_FOUND: "MESSAGE_NOT_FOUND",
+  STREAM_EXISTS: "STREAM_EXISTS",
+  CONSUMER_EXISTS: "CONSUMER_EXISTS",
+  INVALID_SUBJECT: "INVALID_SUBJECT",
+  MAX_PAYLOAD_EXCEEDED: "MAX_PAYLOAD_EXCEEDED"
+};
+
+exports.ConnectionError = ConnectionError;
+exports.ConsumerExistsError = ConsumerExistsError;
+exports.ConsumerNotFoundError = ConsumerNotFoundError;
+exports.ErrorCodes = ErrorCodes;
+exports.InvalidSubjectError = InvalidSubjectError;
+exports.JetStreamError = JetStreamError;
+exports.MaxPayloadError = MaxPayloadError;
+exports.MessageNotFoundError = MessageNotFoundError;
+exports.NUID = NUID;
+exports.NatsError = NatsError;
+exports.NoRespondersError = NoRespondersError;
+exports.PermissionError = PermissionError;
+exports.StreamExistsError = StreamExistsError;
+exports.StreamNotFoundError = StreamNotFoundError;
+exports.TimeoutError = TimeoutError;
+exports.createInbox = createInbox;
+exports.isValidSubject = isValidSubject;
+exports.isValidWildcard = isValidWildcard;
+exports.matchSubject = matchSubject;
+exports.nuid = nuid;
+exports.parseSubject = parseSubject;
+exports.subjectToRegex = subjectToRegex;
+exports.tokenizeSubject = tokenizeSubject;
+//# sourceMappingURL=utils.cjs.map
+//# sourceMappingURL=utils.cjs.map

package/dist/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/subject-matcher.ts","../src/utils/nuid.ts","../src/utils/errors.ts"],"names":[],"mappings":"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","file":"utils.cjs","sourcesContent":["/**\n * Subject Wildcard Matcher\n *\n * Implements NATS subject pattern matching with wildcards:\n *   * (asterisk) - matches exactly one token\n *   > (greater than) - matches one or more tokens (must be last)\n */\n\n// Valid characters for subject tokens (excluding wildcards)\nconst VALID_TOKEN_CHARS = /^[a-zA-Z0-9_-]+$/\n\n// Wildcard characters\nconst SINGLE_WILDCARD = '*'\nconst MULTI_WILDCARD = '>'\nconst TOKEN_SEPARATOR = '.'\n\n/**\n * Tokenize a subject string into an array of tokens\n */\nexport function tokenizeSubject(subject: string): string[] {\n  return subject.split(TOKEN_SEPARATOR)\n}\n\n/**\n * Parse a subject and return metadata about it\n */\nexport interface ParsedSubject {\n  tokens: string[]\n  tokenCount: number\n  hasWildcard: boolean\n  hasGreater: boolean\n}\n\nexport function parseSubject(subject: string): ParsedSubject {\n  const tokens = tokenizeSubject(subject)\n  return {\n    tokens,\n    tokenCount: tokens.length,\n    hasWildcard: tokens.includes(SINGLE_WILDCARD),\n    hasGreater: tokens.includes(MULTI_WILDCARD),\n  }\n}\n\n/**\n * Check if a subject (not pattern) is valid\n * Subjects cannot contain wildcards\n */\nexport function isValidSubject(subject: string): boolean {\n  if (!subject || subject.length === 0) {\n    return false\n  }\n\n  // Check for null bytes\n  if (subject.includes('\\x00')) {\n    return false\n  }\n\n  // Check for spaces\n  if (subject.includes(' ')) {\n    return false\n  }\n\n  // Check for leading/trailing dots\n  if (subject.startsWith(TOKEN_SEPARATOR) || subject.endsWith(TOKEN_SEPARATOR)) {\n    return false\n  }\n\n  // Check for double dots\n  if (subject.includes('..')) {\n    return false\n  }\n\n  const tokens = tokenizeSubject(subject)\n\n  for (const token of tokens) {\n    // Empty tokens (from double dots) are invalid\n    if (token.length === 0) {\n      return false\n    }\n\n    // Wildcards are not allowed in plain subjects\n    if (token === SINGLE_WILDCARD || token === MULTI_WILDCARD) {\n      return false\n    }\n\n    // Check for valid characters\n    if (!VALID_TOKEN_CHARS.test(token)) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/**\n * Check if a wildcard pattern is valid\n */\nexport function isValidWildcard(pattern: string): boolean {\n  if (!pattern || pattern.length === 0) {\n    return false\n  }\n\n  // Check for spaces\n  if (pattern.includes(' ')) {\n    return false\n  }\n\n  // Check for leading/trailing dots\n  if (pattern.startsWith(TOKEN_SEPARATOR) || pattern.endsWith(TOKEN_SEPARATOR)) {\n    return false\n  }\n\n  // Check for double dots\n  if (pattern.includes('..')) {\n    return false\n  }\n\n  const tokens = tokenizeSubject(pattern)\n  let foundGreater = false\n\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i]\n\n    // Empty tokens are invalid\n    if (token.length === 0) {\n      return false\n    }\n\n    // > must be the last token\n    if (foundGreater) {\n      return false\n    }\n\n    if (token === MULTI_WILDCARD) {\n      foundGreater = true\n      continue\n    }\n\n    if (token === SINGLE_WILDCARD) {\n      continue\n    }\n\n    // Check for partial wildcards (e.g., \"foo*\" or \"*foo\")\n    if (token.includes(SINGLE_WILDCARD) || token.includes(MULTI_WILDCARD)) {\n      return false\n    }\n\n    // Check for valid characters\n    if (!VALID_TOKEN_CHARS.test(token)) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/**\n * Match a subject against a pattern\n * Pattern can contain wildcards (* and >)\n * Subject must be a plain subject (no wildcards)\n */\nexport function matchSubject(pattern: string, subject: string): boolean {\n  if (!pattern || !subject) {\n    return false\n  }\n\n  const patternTokens = tokenizeSubject(pattern)\n  const subjectTokens = tokenizeSubject(subject)\n\n  let patternIdx = 0\n  let subjectIdx = 0\n\n  while (patternIdx < patternTokens.length && subjectIdx < subjectTokens.length) {\n    const patternToken = patternTokens[patternIdx]\n    const subjectToken = subjectTokens[subjectIdx]\n\n    if (patternToken === MULTI_WILDCARD) {\n      // > must be last token and matches one or more remaining tokens\n      return subjectIdx < subjectTokens.length\n    }\n\n    if (patternToken === SINGLE_WILDCARD) {\n      // * matches exactly one token\n      patternIdx++\n      subjectIdx++\n      continue\n    }\n\n    // Exact match required\n    if (patternToken !== subjectToken) {\n      return false\n    }\n\n    patternIdx++\n    subjectIdx++\n  }\n\n  // Check if we consumed all tokens\n  if (patternIdx < patternTokens.length) {\n    // Pattern has remaining tokens - only valid if it's just >\n    if (patternTokens[patternIdx] === MULTI_WILDCARD && patternIdx === patternTokens.length - 1) {\n      // > requires at least one more subject token, which we don't have\n      return false\n    }\n    return false\n  }\n\n  if (subjectIdx < subjectTokens.length) {\n    // Subject has remaining tokens but pattern doesn't\n    return false\n  }\n\n  return true\n}\n\n/**\n * Convert a subject pattern to a RegExp\n * Useful for filtering subjects in bulk\n */\nexport function subjectToRegex(pattern: string): RegExp {\n  const tokens = tokenizeSubject(pattern)\n  const regexParts: string[] = []\n\n  for (const token of tokens) {\n    if (token === SINGLE_WILDCARD) {\n      // * matches one token (anything except dots)\n      regexParts.push('[^.]+')\n    } else if (token === MULTI_WILDCARD) {\n      // > matches one or more tokens (rest of subject)\n      regexParts.push('.+')\n    } else {\n      // Escape regex special characters\n      regexParts.push(escapeRegex(token))\n    }\n  }\n\n  return new RegExp(`^${regexParts.join('\\\\.')}$`)\n}\n\n/**\n * Escape special regex characters\n */\nfunction escapeRegex(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n}\n","/**\n * NUID Generator\n *\n * Generates unique identifiers compatible with NATS NUIDs.\n * Format: 22 characters using base36 alphabet.\n */\n\nconst DIGITS = '0123456789abcdefghijklmnopqrstuvwxyz'\nconst BASE = 36\nconst PREFIX_LENGTH = 12\nconst SEQ_LENGTH = 10\nconst MAX_SEQ = Math.pow(BASE, SEQ_LENGTH)\n\n/**\n * NUID generator class\n */\nexport class NUID {\n  private prefix: string\n  private seq: number\n  private inc: number\n\n  constructor() {\n    this.prefix = this.randomPrefix()\n    this.seq = Math.floor(Math.random() * MAX_SEQ)\n    this.inc = Math.floor(Math.random() * 33) + 22 // Random increment between 22-54\n  }\n\n  /**\n   * Generate the next NUID\n   */\n  next(): string {\n    this.seq += this.inc\n    if (this.seq >= MAX_SEQ) {\n      this.prefix = this.randomPrefix()\n      this.seq = Math.floor(Math.random() * MAX_SEQ)\n    }\n    return this.prefix + this.formatSeq(this.seq)\n  }\n\n  /**\n   * Generate a random prefix\n   */\n  private randomPrefix(): string {\n    const bytes = new Uint8Array(PREFIX_LENGTH)\n    crypto.getRandomValues(bytes)\n    let result = ''\n    for (let i = 0; i < PREFIX_LENGTH; i++) {\n      result += DIGITS[bytes[i] % BASE]\n    }\n    return result\n  }\n\n  /**\n   * Format sequence number as fixed-length base36\n   */\n  private formatSeq(n: number): string {\n    let result = ''\n    for (let i = 0; i < SEQ_LENGTH; i++) {\n      result = DIGITS[n % BASE] + result\n      n = Math.floor(n / BASE)\n    }\n    return result\n  }\n\n  /**\n   * Reset with new random state\n   */\n  reset(): void {\n    this.prefix = this.randomPrefix()\n    this.seq = Math.floor(Math.random() * MAX_SEQ)\n    this.inc = Math.floor(Math.random() * 33) + 22\n  }\n}\n\n// Global instance for convenience\nconst globalNuid = new NUID()\n\n/**\n * Generate the next NUID using global instance\n */\nexport function nuid(): string {\n  return globalNuid.next()\n}\n\n/**\n * Create a new inbox subject\n */\nexport function createInbox(prefix = '_INBOX'): string {\n  return `${prefix}.${nuid()}`\n}\n","/**\n * Error Hierarchy\n *\n * NATS-compatible error types for NatDO.\n */\n\n/**\n * Base NATS error\n */\nexport class NatsError extends Error {\n  readonly code: string\n  override readonly name: string = 'NatsError'\n\n  constructor(message: string, code: string) {\n    super(message)\n    this.code = code\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n\n/**\n * JetStream-specific error\n */\nexport class JetStreamError extends NatsError {\n  override readonly name: string = 'JetStreamError'\n  readonly stream?: string\n  readonly consumer?: string\n\n  constructor(\n    message: string,\n    code: string,\n    opts?: { stream?: string; consumer?: string }\n  ) {\n    super(message, code)\n    this.stream = opts?.stream\n    this.consumer = opts?.consumer\n  }\n}\n\n/**\n * Timeout error\n */\nexport class TimeoutError extends NatsError {\n  override readonly name = 'TimeoutError'\n  readonly timeout: number\n\n  constructor(timeout: number, message?: string) {\n    super(message || `Operation timed out after ${timeout}ms`, 'TIMEOUT')\n    this.timeout = timeout\n  }\n}\n\n/**\n * No responders error\n */\nexport class NoRespondersError extends NatsError {\n  override readonly name = 'NoRespondersError'\n  readonly subject: string\n\n  constructor(subject: string) {\n    super(`No responders for subject \"${subject}\"`, 'NO_RESPONDERS')\n    this.subject = subject\n  }\n}\n\n/**\n * Connection error\n */\nexport class ConnectionError extends NatsError {\n  override readonly name = 'ConnectionError'\n\n  constructor(message: string) {\n    super(message, 'CONNECTION_ERROR')\n  }\n}\n\n/**\n * Permission error\n */\nexport class PermissionError extends NatsError {\n  override readonly name = 'PermissionError'\n  readonly operation?: string\n  readonly subject?: string\n\n  constructor(message: string, opts?: { operation?: string; subject?: string }) {\n    super(message, 'PERMISSION_DENIED')\n    this.operation = opts?.operation\n    this.subject = opts?.subject\n  }\n}\n\n/**\n * Stream not found error\n */\nexport class StreamNotFoundError extends JetStreamError {\n  override readonly name = 'StreamNotFoundError'\n\n  constructor(stream: string) {\n    super(`Stream \"${stream}\" not found`, 'STREAM_NOT_FOUND', { stream })\n  }\n}\n\n/**\n * Consumer not found error\n */\nexport class ConsumerNotFoundError extends JetStreamError {\n  override readonly name = 'ConsumerNotFoundError'\n\n  constructor(stream: string, consumer: string) {\n    super(\n      `Consumer \"${consumer}\" not found on stream \"${stream}\"`,\n      'CONSUMER_NOT_FOUND',\n      { stream, consumer }\n    )\n  }\n}\n\n/**\n * Message not found error\n */\nexport class MessageNotFoundError extends JetStreamError {\n  override readonly name = 'MessageNotFoundError'\n  readonly seq: number\n\n  constructor(stream: string, seq: number) {\n    super(`Message ${seq} not found in stream \"${stream}\"`, 'MESSAGE_NOT_FOUND', {\n      stream,\n    })\n    this.seq = seq\n  }\n}\n\n/**\n * Stream already exists error\n */\nexport class StreamExistsError extends JetStreamError {\n  override readonly name = 'StreamExistsError'\n\n  constructor(stream: string) {\n    super(`Stream \"${stream}\" already exists`, 'STREAM_EXISTS', { stream })\n  }\n}\n\n/**\n * Consumer already exists error\n */\nexport class ConsumerExistsError extends JetStreamError {\n  override readonly name = 'ConsumerExistsError'\n\n  constructor(stream: string, consumer: string) {\n    super(\n      `Consumer \"${consumer}\" already exists on stream \"${stream}\"`,\n      'CONSUMER_EXISTS',\n      { stream, consumer }\n    )\n  }\n}\n\n/**\n * Invalid subject error\n */\nexport class InvalidSubjectError extends NatsError {\n  override readonly name = 'InvalidSubjectError'\n  readonly subject: string\n\n  constructor(subject: string) {\n    super(`Invalid subject: \"${subject}\"`, 'INVALID_SUBJECT')\n    this.subject = subject\n  }\n}\n\n/**\n * Max payload exceeded error\n */\nexport class MaxPayloadError extends NatsError {\n  override readonly name = 'MaxPayloadError'\n  readonly size: number\n  readonly maxSize: number\n\n  constructor(size: number, maxSize: number) {\n    super(\n      `Message size ${size} exceeds maximum allowed ${maxSize}`,\n      'MAX_PAYLOAD_EXCEEDED'\n    )\n    this.size = size\n    this.maxSize = maxSize\n  }\n}\n\n/**\n * Error codes for RPC responses\n */\nexport const ErrorCodes = {\n  TIMEOUT: 'TIMEOUT',\n  NO_RESPONDERS: 'NO_RESPONDERS',\n  CONNECTION_ERROR: 'CONNECTION_ERROR',\n  PERMISSION_DENIED: 'PERMISSION_DENIED',\n  STREAM_NOT_FOUND: 'STREAM_NOT_FOUND',\n  CONSUMER_NOT_FOUND: 'CONSUMER_NOT_FOUND',\n  MESSAGE_NOT_FOUND: 'MESSAGE_NOT_FOUND',\n  STREAM_EXISTS: 'STREAM_EXISTS',\n  CONSUMER_EXISTS: 'CONSUMER_EXISTS',\n  INVALID_SUBJECT: 'INVALID_SUBJECT',\n  MAX_PAYLOAD_EXCEEDED: 'MAX_PAYLOAD_EXCEEDED',\n} as const\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes]\n"]}

package/dist/utils.d.cts

@@ -0,0 +1,214 @@
+/**
+ * Subject Wildcard Matcher
+ *
+ * Implements NATS subject pattern matching with wildcards:
+ *   * (asterisk) - matches exactly one token
+ *   > (greater than) - matches one or more tokens (must be last)
+ */
+/**
+ * Tokenize a subject string into an array of tokens
+ */
+declare function tokenizeSubject(subject: string): string[];
+/**
+ * Parse a subject and return metadata about it
+ */
+interface ParsedSubject {
+    tokens: string[];
+    tokenCount: number;
+    hasWildcard: boolean;
+    hasGreater: boolean;
+}
+declare function parseSubject(subject: string): ParsedSubject;
+/**
+ * Check if a subject (not pattern) is valid
+ * Subjects cannot contain wildcards
+ */
+declare function isValidSubject(subject: string): boolean;
+/**
+ * Check if a wildcard pattern is valid
+ */
+declare function isValidWildcard(pattern: string): boolean;
+/**
+ * Match a subject against a pattern
+ * Pattern can contain wildcards (* and >)
+ * Subject must be a plain subject (no wildcards)
+ */
+declare function matchSubject(pattern: string, subject: string): boolean;
+/**
+ * Convert a subject pattern to a RegExp
+ * Useful for filtering subjects in bulk
+ */
+declare function subjectToRegex(pattern: string): RegExp;
+
+/**
+ * NUID Generator
+ *
+ * Generates unique identifiers compatible with NATS NUIDs.
+ * Format: 22 characters using base36 alphabet.
+ */
+/**
+ * NUID generator class
+ */
+declare class NUID {
+    private prefix;
+    private seq;
+    private inc;
+    constructor();
+    /**
+     * Generate the next NUID
+     */
+    next(): string;
+    /**
+     * Generate a random prefix
+     */
+    private randomPrefix;
+    /**
+     * Format sequence number as fixed-length base36
+     */
+    private formatSeq;
+    /**
+     * Reset with new random state
+     */
+    reset(): void;
+}
+/**
+ * Generate the next NUID using global instance
+ */
+declare function nuid(): string;
+/**
+ * Create a new inbox subject
+ */
+declare function createInbox(prefix?: string): string;
+
+/**
+ * Error Hierarchy
+ *
+ * NATS-compatible error types for NatDO.
+ */
+/**
+ * Base NATS error
+ */
+declare class NatsError extends Error {
+    readonly code: string;
+    readonly name: string;
+    constructor(message: string, code: string);
+}
+/**
+ * JetStream-specific error
+ */
+declare class JetStreamError extends NatsError {
+    readonly name: string;
+    readonly stream?: string;
+    readonly consumer?: string;
+    constructor(message: string, code: string, opts?: {
+        stream?: string;
+        consumer?: string;
+    });
+}
+/**
+ * Timeout error
+ */
+declare class TimeoutError extends NatsError {
+    readonly name = "TimeoutError";
+    readonly timeout: number;
+    constructor(timeout: number, message?: string);
+}
+/**
+ * No responders error
+ */
+declare class NoRespondersError extends NatsError {
+    readonly name = "NoRespondersError";
+    readonly subject: string;
+    constructor(subject: string);
+}
+/**
+ * Connection error
+ */
+declare class ConnectionError extends NatsError {
+    readonly name = "ConnectionError";
+    constructor(message: string);
+}
+/**
+ * Permission error
+ */
+declare class PermissionError extends NatsError {
+    readonly name = "PermissionError";
+    readonly operation?: string;
+    readonly subject?: string;
+    constructor(message: string, opts?: {
+        operation?: string;
+        subject?: string;
+    });
+}
+/**
+ * Stream not found error
+ */
+declare class StreamNotFoundError extends JetStreamError {
+    readonly name = "StreamNotFoundError";
+    constructor(stream: string);
+}
+/**
+ * Consumer not found error
+ */
+declare class ConsumerNotFoundError extends JetStreamError {
+    readonly name = "ConsumerNotFoundError";
+    constructor(stream: string, consumer: string);
+}
+/**
+ * Message not found error
+ */
+declare class MessageNotFoundError extends JetStreamError {
+    readonly name = "MessageNotFoundError";
+    readonly seq: number;
+    constructor(stream: string, seq: number);
+}
+/**
+ * Stream already exists error
+ */
+declare class StreamExistsError extends JetStreamError {
+    readonly name = "StreamExistsError";
+    constructor(stream: string);
+}
+/**
+ * Consumer already exists error
+ */
+declare class ConsumerExistsError extends JetStreamError {
+    readonly name = "ConsumerExistsError";
+    constructor(stream: string, consumer: string);
+}
+/**
+ * Invalid subject error
+ */
+declare class InvalidSubjectError extends NatsError {
+    readonly name = "InvalidSubjectError";
+    readonly subject: string;
+    constructor(subject: string);
+}
+/**
+ * Max payload exceeded error
+ */
+declare class MaxPayloadError extends NatsError {
+    readonly name = "MaxPayloadError";
+    readonly size: number;
+    readonly maxSize: number;
+    constructor(size: number, maxSize: number);
+}
+/**
+ * Error codes for RPC responses
+ */
+declare const ErrorCodes: {
+    readonly TIMEOUT: "TIMEOUT";
+    readonly NO_RESPONDERS: "NO_RESPONDERS";
+    readonly CONNECTION_ERROR: "CONNECTION_ERROR";
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    readonly STREAM_NOT_FOUND: "STREAM_NOT_FOUND";
+    readonly CONSUMER_NOT_FOUND: "CONSUMER_NOT_FOUND";
+    readonly MESSAGE_NOT_FOUND: "MESSAGE_NOT_FOUND";
+    readonly STREAM_EXISTS: "STREAM_EXISTS";
+    readonly CONSUMER_EXISTS: "CONSUMER_EXISTS";
+    readonly INVALID_SUBJECT: "INVALID_SUBJECT";
+    readonly MAX_PAYLOAD_EXCEEDED: "MAX_PAYLOAD_EXCEEDED";
+};
+type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+
+export { ConnectionError, ConsumerExistsError, ConsumerNotFoundError, type ErrorCode, ErrorCodes, InvalidSubjectError, JetStreamError, MaxPayloadError, MessageNotFoundError, NUID, NatsError, NoRespondersError, type ParsedSubject, PermissionError, StreamExistsError, StreamNotFoundError, TimeoutError, createInbox, isValidSubject, isValidWildcard, matchSubject, nuid, parseSubject, subjectToRegex, tokenizeSubject };