@joai/core 4.15.7 → 5.0.0

package/dist/index.d.mts

@@ -584,7 +584,7 @@ type Media = {
 };
 //#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' | 'facebook' | 'linkedin' | 'grok' | 'cloudflare' | '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' | 'facebook' | 'linkedin' | 'grok' | 'cloudflare' | 'google-search-console' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
 type IntegrationDetails = {
   type: IntegrationType;
   name: string;
@@ -831,6 +831,7 @@ type MeetingStatus = 'active' | 'completed' | 'analyzed' | 'scheduled' | 'cancel
 type MeetingConferenceProvider = 'google_meet' | 'teams' | 'zoom';
 type MeetingFeature = 'transcription' | 'summary' | 'insights' | 'actions';
 type MeetingJoinTeam = {
+  slug: string;
   name: string;
   logo: string | null;
 };
@@ -1127,6 +1128,7 @@ declare const NativeApps: {
   readonly Social: "social";
   readonly Studio: "studio";
   readonly Loyalty: "loyalty";
+  readonly Documents: "documents";
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 declare const nativeAppSlugs: NativeApp[];
@@ -1188,6 +1190,10 @@ type TeamMeta = {
   'shop.kiosk.enabled'?: boolean;
   'shop.stock.enabled'?: boolean;
   'shop.reorder.enabled'?: boolean;
+  'shop.legal.terms_url'?: string | null;
+  'shop.legal.privacy_url'?: string | null;
+  'shop.legal.withdrawal_url'?: string | null;
+  'shop.legal.imprint_url'?: string | null;
   'orders.notify_emails'?: string[];
   contactPropertyMaskWarp?: string;
   branding?: TeamBrand | null;
@@ -1311,6 +1317,10 @@ type TeamSettings = {
   'shop.kiosk.enabled'?: boolean;
   'shop.stock.enabled'?: boolean;
   'shop.reorder.enabled'?: boolean;
+  'shop.legal.terms_url'?: string | null;
+  'shop.legal.privacy_url'?: string | null;
+  'shop.legal.withdrawal_url'?: string | null;
+  'shop.legal.imprint_url'?: string | null;
   'orders.notify_emails'?: string[];
   branding?: TeamBrand | null;
 };
@@ -1525,9 +1535,23 @@ type ProductVariationMeta = {
   mpn?: string | null;
   condition?: 'new' | 'used' | 'refurbished';
 };
+type ProductDetailKind = 'kv' | 'text';
+type ProductDetailText = string | TranslatableValue;
+type ProductDetailRow = {
+  label: ProductDetailText;
+  value: ProductDetailText;
+};
+type ProductDetailSection = {
+  key: string;
+  title: ProductDetailText;
+  kind: ProductDetailKind;
+  text?: ProductDetailText;
+  rows?: ProductDetailRow[];
+};
 type ProductMeta = {
   googleProductCategory?: number | null;
   brand?: string | null;
+  details?: ProductDetailSection[];
 };
 type ProductVariation = {
   resource?: 'product-variation';
@@ -2417,7 +2441,7 @@ type AppointmentRequest = {
 };
 //#endregion
 //#region src/automation/types.d.ts
-type AutomationTriggerType = 'prop' | 'segment' | 'manual' | 'webhook';
+type AutomationTriggerType = 'prop' | 'segment' | 'manual' | 'webhook' | 'site_monthly_report';
 type AutomationActionType = 'wait' | 'halt' | 'warp' | 'branch';
 type AutomationEnrollmentStatus = 'active' | 'completed' | 'skipped';
 type AutomationEnrollmentChange = 'created' | 'advanced' | 'sent' | 'completed' | 'skipped' | 'errored';
@@ -2628,7 +2652,47 @@ type PatchContentInput = {
   expectedVersion: number;
   patches: ContentPatch[];
   origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
+  publish?: boolean;
+};
+//#endregion
+//#region src/content/image-processing.d.ts
+type ImageDimensions = {
+  width: number;
+  height: number;
+};
+type ImageCropState = {
+  x: number;
+  y: number;
+  zoom: number;
+};
+type ImageCropRectangle = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
 };
+type ImageDimensionRules = {
+  minWidth?: number;
+  minHeight?: number;
+  maxWidth?: number;
+  maxHeight?: number;
+  maxPixels?: number;
+};
+type ImageCompressionOptions = {
+  maxWidth?: number;
+  maxHeight?: number;
+  mimeType?: 'image/jpeg' | 'image/png' | 'image/webp';
+  quality?: number;
+};
+type ImageCropOptions = {
+  aspectRatio: number;
+  outputWidth?: number;
+  outputHeight?: number;
+};
+declare const validateImageDimensions: (dimensions: ImageDimensions, rules: ImageDimensionRules) => "too-small" | "too-large" | null;
+declare const imageCropRectangle: (dimensions: ImageDimensions, aspectRatio: number, crop: ImageCropState) => ImageCropRectangle;
+declare const containedImageDimensions: (source: ImageDimensions, options: ImageCompressionOptions) => ImageDimensions;
+declare const cropOutputDimensions: (source: ImageDimensions, options: ImageCropOptions, compression: ImageCompressionOptions) => ImageDimensions;
 //#endregion
 //#region src/address/formatAddressSnapshot.d.ts
 /** Accepts camelCase API snapshots and legacy snake_case stored snapshots. */
@@ -3180,7 +3244,7 @@ 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 MetricSource = 'cloudflare' | 'google_search_console';
 type Metric = {
   key: string;
   value: number;
@@ -4841,4 +4905,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, 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, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentPolicyUpsert, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, 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, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentFlowAction, FulfillmentFlowStep, 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, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, PickupNextAction, 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, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, SupportedAppLocale, SupportedAppLocales, Swarm, Tag, TagType, Task, TaxBreakdownRow, TaxClass, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, 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, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, createCursorMcpInstallLink, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validationMessageFor, withRetry };
+export { AUTOMATION_SEND_CHANNELS, 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, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentPolicyUpsert, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, 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, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentFlowAction, FulfillmentFlowStep, 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, ImageCompressionOptions, ImageCropOptions, ImageCropRectangle, ImageCropState, ImageDimensionRules, ImageDimensions, 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, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, PickupNextAction, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDetailKind, ProductDetailRow, ProductDetailSection, ProductDetailText, 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, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, SupportedAppLocale, SupportedAppLocales, Swarm, Tag, TagType, Task, TaxBreakdownRow, TaxClass, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, 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, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };

package/dist/index.mjs

@@ -410,6 +410,63 @@ function integrationSlugForChannel(channel) {
 	return channel === "sms" ? "twilio" : channel;
 }
 //#endregion
+//#region src/content/image-processing.ts
+const positiveFinite = (value) => typeof value === "number" && Number.isFinite(value) && value > 0;
+const validateImageDimensions = (dimensions, rules) => {
+	if (!positiveFinite(dimensions.width) || !positiveFinite(dimensions.height)) return "too-small";
+	if (rules.minWidth && dimensions.width < rules.minWidth || rules.minHeight && dimensions.height < rules.minHeight) return "too-small";
+	if (rules.maxWidth && dimensions.width > rules.maxWidth || rules.maxHeight && dimensions.height > rules.maxHeight || rules.maxPixels && dimensions.width * dimensions.height > rules.maxPixels) return "too-large";
+	return null;
+};
+const imageCropRectangle = (dimensions, aspectRatio, crop) => {
+	if (!positiveFinite(aspectRatio)) throw new RangeError("Crop aspect ratio must be a positive finite number.");
+	if (!positiveFinite(dimensions.width) || !positiveFinite(dimensions.height)) throw new RangeError("Image dimensions must be positive finite numbers.");
+	const sourceAspect = dimensions.width / dimensions.height;
+	const baseWidth = sourceAspect > aspectRatio ? dimensions.height * aspectRatio : dimensions.width;
+	const baseHeight = sourceAspect > aspectRatio ? dimensions.height : dimensions.width / aspectRatio;
+	const zoom = Number.isFinite(crop.zoom) ? Math.max(1, crop.zoom) : 1;
+	const positionX = Number.isFinite(crop.x) ? Math.max(-1, Math.min(1, crop.x)) : 0;
+	const positionY = Number.isFinite(crop.y) ? Math.max(-1, Math.min(1, crop.y)) : 0;
+	const width = baseWidth / zoom;
+	const height = baseHeight / zoom;
+	const availableX = dimensions.width - width;
+	const availableY = dimensions.height - height;
+	return {
+		x: availableX * ((positionX + 1) / 2),
+		y: availableY * ((positionY + 1) / 2),
+		width,
+		height
+	};
+};
+const containedImageDimensions = (source, options) => {
+	if (!positiveFinite(source.width) || !positiveFinite(source.height)) throw new RangeError("Image dimensions must be positive finite numbers.");
+	const maxWidth = positiveFinite(options.maxWidth) ? options.maxWidth : source.width;
+	const maxHeight = positiveFinite(options.maxHeight) ? options.maxHeight : source.height;
+	const scale = Math.min(1, maxWidth / source.width, maxHeight / source.height);
+	return {
+		width: Math.max(1, Math.round(source.width * scale)),
+		height: Math.max(1, Math.round(source.height * scale))
+	};
+};
+const cropOutputDimensions = (source, options, compression) => {
+	if (!positiveFinite(options.aspectRatio)) throw new RangeError("Crop aspect ratio must be a positive finite number.");
+	const width = positiveFinite(options.outputWidth) ? options.outputWidth : void 0;
+	const height = positiveFinite(options.outputHeight) ? options.outputHeight : void 0;
+	if (width && height) return {
+		width: Math.max(1, Math.round(width)),
+		height: Math.max(1, Math.round(height))
+	};
+	if (width) return {
+		width: Math.max(1, Math.round(width)),
+		height: Math.max(1, Math.round(width / options.aspectRatio))
+	};
+	if (height) return {
+		width: Math.max(1, Math.round(height * options.aspectRatio)),
+		height: Math.max(1, Math.round(height))
+	};
+	return containedImageDimensions(source, compression);
+};
+//#endregion
 //#region src/address/enums.ts
 const AddressTypes = {
 	Billing: "billing",
@@ -878,7 +935,8 @@ const NativeApps = {
 	Artifacts: "artifacts",
 	Social: "social",
 	Studio: "studio",
-	Loyalty: "loyalty"
+	Loyalty: "loyalty",
+	Documents: "documents"
 };
 const nativeAppSlugs = Object.values(NativeApps);
 const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);
@@ -976,4 +1034,4 @@ const DefaultInviteTeamRole = UserRoles.Member;
 const inviteableTeamRoles = () => [...InviteableTeamRoles];
 const defaultInviteTeamRole = () => DefaultInviteTeamRole;
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, SupportedAppLocales, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, createCursorMcpInstallLink, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validationMessageFor, withRetry };
+export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, SupportedAppLocales, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/core",
-  "version": "4.15.7",
+  "version": "5.0.0",
   "description": "JoAi shared types, HTTP service, and config",
   "license": "MIT",
   "type": "module",
@@ -10,10 +10,6 @@
     ".": {
       "import": "./dist/index.mjs",
       "types": "./dist/index.d.mts"
-    },
-    "./react": {
-      "import": "./dist/react/index.mjs",
-      "types": "./dist/react/index.d.mts"
     }
   },
   "files": [
@@ -26,17 +22,10 @@
     "test:watch": "jest --watch"
   },
   "peerDependencies": {
-    "@joai/warps": ">=4.0.0",
-    "react": ">=18.0.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": true
-    }
+    "@joai/warps": ">=4.0.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
-    "@types/react": "^19.2.14",
     "jest": "^30.3.0",
     "ts-jest": "^29.4.6",
     "tsdown": "^0.21.0",

package/dist/react/index.d.mts

@@ -1,361 +0,0 @@
-'use client';
-import * as _$react from "react";
-import { ReactNode } from "react";
-
-//#region src/react/types.d.ts
-type EmbedChatItem = {
-  content: string;
-  byUser: boolean;
-  streaming?: boolean;
-  error?: boolean;
-};
-//#endregion
-//#region src/react/guest.d.ts
-declare function getOrCreateGuestId(storageKey?: string): string;
-declare function loadRoom(storageKey: string): string | null;
-declare function saveRoom(storageKey: string, roomId: string): void;
-declare function clearRoom(storageKey: string): void;
-//#endregion
-//#region src/react/stream-connection.d.ts
-type StreamDataHandler = (data: unknown) => void;
-declare function openEventSourceStream(url: string, onData: StreamDataHandler, options?: {
-  withCredentials?: boolean;
-  onError?: (e: unknown) => void;
-  onConnectionError?: (e: Event | null) => void;
-}): () => void;
-//#endregion
-//#region src/react/components.d.ts
-type ListClassNames = {
-  container?: string;
-  userBubble?: string;
-  agentBubble?: string;
-  errorBubble?: string;
-  thinkingWrapper?: string;
-  dot?: string;
-};
-type EmbedChatListProps = {
-  items: EmbedChatItem[];
-  agentName: string;
-  awaitingResponse: boolean;
-  classNames?: ListClassNames;
-  renderEmptyState?: () => ReactNode;
-  renderAgentContent?: (item: EmbedChatItem) => ReactNode;
-};
-declare function EmbedChatList({
-  items,
-  agentName,
-  awaitingResponse,
-  classNames,
-  renderEmptyState,
-  renderAgentContent
-}: EmbedChatListProps): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | _$react.ReactPortal | _$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | _$react.JSX.Element | null | undefined;
-type EmbedChatInputProps = {
-  onSend: (message: string) => void;
-  disabled: boolean;
-  placeholder?: string;
-  maxLength?: number;
-  classNames?: {
-    container?: string;
-    textarea?: string;
-  };
-  renderSendButton: (props: {
-    onClick: () => void;
-    disabled: boolean;
-  }) => ReactNode;
-};
-declare function EmbedChatInput({
-  onSend,
-  disabled,
-  placeholder,
-  maxLength,
-  classNames,
-  renderSendButton
-}: EmbedChatInputProps): _$react.JSX.Element;
-//#endregion
-//#region src/http/types.d.ts
-interface IHttpService {
-  readonly baseUrl: string;
-  readonly authToken: string | null;
-  onNetworkError: (error: Error) => void;
-  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>>;
-  patch: <T>(url: string, data?: any, options?: IRequestOptions) => Promise<IAppResponse<T>>;
-  delete: <T>(url: string, options?: IRequestOptions) => Promise<IAppResponse<T>>;
-}
-interface IAppResponse<T> {
-  data: T;
-  meta?: any;
-  body: any;
-  errors: any;
-  ok: boolean;
-  paymentRequired: boolean;
-  noContent: boolean;
-  original: Response;
-}
-interface IRequestOptions {
-  isJson?: boolean;
-  headers?: {
-    [name: string]: string;
-  };
-}
-//#endregion
-//#region src/react/use-embed-chat.d.ts
-type Options = {
-  agentUuid: string | null;
-  http: IHttpService;
-  cortexBaseUrl: string;
-  guestId: string;
-  roomStorageKey: string;
-  enabled?: boolean;
-  extraPayload?: Record<string, unknown>;
-};
-declare function useEmbedChat({
-  agentUuid,
-  http,
-  cortexBaseUrl,
-  guestId,
-  roomStorageKey,
-  enabled,
-  extraPayload
-}: Options): {
-  items: EmbedChatItem[];
-  setItems: _$react.Dispatch<_$react.SetStateAction<EmbedChatItem[]>>;
-  sending: boolean;
-  awaitingResponse: boolean;
-  roomId: string | null;
-  setRoomId: _$react.Dispatch<_$react.SetStateAction<string | null>>;
-  send: (message: string) => Promise<void>;
-  connectionError: boolean;
-};
-//#endregion
-//#region src/content/types.d.ts
-type ContentStatus = 'draft' | 'published' | 'archived';
-type ContentFieldType = 'text' | 'richText' | 'number' | 'boolean' | 'url' | 'image' | 'media' | 'list' | 'object' | 'reference';
-type ContentField = {
-  key: string;
-  type: ContentFieldType;
-  label?: string;
-  required?: boolean;
-};
-type ContentDefinition = {
-  fields: ContentField[];
-};
-type ContentValue = string | number | boolean | null | ContentValue[] | {
-  [key: string]: ContentValue;
-};
-type ContentEntry = {
-  key: string;
-  value: ContentValue;
-  updatedAt: string;
-};
-type ContentVersion = {
-  id: string;
-  number: number;
-  status: ContentStatus;
-  entries: ContentEntry[];
-  snapshotHash: string;
-  origin: string;
-  createdAt: string;
-  updatedAt: string;
-  publishedAt: string | null;
-};
-type Content = {
-  id: string;
-  name: string;
-  slug: string;
-  schema: string | null;
-  definition: ContentDefinition;
-  metadata: Record<string, ContentValue>;
-  version: ContentVersion | null;
-  createdAt: string;
-  updatedAt: string;
-};
-type ContentPatch = {
-  key: string;
-  value: ContentValue;
-};
-type PatchContentInput = {
-  expectedVersion: number;
-  patches: ContentPatch[];
-  origin?: 'api' | 'inlineEditor' | 'joai' | 'mcp';
-};
-//#endregion
-//#region src/json/types.d.ts
-type JsonValue = string | number | boolean | null | JsonValue[] | {
-  [key: string]: JsonValue;
-};
-//#endregion
-//#region src/media/types.d.ts
-type MediaLibraryAttributes = {
-  uuid: string;
-  order: number;
-  name: string;
-  custom_properties: {
-    [key: string]: JsonValue;
-  };
-  preview_url: null | string;
-  original_url: null | string;
-  extension?: string;
-  size?: number;
-};
-type MediaMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'audio/mpeg' | 'audio/mp3' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/aac' | 'audio/m4a' | 'audio/m4b' | 'audio/m4p' | 'audio/m4v' | 'application/pdf' | 'application/json';
-type Media = {
-  id: string;
-  name: string;
-  mime: MediaMime;
-  url: string;
-  library: MediaLibraryAttributes;
-  tags?: string[];
-  copyright?: string | null;
-  aiGenerated?: boolean;
-};
-//#endregion
-//#region src/react/content/types.d.ts
-type ContentResource = {
-  get: (contentId: string) => Promise<{
-    ok: boolean;
-    data?: Content;
-  }>;
-  getPublic: (slug: string) => Promise<{
-    ok: boolean;
-    data?: Content;
-  }>;
-  patch: (contentId: string, input: PatchContentInput) => Promise<{
-    ok: boolean;
-    data?: ContentVersion;
-  }>;
-  publish: (contentId: string, expectedVersion: number) => Promise<{
-    ok: boolean;
-    data?: ContentVersion;
-  }>;
-};
-type ContentClient = {
-  content: ContentResource;
-  media?: {
-    list: (team: string, params?: {
-      page?: number;
-      mime?: string;
-    }) => Promise<{
-      ok: boolean;
-      data?: Media[];
-    }>;
-    upload: (data: {
-      team: string;
-      file: File;
-      type: 'output';
-      label?: string;
-    }) => Promise<{
-      ok: boolean;
-      data?: Media;
-    }>;
-  };
-};
-type ContentContextValue = {
-  content: Content | null;
-  values: Record<string, ContentValue>;
-  isLoading: boolean;
-  isSaving: boolean;
-  isEditing: boolean;
-  isDirty: boolean;
-  canEdit: boolean;
-  canPublish: boolean;
-  teamSlug?: string;
-  media?: ContentClient['media'];
-  error: string | null;
-  setEditing: (editing: boolean) => void;
-  setValue: (key: string, value: ContentValue) => void;
-  save: () => Promise<boolean>;
-  publish: () => Promise<boolean>;
-};
-type ContentProviderProp = {
-  children: ReactNode;
-  client: ContentClient;
-  contentId?: string;
-  publicSlug?: string;
-  initialContent?: Content;
-  canEdit?: boolean;
-  canPublish?: boolean;
-  teamSlug?: string;
-};
-type EditableContentProp = {
-  field: string;
-  as?: 'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3';
-  className?: string;
-  placeholder?: string;
-  multiline?: boolean;
-};
-type EditableImageProp = {
-  field: string;
-  alt?: string;
-  className?: string;
-  onSelect?: () => void;
-  inputClassName?: string;
-  placeholder?: string;
-};
-type ContentToolbarProp = {
-  className?: string;
-  confirmPublish?: () => boolean | Promise<boolean>;
-  labels?: {
-    edit?: string;
-    save?: string;
-    publish?: string;
-    cancel?: string;
-  };
-};
-//#endregion
-//#region src/react/content/provider.d.ts
-declare function ContentProvider({
-  children,
-  client,
-  contentId,
-  publicSlug,
-  initialContent,
-  canEdit,
-  canPublish,
-  teamSlug
-}: ContentProviderProp): _$react.JSX.Element;
-//#endregion
-//#region src/react/content/editable-content.d.ts
-declare function EditableContent({
-  field,
-  as: Tag,
-  className,
-  placeholder,
-  multiline
-}: EditableContentProp): _$react.JSX.Element;
-declare function useContentValue<T extends ContentValue = ContentValue>(key: string): T | undefined;
-//#endregion
-//#region src/react/content/editable-image.d.ts
-declare function EditableImage({
-  field,
-  alt,
-  className,
-  inputClassName,
-  placeholder,
-  onSelect
-}: EditableImageProp): _$react.JSX.Element | null;
-//#endregion
-//#region src/react/content/toolbar.d.ts
-declare function ContentToolbar({
-  className,
-  labels,
-  confirmPublish
-}: ContentToolbarProp): _$react.JSX.Element | null;
-//#endregion
-//#region src/react/content/content-editor.d.ts
-type Prop = ContentProviderProp & {
-  children: ReactNode;
-  title?: string;
-};
-declare function ContentEditor({
-  children,
-  title,
-  ...provider
-}: Prop): _$react.JSX.Element;
-//#endregion
-export { ContentClient, ContentContextValue, ContentEditor, ContentProvider, ContentProviderProp, ContentResource, ContentToolbar, ContentToolbarProp, EditableContent, EditableContentProp, EditableImage, EditableImageProp, EmbedChatInput, EmbedChatItem, EmbedChatList, StreamDataHandler, clearRoom, getOrCreateGuestId, loadRoom, openEventSourceStream, saveRoom, useContentValue, useEmbedChat };