@veladent/booking-core 0.0.0-stage → 1.0.4-dev.9

package/README.md

@@ -1,3 +1,22 @@
-# Temporary Holding Version
+# Veladent booking core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Framework-independent booking API client, types, locale helpers, and validation.
+
+```sh
+npm install @veladent/booking-core
+```
+
+```js
+import { createBookingClient } from "@veladent/booking-core";
+
+const client = createBookingClient({
+  baseUrl: "YOUR_API_BASE_URL",
+  publishableKey: "YOUR_SITE_PUBLISHABLE_KEY",
+});
+```
+
+Use `@dev` or `@sandbox` to install a public prerelease. The default channel is
+stable (`latest`). Supply your API URL and site publishable key at runtime.
+Never supply a server secret or npm token to a browser application.
+
+For the React UI, install `@veladent/booking-widget`.

package/index.js

@@ -0,0 +1,499 @@
+function normalizeEmail(value) {
+  return value.trim().toLowerCase();
+}
+function normalizePhone(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("00")) {
+    return `+${trimmed.slice(2).replace(/\D/g, "")}`;
+  }
+  if (trimmed.startsWith("+")) {
+    return `+${trimmed.slice(1).replace(/\D/g, "")}`;
+  }
+  return trimmed.replace(/\D/g, "");
+}
+function isLikelyE164(value) {
+  return /^\+[1-9]\d{7,14}$/.test(value);
+}
+function validateContact(contact) {
+  if (!normalizePhone(contact.phone)) {
+    return "phone";
+  }
+  if (!contact.fullName.trim()) {
+    return "fullName";
+  }
+  if (!/^\S+@\S+\.\S+$/.test(normalizeEmail(contact.email))) {
+    return "email";
+  }
+  return null;
+}
+function validateExistingPhone(phone) {
+  return isLikelyE164(normalizePhone(phone)) ? null : "phone";
+}
+function validateVerificationCode(code) {
+  return /^\d{6}$/.test(code.trim()) ? null : "verificationCode";
+}
+function isValidPastDateOfBirth(value) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+    return false;
+  }
+  const date = /* @__PURE__ */ new Date(`${value}T00:00:00Z`);
+  if (Number.isNaN(date.getTime())) {
+    return false;
+  }
+  const now = /* @__PURE__ */ new Date();
+  const todayUtc = Date.UTC(
+    now.getUTCFullYear(),
+    now.getUTCMonth(),
+    now.getUTCDate()
+  );
+  return date.getTime() <= todayUtc && date.getUTCFullYear() >= 1900;
+}
+function validatePatientDetails(details) {
+  if (!details) {
+    return "patientDetails";
+  }
+  if (!isValidPastDateOfBirth(details.dateOfBirth)) {
+    return "dateOfBirth";
+  }
+  if (!details.gender.trim()) {
+    return "gender";
+  }
+  return null;
+}
+class BookingApiError extends Error {
+  constructor(message, status, code) {
+    super(message);
+    this.name = "BookingApiError";
+    this.status = status;
+    this.code = code;
+  }
+}
+function joinUrl(baseUrl, path) {
+  return `${baseUrl.replace(/\/$/, "")}/${path.replace(/^\//, "")}`;
+}
+function normalizeConfig(config) {
+  const candidate = config;
+  return {
+    ...config,
+    doctors: Array.isArray(config.doctors) ? config.doctors : [],
+    locale: config.locale || "en",
+    services: Array.isArray(config.services) ? config.services : [],
+    siteAddress: config.siteAddress ?? null,
+    siteLogoUrl: config.siteLogoUrl ?? null,
+    siteName: config.siteName ?? null,
+    sitePhone: config.sitePhone ?? null,
+    theme: config.theme ?? candidate.themeConfig ?? null,
+    timeZone: config.timeZone || candidate.timezone || "UTC",
+    treatments: Array.isArray(config.treatments) ? config.treatments : []
+  };
+}
+function createBookingClient(options) {
+  const fetcher = options.fetcher ?? globalThis.fetch.bind(globalThis);
+  const baseUrl = options.baseUrl.replace(/\/$/, "");
+  const headers = {
+    Accept: "application/json",
+    "Content-Type": "application/json",
+    "X-Veladent-Publishable-Key": options.publishableKey
+  };
+  async function request(path, init = {}) {
+    const response = await fetcher(joinUrl(baseUrl, path), {
+      ...init,
+      cache: "no-store",
+      headers: {
+        ...headers,
+        ...init.headers
+      }
+    });
+    const body = await response.json().catch(() => null);
+    if (!response.ok) {
+      const errorBody = body;
+      throw new BookingApiError(
+        errorBody?.message || "The booking request failed",
+        response.status,
+        errorBody?.code
+      );
+    }
+    return body;
+  }
+  return {
+    cancelPayment(sessionId) {
+      return request(
+        `/api/v1/public/booking/payments/${encodeURIComponent(sessionId)}/cancel`,
+        { method: "POST" }
+      );
+    },
+    createRequest(input) {
+      return request("/api/v1/public/booking/requests", {
+        body: JSON.stringify({
+          bookingMode: input.bookingMode,
+          checkoutRequestId: input.checkoutRequestId,
+          contact: {
+            ...input.contact,
+            email: normalizeEmail(input.contact.email),
+            phone: normalizePhone(input.contact.phone)
+          },
+          doctorId: input.doctorId,
+          end: input.end,
+          identity: input.bookingMode === "existing" && input.contact.firstName && input.contact.lastName && input.patientDetails.dateOfBirth ? {
+            dateOfBirth: input.patientDetails.dateOfBirth,
+            firstName: input.contact.firstName,
+            lastName: input.contact.lastName
+          } : void 0,
+          patientDetails: input.bookingMode === "new" ? input.patientDetails : void 0,
+          start: input.start,
+          treatmentId: input.treatmentId,
+          verificationCode: input.verificationCode
+        }),
+        method: "POST"
+      });
+    },
+    getConfig(signal) {
+      return request("/api/v1/public/booking/config", {
+        signal
+      }).then(normalizeConfig);
+    },
+    getPaymentStatus(sessionId) {
+      return request(
+        `/api/v1/public/booking/payments/${encodeURIComponent(sessionId)}`
+      );
+    },
+    getSlots(input) {
+      const params = new URLSearchParams({ treatmentId: input.treatmentId });
+      if (input.fromDate && input.toDate) {
+        params.set("fromDate", input.fromDate);
+        params.set("toDate", input.toDate);
+      } else {
+        params.set("date", input.date);
+      }
+      if (input.doctorId) {
+        params.set("doctorId", input.doctorId);
+      }
+      return request(
+        `/api/v1/public/booking/slots?${params}`,
+        { signal: input.signal }
+      ).then((body) => Array.isArray(body) ? body : body.slots);
+    },
+    requestVerification(input) {
+      return request(
+        "/api/v1/public/booking/verification/request",
+        {
+          body: JSON.stringify({
+            bookingMode: input.bookingMode,
+            identity: input.identity,
+            phone: normalizePhone(input.phone)
+          }),
+          method: "POST"
+        }
+      );
+    },
+    verificationStorageKey: `veladent-booking:verification:${baseUrl}:${options.publishableKey}`,
+    verifyCode(input) {
+      return request(
+        "/api/v1/public/booking/verification/check",
+        {
+          body: JSON.stringify({
+            bookingMode: input.bookingMode,
+            code: input.code.trim(),
+            identity: input.identity,
+            phone: normalizePhone(input.phone)
+          }),
+          method: "POST"
+        }
+      );
+    }
+  };
+}
+const englishCopy = {
+  addressLine1: "Address line 1",
+  anyPractitioner: "Any practitioner",
+  anyPractitionerDescription: "Let the clinic choose the best available practitioner",
+  appointmentSummary: "Appointment summary",
+  appointmentTitle: "Book an appointment",
+  back: "Back",
+  balance: "Balance due after appointment",
+  bookAgain: "Book another appointment",
+  bookingDisabled: "This practice isn’t accepting online bookings right now.",
+  bookingFailed: "We could not complete the booking. Please try again.",
+  bookingUnavailableDescription: "We couldn’t load online booking right now. Please try again in a moment, or contact the practice for help.",
+  bookingUnavailableTitle: "Online booking is unavailable",
+  callPractice: "Call us",
+  cancelPayment: "Cancel payment and edit booking",
+  checkingPayment: "Checking payment status.",
+  checkPayment: "Check payment status",
+  chooseAnotherDate: "Please choose another date or contact the practice.",
+  chooseDate: "Choose a date",
+  chooseDateTime: "Choose a date & time",
+  chooseDoctor: "Choose practitioner",
+  chooseService: "What do you need?",
+  chooseTime: "Available times",
+  chooseTreatment: "Choose a treatment",
+  clinic: "Clinic",
+  close: "Close",
+  codeExpired: "This code has expired. Request a new code.",
+  codeExpiresIn: "Code expires in {time}",
+  confirmationDescription: "Your booking is complete. We look forward to seeing you.",
+  confirmCode: "Verify code",
+  confirmed: "Your appointment is confirmed.",
+  contactPractice: "Please contact the practice for help.",
+  contactSite: "Can’t see the appointment you need? Call {phone} to discuss your options.",
+  continue: "Continue",
+  dateOfBirth: "Date of birth",
+  deposit: "Deposit",
+  email: "Email address",
+  existingPatient: "Yes",
+  existingPatientDescription: "I'm an existing patient",
+  findPatientRecord: "Find your patient record",
+  firstName: "First name",
+  fullName: "Full name",
+  gender: "Gender",
+  genderOptions: {
+    female: "Female",
+    male: "Male",
+    other: "Other",
+    preferNotToSay: "Prefer not to say"
+  },
+  genderPlaceholder: "Select gender",
+  goBackAndEdit: "Go back and edit",
+  identityUnavailable: "We didn't find your patient record",
+  identityUnavailableDescription: "Your details may have changed, or there may be a mistake on your patient record. Please call the practice to verify your identity and update your contact details.",
+  invalidInput: "Please check the booking details and try again.",
+  lastName: "Last name",
+  loadingSlots: "Loading available times…",
+  loginTitle: "Log in to your account",
+  marketingOptIn: "Yes, I’d like to hear about news and special offers",
+  newPatient: "No",
+  newPatientDescription: "I'm a new patient",
+  noDoctors: "No practitioners are available for online booking.",
+  noMatchingServices: "No services match your search.",
+  noServices: "There are no services available for online booking.",
+  noSlots: "There are no available times on this date.",
+  noTreatments: "There are no treatments available for this service.",
+  otpCode: "6-digit code",
+  otpDescription: "Enter the 6-digit code sent to your mobile number.",
+  otpSent: "We sent a verification code to",
+  patientDetails: "Patient details",
+  patientDetailsRequired: "Please add the patient details so we can create the patient record.",
+  patientNoMatch: "We didn't find a match",
+  patientNoMatchDescription: "We searched for records matching these details.",
+  paymentAtPractice: "Pay the full treatment price securely with Stripe to confirm your appointment.",
+  paymentExpired: "The payment session has expired. Choose an appointment time and try again.",
+  paymentPending: "Complete payment in the Stripe tab. Your appointment will be confirmed automatically after payment.",
+  paymentReceived: "Payment received",
+  paymentStatusUnavailable: "We couldn’t check payment status. Please try checking again. Your payment may still be processing.",
+  payWithStripe: "Pay securely with Stripe",
+  pendingConfirmation: "Your appointment request is waiting for clinic confirmation.",
+  phone: "Mobile number",
+  phoneCountry: "Phone country and calling code",
+  phoneCountryCodeHint: "Include your country code, for example +91 8799657887 or +44 7700900123.",
+  postcode: "Postcode",
+  practitionerDescription: "Choose a practitioner or let us find the next available appointment",
+  preparingPayment: "Preparing your secure payment…",
+  price: "Price",
+  registeredQuestion: "Are you registered as a patient at this practice?",
+  requestCode: "Send verification code",
+  resendCode: "Resend code",
+  resendCodeIn: "Resend code in {seconds}s",
+  retry: "Try again",
+  reviewPayment: "Complete your payment",
+  searchServices: "Search services",
+  selectDateFirst: "Choose a date to see available times.",
+  serviceDescription: "Choose a service to continue",
+  slotsLoadFailed: "We couldn’t load available times. Please try again or choose another date.",
+  somethingElse: "Something else",
+  submit: "Book appointment",
+  submitting: "Booking appointment...",
+  title: "Book online",
+  titleLabel: "Title",
+  titlePlaceholder: "Select title",
+  total: "Total",
+  treatmentDescription: "Choose an appointment",
+  verificationReminders: "We use your mobile number for account verification and appointment reminders.",
+  verifyPhone: "Verify your mobile number",
+  yourDetails: "Contact details"
+};
+const arabicCopy = {
+  ...englishCopy,
+  addressLine1: "العنوان",
+  anyPractitioner: "أي طبيب",
+  anyPractitionerDescription: "دع العيادة تختار الطبيب المتاح الأنسب",
+  appointmentSummary: "ملخص الموعد",
+  appointmentTitle: "حجز موعد",
+  back: "رجوع",
+  balance: "المبلغ المتبقي بعد الموعد",
+  bookAgain: "حجز موعد آخر",
+  bookingDisabled: "لا تقبل هذه العيادة الحجز عبر الإنترنت حاليًا.",
+  bookingFailed: "تعذر إكمال الحجز. يرجى المحاولة مرة أخرى.",
+  bookingUnavailableDescription: "تعذر تحميل الحجز الآن. حاول مرة أخرى بعد قليل أو تواصل مع العيادة للمساعدة.",
+  bookingUnavailableTitle: "الحجز عبر الإنترنت غير متاح",
+  callPractice: "اتصل بنا",
+  cancelPayment: "إلغاء الدفع وتعديل الحجز",
+  checkingPayment: "جارٍ التحقق من حالة الدفع.",
+  checkPayment: "التحقق من حالة الدفع",
+  chooseAnotherDate: "يرجى اختيار تاريخ آخر أو الاتصال بالعيادة.",
+  chooseDate: "اختر التاريخ",
+  chooseDateTime: "اختر التاريخ والوقت",
+  chooseDoctor: "اختر الطبيب",
+  chooseService: "ما الذي تحتاجه؟",
+  chooseTime: "الأوقات المتاحة",
+  chooseTreatment: "اختر العلاج",
+  clinic: "العيادة",
+  close: "إغلاق",
+  codeExpired: "انتهت صلاحية الرمز. اطلب رمزًا جديدًا.",
+  codeExpiresIn: "تنتهي صلاحية الرمز خلال {time}",
+  confirmationDescription: "اكتمل حجزك. نتطلع إلى رؤيتك.",
+  confirmCode: "تحقق من الرمز",
+  confirmed: "تم تأكيد موعدك.",
+  contactPractice: "يرجى الاتصال بالعيادة للمساعدة.",
+  contactSite: "لا ترى الموعد الذي تحتاجه؟ اتصل بـ {phone} لمناقشة الخيارات.",
+  continue: "متابعة",
+  dateOfBirth: "تاريخ الميلاد",
+  deposit: "العربون",
+  email: "البريد الإلكتروني",
+  existingPatient: "نعم",
+  existingPatientDescription: "أنا مريض حالي",
+  findPatientRecord: "البحث عن سجل المريض",
+  firstName: "الاسم الأول",
+  fullName: "الاسم الكامل",
+  gender: "الجنس",
+  genderOptions: {
+    female: "أنثى",
+    male: "ذكر",
+    other: "آخر",
+    preferNotToSay: "أفضل عدم الإفصاح"
+  },
+  genderPlaceholder: "اختر الجنس",
+  goBackAndEdit: "العودة وتعديل البيانات",
+  identityUnavailable: "لا يمكننا التحقق من هويتك عبر الإنترنت",
+  identityUnavailableDescription: "لم نتمكن من مطابقة بياناتك مع سجل مريض. يرجى الاتصال بالعيادة للتحقق من هويتك وبيانات الاتصال الخاصة بك.",
+  lastName: "اسم العائلة",
+  loadingSlots: "جارٍ تحميل الأوقات المتاحة…",
+  loginTitle: "تسجيل الدخول إلى حسابك",
+  marketingOptIn: "نعم، أود معرفة الأخبار والعروض الخاصة",
+  newPatient: "لا",
+  newPatientDescription: "أنا مريض جديد",
+  noDoctors: "لا يوجد أطباء متاحون للحجز عبر الإنترنت.",
+  noServices: "لا توجد خدمات متاحة للحجز عبر الإنترنت.",
+  noSlots: "لا توجد أوقات متاحة في هذا التاريخ.",
+  noTreatments: "لا توجد علاجات متاحة لهذه الخدمة.",
+  otpCode: "رمز مكون من 6 أرقام",
+  otpDescription: "أدخل الرمز المكون من 6 أرقام المرسل إلى هاتفك المحمول.",
+  otpSent: "أرسلنا رمز التحقق إلى",
+  patientDetails: "بيانات المريض",
+  patientDetailsRequired: "أضف بيانات المريض لإنشاء سجل المريض.",
+  patientNoMatch: "لم نعثر على سجل مطابق",
+  patientNoMatchDescription: "بحثنا عن سجلات تطابق هذه البيانات.",
+  paymentAtPractice: "ادفع سعر العلاج بالكامل بأمان عبر Stripe لتأكيد موعدك.",
+  paymentExpired: "انتهت جلسة الدفع. اختر وقتًا للموعد وحاول مرة أخرى.",
+  paymentPending: "أكمل الدفع في علامة تبويب Stripe. سيتم تأكيد موعدك تلقائيًا بعد الدفع.",
+  paymentReceived: "تم استلام الدفع",
+  paymentStatusUnavailable: "تعذر التحقق من حالة الدفع. يرجى المحاولة مرة أخرى. قد يكون الدفع قيد المعالجة.",
+  payWithStripe: "الدفع بأمان عبر Stripe",
+  pendingConfirmation: "طلب موعدك بانتظار تأكيد العيادة.",
+  phone: "رقم الجوال",
+  phoneCountry: "الدولة ورمز الاتصال",
+  phoneCountryCodeHint: "أدخل رمز الدولة، مثل ‎+91 8799657887 أو ‎+44 7700900123.",
+  postcode: "الرمز البريدي",
+  practitionerDescription: "اختر طبيبًا أو دعنا نجد أقرب موعد متاح",
+  preparingPayment: "جارٍ تجهيز الدفع الآمن…",
+  price: "السعر",
+  registeredQuestion: "هل أنت مسجل كمريض في هذه العيادة؟",
+  requestCode: "إرسال رمز التحقق",
+  resendCode: "إعادة إرسال الرمز",
+  resendCodeIn: "إعادة إرسال الرمز خلال {seconds} ثانية",
+  retry: "حاول مرة أخرى",
+  reviewPayment: "أكمل الدفع",
+  selectDateFirst: "اختر تاريخًا لعرض الأوقات المتاحة.",
+  serviceDescription: "اختر خدمة للمتابعة",
+  slotsLoadFailed: "تعذر تحميل الأوقات المتاحة. يرجى المحاولة مرة أخرى أو اختيار تاريخ آخر.",
+  somethingElse: "شيء آخر",
+  submit: "حجز الموعد",
+  submitting: "جارٍ حجز الموعد...",
+  title: "احجز عبر الإنترنت",
+  titleLabel: "اللقب",
+  titlePlaceholder: "اختر اللقب",
+  total: "الإجمالي",
+  treatmentDescription: "اختر موعدًا",
+  verificationReminders: "نستخدم رقم هاتفك للتحقق من الحساب وتذكيرات المواعيد.",
+  verifyPhone: "تحقق من رقم جوالك",
+  yourDetails: "بيانات التواصل"
+};
+function resolveLocale(locale) {
+  const candidate = locale?.trim() || "en";
+  try {
+    return Intl.getCanonicalLocales(candidate)[0] ?? "en";
+  } catch {
+    return "en";
+  }
+}
+function getLocaleDirection(locale) {
+  return /^((ar|fa|he|ur)(-|$))/i.test(resolveLocale(locale)) ? "rtl" : "ltr";
+}
+function getBookingCopy(locale) {
+  return resolveLocale(locale).toLowerCase().startsWith("ar") ? arabicCopy : englishCopy;
+}
+function getDateTimeParts(value, timeZone) {
+  const date = value instanceof Date ? value : new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error("Invalid booking date");
+  }
+  return new Intl.DateTimeFormat("en-CA", {
+    day: "2-digit",
+    month: "2-digit",
+    timeZone,
+    year: "numeric"
+  }).formatToParts(date);
+}
+function formatBookingDateTime(value, options) {
+  return new Intl.DateTimeFormat(resolveLocale(options.locale), {
+    dateStyle: "medium",
+    timeStyle: "short",
+    timeZone: options.timeZone
+  }).format(typeof value === "string" ? new Date(value) : value);
+}
+function formatBookingDate(value, options) {
+  return new Intl.DateTimeFormat(resolveLocale(options.locale), {
+    dateStyle: "full",
+    timeZone: options.timeZone
+  }).format(typeof value === "string" ? new Date(value) : value);
+}
+function formatBookingTime(value, options) {
+  return new Intl.DateTimeFormat(resolveLocale(options.locale), {
+    timeStyle: "short",
+    timeZone: options.timeZone
+  }).format(typeof value === "string" ? new Date(value) : value);
+}
+function getDateKeyInTimeZone(value, timeZone) {
+  const parts = getDateTimeParts(value, timeZone);
+  const values = Object.fromEntries(
+    parts.map((part) => [part.type, part.value])
+  );
+  return `${values.year}-${values.month}-${values.day}`;
+}
+function addCalendarDays(dateKey, days) {
+  const date = /* @__PURE__ */ new Date(`${dateKey}T12:00:00.000Z`);
+  if (Number.isNaN(date.getTime())) {
+    throw new Error("Invalid booking date key");
+  }
+  date.setUTCDate(date.getUTCDate() + days);
+  return date.toISOString().slice(0, 10);
+}
+export {
+  BookingApiError,
+  addCalendarDays,
+  createBookingClient,
+  formatBookingDate,
+  formatBookingDateTime,
+  formatBookingTime,
+  getBookingCopy,
+  getDateKeyInTimeZone,
+  getLocaleDirection,
+  isLikelyE164,
+  isValidPastDateOfBirth,
+  normalizeEmail,
+  normalizePhone,
+  resolveLocale,
+  validateContact,
+  validateExistingPhone,
+  validatePatientDetails,
+  validateVerificationCode
+};

