@blazeo.com/appointment-client 1.0.5 → 1.0.7

package/dist/types/calendar.js

@@ -1,6 +1,6 @@
-/**
- * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
- * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
- */
-export {};
+/**
+ * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
+ * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
+ */
+export {};
 //# sourceMappingURL=calendar.js.map

package/dist/types/calendarBo.d.ts

@@ -1,62 +1,62 @@
-/**
- * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
- * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
- */
-export type CalendarBOInput = {
-    /** Blazeo / API calendar identifier; falls back to `thirdPartyCalendarId` or `"new"`. */
-    calendarId?: string;
-    thirdPartyCalendarId?: string;
-    /** Apex / DB numeric id when known */
-    serverId?: number;
-    companyKey?: string | null;
-    purpose?: string;
-    name?: string | null;
-    timeZoneId?: string | null;
-    description?: string | null;
-    /** Apex `AssignmentType` — mapped to Blazeo `assignmentMethod`. */
-    assignmentType?: number;
-    assignmentMethod?: number;
-    duration?: number;
-    bookingLimit?: number | null;
-    calendarJson?: string | null;
-    isThirdPartySaved?: boolean;
-    durationUnit?: number;
-    minimumBookingNotice?: number;
-    minimumBookingNoticeUnit?: number;
-    minimumCancelationNotice?: number;
-    minimumCancelationNoticeUnit?: number;
-    futureLimit?: number;
-    futureLimitUnit?: number;
-    bufferTime?: number | null;
-    bufferTimeUnit?: number;
-    calendarLink?: string | null;
-    status?: number;
-    location?: string | null;
-    bookingPageTitle?: string | null;
-    themeId?: number | null;
-    createdOn?: string | null;
-    modifiedOn?: string | null;
-    /** Not part of Blazeo Calendar MST — reserved for future participant/hours steps. */
-    members?: MemberBOInput[];
-    openingHours?: OpeningHourBOInput[];
-};
-export type MemberBOInput = {
-    id: number;
-    name?: string | null;
-    email?: string;
-    thirdPartyMemberId?: string | null;
-};
-export type OpeningHourBOInput = {
-    id: number;
-    openingHourId?: string;
-    calendarId?: string;
-    participantId?: string;
-    days: number[];
-    startHour: number;
-    startMinute: number;
-    endHour: number;
-    endMinute: number;
-    off: boolean;
-    member: number;
-};
+/**
+ * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
+ * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
+ */
+export type CalendarBOInput = {
+    /** Blazeo / API calendar identifier; falls back to `thirdPartyCalendarId` or `"new"`. */
+    calendarId?: string;
+    thirdPartyCalendarId?: string;
+    /** Apex / DB numeric id when known */
+    serverId?: number;
+    companyKey?: string | null;
+    purpose?: string;
+    name?: string | null;
+    timeZoneId?: string | null;
+    description?: string | null;
+    /** Apex `AssignmentType` — mapped to Blazeo `assignmentMethod`. */
+    assignmentType?: number;
+    assignmentMethod?: number;
+    duration?: number;
+    bookingLimit?: number | null;
+    calendarJson?: string | null;
+    isThirdPartySaved?: boolean;
+    durationUnit?: number;
+    minimumBookingNotice?: number;
+    minimumBookingNoticeUnit?: number;
+    minimumCancelationNotice?: number;
+    minimumCancelationNoticeUnit?: number;
+    futureLimit?: number;
+    futureLimitUnit?: number;
+    bufferTime?: number | null;
+    bufferTimeUnit?: number;
+    calendarLink?: string | null;
+    status?: number;
+    location?: string | null;
+    bookingPageTitle?: string | null;
+    themeId?: number | null;
+    createdOn?: string | null;
+    modifiedOn?: string | null;
+    /** Not part of Blazeo Calendar MST — reserved for future participant/hours steps. */
+    members?: MemberBOInput[];
+    openingHours?: OpeningHourBOInput[];
+};
+export type MemberBOInput = {
+    id: number;
+    name?: string | null;
+    email?: string;
+    thirdPartyMemberId?: string | null;
+};
+export type OpeningHourBOInput = {
+    id: number;
+    openingHourId?: string;
+    calendarId?: string;
+    participantId?: string;
+    days: number[];
+    startHour: number;
+    startMinute: number;
+    endHour: number;
+    endMinute: number;
+    off: boolean;
+    member: number;
+};
 //# sourceMappingURL=calendarBo.d.ts.map

