@knocklabs/react-core 0.12.2 → 0.12.4

package/dist/esm/modules/slack/context/KnockSlackProvider.mjs

@@ -1,49 +1,51 @@
-import d from "../hooks/useSlackConnectionStatus.mjs";
+import S from "../hooks/useSlackConnectionStatus.mjs";
 import * as o from "react";
+import { useRef as C } from "react";
 import "swr/infinite";
-import { useKnockClient as S } from "../../core/context/KnockProvider.mjs";
+import { useKnockClient as f } from "../../core/context/KnockProvider.mjs";
 import "@knocklabs/client";
 import "fast-deep-equal";
-import { slackProviderKey as C } from "../../core/utils.mjs";
+import { slackProviderKey as p } from "../../core/utils.mjs";
 import "swr";
 import "../../i18n/context/KnockI18nProvider.mjs";
-const a = o.createContext(null), I = (t) => {
+const i = o.createContext(null), E = (t) => {
   const {
     knockSlackChannelId: e,
-    children: i
-  } = t, n = "tenantId" in t ? t.tenantId : t.tenant, l = S(), {
+    children: a
+  } = t, n = "tenantId" in t ? t.tenantId : t.tenant, l = f(), s = C(null), {
     connectionStatus: r,
-    setConnectionStatus: s,
+    setConnectionStatus: k,
     errorLabel: c,
-    setErrorLabel: k,
-    actionLabel: m,
-    setActionLabel: u
-  } = d(l, e, n);
-  return /* @__PURE__ */ o.createElement(a.Provider, { key: C({
+    setErrorLabel: m,
+    actionLabel: u,
+    setActionLabel: d
+  } = S(l, e, n);
+  return /* @__PURE__ */ o.createElement(i.Provider, { key: p({
     knockSlackChannelId: e,
     tenantId: n,
     connectionStatus: r,
     errorLabel: c
   }), value: {
     connectionStatus: r,
-    setConnectionStatus: s,
+    setConnectionStatus: k,
     errorLabel: c,
-    setErrorLabel: k,
-    actionLabel: m,
-    setActionLabel: u,
+    setErrorLabel: m,
+    actionLabel: u,
+    setActionLabel: d,
     knockSlackChannelId: e,
     // Assign the same value to both tenant and tenantId for backwards compatibility
     tenant: n,
-    tenantId: n
-  } }, i);
-}, L = () => {
-  const t = o.useContext(a);
+    tenantId: n,
+    popupWindowRef: s
+  } }, a);
+}, R = () => {
+  const t = o.useContext(i);
   if (t === void 0)
     throw new Error("useKnockSlackClient must be used within a KnockSlackProvider");
   return t;
 };
 export {
-  I as KnockSlackProvider,
-  L as useKnockSlackClient
+  E as KnockSlackProvider,
+  R as useKnockSlackClient
 };
 //# sourceMappingURL=KnockSlackProvider.mjs.map

package/dist/esm/modules/slack/context/KnockSlackProvider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"KnockSlackProvider.mjs","sources":["../../../../../src/modules/slack/context/KnockSlackProvider.tsx"],"sourcesContent":["import { useSlackConnectionStatus } from \"..\";\nimport * as React from \"react\";\nimport { PropsWithChildren } from \"react\";\n\nimport { slackProviderKey } from \"../../core\";\nimport { useKnockClient } from \"../../core\";\nimport { ConnectionStatus } from \"../hooks/useSlackConnectionStatus\";\n\nexport interface KnockSlackProviderState {\n  knockSlackChannelId: string;\n  tenantId: string;\n  /**\n   * @deprecated Use `tenantId` instead. This field will be removed in a future release.\n   */\n  tenant: string;\n  connectionStatus: ConnectionStatus;\n  setConnectionStatus: (connectionStatus: ConnectionStatus) => void;\n  errorLabel: string | null;\n  setErrorLabel: (label: string) => void;\n  actionLabel: string | null;\n  setActionLabel: (label: string | null) => void;\n}\n\nconst SlackProviderStateContext =\n  React.createContext<KnockSlackProviderState | null>(null);\n\nexport type KnockSlackProviderProps =\n  | {\n      knockSlackChannelId: string;\n      /**\n       * @deprecated Use `tenantId` instead. This field will be removed in a future release.\n       */\n      tenant: string;\n    }\n  | {\n      knockSlackChannelId: string;\n      tenantId: string;\n    };\n\nexport const KnockSlackProvider: React.FC<\n  PropsWithChildren<KnockSlackProviderProps>\n> = (props) => {\n  const { knockSlackChannelId, children } = props;\n  const tenantId = \"tenantId\" in props ? props.tenantId : props.tenant;\n\n  const knock = useKnockClient();\n\n  const {\n    connectionStatus,\n    setConnectionStatus,\n    errorLabel,\n    setErrorLabel,\n    actionLabel,\n    setActionLabel,\n  } = useSlackConnectionStatus(knock, knockSlackChannelId, tenantId);\n\n  return (\n    <SlackProviderStateContext.Provider\n      key={slackProviderKey({\n        knockSlackChannelId,\n        tenantId,\n        connectionStatus,\n        errorLabel,\n      })}\n      value={{\n        connectionStatus,\n        setConnectionStatus,\n        errorLabel,\n        setErrorLabel,\n        actionLabel,\n        setActionLabel,\n        knockSlackChannelId,\n        // Assign the same value to both tenant and tenantId for backwards compatibility\n        tenant: tenantId,\n        tenantId,\n      }}\n    >\n      {children}\n    </SlackProviderStateContext.Provider>\n  );\n};\n\nexport const useKnockSlackClient = (): KnockSlackProviderState => {\n  const context = React.useContext(\n    SlackProviderStateContext,\n  ) as KnockSlackProviderState;\n  if (context === undefined) {\n    throw new Error(\n      \"useKnockSlackClient must be used within a KnockSlackProvider\",\n    );\n  }\n  return context as KnockSlackProviderState;\n};\n"],"names":["SlackProviderStateContext","React","createContext","KnockSlackProvider","props","knockSlackChannelId","children","tenantId","tenant","knock","useKnockClient","connectionStatus","setConnectionStatus","errorLabel","setErrorLabel","actionLabel","setActionLabel","useSlackConnectionStatus","slackProviderKey","useKnockSlackClient","context","useContext","undefined","Error"],"mappings":";;;;;;;;;AAuBA,MAAMA,IACJC,EAAMC,cAA8C,IAAI,GAe7CC,IAERC,CAAUA,MAAA;AACP,QAAA;AAAA,IAAEC,qBAAAA;AAAAA,IAAqBC,UAAAA;AAAAA,EAAAA,IAAaF,GACpCG,IAAW,cAAcH,IAAQA,EAAMG,WAAWH,EAAMI,QAExDC,IAAQC,EAAe,GAEvB;AAAA,IACJC,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAC,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,EACEC,IAAAA,EAAyBR,GAAOJ,GAAqBE,CAAQ;AAEjE,SACG,gBAAAN,EAAA,cAAAD,EAA0B,UAA1B,EACC,KAAKkB,EAAiB;AAAA,IACpBb,qBAAAA;AAAAA,IACAE,UAAAA;AAAAA,IACAI,kBAAAA;AAAAA,IACAE,YAAAA;AAAAA,EACD,CAAA,GACD,OAAO;AAAA,IACLF,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAC,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,IACAX,qBAAAA;AAAAA;AAAAA,IAEAG,QAAQD;AAAAA,IACRA,UAAAA;AAAAA,OAGDD,CACH;AAEJ,GAEaa,IAAsBA,MAA+B;AAC1DC,QAAAA,IAAUnB,EAAMoB,WACpBrB,CACF;AACA,MAAIoB,MAAYE;AACR,UAAA,IAAIC,MACR,8DACF;AAEKH,SAAAA;AACT;"}
+{"version":3,"file":"KnockSlackProvider.mjs","sources":["../../../../../src/modules/slack/context/KnockSlackProvider.tsx"],"sourcesContent":["import { useSlackConnectionStatus } from \"..\";\nimport * as React from \"react\";\nimport { PropsWithChildren, useRef } from \"react\";\n\nimport { type ConnectionStatus, slackProviderKey } from \"../../core\";\nimport { useKnockClient } from \"../../core\";\n\nexport interface KnockSlackProviderState {\n  knockSlackChannelId: string;\n  tenantId: string;\n  /**\n   * @deprecated Use `tenantId` instead. This field will be removed in a future release.\n   */\n  tenant: string;\n  connectionStatus: ConnectionStatus;\n  setConnectionStatus: (connectionStatus: ConnectionStatus) => void;\n  errorLabel: string | null;\n  setErrorLabel: (label: string) => void;\n  actionLabel: string | null;\n  setActionLabel: (label: string | null) => void;\n  popupWindowRef: React.MutableRefObject<Window | null>;\n}\n\nconst SlackProviderStateContext =\n  React.createContext<KnockSlackProviderState | null>(null);\n\nexport type KnockSlackProviderProps =\n  | {\n      knockSlackChannelId: string;\n      /**\n       * @deprecated Use `tenantId` instead. This field will be removed in a future release.\n       */\n      tenant: string;\n    }\n  | {\n      knockSlackChannelId: string;\n      tenantId: string;\n    };\n\nexport const KnockSlackProvider: React.FC<\n  PropsWithChildren<KnockSlackProviderProps>\n> = (props) => {\n  const { knockSlackChannelId, children } = props;\n  const tenantId = \"tenantId\" in props ? props.tenantId : props.tenant;\n\n  const knock = useKnockClient();\n  const popupWindowRef = useRef<Window | null>(null);\n\n  const {\n    connectionStatus,\n    setConnectionStatus,\n    errorLabel,\n    setErrorLabel,\n    actionLabel,\n    setActionLabel,\n  } = useSlackConnectionStatus(knock, knockSlackChannelId, tenantId);\n\n  return (\n    <SlackProviderStateContext.Provider\n      key={slackProviderKey({\n        knockSlackChannelId,\n        tenantId,\n        connectionStatus,\n        errorLabel,\n      })}\n      value={{\n        connectionStatus,\n        setConnectionStatus,\n        errorLabel,\n        setErrorLabel,\n        actionLabel,\n        setActionLabel,\n        knockSlackChannelId,\n        // Assign the same value to both tenant and tenantId for backwards compatibility\n        tenant: tenantId,\n        tenantId,\n        popupWindowRef,\n      }}\n    >\n      {children}\n    </SlackProviderStateContext.Provider>\n  );\n};\n\nexport const useKnockSlackClient = (): KnockSlackProviderState => {\n  const context = React.useContext(\n    SlackProviderStateContext,\n  ) as KnockSlackProviderState;\n  if (context === undefined) {\n    throw new Error(\n      \"useKnockSlackClient must be used within a KnockSlackProvider\",\n    );\n  }\n  return context as KnockSlackProviderState;\n};\n"],"names":["SlackProviderStateContext","React","createContext","KnockSlackProvider","props","knockSlackChannelId","children","tenantId","tenant","knock","useKnockClient","popupWindowRef","useRef","connectionStatus","setConnectionStatus","errorLabel","setErrorLabel","actionLabel","setActionLabel","useSlackConnectionStatus","slackProviderKey","useKnockSlackClient","context","useContext","undefined","Error"],"mappings":";;;;;;;;;;AAuBA,MAAMA,IACJC,EAAMC,cAA8C,IAAI,GAe7CC,IAERC,CAAUA,MAAA;AACP,QAAA;AAAA,IAAEC,qBAAAA;AAAAA,IAAqBC,UAAAA;AAAAA,EAAAA,IAAaF,GACpCG,IAAW,cAAcH,IAAQA,EAAMG,WAAWH,EAAMI,QAExDC,IAAQC,EAAe,GACvBC,IAAiBC,EAAsB,IAAI,GAE3C;AAAA,IACJC,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAC,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,EACEC,IAAAA,EAAyBV,GAAOJ,GAAqBE,CAAQ;AAEjE,SACG,gBAAAN,EAAA,cAAAD,EAA0B,UAA1B,EACC,KAAKoB,EAAiB;AAAA,IACpBf,qBAAAA;AAAAA,IACAE,UAAAA;AAAAA,IACAM,kBAAAA;AAAAA,IACAE,YAAAA;AAAAA,EACD,CAAA,GACD,OAAO;AAAA,IACLF,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAC,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,IACAb,qBAAAA;AAAAA;AAAAA,IAEAG,QAAQD;AAAAA,IACRA,UAAAA;AAAAA,IACAI,gBAAAA;AAAAA,OAGDL,CACH;AAEJ,GAEae,IAAsBA,MAA+B;AAC1DC,QAAAA,IAAUrB,EAAMsB,WACpBvB,CACF;AACA,MAAIsB,MAAYE;AACR,UAAA,IAAIC,MACR,8DACF;AAEKH,SAAAA;AACT;"}

