@joai/sdk 13.0.1 → 13.1.0

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, AnalyticsConfiguration, ApiToken, AppEnv, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentBooking, AppointmentPolicy, AppointmentPolicyUpsert, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactDeliveryPreview, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarFeed, CalendarFeedInput, CalendarFeedSyncResult, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSendTestDraftPayload, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, ClientProposal, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentValue, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementType, ElementVariation, EmbedStatus, Entity, Flow, FollowListParams, FollowPayload, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, HashidInput, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IHttpService, IRequestOptions, IdentifiedSiteEvent, Inquiry, InquiryType, Install, InstallClaimPayload, InstallOptOutPayload, InstallRegisterPayload, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyCollectPointInput, LoyaltyCollectResponse, LoyaltyJoinResponse, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, LoyaltyWalletAccount, 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, ProductDetailSection, ProductRelation, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalCreateInput, ProposalPollOption, ProposalPricing, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedArtifact, SharedProposal, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostScheduleSlot, 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, TemplateMode, TemplateOverrides, TemplateSpec, 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, AddressInput as AddressInput$1, AddressType, AddressUpdatePayload, Affiliate, AffiliateTier, Agent, AgentActionHistoryEntry, AgentPrivate, AgentSettings, AgentTrustedActionRule, AiCostsResponse, Alert, AnalyticsConfiguration, ApiToken, AppEnv, AppEnv as AppEnv$1, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentPolicy, AppointmentPolicyUpsert, AppointmentRequest, Artifact, ArtifactCreatePayload, ArtifactDeliverPayload, ArtifactDelivery, ArtifactDeliveryPreview, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, AuthUser as AuthUser$1, Automation, AutomationActionInput, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationStats, AutomationUpdatePayload, Blueprint, BlueprintSettings, BrandBackend, BrandSiteConfig, BrandSourceConfig, CalendarFeed, CalendarFeedInput, CalendarFeedSyncResult, CalendarStatus, Campaign, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSendTestDraftPayload, CampaignStats, CampaignUpdatePayload, Card, Cart, Cart as Cart$1, CartItem, CartLine, ChangelogEntry, Character, CheckoutSnapshot, CheckoutSnapshot as CheckoutSnapshot$1, CheckoutSnapshotRequest, CheckoutSnapshotRequest as CheckoutSnapshotRequest$1, ClientProposal, CommissionAgreement, Configuration, Contact, ContactActivity, ContactCreatePayload, ContactFormData, ContactRelation, ContactRelationPayload, ContactRelationUpdatePayload, Content, ContentValue, ContentVersion, Contract, ContractCategoryName, ContractVersion, Coupon, CouponCondition, CouponRestrictedItem, CreateContentInput, CreateHookPayload, CreateHookPayload as CreateHookPayload$1, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, Document, EarnResponse, Element, ElementSpec, ElementType, ElementVariation, EmbedStatus, Entity, Flow, FollowListParams, FollowPayload, Fulfillment, FulfillmentLocation, FulfillmentLocation as FulfillmentLocation$1, FulfillmentMethod, GamificationData, Goal, GoalCreatePayload, GuestBuyer, GuestBuyer as GuestBuyer$1, HashidInput, HashidInput as HashidInput$1, Hook, Hook as Hook$1, HookSample, HookSample as HookSample$1, HookTrigger, HookTriggerCondition, HookTriggerInput, IAppResponse, IAppResponse as IAppResponse$1, IHttpService, IRequestOptions, IdentifiedSiteEvent, Inquiry, InquiryType, Install, InstallClaimPayload, InstallOptOutPayload, InstallRegisterPayload, Integration, IntegrationType, Intent, Item, ItemCreatePayload, ItemUpdatePayload, JsonValue, KvEntryPayload, KvField, KvFieldWithEntries, Link, LinkCreatePayload, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LoyaltyAccount, LoyaltyCollectPointInput, LoyaltyCollectResponse, LoyaltyJoinResponse, LoyaltyMember, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyTier, LoyaltyTransaction, LoyaltyWalletAccount, 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, ProductDetailSection, ProductDetailSection as ProductDetailSection$1, ProductDetailText, ProductRelation, ProductRelationType, ProductVariation, ProgramSettings, Project, ProjectExportResponse, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectStudioHistoryEntry, Proposal, ProposalAction, ProposalCreateInput, ProposalPollOption, ProposalPricing, PublicFormResults, PurchaseResult, RampProviderInfo, Reactions, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomKind, Segment, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, Service, SetKvEntryResult, SharedArtifact, SharedProposal, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostScheduleSlot, 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, TemplateMode, TemplateOverrides, TemplateSpec, TerminalConnectionToken, TerminalPaymentIntent, ToggleKvFieldResult, TranslatableValue, TranslatableValue as TranslatableValue$1, 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
@@ -60,15 +60,15 @@ type AddressQuery = {
 declare class AddressesResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(params?: AddressQuery): Promise<IAppResponse<Address[]>>;
-  get(params?: Omit<AddressQuery, 'type'>): Promise<IAppResponse<Address | null>>;
-  create(data: AddressCreatePayload): Promise<IAppResponse<Address>>;
-  update(id: string, data: AddressUpdatePayload): Promise<IAppResponse<Address>>;
-  delete(id: string): Promise<IAppResponse<void>>;
+  list(params?: AddressQuery): Promise<IAppResponse$1<Address[]>>;
+  get(params?: Omit<AddressQuery, 'type'>): Promise<IAppResponse$1<Address | null>>;
+  create(data: AddressCreatePayload): Promise<IAppResponse$1<Address>>;
+  update(id: string, data: AddressUpdatePayload): Promise<IAppResponse$1<Address>>;
+  delete(id: string): Promise<IAppResponse$1<void>>;
 }
 //#endregion
 //#region src/commerce/checkout.d.ts