package/dist/types/calendarBo.js

@@ -1,6 +1,6 @@
-/**
- * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
- * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
- */
-export {};
+/**
+ * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
+ * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
+ */
+export {};
 //# sourceMappingURL=calendarBo.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazeo.com/appointment-client",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "publishConfig": {
     "access": "public"
   },
@@ -14,9 +14,15 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsc"
+  },
   "dependencies": {
-    "@blazeo.com/calendar-client": "^1.0.17",
+    "@blazeo.com/calendar-client": "^1.0.18",
     "mobx": "^6.13.7",
     "mobx-state-tree": "^7.0.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
   }
 }

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/demo.js

@@ -0,0 +1,70 @@
+/**
+ * Demo usage of appointment-client
+ * Run with: node demo.js
+ */
+import { 
+  initializeAppointmentClient, 
+  fetchCalendarDetails 
+} from "../dist/index.js"; // In a real app, use 'appointment-client'
+
+async function runDemo() {
+  const TEST_CALENDAR_ID = "66f42c26-f48e-4965-b772-88155986898d"; // Example ID
+  const BASE_URL = "https://api.blazeo.com"; // Example API URL
+
+  console.log("--- Appointment Client Demo ---");
+
+  // 1. Initialize the client
+  console.log(`Initializing client with BASE_URL: ${BASE_URL}`);
+  initializeAppointmentClient({
+    baseUrl: BASE_URL,
+    consumer: "demo-app"
+  });
+
+  try {
+    // 2. Pass calendarId and fetch details
+    console.log(`Fetching details for calendarId: ${TEST_CALENDAR_ID}...`);
+    const details = await fetchCalendarDetails(TEST_CALENDAR_ID);
+
+    if (!details.meta.ok) {
+      console.error("Failed to fetch calendar details:", details.meta.reason);
+      return;
+    }
+
+    if (details.calendarView) {
+      console.log("\n--- calendarView (preview) ---");
+      console.log(
+        JSON.stringify({
+          members: details.calendarView.members?.length ?? 0,
+          openingHours: details.calendarView.openingHours?.length ?? 0,
+        })
+      );
+    }
+
+    // 3. Retrieve and print Opening hours
+    console.log("\n--- Opening Hours ---");
+    if (details.openingHours.length > 0) {
+      details.openingHours.forEach((oh, idx) => {
+        console.log(`[${idx + 1}] Day: ${oh.day}, Start: ${oh.startHour}:${oh.startMinute}, End: ${oh.endHour}:${oh.endMinute}`);
+      });
+    } else {
+      console.log("No opening hours found.");
+    }
+
+    // 4. Retrieve and print Participants
+    console.log("\n--- Participants ---");
+    if (details.participants.length > 0) {
+      details.participants.forEach((p, idx) => {
+        console.log(`[${idx + 1}] Name: ${p.name}, Email: ${p.email || 'N/A'}`);
+      });
+    } else {
+      console.log("No participants found.");
+    }
+
+    console.log("\nDemo completed successfully.");
+
+  } catch (error) {
+    console.error("An error occurred during the demo:", error.message);
+  }
+}
+
+runDemo();

package/sample/package-lock.json

