@cerbos/hub

Client library for interacting with Cerbos Hub from server-side Node.js applications.

Prerequisites

• Node.js 20+

Installation

$ npm install @cerbos/hub
Copy

Example usage

Interacting with policy stores

import { readFile } from "node:fs/promises";

import { credentialsFromEnv, StoresClient } from "@cerbos/hub";

const stores = new StoresClient({ credentials: credentialsFromEnv() });

const { newStoreVersion } = await stores.modifyFiles({
  storeId: "MWPKEMFX3CK1",
  operations: [
    {
      addOrUpdate: {
        path: "policy.yaml",
        contents: await readFile("path/to/policy.yaml"),
      },
    },
  ],
});
Copy

For more details, see the StoresClient class documentation.

CommonJS support

This package is ESM-only, but may be required from CommonJS modules in Node.js versions 20.19.5+, 22.15+, and 24+.

Further reading

• API reference
• Cerbos Hub documentation

Get help

• Join the Cerbos community on Slack
• Email us at help@cerbos.dev