@joai/sdk 5.0.0 → 7.0.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, 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, 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, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, 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, 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, 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, ShippingRate, ShippingRate as ShippingRate$1, ShippingZone, Shortcut, Site, SiteBrand, SiteType, Skill, SkillScopeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreData, StorePriceTier, StorePurchaseResult, Subscription, Swarm, Tag, TagType, Task, Team, TeamAccessConfig, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, 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
@@ -43,6 +43,12 @@ declare class AgentsResource {
     error?: string;
     meta?: Record<string, any>;
   }): Promise<_$_joai_core0.IAppResponse<unknown>>;
+  listTrustedActions(uuid: string): Promise<_$_joai_core0.IAppResponse<{
+    rules: AgentTrustedActionRule[];
+  }>>;
+  removeTrustedAction(uuid: string, ruleId: string): Promise<_$_joai_core0.IAppResponse<{
+    rules: AgentTrustedActionRule[];
+  }>>;
 }
 //#endregion
 //#region src/address/addresses.d.ts
@@ -182,11 +188,16 @@ type GuestCheckoutDraft<TCart = unknown> = {
   fulfillmentMethod: FulfillmentMethod;
   shippingRateId: number | null;
   fulfillmentLocationId: number | null;
+  couponCode?: string | null;
 };
 type GuestCommerceStorageOptions = {
   namespace: string;
   maxOrders?: number;
 };
+declare function buildGuestOrderReturnUrl(ordersPageUrl: string, orderId: string, accessToken: string): string;
+declare function readGuestOrderReturnAccess(search: string | URLSearchParams): GuestOrderAccess | null;
+declare function stripGuestOrderReturnToken(pathname: string, search: string | URLSearchParams): string;
+type GuestCommerceStorage = ReturnType<typeof createGuestCommerceStorage>;
 declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions): {
   saveCheckoutDraft<TCart>(draft: GuestCheckoutDraft<TCart>): void;
   readCheckoutDraft<TCart>(fallback: GuestCheckoutDraft<TCart>): GuestCheckoutDraft<TCart>;
@@ -195,7 +206,10 @@ declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions
     accessToken
   }: GuestOrderAccess): void;
   readOrderAccess(orderId: string): string | null;
-  listOrderAccess(): GuestOrderAccess[];
+  listOrderAccess(): GuestOrderAccess[]; /** Absolute shop URL from a path or full URL (e.g. orders page). */
+  shopUrl(ordersPage: string): string; /** Thank-you → shop handoff URL with capability token query params. */
+  orderReturnUrl(ordersPage: string, orderId: string, accessToken: string): string; /** Persist `order` + `orderAccessToken` from the shop handoff query, then strip the token. */
+  claimOrderReturn(): GuestOrderAccess | null;
 };
 //#endregion
 //#region src/commerce/guestCheckout.d.ts
