@blazeo.com/calendar-client 1.0.31 → 1.0.34

package/README.md

@@ -64,7 +64,7 @@ All `reqGet` / `reqPost` calls attach `Authorization: Bearer …` when a token i
 ```js
 setAccessToken(session.accessToken, session.expiresAt);
 setGetAccessToken(() => authService.acquireTokenSilent());
-await LeadModel.requestExport('company-key');
+await LeadModel.requestExport('company-key', { userEmail: 'user@example.com' });
 ```
 
 ## API overview
@@ -72,7 +72,7 @@ await LeadModel.requestExport('company-key');
 - **CalendarModel (static):** `get`, `getByCompany`, `getTimeZones`, `getTimeZone`, `getParticipants`, `getMonth`, `getEvents`, etc.
 - **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`, `getByPhone`, `getByCompany`, `saveColumnSelection`, `getColumnSelection`, `allowedColumns`; instance `get`, `getByEmail`, `getByPhone`, `getByCompany`, `saveColumnSelection`, `getColumnSelection`. Pass `userId` in `getByCompany(companyKey, { userId })` to return only columns saved for that user.
+- **LeadModel:** `LeadModel.create({}, { env })`; static `get`, `getRaw`, `getByEmail`, `getByPhone`, `getByCompany`, `saveColumnSelection`, `getColumnSelection`, `allowedColumns`, `requestExport`; instance `get`, `getByEmail`, `getByPhone`, `getByCompany`, `saveColumnSelection`, `getColumnSelection`, `requestLeadExport`. Pass `userId` in `getByCompany(companyKey, { userId })` to return only columns saved for that user. For `requestExport`, pass `userEmail` (or rely on JWT email claim) so the server can publish a `NotificationGenerated` message when export completes.
 - **ParticipantModel:** static `get`, `getByEmail`, `getByIds`, `getAll`, …; instance `getByEmail` uses `email` + `companyKey` on the snapshot (see `GET /participant/getbyemail`)
 - **AuthModel (calendar OAuth / Connect Calendar):** `getCalendarProviders`, `getAuthorizationUrl`, `getAuthorizationStatus`, `openOAuthPopup`, `onCalendarAuthMessage` — see [Calendar authorization flow](#calendar-authorization-direct-ui)
 - **RootStore:** `addCalendar`, `addEvent`

package/dist/index.d.ts

@@ -268,6 +268,9 @@ export const LeadModel: {
       notify_path?: string;
       consumer?: string;
       Consumer?: string;
+      /** Recipient for lead-export completion notification (or omit to use JWT email claim). */
+      userEmail?: string;
+      user_email?: string;
     }
   ): Promise<{ status: string; data?: unknown; message?: string }>;
   getByCompany(

package/dist/index.js

@@ -38,6 +38,7 @@ __export(index_exports, {
   DayOfWeek: () => DayOfWeek,
   EmailProvider: () => EmailProvider,
   EventModel: () => Event_default,
+  EventSource: () => EventSource,
   FlowModel: () => Flow_default,
   LeadModel: () => Lead_default,
   LocationType: () => LocationType,
@@ -344,6 +345,11 @@ var RecurringFrequency = {
   Monthly: 3,
   Yearly: 4
 };
+var EventSource = {
+  AppointmentType: 0,
+  OneOffMeeting: 1,
+  MeetingLink: 2
+};
 var DayOfWeek = {
   Sunday: 0,
   Monday: 1,
@@ -483,7 +489,8 @@ var EventModel = import_mobx_state_tree4.types.model("Event", {
   rescheduleLink: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   cancelLink: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   timeZone: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
-  offset: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.number, 0)
+  offset: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.number, 0),
+  eventSource: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.number, EventSource.AppointmentType)
 }).actions((self) => {
   const { req, reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree4.getEnv);
   const getOffset = () => {
@@ -620,11 +627,14 @@ function mapEventFromApi(d) {
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
   const n = (v) => v != null && v !== "" ? Number(v) : void 0;
   return {
+    id: n(pick2("id", "Id")),
     eventId: String(pick2("eventId", "EventId", "event_id") ?? ""),
     calendarId: String(pick2("calendarId", "CalendarId", "calendar_id") ?? ""),
     participantId: pick2("participantId", "ParticipantId", "participant_id") ?? null,
     title: pick2("title", "Title"),
     description: pick2("description", "Description"),
+    isRecurring: pick2("isRecurring", "IsRecurring", "is_recurring") ?? false,
+    recurringFrequency: n(pick2("recurringFrequency", "RecurringFrequency", "recurring_frequency")),
     startDate: pick2("startDate", "StartDate", "start_date"),
     endDate: pick2("endDate", "EndDate", "end_date"),
     startHour: n(pick2("startHour", "StartHour", "start_hour")),
@@ -634,15 +644,17 @@ function mapEventFromApi(d) {
     visitorName: pick2("visitorName", "VisitorName", "visitor_name"),
     visitorEmail: pick2("visitorEmail", "VisitorEmail", "visitor_email"),
     visitorPhone: pick2("visitorPhone", "VisitorPhone", "visitor_phone"),
-    externalEventId: pick2("externalEventId", "ExternalEventId", "external_event_id"),
+    externalEventId: pick2("externalEventId", "ExternalEventId", "externalEventId", "external_event_id"),
     calendarLocationId: pick2("calendarLocationId", "CalendarLocationId", "calendar_location_id"),
     customLocation: pick2("customLocation", "CustomLocation", "custom_location"),
     flowId: pick2("flowId", "FlowId", "flow_id"),
     flowPath: pick2("flowPath", "FlowPath", "flow_path"),
     attendeeStatus: n(pick2("attendeeStatus", "AttendeeStatus", "attendee_status")),
+    eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
     timeZone: pick2("timeZone", "TimeZone", "time_zone"),
+    offset: n(pick2("offset", "Offset")),
     createdOn: pick2("createdOn", "CreatedOn", "created_on"),
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on")
   };
@@ -1962,6 +1974,12 @@ var CalendarLocationModel = import_mobx_state_tree16.types.model("CalendarLocati
       if (!resolvedCalendarId) return { status: "failure", message: "calendarId required" };
       return reqGet("/Calendar/Location/Get", { calendar_id: resolvedCalendarId });
     },
+    /** GET Calendar/Location/GetById – fetch a single location by calendar_location_id */
+    async getById(calendarLocationId) {
+      const resolvedCalendarLocationId = calendarLocationId ?? self.calendarLocationId;
+      if (!resolvedCalendarLocationId) return { status: "failure", message: "calendarLocationId required" };
+      return reqGet("/Calendar/Location/GetById", { calendar_location_id: resolvedCalendarLocationId });
+    },
     /** POST Calendar/Location/Save – create or update location */
     async save() {
       const res = await reqPost("/Calendar/Location/Save", toPayload4(self));
@@ -1998,6 +2016,14 @@ CalendarLocationModel.getByCalendar = async (calendarId) => {
   }
   return null;
 };
+CalendarLocationModel.getById = async (calendarLocationId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const res = await reqGet("/Calendar/Location/GetById", { calendar_location_id: calendarLocationId });
+  if (res.status === "success" && res.data) {
+    return CalendarLocationModel.create(mapCalendarLocationFromApi(res.data), { env: getConfig() });
+  }
+  return null;
+};
 CalendarLocationModel.save = async (payload) => {
   const { reqPost } = createRequestHelpersFromEnv(getConfig());
   const res = await reqPost("/Calendar/Location/Save", payload);
@@ -2483,7 +2509,7 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
     },
     /**
      * POST /lead/export/request – queue async full CSV export for self.companyKey (no list filters).
-     * @param {object} [opts] – { notifyPath?, consumer? } consumer = Consumer header for completion webhook
+     * @param {object} [opts] – { notifyPath?, consumer?, userEmail? } consumer = Consumer header; userEmail for completion notification
      */
     async requestLeadExport(opts = {}) {
       if (!self.companyKey || String(self.companyKey).trim() === "") {
@@ -2615,6 +2641,10 @@ LeadModel.requestExport = async (companyKey, opts = {}) => {
   if (np != null && String(np).trim() !== "") {
     body.notify_path = String(np).trim();
   }
+  const userEmail = opts.userEmail ?? opts.user_email;
+  if (userEmail != null && String(userEmail).trim() !== "") {
+    body.user_email = String(userEmail).trim();
+  }
   const headers = {};
   const consumer = opts.consumer ?? opts.Consumer;
   if (consumer != null && String(consumer).trim() !== "") {
@@ -3020,6 +3050,7 @@ function createRootStore(initialState = {}) {
   DayOfWeek,
   EmailProvider,
   EventModel,
+  EventSource,
   FlowModel,
   LeadModel,
   LocationType,

package/dist/index.mjs

@@ -273,6 +273,11 @@ var RecurringFrequency = {
   Monthly: 3,
   Yearly: 4
 };
+var EventSource = {
+  AppointmentType: 0,
+  OneOffMeeting: 1,
+  MeetingLink: 2
+};
 var DayOfWeek = {
   Sunday: 0,
   Monday: 1,
@@ -412,7 +417,8 @@ var EventModel = types4.model("Event", {
   rescheduleLink: types4.optional(types4.maybeNull(types4.string), null),
   cancelLink: types4.optional(types4.maybeNull(types4.string), null),
   timeZone: types4.optional(types4.maybeNull(types4.string), null),
-  offset: types4.optional(types4.number, 0)
+  offset: types4.optional(types4.number, 0),
+  eventSource: types4.optional(types4.number, EventSource.AppointmentType)
 }).actions((self) => {
   const { req, reqGet, reqPost } = createRequestHelpers(self, getEnv);
   const getOffset = () => {
@@ -549,11 +555,14 @@ function mapEventFromApi(d) {
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
   const n = (v) => v != null && v !== "" ? Number(v) : void 0;
   return {
+    id: n(pick2("id", "Id")),
     eventId: String(pick2("eventId", "EventId", "event_id") ?? ""),
     calendarId: String(pick2("calendarId", "CalendarId", "calendar_id") ?? ""),
     participantId: pick2("participantId", "ParticipantId", "participant_id") ?? null,
     title: pick2("title", "Title"),
     description: pick2("description", "Description"),
+    isRecurring: pick2("isRecurring", "IsRecurring", "is_recurring") ?? false,
+    recurringFrequency: n(pick2("recurringFrequency", "RecurringFrequency", "recurring_frequency")),
     startDate: pick2("startDate", "StartDate", "start_date"),
     endDate: pick2("endDate", "EndDate", "end_date"),
     startHour: n(pick2("startHour", "StartHour", "start_hour")),
@@ -563,15 +572,17 @@ function mapEventFromApi(d) {
     visitorName: pick2("visitorName", "VisitorName", "visitor_name"),
     visitorEmail: pick2("visitorEmail", "VisitorEmail", "visitor_email"),
     visitorPhone: pick2("visitorPhone", "VisitorPhone", "visitor_phone"),
-    externalEventId: pick2("externalEventId", "ExternalEventId", "external_event_id"),
+    externalEventId: pick2("externalEventId", "ExternalEventId", "externalEventId", "external_event_id"),
     calendarLocationId: pick2("calendarLocationId", "CalendarLocationId", "calendar_location_id"),
     customLocation: pick2("customLocation", "CustomLocation", "custom_location"),
     flowId: pick2("flowId", "FlowId", "flow_id"),
     flowPath: pick2("flowPath", "FlowPath", "flow_path"),
     attendeeStatus: n(pick2("attendeeStatus", "AttendeeStatus", "attendee_status")),
+    eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
     timeZone: pick2("timeZone", "TimeZone", "time_zone"),
+    offset: n(pick2("offset", "Offset")),
     createdOn: pick2("createdOn", "CreatedOn", "created_on"),
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on")
   };
@@ -1891,6 +1902,12 @@ var CalendarLocationModel = types16.model("CalendarLocation", {
       if (!resolvedCalendarId) return { status: "failure", message: "calendarId required" };
       return reqGet("/Calendar/Location/Get", { calendar_id: resolvedCalendarId });
     },
+    /** GET Calendar/Location/GetById – fetch a single location by calendar_location_id */
+    async getById(calendarLocationId) {
+      const resolvedCalendarLocationId = calendarLocationId ?? self.calendarLocationId;
+      if (!resolvedCalendarLocationId) return { status: "failure", message: "calendarLocationId required" };
+      return reqGet("/Calendar/Location/GetById", { calendar_location_id: resolvedCalendarLocationId });
+    },
     /** POST Calendar/Location/Save – create or update location */
     async save() {
       const res = await reqPost("/Calendar/Location/Save", toPayload4(self));
@@ -1927,6 +1944,14 @@ CalendarLocationModel.getByCalendar = async (calendarId) => {
   }
   return null;
 };
+CalendarLocationModel.getById = async (calendarLocationId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const res = await reqGet("/Calendar/Location/GetById", { calendar_location_id: calendarLocationId });
+  if (res.status === "success" && res.data) {
+    return CalendarLocationModel.create(mapCalendarLocationFromApi(res.data), { env: getConfig() });
+  }
+  return null;
+};
 CalendarLocationModel.save = async (payload) => {
   const { reqPost } = createRequestHelpersFromEnv(getConfig());
   const res = await reqPost("/Calendar/Location/Save", payload);
@@ -2412,7 +2437,7 @@ var LeadModel = types19.model("Lead", {
     },
     /**
      * POST /lead/export/request – queue async full CSV export for self.companyKey (no list filters).
-     * @param {object} [opts] – { notifyPath?, consumer? } consumer = Consumer header for completion webhook
+     * @param {object} [opts] – { notifyPath?, consumer?, userEmail? } consumer = Consumer header; userEmail for completion notification
      */
     async requestLeadExport(opts = {}) {
       if (!self.companyKey || String(self.companyKey).trim() === "") {
@@ -2544,6 +2569,10 @@ LeadModel.requestExport = async (companyKey, opts = {}) => {
   if (np != null && String(np).trim() !== "") {
     body.notify_path = String(np).trim();
   }
+  const userEmail = opts.userEmail ?? opts.user_email;
+  if (userEmail != null && String(userEmail).trim() !== "") {
+    body.user_email = String(userEmail).trim();
+  }
   const headers = {};
   const consumer = opts.consumer ?? opts.Consumer;
   if (consumer != null && String(consumer).trim() !== "") {
@@ -2948,6 +2977,7 @@ export {
   DayOfWeek,
   EmailProvider,
   Event_default as EventModel,
+  EventSource,
   Flow_default as FlowModel,
   Lead_default as LeadModel,
   LocationType,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazeo.com/calendar-client",
-  "version": "1.0.31",
+  "version": "1.0.34",
   "description": "Blazeo Calendar / Appointment API client with MobX State Tree models",
   "exports": {
     ".": {