@blazeo.com/calendar-client 1.0.35 → 1.0.37

package/dist/index.d.ts

@@ -131,9 +131,25 @@ export const EventModel: {
   getCustomData(calendarId: string, eventId?: string): Promise<unknown>;
   setReminder(eventId: string): Promise<unknown>;
   setAttendeeStatus(eventId: string, attendeeStatus: number | string): Promise<unknown>;
+  setEventStatus(eventId: string, status: number | string): Promise<unknown>;
   create(snapshot: EventSnapshot | object, options?: { env?: object }): unknown;
 };
 
+export type ExternalEventSnapshot = {
+  title?: string | null;
+  startDate?: string;
+  endDate?: string;
+  startHour?: number;
+  startMinute?: number;
+  endHour?: number;
+  endMinute?: number;
+};
+
+export const ExternalEventModel: {
+  getByParticipant(participantId: string, opts?: { offset?: number }): Promise<unknown[]>;
+  create(snapshot: ExternalEventSnapshot | object, options?: { env?: object }): unknown;
+};
+
 export const AvailabilityModel: { create(snapshot: object, options?: { env?: object }): unknown };
 export const AvailabilityDetailModel: { create(snapshot: object, options?: { env?: object }): unknown };
 export const CalendarParticipantModel: {
@@ -272,15 +288,17 @@ export const LeadModel: {
     data?: { userId?: string; columns?: string[]; isDefault?: boolean };
     message?: string;
   }>;
+  /** Requires companyKey and at least one of email or phone. */
   createLead(payload: {
-    email: string;
     companyKey: string;
-    name?: string;
+    email?: string;
     phone?: string;
+    name?: string;
     source?: string;
     leadType?: 'sales' | 'service' | 'others' | number;
     referrerLink?: string;
-  }): Promise<unknown>;
+    description?: string;
+  }): Promise<{ status: string; data?: unknown; message?: string } | null>;
   updateLead(payload: {
     leadId: string;
     email?: string;
@@ -290,6 +308,7 @@ export const LeadModel: {
     source?: string;
     leadType?: 'sales' | 'service' | 'others' | number;
     referrerLink?: string;
+    description?: string;
   }): Promise<unknown>;
   deleteLead(leadId: string): Promise<{ status: string; data?: unknown; message?: string }>;
   requestExport(
@@ -450,6 +469,7 @@ export function createRootStore(initialState?: object): unknown;
 export const Unit: Record<string, number>;
 export const AssignmentMethod: Record<string, number>;
 export const AttendeeStatus: Record<string, number>;
+export const EventStatus: Record<string, number>;
 export const RecurringFrequency: Record<string, number>;
 export const DayOfWeek: Record<string, number>;
 export const LocationType: Record<string, number>;

package/dist/index.js

@@ -39,6 +39,8 @@ __export(index_exports, {
   EmailProvider: () => EmailProvider,
   EventModel: () => Event_default,
   EventSource: () => EventSource,
+  EventStatus: () => EventStatus,
+  ExternalEventModel: () => ExternalEvent_default,
   FlowModel: () => Flow_default,
   LeadModel: () => Lead_default,
   LocationType: () => LocationType,
@@ -338,6 +340,12 @@ var AttendeeStatus = {
   NeedsAction: 4,
   Canceled: 5
 };
+var EventStatus = {
+  Scheduled: 1,
+  ReScheduled: 2,
+  Completed: 3,
+  Canceled: 4
+};
 var RecurringFrequency = {
   None: 0,
   Daily: 1,
@@ -488,6 +496,7 @@ var EventModel = import_mobx_state_tree4.types.model("Event", {
   flowId: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   flowPath: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   attendeeStatus: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.number, AttendeeStatus.Tentative),
+  status: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.number), null),
   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),
@@ -626,6 +635,18 @@ var EventModel = import_mobx_state_tree4.types.model("Event", {
     async setAttendeeStatus(status) {
       const statusName = typeof status === "number" ? Object.keys(AttendeeStatus).find((k) => AttendeeStatus[k] === status) ?? "None" : status;
       return reqGet(`/event/${encodeURIComponent(self.eventId)}/${encodeURIComponent(statusName)}`);
+    },
+    /** GET /event/status/update – update event lifecycle status */
+    async setEventStatus(status) {
+      const statusValue = typeof status === "number" ? status : EventStatus[status] ?? status;
+      const res = await reqGet("/event/status/update", {
+        event_id: self.eventId,
+        status: statusValue
+      });
+      if (res.status === "success" && res.data) {
+        (0, import_mobx_state_tree4.applySnapshot)(self, { ...mapEventFromApi(res.data), eventId: self.eventId });
+      }
+      return res;
     }
   };
 });
@@ -658,6 +679,7 @@ function mapEventFromApi(d) {
     flowId: pick2("flowId", "FlowId", "flow_id"),
     flowPath: pick2("flowPath", "FlowPath", "flow_path"),
     attendeeStatus: n(pick2("attendeeStatus", "AttendeeStatus", "attendee_status")),
+    status: n(pick2("status", "Status")),
     eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
@@ -757,6 +779,7 @@ async function getByFiltersInternal(path, companyKey, opts = {}, dateRange = nul
   if (opts.title != null && opts.title !== "") query.title = opts.title;
   if (opts.search != null && opts.search !== "") query.search = opts.search;
   if (opts.attendeeStatus != null && opts.attendeeStatus !== "") query.attendee_status = opts.attendeeStatus;
+  if (opts.status != null && opts.status !== "") query.status = opts.status;
   if (opts.eventSource != null && opts.eventSource !== "") query.event_source = opts.eventSource;
   const sortBy = opts.sortBy ?? opts.sort ?? opts.sort_column;
   if (sortBy != null && sortBy !== "") query.sort = sortBy;
@@ -765,12 +788,17 @@ async function getByFiltersInternal(path, companyKey, opts = {}, dateRange = nul
     const u = String(sortOrderRaw).trim().toUpperCase();
     query.sort_dir = u.startsWith("DESC") ? "desc" : "asc";
   }
-  if (opts.page != null) {
-    query.page = opts.page;
-    if (opts.page_size != null) query.page_size = opts.page_size;
+  const pageSize = opts.page_size ?? opts.pageSize;
+  const pageNum = opts.page != null ? Number(opts.page) : null;
+  const hasSkipTake = opts.skip != null || opts.take != null;
+  const usePageMode = pageNum != null && pageNum >= 1 && !hasSkipTake;
+  if (usePageMode) {
+    query.page = pageNum;
+    if (pageSize != null) query.page_size = pageSize;
   } else {
     if (opts.skip != null) query.skip = opts.skip;
-    if (opts.take != null) query.take = opts.take;
+    const take = opts.take ?? (pageSize != null && !hasSkipTake ? pageSize : null);
+    if (take != null) query.take = take;
   }
   const res = await reqGet(path, query, { headers: { offset: String(offset) } });
   if (res.status !== "success") {
@@ -889,6 +917,11 @@ EventModel.setAttendeeStatus = async (eventId, attendeeStatus) => {
   const statusName = typeof attendeeStatus === "number" ? Object.keys(AttendeeStatus).find((k) => AttendeeStatus[k] === attendeeStatus) ?? "None" : attendeeStatus;
   return reqGet(`/event/${encodeURIComponent(eventId)}/${encodeURIComponent(statusName)}`);
 };
+EventModel.setEventStatus = async (eventId, status) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const statusValue = typeof status === "number" ? status : EventStatus[status] ?? status;
+  return reqGet("/event/status/update", { event_id: eventId, status: statusValue });
+};
 var Event_default = EventModel;
 
 // src/models/appointment/CalendarParticipant.js
@@ -1686,30 +1719,96 @@ var OpeningHourModel = import_mobx_state_tree12.types.model("OpeningHour", {
 });
 var OpeningHour_default = OpeningHourModel;
 
-// src/models/appointment/Setting.js
+// src/models/appointment/ExternalEvent.js
 var import_mobx_state_tree13 = require("mobx-state-tree");
-var SettingModel = import_mobx_state_tree13.types.model("Setting", {
-  id: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.number), null),
-  settingsId: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.string, ""),
-  calendarId: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.string, ""),
-  logo: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.string), null),
-  theme: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.string), null),
-  schedulingButtonText: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.string), null),
-  scheduledMessage: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.string), null)
+function getDefaultOffset2() {
+  var _a;
+  const cfg = getConfig();
+  return ((_a = cfg == null ? void 0 : cfg.getDefaultOffset) == null ? void 0 : _a.call(cfg)) ?? -(/* @__PURE__ */ new Date()).getTimezoneOffset();
+}
+function pickStr(obj, ...keys) {
+  for (const k of keys) {
+    const v = obj[k];
+    if (v != null && typeof v === "string") return v;
+  }
+  return void 0;
+}
+function pickNum(obj, ...keys) {
+  for (const k of keys) {
+    const v = obj[k];
+    if (v != null) {
+      const n = typeof v === "number" ? v : Number(v);
+      if (!Number.isNaN(n)) return n;
+    }
+  }
+  return void 0;
+}
+function toIsoDate(value) {
+  if (value == null || value === "") return "";
+  if (typeof value === "string") return value;
+  if (value instanceof Date) return value.toISOString();
+  return String(value);
+}
+var ExternalEventModel = import_mobx_state_tree13.types.model("ExternalEvent", {
+  title: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.maybeNull(import_mobx_state_tree13.types.string), null),
+  startDate: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.string, ""),
+  endDate: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.string, ""),
+  startHour: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.number, 0),
+  startMinute: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.number, 0),
+  endHour: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.number, 0),
+  endMinute: import_mobx_state_tree13.types.optional(import_mobx_state_tree13.types.number, 0)
+});
+function mapApiRow(row) {
+  return ExternalEventModel.create({
+    title: pickStr(row, "title", "Title") ?? null,
+    startDate: toIsoDate(row.startDate ?? row.StartDate),
+    endDate: toIsoDate(row.endDate ?? row.EndDate),
+    startHour: pickNum(row, "startHour", "StartHour") ?? 0,
+    startMinute: pickNum(row, "startMinute", "StartMinute") ?? 0,
+    endHour: pickNum(row, "endHour", "EndHour") ?? 0,
+    endMinute: pickNum(row, "endMinute", "EndMinute") ?? 0
+  });
+}
+ExternalEventModel.getByParticipant = async (participantId, opts = {}) => {
+  if (!participantId) throw new Error("participantId required");
+  const { req } = createRequestHelpersFromEnv(getConfig());
+  const offset = opts.offset ?? getDefaultOffset2();
+  const res = await req("/externalcalendar/events/get", {
+    method: "GET",
+    query: { participant_id: participantId },
+    headers: { offset: String(offset) }
+  });
+  if (res.status === "success" && Array.isArray(res.data)) {
+    return res.data.map(mapApiRow);
+  }
+  return [];
+};
+var ExternalEvent_default = ExternalEventModel;
+
+// src/models/appointment/Setting.js
+var import_mobx_state_tree14 = require("mobx-state-tree");
+var SettingModel = import_mobx_state_tree14.types.model("Setting", {
+  id: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.number), null),
+  settingsId: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.string, ""),
+  calendarId: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.string, ""),
+  logo: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null),
+  theme: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null),
+  schedulingButtonText: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null),
+  scheduledMessage: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree13.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree14.getEnv);
   return {
     /** GET setting/get – fetch setting for this calendar */
     async get() {
       const res = await reqGet("/setting/get", { calendar_id: self.calendarId });
-      if (res.status === "success" && res.data) (0, import_mobx_state_tree13.applySnapshot)(self, mapFromApi3(res.data));
+      if (res.status === "success" && res.data) (0, import_mobx_state_tree14.applySnapshot)(self, mapFromApi3(res.data));
       return res;
     },
     /** POST setting/save – save this setting */
     async save() {
       const payload = toPayload2(self);
       const res = await reqPost("/setting/save", payload);
-      if (res.status === "success" && res.data) (0, import_mobx_state_tree13.applySnapshot)(self, mapFromApi3(res.data));
+      if (res.status === "success" && res.data) (0, import_mobx_state_tree14.applySnapshot)(self, mapFromApi3(res.data));
       return res;
     },
     /** POST setting/logo/upload – upload logo file for this calendar */
@@ -1784,27 +1883,27 @@ SettingModel.uploadLogo = async (calendarId, file) => {
 var Setting_default = SettingModel;
 
 // src/models/appointment/Company.js
-var import_mobx_state_tree14 = require("mobx-state-tree");
-var CompanyModel = import_mobx_state_tree14.types.model("Company", {
-  id: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.number), null),
-  companyKey: import_mobx_state_tree14.types.identifier,
-  companyName: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.string, ""),
-  createdOn: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null),
-  modifiedOn: import_mobx_state_tree14.types.optional(import_mobx_state_tree14.types.maybeNull(import_mobx_state_tree14.types.string), null)
+var import_mobx_state_tree15 = require("mobx-state-tree");
+var CompanyModel = import_mobx_state_tree15.types.model("Company", {
+  id: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.number), null),
+  companyKey: import_mobx_state_tree15.types.identifier,
+  companyName: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.string, ""),
+  createdOn: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null),
+  modifiedOn: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree14.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree15.getEnv);
   return {
     /** GET Company/Get – fetch this company */
     async get() {
       const res = await reqGet("/Company/Get", { company_key: self.companyKey });
-      if (res.status === "success" && res.data) (0, import_mobx_state_tree14.applySnapshot)(self, mapFromApi4(res.data));
+      if (res.status === "success" && res.data) (0, import_mobx_state_tree15.applySnapshot)(self, mapFromApi4(res.data));
       return res;
     },
     /** POST Company/Save – save this company */
     async save() {
       const payload = toPayload3(self);
       const res = await reqPost("/Company/Save", payload);
-      if (res.status === "success" && res.data) (0, import_mobx_state_tree14.applySnapshot)(self, mapFromApi4(res.data));
+      if (res.status === "success" && res.data) (0, import_mobx_state_tree15.applySnapshot)(self, mapFromApi4(res.data));
       return res;
     }
   };
