@joai/sdk 4.1.0 → 4.2.1

package/dist/index.d.mts

@@ -38,7 +38,7 @@ type SocialAuthProvider = 'github' | 'apple' | 'google' | 'x' | 'telegram' | 'sl
 //#region src/config/types.d.ts
 type AppEnv = 'mainnet' | 'testnet' | 'devnet' | 'local'; //#endregion
 //#region src/auth/token.d.ts
-/** One-time native/deep-link handoff param (exchanged for a Bearer via API). */
+/** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
 //#endregion
 //#region src/ingestion/types.d.ts
 type IngestionSourceType = 'note' | 'meeting' | 'article' | 'email' | 'chat' | 'post' | 'webhook';
@@ -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,8 +216,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  billingAddress: BillingAddress | null;
-  betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
 };
@@ -243,14 +266,13 @@ 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";
   readonly Shop: "shop";
   readonly SmartLinks: "smart-links";
   readonly Contacts: "contacts";
+  readonly Forms: "forms";
   readonly Appointments: "appointments";
   readonly Workspace: "workspace";
   readonly Meeting: "meeting";
@@ -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,6 +487,186 @@ 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 Address = {
+  id: string;
+  type: AddressType;
+  name: string;
+  company: string | null;
+  addressOne: string;
+  addressTwo: string | null;
+  city: string;
+  state: string | null;
+  zipCode: string;
+  country: string;
+  phone: string | null;
+  isDefault: boolean;
+  business: boolean;
+  vatId: string | null;
+  isEU: boolean;
+  isEEA: boolean;
+};
+type AddressSnapshot = Pick<Address, 'name' | 'company' | 'addressOne' | 'addressTwo' | 'city' | 'state' | 'zipCode' | 'country' | 'phone' | 'business' | 'vatId'>;
+type AddressInput = {
+  name: string;
+  addressOne: string;
+  city: string;
+  zipCode: string;
+  country: string;
+  type?: AddressType;
+  company?: string | null;
+  addressTwo?: string | null;
+  state?: string | null;
+  phone?: string | null;
+  business?: boolean;
+  vatId?: string | null;
+};
+type AddressCreatePayload = {
+  name: string;
+  country: string;
+  type?: AddressType;
+  email?: string | null;
+  company?: string | null;
+  addressOne?: string | null;
+  addressTwo?: string | null;
+  city?: string | null;
+  state?: string | null;
+  zipCode?: string | null;
+  vatId?: string | null;
+  phone?: string | null;
+  isDefault?: boolean;
+  contact?: string;
+  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 ShippingRate = {
+  id: number;
+  name: string;
+  price: number;
+  fee?: number;
+  freeShippingThreshold?: number | null;
+  minOrderValue?: number | null;
+  maxOrderValue?: number | null;
+  minWeight?: number | null;
+  maxWeight?: number | null;
+  estimatedMinDays?: number | null;
+  estimatedMaxDays?: number | null;
+  active?: boolean;
+  position?: number;
+};
+type CheckoutSnapshot = {
+  id: string;
+  fulfillmentMethod: FulfillmentMethod;
+  totals: {
+    subtotal: number;
+    shippingFee: number;
+    total: number;
+  };
+  expiresAt: string;
+  accessToken?: string | null;
+};
+type CheckoutSnapshotRequest = {
+  fulfillmentMethod: FulfillmentMethod;
+  items: {
+    id: string;
+    type: 'product' | 'service' | 'coupon';
+    quantity: number;
+  }[];
+  billingAddressId?: number | null;
+  shippingAddressId?: number | null;
+  billingAddress?: AddressInput;
+  shippingAddress?: AddressInput;
+  shippingRateId?: number | null;
+  fulfillmentLocationId?: number | null;
+};
+type ShippingZone = {
+  id: number;
+  name: string;
+  countries: string[];
+  postal_code_rules: string[] | null;
+  active: boolean;
+  position: number;
+  rates: ShippingRate[];
+};
+type FulfillmentLocation = {
+  id: number;
+  name: string;
+  address_id: number | null;
+  address: Address | null;
+  instructions: string | null;
+  active: boolean;
+};
+type Fulfillment = {
+  id: string;
+  orderId: number;
+  method: FulfillmentMethod;
+  status: FulfillmentStatus;
+  carrierCode: string | null;
+  trackingNumber: string | null;
+  trackingUrl: string | null;
+  items: {
+    orderItemId: number;
+    quantity: number;
+  }[];
+  shippedAt: string | null;
+  readyForPickupAt: string | null;
+  deliveredAt: string | null;
+};
+type Return = {
+  id: string;
+  orderId: number;
+  status: ReturnStatus;
+  reason: string;
+  merchantNote: string | null;
+  items: {
+    orderItemId: number;
+    quantity: number;
+    condition: string | null;
+  }[];
+  refundAmount: number | null;
+};
+type SubscriptionDelivery = {
+  fulfillmentMethod: FulfillmentMethod | null;
+  nextOrderAt: string | null;
+  pausedAt: string | null;
+  shippingAddress?: AddressSnapshot | null;
+  shippingRate?: Pick<ShippingRate, 'name' | 'price'> | null;
+  fulfillmentLocation?: {
+    name: string;
+    instructions: string | null;
+  } | null;
+}; //#endregion
 //#region src/json/types.d.ts
 type JsonValue = string | number | boolean | null | JsonValue[] | {
   [key: string]: JsonValue;
@@ -563,7 +788,7 @@ type OrderType = 'order' | 'quote';
 type SubscriptionStatus = 'active' | 'canceled' | 'past_due' | 'pending';
 type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly';
 type PricingModel = 'free' | 'one-time' | 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'per-run';
-type AppSubscription = {
+type Subscription = {
   id: string;
   orderId: string;
   teamId: string;
@@ -576,6 +801,7 @@ type AppSubscription = {
   meta: Record<string, JsonValue> | null;
   createdAt: string;
   updatedAt: string;
+  delivery?: SubscriptionDelivery | null;
 };
 type PaymentProvider = 'xmoney' | 'lemonsqueezy' | 'stripe' | 'stripe-connect' | 'mollie' | 'mollie-connect' | 'apple' | 'google' | 'blockchain' | 'offline';
 type PaymentAccount = {
@@ -614,16 +840,6 @@ type PlanExtra = {
   price: number;
   unitName: string;
 };
-type BillingAddress = {
-  name: string;
-  addressOne: string | null;
-  city: string | null;
-  state: string | null;
-  zipCode: string | null;
-  country: string;
-  vatId: string | null;
-  isEU: boolean;
-};
 type PlanInterval = 'weekly' | 'monthly' | 'yearly' | 'lifetime';
 type Plan = {
   resource: 'plan';
@@ -778,6 +994,17 @@ type Order = {
   paymentMode: string | null;
   linkVariationId: string | null;
   notes: string | null;
+  fulfillmentMethod?: FulfillmentMethod | null;
+  address?: AddressSnapshot | null;
+  shippingAddress?: AddressSnapshot | null;
+  shippingRate?: Pick<ShippingRate, 'name' | 'price' | 'estimatedMinDays' | 'estimatedMaxDays'> | null;
+  fulfillmentLocation?: {
+    name: string;
+    instructions?: string | null;
+  } | null;
+  shippingFee?: number;
+  fulfillments?: Fulfillment[];
+  subscription?: Subscription | null;
   configuration?: OrderConfigurationItem[];
   items: OrderItem[];
   coupon?: Coupon | null;
@@ -1429,7 +1656,8 @@ type Meeting = {
   captureMode: 'desktop_local' | null;
   transcriptUrl: string | null;
   summaryUrl: string | null;
-  participants?: MeetingParticipant[];
+  participants?: MeetingParticipant[]; /** The customer associated with an appointment booking, when available. */
+  contact?: Contact | null;
   speakerAssignments?: MeetingSpeakerAssignment[] | null;
   scheduledAt: string | null;
   calendarEventId: number | null;