-type PlaceCheckoutOrderRequest = CheckoutSnapshotRequest & {
+type PlaceCheckoutOrderRequest = CheckoutSnapshotRequest$1 & {
   guest?: GuestBuyer;
   notes?: string;
   scheduledAt?: string;
@@ -92,7 +92,7 @@ declare class CheckoutResource {
     discount: number;
     eligibleSubtotal: number;
   }>>;
-  snapshot(team: string, data: CheckoutSnapshotRequest): Promise<_$_joai_core0.IAppResponse<_$_joai_core0.CheckoutSnapshot>>;
+  snapshot(team: string, data: CheckoutSnapshotRequest$1): Promise<_$_joai_core0.IAppResponse<_$_joai_core0.CheckoutSnapshot>>;
   placeOrder(team: string, data: PlaceCheckoutOrderRequest): Promise<_$_joai_core0.IAppResponse<Order$1>>;
   locations(team: string): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1[]>>;
   shippingRates(team: string, data: {
@@ -187,11 +187,11 @@ declare class ShippingResource {
   constructor(http: IHttpService);
   zones(team: string): Promise<_$_joai_core0.IAppResponse<ShippingZone[]>>;
   createZone(team: string, data: ShippingZoneInput): Promise<_$_joai_core0.IAppResponse<ShippingZone>>;
-  updateZone(team: string, zoneId: HashidInput, data: ShippingZoneInput): Promise<_$_joai_core0.IAppResponse<ShippingZone>>;
-  deleteZone(team: string, zoneId: HashidInput): Promise<_$_joai_core0.IAppResponse<void>>;
-  createRate(team: string, zoneId: HashidInput, data: ShippingRateInput): Promise<_$_joai_core0.IAppResponse<ShippingRate$1>>;
-  updateRate(team: string, zoneId: HashidInput, rateId: HashidInput, data: ShippingRateInput): Promise<_$_joai_core0.IAppResponse<ShippingRate$1>>;
-  deleteRate(team: string, zoneId: HashidInput, rateId: HashidInput): Promise<_$_joai_core0.IAppResponse<void>>;
+  updateZone(team: string, zoneId: HashidInput$1, data: ShippingZoneInput): Promise<_$_joai_core0.IAppResponse<ShippingZone>>;
+  deleteZone(team: string, zoneId: HashidInput$1): Promise<_$_joai_core0.IAppResponse<void>>;
+  createRate(team: string, zoneId: HashidInput$1, data: ShippingRateInput): Promise<_$_joai_core0.IAppResponse<ShippingRate$1>>;
+  updateRate(team: string, zoneId: HashidInput$1, rateId: HashidInput$1, data: ShippingRateInput): Promise<_$_joai_core0.IAppResponse<ShippingRate$1>>;
+  deleteRate(team: string, zoneId: HashidInput$1, rateId: HashidInput$1): 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: string, data: FulfillmentLocationInput): Promise<_$_joai_core0.IAppResponse<FulfillmentLocation$1>>;
@@ -222,7 +222,7 @@ type GuestOrderAccess = {
 type GuestCheckoutDraft<TCart = unknown> = {
   cart: TCart;
   fulfillmentMethod: FulfillmentMethod;
-  shippingRateId: HashidInput | null;
+  shippingRateId: HashidInput$1 | 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. */
@@ -276,7 +276,7 @@ type GuestCheckoutCartItem = {
 };
 type GuestCheckoutState<TCart = GuestCheckoutCartItem[]> = GuestCheckoutDraft<TCart> & {
   identity: GuestBuyer$1;
-  address: AddressInput;
+  address: AddressInput$1;
 };
 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 {
@@ -292,8 +292,8 @@ type GuestCheckoutClient = {
           zipCode?: string;
         };
         items: GuestCheckoutCartItem[];
-      }): Promise<IAppResponse<ShippingRate$1[]>>;
-      snapshot(team: string, data: CheckoutSnapshotRequest): Promise<IAppResponse<CheckoutSnapshot$1>>;
+      }): Promise<IAppResponse$1<ShippingRate$1[]>>;
+      snapshot(team: string, data: CheckoutSnapshotRequest$1): Promise<IAppResponse$1<CheckoutSnapshot$1>>;
     };
   };
   orders: {
@@ -307,8 +307,8 @@ type GuestCheckoutClient = {
       scheduledAt?: string;
       serviceSlug?: string;
       sendConfirmation?: boolean;
-    }): Promise<IAppResponse<Order$1>>;
-    pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<IAppResponse<{
+    }): Promise<IAppResponse$1<Order$1>>;
+    pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<IAppResponse$1<{
       url: string;
     }>>;
   };
