@blazeo.com/appointment-client 1.0.6 → 1.0.8

package/src/calendar/fetchCalendarWithOpeningHours.ts

@@ -1,99 +1,130 @@
-import { CalendarModel } from "@blazeo.com/calendar-client";
-import { getSnapshot } from "mobx-state-tree";
-
-/**
- * Unwrap nested REST shapes: `res.data`, `res.Data`, or `res.data.data`.
- */
-export function unwrapCalendarGetData(res: any) {
-  if (res == null || typeof res !== "object") return null;
-  let d = res.data ?? res.Data;
-  if (d == null) return null;
-  if (typeof d === "object" && (d.data != null || d.Data != null)) {
-    d = d.data ?? d.Data;
-  }
-  return d;
-}
-
-/** `openingHours` / `OpeningHours` on the calendar object returned by GET /Calendar/
- * Robustly picks opening hours array from a raw calendar payload.
- */
-export function pickOpeningHoursArrayFromCalendarPayload(data: any) {
-  if (data == null) return null;
-  const { list } = normalizeParticipantOpeningHoursResponse(data);
-  return list;
-}
-
-/**
- * Normalize `calendar.getParticipantOpeningHours()` response (`GET /Calendar/Participant/OpeningHours/Get`).
- * Supports various Blazeo API shapes including nested data and common property names.
- */
-export function normalizeParticipantOpeningHoursResponse(res: any) {
-  if (res == null) return { list: null, raw: res };
-
-  // 1. Check for standard envelope: res.data or res.Data
-  let d = res.data ?? res.Data ?? res;
-
-  // 2. Handle double-nested data (common in some Blazeo API versions)
-  if (d && typeof d === "object" && !Array.isArray(d)) {
-    if (d.data !== undefined) d = d.data;
-    else if (d.Data !== undefined) d = d.Data;
-  }
-
-  // 3. If d is now an array, that's our list
-  if (Array.isArray(d)) return { list: d, raw: res };
-
-  // 4. Otherwise check for known list properties on the object
-  if (d && typeof d === "object") {
-    const list =
-      d.openingHours ??
-      d.OpeningHours ??
-      d.participantOpeningHours ??
-      d.ParticipantOpeningHours ??
-      d.rows ??
-      d.Rows ??
-      d.items ??
-      d.Items ??
-      d.list ??
-      d.List;
-    if (Array.isArray(list)) return { list, raw: res };
-  }
-
-  return { list: null, raw: res };
-}
-
-/**
- * Loads `CalendarModel` and attaches **`openingHours`** to the MST snapshot:
- * 1. Prefer rows embedded on **GET /Calendar/Get** (`CalendarModel.getRaw` payload — `@blazeo.com/calendar-client` MST omits them).
- * 2. If missing/empty, calls **`calendar.getParticipantOpeningHours()`** (`GET /Calendar/Participant/OpeningHours/Get`).
- */
-export async function fetchCalendarWithOpeningHours(calendarId: string, options: any = {}) {
-  const { includeRawGet = false } = options;
-  const rawRes: any = await (CalendarModel as any).getRaw(calendarId);
-  const cal: any = await CalendarModel.get(calendarId);
-  const payload = unwrapCalendarGetData(rawRes);
-  const embedded = pickOpeningHoursArrayFromCalendarPayload(payload) ?? [];
-  let resolved = embedded.length > 0 ? embedded : null;
-  let participantRes: any = null;
-
-  if ((resolved == null || resolved.length === 0) && cal != null) {
-    // Pass calendarId explicitly because some server shapes do not populate `self.calendarId` on the MST model.
-    participantRes = await cal.getParticipantOpeningHours({ calendarId });
-    const { list } = normalizeParticipantOpeningHoursResponse(participantRes);
-    if (list != null && list.length > 0) resolved = list;
-  }
-
-  const openingHours = Array.isArray(resolved) ? resolved : [];
-  const snap = cal != null ? getSnapshot(cal) : null;
-  const calendar = snap != null ? { ...(snap as any), openingHours } : null;
-
-  return {
-    calendar,
-    cal,
-    openingHours,
-    embeddedFromGet: embedded,
-    fromCalendarGet: embedded.length > 0,
-    fromParticipantApi: embedded.length === 0 && openingHours.length > 0 && participantRes != null,
-    participantOpeningHoursResponse: participantRes,
-    ...(includeRawGet ? { rawGet: rawRes } : {}),
-  };
-}
+import { CalendarModel } from "@blazeo.com/calendar-client";
+import { getSnapshot } from "mobx-state-tree";
+import { resolveBlazeoConnection } from "./createCalendar.js";
+import { ensureBlazeoHttpReady } from "../config/ensureBlazeoHttpReady.js";
+import { mapToDesiredCalendarResponse } from "./mapToDesiredResponse.js";
+
+/**
+ * Unwrap nested REST shapes: `res.data`, `res.Data`, or `res.data.data`.
+ */
+export function unwrapCalendarGetData(res: any) {
+  if (res == null || typeof res !== "object") return null;
+  let d = res.data ?? res.Data;
+  if (d == null) return null;
+  if (typeof d === "object" && (d.data != null || d.Data != null)) {
+    d = d.data ?? d.Data;
+  }
+  return d;
+}
+
+/** `openingHours` / `OpeningHours` on the calendar object returned by GET /Calendar/
+ * Robustly picks opening hours array from a raw calendar payload.
+ */
+export function pickOpeningHoursArrayFromCalendarPayload(data: any) {
+  if (data == null) return null;
+  const { list } = normalizeParticipantOpeningHoursResponse(data);
+  return list;
+}
+
+/**
+ * Normalize `calendar.getParticipantOpeningHours()` response (`GET /Calendar/Participant/OpeningHours/Get`).
+ * Supports various Blazeo API shapes including nested data and common property names.
+ */
+export function normalizeParticipantOpeningHoursResponse(res: any) {
+  if (res == null) return { list: null, raw: res };
+
+  // 1. Check for standard envelope: res.data or res.Data
+  let d = res.data ?? res.Data ?? res;
+
+  // 2. Handle double-nested data (common in some Blazeo API versions)
+  if (d && typeof d === "object" && !Array.isArray(d)) {
+    if (d.data !== undefined) d = d.data;
+    else if (d.Data !== undefined) d = d.Data;
+  }
+
+  // 3. If d is now an array, that's our list
+  if (Array.isArray(d)) return { list: d, raw: res };
+
+  // 4. Otherwise check for known list properties on the object
+  if (d && typeof d === "object") {
+    const list =
+      d.openingHours ??
+      d.OpeningHours ??
+      d.participantOpeningHours ??
+      d.ParticipantOpeningHours ??
+      d.rows ??
+      d.Rows ??
+      d.items ??
+      d.Items ??
+      d.list ??
+      d.List;
+    if (Array.isArray(list)) return { list, raw: res };
+  }
+
+  return { list: null, raw: res };
+}
+
+/**
+ * Loads `CalendarModel` and attaches **`openingHours`** to the MST snapshot:
+ * 1. Prefer rows embedded on **GET /Calendar/Get** (`CalendarModel.getRaw` payload — `@blazeo.com/calendar-client` MST omits them).
+ * 2. If missing/empty, calls **`calendar.getParticipantOpeningHours()`** (`GET /Calendar/Participant/OpeningHours/Get`).
+ */
+export async function fetchCalendarWithOpeningHours(calendarId: string, options: any = {}) {
+  const { includeRawGet = false, baseUrl, consumer } = options;
+
+  const { baseUrl: resolvedBase, consumer: resolvedConsumer } = resolveBlazeoConnection({ baseUrl, consumer });
+  const rawRes = await (CalendarModel as any).getRaw(calendarId);
+  const payload = unwrapCalendarGetData(rawRes);
+
+  let cal: any = null;
+  if (payload) {
+    // Manually create the model instance to fix a bug in calendar-client static get.
+    cal = (CalendarModel as any).create(
+      { ...payload, calendarId },
+      { baseUrl: resolvedBase, consumer: resolvedConsumer }
+    );
+  }
+
+  if (cal == null) {
+    return {
+      calendar: null,
+      openingHours: [],
+      raw: rawRes,
+      meta: { ok: false as const, reason: "calendar_not_found" },
+    };
+  }
+
+  const embedded = pickOpeningHoursArrayFromCalendarPayload(payload) ?? [];
+  let resolved = embedded.length > 0 ? embedded : null;
+  let participantRes: any = null;
+
+  if ((resolved == null || resolved.length === 0) && cal != null) {
+    // Pass calendarId explicitly because some server shapes do not populate `self.calendarId` on the MST model.
+    participantRes = await cal.getParticipantOpeningHours({ calendarId });
+    const { list } = normalizeParticipantOpeningHoursResponse(participantRes);
+    if (list != null && list.length > 0) resolved = list;
+  }
+
+  const openingHours = Array.isArray(resolved) ? resolved : [];
+  const mappedOpeningHours = openingHours.map(oh => ({
+    ...oh,
+  }));
+
+  const rawMembers = payload?.members ?? payload?.Members ?? payload?.participants ?? payload?.Participants;
+  const mappedMembers = Array.isArray(rawMembers) 
+    ? rawMembers.map((m: any) => ({ ...m }))
+    : [];
+
+  const calendar = mapToDesiredCalendarResponse(payload, openingHours, mappedMembers);
+
+  if (!calendar) return null as any;
+
+  Object.defineProperties(calendar, {
+    _cal: { value: cal, enumerable: false },
+    _openingHours: { value: openingHours, enumerable: false },
+    _embeddedFromGet: { value: embedded, enumerable: false },
+    _rawGet: { value: rawRes, enumerable: false },
+  });
+
+  return calendar as any;
+}

