@joai/sdk 4.7.0 → 4.8.0

package/dist/index.d.mts

@@ -220,6 +220,7 @@ type CheckoutSnapshot = {
 type GuestBuyer = {
   name: string;
   email: string;
+  phone?: string;
 };
 type CheckoutSnapshotRequest = {
   fulfillmentMethod: FulfillmentMethod;
@@ -290,6 +291,7 @@ type SubscriptionDelivery = {
   fulfillmentLocation?: {
     name: string;
     instructions: string | null;
+    address?: AddressSnapshot | null;
   } | null;
 }; //#endregion
 //#region src/wallet/types.d.ts
@@ -614,6 +616,7 @@ declare const NativeApps: {
   readonly Heartbeats: "heartbeats";
   readonly Wallets: "wallets";
   readonly Campaigns: "campaigns";
+  readonly Automations: "automations";
   readonly News: "news";
   readonly Sites: "sites";
   readonly Contracts: "contracts";
@@ -824,9 +827,10 @@ type AiCostsResponse = {
 }; //#endregion
 //#region src/billing/types.d.ts
 type TranslatableValue = Partial<Record<WarpLocale, string>>;
-type OrderStatus = 'pending' | 'completed' | 'delivered' | 'canceled';
+type OrderStatus = 'pending' | 'confirmed' | 'processing' | 'shipped' | 'completed' | 'delivered' | 'canceled' | 'returned';
 type OrderSource = 'auto' | 'manual' | 'kiosk';
 type OrderType = 'order' | 'quote';
+type OrderPriceMode = 'net' | 'gross';
 type SubscriptionStatus = 'active' | 'canceled' | 'past_due' | 'pending';
 type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly';
 type PricingModel = 'free' | 'one-time' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'per-run';
@@ -1037,6 +1041,7 @@ type Order = {
   source: OrderSource | null;
   context: OrderContext | null;
   paymentMode: string | null;
+  priceMode?: OrderPriceMode | null;
   linkVariationId: string | null;
   notes: string | null;
   fulfillmentMethod?: FulfillmentMethod | null;
@@ -1046,6 +1051,7 @@ type Order = {
   fulfillmentLocation?: {
     name: string;
     instructions?: string | null;
+    address?: AddressSnapshot | null;
   } | null;
   shippingFee?: number;
   fulfillments?: Fulfillment[];
@@ -1899,24 +1905,37 @@ type AppointmentRequest = {
   createdAt: string;
 }; //#endregion
 //#region src/automation/types.d.ts
-type AutomationTriggerType = 'prop' | 'segment' | 'manual';
-type AutomationActionType = 'wait' | 'send_email' | 'halt';
-type AutomationSendMode = 'direct' | 'campaign';
+type AutomationTriggerType = 'prop' | 'segment' | 'manual' | 'webhook';
+type AutomationActionType = 'wait' | 'halt' | 'warp' | 'branch';
 type AutomationEnrollmentStatus = 'active' | 'completed' | 'skipped';
 type AutomationSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'automation_disabled' | 'already_completed';
 type AutomationTriggerConfig = {
   propKey?: string;
   propValue?: string | number | boolean;
   segmentId?: string;
+  source?: string;
+  trigger?: {
+    event?: string;
+    when?: Array<{
+      path: string;
+      operator: string;
+      value?: unknown;
+    }>;
+    inputs?: Record<string, unknown>;
+  };
+  hookId?: string;
 };
 type AutomationActionConfig = {
   delayMinutes?: number;
-  sendMode?: AutomationSendMode;
-  campaignId?: string;
-  subject?: string;
-  body?: string;
-  contentHtml?: boolean;
-  sentPropKey?: string;
+  warpId?: string;
+  inputs?: Record<string, unknown>;
+  when?: Array<{
+    path: string;
+    operator: string;
+    value?: unknown;
+  }>;
+  thenPosition?: number;
+  elsePosition?: number;
   [key: string]: unknown;
 };
 type AutomationAction = {
@@ -1933,6 +1952,10 @@ type Automation = {
   enabled: boolean;
   agent: AgentSimple | null;
   actions?: AutomationAction[];
+  activeEnrollmentsCount?: number;
+  completedEnrollmentsCount?: number;
+  skippedEnrollmentsCount?: number;
+  erroredEnrollmentsCount?: number;
   createdAt: string;
   updatedAt: string;
 };
@@ -1978,8 +2001,23 @@ type AutomationUpdatePayload = {
 };
 type AutomationAudiencePreview = {
   count: number;
+  total: number;
+  sendable: number;
+  willSkip: number;
+  reasons: Record<'pending_consent' | 'opted_out' | 'missing_channel', number>;
   sampleContactIds: string[];
-}; //#endregion
+  channel: string | null;
+};
+type AutomationStats = {
+  totalAutomations: number;
+  enabledAutomations: number;
+  activeEnrollments: number;
+  emailsSent: number;
+  completedEnrollments: number;
+  erroredEnrollments: number;
+};
+type CampaignChannelId = 'email' | 'whatsapp' | 'sms' | 'push';
+//#endregion
 //#region src/content/types.d.ts
 type ContentStatus = 'draft' | 'published' | 'archived';
 type ContentFieldType = 'text' | 'richText' | 'number' | 'boolean' | 'url' | 'image' | 'media' | 'list' | 'object' | 'reference';
@@ -2039,7 +2077,7 @@ type PatchContentInput = {
   patches: ContentPatch[];
   origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
 }; //#endregion
-//#region src/commerce/helpers.d.ts
+//#region src/address/formatAddressSnapshot.d.ts
 //#endregion
 //#region src/card/types.d.ts
 type Card = {
@@ -2875,6 +2913,8 @@ type SiteAgent = {
 type Site = {
   id: number;
   slug: string;
+  name: string | null;
+  url: string | null;
   brandSlug: string | null;
   customDomain: string | null;
   enabled: boolean;
@@ -3101,7 +3141,7 @@ type SegmentCountResult = {
   reachable: number | null;
 }; //#endregion
 //#region src/campaign/types.d.ts
-type CampaignChannel = 'email' | 'whatsapp' | 'sms' | 'push';
+type CampaignChannel = CampaignChannelId;
 type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'scheduled' | 'sending' | 'completed' | 'failed';
 type CampaignCategory = 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
 type CampaignSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'approval_skipped';
@@ -3322,10 +3362,10 @@ type HookTriggerCondition = {
   value?: unknown;
 };
 type HookTriggerInput = string | {
-  source: 'payload';
+  source: 'payload' | 'contact' | 'enrollment';
   path: string;
 } | {
-  source: 'literal';
+  source: 'literal' | 'static';
   value: unknown;
 };
 type HookTrigger = {
@@ -3607,6 +3647,103 @@ declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions
   listOrderAccess(): GuestOrderAccess[];
 };
 //#endregion
+//#region src/commerce/guestCheckout.d.ts
+type GuestCheckoutCartItem = {
+  id: string;
+  type: 'product' | 'service' | 'coupon';
+  quantity: number;
+};
+type GuestCheckoutState<TCart = GuestCheckoutCartItem[]> = GuestCheckoutDraft<TCart> & {
+  identity: GuestBuyer;
+  address: AddressInput;
+};
+type GuestCheckoutErrorCode = 'empty_cart' | 'missing_identity' | 'missing_pickup_phone' | 'incomplete_shipping_address' | 'pickup_unavailable' | 'missing_shipping_rate' | 'rates_failed' | 'snapshot_failed' | 'review_required' | 'terms_required' | 'review_expired' | 'order_failed' | 'payment_failed';
+declare class GuestCheckoutError extends Error {
+  readonly code: GuestCheckoutErrorCode;
+  constructor(code: GuestCheckoutErrorCode);
+}
+type GuestCheckoutClient = {
+  commerce: {
+    checkout: {
+      shippingRates(team: string, data: {
+        address: {
+          country: string;
+          zipCode?: string;
+        };
+        items: GuestCheckoutCartItem[];
+      }): Promise<IAppResponse<ShippingRate[]>>;
+      snapshot(team: string, data: CheckoutSnapshotRequest): Promise<IAppResponse<CheckoutSnapshot>>;
+    };
+  };
+  orders: {
+    create(data: {
+      team: string;
+      snapshotId?: string;
+      snapshotAccessToken?: string;
+      guest?: GuestBuyer;
+      idempotencyKey?: string;
+      notes?: string;
+      sendConfirmation?: boolean;
+    }): Promise<IAppResponse<Order>>;
+    pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<IAppResponse<{
+      url: string;
+    }>>;
+  };
+};
+type CreateEmptyGuestCheckoutOptions = {
+  country?: string;
+  fulfillmentMethod?: FulfillmentMethod;
+};
+declare const createEmptyGuestCheckoutState: <TCart = GuestCheckoutCartItem[]>(options?: CreateEmptyGuestCheckoutOptions) => GuestCheckoutState<TCart>;
+declare const toGuestCheckoutDraft: <TCart>(state: GuestCheckoutState<TCart>) => GuestCheckoutDraft<TCart>;
+declare const assertGuestCheckoutReady: (state: GuestCheckoutState, pickupLocationIds?: number[]) => void;
+declare const buildGuestCheckoutSnapshotRequest: (state: GuestCheckoutState, options?: {
+  shippingRates?: ShippingRate[];
+  pickupLocationIds?: number[];
+}) => CheckoutSnapshotRequest;
+type GuestCheckoutSnapshotResult = {
+  snapshot: CheckoutSnapshot & {
+    accessToken: string;
+  };
+  shippingRates: ShippingRate[];
+  shippingRateId: number | null;
+};
+declare function createGuestCheckoutSnapshot(options: {
+  client: GuestCheckoutClient;
+  team: string;
+  state: GuestCheckoutState;
+  pickupLocationIds?: number[];
+  shippingRates?: ShippingRate[];
+}): Promise<GuestCheckoutSnapshotResult>;
+type PlaceGuestCheckoutOrderResult = {
+  order: Order;
+  accessToken: string | null; /** Payment provider redirect URL from `orders.pay`. Never the JoAi thank-you page. */
+  paymentUrl: string | null;
+};
+/**
+ * Places a guest order from a checkout snapshot and optionally starts payment.
+ *
+ * The client must already carry team context (e.g. `createClient({ team })` → `X-Team`).
+ * Body `team` alone is not enough for `orders.create`.
+ *
+ * When `pay` is enabled (default), `paymentUrl` is only set from a successful `orders.pay`
+ * response. `order.paymentUrl` from create is the JoAi thank-you URL and must not be used
+ * as a gateway redirect.
+ */
+declare function placeGuestCheckoutOrder(options: {
+  client: GuestCheckoutClient;
+  team: string;
+  snapshot: Pick<CheckoutSnapshot, 'id' | 'expiresAt'> & {
+    accessToken: string;
+  };
+  guest: GuestBuyer;
+  acceptedTerms?: boolean;
+  notes?: string;
+  idempotencyKey?: string;
+  pay?: boolean;
+}): Promise<PlaceGuestCheckoutOrderResult>;
+declare const isGuestCheckoutError: (error: unknown) => error is GuestCheckoutError;
+//#endregion
 //#region src/commerce/index.d.ts
 declare class CommerceResource {
   readonly checkout: CheckoutResource;
@@ -4563,7 +4700,7 @@ declare class OrdersResource {
     source?: 'kiosk';
     context?: OrderContext;
     linkVariationId?: string;
-    priceMode?: string;
+    priceMode?: OrderPriceMode;
     type?: OrderType;
     sendConfirmation?: boolean;
     invoiceDate?: string;
@@ -4589,6 +4726,7 @@ declare class OrdersResource {
     guest?: {
       name: string;
       email: string;
+      phone?: string;
     };
   }): Promise<IAppResponse<Order>>;
   update(id: string, data: {
@@ -4597,6 +4735,7 @@ declare class OrdersResource {
     serviceDate?: string;
     type?: OrderType;
     invoiceContactId?: string | null;
+    priceMode?: OrderPriceMode;
   }): Promise<IAppResponse<Order>>;
   convertToOrder(id: string): Promise<IAppResponse<Order>>;
   delete(id: string): Promise<IAppResponse<void>>;
@@ -4801,10 +4940,13 @@ declare class SitesResource {
   constructor(http: IHttpService);
   brands(): Promise<IAppResponse<SiteBrand[]>>;
   listMine(teamSlug: string): Promise<IAppResponse<Site[]>>;
-  create(teamSlug: string, slug: string, data?: {
+  create(teamSlug: string, data: {
+    name: string;
+    url?: string | null;
     contactId?: string | null;
     metricsSource?: string | null;
     metricsResource?: string | null;
+    monthlyReport?: boolean;
   }): Promise<IAppResponse<Site>>;
   provision(teamSlug: string, brandSlug: string, data?: {
     settings?: Record<string, unknown>;
@@ -4815,6 +4957,8 @@ declare class SitesResource {
     customDomain?: string | null;
     enabled?: boolean;
     modules?: string[];
+    name?: string | null;
+    url?: string | null;
     contactId?: string | null;
     metricsSource?: string | null;
     metricsResource?: string | null;
@@ -5077,6 +5221,7 @@ declare class AutomationsResource {
   private readonly http;
   constructor(http: IHttpService);
   list(): Promise<IAppResponse<Automation[]>>;
+  stats(): Promise<IAppResponse<AutomationStats>>;
   get(id: string): Promise<IAppResponse<Automation>>;
   create(payload: AutomationCreatePayload): Promise<IAppResponse<Automation>>;
   update(id: string, payload: AutomationUpdatePayload): Promise<IAppResponse<Automation>>;
@@ -5508,4 +5653,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutDraft, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, sanitizePortalCallbackUrl, toGuestCheckoutDraft };

package/dist/index.mjs

@@ -110,6 +110,37 @@ var HttpService = class {
 		};
 	}
 };
+const OUTBOUND_CHANNELS = [
+	{
+		id: "email",
+		supportsHtml: true,
+		requiresSubject: true,
+		settingsKey: "email_provider"
+	},
+	{
+		id: "whatsapp",
+		supportsHtml: false,
+		requiresSubject: false
+	},
+	{
+		id: "whatsapp-personal",
+		supportsHtml: false,
+		requiresSubject: false
+	},
+	{
+		id: "sms",
+		supportsHtml: false,
+		requiresSubject: false
+	},
+	{
+		id: "push",
+		supportsHtml: false,
+		requiresSubject: true
+	}
+];
+const AUTOMATION_SEND_CHANNELS = OUTBOUND_CHANNELS.filter((channel) => channel.id === "email" || channel.id === "whatsapp-personal");
+OUTBOUND_CHANNELS.map((channel) => channel.id).filter((id) => id !== "whatsapp-personal");
+AUTOMATION_SEND_CHANNELS[0];
 Object.values({
 	Billing: "billing",
 	Shipping: "shipping"
@@ -138,6 +169,7 @@ Object.values({
 	Received: "received",
 	Closed: "closed"
 });
+const isCompleteAddressInput = (address) => Boolean(address.name.trim() && address.addressOne.trim() && address.city.trim() && address.zipCode.trim() && address.country.trim());
 Object.values({
 	Board: "board",
 	Shop: "shop",
@@ -151,6 +183,7 @@ Object.values({
 	Heartbeats: "heartbeats",
 	Wallets: "wallets",
 	Campaigns: "campaigns",
+	Automations: "automations",
 	News: "news",
 	Sites: "sites",
 	Contracts: "contracts",
@@ -505,6 +538,171 @@ function createGuestCommerceStorage(options) {
 	};
 }
 //#endregion
+//#region src/commerce/guestCheckout.ts
+var GuestCheckoutError = class extends Error {
+	constructor(code) {
+		super(code);
+		this.code = code;
+		this.name = "GuestCheckoutError";
+	}
+};
+const createEmptyGuestCheckoutState = (options = {}) => ({
+	cart: [],
+	identity: {
+		name: "",
+		email: "",
+		phone: ""
+	},
+	fulfillmentMethod: options.fulfillmentMethod ?? "shipping",
+	address: {
+		name: "",
+		addressOne: "",
+		city: "",
+		zipCode: "",
+		country: options.country ?? "AT",
+		phone: ""
+	},
+	shippingRateId: null,
+	fulfillmentLocationId: null
+});
+const toGuestCheckoutDraft = (state) => ({
+	cart: state.cart,
+	fulfillmentMethod: state.fulfillmentMethod,
+	shippingRateId: state.shippingRateId,
+	fulfillmentLocationId: state.fulfillmentLocationId
+});
+const assertGuestCheckoutReady = (state, pickupLocationIds = []) => {
+	if (!state.cart.length) throw new GuestCheckoutError("empty_cart");
+	if (!state.identity.name.trim() || !state.identity.email.trim()) throw new GuestCheckoutError("missing_identity");
+	if (state.fulfillmentMethod === "pickup" && !state.identity.phone?.trim()) throw new GuestCheckoutError("missing_pickup_phone");
+	const address = {
+		...state.address,
+		name: state.identity.name
+	};
+	if (state.fulfillmentMethod === "shipping" && !isCompleteAddressInput(address)) throw new GuestCheckoutError("incomplete_shipping_address");
+	if (state.fulfillmentMethod === "pickup" && !state.fulfillmentLocationId && !pickupLocationIds[0]) throw new GuestCheckoutError("pickup_unavailable");
+};
+const buildGuestCheckoutSnapshotRequest = (state, options = {}) => {
+	assertGuestCheckoutReady(state, options.pickupLocationIds ?? []);
+	const items = state.cart.map(({ id, type, quantity }) => ({
+		id,
+		type,
+		quantity
+	}));
+	const address = {
+		...state.address,
+		name: state.identity.name
+	};
+	if (state.fulfillmentMethod === "shipping") {
+		const rates = options.shippingRates ?? [];
+		const rate = state.shippingRateId == null ? rates[0] : rates.find((item) => item.id === state.shippingRateId);
+		if (!rate) throw new GuestCheckoutError("missing_shipping_rate");
+		return {
+			fulfillmentMethod: "shipping",
+			items,
+			billingAddress: {
+				...address,
+				type: "billing"
+			},
+			shippingAddress: {
+				...address,
+				type: "shipping"
+			},
+			shippingRateId: rate.id
+		};
+	}
+	return {
+		fulfillmentMethod: "pickup",
+		items,
+		fulfillmentLocationId: state.fulfillmentLocationId || options.pickupLocationIds?.[0] || null
+	};
+};
+async function createGuestCheckoutSnapshot(options) {
+	const { client, team, state } = options;
+	const items = state.cart.map(({ id, type, quantity }) => ({
+		id,
+		type,
+		quantity
+	}));
+	let shippingRates = options.shippingRates ?? [];
+	if (state.fulfillmentMethod === "shipping" && !options.shippingRates) {
+		const address = {
+			...state.address,
+			name: state.identity.name
+		};
+		const ratesResponse = await client.commerce.checkout.shippingRates(team, {
+			address: {
+				country: address.country,
+				zipCode: address.zipCode
+			},
+			items
+		});
+		if (!ratesResponse.ok || !Array.isArray(ratesResponse.data)) throw new GuestCheckoutError("rates_failed");
+		shippingRates = ratesResponse.data;
+	}
+	const snapshotRequest = buildGuestCheckoutSnapshotRequest(state, {
+		shippingRates,
+		pickupLocationIds: options.pickupLocationIds
+	});
+	const snapshot = await client.commerce.checkout.snapshot(team, snapshotRequest);
+	if (!snapshot.ok || !snapshot.data?.id || !snapshot.data.accessToken) throw new GuestCheckoutError("snapshot_failed");
+	return {
+		snapshot: {
+			...snapshot.data,
+			accessToken: snapshot.data.accessToken
+		},
+		shippingRates,
+		shippingRateId: typeof snapshotRequest.shippingRateId === "number" ? snapshotRequest.shippingRateId : null
+	};
+}
+/**
+* Places a guest order from a checkout snapshot and optionally starts payment.
+*
+* The client must already carry team context (e.g. `createClient({ team })` → `X-Team`).
+* Body `team` alone is not enough for `orders.create`.
+*
+* When `pay` is enabled (default), `paymentUrl` is only set from a successful `orders.pay`
+* response. `order.paymentUrl` from create is the JoAi thank-you URL and must not be used
+* as a gateway redirect.
+*/
+async function placeGuestCheckoutOrder(options) {
+	if (!options.acceptedTerms) throw new GuestCheckoutError("terms_required");
+	const expiresAt = new Date(options.snapshot.expiresAt).getTime();
+	if (!Number.isFinite(expiresAt) || expiresAt <= Date.now()) throw new GuestCheckoutError("review_expired");
+	const order = await options.client.orders.create({
+		team: options.team,
+		snapshotId: options.snapshot.id,
+		snapshotAccessToken: options.snapshot.accessToken,
+		guest: options.guest,
+		idempotencyKey: options.idempotencyKey ?? crypto.randomUUID(),
+		notes: options.notes,
+		sendConfirmation: true
+	});
+	if (!order.ok || !order.data?.id) throw new GuestCheckoutError("order_failed");
+	const accessToken = typeof order.meta?.orderAccessToken === "string" ? order.meta.orderAccessToken : null;
+	if (options.pay === false) return {
+		order: order.data,
+		accessToken,
+		paymentUrl: null
+	};
+	if (!accessToken) throw new GuestCheckoutError("payment_failed");
+	const payment = await options.client.orders.pay(order.data.id, void 0, accessToken);
+	if (!payment.ok || !payment.data?.url) return {
+		order: order.data,
+		accessToken,
+		paymentUrl: null
+	};
+	return {
+		order: order.data,
+		accessToken,
+		paymentUrl: payment.data.url
+	};
+}
+const isGuestCheckoutError = (error) => {
+	if (error instanceof GuestCheckoutError) return true;
+	return typeof error === "object" && error !== null && error.name === "GuestCheckoutError" && typeof error.code === "string";
+};
+//#endregion
 //#region src/commerce/index.ts
 var CommerceResource = class {
 	constructor(http) {
@@ -1921,7 +2119,7 @@ var OrdersResource = class {
 		return this.http.get(`orders/${id}`, orderAccessHeaders(accessToken));
 	}
 	create(data) {
-		return this.http.post("orders", data);
+		return this.http.post("orders", data, { headers: { "X-Team": data.team } });
 	}
 	update(id, data) {
 		return this.http.put(`orders/${id}`, data);
@@ -2175,10 +2373,9 @@ var SitesResource = class {
 	listMine(teamSlug) {
 		return this.http.get(`sites/mine?team=${encodeURIComponent(teamSlug)}`);
 	}
-	create(teamSlug, slug, data) {
+	create(teamSlug, data) {
 		return this.http.post("sites", {
 			team: teamSlug,
-			slug,
 			...data
 		});
 	}
@@ -2611,6 +2808,9 @@ var AutomationsResource = class {
 	list() {
 		return this.http.get("automations");
 	}
+	stats() {
+		return this.http.get("automations/stats");
+	}
 	get(id) {
 		return this.http.get(`automations/${id}`);
 	}
@@ -3355,4 +3555,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, GuestCheckoutError, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, sanitizePortalCallbackUrl, toGuestCheckoutDraft };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "4.7.0",
+  "version": "4.8.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",