@blazeo.com/appointment-client 1.0.5 → 1.0.6

package/dist/types/appointment.d.ts

@@ -1,28 +1,28 @@
-/**
- * ApexFlows `AppointmentBO`-aligned input for Blazeo event APIs
- * (same intent as `AppointmentAPIAdapter` Create / Reschedule / Cancel).
- */
-export type ApexAppointmentInput = {
-    /** Blazeo `calendarId` — `ThirdPartyCalendarId` in Apex. */
-    thirdPartyCalendarId: string;
-    /** Participant GUID string (with or without braces). */
-    participantId: string;
-    title?: string;
-    /** Create: `AppointmentBO.Description`. */
-    description?: string;
-    /** Reschedule / update: Apex often uses `Notes` for body (see adapter). */
-    notes?: string;
-    startDate: string | Date;
-    endDate: string | Date;
-    visitorEmail?: string;
-    visitorPhone?: string;
-    visitorName?: string;
-    email?: string;
-    phone?: string;
-    rescheduleUrl?: string;
-    cancelUrl?: string;
-    timeZone?: string;
-    /** Existing Blazeo event id — required for reschedule; omit or `"new"` for create. */
-    thirdPartyAppointmentId?: string;
-};
+/**
+ * ApexFlows `AppointmentBO`-aligned input for Blazeo event APIs
+ * (same intent as `AppointmentAPIAdapter` Create / Reschedule / Cancel).
+ */
+export type ApexAppointmentInput = {
+    /** Blazeo `calendarId` — `ThirdPartyCalendarId` in Apex. */
+    thirdPartyCalendarId: string;
+    /** Participant GUID string (with or without braces). */
+    participantId: string;
+    title?: string;
+    /** Create: `AppointmentBO.Description`. */
+    description?: string;
+    /** Reschedule / update: Apex often uses `Notes` for body (see adapter). */
+    notes?: string;
+    startDate: string | Date;
+    endDate: string | Date;
+    visitorEmail?: string;
+    visitorPhone?: string;
+    visitorName?: string;
+    email?: string;
+    phone?: string;
+    rescheduleUrl?: string;
+    cancelUrl?: string;
+    timeZone?: string;
+    /** Existing Blazeo event id — required for reschedule; omit or `"new"` for create. */
+    thirdPartyAppointmentId?: string;
+};
 //# sourceMappingURL=appointment.d.ts.map

package/dist/types/appointment.js

@@ -1,6 +1,6 @@
-/**
- * ApexFlows `AppointmentBO`-aligned input for Blazeo event APIs
- * (same intent as `AppointmentAPIAdapter` Create / Reschedule / Cancel).
- */
-export {};
+/**
+ * ApexFlows `AppointmentBO`-aligned input for Blazeo event APIs
+ * (same intent as `AppointmentAPIAdapter` Create / Reschedule / Cancel).
+ */
+export {};
 //# sourceMappingURL=appointment.js.map

package/dist/types/calendar.d.ts

@@ -1,52 +1,52 @@
-/**
- * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
- * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
- */
-export type CalendarInput = {
-    /** Blazeo / API calendar identifier; falls back to `thirdPartyCalendarId` or `"new"`. */
-    calendarId?: string;
-    companyKey?: string | null;
-    name?: string | null;
-    timeZoneId?: string | null;
-    description?: string | null;
-    /** Apex `AssignmentType` — mapped to Blazeo `assignmentMethod`. */
-    assignmentType?: number;
-    assignmentMethod?: number;
-    duration?: number;
-    bookingLimit?: number | null;
-    durationUnit?: number;
-    minimumBookingNotice?: number;
-    minimumBookingNoticeUnit?: number;
-    minimumCancelationNotice?: number;
-    minimumCancelationNoticeUnit?: number;
-    futureLimit?: number;
-    futureLimitUnit?: number;
-    bufferTime?: number | null;
-    bufferTimeUnit?: number;
-    /**
-     * Apex: used to populate Blazeo `purpose` (fallback).
-     * If omitted, we fallback to `bookingPageTitle` or "".
-     */
-    purpose?: string;
-    bookingPageTitle?: string | 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: string | null;
-};
-export type OpeningHourBOInput = {
-    id: number;
-    openingHourId?: string;
-    participantId?: string;
-    days: number[];
-    startHour: number;
-    startMinute: number;
-    endHour: number;
-    endMinute: number;
-    off: boolean;
-};
+/**
+ * Plain shapes aligned with CalendarBO / MemberBO / OpeningHourBO for mapping
+ * into `@blazeo.com/calendar-client` `CalendarModel.create` (see `mapCalendarBoToBlazeoSnapshot.ts`).
+ */
+export type CalendarInput = {
+    /** Blazeo / API calendar identifier; falls back to `thirdPartyCalendarId` or `"new"`. */
+    calendarId?: string;
+    companyKey?: string | null;
+    name?: string | null;
+    timeZoneId?: string | null;
+    description?: string | null;
+    /** Apex `AssignmentType` — mapped to Blazeo `assignmentMethod`. */
+    assignmentType?: number;
+    assignmentMethod?: number;
+    duration?: number;
+    bookingLimit?: number | null;
+    durationUnit?: number;
+    minimumBookingNotice?: number;
+    minimumBookingNoticeUnit?: number;
+    minimumCancelationNotice?: number;
+    minimumCancelationNoticeUnit?: number;
+    futureLimit?: number;
+    futureLimitUnit?: number;
+    bufferTime?: number | null;
+    bufferTimeUnit?: number;
+    /**
+     * Apex: used to populate Blazeo `purpose` (fallback).
+     * If omitted, we fallback to `bookingPageTitle` or "".
+     */
+    purpose?: string;
+    bookingPageTitle?: string | 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: string | null;
+};
+export type OpeningHourBOInput = {
+    id: number;
+    openingHourId?: string;
+    participantId?: string;
+    days: number[];
+    startHour: number;
+    startMinute: number;
+    endHour: number;
+    endMinute: number;
+    off: boolean;
+};
 //# sourceMappingURL=calendar.d.ts.map

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.6",
   "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/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.5",
       "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,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}
+    </>
+  );
+}
+