@@ -1852,13 +1951,13 @@ CompanyModel.save = async (payload) => {
 var Company_default = CompanyModel;
 
 // src/models/appointment/Asset.js
-var import_mobx_state_tree15 = require("mobx-state-tree");
-var AssetModel = import_mobx_state_tree15.types.model("Asset", {
-  url: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null),
-  blobPath: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null),
-  category: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null),
-  contentType: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.string), null),
-  size: import_mobx_state_tree15.types.optional(import_mobx_state_tree15.types.maybeNull(import_mobx_state_tree15.types.number), null)
+var import_mobx_state_tree16 = require("mobx-state-tree");
+var AssetModel = import_mobx_state_tree16.types.model("Asset", {
+  url: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  blobPath: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  category: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  contentType: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  size: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.number), null)
 }).actions((self) => ({
   /** POST /asset/upload – upload file using model category. */
   async upload(file, opts = {}) {
@@ -1932,7 +2031,7 @@ AssetModel.upload = async (file, opts = {}) => {
 var Asset_default = AssetModel;
 
 // src/models/appointment/CalendarLocation.js
-var import_mobx_state_tree16 = require("mobx-state-tree");
+var import_mobx_state_tree17 = require("mobx-state-tree");
 function mapCalendarLocationFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -1962,19 +2061,19 @@ function toPayload4(self) {
     sortOrder: self.sortOrder
   };
 }
-var CalendarLocationModel = import_mobx_state_tree16.types.model("CalendarLocation", {
-  id: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.number), null),
-  calendarLocationId: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
-  calendarId: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
-  locationType: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.number, LocationType.Physical),
-  name: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.string, ""),
-  value: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.string, ""),
-  isDefault: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.boolean, false),
-  sortOrder: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.number, 0),
-  createdOn: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
-  modifiedOn: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null)
+var CalendarLocationModel = import_mobx_state_tree17.types.model("CalendarLocation", {
+  id: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.number), null),
+  calendarLocationId: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null),
+  calendarId: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null),
+  locationType: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.number, LocationType.Physical),
+  name: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
+  value: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
+  isDefault: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.boolean, false),
+  sortOrder: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.number, 0),
+  createdOn: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null),
+  modifiedOn: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree16.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree17.getEnv);
   return {
     /** GET Calendar/Location/Get – list locations by calendar id */
     async getByCalendar(calendarId) {
@@ -1992,7 +2091,7 @@ var CalendarLocationModel = import_mobx_state_tree16.types.model("CalendarLocati
     async save() {
       const res = await reqPost("/Calendar/Location/Save", toPayload4(self));
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree16.applySnapshot)(self, mapCalendarLocationFromApi(res.data));
+        (0, import_mobx_state_tree17.applySnapshot)(self, mapCalendarLocationFromApi(res.data));
       }
       return res;
     },
@@ -2054,7 +2153,7 @@ CalendarLocationModel.setDefault = async (calendarId, calendarLocationId) => {
 var CalendarLocation_default = CalendarLocationModel;
 
 // src/models/appointment/Preference.js
-var import_mobx_state_tree17 = require("mobx-state-tree");
+var import_mobx_state_tree18 = require("mobx-state-tree");
 var PreferenceScope = {
   Global: 0,
   Consumer: 1,
@@ -2065,13 +2164,13 @@ var PreferenceScope = {
   User: 6
 };
 var SCOPE_NAMES = ["Global", "Consumer", "Company", "Calendar", "Event", "Participant", "User"];
-var PreferenceModel = import_mobx_state_tree17.types.model("Preference", {
-  id: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.number), null),
-  preferenceId: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null),
-  level: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.number, 0),
-  primaryKey: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
-  preferenceOption: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
-  optionsJson: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string), null)
+var PreferenceModel = import_mobx_state_tree18.types.model("Preference", {
+  id: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.number), null),
+  preferenceId: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
+  level: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.number, 0),
+  primaryKey: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.string, ""),
+  preferenceOption: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.string, ""),
+  optionsJson: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null)
 }).actions((self) => ({
   /** POST /preference/{scope}/{key}/{option} – save this preference to the API. */
   async save() {
@@ -2119,7 +2218,7 @@ PreferenceModel.delete = async (preferenceId) => {
 var Preference_default = PreferenceModel;
 
 // src/models/appointment/Flow.js
-var import_mobx_state_tree18 = require("mobx-state-tree");
+var import_mobx_state_tree19 = require("mobx-state-tree");
 function mapFlowFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -2138,27 +2237,27 @@ function mapFlowFromApi(d) {
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on") ?? null
   };
 }
-var FlowModel = import_mobx_state_tree18.types.model("Flow", {
-  id: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.number), null),
-  flowId: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.identifier, "new"),
-  companyKey: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
-  calendarId: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
-  name: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
-  description: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
-  flowJson: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.string, ""),
-  isActive: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.boolean, true),
-  isDeleted: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.boolean, false),
-  createdOn: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null),
-  modifiedOn: import_mobx_state_tree18.types.optional(import_mobx_state_tree18.types.maybeNull(import_mobx_state_tree18.types.string), null)
+var FlowModel = import_mobx_state_tree19.types.model("Flow", {
+  id: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.number), null),
+  flowId: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.identifier, "new"),
+  companyKey: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
+  calendarId: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
+  name: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
+  description: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
+  flowJson: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
+  isActive: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.boolean, true),
+  isDeleted: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.boolean, false),
+  createdOn: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
+  modifiedOn: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree18.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree19.getEnv);
   return {
     /** GET flow/get – fetch this flow by flowId */
     async get() {
       if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       const res = await reqGet("/flow/get", { flow_id: self.flowId });
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree18.applySnapshot)(self, mapFlowFromApi(res.data));
+        (0, import_mobx_state_tree19.applySnapshot)(self, mapFlowFromApi(res.data));
       }
       return res;
     },
