@thebookingkit/server 0.1.1

package/dist/email-templates.js

@@ -0,0 +1,112 @@
+/**
+ * Interpolate template variables into a template string.
+ * Variables use the format `{variableName}`.
+ */
+export function interpolateTemplate(template, vars) {
+    return template.replace(/\{(\w+)\}/g, (match, key) => {
+        const value = vars[key];
+        return value ?? match;
+    });
+}
+/** Default booking confirmation email template (HTML) */
+export const CONFIRMATION_EMAIL_HTML = `
+<div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+  <h2>Booking Confirmed</h2>
+  <p>Hi {customerName},</p>
+  <p>Your booking has been confirmed. Here are the details:</p>
+  <table style="width: 100%; border-collapse: collapse;">
+    <tr><td style="padding: 8px; font-weight: bold;">Service</td><td style="padding: 8px;">{eventTitle}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Provider</td><td style="padding: 8px;">{providerName}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Date</td><td style="padding: 8px;">{date}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Time</td><td style="padding: 8px;">{time} ({timezone})</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Duration</td><td style="padding: 8px;">{duration}</td></tr>
+  </table>
+  <p style="margin-top: 20px;">
+    <a href="{managementUrl}" style="display: inline-block; padding: 12px 24px; background: #0070f3; color: white; text-decoration: none; border-radius: 6px;">
+      Manage Booking
+    </a>
+  </p>
+  <p style="margin-top: 30px; font-size: 12px; color: #666;">
+    <a href="{unsubscribeUrl}">Unsubscribe</a> from booking notifications.
+  </p>
+</div>
+`.trim();
+/** Default booking confirmation email (plain text) */
+export const CONFIRMATION_EMAIL_TEXT = `
+Booking Confirmed
+
+Hi {customerName},
+
+Your booking has been confirmed:
+
+Service: {eventTitle}
+Provider: {providerName}
+Date: {date}
+Time: {time} ({timezone})
+Duration: {duration}
+
+Manage your booking: {managementUrl}
+
+To unsubscribe: {unsubscribeUrl}
+`.trim();
+/** Default reminder email template */
+export const REMINDER_EMAIL_HTML = `
+<div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+  <h2>Appointment Reminder</h2>
+  <p>Hi {customerName},</p>
+  <p>This is a reminder about your upcoming appointment:</p>
+  <table style="width: 100%; border-collapse: collapse;">
+    <tr><td style="padding: 8px; font-weight: bold;">Service</td><td style="padding: 8px;">{eventTitle}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Provider</td><td style="padding: 8px;">{providerName}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Date</td><td style="padding: 8px;">{date}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Time</td><td style="padding: 8px;">{time} ({timezone})</td></tr>
+  </table>
+  <p style="margin-top: 20px;">
+    <a href="{managementUrl}" style="display: inline-block; padding: 12px 24px; background: #0070f3; color: white; text-decoration: none; border-radius: 6px;">
+      Manage Booking
+    </a>
+  </p>
+  <p style="margin-top: 30px; font-size: 12px; color: #666;">
+    <a href="{unsubscribeUrl}">Unsubscribe</a>
+  </p>
+</div>
+`.trim();
+/** Default cancellation email template */
+export const CANCELLATION_EMAIL_HTML = `
+<div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+  <h2>Booking Cancelled</h2>
+  <p>Hi {customerName},</p>
+  <p>Your booking has been cancelled:</p>
+  <table style="width: 100%; border-collapse: collapse;">
+    <tr><td style="padding: 8px; font-weight: bold;">Service</td><td style="padding: 8px;">{eventTitle}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Date</td><td style="padding: 8px;">{date}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Time</td><td style="padding: 8px;">{time} ({timezone})</td></tr>
+  </table>
+  <p style="margin-top: 30px; font-size: 12px; color: #666;">
+    <a href="{unsubscribeUrl}">Unsubscribe</a>
+  </p>
+</div>
+`.trim();
+/** Default reschedule email template */
+export const RESCHEDULE_EMAIL_HTML = `
+<div style="font-family: sans-serif; max-width: 600px; margin: 0 auto;">
+  <h2>Booking Rescheduled</h2>
+  <p>Hi {customerName},</p>
+  <p>Your booking has been rescheduled:</p>
+  <table style="width: 100%; border-collapse: collapse;">
+    <tr><td style="padding: 8px; font-weight: bold;">Service</td><td style="padding: 8px;">{eventTitle}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">Previous</td><td style="padding: 8px;">{oldDate} at {oldTime}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">New Date</td><td style="padding: 8px;">{newDate}</td></tr>
+    <tr><td style="padding: 8px; font-weight: bold;">New Time</td><td style="padding: 8px;">{newTime} ({timezone})</td></tr>
+  </table>
+  <p style="margin-top: 20px;">
+    <a href="{managementUrl}" style="display: inline-block; padding: 12px 24px; background: #0070f3; color: white; text-decoration: none; border-radius: 6px;">
+      Manage Booking
+    </a>
+  </p>
+  <p style="margin-top: 30px; font-size: 12px; color: #666;">
+    <a href="{unsubscribeUrl}">Unsubscribe</a>
+  </p>
+</div>
+`.trim();
+//# sourceMappingURL=email-templates.js.map

