@blazeo.com/appointment-client 1.0.3 → 1.0.5

package/dist/calendar/fetchCalendarDetails.d.ts

@@ -0,0 +1,18 @@
+export declare function fetchCalendarDetails(calendarId: string, options?: {
+    includeParticipantsInfo?: boolean;
+}): Promise<{
+    calendar: (Record<string, unknown> & {
+        openingHours: unknown[];
+    }) | null;
+    /** Live MST calendar node (same as `CalendarModel.get`) — use for instance calls. */
+    cal: unknown;
+    openingHours: unknown[];
+    participants: unknown[];
+    participantsInfo: unknown;
+    openingHoursApiResponse: unknown;
+    meta: {
+        ok: boolean;
+        reason?: string;
+    };
+}>;
+

package/dist/calendar/fetchCalendarDetails.js

@@ -0,0 +1,51 @@
+import { CalendarModel } from "@blazeo.com/calendar-client";
+import { getSnapshot } from "mobx-state-tree";
+import { normalizeParticipantOpeningHoursResponse } from "./fetchCalendarWithOpeningHours.js";
+
+/**
+ * Loads calendar + opening hours + participants and returns a single bundle.
+ *
+ * Network calls (when calendar exists):
+ * - GET /Calendar/Get
+ * - GET /Calendar/Participant/OpeningHours/Get
+ * - GET /Calendar/Participant/All
+ */
+export async function fetchCalendarDetails(calendarId, options = {}) {
+  const { includeParticipantsInfo = false } = options;
+
+  const cal = await CalendarModel.get(calendarId);
+  if (cal == null) {
+    return {
+      calendar: null,
+      cal: null,
+      openingHours: [],
+      participants: [],
+      participantsInfo: null,
+      openingHoursApiResponse: null,
+      meta: { ok: false, reason: "calendar_not_found" }
+    };
+  }
+
+  const [openingHoursRes, participants, participantsInfo] = await Promise.all([
+    cal.getParticipantOpeningHours({}),
+    cal.getParticipants(),
+    includeParticipantsInfo ? cal.getParticipantsInfo() : Promise.resolve(null)
+  ]);
+
+  const { list: openingHoursList } = normalizeParticipantOpeningHoursResponse(openingHoursRes);
+  const openingHours = Array.isArray(openingHoursList) ? openingHoursList : [];
+
+  const snap = getSnapshot(cal);
+  const calendar = { ...snap, openingHours };
+
+  return {
+    calendar,
+    cal,
+    openingHours,
+    participants: Array.isArray(participants) ? participants : [],
+    participantsInfo,
+    openingHoursApiResponse: openingHoursRes,
+    meta: { ok: true }
+  };
+}
+

package/dist/calendar/fetchCalendarWithOpeningHours.d.ts

@@ -0,0 +1,21 @@
+export declare function unwrapCalendarGetData(res: unknown): unknown | null;
+export declare function pickOpeningHoursArrayFromCalendarPayload(data: unknown): unknown[] | null;
+export declare function normalizeParticipantOpeningHoursResponse(res: unknown): {
+    list: unknown[] | null;
+    raw: unknown;
+};
+export declare function fetchCalendarWithOpeningHours(calendarId: string, options?: {
+    includeRawGet?: boolean;
+}): Promise<{
+    calendar: (Record<string, unknown> & {
+        openingHours: unknown[];
+    }) | null;
+    /** Live MST calendar node (same as `CalendarModel.get`) — use for `getParticipants()`, etc. */
+    cal: unknown;
+    openingHours: unknown[];
+    embeddedFromGet: unknown[];
+    fromCalendarGet: boolean;
+    fromParticipantApi: boolean;
+    participantOpeningHoursResponse: unknown;
+    rawGet?: unknown;
+}>;

package/dist/calendar/fetchCalendarWithOpeningHours.js

