@joai/core 4.1.0 → 4.3.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;
@@ -197,8 +197,50 @@ type WalletList = Partial<Record<WarpChainName, {
   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];
+declare const userPermissionValues: [UserPermission, ...UserPermission[]];
+declare const hasPermission: (granted: readonly UserPermission[] | undefined, required: UserPermission) => boolean;
+declare const hasAllPermissions: (granted: readonly UserPermission[] | undefined, required: readonly UserPermission[]) => boolean;
+declare const hasAnyPermissions: (granted: readonly UserPermission[] | undefined, required: readonly UserPermission[]) => boolean;
+declare const hasTeamPermission: (team: {
+  permissions?: UserPermission[];
+} | null | undefined, permission: UserPermission) => boolean;
+declare const hasAllTeamPermissions: (team: {
+  permissions?: UserPermission[];
+} | null | undefined, permissions: UserPermission[]) => boolean;
+//#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];
+declare const userRoleValues: [UserRole, ...UserRole[]];
+declare const isUserRole: (value: string) => value is UserRole;
+/** Roles assignable via team invite — owner is never inviteable. Must match API `RolePermissions::inviteable()`. */
+declare const InviteableTeamRoles: readonly ["member", "developer", "admin"];
+declare const DefaultInviteTeamRole: "member";
+declare const inviteableTeamRoles: () => UserRole[];
+declare const defaultInviteTeamRole: () => UserRole;
+//#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 = {
@@ -234,8 +276,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  billingAddress: BillingAddress | null;
-  betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
 };
@@ -303,15 +343,13 @@ 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";
@@ -327,6 +365,38 @@ type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 declare const nativeAppSlugs: NativeApp[];
 declare const isNativeApp: (value: unknown) => value is NativeApp;
 //#endregion
