TypeScript

Empieza por la guía de gRPC para crear un token API de la plataforma y descargar platform.proto. Ejecuta los siguientes comandos desde el directorio que contiene ese archivo.

Los navegadores no pueden abrir conexiones gRPC HTTP/2 nativas. La API de la plataforma también acepta gRPC-Web en su endpoint HTTP/1.1. Instala protoc, los plugins protoc-gen-js y protoc-gen-grpc-web y los paquetes de ejecución:

npm install grpc-web google-protobuf
npm install --save-dev @types/google-protobuf
mkdir -p src/generated
protoc -I. platform.proto \
  --js_out=import_style=commonjs,binary:src/generated \
  --grpc-web_out=import_style=typescript,mode=grpcweb:src/generated

Descarga los plugins del compilador desde las versiones y guía oficial de configuración de gRPC-Web; deben estar en tu PATH. El comando genera platform_pb.js, sus declaraciones TypeScript y PlatformServiceClientPb.ts.

import {PlatformServicePromiseClient} from './generated/PlatformServiceClientPb';
import {GetCatalogRequest, ListCatalogsRequest} from './generated/platform_pb';

// Supply a token at runtime. Do not bundle a long-lived API token in browser code.
export async function listCatalogDetails(token: string) {
  const client = new PlatformServicePromiseClient('https://reconstruct.dev');
  const metadata = {authorization: `Bearer ${token}`};
  const listRequest = new ListCatalogsRequest();
  listRequest.setPageSize(10);

  const page = await client.listCatalogs(listRequest, metadata);
  for (const catalog of page.getCatalogsList()) {
    const detailRequest = new GetCatalogRequest();
    detailRequest.setCatalogId(catalog.getCatalogId());
    const detail = await client.getCatalog(detailRequest, metadata);
    console.log(detail.getCatalogId(), detail.getDescription());
  }
}

Para una aplicación de navegador, la API pública debe permitir el origen de esa aplicación mediante CORS. Conserva los tokens API persistentes en un servidor de confianza; un paquete de navegador no puede proteger un secreto incrustado.