@blazeo.com/calendar-client 1.0.34 → 1.0.36

package/dist/index.d.ts

@@ -76,9 +76,40 @@ export const CalendarModel: {
   create(snapshot: object, options?: { env?: object }): unknown;
 };
 
+/** Event fields returned by the API (camelCase). */
+export type EventSnapshot = {
+  eventId: string;
+  calendarId?: string;
+  participantId?: string | null;
+  title?: string | null;
+  description?: string | null;
+  calendarLocationId?: string | null;
+  /** From CalendarLocation.Value when event search endpoints enrich the row. */
+  calendarLocationValue?: string | null;
+  customLocation?: string | null;
+  visitorName?: string | null;
+  visitorEmail?: string | null;
+  visitorPhone?: string | null;
+  startDate?: string;
+  endDate?: string;
+  [key: string]: unknown;
+};
+
+export type EventSearchResult = {
+  events: unknown[];
+  totalCount: number;
+};
+
 export const EventModel: {
   get(eventId: string): Promise<unknown>;
   getByExternalId(externalEventId: string): Promise<unknown>;
+  getByDateRangeWithFilters(
+    companyKey: string,
+    startDateFrom: string,
+    startDateTo: string,
+    opts?: Record<string, unknown>
+  ): Promise<EventSearchResult>;
+  getByFilters(companyKey: string, opts?: Record<string, unknown>): Promise<EventSearchResult>;
   getRoundRobinParticipant(calendarId: string): Promise<unknown>;
   getEarliestAvailableDays(calendarId: string, count: number, opts?: { year?: number; month?: number; day?: number; offset?: number }): Promise<string[] | null>;
   getDaySelectable(calendarId: string, year: number, month: number, day: number, opts?: { participantId?: string; offset?: number }): Promise<boolean>;
@@ -100,7 +131,23 @@ export const EventModel: {
   getCustomData(calendarId: string, eventId?: string): Promise<unknown>;
   setReminder(eventId: string): Promise<unknown>;
   setAttendeeStatus(eventId: string, attendeeStatus: number | string): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): 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 };
@@ -241,15 +288,16 @@ 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>;
+  }): Promise<{ status: string; data?: unknown; message?: string } | null>;
   updateLead(payload: {
     leadId: string;
     email?: string;
@@ -419,6 +467,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,
@@ -482,16 +490,24 @@ var EventModel = import_mobx_state_tree4.types.model("Event", {
   modifiedOn: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   externalEventId: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   calendarLocationId: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
+  /** Resolved location text from CalendarLocation when returned by search APIs. */
+  calendarLocationValue: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   customLocation: import_mobx_state_tree4.types.optional(import_mobx_state_tree4.types.maybeNull(import_mobx_state_tree4.types.string), null),
   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),
   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) => {
+}).views((self) => ({
+  /** calendarLocationValue, else customLocation (one-off / typed location). */
+  get displayLocation() {
+    return self.calendarLocationValue ?? self.customLocation ?? null;
+  }
+})).actions((self) => {
   const { req, reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree4.getEnv);
   const getOffset = () => {
     var _a, _b;
@@ -619,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;
     }
   };
 });
@@ -646,10 +674,12 @@ function mapEventFromApi(d) {
     visitorPhone: pick2("visitorPhone", "VisitorPhone", "visitor_phone"),
     externalEventId: pick2("externalEventId", "ExternalEventId", "externalEventId", "external_event_id"),
     calendarLocationId: pick2("calendarLocationId", "CalendarLocationId", "calendar_location_id"),
+    calendarLocationValue: pick2("calendarLocationValue", "CalendarLocationValue", "calendar_location_value"),
     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")),
+    status: n(pick2("status", "Status")),
     eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
@@ -881,6 +911,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
@@ -1678,30 +1713,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 */
@@ -1776,27 +1877,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;
     }
   };
@@ -1844,13 +1945,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 = {}) {
@@ -1924,7 +2025,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);
@@ -1954,19 +2055,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) {
@@ -1984,7 +2085,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;
     },
