@joai/core 4.0.0 → 4.2.0

package/dist/index.d.mts

@@ -8,8 +8,8 @@ type SocialAuthProvider = 'github' | 'apple' | 'google' | 'x' | 'telegram' | 'sl
 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). */
-declare const AUTH_CODE_PARAM = "auth_code";
+/** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
+declare const NATIVE_AUTH_TOKEN_PARAM = "token";
 /** Login URL on the main app with a direct return URL (no mini-app callback). */
 declare const getLoginUrl: (env: AppEnv, returnTo: string, branding?: {
   team: string;
@@ -234,7 +234,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  billingAddress: BillingAddress | null;
   betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
@@ -306,6 +305,28 @@ type AffiliateStatus = 'pending' | 'approved' | 'rejected' | 'suspended' | 'demo
 //#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];
+declare const nativeAppSlugs: NativeApp[];
+declare const isNativeApp: (value: unknown) => value is NativeApp;
+//#endregion
 //#region src/team/types.d.ts
 type TeamCategory = (typeof teamCategories)[number];
 type TeamFeature = 'shop' | 'appointments';
@@ -331,7 +352,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';
@@ -501,6 +524,162 @@ 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;
@@ -630,7 +809,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;
@@ -643,6 +822,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 = {
@@ -689,16 +869,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';
@@ -873,6 +1043,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;
@@ -934,7 +1115,7 @@ type PurchaseResult = {
 };
 type PurchaseOptions = {
   forceProvider?: PaymentProvider;
-  billingAddress?: BillingAddress | null;
+  billingAddress?: AddressSnapshot | null;
   meta?: Record<string, string>;
 };
 //#endregion
@@ -1673,7 +1854,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;
@@ -1768,6 +1950,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;
@@ -1818,6 +2001,14 @@ type AppointmentRequest = {
   createdAt: string;
 };
 //#endregion
+//#region src/commerce/helpers.d.ts
+type CartLine = {
+  price: number;
+  quantity: number;
+};
+declare const cartLineTotal: <T extends CartLine>(items: T[]) => number;
+declare const isCompleteAddressInput: (address: Pick<AddressInput, "name" | "addressOne" | "city" | "zipCode" | "country">) => boolean;
+//#endregion
 //#region src/budget/types.d.ts
 type Budget = {
   id: number;
@@ -3780,4 +3971,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-export { AUTH_CODE_PARAM, Achievement, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSimple, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppEnv, AppFile, AppFileType, AppIngestion, AppSubscription, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, AuthUser, BillingAddress, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignCategory, CampaignChannel, CampaignCreatePayload, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactViewable, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultCodeMetadata, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, OgImageParams, OgImageType, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderSource, OrderStatus, OrderType, PaginatedResponse, Pass, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PersonaQuestionable, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, Swarm, Tag, TagType, Task, Team, TeamBrand, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, UserPrivate, UserRole, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, localize, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };
+export { Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, AddressType, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSimple, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppEnv, AppFile, AppFileType, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, AuthUser, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignCategory, CampaignChannel, CampaignCreatePayload, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, CartLine, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CheckoutSnapshot, CheckoutSnapshotRequest, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactViewable, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultCodeMetadata, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentLocation, FulfillmentMethod, FulfillmentStatus, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, NATIVE_AUTH_TOKEN_PARAM, NativeApp, NativeApps, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, OgImageParams, OgImageType, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderSource, OrderStatus, OrderType, PaginatedResponse, Pass, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PersonaQuestionable, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Return, ReturnStatus, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, Swarm, Tag, TagType, Task, Team, TeamBrand, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureUsage, TeamMember, TeamMeta, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, UserPrivate, UserRole, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, cartLineTotal, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, localize, nativeAppSlugs, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };

package/dist/index.mjs

@@ -58,8 +58,8 @@ const getSitesRootDomain = (env) => {
 const getSiteUrl = (env, teamSlug, brandSlug) => `https://${getSitesRootDomain(env)}/${teamSlug}/${brandSlug}`;
 //#endregion
 //#region src/auth/token.ts
-/** One-time native/deep-link handoff param (exchanged for a Bearer via API). */
-const AUTH_CODE_PARAM = "auth_code";
+/** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
+const NATIVE_AUTH_TOKEN_PARAM = "token";
 /** Login URL on the main app with a direct return URL (no mini-app callback). */
 const getLoginUrl = (env, returnTo, branding) => {
 	const params = new URLSearchParams({ redirect: returnTo });
@@ -282,6 +282,10 @@ function resolveWarpText(text, locale = "en") {
 	return text[locale] ?? text.en ?? Object.values(text)[0] ?? "";
 }
 //#endregion
+//#region src/commerce/helpers.ts
+const cartLineTotal = (items) => items.reduce((total, item) => total + item.price * item.quantity, 0);
+const isCompleteAddressInput = (address) => Boolean(address.name.trim() && address.addressOne.trim() && address.city.trim() && address.zipCode.trim() && address.country.trim());
+//#endregion
 //#region src/budget/types.ts
 const PeriodTypeLabels = {
 	0: "One-time",
@@ -396,4 +400,25 @@ const teamCategories = [
 	"leisure-tourism"
 ];
 //#endregion
-export { AUTH_CODE_PARAM, ContractCategoryDisplayNames, DefaultCodeMetadata, HttpService, JoaiUrls, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, SkillMediaBindingRole, SkillScope, SkillType, abbreviateNumber, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, localize, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };
+//#region src/team/apps.ts
+const NativeApps = {
+	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"
+};
+const nativeAppSlugs = Object.values(NativeApps);
+const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);
+//#endregion
+export { ContractCategoryDisplayNames, DefaultCodeMetadata, HttpService, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, SkillMediaBindingRole, SkillScope, SkillType, abbreviateNumber, cartLineTotal, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, localize, nativeAppSlugs, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/core",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "JoAi shared types, HTTP service, and config",
   "license": "MIT",
   "type": "module",