package/dist/email-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-templates.js","sourceRoot":"","sources":["../src/email-templates.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,IAAuB;IAEvB,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACnD,MAAM,KAAK,GAAI,IAAsD,CAAC,GAAG,CAAC,CAAC;QAC3E,OAAO,KAAK,IAAI,KAAK,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBtC,CAAC,IAAI,EAAE,CAAC;AAET,sDAAsD;AACtD,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;CAgBtC,CAAC,IAAI,EAAE,CAAC;AAET,sCAAsC;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBlC,CAAC,IAAI,EAAE,CAAC;AAET,0CAA0C;AAC1C,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;CActC,CAAC,IAAI,EAAE,CAAC;AAET,wCAAwC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBpC,CAAC,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { BookingConflictError, SerializationRetryExhaustedError, UnauthorizedError, ForbiddenError, } from "@thebookingkit/core";
+export { withSerializableRetry, type SerializableRetryOptions, } from "./serialization-retry.js";
+export { withAuth, assertProviderOwnership, assertCustomerAccess, type AuthUser, type AuthSession, type AuthAdapter, type AuthenticatedRequest, type WithAuthOptions, } from "./auth.js";
+export type { EmailAdapter, SendEmailOptions, EmailResult, EmailDeliveryStatus, EmailAttachment, CalendarAdapter, CalendarEventOptions, CalendarEventResult, CalendarConflict, JobAdapter, StorageAdapter, SmsAdapter, SendSmsOptions, SmsResult, PaymentAdapter, CreatePaymentIntentOptions, CreatePaymentIntentResult, CreateSetupIntentOptions, CreateSetupIntentResult, CaptureResult, RefundResult, } from "./adapters/index.js";
+export { generateICSAttachment, JOB_NAMES } from "./adapters/index.js";
+export { generateBookingToken, verifyBookingToken, } from "./booking-tokens.js";
+export { sendConfirmationEmail, sendReminderEmail, sendCancellationEmail, sendRescheduleEmail, scheduleAutoReject, syncBookingToCalendar, deleteBookingFromCalendar, formatDateTimeForEmail, formatDurationForEmail, type NotificationBookingData, type ConfirmationEmailPayload, type ReminderEmailPayload, type CancellationEmailPayload, type RescheduleEmailPayload, type CalendarSyncPayload, type CalendarDeletePayload, type AutoRejectPendingPayload, } from "./notification-jobs.js";
+export { interpolateTemplate, CONFIRMATION_EMAIL_HTML, CONFIRMATION_EMAIL_TEXT, REMINDER_EMAIL_HTML, CANCELLATION_EMAIL_HTML, RESCHEDULE_EMAIL_HTML, type EmailTemplateVars, } from "./email-templates.js";
+export { resolveTemplateVariables, evaluateConditions, validateWorkflow, matchWorkflows, DEFAULT_TEMPLATES, TEMPLATE_VARIABLES, WorkflowValidationError, type WorkflowTrigger, type WorkflowActionType, type ConditionOperator, type WorkflowCondition, type EmailActionConfig, type SmsActionConfig, type WebhookActionConfig, type StatusUpdateActionConfig, type CalendarEventActionConfig, type WorkflowAction, type WorkflowDefinition, type WorkflowContext, type WorkflowLogEntry, } from "./workflows.js";
+export { signWebhookPayload, verifyWebhookSignature, createWebhookEnvelope, resolvePayloadTemplate, matchWebhookSubscriptions, getRetryDelay, isSuccessResponse, validateWebhookSubscription, WebhookValidationError, DEFAULT_RETRY_CONFIG, WEBHOOK_TRIGGERS, SIGNATURE_HEADER, TIMESTAMP_HEADER, DEFAULT_TOLERANCE_SECONDS, type WebhookTrigger, type WebhookAttendee, type WebhookPayload, type WebhookEnvelope, type WebhookSubscription, type WebhookDeliveryResult, type WebhookRetryConfig, type WebhookVerificationResult, } from "./webhooks.js";
+export { createErrorResponse, createSuccessResponse, createPaginatedResponse, generateApiKey, hashApiKey, verifyApiKey, hasScope, isKeyExpired, checkRateLimit, encodeCursor, decodeCursor, validateSlotQueryParams, parseSortParam, API_ERROR_CODES, type ApiError, type ApiErrorResponse, type ApiSuccessResponse, type ApiMeta, type PaginatedResponse, type ApiErrorCode, type ApiKeyRecord, type ApiKeyScope, type GeneratedApiKey, type RateLimitState, type RateLimitResult, type ValidationDetail, type ValidationResult, } from "./api.js";
+export { resolveEffectiveSettings, getRolePermissions, roleHasPermission, assertOrgPermission, assertTenantScope, buildOrgBookingUrl, parseOrgBookingPath, TenantAuthorizationError, GLOBAL_DEFAULTS, type OrgRole, type OrgMember, type OrgBranding, type OrgSettings, type ProviderSettings, type EventTypeSettings, type GlobalDefaults, type ResolvedSettings, type OrgPermission, } from "./multi-tenancy.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,22 @@
+// Re-export core errors used by server modules
+export { BookingConflictError, SerializationRetryExhaustedError, UnauthorizedError, ForbiddenError, } from "@thebookingkit/core";
+// Serialization retry utility
+export { withSerializableRetry, } from "./serialization-retry.js";
+// Auth middleware & adapters
+export { withAuth, assertProviderOwnership, assertCustomerAccess, } from "./auth.js";
+export { generateICSAttachment, JOB_NAMES } from "./adapters/index.js";
+// Booking Tokens
+export { generateBookingToken, verifyBookingToken, } from "./booking-tokens.js";
+// Notification Jobs
+export { sendConfirmationEmail, sendReminderEmail, sendCancellationEmail, sendRescheduleEmail, scheduleAutoReject, syncBookingToCalendar, deleteBookingFromCalendar, formatDateTimeForEmail, formatDurationForEmail, } from "./notification-jobs.js";
+// Email Templates
+export { interpolateTemplate, CONFIRMATION_EMAIL_HTML, CONFIRMATION_EMAIL_TEXT, REMINDER_EMAIL_HTML, CANCELLATION_EMAIL_HTML, RESCHEDULE_EMAIL_HTML, } from "./email-templates.js";
+// Workflows
+export { resolveTemplateVariables, evaluateConditions, validateWorkflow, matchWorkflows, DEFAULT_TEMPLATES, TEMPLATE_VARIABLES, WorkflowValidationError, } from "./workflows.js";
+// Webhooks
+export { signWebhookPayload, verifyWebhookSignature, createWebhookEnvelope, resolvePayloadTemplate, matchWebhookSubscriptions, getRetryDelay, isSuccessResponse, validateWebhookSubscription, WebhookValidationError, DEFAULT_RETRY_CONFIG, WEBHOOK_TRIGGERS, SIGNATURE_HEADER, TIMESTAMP_HEADER, DEFAULT_TOLERANCE_SECONDS, } from "./webhooks.js";
+// REST API Utilities
+export { createErrorResponse, createSuccessResponse, createPaginatedResponse, generateApiKey, hashApiKey, verifyApiKey, hasScope, isKeyExpired, checkRateLimit, encodeCursor, decodeCursor, validateSlotQueryParams, parseSortParam, API_ERROR_CODES, } from "./api.js";
+// Multi-Tenancy
+export { resolveEffectiveSettings, getRolePermissions, roleHasPermission, assertOrgPermission, assertTenantScope, buildOrgBookingUrl, parseOrgBookingPath, TenantAuthorizationError, GLOBAL_DEFAULTS, } from "./multi-tenancy.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EACL,oBAAoB,EACpB,gCAAgC,EAChC,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,8BAA8B;AAC9B,OAAO,EACL,qBAAqB,GAEtB,MAAM,0BAA0B,CAAC;AAElC,6BAA6B;AAC7B,OAAO,EACL,QAAQ,EACR,uBAAuB,EACvB,oBAAoB,GAMrB,MAAM,WAAW,CAAC;AA0BnB,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEvE,iBAAiB;AACjB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,GASvB,MAAM,wBAAwB,CAAC;AAEhC,kBAAkB;AAClB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY;AACZ,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GAcxB,MAAM,gBAAgB,CAAC;AAExB,WAAW;AACX,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,GAS1B,MAAM,eAAe,CAAC;AAEvB,qBAAqB;AACrB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,eAAe,GAchB,MAAM,UAAU,CAAC;AAElB,gBAAgB;AAChB,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,GAUhB,MAAM,oBAAoB,CAAC"}

