@blazeo.com/calendar-client 1.0.4 → 1.0.5

package/README.md

@@ -1,53 +1,54 @@
-# @blazeo.com/calendar-client
-
-**Private package** – for Blazeo internal teams only. JavaScript client for the Blazeo Calendar / Appointment API. Use it in React (or any JS app) to call calendar and event endpoints via MobX State Tree models.
-
-## Install
-
-From your npm registry (internal teams; ensure you're logged in to the scope):
-
-```bash
-npm install @blazeo.com/calendar-client
-```
-
-Or link locally:
-
-```bash
-cd calendar-client && npm run build && npm link
-cd your-app && npm link @blazeo.com/calendar-client
-```
-
-## Usage
-
-Configure once at app startup, then use models and their methods:
-
-```js
-import { configure, setBaseUrl, CalendarModel, createRootStore } from '@blazeo.com/calendar-client';
-
-configure({ baseUrl: 'https://your-appointment-api.example.com' });
-// or: setBaseUrl('https://localhost:7051');
-
-// Calendar static methods (no store needed)
-const timezones = await CalendarModel.getTimeZones();
-const calendar = await CalendarModel.get('calendar-guid');
-
-// Or use RootStore with models
-const store = createRootStore();
-const cal = store.addCalendar({ calendarId: 'my-cal', name: 'My Calendar' });
-await cal.create(); // POST to backend
-```
-
-## API overview
-
-- **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`
-- **RootStore:** `addCalendar`, `addEvent`
-
-All methods return `Promise<{ status, data?, message? }>`. Check `response.status === 'success'` and use `response.data`.
-
-## Samples
-
-- **`sample/`** – Uses the package via `file:..` for local development (run `npm run build` in parent first).
-- **`sample-npm/`** – Uses the package from npm: `npm i @blazeo.com/calendar-client`. For testing the published package.
+# @blazeo.com/calendar-client
+
+**Private package** – for Blazeo internal teams only. JavaScript client for the Blazeo Calendar / Appointment API. Use it in React (or any JS app) to call calendar and event endpoints via MobX State Tree models.
+
+## Install
+
+From your npm registry (internal teams; ensure you're logged in to the scope):
+
+```bash
+npm install @blazeo.com/calendar-client
+```
+
+Or link locally:
+
+```bash
+cd calendar-client && npm run build && npm link
+cd your-app && npm link @blazeo.com/calendar-client
+```
+
+## Usage
+
+Configure once at app startup, then use models and their methods:
+
+```js
+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();
+const calendar = await CalendarModel.get('calendar-guid');
+
+// Or use RootStore with models
+const store = createRootStore();
+const cal = store.addCalendar({ calendarId: 'my-cal', name: 'My Calendar' });
+await cal.create(); // POST to backend
+```
+
+## API overview
+
+- **CalendarModel (static):** `get`, `getByCompany`, `getTimeZones`, `getTimeZone`, `getParticipants`, `getMonth`, `getEvents`, etc.
+- **EventModel (instance):** `get`, `create`, `cancel`, `getCancellable`, `getAvailability`, `setReminder`
+- **FlowModel:** Same pattern as Calendar — `FlowModel.create({}, { env })` with no fields; static `get`, `getRaw`, `list`, `createFlow`, `updateFlow`, `delete`, `duplicate`, appearance/embed/public/preview helpers; instance methods mirror those using `flowId` on the snapshot
+- **LeadModel:** `LeadModel.create({}, { env })`; static `get`, `getRaw`, `getByEmail`, `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`.
+
+## Samples
+
+- **`sample/`** – Uses the package via `file:..` for local development (run `npm run build` in parent first).
+- **`sample-npm/`** – Uses the package from npm: `npm i @blazeo.com/calendar-client`. For testing the published package.

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 /** @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 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;
@@ -92,6 +93,7 @@ export const PreferenceModel: {
 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>;
@@ -104,14 +106,17 @@ export const FlowModel: {
   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;
+  /** 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 }): Promise<unknown[] | null>;
-  create(snapshot: object, options?: { env?: object }): unknown;
+  /** Empty snapshot is valid: `LeadModel.create({}, { env })` after configure() */
+  create(snapshot?: object, options?: { env?: object }): unknown;
 };
 
 export const RootStore: unknown;

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 });

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 });

package/package.json

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