@@ -0,0 +1,75 @@
+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) {
+    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/Get (matches GraphQL-style payloads). */
+export function pickOpeningHoursArrayFromCalendarPayload(data) {
+    if (data == null || typeof data !== "object")
+        return null;
+    const h = data.openingHours ?? data.OpeningHours;
+    return Array.isArray(h) ? h : null;
+}
+/**
+ * Normalize `calendar.getParticipantOpeningHours()` response (`GET /Calendar/Participant/OpeningHours/Get`).
+ */
+export function normalizeParticipantOpeningHoursResponse(res) {
+    if (res == null)
+        return { list: null, raw: res };
+    const d = res.data ?? res.Data;
+    if (Array.isArray(d))
+        return { list: d, raw: res };
+    if (d && typeof d === "object") {
+        if (Array.isArray(d.openingHours))
+            return { list: d.openingHours, raw: res };
+        if (Array.isArray(d.OpeningHours))
+            return { list: d.OpeningHours, raw: res };
+        if (Array.isArray(d.items))
+            return { list: d.items, 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, options = {}) {
+    const { includeRawGet = false } = options;
+    const rawRes = await CalendarModel.getRaw(calendarId);
+    const cal = await CalendarModel.get(calendarId);
+    const payload = unwrapCalendarGetData(rawRes);
+    const embedded = pickOpeningHoursArrayFromCalendarPayload(payload) ?? [];
+    let resolved = embedded.length > 0 ? embedded : null;
+    let participantRes = null;
+    if ((resolved == null || resolved.length === 0) && cal != null) {
+        participantRes = await cal.getParticipantOpeningHours({});
+        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, 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 } : {}),
+    };
+}

package/dist/config/initializeAppointmentClient.js

@@ -1,6 +1,7 @@
 import { configure, getConfig } from "@blazeo.com/calendar-client";
 import { blazeoClientConfig } from "./blazeoClientDefaults.js";
 export function initializeAppointmentClient(options = {}) {
+    debugger;
     const fromOpts = options.baseUrl?.trim().replace(/\/+$/, "") ?? "";
     const fromFile = blazeoClientConfig.baseUrl?.trim().replace(/\/+$/, "") ?? "";
     const baseUrl = fromOpts || fromFile;

package/dist/index.d.ts

@@ -17,6 +17,8 @@ export * from "./models/index.js";
 export { mapCalendarBOToSnapshot } from "./calendar/mapCalendarToBlazeoSnapshot.js";
 export type { CalendarInput as CalendarBOInput, MemberBOInput, OpeningHourBOInput, } from "./types/calendar.js";
 export type { ApexAppointmentInput } from "./types/appointment.js";
+export { fetchCalendarWithOpeningHours, normalizeParticipantOpeningHoursResponse, pickOpeningHoursArrayFromCalendarPayload, unwrapCalendarGetData, } from "./calendar/fetchCalendarWithOpeningHours.js";
+export { fetchCalendarDetails } from "./calendar/fetchCalendarDetails.js";
 export { CalendarModel, EventModel, ParticipantModel, OpeningHourModel, } from "@blazeo.com/calendar-client";
 export { configure, getConfig } from "@blazeo.com/calendar-client";
 export { getExampleCalendarRoot, getExampleCalendarRootSnapshot, getExampleEvents, getExampleParticipants, getExampleSlots, } from "./exampleData.js";

package/dist/index.js

@@ -16,6 +16,8 @@ export { blazeoClientConfig } from "./config/blazeoClientDefaults.js";
 export * from "./facades/index.js";
 export * from "./models/index.js";
 export { mapCalendarBOToSnapshot } from "./calendar/mapCalendarToBlazeoSnapshot.js";
+export { fetchCalendarWithOpeningHours, normalizeParticipantOpeningHoursResponse, pickOpeningHoursArrayFromCalendarPayload, unwrapCalendarGetData, } from "./calendar/fetchCalendarWithOpeningHours.js";
+export { fetchCalendarDetails } from "./calendar/fetchCalendarDetails.js";
 export { CalendarModel, EventModel, ParticipantModel, OpeningHourModel, } from "@blazeo.com/calendar-client";
 export { configure, getConfig } from "@blazeo.com/calendar-client";
 export { getExampleCalendarRoot, getExampleCalendarRootSnapshot, getExampleEvents, getExampleParticipants, getExampleSlots, } from "./exampleData.js";

package/package.json

@@ -1,39 +1,22 @@
-{
-  "name": "@blazeo.com/appointment-client",
-  "version": "1.0.3",
-  "description": "Appointment API client",
-  "license": "UNLICENSED",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "author": "Blazeo",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "sample:dev": "npm run build && npm install --prefix sample && npm run dev --prefix sample",
-    "sample:build": "npm run build && npm install --prefix sample && npm run build --prefix sample",
-    "sample:preview": "npm run sample:build && npm run preview --prefix sample",
-    "sample:install": "npm install --prefix sample"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@blazeo.com/calendar-client": "^1.0.5",
-    "calendar-client": "file:../calendar-client",
-    "mobx": "^6.13.7",
-    "mobx-state-tree": "^7.0.2"
-  },
-  "devDependencies": {
-    "typescript": "^5.7.0"
-  }
-}
+{
+  "name": "@blazeo.com/appointment-client",
+  "version": "1.0.5",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Blazeo",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@blazeo.com/calendar-client": "^1.0.17",
+    "mobx": "^6.13.7",
+    "mobx-state-tree": "^7.0.2"
+  }
+}

package/sample/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>appointment-client sample</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.jsx"></script>
+  </body>
+</html>
+