@blazeo.com/appointment-client 1.0.4 → 1.0.6

package/dist/exampleData.d.ts

@@ -1,15 +1,119 @@
-import { type CalendarSlot } from "./models/CalendarSlotModel.js";
-import { type CalendarRoot, type CalendarRootSnapshotIn } from "./models/CalendarRootModel.js";
-import { type Event } from "./models/EventModel.js";
-import { type Participant } from "./models/ParticipantModel.js";
 /** Example slot nodes (MST instances). */
-export declare function getExampleSlots(): CalendarSlot[];
+export declare function getExampleSlots(): (import("mobx-state-tree").ModelInstanceTypeProps<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    title: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    start: import("mobx-state-tree").ISimpleType<string>;
+    end: import("mobx-state-tree").ISimpleType<string>;
+    isAvailable: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").ISimpleType<boolean>, [undefined]>;
+}> & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    title: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    start: import("mobx-state-tree").ISimpleType<string>;
+    end: import("mobx-state-tree").ISimpleType<string>;
+    isAvailable: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").ISimpleType<boolean>, [undefined]>;
+}, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>)[];
 /** Example event nodes. */
-export declare function getExampleEvents(): Event[];
+export declare function getExampleEvents(): (import("mobx-state-tree").ModelInstanceTypeProps<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    title: import("mobx-state-tree").ISimpleType<string>;
+    calendarId: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    startsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    endsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    participantIds: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").IArrayType<import("mobx-state-tree").ISimpleType<string>>, [undefined]>;
+}> & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    title: import("mobx-state-tree").ISimpleType<string>;
+    calendarId: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    startsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    endsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    participantIds: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").IArrayType<import("mobx-state-tree").ISimpleType<string>>, [undefined]>;
+}, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>)[];
 /** Example participant nodes. */
-export declare function getExampleParticipants(): Participant[];
+export declare function getExampleParticipants(): (import("mobx-state-tree").ModelInstanceTypeProps<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    name: import("mobx-state-tree").ISimpleType<string>;
+    email: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    role: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+}> & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
+    id: import("mobx-state-tree").ISimpleType<string>;
+    name: import("mobx-state-tree").ISimpleType<string>;
+    email: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    role: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+}, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>)[];
 /** Full root store snapshot suitable for `createCalendarRoot(snapshot)`. */
-export declare function getExampleCalendarRootSnapshot(): CalendarRootSnapshotIn;
+export declare function getExampleCalendarRootSnapshot(): {
+    slots: {
+        id: string;
+        title: string;
+        start: string;
+        end: string;
+    }[];
+    events: {
+        id: string;
+        title: string;
+        calendarId: string;
+        startsAt: string;
+        endsAt: string;
+        participantIds: string[];
+    }[];
+    participants: {
+        id: string;
+        name: string;
+        email: string;
+        role: string;
+    }[];
+};
 /** Root store with example slots, events, and participants. */
-export declare function getExampleCalendarRoot(): CalendarRoot;
-//# sourceMappingURL=exampleData.d.ts.map
+export declare function getExampleCalendarRoot(): import("mobx-state-tree").ModelInstanceTypeProps<{
+    slots: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        title: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        start: import("mobx-state-tree").ISimpleType<string>;
+        end: import("mobx-state-tree").ISimpleType<string>;
+        isAvailable: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").ISimpleType<boolean>, [undefined]>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+    events: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        title: import("mobx-state-tree").ISimpleType<string>;
+        calendarId: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        startsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        endsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        participantIds: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").IArrayType<import("mobx-state-tree").ISimpleType<string>>, [undefined]>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+    participants: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        name: import("mobx-state-tree").ISimpleType<string>;
+        email: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        role: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+}> & {
+    removeSlot(id: string): void;
+    removeEvent(id: string): void;
+    removeParticipant(id: string): void;
+} & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IModelType<{
+    slots: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        title: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        start: import("mobx-state-tree").ISimpleType<string>;
+        end: import("mobx-state-tree").ISimpleType<string>;
+        isAvailable: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").ISimpleType<boolean>, [undefined]>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+    events: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        title: import("mobx-state-tree").ISimpleType<string>;
+        calendarId: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        startsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        endsAt: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        participantIds: import("mobx-state-tree").IOptionalIType<import("mobx-state-tree").IArrayType<import("mobx-state-tree").ISimpleType<string>>, [undefined]>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+    participants: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IModelType<{
+        id: import("mobx-state-tree").ISimpleType<string>;
+        name: import("mobx-state-tree").ISimpleType<string>;
+        email: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+        role: import("mobx-state-tree").IMaybeNull<import("mobx-state-tree").ISimpleType<string>>;
+    }, {}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;
+}, {
+    removeSlot(id: string): void;
+    removeEvent(id: string): void;
+    removeParticipant(id: string): void;
+}, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>>;

