@blazeo.com/appointment-client 1.0.6 → 1.0.8

package/dist/calendar/mapToDesiredResponse.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Maps a raw Blazeo API calendar payload (often PascalCase) to the specific camelCase
+ * shape requested by the user, including typenames and normalized fields.
+ */
+export declare function mapToDesiredCalendarResponse(payload: any, openingHours?: any[], members?: any[]): {
+    id: number | null;
+    durationUnit: number | null;
+    minimumBookingNotice: number | null;
+    minimumBookingNoticeUnit: number | null;
+    minimumCancelationNotice: number | null;
+    minimumCancelationNoticeUnit: number | null;
+    futureLimit: number | null;
+    futureLimitUnit: number | null;
+    bufferTime: number | null;
+    bufferTimeUnit: number | null;
+    calendarLink: any;
+    uuid: any;
+    location: any;
+    bookingPageTitle: any;
+    reminderChannelStatuses: {
+        id: any;
+        calendarId: any;
+        channelId: any;
+        status: boolean;
+        appointmentReminders: any;
+        __typename: string;
+    }[];
+    members: {
+        id: any;
+        name: any;
+        email: any;
+        status: any;
+        __typename: string;
+    }[];
+    createdOn: any;
+    modifiedOn: any;
+    name: any;
+    timeZoneId: any;
+    description: any;
+    assignmentType: number | null;
+    duration: number | null;
+    bookingLimit: number | null;
+    calendarJson: any;
+    isThirdPartySaved: boolean;
+    themeId: number | null;
+    theme: {
+        id: any;
+        color: any;
+        logoUrl: any;
+        __typename: string;
+    } | null;
+    openingHours: {
+        id: any;
+        createdOn: any;
+        modifiedOn: any;
+        member: any;
+        openingHourId: any;
+        calendarId: any;
+        participantId: any;
+        days: any;
+        startHour: any;
+        startMinute: any;
+        endHour: any;
+        endMinute: any;
+        off: boolean;
+        __typename: string;
+    }[];
+    appointmentUserDefinedFields: any;
+    __typename: string;
+} | null;

package/dist/calendar/mapToDesiredResponse.js

