integrate-sdk 0.5.2 → 0.5.3

package/dist/react.js

@@ -859,15 +859,28 @@ var require_react = __commonJS((exports, module) => {
 
 // src/react/hooks.ts
 var import_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 useIntegrateTokens(client) {
+  if (typeof window === "undefined") {
+    return getSafeFallback();
+  }
+  if (!client) {
+    return {
+      ...getSafeFallback(),
+      isLoading: true
+    };
+  }
   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;
-    }
     try {
       const updateTokens = () => {
         try {

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;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,GAC7B,wBAAwB,CAoH1B"}

package/package.json

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