feat: docs update to have BatchCheck serverside example in Go (#1138)

Co-authored-by: Ewan Harris <[email protected]>

Author: SoulPancake

docs/content/getting-started/perform-check.mdx

@@ -170,9 +170,15 @@ The result's `allowed` field will return `true` if the relationship exists and `
 If you want to check multiple user-object-relationship combinations in a single request, you can use the [Batch Check](/api/service#Relationship%20Queries/BatchCheck) API endpoint. Batching authorization checks together in a single request significantly reduces overall network latency.    
 
 :::note
-The BatchCheck endpoint is currently only supported by the JS SDK (>=[v0.8.0](https://github.com/openfga/js-sdk/releases/tag/v0.8.0) and the Python SDK (>=[v0.9.0](https://github.com/openfga/python-sdk/releases/tag/v0.9.0)). Support in the other SDKs is being worked on.
+The BatchCheck endpoint is currently supported by:
+- JS SDK (>=[v0.8.0](https://github.com/openfga/js-sdk/releases/tag/v0.8.0))
+- Python SDK (>=[v0.9.0](https://github.com/openfga/python-sdk/releases/tag/v0.9.0))
+- Go SDK (>=[v0.7.0](https://github.com/openfga/go-sdk/releases/tag/v0.7.0))
+- Java SDK (>=[v0.8.0](https://github.com/openfga/java-sdk/releases/tag/v0.8.0))
 
-In the SDKs that don't support the server-side `BatchCheck`, the `BatchCheck` method performs client-side batch checks by making multiple check requests with limited parallelization, in SDK versions that do support the server-side `BatchCheck`, the existing method has been renamed to `ClientBatchCheck`.
+Support in the other SDKs is being worked on.
+
+In the SDKs that don't support the server-side `BatchCheck`, the `BatchCheck` method performs client-side batch checks by making multiple check requests with limited parallelization. In SDK versions that do support the server-side `BatchCheck`, the existing method has been renamed to `ClientBatchCheck`.
 
 Refer to the README for each SDK for more information. Refer to the release notes of the relevant SDK version for more information on how to migrate from client-side to the server-side `BatchCheck`.
 :::

src/components/Docs/SnippetViewer/BatchCheckRequestViewer.tsx

@@ -108,62 +108,71 @@ const { result } = await fgaClient.batchCheck(body, options);
 */`;
 
     case SupportedLanguage.GO_SDK:
-      return `// The Go SDK does not yet support server-side batch checks. This currently just calls the check endpoint in parallel.
+      return `// Requires >=v0.7.0 for the server side BatchCheck, earlier versions support a client-side BatchCheck with a slightly different interface
+body := ClientBatchCheckRequest{
+  Checks: []ClientBatchCheckItem{${checks
+    .map(
+      (check) => `
+    {
+      User:          "${check.user}",
+      Relation:      "${check.relation}",
+      Object:        "${check.object}",
+      CorrelationId: "${check.correlation_id}",${
+        check.contextualTuples
+          ? `
+      ContextualTuples: []ClientContextualTupleKey{
+        ${check.contextualTuples
+          .map(
+            (tuple) => `{
+          User:     "${tuple.user}",
+          Relation: "${tuple.relation}",
+          Object:   "${tuple.object}",
+        },`,
+          )
+          .join('\n        ')}
+      },`
+          : ''
+      }${
+        check.context
+          ? `
+      Context: &map[string]interface{}${JSON.stringify(check.context)},`
+          : ''
+      }
+    },`,
+    )
+    .join('')}
+  },
+}
+
+options := BatchCheckOptions{
+  MaxBatchSize:         openfga.PtrInt32(50), // optional, default is 50, can be used to limit the number of checks in a single server request
+  MaxParallelRequests:  openfga.PtrInt32(10), // optional, default is 10, can be used to limit the parallelization of the BatchCheck chunks${
+    modelId
+      ? `,
+  AuthorizationModelId: openfga.PtrString("${modelId}"),`
+      : ''
+  }
+}
+
+data, err := fgaClient.BatchCheck(context.Background()).Body(body).Options(options).Execute()
 
-body := ClientBatchCheckBody{${checks
+/*
+// Results are a map keyed by correlationId
+// Example:
+data.GetResult() = map[string]BatchCheckSingleResult{${checks
         .map(
           (check) => `
-  {
-    User: "${check.user}",
-    Relation: "${check.relation}",
-    Object: "${check.object}",${
-      check.contextualTuples
-        ? `
-    ContextualTuples: []ClientTupleKey{
-      ${check.contextualTuples
-        .map(
-          (tuple) => `
-        {
-          User: "${tuple.user}",
-          Relation: "${tuple.relation}",
-          Object: "${tuple.object}",
-        },`,
-        )
-        .join('')}
-    },`
-        : ''
+  "${check.correlation_id}": {
+    Allowed: ${check.allowed},${
+      check.allowed
+        ? ''
+        : `
+    Error:   <FgaError ...>,`
     }
   },`,
         )
         .join('')}
 }
-options := ClientBatchCheckOptions{${modelId ? `\n  AuthorizationModelId: PtrString("${modelId}"),\n` : ''}}
-data, err := fgaClient.BatchCheck(context.Background()).Body(requestBody).Options(options).Execute()
-/*
-data = [${checks
-        .map(
-          (check) => `{
-  Allowed: ${check.allowed},
-  Request: {
-    User: '${check.user}',
-    Relation: '${check.relation}',
-    Object: '${check.object}'${
-      check.contextualTuples
-        ? `,\n    ContextualTuples: [${check.contextualTuples
-            .map(
-              (tuple) => `{
-      User: '${tuple.user}',
-      Relation: '${tuple.relation}',
-      Object: '${tuple.object}'
-    }`,
-            )
-            .join(',\n    ')}]
-  `
-        : '\n  '
-    }}
-}`,
-        )
-        .join(', ')}]
 */
 `;
 
@@ -362,7 +371,6 @@ Reply:${checks
 `;
 
     case SupportedLanguage.CURL: {
-      /* eslint-disable max-len */
       return `curl -X POST $FGA_API_URL/stores/$FGA_STORE_ID/batch-check \\
 -H "Authorization: Bearer $FGA_API_TOKEN" \\ # Not needed if service does not require authorization
 -H "content-type: application/json" \\
@@ -405,7 +413,6 @@ Reply:${checks
     default:
       assertNever(lang);
   }
-  /* eslint-enable no-tabs */
 }
 
 export function BatchCheckRequestViewer(opts: BatchCheckRequestViewerOpts): JSX.Element {