@@ -1507,6 +1735,7 @@ type AppointmentPolicy = {
   bookingCapacity?: number | null;
   bookingCapacityUnit?: 'booking' | 'person' | null;
   requireApproval?: boolean | null;
+  notificationEmail?: string | null;
   sync?: AppointmentPolicySync | null;
   agent?: Agent | null;
   agentUuid?: string | null;
@@ -1546,7 +1775,7 @@ type AppointmentRequest = {
   configuration?: Configuration;
   createdAt: string;
 }; //#endregion
-//#region src/budget/types.d.ts
+//#region src/commerce/helpers.d.ts
 //#endregion
 //#region src/card/types.d.ts
 type Card = {
@@ -2890,6 +3119,166 @@ declare class AgentsResource {
   }): Promise<IAppResponse<unknown>>;
 }
 //#endregion
+//#region src/address/addresses.d.ts
+type AddressQuery = {
+  contact?: string;
+  team?: string;
+  type?: AddressType;
+};
+declare class AddressesResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(params?: AddressQuery): Promise<IAppResponse<Address[]>>;
+  get(params?: Omit<AddressQuery, 'type'>): Promise<IAppResponse<Address | null>>;
+  create(data: AddressCreatePayload): Promise<IAppResponse<Address>>;
+  update(id: string, data: AddressUpdatePayload): Promise<IAppResponse<Address>>;
+  delete(id: string): Promise<IAppResponse<void>>;
+}
+//#endregion
+//#region src/commerce/checkout.d.ts
+type PlaceCheckoutOrderRequest = CheckoutSnapshotRequest & {
+  guest?: {
+    name: string;
+    email: string;
+  };
+  notes?: string;
+  idempotencyKey?: string;
+  saveAddresses?: boolean;
+  sendConfirmation?: boolean;
+};
+declare class CheckoutResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  snapshot(team: string, data: CheckoutSnapshotRequest): Promise<IAppResponse<CheckoutSnapshot>>;
+  placeOrder(team: string, data: PlaceCheckoutOrderRequest): Promise<IAppResponse<Order>>;
+  locations(team: string): Promise<IAppResponse<FulfillmentLocation[]>>;
+  shippingRates(team: string, data: {
+    address: {
+      country: string;
+      zipCode?: string;
+    };
+    items: {
+      id: string;
+      type: 'product' | 'service' | 'coupon';
+      quantity: number;
+    }[];
+  }): Promise<IAppResponse<ShippingRate[]>>;
+}
+//#endregion
+//#region src/commerce/fulfillments.d.ts
+declare class FulfillmentsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(orderId: string): Promise<IAppResponse<Fulfillment[]>>;
+  create(orderId: string, data: {
+    items: {
+      orderItemId: number;
+      quantity: number;
+    }[];
+    carrierCode?: string;
+    trackingNumber?: string;
+    trackingUrl?: string;
+    status?: Fulfillment['status'];
+  }): Promise<IAppResponse<Fulfillment>>;
+  update(orderId: string, fulfillmentId: string, status: Fulfillment['status']): Promise<IAppResponse<Fulfillment>>;
+}
+//#endregion
+//#region src/commerce/returns.d.ts
+declare class ReturnsResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  list(orderId: string, accessToken?: string): Promise<IAppResponse<Return[]>>;
+  create(orderId: string, data: {
+    reason: string;
+    fulfillmentId?: number;
+    items: {
+      orderItemId: number;
+      quantity: number;
+      condition?: string;
+    }[];
+  }, accessToken?: string): Promise<IAppResponse<Return>>;
+  update(id: string, data: {
+    status: Exclude<ReturnStatus, 'requested'>;
+    merchantNote?: string;
+    refundAmount?: number;
+    resolution?: number;
+    returnShippingCostPayer?: number;
+  }): Promise<IAppResponse<Return>>;
+}
+//#endregion
+//#region src/commerce/shipping.d.ts
+type ZoneInput = {
+  name: string;
+  countries: string[];
+  postalCodeRules?: string[];
+  active?: boolean;
+  position?: number;
+};
+type RateInput = {
+  name: string;
+  price: number;
+  freeShippingThreshold?: number;
+  minOrderValue?: number;
+  maxOrderValue?: number;
+  minWeight?: number;
+  maxWeight?: number;
+  estimatedMinDays?: number;
+  estimatedMaxDays?: number;
+  active?: boolean;
+  position?: number;
+};
+declare class ShippingResource {
+  private readonly http;
+  constructor(http: IHttpService);
+  zones(team: string): Promise<IAppResponse<ShippingZone[]>>;
+  createZone(team: string, data: ZoneInput): Promise<IAppResponse<ShippingZone>>;
+  updateZone(team: string, zoneId: number, data: Partial<ZoneInput>): Promise<IAppResponse<ShippingZone>>;
+  deleteZone(team: string, zoneId: number): Promise<IAppResponse<void>>;
+  createRate(team: string, zoneId: number, data: RateInput): Promise<IAppResponse<ShippingRate>>;
+  locations(team: string): Promise<IAppResponse<FulfillmentLocation[]>>;
+  createLocation(team: string, data: {
+    name: string;
+    addressId?: number;
+    instructions?: string;
+    active?: boolean;
+  }): Promise<IAppResponse<FulfillmentLocation>>;
+}
+//#endregion
+//#region src/commerce/guest.d.ts
+type GuestOrderAccess = {
+  orderId: string;
+  accessToken: string | null;
+};
+type GuestCheckoutDraft<TCart = unknown> = {
+  cart: TCart;
+  fulfillmentMethod: FulfillmentMethod;
+  shippingRateId: number | null;
+  fulfillmentLocationId: number | null;
+};
+type GuestCommerceStorageOptions = {
+  namespace: string;
+  maxOrders?: number;
+};
+declare function createGuestCommerceStorage(options: GuestCommerceStorageOptions): {
+  saveCheckoutDraft<TCart>(draft: GuestCheckoutDraft<TCart>): void;
+  readCheckoutDraft<TCart>(fallback: GuestCheckoutDraft<TCart>): GuestCheckoutDraft<TCart>;
+  saveOrderAccess({
+    orderId,
+    accessToken
+  }: GuestOrderAccess): void;
+  readOrderAccess(orderId: string): string | null;
+  listOrderAccess(): GuestOrderAccess[];
+};
+//#endregion
+//#region src/commerce/index.d.ts
+declare class CommerceResource {
+  readonly checkout: CheckoutResource;
+  readonly shipping: ShippingResource;
+  readonly fulfillments: FulfillmentsResource;
+  readonly returns: ReturnsResource;
+  constructor(http: IHttpService);
+}
+//#endregion
 //#region src/resources/alerts.d.ts
 declare class AlertsResource {
   private readonly http;
@@ -3100,11 +3489,21 @@ type NativeSocialAuthProvider = Extract<SocialAuthProvider, 'apple' | 'google'>;
 type AuthSendCodeRequest = {
   name: string;
   phone?: string;
+  email: string;
+  team?: string;
+  table?: string;
+};
+type AuthConfirmCodeRequest = {
+  code: string;
+  phone?: string;
   email?: string;
   team?: string;
   table?: string;
 };
-type AuthVerifyResponse = {
+type AuthConfirmCodeResponse = {
+  authUrl: string;
+};
+type AuthNativeSessionResponse = {
   token: string;
   user: AuthUser;
   team: {
@@ -3121,37 +3520,24 @@ type AuthLoginResponse = {
 type AuthApiTokenResponse = {
   plainTextToken: string;
 };
+type AuthPortalSessionResponse = {
+  url: string;
+};
 declare class AuthResource {
   private http;
   constructor(http: IHttpService);
   sendCode(data: AuthSendCodeRequest): Promise<IAppResponse<void>>;
+  confirmCode(data: AuthConfirmCodeRequest): Promise<IAppResponse<AuthConfirmCodeResponse>>;
   requestEmail(email: string, redirect?: string): Promise<IAppResponse<AuthLoginResponse>>;
   loginWithSocialAccessToken(provider: NativeSocialAuthProvider, accessToken: string): Promise<IAppResponse<AuthLoginResponse>>;
-  verify(token: string): Promise<IAppResponse<AuthVerifyResponse>>;
+  exchangeNativeSession(token: string): Promise<IAppResponse<AuthNativeSessionResponse>>;
   me(): Promise<IAppResponse<AuthUser>>;
   logout(): Promise<IAppResponse<void>>;
   createApiToken(): Promise<IAppResponse<AuthApiTokenResponse>>;
+  createPortalSession(redirect: string): Promise<IAppResponse<AuthPortalSessionResponse>>;
   verifyWallet(accessToken: string, withMobileApiToken?: boolean): Promise<IAppResponse<UserPrivate>>;
 }
 //#endregion
-//#region src/resources/billing-addresses.d.ts
-declare class BillingAddressesResource {
-  private readonly http;
-  constructor(http: IHttpService);
-  get(contact?: string, team?: string): Promise<IAppResponse<BillingAddress | null>>;
-  store(data: {
-    name: string;
-    addressOne?: string;
-    city?: string;
-    state?: string;
-    zipCode?: string;
-    country: string;
-    vatId?: string;
-    contact?: string;
-    team?: string;
-  }): Promise<IAppResponse<BillingAddress>>;
-}
-//#endregion
 //#region src/resources/billing.d.ts
 type IapReceipt = {
   productId: string;
@@ -3780,7 +4166,7 @@ declare class OrdersResource {
   private readonly http;
   constructor(http: IHttpService);
   list(team: string): Promise<IAppResponse<Order[]>>;
-  get(id: string): Promise<IAppResponse<Order>>;
+  get(id: string, accessToken?: string): Promise<IAppResponse<Order>>;
   create(data: {
     contactId?: string;
     notes?: string;
@@ -3798,6 +4184,20 @@ declare class OrdersResource {
       quantity: number;
       configuration?: Configuration;
     }[];
+    fulfillmentMethod?: FulfillmentMethod;
+    snapshotId?: string;
+    snapshotAccessToken?: string;
+    billingAddressId?: number;
+    shippingAddressId?: number;
+    billingAddress?: AddressInput;
+    shippingAddress?: AddressInput;
+    shippingRateId?: number;
+    fulfillmentLocationId?: number;
+    idempotencyKey?: string;
+    guest?: {
+      name: string;
+      email: string;
+    };
   }): Promise<IAppResponse<Order>>;
   update(id: string, data: {
     status?: OrderStatus;
@@ -3806,7 +4206,7 @@ declare class OrdersResource {
   }): Promise<IAppResponse<Order>>;
   convertToOrder(id: string): Promise<IAppResponse<Order>>;
   delete(id: string): Promise<IAppResponse<void>>;
-  pay(id: string, provider?: PaymentProvider): Promise<IAppResponse<{
+  pay(id: string, provider?: PaymentProvider, accessToken?: string): Promise<IAppResponse<{
     url: string;
   }>>;
   notify(id: string, type?: string): Promise<IAppResponse<{
@@ -3828,6 +4228,7 @@ declare class ProductsResource {
   constructor(http: IHttpService);
   list(params?: {
     includePrivate?: boolean;
+    team?: string;
   }): Promise<IAppResponse<Product[]>>;
   get(id: string): Promise<IAppResponse<Product>>;
   create(data: {
@@ -4085,10 +4486,19 @@ declare class KvResource {
 declare class SubscriptionsResource {
   private readonly http;
   constructor(http: IHttpService);
-  list(team: string): Promise<IAppResponse<AppSubscription[]>>;
-  get(id: string): Promise<IAppResponse<AppSubscription>>;
-  cancel(id: string): Promise<IAppResponse<AppSubscription>>;
-  resume(id: string): Promise<IAppResponse<AppSubscription>>;
+  list(team?: string): Promise<IAppResponse<Subscription[]>>;
+  get(id: string): Promise<IAppResponse<Subscription>>;
+  cancel(id: string, team: string): Promise<IAppResponse<Subscription>>;
+  resume(id: string, team: string): Promise<IAppResponse<Subscription>>;
+  updateDelivery(id: string, data: {
+    fulfillmentMethod: 'shipping' | 'pickup';
+    shippingAddressId?: number | null;
+    shippingRateId?: number | null;
+    fulfillmentLocationId?: number | null;
+  }): Promise<IAppResponse<Subscription>>;
+  skip(id: string): Promise<IAppResponse<Subscription>>;
+  pause(id: string): Promise<IAppResponse<Subscription>>;
+  resumeDelivery(id: string): Promise<IAppResponse<Subscription>>;
   cancelPlan(team: string): Promise<IAppResponse<void>>;
   resumePlan(team: string): Promise<IAppResponse<void>>;
 }
@@ -4147,7 +4557,7 @@ type TeamMutationPayload = {
   settings?: Record<string, JsonValue>;
   emails?: {
     email: string;
-    role: 'owner' | 'admin' | 'member';
+    role: UserRole;
   }[];
   website?: string | null;
   phone?: string | null;
@@ -4173,7 +4583,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>>;
@@ -4188,6 +4598,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>>;
@@ -4476,6 +4887,8 @@ declare class JoAiClient {
   isReady: boolean;
   hasApiToken: boolean;
   readonly agents: AgentsResource;
+  readonly addresses: AddressesResource;
+  readonly commerce: CommerceResource;
   readonly alerts: AlertsResource;
   readonly apiTokens: ApiTokensResource;
   readonly characters: CharactersResource;
@@ -4486,7 +4899,6 @@ declare class JoAiClient {
   readonly appointments: AppointmentsResource;
   readonly auth: AuthResource;
   readonly billing: BillingResource;
-  readonly billingAddresses: BillingAddressesResource;
   readonly blueprints: BlueprintsResource;
   readonly cards: CardsResource;
   readonly cart: CartsResource;
@@ -4573,10 +4985,38 @@ declare class CachedHttpService implements IHttpService {
   private bust;
 }
 //#endregion
+//#region src/auth/portal.d.ts
+declare const getAuthFragmentToken: (url: string) => string | null;
+declare const isPortalCallbackUrl: (url: string, env?: AppEnv) => boolean;
+declare const sanitizePortalCallbackUrl: (url: string | null | undefined, env?: AppEnv) => string | null;
+declare const isAllowedRedirectUrl: (redirect: string, allowedOrigins: string[]) => boolean;
+declare const completePortalSession: (callbackUrl: string, fetcher?: typeof fetch) => Promise<boolean>;
+type PortalClient = {
+  auth: {
+    createPortalSession: (redirect: string) => Promise<IAppResponse<AuthPortalSessionResponse>>;
+  };
+};
+type OpenPortalSessionOptions = {
+  client: PortalClient;
+  redirect: string;
+  allowedOrigins: string[];
+  env?: AppEnv;
+  fetcher?: typeof fetch;
+  onNavigate?: (redirect: string) => void;
+};
+declare const openPortalSession: ({
+  client,
+  redirect,
+  allowedOrigins,
+  env,
+  fetcher,
+  onNavigate
+}: OpenPortalSessionOptions) => Promise<boolean>;
+//#endregion
 //#region src/resources/distribution.d.ts
 declare class DistributionResource {
   getBrandSiteConfig(env: AppEnv, brandSlug: string): Promise<BrandSiteConfig | null>;
   private fetchDistribution;
 }
 //#endregion
-export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BillingAddressesResource, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, type CreateHookPayload, type CreateInboundHookPayload, type CreateInternalHookPayload, type CreateWarpLinkedHookPayload, type CreateWebHookPayload, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, 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 OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, type WebHookTriggerEvent, WorkspaceResource, createClient, formatOpeningHours };
+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 };

package/dist/index.mjs

@@ -110,11 +110,40 @@ 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",
 	SmartLinks: "smart-links",
 	Contacts: "contacts",
+	Forms: "forms",
 	Appointments: "appointments",
 	Workspace: "workspace",
 	Meeting: "meeting",
@@ -126,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 {
@@ -217,6 +287,207 @@ var AgentsResource = class {
 	}
 };
 //#endregion
+//#region src/address/addresses.ts
+var AddressesResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(params) {
+		return this.http.get(`addresses${query(params)}`);
+	}
+	get(params) {
+		return this.list({
+			...params,
+			type: "billing"
+		}).then((response) => ({
+			...response,
+			data: response.ok ? response.data[0] ?? null : null
+		}));
+	}
+	create(data) {
+		return this.http.post("addresses", data);
+	}
+	update(id, data) {
+		return this.http.patch(`addresses/${id}`, data);
+	}
+	delete(id) {
+		return this.http.delete(`addresses/${id}`);
+	}
+};
+const query = (params) => {
+	const search = new URLSearchParams();
+	if (params?.contact) search.set("contact", params.contact);
+	if (params?.team) search.set("team", params.team);
+	if (params?.type) search.set("type", params.type);
+	const value = search.toString();
+	return value ? `?${value}` : "";
+};
+//#endregion
+//#region src/commerce/checkout.ts
+var CheckoutResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	snapshot(team, data) {
+		return this.http.post(`shops/${encodeURIComponent(team)}/checkout/snapshots`, data);
+	}
+	placeOrder(team, data) {
+		return this.http.post(`shops/${encodeURIComponent(team)}/checkout/orders`, data);
+	}
+	locations(team) {
+		return this.http.get(`shops/${encodeURIComponent(team)}/checkout/fulfillment-locations`);
+	}
+	shippingRates(team, data) {
+		return this.http.post(`shops/${encodeURIComponent(team)}/checkout/shipping-rates`, data);
+	}
+};
+//#endregion
+//#region src/commerce/fulfillments.ts
+var FulfillmentsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(orderId) {
+		return this.http.get(`orders/${orderId}/fulfillments`);
+	}
+	create(orderId, data) {
+		return this.http.post(`orders/${orderId}/fulfillments`, data);
+	}
+	update(orderId, fulfillmentId, status) {
+		return this.http.patch(`orders/${orderId}/fulfillments/${fulfillmentId}`, { status });
+	}
+};
+//#endregion
+//#region src/commerce/returns.ts
+const orderAccessHeaders$1 = (accessToken) => accessToken ? { headers: { "X-Order-Access-Token": accessToken } } : void 0;
+var ReturnsResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	list(orderId, accessToken) {
+		return this.http.get(`orders/${orderId}/returns`, orderAccessHeaders$1(accessToken));
+	}
+	create(orderId, data, accessToken) {
+		return this.http.post(`orders/${orderId}/returns`, data, orderAccessHeaders$1(accessToken));
+	}
+	update(id, data) {
+		return this.http.patch(`returns/${id}`, data);
+	}
+};
+//#endregion
+//#region src/commerce/shipping.ts
+var ShippingResource = class {
+	constructor(http) {
+		this.http = http;
+	}
+	zones(team) {
+		return this.http.get(`teams/${team}/shipping-zones`);
+	}
+	createZone(team, data) {
+		return this.http.post(`teams/${team}/shipping-zones`, data);
+	}
+	updateZone(team, zoneId, data) {
+		return this.http.patch(`teams/${team}/shipping-zones/${zoneId}`, data);
+	}
+	deleteZone(team, zoneId) {
+		return this.http.delete(`teams/${team}/shipping-zones/${zoneId}`);
+	}
+	createRate(team, zoneId, data) {
+		return this.http.post(`teams/${team}/shipping-zones/${zoneId}/rates`, data);
+	}
+	locations(team) {
+		return this.http.get(`teams/${team}/fulfillment-locations`);
+	}
+	createLocation(team, data) {
+		return this.http.post(`teams/${team}/fulfillment-locations`, data);
+	}
+};
+//#endregion
+//#region src/commerce/guest.ts
+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) => {
+	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 parseGuestOrderAccess = (entry) => {
+	if (!entry || typeof entry !== "object") return null;
+	const record = entry;
+	if (typeof record.orderId !== "string") return null;
+	if (record.accessToken !== null && typeof record.accessToken !== "string") return null;
+	return {
+		orderId: record.orderId,
+		accessToken: record.accessToken ?? null
+	};
+};
+const readOrderList = (namespace) => {
+	try {
+		const saved = JSON.parse(safeGet(ordersKey(namespace)) || "[]");
+		if (!Array.isArray(saved)) return [];
+		return saved.map(parseGuestOrderAccess).filter((entry) => entry !== null);
+	} catch {
+		return [];
+	}
+};
+function createGuestCommerceStorage(options) {
+	const maxOrders = options.maxOrders ?? 10;
+	return {
+		saveCheckoutDraft(draft) {
+			safeSet(checkoutKey(options.namespace), JSON.stringify(draft));
+		},
+		readCheckoutDraft(fallback) {
+			try {
+				const saved = JSON.parse(safeGet(checkoutKey(options.namespace)) || "");
+				return {
+					...fallback,
+					...saved,
+					cart: Array.isArray(saved.cart) ? saved.cart : fallback.cart
+				};
+			} catch {
+				return fallback;
+			}
+		},
+		saveOrderAccess({ orderId, accessToken }) {
+			const key = orderAccessKey(options.namespace, orderId);
+			if (accessToken) safeSet(key, accessToken);
+			const orders = readOrderList(options.namespace).filter((entry) => entry.orderId !== orderId);
+			orders.unshift({
+				orderId,
+				accessToken
+			});
+			safeSet(ordersKey(options.namespace), JSON.stringify(orders.slice(0, maxOrders)));
+		},
+		readOrderAccess(orderId) {
+			return safeGet(orderAccessKey(options.namespace, orderId));
+		},
+		listOrderAccess() {
+			return readOrderList(options.namespace);
+		}
+	};
+}
+//#endregion
+//#region src/commerce/index.ts
+var CommerceResource = class {
+	constructor(http) {
+		this.checkout = new CheckoutResource(http);
+		this.shipping = new ShippingResource(http);
+		this.fulfillments = new FulfillmentsResource(http);
+		this.returns = new ReturnsResource(http);
+	}
+};
+//#endregion
 //#region src/resources/alerts.ts
 var AlertsResource = class {
 	constructor(http) {
@@ -501,6 +772,9 @@ var AuthResource = class {
 	sendCode(data) {
 		return this.http.post("auth/send-code", data);
 	}
+	confirmCode(data) {
+		return this.http.post("auth/confirm-code", data);
+	}
 	requestEmail(email, redirect) {
 		return this.http.post("auth/email/request", {
 			email,
@@ -510,8 +784,8 @@ var AuthResource = class {
 	loginWithSocialAccessToken(provider, accessToken) {
 		return this.http.post(`auth/social/${provider}/login`, { accessToken });
 	}
-	verify(token) {
-		return this.http.get("auth/verify?token=" + token);
+	exchangeNativeSession(token) {
+		return this.http.post("auth/verify", { token });
 	}
 	me() {
 		return this.http.get("auth/me");
@@ -522,6 +796,9 @@ var AuthResource = class {
 	createApiToken() {
 		return this.http.post("auth/api-tokens");
 	}
+	createPortalSession(redirect) {
+		return this.http.post("auth/portal-sessions", { redirect });
+	}
 	verifyWallet(accessToken, withMobileApiToken) {
 		return this.http.post("auth/wallet/verify", {
 			accessToken,
@@ -530,23 +807,6 @@ var AuthResource = class {
 	}
 };
 //#endregion
-//#region src/resources/billing-addresses.ts
-var BillingAddressesResource = class {
-	constructor(http) {
-		this.http = http;
-	}
-	get(contact, team) {
-		const params = new URLSearchParams();
-		if (contact) params.set("contact", contact);
-		if (team) params.set("team", team);
-		const qs = params.toString();
-		return this.http.get(`billing/addresses${qs ? "?" + qs : ""}`);
-	}
-	store(data) {
-		return this.http.post("billing/addresses", data);
-	}
-};
-//#endregion
 //#region src/resources/billing.ts
 var BillingResource = class {
 	constructor(http) {
@@ -1559,6 +1819,7 @@ var OfficeResource = class {
 };
 //#endregion
 //#region src/resources/orders.ts
+const orderAccessHeaders = (accessToken) => accessToken ? { headers: { "X-Order-Access-Token": accessToken } } : void 0;
 var OrdersResource = class {
 	constructor(http) {
 		this.http = http;
@@ -1566,11 +1827,11 @@ var OrdersResource = class {
 	list(team) {
 		return this.http.get("orders", { headers: { "X-Team": team } });
 	}
-	get(id) {
-		return this.http.get(`orders/${id}`);
+	get(id, accessToken) {
+		return this.http.get(`orders/${id}`, orderAccessHeaders(accessToken));
 	}
 	create(data) {
-		return this.http.post("orders", data, { headers: { "X-Team": data.team } });
+		return this.http.post("orders", data);
 	}
 	update(id, data) {
 		return this.http.put(`orders/${id}`, data);
@@ -1581,8 +1842,8 @@ var OrdersResource = class {
 	delete(id) {
 		return this.http.delete(`orders/${id}`);
 	}
-	pay(id, provider) {
-		return this.http.post(`orders/${id}/pay`, provider ? { provider } : {});
+	pay(id, provider, accessToken) {
+		return this.http.post(`orders/${id}/pay`, provider ? { provider } : {}, orderAccessHeaders(accessToken));
 	}
 	notify(id, type = "confirmation") {
 		return this.http.post(`orders/${id}/notify`, { type });
@@ -1612,7 +1873,10 @@ var ProductsResource = class {
 	}
 	list(params) {
 		let url = "products";
-		if (params?.includePrivate) url += "?includePrivate=1";
+		const search = new URLSearchParams();
+		if (params?.includePrivate) search.set("includePrivate", "1");
+		if (params?.team) search.set("team", params.team);
+		if (search.size) url += `?${search.toString()}`;
 		return this.http.get(url);
 	}
 	get(id) {
@@ -1921,16 +2185,28 @@ var SubscriptionsResource = class {
 		this.http = http;
 	}
 	list(team) {
-		return this.http.get("subscriptions");
+		return team ? this.http.get("subscriptions", { headers: { "X-Team": team } }) : this.http.get("subscriptions");
 	}
 	get(id) {
 		return this.http.get(`subscriptions/${id}`);
 	}
-	cancel(id) {
-		return this.http.post(`subscriptions/${id}/cancel`);
+	cancel(id, team) {
+		return this.http.post(`subscriptions/${id}/cancel`, void 0, { headers: { "X-Team": team } });
 	}
-	resume(id) {
-		return this.http.post(`subscriptions/${id}/resume`);
+	resume(id, team) {
+		return this.http.post(`subscriptions/${id}/resume`, void 0, { headers: { "X-Team": team } });
+	}
+	updateDelivery(id, data) {
+		return this.http.patch(`subscriptions/${id}/delivery`, data);
+	}
+	skip(id) {
+		return this.http.post(`subscriptions/${id}/skip`);
+	}
+	pause(id) {
+		return this.http.post(`subscriptions/${id}/pause`);
+	}
+	resumeDelivery(id) {
+		return this.http.post(`subscriptions/${id}/resume-delivery`);
 	}
 	cancelPlan(team) {
 		return this.http.post("billing/plans/cancel", { team });
@@ -2091,6 +2367,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}`);
 	}
@@ -2642,6 +2921,8 @@ var JoAiClient = class {
 		const cache = config.cache;
 		this.http = cache?.enabled !== false ? new CachedHttpService(http, cache?.overrides, cache?.defaultTtl) : http;
 		this.agents = new AgentsResource(this.http);
+		this.addresses = new AddressesResource(this.http);
+		this.commerce = new CommerceResource(this.http);
 		this.alerts = new AlertsResource(this.http);
 		this.apiTokens = new ApiTokensResource(this.http);
 		this.characters = new CharactersResource(this.http);
@@ -2652,7 +2933,6 @@ var JoAiClient = class {
 		this.appointments = new AppointmentsResource(this.http, config);
 		this.auth = new AuthResource(this.http);
 		this.billing = new BillingResource(this.http);
-		this.billingAddresses = new BillingAddressesResource(this.http);
 		this.blueprints = new BlueprintsResource(this.http);
 		this.cards = new CardsResource(this.http);
 		this.cart = new CartsResource(this.http);
@@ -2723,6 +3003,69 @@ function createClient(config) {
 	return new JoAiClient(config);
 }
 //#endregion
+//#region src/auth/portal.ts
+const getAuthFragmentToken = (url) => {
+	try {
+		return new URLSearchParams(new URL(url).hash.slice(1)).get("token");
+	} catch {
+		return null;
+	}
+};
+const isPortalCallbackUrl = (url, env = "mainnet") => {
+	try {
+		const callbackUrl = new URL(url);
+		const apiCallback = new URL("/v1/auth/callback", getApiBaseUrl(env));
+		return callbackUrl.origin === apiCallback.origin && callbackUrl.pathname === apiCallback.pathname && !callbackUrl.search && Boolean(getAuthFragmentToken(url));
+	} catch {
+		return false;
+	}
+};
+const sanitizePortalCallbackUrl = (url, env = "mainnet") => url && isPortalCallbackUrl(url, env) ? url : null;
+const isAllowedRedirectUrl = (redirect, allowedOrigins) => {
+	try {
+		return allowedOrigins.includes(new URL(redirect).origin);
+	} catch {
+		return false;
+	}
+};
+const completePortalSession = async (callbackUrl, fetcher = fetch) => {
+	const token = getAuthFragmentToken(callbackUrl);
+	if (!token) return false;
+	try {
+		const callback = new URL(callbackUrl);
+		const response = await fetcher(`${callback.origin}${callback.pathname}`, {
+			method: "POST",
+			headers: {
+				Accept: "application/json",
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify({ token }),
+			credentials: "include",
+			redirect: "manual"
+		});
+		return response.ok || response.type === "opaqueredirect";
+	} catch {
+		return false;
+	}
+};
+const openPortalSession = async ({ client, redirect, allowedOrigins, env = "mainnet", fetcher = fetch, onNavigate }) => {
+	if (!isAllowedRedirectUrl(redirect, allowedOrigins)) return false;
+	const response = await client.auth.createPortalSession(redirect);
+	const callbackUrl = sanitizePortalCallbackUrl(response.ok ? response.data?.url : null, env);
+	if (!callbackUrl) return false;
+	if (!await completePortalSession(callbackUrl, fetcher)) return false;
+	if (!isAllowedRedirectUrl(redirect, allowedOrigins)) return false;
+	if (onNavigate) {
+		onNavigate(redirect);
+		return true;
+	}
+	if (typeof window !== "undefined") {
+		window.location.assign(redirect);
+		return true;
+	}
+	return false;
+};
+//#endregion
 //#region src/resources/distribution.ts
 const DISTRIBUTION_URLS = {
 	local: "https://raw.githubusercontent.com/JoAiHQ/warps/refs/heads/dev/catalog/devnet/distribution.json",
@@ -2751,4 +3094,4 @@ var DistributionResource = class {
 	}
 };
 //#endregion
-export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, BillingAddressesResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MissionsResource, NotificationsResource, OfficeResource, OrdersResource, PersonaResource, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WorkspaceResource, createClient, formatOpeningHours };
+export { AddressesResource, AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, BillingResource, BlueprintsResource, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, CheckoutResource, CommerceResource, ContactsResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, FulfillmentsResource, GoalsResource, HooksResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, 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 };

package/package.json

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