@thebookingkit/server 0.1.2 → 0.1.3

package/README.md

@@ -6,7 +6,7 @@ Auth, webhooks, API keys, workflows, and adapter interfaces for booking system b
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue)](https://www.typescriptlang.org/)
 
-Part of [The Booking Kit](https://thebookingkit.dev) — The Headless Booking Primitive.
+Part of [The Booking Kit](https://docs.thebookingkit.dev) — The Headless Booking Primitive.
 
 ## Install
 
@@ -43,7 +43,7 @@ const signature = signWebhookPayload(payload, secret);
 
 ## Documentation
 
-[**Full Documentation**](https://thebookingkit.dev/features/webhooks/)
+[**Full Documentation**](https://docs.thebookingkit.dev/features/webhooks/)
 
 ## License
 

package/dist/adapters/calendar-adapter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Calendar sync adapter interface.
+ * Default implementation uses Google Calendar OAuth.
+ * Swap to Outlook Calendar or CalDAV by implementing this interface.
+ */
+export interface CalendarAdapter {
+    /** Create a calendar event for a booking */
+    createEvent(options: CalendarEventOptions): Promise<CalendarEventResult>;
+    /** Update an existing calendar event */
+    updateEvent(eventId: string, options: Partial<CalendarEventOptions>): Promise<CalendarEventResult>;
+    /** Delete a calendar event */
+    deleteEvent(eventId: string): Promise<void>;
+    /** Get conflicts (busy times) from external calendar */
+    getConflicts(timeMin: Date, timeMax: Date): Promise<CalendarConflict[]>;
+}
+/** Options for creating/updating a calendar event */
+export interface CalendarEventOptions {
+    /** Event title */
+    title: string;
+    /** Event description/notes */
+    description?: string;
+    /** Event start time */
+    startsAt: Date;
+    /** Event end time */
+    endsAt: Date;
+    /** Event location */
+    location?: string;
+    /** Attendee email addresses */
+    attendees?: string[];
+    /** Provider's timezone */
+    timezone?: string;
+}
+/** Result of creating/updating a calendar event */
+export interface CalendarEventResult {
+    /** External calendar event ID */
+    eventId: string;
+    /** Link to the calendar event */
+    eventUrl?: string;
+}
+/** A busy time period from an external calendar */
+export interface CalendarConflict {
+    /** Start of busy period */
+    start: Date;
+    /** End of busy period */
+    end: Date;
+}
+//# sourceMappingURL=calendar-adapter.d.ts.map

package/dist/adapters/calendar-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/calendar-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACzE,wCAAwC;IACxC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnG,8BAA8B;IAC9B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,wDAAwD;IACxD,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACzE;AAED,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,EAAE,IAAI,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,IAAI,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,IAAI,CAAC;IACZ,yBAAyB;IACzB,GAAG,EAAE,IAAI,CAAC;CACX"}

package/dist/adapters/calendar-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=calendar-adapter.js.map

package/dist/adapters/calendar-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-adapter.js","sourceRoot":"","sources":["../../src/adapters/calendar-adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/email-adapter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Email sending adapter interface.
+ * Default implementation uses Resend. Swap to SendGrid, AWS SES,
+ * or Postmark by implementing this interface.
+ */
+export interface EmailAdapter {
+    /** Send a single email */
+    send(options: SendEmailOptions): Promise<EmailResult>;
+    /** Send multiple emails in a batch */
+    sendBatch(emails: SendEmailOptions[]): Promise<EmailResult[]>;
+    /** Get delivery status of a previously sent email */
+    getDeliveryStatus?(messageId: string): Promise<EmailDeliveryStatus>;
+}
+/** Options for sending an email */
+export interface SendEmailOptions {
+    /** Recipient email address */
+    to: string;
+    /** Subject line */
+    subject: string;
+    /** HTML body */
+    html: string;
+    /** Plain text body (fallback) */
+    text?: string;
+    /** From address (defaults to configured sender) */
+    from?: string;
+    /** Reply-to address */
+    replyTo?: string;
+    /** Additional headers (List-Unsubscribe, etc.) */
+    headers?: Record<string, string>;
+    /** File attachments */
+    attachments?: EmailAttachment[];
+    /** Tags for categorization */
+    tags?: Record<string, string>;
+}
+/** An email attachment */
+export interface EmailAttachment {
+    filename: string;
+    content: string | Buffer;
+    contentType?: string;
+}
+/** Result of sending an email */
+export interface EmailResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+}
+/** Delivery status of an email */
+export interface EmailDeliveryStatus {
+    status: "sent" | "delivered" | "bounced" | "complained" | "failed";
+    timestamp: Date;
+}
+/**
+ * Generate an ICS calendar attachment for a booking.
+ */
+export declare function generateICSAttachment(booking: {
+    id: string;
+    title: string;
+    startsAt: Date;
+    endsAt: Date;
+    location?: string;
+    description?: string;
+    organizerEmail?: string;
+    attendeeEmail: string;
+}): EmailAttachment;
+//# sourceMappingURL=email-adapter.d.ts.map

package/dist/adapters/email-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/email-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,sCAAsC;IACtC,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9D,qDAAqD;IACrD,iBAAiB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrE;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,uBAAuB;IACvB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IACnE,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,eAAe,CA+BlB"}

package/dist/adapters/email-adapter.js

@@ -0,0 +1,40 @@
+/**
+ * Generate an ICS calendar attachment for a booking.
+ */
+export function generateICSAttachment(booking) {
+    const formatICSDate = (d) => d.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}/, "");
+    const ics = [
+        "BEGIN:VCALENDAR",
+        "VERSION:2.0",
+        "PRODID:-//TheBookingKit//EN",
+        "CALSCALE:GREGORIAN",
+        "METHOD:PUBLISH",
+        "BEGIN:VEVENT",
+        `UID:${booking.id}@thebookingkit`,
+        `DTSTART:${formatICSDate(booking.startsAt)}`,
+        `DTEND:${formatICSDate(booking.endsAt)}`,
+        `SUMMARY:${escapeICS(booking.title)}`,
+        booking.location ? `LOCATION:${escapeICS(booking.location)}` : "",
+        booking.description ? `DESCRIPTION:${escapeICS(booking.description)}` : "",
+        booking.organizerEmail ? `ORGANIZER:mailto:${booking.organizerEmail}` : "",
+        `ATTENDEE:mailto:${booking.attendeeEmail}`,
+        `DTSTAMP:${formatICSDate(new Date())}`,
+        "END:VEVENT",
+        "END:VCALENDAR",
+    ]
+        .filter(Boolean)
+        .join("\r\n");
+    return {
+        filename: "booking.ics",
+        content: ics,
+        contentType: "text/calendar",
+    };
+}
+function escapeICS(text) {
+    return text
+        .replace(/\\/g, "\\\\")
+        .replace(/;/g, "\\;")
+        .replace(/,/g, "\\,")
+        .replace(/\n/g, "\\n");
+}
+//# sourceMappingURL=email-adapter.js.map

package/dist/adapters/email-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-adapter.js","sourceRoot":"","sources":["../../src/adapters/email-adapter.ts"],"names":[],"mappings":"AAwDA;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OASrC;IACC,MAAM,aAAa,GAAG,CAAC,CAAO,EAAE,EAAE,CAChC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE9D,MAAM,GAAG,GAAG;QACV,iBAAiB;QACjB,aAAa;QACb,6BAA6B;QAC7B,oBAAoB;QACpB,gBAAgB;QAChB,cAAc;QACd,OAAO,OAAO,CAAC,EAAE,gBAAgB;QACjC,WAAW,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;QAC5C,SAAS,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;QACxC,WAAW,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;QACrC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QACjE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1E,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,oBAAoB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1E,mBAAmB,OAAO,CAAC,aAAa,EAAE;QAC1C,WAAW,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE;QACtC,YAAY;QACZ,eAAe;KAChB;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;QACL,QAAQ,EAAE,aAAa;QACvB,OAAO,EAAE,GAAG;QACZ,WAAW,EAAE,eAAe;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI;SACR,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,9 @@
+export type { EmailAdapter, SendEmailOptions, EmailResult, EmailDeliveryStatus, EmailAttachment, } from "./email-adapter.js";
+export { generateICSAttachment } from "./email-adapter.js";
+export type { CalendarAdapter, CalendarEventOptions, CalendarEventResult, CalendarConflict, } from "./calendar-adapter.js";
+export type { JobAdapter } from "./job-adapter.js";
+export { JOB_NAMES } from "./job-adapter.js";
+export type { StorageAdapter } from "./storage-adapter.js";
+export type { SmsAdapter, SendSmsOptions, SmsResult, } from "./sms-adapter.js";
+export type { PaymentAdapter, CreatePaymentIntentOptions, CreatePaymentIntentResult, CreateSetupIntentOptions, CreateSetupIntentResult, CaptureResult, RefundResult, } from "./payment-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,YAAY,EACV,UAAU,EACV,cAAc,EACd,SAAS,GACV,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,YAAY,GACb,MAAM,sBAAsB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,3 @@
+export { generateICSAttachment } from "./email-adapter.js";
+export { JOB_NAMES } from "./job-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAU3D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/adapters/job-adapter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Background job adapter interface.
+ * Default implementation uses Inngest. Swap to Trigger.dev,
+ * BullMQ, or Vercel Cron by implementing this interface.
+ */
+export interface JobAdapter {
+    /** Enqueue a job for immediate execution */
+    enqueue<T>(jobName: string, payload: T): Promise<void>;
+    /** Schedule a job for future execution */
+    schedule<T>(jobName: string, payload: T, runAt: Date): Promise<string>;
+    /** Cancel a previously scheduled job */
+    cancel(jobId: string): Promise<void>;
+}
+/** Common job names used by The Booking Kit */
+export declare const JOB_NAMES: {
+    readonly SEND_CONFIRMATION_EMAIL: "thebookingkit/send-confirmation-email";
+    readonly SEND_REMINDER_EMAIL: "thebookingkit/send-reminder-email";
+    readonly SEND_CANCELLATION_EMAIL: "thebookingkit/send-cancellation-email";
+    readonly SEND_RESCHEDULE_EMAIL: "thebookingkit/send-reschedule-email";
+    readonly SYNC_CALENDAR_EVENT: "thebookingkit/sync-calendar-event";
+    readonly DELETE_CALENDAR_EVENT: "thebookingkit/delete-calendar-event";
+    readonly CHECK_CALENDAR_CONFLICTS: "thebookingkit/check-calendar-conflicts";
+    readonly AUTO_REJECT_PENDING: "thebookingkit/auto-reject-pending-booking";
+    readonly PROCESS_WEBHOOK: "thebookingkit/process-webhook";
+};
+//# sourceMappingURL=job-adapter.d.ts.map

package/dist/adapters/job-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/job-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,0CAA0C;IAC1C,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvE,wCAAwC;IACxC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,+CAA+C;AAC/C,eAAO,MAAM,SAAS;;;;;;;;;;CAUZ,CAAC"}

package/dist/adapters/job-adapter.js

@@ -0,0 +1,13 @@
+/** Common job names used by The Booking Kit */
+export const JOB_NAMES = {
+    SEND_CONFIRMATION_EMAIL: "thebookingkit/send-confirmation-email",
+    SEND_REMINDER_EMAIL: "thebookingkit/send-reminder-email",
+    SEND_CANCELLATION_EMAIL: "thebookingkit/send-cancellation-email",
+    SEND_RESCHEDULE_EMAIL: "thebookingkit/send-reschedule-email",
+    SYNC_CALENDAR_EVENT: "thebookingkit/sync-calendar-event",
+    DELETE_CALENDAR_EVENT: "thebookingkit/delete-calendar-event",
+    CHECK_CALENDAR_CONFLICTS: "thebookingkit/check-calendar-conflicts",
+    AUTO_REJECT_PENDING: "thebookingkit/auto-reject-pending-booking",
+    PROCESS_WEBHOOK: "thebookingkit/process-webhook",
+};
+//# sourceMappingURL=job-adapter.js.map

package/dist/adapters/job-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-adapter.js","sourceRoot":"","sources":["../../src/adapters/job-adapter.ts"],"names":[],"mappings":"AAcA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,uBAAuB,EAAE,uCAAuC;IAChE,mBAAmB,EAAE,mCAAmC;IACxD,uBAAuB,EAAE,uCAAuC;IAChE,qBAAqB,EAAE,qCAAqC;IAC5D,mBAAmB,EAAE,mCAAmC;IACxD,qBAAqB,EAAE,qCAAqC;IAC5D,wBAAwB,EAAE,wCAAwC;IAClE,mBAAmB,EAAE,2CAA2C;IAChE,eAAe,EAAE,+BAA+B;CACxC,CAAC"}

package/dist/adapters/payment-adapter.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Abstract interface for payment processing.
+ *
+ * Default implementation: Stripe via `stripe` npm package.
+ * Alternatives: Square, PayPal, or mock for testing.
+ */
+/** Result of creating a payment intent */
+export interface CreatePaymentIntentResult {
+    /** Stripe PaymentIntent ID (or equivalent) */
+    paymentIntentId: string;
+    /** Client secret for confirming payment on the frontend */
+    clientSecret: string;
+    /** Current status of the payment intent */
+    status: "requires_payment_method" | "requires_confirmation" | "requires_action" | "processing" | "succeeded" | "canceled";
+}
+/** Result of creating a setup intent for card authorization */
+export interface CreateSetupIntentResult {
+    /** Stripe SetupIntent ID (or equivalent) */
+    setupIntentId: string;
+    /** Client secret for confirming setup on the frontend */
+    clientSecret: string;
+}
+/** Result of capturing a held payment */
+export interface CaptureResult {
+    /** Whether the capture was successful */
+    captured: boolean;
+    /** The payment intent ID that was captured */
+    paymentIntentId: string;
+}
+/** Result of a refund operation */
+export interface RefundResult {
+    /** Refund ID from the payment provider */
+    refundId: string;
+    /** Amount refunded in cents */
+    amountCents: number;
+    /** Status of the refund */
+    status: "succeeded" | "pending" | "failed";
+}
+/** Options for creating a payment intent */
+export interface CreatePaymentIntentOptions {
+    /** Amount in smallest currency unit (e.g., cents for USD) */
+    amountCents: number;
+    /** ISO 4217 currency code */
+    currency: string;
+    /** Connected account ID (for Stripe Connect) */
+    connectedAccountId?: string;
+    /** Whether to use manual capture (for holds) */
+    captureMethod?: "automatic" | "manual";
+    /** Metadata to attach to the payment */
+    metadata?: Record<string, string>;
+    /** Customer email for receipt */
+    customerEmail?: string;
+}
+/** Options for creating a setup intent */
+export interface CreateSetupIntentOptions {
+    /** Connected account ID (for Stripe Connect) */
+    connectedAccountId?: string;
+    /** Customer email */
+    customerEmail?: string;
+    /** Metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Payment processing adapter interface.
+ *
+ * Implementations handle creating payment intents, capturing holds,
+ * processing refunds, and managing Stripe Connect onboarding.
+ */
+export interface PaymentAdapter {
+    /**
+     * Create a payment intent for collecting payment.
+     * Use `captureMethod: 'manual'` for no-show fee holds.
+     */
+    createPaymentIntent(options: CreatePaymentIntentOptions): Promise<CreatePaymentIntentResult>;
+    /**
+     * Create a setup intent for authorizing a card without charging.
+     */
+    createSetupIntent(options: CreateSetupIntentOptions): Promise<CreateSetupIntentResult>;
+    /**
+     * Capture a previously authorized (manual capture) payment intent.
+     * Used when marking a booking as no-show.
+     */
+    capturePaymentIntent(paymentIntentId: string, amountCents?: number): Promise<CaptureResult>;
+    /**
+     * Cancel a payment intent (release a hold).
+     * Used when a booking completes normally and the no-show hold should be released.
+     */
+    cancelPaymentIntent(paymentIntentId: string): Promise<void>;
+    /**
+     * Refund a payment intent (full or partial).
+     */
+    refund(paymentIntentId: string, amountCents?: number): Promise<RefundResult>;
+    /**
+     * Generate a Stripe Connect onboarding URL for a provider.
+     * Returns the URL the provider should be redirected to.
+     */
+    createConnectOnboardingUrl(options: {
+        returnUrl: string;
+        refreshUrl: string;
+    }): Promise<string>;
+    /**
+     * Disconnect a Stripe Connect account.
+     */
+    disconnectAccount(connectedAccountId: string): Promise<void>;
+}
+//# sourceMappingURL=payment-adapter.d.ts.map

package/dist/adapters/payment-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/payment-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,MAAM,EAAE,yBAAyB,GAAG,uBAAuB,GAAG,iBAAiB,GAAG,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC;CAC3H;AAED,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C;AAED,4CAA4C;AAC5C,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gDAAgD;IAChD,aAAa,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACvC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iCAAiC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAE7F;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAEvF;;;OAGG;IACH,oBAAoB,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE5F;;;OAGG;IACH,mBAAmB,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;OAEG;IACH,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE7E;;;OAGG;IACH,0BAA0B,CAAC,OAAO,EAAE;QAClC,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpB;;OAEG;IACH,iBAAiB,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D"}

package/dist/adapters/payment-adapter.js

@@ -0,0 +1,8 @@
+/**
+ * Abstract interface for payment processing.
+ *
+ * Default implementation: Stripe via `stripe` npm package.
+ * Alternatives: Square, PayPal, or mock for testing.
+ */
+export {};
+//# sourceMappingURL=payment-adapter.js.map

package/dist/adapters/payment-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-adapter.js","sourceRoot":"","sources":["../../src/adapters/payment-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adapters/sms-adapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Abstract interface for SMS delivery.
+ *
+ * Default implementation: Twilio.
+ * Alternatives: AWS SNS, Vonage, or mock for testing.
+ */
+/** Options for sending an SMS */
+export interface SendSmsOptions {
+    /** Recipient phone number (E.164 format) */
+    to: string;
+    /** SMS body text */
+    body: string;
+    /** Sender phone number or alphanumeric sender ID */
+    from?: string;
+}
+/** Result of an SMS send operation */
+export interface SmsResult {
+    /** Message ID from the SMS provider */
+    messageId: string;
+    /** Delivery status */
+    status: "queued" | "sent" | "delivered" | "failed";
+}
+/**
+ * SMS delivery adapter interface.
+ *
+ * Implementations handle sending SMS messages via a provider
+ * (e.g., Twilio, AWS SNS).
+ */
+export interface SmsAdapter {
+    /** Send an SMS message */
+    send(options: SendSmsOptions): Promise<SmsResult>;
+}
+//# sourceMappingURL=sms-adapter.d.ts.map

package/dist/adapters/sms-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/sms-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;CACpD;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACnD"}

package/dist/adapters/sms-adapter.js

@@ -0,0 +1,8 @@
+/**
+ * Abstract interface for SMS delivery.
+ *
+ * Default implementation: Twilio.
+ * Alternatives: AWS SNS, Vonage, or mock for testing.
+ */
+export {};
+//# sourceMappingURL=sms-adapter.js.map

package/dist/adapters/sms-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sms-adapter.js","sourceRoot":"","sources":["../../src/adapters/sms-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/{src/adapters/storage-adapter.ts → dist/adapters/storage-adapter.d.ts}

@@ -4,8 +4,9 @@
  * Swap to AWS KMS, GCP KMS, or HashiCorp Vault by implementing this interface.
  */
 export interface StorageAdapter {
-  /** Encrypt a plaintext value */
-  encrypt(plaintext: string): Promise<string>;
-  /** Decrypt an encrypted value */
-  decrypt(ciphertext: string): Promise<string>;
+    /** Encrypt a plaintext value */
+    encrypt(plaintext: string): Promise<string>;
+    /** Decrypt an encrypted value */
+    decrypt(ciphertext: string): Promise<string>;
 }
+//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/adapters/storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/storage-adapter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iCAAiC;IACjC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9C"}

package/dist/adapters/storage-adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage-adapter.js.map

package/dist/adapters/storage-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../../src/adapters/storage-adapter.ts"],"names":[],"mappings":""}