package/dist/esm/modules/slack/hooks/useSlackConnectionStatus.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useSlackConnectionStatus.mjs","sources":["../../../../../src/modules/slack/hooks/useSlackConnectionStatus.ts"],"sourcesContent":["import Knock from \"@knocklabs/client\";\nimport { useEffect, useState } from \"react\";\n\nimport { useTranslations } from \"../../i18n\";\n\nexport type ConnectionStatus =\n  | \"connecting\"\n  | \"connected\"\n  | \"disconnected\"\n  | \"error\"\n  | \"disconnecting\";\n\ntype UseSlackConnectionStatusOutput = {\n  connectionStatus: ConnectionStatus;\n  setConnectionStatus: (status: ConnectionStatus) => void;\n  errorLabel: string | null;\n  setErrorLabel: (errorLabel: string) => void;\n  actionLabel: string | null;\n  setActionLabel: (actionLabel: string | null) => void;\n};\n\n/**\n * Transforms a slack error message into\n * a formatted one. Slack error messages: https://api.slack.com/methods/auth.test#errors\n *\n * Ex.: \"account_inactive\" -> \"Account inactive\"\n */\nconst formatSlackErrorMessage = (errorMessage: string) => {\n  const firstLetter = errorMessage.substring(0, 1).toUpperCase();\n  const rest = errorMessage.substring(1);\n  return firstLetter?.concat(rest).replace(\"_\", \" \");\n};\n\nfunction useSlackConnectionStatus(\n  knock: Knock,\n  knockSlackChannelId: string,\n  tenantId: string,\n): UseSlackConnectionStatusOutput {\n  const { t } = useTranslations();\n  const [connectionStatus, setConnectionStatus] =\n    useState<ConnectionStatus>(\"connecting\");\n  const [errorLabel, setErrorLabel] = useState<string | null>(null);\n  const [actionLabel, setActionLabel] = useState<string | null>(null);\n\n  useEffect(() => {\n    const checkAuthStatus = async () => {\n      if (connectionStatus !== \"connecting\") return;\n\n      try {\n        const authRes = await knock.slack.authCheck({\n          tenant: tenantId,\n          knockChannelId: knockSlackChannelId,\n        });\n\n        if (authRes.connection?.ok) {\n          return setConnectionStatus(\"connected\");\n        }\n\n        // This is a normal response for a tenant that doesn't have an access\n        // token set on it, meaning it's not connected to Slack, so we\n        // give it a \"disconnected\" status instead of an error status.\n        if (\n          authRes.code === \"ERR_BAD_REQUEST\" &&\n          authRes.response?.data?.message === t(\"slackAccessTokenNotSet\")\n        ) {\n          return setConnectionStatus(\"disconnected\");\n        }\n\n        // This is for an error coming directly from Slack.\n        if (authRes.connection && authRes.connection.error) {\n          const errorLabel = formatSlackErrorMessage(authRes.connection.error);\n          setErrorLabel(errorLabel);\n          setConnectionStatus(\"error\");\n          return;\n        }\n\n        if (authRes.connection) {\n          return setConnectionStatus(\"disconnected\");\n        }\n\n        setConnectionStatus(\"error\");\n      } catch (_error) {\n        setConnectionStatus(\"error\");\n      }\n    };\n\n    checkAuthStatus();\n  }, [connectionStatus, tenantId, knockSlackChannelId, knock.slack, t]);\n\n  return {\n    connectionStatus,\n    setConnectionStatus,\n    errorLabel,\n    setErrorLabel,\n    actionLabel,\n    setActionLabel,\n  };\n}\n\nexport default useSlackConnectionStatus;\n"],"names":["formatSlackErrorMessage","errorMessage","firstLetter","substring","toUpperCase","rest","concat","replace","useSlackConnectionStatus","knock","knockSlackChannelId","tenantId","t","useTranslations","connectionStatus","setConnectionStatus","useState","errorLabel","setErrorLabel","actionLabel","setActionLabel","useEffect","authRes","slack","authCheck","tenant","knockChannelId","connection","ok","code","response","data","message","error"],"mappings":";;;AA2BA,MAAMA,IAA0BA,CAACC,MAAyB;AACxD,QAAMC,IAAcD,EAAaE,UAAU,GAAG,CAAC,EAAEC,YAAY,GACvDC,IAAOJ,EAAaE,UAAU,CAAC;AACrC,SAAOD,KAAAA,gBAAAA,EAAaI,OAAOD,GAAME,QAAQ,KAAK;AAChD;AAEA,SAASC,EACPC,GACAC,GACAC,GACgC;AAC1B,QAAA;AAAA,IAAEC,GAAAA;AAAAA,MAAMC,EAAgB,GACxB,CAACC,GAAkBC,CAAmB,IAC1CC,EAA2B,YAAY,GACnC,CAACC,GAAYC,CAAa,IAAIF,EAAwB,IAAI,GAC1D,CAACG,GAAaC,CAAc,IAAIJ,EAAwB,IAAI;AAElEK,SAAAA,EAAU,MAAM;AA0CE,KAzCQ,YAAY;;AAClC,UAAIP,MAAqB;AAErB,YAAA;AACF,gBAAMQ,IAAU,MAAMb,EAAMc,MAAMC,UAAU;AAAA,YAC1CC,QAAQd;AAAAA,YACRe,gBAAgBhB;AAAAA,UAAAA,CACjB;AAEGY,eAAAA,IAAAA,EAAQK,eAARL,QAAAA,EAAoBM;AACtB,mBAAOb,EAAoB,WAAW;AAOtCO,cAAAA,EAAQO,SAAS,uBACjBP,KAAAA,IAAAA,EAAQQ,aAARR,gBAAAA,EAAkBS,SAAlBT,gBAAAA,EAAwBU,aAAYpB,EAAE,wBAAwB;AAE9D,mBAAOG,EAAoB,cAAc;AAI3C,cAAIO,EAAQK,cAAcL,EAAQK,WAAWM,OAAO;AAClD,kBAAMhB,IAAajB,EAAwBsB,EAAQK,WAAWM,KAAK;AACnEf,YAAAA,EAAcD,CAAU,GACxBF,EAAoB,OAAO;AAC3B;AAAA,UAAA;AAGF,cAAIO,EAAQK;AACV,mBAAOZ,EAAoB,cAAc;AAG3CA,UAAAA,EAAoB,OAAO;AAAA,gBACZ;AACfA,UAAAA,EAAoB,OAAO;AAAA,QAAA;AAAA,IAE/B,GAEgB;AAAA,EAAA,GACf,CAACD,GAAkBH,GAAUD,GAAqBD,EAAMc,OAAOX,CAAC,CAAC,GAE7D;AAAA,IACLE,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAE,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,EACF;AACF;"}
+{"version":3,"file":"useSlackConnectionStatus.mjs","sources":["../../../../../src/modules/slack/hooks/useSlackConnectionStatus.ts"],"sourcesContent":["import Knock from \"@knocklabs/client\";\nimport { useEffect, useState } from \"react\";\n\nimport { type ConnectionStatus } from \"../../core/types\";\nimport { useTranslations } from \"../../i18n\";\n\ntype UseSlackConnectionStatusOutput = {\n  connectionStatus: ConnectionStatus;\n  setConnectionStatus: (status: ConnectionStatus) => void;\n  errorLabel: string | null;\n  setErrorLabel: (errorLabel: string) => void;\n  actionLabel: string | null;\n  setActionLabel: (actionLabel: string | null) => void;\n};\n\n/**\n * Transforms a slack error message into\n * a formatted one. Slack error messages: https://api.slack.com/methods/auth.test#errors\n *\n * Ex.: \"account_inactive\" -> \"Account inactive\"\n */\nconst formatSlackErrorMessage = (errorMessage: string) => {\n  const firstLetter = errorMessage.substring(0, 1).toUpperCase();\n  const rest = errorMessage.substring(1);\n  return firstLetter?.concat(rest).replace(\"_\", \" \");\n};\n\nfunction useSlackConnectionStatus(\n  knock: Knock,\n  knockSlackChannelId: string,\n  tenantId: string,\n): UseSlackConnectionStatusOutput {\n  const { t } = useTranslations();\n  const [connectionStatus, setConnectionStatus] =\n    useState<ConnectionStatus>(\"connecting\");\n  const [errorLabel, setErrorLabel] = useState<string | null>(null);\n  const [actionLabel, setActionLabel] = useState<string | null>(null);\n\n  useEffect(() => {\n    const checkAuthStatus = async () => {\n      if (connectionStatus !== \"connecting\") return;\n\n      try {\n        const authRes = await knock.slack.authCheck({\n          tenant: tenantId,\n          knockChannelId: knockSlackChannelId,\n        });\n\n        if (authRes.connection?.ok) {\n          return setConnectionStatus(\"connected\");\n        }\n\n        // This is a normal response for a tenant that doesn't have an access\n        // token set on it, meaning it's not connected to Slack, so we\n        // give it a \"disconnected\" status instead of an error status.\n        if (\n          authRes.code === \"ERR_BAD_REQUEST\" &&\n          authRes.response?.data?.message === t(\"slackAccessTokenNotSet\")\n        ) {\n          return setConnectionStatus(\"disconnected\");\n        }\n\n        // This is for an error coming directly from Slack.\n        if (authRes.connection && authRes.connection.error) {\n          const errorLabel = formatSlackErrorMessage(authRes.connection.error);\n          setErrorLabel(errorLabel);\n          setConnectionStatus(\"error\");\n          return;\n        }\n\n        if (authRes.connection) {\n          return setConnectionStatus(\"disconnected\");\n        }\n\n        setConnectionStatus(\"error\");\n      } catch (_error) {\n        setConnectionStatus(\"error\");\n      }\n    };\n\n    checkAuthStatus();\n  }, [connectionStatus, tenantId, knockSlackChannelId, knock.slack, t]);\n\n  return {\n    connectionStatus,\n    setConnectionStatus,\n    errorLabel,\n    setErrorLabel,\n    actionLabel,\n    setActionLabel,\n  };\n}\n\nexport default useSlackConnectionStatus;\n"],"names":["formatSlackErrorMessage","errorMessage","firstLetter","substring","toUpperCase","rest","concat","replace","useSlackConnectionStatus","knock","knockSlackChannelId","tenantId","t","useTranslations","connectionStatus","setConnectionStatus","useState","errorLabel","setErrorLabel","actionLabel","setActionLabel","useEffect","authRes","slack","authCheck","tenant","knockChannelId","connection","ok","code","response","data","message","error"],"mappings":";;;AAqBA,MAAMA,IAA0BA,CAACC,MAAyB;AACxD,QAAMC,IAAcD,EAAaE,UAAU,GAAG,CAAC,EAAEC,YAAY,GACvDC,IAAOJ,EAAaE,UAAU,CAAC;AACrC,SAAOD,KAAAA,gBAAAA,EAAaI,OAAOD,GAAME,QAAQ,KAAK;AAChD;AAEA,SAASC,EACPC,GACAC,GACAC,GACgC;AAC1B,QAAA;AAAA,IAAEC,GAAAA;AAAAA,MAAMC,EAAgB,GACxB,CAACC,GAAkBC,CAAmB,IAC1CC,EAA2B,YAAY,GACnC,CAACC,GAAYC,CAAa,IAAIF,EAAwB,IAAI,GAC1D,CAACG,GAAaC,CAAc,IAAIJ,EAAwB,IAAI;AAElEK,SAAAA,EAAU,MAAM;AA0CE,KAzCQ,YAAY;;AAClC,UAAIP,MAAqB;AAErB,YAAA;AACF,gBAAMQ,IAAU,MAAMb,EAAMc,MAAMC,UAAU;AAAA,YAC1CC,QAAQd;AAAAA,YACRe,gBAAgBhB;AAAAA,UAAAA,CACjB;AAEGY,eAAAA,IAAAA,EAAQK,eAARL,QAAAA,EAAoBM;AACtB,mBAAOb,EAAoB,WAAW;AAOtCO,cAAAA,EAAQO,SAAS,uBACjBP,KAAAA,IAAAA,EAAQQ,aAARR,gBAAAA,EAAkBS,SAAlBT,gBAAAA,EAAwBU,aAAYpB,EAAE,wBAAwB;AAE9D,mBAAOG,EAAoB,cAAc;AAI3C,cAAIO,EAAQK,cAAcL,EAAQK,WAAWM,OAAO;AAClD,kBAAMhB,IAAajB,EAAwBsB,EAAQK,WAAWM,KAAK;AACnEf,YAAAA,EAAcD,CAAU,GACxBF,EAAoB,OAAO;AAC3B;AAAA,UAAA;AAGF,cAAIO,EAAQK;AACV,mBAAOZ,EAAoB,cAAc;AAG3CA,UAAAA,EAAoB,OAAO;AAAA,gBACZ;AACfA,UAAAA,EAAoB,OAAO;AAAA,QAAA;AAAA,IAE/B,GAEgB;AAAA,EAAA,GACf,CAACD,GAAkBH,GAAUD,GAAqBD,EAAMc,OAAOX,CAAC,CAAC,GAE7D;AAAA,IACLE,kBAAAA;AAAAA,IACAC,qBAAAA;AAAAA,IACAE,YAAAA;AAAAA,IACAC,eAAAA;AAAAA,IACAC,aAAAA;AAAAA,IACAC,gBAAAA;AAAAA,EACF;AACF;"}

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { FilterStatus, KnockProvider, feedProviderKey, formatBadgeCount, formatTimestamp, msTeamsProviderKey, renderNodeOrFallback, slackProviderKey, toSentenceCase, type ColorMode, type KnockProviderProps, type KnockProviderState, useAuthenticatedKnockClient, useKnockClient, useStableOptions, } from './modules/core';
+export { FilterStatus, KnockProvider, feedProviderKey, formatBadgeCount, formatTimestamp, msTeamsProviderKey, renderNodeOrFallback, slackProviderKey, toSentenceCase, type AuthCheckResult, type ColorMode, type ConnectionStatus, type KnockProviderProps, type KnockProviderState, useAuthenticatedKnockClient, useAuthPolling, useAuthPostMessageListener, useKnockClient, useStableOptions, } from './modules/core';
 export { KnockFeedProvider, type KnockFeedProviderProps, type KnockFeedProviderState, type Selector, useCreateNotificationStore, useFeedSettings, useKnockFeed, useNotificationStore, useNotifications, } from './modules/feed';
 export { KnockGuideProvider, KnockGuideContext, type KnockGuideProviderProps, useGuide, useGuides, useGuideContext, } from './modules/guide';
 export { type MsTeamsChannelQueryOptions, type MsTeamsTeamQueryOptions, KnockMsTeamsProvider, type KnockMsTeamsProviderProps, type KnockMsTeamsProviderState, useConnectedMsTeamsChannels, useKnockMsTeamsClient, useMsTeamsAuth, useMsTeamsChannels, useMsTeamsConnectionStatus, useMsTeamsTeams, } from './modules/ms-teams';

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,2BAA2B,EAC3B,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,0BAA0B,EAC1B,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,2BAA2B,EAC3B,cAAc,EACd,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,QAAQ,EACb,0BAA0B,EAC1B,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,QAAQ,EACR,SAAS,EACT,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,0BAA0B,EAC1B,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAMvD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/modules/core/hooks/index.d.ts

