@joai/sdk 4.2.0 → 4.2.2

package/dist/index.d.mts

@@ -154,8 +154,33 @@ type WalletList = Partial<Record<WarpChainName, {
   provider: WarpWalletProvider;
   address?: string;
 }>>; //#endregion
+//#region src/user/permissions.d.ts
+/** Permission string values — must match joai--api `UserPermission::value`. */
+declare const UserPermissions: {
+  readonly BillingManage: "billing-manage";
+  readonly TeamManage: "team-manage";
+  readonly TeamView: "team-view";
+  readonly TeamMemberInvite: "team-member-invite";
+  readonly TeamMemberRemove: "team-member-remove";
+  readonly TeamSecretView: "team-secret-view";
+  readonly TeamSecretManage: "team-secret-manage";
+  readonly AgentExecute: "agent-execute";
+  readonly AgentWalletManage: "agent-wallet-manage";
+  readonly SwarmCreate: "swarm-create";
+};
+type UserPermission = (typeof UserPermissions)[keyof typeof UserPermissions];
+//#endregion
+//#region src/user/roles.d.ts
+/** Team member roles — values must match joai--api `UserRole::toName()`. */
+declare const UserRoles: {
+  readonly Owner: "owner";
+  readonly Admin: "admin";
+  readonly Member: "member";
+  readonly Developer: "developer";
+};
+type UserRole = (typeof UserRoles)[keyof typeof UserRoles];
+//#endregion
 //#region src/user/types.d.ts
-type UserRole = 'owner' | 'member';
 type UserMode = 'simple' | 'advanced';
 type UserInterest = 'payments' | 'health' | 'content' | 'business' | 'finance' | 'research' | 'shopping' | 'web3' | 'developer' | 'fitness' | 'ecommerce';
 type UserSettings = {
@@ -191,7 +216,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
 };
@@ -242,8 +266,6 @@ type AffiliateTier = {
   threshold: number;
 };
 type AffiliateStatus = 'pending' | 'approved' | 'rejected' | 'suspended' | 'demoted'; //#endregion
