feat: support integrations inside reusable content blocks (#4250)

Author: Antoine-C

bun.lock

@@ -43,7 +43,7 @@
         "catalog": {
             "@tsconfig/strictest": "^2.0.6",
             "@tsconfig/node20": "^20.1.6",
-            "@gitbook/api": "0.180.0",
+            "@gitbook/api": "0.181.0",
             "@scalar/api-client-react": "^1.3.46",
             "@types/react": "^19.0.0",
             "@types/react-dom": "^19.0.0",

package.json

@@ -12,8 +12,12 @@ import { renderIntegrationUi } from './server-actions';
 export async function IntegrationBlock(props: BlockProps<DocumentBlockIntegration>) {
     const { block, context, style } = props;
 
-    if (!context.contentContext?.space) {
-        throw new Error('integration block requires a content.spaceId');
+    if (!context.contentContext) {
+        throw new Error('Expected a content context to render an block');
+    }
+
+    if (!context.contentContext.space && !block.meta?.spaceId) {
+        throw new Error('integration block requires a spaceId from the context or API');
     }
 
     const initialInput: RenderIntegrationUI = {
@@ -22,16 +26,28 @@ export async function IntegrationBlock(props: BlockProps<DocumentBlockIntegratio
         action: block.data.action,
         context: {
             type: 'document',
-            spaceId: context.contentContext?.space.id,
+            // When the block originates from a cross-space reusable content, the server adds a spaceId so the integration is
+            // looked up in the correct source space.
+            spaceId: block.meta?.spaceId ?? context.contentContext.space.id,
             editable: false,
             theme: 'light', // TODO: how to handle this without moving rendering to the client side?
         },
     };
 
-    const initialResponse = await fetchSafeIntegrationUI(context.contentContext, {
-        integrationName: block.data.integration,
-        request: initialInput,
-    });
+    const dataFetcher = block.meta?.token
+        ? context.contentContext.dataFetcher.withToken({ apiToken: block.meta.token })
+        : context.contentContext.dataFetcher;
+
+    const initialResponse = await fetchSafeIntegrationUI(
+        {
+            ...context.contentContext,
+            dataFetcher,
+        },
+        {
+            integrationName: block.data.integration,
+            request: initialInput,
+        }
+    );
 
     if (initialResponse.error) {
         if (initialResponse.error.code === 404) {