@joai/sdk 7.0.7 → 7.0.8

package/dist/index.d.mts

@@ -249,6 +249,24 @@ declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions
   claimOrderReturn(): GuestOrderAccess | null;
 };
 //#endregion
+//#region src/commerce/recentlyViewed.d.ts
+type RecentlyViewedStorageOptions = {
+  /** Team slug or shop id — scopes storage per storefront. */namespace: string;
+  maxItems?: number;
+};
+type RecentlyViewedStorage = {
+  track: (slug: string) => void;
+  getSlugs: () => string[];
+  clear: () => void;
+};
+/**
+ * Persist recently viewed product slugs in localStorage (no PII).
+ * Newest first; duplicates move to the front; capped by maxItems.
+ */
+declare function createRecentlyViewedStorage(options: RecentlyViewedStorageOptions): RecentlyViewedStorage;
+declare function trackRecentlyViewed(namespace: string, slug: string, maxItems?: number): void;
+declare function getRecentlyViewedSlugs(namespace: string): string[];
+//#endregion
 //#region src/commerce/guestCheckout.d.ts
 type GuestCheckoutCartItem = {
   id: string;
@@ -1447,6 +1465,17 @@ declare class OrdersResource {
   pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<_$_joai_core0.IAppResponse<{
     url: string;
   }>>;
+  reorder(id: string): Promise<_$_joai_core0.IAppResponse<{
+    added: Array<{
+      id: string;
+      name: string;
+      quantity: number;
+    }>;
+    skipped: Array<{
+      name: string;
+      reason: string;
+    }>;
+  }>>;
   notify(id: string, type: string | undefined, agentId: string): Promise<_$_joai_core0.IAppResponse<{
     message: string;
   }>>;
@@ -2388,4 +2417,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type AuthUser, AutomationsResource, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, type Cart, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, type CheckoutSnapshot, CommerceResource, ContactsResource, ContentResource, ContractsResource, type CreateEmptyGuestCheckoutOptions, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, type FulfillmentLocation, type FulfillmentLocationInput, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCartAmounts, type GuestCheckoutCartItem, type GuestCheckoutClient, type GuestCheckoutDraft, GuestCheckoutError, type GuestCheckoutErrorCode, type GuestCheckoutSnapshotResult, type GuestCheckoutState, type GuestCommerceStorage, type GuestCommerceStorageOptions, type GuestCouponClient, GuestCouponError, type GuestCouponErrorCode, type GuestCouponPreview, type GuestOrderAccess, type Hook, type HookSample, type HookTrigger, type HookTriggerCondition, type HookTriggerInput, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, type ItemListParams, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, type Order, type OrderPriceMode, type OrderStatus, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type PlaceGuestCheckoutOrderResult, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, type RevalidateGuestCouponResult, SegmentsResource, ServicesResource, type ShippingRate, type ShippingRateInput, ShippingResource, type ShippingZoneInput, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TaxClassInput, TaxClassesResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, assertGuestCheckoutReady, assertGuestPickupSlotReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };
+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 };

package/dist/index.mjs

@@ -255,7 +255,7 @@ const orderAccessPrefix = "joai:order-access:";
 const checkoutKey = (namespace) => `joai:guest-checkout:${namespace}`;
 const ordersKey = (namespace) => `joai:guest-orders:${namespace}`;
 const orderAccessKey = (namespace, orderId) => `${orderAccessPrefix}${namespace}:${orderId}`;