package/dist/multi-tenancy.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Multi-tenancy utilities for organization-scoped deployments.
+ *
+ * Provides organization settings resolution, cascading defaults,
+ * role-based access control, and tenant authorization helpers.
+ */
+/** Organization member role */
+export type OrgRole = "owner" | "admin" | "member";
+/** Organization member */
+export interface OrgMember {
+    userId: string;
+    organizationId: string;
+    role: OrgRole;
+}
+/** Organization branding */
+export interface OrgBranding {
+    logoUrl?: string;
+    primaryColor?: string;
+    accentColor?: string;
+    fontFamily?: string;
+}
+/** Organization-level settings */
+export interface OrgSettings {
+    defaultTimezone?: string;
+    defaultCurrency?: string;
+    branding?: OrgBranding;
+    defaultBufferMinutes?: number;
+    defaultBookingLimits?: Record<string, unknown>;
+}
+/** Provider-level settings that can override org defaults */
+export interface ProviderSettings {
+    timezone?: string;
+    currency?: string;
+    branding?: Partial<OrgBranding>;
+    bufferMinutes?: number;
+    bookingLimits?: Record<string, unknown>;
+}
+/** Event type settings that can override provider defaults */
+export interface EventTypeSettings {
+    timezone?: string;
+    currency?: string;
+    bufferBefore?: number;
+    bufferAfter?: number;
+    bookingLimits?: Record<string, unknown>;
+}
+/** Global SlotKit defaults */
+export interface GlobalDefaults {
+    timezone: string;
+    currency: string;
+    bufferMinutes: number;
+}
+/** Resolved effective settings after cascading resolution */
+export interface ResolvedSettings {
+    timezone: string;
+    currency: string;
+    bufferMinutes: number;
+    branding: OrgBranding;
+    bookingLimits: Record<string, unknown>;
+}
+/** Permissions available in the system */
+export type OrgPermission = "manage:members" | "manage:teams" | "manage:event-types" | "view:all-bookings" | "view:own-bookings" | "manage:own-availability" | "view:analytics" | "manage:organization";
+/** Error thrown for multi-tenancy authorization violations */
+export declare class TenantAuthorizationError extends Error {
+    constructor(message: string);
+}
+/** System-wide defaults used as the base for cascading resolution */
+export declare const GLOBAL_DEFAULTS: GlobalDefaults;
+/**
+ * Resolve effective settings via the cascade:
+ * `event_type > provider > organization > global defaults`
+ *
+ * @param orgSettings - Organization-level settings
+ * @param providerSettings - Provider-level settings (overrides org)
+ * @param eventTypeSettings - Event type settings (overrides provider)
+ * @returns Fully resolved effective settings
+ */
+export declare function resolveEffectiveSettings(orgSettings?: OrgSettings | null, providerSettings?: ProviderSettings | null, eventTypeSettings?: EventTypeSettings | null): ResolvedSettings;
+/**
+ * Get all permissions granted to a role.
+ *
+ * @param role - The organization role
+ * @returns Array of permissions
+ */
+export declare function getRolePermissions(role: OrgRole): OrgPermission[];
+/**
+ * Check if a role has a specific permission.
+ *
+ * @param role - The organization role
+ * @param permission - The permission to check
+ * @returns Whether the role has the permission
+ */
+export declare function roleHasPermission(role: OrgRole, permission: OrgPermission): boolean;
+/**
+ * Assert that an org member has a required permission.
+ *
+ * @param member - The org member
+ * @param permission - The required permission
+ * @throws {TenantAuthorizationError} If the member lacks the permission
+ */
+export declare function assertOrgPermission(member: OrgMember, permission: OrgPermission): void;
+/**
+ * Validate that a resource belongs to the expected organization.
+ *
+ * @param resourceOrgId - Organization ID on the resource
+ * @param expectedOrgId - The org ID from the authenticated context
+ * @throws {TenantAuthorizationError} If there is a tenant mismatch
+ */
+export declare function assertTenantScope(resourceOrgId: string | null | undefined, expectedOrgId: string): void;
+/**
+ * Generate the public booking URL for an organization's provider/event type.
+ *
+ * @param orgSlug - Organization slug
+ * @param providerSlug - Provider slug or ID
+ * @param eventTypeSlug - Event type slug
+ * @param baseUrl - Base URL of the application
+ * @returns Full booking URL
+ */
+export declare function buildOrgBookingUrl(orgSlug: string, providerSlug: string, eventTypeSlug: string, baseUrl: string): string;
+/**
+ * Parse an organization slug from a booking URL path.
+ *
+ * Expected format: `/{orgSlug}/{providerSlug}/{eventTypeSlug}`
+ *
+ * @param pathname - URL pathname
+ * @returns Parsed segments, or null if format is invalid
+ */
+export declare function parseOrgBookingPath(pathname: string): {
+    orgSlug: string;
+    providerSlug: string;
+    eventTypeSlug: string;
+} | null;
+//# sourceMappingURL=multi-tenancy.d.ts.map

