@happyvertical/smrt-bookings
Operator-managed reservations of developer time and supervision windows, with provider availability, exact assent, and transactional capacity checks.
What it gives you
Operator-managed reservations of developer time and supervision windows, with provider availability, exact assent, and transactional capacity checks.
- 01An offering has a kind and a unit of hour, day, week, or month
- 02A proposal freezes the unit price, the quantity, the total, and the agreed wording
- 03Confirmation locks the booking and the provider, then checks every window against declared availability
- 04Canceling a confirmed booking releases its capacity in the same transaction
Request, propose, assent, confirm
A contact or an operator requests an enabled offering. An operator proposes a provider, windows, and terms. The contact assents to that exact proposal. An operator then confirms it. Requests, proposals, and assent reserve no capacity.
Two kinds of capacity
A developer-hour offering is exclusive: it blocks every overlapping reservation. A supervision-day offering draws on supervision windows with a positive whole-number capacity. Each booking consumes one unit, and the offering needs a project and an approved plan. Two active supervision reservations for one project and one interval are refused.
PostgreSQL, applied by the host
The host applies migrateBookingsV1 and then migrateBookingsV2 once each through its deployment migration ledger. BookingService owns its transaction and uses READ COMMITTED. The package creates no schema on demand.
What the package leaves to the host
The package starts no agents, collects no payment, sends no notification, and writes no Commerce record. The host supplies the trusted actor and tenant, and verifies customer, provider, project, and plan relationships.
Package UI
No UI layer to carry
This package stays focused on models, runtime behavior, or tooling. Build its interface with smrt-ui, or use a related domain package that exposes a /svelte entry point.
Intentionally headless
Package previews
No playground module yet
This package does not currently export a ./playground module. Its component names and import path remain available in the Components tab.
Intentionally not registered
Generated interface
REST
The exact route set comes from each model's @smrt({ api }) policy
and the application manifest—not from a second controller definition.
The package registers no ORM collection, CRUD route, or generated CLI or MCP write. Applications call BookingService.
Generated interface
MCP
AI tools are generated from the methods you explicitly include. Their inputs are validated against the same model metadata used by REST and CLI.
The package registers no ORM collection, CRUD route, or generated CLI or MCP write. Applications call BookingService.
Browser-native agent interface
WebMCP
The generated web definitions carry the same tool names, descriptions, and JSON Schema
inputs as MCP. smrt-web registers them with document.modelContext.
The package registers no ORM collection, CRUD route, or generated CLI or MCP write. Applications call BookingService.
Generated interface
CLI
The app CLI turns manifest resources into predictable operator commands while keeping package-specific actions close to their models.
The package registers no ORM collection, CRUD route, or generated CLI or MCP write. Applications call BookingService.