The Headless Booking Primitive

The scheduling math engine. Framework-agnostic pure functions for slot computation, team scheduling, recurring bookings, routing forms, payments, kiosk, and walk-in.

import { getAvailableSlots } from "@thebookingkit/core";

const slots = getAvailableSlots(
  rules, overrides, bookings,
  { start, end }, timezone,
  { duration: 30, bufferBefore: 5 }
);

Backend infrastructure: auth adapters, webhook signing, API key management, email templates, background job adapters, booking tokens, and multi-tenancy utilities.

import { withSerializableRetry } from "@thebookingkit/server";

// Automatically retries on SQLSTATE 40001
const booking = await withSerializableRetry(
  () => db.transaction(createBooking)
);

Drizzle ORM schema and migrations for PostgreSQL 15+. Includes btree_gist extension for EXCLUDE constraints, audit triggers, and GDPR helpers.

import { db } from "@thebookingkit/db";
import { bookings } from "@thebookingkit/db/schema";

// Drizzle ORM — type-safe queries
const upcoming = await db
  .select()
  .from(bookings)
  .where(eq(bookings.status, "confirmed"));

Cloudflare D1 (SQLite) adapter with UTC date codec, advisory locking for double-booking prevention, and weekly schedule conversion utilities.

import { D1BookingLock } from "@thebookingkit/d1";

// Advisory lock prevents double-bookings
// on Cloudflare D1 (no SKIP LOCKED)
const lock = new D1BookingLock(db);
await lock.withLock(slotKey, createBooking);

Scaffolding CLI for adding components, running database migrations, and initializing new projects. Uses the registry.json component manifest.

# Scaffold a new project
npx thebookingkit init my-booking-app

# Add a UI component from the registry
npx thebookingkit add booking-calendar

# Run database migrations
npx thebookingkit migrate