-const safeGet = (key) => {
+const safeGet$1 = (key) => {
 	if (typeof localStorage === "undefined") return null;
 	try {
 		return localStorage.getItem(key);
@@ -263,13 +263,13 @@ const safeGet = (key) => {
 		return null;
 	}
 };
-const safeSet = (key, value) => {
+const safeSet$1 = (key, value) => {
 	if (typeof localStorage === "undefined") return;
 	try {
 		localStorage.setItem(key, value);
 	} catch {}
 };
-const safeRemove = (key) => {
+const safeRemove$1 = (key) => {
 	if (typeof localStorage === "undefined") return;
 	try {
 		localStorage.removeItem(key);
@@ -287,7 +287,7 @@ const parseGuestOrderAccess = (entry) => {
 };
 const readOrderList = (namespace) => {
 	try {
-		const saved = JSON.parse(safeGet(ordersKey(namespace)) || "[]");
+		const saved = JSON.parse(safeGet$1(ordersKey(namespace)) || "[]");
 		if (!Array.isArray(saved)) return [];
 		return saved.map(parseGuestOrderAccess).filter((entry) => entry !== null);
 	} catch {
@@ -330,11 +330,11 @@ function createGuestCommerceStorage(options) {
 	const maxOrders = options.maxOrders ?? 10;
 	const storage = {
 		saveCheckoutDraft(draft) {
-			safeSet(checkoutKey(options.namespace), JSON.stringify(draft));
+			safeSet$1(checkoutKey(options.namespace), JSON.stringify(draft));
 		},
 		readCheckoutDraft(fallback) {
 			try {
-				const saved = JSON.parse(safeGet(checkoutKey(options.namespace)) || "");
+				const saved = JSON.parse(safeGet$1(checkoutKey(options.namespace)) || "");
 				return {
 					...fallback,
 					...saved,
@@ -346,24 +346,24 @@ function createGuestCommerceStorage(options) {
 		},
 		saveOrderAccess({ orderId, accessToken }) {
 			const key = orderAccessKey(options.namespace, orderId);
-			const resolvedToken = accessToken || safeGet(key);
-			if (resolvedToken) safeSet(key, resolvedToken);
+			const resolvedToken = accessToken || safeGet$1(key);
+			if (resolvedToken) safeSet$1(key, resolvedToken);
 			const orders = readOrderList(options.namespace).filter((entry) => entry.orderId !== orderId);
 			orders.unshift({
 				orderId,
 				accessToken: resolvedToken
 			});
 			const kept = orders.slice(0, maxOrders);
-			for (const dropped of orders.slice(maxOrders)) safeRemove(orderAccessKey(options.namespace, dropped.orderId));
-			safeSet(ordersKey(options.namespace), JSON.stringify(kept));
+			for (const dropped of orders.slice(maxOrders)) safeRemove$1(orderAccessKey(options.namespace, dropped.orderId));
+			safeSet$1(ordersKey(options.namespace), JSON.stringify(kept));
 		},
 		readOrderAccess(orderId) {
-			return safeGet(orderAccessKey(options.namespace, orderId));
+			return safeGet$1(orderAccessKey(options.namespace, orderId));
 		},
 		listOrderAccess() {
 			return readOrderList(options.namespace).map((entry) => ({
 				orderId: entry.orderId,
-				accessToken: entry.accessToken || safeGet(orderAccessKey(options.namespace, entry.orderId))
+				accessToken: entry.accessToken || safeGet$1(orderAccessKey(options.namespace, entry.orderId))
 			}));
 		},
 		/** Absolute shop URL from a path or full URL (e.g. orders page). */
@@ -387,6 +387,71 @@ function createGuestCommerceStorage(options) {
 	return storage;
 }
 //#endregion
+//#region src/commerce/recentlyViewed.ts
+const DEFAULT_MAX_ITEMS = 12;
+const storageKey = (namespace) => `joai:recently-viewed:${namespace}`;
+const safeGet = (key) => {
+	if (typeof localStorage === "undefined") return null;
+	try {
+		return localStorage.getItem(key);
+	} catch {
+		return null;
+	}
+};
+const safeSet = (key, value) => {
+	if (typeof localStorage === "undefined") return;
+	try {
+		localStorage.setItem(key, value);
+	} catch {}
+};
+const safeRemove = (key) => {
+	if (typeof localStorage === "undefined") return;
+	try {
+		localStorage.removeItem(key);
+	} catch {}
+};
+const parseSlugs = (raw) => {
+	if (!raw) return [];
+	try {
+		const parsed = JSON.parse(raw);
+		if (!Array.isArray(parsed)) return [];
+		return parsed.filter((item) => typeof item === "string" && item.length > 0);
+	} catch {
+		return [];
+	}
+};
+/**
+* Persist recently viewed product slugs in localStorage (no PII).
+* Newest first; duplicates move to the front; capped by maxItems.
+*/
+function createRecentlyViewedStorage(options) {
+	const key = storageKey(options.namespace);
+	const maxItems = options.maxItems ?? DEFAULT_MAX_ITEMS;
+	return {
+		track(slug) {
+			const normalized = slug.trim();
+			if (!normalized) return;
+			const updated = [normalized, ...parseSlugs(safeGet(key)).filter((item) => item !== normalized)].slice(0, maxItems);
+			safeSet(key, JSON.stringify(updated));
+		},
+		getSlugs() {
+			return parseSlugs(safeGet(key));
+		},
+		clear() {
+			safeRemove(key);
+		}
+	};
+}
+function trackRecentlyViewed(namespace, slug, maxItems) {
+	createRecentlyViewedStorage({
+		namespace,
+		maxItems
+	}).track(slug);
+}
+function getRecentlyViewedSlugs(namespace) {
+	return createRecentlyViewedStorage({ namespace }).getSlugs();
+}
+//#endregion
 //#region src/commerce/guestCheckout.ts
 var GuestCheckoutError = class extends Error {
 	constructor(code) {
@@ -2110,6 +2175,9 @@ var OrdersResource = class {
 	pay(id, provider, accessToken) {
 		return this.http.post(`orders/${id}/pay`, { ...provider ? { provider } : {} }, orderAccessHeaders(accessToken));
 	}
+	reorder(id) {
+		return this.http.post(`orders/${id}/reorder`);
+	}
 	notify(id, type = "confirmation", agentId) {
 		return this.http.post(`orders/${id}/notify`, {
 			type,
@@ -3588,4 +3656,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, formatOpeningHours, formatPickupSlotLabel, getAuthFragmentToken, guestCartAmounts, guestCouponMessageFromErrors, isAllowedRedirectUrl, isGuestCheckoutError, isGuestCouponError, isPortalCallbackUrl, openPortalSession, placeGuestCheckoutOrder, readGuestOrderReturnAccess, revalidateGuestCoupon, sanitizePortalCallbackUrl, stripGuestOrderReturnToken, toGuestCheckoutDraft, validateGuestCoupon };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, AutomationsResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContentResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, GuestCheckoutError, GuestCouponError, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MetricsResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, SocialPostsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TaxClassesResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, assertGuestCheckoutReady, assertGuestPickupSlotReady, buildGuestCheckoutSnapshotRequest, buildGuestOrderReturnUrl, completePortalSession, createClient, createEmptyGuestCheckoutState, createGuestCheckoutSnapshot, createGuestCommerceStorage, 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": "7.0.7",
+  "version": "7.0.8",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -35,11 +35,11 @@
     "test": "jest --config jest.config.js"
   },
   "dependencies": {
-    "@joai/core": "^4.15.6",
+    "@joai/core": "^4.15.7",
     "@joai/warps": "*"
   },
   "peerDependencies": {
-    "@joai/core": "^4.15.6"
+    "@joai/core": "^4.15.7"
   },
   "devDependencies": {
     "tsdown": "^0.21.0",