# @eventcatalog/sdk

> SDK to integrate with EventCatalog

Latest version **2.29.0** (published 2026-09-04) · MIT license · 0 weekly downloads

## Install

```sh
npm install @eventcatalog/sdk
pnpm add @eventcatalog/sdk
yarn add @eventcatalog/sdk
bun add @eventcatalog/sdk
```

## Health

**Score 75/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.29.0 |
| Published | 2026-09-04 |
| First published | 2024-07-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 8 |
| Unpacked size | 1.8 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 2902 |
| Maintainers | boyney123 |

## Links

- npm: https://www.npmjs.com/package/@eventcatalog/sdk
- Repository: https://github.com/event-catalog/eventcatalog
- Homepage: https://github.com/event-catalog/eventcatalog#readme
- Issues: https://github.com/event-catalog/eventcatalog/issues
- npm.io page: https://npm.io/package/@eventcatalog/sdk

## Dependencies (8)

- [zod](https://npm.io/package/zod.md) ^4.3.6
- [glob](https://npm.io/package/glob.md) ^13.0.6
- [ignore](https://npm.io/package/ignore.md) ^7.0.5
- [semver](https://npm.io/package/semver.md) 7.7.3
- [slugify](https://npm.io/package/slugify.md) ^1.6.6
- [fs-extra](https://npm.io/package/fs-extra.md) ^11.3.2
- [gray-matter](https://npm.io/package/gray-matter.md) ^4.0.3
- [proper-lockfile](https://npm.io/package/proper-lockfile.md) ^4.1.2

## Recent versions

- 2.29.0 (latest) — 2026-09-04
- 2.25.0-beta.1 (beta) — 2026-07-03
- 2.28.1 — 2026-08-27
- 2.28.0 — 2026-08-27
- 2.27.4 — 2026-08-21
- 2.27.3 — 2026-08-19
- 2.27.2 — 2026-08-12
- 2.27.1 — 2026-08-10
- 2.27.0 — 2026-08-10
- 2.26.3 — 2026-07-23
- 2.26.2 — 2026-07-20
- 2.26.1 — 2026-07-15
- 2.26.0 — 2026-07-14
- 2.25.0 — 2026-07-03
- 2.25.0-beta.0 — 2026-06-30
- … 139 more at https://npm.io/package/@eventcatalog/sdk/versions

## README

## @eventcatalog/sdk

SDK to interact with your EventCatalog programmatically in JavaScript/TypeScript.

### Motivation

EventCatalog vision is to integrate with any broker or technology in the world. As its powered by Markdown and contents are built at build time, you can use the SDK
to generate these resources. For example you can integrate with your systems, create domains, services and messages for EventCatalog using this SDK.

The SDK supports standard CRUD operations for domains, service and messages in EventCatalog.

The SDK is useful for creating your own EventCatalog plugins and integrations.

**Features**

- Create, read and delete resources in EventCatalog
- Version any resource in EventCatalog using the `version` SDK api.
- Add files or schemas to resources in EventCatalog
- and more...

### Installation

```sh
npm i @eventcatalog/sdk
```

### Example usage

```typescript
import utils from '@eventcatalog/sdk';

const { getEvent, versionEvent, getService } = utils(PATH_TO_CATALOG);

// Gets event by id
const event = await getEvent('InventoryEvent');

// Gets event by id and version
const event2 = await getEvent('InventoryEvent', '1.0.0');

// Version the event InventoryEvent (e.g goes to /versioned/{version}/InventoryEvent)
await versionEvent('InventoryEvent');

// Returns the service /services/PaymentService
const service = await getService('PaymentService');
```

### CLI

Looking for command-line usage? See [@eventcatalog/cli](../cli).

See the [SDK docs](https://www.eventcatalog.dev/docs/sdk) for more information and examples.

# Enterprise support

Interested in collaborating with us? Our offerings include dedicated support, priority assistance, feature development, custom integrations, and more.

Find more details on our [services page](https://eventcatalog.dev/services).

---
_Source: https://npm.io/package/@eventcatalog/sdk · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._