@joai/sdk 7.0.5 → 7.0.6

package/dist/index.d.mts

@@ -71,6 +71,8 @@ declare class AddressesResource {
 type PlaceCheckoutOrderRequest = CheckoutSnapshotRequest & {
   guest?: GuestBuyer;
   notes?: string;
+  scheduledAt?: string;
+  serviceSlug?: string;
   idempotencyKey?: string;
   saveAddresses?: boolean;
   sendConfirmation?: boolean;
@@ -170,7 +172,7 @@ type ShippingRateInput = {
 };
 type FulfillmentLocationInput = {
   name: string;
-  addressId?: number | null;
+  addressId?: string | null;
   instructions?: string | null;
   active?: boolean;
 };
@@ -186,8 +188,8 @@ declare class ShippingResource {
   deleteRate(team: string, zoneId: number, rateId: number): Promise<_$_joai_core0.IAppResponse<void>>;
   locations(team: string): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1[]>>;
   createLocation(team: string, data: FulfillmentLocationInput): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1>>;
-  updateLocation(team: string, locationId: number, data: FulfillmentLocationInput): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1>>;
-  deleteLocation(team: string, locationId: number): Promise<_$_joai_core0.IAppResponse<void>>;
+  updateLocation(team: string, locationId: string, data: FulfillmentLocationInput): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1>>;
+  deleteLocation(team: string, locationId: string): Promise<_$_joai_core0.IAppResponse<void>>;
 }
 //#endregion
 //#region src/commerce/guest.d.ts
@@ -199,8 +201,10 @@ type GuestCheckoutDraft<TCart = unknown> = {
   cart: TCart;
   fulfillmentMethod: FulfillmentMethod;
   shippingRateId: number | null;
-  fulfillmentLocationId: number | null;
-  couponCode?: string | null;
+  fulfillmentLocationId: string | null;
+  couponCode?: string | null; /** Pickup appointment start (ISO-8601), required for pickup confirm. */
+  scheduledAt?: string | null; /** Bookable service slug when the shop has more than one. */
+  serviceSlug?: string | null;
 };
 type GuestCommerceStorageOptions = {
   namespace: string;
@@ -234,7 +238,7 @@ type GuestCheckoutState<TCart = GuestCheckoutCartItem[]> = GuestCheckoutDraft<TC
   identity: GuestBuyer$1;
   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';
+type GuestCheckoutErrorCode = 'empty_cart' | 'missing_identity' | 'missing_pickup_phone' | 'missing_scheduled_at' | '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);
@@ -260,6 +264,8 @@ type GuestCheckoutClient = {
       guest?: GuestBuyer$1;
       idempotencyKey?: string;
       notes?: string;
+      scheduledAt?: string;
+      serviceSlug?: string;
       sendConfirmation?: boolean;
     }): Promise<IAppResponse<Order$1>>;
     pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<IAppResponse<{
@@ -273,10 +279,11 @@ type CreateEmptyGuestCheckoutOptions = {
 };
 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 assertGuestCheckoutReady: (state: GuestCheckoutState, pickupLocationIds?: string[]) => void;
+declare const assertGuestPickupSlotReady: (state: GuestCheckoutState) => void;
 declare const buildGuestCheckoutSnapshotRequest: (state: GuestCheckoutState, options?: {
   shippingRates?: ShippingRate$1[];
-  pickupLocationIds?: number[];
+  pickupLocationIds?: string[];
 }) => CheckoutSnapshotRequest;
 type GuestCheckoutSnapshotResult = {
   snapshot: CheckoutSnapshot$1 & {
@@ -289,7 +296,7 @@ declare function createGuestCheckoutSnapshot(options: {
   client: GuestCheckoutClient;
   team: string;
   state: GuestCheckoutState;
-  pickupLocationIds?: number[];
+  pickupLocationIds?: string[];
   shippingRates?: ShippingRate$1[];
 }): Promise<GuestCheckoutSnapshotResult>;
 type PlaceGuestCheckoutOrderResult = {
@@ -317,6 +324,8 @@ declare function placeGuestCheckoutOrder(options: {
   guest: GuestBuyer$1;
   acceptedTerms?: boolean;
   notes?: string;
+  scheduledAt?: string;
+  serviceSlug?: string;
   idempotencyKey?: string;
   pay?: boolean;
 }): Promise<PlaceGuestCheckoutOrderResult>;
@@ -391,6 +400,9 @@ declare function revalidateGuestCoupon(options: {
   items: GuestCheckoutCartItem[];
 }): Promise<RevalidateGuestCouponResult>;
 //#endregion
+//#region src/commerce/pickupSlotLabel.d.ts
+declare const formatPickupSlotLabel: (iso: string, locale: string, timeZone: string) => string;
+//#endregion
 //#region src/commerce/index.d.ts
 declare class CommerceResource {
   readonly checkout: CheckoutResource;
@@ -1380,18 +1392,21 @@ declare class OrdersResource {
     fulfillmentMethod?: FulfillmentMethod;
     snapshotId?: string;
     snapshotAccessToken?: string;
-    billingAddressId?: number;
-    shippingAddressId?: number;
+    billingAddressId?: string;
+    shippingAddressId?: string;
     billingAddress?: AddressInput;
     shippingAddress?: AddressInput;
     shippingRateId?: number;
-    fulfillmentLocationId?: number;
+    fulfillmentLocationId?: string;
     idempotencyKey?: string;
     guest?: {
       name: string;
       email: string;
       phone?: string;
     };
+    scheduledAt?: string;
+    serviceSlug?: string;
+    couponCode?: string;
   }): Promise<_$_joai_core0.IAppResponse<Order$1>>;
   update(id: string, data: {
     status?: OrderStatus$1;
@@ -1709,9 +1724,9 @@ declare class SubscriptionsResource {
   resume(id: string, team: string): Promise<_$_joai_core0.IAppResponse<Subscription>>;
   updateDelivery(id: string, data: {
     fulfillmentMethod: 'shipping' | 'pickup';
-    shippingAddressId?: number | null;
+    shippingAddressId?: string | null;
     shippingRateId?: number | null;
-    fulfillmentLocationId?: number | null;
+    fulfillmentLocationId?: string | null;
   }): Promise<_$_joai_core0.IAppResponse<Subscription>>;
   skip(id: string): Promise<_$_joai_core0.IAppResponse<Subscription>>;
   pause(id: string): Promise<_$_joai_core0.IAppResponse<Subscription>>;
@@ -2344,4 +2359,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, type AuthUser, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, type Cart, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocation, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCartAmounts, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestCouponClient, GuestCouponError, type GuestCouponErrorCode, type GuestCouponPreview, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, type ItemListParams, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type AuthUser, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, type Cart, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocation, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCartAmounts, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestCouponClient, GuestCouponError, type GuestCouponErrorCode, type GuestCouponPreview, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, type ItemListParams, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, assertGuestPickupSlotReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };

package/dist/index.mjs

@@ -390,14 +390,18 @@ const createEmptyGuestCheckoutState = (options = {}) => ({
 	},
 	shippingRateId: null,
 	fulfillmentLocationId: null,
-	couponCode: null
+	couponCode: null,
+	scheduledAt: null,
+	serviceSlug: null
 });
 const toGuestCheckoutDraft = (state) => ({
 	cart: state.cart,
 	fulfillmentMethod: state.fulfillmentMethod,
 	shippingRateId: state.shippingRateId,
 	fulfillmentLocationId: state.fulfillmentLocationId,
-	couponCode: state.couponCode ?? null
+	couponCode: state.couponCode ?? null,
+	scheduledAt: state.scheduledAt ?? null,
+	serviceSlug: state.serviceSlug ?? null
 });
 const assertGuestCheckoutReady = (state, pickupLocationIds = []) => {
 	if (!state.cart.length) throw new GuestCheckoutError("empty_cart");
@@ -410,6 +414,9 @@ const assertGuestCheckoutReady = (state, pickupLocationIds = []) => {
 	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 assertGuestPickupSlotReady = (state) => {
+	if (state.fulfillmentMethod === "pickup" && !state.scheduledAt?.trim()) throw new GuestCheckoutError("missing_scheduled_at");
+};
 const buildGuestCheckoutSnapshotRequest = (state, options = {}) => {
 	assertGuestCheckoutReady(state, options.pickupLocationIds ?? []);
 	const items = state.cart.map(({ id, type, quantity }) => ({
@@ -507,6 +514,8 @@ async function placeGuestCheckoutOrder(options) {
 		guest: options.guest,
 		idempotencyKey: options.idempotencyKey ?? crypto.randomUUID(),
 		notes: options.notes,
+		scheduledAt: options.scheduledAt,
+		serviceSlug: options.serviceSlug,
 		sendConfirmation: true
 	});
 	if (!order.ok || !order.data?.id) throw new GuestCheckoutError("order_failed");
@@ -618,6 +627,16 @@ async function revalidateGuestCoupon(options) {
 	}
 }
 //#endregion
+//#region src/commerce/pickupSlotLabel.ts
+const formatPickupSlotLabel = (iso, locale, timeZone) => new Intl.DateTimeFormat(locale, {
+	timeZone,
+	weekday: "short",
+	day: "numeric",
+	month: "short",
+	hour: "2-digit",
+	minute: "2-digit"
+}).format(new Date(iso));
+//#endregion
 //#region src/commerce/index.ts
 var CommerceResource = class {
 	constructor(http) {
@@ -3542,4 +3561,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, GuestCheckoutError, GuestCouponError, 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, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };
+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, GuestCouponError, 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, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, assertGuestPickupSlotReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "7.0.5",
+  "version": "7.0.6",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -35,11 +35,11 @@
     "test": "jest --config jest.config.js"
   },
   "dependencies": {
-    "@joai/core": "^4.15.4",
+    "@joai/core": "^4.15.5",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.15.4"
+    "@joai/core": "^4.15.5"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",