@@ -2046,7 +2147,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,
@@ -2057,13 +2158,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() {
@@ -2111,7 +2212,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);
@@ -2130,27 +2231,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;
     },
@@ -2166,7 +2267,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;
     },
@@ -2183,7 +2284,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;
     },
@@ -2197,7 +2298,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;
     },
@@ -2374,7 +2475,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);
@@ -2403,27 +2517,27 @@ function mapLeadFromApi(d) {
     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, ""),
+  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;
     },
@@ -2434,7 +2548,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 };
     },
@@ -2445,7 +2559,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 };
     },
@@ -2462,8 +2576,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,
@@ -2475,7 +2595,7 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
       };
       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;
     },
@@ -2496,7 +2616,7 @@ var LeadModel = import_mobx_state_tree19.types.model("Lead", {
       };
       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;
     },
@@ -2613,6 +2733,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) {
@@ -2668,19 +2790,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) {
@@ -2701,7 +2823,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;
     },
@@ -3008,10 +3130,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);
@@ -3051,6 +3173,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,
@@ -410,16 +416,24 @@ var EventModel = types4.model("Event", {
   modifiedOn: types4.optional(types4.maybeNull(types4.string), null),
   externalEventId: types4.optional(types4.maybeNull(types4.string), null),
   calendarLocationId: types4.optional(types4.maybeNull(types4.string), null),
+  /** Resolved location text from CalendarLocation when returned by search APIs. */
+  calendarLocationValue: types4.optional(types4.maybeNull(types4.string), null),
   customLocation: types4.optional(types4.maybeNull(types4.string), null),
   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),
   offset: types4.optional(types4.number, 0),
   eventSource: types4.optional(types4.number, EventSource.AppointmentType)
-}).actions((self) => {
+}).views((self) => ({
+  /** calendarLocationValue, else customLocation (one-off / typed location). */
+  get displayLocation() {
+    return self.calendarLocationValue ?? self.customLocation ?? null;
+  }
+})).actions((self) => {
   const { req, reqGet, reqPost } = createRequestHelpers(self, getEnv);
   const getOffset = () => {
     var _a, _b;
@@ -547,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;
     }
   };
 });
@@ -574,10 +600,12 @@ function mapEventFromApi(d) {
     visitorPhone: pick2("visitorPhone", "VisitorPhone", "visitor_phone"),
     externalEventId: pick2("externalEventId", "ExternalEventId", "externalEventId", "external_event_id"),
     calendarLocationId: pick2("calendarLocationId", "CalendarLocationId", "calendar_location_id"),
+    calendarLocationValue: pick2("calendarLocationValue", "CalendarLocationValue", "calendar_location_value"),
     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")),
+    status: n(pick2("status", "Status")),
     eventSource: n(pick2("eventSource", "EventSource", "event_source")),
     rescheduleLink: pick2("rescheduleLink", "RescheduleLink", "reschedule_link"),
     cancelLink: pick2("cancelLink", "CancelLink", "cancel_link"),
@@ -809,6 +837,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
@@ -1606,16 +1639,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 {
@@ -1704,13 +1803,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 {
@@ -1772,13 +1871,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 = {}) {
@@ -1852,7 +1951,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);
@@ -1882,17 +1981,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 {
@@ -1974,7 +2073,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,
@@ -1985,13 +2084,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() {
@@ -2039,7 +2138,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);
@@ -2058,18 +2157,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 {
@@ -2302,7 +2401,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);
@@ -2331,18 +2443,18 @@ function mapLeadFromApi(d) {
     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, ""),
+  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 {
@@ -2390,8 +2502,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,
@@ -2541,6 +2659,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) {
@@ -2596,17 +2716,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 {
@@ -2936,10 +3056,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);
@@ -2978,6 +3098,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.34",
+  "version": "1.0.36",
   "description": "Blazeo Calendar / Appointment API client with MobX State Tree models",
   "exports": {
     ".": {