@joai/sdk 4.0.0 → 4.2.0

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';
@@ -191,7 +191,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  billingAddress: BillingAddress | null;
   betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
@@ -245,6 +244,26 @@ type AffiliateTier = {
 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";
+  readonly VoiceDictation: "voice-dictation";
+  readonly Heartbeats: "heartbeats";
+  readonly Wallets: "wallets";
+  readonly Campaigns: "campaigns";
+  readonly News: "news";
+  readonly Sites: "sites";
+  readonly Contracts: "contracts";
+};
+type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
+//#endregion
 //#region src/team/types.d.ts
 type TeamCategory = (typeof teamCategories)[number];
 type TeamFeature = 'shop' | 'appointments';
@@ -270,7 +289,9 @@ type TeamMeta = {
   'stock.enabled'?: boolean;
   contactPropertyMaskWarp?: string;
   branding?: TeamBrand | null;
-  settings: Record<string, unknown>;
+  settings: Record<string, unknown> & {
+    apps?: NativeApp[];
+  };
 };
 type TeamPlace = {
   provider: 'google';
@@ -421,6 +442,160 @@ type AiCostsResponse = {
     };
   };
 }; //#endregion
+//#region src/address/types.d.ts
+type AddressType = 'shipping' | 'billing';
+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/types.d.ts
+type FulfillmentMethod = 'shipping' | 'pickup';
+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 FulfillmentStatus = 'pending' | 'ready_for_pickup' | 'shipped' | 'delivered' | 'cancelled';
+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 ReturnStatus = 'requested' | 'approved' | 'rejected' | 'received' | 'closed';
+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;
@@ -542,7 +717,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;
@@ -555,6 +730,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 = {
@@ -593,16 +769,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';
@@ -757,6 +923,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;
@@ -1408,7 +1585,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;
@@ -1486,6 +1664,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;
@@ -1525,7 +1704,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 = {
@@ -2869,6 +3048,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;
@@ -3079,11 +3418,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: {
@@ -3100,37 +3449,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;
@@ -3734,6 +4070,9 @@ declare class NotificationsResource {
   constructor(http: IHttpService);
   list(page?: number): Promise<IAppResponse<Notification[]>>;
   getUnread(): Promise<IAppResponse<Notification[]>>;
+  getDismissedPushKeys(): Promise<IAppResponse<{
+    notificationKeys: string[];
+  }>>;
   getSettings(): Promise<IAppResponse<NotificationSetting[]>>;
   updateSettings(notificationType: string, channel: NotificationChannel): Promise<IAppResponse<NotificationSetting[]>>;
   getAgentSettings(): Promise<IAppResponse<{
@@ -3756,7 +4095,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;
@@ -3774,6 +4113,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;
@@ -3782,7 +4135,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<{
@@ -3804,6 +4157,7 @@ declare class ProductsResource {
   constructor(http: IHttpService);
   list(params?: {
     includePrivate?: boolean;
+    team?: string;
   }): Promise<IAppResponse<Product[]>>;
   get(id: string): Promise<IAppResponse<Product>>;
   create(data: {
@@ -4061,10 +4415,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>>;
 }
@@ -4452,6 +4815,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;
@@ -4462,7 +4827,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;
@@ -4549,10 +4913,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,6 +110,23 @@ var HttpService = class {
 		};
 	}
 };
+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"
+});
 //#endregion
 //#region src/resources/agents.ts
 var AgentsResource = class {
@@ -201,6 +218,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) {
@@ -485,6 +703,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,
@@ -494,8 +715,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");
@@ -506,6 +727,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,
@@ -514,23 +738,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) {
@@ -1512,6 +1719,9 @@ var NotificationsResource = class {
 	getUnread() {
 		return this.http.get("notifications?unread");
 	}
+	getDismissedPushKeys() {
+		return this.http.get("notifications/dismissed-push-keys");
+	}
 	getSettings() {
 		return this.http.get("notifications/settings");
 	}
@@ -1540,6 +1750,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;
@@ -1547,11 +1758,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);
@@ -1562,8 +1773,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 });
@@ -1593,7 +1804,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) {
@@ -1902,16 +2116,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 });
@@ -2623,6 +2849,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);
@@ -2633,7 +2861,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);
@@ -2704,6 +2931,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",
@@ -2732,4 +3022,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.0.0",
+  "version": "4.2.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",