@joai/core 4.15.3 → 4.15.4

package/dist/index.d.mts

@@ -23,6 +23,7 @@ declare const getFormsBaseUrl: (env: AppEnv) => "http://forms.joai--api.test:300
 declare const getDigestBaseUrl: (env: AppEnv) => "http://localhost:3005" | "https://devnet-digests.joai.ai" | "https://testnet-digests.joai.ai" | "https://digests.joai.ai";
 declare const getStoreBaseUrl: (env: AppEnv) => "http://localhost:3005" | "https://devnet-store.joai.ai" | "https://testnet-store.joai.ai" | "https://store.joai.ai";
 declare const getAgentsBaseUrl: (env: AppEnv) => "http://localhost:3007" | "https://devnet-agents.joai.ai" | "https://testnet-agents.joai.ai" | "https://agents.joai.ai";
+declare const getGenBaseUrl: (env: AppEnv) => "http://localhost:3011" | "https://devnet-gen.joai.ai" | "https://testnet-gen.joai.ai" | "https://gen.joai.ai";
 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";
@@ -811,6 +812,7 @@ declare const NativeApps: {
   readonly Artifacts: "artifacts";
   readonly Social: "social";
   readonly Studio: "studio";
+  readonly Loyalty: "loyalty";
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 declare const nativeAppSlugs: NativeApp[];
@@ -871,6 +873,7 @@ type TeamMeta = {
   'payments.coupons'?: boolean;
   'kiosk.enabled'?: boolean;
   'stock.enabled'?: boolean;
+  'orders.notify_emails'?: string[];
   contactPropertyMaskWarp?: string;
   branding?: TeamBrand | null;
   settings: Record<string, unknown> & {
@@ -992,6 +995,7 @@ type TeamSettings = {
   'payments.coupons'?: boolean;
   'kiosk.enabled'?: boolean;
   'stock.enabled'?: boolean;
+  'orders.notify_emails'?: string[];
   branding?: TeamBrand | null;
 };
 type TeamUsage = Partial<Record<PlanFeature, TeamFeatureUsage>> & {
@@ -1256,7 +1260,8 @@ type Product = {
   media?: Media[];
 };
 type OrderItem = {
-  id: string | null;
+  id: string | null; /** Database id of the order_items row — required for fulfillments/returns. */
+  orderItemId: number;
   name: string;
   quantity: number;
   unitPrice: number;
@@ -1282,6 +1287,7 @@ type Order = {
   status: OrderStatus;
   paymentUrl?: string | null;
   invoiceUrl: string | null;
+  deliveryNoteUrl: string | null;
   justCreated?: boolean;
   createdAt: string;
   invoiceDate: string;
@@ -2582,6 +2588,7 @@ type PatchContentInput = {
 };
 //#endregion
 //#region src/address/formatAddressSnapshot.d.ts
+/** Accepts camelCase API snapshots and legacy snake_case stored snapshots. */
 declare const formatAddressSnapshotLines: (address: AddressSnapshot | null | undefined) => string[];
 //#endregion
 //#region src/billing/orderStatus.d.ts
@@ -2589,8 +2596,8 @@ declare const formatAddressSnapshotLines: (address: AddressSnapshot | null | und
 declare const ORDER_FULFILLMENT_STATUSES: readonly OrderStatus[];
 /** Statuses where checkout is finished and the guest may leave the JoAi thank-you page. */
 declare const ORDER_POST_CHECKOUT_STATUSES: readonly OrderStatus[];
-/** Storefront/admin label kind — pickup remaps confirmed/processing/shipped/delivered. */
-type OrderStatusDisplay = OrderStatus | 'preparing' | 'ready_for_pickup' | 'picked_up';
+/** Storefront/admin label kind — pickup remaps fulfillment steps; invoice remaps delivered → paid. */
+type OrderStatusDisplay = OrderStatus | 'new' | 'preparing' | 'ready_for_pickup' | 'picked_up' | 'paid';
 declare const isOrderPending: (status: OrderStatus) => boolean;
 declare const isOrderCanceled: (status: OrderStatus) => boolean;
 declare const isOrderInFulfillment: (status: OrderStatus) => boolean;
@@ -2603,6 +2610,36 @@ declare const isPickupReady: (order: Pick<Order, "fulfillmentMethod"> & {
 declare const isPickupOrderReady: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
   fulfillments?: Order["fulfillments"] | null;
 }) => boolean;
+/** Next owner action for a local-pickup packing workstation. */
+type PickupNextAction = 'mark_ready' | 'mark_picked_up' | null;
+declare const getPickupNextAction: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+  items?: Order["items"];
+}) => PickupNextAction;
+/** Allowed manual status targets for pickup (illegal jumps stay out). Ready/picked-up go via fulfillment. */
+declare const getPickupEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Allowed manual status targets for shipping. Carrier ship stays on fulfillment; delivered closes the order. */
+declare const getShippingEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Allowed manual status targets for invoice/service orders (no fulfillment method). */
+declare const getInvoiceEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Manual owner-editable statuses for the order's fulfillment context. */
+declare const getEditableOrderStatuses: (status: OrderStatus, fulfillmentMethod?: string | null) => OrderStatus[];
+declare const canTransitionOrderStatus: (from: OrderStatus, to: OrderStatus, fulfillmentMethod?: string | null) => boolean;
+/** Owner fulfill dialog: payment → prepare → dispatch → complete. */
+type FulfillmentFlowStep = 'payment' | 'prepare' | 'dispatch' | 'complete';
+type FulfillmentFlowAction = 'notify_ready' | 'mark_collected' | 'mark_shipped' | 'mark_delivered' | null;
+declare const resolveFulfillmentFlowStep: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+}) => FulfillmentFlowStep | null;
+declare const getFulfillmentFlowAction: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+  items?: Order["items"];
+}) => FulfillmentFlowAction;
+/** Stepper index 0–3: payment → prepare → dispatch → complete. */
+declare const getFulfillmentFlowStepperIndex: (step: FulfillmentFlowStep | null) => number;
+declare const canOpenFulfillmentFlow: (order: Pick<Order, "fulfillmentMethod" | "status" | "type"> & {
+  items?: Order["items"];
+}) => boolean;
 //#endregion
 //#region src/commerce/helpers.d.ts
 type CartLine = {
@@ -2610,6 +2647,8 @@ type CartLine = {
   quantity: number;
 };
 declare const cartLineTotal: <T extends CartLine>(items: T[]) => number;
+/** Merchandise total after a discount (cents), never below zero. */
+declare const cartPayableTotal: <T extends CartLine>(items: T[], discountCents?: number) => number;
 declare const isCompleteAddressInput: (address: Pick<AddressInput, "name" | "addressOne" | "city" | "zipCode" | "country">) => boolean;
 //#endregion
 //#region src/budget/types.d.ts
@@ -2830,6 +2869,13 @@ type Document = {
   name: string;
   content: string | null;
   documentUrl: string | null;
+  sourceUrl?: string | null;
+  type?: string;
+  meta?: Record<string, unknown> | null;
+  slug?: string | null;
+  isPublic?: boolean;
+  url?: string | null;
+  archivedAt?: string | null;
   createdAt: string;
 };
 //#endregion
@@ -3689,15 +3735,6 @@ type OfficeEntity = {
 };
 //#endregion
 //#region src/ogimage/types.d.ts
-type OgImageType = 'default' | 'article' | 'category' | 'listing' | 'brand';
-type OgImageParams = {
-  type?: OgImageType;
-  title: string;
-  subtitle?: string;
-  category?: string;
-  categoryColor?: string;
-  brandLogo?: string;
-};
 declare const OG_IMAGE_WIDTH = 1200;
 declare const OG_IMAGE_HEIGHT = 630;
 declare const OG_IMAGE_CONFIG: {
@@ -3720,13 +3757,51 @@ declare const OgImageColors: {
 };
 //#endregion
 //#region src/ogimage/helpers.d.ts
-type OgResourceType = 'meeting';
+type OgResourceType = 'meeting' | 'action' | 'app' | 'actions' | 'apps' | 'changelog' | 'agent' | 'agents' | 'skill' | 'flow' | 'blueprint' | 'digest' | 'digests' | 'store' | 'product' | 'service';
 type OgResourceParams = {
   meeting: {
     code: string;
   };
+  action: {
+    slug: string;
+    locale?: string;
+  };
+  app: {
+    slug: string;
+    locale?: string;
+  };
+  actions: Record<string, never>;
+  apps: Record<string, never>;
+  changelog: Record<string, never>;
+  agent: {
+    id: string;
+    locale?: string;
+  };
+  agents: Record<string, never>;
+  skill: {
+    id: string;
+  };
+  flow: {
+    slug: string;
+  };
+  blueprint: {
+    slug: string;
+  };
+  digest: {
+    id: string;
+  };
+  digests: Record<string, never>;
+  store: Record<string, never>;
+  product: {
+    teamname: string;
+    slug: string;
+  };
+  service: {
+    teamname: string;
+    slug: string;
+  };
 };
-declare function ogImageUrl<T extends OgResourceType>(type: T, params: OgResourceParams[T]): string;
+declare function ogImageUrl<T extends OgResourceType>(type: T, params: OgResourceParams[T], env?: AppEnv): string;
 //#endregion
 //#region src/project/types.d.ts
 type ProjectStatus = 'draft' | 'planned' | 'render-ready' | 'rendered' | 'composed' | 'exported';
@@ -4720,4 +4795,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, 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, 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, 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, OgImageParams, OgImageType, 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, 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, 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, Swarm, Tag, TagType, Task, 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, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, 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, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, 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, 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, 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, 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, Swarm, Tag, TagType, Task, 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, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, 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, 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, withRetry };

package/dist/index.mjs

@@ -42,6 +42,12 @@ const getAgentsBaseUrl = (env) => {
 	if (env === "testnet") return "https://testnet-agents.joai.ai";
 	return "https://agents.joai.ai";
 };
+const getGenBaseUrl = (env) => {
+	if (env === "local") return "http://localhost:3011";
+	if (env === "devnet") return "https://devnet-gen.joai.ai";
+	if (env === "testnet") return "https://testnet-gen.joai.ai";
+	return "https://gen.joai.ai";
+};
 const getMcpServerUrl = (env) => `${getCortexBaseUrl(env)}/mcp`;
 const getMcpServerAgentUrl = (env, agent) => `${getCortexBaseUrl(env)}/mcp/agents/${agent}`;
 const getSitesBaseUrl = (env) => {
@@ -366,16 +372,22 @@ const AddressTypes = {
 const addressTypeValues = Object.values(AddressTypes);
 //#endregion
 //#region src/address/formatAddressSnapshot.ts
+const pickLine = (...values) => values.find((value) => typeof value === "string" && value.trim().length > 0);
+/** Accepts camelCase API snapshots and legacy snake_case stored snapshots. */
 const formatAddressSnapshotLines = (address) => {
 	if (!address) return [];
+	const loose = address;
+	const addressOne = pickLine(address.addressOne, loose.address_one);
+	const addressTwo = pickLine(address.addressTwo, loose.address_two);
+	const postalCity = [pickLine(address.zipCode, loose.zip_code), pickLine(address.city)].filter(Boolean).join(" ");
 	return [
-		address.company,
-		address.addressOne,
-		address.addressTwo,
-		[address.zipCode, address.city].filter(Boolean).join(" "),
-		address.state,
-		address.country
-	].filter((line) => !!line && line.trim().length > 0);
+		pickLine(address.company),
+		addressOne,
+		addressTwo,
+		postalCity || void 0,
+		pickLine(address.state),
+		pickLine(address.country)
+	].filter((line) => !!line);
 };
 //#endregion
 //#region src/billing/orderStatus.ts
@@ -399,10 +411,12 @@ const isOrderInFulfillment = (status) => ORDER_FULFILLMENT_STATUSES.includes(sta
 const isOrderPostCheckout = (status) => ORDER_POST_CHECKOUT_STATUSES.includes(status);
 const resolveOrderStatusDisplay = (status, fulfillmentMethod) => {
 	if (fulfillmentMethod === "pickup") {
+		if (status === "pending") return "new";
 		if (status === "confirmed" || status === "processing") return "preparing";
 		if (status === "shipped") return "ready_for_pickup";
 		if (status === "delivered") return "picked_up";
 	}
+	if (!fulfillmentMethod && status === "delivered") return "paid";
 	return status;
 };
 const isPickupReady = (order) => order.fulfillmentMethod === "pickup" && (order.fulfillments ?? []).some((fulfillment) => fulfillment.status === "ready_for_pickup");
@@ -416,6 +430,122 @@ const isPickupOrderReady = (order) => {
 	if (fulfillments.length === 0) return true;
 	return !fulfillments.some((fulfillment) => fulfillment.status === "delivered");
 };
+const getPickupNextAction = (order) => {
+	if (order.fulfillmentMethod !== "pickup") return null;
+	if (order.status === "delivered" || order.status === "canceled" || order.status === "returned") return null;
+	if (isPickupOrderReady(order) || order.status === "shipped") return "mark_picked_up";
+	if (isOrderInFulfillment(order.status) && (order.items ?? []).some((item) => !item.digital)) return "mark_ready";
+	return null;
+};
+/** Allowed manual status targets for pickup (illegal jumps stay out). Ready/picked-up go via fulfillment. */
+const getPickupEditableStatuses = (status) => {
+	if (status === "pending") return ["pending", "canceled"];
+	if (status === "confirmed") return [
+		"confirmed",
+		"processing",
+		"canceled"
+	];
+	if (status === "processing") return ["processing", "canceled"];
+	if (status === "shipped") return ["shipped", "canceled"];
+	if (status === "delivered") return ["delivered"];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Allowed manual status targets for shipping. Carrier ship stays on fulfillment; delivered closes the order. */
+const getShippingEditableStatuses = (status) => {
+	if (status === "pending") return ["pending", "canceled"];
+	if (status === "confirmed") return [
+		"confirmed",
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "processing") return [
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "shipped") return [
+		"shipped",
+		"delivered",
+		"canceled"
+	];
+	if (status === "delivered") return ["delivered"];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Allowed manual status targets for invoice/service orders (no fulfillment method). */
+const getInvoiceEditableStatuses = (status) => {
+	if (status === "pending") return [
+		"pending",
+		"delivered",
+		"canceled"
+	];
+	if (status === "confirmed") return [
+		"confirmed",
+		"delivered",
+		"canceled"
+	];
+	if (status === "processing") return [
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "shipped") return [
+		"shipped",
+		"delivered",
+		"canceled"
+	];
+	if (status === "delivered" || status === "completed") return [status];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Manual owner-editable statuses for the order's fulfillment context. */
+const getEditableOrderStatuses = (status, fulfillmentMethod) => {
+	if (fulfillmentMethod === "pickup") return getPickupEditableStatuses(status);
+	if (fulfillmentMethod === "shipping") return getShippingEditableStatuses(status);
+	return getInvoiceEditableStatuses(status);
+};
+const canTransitionOrderStatus = (from, to, fulfillmentMethod) => {
+	if (from === to) return true;
+	return getEditableOrderStatuses(from, fulfillmentMethod).includes(to);
+};
+const resolveFulfillmentFlowStep = (order) => {
+	if (!order.fulfillmentMethod) return null;
+	if (order.status === "canceled" || order.status === "returned") return "complete";
+	if (order.status === "pending") return "payment";
+	if (order.status === "delivered" || order.status === "completed") return "complete";
+	if (order.fulfillmentMethod === "pickup") {
+		if (isPickupOrderReady(order) || order.status === "shipped") return "dispatch";
+		return "prepare";
+	}
+	if (order.status === "shipped") return "dispatch";
+	return "prepare";
+};
+const getFulfillmentFlowAction = (order) => {
+	const step = resolveFulfillmentFlowStep(order);
+	if (step === "prepare" && isOrderInFulfillment(order.status)) {
+		if (!(order.items ?? []).some((item) => !item.digital)) return null;
+		return order.fulfillmentMethod === "pickup" ? "notify_ready" : "mark_shipped";
+	}
+	if (step === "dispatch") return order.fulfillmentMethod === "pickup" ? "mark_collected" : "mark_delivered";
+	return null;
+};
+/** Stepper index 0–3: payment → prepare → dispatch → complete. */
+const getFulfillmentFlowStepperIndex = (step) => {
+	if (step === "prepare") return 1;
+	if (step === "dispatch") return 2;
+	if (step === "complete") return 3;
+	return 0;
+};
+const canOpenFulfillmentFlow = (order) => {
+	if (!order.fulfillmentMethod || order.type !== "order") return false;
+	if (order.status === "canceled" || order.status === "returned") return false;
+	return (order.items ?? []).some((item) => !item.digital);
+};
 //#endregion
 //#region src/commerce/enums.ts
 const FulfillmentStatuses = {
@@ -449,6 +579,8 @@ const returnUpdateStatusValues = Object.values(ReturnUpdateStatuses);
 //#endregion
 //#region src/commerce/helpers.ts
 const cartLineTotal = (items) => items.reduce((total, item) => total + item.price * item.quantity, 0);
+/** Merchandise total after a discount (cents), never below zero. */
+const cartPayableTotal = (items, discountCents = 0) => Math.max(0, cartLineTotal(items) - Math.max(0, discountCents));
 const isCompleteAddressInput = (address) => Boolean(address.name.trim() && address.addressOne.trim() && address.city.trim() && address.zipCode.trim() && address.country.trim());
 //#endregion
 //#region src/budget/types.ts
@@ -600,10 +732,44 @@ const OgImageColors = {
 };
 //#endregion
 //#region src/ogimage/helpers.ts
-const OG_BASE = "https://gen.joai.ai/image/og";
-function ogImageUrl(type, params) {
+const withLocale = (path, locale) => {
+	if (!locale || locale === "en") return path;
+	return `${path}?locale=${encodeURIComponent(locale)}`;
+};
+function ogImageUrl(type, params, env = "mainnet") {
+	const base = `${getGenBaseUrl(env)}/image/og`;
 	switch (type) {
-		case "meeting": return `${OG_BASE}/meeting/${params.code}`;
+		case "meeting": return `${base}/meeting/${params.code}`;
+		case "action": {
+			const { slug, locale } = params;
+			return withLocale(`${base}/action/${encodeURIComponent(slug)}`, locale);
+		}
+		case "app": {
+			const { slug, locale } = params;
+			return withLocale(`${base}/app/${encodeURIComponent(slug)}`, locale);
+		}
+		case "actions": return `${base}/actions`;
+		case "apps": return `${base}/apps`;
+		case "changelog": return `${base}/changelog`;
+		case "agent": {
+			const { id, locale } = params;
+			return withLocale(`${base}/agent/${encodeURIComponent(id)}`, locale);
+		}
+		case "agents": return `${base}/agents`;
+		case "skill": return `${base}/skill/${encodeURIComponent(params.id)}`;
+		case "flow": return `${base}/flow/${encodeURIComponent(params.slug)}`;
+		case "blueprint": return `${base}/blueprint/${encodeURIComponent(params.slug)}`;
+		case "digest": return `${base}/digest/${encodeURIComponent(params.id)}`;
+		case "digests": return `${base}/digests`;
+		case "store": return `${base}/store`;
+		case "product": {
+			const { teamname, slug } = params;
+			return `${base}/store/${encodeURIComponent(teamname)}/${encodeURIComponent(slug)}`;
+		}
+		case "service": {
+			const { teamname, slug } = params;
+			return `${base}/store/service/${encodeURIComponent(teamname)}/${encodeURIComponent(slug)}`;
+		}
 	}
 }
 //#endregion
@@ -665,7 +831,8 @@ const NativeApps = {
 	Contracts: "contracts",
 	Artifacts: "artifacts",
 	Social: "social",
-	Studio: "studio"
+	Studio: "studio",
+	Loyalty: "loyalty"
 };
 const nativeAppSlugs = Object.values(NativeApps);
 const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);
@@ -763,4 +930,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, 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, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, 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, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };
+export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, 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, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, 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, 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, withRetry };

package/package.json

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