@joai/sdk 4.8.0 → 6.0.0

package/dist/index.mjs

@@ -1,238 +1,5 @@
+import { HttpService, getApiBaseUrl, isCompleteAddressInput } from "@joai/core";
 import { WarpClient } from "@joai/warps";
-//#region ../core/dist/index.mjs
-const toSubdomainBaseUrl = (env, subdomain) => {
-	if (env === "local") return `http://${subdomain}.joai--api.test`;
-	if (env === "devnet") return `https://devnet-${subdomain}.joai.ai`;
-	if (env === "testnet") return `https://testnet-${subdomain}.joai.ai`;
-	return `https://${subdomain}.joai.ai`;
-};
-const getApiBaseUrl = (env) => toSubdomainBaseUrl(env, "api");
-var HttpService = class {
-	constructor(baseUrl, cookies, authToken, options) {
-		this.get = async (url, options) => await this.request("GET", url, void 0, options);
-		this.post = async (url, data, options) => await this.request("POST", url, data, options);
-		this.put = async (url, data, options) => await this.request("PUT", url, data, options);
-		this.patch = async (url, data, options) => await this.request("PATCH", url, data, options);
-		this.delete = async (url, options) => await this.request("DELETE", url, void 0, options);
-		this.getCsrfToken = () => {
-			if (typeof document === "undefined") return null;
-			const match = document.cookie.match(/(?:^|;\s*)XSRF-TOKEN=([^;]*)/);
-			return match ? decodeURIComponent(match[1]) : null;
-		};
-		this.request = async (httpMethod, url, data, options, isRetry) => {
-			const requestUrl = url.startsWith("http") ? url : `${this.baseUrl}/${url}`;
-			const requestInfo = this.getRequestInfo(httpMethod, data, options);
-			const response = await this.convertResponse(this.fetchFn(requestUrl, requestInfo));
-			if (response.original.status === 419 && !isRetry) {
-				await this.refreshCsrfToken();
-				return this.request(httpMethod, url, data, options, true);
-			}
-			if (response.original.status === 401) this.onUnauthorized(response);
-			if (response.original.status === 429) {
-				console.warn(`[HTTP 429] ${httpMethod} ${requestUrl}`);
-				this.onTooManyRequests(response);
-			}
-			if (response.original.status === 503) this.onMaintenanceMode(response);
-			if (response.ok) this.onSuccessfulResponse(response);
-			return response;
-		};
-		this.refreshCsrfToken = async () => {
-			await this.fetchFn(`${this.csrfBaseUrl}/sanctum/csrf-cookie`, {
-				method: "GET",
-				credentials: "include",
-				headers: {
-					Accept: "application/json",
-					...this.headers
-				}
-			});
-		};
-		this.convertResponse = async (apiRes) => {
-			try {
-				const response = await apiRes;
-				const body = response.status === 204 ? {} : await response.json();
-				return {
-					data: body.data || null,
-					meta: body.meta,
-					body,
-					errors: body.errors || [],
-					ok: response.ok && !(body.errors && body.errors.length > 0),
-					noContent: response.status === 204,
-					paymentRequired: response.status === 402,
-					original: response
-				};
-			} catch (error) {
-				this.onNetworkError(error);
-				const anyError = error;
-				return {
-					data: {},
-					errors: anyError.response && (anyError.response.data || {}).errors,
-					body: {},
-					ok: false,
-					noContent: false,
-					paymentRequired: false,
-					original: anyError
-				};
-			}
-		};
-		this.getRequestInfo = (httpMethod = "GET", data, options) => {
-			const isJson = options?.isJson !== false;
-			const isFormData = data instanceof FormData;
-			const situationalHeaders = options?.headers || {};
-			const csrfToken = httpMethod !== "GET" ? this.getCsrfToken() : null;
-			const headers = {
-				Accept: "application/json",
-				...this.authToken ? { Authorization: `Bearer ${this.authToken}` } : {},
-				...csrfToken ? { "X-XSRF-TOKEN": csrfToken } : {},
-				...situationalHeaders,
-				...this.headers
-			};
-			if (isJson && !isFormData) headers["Content-Type"] = "application/json";
-			return {
-				method: httpMethod,
-				credentials: "include",
-				headers,
-				body: httpMethod !== "GET" ? isJson && !isFormData ? JSON.stringify(data || {}) : data : void 0
-			};
-		};
-		this.baseUrl = baseUrl;
-		this.authToken = authToken || null;
-		this.fetchFn = options?.customFetch ?? globalThis.fetch.bind(globalThis);
-		this.csrfBaseUrl = options?.csrfBaseUrl ?? baseUrl;
-		this.onNetworkError = () => {};
-		this.onSuccessfulResponse = () => {};
-		this.onUnauthorized = () => {};
-		this.onMaintenanceMode = () => {};
-		this.onTooManyRequests = () => {};
-		this.headers = {
-			...options?.refererUrl ? { Referer: options.refererUrl } : {},
-			...cookies ? { Cookie: cookies } : {},
-			...options?.headers ?? {}
-		};
-	}
-};
-const OUTBOUND_CHANNELS = [
-	{
-		id: "email",
-		supportsHtml: true,
-		requiresSubject: true,
-		settingsKey: "email_provider"
-	},
-	{
-		id: "whatsapp",
-		supportsHtml: false,
-		requiresSubject: false
-	},
-	{
-		id: "whatsapp-personal",
-		supportsHtml: false,
-		requiresSubject: false
-	},
-	{
-		id: "sms",
-		supportsHtml: false,
-		requiresSubject: false
-	},
-	{
-		id: "push",
-		supportsHtml: false,
-		requiresSubject: true
-	}
-];
-const AUTOMATION_SEND_CHANNELS = OUTBOUND_CHANNELS.filter((channel) => channel.id === "email" || channel.id === "whatsapp-personal");
-OUTBOUND_CHANNELS.map((channel) => channel.id).filter((id) => id !== "whatsapp-personal");
-AUTOMATION_SEND_CHANNELS[0];
-Object.values({
-	Billing: "billing",
-	Shipping: "shipping"
-});
-Object.values({
-	Pending: "pending",
-	ReadyForPickup: "ready_for_pickup",
-	Shipped: "shipped",
-	Delivered: "delivered",
-	Cancelled: "cancelled"
-});
-Object.values({
-	Shipping: "shipping",
-	Pickup: "pickup"
-});
-Object.values({
-	Requested: "requested",
-	Approved: "approved",
-	Rejected: "rejected",
-	Received: "received",
-	Closed: "closed"
-});
-Object.values({
-	Approved: "approved",
-	Rejected: "rejected",
-	Received: "received",
-	Closed: "closed"
-});
-const isCompleteAddressInput = (address) => Boolean(address.name.trim() && address.addressOne.trim() && address.city.trim() && address.zipCode.trim() && address.country.trim());
-Object.values({
-	Board: "board",
-	Shop: "shop",
-	SmartLinks: "smart-links",
-	Contacts: "contacts",
-	Forms: "forms",
-	Appointments: "appointments",
-	Workspace: "workspace",
-	Meeting: "meeting",
-	VoiceDictation: "voice-dictation",
-	Heartbeats: "heartbeats",
-	Wallets: "wallets",
-	Campaigns: "campaigns",
-	Automations: "automations",
-	News: "news",
-	Sites: "sites",
-	Contracts: "contracts",
-	Artifacts: "artifacts"
-});
-/** Permission string values — must match joai--api `UserPermission::value`. */
-const UserPermissions = {
-	BillingManage: "billing-manage",
-	TeamManage: "team-manage",
-	TeamView: "team-view",
-	ContentEdit: "content-edit",
-	ContentPublish: "content-publish",
-	TeamMemberInvite: "team-member-invite",
-	TeamMemberRemove: "team-member-remove",
-	TeamSecretView: "team-secret-view",
-	TeamSecretManage: "team-secret-manage",
-	AgentExecute: "agent-execute",
-	AgentWalletManage: "agent-wallet-manage",
-	SwarmCreate: "swarm-create"
-};
-Object.values(UserPermissions);
-const teamManageOr = (...permissions) => ({ permissionsAny: [UserPermissions.TeamManage, ...permissions] });
-const permissionPresetRules = {
-	teamManage: { permissions: [UserPermissions.TeamManage] },
-	teamView: teamManageOr(UserPermissions.TeamView),
-	billingManage: teamManageOr(UserPermissions.BillingManage),
-	agentTooling: teamManageOr(UserPermissions.AgentExecute),
-	secretView: teamManageOr(UserPermissions.TeamSecretView),
-	secretManage: teamManageOr(UserPermissions.TeamSecretManage),
-	teamMemberInvite: teamManageOr(UserPermissions.TeamMemberInvite),
-	teamMemberRemove: teamManageOr(UserPermissions.TeamMemberRemove),
-	agentWalletManage: teamManageOr(UserPermissions.AgentWalletManage),
-	swarmCreate: teamManageOr(UserPermissions.SwarmCreate)
-};
-permissionPresetRules.teamManage;
-permissionPresetRules.teamView;
-permissionPresetRules.agentTooling;
-permissionPresetRules.billingManage;
-/** Team member roles — values must match joai--api `UserRole::toName()`. */
-const UserRoles = {
-	Owner: "owner",
-	Admin: "admin",
-	Member: "member",
-	Developer: "developer"
-};
-Object.values(UserRoles);
-UserRoles.Member, UserRoles.Developer, UserRoles.Admin;
-UserRoles.Member;
-//#endregion
 //#region src/resources/agents.ts
 var AgentsResource = class {
 	constructor(http) {
@@ -495,9 +262,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));
 		},
@@ -534,8 +333,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
@@ -663,7 +480,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");
@@ -2131,10 +1949,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 ? { agentId } : {}
+		});
 	}
 };
 //#endregion
@@ -2907,6 +2728,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) {
@@ -3442,6 +3298,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);
@@ -3555,4 +3412,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": "4.8.0",
+  "version": "6.0.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",
@@ -35,10 +35,13 @@
     "test": "jest --config jest.config.js"
   },
   "dependencies": {
+    "@joai/core": "^4.14.0",
     "@joai/warps": "*"
   },
+  "peerDependencies": {
+    "@joai/core": "^4.14.0"
+  },
   "devDependencies": {
-    "@joai/core": "^4.12.0",
     "tsdown": "^0.21.0",
     "typescript": "^5.9.3"
   }