skills/plugins/document-navigator/docs/README.md

packages

Suaveplan package tree. Every @suaveplan/* library lives under a category (packages/<category>/) and a subcategory (packages/<category>/<subcategory>/).

Categories

18 categories, 472 packages.

api-stack

API infrastructure, plugin framework, and HTTP orchestration layer for Suaveplan.

api

API orchestration, plugin lifecycle, routing, workers, and tenant resolution.

Package	Description
@suaveplan/api	The thin Hono-based application orchestrator for the Suaveplan API stack. Composes the four sibling packages — @suaveplan/api-plugin, @suaveplan/api-tenant…
@suaveplan/api-2pc	Two-phase commit coordinator for the Suaveplan API plugin system. Drives Postgres PREPARE TRANSACTION / COMMIT PREPARED / ROLLBACK PREPARED across registered p…
@suaveplan/api-audit-file	File-rotating, HMAC-signed audit sink for @suaveplan/api-host. Implements RequestAuditSink from @suaveplan/api-host/request-pipeline: writes one JSON lin…
@suaveplan/api-audit-stdout	Stdout audit sink for @suaveplan/api-host. Writes JSON-per-line audit records to a LineWriter (default process.stdout) with an HMAC-SHA-256 signature app…
@suaveplan/api-auth	$2 for the Suaveplan API plugin system. Defines the abstract session-resolver shape (Request → Principal | null) used by the host on every request, plus…
@suaveplan/api-auth-anonymous	Stage-4 trivial session resolver for @suaveplan/api. Always returns null for every request. Use this as the tail of resolver chains for public endpoints, a…
@suaveplan/api-auth-bearer-static	Stage-4 service-to-service SessionResolver adapter for the @suaveplan/api plugin system. Matches an inbound Authorization: Bearer <token> header against…
@suaveplan/api-auth-better-auth	Stage-6 Better-Auth adapter for @suaveplan/api. Ships two independently-wireable capability surfaces — createBetterAuthSession (implements `auth.sessio…
@suaveplan/api-auth-jwt	Stage-4 concrete SessionResolver for the @suaveplan/api plugin system. Verifies a JWT presented on the Authorization: Bearer <jwt> header (or a configure…
@suaveplan/api-auth-provider	Abstract account-lifecycle contract for the Suaveplan API plugin system (contracts). This package is OPTIONAL: hosted-IdP deployments (Clerk, Auth0, Cognito) i…
@suaveplan/api-auth-rolled	Stage-8.12 rolled session-token resolver for @suaveplan/api. Issues RS256-signed JWTs with rotating kid slots, verifies tokens through the rotator's active…
@suaveplan/api-auth-static-principal	Fixed-Principal session resolver for the @suaveplan/api plugin system. Returns the configured Principal verbatim on every request — no token decoding, no…
@suaveplan/api-db-adapter	Stage-4 bridge from the @suaveplan/db engine adapters to the plugin AdminDatabaseLike / TenantScopedDatabaseLike surfaces exposed by `@suaveplan/api-type…
@suaveplan/api-db-sqlite-memory	Stage-5 in-memory SQLite database adapter for the @suaveplan/api plugin host testing kit. Wraps bun:sqlite (in :memory: mode by default, or a file path f…
@suaveplan/api-db-worker-proxy	Worker-side proxy for the api db capability. Marshals AdminDatabaseLike and TenantScopedDatabaseLike calls — including transactions and cursor streams —…
@suaveplan/api-events-in-memory	In-memory events bus adapter for the @suaveplan/api testing kit. Wraps @suaveplan/events' production EventBus with a per-topic recording layer so tests c…
@suaveplan/api-events-worker-proxy	Worker-tier proxy over a main-process @suaveplan/events EventBus.
@suaveplan/api-graphql	Stage-1 abstract GraphQL contract for the Suaveplan API plugin system.
@suaveplan/api-graphql-apollo	Stage-7 Apollo Server GraphQL engine adapter for the Suaveplan API plugin system. Implements the GraphqlEngine contract from @suaveplan/api-graphql and pas…
@suaveplan/api-graphql-ui-altair	Altair GraphQL UI plugin for the Suaveplan API plugin system. Structural sibling of @suaveplan/api-graphql-ui-graphiql.
@suaveplan/api-graphql-ui-graphiql	GraphiQL UI mount for the Suaveplan API plugin system. Stage 7 of the umbrella plan.
@suaveplan/api-graphql-yoga	Stage-7 GraphQL Yoga engine adapter. Default GraphQL engine for the Suaveplan API plugin system per design doc §10.5 — Bun-friendly, fastest for our usage…
@suaveplan/api-host	Host orchestration core for the Suaveplan API plugin system. Provides the stable error-code registry (HOST/PLUGIN/RELOAD/CAPABILITY/ADMIN/LEDGER), the author-facing definePlugin DX, the runtime CapabilityRegistry, the LifecycleDriver + ReloadDriver + PluginLedger + admin Hono sub-router, the ErrorBoundary, the §6 11-step RequestPipeline, the top-level createHost(config) entry point composing every internal driver, and the HostInstruments registry covering the §12.3 metric surface. The ./testing subpath is reserved for test utilities.
@suaveplan/api-jobs-worker-proxy	Bidirectional MessagePort proxy that lets a worker-isolated API plugin participate in the host's main-process job scheduler. The worker calls registerCron…
@suaveplan/api-lifecycle	Stage-1 contract package for the Suaveplan API plugin system: the plugin-lifecycle finite state machine definition, the legal-transition table, the side-effect…
@suaveplan/api-loader	Stage-1 contract package for the Suaveplan API plugin system.
@suaveplan/api-logger-worker-proxy	Stage-3 worker → main proxy for @suaveplan/logger. Lets a worker-isolated API plugin call a normal LoggerLike surface while the records cross a `MessagePor…
@suaveplan/api-manifest	Stage-1 contract package of the Suaveplan API plugin system: Zod schemas, parser, cross-field validators, dependency-graph resolver, capability resolver, and c…
@suaveplan/api-migrations	Database-agnostic migration runner for the Suaveplan API. Ships a narrow MigrationAdapter surface (six methods), three shipped adapters (surrealql, `postgr…
@suaveplan/api-openapi	OpenAPI 3.1 registry, typed RouteBuilder, schema registry, and document merger for the Suaveplan API. Single source of truth that wires into Hono via `OpenAP…
@suaveplan/api-openapi-ui-redoc	Stage-8 ReDoc UI adapter for the Suaveplan api-host. Mounts the ReDoc HTML shell at /docs/ui/redoc (or any caller-chosen path) via createRedocUiHandler and…
@suaveplan/api-openapi-ui-scalar	Scalar UI adapter for the Suaveplan OpenAPI plugin system.
@suaveplan/api-openapi-ui-swagger	Swagger UI adapter for the /docs/ui/swagger endpoint of the Suaveplan API plugin system (Stage 8.8). Returns a pure HTTP handler whose response is a `text/ht…
@suaveplan/api-plugin	Plugin-system foundation for the Suaveplan API. Universal — runs unchanged in Bun, Node, and the browser.
@suaveplan/api-plugin-audit	Hono plugin that wraps @suaveplan/audit-logging as a write-through audit trail for @suaveplan/api. Installs a global per-request audit middleware (method /…
@suaveplan/api-plugin-auth	Better-Auth-first authentication plugin for @suaveplan/api. The canonical exemplar of the 3-way plug-and-play contract every @suaveplan/api-plugin-* packag…
@suaveplan/api-plugin-campaigns	Campaigns + suppression + delivery-webhooks HTTP plugin for @suaveplan/api. Mounts the /campaigns, /suppression, and /webhooks route trees on a Hono `O…
@suaveplan/api-plugin-cms	Headless content-management primitives for @suaveplan/api. Ships an in-memory CmsEngine that manages flexible content models, content entries with a `draft…
@suaveplan/api-plugin-database	SurrealDB-backed database plugin for @suaveplan/api. Pools @suaveplan/surrealdb's SurrealAdapter (implementing @suaveplan/db's DatabaseAdapter), runs…
@suaveplan/api-plugin-event-bus	Typed event-bus plugin for @suaveplan/api. Wraps @suaveplan/events (pub/sub, async dispatch, interceptors, bounded-queue backpressure, idempotent listener…
@suaveplan/api-plugin-events	Event-management plugin for @suaveplan/api. Ships a SurrealDB-backed EventRepository + RsvpRepository pair, ten Hono OpenAPI routes (list / get / create…
@suaveplan/api-plugin-example	Reference plugin for the @suaveplan/api-host plugin system. The package is a load-bearing integration target, not a tutorial: every contract surface the host…
@suaveplan/api-plugin-export	Data-export plugin for @suaveplan/api. Turns any registered resource into a CSV (RFC 4180), JSON, or XLSX (SpreadsheetML XML) blob through three self-contain…
@suaveplan/api-plugin-file-upload	Multipart and chunked file-upload plugin for @suaveplan/api. Ships six OpenAPI-typed Hono routes, a pluggable storage + session-store contract, SHA-256 hash…
@suaveplan/api-plugin-graphql	GraphQL description + resolver-composition layer for @suaveplan/api. Server-tier — runs in Bun and Node.
@suaveplan/api-plugin-import	Tabular-data ingest plugin for @suaveplan/api. Parses CSV / JSON / TSV-XLSX payloads, applies declarative column mappings + per-field validation + computed f…
@suaveplan/api-plugin-notifications	SurrealDB-backed notifications + push plugin for @suaveplan/api. Ships a NotificationRepository + DeviceTokenRepository pair, an ApnService with a plug…
@suaveplan/api-plugin-payment	Payment-lifecycle plugin for @suaveplan/api. Wraps @suaveplan/payment + a caller-injected PaymentProvider (Stripe / Adyen / PayPal / Square / Mollie / cu…
@suaveplan/api-plugin-rate-limit	Rate-limit plugin for @suaveplan/api. Wraps @suaveplan/rate-limiter as a definePlugin descriptor exposing per-route + per-tenant configuration, parameter…
@suaveplan/api-plugin-search	Full-text search plugin for @suaveplan/api. Brings TF-weighted relevance scoring, four built-in text analyzers (standard, simple, whitespace, keyword…
@suaveplan/api-plugin-site	Multi-site / multi-domain management plugin for @suaveplan/api. Stores site records (name, slug, theme, settings, push config) in SurrealDB, resolves incom…
@suaveplan/api-plugin-sse	Server-Sent Events plugin for @suaveplan/api. Registers a typed sseService in the host ServiceRegistry, mounts a Hono streaming handler at `GET /sse/:cha…
@suaveplan/api-plugin-tenant	Multi-tenancy plugin for @suaveplan/api. Wraps @suaveplan/api-tenant's resolver chain (header / subdomain / domain / path / JWT / query / cookie) as a firs…
@suaveplan/api-plugin-user	User-profile CRUD plugin for @suaveplan/api. Mounts the canonical /users/me GET/PATCH/DELETE surface on top of @suaveplan/api-plugin-auth, registers a ty…
@suaveplan/api-plugin-vault	Per-user vault HTTP plugin for @suaveplan/api. Third instance of the 3-way plug-and-play contract every @suaveplan/api-plugin-* package follows: the plugin…
@suaveplan/api-plugin-webhook	Signed outbound webhook delivery plugin for @suaveplan/api. Wraps @suaveplan/webhook-client behind a definePlugin descriptor, registers a typed `webhookS…
@suaveplan/api-rate-limit	Per-route / per-principal / per-tenant / per-IP token-bucket rate-limit middleware for @suaveplan/api. Implements the RequestRateLimiter contract consumed…
@suaveplan/api-rbac	Scope + rule-based authorisation middleware for the Suaveplan API plugin system. Produces a framework-agnostic Middleware that consumes the resolved `Princip…
@suaveplan/api-router	Stage-1 contract package for the Suaveplan API plugin system.
@suaveplan/api-router-hono	Stage-4 concrete Hono router adapter for @suaveplan/api. Implements the abstract Router contract from @suaveplan/api-router on top of a Hono Hono insta…
@suaveplan/api-router-in-memory	Stage-5 in-memory router adapter for @suaveplan/api. Implements both the abstract Router contract from @suaveplan/api-router AND the PipelineRouter con…
@suaveplan/api-router-worker-bridge	Stage-3 HTTP bridge that marshals Fetch Request and Response objects across the worker boundary. Pairs a main-side dispatch with a worker- side handler o…
@suaveplan/api-saga	Saga orchestrator for the Suaveplan API plugin system. Drives manifest-declared multi-plugin workflows in declared order with reverse-order compensation on fai…
@suaveplan/api-sandbox-permissions	Permission model for sandboxed-tier API plugins. Centralises the permissions.fs[] / permissions.fetch[] allowlists, the permissions.budgets enforcement,…
@suaveplan/api-sandbox-vm	vm.Context-based sandbox host for Suaveplan API plugins running in the sandboxed tier. The package owns the vm.Context+frozen-globals half of the design do…
@suaveplan/api-sandbox-vm-host-bridge	Host-integration bridge that lets a VmSandboxHandle from @suaveplan/api-sandbox-vm install into @suaveplan/api-host as a first-class plugin.
@suaveplan/api-sandbox-wasm	Stage-8 WebAssembly sandbox host. Instantiates a sandboxed-tier plugin WASM module against a WASI snapshot preview1 implementation derived from the plugin's `P…
@suaveplan/api-sandbox-wasm-host-bridge	Host-integration layer that wraps a @suaveplan/api-sandbox-wasm WasmSandboxHandle as a @suaveplan/api-host PluginModule. Sandboxed-tier plugins compile…
@suaveplan/api-schemas	Shared Zod schemas describing Suaveplan API request/response shapes. The single source of truth for server plugins, React data hooks, and generated OpenAPI doc…
@suaveplan/api-secrets	Abstract Secrets contract for the Suaveplan API plugin system — per-plugin secret access typed against manifest.secrets[], canonical redaction marker, frozen…
@suaveplan/api-secrets-bun	Stage-8 SecretsLike adapter backed by Bun.secrets (macOS Keychain, Linux libsecret, Windows Credential Manager) with per-plugin allow-list enforcement, OS-…
@suaveplan/api-secrets-env	Stage-4 SecretsLike adapter backed by process.env / Bun.env with per-plugin allowed-keys enforcement.
@suaveplan/api-secrets-vault	Stage-8 SecretsLike adapter backed by @suaveplan/vault. The vault is passed in already unlocked by the host's startup sequence; the adapter never sees the…
@suaveplan/api-secrets-worker-proxy	Stage-3 worker → main SecretsLike proxy for the API plugin system.
@suaveplan/api-sse	Abstract Server-Sent Events contracts for @suaveplan/api. Stage-1 contract package: defines the engine-side SseConnection, SseBroker, ReplayBuffer (Las…
@suaveplan/api-sse-bun	Bun.serve-backed Server-Sent Events engine for the @suaveplan/api plugin system. Implements the abstract @suaveplan/api-sse contract and passes `runSseEn…
@suaveplan/api-tenant	Multi-tenant resolution + scoping for the Suaveplan API. Server-tier — runs on Bun and Node, depends on hono and node:async_hooks.
@suaveplan/api-tenant-provider	Abstract TenantProvider contract for the Suaveplan API plugin system. Enumerates the universe of tenants known to a host so per-tenant cron / queued jobs (ma…
@suaveplan/api-tenant-provider-memory	In-memory reference implementation of the @suaveplan/api-tenant-provider TenantProvider contract. Backed by an insertion-ordered `Map<TenantId, TenantRecor…
@suaveplan/api-tenant-resolver-header	Stage-8 tenant resolver. Implements the TenantResolver contract from @suaveplan/api-types/tenant-resolver by reading the tenant identifier from a configura…
@suaveplan/api-tenant-resolver-jwt	Stage-4 tenant resolver for the Suaveplan API plugin system. Reads the already-resolved Principal.tenantId (attached by an earlier api-auth-* chain step) a…
@suaveplan/api-tenant-resolver-subdomain	Stage-8 tenant resolver for the Suaveplan API plugin system. Reads the inbound Host header (and optionally a CIDR-trusted X-Forwarded-Host), strips a confi…
@suaveplan/api-types	Root contract-types package for the Suaveplan API plugin system. Defines every cross-cutting type the foundation packages (api-manifest, api-router, `api-h…
@suaveplan/api-worker-host	Worker-side runtime that hosts exactly one Suaveplan API plugin inside an isolated Worker thread. The main-process counterpart is @suaveplan/api-host; this…
@suaveplan/api-worker-rpc	MessagePort-based RPC protocol for worker-isolated API plugins. Provides the shared protocol — Zod-validated wire frames, monotonic correlation ids, AbortSigna…
@suaveplan/api-ws	Abstract WebSocket engine contract for the Suaveplan API foundation — Connection, ConnectionRegistry, SubscriptionBus, WsBroker, reconnect-token envelope, backpressure + heartbeat policies, cross-tenant capability gate, and a runWsEngineConformance harness. Stage-1 contracts only; concrete engines (api-ws-bun) and brokers (api-ws-broker-redis / -in-memory) plug behind these interfaces.
@suaveplan/api-ws-broker-in-memory	Single-host in-process implementation of the @suaveplan/api-ws WsBroker contract. Suitable for production single-host deployments AND as the default broker…
@suaveplan/api-ws-broker-redis	Cross-host Redis pub/sub broker for @suaveplan/api-ws and @suaveplan/api-sse.
@suaveplan/api-ws-bun	Bun.serve-backed WebSocket engine for the @suaveplan/api-ws Stage-1 abstract contract. The engine composes the per-connection handshake pipeline, registry, s…
@suaveplan/wasm-compiler-javy	TS->WASM compiler closing Stage-8 gate 2.8. Thin orchestrator around Bun.build (bundle) + an injected WASI-stdio ABI shim + Javy v8.1.1 (JS->WASM) +…

commerce

Booking engines, contact management, payment plugins, and commerce primitives.

booking

Universal booking engine with availability, conflict detection, and pricing.

Package	Description
@suaveplan/booking	Universal, JSON-configurable booking engine with pluggable strategies for availability resolution, conflict detection, pricing calculation, and rule evaluation…

contacts

Contact and group management with deduplication and import/export.

Package	Description
@suaveplan/api-plugin-contacts	Contacts and Groups HTTP plugin for @suaveplan/api. Mounts the /contacts and /groups route trees on a Hono OpenAPIHono, backed by SurrealDB implementat…
@suaveplan/audience-rules	Universal audience segmentation: rule-based filtering on contact data with 14 comparison operators, AND/OR chaining, dot-notation field resolution including ar…
@suaveplan/contacts	Universal contact and group management with hierarchical nesting, audience resolution, contact merger, and CSV/JSON import-export. Multi-tenant, channel-agnost…
@suaveplan/macos-contacts	Universal bridge to macOS Contacts.app via AppleScript. Reads contacts and groups through the platform osascript binary, parses the output into typed records…

communication

Email delivery, messaging channels, and webhook clients.

emails

Email delivery, DMARC parsing, templates, campaigns, and suppression lists.

Package	Description
@suaveplan/campaigns	Universal campaign orchestration.
@suaveplan/delivery-tracking	Channel-agnostic delivery event tracking for campaigns and messages: lifecycle dedupe, in-memory + SurrealDB stores, time-series aggregation, tracking pixel an…
@suaveplan/dmarc	DMARC report parser for @suaveplan — parses aggregate (RUA) and forensic (RUF) DMARC XML reports into validated, strongly-typed structures. Accepts raw XML s…
@suaveplan/domain-normalizer	Normalisation, matching, and alias-canonicalisation for internet domain names. Given heterogeneous URL or domain input — including common mobile/CDN subdomains…
@suaveplan/email-processing	Universal MIME parsing and email processing for the Suaveplan . Wraps postal-mime and libmime with structured errors, OpenTelemetry instrumentation, a hook…
@suaveplan/email-templates	Universal, React-free email template engine. Produces email-safe HTML strings with inline styles via VNode factories — runs identically in Bun, Node, and the b…
@suaveplan/emailer	Universal email service with pluggable transports. Ships EmailService, three transports (Dummy / SMTP via injectable SmtpClientLike / Gmail REST via inject…
@suaveplan/suppression	Email suppression list management for Suaveplan. Stores and checks email addresses that should not receive outgoing mail — unsubscribes, hard/soft bounces, com…

messaging

Messaging adapters — Discord, Slack, Telegram, SMS, iMessage, and notifications.

Package	Description
@suaveplan/discord-client	Generic Discord API client for webhooks, bot messaging, and embeds. Runtime-agnostic via injectable fetch and clock. Maps every documented Discord failure…
@suaveplan/imessage-adapter	macOS iMessage SQLite chat.db watcher and MessageSourceAdapter implementation. Polls Apple's ~/Library/Messages/chat.db, decodes Apple-epoch / nanosecond t…
@suaveplan/notification-channel	Multi-channel notification router with templates, sliding-window rate limiting, retry + dead-letter, scheduler, preferences, hooks, OpenTelemetry instrumentati…
@suaveplan/slack-client	Typed, deterministic Slack client — Web API + incoming-webhook surface — with Zod-validated boundaries, OpenTelemetry-instrumented hot paths, injectable `Clock…
@suaveplan/sms	Universal SMS core: provider-agnostic send pipeline with strict E.164 validation, Zod boundaries, template rendering, opt-out registry, token-bucket rate limit…
@suaveplan/sms-providers	Universal SMS provider implementations for @suaveplan/sms. Real HTTP clients for Twilio (Basic auth + form-encoded + X-Twilio-Signature HMAC-SHA1), Vonage (HMAC-SHA256 webhook), MessageBird (AccessKey + JWT HS256 webhook), Plivo (Basic auth + X-Plivo-Signature-V3 HMAC-SHA256), and AWS SNS (inline SigV4 + RSA-SHA1 SNS notification verifier). Ships ProviderRegistry, httpRequest over injectable FetchLike, composeAbortSignal, SMS_PROVIDERS_CODES + SmsProvidersError, per-provider mapStatus, parseInbound, parseOptOutKeyword, and five OTel instruments. No provider SDK deps; every HTTP call flows through an injectable FetchLike seam.
@suaveplan/telegram-client	Telegram Bot API client: send/edit/delete messages, six media variants, inline + custom keyboards, typed errors, injectable fetch + clock, and OpenTelemetr…

webhook-client

Webhook delivery client with retry logic and HMAC verification.

Package	Description
@suaveplan/webhook-client	Webhook delivery client with retry logic, HMAC signature generation/verification, payload transformation, and delivery tracking. Runtime-agnostic (injectable f…

devtools

Developer tooling, documentation generators, Docker helpers, and build utilities.

docker

Docker helpers and GPU runtime configuration.

Package	Description
@suaveplan/docker-nvidia	A collection of docker / docker-compose scripts configured for use with WSL / Nvidia

docs

Documentation utilities, SVG compression, PDF handling, and sitemap generation.

Package	Description
@suaveplan/compress-svg	SVG optimisation and minification for TypeScript. Pure TypeScript — no DOMParser, no external SVG library. Runs in Bun, Node.js, browsers, and edge runtimes.
@suaveplan/docs	Server-tier markdown documentation toolkit for Suaveplan. Discovers every .md file under a repo root, parses each via gray-matter + remark into a structu…
@suaveplan/pdf	Server-tier PDF 1.4 generation toolkit. Chunk A foundation — pure utilities + cross-cutting wiring (typed error registry, Zod boundary schemas, OpenTelemet…
@suaveplan/sitemap	Sitemap generation and parsing for the sitemaps.org XML protocol. Produces valid sitemap.xml, sitemap index documents, and parses existing sitemaps. Supports…

tooling

CLI frameworks, installers, and build tooling.

Package	Description
@suaveplan/cli	Enterprise-grade CLI framework for Node.js. Composable fluent API with subcommand routing, option parsing, OTel tracing, and a full set of terminal UI primitiv…
@suaveplan/electrobun	Electrobun desktop-app generator and orchestrator for the SuavePlan ecosystem. Scaffolds a fresh Electrobun project from a layered config + prompt flow, drives…
@suaveplan/install-agent-skills	Installer plugin that bundles every Suaveplan skill (SKILL.md + assets) and installs them into a target project via @suaveplan/installer.
@suaveplan/installer	Plugin host for project boilerplating and asset installation. Pipelines plugins through detect → prompts → plan → apply → postInstall with transactional roll…
@suaveplan/javy-cli-darwin-arm64	Platform wrapper for Javy v8.1.1 on darwin-arm64.
@suaveplan/javy-cli-darwin-x64	Platform wrapper for Javy v8.1.1 on darwin-x64.
@suaveplan/javy-cli-linux-arm64	Platform wrapper for Javy v8.1.1 on linux-arm64.
@suaveplan/javy-cli-linux-x64	Platform wrapper for Javy v8.1.1 on linux-x64.
@suaveplan/javy-cli-win32-x64	Platform wrapper for Javy v8.1.1 on win32-x64.
@suaveplan/linter	Unified markdown + biome linting pipeline for Suaveplan: a remark-based markdown fixer covering MD012/022/025/029/031/032/035/036/040/044, an injectable `Comma…
@suaveplan/mcp	Universal Model Context Protocol (MCP) server + client with a pluggable transport stack, JSON-RPC dispatcher, AbortSignal cancellation, progress notifications,…
@suaveplan/overview	Machine-readable Suaveplan project manifest: typed PackageRecord / SuavePlanManifest / WorkspaceGraph, Zod schemas, tier inference, filesystem discovery (server sub-path), graph utilities (topo, cycle detection, transitive closure, leaves, roots), plugin/category/tier roll-ups, six OVERVIEW.* error codes, three OTel counters + one histogram.
@suaveplan/profiler	Universal runtime performance profiler.
@suaveplan/readline	AsyncGenerator line reader and interactive prompt interface for Node.js streams, file paths, and Web Streams.
@suaveplan/sandbox	Server-tier sandboxed code execution for @suaveplan plugin hosts and agent runtimes. Ships four SandboxEngine implementations (a node:vm default, real `n…
@suaveplan/test-vite	Vite + Vitest configuration factories and validators for Suaveplan: createViteLibraryConfig, createViteAppConfig, createVitestConfig, `createVitestBrowse…

foundation

Foundational primitives — types, errors, configuration, data structures, and cross-cutting utilities.

barcode

1-D barcode generation and parsing.

Package	Description
@suaveplan/barcode	Runtime-agnostic 1D barcode generation for seven symbologies — Code 128B, Code 39, EAN-13, EAN-8, UPC-A, UPC-E, and ITF. Outputs inline SVG strings and binary…
@suaveplan/qrcode	QR code generation producing SVG, pixel matrix, terminal (Unicode blocks), and data URL representations. Implements QR code versions 1-10, error correction lev…

bitpacker

Bit-level binary packing, schemas, compression, and streaming codecs.

Package	Description
@suaveplan/bitpacker	Core bit-level binary packing library. Provides BitWriter, BitReader, BitPacker, and a pluggable strategy system for schema-driven serialization.
@suaveplan/bitpacker-compressed	Compression pipeline integration for bitpacker.
@suaveplan/bitpacker-crypto	Bit-packer-aware crypto primitives. The shared interfaces (Authority, DomainTag, AuthorityVerifier, AeadOps) live in @suaveplan/types; the canonical…
@suaveplan/bitpacker-delta	Delta encoding utilities for efficient repeated state transmission. Detects changes between successive values and encodes differences rather than full values.
@suaveplan/bitpacker-game	Game state utilities: quantization, prediction, interpolation, and client-server reconciliation.
@suaveplan/bitpacker-network	Network simulation utilities for testing bitpacker under realistic network conditions.
@suaveplan/bitpacker-schema	Schema registry and validation for bitpacker.
@suaveplan/bitpacker-strategies	Built-in packing strategies for @suaveplan/bitpacker. Provides strategies for numbers, strings, booleans, objects, arrays, enums, optional fields, oneOf unio…
@suaveplan/bitpacker-streaming	Streaming APIs for bitpacker including chunked packing/unpacking and true TransformStream support with framing.
@suaveplan/bitpacker-validation	Safety limits and validation reports for bitpacker schemas.

core

Core foundation — types, errors, configuration, schema registry, and utilities.

Package	Description
@suaveplan/config	Layered configuration management for Suaveplan. Resolves an ordered set of typed layers (defaults, file, object, env, CLI) in priority order, deep-merges the r…
@suaveplan/env	Type-safe, schema-first environment variable loading for Node.js and edge runtimes. Define a schema of typed field builders, point it at your sources, and rece…
@suaveplan/error	Foundation error substrate for Suaveplan. Every non-testing @suaveplan/* package extends this library's SuaveplanError base class and uses its stable code…
@suaveplan/schema-registry	Versioned schema registry with forward/backward/full compatibility checking for evolving data contracts. Register schemas by subject name, enforce evolution ru…
@suaveplan/types	Types-only foundation package. Zero runtime code, zero dependencies, zero bundle bytes. Provides the canonical shared interfaces that allow every `@suaveplan/*…
@suaveplan/typescript-config	Shared TypeScript configuration presets for Suaveplan. This package ships composable JSON presets consumed via "extends" across every workspace package — no…
@suaveplan/utils	Zero-external-dependency utility library for Suaveplan. Covers debug helpers, deep object manipulation, platform detection, IEEE 754 float packing, pseudo-rand…

data

Data manipulation, masking, deduplication, diffing, and byte utilities.

Package	Description
@suaveplan/bytes	Low-level byte utilities for Suaveplan: lossless hex/base64/UTF-8 encoding, Uint8Array manipulation, and UUID conversion. No native addons; depends only on p…
@suaveplan/clipboard	Enterprise Clipboard API abstraction for browser-tier consumers. Wraps the async Clipboard API with a textarea + execCommand fallback, a paste-event read fal…
@suaveplan/data-masking	PII/sensitive data masking for objects and strings with field-level rules, nested traversal, eight masking strategies, and OpenTelemetry instrumentation.
@suaveplan/dedup	Entity deduplication engine for detecting and merging duplicate records in any data set. Given a list of objects with varying representations of the same real-…
@suaveplan/diff	Zero-dependency RFC 6902 JSON Patch engine for computing, applying, and inverting structural differences between JSON documents. The diff(a, b) function prod…
@suaveplan/json	Safe, enterprise-grade JSON utilities with prototype-pollution protection, circular-reference detection, and OpenTelemetry instrumentation.
@suaveplan/media	Universal media detection, metadata extraction, and constraint validation. Combines a pluggable magic-byte SignatureRegistry with the MIME database from `@su…
@suaveplan/mime	Structured MIME-type detection, parsing, and registry for the Suaveplan platform. Provides RFC 7231 Content-Type parsing, magic-byte file signature detection,…
@suaveplan/packer	Binary packing/unpacking utilities. Two modes:
@suaveplan/packer-browser	Browser-tier runtime for @suaveplan/packer archives. Ships a Service Worker interceptor, a PackedResourceManager (LRU + Blob-URL bookkeeping + ref-count +…
@suaveplan/pagination	Universal pagination primitives for cursor-based, offset-based, and keyset-based (seek) pagination strategies. The package covers the full pagination surface:…
@suaveplan/pwa	Enterprise browser-tier PWA primitives for Suaveplan applications.
@suaveplan/react-packer	React 19 companion for @suaveplan/packer-browser. Ships usePackedResource, usePackedImage, usePackedAudio, usePackedVideo, and usePackedFont hooks…
@suaveplan/serialize	Round-trip-preserving structured serialization for JavaScript's rich type system. The standard JSON.stringify/JSON.parse pair silently drops Date objects…
@suaveplan/templates	A plugin-based string template engine for TypeScript. Resolves {variable} and {variable:transform} tokens in strings using a priority-sorted, regex-scan pi…
@suaveplan/validation	Runtime schema validation with a Zod-compatible API. This package is a self-contained parse engine — it does not import Zod or any other validation library — s…
@suaveplan/web-workers	Enterprise browser-tier runtime for managing Web Workers, SharedWorkers, and fixed-size worker pools with typed RPC, AbortSignal-aware cancellation, transfer-l…

etl

Extract-Transform-Load pipeline engine with typed stages.

Package	Description
@suaveplan/etl	Extract-Transform-Load pipeline engine with typed stages, error handling, observable progress, and OTel instrumentation.

feature-flags

Feature-flag evaluation engine with percentage and attribute targeting.

Package	Description
@suaveplan/feature-flags	Provider-agnostic feature flag evaluation engine for controlling feature rollout without code deploys. The package ships a FlagManager high-level façade, a `…

flow

Finite state machines, CRDTs, idempotency, and CBOR serialization.

Package	Description
@suaveplan/cbor	RFC 8949 (CBOR) encoder + decoder, RFC 8742 (CBOR Sequences), pull-style streaming decoder (AsyncIterable<Uint8Array> / ReadableStream<Uint8Array>), RFC 90…
@suaveplan/crdt	Conflict-free Replicated Data Types (CRDTs) for distributed systems. Provides eight composable CRDT primitives plus a vector-clock and a sync manager that coor…
@suaveplan/fsm	Typed, generic finite state machine (FSM) for TypeScript. Ships a synchronous-by-default interpreter with guard predicates, ordered transition actions, context…
@suaveplan/idempotency	Idempotency key guard and deduplication for async operations. The package provides a complete pending → completed | failed state machine, three store backend…
@suaveplan/job-scheduler	Universal in-process job scheduler with cron + queued runs, retries, timeouts, concurrency control, and OpenTelemetry observability. Built on @suaveplan/cron…
@suaveplan/queue	Enterprise-grade queue management: memory/priority/delayed queues, concurrent workers with retry and dead-letter forwarding, job state machines, and OTel instr…
@suaveplan/queue-distribution	Worker-pool distribution layer: load-balancing strategies, worker pool management, manager with retry and health checks, in-process LocalWorker. Transport-ag…
@suaveplan/queue-distribution-http	HTTP transport plugin for @suaveplan/queue-distribution. Ships HttpWorkerCommunicator (a fetch-backed WorkerCommunicator with a Zod-validated wire envelo…
@suaveplan/queue-distribution-worker-thread	Web-Worker / Node worker_threads transport plugin for @suaveplan/queue-distribution. Ships WorkerThreadCommunicator (a ThreadWorkerLike-based message b…
@suaveplan/rate-limiter	Enterprise rate limiter with three algorithms, rule-based routing, tenant multipliers, pluggable storage, and OTel instrumentation.
@suaveplan/retry	Retry strategies and circuit-breaker for async operations. The package provides constant, linear, and exponential backoff with four jitter modes (full, equal,…
@suaveplan/rules	Universal rule engine + validation system. Comprehensive RuleEngine with async evaluation, depth limit, AbortSignal, plugin registration; fluent `RuleBuilder…
@suaveplan/rules-hono	Hono middleware wrapping @suaveplan/rules. Six middleware factories — ruleMiddleware, validationMiddleware, accessControl, responseValidation, `rateL…
@suaveplan/streams	WHATWG-Streams-based primitives: backpressure-first transforms, zero-copy Uint8Array operations, AbortSignal integration end-to-end, structured errors, OTe…
@suaveplan/streams-chunk-queue	Universal out-of-order chunk reconstitution. Accepts chunks for a file in any order and exposes a sequential ReadableStream<Uint8Array> consumer surface, com…
@suaveplan/streams-metadata	Universal stream transforms that detect MIME type and extract EXIF/IPTC/XMP image metadata from buffered Uint8Array payloads. Three composable transforms (`M…
@suaveplan/undo	Enterprise-grade undo/redo engine with branching history, async commands, history compression, selective undo, and command merging. Built for collaborative edi…
@suaveplan/workflow	Workflow and pipeline orchestration: sequential and parallel step execution, conditional branching with guard functions, retry strategies, timeouts, saga-patte…

random

Pseudo-random generators, noise functions, and deterministic sequences.

Package	Description
@suaveplan/noise	Seeded spatial noise fields for procedural content generation. Provides six field types — Perlin, Simplex (2D/3D/4D), Value, Worley/cellular (F1/F2/F2-F1 modes…
@suaveplan/pseudo-random	Deterministic, seeded pseudo-random number generators (PRNGs) conforming to the Rng interface from @suaveplan/types. Ships four algorithms — Mulberry32, SF…
@suaveplan/random	High-level cryptographically secure randomness for application use. This is the everyday random package — it wraps the CSPRNG with ergonomic helpers for every…

timing

Cron, stopwatches, throttling, debouncing, and scheduling.

Package	Description
@suaveplan/cron	Universal cron expression parser, next-fire calculator with timezone + DST awareness, and an opt-in lightweight in-process scheduler. Zero external cron depend…
@suaveplan/datetime	Timezone-aware date/time utilities covering the most common application-layer date operations that the native Date API leaves unaddressed. The package provid…
@suaveplan/timing	Timing and scheduling utilities for application-layer time management. The package covers measurement (stopwatch with lap recording), rate control (throttle an…

gaming

Game engines, entity-component systems, and simulation libraries.

games

Game controllers, entity-component systems, and game-server logic.

Package	Description
@suaveplan/controller	Universal input controller foundation. Ships the unified ControllerInput shape (37 normalised fields in [0, 255]), BaseController abstract base with inje…
@suaveplan/ecs	Archetype-based Entity Component System with Uint32-backed bitset queries, phase-ordered system scheduling, entity-ID recycling, Zod-validated component sche…
@suaveplan/game-server	Universal game-server framework. Migrated from @suaveplan/game-server on the reference branch claude/review-game-engine-arch-Kaykr (main repo `packages/uni…

geospatial

Geospatial data, mapping, planetary coordinates, and logistics utilities.

geo

Geospatial coordinates, planetary data, and solar-system modelling.

Package	Description
@suaveplan/geo	Abstract spherical and ellipsoidal geometry — pure math with no planet-specific constants. Every operation that needs a body's shape takes an explicit `Ellipso…
@suaveplan/geo-earth	Earth configuration and legacy geo utilities.
@suaveplan/geo-planet	Configurable planet surface geometry from PlanetConfig — ellipsoid, atmosphere, satellites, and orbital elements.
@suaveplan/solar-system	Solar system provider with astronomy engine.
@suaveplan/stars	Star catalog provider.
@suaveplan/tides	Tidal prediction providers.
@suaveplan/universe	Observer model, coordinate frames, wire protocol, and provider registry.

logistics

Port data and logistics primitives.

Package	Description
@suaveplan/ports	Global port database with shipping-lane routing, ETA estimation, and UN/LOCODE port lookups for sea ports, airports, and rail terminals.

identity

Authentication, authorization, identity resolution, and credential management.

auth

Authentication providers, JWT, WebAuthn, OAuth, and session resolution.

Package	Description
@suaveplan/auth	Provider-agnostic authentication library for Suaveplan. Ships JWT token lifecycle, API key management, session management, and framework-agnostic middleware —…
@suaveplan/better-auth-surrealdb	Better-Auth Adapter for SurrealDB v3 — bundles the canonical 17-table SurrealQL schema, compiles Better-Auth Where[] filters to parameterised SurrealQL, auto…
@suaveplan/jwt-tenant	JWT-based multi-tenant token issuance and verification for Suaveplan. Ships an Ed25519 / ECDSA-P256 signing pipeline, in-memory JWKS store with rotation and ex…
@suaveplan/macos-keychain	macOS Keychain bridge for generic-password credentials. Wraps the system /usr/bin/security CLI behind a strongly-typed CRUD surface with typed errors, AbortS…
@suaveplan/oauth-client	Universal OAuth 2.0 / OIDC client for Node.js, browsers, Bun, Deno, and edge runtimes.
@suaveplan/permissions	Full RBAC/ABAC permissions engine for Suaveplan. Ships role management, policy evaluation, CASL-inspired ability builder, TTL permission cache, condition evalu…
@suaveplan/webauthn	W3C WebAuthn Level 3 client + parser + verifier for Suaveplan. Browser-tier registration / authentication entry points sit on the package root; framework-agnos…

localization

Internationalization, localization, locale detection, and translation infrastructure.

i18n

Internationalization core, backends, detectors, and locale resolution.

Package	Description
@suaveplan/i18n	Slim integration core for the i18n family. After the Wave 6 modular split, this package owns the MessageCatalog, the createI18n / I18nInstance plugin slo…
@suaveplan/i18n-backend-chained	Universal chained backend orchestrator for the @suaveplan/i18n family. Composes N backends into a single Backend with read-fallthrough on `BACKEND_LOCALE_N…
@suaveplan/i18n-backend-fs-multifile	Server-tier multi-file Node fs/promises translation backend for the @suaveplan/i18n family. Reads //. (nested), /.. (flat), or a caller-supplied glob pattern. JSON built-in; YAML and JSON5 auto-detected via dynamic import. Optional fs.watch loop emits loaded events through the catalog event bus. AbortSignal cancellation, OpenTelemetry instrumentation under i18n.backend.fs_multifile.*. Server-only — uses node:fs/promises; browser consumers should use @suaveplan/i18n-backend-http or @suaveplan/i18n-backend-storage.
@suaveplan/i18n-backend-http	Universal translation backend for the @suaveplan/i18n family, backed by an injectable fetch. Read-only by design: maps HTTP 404 to `BACKEND_LOCALE_NOT_AVAI…
@suaveplan/i18n-backend-memory	Universal in-memory translation backend for the @suaveplan/i18n family. Backed by Map<locale, Map<namespace, TranslationRecord>> plus a modification ledger…
@suaveplan/i18n-backend-storage	Universal translation backend for the @suaveplan/i18n family, backed by any AbstractStorage implementation from @suaveplan/storage. Implements the full `…
@suaveplan/i18n-detector	Universal locale-detection chain for the @suaveplan/i18n family. Ships the chain orchestrator, the BCP-47 default negotiator, the getTextDirection / `isRtl…
@suaveplan/i18n-formatter-collator	Wrapper around Intl.Collator for the @suaveplan/i18n family — locale-aware string comparison and sorting (sensitivity, numeric-aware natural sort, case-fir…
@suaveplan/i18n-formatter-currency	Locale-aware currency formatting backed by Intl.NumberFormat with style: "currency". Wave 3 of the 14-package i18n modular split. Provides both a class (`C…
@suaveplan/i18n-formatter-date	Wrapper around Intl.DateTimeFormat for the @suaveplan/i18n family — 8-preset table (short/medium/long/full × date+time/time-only/date-only), range renderin…
@suaveplan/i18n-formatter-display-name	Wrapper around Intl.DisplayNames for the @suaveplan/i18n family — locale-aware language, region, script, currency, and calendar display names. Universal le…
@suaveplan/i18n-formatter-list	Locale-aware list joining backed by Intl.ListFormat. Wave 3 of the 14-package i18n modular split. Provides both a class (ListFormatter) and a standalone he…
@suaveplan/i18n-formatter-number	Locale-aware number formatting backed by Intl.NumberFormat. Wave 3 of the 14-package i18n modular split. Provides both a class (NumberFormatter) and a stan…
@suaveplan/i18n-formatter-relative-time	Locale-aware relative-time formatting backed by Intl.RelativeTimeFormat. Wave 3 of the 14-package i18n modular split. Provides both a class (`RelativeTimeFor…
@suaveplan/i18n-formatter-segmenter	Wrapper around Intl.Segmenter for the @suaveplan/i18n family — locale-aware text segmentation by grapheme, word, or sentence. Compound emoji count as a sin…
@suaveplan/i18n-icu-parser	ICU MessageFormat parser, {{var}} interpolation engine, and 9-language CLDR pluralization for the @suaveplan/i18n family. Universal leaf package — depends…
@suaveplan/i18n-shared	Shared runtime atoms for the entire @suaveplan/i18n* package family — locale constants, BCP-47 normalisation map, RTL set, locale descriptors, interpolation…
@suaveplan/locale-data	Static ISO 3166-1 country data and ISO 639-1 language data with typed lookup functions, OTel instrumentation, and Zod schemas.
@suaveplan/react-i18n	React bindings for @suaveplan/i18n. Ships the <TranslationProvider>, twelve hooks, four headless components, the class-component HOC, the nine built-in loc…

media

Audio, video, image, and font processing libraries.

audio

Audio processing, playback, analysis, and effect plugins.

Package	Description
@suaveplan/audio-analysis-beat	Universal beat, tempo, and onset detection plugin for the @suaveplan/audio-* family. Detects BPM, beat locations, and onset times from AudioDocument stream…
@suaveplan/audio-analysis-loudness	Universal ITU-R BS.1770-4 loudness analyser. Drop-in AnalysisOp plugin for the @suaveplan/audio-* family.
@suaveplan/audio-analysis-pitch	Universal pitch, key, and chord detection Analysis Op plugins for the @suaveplan/audio-* family. Three detectors:
@suaveplan/audio-analysis-spectrum	Universal spectral analysis for the Suaveplan audio stack: real FFT, Hann/Hamming/Blackman windows, mel filterbank, DCT-II, and three high-level analyzers — `S…
@suaveplan/audio-cli	Server-tier audio command-line tool. Thin shell over @suaveplan/audio-core, @suaveplan/audio-codecs, and @suaveplan/audio-engine-server: every audio tr…
@suaveplan/audio-codec-ffmpeg-native	Server-tier AudioCodec plugin for @suaveplan/audio-codecs that shells out to the system ffmpeg binary via fluent-ffmpeg and streams audio through the s…
@suaveplan/audio-codec-ffmpeg-wasm	Browser-tier AudioCodec plugin for @suaveplan/audio-codecs backed by @ffmpeg/ffmpeg running inside a dedicated Web Worker. Decodes and encodes wav, `mp…
@suaveplan/audio-codecs	Universal audio codec registry: decode/encode plugin loader with magic-byte format detection, progressive streaming decode, native WAV/AIFF/CAF codecs, and laz…
@suaveplan/audio-controllers	Universal MIDI hardware controller plugins. Built on @suaveplan/audio-core, @suaveplan/audio-transport, @suaveplan/events, @suaveplan/fsm, and `@suavep…
@suaveplan/audio-core	Universal audio data model and processing primitives. Provides a paged AudioDocument, a non-destructive PlanEngine, a block-level ProcessPipeline, and a…
@suaveplan/audio-decode-wav	Universal WAV decoder wrapper over the upstream @audio/decode-wav library. Exposes a stable, OTel-instrumented, AbortSignal-honouring contract over a frozen,…
@suaveplan/audio-engine-browser	Browser-tier TimelineAdapter implementation for the @suaveplan/audio-* family. Hosts Web Audio rendering, AudioWorklet loading, and the `AudioFxPlugin.cr…
@suaveplan/audio-engine-server	Server-tier audio I/O layer for the @suaveplan/audio-* family. Provides the thinnest possible bridge between universal AudioDocument primitives and a Node.…
@suaveplan/audio-fingerprint	High-accuracy audio fingerprinting service. The package is dual-runtime: a Python FastAPI backend (src/fingerprint.py + src/api/app.py) implements chromagr…
@suaveplan/audio-metadata	Universal audio metadata extractor that parses ID3v1/v2, MP4/M4A atoms, FLAC Vorbis comments, Ogg Vorbis, WAV RIFF, and AIFF/AIFC containers, returning a norma…
@suaveplan/audio-sprite-packer	Universal audio sprite packer with injectable adapter, Zod-validated boundaries, and OpenTelemetry instrumentation. Zero browser or Node.js dependencies.
@suaveplan/audio-sprite-player	Universal audio sprite playback engine. Consumes manifests produced by @suaveplan/audio-sprite-packer, validates them, schedules voices, runs voice-stealing…
@suaveplan/audio-timeline	Headless DAW timeline engine with multi-track arrangements, clips, playback, loop regions, selection, zoom, per-track mixer state, undo/redo, and a pluggable `…
@suaveplan/audio-transport	Universal musical clock and transport: sample-accurate scheduling with PPQ, BPM automation, swing, time signatures, and loop regions. Zero browser or Node depe…
@suaveplan/control-surface-schema	Universal canonical schema for DAW-style control surfaces. Owns the ControlSurface root document, the ControlNode = Group | Control discriminated tree, the…
@suaveplan/midi	Universal MIDI primitives for the Suaveplan platform. Owns the canonical types, byte parsers, message constructors, control-surface dispatchers (NRPN, RPN, 14-…
@suaveplan/third-party-elevenlabs
@suaveplan/voice	Provider-agnostic voice core for Suaveplan. Defines the abstract interfaces, shared types, Zod schemas, and structured error hierarchy that every voice provide…
@suaveplan/voice-elevenlabs	ElevenLabs domain adapter for the @suaveplan/voice interface family.

audio-fx

Real-time audio effects and DSP plugins.

Package	Description
@suaveplan/audio-fx-plugin-audio-analyzer	audio-analyzer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-audio-player	audio-player plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-auto-filter	auto-filter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-base	Foundation for the @suaveplan/audio-fx-plugin-* family. Universal (browser / server / offline / worklet identical). Zero @suaveplan/audio-fx-plugin-* deps…
@suaveplan/audio-fx-plugin-chorus	chorus plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-compressor	compressor plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-delay	delay plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-distortion	distortion plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-eq	Parametric / shelving / high-pass / low-pass equaliser for the @suaveplan/audio-fx-plugin-* family. Multi-band biquad implementation, sample-accurate paramet…
@suaveplan/audio-fx-plugin-filter	filter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-flanger	flanger plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-game-audio	game-audio plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-gate	gate plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-glados	glados plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-limiter	limiter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-microphone	microphone plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-mixer	mixer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-phaser	phaser plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-pitch-shifter	pitch-shifter plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-reverb	reverb plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-sampler	sampler plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-spatial	spatial plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-spessasynth	SF2/SF3 SoundFont synthesizer plugin for the @suaveplan/audio-fx-plugin-* family. Wraps the MIT-licensed SpessaSynth engine as a standard AudioFxPlugin, so…
@suaveplan/audio-fx-plugin-synthesizer	synthesizer plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-tremolo	tremolo plugin for the @suaveplan/audio-fx-plugin-* family.
@suaveplan/audio-fx-plugin-widener	widener plugin for the @suaveplan/audio-fx-plugin-* family.

audio-ir

Impulse-response capture, loading, and room-acoustic plugins.

Package	Description
@suaveplan/audio-ir-core	Foundation contract for the @suaveplan/audio-ir-* family. Universal; zero @suaveplan/audio-* runtime deps. Every sibling package (audio-ir-loader, `audio…
@suaveplan/audio-ir-loader	Pipeline package for the @suaveplan/audio-ir-* family. Composes IrRegistry (from @suaveplan/audio-ir-core), a StorageUriResolver (from `@suaveplan/stor…
@suaveplan/audio-ir-room-plugin-club	Original audio-ir content package. Ships two bundled room impulse responses (club1.wav, club2.wav) wired through the @suaveplan/audio-ir-* family.
@suaveplan/audio-ir-room-plugin-pool	Original audio-ir content package. Ships a single room-family impulse response — pool-outdoor-swimming-pool — sourced from the outdoor-swimming-pool captur…

fonts

Font packing, compression, subsetting, and conversion tools.

Package	Description
@suaveplan/font-compress	BTF (Binary TypeFace) binary packing and unpacking. Converts TypefaceFont (typeface.js JSON format) to a compact Uint8Array using dictionary-based integer…
@suaveplan/font-convert	Converts TTF/OTF/WOFF/WOFF2 font files to the typeface.js JSON format used by Three.js FontLoader. Also defines the canonical TypefaceFont, TypefaceGlyph…
@suaveplan/font-decompress	BTF (Binary TypeFace) binary unpacking. Reverses @suaveplan/font-compress's BinaryFontPacker output into a typeface.js JSON shape ready for Three.js / R3F…
@suaveplan/font-subset	Font subsetting and compression library with a codec-agnostic adapter interface. Supports Unicode range subsetting, WOFF2/WOFF/OTF/TTF output, OpenType feature…

image

Image compression, colour conversion, EXIF handling, and optimisation.

Package	Description
@suaveplan/caddy-imgproxy	Universal TypeScript port of the Caddy imgproxy URL rewriter. Parses the compact /u<op><gravity><dims><modifiers>/<path>.<format> grammar, resolves aspect-ra…
@suaveplan/colour-convert-adapt	Bradford chromatic adaptation for XYZ colour coordinates. Chromatic adaptation adjusts a colour's appearance so that it looks the same under different light so…
@suaveplan/colour-convert-cieluv	CIELUV, xyY, LMS, and Bradford chromatic adaptation conversions. This plugin provides colour-space transforms between RGB, CIELUV, xyY, and LMS cone-response s…
@suaveplan/colour-convert-cmyk	Bidirectional conversion between RGB and CMYK colour spaces using the standard Euclidean algorithm with black generation. CMYK is the subtractive model used in…
@suaveplan/colour-convert-hsluv	HSLuv perceptually-uniform colour space with gamut-mapped ray intersection for sRGB. This plugin provides bidirectional RGB↔HSLuv/HPLuv conversions and uniform…
@suaveplan/colour-filter-cct	Correlated Colour Temperature (CCT) conversions using the McCamy formula and black-body RGB approximation. Convert any RGB colour to its approximate colour tem…
@suaveplan/colour-filter-cmc	CMC l:c Delta-E colour difference metric with hue-dependent chroma scaling and low-luminance branch handling. This plugin computes perceptual distance between…
@suaveplan/colour-filter-greyscale	Converts any RGB colour to its perceptual greyscale equivalent using the ITU-R BT.709 luminance coefficients. Unlike simple channel averaging, this formula wei…
@suaveplan/colour-filter-sepia	Applies a photographic sepia tone filter to RGB colours using the standard W3C CSS Filters 3×3 matrix. This plugin converts any colour into a warm brownish ton…
@suaveplan/colours	Universal colour manipulation library: parsing, conversion, analysis, mixing, blending, and palette generation. Parses hex (3/4/6/8 digit), CSS rgb(), `hsl()…
@suaveplan/compress-image	Runtime-agnostic image compression utilities with pluggable adapters for Node.js (Sharp) and testing (MemoryAdapter). Supports resize, quality reduction, forma…
@suaveplan/emblem-solver	Minimal-rectangle SVG converter for pixelated sprite emblems.
@suaveplan/exif	Dependency-free, runtime-agnostic EXIF/XMP/IPTC metadata reader, writer, and stripper for JPEG and PNG images. Parses JPEG segment chains to locate and decode…
@suaveplan/image	Universal image metadata extraction, format detection, resize math, crop validation, and transform pipeline planning. Zero browser or Node dependencies — runs…
@suaveplan/image-quantisation	Image complexity analysis and adaptive colour quantisation with pool detection, spatial-aware anti-aliasing cleanup, and multiple quantisation algorithms. Desi…

video

Video encoding, decoding, and thumbnail generation.

Package	Description
@suaveplan/video	Universal video metadata extraction, magic-byte format detection, resolution math, transform-pipeline planning, and a fluent pipeline builder. Zero browser-onl…
@suaveplan/video-thumbnails	Video thumbnail extraction and sprite-sheet generation backed by an injectable FfmpegRunner. The default runner — FluentFfmpegRunner — wraps `fluent-ffmpeg…

money

Payments, currencies, cryptocurrency, and financial primitives.

finance

Currency conversion, cryptocurrency utilities, and exchange-rate providers.

Package	Description
@suaveplan/cryptocurrency	Universal cryptocurrency utilities for wallet address validation, unit conversion, chain registry, gas estimation, ERC-20 token registry, calldata / function-s…
@suaveplan/currency	Universal currency conversion engine — pluggable CurrencyProvider interface, TTL-bounded RateCache with direct / inverse / triangulated lookup, primary + f…
@suaveplan/currency-provider-binance	Binance public-ticker crypto-rates provider for @suaveplan/currency. Sibling package in the foundation-with-sibling-plugins shape: implements the `CurrencyPr…
@suaveplan/currency-provider-coingecko	Universal CoinGecko sibling for @suaveplan/currency-providers. Implements the CurrencyProvider contract from @suaveplan/currency against the public `/sim…
@suaveplan/currency-provider-coinmarketcap	CoinMarketCap crypto-rates sibling provider for @suaveplan/currency. One of the nine @suaveplan/currency-provider-<name> sibling packages spun out of the 2…
@suaveplan/currency-provider-cryptocompare	Universal CryptoCompare crypto-rates provider for @suaveplan/currency. Sibling provider package on top of the slim @suaveplan/currency-providers core (`htt…
@suaveplan/currency-provider-ecb	Universal @suaveplan/currency rate provider for the European Central Bank's daily exchange-rates XML feed. Free, no API key required. Built on the slim `@sua…
@suaveplan/currency-provider-fixer	Fixer.io fiat-rates sibling provider for the slim @suaveplan/currency-providers core. Implements the CurrencyProvider contract from @suaveplan/currency,…
@suaveplan/currency-provider-kraken	Universal Kraken public-ticker rate provider for @suaveplan/currency. Wraps Kraken's free, no-API-key /0/public/Ticker endpoint into a CurrencyProvider s…
@suaveplan/currency-provider-open-exchange-rates	Universal @suaveplan/currency provider for openexchangerates.org. Routes /latest.json through the slim-core httpRequest() helper, validates the upstream…
@suaveplan/currency-provider-virtual	In-memory, programmable virtual / game currency provider for @suaveplan/currency. Sibling of the @suaveplan/currency-providers slim plugin core. No HTTP, n…
@suaveplan/currency-providers	Slim plugin core for @suaveplan/currency rate providers. Ships the CurrencyProviderRegistry (name-keyed lookup), the defineCurrencyProvider factory, the…
@suaveplan/money	Universal precise currency and money arithmetic using integer minor-unit representation. All operations use bigint so consumers never hit floating-point roun…

payment

Payment intent lifecycle, provider adapters, and fraud detection.

Package	Description
@suaveplan/payment	Universal payment intent lifecycle, webhook signature verification, receipt generation, fraud scoring, refund tracking, tax calculation, retry orchestration, r…
@suaveplan/payment-provider-adyen	Universal Adyen Checkout API v71 adapter for @suaveplan/payment. Implements the PaymentProvider interface via the slim @suaveplan/payment-providers c…
@suaveplan/payment-provider-mollie	Universal Mollie Payments API v2 adapter for @suaveplan/payment. Sibling provider package on the slim @suaveplan/payment-providers core: implements `Paymen…
@suaveplan/payment-provider-paypal	PayPal sibling adapter for the slim @suaveplan/payment-providers foundation. Ships PayPalProvider — a PaymentProvider implementation against the PayPal O…
@suaveplan/payment-provider-square	Universal Square Payments API adapter for @suaveplan/payment. Ships the SquareProvider class (implements the structural PaymentProvider contract with lit…
@suaveplan/payment-provider-stripe	Universal Stripe adapter for @suaveplan/payment. Implements PaymentProvider against the Stripe REST API using the slim @suaveplan/payment-providers found…
@suaveplan/payment-providers	Universal foundation for the @suaveplan/payment-provider-* sibling-package family. This package ships only the shared abstractions every concrete adapter…

networking

Distributed networking, event buses, drive mesh, and network discovery.

drive

Virtual filesystem, mesh networking, and chunk-addressed storage plugins.

Package	Description
@suaveplan/drive	Modular virtual filesystem core for Suaveplan. File-level operations over AbstractStorage with a plugin slot for middleware, chunking, encryption, and P2P me…
@suaveplan/drive-mesh	P2P mesh orchestrator over the drive chunks plugin. Consumes ChunkSource (from @suaveplan/drive-plugin-chunks) and one or more DriveTransport implementat…
@suaveplan/drive-mesh-protocol	Wire protocol for chunk discovery, request, and delivery across the mesh. Three envelope shapes (cd:request, cd:advertise, cd:response) with three reques…
@suaveplan/drive-plugin-cache	Read-through cache middleware for @suaveplan/drive. Accepts a caller-supplied AbstractCache<Uint8Array> (from @suaveplan/cache) and intercepts every `dri…
@suaveplan/drive-plugin-chunks	Chunk-addressing plugin for @suaveplan/drive. Splits files into signed, encrypted chunks using the locked version 0x0001 binary format, with server-signed…
@suaveplan/drive-react-sharing	React-tier UI surface for @suaveplan/drive-sharing. Three controlled components plus a real-engine-backed hook.
@suaveplan/drive-sharing	Partitioned drive sharing engine for the Suaveplan ecosystem. Ships envelope encryption with mandatory AAD, per-user key wrapping, partition policies with dete…
@suaveplan/drive-storage-archive-core	Shared archive-mounting primitives for the Suaveplan drive: magic-byte format sniffing, split-volume sibling resolution, password hook contract, mutation-mode…
@suaveplan/drive-storage-zip	ZIP archive adapter for @suaveplan/drive. Reads and writes standards-compliant zip archives through the structural DriveStorage view; supports ZIP64, split…
@suaveplan/drive-template	Server-signed drive templates for the dehydrated-drive workflow. A DriveTemplate describes a drive's full folder structure and per-file metadata; the actual…
@suaveplan/drive-transport-https	HTTPS-relay-backed TransportLike<MessageEnvelope> for the Suaveplan drive mesh. Implements long-poll receive, stateless POST send, exponential backoff with e…
@suaveplan/drive-transport-webrtc	WebRTC datachannel transport for the drive mesh. Implements the canonical DriveTransport interface from @suaveplan/drive-mesh over a `@suaveplan/drive-webr…
@suaveplan/drive-uri	URI plugins (drive://, drive+mesh://, drive+template://) for @suaveplan/storage-uri's StorageUriResolver. Wraps a caller-supplied Drive instance in…
@suaveplan/drive-webrtc	Browser-tier WebRTC P2P chunk-distribution plugin for @suaveplan/drive. Provides a complete mesh networking stack — signalling client, ICE-aware WebRTC clien…

events

Typed event bus, event sourcing, metrics, and transport bridges.

Package	Description
@suaveplan/broadcast-channel	Typed cross-tab messaging built on the Web BroadcastChannel API. Browser-tier package — leader election, tab presence and heartbeats, message-type handler re…
@suaveplan/event-sourcing	Event sourcing patterns for Suaveplan: typed aggregate root, in-memory event store with optimistic concurrency, snapshot support, projections, upcasting, and O…
@suaveplan/events	Typed event-bus substrate for Suaveplan. Pub/sub with deterministic FIFO delivery, interceptor API, bounded-queue backpressure, idempotent listeners, Zod-valid…
@suaveplan/events-metrics	OTel metrics companion for @suaveplan/events. Attaches via the public interceptor API to record dispatch totals, listener error counts, and latency histogram…
@suaveplan/events-otel	OpenTelemetry tracing companion for @suaveplan/events. Wraps each dispatch in a span, propagates W3C Trace Context, and records listener exceptions as span e…
@suaveplan/events-schema	Runtime schema-validation companion for @suaveplan/events. Validates event payloads at dispatch boundaries via Zod schemas with strict/warn/sample modes and…
@suaveplan/events-transport	Cross-context event bridges for @suaveplan/events: MessageChannel (at-least-once with ack/retry) and BroadcastChannel (at-most-once, fan-out) transports…

network

Mesh networking, WebSocket transports, bootstrap, and discovery protocols.

Package	Description
@suaveplan/network	Core network interfaces and runtime for the mesh system.
@suaveplan/network-bootstrap	Pluggable peer-discovery chain, persistent peer cache, and NetworkPlugin wrapper for the @suaveplan/network mesh. Provides the canonical way for a freshly…
@suaveplan/network-discovery-crdt	Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap. Wraps an awareness-document CRDT (Yjs or Automerge — chosen at construction) and produce…
@suaveplan/network-discovery-gundb	Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap chains. Wraps a GunDB instance — gossip-over- WebSocket decentralised graph database — and…
@suaveplan/network-discovery-hybrid	Browser-tier multi-strategy DiscoveryStrategy orchestrator: composes any subset of the five Wave-2 sibling strategies (peerjs / crdt / trystero / webtorrent / gundb) into a single HybridDiscoveryManager with priority-based peer selection, per-strategy health tracking, automatic fallback, de-duplicated peer set with PeerSource provenance, and unified lifecycle. Implements the network-bootstrap DiscoveryStrategy contract so it can itself be chained.
@suaveplan/network-discovery-peerjs	Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap that wraps a PeerJS signalling-server client + WebRTC DataConnections into a deduped peer…
@suaveplan/network-discovery-trystero	Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap. Serverless WebRTC peer discovery via Trystero, with four interchangeable transports — BitT…
@suaveplan/network-discovery-webtorrent	Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap chains. Wraps a p2pt instance — WebTorrent-tracker-driven WebRTC peer discovery — and exp…
@suaveplan/network-gundb-server	Server-tier GunDB relay daemon. Hosts a Gun relay peer plus standard /health / /ready / /live probes on a single Node http.Server. Browser-tier clients…
@suaveplan/network-libp2p-server	Server-tier libp2p relay daemon paired with @suaveplan/network-transport-libp2p. Hosts a libp2p node configured as a bootstrap + circuit-relay-v2 server alon…
@suaveplan/network-plugin-assignment	Mesh auto-assignment and load balancing: live MeshCapacityTracker, weighted-multi-criteria AssignmentEngine, imbalance-detecting MeshBalancer planner, an…
@suaveplan/network-plugin-audit-mesh	Tamper-evident, cryptographically signed, append-only audit log chain for the Suaveplan mesh. SignedLog produces hash-chained LogEntry records keyed by mon…
@suaveplan/network-plugin-auth	Mesh membership authentication and cross-mesh relay authorization. Bridges @suaveplan/auth into the mesh: peer join verification, capability-tier-bound token…
@suaveplan/network-plugin-circuit-breaker	Mesh-level circuit breakers: per-path state machine (CLOSED → OPEN → HALF_OPEN), registry, half-open probe loop, and relay middleware integration. Fast-fails…
@suaveplan/network-plugin-content-delivery	Mesh-as-CDN core for the Suaveplan network. ChunkIndex maintains a distributed holder map keyed by chunk hash with gossip-style merge over `ChunkAdvertisemen…
@suaveplan/network-plugin-crypto-messages	Cryptographic integrity layer for the Suaveplan mesh. Ed25519-backed MessageSigner (sign on send, verify against the registry on receive); `SessionTokenAutho…
@suaveplan/network-plugin-devtools	Developer-tools plugin for the Suaveplan mesh. Bundles four subsystems behind a single NetworkPlugin lifecycle so engineers can inspect, visualise, and profi…
@suaveplan/network-plugin-failover	Mesh failover plugin: per-peer heartbeat manager, alive→suspect→dead→recovering health monitor, debounced promoter that triggers emergency elections, and a coo…
@suaveplan/network-plugin-governance	Election engine for the Suaveplan mesh: candidate scoring, reputation tracking, voting, and host transitions.
@suaveplan/network-plugin-intra-relay	Intra-mesh peer-to-peer relay for the Suaveplan network. When direct WebRTC fails (symmetric NAT, restrictive firewall), IntraRelayPlugin routes the message…
@suaveplan/network-plugin-middleware	Priority-ordered middleware chain for the Suaveplan mesh. Inbound and outbound message flow each pass through the same five-band pipeline (CRITICAL → HIGH → NO…
@suaveplan/network-plugin-migration	Peer state migration between meshes: 8-step MigrationCoordinator, snapshot serialize/deserialize via StateTransferProtocol, graceful-handoff `ForwardingTun…
@suaveplan/network-plugin-monitor	Production monitoring + distributed tracing for the Suaveplan mesh. Collects metrics across four categories (node / connection / message / hierarchy), supports…
@suaveplan/network-plugin-partition	Split-brain detection and resolution for the mesh: epoch-based PartitionDetector (deterministic partition-id from sorted reachable set), QuorumResolver wit…
@suaveplan/network-plugin-protocol	Network protocol plugin for the mesh system.
@suaveplan/network-plugin-qos	Bandwidth management and quality-of-service for the mesh: bandwidth-quota enforcer, message-priority classifier, QoS router (bypass / drop / queue / defer), co…
@suaveplan/network-plugin-registry	Fixed-capacity peer registry with bitpacker-based binary encoding.
@suaveplan/network-plugin-relay	Cross-mesh relay — the federation layer that lets Tier 0 hosts of different meshes route messages to each other. Composes RelayRouter, `HostBackboneTransport…
@suaveplan/network-plugin-server-bridge	Tier-0 host ↔ central-server bridge for the Suaveplan mesh.
@suaveplan/network-plugin-session	Hierarchical session management for the Suaveplan mesh. SessionTree maintains a parent-child session graph rooted at a single auto-created root; `SessionMana…
@suaveplan/network-plugin-simulation	Deterministic virtual-network simulation framework for the Suaveplan mesh. NetworkSimulator runs scenarios against a seeded RNG with simulated time (accelera…
@suaveplan/network-plugin-state	Mesh-wide synchronized state for the Suaveplan network. Path-based StateManager (versioned history with sequence numbers + per-path subscriptions); `DeltaCom…
@suaveplan/network-plugin-topology	Tiered mesh topology plugin: 3-tier HierarchicalTopology (Host / SubHost / Leaf) with promote/demote, latency-bucket-based LatencyAssigner, GroupManager,…
@suaveplan/network-plugin-transport-manager	Multi-transport orchestration for the Suaveplan mesh. Maintains a pool of registered transports per peer, negotiates capability bitmaps during handshake, route…
@suaveplan/network-testing
@suaveplan/network-transport-hyperswarm	Server-tier Hyperswarm DHT transport for @suaveplan/network. Provides hole-punched peer-to-peer streams discovered via Kademlia DHT topics.
@suaveplan/network-transport-libp2p	Universal libp2p Transport for @suaveplan/network. Composes WebSockets or WebRTC sub-transports with Noise + Yamux, identify + ping + bootstrap + circuit-r…
@suaveplan/network-transport-standby	Pre-emptive WebRTC standby transport for @suaveplan/network. Maintains a pool of warm RTCPeerConnection-like slots so peer attach completes in ~10 ms inste…
@suaveplan/network-transport-webrtc	WebRTC transport plugin for mesh networking.
@suaveplan/network-transport-websockets	WebSocket client utilities with typed message framing, connection lifecycle management, heartbeat, backpressure queue, and injectable transport adapters.
@suaveplan/network-trystero-server	Server-tier Trystero signaling daemon. Hosts an MQTT-style or Nostr-style WebSocket broker shim plus standard /health / /ready / /live probes on a single…
@suaveplan/react-network-libp2p-demo	React-tier demo UI for @suaveplan/network-transport-libp2p. Splits the upstream 749-LOC monolithic demo into per-concern subcomponents (<NodeStatusPanel>,…
@suaveplan/service-discovery	Universal service-registry primitives. Provides the shared ServiceDescriptor, ServiceQuery, RegistryEvent, and ServiceRegistry contract consumed by eve…
@suaveplan/websocket-gateway	Server-tier WebSocket gateway daemon with rooms, presence tracking, and channel-multiplexed pub/sub. Pairs with @suaveplan/network-transport-websockets on th…

observability

Monitoring, logging, health checks, audit trails, and analytics.

monitor

Logging, health checks, audit logging, and analytics instrumentation.

Package	Description
@suaveplan/analytics-browser	Browser-tier client-side product analytics — AnalyticsTracker, BatchTransport, BeaconTransport, and SessionManager with consent gate, PII scrubber, hea…
@suaveplan/audit-logging	Tamper-proof, GDPR-compliant audit logging for Suaveplan. Provides a cryptographic chain-integrity engine, pluggable storage adapters, GDPR data export, config…
@suaveplan/health-check	Server-tier health-check core for /health, /ready, /live endpoints with dependency checks (HTTP, TCP, custom), aggregated status, caching, and typed life…
@suaveplan/logger	Enterprise-grade structured logger for Suaveplan. Provides a full pipeline: level filtering → OTel trace enrichment → sampling → redaction → sinks. Supports mu…
@suaveplan/opentelemetry	OpenTelemetry SDK setup and configuration helpers for Suaveplan. Provides batteries-included OTel initialization helpers, resource detection, ergonomic span/me…

persistence

Caching, database adapters, search engines, and storage abstractions.

cache

Caching abstractions, memory caches, and Redis backends.

Package	Description
@suaveplan/cache	Type-safe caching abstraction for Suaveplan. Provides MemoryCache with LRU/LFU/FIFO/TTL eviction, NamespacedCache for shared-storage isolation, a `CacheFac…
@suaveplan/cache-redis	AbstractCache<T> backend over a minimal RedisLike interface — native SET ... EX, GET, DEL, EXISTS, TTL, SCAN. Reuses @suaveplan/cache-storage…
@suaveplan/cache-storage	AbstractCache<T> backend that bridges any @suaveplan/storage AbstractStorage into a typed cache via a 32-byte fixed-width TTL header and pluggable `Codec…

database

Database adapters, migrations, seeding, and SQLite support.

Package	Description
@suaveplan/db	Universal relational database adapter interface for Suaveplan. Provides the DatabaseAdapter contract (extending DatabaseLike from @suaveplan/types), inje…
@suaveplan/db-sqlite	Universal SQLite adapter for Suaveplan. Runs on bun:sqlite on the Bun server and @sqlite.org/sqlite-wasm (Web Worker) in the browser, unified behind a sing…
@suaveplan/migration	Database-agnostic schema migration runner with ledger tracking, checksum validation, dry-run reporting, distributed locking, event bus integration, and OTel in…
@suaveplan/seed	Universal declarative database seeding and fixture framework. Define seed data once, let the runner handle dependency ordering, environment filtering, idempote…
@suaveplan/surrealdb	Universal SurrealDB client wrapper for Suaveplan. Implements @suaveplan/db's DatabaseAdapter interface with connection lifecycle management, typed CRUD, sc…

search

Full-text search, BM25, fuzzy matching, and faceted search.

Package	Description
@suaveplan/search	Full-text and fuzzy search primitives with in-memory BM25 engine, trigram fuzzy matching, faceted search, and pagination support.

storage

Storage abstractions, browser backends, S3, CDN, and URI routing.

Package	Description
@suaveplan/storage	Enterprise key-value storage abstractions for Suaveplan. Provides AbstractStorage (implementing StorageLike), MemoryStorage with TTL and zero-copy stream…
@suaveplan/storage-browser-indexeddb	Browser-tier AbstractStorage adapter backed by the W3C IndexedDB API (globalThis.indexedDB). Provides persistent, origin-scoped key-value storage for brows…
@suaveplan/storage-browser-localstorage	Browser-tier AbstractStorage adapter backed by the synchronous Storage API (globalThis.localStorage). Provides namespaced, origin-scoped key-value storag…
@suaveplan/storage-browser-opfs	Browser-tier AbstractStorage adapter backed by the Origin Private File System (OPFS). Provides persistent, origin-scoped key-value storage for browser consum…
@suaveplan/storage-cdn	Types-only foundation for CDN-flavoured @suaveplan/storage adapters. Declares CdnAdapter (an abstract base class extending AbstractStorage with purge,…
@suaveplan/storage-cdn-bunnycdn	BunnyCDN Storage Zone + Pull Zone provider for @suaveplan/storage-cdn. Full AbstractStorage and CdnAdapter surface — get/set/delete/exists/`getMe…
@suaveplan/storage-cdn-rackspace	Rackspace Cloud Files (OpenStack Swift) origin + Rackspace CDN provider for @suaveplan/storage-cdn. Full AbstractStorage and CdnAdapter surface — get/`…
@suaveplan/storage-file	Node.js filesystem AbstractStorage adapter for @suaveplan/storage. Implements atomic writes via temp-file-then-rename, AbortSignal threaded through every a…
@suaveplan/storage-http	Universal HTTP/CDN-backed AbstractStorage adapter for @suaveplan/storage. Reads via GET/HEAD/Range against any <baseUrl><key> origin, with optional…
@suaveplan/storage-plugin-cache	Read-through cache decorator for AbstractStorage. Wraps any @suaveplan/storage instance with an injectable AbstractCache<Uint8Array>; hit/miss/populate o…
@suaveplan/storage-s3	S3-compatible object storage adapter for @suaveplan/storage. Extends AbstractStorage backed by @aws-sdk/client-s3 with presigned URL generation, multipar…
@suaveplan/storage-uri	Universal URI-routed dispatch over @suaveplan StorageLike adapters.
@suaveplan/storage-uri-plugin-bundle	Per-package bundle:// URI scheme for @suaveplan/storage-uri.
@suaveplan/storage-uri-plugin-fallback	Universal fallback:// URI plugin for @suaveplan/storage-uri. Ships ordered multi-source resolution with cycle detection, depth cap, mirror writes, list uni…

security-stack

Cryptography, vaults, security utilities, and threat-detection primitives.

crypto

Cryptographic primitives, ciphers, hashes, curves, and key management.

Package	Description
@suaveplan/crypto	Universal cryptographic primitives — engine-pluggable AEAD, Ed25519/ECDSA-P256 signing, X25519 key agreement, sealed-box, and auth-box. Built on audited @noble…
@suaveplan/crypto-bin	Suaveplan password-hashing CLI. Ships the suaveplan-hash-password binary — Argon2id (default) and BLAKE2b password hashing + verification with PHC/MCF-format…
@suaveplan/crypto-browser	WebCrypto-backed engine implementations for @suaveplan/crypto — AES-256-GCM, Ed25519, ECDSA-P256/P384, X25519, ECDH-P256/P384, RSA, AES-KW, and non-extractab…
@suaveplan/crypto-cipher	Low-level AEAD (Authenticated Encryption with Associated Data) cipher primitives for the @suaveplan/crypto stack. Provides three algorithms — AES-256-GCM, Ch…
@suaveplan/crypto-cli	Suaveplan keychain CLI — root + server identity lifecycle (init, roll, revoke, inspect, verify, export-public, restore)
@suaveplan/crypto-core	Universal cryptographic primitives — engine-pluggable AEAD, Ed25519/ECDSA-P256 signing, X25519 key agreement, sealed-box, and auth-box. Built on audited @noble…
@suaveplan/crypto-curve	Low-level elliptic-curve building blocks for the @suaveplan/crypto stack. Exposes four curves — secp256k1, Ed25519, X25519, and NIST P-256 — each as a standa…
@suaveplan/crypto-hash	Pure-TypeScript hashing substrate. SHA-2 digests, HMAC, HKDF, PBKDF2, Argon2id, and hex/Base64 encoding — no WASM, no browser globals, fully tree-shakeable.
@suaveplan/crypto-keys	Hierarchical keychain chain-signing for the crypto ecosystem. Store-agnostic, free of node: / bun: imports.
@suaveplan/crypto-rsa	RSA primitives for Suaveplan — RFC 8017 PKCS #1 v2.2, RFC 5208 / RFC 5958 PKCS #8, RFC 5280 SPKI, RFC 7517 / RFC 7518 JWK, RFC 7468 PEM. Universal package (zer…
@suaveplan/crypto-sodium	libsodium-backed engine implementations for @suaveplan/crypto. Provides AEAD encryption, Ed25519 signing, X25519 key agreement, sealed-box, auth-box, determi…
@suaveplan/crypto-utils	Shared cryptographic utilities consumed internally by all other @suaveplan/crypto-* packages. Provides the low-level primitives that every crypto implementat…
@suaveplan/crypto-vault	Cryptographic foundation for the Vaulted password-manager ecosystem. Provides BIP39 mnemonic generation, OWASP-grade Argon2id derivation, two-secret key deriva…

security

Have-I-Been-Pwned checks, JWS, licensing, and OTP utilities.

Package	Description
@suaveplan/hibp	Privacy-preserving Have I Been Pwned v3 client. Universal — works in Node, Bun, Deno, browsers, edge workers. The only required runtime primitive is fetch.
@suaveplan/jws	RFC 7515 JSON Web Signature (verify + sign). Pure TypeScript over Uint8Array + DataView plus the workspace crypto primitives (@suaveplan/crypto-rsa,…
@suaveplan/license	Compact, offline-verifiable, secp256k1-signed software-license-key format. Bit-for-bit wire-format compatible with upstream @suaveplan/license. runs unchange…
@suaveplan/otp	RFC 4226 (HOTP) + RFC 6238 (TOTP) + RFC 6287 (OCRA) + Google Authenticator Key URI Format + Base32 (RFC 4648 §6) + recovery codes + clock-drift detector — zero browser/Node deps
@suaveplan/password-formats	Universal import/export layer for common password-manager export formats. Parses Apple Passwords CSV, Bitwarden JSON, Chrome CSV, and KeePass XML into a normal…
@suaveplan/password-generator	Cryptographically-strong password and passphrase generator — char-class, pronounceable, EFF Diceware, and PIN modes with bias-free RNG, real entropy estimates,…
@suaveplan/password-strength	zxcvbn-style password strength estimator — pattern-matching + dictionary cracker model per Wheeler 2016. Universal; zero browser/Node/React deps. Re-implementa…
@suaveplan/security-codes	Detect and sanitise sensitive security-code leakage in strings. Handles API keys, JWTs, credit cards, GitHub tokens, Stripe keys, SSH keys, PEM blocks, AWS acc…
@suaveplan/server-keys	Operator-facing CLI bundle for the Suaveplan server-key lifecycle: 18 bins covering root + server keychain generation (including hierarchical `ChainedKeySigner…
@suaveplan/slsa	SLSA L1-L2 supply-chain security for Suaveplan. Generates and verifies in-toto / SLSA v1.0 provenance, CycloneDX 1.5 SBOMs, DSSE attestation envelopes, and RFC…
@suaveplan/srp	SRP-6a zero-knowledge password proof per RFC 5054 / RFC 2945. Universal — client and server roles in one package, bundled 2048-bit safe-prime group, optional 1…
@suaveplan/tpm-struct	Zero-runtime-dep TPM 2.0 attestation-structure parser and serialiser. Decodes TPMS_ATTEST (TCG TPM 2.0 Library Part 2 §10.12), decodes TPMT_PUBLIC (§12.2),…
@suaveplan/vault	Vault orchestration layer for the Vaulted password-manager ecosystem. Provides a drive-backed encrypted SQLite-style container, a strict locked ↔ unlocked…
@suaveplan/vault-sync	Domain-specific sync and conflict-resolution engine for the Vaulted password-manager ecosystem. Builds on @suaveplan/crdt and @suaveplan/diff (RFC 6902 JSO…
@suaveplan/x509	RFC 5280 X.509 v3 certificate parser and certification-path validator. Universal (zero browser, Node, or React deps). Pure TypeScript over Uint8Array / `Data…

testkit

Testing frameworks, A/B testing, and quality-assurance utilities.

testing

Testing runners, DOM helpers, E2E harnesses, and A/B testing.

Package	Description
@suaveplan/ab-testing	Enterprise A/B testing and experimentation engine with deterministic FNV-1a bucketing, targeting rules, variant assignment, conversion tracking, result aggrega…
@suaveplan/testing	Shared test infrastructure for Suaveplan. Provides runner primitives (Vitest or bun-test via conditional exports), structured builders, a deterministic FakeClo…
@suaveplan/testing-dom	DOM and React component testing utilities for Suaveplan. Provides a single install that covers vitest config generation with WSL2-safe defaults, `@testing-libr…
@suaveplan/testing-e2e	Playwright E2E testing utilities for Suaveplan, with the default browser worker fixture launching cloakbrowser — a real Chromium binary with 49 source-leve…
@suaveplan/testing-integration	Core integration test infrastructure for Vitest: fixture lifecycle management, health polling, and the global-setup bridge.
@suaveplan/testing-integration-garage-s3	Garage S3 v2.0.0 testcontainers fixture for @suaveplan/testing-integration.
@suaveplan/testing-integration-mailpit	Mailpit testcontainers fixture + assertMail() helper for @suaveplan/testing-integration.
@suaveplan/testing-integration-oauth-mock	Real-HTTP mock OAuth 2.0 Identity Provider for integration tests.
@suaveplan/testing-integration-postgres	PostgreSQL 16 testcontainers fixture for @suaveplan/testing-integration.
@suaveplan/testing-integration-redis	Redis 7 testcontainers fixture for @suaveplan/testing-integration.
@suaveplan/testing-integration-step-ca	A ServiceFixture for smallstep/step-ca that gives any integration test suite a real, ephemeral certificate authority — root cert, JWK provisioner, and an `…
@suaveplan/testing-integration-surrealdb	SurrealDB v3 testcontainers fixture for @suaveplan/testing-integration.
@suaveplan/testing-integration-typesense	Typesense 27 testcontainers fixture for @suaveplan/testing-integration.

threejs

Three.js and React Three Fiber integrations.

r3f

React Three Fiber networking and scene components.

Package	Description
@suaveplan/r3f-networking	R3F-tier multiplayer state-synchronisation for React-Three-Fiber scenes. Composes any @suaveplan/network Transport (canonical: `@suaveplan/network-transpor…

ui

React components, forms, and user-interface primitives.

forms

Form builders, validation, and React form components.

Package	Description
@suaveplan/form-builder	Universal dynamic form schema engine. Renderer-agnostic — no DOM, no React, no Node-specific globals. Drives every dynamic form surface in the Suaveplan.
@suaveplan/react-forms	React forms library for the Suaveplan ecosystem. Wraps react-hook-form + Zod with a primitives + factory + recipes architecture: every user-facing string is ty…

react

React hooks and components for audio, auth, and UI surfaces.

Package	Description
@suaveplan/react-audio	React surface for the Suaveplan audio family. Phase 1 of 3 — foundation (provider + hooks + stores + error codes + a11y helpers). Components ship in Phase…
@suaveplan/react-audio-fingerprint	React 19 surface for client-side audio fingerprinting and identity matching. The package implements the classic Shazam-style constellation algorithm (2D-peak d…
@suaveplan/react-audio-player	Track-style media-player surface for the Suaveplan audio family. The package ships two kinds of exports:
@suaveplan/react-audio-stream	React 19 surface for live audio streaming sessions: a Provider, six hooks, and four accessible components. Chunk C of the four-chunk `enterprise-react-audio-st…
@suaveplan/react-auth	React authentication core for Suaveplan apps — a typed wrapper around better-auth/client, an AuthProvider React context, an AuthGuard route component, `u…
@suaveplan/react-auth-whitelabel	White-label authentication React components with tenant branding wired through the @suaveplan/react-ui runtime theme-token mutator.
@suaveplan/react-control-surface	React 19 atomic-control surface renderer for @suaveplan/control-surface-schema.
@suaveplan/react-midi	React 19 adapter for the Web MIDI API. Provides a strict-mode-safe <MidiProvider> that requests MIDIAccess exactly once, seven typed hooks for common consu…
@suaveplan/react-ui	React UI component library — opinionated providers, theme/pack plugin contracts, bundled translations, telemetry, shadcn-compatible registry generator.