@joai/core 4.15.2 → 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;
@@ -2222,6 +2228,8 @@ type Meeting = {
   contacts?: Contact[];
   speakerAssignments?: MeetingSpeakerAssignment[] | null;
   scheduledAt: string | null;
+  scheduledEndAt?: string | null;
+  timezone?: string | null;
   calendarEventId: number | null;
   startedAt: string | null;
   endedAt: string | null;
@@ -2580,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
@@ -2587,10 +2596,50 @@ 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 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;
 declare const isOrderPostCheckout: (status: OrderStatus) => boolean;
+declare const resolveOrderStatusDisplay: (status: OrderStatus, fulfillmentMethod?: string | null) => OrderStatusDisplay;
+declare const isPickupReady: (order: Pick<Order, "fulfillmentMethod"> & {
+  fulfillments?: Order["fulfillments"] | null;
+}) => boolean;
+/** True when a pickup order is waiting for the guest (fulfillment ready, or shipped without delivered fulfillments). */
+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 = {
@@ -2598,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
@@ -2818,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
@@ -3064,7 +3122,7 @@ declare const isUnifiedMcpUrl: (mcpUrl: string) => boolean;
 declare const getAgentSetupPromptUrl: (env: AppEnv) => string;
 declare const buildAgentSetupClipboardText: (env: AppEnv, target: AgentSetupTarget) => string;
 declare const buildAppSetupClipboardText: (env: AppEnv, target: AppSetupTarget) => string;
-/** Marketing / public pages: no known agent yet — unified MCP + OAuth agent pick. */
+/** Marketing / public pages: no known agent yet — unified MCP; OAuth UI handles login/agent pick. */
 declare const buildFeatureSetupClipboardText: (env: AppEnv, target?: FeatureSetupTarget) => string;
 declare const createCursorMcpInstallLink: (mcpServerUrl: string, serverName: string) => string;
 /** Default owner/connect MCP URL. Optional agent UUID soft-prefills OAuth via `?agent=`. */
@@ -3677,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: {
@@ -3708,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';
@@ -4340,6 +4427,7 @@ type Update = {
   linkUrl: string | null;
   startsAt: string | null;
   endsAt: string | null;
+  props?: Record<string, string>;
   team?: Team;
   createdAt: string;
   updatedAt: string;
@@ -4354,6 +4442,7 @@ type UpdateCreatePayload = {
   startsAt?: string;
   endsAt?: string;
   status?: UpdateStatus;
+  props?: Record<string, string>;
 };
 type UpdateUpdatePayload = Partial<UpdateCreatePayload>;
 type UpdateStats = {
@@ -4387,9 +4476,19 @@ type SocialPost = {
   canCancel: boolean;
   canRetry: boolean;
   canDelete: boolean;
+  shareUrl: string | null;
   createdAt: string;
   updatedAt: string;
 };
+type SharedSocialPost = {
+  platform: SocialPostPlatform;
+  status: SocialPostStatus;
+  body: string | null;
+  media: Media[];
+  scheduledAt: string | null;
+  publishedAt: string | null;
+  team: Team;
+};
 type SocialPostCreatePayload = {
   platform: SocialPostPlatform;
   body?: string | null;
@@ -4696,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, 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, 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, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, 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
@@ -397,6 +409,143 @@ const isOrderPending = (status) => status === "pending";
 const isOrderCanceled = (status) => status === "canceled";
 const isOrderInFulfillment = (status) => ORDER_FULFILLMENT_STATUSES.includes(status);
 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");
+/** True when a pickup order is waiting for the guest (fulfillment ready, or shipped without delivered fulfillments). */
+const isPickupOrderReady = (order) => {
+	if (order.fulfillmentMethod !== "pickup" || order.status === "delivered") return false;
+	if (isPickupReady(order)) return true;
+	if (order.status !== "shipped") return false;
+	const fulfillments = order.fulfillments;
+	if (!fulfillments) return true;
+	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 = {
@@ -430,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
@@ -496,9 +647,7 @@ const buildAgentSetupClipboardText = (env, target) => {
 		"",
 		"Connect me to JoAi MCP:",
 		`- MCP: ${target.mcpUrl}`,
-		`- Agent: ${target.agentName}`,
-		"",
-		"Authenticate with OAuth. The agent in the MCP URL is preselected and can be changed."
+		`- Agent: ${target.agentName}`
 	].join("\n");
 	return [
 		`Fetch and execute the appropriate instructions to set me up for JoAi from ${promptUrl}`,
@@ -519,7 +668,7 @@ const buildAppSetupClipboardText = (env, target) => {
 		`- MCP: ${target.mcpUrl}`
 	].join("\n");
 };
-/** Marketing / public pages: no known agent yet — unified MCP + OAuth agent pick. */
+/** Marketing / public pages: no known agent yet — unified MCP; OAuth UI handles login/agent pick. */
 const buildFeatureSetupClipboardText = (env, target = {}) => {
 	const promptUrl = getAgentSetupPromptUrl(env);
 	const mcpUrl = resolveConnectMcpUrl(env);
@@ -530,8 +679,6 @@ const buildFeatureSetupClipboardText = (env, target = {}) => {
 		"Connect me to JoAi MCP:",
 		`- MCP: ${mcpUrl}`,
 		"",
-		"Authenticate with OAuth when asked. If you don’t have an agent yet, create and name one there. Pick my team and agent during login.",
-		"",
 		featureName ? `Once connected, help me with JoAi ${featureName}.` : "Once connected, help me run JoAi."
 	];
 	if (target.taskHint?.trim()) lines.push(target.taskHint.trim());
@@ -585,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
@@ -650,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);
@@ -748,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, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, 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.2",
+  "version": "4.15.4",
   "description": "JoAi shared types, HTTP service, and config",
   "license": "MIT",
   "type": "module",