Topogram Generator: Hono API

Package-backed Topogram generator for Hono API services.

Status: current Audience: generator package authors and maintainers Use when: you need to change generator realization, manifests, package metadata, or release proof.

Package-backed Topogram generator for stateless Hono API services.

This package proves the API generator-pack boundary: Topogram core resolves the API topology widget and normalized contracts, then this package turns the API projection into a Hono service.

Manifest

• Generator id: @topogram/generator-hono-api
• Surface: api
• Surface type: api
• Stack: Hono + TypeScript
• Package manifest: topogram-generator.json
• Adapter export: index.cjs

Topology binding:

{
  "id": "app_api",
  "type": "api",
  "projection": "proj_api",
  "generator": {
    "id": "@topogram/generator-hono-api",
    "version": "1",
    "package": "@topogram/generator-hono-api"
  },
  "port": 3000
}

Verify Locally

From this repo:

npm run check

See CONSUMER_PROOF.md for the verification standard this repo must keep before publishing.

The smoke test packs this generator, installs it beside @topogram/cli in a temporary consumer project, runs topogram check, runs topogram generate, compiles the generated app bundle, and verifies the generated Hono API service files.

Use a different Topogram CLI package with:

TOPOGRAM_CLI_PACKAGE_SPEC=@topogram/cli@latest npm run check

Release Preflight

npm run release:preflight

The preflight runs package checks, docs/RAG verification, npm pack --dry-run, and Gitleaks secret scanning before publish or broad sharing.