package/package.json

@@ -1,6 +1,38 @@
 {
+  "dependencies": {},
+  "description": "Veladent booking API client and types",
+  "exports": {
+    ".": {
+      "types": "./types/booking/core/src/index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "styles.css",
+    "types",
+    "README.md"
+  ],
+  "license": "UNLICENSED",
+  "main": "./index.js",
   "name": "@veladent/booking-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "repository": {
+    "directory": "packages/booking/core",
+    "type": "git",
+    "url": "git+https://github.com/veladent-tech/veladent.git"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "type": "module",
+  "types": "./types/booking/core/src/index.d.ts",
+  "version": "1.0.4-dev.9",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "veladentRelease": {
+    "environment": "dev",
+    "source": "da9f660f9c547eea900329e92dc3cc282f15e6d3a333643282198e2bf105ef9d"
+  }
+}

package/types/booking/core/src/client.d.ts

@@ -0,0 +1,21 @@
+import type { BookingClientOptions, BookingConfig, BookingResult, BookingSlot, CreateBookingInput, GetSlotsInput, RequestBookingVerificationInput, RequestBookingVerificationResult, VerifyBookingCodeInput, VerifyBookingCodeResult } from "./types.js";
+export declare class BookingApiError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor(message: string, status: number, code?: string);
+}
+export interface BookingClient {
+    cancelPayment?(sessionId: string): Promise<Omit<BookingResult, "status"> & {
+        status: "pending" | "confirmed" | "expired";
+    }>;
+    createRequest(input: CreateBookingInput): Promise<BookingResult>;
+    getConfig(signal?: AbortSignal): Promise<BookingConfig>;
+    getPaymentStatus?(sessionId: string): Promise<Omit<BookingResult, "status"> & {
+        status: "pending" | "confirmed" | "expired";
+    }>;
+    getSlots(input: GetSlotsInput): Promise<BookingSlot[]>;
+    requestVerification(input: RequestBookingVerificationInput): Promise<RequestBookingVerificationResult>;
+    verificationStorageKey?: string;
+    verifyCode(input: VerifyBookingCodeInput): Promise<VerifyBookingCodeResult>;
+}
+export declare function createBookingClient(options: BookingClientOptions): BookingClient;

