@blazeo.com/calendar-client 1.0.4 → 1.0.6

package/README.md

@@ -22,10 +22,11 @@ cd your-app && npm link @blazeo.com/calendar-client
 Configure once at app startup, then use models and their methods:
 
 ```js
-import { configure, setBaseUrl, CalendarModel, createRootStore } from '@blazeo.com/calendar-client';
+import { configure, setBaseUrl, setConsumer, CalendarModel, createRootStore } from '@blazeo.com/calendar-client';
 
 configure({ baseUrl: 'https://your-appointment-api.example.com' });
 // or: setBaseUrl('https://localhost:7051');
+setConsumer('my-app');  // optional: sent as Consumer header (e.g. for lead source)
 
 // Calendar static methods (no store needed)
 const timezones = await CalendarModel.getTimeZones();
@@ -41,8 +42,8 @@ await cal.create(); // POST to backend
 
 - **CalendarModel (static):** `get`, `getByCompany`, `getTimeZones`, `getTimeZone`, `getParticipants`, `getMonth`, `getEvents`, etc.
 - **EventModel (instance):** `get`, `create`, `cancel`, `getCancellable`, `getAvailability`, `setReminder`
-- **FlowModel (static):** `list`, `get`, `createFlow`, `updateFlow`, `delete`, `duplicate`, `getAppearance`, `saveAppearance`, `getEmbed`, `saveEmbed`, `getPublic`, `getPreview`
-- **LeadModel (static):** `get`, `getByEmail`, `getByCompany`
+- **FlowModel:** Same pattern as Calendar — `FlowModel.create({}, { env })` with no fields; static `get`, `getRaw`, `list`, `createFlow`, `updateFlow`, `delete`, `duplicate`, appearance/embed/public/preview helpers; instance methods mirror those using `flowId` on the snapshot
+- **LeadModel:** `LeadModel.create({}, { env })`; static `get`, `getRaw`, `getByEmail`, `getByCompany`; instance `get`, `getByEmail`, `getByCompany` (uses `leadId` / `email` / `companyKey` on the snapshot)
 - **RootStore:** `addCalendar`, `addEvent`
 
 All methods return `Promise<{ status, data?, message? }>`. Check `response.status === 'success'` and use `response.data`.

package/dist/index.d.ts

@@ -1,124 +1,140 @@
-/** @blazeo.com/calendar-client - type declarations */
-
-export function configure(env: { baseUrl?: string; fetch?: typeof fetch; getDefaultOffset?: () => number }): void;
-export function getConfig(): { baseUrl?: string; fetch?: typeof fetch; getDefaultOffset?: () => number } | null;
-export function setBaseUrl(baseUrl: string): void;
-export function getConfigStore(): unknown;
-
-export const ConfigModel: unknown;
-
-export const CalendarModel: {
-  get(calendarId: string): Promise<unknown>;
-  getRaw(calendarId: string): Promise<{ status: string; data?: unknown; message?: string }>;
-  getByCompany(companyKey: string): Promise<unknown[]>;
-  getTimeZones(): Promise<unknown>;
-  getTimeZone(timezoneId: string): Promise<unknown>;
-  getParticipants(calendarId: string): Promise<unknown>;
-  getCalendarParticipant(calendarId: string): Promise<unknown>;
-  getParticipantsInfo(calendarId: string): Promise<unknown>;
-  getMonth(calendarId: string, year: number, month: number): Promise<unknown>;
-  getEvents(calendarId: string): Promise<unknown>;
-  createWithParticipants(name: string, companyKey: string, participantIds: string[], description: string, calendarId?: string): Promise<unknown>;
-  editWithParticipants(calendarId: string, name: string, participantIds: string[], description: string): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-
-export const EventModel: {
-  get(eventId: string): Promise<unknown>;
-  getByExternalId(externalEventId: string): Promise<unknown>;
-  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>;
-  getByVisitorEmail(email: string, opts: { companyKey?: string; calendarId?: string; offset?: number }): Promise<unknown[] | null>;
-  getByVisitorPhone(phone: string, opts: { companyKey?: string; calendarId?: string; offset?: number }): Promise<unknown[] | null>;
-  getAvailability(calendarId: string, year: number, month: number, day: number, opts?: { participantId?: string; offset?: number }): Promise<unknown[]>;
-  cancel(eventId: string): Promise<unknown>;
-  getCancellable(eventId: string): Promise<boolean>;
-  createEvent(payload: object, offsetMinutes?: number): Promise<unknown>;
-  reschedule(payload: object, offsetMinutes?: number): Promise<unknown>;
-  updateEvent(payload: object): Promise<unknown>;
-  createTest(payload: object, offsetMinutes?: number): Promise<unknown>;
-  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;
-};
-
-export const AvailabilityModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const AvailabilityDetailModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const CalendarParticipantModel: {
-  getByCalendar(calendarId: string): Promise<unknown[] | null>;
-  getInfoByCalendar(calendarId: string): Promise<unknown[] | null>;
-  getByParticipant(participantId: string): Promise<unknown[] | null>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-export const ParticipantModel: {
-  get(participantId: string): Promise<unknown>;
-  getByIds(participantIds: string[] | string): Promise<unknown[] | null>;
-  getAll(companyKey: string): Promise<unknown[] | null>;
-  add(payload: object, calendarId?: string): Promise<unknown>;
-  remove(participantId: string): Promise<unknown>;
-  update(payload: object): Promise<unknown>;
-  save(payload: object): Promise<unknown>;
-  sendEmail(participantId: string): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-export const OpeningHourModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const TimeSlotModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const TimeFrameModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const SettingModel: {
-  get(calendarId: string): Promise<unknown>;
-  save(payload: object): Promise<unknown>;
-  uploadLogo(calendarId: string, file: File | Blob): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-export const CompanyModel: {
-  get(companyKey: string): Promise<unknown>;
-  getAll(): Promise<unknown[] | null>;
-  save(payload: object): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-export const CalendarDayModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const ParticipantInfoModel: { create(snapshot: object, options?: { env?: object }): unknown };
-export const PreferenceModel: {
-  getScopes(): Promise<string[] | null>;
-  getOptions(): Promise<string[] | null>;
-  getOptionTemplate(option: string): Promise<unknown>;
-  get(option: string, keys: string | string[]): Promise<unknown>;
-  set(scope: string, key: string, option: string, body: string | object): Promise<unknown>;
-  delete(preferenceId: string): Promise<unknown>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-export const PreferenceScope: Record<string, number>;
-
-export const FlowModel: {
-  list(companyKey: string, includeDeleted?: boolean): Promise<unknown[] | null>;
-  get(flowId: string): Promise<unknown>;
-  createFlow(payload: object): Promise<unknown>;
-  updateFlow(payload: object): Promise<unknown>;
-  delete(flowId: string): Promise<unknown>;
-  duplicate(flowId: string, newName?: string): Promise<unknown>;
-  getAppearance(flowId: string): Promise<unknown>;
-  saveAppearance(payload: object): Promise<unknown>;
-  getEmbed(flowId: string): Promise<unknown>;
-  saveEmbed(payload: object): Promise<unknown>;
-  getPublic(flowId: string): Promise<{ flow: unknown; appearance: unknown; embed: unknown } | null>;
-  getPreview(flowId: string): Promise<{ flow: unknown; appearance: unknown; embed: unknown } | null>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-
-export const LeadModel: {
-  get(leadId: string): Promise<unknown>;
-  getByEmail(email: string, companyKey: string): Promise<unknown>;
-  getByCompany(companyKey: string, opts?: { skip?: number; take?: number }): Promise<unknown[] | null>;
-  create(snapshot: object, options?: { env?: object }): unknown;
-};
-
-export const RootStore: unknown;
-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 RecurringFrequency: Record<string, number>;
-export const DayOfWeek: Record<string, number>;
+/** @blazeo.com/calendar-client - type declarations */
+
+export function configure(env: { baseUrl?: string; consumer?: string; fetch?: typeof fetch; getDefaultOffset?: () => number }): void;
+export function getConfig(): { baseUrl?: string; consumer?: string; fetch?: typeof fetch; getDefaultOffset?: () => number } | null;
+export function setBaseUrl(baseUrl: string): void;
+export function setConsumer(consumer: string): void;
+export function getConfigStore(): unknown;
+
+export const ConfigModel: unknown;
+
+export const CalendarModel: {
+  get(calendarId: string): Promise<unknown>;
+  getRaw(calendarId: string): Promise<{ status: string; data?: unknown; message?: string }>;
+  getByCompany(companyKey: string): Promise<unknown[]>;
+  getTimeZones(): Promise<unknown>;
+  getTimeZone(timezoneId: string): Promise<unknown>;
+  getParticipants(calendarId: string): Promise<unknown>;
+  getCalendarParticipant(calendarId: string): Promise<unknown>;
+  getParticipantsInfo(calendarId: string): Promise<unknown>;
+  getMonth(calendarId: string, year: number, month: number): Promise<unknown>;
+  getEvents(calendarId: string): Promise<unknown>;
+  createWithParticipants(name: string, companyKey: string, participantIds: string[], description: string, calendarId?: string): Promise<unknown>;
+  editWithParticipants(calendarId: string, name: string, participantIds: string[], description: string): Promise<unknown>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+
+export const EventModel: {
+  get(eventId: string): Promise<unknown>;
+  getByExternalId(externalEventId: string): Promise<unknown>;
+  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>;
+  getByVisitorEmail(email: string, opts: { companyKey?: string; calendarId?: string; offset?: number }): Promise<unknown[] | null>;
+  getByVisitorPhone(phone: string, opts: { companyKey?: string; calendarId?: string; offset?: number }): Promise<unknown[] | null>;
+  getAvailability(calendarId: string, year: number, month: number, day: number, opts?: { participantId?: string; offset?: number }): Promise<unknown[]>;
+  cancel(eventId: string): Promise<unknown>;
+  getCancellable(eventId: string): Promise<boolean>;
+  createEvent(payload: object, offsetMinutes?: number): Promise<unknown>;
+  reschedule(payload: object, offsetMinutes?: number): Promise<unknown>;
+  updateEvent(payload: object): Promise<unknown>;
+  createTest(payload: object, offsetMinutes?: number): Promise<unknown>;
+  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;
+};
+
+export const AvailabilityModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const AvailabilityDetailModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const CalendarParticipantModel: {
+  getByCalendar(calendarId: string): Promise<unknown[] | null>;
+  getInfoByCalendar(calendarId: string): Promise<unknown[] | null>;
+  getByParticipant(participantId: string): Promise<unknown[] | null>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+export const ParticipantModel: {
+  get(participantId: string): Promise<unknown>;
+  getByIds(participantIds: string[] | string): Promise<unknown[] | null>;
+  getAll(companyKey: string): Promise<unknown[] | null>;
+  add(payload: object, calendarId?: string): Promise<unknown>;
+  remove(participantId: string): Promise<unknown>;
+  update(payload: object): Promise<unknown>;
+  save(payload: object): Promise<unknown>;
+  sendEmail(participantId: string): Promise<unknown>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+export const OpeningHourModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const TimeSlotModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const TimeFrameModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const SettingModel: {
+  get(calendarId: string): Promise<unknown>;
+  save(payload: object): Promise<unknown>;
+  uploadLogo(calendarId: string, file: File | Blob): Promise<unknown>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+export const CompanyModel: {
+  get(companyKey: string): Promise<unknown>;
+  getAll(): Promise<unknown[] | null>;
+  save(payload: object): Promise<unknown>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+export const CalendarDayModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const ParticipantInfoModel: { create(snapshot: object, options?: { env?: object }): unknown };
+export const PreferenceModel: {
+  getScopes(): Promise<string[] | null>;
+  getOptions(): Promise<string[] | null>;
+  getOptionTemplate(option: string): Promise<unknown>;
+  get(option: string, keys: string | string[]): Promise<unknown>;
+  set(scope: string, key: string, option: string, body: string | object): Promise<unknown>;
+  delete(preferenceId: string): Promise<unknown>;
+  create(snapshot: object, options?: { env?: object }): unknown;
+};
+export const PreferenceScope: Record<string, number>;
+
+export const FlowModel: {
+  getRaw(flowId: string): Promise<{ status: string; data?: unknown; message?: string }>;
+  list(companyKey: string, includeDeleted?: boolean): Promise<unknown[] | null>;
+  get(flowId: string): Promise<unknown>;
+  createFlow(payload: object): Promise<unknown>;
+  updateFlow(payload: object): Promise<unknown>;
+  delete(flowId: string): Promise<unknown>;
+  duplicate(flowId: string, newName?: string): Promise<unknown>;
+  getAppearance(flowId: string): Promise<unknown>;
+  saveAppearance(payload: object): Promise<unknown>;
+  getEmbed(flowId: string): Promise<unknown>;
+  saveEmbed(payload: object): Promise<unknown>;
+  getPublic(flowId: string): Promise<{ flow: unknown; appearance: unknown; embed: unknown } | null>;
+  getPreview(flowId: string): Promise<{ flow: unknown; appearance: unknown; embed: unknown } | null>;
+  /** Empty snapshot is valid: `FlowModel.create({}, { env })` after configure() */
+  create(snapshot?: object, options?: { env?: object }): unknown;
+};
+
+export const LeadModel: {
+  getRaw(leadId: string): Promise<{ status: string; data?: unknown; message?: string }>;
+  get(leadId: string): Promise<unknown>;
+  getByEmail(email: string, companyKey: string): Promise<unknown>;
+  getByCompany(
+    companyKey: string,
+    opts?: {
+      skip?: number;
+      take?: number;
+      sort?: string;
+      sort_column?: string;
+      sort_dir?: 'asc' | 'desc';
+      page?: number;
+      page_size?: number;
+    }
+  ): Promise<unknown[] | null>;
+  /** Empty snapshot is valid: `LeadModel.create({}, { env })` after configure() */
+  create(snapshot?: object, options?: { env?: object }): unknown;
+};
+
+export const RootStore: unknown;
+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 RecurringFrequency: Record<string, number>;
+export const DayOfWeek: Record<string, number>;

package/dist/index.js

@@ -57,7 +57,8 @@ var import_mobx_state_tree7 = require("mobx-state-tree");
 // src/ConfigModel.js
 var import_mobx_state_tree = require("mobx-state-tree");
 var ConfigModel = import_mobx_state_tree.types.model("Config", {
-  baseUrl: import_mobx_state_tree.types.optional(import_mobx_state_tree.types.string, "")
+  baseUrl: import_mobx_state_tree.types.optional(import_mobx_state_tree.types.string, ""),
+  consumer: import_mobx_state_tree.types.optional(import_mobx_state_tree.types.string, "")
 }).volatile(() => ({
   fetch: void 0,
   getDefaultOffset: () => -(/* @__PURE__ */ new Date()).getTimezoneOffset()
@@ -65,6 +66,9 @@ var ConfigModel = import_mobx_state_tree.types.model("Config", {
   setBaseUrl(url) {
     self.baseUrl = url;
   },
+  setConsumer(value) {
+    self.consumer = value ?? "";
+  },
   setFetch(fn) {
     self.fetch = fn;
   },
@@ -73,6 +77,7 @@ var ConfigModel = import_mobx_state_tree.types.model("Config", {
   },
   configure(env) {
     if (env.baseUrl != null) self.baseUrl = env.baseUrl;
+    if (env.consumer != null) self.consumer = env.consumer;
     if (env.fetch != null) self.fetch = env.fetch;
     if (env.getDefaultOffset != null) self.getDefaultOffset = env.getDefaultOffset;
   }
@@ -80,6 +85,7 @@ var ConfigModel = import_mobx_state_tree.types.model("Config", {
   getEnv() {
     return {
       baseUrl: self.baseUrl || void 0,
+      consumer: self.consumer || void 0,
       fetch: self.fetch,
       getDefaultOffset: self.getDefaultOffset
     };
@@ -139,6 +145,11 @@ async function request(baseUrl, fetchFn, path, options = {}) {
   }
   return data;
 }
+function mergeConsumerHeader(env, opts) {
+  const headers = { ...opts.headers || {} };
+  if (env == null ? void 0 : env.consumer) headers["Consumer"] = env.consumer;
+  return { ...opts, headers };
+}
 function createRequestHelpers(self, getEnv9) {
   const env = () => getEnv9(self);
   const baseUrl = () => env().baseUrl;
@@ -148,7 +159,7 @@ function createRequestHelpers(self, getEnv9) {
   const req = (path, opts = {}) => {
     const url = baseUrl();
     if (!url) throw new Error("Model env requires baseUrl. Call configure({ baseUrl }) at app startup.");
-    return request(url, fetchFn(), path, opts);
+    return request(url, fetchFn(), path, mergeConsumerHeader(env(), opts));
   };
   return {
     req,
@@ -166,7 +177,7 @@ function createRequestHelpersFromEnv(env) {
   const req = (path, opts = {}) => {
     const url = baseUrl();
     if (!url) throw new Error("Env requires baseUrl. Call configure({ baseUrl }) at app startup.");
-    return request(url, fetchFn(), path, opts);
+    return request(url, fetchFn(), path, mergeConsumerHeader(e, opts));
   };
   return {
     env: e,
@@ -1494,16 +1505,16 @@ function mapFlowFromApi(d) {
   };
 }
 var FlowModel = import_mobx_state_tree16.types.model("Flow", {
-  id: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.number),
+  id: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.number), null),
   flowId: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.identifier, "new"),
-  companyKey: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string),
-  name: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string),
-  description: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string),
+  companyKey: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  name: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
+  description: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string), null),
   flowJson: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.string, ""),
   isActive: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.boolean, true),
   isDeleted: import_mobx_state_tree16.types.optional(import_mobx_state_tree16.types.boolean, false),
-  createdOn: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string),
-  modifiedOn: import_mobx_state_tree16.types.maybeNull(import_mobx_state_tree16.types.string)
+  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)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, import_mobx_state_tree16.getEnv);
   return {
@@ -1516,7 +1527,7 @@ var FlowModel = import_mobx_state_tree16.types.model("Flow", {
       }
       return res;
     },
-    /** POST flow/create – create flow */
+    /** POST flow/create – create flow from current snapshot */
     async create() {
       const payload = {
         companyKey: self.companyKey ?? void 0,
@@ -1533,6 +1544,7 @@ var FlowModel = import_mobx_state_tree16.types.model("Flow", {
     },
     /** POST flow/update – update flow */
     async update() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       const payload = {
         flowId: self.flowId,
         name: self.name ?? void 0,
@@ -1551,14 +1563,53 @@ var FlowModel = import_mobx_state_tree16.types.model("Flow", {
       if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       return reqPost("/flow/delete", { flow_id: self.flowId });
     },
-    /** POST flow/duplicate – duplicate flow */
+    /** POST flow/duplicate – duplicate flow; applies snapshot if new flow returned */
     async duplicate(newName) {
       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_tree16.applySnapshot)(self, mapFlowFromApi(res.data));
+      }
       return res;
+    },
+    /** GET flow/appearance/get – uses self.flowId */
+    async getAppearance() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getAppearance(self.flowId);
+    },
+    /** POST flow/appearance/save – merges self.flowId into payload */
+    async saveAppearance(payload = {}) {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      const body = { ...payload, flowId: self.flowId };
+      return FlowModel.saveAppearance(body);
+    },
+    /** GET flow/embed/get – uses self.flowId */
+    async getEmbed() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getEmbed(self.flowId);
+    },
+    /** POST flow/embed/save – merges self.flowId into payload */
+    async saveEmbed(payload = {}) {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      const body = { ...payload, flowId: self.flowId };
+      return FlowModel.saveEmbed(body);
+    },
+    /** GET flow/public/get – uses self.flowId */
+    async getPublic() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getPublic(self.flowId);
+    },
+    /** GET flow/preview/get – same as getPublic */
+    async getPreview() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getPreview(self.flowId);
     }
   };
 });
+FlowModel.getRaw = async (flowId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  return reqGet("/flow/get", { flow_id: flowId });
+};
 FlowModel.list = async (companyKey, includeDeleted = false) => {
   const { reqGet } = createRequestHelpersFromEnv(getConfig());
   const query = { company_key: companyKey };
@@ -1679,7 +1730,17 @@ FlowModel.getPublic = async (flowId) => {
   return null;
 };
 FlowModel.getPreview = async (flowId) => {
-  return FlowModel.getPublic(flowId);
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const res = await reqGet("/flow/preview/get", { flow_id: flowId });
+  if (res.status === "success" && res.data) {
+    const d = res.data;
+    return {
+      flow: d.flow ? mapFlowFromApi(d.flow) : null,
+      appearance: d.appearance ?? null,
+      embed: d.embed ?? null
+    };
+  }
+  return null;
 };
 var Flow_default = FlowModel;
 
@@ -1701,15 +1762,15 @@ function mapLeadFromApi(d) {
   };
 }
 var LeadModel = import_mobx_state_tree17.types.model("Lead", {
-  id: import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.number),
+  id: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.number), null),
   leadId: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.identifier, "new"),
   email: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
   name: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
   phone: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
   companyKey: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
   source: import_mobx_state_tree17.types.optional(import_mobx_state_tree17.types.string, ""),
-  createdOn: import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string),
-  modifiedOn: import_mobx_state_tree17.types.maybeNull(import_mobx_state_tree17.types.string)
+  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 } = createRequestHelpers(self, import_mobx_state_tree17.getEnv);
   return {
@@ -1721,9 +1782,29 @@ var LeadModel = import_mobx_state_tree17.types.model("Lead", {
         (0, import_mobx_state_tree17.applySnapshot)(self, mapLeadFromApi(res.data));
       }
       return res;
+    },
+    /** GET /lead/getbyemail – uses self.email and self.companyKey */
+    async getByEmail() {
+      if (!self.email || !self.companyKey) {
+        return { status: "failure", message: "email and companyKey required on model" };
+      }
+      const lead = await LeadModel.getByEmail(self.email, self.companyKey);
+      if (lead) {
+        (0, import_mobx_state_tree17.applySnapshot)(self, (0, import_mobx_state_tree17.getSnapshot)(lead));
+      }
+      return { status: lead ? "success" : "failure", data: lead ?? void 0 };
+    },
+    /** GET /lead/company/get – uses self.companyKey; same result as LeadModel.getByCompany(companyKey, opts) */
+    async getByCompany(opts = {}) {
+      if (!self.companyKey) return null;
+      return LeadModel.getByCompany(self.companyKey, opts);
     }
   };
 });
+LeadModel.getRaw = async (leadId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  return reqGet("/lead/get", { lead_id: leadId });
+};
 LeadModel.get = async (leadId) => {
   const { reqGet } = createRequestHelpersFromEnv(getConfig());
   const res = await reqGet("/lead/get", { lead_id: leadId });
@@ -1745,6 +1826,11 @@ LeadModel.getByCompany = async (companyKey, opts = {}) => {
   const query = { company_key: companyKey };
   if (opts.skip != null) query.skip = opts.skip;
   if (opts.take != null) query.take = opts.take;
+  const sortCol = opts.sort ?? opts.sort_column;
+  if (sortCol != null && sortCol !== "") query.sort = sortCol;
+  if (opts.sort_dir != null) query.sort_dir = opts.sort_dir;
+  if (opts.page != null) query.page = opts.page;
+  if (opts.page_size != null) query.page_size = opts.page_size;
   const res = await reqGet("/lead/company/get", query);
   if (res.status === "success" && Array.isArray(res.data)) {
     return res.data.map((l) => LeadModel.create(mapLeadFromApi(l), { env: getConfig() }));

package/dist/index.mjs

@@ -4,7 +4,8 @@ import { types as types7, getEnv as getEnv2, applySnapshot as applySnapshot2 } f
 // src/ConfigModel.js
 import { types } from "mobx-state-tree";
 var ConfigModel = types.model("Config", {
-  baseUrl: types.optional(types.string, "")
+  baseUrl: types.optional(types.string, ""),
+  consumer: types.optional(types.string, "")
 }).volatile(() => ({
   fetch: void 0,
   getDefaultOffset: () => -(/* @__PURE__ */ new Date()).getTimezoneOffset()
@@ -12,6 +13,9 @@ var ConfigModel = types.model("Config", {
   setBaseUrl(url) {
     self.baseUrl = url;
   },
+  setConsumer(value) {
+    self.consumer = value ?? "";
+  },
   setFetch(fn) {
     self.fetch = fn;
   },
@@ -20,6 +24,7 @@ var ConfigModel = types.model("Config", {
   },
   configure(env) {
     if (env.baseUrl != null) self.baseUrl = env.baseUrl;
+    if (env.consumer != null) self.consumer = env.consumer;
     if (env.fetch != null) self.fetch = env.fetch;
     if (env.getDefaultOffset != null) self.getDefaultOffset = env.getDefaultOffset;
   }
@@ -27,6 +32,7 @@ var ConfigModel = types.model("Config", {
   getEnv() {
     return {
       baseUrl: self.baseUrl || void 0,
+      consumer: self.consumer || void 0,
       fetch: self.fetch,
       getDefaultOffset: self.getDefaultOffset
     };
@@ -86,6 +92,11 @@ async function request(baseUrl, fetchFn, path, options = {}) {
   }
   return data;
 }
+function mergeConsumerHeader(env, opts) {
+  const headers = { ...opts.headers || {} };
+  if (env == null ? void 0 : env.consumer) headers["Consumer"] = env.consumer;
+  return { ...opts, headers };
+}
 function createRequestHelpers(self, getEnv9) {
   const env = () => getEnv9(self);
   const baseUrl = () => env().baseUrl;
@@ -95,7 +106,7 @@ function createRequestHelpers(self, getEnv9) {
   const req = (path, opts = {}) => {
     const url = baseUrl();
     if (!url) throw new Error("Model env requires baseUrl. Call configure({ baseUrl }) at app startup.");
-    return request(url, fetchFn(), path, opts);
+    return request(url, fetchFn(), path, mergeConsumerHeader(env(), opts));
   };
   return {
     req,
@@ -113,7 +124,7 @@ function createRequestHelpersFromEnv(env) {
   const req = (path, opts = {}) => {
     const url = baseUrl();
     if (!url) throw new Error("Env requires baseUrl. Call configure({ baseUrl }) at app startup.");
-    return request(url, fetchFn(), path, opts);
+    return request(url, fetchFn(), path, mergeConsumerHeader(e, opts));
   };
   return {
     env: e,
@@ -1441,16 +1452,16 @@ function mapFlowFromApi(d) {
   };
 }
 var FlowModel = types16.model("Flow", {
-  id: types16.maybeNull(types16.number),
+  id: types16.optional(types16.maybeNull(types16.number), null),
   flowId: types16.optional(types16.identifier, "new"),
-  companyKey: types16.maybeNull(types16.string),
-  name: types16.maybeNull(types16.string),
-  description: types16.maybeNull(types16.string),
+  companyKey: types16.optional(types16.maybeNull(types16.string), null),
+  name: types16.optional(types16.maybeNull(types16.string), null),
+  description: types16.optional(types16.maybeNull(types16.string), null),
   flowJson: types16.optional(types16.string, ""),
   isActive: types16.optional(types16.boolean, true),
   isDeleted: types16.optional(types16.boolean, false),
-  createdOn: types16.maybeNull(types16.string),
-  modifiedOn: types16.maybeNull(types16.string)
+  createdOn: types16.optional(types16.maybeNull(types16.string), null),
+  modifiedOn: types16.optional(types16.maybeNull(types16.string), null)
 }).actions((self) => {
   const { reqGet, reqPost } = createRequestHelpers(self, getEnv6);
   return {
@@ -1463,7 +1474,7 @@ var FlowModel = types16.model("Flow", {
       }
       return res;
     },
-    /** POST flow/create – create flow */
+    /** POST flow/create – create flow from current snapshot */
     async create() {
       const payload = {
         companyKey: self.companyKey ?? void 0,
@@ -1480,6 +1491,7 @@ var FlowModel = types16.model("Flow", {
     },
     /** POST flow/update – update flow */
     async update() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       const payload = {
         flowId: self.flowId,
         name: self.name ?? void 0,
@@ -1498,14 +1510,53 @@ var FlowModel = types16.model("Flow", {
       if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
       return reqPost("/flow/delete", { flow_id: self.flowId });
     },
-    /** POST flow/duplicate – duplicate flow */
+    /** POST flow/duplicate – duplicate flow; applies snapshot if new flow returned */
     async duplicate(newName) {
       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) {
+        applySnapshot6(self, mapFlowFromApi(res.data));
+      }
       return res;
+    },
+    /** GET flow/appearance/get – uses self.flowId */
+    async getAppearance() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getAppearance(self.flowId);
+    },
+    /** POST flow/appearance/save – merges self.flowId into payload */
+    async saveAppearance(payload = {}) {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      const body = { ...payload, flowId: self.flowId };
+      return FlowModel.saveAppearance(body);
+    },
+    /** GET flow/embed/get – uses self.flowId */
+    async getEmbed() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getEmbed(self.flowId);
+    },
+    /** POST flow/embed/save – merges self.flowId into payload */
+    async saveEmbed(payload = {}) {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      const body = { ...payload, flowId: self.flowId };
+      return FlowModel.saveEmbed(body);
+    },
+    /** GET flow/public/get – uses self.flowId */
+    async getPublic() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getPublic(self.flowId);
+    },
+    /** GET flow/preview/get – same as getPublic */
+    async getPreview() {
+      if (!self.flowId || self.flowId === "new") return { status: "failure", message: "flowId required" };
+      return FlowModel.getPreview(self.flowId);
     }
   };
 });
+FlowModel.getRaw = async (flowId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  return reqGet("/flow/get", { flow_id: flowId });
+};
 FlowModel.list = async (companyKey, includeDeleted = false) => {
   const { reqGet } = createRequestHelpersFromEnv(getConfig());
   const query = { company_key: companyKey };
@@ -1626,12 +1677,22 @@ FlowModel.getPublic = async (flowId) => {
   return null;
 };
 FlowModel.getPreview = async (flowId) => {
-  return FlowModel.getPublic(flowId);
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  const res = await reqGet("/flow/preview/get", { flow_id: flowId });
+  if (res.status === "success" && res.data) {
+    const d = res.data;
+    return {
+      flow: d.flow ? mapFlowFromApi(d.flow) : null,
+      appearance: d.appearance ?? null,
+      embed: d.embed ?? null
+    };
+  }
+  return null;
 };
 var Flow_default = FlowModel;
 
 // src/models/appointment/Lead.js
-import { types as types17, getEnv as getEnv7, applySnapshot as applySnapshot7 } from "mobx-state-tree";
+import { types as types17, getEnv as getEnv7, applySnapshot as applySnapshot7, getSnapshot } from "mobx-state-tree";
 function mapLeadFromApi(d) {
   if (!d) return d;
   const pick = (...keys) => keys.reduce((v, k) => v ?? d[k], void 0);
@@ -1648,15 +1709,15 @@ function mapLeadFromApi(d) {
   };
 }
 var LeadModel = types17.model("Lead", {
-  id: types17.maybeNull(types17.number),
+  id: types17.optional(types17.maybeNull(types17.number), null),
   leadId: types17.optional(types17.identifier, "new"),
   email: types17.optional(types17.string, ""),
   name: types17.optional(types17.string, ""),
   phone: types17.optional(types17.string, ""),
   companyKey: types17.optional(types17.string, ""),
   source: types17.optional(types17.string, ""),
-  createdOn: types17.maybeNull(types17.string),
-  modifiedOn: types17.maybeNull(types17.string)
+  createdOn: types17.optional(types17.maybeNull(types17.string), null),
+  modifiedOn: types17.optional(types17.maybeNull(types17.string), null)
 }).actions((self) => {
   const { reqGet } = createRequestHelpers(self, getEnv7);
   return {
@@ -1668,9 +1729,29 @@ var LeadModel = types17.model("Lead", {
         applySnapshot7(self, mapLeadFromApi(res.data));
       }
       return res;
+    },
+    /** GET /lead/getbyemail – uses self.email and self.companyKey */
+    async getByEmail() {
+      if (!self.email || !self.companyKey) {
+        return { status: "failure", message: "email and companyKey required on model" };
+      }
+      const lead = await LeadModel.getByEmail(self.email, self.companyKey);
+      if (lead) {
+        applySnapshot7(self, getSnapshot(lead));
+      }
+      return { status: lead ? "success" : "failure", data: lead ?? void 0 };
+    },
+    /** GET /lead/company/get – uses self.companyKey; same result as LeadModel.getByCompany(companyKey, opts) */
+    async getByCompany(opts = {}) {
+      if (!self.companyKey) return null;
+      return LeadModel.getByCompany(self.companyKey, opts);
     }
   };
 });
+LeadModel.getRaw = async (leadId) => {
+  const { reqGet } = createRequestHelpersFromEnv(getConfig());
+  return reqGet("/lead/get", { lead_id: leadId });
+};
 LeadModel.get = async (leadId) => {
   const { reqGet } = createRequestHelpersFromEnv(getConfig());
   const res = await reqGet("/lead/get", { lead_id: leadId });
@@ -1692,6 +1773,11 @@ LeadModel.getByCompany = async (companyKey, opts = {}) => {
   const query = { company_key: companyKey };
   if (opts.skip != null) query.skip = opts.skip;
   if (opts.take != null) query.take = opts.take;
+  const sortCol = opts.sort ?? opts.sort_column;
+  if (sortCol != null && sortCol !== "") query.sort = sortCol;
+  if (opts.sort_dir != null) query.sort_dir = opts.sort_dir;
+  if (opts.page != null) query.page = opts.page;
+  if (opts.page_size != null) query.page_size = opts.page_size;
   const res = await reqGet("/lead/company/get", query);
   if (res.status === "success" && Array.isArray(res.data)) {
     return res.data.map((l) => LeadModel.create(mapLeadFromApi(l), { env: getConfig() }));

package/package.json

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