@happyvertical/messages 0.79.0 → 0.80.1

package/AGENT.md

@@ -7,7 +7,7 @@ Unified multi-channel messaging with adapter-based architecture (Slack, Twitter,
 ## Package Map
 - Package: `@happyvertical/messages`
 - Hierarchy path: `@happyvertical/sdk > packages > messages`
-- Workspace position: `19 of 31` local packages
+- Workspace position: `19 of 32` local packages
 - Internal dependencies: `@happyvertical/email`, `@happyvertical/logger`, `@happyvertical/utils`
 - Internal dependents: none
 - Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`

package/dist/chunks/base-DWpO_9_P.js

@@ -0,0 +1,107 @@
+import { createLogger } from "@happyvertical/logger";
+//#region src/shared/errors.ts
+/**
+* Error classes for @happyvertical/messages package
+*/
+var MessagingError = class extends Error {
+	code;
+	provider;
+	cause;
+	constructor(message, code, provider, cause) {
+		super(message);
+		this.name = "MessagingError";
+		this.code = code;
+		this.provider = provider;
+		this.cause = cause;
+	}
+};
+var ConnectionError = class extends MessagingError {
+	constructor(message, provider, cause) {
+		super(message, "CONNECTION_ERROR", provider, cause);
+		this.name = "ConnectionError";
+	}
+};
+var AuthenticationError = class extends MessagingError {
+	constructor(message, provider, cause) {
+		super(message, "AUTHENTICATION_ERROR", provider, cause);
+		this.name = "AuthenticationError";
+	}
+};
+var SendError = class extends MessagingError {
+	constructor(message, provider, cause) {
+		super(message, "SEND_ERROR", provider, cause);
+		this.name = "SendError";
+	}
+};
+var MessageNotFoundError = class extends MessagingError {
+	messageId;
+	constructor(messageId, provider, cause) {
+		super(`Message not found: ${messageId}`, "MESSAGE_NOT_FOUND", provider, cause);
+		this.name = "MessageNotFoundError";
+		this.messageId = messageId;
+	}
+};
+var ChannelNotFoundError = class extends MessagingError {
+	channelId;
+	constructor(channelId, provider) {
+		super(`Channel not found: ${channelId}`, "CHANNEL_NOT_FOUND", provider);
+		this.name = "ChannelNotFoundError";
+		this.channelId = channelId;
+	}
+};
+var RateLimitError = class extends MessagingError {
+	retryAfter;
+	constructor(provider, retryAfter) {
+		super(`Rate limit exceeded${retryAfter ? ` (retry after ${retryAfter}s)` : ""}`, "RATE_LIMIT", provider);
+		this.name = "RateLimitError";
+		this.retryAfter = retryAfter;
+	}
+};
+var InvalidMessageError = class extends MessagingError {
+	constructor(message, provider, cause) {
+		super(message, "INVALID_MESSAGE", provider, cause);
+		this.name = "InvalidMessageError";
+	}
+};
+//#endregion
+//#region src/shared/base.ts
+/**
+* Base message client adapter class
+*/
+/**
+* Base adapter class providing shared functionality.
+*
+* All adapter implementations should extend this class.
+* Protocol-only — no database persistence.
+*/
+var BaseMessageClient = class {
+	config;
+	logger;
+	connected = false;
+	constructor(config) {
+		this.config = config;
+		this.logger = config.logger || createLogger({ level: "info" });
+	}
+	async listChannels() {
+		throw new MessagingError("listChannels not supported by this adapter", "NOT_SUPPORTED", this.getAdapter());
+	}
+	isConnected() {
+		return this.connected;
+	}
+	validateMessage(message) {
+		if (!message.content && !message.html) throw new InvalidMessageError("Message must have content or html", this.getAdapter());
+		if (!message.from) throw new InvalidMessageError("Message must have a sender (from)", this.getAdapter());
+	}
+	mapError(error) {
+		if (error instanceof MessagingError) return error;
+		if (error instanceof Error) return new MessagingError(error.message, "UNKNOWN_ERROR", this.getAdapter(), error);
+		return new MessagingError(String(error), "UNKNOWN_ERROR", this.getAdapter());
+	}
+	debug(message, data) {
+		if (this.config.debug) this.logger.debug(message, data);
+	}
+};
+//#endregion
+export { InvalidMessageError as a, RateLimitError as c, ConnectionError as i, SendError as l, AuthenticationError as n, MessageNotFoundError as o, ChannelNotFoundError as r, MessagingError as s, BaseMessageClient as t };
+
+//# sourceMappingURL=base-DWpO_9_P.js.map

package/dist/chunks/base-DWpO_9_P.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-DWpO_9_P.js","names":[],"sources":["../../src/shared/errors.ts","../../src/shared/base.ts"],"sourcesContent":["/**\n * Error classes for @happyvertical/messages package\n */\n\n// ============================================================================\n// Base Error\n// ============================================================================\n\nexport class MessagingError extends Error {\n  code: string;\n  provider?: string;\n  cause?: unknown;\n\n  constructor(\n    message: string,\n    code: string,\n    provider?: string,\n    cause?: unknown,\n  ) {\n    super(message);\n    this.name = 'MessagingError';\n    this.code = code;\n    this.provider = provider;\n    this.cause = cause;\n  }\n}\n\n// ============================================================================\n// Connection Errors\n// ============================================================================\n\nexport class ConnectionError extends MessagingError {\n  constructor(message: string, provider?: string, cause?: unknown) {\n    super(message, 'CONNECTION_ERROR', provider, cause);\n    this.name = 'ConnectionError';\n  }\n}\n\n// ============================================================================\n// Authentication Errors\n// ============================================================================\n\nexport class AuthenticationError extends MessagingError {\n  constructor(message: string, provider?: string, cause?: unknown) {\n    super(message, 'AUTHENTICATION_ERROR', provider, cause);\n    this.name = 'AuthenticationError';\n  }\n}\n\n// ============================================================================\n// Send Errors\n// ============================================================================\n\nexport class SendError extends MessagingError {\n  constructor(message: string, provider?: string, cause?: unknown) {\n    super(message, 'SEND_ERROR', provider, cause);\n    this.name = 'SendError';\n  }\n}\n\n// ============================================================================\n// Message Errors\n// ============================================================================\n\nexport class MessageNotFoundError extends MessagingError {\n  messageId: string;\n\n  constructor(messageId: string, provider?: string, cause?: unknown) {\n    super(\n      `Message not found: ${messageId}`,\n      'MESSAGE_NOT_FOUND',\n      provider,\n      cause,\n    );\n    this.name = 'MessageNotFoundError';\n    this.messageId = messageId;\n  }\n}\n\n// ============================================================================\n// Channel Errors\n// ============================================================================\n\nexport class ChannelNotFoundError extends MessagingError {\n  channelId: string;\n\n  constructor(channelId: string, provider?: string) {\n    super(`Channel not found: ${channelId}`, 'CHANNEL_NOT_FOUND', provider);\n    this.name = 'ChannelNotFoundError';\n    this.channelId = channelId;\n  }\n}\n\n// ============================================================================\n// Rate Limit Errors\n// ============================================================================\n\nexport class RateLimitError extends MessagingError {\n  retryAfter?: number;\n\n  constructor(provider?: string, retryAfter?: number) {\n    super(\n      `Rate limit exceeded${retryAfter ? ` (retry after ${retryAfter}s)` : ''}`,\n      'RATE_LIMIT',\n      provider,\n    );\n    this.name = 'RateLimitError';\n    this.retryAfter = retryAfter;\n  }\n}\n\n// ============================================================================\n// Validation Errors\n// ============================================================================\n\nexport class InvalidMessageError extends MessagingError {\n  constructor(message: string, provider?: string, cause?: unknown) {\n    super(message, 'INVALID_MESSAGE', provider, cause);\n    this.name = 'InvalidMessageError';\n  }\n}\n","/**\n * Base message client adapter class\n */\n\nimport { createLogger, type Logger } from '@happyvertical/logger';\nimport { InvalidMessageError, MessagingError } from './errors.js';\nimport type {\n  Channel,\n  FetchOptions,\n  Message,\n  MessageAdapterType,\n  MessageClient,\n  MessageClientCapabilities,\n  MessageClientConfig,\n  SendOptions,\n  SendResult,\n} from './types.js';\n\n/**\n * Base adapter class providing shared functionality.\n *\n * All adapter implementations should extend this class.\n * Protocol-only — no database persistence.\n */\nexport abstract class BaseMessageClient implements MessageClient {\n  protected config: MessageClientConfig;\n  protected logger: Logger;\n  protected connected = false;\n\n  constructor(config: MessageClientConfig) {\n    this.config = config;\n    this.logger = config.logger || createLogger({ level: 'info' });\n  }\n\n  // ========================================================================\n  // Abstract methods that adapters must implement\n  // ========================================================================\n\n  abstract send(message: Message, options?: SendOptions): Promise<SendResult>;\n  abstract fetch(options?: FetchOptions): Promise<Message[]>;\n  abstract getMessage(messageId: string): Promise<Message>;\n  abstract getThread(threadId: string): Promise<Message[]>;\n  abstract connect(): Promise<void>;\n  abstract disconnect(): Promise<void>;\n  abstract getCapabilities(): MessageClientCapabilities;\n  abstract getAdapter(): MessageAdapterType;\n\n  // ========================================================================\n  // Optional methods (default to unsupported)\n  // ========================================================================\n\n  async listChannels(): Promise<Channel[]> {\n    throw new MessagingError(\n      'listChannels not supported by this adapter',\n      'NOT_SUPPORTED',\n      this.getAdapter(),\n    );\n  }\n\n  // ========================================================================\n  // Connection management\n  // ========================================================================\n\n  isConnected(): boolean {\n    return this.connected;\n  }\n\n  // ========================================================================\n  // Validation helpers\n  // ========================================================================\n\n  protected validateMessage(message: Message): void {\n    if (!message.content && !message.html) {\n      throw new InvalidMessageError(\n        'Message must have content or html',\n        this.getAdapter(),\n      );\n    }\n\n    if (!message.from) {\n      throw new InvalidMessageError(\n        'Message must have a sender (from)',\n        this.getAdapter(),\n      );\n    }\n  }\n\n  // ========================================================================\n  // Error mapping\n  // ========================================================================\n\n  protected mapError(error: unknown): MessagingError {\n    if (error instanceof MessagingError) {\n      return error;\n    }\n\n    if (error instanceof Error) {\n      return new MessagingError(\n        error.message,\n        'UNKNOWN_ERROR',\n        this.getAdapter(),\n        error,\n      );\n    }\n\n    return new MessagingError(\n      String(error),\n      'UNKNOWN_ERROR',\n      this.getAdapter(),\n    );\n  }\n\n  // ========================================================================\n  // Utility methods\n  // ========================================================================\n\n  protected debug(message: string, data?: unknown): void {\n    if (this.config.debug) {\n      this.logger.debug(message, data as Record<string, unknown> | undefined);\n    }\n  }\n}\n"],"mappings":";;;;;AAQA,IAAa,iBAAb,cAAoC,MAAM;CACxC;CACA;CACA;CAEA,YACE,SACA,MACA,UACA,OACA;EACA,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,WAAW;EAChB,KAAK,QAAQ;CACf;AACF;AAMA,IAAa,kBAAb,cAAqC,eAAe;CAClD,YAAY,SAAiB,UAAmB,OAAiB;EAC/D,MAAM,SAAS,oBAAoB,UAAU,KAAK;EAClD,KAAK,OAAO;CACd;AACF;AAMA,IAAa,sBAAb,cAAyC,eAAe;CACtD,YAAY,SAAiB,UAAmB,OAAiB;EAC/D,MAAM,SAAS,wBAAwB,UAAU,KAAK;EACtD,KAAK,OAAO;CACd;AACF;AAMA,IAAa,YAAb,cAA+B,eAAe;CAC5C,YAAY,SAAiB,UAAmB,OAAiB;EAC/D,MAAM,SAAS,cAAc,UAAU,KAAK;EAC5C,KAAK,OAAO;CACd;AACF;AAMA,IAAa,uBAAb,cAA0C,eAAe;CACvD;CAEA,YAAY,WAAmB,UAAmB,OAAiB;EACjE,MACE,sBAAsB,aACtB,qBACA,UACA,KACF;EACA,KAAK,OAAO;EACZ,KAAK,YAAY;CACnB;AACF;AAMA,IAAa,uBAAb,cAA0C,eAAe;CACvD;CAEA,YAAY,WAAmB,UAAmB;EAChD,MAAM,sBAAsB,aAAa,qBAAqB,QAAQ;EACtE,KAAK,OAAO;EACZ,KAAK,YAAY;CACnB;AACF;AAMA,IAAa,iBAAb,cAAoC,eAAe;CACjD;CAEA,YAAY,UAAmB,YAAqB;EAClD,MACE,sBAAsB,aAAa,iBAAiB,WAAW,MAAM,MACrE,cACA,QACF;EACA,KAAK,OAAO;EACZ,KAAK,aAAa;CACpB;AACF;AAMA,IAAa,sBAAb,cAAyC,eAAe;CACtD,YAAY,SAAiB,UAAmB,OAAiB;EAC/D,MAAM,SAAS,mBAAmB,UAAU,KAAK;EACjD,KAAK,OAAO;CACd;AACF;;;;;;;;;;;;AChGA,IAAsB,oBAAtB,MAAiE;CAC/D;CACA;CACA,YAAsB;CAEtB,YAAY,QAA6B;EACvC,KAAK,SAAS;EACd,KAAK,SAAS,OAAO,UAAU,aAAa,EAAE,OAAO,OAAO,CAAC;CAC/D;CAmBA,MAAM,eAAmC;EACvC,MAAM,IAAI,eACR,8CACA,iBACA,KAAK,WAAW,CAClB;CACF;CAMA,cAAuB;EACrB,OAAO,KAAK;CACd;CAMA,gBAA0B,SAAwB;EAChD,IAAI,CAAC,QAAQ,WAAW,CAAC,QAAQ,MAC/B,MAAM,IAAI,oBACR,qCACA,KAAK,WAAW,CAClB;EAGF,IAAI,CAAC,QAAQ,MACX,MAAM,IAAI,oBACR,qCACA,KAAK,WAAW,CAClB;CAEJ;CAMA,SAAmB,OAAgC;EACjD,IAAI,iBAAiB,gBACnB,OAAO;EAGT,IAAI,iBAAiB,OACnB,OAAO,IAAI,eACT,MAAM,SACN,iBACA,KAAK,WAAW,GAChB,KACF;EAGF,OAAO,IAAI,eACT,OAAO,KAAK,GACZ,iBACA,KAAK,WAAW,CAClB;CACF;CAMA,MAAgB,SAAiB,MAAsB;EACrD,IAAI,KAAK,OAAO,OACd,KAAK,OAAO,MAAM,SAAS,IAA2C;CAE1E;AACF"}