@blocksdiy/blocks-client-sdk 1.17.2 → 1.18.0

package/dist/ClientSdk.d.ts

@@ -2,6 +2,7 @@ import { Action, type ActionConfig } from "./Action.js";
 import { Agent, type AgentConfig } from "./Agent.js";
 import { AgentChat, AgentChatConfig } from "./AgentChat.js";
 import { Entity, type EntityConfig } from "./Entity.js";
+import { Integration } from "./Integration.js";
 import { Page, type PageConfig } from "./Page.js";
 /**
  * Represents a user's data
@@ -52,6 +53,7 @@ export interface ClientConfig {
  * - Agents: App agents generated from product-types
  * - AgentChat: Interact with the agent chat
  * - User: The user's data
+ * - Integrations: Which of the app's integrations are connected for whoever is viewing the app
  *
  * @class ClientSdk
  */
@@ -64,6 +66,9 @@ export declare class ClientSdk {
     private readonly pages;
     private readonly agentsMap;
     private readonly agentChats;
+    private readonly integrationsMap;
+    private integrationsSnapshot;
+    private integrationsLoad?;
     /**
      * Creates a new ClientSdk instance
      * @param {ClientConfig} config - Configuration options
@@ -194,6 +199,35 @@ export declare class ClientSdk {
      * ```
      */
     getUser(): User;
+    /**
+     * The app's integrations keyed by provider slug, as last loaded by `loadIntegrations()`
+     *
+     * Empty until the first load completes; a provider the app does not declare is `undefined`. An integration is
+     * connected when actions that use it can run for the viewer right now: the builder shared a connection with all
+     * users of the app, or the signed-in user connected their own, and it has not expired or been revoked. Optional
+     * integrations are never prompted for, so they are often not connected — use this to hide or disable the
+     * features that need them. For a visitor of a public app who is not signed in, only a shared connection counts.
+     *
+     * @returns {Readonly<Record<string, Integration | undefined>>} The loaded integrations
+     * @example
+     * ```ts
+     * await client.loadIntegrations();
+     * const canPostToSlack = client.integrations["slack"]?.isConnected ?? false;
+     * ```
+     */
+    get integrations(): Readonly<Record<string, Integration | undefined>>;
+    /**
+     * Fetches the connection status of every integration the app declares and stores it on the client
+     *
+     * Status is live — it changes when someone connects or disconnects an integration in the app's settings — so
+     * call this again to refresh. Concurrent calls share one request. An integration whose status did not change
+     * keeps its instance. If the fetch fails, the previously loaded integrations are kept.
+     *
+     * @returns {Promise<Readonly<Record<string, Integration | undefined>>>} The loaded integrations, same as `integrations`
+     * @throws {Error} If the status could not be fetched
+     */
+    loadIntegrations(): Promise<Readonly<Record<string, Integration | undefined>>>;
+    private fetchIntegrations;
     /**
      * Changes a user's role
      * @param userId - The user ID to change the role for

package/dist/ClientSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClientSdk.d.ts","sourceRoot":"","sources":["../src/ClientSdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ClientSdk.d.ts","sourceRoot":"","sources":["../src/ClientSdk.ts"],"names":[],"mappings":"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"}

package/dist/ClientSdk.js

@@ -1,3 +1,4 @@
+import { DataApiService } from "@blocksdiy/blocks-client-api";
 import { AppVersionService } from "@blocksdiy/blocks-client-api/appVersionService";
 import { BlocksApiService } from "@blocksdiy/blocks-client-api/blocksStoreService";
 import { getGoogleBaseUrl, getHost } from "@blocksdiy/blocks-client-api/envService";
@@ -6,6 +7,7 @@ import { Agent } from "./Agent.js";
 import { AgentChat } from "./AgentChat.js";
 import { resolveAgentBlockId } from "./AgentRef.js";
 import { Entity } from "./Entity.js";
+import { Integration } from "./Integration.js";
 import { Page } from "./Page.js";
 /**
  * Main client SDK for interacting with entities, actions, and pages
@@ -17,6 +19,7 @@ import { Page } from "./Page.js";
  * - Agents: App agents generated from product-types
  * - AgentChat: Interact with the agent chat
  * - User: The user's data
+ * - Integrations: Which of the app's integrations are connected for whoever is viewing the app
  *
  * @class ClientSdk
  */
@@ -29,6 +32,9 @@ export class ClientSdk {
     pages;
     agentsMap;
     agentChats;
+    integrationsMap;
+    integrationsSnapshot = Object.freeze({});
+    integrationsLoad;
     /**
      * Creates a new ClientSdk instance
      * @param {ClientConfig} config - Configuration options
@@ -45,6 +51,7 @@ export class ClientSdk {
         this.pages = new Map();
         this.agentsMap = new Map();
         this.agentChats = new Map();
+        this.integrationsMap = new Map();
     }
     async authenticate() {
         const headers = {
@@ -261,6 +268,58 @@ export class ClientSdk {
     getUser() {
         return this.user;
     }
+    /**
+     * The app's integrations keyed by provider slug, as last loaded by `loadIntegrations()`
+     *
+     * Empty until the first load completes; a provider the app does not declare is `undefined`. An integration is
+     * connected when actions that use it can run for the viewer right now: the builder shared a connection with all
+     * users of the app, or the signed-in user connected their own, and it has not expired or been revoked. Optional
+     * integrations are never prompted for, so they are often not connected — use this to hide or disable the
+     * features that need them. For a visitor of a public app who is not signed in, only a shared connection counts.
+     *
+     * @returns {Readonly<Record<string, Integration | undefined>>} The loaded integrations
+     * @example
+     * ```ts
+     * await client.loadIntegrations();
+     * const canPostToSlack = client.integrations["slack"]?.isConnected ?? false;
+     * ```
+     */
+    get integrations() {
+        return this.integrationsSnapshot;
+    }
+    /**
+     * Fetches the connection status of every integration the app declares and stores it on the client
+     *
+     * Status is live — it changes when someone connects or disconnects an integration in the app's settings — so
+     * call this again to refresh. Concurrent calls share one request. An integration whose status did not change
+     * keeps its instance. If the fetch fails, the previously loaded integrations are kept.
+     *
+     * @returns {Promise<Readonly<Record<string, Integration | undefined>>>} The loaded integrations, same as `integrations`
+     * @throws {Error} If the status could not be fetched
+     */
+    loadIntegrations() {
+        this.integrationsLoad ??= this.fetchIntegrations().finally(() => {
+            this.integrationsLoad = undefined;
+        });
+        return this.integrationsLoad;
+    }
+    async fetchIntegrations() {
+        const response = await new DataApiService({ appId: this.appId, token: this.token }).apiCall("GET", `/data-api/apps/${this.appId}/integrations/status`);
+        const { integrations = [] } = (await response.json());
+        const next = new Map();
+        for (const status of integrations) {
+            const current = this.integrationsMap.get(status.provider);
+            next.set(status.provider, current?.matches(status) ? current : new Integration(status));
+        }
+        const changed = next.size !== this.integrationsMap.size ||
+            [...next].some(([provider, integration]) => this.integrationsMap.get(provider) !== integration);
+        if (changed) {
+            this.integrationsMap.clear();
+            next.forEach((integration, provider) => this.integrationsMap.set(provider, integration));
+            this.integrationsSnapshot = Object.freeze(Object.fromEntries(this.integrationsMap));
+        }
+        return this.integrationsSnapshot;
+    }
     /**
      * Changes a user's role
      * @param userId - The user ID to change the role for

package/dist/Integration.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Connection status of one of the app's integrations, as the platform reports it
+ * @interface IntegrationStatus
+ * @template P - The integration's provider slug
+ * @property {string} provider - The integration's provider slug, as declared on the app (e.g. "slack", "gmail")
+ * @property {boolean} connected - Whether actions that use this integration can run for the viewer right now
+ * @property {boolean} optional - Whether the app declares the integration as optional
+ */
+export interface IntegrationStatus<P extends string = string> {
+    provider: P;
+    connected: boolean;
+    optional: boolean;
+}
+/**
+ * Integration class for one of the app's integrations, as seen by whoever is viewing the app
+ *
+ * An integration is connected when actions that use it can run for the viewer right now: the builder shared a
+ * connection with all users of the app, or the signed-in user connected their own, and it has not expired or been
+ * revoked. For a visitor of a public app who is not signed in, only a shared connection counts. Optional
+ * integrations are never prompted for, so they are often not connected.
+ *
+ * Instances are immutable snapshots: a refreshed status yields a new instance, so React sees the change.
+ *
+ * @class Integration
+ * @template P - The integration's provider slug
+ */
+export declare class Integration<P extends string = string> {
+    private readonly _provider;
+    private readonly _connected;
+    private readonly _optional;
+    /**
+     * Creates a new Integration instance
+     * @param {IntegrationStatus<P>} status - The integration's status as reported by the platform
+     */
+    constructor(status: IntegrationStatus<P>);
+    /** The integration's provider slug, as declared on the app (e.g. "slack") */
+    get provider(): P;
+    /** Whether actions that use this integration can run for the viewer right now */
+    get isConnected(): boolean;
+    /** Whether the app declares the integration as optional: users are never prompted to connect it */
+    get isOptional(): boolean;
+    /** Whether `status` describes this integration exactly, so a refresh can keep this instance */
+    matches(status: IntegrationStatus): boolean;
+    toJSON(): IntegrationStatus<P>;
+}
+//# sourceMappingURL=Integration.d.ts.map

package/dist/Integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Integration.d.ts","sourceRoot":"","sources":["../src/Integration.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC1D,QAAQ,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAI;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IAEpC;;;OAGG;gBACS,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAMxC,6EAA6E;IAC7E,IAAI,QAAQ,IAAI,CAAC,CAEhB;IAED,iFAAiF;IACjF,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,mGAAmG;IACnG,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,+FAA+F;IAC/F,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO;IAM3C,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC;CAG/B"}

package/dist/Integration.js

@@ -0,0 +1,46 @@
+/**
+ * Integration class for one of the app's integrations, as seen by whoever is viewing the app
+ *
+ * An integration is connected when actions that use it can run for the viewer right now: the builder shared a
+ * connection with all users of the app, or the signed-in user connected their own, and it has not expired or been
+ * revoked. For a visitor of a public app who is not signed in, only a shared connection counts. Optional
+ * integrations are never prompted for, so they are often not connected.
+ *
+ * Instances are immutable snapshots: a refreshed status yields a new instance, so React sees the change.
+ *
+ * @class Integration
+ * @template P - The integration's provider slug
+ */
+export class Integration {
+    _provider;
+    _connected;
+    _optional;
+    /**
+     * Creates a new Integration instance
+     * @param {IntegrationStatus<P>} status - The integration's status as reported by the platform
+     */
+    constructor(status) {
+        this._provider = status.provider;
+        this._connected = status.connected;
+        this._optional = status.optional;
+    }
+    /** The integration's provider slug, as declared on the app (e.g. "slack") */
+    get provider() {
+        return this._provider;
+    }
+    /** Whether actions that use this integration can run for the viewer right now */
+    get isConnected() {
+        return this._connected;
+    }
+    /** Whether the app declares the integration as optional: users are never prompted to connect it */
+    get isOptional() {
+        return this._optional;
+    }
+    /** Whether `status` describes this integration exactly, so a refresh can keep this instance */
+    matches(status) {
+        return (status.provider === this._provider && status.connected === this._connected && status.optional === this._optional);
+    }
+    toJSON() {
+        return { provider: this._provider, connected: this._connected, optional: this._optional };
+    }
+}

package/dist/ReactClientSdk.d.ts

@@ -3,6 +3,7 @@ import type { AgentConfig } from "./Agent.js";
 import type { AgentChatConfig } from "./AgentChat.js";
 import { ClientSdk, UpdateUserOptions } from "./ClientSdk.js";
 import type { EntityAttribution, EntityConfig, EntityType, EntityTypeOnlyMutable } from "./Entity.js";
+import type { Integration } from "./Integration.js";
 import type { PageConfig } from "./Page.js";
 export declare class ReactClientSdk extends ClientSdk {
 }
@@ -686,6 +687,78 @@ export declare const useFileUpload: () => {
  * ```
  */
 export declare const useUser: () => import("./ClientSdk.js").User;
+/**
+ * Hook to get the connection status of one of the app's integrations for whoever is viewing the app
+ *
+ * Use it to render UI conditionally on an integration: hide or disable a feature whose integration is not
+ * connected, instead of letting its action fail. Optional integrations are never prompted for, so they are
+ * often not connected. An integration is connected when actions that use it can run for the viewer right now:
+ * a connection the builder shared with all users of the app, or the signed-in user's own, that has not expired
+ * or been revoked. A visitor of a public app who is not signed in has no connection of their own, so for them only
+ * shared connections count — gate UI the same way for both.
+ *
+ * `isConnected` is false while the status is loading, when it failed to load, and for a provider the app does not
+ * declare, so gated UI stays hidden until the integration is known to work. The status refreshes when the user
+ * returns to the app.
+ *
+ * @template P - The integration's provider slug, inferred from `provider`
+ * @param {P} provider - The integration's provider slug, as declared on the app (e.g. "slack")
+ * @returns {Object} Integration status
+ * @returns {boolean} isConnected - Whether actions that use the integration can run for the viewer right now
+ * @returns {Integration<P> | undefined} integration - `{ provider, isConnected, isOptional }`; undefined while loading,
+ * on error, and for a provider the app does not declare
+ * @returns {boolean} isLoading - True until the first status arrives
+ * @returns {Error | null} error - Set if the status could not be fetched
+ * @example
+ * ```tsx
+ * function ShareButtons({ report }) {
+ *   const { isConnected: isSlackConnected } = useIntegrationStatus("slack");
+ *   const { executeFunction: postToSlack } = useExecuteAction(PostReportToSlackAction);
+ *
+ *   return (
+ *     <div>
+ *       <Button onClick={downloadReport}>Download</Button>
+ *       {isSlackConnected && <Button onClick={() => postToSlack({ reportId: report.id })}>Post to Slack</Button>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare const useIntegrationStatus: <P extends string>(provider: P) => {
+    isConnected: boolean;
+    integration: Integration<P> | undefined;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Hook to get all of the app's integrations for whoever is viewing the app
+ *
+ * For gating on a single integration prefer `useIntegrationStatus(provider)`; use this when a component needs
+ * several, or lists them. Shares its state with `useIntegrationStatus` (it lives on `client.integrations`), so the
+ * status is fetched once. `isConnected` follows the same rules: false while loading, on error, and for undeclared
+ * providers.
+ *
+ * @returns {Object} Integrations
+ * @returns {Readonly<Record<string, Integration | undefined>>} integrations - Keyed by provider slug, e.g.
+ * `integrations["slack"]?.isConnected`; empty until loaded
+ * @returns {Function} isConnected - `(provider: string) => boolean`, e.g. `isConnected("slack")`
+ * @returns {boolean} isLoading - True until the first status arrives
+ * @returns {Error | null} error - Set if the status could not be fetched
+ * @example
+ * ```tsx
+ * function ConnectedIntegrations() {
+ *   const { integrations } = useIntegrationsStatus();
+ *   const connected = Object.entries(integrations).filter(([, integration]) => integration?.isConnected);
+ *   return <ul>{connected.map(([provider]) => <li key={provider}>{provider}</li>)}</ul>;
+ * }
+ * ```
+ */
+export declare const useIntegrationsStatus: () => {
+    integrations: Readonly<Record<string, Integration<string> | undefined>>;
+    isConnected: (provider: string) => boolean;
+    isLoading: boolean;
+    error: Error | null;
+};
 /**
  * Hook to manage the application theme mode
  *

package/dist/ReactClientSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReactClientSdk.d.ts","sourceRoot":"","sources":["../src/ReactClientSdk.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReactClientSdk.d.ts","sourceRoot":"","sources":["../src/ReactClientSdk.tsx"],"names":[],"mappings":"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"}

package/dist/ReactClientSdk.jsx

@@ -12,6 +12,10 @@ import { createEntityLiveSync } from "./EntityLiveSync.js";
 export class ReactClientSdk extends ClientSdk {
 }
 const CURRENT_USER_QUERY_KEY = "currentUser";
+const INTEGRATIONS_QUERY_KEY = "integrations";
+const EMPTY_INTEGRATIONS = Object.freeze({});
+// Connecting happens outside the app (its settings, in the platform), so revisit on focus to pick it up.
+const INTEGRATIONS_STALE_TIME = 30_000;
 // Avoids redundant refetches on quick remounts and window focus flaps without meaningfully delaying anything.
 const ENTITIES_STALE_TIME = 5_000;
 const ClientContext = createContext(null);
@@ -1072,6 +1076,88 @@ export const useUser = () => {
     });
     return user;
 };
+// One query per app: every integration hook shares it, so the status is fetched once however many mount. The
+// state itself lives on the client (`client.integrations`); the query triggers the first load and the refreshes.
+const useIntegrationsQuery = () => {
+    const client = useClient();
+    return useQuery({
+        queryKey: [INTEGRATIONS_QUERY_KEY, client.appId],
+        queryFn: () => client.loadIntegrations(),
+        staleTime: INTEGRATIONS_STALE_TIME,
+        refetchOnWindowFocus: true,
+    });
+};
+/**
+ * Hook to get the connection status of one of the app's integrations for whoever is viewing the app
+ *
+ * Use it to render UI conditionally on an integration: hide or disable a feature whose integration is not
+ * connected, instead of letting its action fail. Optional integrations are never prompted for, so they are
+ * often not connected. An integration is connected when actions that use it can run for the viewer right now:
+ * a connection the builder shared with all users of the app, or the signed-in user's own, that has not expired
+ * or been revoked. A visitor of a public app who is not signed in has no connection of their own, so for them only
+ * shared connections count — gate UI the same way for both.
+ *
+ * `isConnected` is false while the status is loading, when it failed to load, and for a provider the app does not
+ * declare, so gated UI stays hidden until the integration is known to work. The status refreshes when the user
+ * returns to the app.
+ *
+ * @template P - The integration's provider slug, inferred from `provider`
+ * @param {P} provider - The integration's provider slug, as declared on the app (e.g. "slack")
+ * @returns {Object} Integration status
+ * @returns {boolean} isConnected - Whether actions that use the integration can run for the viewer right now
+ * @returns {Integration<P> | undefined} integration - `{ provider, isConnected, isOptional }`; undefined while loading,
+ * on error, and for a provider the app does not declare
+ * @returns {boolean} isLoading - True until the first status arrives
+ * @returns {Error | null} error - Set if the status could not be fetched
+ * @example
+ * ```tsx
+ * function ShareButtons({ report }) {
+ *   const { isConnected: isSlackConnected } = useIntegrationStatus("slack");
+ *   const { executeFunction: postToSlack } = useExecuteAction(PostReportToSlackAction);
+ *
+ *   return (
+ *     <div>
+ *       <Button onClick={downloadReport}>Download</Button>
+ *       {isSlackConnected && <Button onClick={() => postToSlack({ reportId: report.id })}>Post to Slack</Button>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export const useIntegrationStatus = (provider) => {
+    const { data, isLoading, error } = useIntegrationsQuery();
+    const integration = data?.[provider];
+    return { isConnected: integration?.isConnected ?? false, integration, isLoading, error };
+};
+/**
+ * Hook to get all of the app's integrations for whoever is viewing the app
+ *
+ * For gating on a single integration prefer `useIntegrationStatus(provider)`; use this when a component needs
+ * several, or lists them. Shares its state with `useIntegrationStatus` (it lives on `client.integrations`), so the
+ * status is fetched once. `isConnected` follows the same rules: false while loading, on error, and for undeclared
+ * providers.
+ *
+ * @returns {Object} Integrations
+ * @returns {Readonly<Record<string, Integration | undefined>>} integrations - Keyed by provider slug, e.g.
+ * `integrations["slack"]?.isConnected`; empty until loaded
+ * @returns {Function} isConnected - `(provider: string) => boolean`, e.g. `isConnected("slack")`
+ * @returns {boolean} isLoading - True until the first status arrives
+ * @returns {Error | null} error - Set if the status could not be fetched
+ * @example
+ * ```tsx
+ * function ConnectedIntegrations() {
+ *   const { integrations } = useIntegrationsStatus();
+ *   const connected = Object.entries(integrations).filter(([, integration]) => integration?.isConnected);
+ *   return <ul>{connected.map(([provider]) => <li key={provider}>{provider}</li>)}</ul>;
+ * }
+ * ```
+ */
+export const useIntegrationsStatus = () => {
+    const { data, isLoading, error } = useIntegrationsQuery();
+    const integrations = data ?? EMPTY_INTEGRATIONS;
+    const isConnected = useCallback((provider) => integrations[provider]?.isConnected ?? false, [integrations]);
+    return { integrations, isConnected, isLoading, error };
+};
 /**
  * Hook to manage the application theme mode
  *

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from "./Agent.js";
 export * from "./AgentChat.js";
 export * from "./ClientSdk.js";
 export * from "./Entity.js";
+export * from "./Integration.js";
 export * from "./Page.js";
 export * from "./ReactClientSdk";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -3,5 +3,6 @@ export * from "./Agent.js";
 export * from "./AgentChat.js";
 export * from "./ClientSdk.js";
 export * from "./Entity.js";
+export * from "./Integration.js";
 export * from "./Page.js";
 export * from "./ReactClientSdk";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blocksdiy/blocks-client-sdk",
-  "version": "1.17.2",
+  "version": "1.18.0",
   "type": "module",
   "description": "Blocks client sdk",
   "keywords": [],
@@ -48,7 +48,7 @@
   "dependencies": {
     "@tanstack/react-query": "^5.101.0",
     "@blocksdiy/blocks-client-api": "1.5.0",
-    "@blocksdiy/react-common": "1.49.0"
+    "@blocksdiy/react-common": "1.5.2"
   },
   "devDependencies": {
     "tsc-alias": "^1.8.10",