@@ -1,3 +1,5 @@
 export { default as useAuthenticatedKnockClient } from './useAuthenticatedKnockClient';
 export { default as useStableOptions } from './useStableOptions';
+export { useAuthPostMessageListener } from './useAuthPostMessageListener';
+export { useAuthPolling } from './useAuthPolling';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/modules/core/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/core/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/core/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/modules/core/hooks/useAuthPolling.d.ts

@@ -0,0 +1,34 @@
+import { AuthCheckResult, ConnectionStatus } from '../types';
+export interface UseAuthPollingOptions {
+    popupWindowRef: React.MutableRefObject<Window | null>;
+    setConnectionStatus: (status: ConnectionStatus) => void;
+    authCheckFn: () => Promise<AuthCheckResult>;
+    onAuthenticationComplete?: (authenticationResp: string) => void;
+}
+/**
+ * Hook that polls an authentication check endpoint until success or timeout.
+ *
+ * Polls every 2 seconds for up to 3 minutes (90 iterations). Has three stop conditions:
+ * 1. Max timeout reached → sets error status
+ * 2. Popup closed + 10s grace period → stops silently
+ * 3. Success detected via authCheckFn → updates status and closes popup
+ *
+ * @param options - Configuration options for the polling mechanism
+ *
+ * @example
+ * ```tsx
+ * useAuthPolling({
+ *   popupWindowRef,
+ *   setConnectionStatus,
+ *   onAuthenticationComplete,
+ *   authCheckFn: useCallback(async () => {
+ *     return knock.slack.authCheck({
+ *       tenant: tenantId,
+ *       knockChannelId: knockSlackChannelId,
+ *     });
+ *   }, [knock.slack, tenantId, knockSlackChannelId]),
+ * });
+ * ```
+ */
+export declare function useAuthPolling(options: UseAuthPollingOptions): void;
+//# sourceMappingURL=useAuthPolling.d.ts.map