@@ -279,7 +293,8 @@ type PlaceGuestCheckoutOrderResult = {
  *
  * When `pay` is enabled (default), `paymentUrl` is only set from a successful `orders.pay`
  * response. `order.paymentUrl` from create is the JoAi thank-you URL and must not be used
- * as a gateway redirect.
+ * as a gateway redirect. After payment, the thank-you page redirects to the team's shop
+ * site URL when one is configured (`sites.type = shop`).
  */
 declare function placeGuestCheckoutOrder(options: {
   client: GuestCheckoutClient;
@@ -468,6 +483,7 @@ declare class AppointmentsResource {
     timezone?: string;
     attendeeEmail?: string;
     attendeeName?: string;
+    contactIds?: string[];
     attendees?: {
       email: string;
       name?: string;
@@ -1293,7 +1309,7 @@ declare class OrdersResource {
   pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<_$_joai_core0.IAppResponse<{
     url: string;
   }>>;
-  notify(id: string, type?: string): Promise<_$_joai_core0.IAppResponse<{
+  notify(id: string, type: string | undefined, agentId: string): Promise<_$_joai_core0.IAppResponse<{
     message: string;
   }>>;
 }
@@ -1494,6 +1510,7 @@ declare class SitesResource {
   create(teamSlug: string, data: {
     name: string;
     url?: string | null;
+    type?: SiteType;
     contactId?: string | null;
     metricsSource?: string | null;
     metricsResource?: string | null;
@@ -1510,6 +1527,7 @@ declare class SitesResource {
     modules?: string[];
     name?: string | null;
     url?: string | null;
+    type?: SiteType;
     contactId?: string | null;
     metricsSource?: string | null;
     metricsResource?: string | null;
@@ -1826,6 +1844,23 @@ declare class UpdatesResource {
   stats(): Promise<_$_joai_core0.IAppResponse<UpdateStats>>;
 }
 //#endregion
+//#region src/resources/social-posts.d.ts
+declare class SocialPostsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  connections(): Promise<_$_joai_core0.IAppResponse<SocialPostConnection[]>>;
+  list(params?: {
+    status?: SocialPostStatus;
+    platform?: SocialPostPlatform;
+  }): Promise<_$_joai_core0.IAppResponse<SocialPost[]>>;
+  create(payload: SocialPostCreatePayload): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  update(id: string, payload: SocialPostUpdatePayload): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  schedule(id: string, scheduledAt?: string | null): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  cancel(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  retry(id: string): Promise<_$_joai_core0.IAppResponse<SocialPost>>;
+  delete(id: string): Promise<_$_joai_core0.IAppResponse<void>>;
+}
+//#endregion
 //#region src/resources/upgrades.d.ts
 declare class UpgradesResource {
   private readonly http;
@@ -2127,6 +2162,7 @@ declare class JoAiClient {
   readonly automations: AutomationsResource;
   readonly segments: SegmentsResource;
   readonly updates: UpdatesResource;
+  readonly socialPosts: SocialPostsResource;
   readonly upgrades: UpgradesResource;
   readonly users: UsersResource;
   readonly voice: VoiceResource;
@@ -2204,4 +2240,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 GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, sanitizePortalCallbackUrl, toGuestCheckoutDraft };
+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 GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft };

package/dist/index.mjs

@@ -88,6 +88,12 @@ var AgentsResource = class {
 			result
 		});
 	}
+	listTrustedActions(uuid) {
+		return this.http.get(`agents/${uuid}/trusted-actions`);
+	}
+	removeTrustedAction(uuid, ruleId) {
+		return this.http.delete(`agents/${uuid}/trusted-actions/${encodeURIComponent(ruleId)}`);
+	}
 };
 //#endregion
 //#region src/address/addresses.ts
@@ -262,9 +268,41 @@ const readOrderList = (namespace) => {
 		return [];
 	}
 };
+function buildGuestOrderReturnUrl(ordersPageUrl, orderId, accessToken) {
+	try {
+		const url = new URL(ordersPageUrl);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return ordersPageUrl;
+		url.searchParams.set("order", orderId);
+		url.searchParams.set("orderAccessToken", accessToken);
+		return url.toString();
+	} catch {
+		return ordersPageUrl;
+	}
+}
+function readGuestOrderReturnAccess(search) {
+	const query = typeof search === "string" ? new URLSearchParams(search) : search;
+	const orderId = query.get("order");
+	const accessToken = query.get("orderAccessToken");
+	if (!orderId || !accessToken) return null;
+	return {
+		orderId,
+		accessToken
+	};
+}
+function stripGuestOrderReturnToken(pathname, search) {
+	const query = new URLSearchParams(typeof search === "string" ? search : search.toString());
+	query.delete("orderAccessToken");
+	const next = query.toString();
+	return `${pathname}${next ? `?${next}` : ""}`;
+}
+const absoluteOrdersPageUrl = (ordersPage) => {
+	if (/^https?:\/\//i.test(ordersPage)) return ordersPage;
+	const origin = typeof window !== "undefined" ? window.location.origin : "http://localhost";
+	return new URL(ordersPage, origin).toString();
+};
 function createGuestCommerceStorage(options) {
 	const maxOrders = options.maxOrders ?? 10;
-	return {
+	const storage = {
 		saveCheckoutDraft(draft) {
 			safeSet(checkoutKey(options.namespace), JSON.stringify(draft));
 		},
@@ -301,8 +339,26 @@ function createGuestCommerceStorage(options) {
 				orderId: entry.orderId,
 				accessToken: entry.accessToken || safeGet(orderAccessKey(options.namespace, entry.orderId))
 			}));
+		},
+		/** Absolute shop URL from a path or full URL (e.g. orders page). */
+		shopUrl(ordersPage) {
+			return absoluteOrdersPageUrl(ordersPage);
+		},
+		/** Thank-you → shop handoff URL with capability token query params. */
+		orderReturnUrl(ordersPage, orderId, accessToken) {
+			return buildGuestOrderReturnUrl(absoluteOrdersPageUrl(ordersPage), orderId, accessToken);
+		},
+		/** Persist `order` + `orderAccessToken` from the shop handoff query, then strip the token. */
+		claimOrderReturn() {
+			if (typeof window === "undefined") return null;
+			const access = readGuestOrderReturnAccess(window.location.search);
+			if (!access?.accessToken) return null;
+			storage.saveOrderAccess(access);
+			window.history.replaceState({}, "", stripGuestOrderReturnToken(window.location.pathname, window.location.search));
+			return access;
 		}
 	};
+	return storage;
 }
 //#endregion
 //#region src/commerce/guestCheckout.ts
@@ -330,13 +386,15 @@ const createEmptyGuestCheckoutState = (options = {}) => ({
 		phone: ""
 	},
 	shippingRateId: null,
-	fulfillmentLocationId: null
+	fulfillmentLocationId: null,
+	couponCode: null
 });
 const toGuestCheckoutDraft = (state) => ({
 	cart: state.cart,
 	fulfillmentMethod: state.fulfillmentMethod,
 	shippingRateId: state.shippingRateId,
-	fulfillmentLocationId: state.fulfillmentLocationId
+	fulfillmentLocationId: state.fulfillmentLocationId,
+	couponCode: state.couponCode ?? null
 });
 const assertGuestCheckoutReady = (state, pickupLocationIds = []) => {
 	if (!state.cart.length) throw new GuestCheckoutError("empty_cart");
@@ -375,13 +433,15 @@ const buildGuestCheckoutSnapshotRequest = (state, options = {}) => {
 				...address,
 				type: "shipping"
 			},
-			shippingRateId: rate.id
+			shippingRateId: rate.id,
+			couponCode: state.couponCode?.trim() || void 0
 		};
 	}
 	return {
 		fulfillmentMethod: "pickup",
 		items,
-		fulfillmentLocationId: state.fulfillmentLocationId || options.pickupLocationIds?.[0] || null
+		fulfillmentLocationId: state.fulfillmentLocationId || options.pickupLocationIds?.[0] || null,
+		couponCode: state.couponCode?.trim() || void 0
 	};
 };
 async function createGuestCheckoutSnapshot(options) {
@@ -430,7 +490,8 @@ async function createGuestCheckoutSnapshot(options) {
 *
 * When `pay` is enabled (default), `paymentUrl` is only set from a successful `orders.pay`
 * response. `order.paymentUrl` from create is the JoAi thank-you URL and must not be used
-* as a gateway redirect.
+* as a gateway redirect. After payment, the thank-you page redirects to the team's shop
+* site URL when one is configured (`sites.type = shop`).
 */
 async function placeGuestCheckoutOrder(options) {
 	if (!options.acceptedTerms) throw new GuestCheckoutError("terms_required");
@@ -1898,10 +1959,13 @@ var OrdersResource = class {
 		return this.http.delete(`orders/${id}`);
 	}
 	pay(id, provider, accessToken) {
-		return this.http.post(`orders/${id}/pay`, provider ? { provider } : {}, orderAccessHeaders(accessToken));
+		return this.http.post(`orders/${id}/pay`, { ...provider ? { provider } : {} }, orderAccessHeaders(accessToken));
 	}
-	notify(id, type = "confirmation") {
-		return this.http.post(`orders/${id}/notify`, { type });
+	notify(id, type = "confirmation", agentId) {
+		return this.http.post(`orders/${id}/notify`, {
+			type,
+			agentId
+		});
 	}
 };
 //#endregion
@@ -2674,6 +2738,41 @@ var UpdatesResource = class {
 	}
 };
 //#endregion
+//#region src/resources/social-posts.ts
+var SocialPostsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	connections() {
+		return this.http.get("social-posts/connections");
+	}
+	list(params) {
+		const query = new URLSearchParams();
+		if (params?.status) query.set("status", params.status);
+		if (params?.platform) query.set("platform", params.platform);
+		const qs = query.toString();
+		return this.http.get(`social-posts${qs ? "?" + qs : ""}`);
+	}
+	create(payload) {
+		return this.http.post("social-posts", payload);
+	}
+	update(id, payload) {
+		return this.http.patch(`social-posts/${id}`, payload);
+	}
+	schedule(id, scheduledAt) {
+		return this.http.post(`social-posts/${id}/schedule`, scheduledAt ? { scheduledAt } : {});
+	}
+	cancel(id) {
+		return this.http.post(`social-posts/${id}/cancel`, {});
+	}
+	retry(id) {
+		return this.http.post(`social-posts/${id}/retry`, {});
+	}
+	delete(id) {
+		return this.http.delete(`social-posts/${id}`);
+	}
+};
+//#endregion
 //#region src/resources/upgrades.ts
 var UpgradesResource = class {
 	constructor(http) {
@@ -3209,6 +3308,7 @@ var JoAiClient = class {
 		this.automations = new AutomationsResource(this.http);
 		this.segments = new SegmentsResource(this.http);
 		this.updates = new UpdatesResource(this.http);
+		this.socialPosts = new SocialPostsResource(this.http);
 		this.upgrades = new UpgradesResource(this.http);
 		this.users = new UsersResource(this.http);
 		this.voice = new VoiceResource(this.http);
@@ -3322,4 +3422,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, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, sanitizePortalCallbackUrl, toGuestCheckoutDraft };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, GuestCheckoutError, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isGuestCheckoutError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "5.0.0",
+  "version": "7.0.0",
   "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.13.0",
+    "@joai/core": "^4.15.0",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.13.0"
+    "@joai/core": "^4.15.0"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",