@joai/core 4.2.0 → 4.3.1

package/dist/index.d.mts

@@ -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,7 +276,6 @@ type UserPrivate = {
   socials: UserSocialAccount[];
   justCreated: boolean;
   affiliate: Affiliate | null;
-  betaRestricted: boolean;
   kyc?: Kyc | null;
   settings: UserSettings;
 };
@@ -302,9 +343,6 @@ 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";
@@ -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,8 +598,15 @@ 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 AddressType = 'shipping' | 'billing';
 type Address = {
   id: string;
   type: AddressType;
@@ -578,8 +659,41 @@ type AddressCreatePayload = {
 };
 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 FulfillmentMethod = 'shipping' | 'pickup';
 type ShippingRate = {
   id: number;
   name: string;
@@ -637,7 +751,6 @@ type FulfillmentLocation = {
   instructions: string | null;
   active: boolean;
 };
-type FulfillmentStatus = 'pending' | 'ready_for_pickup' | 'shipped' | 'delivered' | 'cancelled';
 type Fulfillment = {
   id: string;
   orderId: number;
@@ -654,7 +767,6 @@ type Fulfillment = {
   readyForPickupAt: string | null;
   deliveredAt: string | null;
 };
-type ReturnStatus = 'requested' | 'approved' | 'rejected' | 'received' | 'closed';
 type Return = {
   id: string;
   orderId: number;
@@ -1044,7 +1156,7 @@ type Order = {
   linkVariationId: string | null;
   notes: string | null;
   fulfillmentMethod?: FulfillmentMethod | null;
-  address?: AddressSnapshot | null;
+  billingAddress?: AddressSnapshot | null;
   shippingAddress?: AddressSnapshot | null;
   shippingRate?: Pick<ShippingRate, 'name' | 'price' | 'estimatedMinDays' | 'estimatedMaxDays'> | null;
   fulfillmentLocation?: {
@@ -3798,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 = {
@@ -3971,4 +4109,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-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 };
+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

@@ -282,6 +282,43 @@ 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());
@@ -421,4 +458,95 @@ const NativeApps = {
 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 };
+//#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.2.0",
+  "version": "4.3.1",
   "description": "JoAi shared types, HTTP service, and config",
   "license": "MIT",
   "type": "module",