package/src/calendar/getAllParticipantOpeningHours.ts

@@ -1,11 +1,19 @@
 import { CalendarModel } from "@blazeo.com/calendar-client";
+import { ensureBlazeoHttpReady } from "../config/ensureBlazeoHttpReady.js";
 import { normalizeParticipantOpeningHoursResponse } from "./fetchCalendarWithOpeningHours.js";
 
 /**
  * Fetch all participant opening hours for a calendar.
  * Uses `GET /Calendar/Participant/OpeningHours/All/Get`.
  */
-export async function getAllParticipantOpeningHours(calendarId: string) {
+export async function getAllParticipantOpeningHours(
+  calendarId: string,
+  options: { baseUrl?: string; consumer?: string } = {}
+) {
+  const ready = ensureBlazeoHttpReady(options);
+  if (!ready.ok) {
+    throw new Error(ready.error);
+  }
   const raw: any = await (CalendarModel as any).getAllParticipantOpeningHours(calendarId);
 
   // calendar-client static helper returns either `unknown[] | null` or an envelope depending on version/entrypoint.

package/src/calendar/getOpeningHours.ts

@@ -4,7 +4,7 @@ import { fetchCalendarWithOpeningHours } from "./fetchCalendarWithOpeningHours.j
  * Fetches opening hours for a calendar.
  * Automatically handles embedded calendar-level hours and participant-level fallbacks.
  */
-export async function getOpeningHours(calendarId: string) {
-  const result = await fetchCalendarWithOpeningHours(calendarId);
+export async function getOpeningHours(calendarId: string, options: { baseUrl?: string; consumer?: string } = {}) {
+  const result = await fetchCalendarWithOpeningHours(calendarId, options);
   return result.openingHours;
 }

package/src/calendar/getParticipantOpeningHours.ts

@@ -1,5 +1,6 @@
 import { CalendarModel } from "@blazeo.com/calendar-client";
-import { normalizeParticipantOpeningHoursResponse } from "./fetchCalendarWithOpeningHours.js";
+import { resolveBlazeoConnection } from "./createCalendar.js";
+import { unwrapCalendarGetData, normalizeParticipantOpeningHoursResponse } from "./fetchCalendarWithOpeningHours.js";
 
 /**
  * Direct wrapper around `calendar.getParticipantOpeningHours()` for a calendar id.
@@ -9,8 +10,12 @@ import { normalizeParticipantOpeningHoursResponse } from "./fetchCalendarWithOpe
  */
 export async function getParticipantOpeningHours(calendarId: string, options: any = {}) {
   try {
-    const cal: any = await CalendarModel.get(calendarId);
-    if (cal == null) {
+    const { baseUrl, consumer, ...passThrough } = options;
+    const { baseUrl: resolvedBase, consumer: resolvedConsumer } = resolveBlazeoConnection({ baseUrl, consumer });
+    const rawRes = await (CalendarModel as any).getRaw(calendarId);
+    const payload = unwrapCalendarGetData(rawRes);
+
+    if (!payload) {
       return {
         openingHours: [] as any[],
         raw: null as any,
@@ -18,7 +23,12 @@ export async function getParticipantOpeningHours(calendarId: string, options: an
       };
     }
 
-    const raw = await cal.getParticipantOpeningHours({ calendarId, ...(options ?? {}) });
+    const cal = (CalendarModel as any).create(
+      { ...payload, calendarId },
+      { baseUrl: resolvedBase, consumer: resolvedConsumer }
+    );
+
+    const raw = await cal.getParticipantOpeningHours({ calendarId, ...(passThrough ?? {}) });
     const { list } = normalizeParticipantOpeningHoursResponse(raw);
     const openingHours = Array.isArray(list) ? list : [];
 
@@ -43,4 +53,3 @@ export async function getParticipantOpeningHours(calendarId: string, options: an
     };
   }
 }
-

package/src/calendar/getParticipants.ts

@@ -1,9 +1,17 @@
 import { CalendarModel } from "@blazeo.com/calendar-client";
+import { ensureBlazeoHttpReady } from "../config/ensureBlazeoHttpReady.js";
 
 /**
  * Fetches participants for a calendar.
  */
-export async function getParticipants(calendarId: string) {
+export async function getParticipants(
+  calendarId: string,
+  options: { baseUrl?: string; consumer?: string } = {}
+) {
+  const ready = ensureBlazeoHttpReady(options);
+  if (!ready.ok) {
+    throw new Error(ready.error);
+  }
   const participants = await CalendarModel.getParticipants(calendarId);
   return Array.isArray(participants) ? participants : [];
 }

package/src/calendar/mapToDesiredResponse.ts

@@ -0,0 +1,104 @@
+/**
+ * Maps a raw Blazeo API calendar payload (often PascalCase) to the specific camelCase 
+ * shape requested by the user, including typenames and normalized fields.
+ */
+export function mapToDesiredCalendarResponse(payload: any, openingHours: any[] = [], members: any[] = []) {
+  if (!payload) return null;
+
+  const pick = (obj: any, ...keys: string[]) => {
+    for (const k of keys) {
+      if (obj[k] !== undefined && obj[k] !== null) return obj[k];
+    }
+    return undefined;
+  };
+
+  const n = (v: any) => (v != null && v !== "" ? Number(v) : null);
+
+  // Map members with typename
+  const mappedMembers = members.map(m => ({
+    id: m.id ?? pick(m, "id", "Id"),
+    name: m.name ?? pick(m, "name", "Name", "alias", "Alias"),
+    email: m.email ?? pick(m, "email", "Email") ?? null,
+    status: m.status ?? pick(m, "status", "Status") ?? 0,
+    __typename: "Member"
+  }));
+
+  // Map opening hours with typename and raw fields
+  const mappedOpeningHours = openingHours.map(oh => ({
+    id: pick(oh, "id", "Id") ?? 0,
+    createdOn: pick(oh, "createdOn", "CreatedOn", "created_on") ?? "0001-01-01T00:00:00.000Z",
+    modifiedOn: pick(oh, "modifiedOn", "ModifiedOn", "modified_on") ?? "0001-01-01T00:00:00.000Z",
+    member: pick(oh, "member", "Member"),
+    openingHourId: pick(oh, "openingHourId", "OpeningHourId", "opening_hour_id") ?? "",
+    calendarId: pick(oh, "calendarId", "CalendarId", "calendar_id") ?? "",
+    participantId: pick(oh, "participantId", "ParticipantId", "participant_id") ?? "",
+    days: oh.days ?? [],
+    startHour: oh.startHour ?? pick(oh, "startHour", "StartHour") ?? 0,
+    startMinute: oh.startMinute ?? pick(oh, "startMinute", "StartMinute") ?? 0,
+    endHour: oh.endHour ?? pick(oh, "endHour", "EndHour") ?? 0,
+    endMinute: oh.endMinute ?? pick(oh, "endMinute", "EndMinute") ?? 0,
+    off: !!(oh.off ?? pick(oh, "off", "Off")),
+    __typename: "OpeningHour"
+  }));
+
+  // Map theme
+  const rawTheme = pick(payload, "theme", "Theme");
+  const theme = rawTheme ? {
+    id: pick(rawTheme, "id", "Id"),
+    color: pick(rawTheme, "color", "Color"),
+    logoUrl: pick(rawTheme, "logoUrl", "LogoUrl") ?? null,
+    __typename: "Theme"
+  } : null;
+
+  // Map reminders
+  const rawReminders = pick(payload, "reminderChannelStatuses", "ReminderChannelStatuses") ?? [];
+  const reminderChannelStatuses = Array.isArray(rawReminders) ? rawReminders.map((r: any) => ({
+    id: pick(r, "id", "Id"),
+    calendarId: pick(r, "calendarId", "CalendarId"),
+    channelId: pick(r, "channelId", "ChannelId"),
+    status: !!pick(r, "status", "Status"),
+    appointmentReminders: (pick(r, "appointmentReminders", "AppointmentReminders") ?? []).map((ar: any) => ({
+      id: pick(ar, "id", "Id"),
+      reminderChannelStatusId: pick(ar, "reminderChannelStatusId", "ReminderChannelStatusId"),
+      recipientType: pick(ar, "recipientType", "RecipientType"),
+      beforeEventTime: pick(ar, "beforeEventTime", "BeforeEventTime"),
+      unit: pick(ar, "unit", "Unit"),
+      __typename: "AppointmentReminder"
+    })),
+    __typename: "ReminderChannelStatus"
+  })) : [];
+
+  return {
+    id: n(pick(payload, "id", "Id")),
+    durationUnit: n(pick(payload, "durationUnit", "DurationUnit")),
+    minimumBookingNotice: n(pick(payload, "minimumBookingNotice", "MinimumBookingNotice")),
+    minimumBookingNoticeUnit: n(pick(payload, "minimumBookingNoticeUnit", "MinimumBookingNoticeUnit")),
+    minimumCancelationNotice: n(pick(payload, "minimumCancelationNotice", "MinimumCancelationNotice")),
+    minimumCancelationNoticeUnit: n(pick(payload, "minimumCancelationNoticeUnit", "MinimumCancelationNoticeUnit")),
+    futureLimit: n(pick(payload, "futureLimit", "FutureLimit")),
+    futureLimitUnit: n(pick(payload, "futureLimitUnit", "FutureLimitUnit")),
+    bufferTime: n(pick(payload, "bufferTime", "BufferTime")),
+    bufferTimeUnit: n(pick(payload, "bufferTimeUnit", "BufferTimeUnit")),
+    calendarLink: pick(payload, "calendarLink", "CalendarLink"),
+    uuid: pick(payload, "uuid", "Uuid", "calendarId", "CalendarId"),
+    location: pick(payload, "location", "Location") ?? "",
+    bookingPageTitle: pick(payload, "bookingPageTitle", "BookingPageTitle") ?? null,
+    reminderChannelStatuses,
+    members: mappedMembers,
+    createdOn: pick(payload, "createdOn", "CreatedOn") ?? "0001-01-01T00:00:00.000Z",
+    modifiedOn: pick(payload, "modifiedOn", "ModifiedOn") ?? "0001-01-01T00:00:00.000Z",
+    name: pick(payload, "name", "Name"),
+    timeZoneId: pick(payload, "timeZoneId", "TimeZoneId"),
+    description: pick(payload, "description", "Description") ?? "",
+    assignmentType: n(pick(payload, "assignmentType", "AssignmentType", "assignmentMethod", "AssignmentMethod")),
+    duration: n(pick(payload, "duration", "Duration")),
+    bookingLimit: n(pick(payload, "bookingLimit", "BookingLimit")),
+    calendarJson: pick(payload, "calendarJson", "CalendarJson") ?? null,
+    isThirdPartySaved: !!pick(payload, "isThirdPartySaved", "IsThirdPartySaved"),
+    themeId: n(pick(payload, "themeId", "ThemeId")),
+    theme,
+    openingHours: mappedOpeningHours,
+    appointmentUserDefinedFields: pick(payload, "appointmentUserDefinedFields", "AppointmentUserDefinedFields") ?? [],
+    __typename: "Calendar"
+  };
+}

package/src/config/applyBlazeoDefaults.ts

@@ -1,12 +1,13 @@
-import { configure } from "@blazeo.com/calendar-client";
 import { blazeoClientConfig } from "./blazeoClientDefaults.js";
+import { syncBlazeoConnection } from "./syncBlazeoConnection.js";
 
 /** Push {@link blazeoClientConfig} into `@blazeo.com/calendar-client` (global store). Call explicitly if you use file defaults; otherwise use {@link initializeAppointmentClient}. */
 export function applyBlazeoClientConfig() {
+  debugger;
   const baseUrl = blazeoClientConfig.baseUrl?.trim().replace(/\/+$/, "");
   if (!baseUrl) return;
   const consumer = blazeoClientConfig.consumer?.trim();
-  configure({
+  syncBlazeoConnection({
     baseUrl,
     ...(consumer ? { consumer } : {}),
   });

package/src/config/blazeoClientDefaults.ts

@@ -6,6 +6,6 @@
  * @example baseUrl: "https://apptscheduling.azurewebsites.net"
  */
 export const blazeoClientConfig = {
-  baseUrl: "",
-  consumer: "",
+  baseUrl: "https://apptscheduling.azurewebsites.net",
+  consumer: "smarthub",
 };

package/src/config/ensureBlazeoHttpReady.ts

@@ -0,0 +1,41 @@
+import { configure } from "@blazeo.com/calendar-client";
+import { resolveBlazeoConnection } from "../calendar/createCalendar.js";
+
+export type EnsureBlazeoHttpOptions = {
+  baseUrl?: string;
+  consumer?: string;
+};
+
+/**
+ * Ensures global Blazeo `configure({ baseUrl })` runs before any `CalendarModel` / `EventModel` HTTP.
+ * Uses the same resolution as {@link resolveBlazeoConnection}: explicit args, existing `getConfig()`,
+ * then `blazeoClientDefaults` — so file defaults apply even if the host never called `configure`.
+ */
+export function ensureBlazeoHttpReady(options: EnsureBlazeoHttpOptions = {}):
+  | { ok: true; baseUrl: string; consumer?: string }
+  | { ok: false; error: string } {
+  // Hard-prefer explicit args (call-site can bypass any module-resolution mismatch).
+  const explicitBase = options.baseUrl?.trim().replace(/\/+$/, "");
+  const explicitConsumer = options.consumer?.trim() || undefined;
+  if (explicitBase) {
+    configure({
+      baseUrl: explicitBase,
+      ...(explicitConsumer ? { consumer: explicitConsumer } : {}),
+    });
+    return { ok: true, baseUrl: explicitBase, ...(explicitConsumer ? { consumer: explicitConsumer } : {}) };
+  }
+
+  const { baseUrl, consumer } = resolveBlazeoConnection(options);
+  if (!baseUrl) {
+    return {
+      ok: false,
+      error:
+        "Blazeo base URL is not set. Call initializeAppointmentClient({ baseUrl }) or configure({ baseUrl }) at app startup, set blazeoClientConfig.baseUrl, or pass baseUrl when calling fetch APIs.",
+    };
+  }
+  configure({
+    baseUrl,
+    ...(consumer ? { consumer } : {}),
+  });
+  return { ok: true, baseUrl, ...(consumer ? { consumer } : {}) };
+}

package/src/config/initializeAppointmentClient.ts

@@ -1,4 +1,5 @@
-import { configure, getConfig } from "@blazeo.com/calendar-client";
+import { getConfig } from "@blazeo.com/calendar-client";
+import { syncBlazeoConnection } from "./syncBlazeoConnection.js";
 
 export interface AppointmentClientConfig {
   baseUrl: string;
@@ -8,9 +9,14 @@ export interface AppointmentClientConfig {
 
 let isConfigured = false;
 
+/**
+ * Applies Blazeo connection (same as {@link syncBlazeoConnection}) and marks the client as configured
+ * when a non-empty `baseUrl` was written to `@blazeo.com/calendar-client`.
+ */
 export function initializeAppointmentClient(config: AppointmentClientConfig) {
-  configure(config);
-  isConfigured = true;
+  if (syncBlazeoConnection(config)) {
+    isConfigured = true;
+  }
 }
 
 export function isAppointmentClientConfigured() {

package/src/config/syncBlazeoConnection.ts

@@ -0,0 +1,19 @@
+import { configure } from "@blazeo.com/calendar-client";
+import type { AppointmentClientConfig } from "./initializeAppointmentClient.js";
+
+/**
+ * Writes `baseUrl` / `consumer` into the global `@blazeo.com/calendar-client` `configure()` store.
+ * Returns whether anything was applied (skipped when `baseUrl` is empty after trim).
+ */
+export function syncBlazeoConnection(config: AppointmentClientConfig): boolean {
+  const baseUrl = config.baseUrl?.trim().replace(/\/+$/, "");
+  if (!baseUrl) return false;
+  configure({
+    baseUrl,
+    ...(config.consumer != null && String(config.consumer).trim() !== ""
+      ? { consumer: String(config.consumer).trim() }
+      : {}),
+    ...(config.fetch ? { fetch: config.fetch } : {}),
+  });
+  return true;
+}

package/src/index.ts

@@ -1,6 +1,12 @@
 import { getExampleSlots } from "./exampleData.js";
 
-export { initializeAppointmentClient, isAppointmentClientConfigured } from "./config/initializeAppointmentClient.js";
+export {
+  initializeAppointmentClient,
+  isAppointmentClientConfigured,
+} from "./config/initializeAppointmentClient.js";
+export { syncBlazeoConnection } from "./config/syncBlazeoConnection.js";
+export { ensureBlazeoHttpReady } from "./config/ensureBlazeoHttpReady.js";
+export type { EnsureBlazeoHttpOptions } from "./config/ensureBlazeoHttpReady.js";
 export { blazeoClientConfig } from "./config/blazeoClientDefaults.js";
 export { applyBlazeoClientConfig } from "./config/applyBlazeoDefaults.js";
 export { createCalendarRoot, CalendarRootModel, CalendarSlotModel, EventModel, ParticipantModel } from "./models/CalendarRootModel.js";