@joai/core 5.0.0 → 5.0.1

package/dist/index.d.mts

@@ -374,7 +374,7 @@ type ShippingCarrierOption = {
 };
 type Fulfillment = {
   id: string;
-  orderId: number;
+  orderId: string;
   method: FulfillmentMethod;
   status: FulfillmentStatus;
   carrierCode: string | null;
@@ -390,7 +390,8 @@ type Fulfillment = {
 };
 type Return = {
   id: string;
-  orderId: number;
+  orderId: string;
+  fulfillmentId?: string | null;
   status: ReturnStatus;
   reason: string;
   merchantNote: string | null;
@@ -398,8 +399,12 @@ type Return = {
     orderItemId: number;
     quantity: number;
     condition: string | null;
+    name?: string | null;
   }[];
   refundAmount: number | null;
+  suggestedRefundAmount?: number | null;
+  createdAt?: string;
+  order?: Order | null;
 };
 type SubscriptionDelivery = {
   fulfillmentMethod: FulfillmentMethod | null;
@@ -778,151 +783,6 @@ type Room = {
   integration: Integration | null;
 };
 //#endregion
-//#region src/meeting/types.d.ts
-type MeetingSessionState = 'idle' | 'listening' | 'ended';
-type TranscriptEntry = {
-  id: string;
-  text: string;
-  isFinal: boolean;
-  timestamp: number;
-  speakerId?: number;
-  speakerName?: string;
-};
-type BookmarkEntry = {
-  id: string;
-  timestamp: number;
-  transcriptEntryId: string;
-};
-type MeetingParticipant = {
-  name: string | null;
-  profileImageUrl: string | null;
-};
-type MeetingSpeakerAssignment = {
-  speakerId: number;
-  name: string;
-  contactId: string | null;
-};
-type Meeting = {
-  id: string;
-  code: string;
-  name: string | null;
-  room: Room | null;
-  inviteUrl: string;
-  status: MeetingStatus;
-  conferenceProvider: MeetingConferenceProvider | null;
-  conferenceUrl: string | null;
-  conferenceExternalId: string | null;
-  configuration?: Configuration;
-  captureMode: 'desktop_local' | null;
-  transcriptUrl: string | null;
-  summaryUrl: string | null;
-  participants?: MeetingParticipant[]; /** CRM contacts linked to an appointment booking, when available. */
-  contacts?: Contact[];
-  speakerAssignments?: MeetingSpeakerAssignment[] | null;
-  scheduledAt: string | null;
-  scheduledEndAt?: string | null;
-  timezone?: string | null;
-  calendarEventId: number | null;
-  startedAt: string | null;
-  endedAt: string | null;
-  createdAt: string;
-};
-type MeetingStatus = 'active' | 'completed' | 'analyzed' | 'scheduled' | 'cancelled';
-type MeetingConferenceProvider = 'google_meet' | 'teams' | 'zoom';
-type MeetingFeature = 'transcription' | 'summary' | 'insights' | 'actions';
-type MeetingJoinTeam = {
-  slug: string;
-  name: string;
-  logo: string | null;
-};
-type MeetingJoinInfo = {
-  id: string;
-  code: string;
-  name: string | null;
-  inviteUrl: string;
-  agentName: string;
-  team: MeetingJoinTeam;
-  status: MeetingStatus;
-  isPhysical: boolean;
-  scheduledAt: string | null;
-  scheduledEndAt: string | null;
-  timezone: string;
-  conferenceUrl: string | null;
-  conferenceProvider: MeetingConferenceProvider | null;
-  endedAt: string | null;
-  canCancel: boolean;
-  features: Record<MeetingFeature, boolean>;
-};
-type MeetingTranscriptEntry = {
-  speaker: 'user' | 'agent';
-  text: string;
-  timestamp: string;
-};
-type MeetingUsage = {
-  current: number;
-  limit: number;
-  reached: boolean;
-  remainingWords: number | null;
-};
-type MeetingSummary = {
-  content: string;
-};
-//#endregion
-//#region src/site/types.d.ts
-type SiteType = 'undefined' | 'shop';
-type SiteTeam = {
-  name: string;
-  slug: string;
-  logoUrl: string | null;
-};
-type SiteAgent = {
-  uuid: string | null;
-};
-type Site = {
-  id: number;
-  slug: string;
-  name: string | null;
-  url: string | null;
-  type: SiteType;
-  brandSlug: string | null;
-  customDomain: string | null;
-  enabled: boolean;
-  contactId?: string | null;
-  metricsSource?: string | null;
-  metricsResource?: string | null;
-  monthlyReport?: boolean;
-  team: SiteTeam | null;
-  agent: SiteAgent | null;
-  settings: Record<string, JsonValue>;
-};
-type SiteRoute = {
-  path: string;
-  warp: string;
-  label: WarpI18nText;
-  nav?: boolean;
-  hiddenFields?: string[];
-};
-type BrandSiteConfig = {
-  enabled: boolean;
-  auth?: boolean;
-  indexPath: string;
-  routes: SiteRoute[];
-  name?: string;
-  logoUrl?: string | null;
-};
-type SiteBrand = {
-  slug: string;
-  configureRoute: Pick<SiteRoute, 'path' | 'label'> | null;
-};
-type AggregatedRoute = {
-  path: string;
-  warp: string;
-  label: WarpI18nText;
-  nav?: boolean;
-  hiddenFields?: string[];
-  moduleSlug?: string;
-};
-//#endregion
 //#region src/flow/types.d.ts
 type FlowCategory = 'none' | 'defi' | 'nft' | 'social' | 'devtools' | 'productivity' | 'trading' | 'portfolio';
 type FlowStatus = 'draft' | 'published';
@@ -968,6 +828,7 @@ declare const UserPermissions: {
   readonly ContentPublish: "content-publish";
   readonly TeamMemberInvite: "team-member-invite";
   readonly TeamMemberRemove: "team-member-remove";
+  readonly TeamMemberRole: "team-member-role";
   readonly TeamSecretView: "team-secret-view";
   readonly TeamSecretManage: "team-secret-manage";
   readonly AgentExecute: "agent-execute";
@@ -1001,6 +862,9 @@ declare const isUserRole: (value: string) => value is UserRole;
 declare const InviteableTeamRoles: readonly ["member", "developer", "admin"];
 declare const DefaultInviteTeamRole: "member";
 declare const inviteableTeamRoles: () => UserRole[];
+/** Roles assignable to an existing member — unlike invites, ownership can be transferred. */
+declare const AssignableTeamRoles: readonly ["owner", "admin", "developer", "member"];
+declare const assignableTeamRoles: () => UserRole[];
 declare const defaultInviteTeamRole: () => UserRole;
 //#endregion
 //#region src/user/types.d.ts
@@ -1195,6 +1059,7 @@ type TeamMeta = {
   'shop.legal.withdrawal_url'?: string | null;
   'shop.legal.imprint_url'?: string | null;
   'orders.notify_emails'?: string[];
+  'orders.payment_reminders'?: boolean;
   contactPropertyMaskWarp?: string;
   branding?: TeamBrand | null;
   settings: Record<string, unknown> & {
@@ -1322,6 +1187,7 @@ type TeamSettings = {
   'shop.legal.withdrawal_url'?: string | null;
   'shop.legal.imprint_url'?: string | null;
   'orders.notify_emails'?: string[];
+  'orders.payment_reminders'?: boolean;
   branding?: TeamBrand | null;
 };
 type TeamUsage = Partial<Record<PlanFeature, TeamFeatureUsage>> & {
@@ -1379,6 +1245,152 @@ type AiCostsResponse = {
   };
 };
 //#endregion
+//#region src/meeting/types.d.ts
+type MeetingSessionState = 'idle' | 'listening' | 'ended';
+type TranscriptEntry = {
+  id: string;
+  text: string;
+  isFinal: boolean;
+  timestamp: number;
+  speakerId?: number;
+  speakerName?: string;
+};
+type BookmarkEntry = {
+  id: string;
+  timestamp: number;
+  transcriptEntryId: string;
+};
+type MeetingParticipant = {
+  name: string | null;
+  profileImageUrl: string | null;
+};
+type MeetingSpeakerAssignment = {
+  speakerId: number;
+  name: string;
+  contactId: string | null;
+};
+type Meeting = {
+  id: string;
+  code: string;
+  name: string | null;
+  room: Room | null;
+  inviteUrl: string;
+  status: MeetingStatus;
+  conferenceProvider: MeetingConferenceProvider | null;
+  conferenceUrl: string | null;
+  conferenceExternalId: string | null;
+  configuration?: Configuration;
+  captureMode: 'desktop_local' | null;
+  transcriptUrl: string | null;
+  summaryUrl: string | null;
+  participants?: MeetingParticipant[]; /** CRM contacts linked to an appointment booking, when available. */
+  contacts?: Contact[];
+  speakerAssignments?: MeetingSpeakerAssignment[] | null;
+  scheduledAt: string | null;
+  scheduledEndAt?: string | null;
+  timezone?: string | null;
+  calendarEventId: number | null;
+  startedAt: string | null;
+  endedAt: string | null;
+  createdAt: string;
+};
+type MeetingStatus = 'active' | 'completed' | 'analyzed' | 'scheduled' | 'cancelled';
+type MeetingConferenceProvider = 'google_meet' | 'teams' | 'zoom';
+type MeetingFeature = 'transcription' | 'summary' | 'insights' | 'actions';
+type MeetingJoinTeam = {
+  slug: string;
+  name: string;
+  logo: string | null;
+  place?: TeamPlace | null;
+};
+type MeetingJoinInfo = {
+  id: string;
+  code: string;
+  name: string | null;
+  inviteUrl: string;
+  agentName: string;
+  team: MeetingJoinTeam;
+  status: MeetingStatus;
+  isPhysical: boolean;
+  scheduledAt: string | null;
+  scheduledEndAt: string | null;
+  timezone: string;
+  conferenceUrl: string | null;
+  conferenceProvider: MeetingConferenceProvider | null;
+  endedAt: string | null;
+  canCancel: boolean;
+  features: Record<MeetingFeature, boolean>;
+};
+type MeetingTranscriptEntry = {
+  speaker: 'user' | 'agent';
+  text: string;
+  timestamp: string;
+};
+type MeetingUsage = {
+  current: number;
+  limit: number;
+  reached: boolean;
+  remainingWords: number | null;
+};
+type MeetingSummary = {
+  content: string;
+};
+//#endregion
+//#region src/site/types.d.ts
+type SiteType = 'undefined' | 'shop';
+type SiteTeam = {
+  name: string;
+  slug: string;
+  logoUrl: string | null;
+};
+type SiteAgent = {
+  uuid: string | null;
+};
+type Site = {
+  id: number;
+  slug: string;
+  name: string | null;
+  url: string | null;
+  type: SiteType;
+  brandSlug: string | null;
+  customDomain: string | null;
+  enabled: boolean;
+  contactId?: string | null;
+  metricsSource?: string | null;
+  metricsResource?: string | null;
+  monthlyReport?: boolean;
+  team: SiteTeam | null;
+  agent: SiteAgent | null;
+  settings: Record<string, JsonValue>;
+};
+type SiteRoute = {
+  path: string;
+  warp: string;
+  label: WarpI18nText;
+  nav?: boolean;
+  hiddenFields?: string[];
+};
+type BrandSiteConfig = {
+  enabled: boolean;
+  auth?: boolean;
+  indexPath: string;
+  routes: SiteRoute[];
+  name?: string;
+  logoUrl?: string | null;
+};
+type SiteBrand = {
+  slug: string;
+  configureRoute: Pick<SiteRoute, 'path' | 'label'> | null;
+};
+type AggregatedRoute = {
+  path: string;
+  warp: string;
+  label: WarpI18nText;
+  nav?: boolean;
+  hiddenFields?: string[];
+  moduleSlug?: string;
+};
+//#endregion
 //#region src/billing/types.d.ts
 type TranslatableValue = Partial<Record<WarpLocale, string>>;
 type OrderStatus = 'pending' | 'confirmed' | 'processing' | 'shipped' | 'completed' | 'delivered' | 'canceled' | 'returned';
@@ -2312,6 +2324,11 @@ type ArtifactDeliverPayload = {
   contactIds?: string[];
   agentId?: string;
 };
+type ArtifactDeliveryPreview = {
+  subject: string | null;
+  integration: ArtifactDeliverIntegration;
+  message: string;
+};
 type ArtifactDelivery = {
   id: string;
   contactId: string;
@@ -2336,6 +2353,7 @@ type Service = {
   digital: boolean;
   public: boolean;
   bookable: boolean;
+  order?: number | null;
   taxClassId?: string | null;
   settings?: Record<string, unknown> | null;
   createdAt: string;
@@ -2758,6 +2776,39 @@ declare const cartLineTotal: <T extends CartLine>(items: T[]) => number;
 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/commerce/returns.d.ts
+/** Pickup "collected" is `delivered`; goods must have left the shop before a return makes sense. */
+declare const RETURNABLE_FULFILLMENT_STATUSES: readonly FulfillmentStatus[];
+type ReturnableItem = {
+  item: OrderItem;
+  orderItemId: number;
+  quantity: number; /** Prefer this fulfillment when creating the return; null when quantity spans multiple. */
+  fulfillmentId: string | null;
+};
+type ReturnCreatePayload = {
+  fulfillmentId?: string;
+  items: {
+    orderItemId: number;
+    quantity: number;
+    condition?: string;
+  }[];
+};
+/** Physical quantities of a paid order that were shipped/delivered and are not yet in a non-rejected return. */
+declare const getReturnableItems: (order: Pick<Order, "items" | "status" | "fulfillments" | "returns">, returns?: Pick<Return, "status" | "items" | "fulfillmentId">[]) => ReturnableItem[];
+/**
+ * Split selected return quantities into create payloads, one per fulfillment when possible.
+ * Quantities without a single fulfillment go in an unscoped payload.
+ */
+declare const buildReturnCreatePayloads: (order: Pick<Order, "items" | "status" | "fulfillments" | "returns">, selected: {
+  orderItemId: number;
+  quantity: number;
+  condition?: string;
+}[], returns?: Pick<Return, "status" | "items" | "fulfillmentId">[]) => ReturnCreatePayload[];
+/** Customer-paid amount for returned units (includes proportional tax when prices are net). */
+declare const getReturnRefundAmount: (order: Pick<Order, "items" | "total"> & {
+  priceMode?: OrderPriceMode | null;
+}, request: Pick<Return, "items" | "suggestedRefundAmount" | "refundAmount">, alreadyRefunded?: number) => number;
+//#endregion
 //#region src/budget/types.d.ts
 type Budget = {
   id: number;
@@ -4267,6 +4318,96 @@ type LoyaltyProgram = {
   rewardCount: number;
   tierCount: number;
   memberCount: number;
+  rewards?: LoyaltyReward[];
+  tiers?: LoyaltyTier[]; /** Public view: collectable points only. Team view: all of them (edit through `updateProgram` settings.collect_points). */
+  collectPoints?: LoyaltyCollectPoint[];
+};
+type LoyaltyCollectLimit = 'once' | 'daily' | 'per_window';
+/** `daily`: the code changes every calendar day (team timezone, hard cut at midnight), so shared links stop working. */
+type LoyaltyCollectCodeRotation = 'none' | 'daily';
+type LoyaltyCollectPoint = {
+  id: number;
+  key: string;
+  name: string;
+  source: string;
+  points: number;
+  limit: LoyaltyCollectLimit;
+  windowMinutes: number | null;
+  startsAt: string | null;
+  endsAt: string | null;
+  active: boolean;
+  requiresCode: boolean; /** Present on every program view. `daily` means the code changes each team calendar day. */
+  codeRotation: LoyaltyCollectCodeRotation;
+  meta: Record<string, JsonValue> | null;
+  /**
+   * Staff / team program view only (`loyalty.getProgram()` without `team`), and only when
+   * `codeRotation` is `daily`: the code valid right now. Signed-in team members only: never on the public or customer
+   * view, and never for agent auth keys — do not rely on it there.
+   */
+  codeToday?: string; /** Same visibility as `codeToday` (signed-in team members only): when it stops working (next midnight in the team timezone). */
+  codeValidUntil?: string; /** Only for a signed-in customer with an account: a collect now would answer `already` (respects the limit window). */
+  collected?: boolean; /** Only for a signed-in customer: their latest collect at this point, also from earlier windows. */
+  collectedAt?: string | null; /** Only for a signed-in customer: when the next window opens while `collected` (daily / per_window). */
+  nextAvailableAt?: string | null;
+};
+/**
+ * One entry of `settings.collect_points` in `updateProgram`. The list replaces all collect points; entries match by key.
+ * Omit `code` to keep the existing one, `null` removes it. `codeRotation: 'daily'` replaces a fixed code with a daily
+ * code (do not send `code` then); omit `codeRotation` to keep the current mode.
+ */
+type LoyaltyCollectPointInput = {
+  key: string;
+  name: string;
+  source: string;
+  points: number;
+  limit?: LoyaltyCollectLimit;
+  windowMinutes?: number | null;
+  startsAt?: string | null;
+  endsAt?: string | null;
+  active?: boolean;
+  code?: string | null;
+  codeRotation?: LoyaltyCollectCodeRotation;
+  meta?: Record<string, JsonValue> | null;
+};
+type LoyaltyWalletAccount = {
+  contactId: string;
+  team: {
+    slug: string;
+    name: string;
+    logoUrl: string | null;
+  };
+  program: {
+    name: string;
+    settings: ProgramSettings;
+  };
+  points: number;
+  lifetimePoints: number;
+  tier: {
+    name: string;
+    multiplier: number;
+  } | null;
+  rewards: LoyaltyReward[];
+  updatedAt: string;
+};
+type LoyaltyJoinResponse = {
+  joined: boolean;
+  account: LoyaltyWalletAccount;
+};
+type LoyaltyCollectResponse = {
+  collected: boolean;
+  already: boolean;
+  joined: boolean;
+  points: number;
+  balance: number;
+  lifetimePoints: number;
+  tier: string | null;
+  nextAvailableAt: string | null;
+  collectPoint: {
+    id: number;
+    key: string;
+    name: string;
+    source: string;
+  };
 };
 type LoyaltyReward = {
   id: string;
@@ -4335,6 +4476,8 @@ type LoyaltyTransaction = {
   points: number;
   balanceAfter: number;
   description: string | null;
+  collectPointId?: number | null;
+  expiresAt?: string | null;
   createdAt: string;
 };
 type EarnResponse = {
@@ -4571,9 +4714,14 @@ type UpdateStats = {
 //#region src/social-post/types.d.ts
 type SocialPostPlatform = 'instagram' | 'x' | 'facebook' | 'linkedin';
 type SocialPostStatus = 'draft' | 'scheduled' | 'publishing' | 'published' | 'failed' | 'cancelled';
+type SocialPostAccount = {
+  id: string;
+  displayName: string;
+};
 type SocialPost = {
   id: string;
   platform: SocialPostPlatform;
+  accountId: string | null;
   status: SocialPostStatus;
   body: string | null;
   media: Media[];
@@ -4601,6 +4749,7 @@ type SharedSocialPost = {
 };
 type SocialPostCreatePayload = {
   platform: SocialPostPlatform;
+  accountId?: string | null;
   body?: string | null;
   media?: string[];
   exportId?: string | null;
@@ -4627,6 +4776,7 @@ type SocialPostConnection = {
   platform: SocialPostPlatform;
   connected: boolean;
   displayName: string | null;
+  accounts: SocialPostAccount[];
   minImages: number;
   maxImages: number;
   maxBodyLength: number;
@@ -4717,6 +4867,7 @@ declare const PermissionPresetNames: {
   readonly SecretManage: "secretManage";
   readonly TeamMemberInvite: "teamMemberInvite";
   readonly TeamMemberRemove: "teamMemberRemove";
+  readonly TeamMemberRole: "teamMemberRole";
   readonly AgentWalletManage: "agentWalletManage";
   readonly SwarmCreate: "swarmCreate";
 };
@@ -4905,4 +5056,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, type AddressType, AddressTypes, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentPolicyUpsert, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSkipReason, CampaignSkipReasons, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, CartLine, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CheckoutSnapshot, CheckoutSnapshotRequest, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactRelation, ContactRelationCategory, ContactRelationContact, ContactRelationDirection, ContactRelationPayload, ContactRelationType, ContactRelationUpdatePayload, ContactViewable, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentFlowAction, FulfillmentFlowStep, FulfillmentLocation, type FulfillmentMethod, FulfillmentMethods, type FulfillmentStatus, FulfillmentStatuses, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, GuestBuyer, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, ImageCompressionOptions, ImageCropOptions, ImageCropRectangle, ImageCropState, ImageDimensionRules, ImageDimensions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, InviteableTeamRoles, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Metric, MetricSource, MetricsResult, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, NATIVE_AUTH_TOKEN_PARAM, NativeApp, NativeApps, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, PickupNextAction, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDetailKind, ProductDetailRow, ProductDetailSection, ProductDetailText, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Return, type ReturnStatus, ReturnStatuses, ReturnUpdateStatus, ReturnUpdateStatuses, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, SupportedAppLocale, SupportedAppLocales, Swarm, Tag, TagType, Task, TaxBreakdownRow, TaxClass, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TeamViewAccess, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, UNIFIED_MCP_SERVER_NAME, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, type UserPermission, UserPermissions, UserPrivate, type UserRole, UserRoles, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };
+export { AUTOMATION_SEND_CHANNELS, Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, type AddressType, AddressTypes, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentPolicyUpsert, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactDeliveryPreview, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AssignableTeamRoles, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSkipReason, CampaignSkipReasons, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, CartLine, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CheckoutSnapshot, CheckoutSnapshotRequest, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactRelation, ContactRelationCategory, ContactRelationContact, ContactRelationDirection, ContactRelationPayload, ContactRelationType, ContactRelationUpdatePayload, ContactViewable, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentFlowAction, FulfillmentFlowStep, FulfillmentLocation, type FulfillmentMethod, FulfillmentMethods, type FulfillmentStatus, FulfillmentStatuses, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, GuestBuyer, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, ImageCompressionOptions, ImageCropOptions, ImageCropRectangle, ImageCropState, ImageDimensionRules, ImageDimensions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, InviteableTeamRoles, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyCollectCodeRotation, LoyaltyCollectLimit, LoyaltyCollectPoint, LoyaltyCollectPointInput, LoyaltyCollectResponse, LoyaltyJoinResponse, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, LoyaltyWalletAccount, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Metric, MetricSource, MetricsResult, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, NATIVE_AUTH_TOKEN_PARAM, NativeApp, NativeApps, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, PickupNextAction, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDetailKind, ProductDetailRow, ProductDetailSection, ProductDetailText, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RETURNABLE_FULFILLMENT_STATUSES, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Return, ReturnCreatePayload, type ReturnStatus, ReturnStatuses, ReturnUpdateStatus, ReturnUpdateStatuses, ReturnableItem, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, SharedSocialPost, ShippingCarrierOption, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostAccount, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, SupportedAppLocale, SupportedAppLocales, Swarm, Tag, TagType, Task, TaxBreakdownRow, TaxClass, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TeamViewAccess, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, UNIFIED_MCP_SERVER_NAME, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, type UserPermission, UserPermissions, UserPrivate, type UserRole, UserRoles, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, addressTypeValues, assignableTeamRoles, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, buildReturnCreatePayloads, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getReturnRefundAmount, getReturnableItems, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };

package/dist/index.mjs

@@ -686,6 +686,173 @@ const cartLineTotal = (items) => items.reduce((total, item) => total + item.pric
 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/commerce/returns.ts
+/** Pickup "collected" is `delivered`; goods must have left the shop before a return makes sense. */
+const RETURNABLE_FULFILLMENT_STATUSES = ["shipped", "delivered"];
+const resolveOrderItemId = (item) => typeof item.orderItemId === "number" && Number.isFinite(item.orderItemId) ? item.orderItemId : Number(item.id);
+const resolveFulfillmentId = (value) => {
+	if (value === null || value === void 0 || value === "") return null;
+	return String(value);
+};
+/** Physical quantities of a paid order that were shipped/delivered and are not yet in a non-rejected return. */
+const getReturnableItems = (order, returns = order.returns ?? []) => {
+	if (!isOrderInFulfillment(order.status)) return [];
+	const shippedByItem = /* @__PURE__ */ new Map();
+	(order.fulfillments ?? []).filter((fulfillment) => RETURNABLE_FULFILLMENT_STATUSES.includes(fulfillment.status)).forEach((fulfillment) => {
+		const fulfillmentId = resolveFulfillmentId(fulfillment.id);
+		if (fulfillmentId === null) return;
+		fulfillment.items.forEach((item) => {
+			const byFulfillment = shippedByItem.get(item.orderItemId) ?? /* @__PURE__ */ new Map();
+			byFulfillment.set(fulfillmentId, (byFulfillment.get(fulfillmentId) ?? 0) + item.quantity);
+			shippedByItem.set(item.orderItemId, byFulfillment);
+		});
+	});
+	returns.filter((request) => request.status !== "rejected").forEach((request) => {
+		const preferredFulfillmentId = resolveFulfillmentId(request.fulfillmentId);
+		request.items.forEach((item) => {
+			const byFulfillment = shippedByItem.get(item.orderItemId);
+			if (!byFulfillment) return;
+			let remaining = item.quantity;
+			if (preferredFulfillmentId !== null && byFulfillment.has(preferredFulfillmentId)) {
+				const available = byFulfillment.get(preferredFulfillmentId) ?? 0;
+				const used = Math.min(available, remaining);
+				byFulfillment.set(preferredFulfillmentId, available - used);
+				remaining -= used;
+			}
+			for (const [fulfillmentId, available] of byFulfillment) {
+				if (remaining <= 0) break;
+				if (preferredFulfillmentId !== null && fulfillmentId === preferredFulfillmentId) continue;
+				const used = Math.min(available, remaining);
+				byFulfillment.set(fulfillmentId, available - used);
+				remaining -= used;
+			}
+		});
+	});
+	return order.items.filter((item) => !item.digital && item.type !== "coupon").map((item) => {
+		const orderItemId = resolveOrderItemId(item);
+		const byFulfillment = shippedByItem.get(orderItemId) ?? /* @__PURE__ */ new Map();
+		const quantity = Math.min(item.quantity, [...byFulfillment.values()].reduce((sum, value) => sum + value, 0));
+		const fulfillmentIds = [...byFulfillment.entries()].filter(([, available]) => available > 0).map(([id]) => id);
+		return {
+			item,
+			orderItemId,
+			quantity,
+			fulfillmentId: fulfillmentIds.length === 1 ? fulfillmentIds[0] : null
+		};
+	}).filter(({ orderItemId, quantity }) => Number.isFinite(orderItemId) && quantity > 0);
+};
+/**
+* Split selected return quantities into create payloads, one per fulfillment when possible.
+* Quantities without a single fulfillment go in an unscoped payload.
+*/
+const buildReturnCreatePayloads = (order, selected, returns = order.returns ?? []) => {
+	const returnable = getReturnableItems(order, returns);
+	const remainingByItem = new Map(returnable.map((item) => [item.orderItemId, item.quantity]));
+	const fulfillmentPools = /* @__PURE__ */ new Map();
+	(order.fulfillments ?? []).filter((fulfillment) => RETURNABLE_FULFILLMENT_STATUSES.includes(fulfillment.status)).forEach((fulfillment) => {
+		const fulfillmentId = resolveFulfillmentId(fulfillment.id);
+		if (fulfillmentId === null) return;
+		const pool = /* @__PURE__ */ new Map();
+		fulfillment.items.forEach((item) => pool.set(item.orderItemId, (pool.get(item.orderItemId) ?? 0) + item.quantity));
+		fulfillmentPools.set(fulfillmentId, pool);
+	});
+	returns.filter((request) => request.status !== "rejected").forEach((request) => {
+		const preferredFulfillmentId = resolveFulfillmentId(request.fulfillmentId);
+		request.items.forEach((item) => {
+			let remaining = item.quantity;
+			if (preferredFulfillmentId !== null) {
+				const pool = fulfillmentPools.get(preferredFulfillmentId);
+				if (pool) {
+					const available = pool.get(item.orderItemId) ?? 0;
+					const used = Math.min(available, remaining);
+					pool.set(item.orderItemId, available - used);
+					remaining -= used;
+				}
+			}
+			for (const pool of fulfillmentPools.values()) {
+				if (remaining <= 0) break;
+				const available = pool.get(item.orderItemId) ?? 0;
+				const used = Math.min(available, remaining);
+				pool.set(item.orderItemId, available - used);
+				remaining -= used;
+			}
+		});
+	});
+	const payloads = /* @__PURE__ */ new Map();
+	selected.filter((item) => item.quantity > 0).forEach((item) => {
+		let remaining = Math.min(item.quantity, remainingByItem.get(item.orderItemId) ?? 0);
+		remainingByItem.set(item.orderItemId, (remainingByItem.get(item.orderItemId) ?? 0) - remaining);
+		const preferred = returnable.find((candidate) => candidate.orderItemId === item.orderItemId)?.fulfillmentId;
+		if (preferred !== null && preferred !== void 0) {
+			const pool = fulfillmentPools.get(preferred);
+			const available = pool?.get(item.orderItemId) ?? 0;
+			const used = Math.min(available, remaining);
+			if (used > 0) {
+				pool?.set(item.orderItemId, available - used);
+				const key = preferred;
+				const payload = payloads.get(key) ?? {
+					fulfillmentId: preferred,
+					items: []
+				};
+				payload.items.push({
+					orderItemId: item.orderItemId,
+					quantity: used,
+					condition: item.condition
+				});
+				payloads.set(key, payload);
+				remaining -= used;
+			}
+		}
+		for (const [fulfillmentId, pool] of fulfillmentPools) {
+			if (remaining <= 0) break;
+			if (preferred !== null && preferred !== void 0 && fulfillmentId === preferred) continue;
+			const available = pool.get(item.orderItemId) ?? 0;
+			const used = Math.min(available, remaining);
+			if (used <= 0) continue;
+			pool.set(item.orderItemId, available - used);
+			const payload = payloads.get(fulfillmentId) ?? {
+				fulfillmentId,
+				items: []
+			};
+			payload.items.push({
+				orderItemId: item.orderItemId,
+				quantity: used,
+				condition: item.condition
+			});
+			payloads.set(fulfillmentId, payload);
+			remaining -= used;
+		}
+		if (remaining > 0) {
+			const payload = payloads.get("unscoped") ?? { items: [] };
+			payload.items.push({
+				orderItemId: item.orderItemId,
+				quantity: remaining,
+				condition: item.condition
+			});
+			payloads.set("unscoped", payload);
+		}
+	});
+	return [...payloads.values()].filter((payload) => payload.items.length > 0);
+};
+/** Customer-paid amount for returned units (includes proportional tax when prices are net). */
+const getReturnRefundAmount = (order, request, alreadyRefunded = 0) => {
+	if (typeof request.suggestedRefundAmount === "number" && Number.isFinite(request.suggestedRefundAmount)) return Math.max(0, request.suggestedRefundAmount);
+	if (typeof request.refundAmount === "number" && request.refundAmount > 0) return request.refundAmount;
+	const amount = request.items.reduce((sum, returnItem) => {
+		const orderItem = order.items.find((item) => resolveOrderItemId(item) === returnItem.orderItemId);
+		if (!orderItem || orderItem.quantity < 1) return sum;
+		const quantity = Math.min(returnItem.quantity, orderItem.quantity);
+		const line = orderItem.unitPrice * quantity;
+		if ((order.priceMode ?? "gross") === "net") {
+			const tax = Math.round((orderItem.taxAmount ?? 0) * quantity / orderItem.quantity);
+			return sum + line + tax;
+		}
+		return sum + line;
+	}, 0);
+	const remaining = typeof order.total === "number" ? Math.max(0, order.total - alreadyRefunded) : amount;
+	return Math.max(0, Math.min(amount, remaining));
+};
+//#endregion
 //#region src/budget/types.ts
 const PeriodTypeLabels = {
 	0: "One-time",
@@ -951,6 +1118,7 @@ const UserPermissions = {
 	ContentPublish: "content-publish",
 	TeamMemberInvite: "team-member-invite",
 	TeamMemberRemove: "team-member-remove",
+	TeamMemberRole: "team-member-role",
 	TeamSecretView: "team-secret-view",
 	TeamSecretManage: "team-secret-manage",
 	AgentExecute: "agent-execute",
@@ -975,6 +1143,7 @@ const PermissionPresetNames = {
 	SecretManage: "secretManage",
 	TeamMemberInvite: "teamMemberInvite",
 	TeamMemberRemove: "teamMemberRemove",
+	TeamMemberRole: "teamMemberRole",
 	AgentWalletManage: "agentWalletManage",
 	SwarmCreate: "swarmCreate"
 };
@@ -988,6 +1157,7 @@ const permissionPresetRules = {
 	secretManage: teamManageOr(UserPermissions.TeamSecretManage),
 	teamMemberInvite: teamManageOr(UserPermissions.TeamMemberInvite),
 	teamMemberRemove: teamManageOr(UserPermissions.TeamMemberRemove),
+	teamMemberRole: teamManageOr(UserPermissions.TeamMemberRole),
 	agentWalletManage: teamManageOr(UserPermissions.AgentWalletManage),
 	swarmCreate: teamManageOr(UserPermissions.SwarmCreate)
 };
@@ -1032,6 +1202,14 @@ const InviteableTeamRoles = [
 ];
 const DefaultInviteTeamRole = UserRoles.Member;
 const inviteableTeamRoles = () => [...InviteableTeamRoles];
+/** Roles assignable to an existing member — unlike invites, ownership can be transferred. */
+const AssignableTeamRoles = [
+	UserRoles.Owner,
+	UserRoles.Admin,
+	UserRoles.Developer,
+	UserRoles.Member
+];
+const assignableTeamRoles = () => [...AssignableTeamRoles];
 const defaultInviteTeamRole = () => DefaultInviteTeamRole;
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, SupportedAppLocales, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };
+export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, AssignableTeamRoles, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultAppLocale, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, RETURNABLE_FULFILLMENT_STATUSES, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, SupportedAppLocales, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, assignableTeamRoles, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, buildReturnCreatePayloads, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, containedImageDimensions, createCursorMcpInstallLink, cropOutputDimensions, defaultInviteTeamRole, documentShareUrl, firstValidationMessage, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getDocumentsBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getReturnRefundAmount, getReturnableItems, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, imageCropRectangle, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isSupportedAppLocale, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, validateImageDimensions, validationMessageFor, withRetry };

package/package.json

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