@knocklabs/react-core 0.3.0-rc.0 → 0.3.1

package/dist/types/modules/i18n/languages/en.d.ts

@@ -1,5 +1,4 @@
 import { I18nContent } from '.';
-
 declare const en: I18nContent;
 export default en;
 //# sourceMappingURL=en.d.ts.map

package/dist/types/modules/i18n/languages/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/modules/i18n/languages/en.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;AAEhC,QAAA,MAAM,EAAE,EAAE,WAsCT,CAAC;AAEF,eAAe,EAAE,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/modules/i18n/languages/en.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,CAAC;AAEhC,QAAA,MAAM,EAAE,EAAE,WAgDT,CAAC;AAEF,eAAe,EAAE,CAAC"}

package/dist/types/modules/i18n/languages/index.d.ts

@@ -10,6 +10,15 @@ export interface Translations {
     readonly unread: string;
     readonly read: string;
     readonly unseen: string;
+    readonly msTeamsConnect: string;
+    readonly msTeamsConnected: string;
+    readonly msTeamsConnecting: string;
+    readonly msTeamsConnectContainerDescription: string;
+    readonly msTeamsDisconnect: string;
+    readonly msTeamsDisconnecting: string;
+    readonly msTeamsError: string;
+    readonly msTeamsReconnect: string;
+    readonly msTeamsTenantIdNotSet: string;
     readonly slackConnectChannel: string;
     readonly slackChannelId: string;
     readonly slackConnecting: string;

package/dist/types/modules/i18n/languages/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/i18n/languages/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,iCAAiC,EAAE,MAAM,CAAC;IACnD,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,OAAO;;;CAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/i18n/languages/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kCAAkC,EAAE,MAAM,CAAC;IACpD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,8BAA8B,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,iCAAiC,EAAE,MAAM,CAAC;IACnD,QAAQ,CAAC,6BAA6B,EAAE,MAAM,CAAC;IAC/C,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,OAAO;;;CAAa,CAAC"}

package/dist/types/modules/ms-teams/context/KnockMsTeamsProvider.d.ts

@@ -0,0 +1,20 @@
+import { PropsWithChildren } from 'react';
+import { ConnectionStatus } from '../hooks/useMsTeamsConnectionStatus';
+import * as React from "react";
+export interface KnockMsTeamsProviderState {
+    knockMsTeamsChannelId: string;
+    tenantId: string;
+    connectionStatus: ConnectionStatus;
+    setConnectionStatus: (connectionStatus: ConnectionStatus) => void;
+    errorLabel: string | null;
+    setErrorLabel: (label: string) => void;
+    actionLabel: string | null;
+    setActionLabel: (label: string | null) => void;
+}
+export interface KnockMsTeamsProviderProps {
+    knockMsTeamsChannelId: string;
+    tenantId: string;
+}
+export declare const KnockMsTeamsProvider: React.FC<PropsWithChildren<KnockMsTeamsProviderProps>>;
+export declare const useKnockMsTeamsClient: () => KnockMsTeamsProviderState;
+//# sourceMappingURL=KnockMsTeamsProvider.d.ts.map

package/dist/types/modules/ms-teams/context/KnockMsTeamsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnockMsTeamsProvider.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/context/KnockMsTeamsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAK1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CAChD;AAKD,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CACzC,iBAAiB,CAAC,yBAAyB,CAAC,CAmC7C,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,yBAQxC,CAAC"}

package/dist/types/modules/ms-teams/context/index.d.ts

@@ -0,0 +1,2 @@
+export * from './KnockMsTeamsProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/modules/ms-teams/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/types/modules/ms-teams/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { default as useMsTeamsConnectionStatus } from './useMsTeamsConnectionStatus';
+export { default as useMsTeamsAuth } from './useMsTeamsAuth';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/modules/ms-teams/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/modules/ms-teams/hooks/useMsTeamsAuth.d.ts

@@ -0,0 +1,7 @@
+interface UseMsTeamsAuthOutput {
+    buildMsTeamsAuthUrl: () => string;
+    disconnectFromMsTeams: () => void;
+}
+declare function useMsTeamsAuth(msTeamsBotId: string, redirectUrl?: string): UseMsTeamsAuthOutput;
+export default useMsTeamsAuth;
+//# sourceMappingURL=useMsTeamsAuth.d.ts.map

package/dist/types/modules/ms-teams/hooks/useMsTeamsAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMsTeamsAuth.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/hooks/useMsTeamsAuth.ts"],"names":[],"mappings":"AAWA,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,IAAI,CAAC;CACnC;AAED,iBAAS,cAAc,CACrB,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,oBAAoB,CA8DtB;AAED,eAAe,cAAc,CAAC"}

package/dist/types/modules/ms-teams/hooks/useMsTeamsConnectionStatus.d.ts

@@ -0,0 +1,13 @@
+import { default as Knock } from '@knocklabs/client';
+export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "error" | "disconnecting";
+type UseMsTeamsConnectionStatusOutput = {
+    connectionStatus: ConnectionStatus;
+    setConnectionStatus: (status: ConnectionStatus) => void;
+    errorLabel: string | null;
+    setErrorLabel: (errorLabel: string) => void;
+    actionLabel: string | null;
+    setActionLabel: (actionLabel: string | null) => void;
+};
+declare function useMsTeamsConnectionStatus(knock: Knock, knockMsTeamsChannelId: string, tenantId: string): UseMsTeamsConnectionStatusOutput;
+export default useMsTeamsConnectionStatus;
+//# sourceMappingURL=useMsTeamsConnectionStatus.d.ts.map

package/dist/types/modules/ms-teams/hooks/useMsTeamsConnectionStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMsTeamsConnectionStatus.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/hooks/useMsTeamsConnectionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAKtC,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,OAAO,GACP,eAAe,CAAC;AAEpB,KAAK,gCAAgC,GAAG;IACtC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,mBAAmB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,iBAAS,0BAA0B,CACjC,KAAK,EAAE,KAAK,EACZ,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,EAAE,MAAM,GACf,gCAAgC,CAsDlC;AAED,eAAe,0BAA0B,CAAC"}

package/dist/types/modules/ms-teams/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/ms-teams/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/types/modules/slack/hooks/useConnectedSlackChannels.d.ts

@@ -1,6 +1,5 @@
 import { ContainerObject } from '..';
 import { SlackChannelConnection } from '@knocklabs/client';
-
 type UseSlackChannelsProps = {
     slackChannelsRecipientObject: ContainerObject;
 };

package/dist/types/modules/slack/hooks/useSlackChannels.d.ts

@@ -1,6 +1,5 @@
 import { SlackChannelQueryOptions } from '..';
 import { SlackChannel } from '@knocklabs/client';
-
 type UseSlackChannelsProps = {
     queryOptions?: SlackChannelQueryOptions;
 };

package/dist/types/modules/slack/hooks/useSlackConnectionStatus.d.ts

@@ -1,5 +1,4 @@
 import { default as Knock } from '@knocklabs/client';
-
 export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "error" | "disconnecting";
 type UseSlackConnectionStatusOutput = {
     connectionStatus: ConnectionStatus;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@knocklabs/react-core",
   "description": "A set of React components to build notification experiences powered by Knock",
   "author": "@knocklabs",
-  "version": "0.3.0-rc.0",
+  "version": "0.3.1",
   "license": "MIT",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.mjs",
@@ -49,8 +49,7 @@
     "react": "^16.11.0 || ^17.0.0 || ^18.0.0"
   },
   "dependencies": {
-    "@knocklabs/client": "^0.11.0-rc.0",
-    "@tanstack/react-store": "^0.5.5",
+    "@knocklabs/client": "^0.11.1",
     "date-fns": "^4.0.0",
     "swr": "^2.2.5",
     "zustand": "^3.7.2"
@@ -58,21 +57,21 @@
   "devDependencies": {
     "@testing-library/react": "^14.2.0",
     "@types/react": "^18.3.6",
-    "@typescript-eslint/eslint-plugin": "^6.20.0",
-    "@typescript-eslint/parser": "^8.8.1",
-    "@vitejs/plugin-react": "^4.3.2",
+    "@typescript-eslint/eslint-plugin": "^8.19.1",
+    "@typescript-eslint/parser": "^8.16.0",
+    "@vitejs/plugin-react": "^4.3.4",
     "babel-plugin-react-require": "^4.0.3",
     "eslint": "^8.56.0",
-    "eslint-plugin-react-hooks": "^4.6.0",
-    "eslint-plugin-react-refresh": "^0.4.4",
-    "jsdom": "^24.0.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.14",
+    "jsdom": "^25.0.1",
     "react": "^18.2.0",
     "rimraf": "^6.0.1",
     "rollup-plugin-execute": "^1.1.1",
-    "typescript": "^5.6.2",
+    "typescript": "^5.7.3",
     "vite": "^5.0.0",
-    "vite-plugin-dts": "^3.6.3",
+    "vite-plugin-dts": "^4.3.0",
     "vite-plugin-no-bundle": "^4.0.0",
-    "vitest": "^2.0.5"
+    "vitest": "^2.1.8"
   }
 }

package/src/index.ts

@@ -1,5 +1,5 @@
 export * from "./modules/core";
 export * from "./modules/feed";
-export * from "./modules/in-app-messages";
+export * from "./modules/ms-teams";
 export * from "./modules/slack";
 export * from "./modules/i18n";

package/src/modules/core/context/KnockProvider.tsx

@@ -9,21 +9,21 @@ export interface KnockProviderState {
   knock: Knock;
 }
 
-const KnockContext = React.createContext<KnockProviderState | null>(null);
+const ProviderStateContext = React.createContext<KnockProviderState | null>(
+  null,
+);
 
 export interface KnockProviderProps {
   // Knock client props
   apiKey: string;
   host?: string;
   // Authentication props
-  userId: string;
-  userToken?: string;
+  userId: Knock["userId"];
+  userToken?: Knock["userToken"];
   onUserTokenExpiring?: AuthenticateOptions["onUserTokenExpiring"];
   timeBeforeExpirationInMs?: AuthenticateOptions["timeBeforeExpirationInMs"];
-
   // i18n translations
   i18n?: I18nContent;
-
   logLevel?: LogLevel;
 }
 
@@ -57,20 +57,20 @@ export const KnockProvider: React.FC<PropsWithChildren<KnockProviderProps>> = ({
   );
 
   return (
-    <KnockContext.Provider
+    <ProviderStateContext.Provider
       value={{
         knock,
       }}
     >
       <KnockI18nProvider i18n={i18n}>{children}</KnockI18nProvider>
-    </KnockContext.Provider>
+    </ProviderStateContext.Provider>
   );
 };
 
 export const useKnockClient = (): Knock => {
-  const context = React.useContext(KnockContext);
-  if (!context) {
-    throw new Error("useKnockClient must be used within a KnockProvider");
+  const context = React.useContext(ProviderStateContext) as KnockProviderState;
+  if (context === undefined) {
+    throw new Error("useKnock must be used within a KnockProvider");
   }
   return context.knock;
 };

package/src/modules/core/hooks/useAuthenticatedKnockClient.ts

@@ -5,8 +5,8 @@ import { useStableOptions } from "../../core";
 
 function authenticateWithOptions(
   knock: Knock,
-  userId: string,
-  userToken?: string,
+  userId: Knock["userId"],
+  userToken?: Knock["userToken"],
   options: AuthenticateOptions = {},
 ) {
   knock.authenticate(userId, userToken, {
@@ -20,8 +20,8 @@ export type AuthenticatedKnockClientOptions = KnockOptions &
 
 function useAuthenticatedKnockClient(
   apiKey: string,
-  userId: string,
-  userToken?: string,
+  userId: Knock["userId"],
+  userToken?: Knock["userToken"],
   options: AuthenticatedKnockClientOptions = {},
 ) {
   const knockRef = React.useRef<Knock | undefined>();

package/src/modules/core/utils.ts

@@ -1,4 +1,4 @@
-import { FeedClientOptions } from "@knocklabs/client";
+import Knock, { FeedClientOptions } from "@knocklabs/client";
 import { intlFormatDistance, parseISO } from "date-fns";
 import { ReactNode } from "react";
 
@@ -21,7 +21,7 @@ export function formatTimestamp(
     });
 
     return formatted;
-  } catch (e) {
+  } catch (_e) {
     return ts;
   }
 }
@@ -39,7 +39,7 @@ export function renderNodeOrFallback(node: ReactNode, fallback: ReactNode) {
   to trigger a re-render of the context when a key property changes.
 */
 export function feedProviderKey(
-  userId: string | undefined,
+  userId: Knock["userId"],
   feedId: string,
   options: FeedClientOptions = {},
 ) {
@@ -74,3 +74,23 @@ export function slackProviderKey({
     .filter((f) => f !== null && f !== undefined)
     .join("-");
 }
+
+/*
+  Used to build a consistent key for the KnockMsTeamsProvider so that React knows when
+  to trigger a re-render of the context when a key property changes.
+*/
+export function msTeamsProviderKey({
+  knockMsTeamsChannelId,
+  tenantId,
+  connectionStatus,
+  errorLabel,
+}: {
+  knockMsTeamsChannelId: string;
+  tenantId: string;
+  connectionStatus: string;
+  errorLabel: string | null;
+}) {
+  return [knockMsTeamsChannelId, tenantId, connectionStatus, errorLabel]
+    .filter((f) => f !== null && f !== undefined)
+    .join("-");
+}

package/src/modules/feed/context/KnockFeedProvider.tsx

@@ -20,7 +20,7 @@ export interface KnockFeedProviderState {
   colorMode: ColorMode;
 }
 
-const KnockFeedContext = React.createContext<
+const FeedStateContext = React.createContext<
   KnockFeedProviderState | undefined
 >(undefined);
 
@@ -38,18 +38,12 @@ export interface KnockFeedProviderProps {
 export const KnockFeedProvider: React.FC<
   PropsWithChildren<KnockFeedProviderProps>
 > = ({ feedId, children, defaultFeedOptions = {}, colorMode = "light" }) => {
-  let knock: Knock;
-  try {
-    knock = useKnockClient();
-  } catch (error) {
-    throw new Error("KnockFeedProvider must be used within a KnockProvider.");
-  }
-
+  const knock = useKnockClient();
   const feedClient = useNotifications(knock, feedId, defaultFeedOptions);
   const useFeedStore = useCreateNotificationStore(feedClient);
 
   return (
-    <KnockFeedContext.Provider
+    <FeedStateContext.Provider
       key={feedProviderKey(knock.userId, feedId, defaultFeedOptions)}
       value={{
         knock,
@@ -59,12 +53,13 @@ export const KnockFeedProvider: React.FC<
       }}
     >
       {children}
-    </KnockFeedContext.Provider>
+    </FeedStateContext.Provider>
   );
 };
 
 export const useKnockFeed = (): KnockFeedProviderState => {
-  const context = React.useContext(KnockFeedContext);
+  const context = React.useContext(FeedStateContext);
+
   if (!context) {
     throw new Error("useKnockFeed must be used within a KnockFeedProvider");
   }

package/src/modules/i18n/languages/en.ts

@@ -12,6 +12,16 @@ const en: I18nContent = {
     unread: "Unread",
     read: "Read",
     unseen: "Unseen",
+    msTeamsConnect: "Connect to Microsoft Teams",
+    msTeamsConnected: "Connected",
+    msTeamsConnecting: "Connecting to Microsoft Teams…",
+    msTeamsConnectContainerDescription:
+      "Connect to get notifications in Microsoft Teams",
+    msTeamsDisconnect: "Disconnect",
+    msTeamsDisconnecting: "Disconnecting from Microsoft Teams…",
+    msTeamsError: "Error",
+    msTeamsReconnect: "Reconnect",
+    msTeamsTenantIdNotSet: "Microsoft Teams tenant ID not set.",
     slackConnectChannel: "Connect channel",
     slackChannelId: "Slack channel ID",
     slackConnecting: "Connecting to Slack...",

package/src/modules/i18n/languages/index.ts

@@ -13,6 +13,15 @@ export interface Translations {
   readonly unread: string;
   readonly read: string;
   readonly unseen: string;
+  readonly msTeamsConnect: string;
+  readonly msTeamsConnected: string;
+  readonly msTeamsConnecting: string;
+  readonly msTeamsConnectContainerDescription: string;
+  readonly msTeamsDisconnect: string;
+  readonly msTeamsDisconnecting: string;
+  readonly msTeamsError: string;
+  readonly msTeamsReconnect: string;
+  readonly msTeamsTenantIdNotSet: string;
   readonly slackConnectChannel: string;
   readonly slackChannelId: string;
   readonly slackConnecting: string;

package/src/modules/ms-teams/context/KnockMsTeamsProvider.tsx

@@ -0,0 +1,74 @@
+import * as React from "react";
+import { PropsWithChildren } from "react";
+
+import { useKnockClient } from "../../core";
+import { msTeamsProviderKey } from "../../core/utils";
+import { useMsTeamsConnectionStatus } from "../hooks";
+import { ConnectionStatus } from "../hooks/useMsTeamsConnectionStatus";
+
+export interface KnockMsTeamsProviderState {
+  knockMsTeamsChannelId: string;
+  tenantId: string;
+  connectionStatus: ConnectionStatus;
+  setConnectionStatus: (connectionStatus: ConnectionStatus) => void;
+  errorLabel: string | null;
+  setErrorLabel: (label: string) => void;
+  actionLabel: string | null;
+  setActionLabel: (label: string | null) => void;
+}
+
+const MsTeamsProviderStateContext =
+  React.createContext<KnockMsTeamsProviderState | null>(null);
+
+export interface KnockMsTeamsProviderProps {
+  knockMsTeamsChannelId: string;
+  tenantId: string;
+}
+
+export const KnockMsTeamsProvider: React.FC<
+  PropsWithChildren<KnockMsTeamsProviderProps>
+> = ({ knockMsTeamsChannelId, tenantId, children }) => {
+  const knock = useKnockClient();
+
+  const {
+    connectionStatus,
+    setConnectionStatus,
+    errorLabel,
+    setErrorLabel,
+    actionLabel,
+    setActionLabel,
+  } = useMsTeamsConnectionStatus(knock, knockMsTeamsChannelId, tenantId);
+
+  return (
+    <MsTeamsProviderStateContext.Provider
+      key={msTeamsProviderKey({
+        knockMsTeamsChannelId,
+        tenantId,
+        connectionStatus,
+        errorLabel,
+      })}
+      value={{
+        connectionStatus,
+        setConnectionStatus,
+        errorLabel,
+        setErrorLabel,
+        actionLabel,
+        setActionLabel,
+        knockMsTeamsChannelId,
+        tenantId,
+      }}
+    >
+      {children}
+    </MsTeamsProviderStateContext.Provider>
+  );
+};
+
+export const useKnockMsTeamsClient = (): KnockMsTeamsProviderState => {
+  const context = React.useContext(MsTeamsProviderStateContext);
+  if (!context) {
+    throw new Error(
+      "useKnockMsTeamsClient must be used within a KnockMsTeamsProvider",
+    );
+  }
+  return context;
+};

package/src/modules/ms-teams/context/index.ts

@@ -0,0 +1 @@
+export * from "./KnockMsTeamsProvider";

package/src/modules/ms-teams/hooks/index.ts

@@ -0,0 +1,2 @@
+export { default as useMsTeamsConnectionStatus } from "./useMsTeamsConnectionStatus";
+export { default as useMsTeamsAuth } from "./useMsTeamsAuth";

package/src/modules/ms-teams/hooks/useMsTeamsAuth.ts

@@ -0,0 +1,84 @@
+import { useKnockMsTeamsClient } from "..";
+import { TENANT_OBJECT_COLLECTION } from "@knocklabs/client";
+import { useCallback, useMemo } from "react";
+
+import { useKnockClient } from "../../core";
+
+const MS_TEAMS_ADMINCONSENT_URL =
+  "https://login.microsoftonline.com/organizations/adminconsent";
+
+const AUTH_REDIRECT_PATH = "/providers/ms-teams/authenticate";
+
+interface UseMsTeamsAuthOutput {
+  buildMsTeamsAuthUrl: () => string;
+  disconnectFromMsTeams: () => void;
+}
+
+function useMsTeamsAuth(
+  msTeamsBotId: string,
+  redirectUrl?: string,
+): UseMsTeamsAuthOutput {
+  const knock = useKnockClient();
+  const {
+    setConnectionStatus,
+    knockMsTeamsChannelId,
+    tenantId,
+    setActionLabel,
+  } = useKnockMsTeamsClient();
+
+  const authRedirectUri = useMemo(
+    () => knock.host + AUTH_REDIRECT_PATH,
+    [knock.host],
+  );
+
+  const buildMsTeamsAuthUrl = useCallback(() => {
+    const rawParams = {
+      state: JSON.stringify({
+        redirect_url: redirectUrl,
+        ms_teams_tenant_object: {
+          object_id: tenantId,
+          collection: TENANT_OBJECT_COLLECTION,
+        },
+        channel_id: knockMsTeamsChannelId,
+        public_key: knock.apiKey,
+        user_token: knock.userToken,
+      }),
+      client_id: msTeamsBotId,
+      redirect_uri: authRedirectUri,
+    };
+    return `${MS_TEAMS_ADMINCONSENT_URL}?${new URLSearchParams(rawParams)}`;
+  }, [
+    redirectUrl,
+    tenantId,
+    knockMsTeamsChannelId,
+    knock.apiKey,
+    knock.userToken,
+    msTeamsBotId,
+    authRedirectUri,
+  ]);
+
+  const disconnectFromMsTeams = useCallback(async () => {
+    setActionLabel(null);
+    setConnectionStatus("disconnecting");
+    try {
+      const revokeResult = await knock.msTeams.revokeAccessToken({
+        tenant: tenantId,
+        knockChannelId: knockMsTeamsChannelId,
+      });
+
+      setConnectionStatus(revokeResult === "ok" ? "disconnected" : "error");
+    } catch (_error) {
+      setConnectionStatus("error");
+    }
+  }, [
+    setConnectionStatus,
+    knock.msTeams,
+    tenantId,
+    knockMsTeamsChannelId,
+    setActionLabel,
+  ]);
+
+  return { buildMsTeamsAuthUrl, disconnectFromMsTeams };
+}
+
+export default useMsTeamsAuth;

package/src/modules/ms-teams/hooks/useMsTeamsConnectionStatus.ts

@@ -0,0 +1,82 @@
+import Knock from "@knocklabs/client";
+import { useEffect, useState } from "react";
+
+import { useTranslations } from "../../i18n";
+
+export type ConnectionStatus =
+  | "connecting"
+  | "connected"
+  | "disconnected"
+  | "error"
+  | "disconnecting";
+
+type UseMsTeamsConnectionStatusOutput = {
+  connectionStatus: ConnectionStatus;
+  setConnectionStatus: (status: ConnectionStatus) => void;
+  errorLabel: string | null;
+  setErrorLabel: (errorLabel: string) => void;
+  actionLabel: string | null;
+  setActionLabel: (actionLabel: string | null) => void;
+};
+
+function useMsTeamsConnectionStatus(
+  knock: Knock,
+  knockMsTeamsChannelId: string,
+  tenantId: string,
+): UseMsTeamsConnectionStatusOutput {
+  const { t } = useTranslations();
+
+  const [connectionStatus, setConnectionStatus] =
+    useState<ConnectionStatus>("connecting");
+  const [errorLabel, setErrorLabel] = useState<string | null>(null);
+  const [actionLabel, setActionLabel] = useState<string | null>(null);
+
+  useEffect(() => {
+    const checkAuthStatus = async () => {
+      if (connectionStatus !== "connecting") return;
+
+      try {
+        const authRes = await knock.msTeams.authCheck({
+          tenant: tenantId,
+          knockChannelId: knockMsTeamsChannelId,
+        });
+
+        if (authRes.connection?.ok === true) {
+          return setConnectionStatus("connected");
+        }
+
+        if (authRes.connection?.ok === false) {
+          return setConnectionStatus("disconnected");
+        }
+
+        // This is a normal response for a tenant that doesn't have
+        // ms_teams_tenant_id set on it, meaning it's not connected to MS Teams,
+        // so we give it a "disconnected" status instead of an error status.
+        if (
+          authRes.code === "ERR_BAD_REQUEST" &&
+          authRes.response?.data?.message === t("msTeamsTenantIdNotSet")
+        ) {
+          return setConnectionStatus("disconnected");
+        }
+
+        // This is for any Knock errors that would require a reconnect.
+        setConnectionStatus("error");
+      } catch (_error) {
+        setConnectionStatus("error");
+      }
+    };
+
+    checkAuthStatus();
+  }, [connectionStatus, tenantId, knockMsTeamsChannelId, knock.msTeams, t]);
+
+  return {
+    connectionStatus,
+    setConnectionStatus,
+    errorLabel,
+    setErrorLabel,
+    actionLabel,
+    setActionLabel,
+  };
+}
+
+export default useMsTeamsConnectionStatus;

package/src/modules/ms-teams/index.ts

@@ -0,0 +1,2 @@
+export * from "./context";
+export * from "./hooks";