@@ -2174,7 +2273,7 @@ var FlowModel = import_mobx_state_tree18.types.model("Flow", {
       };
       const res = await reqPost("/flow/create", payload);
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree18.applySnapshot)(self, mapFlowFromApi(res.data));
+        (0, import_mobx_state_tree19.applySnapshot)(self, mapFlowFromApi(res.data));
       }
       return res;
     },
@@ -2191,7 +2290,7 @@ var FlowModel = import_mobx_state_tree18.types.model("Flow", {
       };
       const res = await reqPost("/flow/update", payload);
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree18.applySnapshot)(self, mapFlowFromApi(res.data));
+        (0, import_mobx_state_tree19.applySnapshot)(self, mapFlowFromApi(res.data));
       }
       return res;
     },
@@ -2205,7 +2304,7 @@ var FlowModel = import_mobx_state_tree18.types.model("Flow", {
       if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       const res = await reqPost("/flow/duplicate", { flow_id: self.flowId, new_name: newName ?? void 0 });
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree18.applySnapshot)(self, mapFlowFromApi(res.data));
+        (0, import_mobx_state_tree19.applySnapshot)(self, mapFlowFromApi(res.data));
       }
       return res;
     },
@@ -2382,7 +2481,20 @@ FlowModel.getPreview = async (flowId) => {
 var Flow_default = FlowModel;
 
 // src/models/appointment/Lead.js
-var import_mobx_state_tree19 = require("mobx-state-tree");
+var import_mobx_state_tree20 = require("mobx-state-tree");
+function pickLeadCreateContact(payload) {
+  const p = payload ?? {};
+  const email = String(p.email ?? p.Email ?? "").trim();
+  const phone = String(p.phone ?? p.Phone ?? "").trim();
+  const companyKey = String(p.companyKey ?? p.company_key ?? p.CompanyKey ?? "").trim();
+  return { email, phone, companyKey };
+}
+function validateLeadCreatePayload(payload) {
+  const { email, phone, companyKey } = pickLeadCreateContact(payload);
+  if (!companyKey) return { ok: false, message: "companyKey is required" };
+  if (!email && !phone) return { ok: false, message: "email or phone is required" };
+  return { ok: true };
+}
 function mapLeadFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -2407,31 +2519,33 @@ function mapLeadFromApi(d) {
     source: pick2("source", "Source") ?? "",
     leadType,
     referrerLink: pick2("referrerLink", "ReferrerLink", "referrer_link") ?? "",
+    description: pick2("description", "Description") ?? "",
     createdOn: pick2("createdOn", "CreatedOn", "created_on") ?? null,
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on") ?? null
   };
 }
