@joai/sdk 9.0.0 → 9.0.3

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, 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, ProductDetailSection, 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 { 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, ArtifactDeliveryPreview, 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, 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, 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
@@ -135,10 +135,11 @@ declare class FulfillmentsResource {
 declare class ReturnsResource {
   private readonly http;
   constructor(http: IHttpService);
+  listForTeam(team?: string): Promise<_$_joai_core0.IAppResponse<Return[]>>;
   list(orderId: string, accessToken?: string): Promise<_$_joai_core0.IAppResponse<Return[]>>;
   create(orderId: string, data: {
     reason: string;
-    fulfillmentId?: number;
+    fulfillmentId?: string;
     items: {
       orderItemId: number;
       quantity: number;
@@ -1143,12 +1144,37 @@ declare class LinksResource {
 declare class LoyaltyResource {
   private readonly http;
   constructor(http: IHttpService);
+  /**
+   * Program of a team. Without `team` (staff, X-Team set): every collect point; daily ones include `codeToday` and
+   * `codeValidUntil` for signed-in team members (never for agent auth keys). With `team`: public / customer view, active
+   * points only and never today's code; a customer token adds `collected`, `collectedAt` and `nextAvailableAt`.
+   */
   getProgram(params?: {
     team?: string;
   }): Promise<_$_joai_core0.IAppResponse<LoyaltyProgram>>;
+  /** Customer: join a team's program with the signed-in user's own contact. Idempotent. */
+  join(params: {
+    team: string;
+  }): Promise<_$_joai_core0.IAppResponse<LoyaltyJoinResponse>>;
+  /** Customer: all loyalty accounts of the signed-in user across teams. */
+  getWallet(): Promise<_$_joai_core0.IAppResponse<LoyaltyWalletAccount[]>>;
+  /** Customer: the signed-in user's own transactions on a team's program. */
+  getWalletHistory(params: {
+    team: string;
+    page?: number;
+  }): Promise<_$_joai_core0.IAppResponse<LoyaltyTransaction[]>>;
+  /** Customer: collect at a collect point. Joins the program if needed; replays return `already: true`. */
+  collect(params: {
+    team: string;
+    key: string;
+    code?: string;
+  }): Promise<_$_joai_core0.IAppResponse<LoyaltyCollectResponse>>;
+  /** Staff: update the program. `settings.collect_points` replaces the collect point list (see LoyaltyCollectPointInput). */
   updateProgram(data: {
     name?: string;
-    settings?: ProgramSettings;
+    settings?: ProgramSettings & {
+      collect_points?: LoyaltyCollectPointInput[];
+    };
   }): Promise<_$_joai_core0.IAppResponse<LoyaltyProgram>>;
   getRewards(): Promise<_$_joai_core0.IAppResponse<LoyaltyReward[]>>;
   createReward(data: {
@@ -1226,6 +1252,18 @@ declare class LoyaltyResource {
   }>>;
 }
 //#endregion
+//#region src/resources/installs.d.ts
+declare class InstallsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  /** Upsert a device install for the current team (`X-Team`). Works anonymously or signed-in. */
+  register(data: InstallRegisterPayload): Promise<_$_joai_core0.IAppResponse<Install>>;
+  /** Attach the signed-in user (and their contact, when present) to an existing install. */
+  claim(data: InstallClaimPayload): Promise<_$_joai_core0.IAppResponse<Install>>;
+  /** Mark push as opted out / unavailable for this provider device ref. */
+  optOut(data: InstallOptOutPayload): Promise<_$_joai_core0.IAppResponse<Install>>;
+}
+//#endregion
 //#region src/resources/store.d.ts
 declare class StoreResource {
   private readonly http;
@@ -1360,6 +1398,8 @@ declare class MessagesResource {
   generateAudio(messageId: string): Promise<_$_joai_core0.IAppResponse<{
     audioUrl: string;
   }>>;
+  attachMedia(messageId: string, file: File): Promise<_$_joai_core0.IAppResponse<Message>>;
+  completeMediaImport(messageId: string, file?: File | null): Promise<_$_joai_core0.IAppResponse<Message>>;
   storeFeedback(agent: string, message: string, positive: boolean, inquiry: Inquiry | null): Promise<_$_joai_core0.IAppResponse<void>>;
   toggleReaction(messageId: string, emoji: string): Promise<_$_joai_core0.IAppResponse<{
     reactions: Reactions | null;
@@ -1651,8 +1691,9 @@ declare class ServicesResource {
     taxClassId?: string | null;
     pricingModel?: string;
     settings?: Record<string, unknown> | null;
+    order?: number | null;
   }): Promise<_$_joai_core0.IAppResponse<Service>>;
-  update(id: string, data: Partial<Pick<Service, 'name' | 'price' | 'description' | 'active' | 'digital' | 'public' | 'bookable' | 'taxClassId'>> & {
+  update(id: string, data: Partial<Pick<Service, 'name' | 'price' | 'description' | 'active' | 'digital' | 'public' | 'bookable' | 'taxClassId' | 'order'>> & {
     durationMinutes?: number | null;
     settings?: Record<string, unknown> | null;
   }): Promise<_$_joai_core0.IAppResponse<Service>>;
@@ -1883,6 +1924,7 @@ declare class TeamsResource {
   }): Promise<_$_joai_core0.IAppResponse<void>>;
   inviteMember(teamSlug: string, email: string, role: UserRole): Promise<_$_joai_core0.IAppResponse<void>>;
   removeMember(teamSlug: string, memberId: string): Promise<_$_joai_core0.IAppResponse<void>>;
+  updateMemberRole(teamSlug: string, memberId: string, role: UserRole): Promise<_$_joai_core0.IAppResponse<void>>;
   listMembers(teamSlug: string): Promise<_$_joai_core0.IAppResponse<TeamMember[]>>;
   updateLogo(teamSlug: string, logo: string[]): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
   updateCover(teamSlug: string, cover: string[]): Promise<_$_joai_core0.IAppResponse<TeamPrivate>>;
@@ -1922,6 +1964,7 @@ declare class ArtifactsResource {
   update(id: string, payload: ArtifactUpdatePayload): Promise<_$_joai_core0.IAppResponse<Artifact>>;
   delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
   deliver(payload: ArtifactDeliverPayload): Promise<_$_joai_core0.IAppResponse<ArtifactDelivery[]>>;
+  previewDelivery(payload: ArtifactDeliverPayload): Promise<_$_joai_core0.IAppResponse<ArtifactDeliveryPreview>>;
 }
 //#endregion
 //#region src/resources/campaigns.d.ts
@@ -2311,6 +2354,7 @@ declare class JoAiClient {
   readonly items: ItemsResource;
   readonly links: LinksResource;
   readonly loyalty: LoyaltyResource;
+  readonly installs: InstallsResource;
   readonly store: StoreResource;
   readonly media: MediaResource;
   readonly metrics: MetricsResource;
@@ -2404,16 +2448,15 @@ type OpenPortalSessionOptions = {
   client: PortalClient;
   redirect: string;
   allowedOrigins: string[];
-  env?: AppEnv;
-  fetcher?: typeof fetch;
-  onNavigate?: (redirect: string) => void;
+  env?: AppEnv; /** @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;
 };
 declare const openPortalSession: ({
   client,
   redirect,
   allowedOrigins,
   env,
-  fetcher,
   onNavigate
 }: OpenPortalSessionOptions) => Promise<boolean>;
 //#endregion
@@ -2423,4 +2466,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, type RecentlyViewedStorage, type RecentlyViewedStorageOptions, 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, createRecentlyViewedStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, getRecentlyViewedSlugs, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, trackRecentlyViewed, 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, 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 ProductVariation, ProductsResource, ProjectsResource, type RecentlyViewedStorage, type RecentlyViewedStorageOptions, 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, createRecentlyViewedStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, getRecentlyViewedSlugs, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, trackRecentlyViewed, validateGuestCoupon };

package/dist/index.mjs

@@ -180,6 +180,9 @@ var ReturnsResource = class {
 	constructor(http) {
 		this.http = http;
 	}
+	listForTeam(team) {
+		return this.http.get("returns", team ? { headers: { "X-Team": team } } : void 0);
+	}
 	list(orderId, accessToken) {
 		return this.http.get(`orders/${orderId}/returns`, orderAccessHeaders$2(accessToken));
 	}
@@ -617,6 +620,11 @@ async function placeGuestCheckoutOrder(options) {
 		accessToken,
 		paymentUrl: null
 	};
+	if (order.data.status !== "pending") return {
+		order: order.data,
+		accessToken,
+		paymentUrl: null
+	};
 	if (!accessToken) throw new GuestCheckoutError("payment_failed");
 	const payment = await options.client.orders.pay(order.data.id, void 0, accessToken);
 	if (!payment.ok || !payment.data?.url) return {
@@ -1736,10 +1744,33 @@ var LoyaltyResource = class {
 	constructor(http) {
 		this.http = http;
 	}
+	/**
+	* Program of a team. Without `team` (staff, X-Team set): every collect point; daily ones include `codeToday` and
+	* `codeValidUntil` for signed-in team members (never for agent auth keys). With `team`: public / customer view, active
+	* points only and never today's code; a customer token adds `collected`, `collectedAt` and `nextAvailableAt`.
+	*/
 	getProgram(params) {
 		const query = params?.team ? `?team=${encodeURIComponent(params.team)}` : "";
 		return this.http.get(`loyalty/program${query}`);
 	}
+	/** Customer: join a team's program with the signed-in user's own contact. Idempotent. */
+	join(params) {
+		return this.http.post("loyalty/join", { team: params.team });
+	}
+	/** Customer: all loyalty accounts of the signed-in user across teams. */
+	getWallet() {
+		return this.http.get("loyalty/wallet");
+	}
+	/** Customer: the signed-in user's own transactions on a team's program. */
+	getWalletHistory(params) {
+		const query = params.page ? `?page=${params.page}` : "";
+		return this.http.get(`loyalty/wallet/${encodeURIComponent(params.team)}/history${query}`);
+	}
+	/** Customer: collect at a collect point. Joins the program if needed; replays return `already: true`. */
+	collect(params) {
+		return this.http.post("loyalty/collect", params);
+	}
+	/** Staff: update the program. `settings.collect_points` replaces the collect point list (see LoyaltyCollectPointInput). */
 	updateProgram(data) {
 		return this.http.patch("loyalty/program", data);
 	}
@@ -1821,6 +1852,25 @@ var LoyaltyResource = class {
 	}
 };
 //#endregion
+//#region src/resources/installs.ts
+var InstallsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	/** Upsert a device install for the current team (`X-Team`). Works anonymously or signed-in. */
+	register(data) {
+		return this.http.post("installs", data);
+	}
+	/** Attach the signed-in user (and their contact, when present) to an existing install. */
+	claim(data) {
+		return this.http.post("installs/claim", data);
+	}
+	/** Mark push as opted out / unavailable for this provider device ref. */
+	optOut(data) {
+		return this.http.post("installs/opt-out", data);
+	}
+};
+//#endregion
 //#region src/resources/store.ts
 var StoreResource = class {
 	constructor(http) {
@@ -2067,6 +2117,17 @@ var MessagesResource = class {
 	generateAudio(messageId) {
 		return this.http.post(`messages/${messageId}/audio`, {});
 	}
+	attachMedia(messageId, file) {
+		const form = new FormData();
+		form.append("file", file, file.name);
+		return this.http.post(`messages/${messageId}/media`, form, { isJson: false });
+	}
+	completeMediaImport(messageId, file) {
+		if (!file) return this.http.post(`messages/${messageId}/media-import`, {});
+		const form = new FormData();
+		form.append("file", file, file.name);
+		return this.http.post(`messages/${messageId}/media-import`, form, { isJson: false });
+	}
 	storeFeedback(agent, message, positive, inquiry) {
 		return this.http.post("feedback", {
 			agent,
@@ -2688,6 +2749,12 @@ var TeamsResource = class {
 	removeMember(teamSlug, memberId) {
 		return this.http.post(`teams/${teamSlug}/members/remove`, { member: memberId });
 	}
+	updateMemberRole(teamSlug, memberId, role) {
+		return this.http.post(`teams/${teamSlug}/members/role`, {
+			member: memberId,
+			role
+		});
+	}
 	listMembers(teamSlug) {
 		return this.http.get(`teams/${teamSlug}/members`);
 	}
@@ -2771,6 +2838,9 @@ var ArtifactsResource = class {
 	deliver(payload) {
 		return this.http.post("artifacts/deliver", payload);
 	}
+	previewDelivery(payload) {
+		return this.http.post("artifacts/preview-delivery", payload);
+	}
 };
 //#endregion
 //#region src/resources/campaigns.ts
@@ -3514,6 +3584,7 @@ var JoAiClient = class {
 		this.items = new ItemsResource(this.http);
 		this.links = new LinksResource(this.http);
 		this.loyalty = new LoyaltyResource(this.http);
+		this.installs = new InstallsResource(this.http);
 		this.store = new StoreResource(this.http);
 		this.media = new MediaResource(this.http);
 		this.metrics = new MetricsResource(this.http);
@@ -3616,19 +3687,18 @@ const completePortalSession = async (callbackUrl, fetcher = fetch) => {
 		return false;
 	}
 };
-const openPortalSession = async ({ client, redirect, allowedOrigins, env = "mainnet", fetcher = fetch, onNavigate }) => {
+const openPortalSession = async ({ client, redirect, allowedOrigins, env = "mainnet", onNavigate }) => {
 	if (!isAllowedRedirectUrl(redirect, allowedOrigins)) return false;
 	const response = await client.auth.createPortalSession(redirect);
 	const callbackUrl = sanitizePortalCallbackUrl(response.ok ? response.data?.url : null, env);
 	if (!callbackUrl) return false;
-	if (!await completePortalSession(callbackUrl, fetcher)) return false;
 	if (!isAllowedRedirectUrl(redirect, allowedOrigins)) return false;
 	if (onNavigate) {
-		onNavigate(redirect);
+		onNavigate(callbackUrl);
 		return true;
 	}
 	if (typeof window !== "undefined") {
-		window.location.assign(redirect);
+		window.location.assign(callbackUrl);
 		return true;
 	}
 	return false;
@@ -3662,4 +3732,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, TaxClassesResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, 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 { 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, InstallsResource, 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, createRecentlyViewedStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, getRecentlyViewedSlugs, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, trackRecentlyViewed, validateGuestCoupon };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "9.0.0",
+  "version": "9.0.3",
   "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": "^5.0.0",
+    "@joai/core": "^5.0.3",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^5.0.0"
+    "@joai/core": "^5.0.3"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",