chat 4.2.0 → 4.3.0

package/dist/{chunk-ACQNDPTB.js → chunk-NZGX5X26.js}

@@ -240,29 +240,47 @@ function processChildren(children) {
   if (typeof children === "object" && "type" in children) {
     return [children];
   }
-  if (typeof children === "string") {
-    return [children];
+  if (typeof children === "string" || typeof children === "number") {
+    return [String(children)];
   }
   return [];
 }
+function isTextProps(props) {
+  return !("id" in props) && !("url" in props) && !("label" in props);
+}
+function isButtonProps(props) {
+  return "id" in props && typeof props.id === "string";
+}
+function isImageProps(props) {
+  return "url" in props && typeof props.url === "string";
+}
+function isFieldProps(props) {
+  return "label" in props && "value" in props && typeof props.label === "string" && typeof props.value === "string";
+}
+function isCardProps(props) {
+  return !("id" in props) && !("url" in props) && ("title" in props || "subtitle" in props || "imageUrl" in props);
+}
 function resolveJSXElement(element) {
   const { type, props, children } = element;
   const processedChildren = processChildren(children);
-  const fn = type;
-  if (fn === Text) {
-    const content = processedChildren.length > 0 ? String(processedChildren[0]) : props.children ?? "";
-    return Text(content, { style: props.style });
+  if (type === Text) {
+    const textProps = isTextProps(props) ? props : { style: void 0 };
+    const content = processedChildren.length > 0 ? String(processedChildren[0]) : String(textProps.children ?? "");
+    return Text(content, { style: textProps.style });
   }
-  if (fn === Section) {
+  if (type === Section) {
     return Section(processedChildren);
   }
-  if (fn === Actions) {
+  if (type === Actions) {
     return Actions(processedChildren);
   }
-  if (fn === Fields) {
+  if (type === Fields) {
     return Fields(processedChildren);
   }
-  if (fn === Button) {
+  if (type === Button) {
+    if (!isButtonProps(props)) {
+      throw new Error("Button requires an 'id' prop");
+    }
     const label = processedChildren.length > 0 ? String(processedChildren[0]) : props.label ?? "";
     return Button({
       id: props.id,
@@ -271,20 +289,29 @@ function resolveJSXElement(element) {
       value: props.value
     });
   }
-  if (fn === Image) {
+  if (type === Image) {
+    if (!isImageProps(props)) {
+      throw new Error("Image requires a 'url' prop");
+    }
     return Image({ url: props.url, alt: props.alt });
   }
-  if (fn === Field) {
+  if (type === Field) {
+    if (!isFieldProps(props)) {
+      throw new Error("Field requires 'label' and 'value' props");
+    }
     return Field({
       label: props.label,
       value: props.value
     });
   }
-  if (fn === Divider) {
+  if (type === Divider) {
     return Divider();
   }
-  return type({
-    ...props,
+  const cardProps = isCardProps(props) ? props : {};
+  return Card({
+    title: cardProps.title,
+    subtitle: cardProps.subtitle,
+    imageUrl: cardProps.imageUrl,
     children: processedChildren
   });
 }
@@ -353,4 +380,4 @@ export {
   toCardElement,
   isJSX
 };
-//# sourceMappingURL=chunk-ACQNDPTB.js.map
+//# sourceMappingURL=chunk-NZGX5X26.js.map

package/dist/chunk-NZGX5X26.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cards.ts","../src/jsx-runtime.ts"],"sourcesContent":["/**\n * Card elements for cross-platform rich messaging.\n *\n * Provides a builder API for creating rich cards that automatically\n * convert to platform-specific formats:\n * - Slack: Block Kit\n * - Teams: Adaptive Cards\n * - Google Chat: Card v2\n *\n * Supports both function-call and JSX syntax:\n *\n * @example Function API\n * ```ts\n * import { Card, Text, Actions, Button } from \"chat\";\n *\n * await thread.post(\n *   Card({\n *     title: \"Order #1234\",\n *     children: [\n *       Text(\"Total: $50.00\"),\n *       Actions([\n *         Button({ id: \"approve\", label: \"Approve\", style: \"primary\" }),\n *         Button({ id: \"reject\", label: \"Reject\", style: \"danger\" }),\n *       ]),\n *     ],\n *   })\n * );\n * ```\n *\n * @example JSX API (requires jsxImportSource: \"chat\" in tsconfig)\n * ```tsx\n * /** @jsxImportSource chat *\\/\n * import { Card, Text, Actions, Button } from \"chat\";\n *\n * await thread.post(\n *   <Card title=\"Order #1234\">\n *     <Text>Total: $50.00</Text>\n *     <Actions>\n *       <Button id=\"approve\" style=\"primary\">Approve</Button>\n *       <Button id=\"reject\" style=\"danger\">Reject</Button>\n *     </Actions>\n *   </Card>\n * );\n * ```\n */\n\n// ============================================================================\n// Card Element Types\n// ============================================================================\n\n/** Button style options */\nexport type ButtonStyle = \"primary\" | \"danger\" | \"default\";\n\n/** Text style options */\nexport type TextStyle = \"plain\" | \"bold\" | \"muted\";\n\n/** Button element for interactive actions */\nexport interface ButtonElement {\n  type: \"button\";\n  /** Unique action ID for callback routing */\n  id: string;\n  /** Button label text */\n  label: string;\n  /** Visual style */\n  style?: ButtonStyle;\n  /** Optional payload value sent with action callback */\n  value?: string;\n}\n\n/** Text content element */\nexport interface TextElement {\n  type: \"text\";\n  /** Text content (supports markdown in some platforms) */\n  content: string;\n  /** Text style */\n  style?: TextStyle;\n}\n\n/** Image element */\nexport interface ImageElement {\n  type: \"image\";\n  /** Image URL */\n  url: string;\n  /** Alt text for accessibility */\n  alt?: string;\n}\n\n/** Visual divider/separator */\nexport interface DividerElement {\n  type: \"divider\";\n}\n\n/** Container for action buttons */\nexport interface ActionsElement {\n  type: \"actions\";\n  /** Button elements */\n  children: ButtonElement[];\n}\n\n/** Section container for grouping elements */\nexport interface SectionElement {\n  type: \"section\";\n  /** Section children */\n  children: CardChild[];\n}\n\n/** Field for key-value display */\nexport interface FieldElement {\n  type: \"field\";\n  /** Field label */\n  label: string;\n  /** Field value */\n  value: string;\n}\n\n/** Fields container for multi-column layout */\nexport interface FieldsElement {\n  type: \"fields\";\n  /** Field elements */\n  children: FieldElement[];\n}\n\n/** Union of all card child element types */\nexport type CardChild =\n  | TextElement\n  | ImageElement\n  | DividerElement\n  | ActionsElement\n  | SectionElement\n  | FieldsElement;\n\n/** Union of all element types (including nested children) */\ntype AnyCardElement = CardChild | CardElement | ButtonElement | FieldElement;\n\n/** Root card element */\nexport interface CardElement {\n  type: \"card\";\n  /** Card title */\n  title?: string;\n  /** Card subtitle */\n  subtitle?: string;\n  /** Header image URL */\n  imageUrl?: string;\n  /** Card content */\n  children: CardChild[];\n}\n\n/** Type guard for CardElement */\nexport function isCardElement(value: unknown): value is CardElement {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"type\" in value &&\n    (value as CardElement).type === \"card\"\n  );\n}\n\n// ============================================================================\n// Builder Functions\n// ============================================================================\n\n/** Options for Card */\nexport interface CardOptions {\n  title?: string;\n  subtitle?: string;\n  imageUrl?: string;\n  children?: CardChild[];\n}\n\n/**\n * Create a Card element.\n *\n * @example\n * ```ts\n * Card({\n *   title: \"Welcome\",\n *   children: [Text(\"Hello!\")],\n * })\n * ```\n */\nexport function Card(options: CardOptions = {}): CardElement {\n  return {\n    type: \"card\",\n    title: options.title,\n    subtitle: options.subtitle,\n    imageUrl: options.imageUrl,\n    children: options.children ?? [],\n  };\n}\n\n/**\n * Create a Text element.\n *\n * @example\n * ```ts\n * Text(\"Hello, world!\")\n * Text(\"Important\", { style: \"bold\" })\n * ```\n */\nexport function Text(\n  content: string,\n  options: { style?: TextStyle } = {},\n): TextElement {\n  return {\n    type: \"text\",\n    content,\n    style: options.style,\n  };\n}\n\n/**\n * Alias for Text that avoids conflicts with DOM's global Text constructor.\n * Use this when importing in environments where `Text` would conflict.\n *\n * @example\n * ```ts\n * import { CardText } from \"chat\";\n * CardText(\"Hello, world!\")\n * ```\n */\nexport const CardText = Text;\n\n/**\n * Create an Image element.\n *\n * @example\n * ```ts\n * Image({ url: \"https://example.com/image.png\", alt: \"Description\" })\n * ```\n */\nexport function Image(options: { url: string; alt?: string }): ImageElement {\n  return {\n    type: \"image\",\n    url: options.url,\n    alt: options.alt,\n  };\n}\n\n/**\n * Create a Divider element.\n *\n * @example\n * ```ts\n * Divider()\n * ```\n */\nexport function Divider(): DividerElement {\n  return { type: \"divider\" };\n}\n\n/**\n * Create a Section container.\n *\n * @example\n * ```ts\n * Section([\n *   Text(\"Grouped content\"),\n *   Image({ url: \"...\" }),\n * ])\n * ```\n */\nexport function Section(children: CardChild[]): SectionElement {\n  return {\n    type: \"section\",\n    children,\n  };\n}\n\n/**\n * Create an Actions container for buttons.\n *\n * @example\n * ```ts\n * Actions([\n *   Button({ id: \"ok\", label: \"OK\" }),\n *   Button({ id: \"cancel\", label: \"Cancel\" }),\n * ])\n * ```\n */\nexport function Actions(children: ButtonElement[]): ActionsElement {\n  return {\n    type: \"actions\",\n    children,\n  };\n}\n\n/** Options for Button */\nexport interface ButtonOptions {\n  /** Unique action ID for callback routing */\n  id: string;\n  /** Button label text */\n  label: string;\n  /** Visual style */\n  style?: ButtonStyle;\n  /** Optional payload value sent with action callback */\n  value?: string;\n}\n\n/**\n * Create a Button element.\n *\n * @example\n * ```ts\n * Button({ id: \"submit\", label: \"Submit\", style: \"primary\" })\n * Button({ id: \"delete\", label: \"Delete\", style: \"danger\", value: \"item-123\" })\n * ```\n */\nexport function Button(options: ButtonOptions): ButtonElement {\n  return {\n    type: \"button\",\n    id: options.id,\n    label: options.label,\n    style: options.style,\n    value: options.value,\n  };\n}\n\n/**\n * Create a Field element for key-value display.\n *\n * @example\n * ```ts\n * Field({ label: \"Status\", value: \"Active\" })\n * ```\n */\nexport function Field(options: { label: string; value: string }): FieldElement {\n  return {\n    type: \"field\",\n    label: options.label,\n    value: options.value,\n  };\n}\n\n/**\n * Create a Fields container for multi-column layout.\n *\n * @example\n * ```ts\n * Fields([\n *   Field({ label: \"Name\", value: \"John\" }),\n *   Field({ label: \"Email\", value: \"john@example.com\" }),\n * ])\n * ```\n */\nexport function Fields(children: FieldElement[]): FieldsElement {\n  return {\n    type: \"fields\",\n    children,\n  };\n}\n\n// ============================================================================\n// React Element Support\n// ============================================================================\n\n/** React element shape (minimal typing to avoid React dependency) */\ninterface ReactElement {\n  $$typeof: symbol;\n  type: unknown;\n  props: Record<string, unknown>;\n}\n\n/**\n * Check if a value is a React element.\n */\nfunction isReactElement(value: unknown): value is ReactElement {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const maybeElement = value as { $$typeof?: unknown };\n  if (typeof maybeElement.$$typeof !== \"symbol\") {\n    return false;\n  }\n  const symbolStr = maybeElement.$$typeof.toString();\n  return (\n    symbolStr.includes(\"react.element\") ||\n    symbolStr.includes(\"react.transitional.element\")\n  );\n}\n\n/**\n * Map of component functions to their names for React element conversion.\n */\nconst componentMap = new Map<unknown, string>([\n  [Card, \"Card\"],\n  [Text, \"Text\"],\n  [Image, \"Image\"],\n  [Divider, \"Divider\"],\n  [Section, \"Section\"],\n  [Actions, \"Actions\"],\n  [Button, \"Button\"],\n  [Field, \"Field\"],\n  [Fields, \"Fields\"],\n]);\n\n/**\n * Convert a React element tree to a CardElement tree.\n * This allows using React's JSX with our card components.\n *\n * @example\n * ```tsx\n * import React from \"react\";\n * import { Card, Text, fromReactElement } from \"chat\";\n *\n * const element = (\n *   <Card title=\"Hello\">\n *     <Text>World</Text>\n *   </Card>\n * );\n *\n * const card = fromReactElement(element);\n * await thread.post(card);\n * ```\n */\nexport function fromReactElement(element: unknown): AnyCardElement | null {\n  if (!isReactElement(element)) {\n    // Already a card element or primitive\n    if (isCardElement(element)) {\n      return element;\n    }\n    if (typeof element === \"object\" && element !== null && \"type\" in element) {\n      return element as CardChild;\n    }\n    return null;\n  }\n\n  const { type, props } = element;\n  const componentName = componentMap.get(type);\n\n  if (!componentName) {\n    // Check if it's an HTML element (string type like \"div\", \"a\", \"span\")\n    if (typeof type === \"string\") {\n      throw new Error(\n        `HTML element <${type}> is not supported in card elements. ` +\n          `Use Card, Text, Section, Actions, Button, Fields, Field, Image, or Divider components instead.`,\n      );\n    }\n\n    // Unknown custom component - try to extract children\n    if (props.children) {\n      return convertChildren(props.children)[0] ?? null;\n    }\n    return null;\n  }\n\n  // Convert children recursively\n  const convertedChildren = props.children\n    ? convertChildren(props.children)\n    : [];\n\n  // Helper to filter for CardChild elements\n  const isCardChild = (el: AnyCardElement): el is CardChild =>\n    el.type !== \"card\" && el.type !== \"button\" && el.type !== \"field\";\n\n  // Call the appropriate builder function based on component type\n  switch (componentName) {\n    case \"Card\":\n      return Card({\n        title: props.title as string | undefined,\n        subtitle: props.subtitle as string | undefined,\n        imageUrl: props.imageUrl as string | undefined,\n        children: convertedChildren.filter(isCardChild),\n      });\n\n    case \"Text\": {\n      // JSX: <Text style=\"bold\">content</Text>\n      const content = extractTextContent(props.children);\n      return Text(content, { style: props.style as TextStyle | undefined });\n    }\n\n    case \"Image\":\n      return Image({\n        url: props.url as string,\n        alt: props.alt as string | undefined,\n      });\n\n    case \"Divider\":\n      return Divider();\n\n    case \"Section\":\n      return Section(convertedChildren.filter(isCardChild));\n\n    case \"Actions\":\n      return Actions(\n        convertedChildren.filter(\n          (c): c is ButtonElement => c.type === \"button\",\n        ),\n      );\n\n    case \"Button\": {\n      // JSX: <Button id=\"x\" style=\"primary\">Label</Button>\n      const label = extractTextContent(props.children);\n      return Button({\n        id: props.id as string,\n        label: (props.label as string | undefined) ?? label,\n        style: props.style as ButtonStyle | undefined,\n        value: props.value as string | undefined,\n      });\n    }\n\n    case \"Field\":\n      return Field({\n        label: props.label as string,\n        value: props.value as string,\n      });\n\n    case \"Fields\":\n      return Fields(\n        convertedChildren.filter((c): c is FieldElement => c.type === \"field\"),\n      );\n\n    default:\n      return null;\n  }\n}\n\n/**\n * Convert React children to card elements.\n */\nfunction convertChildren(children: unknown): AnyCardElement[] {\n  if (children == null) {\n    return [];\n  }\n\n  if (Array.isArray(children)) {\n    return children.flatMap(convertChildren);\n  }\n\n  const converted = fromReactElement(children);\n  if (converted && typeof converted === \"object\" && \"type\" in converted) {\n    // If it's a card, extract its children\n    if (converted.type === \"card\") {\n      return (converted as CardElement).children;\n    }\n    return [converted];\n  }\n\n  return [];\n}\n\n/**\n * Extract text content from React children.\n */\nfunction extractTextContent(children: unknown): string {\n  if (typeof children === \"string\") {\n    return children;\n  }\n  if (typeof children === \"number\") {\n    return String(children);\n  }\n  if (Array.isArray(children)) {\n    return children.map(extractTextContent).join(\"\");\n  }\n  return \"\";\n}\n\n// ============================================================================\n// Fallback Text Generation\n// ============================================================================\n\n/**\n * Generate plain text fallback from a CardElement.\n * Used for platforms/clients that can't render rich cards,\n * and for the SentMessage.text property.\n */\nexport function cardToFallbackText(card: CardElement): string {\n  const parts: string[] = [];\n\n  if (card.title) {\n    parts.push(card.title);\n  }\n\n  if (card.subtitle) {\n    parts.push(card.subtitle);\n  }\n\n  for (const child of card.children) {\n    const text = childToFallbackText(child);\n    if (text) {\n      parts.push(text);\n    }\n  }\n\n  return parts.join(\"\\n\");\n}\n\n/**\n * Generate fallback text from a card child element.\n */\nfunction childToFallbackText(child: CardChild): string | null {\n  switch (child.type) {\n    case \"text\":\n      return child.content;\n    case \"fields\":\n      return child.children.map((f) => `${f.label}: ${f.value}`).join(\"\\n\");\n    case \"actions\":\n      return `[${child.children.map((b) => b.label).join(\"] [\")}]`;\n    case \"section\":\n      return child.children\n        .map((c) => childToFallbackText(c))\n        .filter(Boolean)\n        .join(\"\\n\");\n    default:\n      return null;\n  }\n}\n","/**\n * Custom JSX runtime for chat cards.\n *\n * This allows using JSX syntax without React. Configure your bundler:\n *\n * tsconfig.json:\n * {\n *   \"compilerOptions\": {\n *     \"jsx\": \"react-jsx\",\n *     \"jsxImportSource\": \"chat\"\n *   }\n * }\n *\n * Or per-file:\n * /** @jsxImportSource chat *\\/\n *\n * Usage:\n * ```tsx\n * import { Card, Text, Button, Actions } from \"chat\";\n *\n * const card = (\n *   <Card title=\"Order #1234\">\n *     <Text>Your order is ready!</Text>\n *     <Actions>\n *       <Button id=\"pickup\" style=\"primary\">Schedule Pickup</Button>\n *     </Actions>\n *   </Card>\n * );\n * ```\n */\n\nimport {\n  Actions,\n  Button,\n  type ButtonElement,\n  type ButtonStyle,\n  Card,\n  type CardChild,\n  type CardElement,\n  Divider,\n  Field,\n  type FieldElement,\n  Fields,\n  Image,\n  Section,\n  Text,\n  type TextStyle,\n} from \"./cards\";\n\n// Symbol to identify our JSX elements before they're processed\nconst JSX_ELEMENT = Symbol.for(\"chat.jsx.element\");\n\n// ============================================================================\n// JSX Props Types - Strongly typed props for each component\n// ============================================================================\n\n/** Props for Card component in JSX */\nexport interface CardProps {\n  title?: string;\n  subtitle?: string;\n  imageUrl?: string;\n  children?: unknown;\n}\n\n/** Props for Text component in JSX */\nexport interface TextProps {\n  style?: TextStyle;\n  children?: string | number;\n}\n\n/** Props for Button component in JSX */\nexport interface ButtonProps {\n  id: string;\n  label?: string;\n  style?: ButtonStyle;\n  value?: string;\n  children?: string | number;\n}\n\n/** Props for Image component in JSX */\nexport interface ImageProps {\n  url: string;\n  alt?: string;\n}\n\n/** Props for Field component in JSX */\nexport interface FieldProps {\n  label: string;\n  value: string;\n}\n\n/** Props for container components (Section, Actions, Fields) */\nexport interface ContainerProps {\n  children?: unknown;\n}\n\n/** Props for Divider component (no props) */\nexport type DividerProps = Record<string, never>;\n\n/** Union of all valid JSX props */\nexport type CardJSXProps =\n  | CardProps\n  | TextProps\n  | ButtonProps\n  | ImageProps\n  | FieldProps\n  | ContainerProps\n  | DividerProps;\n\n/** Component function type with proper overloads */\ntype CardComponentFunction =\n  | typeof Card\n  | typeof Text\n  | typeof Button\n  | typeof Image\n  | typeof Field\n  | typeof Divider\n  | typeof Section\n  | typeof Actions\n  | typeof Fields;\n\n/**\n * Represents a JSX element from the chat JSX runtime.\n * This is the type returned when using JSX syntax with chat components.\n */\nexport interface CardJSXElement<P extends CardJSXProps = CardJSXProps> {\n  $$typeof: typeof JSX_ELEMENT;\n  type: CardComponentFunction;\n  props: P;\n  children: unknown[];\n}\n\n// Internal alias for backwards compatibility\ntype JSXElement = CardJSXElement;\n\n/**\n * Check if a value is a JSX element from our runtime.\n */\nfunction isJSXElement(value: unknown): value is JSXElement {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as JSXElement).$$typeof === JSX_ELEMENT\n  );\n}\n\n/** Non-null card element for children arrays */\ntype CardChildOrNested = CardChild | ButtonElement | FieldElement;\n\n/**\n * Process children, converting JSX elements to card elements.\n */\nfunction processChildren(children: unknown): CardChildOrNested[] {\n  if (children == null) {\n    return [];\n  }\n\n  if (Array.isArray(children)) {\n    return children.flatMap(processChildren);\n  }\n\n  // If it's a JSX element, resolve it\n  if (isJSXElement(children)) {\n    const resolved = resolveJSXElement(children);\n    if (resolved) {\n      return [resolved as CardChildOrNested];\n    }\n    return [];\n  }\n\n  // If it's already a card element, return it\n  if (typeof children === \"object\" && \"type\" in children) {\n    return [children as CardChildOrNested];\n  }\n\n  // If it's a string or number, it might be text content for a Button or Text\n  if (typeof children === \"string\" || typeof children === \"number\") {\n    // Return as string, the component will handle it\n    return [String(children) as unknown as CardChildOrNested];\n  }\n\n  return [];\n}\n\n/** Any card element type that can be created */\ntype AnyCardElement =\n  | CardElement\n  | CardChild\n  | ButtonElement\n  | FieldElement\n  | null;\n\n/**\n * Type guard to check if props match TextProps\n */\nfunction isTextProps(props: CardJSXProps): props is TextProps {\n  return !(\"id\" in props) && !(\"url\" in props) && !(\"label\" in props);\n}\n\n/**\n * Type guard to check if props match ButtonProps\n */\nfunction isButtonProps(props: CardJSXProps): props is ButtonProps {\n  return \"id\" in props && typeof props.id === \"string\";\n}\n\n/**\n * Type guard to check if props match ImageProps\n */\nfunction isImageProps(props: CardJSXProps): props is ImageProps {\n  return \"url\" in props && typeof props.url === \"string\";\n}\n\n/**\n * Type guard to check if props match FieldProps\n */\nfunction isFieldProps(props: CardJSXProps): props is FieldProps {\n  return (\n    \"label\" in props &&\n    \"value\" in props &&\n    typeof props.label === \"string\" &&\n    typeof props.value === \"string\"\n  );\n}\n\n/**\n * Type guard to check if props match CardProps\n */\nfunction isCardProps(props: CardJSXProps): props is CardProps {\n  return (\n    !(\"id\" in props) &&\n    !(\"url\" in props) &&\n    (\"title\" in props || \"subtitle\" in props || \"imageUrl\" in props)\n  );\n}\n\n/**\n * Resolve a JSX element by calling its component function.\n * Transforms JSX props into the format each builder function expects.\n */\nfunction resolveJSXElement(element: JSXElement): AnyCardElement {\n  const { type, props, children } = element;\n\n  // Process children first\n  const processedChildren = processChildren(children);\n\n  // Use identity comparison to determine which builder function this is\n  // This is necessary because function names get minified in production builds\n  if (type === Text) {\n    // Text(content: string, options?: { style })\n    // JSX children become the content string\n    const textProps = isTextProps(props) ? props : { style: undefined };\n    const content =\n      processedChildren.length > 0\n        ? String(processedChildren[0])\n        : String(textProps.children ?? \"\");\n    return Text(content, { style: textProps.style });\n  }\n\n  if (type === Section) {\n    // Section takes array as first argument\n    return Section(processedChildren as CardChild[]);\n  }\n\n  if (type === Actions) {\n    // Actions takes array of ButtonElements\n    return Actions(processedChildren as ButtonElement[]);\n  }\n\n  if (type === Fields) {\n    // Fields takes array of FieldElements\n    return Fields(processedChildren as FieldElement[]);\n  }\n\n  if (type === Button) {\n    // Button({ id, label, style, value })\n    // JSX children become the label\n    if (!isButtonProps(props)) {\n      throw new Error(\"Button requires an 'id' prop\");\n    }\n    const label =\n      processedChildren.length > 0\n        ? String(processedChildren[0])\n        : (props.label ?? \"\");\n    return Button({\n      id: props.id,\n      label,\n      style: props.style,\n      value: props.value,\n    });\n  }\n\n  if (type === Image) {\n    // Image({ url, alt })\n    if (!isImageProps(props)) {\n      throw new Error(\"Image requires a 'url' prop\");\n    }\n    return Image({ url: props.url, alt: props.alt });\n  }\n\n  if (type === Field) {\n    // Field({ label, value })\n    if (!isFieldProps(props)) {\n      throw new Error(\"Field requires 'label' and 'value' props\");\n    }\n    return Field({\n      label: props.label,\n      value: props.value,\n    });\n  }\n\n  if (type === Divider) {\n    // Divider() - no args\n    return Divider();\n  }\n\n  // Default: Card({ title, subtitle, imageUrl, children })\n  const cardProps = isCardProps(props) ? props : {};\n  return Card({\n    title: cardProps.title,\n    subtitle: cardProps.subtitle,\n    imageUrl: cardProps.imageUrl,\n    children: processedChildren as CardChild[],\n  });\n}\n\n/**\n * JSX factory function (used by the JSX transform).\n * Creates a lazy JSX element that will be resolved when needed.\n */\nexport function jsx<P extends CardJSXProps>(\n  type: CardComponentFunction,\n  props: P & { children?: unknown },\n  _key?: string,\n): CardJSXElement<P> {\n  const { children, ...restProps } = props;\n  return {\n    $$typeof: JSX_ELEMENT,\n    type,\n    props: restProps as P,\n    children: children != null ? [children] : [],\n  };\n}\n\n/**\n * JSX factory for elements with multiple children.\n */\nexport function jsxs<P extends CardJSXProps>(\n  type: CardComponentFunction,\n  props: P & { children?: unknown },\n  _key?: string,\n): CardJSXElement<P> {\n  const { children, ...restProps } = props;\n  return {\n    $$typeof: JSX_ELEMENT,\n    type,\n    props: restProps as P,\n    children: Array.isArray(children)\n      ? children\n      : children != null\n        ? [children]\n        : [],\n  };\n}\n\n/**\n * Development JSX factory (same as jsx, but called in dev mode).\n */\nexport const jsxDEV = jsx;\n\n/**\n * Fragment support (flattens children).\n */\nexport function Fragment(props: { children?: unknown }): CardChild[] {\n  return processChildren(props.children) as CardChild[];\n}\n\n/**\n * Convert a JSX element tree to a CardElement.\n * Call this on the root JSX element to get a usable CardElement.\n */\nexport function toCardElement(jsxElement: unknown): CardElement | null {\n  if (isJSXElement(jsxElement)) {\n    const resolved = resolveJSXElement(jsxElement);\n    if (\n      resolved &&\n      typeof resolved === \"object\" &&\n      \"type\" in resolved &&\n      resolved.type === \"card\"\n    ) {\n      return resolved as CardElement;\n    }\n  }\n\n  // Already a CardElement\n  if (\n    typeof jsxElement === \"object\" &&\n    jsxElement !== null &&\n    \"type\" in jsxElement &&\n    (jsxElement as CardElement).type === \"card\"\n  ) {\n    return jsxElement as CardElement;\n  }\n\n  return null;\n}\n\n/**\n * Check if a value is a JSX element (from our runtime or React).\n */\nexport function isJSX(value: unknown): boolean {\n  if (isJSXElement(value)) {\n    return true;\n  }\n  // Check for React elements\n  if (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"$$typeof\" in value &&\n    typeof (value as { $$typeof: unknown }).$$typeof === \"symbol\"\n  ) {\n    const symbolStr = (value as { $$typeof: symbol }).$$typeof.toString();\n    return (\n      symbolStr.includes(\"react.element\") ||\n      symbolStr.includes(\"react.transitional.element\")\n    );\n  }\n  return false;\n}\n\n// Re-export for JSX namespace\nexport namespace JSX {\n  export interface Element extends JSXElement {}\n  // biome-ignore lint/complexity/noBannedTypes: Required for JSX namespace\n  export type IntrinsicElements = {};\n  export interface ElementChildrenAttribute {\n    // biome-ignore lint/complexity/noBannedTypes: Required for JSX children attribute\n    children: {};\n  }\n}\n"],"mappings":";AAoJO,SAAS,cAAc,OAAsC;AAClE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,UAAU,SACT,MAAsB,SAAS;AAEpC;AAyBO,SAAS,KAAK,UAAuB,CAAC,GAAgB;AAC3D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,QAAQ;AAAA,IACf,UAAU,QAAQ;AAAA,IAClB,UAAU,QAAQ;AAAA,IAClB,UAAU,QAAQ,YAAY,CAAC;AAAA,EACjC;AACF;AAWO,SAAS,KACd,SACA,UAAiC,CAAC,GACrB;AACb,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,OAAO,QAAQ;AAAA,EACjB;AACF;AAYO,IAAM,WAAW;AAUjB,SAAS,MAAM,SAAsD;AAC1E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,KAAK,QAAQ;AAAA,IACb,KAAK,QAAQ;AAAA,EACf;AACF;AAUO,SAAS,UAA0B;AACxC,SAAO,EAAE,MAAM,UAAU;AAC3B;AAaO,SAAS,QAAQ,UAAuC;AAC7D,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAaO,SAAS,QAAQ,UAA2C;AACjE,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAuBO,SAAS,OAAO,SAAuC;AAC5D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,QAAQ;AAAA,IACZ,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,EACjB;AACF;AAUO,SAAS,MAAM,SAAyD;AAC7E,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,QAAQ;AAAA,IACf,OAAO,QAAQ;AAAA,EACjB;AACF;AAaO,SAAS,OAAO,UAAyC;AAC9D,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;AAgBA,SAAS,eAAe,OAAuC;AAC7D,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,eAAe;AACrB,MAAI,OAAO,aAAa,aAAa,UAAU;AAC7C,WAAO;AAAA,EACT;AACA,QAAM,YAAY,aAAa,SAAS,SAAS;AACjD,SACE,UAAU,SAAS,eAAe,KAClC,UAAU,SAAS,4BAA4B;AAEnD;AAKA,IAAM,eAAe,oBAAI,IAAqB;AAAA,EAC5C,CAAC,MAAM,MAAM;AAAA,EACb,CAAC,MAAM,MAAM;AAAA,EACb,CAAC,OAAO,OAAO;AAAA,EACf,CAAC,SAAS,SAAS;AAAA,EACnB,CAAC,SAAS,SAAS;AAAA,EACnB,CAAC,SAAS,SAAS;AAAA,EACnB,CAAC,QAAQ,QAAQ;AAAA,EACjB,CAAC,OAAO,OAAO;AAAA,EACf,CAAC,QAAQ,QAAQ;AACnB,CAAC;AAqBM,SAAS,iBAAiB,SAAyC;AACxE,MAAI,CAAC,eAAe,OAAO,GAAG;AAE5B,QAAI,cAAc,OAAO,GAAG;AAC1B,aAAO;AAAA,IACT;AACA,QAAI,OAAO,YAAY,YAAY,YAAY,QAAQ,UAAU,SAAS;AACxE,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAEA,QAAM,EAAE,MAAM,MAAM,IAAI;AACxB,QAAM,gBAAgB,aAAa,IAAI,IAAI;AAE3C,MAAI,CAAC,eAAe;AAElB,QAAI,OAAO,SAAS,UAAU;AAC5B,YAAM,IAAI;AAAA,QACR,iBAAiB,IAAI;AAAA,MAEvB;AAAA,IACF;AAGA,QAAI,MAAM,UAAU;AAClB,aAAO,gBAAgB,MAAM,QAAQ,EAAE,CAAC,KAAK;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAGA,QAAM,oBAAoB,MAAM,WAC5B,gBAAgB,MAAM,QAAQ,IAC9B,CAAC;AAGL,QAAM,cAAc,CAAC,OACnB,GAAG,SAAS,UAAU,GAAG,SAAS,YAAY,GAAG,SAAS;AAG5D,UAAQ,eAAe;AAAA,IACrB,KAAK;AACH,aAAO,KAAK;AAAA,QACV,OAAO,MAAM;AAAA,QACb,UAAU,MAAM;AAAA,QAChB,UAAU,MAAM;AAAA,QAChB,UAAU,kBAAkB,OAAO,WAAW;AAAA,MAChD,CAAC;AAAA,IAEH,KAAK,QAAQ;AAEX,YAAM,UAAU,mBAAmB,MAAM,QAAQ;AACjD,aAAO,KAAK,SAAS,EAAE,OAAO,MAAM,MAA+B,CAAC;AAAA,IACtE;AAAA,IAEA,KAAK;AACH,aAAO,MAAM;AAAA,QACX,KAAK,MAAM;AAAA,QACX,KAAK,MAAM;AAAA,MACb,CAAC;AAAA,IAEH,KAAK;AACH,aAAO,QAAQ;AAAA,IAEjB,KAAK;AACH,aAAO,QAAQ,kBAAkB,OAAO,WAAW,CAAC;AAAA,IAEtD,KAAK;AACH,aAAO;AAAA,QACL,kBAAkB;AAAA,UAChB,CAAC,MAA0B,EAAE,SAAS;AAAA,QACxC;AAAA,MACF;AAAA,IAEF,KAAK,UAAU;AAEb,YAAM,QAAQ,mBAAmB,MAAM,QAAQ;AAC/C,aAAO,OAAO;AAAA,QACZ,IAAI,MAAM;AAAA,QACV,OAAQ,MAAM,SAAgC;AAAA,QAC9C,OAAO,MAAM;AAAA,QACb,OAAO,MAAM;AAAA,MACf,CAAC;AAAA,IACH;AAAA,IAEA,KAAK;AACH,aAAO,MAAM;AAAA,QACX,OAAO,MAAM;AAAA,QACb,OAAO,MAAM;AAAA,MACf,CAAC;AAAA,IAEH,KAAK;AACH,aAAO;AAAA,QACL,kBAAkB,OAAO,CAAC,MAAyB,EAAE,SAAS,OAAO;AAAA,MACvE;AAAA,IAEF;AACE,aAAO;AAAA,EACX;AACF;AAKA,SAAS,gBAAgB,UAAqC;AAC5D,MAAI,YAAY,MAAM;AACpB,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,WAAO,SAAS,QAAQ,eAAe;AAAA,EACzC;AAEA,QAAM,YAAY,iBAAiB,QAAQ;AAC3C,MAAI,aAAa,OAAO,cAAc,YAAY,UAAU,WAAW;AAErE,QAAI,UAAU,SAAS,QAAQ;AAC7B,aAAQ,UAA0B;AAAA,IACpC;AACA,WAAO,CAAC,SAAS;AAAA,EACnB;AAEA,SAAO,CAAC;AACV;AAKA,SAAS,mBAAmB,UAA2B;AACrD,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO;AAAA,EACT;AACA,MAAI,OAAO,aAAa,UAAU;AAChC,WAAO,OAAO,QAAQ;AAAA,EACxB;AACA,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,WAAO,SAAS,IAAI,kBAAkB,EAAE,KAAK,EAAE;AAAA,EACjD;AACA,SAAO;AACT;AAWO,SAAS,mBAAmB,MAA2B;AAC5D,QAAM,QAAkB,CAAC;AAEzB,MAAI,KAAK,OAAO;AACd,UAAM,KAAK,KAAK,KAAK;AAAA,EACvB;AAEA,MAAI,KAAK,UAAU;AACjB,UAAM,KAAK,KAAK,QAAQ;AAAA,EAC1B;AAEA,aAAW,SAAS,KAAK,UAAU;AACjC,UAAM,OAAO,oBAAoB,KAAK;AACtC,QAAI,MAAM;AACR,YAAM,KAAK,IAAI;AAAA,IACjB;AAAA,EACF;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAKA,SAAS,oBAAoB,OAAiC;AAC5D,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,MAAM,SAAS,IAAI,CAAC,MAAM,GAAG,EAAE,KAAK,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI;AAAA,IACtE,KAAK;AACH,aAAO,IAAI,MAAM,SAAS,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC;AAAA,IAC3D,KAAK;AACH,aAAO,MAAM,SACV,IAAI,CAAC,MAAM,oBAAoB,CAAC,CAAC,EACjC,OAAO,OAAO,EACd,KAAK,IAAI;AAAA,IACd;AACE,aAAO;AAAA,EACX;AACF;;;AC3iBA,IAAM,cAAc,uBAAO,IAAI,kBAAkB;AAwFjD,SAAS,aAAa,OAAqC;AACzD,SACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAqB,aAAa;AAEvC;AAQA,SAAS,gBAAgB,UAAwC;AAC/D,MAAI,YAAY,MAAM;AACpB,WAAO,CAAC;AAAA,EACV;AAEA,MAAI,MAAM,QAAQ,QAAQ,GAAG;AAC3B,WAAO,SAAS,QAAQ,eAAe;AAAA,EACzC;AAGA,MAAI,aAAa,QAAQ,GAAG;AAC1B,UAAM,WAAW,kBAAkB,QAAQ;AAC3C,QAAI,UAAU;AACZ,aAAO,CAAC,QAA6B;AAAA,IACvC;AACA,WAAO,CAAC;AAAA,EACV;AAGA,MAAI,OAAO,aAAa,YAAY,UAAU,UAAU;AACtD,WAAO,CAAC,QAA6B;AAAA,EACvC;AAGA,MAAI,OAAO,aAAa,YAAY,OAAO,aAAa,UAAU;AAEhE,WAAO,CAAC,OAAO,QAAQ,CAAiC;AAAA,EAC1D;AAEA,SAAO,CAAC;AACV;AAaA,SAAS,YAAY,OAAyC;AAC5D,SAAO,EAAE,QAAQ,UAAU,EAAE,SAAS,UAAU,EAAE,WAAW;AAC/D;AAKA,SAAS,cAAc,OAA2C;AAChE,SAAO,QAAQ,SAAS,OAAO,MAAM,OAAO;AAC9C;AAKA,SAAS,aAAa,OAA0C;AAC9D,SAAO,SAAS,SAAS,OAAO,MAAM,QAAQ;AAChD;AAKA,SAAS,aAAa,OAA0C;AAC9D,SACE,WAAW,SACX,WAAW,SACX,OAAO,MAAM,UAAU,YACvB,OAAO,MAAM,UAAU;AAE3B;AAKA,SAAS,YAAY,OAAyC;AAC5D,SACE,EAAE,QAAQ,UACV,EAAE,SAAS,WACV,WAAW,SAAS,cAAc,SAAS,cAAc;AAE9D;AAMA,SAAS,kBAAkB,SAAqC;AAC9D,QAAM,EAAE,MAAM,OAAO,SAAS,IAAI;AAGlC,QAAM,oBAAoB,gBAAgB,QAAQ;AAIlD,MAAI,SAAS,MAAM;AAGjB,UAAM,YAAY,YAAY,KAAK,IAAI,QAAQ,EAAE,OAAO,OAAU;AAClE,UAAM,UACJ,kBAAkB,SAAS,IACvB,OAAO,kBAAkB,CAAC,CAAC,IAC3B,OAAO,UAAU,YAAY,EAAE;AACrC,WAAO,KAAK,SAAS,EAAE,OAAO,UAAU,MAAM,CAAC;AAAA,EACjD;AAEA,MAAI,SAAS,SAAS;AAEpB,WAAO,QAAQ,iBAAgC;AAAA,EACjD;AAEA,MAAI,SAAS,SAAS;AAEpB,WAAO,QAAQ,iBAAoC;AAAA,EACrD;AAEA,MAAI,SAAS,QAAQ;AAEnB,WAAO,OAAO,iBAAmC;AAAA,EACnD;AAEA,MAAI,SAAS,QAAQ;AAGnB,QAAI,CAAC,cAAc,KAAK,GAAG;AACzB,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AACA,UAAM,QACJ,kBAAkB,SAAS,IACvB,OAAO,kBAAkB,CAAC,CAAC,IAC1B,MAAM,SAAS;AACtB,WAAO,OAAO;AAAA,MACZ,IAAI,MAAM;AAAA,MACV;AAAA,MACA,OAAO,MAAM;AAAA,MACb,OAAO,MAAM;AAAA,IACf,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,OAAO;AAElB,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,YAAM,IAAI,MAAM,6BAA6B;AAAA,IAC/C;AACA,WAAO,MAAM,EAAE,KAAK,MAAM,KAAK,KAAK,MAAM,IAAI,CAAC;AAAA,EACjD;AAEA,MAAI,SAAS,OAAO;AAElB,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,YAAM,IAAI,MAAM,0CAA0C;AAAA,IAC5D;AACA,WAAO,MAAM;AAAA,MACX,OAAO,MAAM;AAAA,MACb,OAAO,MAAM;AAAA,IACf,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,SAAS;AAEpB,WAAO,QAAQ;AAAA,EACjB;AAGA,QAAM,YAAY,YAAY,KAAK,IAAI,QAAQ,CAAC;AAChD,SAAO,KAAK;AAAA,IACV,OAAO,UAAU;AAAA,IACjB,UAAU,UAAU;AAAA,IACpB,UAAU,UAAU;AAAA,IACpB,UAAU;AAAA,EACZ,CAAC;AACH;AAMO,SAAS,IACd,MACA,OACA,MACmB;AACnB,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI;AACnC,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO;AAAA,IACP,UAAU,YAAY,OAAO,CAAC,QAAQ,IAAI,CAAC;AAAA,EAC7C;AACF;AAKO,SAAS,KACd,MACA,OACA,MACmB;AACnB,QAAM,EAAE,UAAU,GAAG,UAAU,IAAI;AACnC,SAAO;AAAA,IACL,UAAU;AAAA,IACV;AAAA,IACA,OAAO;AAAA,IACP,UAAU,MAAM,QAAQ,QAAQ,IAC5B,WACA,YAAY,OACV,CAAC,QAAQ,IACT,CAAC;AAAA,EACT;AACF;AAKO,IAAM,SAAS;AAKf,SAAS,SAAS,OAA4C;AACnE,SAAO,gBAAgB,MAAM,QAAQ;AACvC;AAMO,SAAS,cAAc,YAAyC;AACrE,MAAI,aAAa,UAAU,GAAG;AAC5B,UAAM,WAAW,kBAAkB,UAAU;AAC7C,QACE,YACA,OAAO,aAAa,YACpB,UAAU,YACV,SAAS,SAAS,QAClB;AACA,aAAO;AAAA,IACT;AAAA,EACF;AAGA,MACE,OAAO,eAAe,YACtB,eAAe,QACf,UAAU,cACT,WAA2B,SAAS,QACrC;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAKO,SAAS,MAAM,OAAyB;AAC7C,MAAI,aAAa,KAAK,GAAG;AACvB,WAAO;AAAA,EACT;AAEA,MACE,OAAO,UAAU,YACjB,UAAU,QACV,cAAc,SACd,OAAQ,MAAgC,aAAa,UACrD;AACA,UAAM,YAAa,MAA+B,SAAS,SAAS;AACpE,WACE,UAAU,SAAS,eAAe,KAClC,UAAU,SAAS,4BAA4B;AAAA,EAEnD;AACA,SAAO;AACT;","names":[]}

package/dist/index.d.ts

@@ -1,12 +1,11 @@
-import { C as CardElement, a as CardJSXElement, b as CardChild, A as Actions$1, B as Button$1, c as Card$1, T as Text$1, D as Divider$1, F as Field$1, d as Fields$1, f as fromReactElement$1, I as Image$1, i as isCardElement$1, e as isJSX$1, S as Section$1, t as toCardElement$1 } from './jsx-runtime-D7zHSnXe.js';
-export { g as ActionsElement, h as ButtonElement, j as ButtonOptions, k as ButtonStyle, l as CardOptions, m as DividerElement, n as FieldElement, o as FieldsElement, p as ImageElement, q as SectionElement, r as TextElement, s as TextStyle } from './jsx-runtime-D7zHSnXe.js';
-import { Root, Content, Blockquote, Code, Emphasis, InlineCode, Link, Paragraph, Delete, Strong, Text } from 'mdast';
+import { C as CardElement, a as CardJSXElement, b as CardChild, A as Actions$1, B as Button$1, c as Card$1, T as Text$1, D as Divider$1, F as Field$1, d as Fields$1, f as fromReactElement$1, I as Image$1, i as isCardElement$1, e as isJSX$1, S as Section$1, t as toCardElement$1 } from './jsx-runtime-BHBjDSKS.js';
+export { p as ActionsElement, q as ButtonElement, r as ButtonOptions, g as ButtonProps, s as ButtonStyle, h as CardJSXProps, u as CardOptions, j as CardProps, k as ContainerProps, v as DividerElement, l as DividerProps, w as FieldElement, m as FieldProps, x as FieldsElement, y as ImageElement, n as ImageProps, z as SectionElement, E as TextElement, o as TextProps, G as TextStyle } from './jsx-runtime-BHBjDSKS.js';
+import { Root, Content, Blockquote, Code, Emphasis, InlineCode, Delete, Link, ListItem, List, Paragraph, Strong, Text } from 'mdast';
 export { Blockquote, Code, Content, Delete, Emphasis, InlineCode, Link, List, ListItem, Paragraph, Root, Strong, Text } from 'mdast';
 
 /**
- * Core types for chat-sdk
+ * Logger types and implementations for chat-sdk
  */
-
 type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
 interface Logger {
     debug(message: string, ...args: unknown[]): void;
@@ -30,6 +29,31 @@ declare class ConsoleLogger implements Logger {
     warn(message: string, ...args: unknown[]): void;
     error(message: string, ...args: unknown[]): void;
 }
+
+/**
+ * Error types for chat-sdk
+ */
+declare class ChatError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: string, cause?: unknown | undefined);
+}
+declare class RateLimitError extends ChatError {
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, retryAfterMs?: number | undefined, cause?: unknown);
+}
+declare class LockError extends ChatError {
+    constructor(message: string, cause?: unknown);
+}
+declare class NotImplementedError extends ChatError {
+    readonly feature?: string | undefined;
+    constructor(message: string, feature?: string | undefined, cause?: unknown);
+}
+
+/**
+ * Core types for chat-sdk
+ */
+
 /**
  * Chat configuration with type-safe adapter inference.
  * @template TAdapters - Record of adapter name to adapter instance
@@ -42,10 +66,10 @@ interface ChatConfig<TAdapters extends Record<string, Adapter> = Record<string,
     /** State adapter for subscriptions and locking */
     state: StateAdapter;
     /**
-     * Logger instance or log level. Defaults to "info".
+     * Logger instance or log level.
      * Pass "silent" to disable all logging.
      */
-    logger?: Logger | LogLevel;
+    logger: Logger | LogLevel;
     /**
      * Update interval for fallback streaming (post + edit) in milliseconds.
      * Defaults to 500ms. Lower values provide smoother updates but may hit rate limits.
@@ -879,22 +903,6 @@ interface ActionEvent<TRawMessage = unknown> {
  * ```
  */
 type ActionHandler = (event: ActionEvent) => Promise<void>;
-declare class ChatError extends Error {
-    readonly code: string;
-    readonly cause?: unknown | undefined;
-    constructor(message: string, code: string, cause?: unknown | undefined);
-}
-declare class RateLimitError extends ChatError {
-    readonly retryAfterMs?: number | undefined;
-    constructor(message: string, retryAfterMs?: number | undefined, cause?: unknown);
-}
-declare class LockError extends ChatError {
-    constructor(message: string, cause?: unknown);
-}
-declare class NotImplementedError extends ChatError {
-    readonly feature?: string | undefined;
-    constructor(message: string, feature?: string | undefined, cause?: unknown);
-}
 
 /** Filter can be EmojiValue objects, emoji names, or raw emoji formats */
 type EmojiFilter = EmojiValue | string;
@@ -972,6 +980,12 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      * Gracefully shut down the chat instance.
      */
     shutdown(): Promise<void>;
+    /**
+     * Initialize the chat instance and all adapters.
+     * This is called automatically when handling webhooks, but can be called
+     * manually for non-webhook use cases (e.g., Gateway listeners).
+     */
+    initialize(): Promise<void>;
     /**
      * Register a handler for new @-mentions of the bot.
      *
@@ -1136,6 +1150,7 @@ declare class Chat<TAdapters extends Record<string, Adapter> = Record<string, Ad
      * - Slack: `U...` (e.g., "U03STHCA1JM")
      * - Teams: `29:...` (e.g., "29:198PbJuw...")
      * - Google Chat: `users/...` (e.g., "users/117994873354375860089")
+     * - Discord: numeric snowflake (e.g., "1033044521375764530")
      *
      * @param user - Platform-specific user ID string, or an Author object
      * @returns A Thread that can be used to post messages
@@ -1298,6 +1313,11 @@ declare class EmojiResolver {
      * Returns the first GChat format if multiple exist.
      */
     toGChat(emoji: EmojiValue | string): string;
+    /**
+     * Convert a normalized emoji (or EmojiValue) to Discord format (unicode).
+     * Discord uses unicode emoji, same as Google Chat.
+     */
+    toDiscord(emoji: EmojiValue | string): string;
     /**
      * Check if an emoji (in any format) matches a normalized emoji name or EmojiValue.
      */
@@ -1323,7 +1343,7 @@ declare const defaultEmojiResolver: EmojiResolver;
  * // Returns: "Thanks! 👍"
  * ```
  */
-declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams", resolver?: EmojiResolver): string;
+declare function convertEmojiPlaceholders(text: string, platform: "slack" | "gchat" | "teams" | "discord", resolver?: EmojiResolver): string;
 /** Base emoji object with well-known emoji as EmojiValue singletons */
 type BaseEmojiHelper = {
     [K in WellKnownEmoji]: EmojiValue;
@@ -1411,6 +1431,61 @@ declare const emoji: ExtendedEmojiHelper;
 
 type PostableMessageInput = AdapterPostableMessage;
 
+/**
+ * Type guard for text nodes.
+ */
+declare function isTextNode(node: Content): node is Text;
+/**
+ * Type guard for paragraph nodes.
+ */
+declare function isParagraphNode(node: Content): node is Paragraph;
+/**
+ * Type guard for strong (bold) nodes.
+ */
+declare function isStrongNode(node: Content): node is Strong;
+/**
+ * Type guard for emphasis (italic) nodes.
+ */
+declare function isEmphasisNode(node: Content): node is Emphasis;
+/**
+ * Type guard for delete (strikethrough) nodes.
+ */
+declare function isDeleteNode(node: Content): node is Delete;
+/**
+ * Type guard for inline code nodes.
+ */
+declare function isInlineCodeNode(node: Content): node is InlineCode;
+/**
+ * Type guard for code block nodes.
+ */
+declare function isCodeNode(node: Content): node is Code;
+/**
+ * Type guard for link nodes.
+ */
+declare function isLinkNode(node: Content): node is Link;
+/**
+ * Type guard for blockquote nodes.
+ */
+declare function isBlockquoteNode(node: Content): node is Blockquote;
+/**
+ * Type guard for list nodes.
+ */
+declare function isListNode(node: Content): node is List;
+/**
+ * Type guard for list item nodes.
+ */
+declare function isListItemNode(node: Content): node is ListItem;
+/**
+ * Get children from a content node that has children.
+ * Returns empty array for nodes without children.
+ * This eliminates the need for `as Content` casts in adapter converters.
+ */
+declare function getNodeChildren(node: Content): Content[];
+/**
+ * Get value from a content node that has a value property.
+ * Returns empty string for nodes without value.
+ */
+declare function getNodeValue(node: Content): string;
 /**
  * Parse markdown string into an AST.
  * Supports GFM (GitHub Flavored Markdown) for strikethrough, tables, etc.
@@ -1514,6 +1589,16 @@ interface MarkdownConverter extends FormatConverter {
 declare abstract class BaseFormatConverter implements FormatConverter {
     abstract fromAst(ast: Root): string;
     abstract toAst(platformText: string): Root;
+    /**
+     * Template method for implementing fromAst with a node converter.
+     * Iterates through AST children and converts each using the provided function.
+     * Joins results with double newlines (standard paragraph separation).
+     *
+     * @param ast - The AST to convert
+     * @param nodeConverter - Function to convert each Content node to string
+     * @returns Platform-formatted string
+     */
+    protected fromAstWithNodeConverter(ast: Root, nodeConverter: (node: Content) => string): string;
     extractPlainText(platformText: string): string;
     fromMarkdown(markdown: string): string;
     toMarkdown(platformText: string): string;
@@ -1557,4 +1642,4 @@ declare const isJSX: typeof isJSX$1;
 declare const Section: typeof Section$1;
 declare const toCardElement: typeof toCardElement$1;
 
-export { type ActionEvent, type ActionHandler, Actions, type Adapter, type AdapterPostableMessage, type Attachment, type Author, BaseFormatConverter, Button, Card, CardChild, CardElement, CardJSXElement, CardText, Chat, type ChatConfig, ChatError, type ChatInstance, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, Divider, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type FetchDirection, type FetchOptions, type FetchResult, Field, Fields, type FileUpload, type FormatConverter, type FormattedContent, Image, type Lock, LockError, type LogLevel, type Logger, type MarkdownConverter, type MentionHandler, type Message, type MessageHandler, type MessageMetadata, NotImplementedError, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, Section, type SentMessage, type StateAdapter, type StreamOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, type Thread, ThreadImpl, type ThreadInfo, type WebhookOptions, type WellKnownEmoji, blockquote, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, emoji, emphasis, fromReactElement, getEmoji, inlineCode, isCardElement, isJSX, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, text, toCardElement, toPlainText, walkAst };
+export { type ActionEvent, type ActionHandler, Actions, type Adapter, type AdapterPostableMessage, type Attachment, type Author, BaseFormatConverter, Button, Card, CardChild, CardElement, CardJSXElement, CardText, Chat, type ChatConfig, ChatError, type ChatInstance, ConsoleLogger, type CustomEmojiMap, DEFAULT_EMOJI_MAP, Divider, type Emoji, type EmojiFormats, type EmojiMapConfig, EmojiResolver, type EmojiValue, type FetchDirection, type FetchOptions, type FetchResult, Field, Fields, type FileUpload, type FormatConverter, type FormattedContent, Image, type Lock, LockError, type LogLevel, type Logger, type MarkdownConverter, type MentionHandler, type Message, type MessageHandler, type MessageMetadata, NotImplementedError, type PostableAst, type PostableCard, type PostableMarkdown, type PostableMessage, type PostableRaw, RateLimitError, type RawMessage, type ReactionEvent, type ReactionHandler, Section, type SentMessage, type StateAdapter, type StreamOptions, type SubscribedMessageHandler, THREAD_STATE_TTL_MS, type Thread, ThreadImpl, type ThreadInfo, type WebhookOptions, type WellKnownEmoji, blockquote, codeBlock, convertEmojiPlaceholders, createEmoji, defaultEmojiResolver, emoji, emphasis, fromReactElement, getEmoji, getNodeChildren, getNodeValue, inlineCode, isBlockquoteNode, isCardElement, isCodeNode, isDeleteNode, isEmphasisNode, isInlineCodeNode, isJSX, isLinkNode, isListItemNode, isListNode, isParagraphNode, isStrongNode, isTextNode, link, markdownToPlainText, paragraph, parseMarkdown, root, strikethrough, stringifyMarkdown, strong, text, toCardElement, toPlainText, walkAst };