chat 4.16.1 → 4.17.0

package/dist/{jsx-runtime-Bokk9xw5.d.ts → jsx-runtime-BJENDuXl.d.ts}

@@ -499,12 +499,12 @@ interface CardProps {
 }
 /** Props for Text component in JSX */
 interface TextProps {
-    children?: string | number;
+    children?: string | number | (string | number | undefined)[];
     style?: TextStyle;
 }
 /** Props for Button component in JSX */
 interface ButtonProps {
-    children?: string | number;
+    children?: string | number | (string | number | undefined)[];
     id: string;
     label?: string;
     style?: ButtonStyle;
@@ -512,14 +512,14 @@ interface ButtonProps {
 }
 /** Props for LinkButton component in JSX */
 interface LinkButtonProps {
-    children?: string | number;
+    children?: string | number | (string | number | undefined)[];
     label?: string;
     style?: ButtonStyle;
     url: string;
 }
 /** Props for CardLink component in JSX */
 interface CardLinkProps {
-    children?: string | number;
+    children?: string | number | (string | number | undefined)[];
     label?: string;
     url: string;
 }
@@ -588,7 +588,87 @@ interface CardJSXElement<P extends CardJSXProps = CardJSXProps> {
     props: P;
     type: CardComponentFunction;
 }
-type JSXElement = CardJSXElement;
+/** Union of all element types that can be produced by chat components */
+type ChatElement = CardJSXElement | CardElement | TextElement | ButtonElement | LinkButtonElement | LinkElement | ImageElement | DividerElement | ActionsElement | SectionElement | FieldsElement | FieldElement | ModalElement | TextInputElement | SelectElement | SelectOptionElement | RadioSelectElement;
+interface CardComponent {
+    (options?: CardOptions): CardElement;
+    (props: CardProps): ChatElement;
+}
+interface TextComponent {
+    (content: string, options?: {
+        style?: TextStyle;
+    }): TextElement;
+    (props: TextProps): ChatElement;
+}
+interface ButtonComponent {
+    (options: ButtonOptions): ButtonElement;
+    (props: ButtonProps): ChatElement;
+}
+interface LinkButtonComponent {
+    (options: LinkButtonOptions): LinkButtonElement;
+    (props: LinkButtonProps): ChatElement;
+}
+interface CardLinkComponent {
+    (options: {
+        url: string;
+        label: string;
+    }): LinkElement;
+    (props: CardLinkProps): ChatElement;
+}
+interface ImageComponent {
+    (options: {
+        url: string;
+        alt?: string;
+    }): ImageElement;
+    (props: ImageProps): ChatElement;
+}
+interface FieldComponent {
+    (options: {
+        label: string;
+        value: string;
+    }): FieldElement;
+    (props: FieldProps): ChatElement;
+}
+interface DividerComponent {
+    (): DividerElement;
+    (props: DividerProps): ChatElement;
+}
+interface SectionComponent {
+    (children: CardChild[]): SectionElement;
+    (props: ContainerProps): ChatElement;
+}
+interface ActionsComponent {
+    (children: (ButtonElement | LinkButtonElement | SelectElement | RadioSelectElement)[]): ActionsElement;
+    (props: ContainerProps): ChatElement;
+}
+interface FieldsComponent {
+    (children: FieldElement[]): FieldsElement;
+    (props: ContainerProps): ChatElement;
+}
+interface ModalComponent {
+    (options: ModalOptions): ModalElement;
+    (props: ModalProps): ChatElement;
+}
+interface TextInputComponent {
+    (options: TextInputOptions): TextInputElement;
+    (props: TextInputProps): ChatElement;
+}
+interface SelectComponent {
+    (options: SelectOptions): SelectElement;
+    (props: SelectProps): ChatElement;
+}
+interface SelectOptionComponent {
+    (options: {
+        label: string;
+        value: string;
+        description?: string;
+    }): SelectOptionElement;
+    (props: SelectOptionProps): ChatElement;
+}
+interface RadioSelectComponent {
+    (options: RadioSelectOptions): RadioSelectElement;
+    (props: SelectProps): ChatElement;
+}
 /**
  * Type guard to check if props match CardLinkProps
  */
@@ -627,12 +707,14 @@ declare function toModalElement(jsxElement: unknown): ModalElement | null;
  */
 declare function isJSX(value: unknown): boolean;
 declare namespace JSX {
-    interface Element extends JSXElement {
-    }
+    type Element = ChatElement;
     type IntrinsicElements = {};
+    interface IntrinsicAttributes {
+        key?: string | number;
+    }
     interface ElementChildrenAttribute {
         children: {};
     }
 }
 
-export { type FieldProps as $, Actions as A, Button as B, type CardElement as C, Divider as D, type ImageElement as E, Field as F, type LinkButtonElement as G, type LinkButtonOptions as H, Image as I, type LinkElement as J, type SectionElement as K, LinkButton as L, type ModalElement as M, type TableAlignment as N, type TableElement as O, type TableOptions as P, type TextElement as Q, RadioSelect as R, Section as S, Text as T, type TextStyle as U, type ButtonProps as V, type CardJSXProps as W, type CardLinkProps as X, type CardProps as Y, type ContainerProps as Z, type DividerProps as _, type CardJSXElement as a, type ImageProps as a0, type LinkButtonProps as a1, type TextProps as a2, type ModalChild as a3, type ModalOptions as a4, type RadioSelectElement as a5, type RadioSelectOptions as a6, type SelectElement as a7, type SelectOptionElement as a8, type SelectOptions as a9, type TextInputElement as aa, type TextInputOptions as ab, type ModalProps as ac, type TextInputProps as ad, type SelectProps as ae, type SelectOptionProps as af, isCardLinkProps as ag, jsx as ah, jsxs as ai, jsxDEV as aj, Fragment as ak, JSX as al, type CardChild as b, Card as c, cardChildToFallbackText as d, CardLink as e, Fields as f, fromReactElement as g, isJSX as h, isCardElement as i, Table as j, toModalElement as k, fromReactModalElement as l, isModalElement as m, Modal as n, Select as o, SelectOption as p, TextInput as q, type ActionsElement as r, type ButtonElement as s, toCardElement as t, type ButtonOptions as u, type ButtonStyle as v, type CardOptions as w, type DividerElement as x, type FieldElement as y, type FieldsElement as z };
+export { type DividerProps as $, type ActionsComponent as A, type ButtonComponent as B, type CardElement as C, type DividerComponent as D, type ImageElement as E, type FieldComponent as F, type LinkButtonElement as G, type LinkButtonOptions as H, type ImageComponent as I, type LinkElement as J, type SectionElement as K, type LinkButtonComponent as L, type ModalElement as M, type TableAlignment as N, type TableElement as O, type TableOptions as P, type TextElement as Q, type RadioSelectComponent as R, type SectionComponent as S, type TextComponent as T, type TextStyle as U, type ButtonProps as V, type CardJSXElement as W, type CardJSXProps as X, type CardLinkProps as Y, type CardProps as Z, type ContainerProps as _, type ChatElement as a, type FieldProps as a0, type ImageProps as a1, type LinkButtonProps as a2, type ModalProps as a3, type SelectOptionProps as a4, type SelectProps as a5, type TextInputProps as a6, type TextProps as a7, type ModalChild as a8, type ModalOptions as a9, type RadioSelectElement as aa, type RadioSelectOptions as ab, type SelectElement as ac, type SelectOptionElement as ad, type SelectOptions as ae, type TextInputElement as af, type TextInputOptions as ag, isCardLinkProps as ah, jsx as ai, jsxs as aj, jsxDEV as ak, Fragment as al, JSX as am, type CardChild as b, type CardComponent as c, cardChildToFallbackText as d, type CardLinkComponent as e, type FieldsComponent as f, fromReactElement as g, isJSX as h, isCardElement as i, Table as j, toModalElement as k, fromReactModalElement as l, isModalElement as m, type ModalComponent as n, type SelectComponent as o, type SelectOptionComponent as p, type TextInputComponent as q, type ActionsElement as r, type ButtonElement as s, toCardElement as t, type ButtonOptions as u, type ButtonStyle as v, type CardOptions as w, type DividerElement as x, type FieldElement as y, type FieldsElement as z };

package/dist/jsx-runtime.d.ts

@@ -1 +1 @@
-export { V as ButtonProps, a as CardJSXElement, W as CardJSXProps, X as CardLinkProps, Y as CardProps, Z as ContainerProps, _ as DividerProps, $ as FieldProps, ak as Fragment, a0 as ImageProps, al as JSX, a1 as LinkButtonProps, ac as ModalProps, af as SelectOptionProps, ae as SelectProps, ad as TextInputProps, a2 as TextProps, ag as isCardLinkProps, h as isJSX, ah as jsx, aj as jsxDEV, ai as jsxs, t as toCardElement, k as toModalElement } from './jsx-runtime-Bokk9xw5.js';
+export { A as ActionsComponent, B as ButtonComponent, V as ButtonProps, c as CardComponent, W as CardJSXElement, X as CardJSXProps, e as CardLinkComponent, Y as CardLinkProps, Z as CardProps, a as ChatElement, _ as ContainerProps, D as DividerComponent, $ as DividerProps, F as FieldComponent, a0 as FieldProps, f as FieldsComponent, al as Fragment, I as ImageComponent, a1 as ImageProps, am as JSX, L as LinkButtonComponent, a2 as LinkButtonProps, n as ModalComponent, a3 as ModalProps, R as RadioSelectComponent, S as SectionComponent, o as SelectComponent, p as SelectOptionComponent, a4 as SelectOptionProps, a5 as SelectProps, T as TextComponent, q as TextInputComponent, a6 as TextInputProps, a7 as TextProps, ah as isCardLinkProps, h as isJSX, ai as jsx, ak as jsxDEV, aj as jsxs, t as toCardElement, k as toModalElement } from './jsx-runtime-BJENDuXl.js';

package/dist/jsx-runtime.js

@@ -7,7 +7,7 @@ import {
   jsxs,
   toCardElement,
   toModalElement
-} from "./chunk-A2J5CUHD.js";
+} from "./chunk-Q32GJ2PR.js";
 export {
   Fragment,
   isCardLinkProps,

package/docs/adapters/teams.mdx

@@ -140,12 +140,67 @@ All options are auto-detected from environment variables when not provided.
 | Option | Required | Description |
 |--------|----------|-------------|
 | `appId` | No* | Azure Bot App ID. Auto-detected from `TEAMS_APP_ID` |
-| `appPassword` | No* | Azure Bot App Password. Auto-detected from `TEAMS_APP_PASSWORD` |
+| `appPassword` | No** | Azure Bot App Password. Auto-detected from `TEAMS_APP_PASSWORD` |
+| `certificate` | No** | Certificate-based authentication config |
+| `federated` | No** | Federated (workload identity) authentication config |
 | `appType` | No | `"MultiTenant"` or `"SingleTenant"` (default: `"MultiTenant"`) |
 | `appTenantId` | For SingleTenant | Azure AD Tenant ID. Auto-detected from `TEAMS_APP_TENANT_ID` |
 | `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
 
-*`appId` and `appPassword` are required — either via config or env vars.
+\*`appId` is required — either via config or `TEAMS_APP_ID` env var.
+
+\*\*Exactly one authentication method is required: `appPassword`, `certificate`, or `federated`.
+
+### Authentication methods
+
+The adapter supports three mutually exclusive authentication methods. When no explicit auth is provided, `TEAMS_APP_PASSWORD` is auto-detected from environment variables.
+
+#### Client secret (default)
+
+The simplest option — provide `appPassword` directly or set `TEAMS_APP_PASSWORD`:
+
+```typescript title="lib/bot.ts"
+createTeamsAdapter({
+  appPassword: "your_app_password_here",
+});
+```
+
+#### Certificate
+
+Authenticate with a PEM certificate. Provide either `certificateThumbprint` or `x5c` (public certificate for subject-name validation):
+
+```typescript title="lib/bot.ts"
+createTeamsAdapter({
+  certificate: {
+    certificatePrivateKey: "-----BEGIN RSA PRIVATE KEY-----\n...",
+    certificateThumbprint: "AB1234...", // hex-encoded thumbprint
+  },
+});
+```
+
+Or with subject-name validation:
+
+```typescript title="lib/bot.ts"
+createTeamsAdapter({
+  certificate: {
+    certificatePrivateKey: "-----BEGIN RSA PRIVATE KEY-----\n...",
+    x5c: "-----BEGIN CERTIFICATE-----\n...",
+  },
+});
+```
+
+#### Federated (workload identity)
+
+For environments with managed identities (e.g. Azure Kubernetes Service, GitHub Actions):
+
+```typescript title="lib/bot.ts"
+createTeamsAdapter({
+  federated: {
+    clientId: "your_managed_identity_client_id_here",
+    clientAudience: "api://AzureADTokenExchange", // optional, this is the default
+  },
+});
+```
 
 ## Environment variables
 
@@ -212,7 +267,10 @@ Alternatively, configure the bot in Azure to receive all messages.
 
 ### "Unauthorized" error
 
-- Verify `TEAMS_APP_ID` and `TEAMS_APP_PASSWORD` are correct
+- Verify `TEAMS_APP_ID` and your chosen auth credential are correct
+- For client secret auth, check that `TEAMS_APP_PASSWORD` is valid
+- For certificate auth, ensure the private key and thumbprint/x5c match what's registered in Azure AD
+- For federated auth, verify the managed identity client ID and audience are correct
 - For SingleTenant apps, ensure `TEAMS_APP_TENANT_ID` is set
 - Check that the messaging endpoint URL is correct in Azure
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat",
-  "version": "4.16.1",
+  "version": "4.17.0",
   "description": "Unified chat abstraction for Slack, Teams, Google Chat, and Discord",
   "type": "module",
   "main": "./dist/index.js",