@joai/core 4.8.0 → 4.11.0

package/dist/index.d.mts

@@ -27,7 +27,7 @@ declare const getMcpServerUrl: (env: AppEnv) => string;
 declare const getMcpServerAgentUrl: (env: AppEnv, agent: string) => string;
 declare const getSitesBaseUrl: (env: AppEnv) => "http://sites.joai--api.test:3007" | "https://devnet-sites.joai.ai" | "https://testnet-sites.joai.ai" | "https://sites.joai.ai";
 declare const getSitesRootDomain: (env: AppEnv) => string;
-declare const getSiteUrl: (env: AppEnv, teamSlug: string, brandSlug: string) => string;
+declare const getSiteUrl: (env: AppEnv, teamSlug: string, slug: string) => string;
 //#endregion
 //#region src/config/constants.d.ts
 declare const JoaiUrls: {
@@ -51,6 +51,7 @@ interface IHttpService {
   onUnauthorized: (response: IAppResponse<any>) => void;
   onSuccessfulResponse: (response: IAppResponse<any>) => void;
   onMaintenanceMode: (response: IAppResponse<any>) => void;
+  onTooManyRequests: (response: IAppResponse<any>) => void;
   get: <T>(url: string, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   post: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   put: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
@@ -483,6 +484,37 @@ type ContactCreatePayload = ContactFormData & {
   name: string;
   wallets?: WalletList;
 };
+type ContactRelationType = 'parent_of' | 'child_of' | 'spouse_of' | 'sibling_of' | 'aunt_of' | 'nibling_of' | 'manages' | 'reports_to' | 'colleague_of' | 'partner_of' | 'client_of' | 'supplier_of' | 'referred_by' | 'referred';
+type ContactRelationCategory = 'family' | 'organization' | 'business' | 'referral';
+type ContactRelationDirection = 'outgoing' | 'incoming';
+type ContactRelationContact = {
+  id: string;
+  name: string;
+  avatar: string | null;
+  company: string | null;
+  title: string | null;
+};
+type ContactRelation = {
+  id: string;
+  type: ContactRelationType;
+  category: ContactRelationCategory;
+  direction: ContactRelationDirection;
+  contact: ContactRelationContact;
+  meta: Record<string, JsonValue> | null;
+  notes: string | null;
+  createdAt: string;
+};
+type ContactRelationPayload = {
+  relatedContactId: string;
+  type: ContactRelationType;
+  notes?: string;
+  meta?: Record<string, JsonValue>;
+};
+type ContactRelationUpdatePayload = {
+  type?: ContactRelationType;
+  notes?: string;
+  meta?: Record<string, JsonValue>;
+};
 //#endregion
 //#region src/media/types.d.ts
 type AppFileType = 'abi' | 'pdf' | 'image' | 'video' | 'json';
@@ -715,6 +747,7 @@ declare const NativeApps: {
   readonly News: "news";
   readonly Sites: "sites";
   readonly Contracts: "contracts";
+  readonly Artifacts: "artifacts";
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 declare const nativeAppSlugs: NativeApp[];
@@ -1159,11 +1192,11 @@ type Product = {
   media?: Media[];
 };
 type OrderItem = {
-  id: string;
+  id: string | null;
   name: string;
   quantity: number;
   unitPrice: number;
-  type: 'product-variation' | 'service' | 'coupon';
+  type: 'product-variation' | 'service' | 'coupon' | 'custom';
   digital?: boolean | null;
   sellerTeamId?: string | null;
 };
@@ -1187,9 +1220,12 @@ type Order = {
   justCreated?: boolean;
   createdAt: string;
   invoiceDate: string;
+  serviceDate: string;
   meta: Record<string, JsonValue> | null;
   contactId: string | null;
   contact?: Contact | null;
+  invoiceContactId?: string | null;
+  invoiceContact?: Contact | null;
   source: OrderSource | null;
   context: OrderContext | null;
   paymentMode: string | null;
@@ -1205,6 +1241,7 @@ type Order = {
   } | null;
   shippingFee?: number;
   fulfillments?: Fulfillment[];
+  returns?: Return[];
   subscription?: Subscription | null;
   configuration?: OrderConfigurationItem[];
   items: OrderItem[];
@@ -1316,7 +1353,7 @@ type Skill = {
 };
 //#endregion
 //#region src/integration/types.d.ts
-type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'grok' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
+type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'grok' | 'cloudflare' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
 type IntegrationDetails = {
   type: IntegrationType;
   name: string;
@@ -1951,6 +1988,83 @@ type PaginatedResponse<T> = {
   last_page: number;
 };
 //#endregion
+//#region src/artifact/types.d.ts
+type ArtifactType = 'agreement' | 'offer' | 'concept' | 'update' | 'demo' | 'file' | 'other';
+type ArtifactStatus = 'draft' | 'ready' | 'sent' | 'archived';
+type ArtifactDeliverIntegration = 'email' | 'sms' | 'whatsapp';
+type ArtifactLink = {
+  url: string;
+  label?: string | null;
+};
+type ArtifactBlockType = 'heading' | 'richText' | 'metrics' | 'table' | 'callout' | 'actions' | 'media' | 'divider';
+type ArtifactBlock = {
+  id: string;
+  type: ArtifactBlockType;
+  data: Record<string, unknown>;
+};
+type ArtifactContactSummary = {
+  id: string;
+  name: string | null;
+  email: string | null;
+  phone: string | null;
+};
+type Artifact = {
+  id: string;
+  type: ArtifactType;
+  status: ArtifactStatus;
+  title: string;
+  summary: string | null;
+  blocks: ArtifactBlock[] | null;
+  url: string | null;
+  password: string | null;
+  links: ArtifactLink[];
+  media: Media[];
+  meta: Record<string, unknown> | null;
+  contactId: string | null;
+  orderId: string | null;
+  contact?: ArtifactContactSummary;
+  deliveredAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+type ArtifactCreatePayload = {
+  title: string;
+  type: ArtifactType;
+  status?: ArtifactStatus;
+  summary?: string;
+  blocks?: ArtifactBlock[];
+  url?: string;
+  password?: string;
+  links?: ArtifactLink[];
+  extraLinkUrl?: string;
+  extraLinkLabel?: string;
+  media?: string[];
+  meta?: Record<string, unknown>;
+  contactId?: string;
+  orderId?: string;
+};
+type ArtifactUpdatePayload = Omit<Partial<ArtifactCreatePayload>, 'blocks'> & {
+  blocks?: ArtifactBlock[] | null;
+};
+type ArtifactDeliverPayload = {
+  artifactIds: string[];
+  message: string;
+  integration: ArtifactDeliverIntegration;
+  subject?: string;
+  contactIds?: string[];
+  agentId?: string;
+};
+type ArtifactDelivery = {
+  id: string;
+  contactId: string;
+  integration: ArtifactDeliverIntegration;
+  subject: string | null;
+  message: string;
+  artifactIds?: string[];
+  deliveredAt: string;
+  createdAt: string;
+};
+//#endregion
 //#region src/service/types.d.ts
 type Service = {
   id: string;
@@ -2691,6 +2805,21 @@ declare const slugifyMcpSegment: (value: string) => string;
 declare const buildMcpServerName: (slug: string, teamName?: string) => string;
 declare const buildAgentMcpServerName: (agentName: string, teamName?: string) => string;
 //#endregion
+//#region src/metric/types.d.ts
+type MetricSource = 'cloudflare';
+type Metric = {
+  key: string;
+  value: number;
+  unit: string;
+};
+type MetricsResult = {
+  source: MetricSource;
+  resource: string;
+  from: string;
+  to: string;
+  metrics: Metric[];
+};
+//#endregion
 //#region src/memory/types.d.ts
 type Memory = {
   id: string;
@@ -3080,7 +3209,7 @@ type WarpCloudExecutable = {
 type WarpBatchItem = {
   warpId: string;
   warpRef: string;
-  thought: string;
+  thought: string | null;
   inputs: string[];
 };
 type WarpBatchable = {
@@ -3633,9 +3762,14 @@ type SiteAgent = {
 };
 type Site = {
   id: number;
-  brandSlug: string;
+  slug: string;
+  brandSlug: string | null;
   customDomain: string | null;
   enabled: boolean;
+  contactId?: string | null;
+  metricsSource?: string | null;
+  metricsResource?: string | null;
+  monthlyReport?: boolean;
   team: SiteTeam | null;
   agent: SiteAgent | null;
   settings: Record<string, JsonValue>;
@@ -3835,7 +3969,7 @@ type LoyaltyMember = {
 };
 //#endregion
 //#region src/segment/types.d.ts
-type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'waiting_on' | 'created_after' | 'created_before' | 'email_contains';
+type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'waiting_on' | 'created_after' | 'created_before' | 'email_contains' | 'prop' | 'marketing_opt_out';
 type SegmentCondition = {
   type: SegmentConditionType;
   value: string | boolean;
@@ -3868,10 +4002,24 @@ type SegmentCountResult = {
 //#endregion
 //#region src/campaign/types.d.ts
 type CampaignChannel = 'email' | 'whatsapp' | 'sms' | 'push';
-type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'sending' | 'completed' | 'failed';
+type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'scheduled' | 'sending' | 'completed' | 'failed';
 type CampaignCategory = 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
 type CampaignSkipReason = 'pending_consent' | 'opted_out' | 'missing_channel' | 'approval_skipped';
 type CampaignSkipReasons = Record<CampaignSkipReason, number>;
+type CampaignRecipientStatus = 'sent' | 'failed' | 'skipped' | 'pending';
+type CampaignRecipient = {
+  id: string;
+  name: string | null;
+  email: string | null;
+  phone: string | null;
+  status: CampaignRecipientStatus;
+  error: string | null;
+  skipReason: CampaignSkipReason | null;
+  retryable: boolean;
+  sentAt: string | null;
+  openedAt: string | null;
+  clickedAt: string | null;
+};
 type CampaignAudiencePreview = {
   total: number;
   sendable: number;
@@ -3893,9 +4041,15 @@ type Campaign = {
   channel: CampaignChannel;
   subject: string | null;
   content: string;
+  contentHtml?: boolean;
+  scheduledAt?: string | null;
+  openedCount?: number;
+  clickedCount?: number;
   approval: CampaignApproval;
   agent: AgentSimple | null;
   tags: string[];
+  segmentId?: string | null;
+  contactIds?: string[];
   status: CampaignStatus;
   totalCount: number;
   remainingCount: number;
@@ -3912,6 +4066,7 @@ type CampaignCreatePayload = {
   channel: CampaignChannel;
   subject?: string;
   content: string;
+  contentHtml?: boolean;
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
@@ -3925,11 +4080,15 @@ type CampaignUpdatePayload = {
   name: string;
   subject?: string;
   content: string;
+  contentHtml?: boolean;
   language?: string;
   category?: CampaignCategory;
   templateParams?: Record<string, string>;
   aiParams?: Record<string, string>;
   agentId?: string;
+  tags?: string[];
+  contactIds?: string[];
+  segmentId?: string;
 };
 type CampaignAudiencePreviewPayload = {
   campaignId: string;
@@ -3943,10 +4102,12 @@ type CampaignStats = {
   totalCampaigns: number;
   draftCampaigns: number;
   totalSent: number;
+  totalOpened?: number;
+  totalClicked?: number;
 };
 //#endregion
 //#region src/update/types.d.ts
-type UpdateType = 'deal' | 'event' | 'news';
+type UpdateType = 'deal' | 'event' | 'news' | 'article';
 type UpdateStatus = 'draft' | 'published' | 'archived';
 type UpdateRelation = 'team';
 type Update = {
@@ -3982,6 +4143,7 @@ type UpdateStats = {
   dealsCount: number;
   eventsCount: number;
   newsCount: number;
+  articlesCount: number;
   publishedCount: number;
   draftCount: number;
   archivedCount: number;
@@ -4259,4 +4421,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-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, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, 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, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignCreatePayload, CampaignSkipReason, CampaignSkipReasons, 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, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, 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, GuestBuyer, 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, PatchContentInput, 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, UNIFIED_MCP_SERVER_NAME, 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, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, 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, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, 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, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSkipReason, CampaignSkipReasons, 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, ContactRelation, ContactRelationCategory, ContactRelationContact, ContactRelationDirection, ContactRelationPayload, ContactRelationType, ContactRelationUpdatePayload, ContactViewable, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, 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, GuestBuyer, 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, Metric, MetricSource, MetricsResult, 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, PatchContentInput, 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, UNIFIED_MCP_SERVER_NAME, 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, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, inviteableTeamRoles, isCompleteAddressInput, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, ogImageUrl, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };

package/dist/index.mjs

@@ -56,7 +56,7 @@ const getSitesRootDomain = (env) => {
 	if (env === "testnet") return "testnet-sites.joai.ai";
 	return "sites.joai.ai";
 };
-const getSiteUrl = (env, teamSlug, brandSlug) => `https://${getSitesRootDomain(env)}/${teamSlug}/${brandSlug}`;
+const getSiteUrl = (env, teamSlug, slug) => `https://${getSitesRootDomain(env)}/${teamSlug}/${slug}`;
 //#endregion
 //#region src/auth/token.ts
 /** One-time native/deep-link handoff fragment key (exchanged for a Bearer via POST). */
@@ -519,7 +519,8 @@ const NativeApps = {
 	Campaigns: "campaigns",
 	News: "news",
 	Sites: "sites",
-	Contracts: "contracts"
+	Contracts: "contracts",
+	Artifacts: "artifacts"
 };
 const nativeAppSlugs = Object.values(NativeApps);
 const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);

package/dist/react/index.d.mts

@@ -80,6 +80,7 @@ interface IHttpService {
   onUnauthorized: (response: IAppResponse<any>) => void;
   onSuccessfulResponse: (response: IAppResponse<any>) => void;
   onMaintenanceMode: (response: IAppResponse<any>) => void;
+  onTooManyRequests: (response: IAppResponse<any>) => void;
   get: <T>(url: string, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   post: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
   put: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;

package/package.json

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