+//#region src/access/team-access.d.ts
+type TeamFeatureArea = 'nativeApps' | 'agentSettings' | 'teamSettings' | 'developerHub' | 'areas' | 'commerce';
+type GatedFeatureArea = Exclude<TeamFeatureArea, 'nativeApps'>;
+/** 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>>;
+};
+type TeamWithAccess = {
+  access?: TeamFeatureAccess | null;
+  accessCatalog?: TeamAccessCatalog | null;
+};
+declare const resolveAccessCatalog: (team: TeamWithAccess | null | undefined, accessConfig: TeamAccessConfig | null | undefined) => TeamAccessCatalog | null | undefined;
+declare const isTeamFeatureGated: (catalog: TeamAccessCatalog | null | undefined, area: GatedFeatureArea, key: string) => boolean;
+declare const isNativeAppGated: (catalog: TeamAccessCatalog | null | undefined, app: NativeApp) => boolean;
+declare const isTeamFeatureAccessible: (team: TeamWithAccess | null | undefined, area: GatedFeatureArea, key: string) => boolean;
+declare const isTeamFeatureLocked: (team: TeamWithAccess | null | undefined, catalog: TeamAccessCatalog | null | undefined, area: GatedFeatureArea, key: string) => boolean;
+declare const isNativeAppAccessible: (team: TeamWithAccess | null | undefined, app: NativeApp) => boolean;
+declare const isNativeAppLocked: (team: TeamWithAccess | null | undefined, catalog: TeamAccessCatalog | null | undefined, app: NativeApp) => 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';
@@ -438,6 +508,10 @@ type TeamPrivate = {
   category: TeamCategory;
   createdAt: string;
   justCreated: boolean;
+  role?: UserRole | null;
+  permissions?: UserPermission[];
+  access?: TeamFeatureAccess;
+  accessCatalog?: TeamAccessCatalog;
 };
 type ByokProviderConfig = {
   apiKey?: string;
@@ -524,6 +598,200 @@ 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];
+declare const addressTypeValues: [AddressType, ...AddressType[]];
+//#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 fulfillmentStatusValues: [FulfillmentStatus, ...FulfillmentStatus[]];
+declare const FulfillmentMethods: {
+  readonly Shipping: "shipping";
+  readonly Pickup: "pickup";
+};
+type FulfillmentMethod = (typeof FulfillmentMethods)[keyof typeof FulfillmentMethods];
+declare const fulfillmentMethodValues: [FulfillmentMethod, ...FulfillmentMethod[]];
+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];
+declare const returnStatusValues: [ReturnStatus, ...ReturnStatus[]];
+declare const ReturnUpdateStatuses: {
+  readonly Approved: "approved";
+  readonly Rejected: "rejected";
+  readonly Received: "received";
+  readonly Closed: "closed";
+};
+type ReturnUpdateStatus = (typeof ReturnUpdateStatuses)[keyof typeof ReturnUpdateStatuses];
+declare const returnUpdateStatusValues: [ReturnUpdateStatus, ...ReturnUpdateStatus[]];
+//#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;
@@ -653,7 +921,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;
@@ -666,6 +934,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 = {
@@ -712,16 +981,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';
@@ -896,6 +1155,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;
@@ -957,7 +1227,7 @@ type PurchaseResult = {
 };
 type PurchaseOptions = {
   forceProvider?: PaymentProvider;
-  billingAddress?: BillingAddress | null;
+  billingAddress?: AddressSnapshot | null;
   meta?: Record<string, string>;
 };
 //#endregion
@@ -1696,7 +1966,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;
@@ -1791,6 +2062,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;
@@ -1841,6 +2113,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;
@@ -3630,6 +3910,32 @@ type SchedulePreset = {
   description: string;
 };
 //#endregion
+//#region src/access/mcp-access.d.ts
+/** Preset names — must match joai--api `PermissionPreset::value`. */
+declare const PermissionPresetNames: {
+  readonly TeamManage: "teamManage";
+  readonly TeamView: "teamView";
+  readonly BillingManage: "billingManage";
+  readonly AgentTooling: "agentTooling";
+  readonly SecretView: "secretView";
+  readonly SecretManage: "secretManage";
+  readonly TeamMemberInvite: "teamMemberInvite";
+  readonly TeamMemberRemove: "teamMemberRemove";
+  readonly AgentWalletManage: "agentWalletManage";
+  readonly SwarmCreate: "swarmCreate";
+};
+type PermissionPresetName = (typeof PermissionPresetNames)[keyof typeof PermissionPresetNames];
+/** Permission presets for MCP tool gating — not used by the PWA (UI reads `team.access` from API). */
+type AppAccessRule = {
+  permissions?: UserPermission[];
+  permissionsAny?: UserPermission[];
+};
+declare const permissionPresetRules: Record<PermissionPresetName, AppAccessRule>;
+declare const TeamManageAccess: AppAccessRule;
+declare const TeamViewAccess: AppAccessRule;
+declare const AgentToolingAccess: AppAccessRule;
+declare const BillingManageAccess: AppAccessRule;
+//#endregion
 //#region src/wallet-chains/types.d.ts
 type RampProvider = 'coinbase' | 'xmoney' | 'moonpay';
 type RampProviderInfo = {
@@ -3803,4 +4109,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, 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, 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, isNativeApp, localize, nativeAppSlugs, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };
+export { Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, type AddressType, AddressTypes, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSimple, AgentToolingAccess, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, AuthUser, BillingManageAccess, 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, DefaultInviteTeamRole, 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, type FulfillmentMethod, FulfillmentMethods, type FulfillmentStatus, FulfillmentStatuses, 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, InviteableTeamRoles, 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, PermissionPresetName, PermissionPresetNames, 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, type ReturnStatus, ReturnStatuses, ReturnUpdateStatus, ReturnUpdateStatuses, 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, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TeamViewAccess, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, type UserPermission, UserPermissions, UserPrivate, type UserRole, UserRoles, 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, addressTypeValues, cartLineTotal, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, 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,47 @@ function resolveWarpText(text, locale = "en") {
 	return text[locale] ?? text.en ?? Object.values(text)[0] ?? "";
 }
 //#endregion
+//#region src/address/enums.ts
+const AddressTypes = {
+	Billing: "billing",
+	Shipping: "shipping"
+};
+const addressTypeValues = Object.values(AddressTypes);
+//#endregion
+//#region src/commerce/enums.ts
+const FulfillmentStatuses = {
+	Pending: "pending",
+	ReadyForPickup: "ready_for_pickup",
+	Shipped: "shipped",
+	Delivered: "delivered",
+	Cancelled: "cancelled"
+};
+const fulfillmentStatusValues = Object.values(FulfillmentStatuses);
+const FulfillmentMethods = {
+	Shipping: "shipping",
+	Pickup: "pickup"
+};
+const fulfillmentMethodValues = Object.values(FulfillmentMethods);
+const ReturnStatuses = {
+	Requested: "requested",
+	Approved: "approved",
+	Rejected: "rejected",
+	Received: "received",
+	Closed: "closed"
+};
+const returnStatusValues = Object.values(ReturnStatuses);
+const ReturnUpdateStatuses = {
+	Approved: "approved",
+	Rejected: "rejected",
+	Received: "received",
+	Closed: "closed"
+};
+const returnUpdateStatusValues = Object.values(ReturnUpdateStatuses);
+//#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",
@@ -402,6 +443,7 @@ const NativeApps = {
 	Shop: "shop",
 	SmartLinks: "smart-links",
 	Contacts: "contacts",
+	Forms: "forms",
 	Appointments: "appointments",
 	Workspace: "workspace",
 	Meeting: "meeting",
@@ -416,4 +458,95 @@ const NativeApps = {
 const nativeAppSlugs = Object.values(NativeApps);
 const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);
 //#endregion
-export { AUTH_CODE_PARAM, ContractCategoryDisplayNames, DefaultCodeMetadata, HttpService, JoaiUrls, NativeApps, 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, isNativeApp, localize, nativeAppSlugs, ogImageUrl, resolveWarpText, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, withRetry };
+//#region src/user/permissions.ts
+/** 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"
+};
+const userPermissionValues = Object.values(UserPermissions);
+const hasPermission = (granted, required) => Boolean(granted?.includes(required));
+const hasAllPermissions = (granted, required) => required.every((permission) => hasPermission(granted, permission));
+const hasAnyPermissions = (granted, required) => required.some((permission) => hasPermission(granted, permission));
+const hasTeamPermission = (team, permission) => hasPermission(team?.permissions, permission);
+const hasAllTeamPermissions = (team, permissions) => hasAllPermissions(team?.permissions, permissions);
+//#endregion
+//#region src/access/mcp-access.ts
+/** Preset names — must match joai--api `PermissionPreset::value`. */
+const PermissionPresetNames = {
+	TeamManage: "teamManage",
+	TeamView: "teamView",
+	BillingManage: "billingManage",
+	AgentTooling: "agentTooling",
+	SecretView: "secretView",
+	SecretManage: "secretManage",
+	TeamMemberInvite: "teamMemberInvite",
+	TeamMemberRemove: "teamMemberRemove",
+	AgentWalletManage: "agentWalletManage",
+	SwarmCreate: "swarmCreate"
+};
+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)
+};
+const TeamManageAccess = permissionPresetRules.teamManage;
+const TeamViewAccess = permissionPresetRules.teamView;
+const AgentToolingAccess = permissionPresetRules.agentTooling;
+const BillingManageAccess = permissionPresetRules.billingManage;
+//#endregion
+//#region src/access/team-access.ts
+const resolveAccessCatalog = (team, accessConfig) => team?.accessCatalog ?? accessConfig?.accessCatalog;
+const featureSection = (team, area) => team?.access?.[area];
+const isTeamFeatureGated = (catalog, area, key) => Boolean(catalog?.[area]?.includes(key));
+const isNativeAppGated = (catalog, app) => Boolean(catalog?.nativeApps?.includes(app));
+const isTeamFeatureAccessible = (team, area, key) => {
+	const section = featureSection(team, area);
+	if (!section || !(key in section)) return true;
+	return section[key] === true;
+};
+const isTeamFeatureLocked = (team, catalog, area, key) => isTeamFeatureGated(catalog, area, key) && !isTeamFeatureAccessible(team, area, key);
+const isNativeAppAccessible = (team, app) => {
+	const section = team?.access?.nativeApps;
+	if (!section || !(app in section)) return true;
+	return section[app] === true;
+};
+const isNativeAppLocked = (team, catalog, app) => isNativeAppGated(catalog, app) && !isNativeAppAccessible(team, app);
+//#endregion
+//#region src/user/roles.ts
+/** Team member roles — values must match joai--api `UserRole::toName()`. */
+const UserRoles = {
+	Owner: "owner",
+	Admin: "admin",
+	Member: "member",
+	Developer: "developer"
+};
+const userRoleValues = Object.values(UserRoles);
+const isUserRole = (value) => userRoleValues.includes(value);
+/** Roles assignable via team invite — owner is never inviteable. Must match API `RolePermissions::inviteable()`. */
+const InviteableTeamRoles = [
+	UserRoles.Member,
+	UserRoles.Developer,
+	UserRoles.Admin
+];
+const DefaultInviteTeamRole = UserRoles.Member;
+const inviteableTeamRoles = () => [...InviteableTeamRoles];
+const defaultInviteTeamRole = () => DefaultInviteTeamRole;
+//#endregion
+export { AddressTypes, AgentToolingAccess, BillingManageAccess, ContractCategoryDisplayNames, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, OgImageColors, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, TeamManageAccess, TeamViewAccess, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, cartLineTotal, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };

package/package.json

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