-//#region src/team/constants.d.ts
-declare const teamCategories: readonly ["general", "food-drink", "retail", "beauty-wellness", "health", "sports-fitness", "trades-services", "professional-services", "education-culture", "clubs-organizations", "leisure-tourism"]; //#endregion
 //#region src/team/apps.d.ts
 declare const NativeApps: {
   readonly Board: "board";
@@ -264,6 +286,25 @@ declare const NativeApps: {
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 //#endregion
+//#region src/access/team-access.d.ts
+type TeamFeatureArea = 'nativeApps' | 'agentSettings' | 'teamSettings' | 'developerHub' | 'areas' | 'commerce';
+/** Keys per area that the API evaluates in `team.access`. */
+type TeamAccessCatalog = Partial<Record<TeamFeatureArea, string[]>>;
+type TeamAccessConfig = {
+  accessCatalog: TeamAccessCatalog;
+};
+/** Resolved feature access from API `TeamPrivate.access` — do not evaluate rules on the client. */
+type TeamFeatureAccess = {
+  nativeApps?: Partial<Record<NativeApp, boolean>>;
+  agentSettings?: Partial<Record<string, boolean>>;
+  teamSettings?: Partial<Record<string, boolean>>;
+  developerHub?: Partial<Record<string, boolean>>;
+  areas?: Partial<Record<string, boolean>>;
+  commerce?: Partial<Record<string, boolean>>;
+};
+//#endregion
+//#region src/team/constants.d.ts
+declare const teamCategories: readonly ["general", "food-drink", "retail", "beauty-wellness", "health", "sports-fitness", "trades-services", "professional-services", "education-culture", "clubs-organizations", "leisure-tourism"]; //#endregion
 //#region src/team/types.d.ts
 type TeamCategory = (typeof teamCategories)[number];
 type TeamFeature = 'shop' | 'appointments';
@@ -375,6 +416,10 @@ type TeamPrivate = {
   category: TeamCategory;
   createdAt: string;
   justCreated: boolean;
+  role?: UserRole | null;
+  permissions?: UserPermission[];
+  access?: TeamFeatureAccess;
+  accessCatalog?: TeamAccessCatalog;
 };
 type ByokProviderConfig = {
   apiKey?: string;
@@ -442,8 +487,14 @@ type AiCostsResponse = {
     };
   };
 }; //#endregion
+//#region src/address/enums.d.ts
+declare const AddressTypes: {
+  readonly Billing: "billing";
+  readonly Shipping: "shipping";
+};
+type AddressType = (typeof AddressTypes)[keyof typeof AddressTypes];
+//#endregion
 //#region src/address/types.d.ts
-type AddressType = 'shipping' | 'billing';
 type Address = {
   id: string;
   type: AddressType;
@@ -495,8 +546,30 @@ type AddressCreatePayload = {
   team?: string;
 };
 type AddressUpdatePayload = Partial<Omit<AddressCreatePayload, 'contact' | 'team'>>; //#endregion
+//#region src/commerce/enums.d.ts
+declare const FulfillmentStatuses: {
+  readonly Pending: "pending";
+  readonly ReadyForPickup: "ready_for_pickup";
+  readonly Shipped: "shipped";
+  readonly Delivered: "delivered";
+  readonly Cancelled: "cancelled";
+};
+type FulfillmentStatus = (typeof FulfillmentStatuses)[keyof typeof FulfillmentStatuses];
+declare const FulfillmentMethods: {
+  readonly Shipping: "shipping";
+  readonly Pickup: "pickup";
+};
+type FulfillmentMethod = (typeof FulfillmentMethods)[keyof typeof FulfillmentMethods];
+declare const ReturnStatuses: {
+  readonly Requested: "requested";
+  readonly Approved: "approved";
+  readonly Rejected: "rejected";
+  readonly Received: "received";
+  readonly Closed: "closed";
+};
+type ReturnStatus = (typeof ReturnStatuses)[keyof typeof ReturnStatuses];
+//#endregion
 //#region src/commerce/types.d.ts
-type FulfillmentMethod = 'shipping' | 'pickup';
 type ShippingRate = {
   id: number;
   name: string;
@@ -523,6 +596,10 @@ type CheckoutSnapshot = {
   expiresAt: string;
   accessToken?: string | null;
 };
+type GuestBuyer = {
+  name: string;
+  email: string;
+};
 type CheckoutSnapshotRequest = {
   fulfillmentMethod: FulfillmentMethod;
   items: {
@@ -554,7 +631,6 @@ type FulfillmentLocation = {
   instructions: string | null;
   active: boolean;
 };
-type FulfillmentStatus = 'pending' | 'ready_for_pickup' | 'shipped' | 'delivered' | 'cancelled';
 type Fulfillment = {
   id: string;
   orderId: number;
@@ -571,7 +647,6 @@ type Fulfillment = {
   readyForPickupAt: string | null;
   deliveredAt: string | null;
 };
-type ReturnStatus = 'requested' | 'approved' | 'rejected' | 'received' | 'closed';
 type Return = {
   id: string;
   orderId: number;
@@ -924,7 +999,7 @@ type Order = {
   linkVariationId: string | null;
   notes: string | null;
   fulfillmentMethod?: FulfillmentMethod | null;
-  address?: AddressSnapshot | null;
+  billingAddress?: AddressSnapshot | null;
   shippingAddress?: AddressSnapshot | null;
   shippingRate?: Pick<ShippingRate, 'name' | 'price' | 'estimatedMinDays' | 'estimatedMaxDays'> | null;
   fulfillmentLocation?: {
@@ -3066,10 +3141,7 @@ declare class AddressesResource {
 //#endregion
 //#region src/commerce/checkout.d.ts
 type PlaceCheckoutOrderRequest = CheckoutSnapshotRequest & {
-  guest?: {
-    name: string;
-    email: string;
-  };
+  guest?: GuestBuyer;
   notes?: string;
   idempotencyKey?: string;
   saveAddresses?: boolean;
@@ -4486,7 +4558,7 @@ type TeamMutationPayload = {
   settings?: Record<string, JsonValue>;
   emails?: {
     email: string;
-    role: 'owner' | 'admin' | 'member';
+    role: UserRole;
   }[];
   website?: string | null;
   phone?: string | null;
@@ -4512,7 +4584,7 @@ declare class TeamsResource {
   updateTagline(teamSlug: string, tagline: TranslatableValue | null): Promise<IAppResponse<TeamPrivate>>;
   invite(teamSlug: string, payload: {
     email: string;
-    role: 'owner' | 'admin' | 'member';
+    role: UserRole;
   }): Promise<IAppResponse<void>>;
   inviteMember(teamSlug: string, email: string, role: UserRole): Promise<IAppResponse<void>>;
   removeMember(teamSlug: string, memberId: string): Promise<IAppResponse<void>>;
@@ -4527,6 +4599,7 @@ declare class TeamsResource {
   }): Promise<IAppResponse<TeamPlace[]>>;
   selectPlace(teamSlug: string, sourceId: string | null): Promise<IAppResponse<TeamPrivate>>;
   listPrivate(): Promise<IAppResponse<TeamPrivate[]>>;
+  accessConfig(): Promise<IAppResponse<TeamAccessConfig>>;
   getInviteByToken(token: string): Promise<IAppResponse<TeamInviteInfo>>;
   acceptInvite(slug: string): Promise<IAppResponse<void>>;
   usage(teamSlug: string): Promise<IAppResponse<TeamUsage>>;
@@ -4947,4 +5020,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 BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, type GuestCheckoutDraft, 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, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, type AuthConfirmCodeRequest, type AuthConfirmCodeResponse, type AuthNativeSessionResponse, type AuthPortalSessionResponse, AuthResource, type AuthSendCodeRequest, type BackendWarp, type BackendWarpBrand, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, type GuestBuyer, type GuestCheckoutDraft, 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, MissionsResource, NotificationsResource, OfficeResource, type OpenPortalSessionOptions, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type PlaceCheckoutOrderRequest, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, ReturnsResource, SegmentsResource, ServicesResource, ShippingResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, completePortalSession, createClient, createGuestCommerceStorage, formatOpeningHours, getAuthFragmentToken, isAllowedRedirectUrl, isPortalCallbackUrl, openPortalSession, sanitizePortalCallbackUrl };

package/dist/index.mjs

@@ -110,6 +110,34 @@ var HttpService = class {
 		};
 	}
 };
+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",
@@ -127,6 +155,47 @@ Object.values({
 	Sites: "sites",
 	Contracts: "contracts"
 });
+/** Permission string values — must match joai--api `UserPermission::value`. */
+const UserPermissions = {
+	BillingManage: "billing-manage",
+	TeamManage: "team-manage",
+	TeamView: "team-view",
+	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 {
@@ -353,6 +422,12 @@ const safeSet = (key, value) => {
 		localStorage.setItem(key, value);
 	} catch {}
 };
+const safeRemove = (key) => {
+	if (typeof localStorage === "undefined") return;
+	try {
+		localStorage.removeItem(key);
+	} catch {}
+};
 const parseGuestOrderAccess = (entry) => {
 	if (!entry || typeof entry !== "object") return null;
 	const record = entry;
@@ -392,19 +467,25 @@ function createGuestCommerceStorage(options) {
 		},
 		saveOrderAccess({ orderId, accessToken }) {
 			const key = orderAccessKey(options.namespace, orderId);
-			if (accessToken) safeSet(key, accessToken);
+			const resolvedToken = accessToken || safeGet(key);
+			if (resolvedToken) safeSet(key, resolvedToken);
 			const orders = readOrderList(options.namespace).filter((entry) => entry.orderId !== orderId);
 			orders.unshift({
 				orderId,
-				accessToken
+				accessToken: resolvedToken
 			});
-			safeSet(ordersKey(options.namespace), JSON.stringify(orders.slice(0, maxOrders)));
+			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));
 		},
 		readOrderAccess(orderId) {
 			return safeGet(orderAccessKey(options.namespace, orderId));
 		},
 		listOrderAccess() {
-			return readOrderList(options.namespace);
+			return readOrderList(options.namespace).map((entry) => ({
+				orderId: entry.orderId,
+				accessToken: entry.accessToken || safeGet(orderAccessKey(options.namespace, entry.orderId))
+			}));
 		}
 	};
 }
@@ -2298,6 +2379,9 @@ var TeamsResource = class {
 	listPrivate() {
 		return this.http.get("teams?me=true");
 	}
+	accessConfig() {
+		return this.http.get("teams/access-config");
+	}
 	getInviteByToken(token) {
 		return this.http.get(`teams/invite/${token}`);
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "4.2.0",
+  "version": "4.2.2",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",