-var LeadModel = import_mobx_state_tree19.types.model("Lead", {
-  id: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.number), null),
-  leadId: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.identifier, "new"),
-  email: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  name: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  phone: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  companyKey: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  source: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  leadType: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.number, 2),
-  referrerLink: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.string, ""),
-  createdOn: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null),
-  modifiedOn: import_mobx_state_tree19.types.optional(import_mobx_state_tree19.types.maybeNull(import_mobx_state_tree19.types.string), null)
+var LeadModel = import_mobx_state_tree20.types.model("Lead", {
+  id: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.number), null),
+  leadId: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.identifier, "new"),
+  email: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  name: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  phone: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  companyKey: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  source: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  leadType: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.number, 2),
+  referrerLink: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  description: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
+  createdOn: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
+  modifiedOn: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree19.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree20.getEnv);
   return {
     /** GET /lead/get – fetch this lead by leadId */
     async get() {
       if (!self.leadId || self.leadId === "new") return { status: "failure", message: "leadId required" };
       const res = await reqGet("/lead/get", { lead_id: self.leadId });
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree19.applySnapshot)(self, mapLeadFromApi(res.data));
+        (0, import_mobx_state_tree20.applySnapshot)(self, mapLeadFromApi(res.data));
       }
       return res;
     },
@@ -2442,7 +2556,7 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
       }
       const lead = await LeadModel.getByEmail(self.email, self.companyKey);
       if (lead) {
-        (0, import_mobx_state_tree19.applySnapshot)(self, (0, import_mobx_state_tree19.getSnapshot)(lead));
+        (0, import_mobx_state_tree20.applySnapshot)(self, (0, import_mobx_state_tree20.getSnapshot)(lead));
       }
       return { status: lead ? "success" : "failure", data: lead ?? void 0 };
     },
@@ -2453,7 +2567,7 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
       }
       const lead = await LeadModel.getByPhone(self.phone, self.companyKey);
       if (lead) {
-        (0, import_mobx_state_tree19.applySnapshot)(self, (0, import_mobx_state_tree19.getSnapshot)(lead));
+        (0, import_mobx_state_tree20.applySnapshot)(self, (0, import_mobx_state_tree20.getSnapshot)(lead));
       }
       return { status: lead ? "success" : "failure", data: lead ?? void 0 };
     },
@@ -2470,8 +2584,14 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
     async getColumnSelection(userId) {
       return LeadModel.getColumnSelection(userId);
     },
-    /** POST /lead/create – create this lead */
+    /** POST /lead/create – create this lead (requires companyKey and email or phone) */
     async createLead() {
+      const validation = validateLeadCreatePayload({
+        email: self.email,
+        phone: self.phone,
+        companyKey: self.companyKey
+      });
+      if (!validation.ok) return { status: "failure", message: validation.message };
       const payload = {
         email: self.email,
         name: self.name,
@@ -2479,11 +2599,12 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
         companyKey: self.companyKey,
         source: self.source,
         leadType: self.leadType,
-        referrerLink: self.referrerLink
+        referrerLink: self.referrerLink,
+        description: self.description
       };
       const res = await reqPost("/lead/create", payload);
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree19.applySnapshot)(self, mapLeadFromApi(res.data));
+        (0, import_mobx_state_tree20.applySnapshot)(self, mapLeadFromApi(res.data));
       }
       return res;
     },
@@ -2500,11 +2621,12 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
         companyKey: self.companyKey,
         source: self.source,
         leadType: self.leadType,
-        referrerLink: self.referrerLink
+        referrerLink: self.referrerLink,
+        description: self.description
       };
       const res = await reqPost("/lead/update", payload);
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree19.applySnapshot)(self, mapLeadFromApi(res.data));
+        (0, import_mobx_state_tree20.applySnapshot)(self, mapLeadFromApi(res.data));
       }
       return res;
     },
@@ -2568,6 +2690,7 @@ LeadModel.allowedColumns = [
   "source",
   "lead_type",
   "referrer_link",
+  "description",
   "created_on",
   "modified_on"
 ];