package/types/booking/core/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./locale.js";
+export * from "./timezone.js";
+export * from "./types.js";
+export * from "./validation.js";

package/types/booking/core/src/locale.d.ts

@@ -0,0 +1,113 @@
+import type { BookingLocale } from "./types.js";
+export type BookingDirection = "ltr" | "rtl";
+export interface BookingCopy {
+    addressLine1: string;
+    anyPractitioner: string;
+    anyPractitionerDescription: string;
+    appointmentSummary: string;
+    appointmentTitle: string;
+    back: string;
+    balance: string;
+    bookAgain: string;
+    bookingDisabled: string;
+    bookingFailed: string;
+    bookingUnavailableDescription: string;
+    bookingUnavailableTitle: string;
+    callPractice: string;
+    cancelPayment: string;
+    checkingPayment: string;
+    checkPayment: string;
+    chooseAnotherDate: string;
+    chooseDate: string;
+    chooseDateTime: string;
+    chooseDoctor: string;
+    chooseService: string;
+    chooseTime: string;
+    chooseTreatment: string;
+    clinic: string;
+    close: string;
+    codeExpired: string;
+    codeExpiresIn: string;
+    confirmationDescription: string;
+    confirmCode: string;
+    confirmed: string;
+    contactPractice: string;
+    contactSite: string;
+    continue: string;
+    dateOfBirth: string;
+    deposit: string;
+    email: string;
+    existingPatient: string;
+    existingPatientDescription: string;
+    findPatientRecord: string;
+    firstName: string;
+    fullName: string;
+    gender: string;
+    genderOptions: {
+        female: string;
+        male: string;
+        other: string;
+        preferNotToSay: string;
+    };
+    genderPlaceholder: string;
+    goBackAndEdit: string;
+    identityUnavailable: string;
+    identityUnavailableDescription: string;
+    invalidInput: string;
+    lastName: string;
+    loadingSlots: string;
+    loginTitle: string;
+    marketingOptIn: string;
+    newPatient: string;
+    newPatientDescription: string;
+    noDoctors: string;
+    noMatchingServices: string;
+    noServices: string;
+    noSlots: string;
+    noTreatments: string;
+    otpCode: string;
+    otpDescription: string;
+    otpSent: string;
+    patientDetails: string;
+    patientDetailsRequired: string;
+    patientNoMatch: string;
+    patientNoMatchDescription: string;
+    paymentAtPractice: string;
+    paymentExpired: string;
+    paymentPending: string;
+    paymentReceived: string;
+    paymentStatusUnavailable: string;
+    payWithStripe: string;
+    pendingConfirmation: string;
+    phone: string;
+    phoneCountry: string;
+    phoneCountryCodeHint: string;
+    postcode: string;
+    practitionerDescription: string;
+    preparingPayment: string;
+    price: string;
+    registeredQuestion: string;
+    requestCode: string;
+    resendCode: string;
+    resendCodeIn: string;
+    retry: string;
+    reviewPayment: string;
+    searchServices: string;
+    selectDateFirst: string;
+    serviceDescription: string;
+    slotsLoadFailed: string;
+    somethingElse: string;
+    submit: string;
+    submitting: string;
+    title: string;
+    titleLabel: string;
+    titlePlaceholder: string;
+    total: string;
+    treatmentDescription: string;
+    verificationReminders: string;
+    verifyPhone: string;
+    yourDetails: string;
+}
+export declare function resolveLocale(locale?: BookingLocale): string;
+export declare function getLocaleDirection(locale?: BookingLocale): BookingDirection;
+export declare function getBookingCopy(locale?: BookingLocale): BookingCopy;

