@blazeo.com/appointment-client 1.0.5 → 1.0.7

package/sample/src/ParticipantInfoTab.jsx

@@ -0,0 +1,77 @@
+import { useState } from "react";
+import { CalendarParticipantModel, ensureBlazeoHttpReady } from "appointment-client";
+import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
+
+export function ParticipantInfoTab() {
+  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 info = await CalendarParticipantModel.getInfoByCalendar(id);
+      setOutput(JSON.stringify({ calendarId: id, count: Array.isArray(info) ? info.length : 0, info }, null, 2));
+    } catch (err) {
+      setError(mapBlazeoDemoError(err instanceof Error ? err.message : String(err)));
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <>
+      <div className="card">
+        <h2>Participant Info by Calendar</h2>
+        <p className="muted small">
+          Calls <code>CalendarParticipantModel.getInfoByCalendar(calendarId)</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 participant info"}
+          </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/ParticipantOpeningHoursTab.jsx

@@ -0,0 +1,98 @@
+import { useState } from "react";
+import { ensureBlazeoHttpReady, getParticipantOpeningHours } from "appointment-client";
+import { configureBlazeoFromEffective, useBlazeoConnection } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
+
+export function ParticipantOpeningHoursTab() {
+  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 result = await getParticipantOpeningHours(id, {
+        ...connectionOpts,
+        baseUrl: effective.baseUrl,
+        ...(effective.consumer ? { consumer: effective.consumer } : {}),
+      });
+
+      if (!result.meta.ok) {
+        setError(
+          mapBlazeoDemoError(result.meta.error || `Failed to fetch: ${result.meta.reason}`)
+        );
+        if (result.raw) setOutput(JSON.stringify(result.raw, null, 2));
+        return;
+      }
+
+      setOutput(JSON.stringify({ 
+        calendarId: id, 
+        count: result.openingHours.length, 
+        openingHours: result.openingHours, 
+        raw: result.raw,
+        meta: result.meta 
+      }, null, 2));
+    } catch (err) {
+      setError(mapBlazeoDemoError(err instanceof Error ? err.message : String(err)));
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <>
+      <div className="card">
+        <h2>Participant Opening Hours (Direct)</h2>
+        <p className="muted small">
+          Calls <code>CalendarModel.get(calendarId)</code> then{" "}
+          <code>calendar.getParticipantOpeningHours(&#123;&#125;)</code> (API:{" "}
+          <code>GET /Calendar/Participant/OpeningHours/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 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/ParticipantTab.jsx

@@ -1,10 +1,11 @@
 import { useMemo, useState } from "react";
-import { getExampleParticipants, ParticipantModel } from "appointment-client";
+import { ensureBlazeoHttpReady, getExampleParticipants, getParticipants } from "appointment-client";
 import { getSnapshot, isStateTreeNode } from "mobx-state-tree";
 import {
   configureBlazeoFromEffective,
   useBlazeoConnection,
 } from "./BlazeoConnectionSettings.jsx";
+import { mapBlazeoDemoError } from "./blazeoDemoError.js";
 
 function toDisplayJson(value) {
   if (value == null) return JSON.stringify(value, null, 2);
@@ -20,7 +21,7 @@ function toDisplayJson(value) {
 }
 
 export function ParticipantTab() {
-  const { effective } = useBlazeoConnection();
+  const { effective, connectionOpts } = useBlazeoConnection();
   const example = useMemo(() => getExampleParticipants(), []);
   const [calendarId, setCalendarId] = useState("");
   const [busy, setBusy] = useState(false);
@@ -41,12 +42,20 @@ export function ParticipantTab() {
       return;
     }
     configureBlazeoFromEffective(effective);
+    ensureBlazeoHttpReady({
+      baseUrl: effective.baseUrl,
+      ...(effective.consumer ? { consumer: effective.consumer } : {}),
+    });
     setBusy(true);
     try {
-      const res = await ParticipantModel.getAllByCalendar(id);
+      const res = await getParticipants(id, {
+        ...connectionOpts,
+        baseUrl: effective.baseUrl,
+        ...(effective.consumer ? { consumer: effective.consumer } : {}),
+      });
       setOutput(toDisplayJson(res));
     } 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/blazeoBootstrap.js

@@ -0,0 +1,30 @@
+/**
+ * Runs once before React mounts. Order:
+ * 1. `blazeoClientDefaults.ts` (via applyBlazeoClientConfig) — optional file defaults
+ * 2. `VITE_BLAZEO_BASE_URL` / `VITE_BLAZEO_CONSUMER` — overrides when set
+ *
+ * Uses {@link pushBlazeoConnection} so calendar-client is configured the same way as the UI card.
+ */
+import { applyBlazeoClientConfig } from "appointment-client";
+import { pushBlazeoConnection } from "./blazeoPushConnection.js";
+
+function normalizeBase(u) {
+  const t = (u ?? "").trim();
+  if (!t) return "";
+  return t.replace(/\/+$/, "");
+}
+
+export function bootstrapBlazeoClient() {
+  debugger;
+  applyBlazeoClientConfig();
+
+  const envBase = normalizeBase(import.meta.env.VITE_BLAZEO_BASE_URL ?? "");
+  const envConsumer = (import.meta.env.VITE_BLAZEO_CONSUMER ?? "").trim();
+
+  if (!envBase) return;
+
+  pushBlazeoConnection({
+    baseUrl: envBase,
+    ...(envConsumer ? { consumer: envConsumer } : {}),
+  });
+}

package/sample/src/blazeoDemoError.js

@@ -0,0 +1,14 @@
+/**
+ * Maps low-level Blazeo / calendar-client errors to actionable copy for this sample.
+ */
+export function mapBlazeoDemoError(message) {
+  const m = String(message ?? "");
+  if (
+    /Model env requires baseUrl|requires baseUrl\. Call configure|baseUrl is missing|Blazeo base URL is not set/i.test(
+      m
+    )
+  ) {
+    return "Blazeo Base URL is not set for API calls. Enter **Base URL** (and optional Consumer) in the **Blazeo connection** card at the top of this page, or set `blazeoClientConfig` / `VITE_BLAZEO_BASE_URL`.";
+  }
+  return m;
+}

package/sample/src/blazeoPushConnection.js

@@ -0,0 +1,23 @@
+import { ensureBlazeoHttpReady, initializeAppointmentClient } from "appointment-client";
+import { configure } from "@blazeo.com/calendar-client";
+
+function normalizeBase(u) {
+  const t = (u ?? "").trim();
+  if (!t) return "";
+  return t.replace(/\/+$/, "");
+}
+
+/**
+ * Applies Base URL from the connection card. With Vite `resolve.alias` pointing
+ * `@blazeo.com/calendar-client` at one file, `configure` here matches `CalendarModel`'s store.
+ * `initializeAppointmentClient` + `ensureBlazeoHttpReady` keep `appointment-client` helpers aligned.
+ */
+export function pushBlazeoConnection(effective) {
+  const baseUrl = normalizeBase(effective?.baseUrl ?? "");
+  if (!baseUrl) return;
+  const consumer = (effective?.consumer ?? "").trim() || undefined;
+  const cfg = { baseUrl, ...(consumer ? { consumer } : {}) };
+  initializeAppointmentClient(cfg);
+  configure(cfg);
+  ensureBlazeoHttpReady(cfg);
+}

package/sample/src/main.jsx

@@ -1,11 +1,11 @@
-import { applyBlazeoClientConfig } from "appointment-client";
 import { StrictMode } from "react";
 import { createRoot } from "react-dom/client";
 import { App } from "./App2.jsx";
+import { bootstrapBlazeoClient } from "./blazeoBootstrap.js";
 import "./style.css";
 
-/** Apply file defaults (`blazeoClientDefaults.ts`) before React mounts. */
-applyBlazeoClientConfig();
+/** Blazeo: `blazeoClientDefaults.ts` + optional `VITE_BLAZEO_*` (.env) → `configure()` for calendar-client. */
+bootstrapBlazeoClient();
 
 const rootEl = document.getElementById("app");
 if (!rootEl) {

package/sample/vite.config.js

@@ -1,10 +1,23 @@
 import react from "@vitejs/plugin-react";
 import { defineConfig, loadEnv } from "vite";
 import path from "path";
+import fs from "fs";
 import { fileURLToPath } from "url";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
+/** Single physical entry for `@blazeo.com/calendar-client` (hoisted or nested under `file:..` parent). */
+function calendarClientEntry() {
+  const candidates = [
+    path.resolve(__dirname, "node_modules/@blazeo.com/calendar-client/dist/index.mjs"),
+    path.resolve(__dirname, "../node_modules/@blazeo.com/calendar-client/dist/index.mjs"),
+  ];
+  for (const p of candidates) {
+    if (fs.existsSync(p)) return p;
+  }
+  return candidates[0];
+}
+
 export default defineConfig(({ mode }) => {
   const env = loadEnv(mode, path.resolve(__dirname, "."), "");
   const proxyTarget = (env.VITE_DEV_PROXY_TARGET ?? "").trim().replace(/\/+$/, "");
@@ -26,13 +39,14 @@ export default defineConfig(({ mode }) => {
     plugins: [react()],
     /** Ensure one instance so `configure()` and models share the same store. */
     resolve: {
-      preserveSymlinks: true,
+      // `file:..` appointment-client is symlinked; `true` can resolve the same dep twice → two `getConfig()` stores.
+      preserveSymlinks: false,
       dedupe: ["@blazeo.com/calendar-client", "mobx", "mobx-state-tree"],
       alias: {
-        "@blazeo.com/calendar-client": path.resolve(
-          __dirname,
-          "../node_modules/@blazeo.com/calendar-client/dist/index.mjs"
-        ),
+        // Ensure Vite/Rollup can always resolve the local workspace package.
+        // (Avoids `Failed to resolve import "appointment-client"` during dev/build.)
+        "appointment-client": path.resolve(__dirname, "../dist/index.js"),
+        "@blazeo.com/calendar-client": calendarClientEntry(),
       },
     },
     optimizeDeps: {

package/src/calendar/blazeoCalendarRelationMethods.ts

@@ -0,0 +1,19 @@
+/** `GET /Calendar/Participant/Add` — attach `participantId` to this calendar. */
+export function addParticipantToCalendar(calendar: any, participantId: string) {
+  return calendar.addParticipant(participantId);
+}
+
+/** `GET /Calendar/Participant/Remove` */
+export function removeParticipantFromCalendar(calendar: any, participantId: string) {
+  return calendar.removeParticipant(participantId);
+}
+
+/** `POST /Calendar/Participant/Availability/OpeningHour/Save` — one day/slot. */
+export function saveCalendarOpeningHour(calendar: any, payload: any) {
+  return calendar.saveOpeningHour(payload);
+}
+
+/** `POST /Calendar/Participant/Availability/OpeningHours/Save` — batch body (API-specific shape). */
+export function saveCalendarOpeningHoursBatch(calendar: any, payload: any) {
+  return calendar.saveOpeningHours(payload);
+}