@@ -0,0 +1,99 @@
+/**
+ * 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, openingHours = [], members = []) {
+    if (!payload)
+        return null;
+    const pick = (obj, ...keys) => {
+        for (const k of keys) {
+            if (obj[k] !== undefined && obj[k] !== null)
+                return obj[k];
+        }
+        return undefined;
+    };
+    const n = (v) => (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) => ({
+        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) => ({
+            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/dist/config/applyBlazeoDefaults.js

@@ -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/dist/config/blazeoClientDefaults.js

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

package/dist/config/ensureBlazeoHttpReady.d.ts

@@ -0,0 +1,17 @@
+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 declare function ensureBlazeoHttpReady(options?: EnsureBlazeoHttpOptions): {
+    ok: true;
+    baseUrl: string;
+    consumer?: string;
+} | {
+    ok: false;
+    error: string;
+};

package/dist/config/ensureBlazeoHttpReady.js

@@ -0,0 +1,31 @@
+import { configure } from "@blazeo.com/calendar-client";
+import { resolveBlazeoConnection } from "../calendar/createCalendar.js";
+/**
+ * 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 = {}) {
+    // 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/dist/config/initializeAppointmentClient.d.ts

@@ -3,5 +3,9 @@ export interface AppointmentClientConfig {
     consumer?: string;
     fetch?: typeof fetch;
 }
+/**
+ * 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 declare function initializeAppointmentClient(config: AppointmentClientConfig): void;
 export declare function isAppointmentClientConfigured(): boolean;

package/dist/config/initializeAppointmentClient.js

@@ -1,8 +1,14 @@
-import { configure, getConfig } from "@blazeo.com/calendar-client";
+import { getConfig } from "@blazeo.com/calendar-client";
+import { syncBlazeoConnection } from "./syncBlazeoConnection.js";
 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) {
-    configure(config);
-    isConfigured = true;
+    if (syncBlazeoConnection(config)) {
+        isConfigured = true;
+    }
 }
 export function isAppointmentClientConfigured() {
     return isConfigured || getConfig() !== null;

package/dist/config/syncBlazeoConnection.d.ts

@@ -0,0 +1,6 @@
+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 declare function syncBlazeoConnection(config: AppointmentClientConfig): boolean;

package/dist/config/syncBlazeoConnection.js

@@ -0,0 +1,18 @@
+import { configure } from "@blazeo.com/calendar-client";
+/**
+ * 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) {
+    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/dist/index.d.ts

@@ -1,4 +1,7 @@
-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";

package/dist/index.js

@@ -1,5 +1,7 @@
 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 { blazeoClientConfig } from "./config/blazeoClientDefaults.js";
 export { applyBlazeoClientConfig } from "./config/applyBlazeoDefaults.js";
 export { createCalendarRoot, CalendarRootModel, CalendarSlotModel, EventModel, ParticipantModel } from "./models/CalendarRootModel.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazeo.com/appointment-client",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "publishConfig": {
     "access": "public"
   },

package/sample/.env.example

@@ -0,0 +1,5 @@
+# Copy to `.env` or `.env.local` in this folder and set your API host (no trailing slash).
+# Vite exposes only vars prefixed with VITE_ to the browser.
+VITE_BLAZEO_BASE_URL=https://your-blazeo-api.example.com
+# Optional, if your tenant uses it:
+# VITE_BLAZEO_CONSUMER=

package/sample/package-lock.json

@@ -6,6 +6,7 @@
     "": {
       "name": "appointment-client-sample",
       "dependencies": {
+        "@blazeo.com/appointment-client": "file:../blazeo.com-appointment-client-1.0.7.tgz",
         "appointment-client": "file:..",
         "react": "^19.0.0",
         "react-dom": "^19.0.0"
@@ -17,7 +18,7 @@
     },
     "..": {
       "name": "@blazeo.com/appointment-client",
-      "version": "1.0.5",
+      "version": "1.0.7",
       "dependencies": {
         "@blazeo.com/calendar-client": "^1.0.18",
         "mobx": "^6.13.7",
@@ -319,6 +320,38 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@blazeo.com/appointment-client": {
+      "version": "1.0.7",
+      "resolved": "file:../blazeo.com-appointment-client-1.0.7.tgz",
+      "integrity": "sha512-b2E5TIdxvNJLH3oEvCQngDhzQ08iwXNolPcok3emAlGipO0f8iGDij5hnVUntt68c2Lr3IPz3cvr/BcUY6MofQ==",
+      "dependencies": {
+        "@blazeo.com/calendar-client": "^1.0.18",
+        "mobx": "^6.13.7",
+        "mobx-state-tree": "^7.0.2"
+      }
+    },
+    "node_modules/@blazeo.com/calendar-client": {
+      "version": "1.0.18",
+      "resolved": "https://registry.npmjs.org/@blazeo.com/calendar-client/-/calendar-client-1.0.18.tgz",
+      "integrity": "sha512-wHqOZKUAH4JDgsdwaktEG68H5YfArOW3LEouCXznIza4YqNrlkfdJEyqiwNf6KjY2nELi+s2tFM22/1MKaWf5Q==",
+      "license": "UNLICENSED",
+      "dependencies": {
+        "mobx": "^6.10.0",
+        "mobx-state-tree": "^5.4.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@blazeo.com/calendar-client/node_modules/mobx-state-tree": {
+      "version": "5.4.2",
+      "resolved": "https://registry.npmjs.org/mobx-state-tree/-/mobx-state-tree-5.4.2.tgz",
+      "integrity": "sha512-SGXAh2KCBQbWVcxeQbZEr5pchTgcfNZmGVRL2a2Me+pSMH98bZWXD6EOuuijbTGbc0hOoOsbab3JdwJyr+fW7Q==",
+      "license": "MIT",
+      "peerDependencies": {
+        "mobx": "^6.3.0"
+      }
+    },
     "node_modules/@esbuild/aix-ppc64": {
       "version": "0.25.12",
       "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.25.12.tgz",
@@ -1425,6 +1458,28 @@
         "yallist": "^3.0.2"
       }
     },
+    "node_modules/mobx": {
+      "version": "6.15.3",
+      "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.3.tgz",
+      "integrity": "sha512-6+ZSYDs5zgH5CdGfEU2q2Lsa5PztVryL1ys7kAImTU25n2A9LAMj/yneVsQpd03MfwMLDQF+7kakJR9Z+cQxSw==",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/mobx"
+      }
+    },
+    "node_modules/mobx-state-tree": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/mobx-state-tree/-/mobx-state-tree-7.2.0.tgz",
+      "integrity": "sha512-o46IsMI/lHITYCmkbQgNOCDT8M9Hd2WAgOlHt42hCg+XUZP21obF5ui5Vv9epIsQV8Wpp/GWNHu1YFhTx6iq0g==",
+      "license": "MIT",
+      "dependencies": {
+        "ts-essentials": "^9.4.1"
+      },
+      "peerDependencies": {
+        "mobx": "^6.3.0"
+      }
+    },
     "node_modules/ms": {
       "version": "2.1.3",
       "dev": true,
@@ -1598,6 +1653,20 @@
         "url": "https://github.com/sponsors/SuperchupuDev"
       }
     },
+    "node_modules/ts-essentials": {
+      "version": "9.4.2",
+      "resolved": "https://registry.npmjs.org/ts-essentials/-/ts-essentials-9.4.2.tgz",
+      "integrity": "sha512-mB/cDhOvD7pg3YCLk2rOtejHjjdSi9in/IBYE13S+8WA5FBSraYf4V/ws55uvs0IvQ/l0wBOlXy5yBNZ9Bl8ZQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "typescript": ">=4.1.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/update-browserslist-db": {
       "version": "1.2.3",
       "dev": true,

package/sample/package.json

@@ -10,6 +10,7 @@
     "participants:info": "node ./scripts/getInfoByCalendar.mjs"
   },
   "dependencies": {
+    "@blazeo.com/appointment-client": "file:../blazeo.com-appointment-client-1.0.7.tgz",
     "appointment-client": "file:..",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"

package/sample/src/AllParticipantOpeningHoursTab.jsx

@@ -1,9 +1,10 @@
 import { useState } from "react";
-import { getAllParticipantOpeningHours } from "appointment-client";
+import { ensureBlazeoHttpReady, getAllParticipantOpeningHours } from "appointment-client";
 import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
 
 export function AllParticipantOpeningHoursTab() {
-  const { effective } = useBlazeoConnection();
+  const { effective, connectionOpts } = useBlazeoConnection();
   const [calendarId, setCalendarId] = useState("");
   const [busy, setBusy] = useState(false);
   const [error, setError] = useState("");
@@ -18,12 +19,20 @@ export function AllParticipantOpeningHoursTab() {
     if (!effective.baseUrl) return setError("Set Base URL in the connection card above.");
 
     configureBlazeoFromEffective(effective);
+    ensureBlazeoHttpReady({
+      baseUrl: effective.baseUrl,
+      ...(effective.consumer ? { consumer: effective.consumer } : {}),
+    });
     setBusy(true);
     try {
-      const res = await getAllParticipantOpeningHours(id);
+      const res = await getAllParticipantOpeningHours(id, {
+        ...connectionOpts,
+        baseUrl: effective.baseUrl,
+        ...(effective.consumer ? { consumer: effective.consumer } : {}),
+      });
       setOutput(JSON.stringify(res, null, 2));
     } catch (err) {
-      setError(err instanceof Error ? err.message : String(err));
+      setError(mapBlazeoDemoError(err instanceof Error ? err.message : String(err)));
     } finally {
       setBusy(false);
     }

package/sample/src/App2.jsx

@@ -3,6 +3,7 @@ import {
   BlazeoConnectionProvider,
   useBlazeoConnection,
 } from "./BlazeoConnectionSettings.jsx";
+import { ensureBlazeoHttpReady, getConfig } from "appointment-client";
 import { CalendarTab } from "./CalendarTab.jsx";
 import { EventTab } from "./EventTab.jsx";
 import { ParticipantTab } from "./ParticipantTab.jsx";
@@ -35,14 +36,23 @@ function ConnectionSettingsCard() {
     setBaseUrlInput,
     setConsumerInput,
     effective,
+    connectionOpts,
   } = useBlazeoConnection();
 
+  const ready = ensureBlazeoHttpReady({
+    baseUrl: effective.baseUrl,
+    ...(effective.consumer ? { consumer: effective.consumer } : {}),
+  });
+  const cfg = getConfig?.() ?? null;
+
   return (
     <div className="card connection-card">
       <h2>Blazeo connection</h2>
       <p className="muted small">
         Values are saved in <code>localStorage</code>. Empty fields fall back to{" "}
-        <code>appointment-client/src/config/blazeoClientDefaults.ts</code>.
+        <code>appointment-client/src/config/blazeoClientDefaults.ts</code>. All tabs use the <strong>effective</strong> URL
+        here and run <code>pushBlazeoConnection</code> + <code>ensureBlazeoHttpReady</code> so calendar APIs receive{" "}
+        <code>baseUrl</code> from this card.
       </p>
       <p className="muted small">
         Effective:{" "}
@@ -54,6 +64,12 @@ function ConnectionSettingsCard() {
           </>
         ) : null}
       </p>
+      <p className="muted small">
+        Debug: <code>connectionOpts</code> → <code>{JSON.stringify(connectionOpts)}</code> ·{" "}
+        <code>ensureBlazeoHttpReady</code> →{" "}
+        <code>{ready.ok ? "ok" : "missing_base_url"}</code> · <code>getConfig().baseUrl</code> →{" "}
+        <code>{cfg?.baseUrl ?? "(null)"}</code>
+      </p>
       <div className="connection-card__row">
         <label className="form__label">
           <span>Base URL</span>
@@ -89,7 +105,11 @@ function AppShell() {
     <main className="page">
       <header className="header">
         <h1>appointment-client</h1>
-        <p className="muted">Browser sample — use tab <strong>Fetch · calendarView</strong> for the unified <code>calendarView</code> object.</p>
+        <p className="muted">
+          Browser sample — set <strong>Base URL</strong> in <strong>Blazeo connection</strong> below first; every tab uses
+          those values for <code>configure</code> + API calls. Tab <strong>Fetch · calendarView</strong> shows the unified{" "}
+          <code>calendarView</code> object.
+        </p>
       </header>
 
       <ConnectionSettingsCard />

package/sample/src/AvailabilityTab.jsx

@@ -1,6 +1,7 @@
 import { useMemo, useState } from "react";
-import { EventModel } from "appointment-client";
+import { ensureBlazeoHttpReady, EventModel } from "appointment-client";
 import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
 
 function parseYmd(ymd) {
   const t = (ymd ?? "").trim();
@@ -10,7 +11,7 @@ function parseYmd(ymd) {
 }
 
 export function AvailabilityTab() {
-  const { effective } = useBlazeoConnection();
+  const { effective, connectionOpts } = useBlazeoConnection();
   const [calendarId, setCalendarId] = useState("");
   const [date, setDate] = useState(() => new Date().toISOString().slice(0, 10));
   const [offsetMinutes, setOffsetMinutes] = useState(-new Date().getTimezoneOffset());
@@ -30,13 +31,17 @@ export function AvailabilityTab() {
     if (!parts) return setError("Pick a valid date.");
     if (!effective.baseUrl) return setError("Set Base URL above.");
     configureBlazeoFromEffective(effective);
+    ensureBlazeoHttpReady({
+      baseUrl: effective.baseUrl,
+      ...(effective.consumer ? { consumer: effective.consumer } : {}),
+    });
 
     setBusy(true);
     try {
       const list = await EventModel.getAvailability(id, parts.y, parts.m, parts.d, opts);
       setOutput(JSON.stringify(list.map((n) => n.toJSON?.() ?? n), null, 2));
     } catch (err) {
-      setError(err instanceof Error ? err.message : String(err));
+      setError(mapBlazeoDemoError(err instanceof Error ? err.message : String(err)));
     } finally {
       setBusy(false);
     }

package/sample/src/BlazeoConnectionSettings.jsx

@@ -6,8 +6,8 @@ import {
   useMemo,
   useState,
 } from "react";
-import { blazeoClientConfig, initializeAppointmentClient } from "appointment-client";
-import { configure as configureCalendarClient } from "@blazeo.com/calendar-client";
+import { blazeoClientConfig } from "appointment-client";
+import { pushBlazeoConnection } from "./blazeoPushConnection.js";
 
 const STORAGE_BASE = "appointment-client-sample:blazeoBaseUrl";
 const STORAGE_CONSUMER = "appointment-client-sample:blazeoConsumer";
@@ -46,18 +46,10 @@ export function mergeBlazeoUiWithFile(uiBaseUrl, uiConsumer) {
 
 /**
  * Re-apply global Blazeo `configure` from the effective connection card state.
- * Call at the start of any handler that uses `CalendarModel` / `EventModel` HTTP so
- * `getParticipantOpeningHours` (instance env) and static helpers always see the same
- * `baseUrl`.
+ * Pushes into both calendar-client entrypoints ({@link pushBlazeoConnection}).
  */
 export function configureBlazeoFromEffective(effective) {
-  const baseUrl = normalizeBase(effective?.baseUrl ?? "");
-  if (!baseUrl) return;
-  const consumer = (effective?.consumer ?? "").trim() || undefined;
-  // Configure appointment-client (which configures its internal calendar-client instance)
-  initializeAppointmentClient({ baseUrl, ...(consumer ? { consumer } : {}) });
-  // Also configure the calendar-client instance that the sample (and Vite alias) may resolve.
-  configureCalendarClient({ baseUrl, ...(consumer ? { consumer } : {}) });
+  pushBlazeoConnection(effective);
 }
 
 const BlazeoConnectionContext = createContext(null);
