@joai/sdk 7.0.6 → 7.0.7

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _$_joai_core0 from "@joai/core";
-import { Address, AddressCreatePayload, AddressInput, AddressType, AddressUpdatePayload, Affiliate, AffiliateTier, Agent, AgentActionHistoryEntry, AgentPrivate, AgentSettings, AgentTrustedActionRule, AiCostsResponse, Alert, ApiToken, AppEnv, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentBooking, AppointmentPolicy, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementVariation, EmbedStatus, Entity, Flow, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IHttpService, IRequestOptions, Inquiry, InquiryType, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, McpToolCall, Media, MediaAspectRatio, Meeting, MeetingJoinInfo, MeetingSpeakerAssignment, MeetingSummary, Memory, Message, MetricSource, MetricsResult, Mission, MissionCreatePayload, Notification, NotificationChannel, NotificationSetting, OfficeSnapshot, Order, Order as Order$1, OrderContext, OrderPriceMode, OrderPriceMode as OrderPriceMode$1, OrderStatus, OrderStatus as OrderStatus$1, OrderType, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, Plan, PlanFeature, Product, Product as Product$1, ProductRelation, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalPollOption, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedSocialPost, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPrivate, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, ToggleKvFieldResult, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeStatus, UserPrivate, UserRole, UserSettings, VolumePrice, WarpBackend, WarpBackendStatus, WarpExecutionBackend, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceInfo, XIntegrationStatus } from "@joai/core";
+import { Address, AddressCreatePayload, AddressInput, AddressType, AddressUpdatePayload, Affiliate, AffiliateTier, Agent, AgentActionHistoryEntry, AgentPrivate, AgentSettings, AgentTrustedActionRule, AiCostsResponse, Alert, ApiToken, AppEnv, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentBooking, AppointmentPolicy, AppointmentPolicyUpsert, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementVariation, EmbedStatus, Entity, Flow, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IHttpService, IRequestOptions, Inquiry, InquiryType, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, McpToolCall, Media, MediaAspectRatio, Meeting, MeetingJoinInfo, MeetingSpeakerAssignment, MeetingSummary, Memory, Message, MetricSource, MetricsResult, Mission, MissionCreatePayload, Notification, NotificationChannel, NotificationSetting, OfficeSnapshot, Order, Order as Order$1, OrderContext, OrderPriceMode, OrderPriceMode as OrderPriceMode$1, OrderStatus, OrderStatus as OrderStatus$1, OrderType, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, Plan, PlanFeature, Product, Product as Product$1, ProductRelation, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalPollOption, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, TaxClass, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPrivate, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, ToggleKvFieldResult, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeStatus, UserPrivate, UserRole, UserSettings, VolumePrice, WarpBackend, WarpBackendStatus, WarpExecutionBackend, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceInfo, XIntegrationStatus } from "@joai/core";
 import { WarpChainName, WarpClient, WarpLocale, WarpText, WarpWalletProvider } from "@joai/warps";
 
 //#region src/resources/agents.d.ts
@@ -109,10 +109,16 @@ declare class CheckoutResource {
 }
 //#endregion
 //#region src/commerce/fulfillments.d.ts