@@ -324,7 +324,7 @@ declare const assertGuestPickupSlotReady: (state: GuestCheckoutState) => void;
 declare const buildGuestCheckoutSnapshotRequest: (state: GuestCheckoutState, options?: {
   shippingRates?: ShippingRate$1[];
   pickupLocationIds?: string[];
-}) => CheckoutSnapshotRequest;
+}) => CheckoutSnapshotRequest$1;
 type GuestCheckoutSnapshotResult = {
   snapshot: CheckoutSnapshot$1 & {
     accessToken: string;
@@ -392,7 +392,7 @@ type GuestCouponClient = {
       validateCoupon(team: string, data: {
         couponCode: string;
         items: GuestCheckoutCartItem[];
-      }): Promise<IAppResponse<GuestCouponPreview>>;
+      }): Promise<IAppResponse$1<GuestCouponPreview>>;
     };
   };
 };
@@ -737,19 +737,19 @@ type AuthPortalSessionResponse = {
 declare class AuthResource {
   private http;
   constructor(http: IHttpService);
-  sendCode(data: AuthSendCodeRequest): Promise<IAppResponse<void>>;
-  confirmCode(data: AuthConfirmCodeRequest): Promise<IAppResponse<AuthConfirmCodeResponse>>;
+  sendCode(data: AuthSendCodeRequest): Promise<IAppResponse$1<void>>;
+  confirmCode(data: AuthConfirmCodeRequest): Promise<IAppResponse$1<AuthConfirmCodeResponse>>;
   /** Requests a magic link. `options.team` is the team slug used to brand the email. */
   requestEmail(email: string, redirect?: string, options?: {
     team?: string;
-  }): Promise<IAppResponse<AuthLoginResponse>>;
-  loginWithSocialAccessToken(provider: NativeSocialAuthProvider, accessToken: string): Promise<IAppResponse<AuthLoginResponse>>;
-  exchangeNativeSession(token: string): Promise<IAppResponse<AuthNativeSessionResponse>>;
-  me(): Promise<IAppResponse<AuthUser$1>>;
-  logout(): Promise<IAppResponse<void>>;
-  createApiToken(): Promise<IAppResponse<AuthApiTokenResponse>>;
-  createPortalSession(redirect: string): Promise<IAppResponse<AuthPortalSessionResponse>>;
-  verifyWallet(accessToken: string, withMobileApiToken?: boolean): Promise<IAppResponse<UserPrivate>>;
+  }): Promise<IAppResponse$1<AuthLoginResponse>>;
+  loginWithSocialAccessToken(provider: NativeSocialAuthProvider, accessToken: string): Promise<IAppResponse$1<AuthLoginResponse>>;
+  exchangeNativeSession(token: string): Promise<IAppResponse$1<AuthNativeSessionResponse>>;
+  me(): Promise<IAppResponse$1<AuthUser$1>>;
+  logout(): Promise<IAppResponse$1<void>>;
+  createApiToken(): Promise<IAppResponse$1<AuthApiTokenResponse>>;
+  createPortalSession(redirect: string): Promise<IAppResponse$1<AuthPortalSessionResponse>>;
+  verifyWallet(accessToken: string, withMobileApiToken?: boolean): Promise<IAppResponse$1<UserPrivate>>;
 }
 //#endregion
 //#region src/resources/billing.d.ts
