@blazeo.com/appointment-client 1.0.4 → 1.0.6

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,9 +1,9 @@
 {
   "name": "@blazeo.com/appointment-client",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "publishConfig": {
     "access": "public"
-  },  
+  },
   "author": "Blazeo",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,10 +14,15 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "scripts": {
+    "build": "tsc"
+  },
   "dependencies": {
-    "@blazeo.com/calendar-client": "^1.0.5",
+    "@blazeo.com/calendar-client": "^1.0.18",
     "mobx": "^6.13.7",
     "mobx-state-tree": "^7.0.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
   }
 }
-

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,62 @@
     },
     "..": {
       "name": "@blazeo.com/appointment-client",
-      "version": "1.0.3",
+      "version": "1.0.5",
       "dependencies": {
-        "@blazeo.com/calendar-client": "^1.0.5",
+        "@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": {
+      "version": "1.0.17",
+      "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",
+      "license": "MIT",
+      "peerDependencies": {
+        "mobx": "^6.3.0"
+      }
+    },
+    "../node_modules/mobx": {
+      "version": "6.15.0",
+      "license": "MIT",
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/mobx"
+      }
+    },
+    "../node_modules/mobx-state-tree": {
+      "version": "7.2.0",
+      "license": "MIT",
+      "dependencies": {
+        "ts-essentials": "^9.4.1"
+      },
+      "peerDependencies": {
+        "mobx": "^6.3.0"
+      }
+    },
+    "../node_modules/ts-essentials": {
+      "version": "9.4.2",
+      "license": "MIT",
+      "peerDependencies": {
+        "typescript": ">=4.1.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
       }
     },
     "node_modules/@babel/code-frame": {

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,73 @@
+import { useState } from "react";
+import { getAllParticipantOpeningHours } from "appointment-client";
+import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+
+export function AllParticipantOpeningHoursTab() {
+  const { effective } = 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);
+    setBusy(true);
+    try {
+      const res = await getAllParticipantOpeningHours(id);
+      setOutput(JSON.stringify(res, null, 2));
+    } catch (err) {
+      setError(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

@@ -6,16 +6,25 @@ import {
 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" },
 ];
 
@@ -80,7 +89,7 @@ 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 — use tab <strong>Fetch · calendarView</strong> for the unified <code>calendarView</code> object.</p>
       </header>
 
       <ConnectionSettingsCard />
@@ -128,6 +137,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/BlazeoConnectionSettings.jsx

@@ -45,7 +45,7 @@ export function mergeBlazeoUiWithFile(uiBaseUrl, uiConsumer) {
 }
 
 /**
- * Re-apply global Blazeo `configure` from the merged connection card state.
+ * 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`.