@kehto/mocks

Deterministic, in-memory mock services for every napplet NAP domain — merged and draft alike — so a shell built on @kehto/* has data to work with while implementing a NAP, without a real relay, device, downloader, wallet, or language-model provider.

Alpha status: Kehto is an early runtime toolkit for a draft NIP-5D protocol. Draft NAP contracts change; each mock records the exact napplet/naps ref it was written against and scripts/audit-naps.mjs reports drift.

Install

pnpm add -D @kehto/mocks
Copy

Published Napplet Compatibility

Peers admit @napplet/core >=0.32.0 <0.39.0 and @napplet/nap >=0.32.0 <0.38.0, matching @kehto/runtime. Development, tests, and JSR imports use the host line: core 0.38.0 and nap 0.37.0.

Quick start

import { createShellBridge } from '@kehto/shell';
import { createMockNapEnvironment } from '@kehto/mocks';

const env = createMockNapEnvironment({ seed: 7 });
const bridge = createShellBridge({ ...hooks, services: env.services, statePersistence: env.statePersistence });
// list env.domains in the shell environment's capabilities.domains

const torrent = env.get('torrent');
torrent.mock.state();   // seeded jobs
env.resetAll();         // restore every seed
Copy

Or one domain at a time:

import { createMockLlmService } from '@kehto/mocks';

const llm = createMockLlmService({ latencyMs: 25 });
bridge.runtime.registerService('llm', llm);
Copy

Every mock is a plain ServiceHandler with an extra mock control surface:

Shared options: seed, clock, scheduler, latencyMs. Domain controls (advance(), receive(), press(), respondWith(), approveNext(), …) live on each Mock<Domain>Service.

Domains

Kinds: service — routed by the runtime's built-in dispatcher; extension — routed when the handler declares messageCapabilities and the shell exposes the domain (mockShellEnvironmentDomains() lists them); pushes outside a request are declared as pushCapabilities and pushToWindow returns the runtime's delivery verdict; adapter / runtime-owned / posture — no factory (storage uses createMockStatePersistence()).

Transfer-oriented mocks (torrent, nzb, soulseek, resource, upload, fs, blossom, hashtree, git) model Linux distribution images only.

Keeping up with napplet/naps

pnpm --filter @kehto/mocks audit:naps           # current / stale / retired / missing
pnpm --filter @kehto/mocks audit:naps -- --strict
Copy

See skills/use-nap-mocks/SKILL.md (integrating) and skills/maintain-nap-mocks/SKILL.md (updating) at the repository root.

Docs

• Package page: docs/packages/mocks.md
• Generated API module: docs/api/modules/_kehto_mocks.html (run pnpm docs:api).

License

MIT