+type FulfillmentUpdateInput = {
+  status?: Fulfillment['status'];
+  carrierCode?: string | null;
+  trackingNumber?: string | null;
+};
 declare class FulfillmentsResource {
   private readonly http;
   constructor(http: IHttpService);
   list(orderId: string): Promise<_$_joai_core0.IAppResponse<Fulfillment[]>>;
+  carriers(): Promise<_$_joai_core0.IAppResponse<ShippingCarrierOption[]>>;
   create(orderId: string, data: {
     items: {
       orderItemId: number;
@@ -120,10 +126,9 @@ declare class FulfillmentsResource {
     }[];
     carrierCode?: string;
     trackingNumber?: string;
-    trackingUrl?: string;
     status?: Fulfillment['status'];
   }): Promise<_$_joai_core0.IAppResponse<Fulfillment>>;
-  update(orderId: string, fulfillmentId: string, status: Fulfillment['status']): Promise<_$_joai_core0.IAppResponse<Fulfillment>>;
+  update(orderId: string, fulfillmentId: string, data: FulfillmentUpdateInput | Fulfillment['status']): Promise<_$_joai_core0.IAppResponse<Fulfillment>>;
 }
 //#endregion
 //#region src/commerce/returns.d.ts
@@ -192,6 +197,22 @@ declare class ShippingResource {
   deleteLocation(team: string, locationId: string): Promise<_$_joai_core0.IAppResponse<void>>;
 }
 //#endregion
+//#region src/commerce/taxClasses.d.ts
+type TaxClassInput = {
+  name: string;
+  rate: number;
+  isDefault?: boolean;
+  position?: number;
+};
+declare class TaxClassesResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(team: string): Promise<_$_joai_core0.IAppResponse<TaxClass[]>>;
+  create(team: string, data: TaxClassInput): Promise<_$_joai_core0.IAppResponse<TaxClass>>;
+  update(team: string, taxClassId: string, data: TaxClassInput): Promise<_$_joai_core0.IAppResponse<TaxClass>>;
+  delete(team: string, taxClassId: string): Promise<_$_joai_core0.IAppResponse<void>>;
+}
+//#endregion
 //#region src/commerce/guest.d.ts
 type GuestOrderAccess = {
   orderId: string;
@@ -401,12 +422,14 @@ declare function revalidateGuestCoupon(options: {
 }): Promise<RevalidateGuestCouponResult>;
 //#endregion
 //#region src/commerce/pickupSlotLabel.d.ts
-declare const formatPickupSlotLabel: (iso: string, locale: string, timeZone: string) => string;
+/** Formats a pickup slot in a locale-aware 24h label. Pass timeZone when the meeting/policy provides one. */
+declare const formatPickupSlotLabel: (iso: string, locale: string, timeZone?: string | null) => string;
 //#endregion
 //#region src/commerce/index.d.ts
 declare class CommerceResource {
   readonly checkout: CheckoutResource;
   readonly shipping: ShippingResource;
+  readonly taxClasses: TaxClassesResource;
   readonly fulfillments: FulfillmentsResource;
   readonly returns: ReturnsResource;
   constructor(http: IHttpService);
@@ -558,7 +581,7 @@ declare class AppointmentsResource {
   private readonly config;
   constructor(http: IHttpService, config: JoAiClientConfig);
   getPolicy(): Promise<_$_joai_core0.IAppResponse<AppointmentPolicy | null>>;
-  upsertPolicy(data: Partial<AppointmentPolicy>): Promise<_$_joai_core0.IAppResponse<AppointmentPolicy>>;
+  upsertPolicy(data: AppointmentPolicyUpsert): Promise<_$_joai_core0.IAppResponse<AppointmentPolicy>>;
   checkAvailability(agentUuid: string, params: {
     windowStart: string;
     windowEnd: string;
@@ -701,7 +724,7 @@ declare class BillingResource {
   orders(team: TeamPrivate | null, page?: number, filters?: {
     contactId?: string;
     couponId?: string;
-  }): Promise<_$_joai_core0.IAppResponse<Order$1[]>>;
+  }, perPage?: number): Promise<_$_joai_core0.IAppResponse<Order$1[]>>;
   orderStats(team: string): Promise<_$_joai_core0.IAppResponse<TeamOrderStats>>;
   payOrder(id: string, provider?: PaymentProvider, accessToken?: string): Promise<_$_joai_core0.IAppResponse<{
     url: string;
@@ -901,12 +924,14 @@ declare class DocumentsResource {
     blueprint?: string;
   }): Promise<_$_joai_core0.IAppResponse<Document>>;
   get(id: string): Promise<_$_joai_core0.IAppResponse<Document>>;
-  getShared(slug: string): Promise<_$_joai_core0.IAppResponse<Document>>;
+  getShared(slug: string, password?: string): Promise<_$_joai_core0.IAppResponse<Document>>;
   update(id: string, data: {
     title?: string;
     content?: string;
     public?: boolean;
     archived?: boolean;
+    password?: string | null;
+    clearPassword?: boolean;
     meta?: Record<string, unknown>;
   }): Promise<_$_joai_core0.IAppResponse<Document>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
@@ -1365,7 +1390,7 @@ declare class OfficeResource {
 declare class OrdersResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(team: string): Promise<_$_joai_core0.IAppResponse<Order$1[]>>;
+  list(team: string, page?: number, perPage?: number): Promise<_$_joai_core0.IAppResponse<Order$1[]>>;
   get(id: string, accessToken?: string): Promise<_$_joai_core0.IAppResponse<Order$1>>;
   create(data: {
     contactId?: string;
@@ -1387,6 +1412,7 @@ declare class OrdersResource {
       quantity: number;
       name?: string;
       unitPrice?: number;
+      taxClassId?: string | null;
       configuration?: Configuration;
     }[];
     fulfillmentMethod?: FulfillmentMethod;
@@ -1451,6 +1477,7 @@ declare class ProductsResource {
     description?: TranslatableValue | null;
     virtual?: boolean;
     public?: boolean;
+    taxClassId?: string | null;
   }, teamSlug?: string): Promise<_$_joai_core0.IAppResponse<Product>>;
   update(id: string, data: {
     name?: TranslatableValue;
@@ -1461,6 +1488,7 @@ declare class ProductsResource {
     active?: boolean;
     public?: boolean;
     virtual?: boolean;
+    taxClassId?: string | null;
     media?: string[];
   }): Promise<_$_joai_core0.IAppResponse<Product>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
@@ -1585,10 +1613,11 @@ declare class ServicesResource {
     digital?: boolean;
     public?: boolean;
     bookable?: boolean;
+    taxClassId?: string | null;
     pricingModel?: string;
     settings?: Record<string, unknown> | null;
   }): Promise<_$_joai_core0.IAppResponse<Service>>;
-  update(id: string, data: Partial<Pick<Service, 'name' | 'price' | 'description' | 'active' | 'digital' | 'public' | 'bookable'>> & {
+  update(id: string, data: Partial<Pick<Service, 'name' | 'price' | 'description' | 'active' | 'digital' | 'public' | 'bookable' | 'taxClassId'>> & {
     durationMinutes?: number | null;
     settings?: Record<string, unknown> | null;
   }): Promise<_$_joai_core0.IAppResponse<Service>>;
@@ -2359,4 +2388,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, 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 };
+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 TaxClassInput, TaxClassesResource, 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

@@ -1,4 +1,4 @@
-import { HttpService, cartLineTotal, cartPayableTotal, getApiBaseUrl, isCompleteAddressInput } from "@joai/core";
+import { HttpService, cartLineTotal, cartPayableTotal, firstValidationMessage, getApiBaseUrl, isCompleteAddressInput, validationMessageFor } from "@joai/core";
 import { WarpClient } from "@joai/warps";
 //#region src/resources/agents.ts
 var AgentsResource = class {
@@ -162,11 +162,15 @@ var FulfillmentsResource = class {
 	list(orderId) {
 		return this.http.get(`orders/${orderId}/fulfillments`);
 	}
+	carriers() {
+		return this.http.get("shipping-carriers");
+	}
 	create(orderId, data) {
 		return this.http.post(`orders/${orderId}/fulfillments`, data);
 	}
-	update(orderId, fulfillmentId, status) {
-		return this.http.patch(`orders/${orderId}/fulfillments/${fulfillmentId}`, { status });
+	update(orderId, fulfillmentId, data) {
+		const body = typeof data === "string" ? { status: data } : data;
+		return this.http.patch(`orders/${orderId}/fulfillments/${fulfillmentId}`, body);
 	}
 };
 //#endregion
@@ -227,6 +231,25 @@ var ShippingResource = class {
 	}
 };
 //#endregion
+//#region src/commerce/taxClasses.ts
+var TaxClassesResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(team) {
+		return this.http.get(`teams/${team}/tax-classes`);
+	}
+	create(team, data) {
+		return this.http.post(`teams/${team}/tax-classes`, data);
+	}
+	update(team, taxClassId, data) {
+		return this.http.patch(`teams/${team}/tax-classes/${taxClassId}`, data);
+	}
+	delete(team, taxClassId) {
+		return this.http.delete(`teams/${team}/tax-classes/${taxClassId}`);
+	}
+};
+//#endregion
 //#region src/commerce/guest.ts
 const orderAccessPrefix = "joai:order-access:";
 const checkoutKey = (namespace) => `joai:guest-checkout:${namespace}`;
@@ -518,7 +541,11 @@ async function placeGuestCheckoutOrder(options) {
 		serviceSlug: options.serviceSlug,
 		sendConfirmation: true
 	});
-	if (!order.ok || !order.data?.id) throw new GuestCheckoutError("order_failed");
+	if (!order.ok || !order.data?.id) {
+		const validationMessage = firstValidationMessage(order.errors);
+		if (validationMessage) throw new Error(validationMessage);
+		throw new GuestCheckoutError("order_failed");
+	}
 	const accessToken = typeof order.meta?.orderAccessToken === "string" ? order.meta.orderAccessToken : null;
 	if (options.pay === false) return {
 		order: order.data,
@@ -553,12 +580,7 @@ var GuestCouponError = class extends Error {
 	}
 };
 /** First `couponCode` validation message from an API error payload. */
-const guestCouponMessageFromErrors = (errors) => {
-	if (!errors || typeof errors !== "object" || Array.isArray(errors)) return void 0;
-	const couponError = errors.couponCode;
-	if (Array.isArray(couponError) && typeof couponError[0] === "string") return couponError[0];
-	if (typeof couponError === "string") return couponError;
-};
+const guestCouponMessageFromErrors = (errors) => validationMessageFor(errors, "couponCode");
 const isGuestCouponError = (error) => {
 	if (error instanceof GuestCouponError) return true;
 	return typeof error === "object" && error !== null && error.name === "GuestCouponError" && typeof error.code === "string";
@@ -628,13 +650,16 @@ async function revalidateGuestCoupon(options) {
 }
 //#endregion
 //#region src/commerce/pickupSlotLabel.ts
+/** Formats a pickup slot in a locale-aware 24h label. Pass timeZone when the meeting/policy provides one. */
 const formatPickupSlotLabel = (iso, locale, timeZone) => new Intl.DateTimeFormat(locale, {
-	timeZone,
+	...timeZone ? { timeZone } : {},
 	weekday: "short",
-	day: "numeric",
-	month: "short",
+	day: "2-digit",
+	month: "2-digit",
+	year: "numeric",
 	hour: "2-digit",
-	minute: "2-digit"
+	minute: "2-digit",
+	hourCycle: "h23"
 }).format(new Date(iso));
 //#endregion
 //#region src/commerce/index.ts
@@ -642,6 +667,7 @@ var CommerceResource = class {
 	constructor(http) {
 		this.checkout = new CheckoutResource(http);
 		this.shipping = new ShippingResource(http);
+		this.taxClasses = new TaxClassesResource(http);
 		this.fulfillments = new FulfillmentsResource(http);
 		this.returns = new ReturnsResource(http);
 	}
@@ -1012,8 +1038,8 @@ var BillingResource = class {
 	checkoutProduct(id) {
 		return this.http.get(`products/${id}`);
 	}
-	orders(team, page = 1, filters = {}) {
-		let params = `orders?page=${page}`;
+	orders(team, page = 1, filters = {}, perPage = 10) {
+		let params = `orders?page=${page}&perPage=${perPage}`;
 		if (filters.contactId) params += `&contactId=${encodeURIComponent(filters.contactId)}`;
 		if (filters.couponId) params += `&couponId=${encodeURIComponent(filters.couponId)}`;
 		return this.http.get(params, team ? { headers: { "X-Team": team.slug } } : void 0);
@@ -1365,8 +1391,9 @@ var DocumentsResource = class {
 	get(id) {
 		return this.http.get(`documents/${id}`);
 	}
-	getShared(slug) {
-		return this.http.get(`documents/shared/${encodeURIComponent(slug)}`);
+	getShared(slug, password) {
+		const query = password ? `?password=${encodeURIComponent(password)}` : "";
+		return this.http.get(`documents/shared/${encodeURIComponent(slug)}${query}`);
 	}
 	update(id, data) {
 		return this.http.put(`documents/${id}`, data);
@@ -2062,8 +2089,8 @@ var OrdersResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	list(team) {
-		return this.http.get("orders", { headers: { "X-Team": team } });
+	list(team, page = 1, perPage = 10) {
+		return this.http.get(`orders?page=${page}&perPage=${perPage}`, { headers: { "X-Team": team } });
 	}
 	get(id, accessToken) {
 		return this.http.get(`orders/${id}`, orderAccessHeaders(accessToken));
@@ -3561,4 +3588,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, 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 };
+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, TaxClassesResource, 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.6",
+  "version": "7.0.7",
   "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.5",
+    "@joai/core": "^4.15.6",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.15.5"
+    "@joai/core": "^4.15.6"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",