First draft of using content token to fetch and render reusable content across spaces.

Author: emmerich

packages/gitbook-v2/src/lib/data/api.ts

@@ -125,13 +125,14 @@ export function createDataFetcher(
             );
         },
         getReusableContent(params) {
-            return trace('getReusableContent', () =>
-                getReusableContent(input, {
+            return trace('getReusableContent', () => {
+                const withToken = params.apiToken ? { ...input, apiToken: params.apiToken } : input;
+                return getReusableContent(withToken, {
                     spaceId: params.spaceId,
                     revisionId: params.revisionId,
                     reusableContentId: params.reusableContentId,
-                })
-            );
+                });
+            });
         },
         getLatestOpenAPISpecVersionContent(params) {
             return trace('getLatestOpenAPISpecVersionContent', () =>
@@ -158,12 +159,14 @@ export function createDataFetcher(
             );
         },
         getDocument(params) {
-            return trace('getDocument', () =>
-                getDocument(input, {
+            return trace('getDocument', () => {
+                const withToken = params.apiToken ? { ...input, apiToken: params.apiToken } : input;
+
+                return getDocument(withToken, {
                     spaceId: params.spaceId,
                     documentId: params.documentId,
-                })
-            );
+                });
+            });
         },
         getComputedDocument(params) {
             return trace('getComputedDocument', () =>

packages/gitbook-v2/src/lib/data/types.ts

@@ -109,9 +109,12 @@ export interface GitBookDataFetcher {
     /**
      * Get a document by its space ID and document ID.
      */
-    getDocument(params: { spaceId: string; documentId: string }): Promise<
-        DataFetcherResponse<api.JSONDocument>
-    >;
+    getDocument(params: {
+        spaceId: string;
+        documentId: string;
+        /** Optionally override the API token used to fetch the content. */
+        apiToken?: string;
+    }): Promise<DataFetcherResponse<api.JSONDocument>>;
 
     /**
      * Get a computed document by its space ID and computed source.
@@ -130,6 +133,8 @@ export interface GitBookDataFetcher {
         spaceId: string;
         revisionId: string;
         reusableContentId: string;
+        /** Optionally override the API token used to fetch the content. */
+        apiToken?: string;
     }): Promise<DataFetcherResponse<api.RevisionReusableContent>>;
 
     /**

packages/gitbook/src/components/DocumentView/ReusableContent.tsx

@@ -13,7 +13,10 @@ export async function ReusableContent(props: BlockProps<DocumentBlockReusableCon
         throw new Error('Expected a content context to render a reusable content block');
     }
 
-    const resolved = await resolveContentRef(block.data.ref, context.contentContext);
+    const resolved = await resolveContentRef(block.data.ref, context.contentContext, {
+        apiToken: block.meta?.token,
+    });
+
     if (!resolved?.reusableContent?.document) {
         return null;
     }
@@ -22,6 +25,7 @@ export async function ReusableContent(props: BlockProps<DocumentBlockReusableCon
         context.contentContext.dataFetcher.getDocument({
             spaceId: context.contentContext.space.id,
             documentId: resolved.reusableContent.document,
+            apiToken: block.meta?.token,
         })
     );
 

packages/gitbook/src/lib/api.ts

@@ -671,8 +671,10 @@ export const getRevisionFile = batch<[string, string, string], RevisionFile | nu
 export const getReusableContent = async (
     spaceId: string,
     revisionId: string,
-    reusableContentId: string
+    reusableContentId: string,
+    apiToken?: string
 ): Promise<RevisionReusableContent | null> => {
+    ishouldbeimplmeneted;
     const hasRevisionInMemory = await getRevision.hasInMemory(spaceId, revisionId, {
         metadata: false,
     });

packages/gitbook/src/lib/references.tsx

@@ -64,6 +64,11 @@ export interface ResolveContentRefOptions {
      * @default false
      */
     resolveAsAbsoluteURL?: boolean;
+
+    /**
+     * Override the API token used to fetch any content.
+     */
+    apiToken?: string;
 }
 
 /**
@@ -233,9 +238,10 @@ export async function resolveContentRef(
         case 'reusable-content': {
             const reusableContent = await getDataOrNull(
                 dataFetcher.getReusableContent({
-                    spaceId: space.id,
+                    spaceId: contentRef.space ?? space.id,
                     revisionId,
                     reusableContentId: contentRef.reusableContent,
+                    apiToken: options.apiToken,
                 })
             );
             if (!reusableContent) {

packages/gitbook/src/lib/v1.ts

@@ -210,7 +210,8 @@ async function getDataFetcherV1(): Promise<GitBookDataFetcher> {
                 const reusableContent = await getReusableContent(
                     params.spaceId,
                     params.revisionId,
-                    params.reusableContentId
+                    params.reusableContentId,
+                    params.apiToken
                 );
 
                 if (!reusableContent) {