package/dist/multi-tenancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-tenancy.d.ts","sourceRoot":"","sources":["../src/multi-tenancy.ts"],"names":[],"mappings":"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"}

package/dist/multi-tenancy.js

@@ -0,0 +1,188 @@
+/**
+ * Multi-tenancy utilities for organization-scoped deployments.
+ *
+ * Provides organization settings resolution, cascading defaults,
+ * role-based access control, and tenant authorization helpers.
+ */
+// ---------------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------------
+/** Error thrown for multi-tenancy authorization violations */
+export class TenantAuthorizationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TenantAuthorizationError";
+    }
+}
+// ---------------------------------------------------------------------------
+// Global Defaults
+// ---------------------------------------------------------------------------
+/** System-wide defaults used as the base for cascading resolution */
+export const GLOBAL_DEFAULTS = {
+    timezone: "UTC",
+    currency: "USD",
+    bufferMinutes: 0,
+};
+// ---------------------------------------------------------------------------
+// Settings Resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve effective settings via the cascade:
+ * `event_type > provider > organization > global defaults`
+ *
+ * @param orgSettings - Organization-level settings
+ * @param providerSettings - Provider-level settings (overrides org)
+ * @param eventTypeSettings - Event type settings (overrides provider)
+ * @returns Fully resolved effective settings
+ */
+export function resolveEffectiveSettings(orgSettings, providerSettings, eventTypeSettings) {
+    // Start with global defaults
+    let timezone = GLOBAL_DEFAULTS.timezone;
+    let currency = GLOBAL_DEFAULTS.currency;
+    let bufferMinutes = GLOBAL_DEFAULTS.bufferMinutes;
+    let branding = {};
+    let bookingLimits = {};
+    // Apply org settings
+    if (orgSettings) {
+        if (orgSettings.defaultTimezone)
+            timezone = orgSettings.defaultTimezone;
+        if (orgSettings.defaultCurrency)
+            currency = orgSettings.defaultCurrency;
+        if (orgSettings.defaultBufferMinutes !== undefined)
+            bufferMinutes = orgSettings.defaultBufferMinutes;
+        if (orgSettings.branding)
+            branding = { ...branding, ...orgSettings.branding };
+        if (orgSettings.defaultBookingLimits)
+            bookingLimits = { ...orgSettings.defaultBookingLimits };
+    }
+    // Apply provider settings (override org)
+    if (providerSettings) {
+        if (providerSettings.timezone)
+            timezone = providerSettings.timezone;
+        if (providerSettings.currency)
+            currency = providerSettings.currency;
+        if (providerSettings.bufferMinutes !== undefined)
+            bufferMinutes = providerSettings.bufferMinutes;
+        if (providerSettings.branding)
+            branding = { ...branding, ...providerSettings.branding };
+        if (providerSettings.bookingLimits)
+            bookingLimits = { ...bookingLimits, ...providerSettings.bookingLimits };
+    }
+    // Apply event type settings (override provider)
+    if (eventTypeSettings) {
+        if (eventTypeSettings.timezone)
+            timezone = eventTypeSettings.timezone;
+        if (eventTypeSettings.currency)
+            currency = eventTypeSettings.currency;
+        if (eventTypeSettings.bufferBefore !== undefined)
+            bufferMinutes = eventTypeSettings.bufferBefore;
+        if (eventTypeSettings.bookingLimits)
+            bookingLimits = { ...bookingLimits, ...eventTypeSettings.bookingLimits };
+    }
+    return { timezone, currency, bufferMinutes, branding, bookingLimits };
+}
+// ---------------------------------------------------------------------------
+// Role-Based Access Control
+// ---------------------------------------------------------------------------
+/** Permissions granted to each role */
+const ROLE_PERMISSIONS = {
+    owner: [
+        "manage:members",
+        "manage:teams",
+        "manage:event-types",
+        "view:all-bookings",
+        "view:own-bookings",
+        "manage:own-availability",
+        "view:analytics",
+        "manage:organization",
+    ],
+    admin: [
+        "manage:teams",
+        "manage:event-types",
+        "view:all-bookings",
+        "view:own-bookings",
+        "manage:own-availability",
+        "view:analytics",
+    ],
+    member: [
+        "view:own-bookings",
+        "manage:own-availability",
+    ],
+};
+/**
+ * Get all permissions granted to a role.
+ *
+ * @param role - The organization role
+ * @returns Array of permissions
+ */
+export function getRolePermissions(role) {
+    return ROLE_PERMISSIONS[role] ?? [];
+}
+/**
+ * Check if a role has a specific permission.
+ *
+ * @param role - The organization role
+ * @param permission - The permission to check
+ * @returns Whether the role has the permission
+ */
+export function roleHasPermission(role, permission) {
+    return getRolePermissions(role).includes(permission);
+}
+/**
+ * Assert that an org member has a required permission.
+ *
+ * @param member - The org member
+ * @param permission - The required permission
+ * @throws {TenantAuthorizationError} If the member lacks the permission
+ */
+export function assertOrgPermission(member, permission) {
+    if (!roleHasPermission(member.role, permission)) {
+        throw new TenantAuthorizationError(`Role "${member.role}" does not have permission: "${permission}"`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Tenant Scoping
+// ---------------------------------------------------------------------------
+/**
+ * Validate that a resource belongs to the expected organization.
+ *
+ * @param resourceOrgId - Organization ID on the resource
+ * @param expectedOrgId - The org ID from the authenticated context
+ * @throws {TenantAuthorizationError} If there is a tenant mismatch
+ */
+export function assertTenantScope(resourceOrgId, expectedOrgId) {
+    if (resourceOrgId && resourceOrgId !== expectedOrgId) {
+        throw new TenantAuthorizationError("Resource does not belong to the current organization");
+    }
+}
+/**
+ * Generate the public booking URL for an organization's provider/event type.
+ *
+ * @param orgSlug - Organization slug
+ * @param providerSlug - Provider slug or ID
+ * @param eventTypeSlug - Event type slug
+ * @param baseUrl - Base URL of the application
+ * @returns Full booking URL
+ */
+export function buildOrgBookingUrl(orgSlug, providerSlug, eventTypeSlug, baseUrl) {
+    return `${baseUrl}/${orgSlug}/${providerSlug}/${eventTypeSlug}`;
+}
+/**
+ * Parse an organization slug from a booking URL path.
+ *
+ * Expected format: `/{orgSlug}/{providerSlug}/{eventTypeSlug}`
+ *
+ * @param pathname - URL pathname
+ * @returns Parsed segments, or null if format is invalid
+ */
+export function parseOrgBookingPath(pathname) {
+    const match = pathname.match(/^\/([^/]+)\/([^/]+)\/([^/]+)$/);
+    if (!match)
+        return null;
+    return {
+        orgSlug: match[1],
+        providerSlug: match[2],
+        eventTypeSlug: match[3],
+    };
+}
+//# sourceMappingURL=multi-tenancy.js.map

package/dist/multi-tenancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-tenancy.js","sourceRoot":"","sources":["../src/multi-tenancy.ts"],"names":[],"mappings":"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"}

package/dist/notification-jobs.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Notification job payload types and helper functions for E-06.
+ *
+ * These types are used by background job functions (Inngest, Trigger.dev, BullMQ, etc.)
+ * when sending booking notification emails and syncing calendar events.
+ *
+ * The actual job implementation lives in the consumer app (or a provided Inngest
+ * functions file), but the payload shapes and builder functions are framework-agnostic.
+ */
+import type { EmailAdapter, CalendarAdapter, JobAdapter } from "./adapters/index.js";
+import { JOB_NAMES } from "./adapters/job-adapter.js";
+/** Common booking data included in every notification payload */
+export interface NotificationBookingData {
+    bookingId: string;
+    eventTitle: string;
+    providerName: string;
+    providerEmail: string;
+    customerName: string;
+    customerEmail: string;
+    /** ISO datetime strings */
+    startsAt: string;
+    endsAt: string;
+    timezone: string;
+    location?: string;
+    /** Signed management URL for the customer */
+    managementUrl?: string;
+    /** Unsubscribe URL */
+    unsubscribeUrl?: string;
+}
+/** Payload for SEND_CONFIRMATION_EMAIL job */
+export interface ConfirmationEmailPayload extends NotificationBookingData {
+    /** Whether to also send a notification to the provider */
+    notifyProvider?: boolean;
+}
+/** Payload for SEND_REMINDER_EMAIL job */
+export interface ReminderEmailPayload extends NotificationBookingData {
+    /** How many hours before the appointment this reminder is for (e.g., 24 or 1) */
+    reminderHours: number;
+}
+/** Payload for SEND_CANCELLATION_EMAIL job */
+export interface CancellationEmailPayload extends NotificationBookingData {
+    /** Who initiated the cancellation */
+    cancelledBy: "customer" | "provider" | "system";
+    /** Optional reason for cancellation */
+    reason?: string;
+}
+/** Payload for SEND_RESCHEDULE_EMAIL job */
+export interface RescheduleEmailPayload extends NotificationBookingData {
+    /** Original booking datetime strings */
+    oldStartsAt: string;
+    oldEndsAt: string;
+}
+/** Payload for SYNC_CALENDAR_EVENT job */
+export interface CalendarSyncPayload {
+    bookingId: string;
+    providerId: string;
+    /** External calendar event ID (for updates/deletes) */
+    externalEventId?: string;
+    eventTitle: string;
+    customerName: string;
+    customerEmail: string;
+    startsAt: string;
+    endsAt: string;
+    timezone: string;
+    location?: string;
+    description?: string;
+}
+/** Payload for DELETE_CALENDAR_EVENT job */
+export interface CalendarDeletePayload {
+    bookingId: string;
+    providerId: string;
+    externalEventId: string;
+}
+/** Payload for AUTO_REJECT_PENDING job */
+export interface AutoRejectPendingPayload {
+    bookingId: string;
+    /** Actor to record in the booking_event */
+    actor?: string;
+}
+/**
+ * Format a UTC datetime string in a given timezone for email templates.
+ *
+ * @returns `{ date, time }` formatted for the email template variables
+ */
+export declare function formatDateTimeForEmail(isoString: string, timezone: string): {
+    date: string;
+    time: string;
+};
+/**
+ * Calculate duration in human-readable form from start/end ISO strings.
+ */
+export declare function formatDurationForEmail(startsAt: string, endsAt: string): string;
+/**
+ * Send a booking confirmation email to the customer (and optionally the provider).
+ *
+ * Call this from your Inngest/Trigger.dev/BullMQ job handler.
+ *
+ * @example
+ * ```ts
+ * // In your Inngest function:
+ * export const sendConfirmation = inngest.createFunction(
+ *   { id: "send-confirmation-email" },
+ *   { event: JOB_NAMES.SEND_CONFIRMATION_EMAIL },
+ *   async ({ event }) => {
+ *     await sendConfirmationEmail(event.data, emailAdapter);
+ *   },
+ * );
+ * ```
+ */
+export declare function sendConfirmationEmail(payload: ConfirmationEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send a reminder email to the customer before their appointment.
+ */
+export declare function sendReminderEmail(payload: ReminderEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send cancellation notification emails to customer and provider.
+ */
+export declare function sendCancellationEmail(payload: CancellationEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Send reschedule notification emails to customer and provider.
+ */
+export declare function sendRescheduleEmail(payload: RescheduleEmailPayload, emailAdapter: EmailAdapter): Promise<void>;
+/**
+ * Schedule the auto-rejection of a pending booking using the job adapter.
+ *
+ * Call this immediately after creating a booking that requires confirmation.
+ *
+ * @param bookingId - ID of the pending booking
+ * @param deadline - Date at which to auto-reject (from `getAutoRejectDeadline`)
+ * @param jobs - Your `JobAdapter` instance
+ * @returns The scheduled job ID (store it if you need to cancel on manual confirm/reject)
+ */
+export declare function scheduleAutoReject(bookingId: string, deadline: Date, jobs: JobAdapter): Promise<string>;
+/**
+ * Sync a confirmed booking to the provider's connected calendar.
+ */
+export declare function syncBookingToCalendar(payload: CalendarSyncPayload, calendarAdapter: CalendarAdapter): Promise<string | undefined>;
+/**
+ * Delete a calendar event when a booking is cancelled.
+ */
+export declare function deleteBookingFromCalendar(externalEventId: string, calendarAdapter: CalendarAdapter): Promise<void>;
+export { JOB_NAMES };
+//# sourceMappingURL=notification-jobs.d.ts.map

package/dist/notification-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-jobs.d.ts","sourceRoot":"","sources":["../src/notification-jobs.ts"],"names":[],"mappings":"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"}