@fortfi/sdk

Canonical FortFi developer package. One install, everything included.

Install

npm install @fortfi/sdk

REST API

OpenAPI-generated clients live in the same package namespace per language. Regenerate and merge before publish:

pnpm api:openapi:generate
pnpm api:sdks:generate
pnpm sdk:prepare-publish -- --lang=ts   # merges REST into packages/sdk/src/rest/

Webhook verification

import { verifyFortFiWebhook } from "@fortfi/sdk"

const result = verifyFortFiWebhook({
  secret: process.env.FORTFI_WEBHOOK_SECRET!,
  rawBody,
  signatureHeader: req.headers["fortfi-webhook-signature"],
  timestampHeader: req.headers["fortfi-webhook-timestamp"],
})

CLI discovery

npx fortfi-sdk help
npx fortfi-sdk methods
npx fortfi-sdk methods getTreasuryContext
npx fortfi-sdk webhooks

Built for terminal users and AI agents exploring the API surface.

Package layout (internal)

| Module | Purpose | |--------|---------| | @fortfi/sdk | Main export: webhooks + catalog helpers | | @fortfi/sdk/webhooks | Webhook verify only (same as root) | | OpenAPI generated | REST client stubs (per language under sdks/) |

@fortfi/webhooks remains as a deprecated alias during migration.