package/dist/types/modules/core/hooks/useAuthPolling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthPolling.d.ts","sourceRoot":"","sources":["../../../../../src/modules/core/hooks/useAuthPolling.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,mBAAmB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,wBAAwB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CA8EnE"}

package/dist/types/modules/core/hooks/useAuthPostMessageListener.d.ts

@@ -0,0 +1,27 @@
+import { ConnectionStatus } from '../types';
+export interface UseAuthPostMessageListenerOptions {
+    knockHost: string;
+    popupWindowRef: React.MutableRefObject<Window | null>;
+    setConnectionStatus: (status: ConnectionStatus) => void;
+    onAuthenticationComplete?: (authenticationResp: string) => void;
+}
+/**
+ * Hook that listens for postMessage events from OAuth popup windows.
+ *
+ * Handles "authComplete" and "authFailed" messages sent from the OAuth flow popup,
+ * validates the message origin, updates connection status, and closes the popup.
+ *
+ * @param options - Configuration options for the postMessage listener
+ *
+ * @example
+ * ```tsx
+ * useAuthPostMessageListener({
+ *   knockHost: knock.host,
+ *   popupWindowRef,
+ *   setConnectionStatus,
+ *   onAuthenticationComplete,
+ * });
+ * ```
+ */
+export declare function useAuthPostMessageListener(options: UseAuthPostMessageListenerOptions): void;
+//# sourceMappingURL=useAuthPostMessageListener.d.ts.map