@@ -17,11 +17,14 @@
     },
     "..": {
       "name": "@blazeo.com/appointment-client",
-      "version": "1.0.4",
+      "version": "1.0.6",
       "dependencies": {
-        "@blazeo.com/calendar-client": "^1.0.17",
+        "@blazeo.com/calendar-client": "^1.0.18",
         "mobx": "^6.13.7",
         "mobx-state-tree": "^7.0.2"
+      },
+      "devDependencies": {
+        "typescript": "^5.0.0"
       }
     },
     "../node_modules/@blazeo.com/calendar-client": {

package/sample/package.json

@@ -5,7 +5,9 @@
   "scripts": {
     "dev": "vite",
     "build": "vite build",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "openinghours:participant": "node ./scripts/getParticipantOpeningHours.mjs",
+    "participants:info": "node ./scripts/getInfoByCalendar.mjs"
   },
   "dependencies": {
     "appointment-client": "file:..",

package/sample/scripts/getInfoByCalendar.mjs

@@ -0,0 +1,36 @@
+import { initializeAppointmentClient, CalendarParticipantModel } from "appointment-client";
+
+function reqEnv(name, fallback = "") {
+  const v = (process.env[name] ?? fallback).trim();
+  return v;
+}
+
+const baseUrl = reqEnv("BLAZEO_BASE_URL");
+const consumer = reqEnv("BLAZEO_CONSUMER");
+const calendarId = reqEnv("CALENDAR_ID");
+
+if (!baseUrl) {
+  console.error("Missing env BLAZEO_BASE_URL");
+  process.exit(1);
+}
+if (!calendarId) {
+  console.error("Missing env CALENDAR_ID");
+  process.exit(1);
+}
+
+initializeAppointmentClient({ baseUrl, ...(consumer ? { consumer } : {}) });
+
+const info = await CalendarParticipantModel.getInfoByCalendar(calendarId);
+
+console.log(
+  JSON.stringify(
+    {
+      calendarId,
+      count: Array.isArray(info) ? info.length : 0,
+      info,
+    },
+    null,
+    2
+  )
+);
+

package/sample/scripts/getParticipantOpeningHours.mjs

@@ -0,0 +1,48 @@
+import {
+  initializeAppointmentClient,
+  CalendarModel,
+  normalizeParticipantOpeningHoursResponse,
+} from "appointment-client";
+
+function reqEnv(name, fallback = "") {
+  const v = (process.env[name] ?? fallback).trim();
+  return v;
+}
+
+const baseUrl = reqEnv("BLAZEO_BASE_URL");
+const consumer = reqEnv("BLAZEO_CONSUMER");
+const calendarId = reqEnv("CALENDAR_ID");
+
+if (!baseUrl) {
+  console.error("Missing env BLAZEO_BASE_URL");
+  process.exit(1);
+}
+if (!calendarId) {
+  console.error("Missing env CALENDAR_ID");
+  process.exit(1);
+}
+
+initializeAppointmentClient({ baseUrl, ...(consumer ? { consumer } : {}) });
+
+const cal = await CalendarModel.get(calendarId);
+if (!cal) {
+  console.error("Calendar not found:", calendarId);
+  process.exit(2);
+}
+
+const raw = await cal.getParticipantOpeningHours({});
+const { list } = normalizeParticipantOpeningHoursResponse(raw);
+
+console.log(
+  JSON.stringify(
+    {
+      calendarId,
+      count: Array.isArray(list) ? list.length : 0,
+      openingHours: Array.isArray(list) ? list : null,
+      raw,
+    },
+    null,
+    2
+  )
+);
+

package/sample/src/AllParticipantOpeningHoursTab.jsx

@@ -0,0 +1,82 @@
+import { useState } from "react";
+import { ensureBlazeoHttpReady, getAllParticipantOpeningHours } from "appointment-client";
+import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
+
+export function AllParticipantOpeningHoursTab() {
+  const { effective, connectionOpts } = useBlazeoConnection();
+  const [calendarId, setCalendarId] = useState("");
+  const [busy, setBusy] = useState(false);
+  const [error, setError] = useState("");
+  const [output, setOutput] = useState("");
+
+  async function handleFetch(e) {
+    e.preventDefault();
+    setError("");
+    setOutput("");
+    const id = calendarId.trim();
+    if (!id) return setError("Enter a calendar id.");
+    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, {
+        ...connectionOpts,
+        baseUrl: effective.baseUrl,
+        ...(effective.consumer ? { consumer: effective.consumer } : {}),
+      });
+      setOutput(JSON.stringify(res, null, 2));
+    } catch (err) {
+      setError(mapBlazeoDemoError(err instanceof Error ? err.message : String(err)));
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <>
+      <div className="card">
+        <h2>All Participant Opening Hours</h2>
+        <p className="muted small">
+          Calls <code>getAllParticipantOpeningHours(calendarId)</code> (API:{" "}
+          <code>GET /Calendar/Participant/OpeningHours/All/Get</code>).
+        </p>
+        <form onSubmit={handleFetch} className="form">
+          <label className="form__label">
+            <span>Calendar id</span>
+            <input
+              type="text"
+              className="form__input"
+              value={calendarId}
+              onChange={(e) => setCalendarId(e.target.value)}
+              autoComplete="off"
+            />
+          </label>
+          <button type="submit" className="btn btn--secondary" disabled={busy}>
+            {busy ? "Loading…" : "Fetch all participant opening hours"}
+          </button>
+        </form>
+      </div>
+
+      {error ? (
+        <div className="card card--error" role="alert">
+          <h2>Error</h2>
+          <pre className="pre-block">{error}</pre>
+        </div>
+      ) : null}
+
+      {output ? (
+        <div className="card card--success">
+          <h2>Result</h2>
+          <pre className="pre-block">{output}</pre>
+        </div>
+      ) : null}
+    </>
+  );
+}
+

package/sample/src/App2.jsx

@@ -3,19 +3,29 @@ 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";
+import { ParticipantInfoTab } from "./ParticipantInfoTab.jsx";
+import { ParticipantOpeningHoursTab } from "./ParticipantOpeningHoursTab.jsx";
+import { AllParticipantOpeningHoursTab } from "./AllParticipantOpeningHoursTab.jsx";
 import { AvailabilityTab } from "./AvailabilityTab.jsx";
 import { CreateCalendarTab } from "./CreateCalendarTab.jsx";
 import { FetchCalendarTab } from "./FetchCalendarTab.jsx";
+import { OpeningHoursTab } from "./OpeningHoursTab.jsx";
 
 const TABS = [
   { id: "calendar", label: "Calendar" },
-  { id: "fetch", label: "Fetch calendar" },
+  /** `FetchCalendarTab` → `fetchCalendarDetails` + `calendarView` (unified object). */
+  { id: "fetch", label: "Fetch · calendarView" },
   { id: "create", label: "Create calendar" },
   { id: "event", label: "Event" },
   { id: "participant", label: "Participant" },
+  { id: "participant-info", label: "Participant info" },
+  { id: "opening-hours", label: "Opening Hours" },
+  { id: "participant-opening-hours", label: "Participant opening hours" },
+  { id: "all-participant-opening-hours", label: "All participant opening hours" },
   { id: "availability", label: "Availability / booking" },
 ];
 
@@ -26,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:{" "}
@@ -45,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>
@@ -80,7 +105,11 @@ function AppShell() {
     <main className="page">
       <header className="header">
         <h1>appointment-client</h1>
-        <p className="muted">Browser sample — tabbed explorer for the npm package</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 />
@@ -128,6 +157,34 @@ function AppShell() {
             <ParticipantTab />
           </section>
         )}
+        {activeId === "participant-info" && (
+          <section role="tabpanel" id="panel-participant-info" aria-labelledby="tab-participant-info">
+            <ParticipantInfoTab />
+          </section>
+        )}
+        {activeId === "opening-hours" && (
+          <section role="tabpanel" id="panel-opening-hours" aria-labelledby="tab-opening-hours">
+            <OpeningHoursTab />
+          </section>
+        )}
+        {activeId === "participant-opening-hours" && (
+          <section
+            role="tabpanel"
+            id="panel-participant-opening-hours"
+            aria-labelledby="tab-participant-opening-hours"
+          >
+            <ParticipantOpeningHoursTab />
+          </section>
+        )}
+        {activeId === "all-participant-opening-hours" && (
+          <section
+            role="tabpanel"
+            id="panel-all-participant-opening-hours"
+            aria-labelledby="tab-all-participant-opening-hours"
+          >
+            <AllParticipantOpeningHoursTab />
+          </section>
+        )}
         {activeId === "availability" && (
           <section role="tabpanel" id="panel-availability" aria-labelledby="tab-availability">
             <AvailabilityTab />

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);
     }