package/dist/exampleData.js

@@ -1,7 +1,7 @@
-import { CalendarSlotModel } from "./models/CalendarSlotModel.js";
-import { CalendarRootModel, } from "./models/CalendarRootModel.js";
-import { EventModel } from "./models/EventModel.js";
-import { ParticipantModel, } from "./models/ParticipantModel.js";
+import { CalendarSlotModel } from "./models/CalendarRootModel.js";
+import { CalendarRootModel } from "./models/CalendarRootModel.js";
+import { EventModel } from "./models/CalendarRootModel.js";
+import { ParticipantModel } from "./models/CalendarRootModel.js";
 const EXAMPLE_SLOT_SNAPSHOTS = [
     {
         id: "slot-1",
@@ -69,4 +69,3 @@ export function getExampleCalendarRootSnapshot() {
 export function getExampleCalendarRoot() {
     return CalendarRootModel.create(getExampleCalendarRootSnapshot());
 }
-//# sourceMappingURL=exampleData.js.map

package/dist/facade/calendarCreationFacade.d.ts

@@ -1,40 +1,40 @@
-import type { IStateTreeNode } from "mobx-state-tree";
-import type { CalendarBOInput } from "../types/calendarBo.js";
-export type CreateCalendarOptions = {
-    /** Overrides `blazeo.config` / global `configure` when set. */
-    baseUrl?: string;
-    consumer?: string;
-    /**
-     * When true, only builds the MST `Calendar` node (no HTTP).
-     * Default false: calls `calendar.create()` → POST `/Calendar/Create`.
-     */
-    localOnly?: boolean;
-};
-/** Typical Blazeo `reqPost` / `calendar.create()` result shape. */
-export type BlazeoCalendarCreateResponse = {
-    status: string;
-    message?: string;
-    data?: unknown;
-};
-export type CreateCalendarSuccess = {
-    ok: true;
-    calendar: IStateTreeNode;
-    apiResponse?: BlazeoCalendarCreateResponse;
-};
-export type CreateCalendarFailure = {
-    ok: false;
-    error: string;
-    apiResponse?: BlazeoCalendarCreateResponse;
-};
-export type CreateCalendarResult = CreateCalendarSuccess | CreateCalendarFailure;
-/** Merge per-call options with global Blazeo config (file + `configure`). */
-export declare function resolveBlazeoConnection(options?: CreateCalendarOptions): {
-    baseUrl?: string;
-    consumer?: string;
-};
-/**
- * Uses {@link resolveBlazeoConnection} (config file + `configure` + optional overrides),
- * then `CalendarModel.create` and `calendar.create()` unless `localOnly`.
- */
-export declare function createCalendarAsync(calendar: CalendarBOInput, options?: CreateCalendarOptions): Promise<CreateCalendarResult>;
+import type { IStateTreeNode } from "mobx-state-tree";
+import type { CalendarBOInput } from "../types/calendarBo.js";
+export type CreateCalendarOptions = {
+    /** Overrides `blazeo.config` / global `configure` when set. */
+    baseUrl?: string;
+    consumer?: string;
+    /**
+     * When true, only builds the MST `Calendar` node (no HTTP).
+     * Default false: calls `calendar.create()` → POST `/Calendar/Create`.
+     */
+    localOnly?: boolean;
+};
+/** Typical Blazeo `reqPost` / `calendar.create()` result shape. */
+export type BlazeoCalendarCreateResponse = {
+    status: string;
+    message?: string;
+    data?: unknown;
+};
+export type CreateCalendarSuccess = {
+    ok: true;
+    calendar: IStateTreeNode;
+    apiResponse?: BlazeoCalendarCreateResponse;
+};
+export type CreateCalendarFailure = {
+    ok: false;
+    error: string;
+    apiResponse?: BlazeoCalendarCreateResponse;
+};
+export type CreateCalendarResult = CreateCalendarSuccess | CreateCalendarFailure;
+/** Merge per-call options with global Blazeo config (file + `configure`). */
+export declare function resolveBlazeoConnection(options?: CreateCalendarOptions): {
+    baseUrl?: string;
+    consumer?: string;
+};
+/**
+ * Uses {@link resolveBlazeoConnection} (config file + `configure` + optional overrides),
+ * then `CalendarModel.create` and `calendar.create()` unless `localOnly`.
+ */
+export declare function createCalendarAsync(calendar: CalendarBOInput, options?: CreateCalendarOptions): Promise<CreateCalendarResult>;
 //# sourceMappingURL=calendarCreationFacade.d.ts.map

package/dist/facade/calendarCreationFacade.js

@@ -1,96 +1,96 @@
-import { CalendarModel, configure, getConfig } from "@blazeo.com/calendar-client";
-import { blazeoClientConfig } from "../config/blazeo.config.js";
-import { mapCalendarBOToSnapshot } from "./mapCalendarBOToSnapshot.js";
-function isFailureStatus(res) {
-    return res.status !== "success" && res.status !== "Success";
-}
-/** Merge per-call options with global Blazeo config (file + `configure`). */
-export function resolveBlazeoConnection(options = {}) {
-    const cfg = getConfig();
-    const fromFileBase = blazeoClientConfig.baseUrl?.trim().replace(/\/+$/, "");
-    const fromFileConsumer = blazeoClientConfig.consumer?.trim();
-    const baseUrl = options.baseUrl?.trim().replace(/\/+$/, "") ||
-        cfg?.baseUrl?.replace(/\/+$/, "") ||
-        (fromFileBase || undefined);
-    const consumer = options.consumer?.trim() ||
-        cfg?.consumer ||
-        (fromFileConsumer || undefined);
-    return { baseUrl, consumer };
-}
-function buildModelEnv(baseUrl, consumer, forLocalOnly) {
-    if (forLocalOnly && !baseUrl) {
-        return {};
-    }
-    const cfg = getConfig();
-    const env = {};
-    if (baseUrl) {
-        env.baseUrl = baseUrl;
-    }
-    else if (cfg?.baseUrl) {
-        env.baseUrl = cfg.baseUrl;
-    }
-    if (consumer) {
-        env.consumer = consumer;
-    }
-    else if (cfg?.consumer) {
-        env.consumer = cfg.consumer;
-    }
-    if (cfg?.fetch != null)
-        env.fetch = cfg.fetch;
-    if (cfg?.getDefaultOffset != null) {
-        env.getDefaultOffset = cfg.getDefaultOffset;
-    }
-    return env;
-}
-/**
- * Uses {@link resolveBlazeoConnection} (config file + `configure` + optional overrides),
- * then `CalendarModel.create` and `calendar.create()` unless `localOnly`.
- */
-export async function createCalendarAsync(calendar, options = {}) {
-    try {
-        const { baseUrl: resolvedBase, consumer: resolvedConsumer } = resolveBlazeoConnection(options);
-        if (resolvedBase) {
-            configure({
-                baseUrl: resolvedBase,
-                ...(resolvedConsumer ? { consumer: resolvedConsumer } : {}),
-            });
-        }
-        const baseUrl = resolvedBase;
-        const consumer = resolvedConsumer;
-        if (!options.localOnly && !baseUrl) {
-            return {
-                ok: false,
-                error: "baseUrl is missing. Set `blazeoClientConfig.baseUrl` in `appointment-client/src/config/blazeo.config.ts` or call `configure({ baseUrl })`.",
-            };
-        }
-        const snapshot = mapCalendarBOToSnapshot(calendar);
-        const env = buildModelEnv(baseUrl, consumer, Boolean(options.localOnly));
-        if (!options.localOnly && env.baseUrl == null) {
-            return {
-                ok: false,
-                error: "Model env requires baseUrl. Set `blazeoClientConfig` or pass `baseUrl` in options.",
-            };
-        }
-        const calendarNode = CalendarModel.create(snapshot, env);
-        if (options.localOnly) {
-            return { ok: true, calendar: calendarNode };
-        }
-        const apiRes = await calendarNode.create();
-        if (isFailureStatus(apiRes)) {
-            const msg = apiRes.message ??
-                (typeof apiRes.data === "string" ? apiRes.data : undefined) ??
-                JSON.stringify(apiRes);
-            return {
-                ok: false,
-                error: msg || "Calendar create failed",
-                apiResponse: apiRes,
-            };
-        }
-        return { ok: true, calendar: calendarNode, apiResponse: apiRes };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        return { ok: false, error: message };
-    }
-}
+import { CalendarModel, configure, getConfig } from "@blazeo.com/calendar-client";
+import { blazeoClientConfig } from "../config/blazeo.config.js";
+import { mapCalendarBOToSnapshot } from "./mapCalendarBOToSnapshot.js";
+function isFailureStatus(res) {
+    return res.status !== "success" && res.status !== "Success";
+}
+/** Merge per-call options with global Blazeo config (file + `configure`). */
+export function resolveBlazeoConnection(options = {}) {
+    const cfg = getConfig();
+    const fromFileBase = blazeoClientConfig.baseUrl?.trim().replace(/\/+$/, "");
+    const fromFileConsumer = blazeoClientConfig.consumer?.trim();
+    const baseUrl = options.baseUrl?.trim().replace(/\/+$/, "") ||
+        cfg?.baseUrl?.replace(/\/+$/, "") ||
+        (fromFileBase || undefined);
+    const consumer = options.consumer?.trim() ||
+        cfg?.consumer ||
+        (fromFileConsumer || undefined);
+    return { baseUrl, consumer };
+}
+function buildModelEnv(baseUrl, consumer, forLocalOnly) {
+    if (forLocalOnly && !baseUrl) {
+        return {};
+    }
+    const cfg = getConfig();
+    const env = {};
+    if (baseUrl) {
+        env.baseUrl = baseUrl;
+    }
+    else if (cfg?.baseUrl) {
+        env.baseUrl = cfg.baseUrl;
+    }
+    if (consumer) {
+        env.consumer = consumer;
+    }
+    else if (cfg?.consumer) {
+        env.consumer = cfg.consumer;
+    }
+    if (cfg?.fetch != null)
+        env.fetch = cfg.fetch;
+    if (cfg?.getDefaultOffset != null) {
+        env.getDefaultOffset = cfg.getDefaultOffset;
+    }
+    return env;
+}
+/**
+ * Uses {@link resolveBlazeoConnection} (config file + `configure` + optional overrides),
+ * then `CalendarModel.create` and `calendar.create()` unless `localOnly`.
+ */
+export async function createCalendarAsync(calendar, options = {}) {
+    try {
+        const { baseUrl: resolvedBase, consumer: resolvedConsumer } = resolveBlazeoConnection(options);
+        if (resolvedBase) {
+            configure({
+                baseUrl: resolvedBase,
+                ...(resolvedConsumer ? { consumer: resolvedConsumer } : {}),
+            });
+        }
+        const baseUrl = resolvedBase;
+        const consumer = resolvedConsumer;
+        if (!options.localOnly && !baseUrl) {
+            return {
+                ok: false,
+                error: "baseUrl is missing. Set `blazeoClientConfig.baseUrl` in `appointment-client/src/config/blazeo.config.ts` or call `configure({ baseUrl })`.",
+            };
+        }
+        const snapshot = mapCalendarBOToSnapshot(calendar);
+        const env = buildModelEnv(baseUrl, consumer, Boolean(options.localOnly));
+        if (!options.localOnly && env.baseUrl == null) {
+            return {
+                ok: false,
+                error: "Model env requires baseUrl. Set `blazeoClientConfig` or pass `baseUrl` in options.",
+            };
+        }
+        const calendarNode = CalendarModel.create(snapshot, env);
+        if (options.localOnly) {
+            return { ok: true, calendar: calendarNode };
+        }
+        const apiRes = await calendarNode.create();
+        if (isFailureStatus(apiRes)) {
+            const msg = apiRes.message ??
+                (typeof apiRes.data === "string" ? apiRes.data : undefined) ??
+                JSON.stringify(apiRes);
+            return {
+                ok: false,
+                error: msg || "Calendar create failed",
+                apiResponse: apiRes,
+            };
+        }
+        return { ok: true, calendar: calendarNode, apiResponse: apiRes };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { ok: false, error: message };
+    }
+}
 //# sourceMappingURL=calendarCreationFacade.js.map

package/dist/facade/mapCalendarBOToSnapshot.d.ts

@@ -1,10 +1,10 @@
-import type { CalendarBOInput } from "../types/calendarBo.js";
-/**
- * Maps Apex `CalendarBO`-shaped input to a snapshot for
- * {@link CalendarModel.create} from `@blazeo.com/calendar-client`.
- *
- * Only fields that exist on Blazeo's `Calendar` model are included so MST does not receive
- * unknown keys or invalid `null`s on optional numbers.
- */
-export declare function mapCalendarBOToSnapshot(bo: CalendarBOInput): Record<string, unknown>;
+import type { CalendarBOInput } from "../types/calendarBo.js";
+/**
+ * Maps Apex `CalendarBO`-shaped input to a snapshot for
+ * {@link CalendarModel.create} from `@blazeo.com/calendar-client`.
+ *
+ * Only fields that exist on Blazeo's `Calendar` model are included so MST does not receive
+ * unknown keys or invalid `null`s on optional numbers.
+ */
+export declare function mapCalendarBOToSnapshot(bo: CalendarBOInput): Record<string, unknown>;
 //# sourceMappingURL=mapCalendarBOToSnapshot.d.ts.map

package/dist/facade/mapCalendarBOToSnapshot.js

@@ -1,44 +1,44 @@
-/** Default enum values aligned with ApexFlows / Blazeo (`AssignmentMethod`, `Unit`). */
-const DEFAULT_ASSIGNMENT_METHOD = 1;
-const DEFAULT_UNIT_MINUTES = 1;
-/**
- * For Blazeo `Calendar` MST: `types.optional(types.number)` accepts `undefined` (uses default)
- * but not `null`. Coerce null/absent to `undefined`.
- */
-function optionalNumber(v) {
-    return v == null ? undefined : v;
-}
-/**
- * Maps Apex `CalendarBO`-shaped input to a snapshot for
- * {@link CalendarModel.create} from `@blazeo.com/calendar-client`.
- *
- * Only fields that exist on Blazeo's `Calendar` model are included so MST does not receive
- * unknown keys or invalid `null`s on optional numbers.
- */
-export function mapCalendarBOToSnapshot(bo) {
-    const calendarId = bo.calendarId ?? bo.thirdPartyCalendarId ?? "new";
-    return {
-        id: bo.serverId == null ? undefined : bo.serverId,
-        companyKey: bo.companyKey ?? null,
-        calendarId,
-        name: bo.name ?? null,
-        timeZoneId: bo.timeZoneId ?? null,
-        purpose: bo.purpose ?? bo.bookingPageTitle ?? "",
-        description: bo.description ?? null,
-        assignmentMethod: bo.assignmentMethod ?? bo.assignmentType ?? DEFAULT_ASSIGNMENT_METHOD,
-        duration: optionalNumber(bo.duration) ?? 30,
-        durationUnit: optionalNumber(bo.durationUnit) ?? DEFAULT_UNIT_MINUTES,
-        minimumBookingNotice: optionalNumber(bo.minimumBookingNotice) ?? 0,
-        minimumBookingNoticeUnit: optionalNumber(bo.minimumBookingNoticeUnit) ?? DEFAULT_UNIT_MINUTES,
-        minimumCancelationNotice: optionalNumber(bo.minimumCancelationNotice) ?? 0,
-        minimumCancelationNoticeUnit: optionalNumber(bo.minimumCancelationNoticeUnit) ?? DEFAULT_UNIT_MINUTES,
-        futureLimit: optionalNumber(bo.futureLimit) ?? 0,
-        futureLimitUnit: optionalNumber(bo.futureLimitUnit) ?? 3,
-        bufferTime: optionalNumber(bo.bufferTime),
-        bufferTimeUnit: optionalNumber(bo.bufferTimeUnit) ?? DEFAULT_UNIT_MINUTES,
-        bookingLimit: optionalNumber(bo.bookingLimit),
-        createdOn: bo.createdOn ?? null,
-        modifiedOn: bo.modifiedOn ?? null,
-    };
-}
+/** Default enum values aligned with ApexFlows / Blazeo (`AssignmentMethod`, `Unit`). */
+const DEFAULT_ASSIGNMENT_METHOD = 1;
+const DEFAULT_UNIT_MINUTES = 1;
+/**
+ * For Blazeo `Calendar` MST: `types.optional(types.number)` accepts `undefined` (uses default)
+ * but not `null`. Coerce null/absent to `undefined`.
+ */
+function optionalNumber(v) {
+    return v == null ? undefined : v;
+}
+/**
+ * Maps Apex `CalendarBO`-shaped input to a snapshot for
+ * {@link CalendarModel.create} from `@blazeo.com/calendar-client`.
+ *
+ * Only fields that exist on Blazeo's `Calendar` model are included so MST does not receive
+ * unknown keys or invalid `null`s on optional numbers.
+ */
+export function mapCalendarBOToSnapshot(bo) {
+    const calendarId = bo.calendarId ?? bo.thirdPartyCalendarId ?? "new";
+    return {
+        id: bo.serverId == null ? undefined : bo.serverId,
+        companyKey: bo.companyKey ?? null,
+        calendarId,
+        name: bo.name ?? null,
+        timeZoneId: bo.timeZoneId ?? null,
+        purpose: bo.purpose ?? bo.bookingPageTitle ?? "",
+        description: bo.description ?? null,
+        assignmentMethod: bo.assignmentMethod ?? bo.assignmentType ?? DEFAULT_ASSIGNMENT_METHOD,
+        duration: optionalNumber(bo.duration) ?? 30,
+        durationUnit: optionalNumber(bo.durationUnit) ?? DEFAULT_UNIT_MINUTES,
+        minimumBookingNotice: optionalNumber(bo.minimumBookingNotice) ?? 0,
+        minimumBookingNoticeUnit: optionalNumber(bo.minimumBookingNoticeUnit) ?? DEFAULT_UNIT_MINUTES,
+        minimumCancelationNotice: optionalNumber(bo.minimumCancelationNotice) ?? 0,
+        minimumCancelationNoticeUnit: optionalNumber(bo.minimumCancelationNoticeUnit) ?? DEFAULT_UNIT_MINUTES,
+        futureLimit: optionalNumber(bo.futureLimit) ?? 0,
+        futureLimitUnit: optionalNumber(bo.futureLimitUnit) ?? 3,
+        bufferTime: optionalNumber(bo.bufferTime),
+        bufferTimeUnit: optionalNumber(bo.bufferTimeUnit) ?? DEFAULT_UNIT_MINUTES,
+        bookingLimit: optionalNumber(bo.bookingLimit),
+        createdOn: bo.createdOn ?? null,
+        modifiedOn: bo.modifiedOn ?? null,
+    };
+}
 //# sourceMappingURL=mapCalendarBOToSnapshot.js.map

package/dist/facades/index.d.ts

@@ -1,12 +1,12 @@
-/**
- * Public facade surface for `appointment-client`.
- *
- * Call {@link initializeAppointmentClient} from `../config/initializeAppointmentClient.js`
- * before using these APIs in a host application.
- */
-export { createCalendarAsync, updateCalendarAsync, deleteCalendarAsync, resolveBlazeoConnection, type BlazeoCalendarCreateResponse, type CreateCalendarOptions, type CreateCalendarResult, } from "../calendar/createCalendar.js";
-export { CalendarCreationFacade, createCalendarWithRelationsAsync, updateCalendarWithRelationsAsync, resolveParticipantIdForOpeningHour, type CalendarWithRelationsResult, type CalendarWithRelationsSuccess, } from "../calendar/calendarCreationFacade.js";
-export { addParticipantToCalendar, removeParticipantFromCalendar, saveCalendarOpeningHour, saveCalendarOpeningHoursBatch, type BlazeoCalendarForRelations, type BlazeoCalendarRelationResponse, } from "../calendar/blazeoCalendarRelationMethods.js";
-export { createAppointmentEventAsync, rescheduleAppointmentEventAsync, cancelAppointmentEventAsync, type AppointmentEventOptions, type AppointmentEventResult, type AppointmentEventSuccess, type AppointmentEventFailure, type BlazeoEventApiResponse, } from "../events/appointmentEventFacade.js";
-export { mapAppointmentToEventSnapshot, type AppointmentEventMappingMode, } from "../events/mapAppointmentToEventSnapshot.js";
+/**
+ * Public facade surface for `appointment-client`.
+ *
+ * Call {@link initializeAppointmentClient} from `../config/initializeAppointmentClient.js`
+ * before using these APIs in a host application.
+ */
+export { createCalendarAsync, updateCalendarAsync, deleteCalendarAsync, resolveBlazeoConnection, type BlazeoCalendarCreateResponse, type CreateCalendarOptions, type CreateCalendarResult, } from "../calendar/createCalendar.js";
+export { CalendarCreationFacade, createCalendarWithRelationsAsync, updateCalendarWithRelationsAsync, resolveParticipantIdForOpeningHour, type CalendarWithRelationsResult, type CalendarWithRelationsSuccess, } from "../calendar/calendarCreationFacade.js";
+export { addParticipantToCalendar, removeParticipantFromCalendar, saveCalendarOpeningHour, saveCalendarOpeningHoursBatch, type BlazeoCalendarForRelations, type BlazeoCalendarRelationResponse, } from "../calendar/blazeoCalendarRelationMethods.js";
+export { createAppointmentEventAsync, rescheduleAppointmentEventAsync, cancelAppointmentEventAsync, type AppointmentEventOptions, type AppointmentEventResult, type AppointmentEventSuccess, type AppointmentEventFailure, type BlazeoEventApiResponse, } from "../events/appointmentEventFacade.js";
+export { mapAppointmentToEventSnapshot, type AppointmentEventMappingMode, } from "../events/mapAppointmentToEventSnapshot.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/facades/index.js

@@ -1,12 +1,12 @@
-/**
- * Public facade surface for `appointment-client`.
- *
- * Call {@link initializeAppointmentClient} from `../config/initializeAppointmentClient.js`
- * before using these APIs in a host application.
- */
-export { createCalendarAsync, updateCalendarAsync, deleteCalendarAsync, resolveBlazeoConnection, } from "../calendar/createCalendar.js";
-export { CalendarCreationFacade, createCalendarWithRelationsAsync, updateCalendarWithRelationsAsync, resolveParticipantIdForOpeningHour, } from "../calendar/calendarCreationFacade.js";
-export { addParticipantToCalendar, removeParticipantFromCalendar, saveCalendarOpeningHour, saveCalendarOpeningHoursBatch, } from "../calendar/blazeoCalendarRelationMethods.js";
-export { createAppointmentEventAsync, rescheduleAppointmentEventAsync, cancelAppointmentEventAsync, } from "../events/appointmentEventFacade.js";
-export { mapAppointmentToEventSnapshot, } from "../events/mapAppointmentToEventSnapshot.js";
+/**
+ * Public facade surface for `appointment-client`.
+ *
+ * Call {@link initializeAppointmentClient} from `../config/initializeAppointmentClient.js`
+ * before using these APIs in a host application.
+ */
+export { createCalendarAsync, updateCalendarAsync, deleteCalendarAsync, resolveBlazeoConnection, } from "../calendar/createCalendar.js";
+export { CalendarCreationFacade, createCalendarWithRelationsAsync, updateCalendarWithRelationsAsync, resolveParticipantIdForOpeningHour, } from "../calendar/calendarCreationFacade.js";
+export { addParticipantToCalendar, removeParticipantFromCalendar, saveCalendarOpeningHour, saveCalendarOpeningHoursBatch, } from "../calendar/blazeoCalendarRelationMethods.js";
+export { createAppointmentEventAsync, rescheduleAppointmentEventAsync, cancelAppointmentEventAsync, } from "../events/appointmentEventFacade.js";
+export { mapAppointmentToEventSnapshot, } from "../events/mapAppointmentToEventSnapshot.js";
 //# sourceMappingURL=index.js.map