Skip to main content

Introduction

Honocube is a lightweight, type-safe resource framework built on top of Hono and Drizzle ORM. It allows you to rapidly build robust RESTful APIs with minimal boilerplate while maintaining full control over your business logic.

Motivation​

Building APIs often involves repetitive tasks: setting up CRUD endpoints, handling pagination, filtering, searching, file uploads, and permissions. Honocube abstracts these patterns into a declarative "Resource" model, allowing you to focus on what makes your application unique.

Key Features​

  • 🔋 Battery-included CRUD: Automatic list, detail, create, update, and delete endpoints.
  • 🛡️ Type Safety: End-to-end TypeScript support with Standard Schema (Zod, Valibot, ArkType) validation.
  • 📖 Built-in OpenAPI & Scalar Docs: Zero-dependency OpenAPI 3.1.0 generator and interactive browser documentation dashboard.
  • ⚡ Cursor & Keyset Pagination: O(1) seek performance on large datasets with drift protection.
  • 📊 Analytics & Aggregations: Dynamic metrics (count, sum, avg, min, max), multi-dimensional grouping, and date-histogram bucketing.
  • 🔁 Mutation Idempotency: SHA-256 fingerprinting, atomic lock resolution, and safe retries with Idempotency-Key.
  • 🛡️ Distributed Edge Rate Limiting: Sliding window counters with standard RFC headers (RateLimit-*, Retry-After).
  • 🔀 Workflows & State Machines: Declarative state transitions, role gating, and locked document protection.
  • 📝 Audit Trail & Webhooks: Field-level before/after diff tracking and HMAC-signed transactional outbox webhooks.
  • 🏢 Multi-Tenancy & FLAC/RBAC: Tenant scoping, Field-Level Access Control, and Row-Level Security.
  • 🔌 Adapter Architecture: Currently optimized for Drizzle ORM, with a flexible base for other adapters.
  • 📁 Integrated Uploads: Seamlessly handle file uploads and associate them with your records.
  • 📦 Relations & Pivots: First-class support for one-to-one, one-to-many, and many-to-many (pivot) relationships.

Architecture at a Glance​

Honocube operates on three main levels:

  1. App Config (createApp): Define global behaviors like database adapters, storage providers, authentication logic, and global middleware.
  2. Resources (defineResource): Define a single entity (e.g., "Users", "Posts") with its schema, validators, hooks, and relationships.
  3. API Gateway (defineApi): Group multiple resources into a versioned API with automated documentation.

Ready to jump in? Get started with the installation.