@joai/sdk 4.7.0 → 5.0.0

package/dist/index.mjs

@@ -1,205 +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 ?? {}
-		};
-	}
-};
-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"
-});
-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",
-	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) {
@@ -505,6 +305,171 @@ function createGuestCommerceStorage(options) {
 	};
 }
 //#endregion
+//#region src/commerce/guestCheckout.ts
+var GuestCheckoutError = class extends Error {
+	constructor(code) {
+		super(code);
+		this.code = code;
+		this.name = "GuestCheckoutError";
+	}
+};
+const createEmptyGuestCheckoutState = (options = {}) => ({
+	cart: [],
+	identity: {
+		name: "",
+		email: "",
+		phone: ""
+	},
+	fulfillmentMethod: options.fulfillmentMethod ?? "shipping",
+	address: {
+		name: "",
+		addressOne: "",
+		city: "",
+		zipCode: "",
+		country: options.country ?? "AT",
+		phone: ""
+	},
+	shippingRateId: null,
+	fulfillmentLocationId: null
+});
+const toGuestCheckoutDraft = (state) => ({
+	cart: state.cart,
+	fulfillmentMethod: state.fulfillmentMethod,
+	shippingRateId: state.shippingRateId,
+	fulfillmentLocationId: state.fulfillmentLocationId
+});
+const assertGuestCheckoutReady = (state, pickupLocationIds = []) => {
+	if (!state.cart.length) throw new GuestCheckoutError("empty_cart");
+	if (!state.identity.name.trim() || !state.identity.email.trim()) throw new GuestCheckoutError("missing_identity");
+	if (state.fulfillmentMethod === "pickup" && !state.identity.phone?.trim()) throw new GuestCheckoutError("missing_pickup_phone");
+	const address = {
+		...state.address,
+		name: state.identity.name
+	};
+	if (state.fulfillmentMethod === "shipping" && !isCompleteAddressInput(address)) throw new GuestCheckoutError("incomplete_shipping_address");
+	if (state.fulfillmentMethod === "pickup" && !state.fulfillmentLocationId && !pickupLocationIds[0]) throw new GuestCheckoutError("pickup_unavailable");
+};
+const buildGuestCheckoutSnapshotRequest = (state, options = {}) => {
+	assertGuestCheckoutReady(state, options.pickupLocationIds ?? []);
+	const items = state.cart.map(({ id, type, quantity }) => ({
+		id,
+		type,
+		quantity
+	}));
+	const address = {
+		...state.address,
+		name: state.identity.name
+	};
+	if (state.fulfillmentMethod === "shipping") {
+		const rates = options.shippingRates ?? [];
+		const rate = state.shippingRateId == null ? rates[0] : rates.find((item) => item.id === state.shippingRateId);
+		if (!rate) throw new GuestCheckoutError("missing_shipping_rate");
+		return {
+			fulfillmentMethod: "shipping",
+			items,
+			billingAddress: {
+				...address,
+				type: "billing"
+			},
+			shippingAddress: {
+				...address,
+				type: "shipping"
+			},
+			shippingRateId: rate.id
+		};
+	}
+	return {
+		fulfillmentMethod: "pickup",
+		items,
+		fulfillmentLocationId: state.fulfillmentLocationId || options.pickupLocationIds?.[0] || null
+	};
+};
+async function createGuestCheckoutSnapshot(options) {
+	const { client, team, state } = options;
+	const items = state.cart.map(({ id, type, quantity }) => ({
+		id,
+		type,
+		quantity
+	}));
+	let shippingRates = options.shippingRates ?? [];
+	if (state.fulfillmentMethod === "shipping" && !options.shippingRates) {
+		const address = {
+			...state.address,
+			name: state.identity.name
+		};
+		const ratesResponse = await client.commerce.checkout.shippingRates(team, {
+			address: {
+				country: address.country,
+				zipCode: address.zipCode
+			},
+			items
+		});
+		if (!ratesResponse.ok || !Array.isArray(ratesResponse.data)) throw new GuestCheckoutError("rates_failed");
+		shippingRates = ratesResponse.data;
+	}
+	const snapshotRequest = buildGuestCheckoutSnapshotRequest(state, {
+		shippingRates,
+		pickupLocationIds: options.pickupLocationIds
+	});
+	const snapshot = await client.commerce.checkout.snapshot(team, snapshotRequest);
+	if (!snapshot.ok || !snapshot.data?.id || !snapshot.data.accessToken) throw new GuestCheckoutError("snapshot_failed");
+	return {
+		snapshot: {
+			...snapshot.data,
+			accessToken: snapshot.data.accessToken
+		},
+		shippingRates,
+		shippingRateId: typeof snapshotRequest.shippingRateId === "number" ? snapshotRequest.shippingRateId : null
+	};
+}
+/**
+* Places a guest order from a checkout snapshot and optionally starts payment.
+*
+* The client must already carry team context (e.g. `createClient({ team })` → `X-Team`).
+* Body `team` alone is not enough for `orders.create`.
+*
+* 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.
+*/
+async function placeGuestCheckoutOrder(options) {
+	if (!options.acceptedTerms) throw new GuestCheckoutError("terms_required");
+	const expiresAt = new Date(options.snapshot.expiresAt).getTime();
+	if (!Number.isFinite(expiresAt) || expiresAt <= Date.now()) throw new GuestCheckoutError("review_expired");
+	const order = await options.client.orders.create({
+		team: options.team,
+		snapshotId: options.snapshot.id,
+		snapshotAccessToken: options.snapshot.accessToken,
+		guest: options.guest,
+		idempotencyKey: options.idempotencyKey ?? crypto.randomUUID(),
+		notes: options.notes,
+		sendConfirmation: true
+	});
+	if (!order.ok || !order.data?.id) throw new GuestCheckoutError("order_failed");
+	const accessToken = typeof order.meta?.orderAccessToken === "string" ? order.meta.orderAccessToken : null;
+	if (options.pay === false) 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 {
+		order: order.data,
+		accessToken,
+		paymentUrl: null
+	};
+	return {
+		order: order.data,
+		accessToken,
+		paymentUrl: payment.data.url
+	};
+}
+const isGuestCheckoutError = (error) => {
+	if (error instanceof GuestCheckoutError) return true;
+	return typeof error === "object" && error !== null && error.name === "GuestCheckoutError" && typeof error.code === "string";
+};
+//#endregion
 //#region src/commerce/index.ts
 var CommerceResource = class {
 	constructor(http) {
@@ -1921,7 +1886,7 @@ var OrdersResource = class {
 		return this.http.get(`orders/${id}`, orderAccessHeaders(accessToken));
 	}
 	create(data) {
-		return this.http.post("orders", data);
+		return this.http.post("orders", data, { headers: { "X-Team": data.team } });
 	}
 	update(id, data) {
 		return this.http.put(`orders/${id}`, data);
@@ -2175,10 +2140,9 @@ var SitesResource = class {
 	listMine(teamSlug) {
 		return this.http.get(`sites/mine?team=${encodeURIComponent(teamSlug)}`);
 	}
-	create(teamSlug, slug, data) {
+	create(teamSlug, data) {
 		return this.http.post("sites", {
 			team: teamSlug,
-			slug,
 			...data
 		});
 	}
@@ -2611,6 +2575,9 @@ var AutomationsResource = class {
 	list() {
 		return this.http.get("automations");
 	}
+	stats() {
+		return this.http.get("automations/stats");
+	}
 	get(id) {
 		return this.http.get(`automations/${id}`);
 	}
@@ -3355,4 +3322,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, 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, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+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 };

package/package.json

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