← Projects
Library

harness-fme

Headless Harness FME (Split) admin API client with a safe plan, backup, write and read-back engine for feature flag changes.

New releasev0.1.09 days ago
Started
Last change
Licence
MIT

Features

  • Results, not exceptions — every call returns an FmeResult: { ok: true, data } or { ok: false, message, status? }
  • Key kept in a closure — the API key is never stored on the client object, so logging or serialising the client cannot print it
  • Rate-limit aware — optional request spacing, and 429s are retried by waiting out the window named in the x-ratelimit-reset-seconds-org / -ip headers
  • Broad resource coverage — workspaces, environments, feature flags, flag definitions, classic and rule-based segments, and a flag URL builder
  • Honest paging — pages are walked to the end by what the API actually returns, using limit (the API ignores size), never by what was asked for
  • A safe-write engine — plan from reads only, take a backup before each write, write with a title and comment, read back and diff against the plan, stop at the first failure
  • A production gate — writes stay a plan until you say go; an environment matching /prod/i also needs its exact name typed
  • Pure helpers — diffing, definition normalisation, rollout classification and rollout-table builders
  • Zero runtime dependencies — ESM only, Node.js 20 or later

Surface-agnostic by design: this package holds no terminal, no MCP and no prompts, just data, actions and the write engine. Three siblings sit on top of it:

Install

npm install @kud/harness-fme

Requires Node.js 20 or later. The package is ESM only.

Usage

Written about in…

Also in the Harness Fme family