package/types/booking/core/src/timezone.d.ts

@@ -0,0 +1,10 @@
+import type { BookingLocale } from "./types.js";
+export interface FormatDateTimeOptions {
+    locale?: BookingLocale;
+    timeZone: string;
+}
+export declare function formatBookingDateTime(value: Date | string, options: FormatDateTimeOptions): string;
+export declare function formatBookingDate(value: Date | string, options: FormatDateTimeOptions): string;
+export declare function formatBookingTime(value: Date | string, options: FormatDateTimeOptions): string;
+export declare function getDateKeyInTimeZone(value: Date | string, timeZone: string): string;
+export declare function addCalendarDays(dateKey: string, days: number): string;

package/types/booking/core/src/types.d.ts

@@ -0,0 +1,135 @@
+export type BookingLocale = string;
+export interface BookingTheme {
+    accentColor?: string;
+    colorMode?: "dark" | "light";
+    radius?: string;
+}
+export interface BookingDoctor {
+    avatarUrl?: string | null;
+    displayName: string;
+    id: string;
+    specialty?: string | null;
+}
+export interface BookingService {
+    description?: string | null;
+    id: string;
+    name: string;
+}
+export interface BookingTreatment {
+    currencyCode: string;
+    currencySymbol?: string | null;
+    deposit?: number | null;
+    description?: string | null;
+    durationMinutes: number;
+    id: string;
+    name: string;
+    price: number;
+    serviceId: string;
+}
+export interface BookingConfig {
+    doctors: BookingDoctor[];
+    enabled: boolean;
+    locale: BookingLocale;
+    services: BookingService[];
+    siteAddress?: string | null;
+    siteLogoUrl?: string | null;
+    siteName?: string | null;
+    sitePhone?: string | null;
+    theme?: BookingTheme | null;
+    timeZone: string;
+    treatments: BookingTreatment[];
+}
+export interface BookingSlot {
+    available: boolean;
+    doctorId: string;
+    doctorName?: string | null;
+    end: string;
+    id: string;
+    start: string;
+}
+export interface BookingContact {
+    address?: string;
+    email: string;
+    firstName?: string;
+    fullName: string;
+    lastName?: string;
+    marketingOptIn?: boolean;
+    phone: string;
+    postalCode?: string;
+    title?: string;
+}
+export interface PatientDetails {
+    dateOfBirth: string;
+    gender: string;
+}
+export interface CreateBookingInput {
+    bookingMode: "existing" | "new";
+    checkoutRequestId?: string;
+    contact: BookingContact;
+    doctorId: string;
+    end: string;
+    patientDetails: PatientDetails;
+    start: string;
+    treatmentId: string;
+    verificationCode: string;
+}
+export interface RequestBookingVerificationInput {
+    bookingMode?: "existing" | "new";
+    identity?: {
+        firstName: string;
+        lastName: string;
+        dateOfBirth: string;
+    };
+    phone: string;
+}
+export interface RequestBookingVerificationResult {
+    cooldownSeconds: number;
+    expiresInSeconds: number;
+    is_patient_found?: boolean;
+}
+export interface VerifyBookingCodeInput {
+    bookingMode?: "existing" | "new";
+    code: string;
+    identity?: {
+        firstName: string;
+        lastName: string;
+        dateOfBirth: string;
+    };
+    phone: string;
+}
+export interface VerifyBookingCodeResult {
+    patientMatched?: boolean;
+    sessionExpiresInSeconds?: number;
+    sessionToken?: string;
+    verified: boolean;
+}
+export interface BookingResult {
+    checkout?: {
+        sessionId: string;
+        url: string;
+        amount: number;
+        price: number;
+        currency: string;
+    };
+    payment?: {
+        price: number;
+        currency: string;
+    };
+    scheduledEnd: string;
+    scheduledStart: string;
+    status: "pending" | "confirmed";
+    treatmentName?: string;
+}
+export interface GetSlotsInput {
+    date: string;
+    doctorId?: string;
+    fromDate?: string;
+    signal?: AbortSignal;
+    toDate?: string;
+    treatmentId: string;
+}
+export interface BookingClientOptions {
+    baseUrl: string;
+    fetcher?: typeof fetch;
+    publishableKey: string;
+}

package/types/booking/core/src/validation.d.ts

@@ -0,0 +1,9 @@
+import type { BookingContact, PatientDetails } from "./types.js";
+export declare function normalizeEmail(value: string): string;
+export declare function normalizePhone(value: string): string;
+export declare function isLikelyE164(value: string): boolean;
+export declare function validateContact(contact: BookingContact): string | null;
+export declare function validateExistingPhone(phone: string): string | null;
+export declare function validateVerificationCode(code: string): string | null;
+export declare function isValidPastDateOfBirth(value: string): boolean;
+export declare function validatePatientDetails(details?: PatientDetails): string | null;