@blazeo.com/calendar-client 1.0.22 → 1.0.24

package/README.md

@@ -44,8 +44,53 @@ await cal.create(); // POST to backend
 - **EventModel (instance):** `get`, `create`, `cancel`, `getCancellable`, `getAvailability`, `setReminder`
 - **FlowModel:** Same pattern as Calendar — `FlowModel.create({}, { env })` with no fields; static `get`, `getRaw`, `list`, `createFlow`, `updateFlow`, `delete`, `duplicate`, appearance/embed/public/preview helpers; instance methods mirror those using `flowId` on the snapshot
 - **LeadModel:** `LeadModel.create({}, { env })`; static `get`, `getRaw`, `getByEmail`, `getByCompany`; instance `get`, `getByEmail`, `getByCompany` (uses `leadId` / `email` / `companyKey` on the snapshot)
+- **AuthModel (calendar OAuth / Connect Calendar):** `getCalendarProviders`, `getAuthorizationUrl`, `getAuthorizationStatus`, `openOAuthPopup`, `onCalendarAuthMessage` — see [Calendar authorization flow](#calendar-authorization-direct-ui)
 - **RootStore:** `addCalendar`, `addEvent`
 
+### Calendar authorization (direct UI)
+
+When the user connects Google or Outlook from the Scheduling modal:
+
+```js
+import {
+  configure,
+  AuthModel,
+  CalendarEmailProvider,
+  CALENDAR_AUTH_MESSAGE_TYPE,
+} from '@blazeo.com/calendar-client';
+
+configure({ baseUrl: 'https://your-appointment-api.example.com' });
+
+const participantId = '...'; // logged-in participant GUID
+
+// Optional: already connected?
+const statusRes = await AuthModel.getAuthorizationStatus(participantId);
+if (statusRes.status === 'success' && statusRes.data?.isAuthorized) {
+  // show connected UI
+}
+
+// Load provider cards (Google / Gmail, Microsoft Outlook)
+const providersRes = await AuthModel.getCalendarProviders();
+const providers = providersRes.data; // [{ key: 'google', displayName: 'Google / Gmail', ... }, ...]
+
+// User clicks Google
+const urlRes = await AuthModel.getAuthorizationUrl(participantId, 'google');
+const popup = AuthModel.openOAuthPopup(urlRes.data.authorizationUrl);
+
+const unsubscribe = AuthModel.onCalendarAuthMessage(async (payload) => {
+  if (payload.status === 'success') {
+    const check = await AuthModel.getAuthorizationStatus(participantId);
+    if (check.data?.isAuthorized) {
+      // close modal, show success
+    }
+  }
+});
+
+// On modal unmount: unsubscribe(); popup?.close();
+```
+
+`email_provider` for `getAuthorizationUrl`: `google`, `gmail`, `1`, `outlook`, `microsoft`, or `2`.
+
 All methods return `Promise<{ status, data?, message? }>`. Check `response.status === 'success'` and use `response.data`.
 
 ## Samples