@blazeo.com/calendar-client 1.0.23 → 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

package/dist/index.d.ts

@@ -246,6 +246,86 @@ export const LeadModel: {
   create(snapshot?: object, options?: { env?: object }): unknown;
 };
 
+export type CalendarProviderOption = {
+  emailProvider: number;
+  key: string;
+  name: string;
+  displayName: string;
+  description: string;
+  scope: string;
+  redirectUrl: string;
+};
+
+export type ParticipantAuthorizationUrl = {
+  participantId: string;
+  emailProvider: number;
+  providerKey: string;
+  authorizationUrl: string;
+  redirectUrl: string;
+};
+
+export type CalendarProviderAuthorizationState = {
+  emailProvider: number;
+  key: string;
+  name: string;
+  hasCredentials: boolean;
+  isAuthorized: boolean;
+  isSelected: boolean;
+};
+
+export type ParticipantAuthorizationStatus = {
+  participantId: string;
+  email: string;
+  emailProvider: number;
+  providerKey: string;
+  hasCredentials: boolean;
+  isAuthorized: boolean;
+  providers: CalendarProviderAuthorizationState[];
+};
+
+export const CALENDAR_AUTH_MESSAGE_TYPE: 'calendar-authorization';
+
+export const CalendarEmailProvider: {
+  Google: 1;
+  Microsoft: 2;
+  Default: 3;
+};
+
+export const AuthModel: {
+  CALENDAR_AUTH_MESSAGE_TYPE: typeof CALENDAR_AUTH_MESSAGE_TYPE;
+  EmailProvider: typeof CalendarEmailProvider;
+  getCalendarProviders(opts?: { host?: string }): Promise<{
+    status: string;
+    data?: CalendarProviderOption[];
+    message?: string;
+  }>;
+  getAuthorizationUrl(
+    participantId: string,
+    emailProvider: string | number,
+    opts?: { host?: string }
+  ): Promise<{
+    status: string;
+    data?: ParticipantAuthorizationUrl;
+    message?: string;
+  }>;
+  getAuthorizationStatus(participantId: string): Promise<{
+    status: string;
+    data?: ParticipantAuthorizationStatus;
+    message?: string;
+  }>;
+  openOAuthPopup(
+    authorizationUrl: string,
+    opts?: { width?: number; height?: number }
+  ): Window | null;
+  onCalendarAuthMessage(
+    handler: (payload: {
+      type: string;
+      status: 'success' | 'error';
+      message?: string;
+    }) => void
+  ): () => void;
+};
+
 export const CustomFieldModel: {
   getAll(calendarId: string): Promise<unknown[] | null>;
   getFieldType(fieldType: string): Promise<unknown>;
@@ -270,3 +350,4 @@ export const AttendeeStatus: Record<string, number>;
 export const RecurringFrequency: Record<string, number>;
 export const DayOfWeek: Record<string, number>;
 export const LocationType: Record<string, number>;
+export const EmailProvider: Record<string, number>;