package/dist/types/modules/core/hooks/useAuthPostMessageListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAuthPostMessageListener.d.ts","sourceRoot":"","sources":["../../../../../src/modules/core/hooks/useAuthPostMessageListener.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtD,mBAAmB,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,wBAAwB,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,IAAI,CAsCN"}

package/dist/types/modules/core/index.d.ts

@@ -1,5 +1,6 @@
 export { KnockProvider, useKnockClient, type KnockProviderProps, type KnockProviderState, } from './context';
-export { useAuthenticatedKnockClient, useStableOptions } from './hooks';
+export { useAuthenticatedKnockClient, useStableOptions, useAuthPostMessageListener, useAuthPolling, } from './hooks';
 export { FilterStatus, type ColorMode } from './constants';
 export { formatBadgeCount, formatTimestamp, toSentenceCase, renderNodeOrFallback, feedProviderKey, slackProviderKey, msTeamsProviderKey, } from './utils';
+export { type ConnectionStatus, type AuthCheckResult } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/modules/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,GACf,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/modules/core/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Represents the connection status for OAuth-based integrations (Slack, MS Teams, etc.)
+ */
+export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "error" | "disconnecting";
+/**
+ * Result returned by authentication check API calls
+ */
+export interface AuthCheckResult {
+    connection?: {
+        ok?: boolean;
+        error?: string;
+    };
+    code?: string;
+    response?: {
+        data?: {
+            message?: string;
+        };
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/modules/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,WAAW,GACX,cAAc,GACd,OAAO,GACP,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE;QACX,EAAE,CAAC,EAAE,OAAO,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE;YACL,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC;KACH,CAAC;CACH"}

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

@@ -1,5 +1,5 @@
 import { PropsWithChildren } from 'react';
-import { ConnectionStatus } from '../hooks/useMsTeamsConnectionStatus';
+import { ConnectionStatus } from '../../core';
 import * as React from "react";
 export interface KnockMsTeamsProviderState {
     knockMsTeamsChannelId: string;
@@ -10,6 +10,7 @@ export interface KnockMsTeamsProviderState {
     setErrorLabel: (label: string) => void;
     actionLabel: string | null;
     setActionLabel: (label: string | null) => void;
+    popupWindowRef: React.MutableRefObject<Window | null>;
 }
 export interface KnockMsTeamsProviderProps {
     knockMsTeamsChannelId: string;

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

@@ -1 +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"}
+{"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,EAAU,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AAInE,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;IAC/C,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvD;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,CAqC7C,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,yBAQxC,CAAC"}

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

@@ -1,5 +1,5 @@
 import { default as Knock } from '@knocklabs/client';
-export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "error" | "disconnecting";
+import { ConnectionStatus } from '../../core/types';
 type UseMsTeamsConnectionStatusOutput = {
     connectionStatus: ConnectionStatus;
     setConnectionStatus: (status: ConnectionStatus) => void;

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

@@ -1 +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"}
+{"version":3,"file":"useMsTeamsConnectionStatus.d.ts","sourceRoot":"","sources":["../../../../../src/modules/ms-teams/hooks/useMsTeamsConnectionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAGtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,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/slack/context/KnockSlackProvider.d.ts

@@ -1,5 +1,5 @@
 import { PropsWithChildren } from 'react';
-import { ConnectionStatus } from '../hooks/useSlackConnectionStatus';
+import { ConnectionStatus } from '../../core';
 import * as React from "react";
 export interface KnockSlackProviderState {
     knockSlackChannelId: string;
@@ -14,6 +14,7 @@ export interface KnockSlackProviderState {
     setErrorLabel: (label: string) => void;
     actionLabel: string | null;
     setActionLabel: (label: string | null) => void;
+    popupWindowRef: React.MutableRefObject<Window | null>;
 }
 export type KnockSlackProviderProps = {
     knockSlackChannelId: string;

package/dist/types/modules/slack/context/KnockSlackProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnockSlackProvider.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slack/context/KnockSlackProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,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,MAAM,uBAAuB,GAC/B;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CACvC,iBAAiB,CAAC,uBAAuB,CAAC,CAwC3C,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,uBAUtC,CAAC"}
+{"version":3,"file":"KnockSlackProvider.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slack/context/KnockSlackProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAU,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,YAAY,CAAC;AAGrE,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,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;IAC/C,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvD;AAKD,MAAM,MAAM,uBAAuB,GAC/B;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CACvC,iBAAiB,CAAC,uBAAuB,CAAC,CA0C3C,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO,uBAUtC,CAAC"}

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

@@ -1,5 +1,5 @@
 import { default as Knock } from '@knocklabs/client';
-export type ConnectionStatus = "connecting" | "connected" | "disconnected" | "error" | "disconnecting";
+import { ConnectionStatus } from '../../core/types';
 type UseSlackConnectionStatusOutput = {
     connectionStatus: ConnectionStatus;
     setConnectionStatus: (status: ConnectionStatus) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"useSlackConnectionStatus.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slack/hooks/useSlackConnectionStatus.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,8BAA8B,GAAG;IACpC,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;AAcF,iBAAS,wBAAwB,CAC/B,KAAK,EAAE,KAAK,EACZ,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,8BAA8B,CA4DhC;AAED,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"useSlackConnectionStatus.d.ts","sourceRoot":"","sources":["../../../../../src/modules/slack/hooks/useSlackConnectionStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAGtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,KAAK,8BAA8B,GAAG;IACpC,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;AAcF,iBAAS,wBAAwB,CAC/B,KAAK,EAAE,KAAK,EACZ,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,8BAA8B,CA4DhC;AAED,eAAe,wBAAwB,CAAC"}

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.12.2",
+  "version": "0.12.4",
   "license": "MIT",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.mjs",
@@ -47,7 +47,7 @@
     "react": "^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@knocklabs/client": "^0.20.2",
+    "@knocklabs/client": "^0.20.3",
     "@tanstack/react-store": "^0.7.3",
     "date-fns": "^4.0.0",
     "fast-deep-equal": "^3.1.3",

package/src/index.ts

@@ -8,10 +8,14 @@ export {
   renderNodeOrFallback,
   slackProviderKey,
   toSentenceCase,
+  type AuthCheckResult,
   type ColorMode,
+  type ConnectionStatus,
   type KnockProviderProps,
   type KnockProviderState,
   useAuthenticatedKnockClient,
+  useAuthPolling,
+  useAuthPostMessageListener,
   useKnockClient,
   useStableOptions,
 } from "./modules/core";

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

@@ -1,2 +1,4 @@
 export { default as useAuthenticatedKnockClient } from "./useAuthenticatedKnockClient";
 export { default as useStableOptions } from "./useStableOptions";
+export { useAuthPostMessageListener } from "./useAuthPostMessageListener";
+export { useAuthPolling } from "./useAuthPolling";

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

@@ -0,0 +1,115 @@
+import { useEffect } from "react";
+
+import { AuthCheckResult, ConnectionStatus } from "../types";
+
+export interface UseAuthPollingOptions {
+  popupWindowRef: React.MutableRefObject<Window | null>;
+  setConnectionStatus: (status: ConnectionStatus) => void;
+  authCheckFn: () => Promise<AuthCheckResult>;
+  onAuthenticationComplete?: (authenticationResp: string) => void;
+}
+
+/**
+ * Hook that polls an authentication check endpoint until success or timeout.
+ *
+ * Polls every 2 seconds for up to 3 minutes (90 iterations). Has three stop conditions:
+ * 1. Max timeout reached → sets error status
+ * 2. Popup closed + 10s grace period → stops silently
+ * 3. Success detected via authCheckFn → updates status and closes popup
+ *
+ * @param options - Configuration options for the polling mechanism
+ *
+ * @example
+ * ```tsx
+ * useAuthPolling({
+ *   popupWindowRef,
+ *   setConnectionStatus,
+ *   onAuthenticationComplete,
+ *   authCheckFn: useCallback(async () => {
+ *     return knock.slack.authCheck({
+ *       tenant: tenantId,
+ *       knockChannelId: knockSlackChannelId,
+ *     });
+ *   }, [knock.slack, tenantId, knockSlackChannelId]),
+ * });
+ * ```
+ */
+export function useAuthPolling(options: UseAuthPollingOptions): void {
+  const {
+    popupWindowRef,
+    setConnectionStatus,
+    onAuthenticationComplete,
+    authCheckFn,
+  } = options;
+
+  useEffect(
+    () => {
+      let pollCount = 0;
+      const maxPolls = 90;
+      let popupClosedAt: number | null = null;
+      let isActive = true;
+
+      const pollInterval = setInterval(async () => {
+        if (!isActive) {
+          clearInterval(pollInterval);
+          return;
+        }
+
+        const popupWindow = popupWindowRef.current;
+        if (!popupWindow) {
+          return;
+        }
+
+        pollCount++;
+
+        const isPopupClosed = popupWindow.closed;
+        if (isPopupClosed && !popupClosedAt) {
+          popupClosedAt = Date.now();
+        }
+
+        // Stop condition 1: Max timeout reached
+        if (pollCount >= maxPolls) {
+          clearInterval(pollInterval);
+          setConnectionStatus("error");
+          return;
+        }
+
+        // Stop condition 2: Popup closed + grace period expired
+        if (popupClosedAt && Date.now() - popupClosedAt > 10000) {
+          clearInterval(pollInterval);
+          popupWindowRef.current = null;
+          return;
+        }
+
+        try {
+          const authRes = await authCheckFn();
+
+          // Stop condition 3: Success detected
+          if (authRes.connection?.ok) {
+            clearInterval(pollInterval);
+            setConnectionStatus("connected");
+            if (onAuthenticationComplete) {
+              onAuthenticationComplete("authComplete");
+            }
+            if (popupWindow && !popupWindow.closed) {
+              popupWindow.close();
+            }
+            popupWindowRef.current = null;
+          }
+        } catch (_error) {
+          // Continue polling on error
+        }
+      }, 2000);
+
+      return () => {
+        isActive = false;
+        clearInterval(pollInterval);
+      };
+    },
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [
+      // Empty deps - run once on mount and keep polling
+      // This is intentionally simple/brute force
+    ],
+  );
+}

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

@@ -0,0 +1,70 @@
+import { useEffect } from "react";
+
+import { ConnectionStatus } from "../types";
+
+export interface UseAuthPostMessageListenerOptions {
+  knockHost: string;
+  popupWindowRef: React.MutableRefObject<Window | null>;
+  setConnectionStatus: (status: ConnectionStatus) => void;
+  onAuthenticationComplete?: (authenticationResp: string) => void;
+}
+
+/**
+ * Hook that listens for postMessage events from OAuth popup windows.
+ *
+ * Handles "authComplete" and "authFailed" messages sent from the OAuth flow popup,
+ * validates the message origin, updates connection status, and closes the popup.
+ *
+ * @param options - Configuration options for the postMessage listener
+ *
+ * @example
+ * ```tsx
+ * useAuthPostMessageListener({
+ *   knockHost: knock.host,
+ *   popupWindowRef,
+ *   setConnectionStatus,
+ *   onAuthenticationComplete,
+ * });
+ * ```
+ */
+export function useAuthPostMessageListener(
+  options: UseAuthPostMessageListenerOptions,
+): void {
+  const {
+    knockHost,
+    popupWindowRef,
+    setConnectionStatus,
+    onAuthenticationComplete,
+  } = options;
+
+  useEffect(() => {
+    const receiveMessage = (event: MessageEvent) => {
+      // Validate message origin for security
+      if (event.origin !== knockHost) {
+        return;
+      }
+
+      if (event.data === "authComplete") {
+        setConnectionStatus("connected");
+        onAuthenticationComplete?.(event.data);
+        // Clear popup ref so polling stops and doesn't trigger callback again
+        if (popupWindowRef.current && !popupWindowRef.current.closed) {
+          popupWindowRef.current.close();
+        }
+        popupWindowRef.current = null;
+      } else if (event.data === "authFailed") {
+        setConnectionStatus("error");
+        onAuthenticationComplete?.(event.data);
+        popupWindowRef.current = null;
+      }
+    };
+
+    window.addEventListener("message", receiveMessage, false);
+    return () => window.removeEventListener("message", receiveMessage);
+  }, [
+    knockHost,
+    onAuthenticationComplete,
+    setConnectionStatus,
+    popupWindowRef,
+  ]);
+}

package/src/modules/core/index.ts

@@ -4,7 +4,12 @@ export {
   type KnockProviderProps,
   type KnockProviderState,
 } from "./context";
-export { useAuthenticatedKnockClient, useStableOptions } from "./hooks";
+export {
+  useAuthenticatedKnockClient,
+  useStableOptions,
+  useAuthPostMessageListener,
+  useAuthPolling,
+} from "./hooks";
 export { FilterStatus, type ColorMode } from "./constants";
 export {
   formatBadgeCount,
@@ -15,3 +20,4 @@ export {
   slackProviderKey,
   msTeamsProviderKey,
 } from "./utils";
+export { type ConnectionStatus, type AuthCheckResult } from "./types";

package/src/modules/core/types.ts

@@ -0,0 +1,25 @@
+/**
+ * Represents the connection status for OAuth-based integrations (Slack, MS Teams, etc.)
+ */
+export type ConnectionStatus =
+  | "connecting"
+  | "connected"
+  | "disconnected"
+  | "error"
+  | "disconnecting";
+
+/**
+ * Result returned by authentication check API calls
+ */
+export interface AuthCheckResult {
+  connection?: {
+    ok?: boolean;
+    error?: string;
+  };
+  code?: string;
+  response?: {
+    data?: {
+      message?: string;
+    };
+  };
+}