@chat-adapter/shared 4.1.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Vercel, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,227 @@
+import { AdapterPostableMessage, CardElement, FileUpload, ButtonElement } from 'chat';
+
+/**
+ * Shared utility functions for chat adapters.
+ *
+ * These utilities are used across all adapter implementations (Slack, Teams, GChat)
+ * to reduce code duplication and ensure consistent behavior.
+ */
+
+/**
+ * Extract CardElement from an AdapterPostableMessage if present.
+ *
+ * Handles two cases:
+ * 1. The message IS a CardElement (type: "card")
+ * 2. The message is a PostableCard with a `card` property
+ *
+ * @param message - The message to extract the card from
+ * @returns The CardElement if found, null otherwise
+ *
+ * @example
+ * ```typescript
+ * // Case 1: Direct CardElement
+ * const card = Card({ title: "Test" });
+ * extractCard(card); // returns the card
+ *
+ * // Case 2: PostableCard wrapper
+ * const message = { card, fallbackText: "..." };
+ * extractCard(message); // returns the card
+ *
+ * // Case 3: Non-card message
+ * extractCard("Hello"); // returns null
+ * extractCard({ markdown: "**bold**" }); // returns null
+ * ```
+ */
+declare function extractCard(message: AdapterPostableMessage): CardElement | null;
+/**
+ * Extract FileUpload array from an AdapterPostableMessage if present.
+ *
+ * Files can be attached to PostableRaw, PostableMarkdown, PostableAst,
+ * or PostableCard messages via the `files` property.
+ *
+ * @param message - The message to extract files from
+ * @returns Array of FileUpload objects, or empty array if none
+ *
+ * @example
+ * ```typescript
+ * // With files
+ * const message = {
+ *   markdown: "**Text**",
+ *   files: [{ data: Buffer.from("..."), filename: "doc.pdf" }]
+ * };
+ * extractFiles(message); // returns the files array
+ *
+ * // Without files
+ * extractFiles("Hello"); // returns []
+ * extractFiles({ raw: "text" }); // returns []
+ * ```
+ */
+declare function extractFiles(message: AdapterPostableMessage): FileUpload[];
+
+/**
+ * Shared card conversion utilities for adapters.
+ *
+ * These utilities reduce duplication across adapter implementations
+ * for card-to-platform-format conversions.
+ */
+
+/**
+ * Supported platform names for adapter utilities.
+ */
+type PlatformName = "slack" | "gchat" | "teams";
+/**
+ * Button style mappings per platform.
+ *
+ * Maps our standard button styles ("primary", "danger") to
+ * platform-specific values.
+ */
+declare const BUTTON_STYLE_MAPPINGS: Record<PlatformName, Record<string, string>>;
+/**
+ * Create a platform-specific emoji converter function.
+ *
+ * Returns a function that converts emoji placeholders (e.g., `{{emoji:wave}}`)
+ * to the platform's native format.
+ *
+ * @example
+ * ```typescript
+ * const convertEmoji = createEmojiConverter("slack");
+ * convertEmoji("{{emoji:wave}} Hello"); // ":wave: Hello"
+ * ```
+ */
+declare function createEmojiConverter(platform: PlatformName): (text: string) => string;
+/**
+ * Map a button style to the platform-specific value.
+ *
+ * @example
+ * ```typescript
+ * mapButtonStyle("primary", "teams"); // "positive"
+ * mapButtonStyle("danger", "slack");  // "danger"
+ * mapButtonStyle(undefined, "teams"); // undefined
+ * ```
+ */
+declare function mapButtonStyle(style: ButtonElement["style"], platform: PlatformName): string | undefined;
+/**
+ * Options for fallback text generation.
+ */
+interface FallbackTextOptions {
+    /** Bold format string (default: "*" for mrkdwn, "**" for markdown) */
+    boldFormat?: "*" | "**";
+    /** Line break between sections (default: "\n") */
+    lineBreak?: "\n" | "\n\n";
+    /** Platform for emoji conversion (optional) */
+    platform?: PlatformName;
+}
+/**
+ * Generate fallback plain text from a card element.
+ *
+ * Used when the platform can't render rich cards or for notification previews.
+ * Consolidates duplicate implementations from individual adapters.
+ *
+ * @example
+ * ```typescript
+ * // Slack-style (mrkdwn)
+ * cardToFallbackText(card, { boldFormat: "*", platform: "slack" });
+ *
+ * // Teams-style (markdown with double line breaks)
+ * cardToFallbackText(card, { boldFormat: "**", lineBreak: "\n\n", platform: "teams" });
+ * ```
+ */
+declare function cardToFallbackText(card: CardElement, options?: FallbackTextOptions): string;
+
+/**
+ * Standardized error types for chat adapters.
+ *
+ * These error classes provide consistent error handling across all
+ * adapter implementations.
+ */
+/**
+ * Base error class for adapter operations.
+ *
+ * All adapter-specific errors should extend this class.
+ */
+declare class AdapterError extends Error {
+    readonly adapter: string;
+    readonly code?: string | undefined;
+    /**
+     * @param message - Human-readable error message
+     * @param adapter - Name of the adapter (e.g., "slack", "teams", "gchat")
+     * @param code - Optional error code for programmatic handling
+     */
+    constructor(message: string, adapter: string, code?: string | undefined);
+}
+/**
+ * Rate limit error - thrown when platform API rate limits are hit.
+ *
+ * @example
+ * ```typescript
+ * throw new AdapterRateLimitError("slack", 30);
+ * // message: "Rate limited by slack, retry after 30s"
+ * ```
+ */
+declare class AdapterRateLimitError extends AdapterError {
+    readonly retryAfter?: number | undefined;
+    constructor(adapter: string, retryAfter?: number | undefined);
+}
+/**
+ * Authentication error - thrown when credentials are invalid or expired.
+ *
+ * @example
+ * ```typescript
+ * throw new AuthenticationError("teams", "Token expired");
+ * ```
+ */
+declare class AuthenticationError extends AdapterError {
+    constructor(adapter: string, message?: string);
+}
+/**
+ * Not found error - thrown when a requested resource doesn't exist.
+ *
+ * @example
+ * ```typescript
+ * throw new ResourceNotFoundError("slack", "channel", "C123456");
+ * // message: "channel 'C123456' not found in slack"
+ * ```
+ */
+declare class ResourceNotFoundError extends AdapterError {
+    readonly resourceType: string;
+    readonly resourceId?: string | undefined;
+    constructor(adapter: string, resourceType: string, resourceId?: string | undefined);
+}
+/**
+ * Permission error - thrown when the bot lacks required permissions.
+ *
+ * @example
+ * ```typescript
+ * throw new PermissionError("teams", "send messages", "channels:write");
+ * ```
+ */
+declare class PermissionError extends AdapterError {
+    readonly action: string;
+    readonly requiredScope?: string | undefined;
+    constructor(adapter: string, action: string, requiredScope?: string | undefined);
+}
+/**
+ * Validation error - thrown when input data is invalid.
+ *
+ * @example
+ * ```typescript
+ * throw new ValidationError("slack", "Message text exceeds 40000 characters");
+ * ```
+ */
+declare class ValidationError extends AdapterError {
+    constructor(adapter: string, message: string);
+}
+/**
+ * Network error - thrown when there's a network/connectivity issue.
+ *
+ * @example
+ * ```typescript
+ * throw new NetworkError("gchat", "Connection timeout after 30s");
+ * ```
+ */
+declare class NetworkError extends AdapterError {
+    readonly originalError?: Error | undefined;
+    constructor(adapter: string, message?: string, originalError?: Error | undefined);
+}
+
+export { AdapterError, AdapterRateLimitError, AuthenticationError, BUTTON_STYLE_MAPPINGS, type FallbackTextOptions, NetworkError, PermissionError, type PlatformName, ResourceNotFoundError, ValidationError, cardToFallbackText, createEmojiConverter, extractCard, extractFiles, mapButtonStyle };