@@ -2621,6 +2744,8 @@ LeadModel.getByCompany = async (companyKey, opts = {}) => {
   return null;
 };
 LeadModel.createLead = async (payload) => {
+  const validation = validateLeadCreatePayload(payload);
+  if (!validation.ok) return { status: "failure", message: validation.message };
   const { reqPost } = createRequestHelpersFromEnv(getConfig());
   const res = await reqPost("/lead/create", payload);
   if (res.status === "success" && res.data) {
@@ -2676,19 +2801,19 @@ LeadModel.getSources = async (companyKey) => {
 var Lead_default = LeadModel;
 
 // src/models/appointment/CustomField.js
-var import_mobx_state_tree20 = require("mobx-state-tree");
-var CustomFieldModel = import_mobx_state_tree20.types.model("CustomField", {
-  id: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.number), null),
-  customFieldId: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
-  calendarId: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
-  label: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
-  type: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.string, ""),
-  isRequired: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.boolean, false),
-  createdOn: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
-  modifiedOn: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.maybeNull(import_mobx_state_tree20.types.string), null),
-  isDeleted: import_mobx_state_tree20.types.optional(import_mobx_state_tree20.types.boolean, false)
+var import_mobx_state_tree21 = require("mobx-state-tree");
+var CustomFieldModel = import_mobx_state_tree21.types.model("CustomField", {
+  id: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.number), null),
+  customFieldId: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.string), null),
+  calendarId: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.string), null),
+  label: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.string), null),
+  type: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.string, ""),
+  isRequired: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.boolean, false),
+  createdOn: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.string), null),
+  modifiedOn: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.maybeNull(import_mobx_state_tree21.types.string), null),
+  isDeleted: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.boolean, false)
 }).actions((self) => {
-  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree20.getEnv);
+  const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree21.getEnv);
   return {
     /** GET /CustomField/GetAll?calendar_id= */
     async getAll(calendarId) {
@@ -2709,7 +2834,7 @@ var CustomFieldModel = import_mobx_state_tree20.types.model("CustomField", {
       const body = payload ?? toPayload5(self);
       const res = await reqPost("/CustomField/Add", body);
       if (res.status === "success" && res.data) {
-        (0, import_mobx_state_tree20.applySnapshot)(self, mapCustomFieldFromApi(res.data));
+        (0, import_mobx_state_tree21.applySnapshot)(self, mapCustomFieldFromApi(res.data));
       }
       return res;
     },
@@ -3016,10 +3141,10 @@ var AuthModel = {
 var Auth_default = AuthModel;
 
 // src/models/appointment/index.js
-var import_mobx_state_tree21 = require("mobx-state-tree");
-var RootStore = import_mobx_state_tree21.types.model("RootStore", {
-  calendars: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.map(Calendar_default), {}),
-  events: import_mobx_state_tree21.types.optional(import_mobx_state_tree21.types.map(Event_default), {})
+var import_mobx_state_tree22 = require("mobx-state-tree");
+var RootStore = import_mobx_state_tree22.types.model("RootStore", {
+  calendars: import_mobx_state_tree22.types.optional(import_mobx_state_tree22.types.map(Calendar_default), {}),
+  events: import_mobx_state_tree22.types.optional(import_mobx_state_tree22.types.map(Event_default), {})
 }).actions((self) => ({
   addCalendar(snapshot) {
     const cal = Calendar_default.create(snapshot);
@@ -3059,6 +3184,8 @@ function createRootStore(initialState = {}) {
   EmailProvider,
   EventModel,
   EventSource,
+  EventStatus,
+  ExternalEventModel,
   FlowModel,
   LeadModel,
   LocationType,

package/dist/index.mjs

@@ -266,6 +266,12 @@ var AttendeeStatus = {
   NeedsAction: 4,
   Canceled: 5
 };
+var EventStatus = {
+  Scheduled: 1,
+  ReScheduled: 2,
+  Completed: 3,
+  Canceled: 4
+};
 var RecurringFrequency = {
   None: 0,
   Daily: 1,
@@ -416,6 +422,7 @@ var EventModel = types4.model("Event", {
   flowId: types4.optional(types4.maybeNull(types4.string), null),
   flowPath: types4.optional(types4.maybeNull(types4.string), null),
   attendeeStatus: types4.optional(types4.number, AttendeeStatus.Tentative),
+  status: types4.optional(types4.maybeNull(types4.number), null),
   rescheduleLink: types4.optional(types4.maybeNull(types4.string), null),
   cancelLink: types4.optional(types4.maybeNull(types4.string), null),
   timeZone: types4.optional(types4.maybeNull(types4.string), null),
@@ -554,6 +561,18 @@ var EventModel = types4.model("Event", {
     async setAttendeeStatus(status) {
       const statusName = typeof status === "number" ? Object.keys(AttendeeStatus).find((k) => AttendeeStatus[k] === status) ?? "None" : status;
       return reqGet(`/event/${encodeURIComponent(self.eventId)}/${encodeURIComponent(statusName)}`);
+    },
+    /** GET /event/status/update – update event lifecycle status */
+    async setEventStatus(status) {
+      const statusValue = typeof status === "number" ? status : EventStatus[status] ?? status;
+      const res = await reqGet("/event/status/update", {
+        event_id: self.eventId,
+        status: statusValue
+      });
+      if (res.status === "success" && res.data) {
+        applySnapshot(self, { ...mapEventFromApi(res.data), eventId: self.eventId });
+      }
+      return res;
     }
   };
 });
@@ -586,6 +605,7 @@ function mapEventFromApi(d) {
     flowId: pick2("flowId", "FlowId", "flow_id"),
     flowPath: pick2("flowPath", "FlowPath", "flow_path"),
     attendeeStatus: n(pick2("attendeeStatus", "AttendeeStatus", "attendee_status")),
+    status: n(pick2("status", "Status")),
     eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
@@ -685,6 +705,7 @@ async function getByFiltersInternal(path, companyKey, opts = {}, dateRange = nul
   if (opts.title != null && opts.title !== "") query.title = opts.title;
   if (opts.search != null && opts.search !== "") query.search = opts.search;
   if (opts.attendeeStatus != null && opts.attendeeStatus !== "") query.attendee_status = opts.attendeeStatus;
+  if (opts.status != null && opts.status !== "") query.status = opts.status;
   if (opts.eventSource != null && opts.eventSource !== "") query.event_source = opts.eventSource;
   const sortBy = opts.sortBy ?? opts.sort ?? opts.sort_column;
   if (sortBy != null && sortBy !== "") query.sort = sortBy;
@@ -693,12 +714,17 @@ async function getByFiltersInternal(path, companyKey, opts = {}, dateRange = nul
     const u = String(sortOrderRaw).trim().toUpperCase();
     query.sort_dir = u.startsWith("DESC") ? "desc" : "asc";
   }
-  if (opts.page != null) {
-    query.page = opts.page;
-    if (opts.page_size != null) query.page_size = opts.page_size;
+  const pageSize = opts.page_size ?? opts.pageSize;
+  const pageNum = opts.page != null ? Number(opts.page) : null;
+  const hasSkipTake = opts.skip != null || opts.take != null;
+  const usePageMode = pageNum != null && pageNum >= 1 && !hasSkipTake;
+  if (usePageMode) {
+    query.page = pageNum;
+    if (pageSize != null) query.page_size = pageSize;
   } else {
     if (opts.skip != null) query.skip = opts.skip;
-    if (opts.take != null) query.take = opts.take;
+    const take = opts.take ?? (pageSize != null && !hasSkipTake ? pageSize : null);
+    if (take != null) query.take = take;
   }
   const res = await reqGet(path, query, { headers: { offset: String(offset) } });
   if (res.status !== "success") {
@@ -817,6 +843,11 @@ EventModel.setAttendeeStatus = async (eventId, attendeeStatus) => {
   const statusName = typeof attendeeStatus === "number" ? Object.keys(AttendeeStatus).find((k) => AttendeeStatus[k] === attendeeStatus) ?? "None" : attendeeStatus;
   return reqGet(`/event/${encodeURIComponent(eventId)}/${encodeURIComponent(statusName)}`);
 };
+EventModel.setEventStatus = async (eventId, status) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const statusValue = typeof status === "number" ? status : EventStatus[status] ?? status;
+  return reqGet("/event/status/update", { event_id: eventId, status: statusValue });
+};
 var Event_default = EventModel;
 
 // src/models/appointment/CalendarParticipant.js
@@ -1614,16 +1645,82 @@ var OpeningHourModel = types12.model("OpeningHour", {
 });
 var OpeningHour_default = OpeningHourModel;
 
+// src/models/appointment/ExternalEvent.js
+import { types as types13 } from "mobx-state-tree";
+function getDefaultOffset2() {
+  var _a;
+  const cfg = getConfig();
+  return ((_a = cfg == null ? void 0 : cfg.getDefaultOffset) == null ? void 0 : _a.call(cfg)) ?? -(/* @__PURE__ */ new Date()).getTimezoneOffset();
+}
+function pickStr(obj, ...keys) {
+  for (const k of keys) {
+    const v = obj[k];
+    if (v != null && typeof v === "string") return v;
+  }
+  return void 0;
+}
+function pickNum(obj, ...keys) {
+  for (const k of keys) {
+    const v = obj[k];
+    if (v != null) {
+      const n = typeof v === "number" ? v : Number(v);
+      if (!Number.isNaN(n)) return n;
+    }
+  }
+  return void 0;
+}
+function toIsoDate(value) {
+  if (value == null || value === "") return "";
+  if (typeof value === "string") return value;
+  if (value instanceof Date) return value.toISOString();
+  return String(value);
+}
+var ExternalEventModel = types13.model("ExternalEvent", {
+  title: types13.optional(types13.maybeNull(types13.string), null),
+  startDate: types13.optional(types13.string, ""),
+  endDate: types13.optional(types13.string, ""),
+  startHour: types13.optional(types13.number, 0),
+  startMinute: types13.optional(types13.number, 0),
+  endHour: types13.optional(types13.number, 0),
+  endMinute: types13.optional(types13.number, 0)
+});
+function mapApiRow(row) {
+  return ExternalEventModel.create({
+    title: pickStr(row, "title", "Title") ?? null,
+    startDate: toIsoDate(row.startDate ?? row.StartDate),
+    endDate: toIsoDate(row.endDate ?? row.EndDate),
+    startHour: pickNum(row, "startHour", "StartHour") ?? 0,
+    startMinute: pickNum(row, "startMinute", "StartMinute") ?? 0,
+    endHour: pickNum(row, "endHour", "EndHour") ?? 0,
+    endMinute: pickNum(row, "endMinute", "EndMinute") ?? 0
+  });
+}
+ExternalEventModel.getByParticipant = async (participantId, opts = {}) => {
+  if (!participantId) throw new Error("participantId required");
+  const { req } = createRequestHelpersFromEnv(getConfig());
+  const offset = opts.offset ?? getDefaultOffset2();
+  const res = await req("/externalcalendar/events/get", {
+    method: "GET",
+    query: { participant_id: participantId },
+    headers: { offset: String(offset) }
+  });
+  if (res.status === "success" && Array.isArray(res.data)) {
+    return res.data.map(mapApiRow);
+  }
+  return [];
+};
+var ExternalEvent_default = ExternalEventModel;
+
 // src/models/appointment/Setting.js
-import { types as types13, getEnv as getEnv4, applySnapshot as applySnapshot4 } from "mobx-state-tree";
-var SettingModel = types13.model("Setting", {
-  id: types13.optional(types13.maybeNull(types13.number), null),
-  settingsId: types13.optional(types13.string, ""),
-  calendarId: types13.optional(types13.string, ""),
-  logo: types13.optional(types13.maybeNull(types13.string), null),
-  theme: types13.optional(types13.maybeNull(types13.string), null),
-  schedulingButtonText: types13.optional(types13.maybeNull(types13.string), null),
-  scheduledMessage: types13.optional(types13.maybeNull(types13.string), null)
+import { types as types14, getEnv as getEnv4, applySnapshot as applySnapshot4 } from "mobx-state-tree";
+var SettingModel = types14.model("Setting", {
+  id: types14.optional(types14.maybeNull(types14.number), null),
+  settingsId: types14.optional(types14.string, ""),
+  calendarId: types14.optional(types14.string, ""),
+  logo: types14.optional(types14.maybeNull(types14.string), null),
+  theme: types14.optional(types14.maybeNull(types14.string), null),
+  schedulingButtonText: types14.optional(types14.maybeNull(types14.string), null),
+  scheduledMessage: types14.optional(types14.maybeNull(types14.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv4);
   return {
@@ -1712,13 +1809,13 @@ SettingModel.uploadLogo = async (calendarId, file) => {
 var Setting_default = SettingModel;
 
 // src/models/appointment/Company.js
-import { types as types14, getEnv as getEnv5, applySnapshot as applySnapshot5 } from "mobx-state-tree";
-var CompanyModel = types14.model("Company", {
-  id: types14.optional(types14.maybeNull(types14.number), null),
-  companyKey: types14.identifier,
-  companyName: types14.optional(types14.string, ""),
-  createdOn: types14.optional(types14.maybeNull(types14.string), null),
-  modifiedOn: types14.optional(types14.maybeNull(types14.string), null)
+import { types as types15, getEnv as getEnv5, applySnapshot as applySnapshot5 } from "mobx-state-tree";
+var CompanyModel = types15.model("Company", {
+  id: types15.optional(types15.maybeNull(types15.number), null),
+  companyKey: types15.identifier,
+  companyName: types15.optional(types15.string, ""),
+  createdOn: types15.optional(types15.maybeNull(types15.string), null),
+  modifiedOn: types15.optional(types15.maybeNull(types15.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv5);
   return {
@@ -1780,13 +1877,13 @@ CompanyModel.save = async (payload) => {
 var Company_default = CompanyModel;
 
 // src/models/appointment/Asset.js
-import { types as types15, getEnv as getEnv6 } from "mobx-state-tree";
-var AssetModel = types15.model("Asset", {
-  url: types15.optional(types15.maybeNull(types15.string), null),
-  blobPath: types15.optional(types15.maybeNull(types15.string), null),
-  category: types15.optional(types15.maybeNull(types15.string), null),
-  contentType: types15.optional(types15.maybeNull(types15.string), null),
-  size: types15.optional(types15.maybeNull(types15.number), null)
+import { types as types16, getEnv as getEnv6 } from "mobx-state-tree";
+var AssetModel = types16.model("Asset", {
+  url: types16.optional(types16.maybeNull(types16.string), null),
+  blobPath: types16.optional(types16.maybeNull(types16.string), null),
+  category: types16.optional(types16.maybeNull(types16.string), null),
+  contentType: types16.optional(types16.maybeNull(types16.string), null),
+  size: types16.optional(types16.maybeNull(types16.number), null)
 }).actions((self) => ({
   /** POST /asset/upload – upload file using model category. */
   async upload(file, opts = {}) {
@@ -1860,7 +1957,7 @@ AssetModel.upload = async (file, opts = {}) => {
 var Asset_default = AssetModel;
 
 // src/models/appointment/CalendarLocation.js
-import { types as types16, getEnv as getEnv7, applySnapshot as applySnapshot6 } from "mobx-state-tree";
+import { types as types17, getEnv as getEnv7, applySnapshot as applySnapshot6 } from "mobx-state-tree";
 function mapCalendarLocationFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -1890,17 +1987,17 @@ function toPayload4(self) {
     sortOrder: self.sortOrder
   };
 }
-var CalendarLocationModel = types16.model("CalendarLocation", {
-  id: types16.optional(types16.maybeNull(types16.number), null),
-  calendarLocationId: types16.optional(types16.maybeNull(types16.string), null),
-  calendarId: types16.optional(types16.maybeNull(types16.string), null),
-  locationType: types16.optional(types16.number, LocationType.Physical),
-  name: types16.optional(types16.string, ""),
-  value: types16.optional(types16.string, ""),
-  isDefault: types16.optional(types16.boolean, false),
-  sortOrder: types16.optional(types16.number, 0),
-  createdOn: types16.optional(types16.maybeNull(types16.string), null),
-  modifiedOn: types16.optional(types16.maybeNull(types16.string), null)
+var CalendarLocationModel = types17.model("CalendarLocation", {
+  id: types17.optional(types17.maybeNull(types17.number), null),
+  calendarLocationId: types17.optional(types17.maybeNull(types17.string), null),
+  calendarId: types17.optional(types17.maybeNull(types17.string), null),
+  locationType: types17.optional(types17.number, LocationType.Physical),
+  name: types17.optional(types17.string, ""),
+  value: types17.optional(types17.string, ""),
+  isDefault: types17.optional(types17.boolean, false),
+  sortOrder: types17.optional(types17.number, 0),
+  createdOn: types17.optional(types17.maybeNull(types17.string), null),
+  modifiedOn: types17.optional(types17.maybeNull(types17.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv7);
   return {
@@ -1982,7 +2079,7 @@ CalendarLocationModel.setDefault = async (calendarId, calendarLocationId) => {
 var CalendarLocation_default = CalendarLocationModel;
 
 // src/models/appointment/Preference.js
-import { types as types17 } from "mobx-state-tree";
+import { types as types18 } from "mobx-state-tree";
 var PreferenceScope = {
   Global: 0,
   Consumer: 1,
@@ -1993,13 +2090,13 @@ var PreferenceScope = {
   User: 6
 };
 var SCOPE_NAMES = ["Global", "Consumer", "Company", "Calendar", "Event", "Participant", "User"];
-var PreferenceModel = types17.model("Preference", {
-  id: types17.optional(types17.maybeNull(types17.number), null),
-  preferenceId: types17.optional(types17.maybeNull(types17.string), null),
-  level: types17.optional(types17.number, 0),
-  primaryKey: types17.optional(types17.string, ""),
-  preferenceOption: types17.optional(types17.string, ""),
-  optionsJson: types17.optional(types17.maybeNull(types17.string), null)
+var PreferenceModel = types18.model("Preference", {
+  id: types18.optional(types18.maybeNull(types18.number), null),
+  preferenceId: types18.optional(types18.maybeNull(types18.string), null),
+  level: types18.optional(types18.number, 0),
+  primaryKey: types18.optional(types18.string, ""),
+  preferenceOption: types18.optional(types18.string, ""),
+  optionsJson: types18.optional(types18.maybeNull(types18.string), null)
 }).actions((self) => ({
   /** POST /preference/{scope}/{key}/{option} – save this preference to the API. */
   async save() {
@@ -2047,7 +2144,7 @@ PreferenceModel.delete = async (preferenceId) => {
 var Preference_default = PreferenceModel;
 
 // src/models/appointment/Flow.js
-import { types as types18, getEnv as getEnv8, applySnapshot as applySnapshot7 } from "mobx-state-tree";
+import { types as types19, getEnv as getEnv8, applySnapshot as applySnapshot7 } from "mobx-state-tree";
 function mapFlowFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -2066,18 +2163,18 @@ function mapFlowFromApi(d) {
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on") ?? null
   };
 }
-var FlowModel = types18.model("Flow", {
-  id: types18.optional(types18.maybeNull(types18.number), null),
-  flowId: types18.optional(types18.identifier, "new"),
-  companyKey: types18.optional(types18.maybeNull(types18.string), null),
-  calendarId: types18.optional(types18.maybeNull(types18.string), null),
-  name: types18.optional(types18.maybeNull(types18.string), null),
-  description: types18.optional(types18.maybeNull(types18.string), null),
-  flowJson: types18.optional(types18.string, ""),
-  isActive: types18.optional(types18.boolean, true),
-  isDeleted: types18.optional(types18.boolean, false),
-  createdOn: types18.optional(types18.maybeNull(types18.string), null),
-  modifiedOn: types18.optional(types18.maybeNull(types18.string), null)
+var FlowModel = types19.model("Flow", {
+  id: types19.optional(types19.maybeNull(types19.number), null),
+  flowId: types19.optional(types19.identifier, "new"),
+  companyKey: types19.optional(types19.maybeNull(types19.string), null),
+  calendarId: types19.optional(types19.maybeNull(types19.string), null),
+  name: types19.optional(types19.maybeNull(types19.string), null),
+  description: types19.optional(types19.maybeNull(types19.string), null),
+  flowJson: types19.optional(types19.string, ""),
+  isActive: types19.optional(types19.boolean, true),
+  isDeleted: types19.optional(types19.boolean, false),
+  createdOn: types19.optional(types19.maybeNull(types19.string), null),
+  modifiedOn: types19.optional(types19.maybeNull(types19.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv8);
   return {
@@ -2310,7 +2407,20 @@ FlowModel.getPreview = async (flowId) => {
 var Flow_default = FlowModel;
 
 // src/models/appointment/Lead.js
-import { types as types19, getEnv as getEnv9, applySnapshot as applySnapshot8, getSnapshot } from "mobx-state-tree";
+import { types as types20, getEnv as getEnv9, applySnapshot as applySnapshot8, getSnapshot } from "mobx-state-tree";
+function pickLeadCreateContact(payload) {
+  const p = payload ?? {};
+  const email = String(p.email ?? p.Email ?? "").trim();
+  const phone = String(p.phone ?? p.Phone ?? "").trim();
+  const companyKey = String(p.companyKey ?? p.company_key ?? p.CompanyKey ?? "").trim();
+  return { email, phone, companyKey };
+}
+function validateLeadCreatePayload(payload) {
+  const { email, phone, companyKey } = pickLeadCreateContact(payload);
+  if (!companyKey) return { ok: false, message: "companyKey is required" };
+  if (!email && !phone) return { ok: false, message: "email or phone is required" };
+  return { ok: true };
+}
 function mapLeadFromApi(d) {
   if (!d) return d;
   const pick2 = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -2335,22 +2445,24 @@ function mapLeadFromApi(d) {
     source: pick2("source", "Source") ?? "",
     leadType,
     referrerLink: pick2("referrerLink", "ReferrerLink", "referrer_link") ?? "",
+    description: pick2("description", "Description") ?? "",
     createdOn: pick2("createdOn", "CreatedOn", "created_on") ?? null,
     modifiedOn: pick2("modifiedOn", "ModifiedOn", "modified_on") ?? null
   };
 }
-var LeadModel = types19.model("Lead", {
-  id: types19.optional(types19.maybeNull(types19.number), null),
-  leadId: types19.optional(types19.identifier, "new"),
-  email: types19.optional(types19.string, ""),
-  name: types19.optional(types19.string, ""),
-  phone: types19.optional(types19.string, ""),
-  companyKey: types19.optional(types19.string, ""),
-  source: types19.optional(types19.string, ""),
-  leadType: types19.optional(types19.number, 2),
-  referrerLink: types19.optional(types19.string, ""),
-  createdOn: types19.optional(types19.maybeNull(types19.string), null),
-  modifiedOn: types19.optional(types19.maybeNull(types19.string), null)
+var LeadModel = types20.model("Lead", {
+  id: types20.optional(types20.maybeNull(types20.number), null),
+  leadId: types20.optional(types20.identifier, "new"),
+  email: types20.optional(types20.string, ""),
+  name: types20.optional(types20.string, ""),
+  phone: types20.optional(types20.string, ""),
+  companyKey: types20.optional(types20.string, ""),
+  source: types20.optional(types20.string, ""),
+  leadType: types20.optional(types20.number, 2),
+  referrerLink: types20.optional(types20.string, ""),
+  description: types20.optional(types20.string, ""),
+  createdOn: types20.optional(types20.maybeNull(types20.string), null),
+  modifiedOn: types20.optional(types20.maybeNull(types20.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv9);
   return {
@@ -2398,8 +2510,14 @@ var LeadModel = types19.model("Lead", {
     async getColumnSelection(userId) {
       return LeadModel.getColumnSelection(userId);
     },
-    /** POST /lead/create – create this lead */
+    /** POST /lead/create – create this lead (requires companyKey and email or phone) */
     async createLead() {
+      const validation = validateLeadCreatePayload({
+        email: self.email,
+        phone: self.phone,
+        companyKey: self.companyKey
+      });
+      if (!validation.ok) return { status: "failure", message: validation.message };
       const payload = {
         email: self.email,
         name: self.name,
@@ -2407,7 +2525,8 @@ var LeadModel = types19.model("Lead", {
         companyKey: self.companyKey,
         source: self.source,
         leadType: self.leadType,
-        referrerLink: self.referrerLink
+        referrerLink: self.referrerLink,
+        description: self.description
       };
       const res = await reqPost("/lead/create", payload);
       if (res.status === "success" && res.data) {
@@ -2428,7 +2547,8 @@ var LeadModel = types19.model("Lead", {
         companyKey: self.companyKey,
         source: self.source,
         leadType: self.leadType,
-        referrerLink: self.referrerLink
+        referrerLink: self.referrerLink,
+        description: self.description
       };
       const res = await reqPost("/lead/update", payload);
       if (res.status === "success" && res.data) {
@@ -2496,6 +2616,7 @@ LeadModel.allowedColumns = [
   "source",
   "lead_type",
   "referrer_link",
+  "description",
   "created_on",
   "modified_on"
 ];
@@ -2549,6 +2670,8 @@ LeadModel.getByCompany = async (companyKey, opts = {}) => {
   return null;
 };
 LeadModel.createLead = async (payload) => {
+  const validation = validateLeadCreatePayload(payload);
+  if (!validation.ok) return { status: "failure", message: validation.message };
   const { reqPost } = createRequestHelpersFromEnv(getConfig());
   const res = await reqPost("/lead/create", payload);
   if (res.status === "success" && res.data) {
@@ -2604,17 +2727,17 @@ LeadModel.getSources = async (companyKey) => {
 var Lead_default = LeadModel;
 
 // src/models/appointment/CustomField.js
-import { types as types20, getEnv as getEnv10, applySnapshot as applySnapshot9 } from "mobx-state-tree";
-var CustomFieldModel = types20.model("CustomField", {
-  id: types20.optional(types20.maybeNull(types20.number), null),
-  customFieldId: types20.optional(types20.maybeNull(types20.string), null),
-  calendarId: types20.optional(types20.maybeNull(types20.string), null),
-  label: types20.optional(types20.maybeNull(types20.string), null),
-  type: types20.optional(types20.string, ""),
-  isRequired: types20.optional(types20.boolean, false),
-  createdOn: types20.optional(types20.maybeNull(types20.string), null),
-  modifiedOn: types20.optional(types20.maybeNull(types20.string), null),
-  isDeleted: types20.optional(types20.boolean, false)
+import { types as types21, getEnv as getEnv10, applySnapshot as applySnapshot9 } from "mobx-state-tree";
+var CustomFieldModel = types21.model("CustomField", {
+  id: types21.optional(types21.maybeNull(types21.number), null),
+  customFieldId: types21.optional(types21.maybeNull(types21.string), null),
+  calendarId: types21.optional(types21.maybeNull(types21.string), null),
+  label: types21.optional(types21.maybeNull(types21.string), null),
+  type: types21.optional(types21.string, ""),
+  isRequired: types21.optional(types21.boolean, false),
+  createdOn: types21.optional(types21.maybeNull(types21.string), null),
+  modifiedOn: types21.optional(types21.maybeNull(types21.string), null),
+  isDeleted: types21.optional(types21.boolean, false)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv10);
   return {
@@ -2944,10 +3067,10 @@ var AuthModel = {
 var Auth_default = AuthModel;
 
 // src/models/appointment/index.js
-import { types as types21, getEnv as getEnv11 } from "mobx-state-tree";
-var RootStore = types21.model("RootStore", {
-  calendars: types21.optional(types21.map(Calendar_default), {}),
-  events: types21.optional(types21.map(Event_default), {})
+import { types as types22, getEnv as getEnv11 } from "mobx-state-tree";
+var RootStore = types22.model("RootStore", {
+  calendars: types22.optional(types22.map(Calendar_default), {}),
+  events: types22.optional(types22.map(Event_default), {})
 }).actions((self) => ({
   addCalendar(snapshot) {
     const cal = Calendar_default.create(snapshot);
@@ -2986,6 +3109,8 @@ export {
   EmailProvider,
   Event_default as EventModel,
   EventSource,
+  EventStatus,
+  ExternalEvent_default as ExternalEventModel,
   Flow_default as FlowModel,
   Lead_default as LeadModel,
   LocationType,

package/package.json

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