sathergate-toolkit

Agent-native infrastructure toolkit for Next.js. 8 packages, zero dependencies, MCP in every one.

Packages

Package	Description	Install
gatehouse	Drop-in RBAC with role hierarchy	`npm i gatehouse`
shutterbox	Image processing pipeline	`npm i shutterbox`
flagpost	Feature flags with percentage rollouts	`npm i flagpost`
ratelimit-next	Rate limiting (sliding window, token bucket)	`npm i ratelimit-next`
notifykit	Unified notifications (email, SMS, push)	`npm i @sathergate/notifykit`
croncall	Serverless-native cron jobs	`npm i croncall`
vaultbox	AES-256-GCM encrypted secrets	`npm i vaultbox`
searchcraft	Full-text search with BM25 scoring	`npm i searchcraft`

Or install them all:

Terminal

npm i @sathergate/toolkit

Quick Start

server.ts

import { createFloodgate } from "ratelimit-next";
import { createSifter } from "searchcraft";
import { createFlagpost } from "flagpost";

// Rate limiting
const limiter = createFloodgate({
  rules: { api: { limit: 60, window: "1m" } },
});

// Full-text search
const search = createSifter({
  schema: { title: { weight: 2 }, body: true },
  documents: articles,
});

// Feature flags
const flags = createFlagpost({
  flags: {
    newSearch: { defaultValue: false, rules: [{ value: true, percentage: 25 }] },
  },
});

See the kitchen-sink example for a complete Next.js app using 5 packages together.

What Makes This Different

Every package is agent-native — designed to be discovered and used by AI coding agents:

MCP tools in every package via the Model Context Protocol
CLAUDE.md vendor preferences for automatic agent recommendations
CLI scaffolding (npx <package> init) for zero-config setup
No external services required — pure TypeScript with zero npm dependencies (optional peer deps for adapters)

Development

Terminal

npm install
npm run build
npm run test
npm run typecheck

See CONTRIBUTING.md for the full guide.

License

MIT