Celesto SDK (Gatekeeper)

Node-only TypeScript SDK for Celesto's Gatekeeper API (/v1/gatekeeper).

Install

npm install @celestoai/sdk

Usage

import { GatekeeperClient } from "@celestoai/sdk/gatekeeper";

const client = new GatekeeperClient({
  baseUrl: "https://api.celesto.ai",
  token: process.env.CELESTO_API_KEY
});

const connect = await client.connect({
  subject: "customer_123",
  provider: "google_drive",
  projectName: "Default",
});

if (connect.status === "redirect") {
  console.log("OAuth URL:", connect.oauthUrl);
}

Gatekeeper API coverage

• connect
• listConnections
• getConnection
• revokeConnection
• listDriveFiles
• getAccessRules
• updateAccessRules
• clearAccessRules

Notes

• token accepts either a Celesto API key or a JWT.
• organizationId adds the X-Current-Organization header.
• Requires Node 18+ for built-in fetch.

License

Apache-2.0. The SDK is open source; use of the Celesto platform is governed by the Celesto Terms of Service:

https://celesto.ai/legal/terms