@@ -854,7 +854,7 @@ declare class CartsResource {
 //#region src/resources/coupons.d.ts
 type CouponPayload = {
   code: string;
-  name?: TranslatableValue;
+  name?: TranslatableValue$1;
   percent?: number | null;
   amount?: number | null;
   price?: number | null;
@@ -1406,7 +1406,7 @@ declare class MetricsResource {
 declare class AnalyticsResource {
   private readonly http;
   private readonly env;
-  constructor(http: IHttpService, env: AppEnv);
+  constructor(http: IHttpService, env: AppEnv$1);
   getConfiguration(siteKey: string): Promise<_$_joai_core0.IAppResponse<AnalyticsConfiguration>>;
   getScriptSnippet(siteKey: string): string;
   /** Records a CRM conversion for the caller's authenticated contact only. */
@@ -1555,9 +1555,9 @@ declare class OrdersResource {
     snapshotAccessToken?: string;
     billingAddressId?: string;
     shippingAddressId?: string;
-    billingAddress?: AddressInput;
-    shippingAddress?: AddressInput;
-    shippingRateId?: HashidInput;
+    billingAddress?: AddressInput$1;
+    shippingAddress?: AddressInput$1;
+    shippingRateId?: HashidInput$1;
     fulfillmentLocationId?: string;
     idempotencyKey?: string;
     guest?: {
@@ -1607,6 +1607,7 @@ declare class PersonaResource {
 }
 //#endregion
 //#region src/resources/products.d.ts
+type ProductsSort = 'featured' | 'price_asc' | 'price_desc' | 'name';
 type ProductsListParams = {
   includePrivate?: boolean;
   team?: string;
@@ -1614,43 +1615,60 @@ type ProductsListParams = {
   perPage?: number;
   search?: string;
   category?: string;
+  labels?: string[];
+  minPrice?: number;
+  maxPrice?: number;
+  available?: boolean;
+  sort?: ProductsSort;
+  locale?: string;
   all?: boolean;
 };
 type ProductCategories = {
   categories: string[];
   hasUntagged: boolean;
 };
+type ProductFacets = {
+  categories: string[];
+  tags: string[];
+  priceMin: number | null;
+  priceMax: number | null;
+  total: number;
+};
 declare class ProductsResource {
   private readonly http;
   constructor(http: IHttpService);
   list(params?: ProductsListParams): Promise<_$_joai_core0.IAppResponse<Product[]>>;
   listAll(params?: Omit<ProductsListParams, 'page' | 'perPage' | 'all'>): Promise<_$_joai_core0.IAppResponse<Product[]>>;
+  facets(params?: {
+    team?: string;
+  }): Promise<_$_joai_core0.IAppResponse<ProductFacets>>;
+  private query;
   categories(params?: {
     team?: string;
   }): Promise<_$_joai_core0.IAppResponse<ProductCategories>>;
   get(id: string): Promise<_$_joai_core0.IAppResponse<Product>>;
   getVariation(id: string): Promise<_$_joai_core0.IAppResponse<ProductVariation>>;
   create(data: {
-    name: TranslatableValue;
+    name: TranslatableValue$1;
     price?: number;
-    unit?: TranslatableValue;
+    unit?: TranslatableValue$1;
     tags?: string[];
-    description?: TranslatableValue | null;
+    description?: TranslatableValue$1 | null;
     virtual?: boolean;
     public?: boolean;
     taxClassId?: string | null;
     meta?: {
-      details?: ProductDetailSection[];
+      details?: ProductDetailSection$1[];
     };
   }, teamSlug?: string): Promise<_$_joai_core0.IAppResponse<Product>>;
   update(id: string, data: {
-    name?: TranslatableValue;
-    unit?: TranslatableValue | null;
+    name?: TranslatableValue$1;
+    unit?: TranslatableValue$1 | null;
     tags?: string[] | null;
-    description?: TranslatableValue | null;
+    description?: TranslatableValue$1 | null;
     settings?: Record<string, unknown> | null;
     meta?: {
-      details?: ProductDetailSection[];
+      details?: ProductDetailSection$1[];
     };
     active?: boolean;
     public?: boolean;
@@ -1660,13 +1678,13 @@ declare class ProductsResource {
   }): Promise<_$_joai_core0.IAppResponse<Product>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
   createVariation(productSlug: string, data: {
-    name: TranslatableValue;
+    name: TranslatableValue$1;
     sku: string;
     price: number;
     type?: string;
   }): Promise<_$_joai_core0.IAppResponse<ProductVariation>>;
   updateVariation(variationId: string, data: {
-    name?: TranslatableValue;
+    name?: TranslatableValue$1;
     price?: number;
     active?: boolean;
     hidden?: boolean;
@@ -1792,10 +1810,10 @@ declare class ServicesResource {
   listAll(params?: Omit<ServicesListParams, 'page' | 'perPage' | 'all'>): Promise<_$_joai_core0.IAppResponse<Service[]>>;
   get(slug: string): Promise<_$_joai_core0.IAppResponse<Service>>;
   store(team: string, data: {
-    name: TranslatableValue;
+    name: TranslatableValue$1;
     price: number;
     durationMinutes: number | null;
-    description?: TranslatableValue | null;
+    description?: TranslatableValue$1 | null;
     digital?: boolean;
     public?: boolean;
     bookable?: boolean;
@@ -1850,7 +1868,7 @@ declare class SitesResource {
   }): Promise<_$_joai_core0.IAppResponse<Site>>;
   resolve(teamSlug: string, brandSlug?: string): Promise<_$_joai_core0.IAppResponse<Site>>;
   resolveByDomain(domain: string): Promise<_$_joai_core0.IAppResponse<Site>>;
-  update(siteId: HashidInput, data: {
+  update(siteId: HashidInput$1, data: {
     customDomain?: string | null;
     enabled?: boolean;
     modules?: string[];
@@ -1944,7 +1962,7 @@ declare class SubscriptionsResource {
   updateDelivery(id: string, data: {
     fulfillmentMethod: 'shipping' | 'pickup';
     shippingAddressId?: string | null;
-    shippingRateId?: HashidInput | null;
+    shippingRateId?: HashidInput$1 | null;
     fulfillmentLocationId?: string | null;
   }): Promise<_$_joai_core0.IAppResponse<Subscription>>;
   skip(id: string): Promise<_$_joai_core0.IAppResponse<Subscription>>;
@@ -1998,8 +2016,8 @@ type TeamInviteInfo = {
 type TeamMutationPayload = {
   name?: string;
   slug?: string;
-  description?: TranslatableValue | null;
-  tagline?: TranslatableValue | null;
+  description?: TranslatableValue$1 | null;
+  tagline?: TranslatableValue$1 | null;
   category?: TeamCategory;
   public?: boolean;
   tags?: string[];
@@ -2030,8 +2048,8 @@ declare class TeamsResource {
   }): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
   delete(teamSlug: string): Promise<_$_joai_core0.IAppResponse<void>>;
   update(teamSlug: string, data: TeamMutationPayload): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
-  updateDescription(teamSlug: string, description: TranslatableValue | null): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
-  updateTagline(teamSlug: string, tagline: TranslatableValue | null): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
+  updateDescription(teamSlug: string, description: TranslatableValue$1 | null): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
+  updateTagline(teamSlug: string, tagline: TranslatableValue$1 | null): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
   invite(teamSlug: string, payload: {
     email: string;
     role: UserRole;
@@ -2263,7 +2281,7 @@ type TranscriptionResponse = {
 declare class VoiceResource {
   private readonly http;
   constructor(http: IHttpService);
-  transcribe(teamSlug: string, audio: File, language?: string | null, prompt?: string | null): Promise<IAppResponse<TranscriptionResponse>>;
+  transcribe(teamSlug: string, audio: File, language?: string | null, prompt?: string | null): Promise<IAppResponse$1<TranscriptionResponse>>;
 }
 //#endregion
 //#region src/resources/wallets.d.ts
@@ -2339,8 +2357,8 @@ declare class WarpsResource {
   create(data: {
     brand?: string | null;
     definition: WarpDefinition;
-    title?: TranslatableValue;
-    description?: TranslatableValue | null;
+    title?: TranslatableValue$1;
+    description?: TranslatableValue$1 | null;
     extras?: Record<string, any> | null;
     public?: boolean;
     form?: boolean;
@@ -2350,8 +2368,8 @@ declare class WarpsResource {
   }): Promise<_$_joai_core0.IAppResponse<BackendWarpCreateResponse>>;
   update(identifier: string, data: {
     name?: string;
-    title?: TranslatableValue;
-    description?: TranslatableValue | null;
+    title?: TranslatableValue$1;
+    description?: TranslatableValue$1 | null;
     definition?: WarpDefinition;
     extras?: Record<string, any> | null;
     form?: boolean;
@@ -2448,7 +2466,7 @@ interface CacheConfig {
 interface JoAiClientConfig {
   apiToken?: string;
   team?: string;
-  env?: AppEnv;
+  env?: AppEnv$1;
   locale?: string;
   agentAuthKey?: string;
   cache?: CacheConfig;
@@ -2555,40 +2573,40 @@ declare class CachedHttpService implements IHttpService {
   constructor(inner: IHttpService, overrides?: TtlMap, defaultTtl?: number);
   get onNetworkError(): (error: Error) => void;
   set onNetworkError(fn: (error: Error) => void);
-  get onUnauthorized(): (response: IAppResponse<JsonValue>) => void;
-  set onUnauthorized(fn: (response: IAppResponse<JsonValue>) => void);
-  get onSuccessfulResponse(): (response: IAppResponse<JsonValue>) => void;
-  set onSuccessfulResponse(fn: (response: IAppResponse<JsonValue>) => void);
-  get onMaintenanceMode(): (response: IAppResponse<JsonValue>) => void;
-  set onMaintenanceMode(fn: (response: IAppResponse<JsonValue>) => void);
-  get onTooManyRequests(): (response: IAppResponse<JsonValue>) => void;
-  set onTooManyRequests(fn: (response: IAppResponse<JsonValue>) => void);
+  get onUnauthorized(): (response: IAppResponse$1<JsonValue>) => void;
+  set onUnauthorized(fn: (response: IAppResponse$1<JsonValue>) => void);
+  get onSuccessfulResponse(): (response: IAppResponse$1<JsonValue>) => void;
+  set onSuccessfulResponse(fn: (response: IAppResponse$1<JsonValue>) => void);
+  get onMaintenanceMode(): (response: IAppResponse$1<JsonValue>) => void;
+  set onMaintenanceMode(fn: (response: IAppResponse$1<JsonValue>) => void);
+  get onTooManyRequests(): (response: IAppResponse$1<JsonValue>) => void;
+  set onTooManyRequests(fn: (response: IAppResponse$1<JsonValue>) => void);
   clearCache(): void;
-  get<T>(url: string, options?: IRequestOptions): Promise<IAppResponse<T>>;
-  post<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse<T>>;
-  put<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse<T>>;
-  patch<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse<T>>;
-  delete<T>(url: string, options?: IRequestOptions): Promise<IAppResponse<T>>;
+  get<T>(url: string, options?: IRequestOptions): Promise<IAppResponse$1<T>>;
+  post<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse$1<T>>;
+  put<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse$1<T>>;
+  patch<T>(url: string, data?: JsonValue | FormData, options?: IRequestOptions): Promise<IAppResponse$1<T>>;
+  delete<T>(url: string, options?: IRequestOptions): Promise<IAppResponse$1<T>>;
   private mutate;
   private bust;
 }
 //#endregion
 //#region src/auth/portal.d.ts
 declare const getAuthFragmentToken: (url: string) => string | null;
-declare const isPortalCallbackUrl: (url: string, env?: AppEnv) => boolean;
-declare const sanitizePortalCallbackUrl: (url: string | null | undefined, env?: AppEnv) => string | null;
+declare const isPortalCallbackUrl: (url: string, env?: AppEnv$1) => boolean;
+declare const sanitizePortalCallbackUrl: (url: string | null | undefined, env?: AppEnv$1) => string | null;
 declare const isAllowedRedirectUrl: (redirect: string, allowedOrigins: string[]) => boolean;
 declare const completePortalSession: (callbackUrl: string, fetcher?: typeof fetch) => Promise<boolean>;
 type PortalClient = {
   auth: {
-    createPortalSession: (redirect: string) => Promise<IAppResponse<AuthPortalSessionResponse>>;
+    createPortalSession: (redirect: string) => Promise<IAppResponse$1<AuthPortalSessionResponse>>;
   };
 };
 type OpenPortalSessionOptions = {
   client: PortalClient;
   redirect: string;
   allowedOrigins: string[];
-  env?: AppEnv; /** @deprecated Unused — exchange happens via same-origin blade form after navigation. */
+  env?: AppEnv$1; /** @deprecated Unused — exchange happens via same-origin blade form after navigation. */
   fetcher?: typeof fetch; /** Receives the API callback URL (with fragment token), not the final portal redirect. */
   onNavigate?: (callbackUrl: string) => void;
 };
@@ -2602,8 +2620,8 @@ declare const openPortalSession: ({
 //#endregion
 //#region src/resources/distribution.d.ts
 declare class DistributionResource {
-  getBrandSiteConfig(env: AppEnv, brandSlug: string): Promise<BrandSiteConfig | null>;
+  getBrandSiteConfig(env: AppEnv$1, brandSlug: string): Promise<BrandSiteConfig | null>;
   private fetchDistribution;
 }
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, AnalyticsResource, 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, type DeleteUserParams, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FollowsResource, 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, InstallsResource, 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 ProductCategories, type ProductVariation, type ProductsListParams, ProductsResource, ProjectsResource, ProposalsResource, type RecentlyViewedStorage, type RecentlyViewedStorageOptions, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, type ServicesListParams, 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, createRecentlyViewedStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, getRecentlyViewedSlugs, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, trackRecentlyViewed, validateGuestCoupon };
+export { type AddressInput, AddressesResource, AgentsResource, AlertsResource, AnalyticsResource, ApiTokensResource, type AppEnv, type AppointmentAvailabilitySlot, 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, type CartItem, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, type CheckoutSnapshotRequest, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, type DeleteUserParams, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FollowsResource, 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 HashidInput, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, type IAppResponse, IngestionsResource, InquiriesResource, InstallsResource, 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 ProductCategories, type ProductDetailSection, type ProductDetailText, type ProductFacets, type ProductRelationType, type ProductVariation, type ProductsListParams, ProductsResource, type ProductsSort, ProjectsResource, ProposalsResource, type RecentlyViewedStorage, type RecentlyViewedStorageOptions, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, type ServicesListParams, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TaxClassInput, TaxClassesResource, type TeamInviteInfo, TeamsResource, type TranslatableValue, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, assertGuestPickupSlotReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, createRecentlyViewedStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, getRecentlyViewedSlugs, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, trackRecentlyViewed, validateGuestCoupon };

package/dist/index.mjs

@@ -2369,6 +2369,22 @@ var ProductsResource = class {
 	}
 	list(params) {
 		let url = "products";
+		const search = this.query(params);
+		if (search.size) url += `?${search.toString()}`;
+		return this.http.get(url);
+	}
+	listAll(params) {
+		return this.list({
+			...params,
+			all: true
+		});
+	}
+	facets(params) {
+		let url = "products/facets";
+		if (params?.team) url += `?team=${encodeURIComponent(params.team)}`;
+		return this.http.get(url);
+	}
+	query(params) {
 		const search = new URLSearchParams();
 		if (params?.includePrivate) search.set("includePrivate", "1");
 		if (params?.team) search.set("team", params.team);
@@ -2379,14 +2395,13 @@ var ProductsResource = class {
 		}
 		if (params?.search) search.set("search", params.search);
 		if (params?.category) search.set("category", params.category);
-		if (search.size) url += `?${search.toString()}`;
-		return this.http.get(url);
-	}
-	listAll(params) {
-		return this.list({
-			...params,
-			all: true
-		});
+		if (params?.labels?.length) search.set("label", params.labels.join(","));
+		if (params?.minPrice !== void 0) search.set("minPrice", String(params.minPrice));
+		if (params?.maxPrice !== void 0) search.set("maxPrice", String(params.maxPrice));
+		if (params?.available !== void 0) search.set("available", params.available ? "1" : "0");
+		if (params?.sort) search.set("sort", params.sort);
+		if (params?.locale) search.set("locale", params.locale);
+		return search;
 	}
 	categories(params) {
 		let url = "products/categories";

package/package.json

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