@@ -71,6 +63,15 @@ export function BlazeoConnectionProvider({ children }) {
     [baseUrlInput, consumerInput]
   );
 
+  /** Pass into `fetchCalendarDetails`, `createCalendarAsync`, etc. (explicit `baseUrl` for `ensureBlazeoHttpReady`). */
+  const connectionOpts = useMemo(
+    () => ({
+      ...(effective.baseUrl ? { baseUrl: effective.baseUrl } : {}),
+      ...(effective.consumer ? { consumer: effective.consumer } : {}),
+    }),
+    [effective.baseUrl, effective.consumer]
+  );
+
   useEffect(() => {
     writeStored(STORAGE_BASE, baseUrlInput.trim());
   }, [baseUrlInput]);
@@ -87,8 +88,7 @@ export function BlazeoConnectionProvider({ children }) {
   useLayoutEffect(() => {
     const { baseUrl, consumer } = mergeBlazeoUiWithFile(baseUrlInput, consumerInput);
     if (!baseUrl) return;
-    initializeAppointmentClient({ baseUrl, ...(consumer ? { consumer } : {}) });
-    configureCalendarClient({ baseUrl, ...(consumer ? { consumer } : {}) });
+    pushBlazeoConnection({ baseUrl, consumer });
   }, [baseUrlInput, consumerInput]);
 
   const value = useMemo(
@@ -98,8 +98,9 @@ export function BlazeoConnectionProvider({ children }) {
       setBaseUrlInput,
       setConsumerInput,
       effective,
+      connectionOpts,
     }),
-    [baseUrlInput, consumerInput, effective]
+    [baseUrlInput, consumerInput, effective, connectionOpts]
   );
 
   return (