package/dist/index.js

@@ -0,0 +1,162 @@
+// src/adapter-utils.ts
+import { isCardElement } from "chat";
+function extractCard(message) {
+  if (isCardElement(message)) {
+    return message;
+  }
+  if (typeof message === "object" && message !== null && "card" in message) {
+    return message.card;
+  }
+  return null;
+}
+function extractFiles(message) {
+  if (typeof message === "object" && message !== null && "files" in message) {
+    return message.files ?? [];
+  }
+  return [];
+}
+
+// src/card-utils.ts
+import { convertEmojiPlaceholders } from "chat";
+var BUTTON_STYLE_MAPPINGS = {
+  slack: { primary: "primary", danger: "danger" },
+  gchat: { primary: "primary", danger: "danger" },
+  // Colors handled via buttonColor
+  teams: { primary: "positive", danger: "destructive" }
+};
+function createEmojiConverter(platform) {
+  return (text) => convertEmojiPlaceholders(text, platform);
+}
+function mapButtonStyle(style, platform) {
+  if (!style) return void 0;
+  return BUTTON_STYLE_MAPPINGS[platform][style];
+}
+function cardToFallbackText(card, options = {}) {
+  const { boldFormat = "*", lineBreak = "\n", platform } = options;
+  const convertText = platform ? createEmojiConverter(platform) : (t) => t;
+  const parts = [];
+  if (card.title) {
+    parts.push(`${boldFormat}${convertText(card.title)}${boldFormat}`);
+  }
+  if (card.subtitle) {
+    parts.push(convertText(card.subtitle));
+  }
+  for (const child of card.children) {
+    const text = childToFallbackText(child, convertText);
+    if (text) {
+      parts.push(text);
+    }
+  }
+  return parts.join(lineBreak);
+}
+function childToFallbackText(child, convertText) {
+  switch (child.type) {
+    case "text":
+      return convertText(child.content);
+    case "fields":
+      return child.children.map((f) => `${convertText(f.label)}: ${convertText(f.value)}`).join("\n");
+    case "actions":
+      return `[${child.children.map((b) => convertText(b.label)).join("] [")}]`;
+    case "section":
+      return child.children.map((c) => childToFallbackText(c, convertText)).filter(Boolean).join("\n");
+    case "divider":
+      return "---";
+    default:
+      return null;
+  }
+}
+
+// src/errors.ts
+var AdapterError = class extends Error {
+  /**
+   * @param message - Human-readable error message
+   * @param adapter - Name of the adapter (e.g., "slack", "teams", "gchat")
+   * @param code - Optional error code for programmatic handling
+   */
+  constructor(message, adapter, code) {
+    super(message);
+    this.adapter = adapter;
+    this.code = code;
+    this.name = "AdapterError";
+  }
+};
+var AdapterRateLimitError = class extends AdapterError {
+  constructor(adapter, retryAfter) {
+    super(
+      `Rate limited by ${adapter}${retryAfter ? `, retry after ${retryAfter}s` : ""}`,
+      adapter,
+      "RATE_LIMITED"
+    );
+    this.retryAfter = retryAfter;
+    this.name = "AdapterRateLimitError";
+  }
+};
+var AuthenticationError = class extends AdapterError {
+  constructor(adapter, message) {
+    super(
+      message || `Authentication failed for ${adapter}`,
+      adapter,
+      "AUTH_FAILED"
+    );
+    this.name = "AuthenticationError";
+  }
+};
+var ResourceNotFoundError = class extends AdapterError {
+  constructor(adapter, resourceType, resourceId) {
+    const idPart = resourceId ? ` '${resourceId}'` : "";
+    super(
+      `${resourceType}${idPart} not found in ${adapter}`,
+      adapter,
+      "NOT_FOUND"
+    );
+    this.resourceType = resourceType;
+    this.resourceId = resourceId;
+    this.name = "ResourceNotFoundError";
+  }
+};
+var PermissionError = class extends AdapterError {
+  constructor(adapter, action, requiredScope) {
+    const scopePart = requiredScope ? ` (requires: ${requiredScope})` : "";
+    super(
+      `Permission denied: cannot ${action} in ${adapter}${scopePart}`,
+      adapter,
+      "PERMISSION_DENIED"
+    );
+    this.action = action;
+    this.requiredScope = requiredScope;
+    this.name = "PermissionError";
+  }
+};
+var ValidationError = class extends AdapterError {
+  constructor(adapter, message) {
+    super(message, adapter, "VALIDATION_ERROR");
+    this.name = "ValidationError";
+  }
+};
+var NetworkError = class extends AdapterError {
+  constructor(adapter, message, originalError) {
+    super(
+      message || `Network error communicating with ${adapter}`,
+      adapter,
+      "NETWORK_ERROR"
+    );
+    this.originalError = originalError;
+    this.name = "NetworkError";
+  }
+};
+export {
+  AdapterError,
+  AdapterRateLimitError,
+  AuthenticationError,
+  BUTTON_STYLE_MAPPINGS,
+  NetworkError,
+  PermissionError,
+  ResourceNotFoundError,
+  ValidationError,
+  cardToFallbackText,
+  createEmojiConverter,
+  extractCard,
+  extractFiles,
+  mapButtonStyle
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapter-utils.ts","../src/card-utils.ts","../src/errors.ts"],"sourcesContent":["/**\n * Shared utility functions for chat adapters.\n *\n * These utilities are used across all adapter implementations (Slack, Teams, GChat)\n * to reduce code duplication and ensure consistent behavior.\n */\n\nimport type { CardElement } from \"chat\";\nimport { isCardElement } from \"chat\";\nimport type { AdapterPostableMessage, FileUpload } from \"chat\";\n\n/**\n * Extract CardElement from an AdapterPostableMessage if present.\n *\n * Handles two cases:\n * 1. The message IS a CardElement (type: \"card\")\n * 2. The message is a PostableCard with a `card` property\n *\n * @param message - The message to extract the card from\n * @returns The CardElement if found, null otherwise\n *\n * @example\n * ```typescript\n * // Case 1: Direct CardElement\n * const card = Card({ title: \"Test\" });\n * extractCard(card); // returns the card\n *\n * // Case 2: PostableCard wrapper\n * const message = { card, fallbackText: \"...\" };\n * extractCard(message); // returns the card\n *\n * // Case 3: Non-card message\n * extractCard(\"Hello\"); // returns null\n * extractCard({ markdown: \"**bold**\" }); // returns null\n * ```\n */\nexport function extractCard(\n  message: AdapterPostableMessage,\n): CardElement | null {\n  if (isCardElement(message)) {\n    return message;\n  }\n  if (typeof message === \"object\" && message !== null && \"card\" in message) {\n    return message.card;\n  }\n  return null;\n}\n\n/**\n * Extract FileUpload array from an AdapterPostableMessage if present.\n *\n * Files can be attached to PostableRaw, PostableMarkdown, PostableAst,\n * or PostableCard messages via the `files` property.\n *\n * @param message - The message to extract files from\n * @returns Array of FileUpload objects, or empty array if none\n *\n * @example\n * ```typescript\n * // With files\n * const message = {\n *   markdown: \"**Text**\",\n *   files: [{ data: Buffer.from(\"...\"), filename: \"doc.pdf\" }]\n * };\n * extractFiles(message); // returns the files array\n *\n * // Without files\n * extractFiles(\"Hello\"); // returns []\n * extractFiles({ raw: \"text\" }); // returns []\n * ```\n */\nexport function extractFiles(message: AdapterPostableMessage): FileUpload[] {\n  if (typeof message === \"object\" && message !== null && \"files\" in message) {\n    return (message as { files?: FileUpload[] }).files ?? [];\n  }\n  return [];\n}\n","/**\n * Shared card conversion utilities for adapters.\n *\n * These utilities reduce duplication across adapter implementations\n * for card-to-platform-format conversions.\n */\n\nimport type { ButtonElement, CardChild, CardElement } from \"chat\";\nimport { convertEmojiPlaceholders } from \"chat\";\n\n/**\n * Supported platform names for adapter utilities.\n */\nexport type PlatformName = \"slack\" | \"gchat\" | \"teams\";\n\n/**\n * Button style mappings per platform.\n *\n * Maps our standard button styles (\"primary\", \"danger\") to\n * platform-specific values.\n */\nexport const BUTTON_STYLE_MAPPINGS: Record<\n  PlatformName,\n  Record<string, string>\n> = {\n  slack: { primary: \"primary\", danger: \"danger\" },\n  gchat: { primary: \"primary\", danger: \"danger\" }, // Colors handled via buttonColor\n  teams: { primary: \"positive\", danger: \"destructive\" },\n};\n\n/**\n * Create a platform-specific emoji converter function.\n *\n * Returns a function that converts emoji placeholders (e.g., `{{emoji:wave}}`)\n * to the platform's native format.\n *\n * @example\n * ```typescript\n * const convertEmoji = createEmojiConverter(\"slack\");\n * convertEmoji(\"{{emoji:wave}} Hello\"); // \":wave: Hello\"\n * ```\n */\nexport function createEmojiConverter(\n  platform: PlatformName,\n): (text: string) => string {\n  return (text: string) => convertEmojiPlaceholders(text, platform);\n}\n\n/**\n * Map a button style to the platform-specific value.\n *\n * @example\n * ```typescript\n * mapButtonStyle(\"primary\", \"teams\"); // \"positive\"\n * mapButtonStyle(\"danger\", \"slack\");  // \"danger\"\n * mapButtonStyle(undefined, \"teams\"); // undefined\n * ```\n */\nexport function mapButtonStyle(\n  style: ButtonElement[\"style\"],\n  platform: PlatformName,\n): string | undefined {\n  if (!style) return undefined;\n  return BUTTON_STYLE_MAPPINGS[platform][style];\n}\n\n/**\n * Options for fallback text generation.\n */\nexport interface FallbackTextOptions {\n  /** Bold format string (default: \"*\" for mrkdwn, \"**\" for markdown) */\n  boldFormat?: \"*\" | \"**\";\n  /** Line break between sections (default: \"\\n\") */\n  lineBreak?: \"\\n\" | \"\\n\\n\";\n  /** Platform for emoji conversion (optional) */\n  platform?: PlatformName;\n}\n\n/**\n * Generate fallback plain text from a card element.\n *\n * Used when the platform can't render rich cards or for notification previews.\n * Consolidates duplicate implementations from individual adapters.\n *\n * @example\n * ```typescript\n * // Slack-style (mrkdwn)\n * cardToFallbackText(card, { boldFormat: \"*\", platform: \"slack\" });\n *\n * // Teams-style (markdown with double line breaks)\n * cardToFallbackText(card, { boldFormat: \"**\", lineBreak: \"\\n\\n\", platform: \"teams\" });\n * ```\n */\nexport function cardToFallbackText(\n  card: CardElement,\n  options: FallbackTextOptions = {},\n): string {\n  const { boldFormat = \"*\", lineBreak = \"\\n\", platform } = options;\n\n  const convertText = platform\n    ? createEmojiConverter(platform)\n    : (t: string) => t;\n\n  const parts: string[] = [];\n\n  if (card.title) {\n    parts.push(`${boldFormat}${convertText(card.title)}${boldFormat}`);\n  }\n\n  if (card.subtitle) {\n    parts.push(convertText(card.subtitle));\n  }\n\n  for (const child of card.children) {\n    const text = childToFallbackText(child, convertText);\n    if (text) {\n      parts.push(text);\n    }\n  }\n\n  return parts.join(lineBreak);\n}\n\n/**\n * Convert a card child element to fallback text.\n * Internal helper for cardToFallbackText.\n */\nfunction childToFallbackText(\n  child: CardChild,\n  convertText: (t: string) => string,\n): string | null {\n  switch (child.type) {\n    case \"text\":\n      return convertText(child.content);\n    case \"fields\":\n      return child.children\n        .map((f) => `${convertText(f.label)}: ${convertText(f.value)}`)\n        .join(\"\\n\");\n    case \"actions\":\n      return `[${child.children.map((b) => convertText(b.label)).join(\"] [\")}]`;\n    case \"section\":\n      return child.children\n        .map((c) => childToFallbackText(c, convertText))\n        .filter(Boolean)\n        .join(\"\\n\");\n    case \"divider\":\n      return \"---\";\n    default:\n      return null;\n  }\n}\n","/**\n * Standardized error types for chat adapters.\n *\n * These error classes provide consistent error handling across all\n * adapter implementations.\n */\n\n/**\n * Base error class for adapter operations.\n *\n * All adapter-specific errors should extend this class.\n */\nexport class AdapterError extends Error {\n  /**\n   * @param message - Human-readable error message\n   * @param adapter - Name of the adapter (e.g., \"slack\", \"teams\", \"gchat\")\n   * @param code - Optional error code for programmatic handling\n   */\n  constructor(\n    message: string,\n    public readonly adapter: string,\n    public readonly code?: string,\n  ) {\n    super(message);\n    this.name = \"AdapterError\";\n  }\n}\n\n/**\n * Rate limit error - thrown when platform API rate limits are hit.\n *\n * @example\n * ```typescript\n * throw new AdapterRateLimitError(\"slack\", 30);\n * // message: \"Rate limited by slack, retry after 30s\"\n * ```\n */\nexport class AdapterRateLimitError extends AdapterError {\n  constructor(\n    adapter: string,\n    public readonly retryAfter?: number,\n  ) {\n    super(\n      `Rate limited by ${adapter}${retryAfter ? `, retry after ${retryAfter}s` : \"\"}`,\n      adapter,\n      \"RATE_LIMITED\",\n    );\n    this.name = \"AdapterRateLimitError\";\n  }\n}\n\n/**\n * Authentication error - thrown when credentials are invalid or expired.\n *\n * @example\n * ```typescript\n * throw new AuthenticationError(\"teams\", \"Token expired\");\n * ```\n */\nexport class AuthenticationError extends AdapterError {\n  constructor(adapter: string, message?: string) {\n    super(\n      message || `Authentication failed for ${adapter}`,\n      adapter,\n      \"AUTH_FAILED\",\n    );\n    this.name = \"AuthenticationError\";\n  }\n}\n\n/**\n * Not found error - thrown when a requested resource doesn't exist.\n *\n * @example\n * ```typescript\n * throw new ResourceNotFoundError(\"slack\", \"channel\", \"C123456\");\n * // message: \"channel 'C123456' not found in slack\"\n * ```\n */\nexport class ResourceNotFoundError extends AdapterError {\n  constructor(\n    adapter: string,\n    public readonly resourceType: string,\n    public readonly resourceId?: string,\n  ) {\n    const idPart = resourceId ? ` '${resourceId}'` : \"\";\n    super(\n      `${resourceType}${idPart} not found in ${adapter}`,\n      adapter,\n      \"NOT_FOUND\",\n    );\n    this.name = \"ResourceNotFoundError\";\n  }\n}\n\n/**\n * Permission error - thrown when the bot lacks required permissions.\n *\n * @example\n * ```typescript\n * throw new PermissionError(\"teams\", \"send messages\", \"channels:write\");\n * ```\n */\nexport class PermissionError extends AdapterError {\n  constructor(\n    adapter: string,\n    public readonly action: string,\n    public readonly requiredScope?: string,\n  ) {\n    const scopePart = requiredScope ? ` (requires: ${requiredScope})` : \"\";\n    super(\n      `Permission denied: cannot ${action} in ${adapter}${scopePart}`,\n      adapter,\n      \"PERMISSION_DENIED\",\n    );\n    this.name = \"PermissionError\";\n  }\n}\n\n/**\n * Validation error - thrown when input data is invalid.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\"slack\", \"Message text exceeds 40000 characters\");\n * ```\n */\nexport class ValidationError extends AdapterError {\n  constructor(adapter: string, message: string) {\n    super(message, adapter, \"VALIDATION_ERROR\");\n    this.name = \"ValidationError\";\n  }\n}\n\n/**\n * Network error - thrown when there's a network/connectivity issue.\n *\n * @example\n * ```typescript\n * throw new NetworkError(\"gchat\", \"Connection timeout after 30s\");\n * ```\n */\nexport class NetworkError extends AdapterError {\n  constructor(\n    adapter: string,\n    message?: string,\n    public readonly originalError?: Error,\n  ) {\n    super(\n      message || `Network error communicating with ${adapter}`,\n      adapter,\n      \"NETWORK_ERROR\",\n    );\n    this.name = \"NetworkError\";\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@chat-adapter/shared",
+  "version": "4.1.0",
+  "description": "Shared utilities for chat SDK adapters",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "chat": "4.2.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.7.3",
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "biome check src"
+  }
+}