integrate-sdk 0.5.2 → 0.5.4

package/dist/react.js

@@ -858,16 +858,45 @@ var require_react = __commonJS((exports, module) => {
 });
 
 // src/react/hooks.ts
-var import_react = __toESM(require_react(), 1);
+var React = __toESM(require_react(), 1);
+function getSafeFallback() {
+  return {
+    tokens: {},
+    headers: {},
+    isLoading: false,
+    fetch: globalThis.fetch?.bind(globalThis) || (async () => new Response),
+    mergeHeaders: (existingHeaders) => new Headers(existingHeaders)
+  };
+}
+function isReactHooksAvailable() {
+  if (!React || typeof React !== "object") {
+    return false;
+  }
+  if (!React.useState || !React.useEffect || !React.useMemo || !React.useCallback) {
+    return false;
+  }
+  if (typeof window === "undefined") {
+    return false;
+  }
+  if (typeof document === "undefined") {
+    return false;
+  }
+  return true;
+}
 function useIntegrateTokens(client) {
-  const [tokens, setTokens] = import_react.useState({});
-  const [isLoading, setIsLoading] = import_react.useState(true);
-  import_react.useEffect(() => {
-    if (!client) {
-      console.error("[useIntegrateTokens] Client parameter is required. " + "Pass your MCP client instance to this hook.");
-      setIsLoading(false);
-      return;
-    }
+  if (!isReactHooksAvailable()) {
+    console.warn("[useIntegrateTokens] React hooks are not available. " + "This can happen during SSR, before React initialization, or in Suspense boundaries. " + "Returning safe fallback values.");
+    return getSafeFallback();
+  }
+  if (!client) {
+    return {
+      ...getSafeFallback(),
+      isLoading: true
+    };
+  }
+  const [tokens, setTokens] = React.useState({});
+  const [isLoading, setIsLoading] = React.useState(true);
+  React.useEffect(() => {
     try {
       const updateTokens = () => {
         try {
@@ -903,7 +932,7 @@ function useIntegrateTokens(client) {
       return;
     }
   }, [client]);
-  const headers = import_react.useMemo(() => {
+  const headers = React.useMemo(() => {
     if (Object.keys(tokens).length === 0) {
       return {};
     }
@@ -911,7 +940,7 @@ function useIntegrateTokens(client) {
       "x-integrate-tokens": JSON.stringify(tokens)
     };
   }, [tokens]);
-  const fetchWithHeaders = import_react.useCallback(async (input, init) => {
+  const fetchWithHeaders = React.useCallback(async (input, init) => {
     const mergedHeaders = new Headers(init?.headers);
     if (headers["x-integrate-tokens"]) {
       mergedHeaders.set("x-integrate-tokens", headers["x-integrate-tokens"]);
@@ -921,7 +950,7 @@ function useIntegrateTokens(client) {
       headers: mergedHeaders
     });
   }, [headers]);
-  const mergeHeaders = import_react.useCallback((existingHeaders) => {
+  const mergeHeaders = React.useCallback((existingHeaders) => {
     const merged = new Headers(existingHeaders);
     if (headers["x-integrate-tokens"]) {
       merged.set("x-integrate-tokens", headers["x-integrate-tokens"]);

package/dist/src/react/hooks.d.ts

@@ -39,8 +39,11 @@ export interface UseIntegrateTokensResult {
  * Automatically listens for authentication events and updates when tokens change.
  * Returns tokens and formatted headers ready to pass to API requests.
  *
- * @param client - MCP client instance created with createMCPClient()
- * @returns Object with tokens, headers, and loading state
+ * **Note:** This hook must be called inside a React component. It will return safe
+ * fallback values during SSR or if the client is not ready.
+ *
+ * @param client - MCP client instance created with createMCPClient() (optional)
+ * @returns Object with tokens, headers, loading state, fetch function, and mergeHeaders helper
  *
  * @example
  * ```tsx
@@ -53,11 +56,11 @@ export interface UseIntegrateTokensResult {
  * });
  *
  * function ChatComponent() {
- *   const { tokens, headers, isLoading } = useIntegrateTokens(client);
+ *   const { fetch: fetchWithTokens, isLoading } = useIntegrateTokens(client);
  *
  *   const chat = useChat({
  *     api: '/api/chat',
- *     headers, // Automatically includes x-integrate-tokens
+ *     fetch: fetchWithTokens, // Tokens automatically included
  *   });
  *
  *   return <div>Chat UI here</div>;
@@ -66,21 +69,18 @@ export interface UseIntegrateTokensResult {
  *
  * @example
  * ```tsx
- * // Manual fetch with tokens
+ * // With mergeHeaders helper
  * import { createMCPClient } from 'integrate-sdk';
  *
  * const client = createMCPClient({ plugins: [...] });
  *
  * function MyComponent() {
- *   const { headers } = useIntegrateTokens(client);
+ *   const { mergeHeaders } = useIntegrateTokens(client);
  *
  *   const fetchData = async () => {
  *     const response = await fetch('/api/data', {
  *       method: 'POST',
- *       headers: {
- *         'Content-Type': 'application/json',
- *         ...headers, // Includes x-integrate-tokens
- *       },
+ *       headers: mergeHeaders({ 'Content-Type': 'application/json' }),
  *       body: JSON.stringify({ query: 'example' }),
  *     });
  *     return response.json();
@@ -90,5 +90,5 @@ export interface UseIntegrateTokensResult {
  * }
  * ```
  */
-export declare function useIntegrateTokens(client: MCPClient<any>): UseIntegrateTokensResult;
+export declare function useIntegrateTokens(client?: MCPClient<any> | null): UseIntegrateTokensResult;
 //# sourceMappingURL=hooks.d.ts.map

package/dist/src/react/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3E;;;OAGG;IACH,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,GACrB,wBAAwB,CA+G1B"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/react/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,KAAK,EAAE,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE3E;;;OAGG;IACH,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;CAC1D;AA4CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAC7B,wBAAwB,CA0H1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "integrate-sdk",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Type-safe TypeScript SDK for MCP Client with plugin-based OAuth provider configuration",
   "type": "module",
   "main": "./dist/index.js",