@moonbase.sh/storefront-api 3.0.0 → 3.2.0

package/dist/index.d.cts

@@ -26,12 +26,47 @@ interface IStore {
     set: <TItem>(key: string, item: TItem) => void;
     remove: (key: string) => void;
     listen: <TItem>(key: string, callback: (item: TItem | null) => void) => void;
+    /**
+     * True once any storage operation has failed and the store has fallen back to
+     * memory. Optional so custom stores don't have to implement it.
+     */
+    readonly isDegraded?: boolean;
 }
+/**
+ * Whether `localStorage` can be reached at all.
+ *
+ * Deliberately *not* a write probe. Writability is not the right question here,
+ * because `LocalStorageStore` degrades per operation when a write fails, so a
+ * storage that reads fine but is at quota is still worth using: it is holding the
+ * buyer's existing session, and refusing it would throw away a perfectly readable
+ * sign-in and send them back to the login form. The only thing that makes
+ * `localStorage` unusable is not being able to touch it, which is what Firefox
+ * does (`SecurityError` from the property getter) when the buyer has blocked
+ * cookies and site data. That is why even the truthiness check sits inside a
+ * `try`.
+ */
+declare function isLocalStorageAvailable(): boolean;
+/**
+ * `localStorage`-backed store that degrades to memory instead of throwing.
+ *
+ * Storage can start failing at any point in a session, not just at construction:
+ * the origin hits quota, an extension clears site data, the profile's storage
+ * file goes corrupt. Since this is where the auth tokens live, an unhandled
+ * throw here surfaces as a failed sign-in for a buyer whose credentials were
+ * accepted. So every operation falls back to an in-memory copy. The session
+ * keeps working; it just stops surviving a reload.
+ */
 declare class LocalStorageStore implements IStore {
+    private readonly onDegraded?;
+    private readonly fallback;
+    private degraded;
+    constructor(onDegraded?: ((err: unknown) => void) | undefined);
+    get isDegraded(): boolean;
     get<TItem>(key: string): TItem | null;
     set<TItem>(key: string, item: TItem): void;
     remove(key: string): void;
     listen<TItem>(key: string, callback: (item: TItem | null) => void): void;
+    private reportDegraded;
 }
 declare class InMemoryStore implements IStore {
     private readonly store;
@@ -47,6 +82,7 @@ type IdentityWithExpiry = Identity & {
 };
 interface ITokenStore {
     get user(): User | null;
+    get isPersistent(): boolean;
     getAccessToken: () => Promise<string | null>;
     setUser: (user: Identity | User) => User | null;
     clear: () => void;
@@ -57,15 +93,26 @@ declare class TokenStore implements ITokenStore {
     private refreshTimeoutId;
     private refreshPromise;
     private readonly store;
+    private readonly logger;
     static readonly storageKey = "moonbase_auth";
     constructor(configuration: MoonbaseConfiguration);
     get user(): User | null;
+    get isPersistent(): boolean;
     getAccessToken(): Promise<string | null>;
     setUser(user: Identity | User): IdentityWithExpiry | null;
     clear(): null;
     private get isExpired();
+    /**
+     * Start a refresh and hold it so concurrent callers join it rather than firing
+     * their own. The slot is cleared as soon as it settles: a retained promise
+     * would hand every later expiry the same stale access token, and a rejected one
+     * that stayed put would re-throw on every subsequent request (including the
+     * anonymous ones) for the rest of the session.
+     */
+    private startRefresh;
     private refreshTokens;
     private handleStorageUpdate;
+    private warnAboutStorage;
 }
 
 type HttpMethods = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
@@ -1682,6 +1729,8 @@ declare const licenseSchema: z.ZodObject<{
         releaseDescription: z.ZodOptional<z.ZodString>;
         downloadsNeedsUser: z.ZodBoolean;
         downloadsNeedsOwnership: z.ZodBoolean;
+        downloadsNeedsGroupMembership: z.ZodBoolean;
+        downloadsAllowed: z.ZodBoolean;
         downloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             key: z.ZodString;
@@ -1749,6 +1798,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1783,6 +1834,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1850,6 +1903,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1903,6 +1958,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -2450,6 +2507,8 @@ declare const productSummarySchema: z.ZodObject<{
     releaseDescription: z.ZodOptional<z.ZodString>;
     downloadsNeedsUser: z.ZodBoolean;
     downloadsNeedsOwnership: z.ZodBoolean;
+    downloadsNeedsGroupMembership: z.ZodBoolean;
+    downloadsAllowed: z.ZodBoolean;
     downloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         key: z.ZodString;
@@ -2517,6 +2576,8 @@ declare const productSummarySchema: z.ZodObject<{
     currentVersion: string | null;
     downloadsNeedsUser: boolean;
     downloadsNeedsOwnership: boolean;
+    downloadsNeedsGroupMembership: boolean;
+    downloadsAllowed: boolean;
     description?: string | null | undefined;
     tagline?: string | null | undefined;
     website?: string | undefined;
@@ -2551,6 +2612,8 @@ declare const productSummarySchema: z.ZodObject<{
     currentVersion: string | null;
     downloadsNeedsUser: boolean;
     downloadsNeedsOwnership: boolean;
+    downloadsNeedsGroupMembership: boolean;
+    downloadsAllowed: boolean;
     description?: string | null | undefined;
     tagline?: string | null | undefined;
     website?: string | undefined;
@@ -22703,15 +22766,25 @@ type LineItem = z.infer<typeof openOrderLineItem>;
 type ProductLineItem = z.infer<typeof openProductLineItem>;
 type BundleLineItem = z.infer<typeof openBundleLineItem>;
 
+interface CheckoutUrlOptions {
+    /** Where to send the buyer once the checkout is done with them. */
+    returnUrl?: string;
+    /**
+     * Whether checkout will be rendered in the overlay iframe rather than as a
+     * full-page redirect. Tells the backend whether a checkout login token is
+     * worth minting: the returned `hostedCheckoutUrl` only carries one when this
+     * is not `false`. Say `false` whenever you intend to redirect, so a day-long
+     * credential is never minted for a URL that will not use it.
+     */
+    embedded?: boolean;
+}
 declare class OrderEndpoints {
     private api;
     constructor(api: MoonbaseApi);
     get(orderId: string, options?: {
         abort?: AbortSignal;
         finalize?: boolean;
-        checkout?: {
-            returnUrl?: string;
-        };
+        checkout?: CheckoutUrlOptions;
     }): Promise<{
         id: string;
         status: OrderStatus.Completed;
@@ -24102,9 +24175,7 @@ declare class OrderEndpoints {
             offerId?: string;
             replaced?: string[];
         })[];
-    }, checkout?: {
-        returnUrl?: string;
-    }, utm?: UrchinTrackingModule): Promise<OpenOrder>;
+    }, checkout?: CheckoutUrlOptions, utm?: UrchinTrackingModule): Promise<OpenOrder>;
     addBillingDetails(orderId: string, details: {
         name: string;
         email: string;
@@ -46733,6 +46804,18 @@ declare class OfferUtils {
     static progress(offer: StorefrontOffer, context: Order | OfferConditionContext): OfferProgress | null;
     private static evaluate;
     static relevantTargets(offer: StorefrontOffer, cartItems: LineItem[]): StorefrontOfferTarget[];
+    /**
+     * Whether every item an offer targets is already in the cart, so the offer has no upsell left to
+     * show.
+     *
+     * This is the set of offers the cart hides: a card inviting the buyer to add what they have already
+     * added says nothing, so it is dropped. Which makes it exactly the set whose discount nothing can
+     * currently claim: an offer is only good for one line, and there is no card left to spend it from.
+     *
+     * An offer with no targets names nothing and so is never in this set.
+     */
+    static allTargetsInCart(offer: StorefrontOffer, cartItems: LineItem[]): boolean;
+    private static targetInCart;
     static targetedVariations(target: StorefrontOfferTarget): PricingVariation[];
     static relevantTargetVariations(offer: StorefrontOffer, cartItems: LineItem[]): {
         target: StorefrontProduct | StorefrontBundle;
@@ -46764,6 +46847,7 @@ declare class CartUtils {
     static measure(catalog: CartCatalog, items: LineItem[], currency: string): Money | undefined;
     static conditionContext(catalog: CartCatalog, order: CartOrder, currency: string): OfferConditionContext;
     static cartOfferAppliesToLine(offer: StorefrontOffer, item: LineItem): boolean;
+    static offerTargetsLine(offer: StorefrontOffer, item: LineItem): boolean;
     static appliedCartOffer(catalog: CartCatalog, order: CartOrder, context: OfferConditionContext): StorefrontOffer | undefined;
     static total(catalog: CartCatalog, order: CartOrder, currency: string): CartTotal;
     static bestCartOffer(catalog: CartCatalog, order: CartOrder, currency: string): StorefrontOffer | undefined;
@@ -46776,6 +46860,54 @@ declare class CartUtils {
      * line discounted to a tenth of its price is worth less than 10% of a full-price one.
      */
     static cartOfferValue(catalog: CartCatalog, order: CartOrder, offer: StorefrontOffer, currency: string, context?: OfferConditionContext): number;
+    /**
+     * The item-scope offer worth attaching to a single line, or `undefined` when none is.
+     *
+     * Ranked by what it would actually take off this line rather than by percentage, the same way
+     * `bestCartOffer` ranks a cart: a flat amount off can beat a bigger-looking percentage on a cheap
+     * line, and the other way round on an expensive one.
+     *
+     * `unavailableOfferIds` are offers the rest of the cart has already claimed. An offer is only ever
+     * good for one line, since the cart treats an offer held by any line as in use. So a caller walking
+     * the cart must reserve each one as it goes, or two lines would both count on the same offer and
+     * the API would honour it once. `assignItemOffers` does that bookkeeping for a whole cart.
+     */
+    static bestItemOffer(catalog: CartCatalog, item: LineItem, currency: string, context: OfferConditionContext, unavailableOfferIds?: ReadonlySet<string>): StorefrontOffer | undefined;
+    /**
+     * Which item-scope offer to attach to which line, for the lines not already carrying one.
+     *
+     * Chosen for what the pairings are worth together rather than by cart order. An offer is only good
+     * for one line, so walking the cart and taking the best offer for each line in turn hands a
+     * multi-target offer to whichever line the buyer happened to add first, which is arbitrary and can
+     * be the cheapest one. A buyer claiming these from the upsell cards would have placed them where
+     * they are worth most, so that is what this does.
+     *
+     * Lines already holding an offer are left alone and their offers reserved: an offer on a line is
+     * intent, whether the buyer's from the upsell or the API's from a refreshed order, and this is not
+     * the place to second-guess it.
+     */
+    static assignItemOffers(catalog: CartCatalog, order: CartOrder, currency: string, context?: OfferConditionContext): {
+        itemId: string;
+        offerId: string;
+    }[];
+    /**
+     * The pairings worth the most together, given each offer can only be spent once.
+     *
+     * Taking the most valuable pairing first is not enough: with one offer worth 100 on line A and 99 on
+     * line B, and a second offer worth 98 on line A alone, claiming the 100 strands the second offer and
+     * saves 100, where putting the first offer on B and the second on A saves 197. The pairings have to
+     * be chosen as a set.
+     *
+     * Walked line by line, memoised on which offers are still free. The candidates have already been
+     * through targeting and eligibility, so in a real cart there are a handful; past `searchableOffers`
+     * distinct offers it takes the most valuable pairing first instead, which is never worse than
+     * applying nothing.
+     */
+    private static maximalItemOfferAssignment;
+    private static mostValuableItemOfferPairings;
+    private static readonly searchableOffers;
+    private static itemOfferCandidates;
+    private static itemOfferUnitDiscount;
     private static unitPriceAfterItemOffer;
 }
 
@@ -46947,4 +47079,4 @@ declare class MoonbaseClient {
     orders: OrderEndpoints;
 }
 
-export { type Activation, ActivationMethod, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type Address, Architecture, type BundleLineItem, type CartCatalog, type CartOrder, type CartTotal, type CartTotalCondition, CartUtils, type CommunicationPreferences, type CommunicationPreferencesInput, type CommunicationPreferencesView, type CompletedOrder, ConnectableAccountProvider, type ConnectedAccount, ConsoleLogger, CycleLength, type Discount, DiscountUtils, type Download, type DownloadManifest, type ILogger, type IRecurrence, type IStore, type ITokenStore, type Identity, type ImageFit, type ImageFormat, type ImageTransform, ImageUtils, InMemoryStore, type License, LicenseStatus, type LineItem, type LineItemTotal, LocalStorageStore, LogLevel, MarketingConsentType, type MilestoneProgress, type Money, type MoneyCollection, MoneyCollectionUtils, MoonbaseApi, MoonbaseClient, type MoonbaseConfiguration, MoonbaseError, NotAuthenticatedError, NotAuthorizedError, NotFoundError, type OfferCondition, type OfferConditionContext, type OfferProgress, type OfferScope, OfferUtils, type OpenOrder, type Order, OrderStatus, type OrderTotal, type OwnedProduct, type Page, Platform, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, type SignUpResult, type SingleOrMultiple, type Storefront, type StorefrontBundle, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type Voucher, imageWidths, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject };
+export { type Activation, ActivationMethod, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type Address, Architecture, type BundleLineItem, type CartCatalog, type CartOrder, type CartTotal, type CartTotalCondition, CartUtils, type CommunicationPreferences, type CommunicationPreferencesInput, type CommunicationPreferencesView, type CompletedOrder, ConnectableAccountProvider, type ConnectedAccount, ConsoleLogger, CycleLength, type Discount, DiscountUtils, type Download, type DownloadManifest, type ILogger, type IRecurrence, type IStore, type ITokenStore, type Identity, type ImageFit, type ImageFormat, type ImageTransform, ImageUtils, InMemoryStore, type License, LicenseStatus, type LineItem, type LineItemTotal, LocalStorageStore, LogLevel, MarketingConsentType, type MilestoneProgress, type Money, type MoneyCollection, MoneyCollectionUtils, MoonbaseApi, MoonbaseClient, type MoonbaseConfiguration, MoonbaseError, NotAuthenticatedError, NotAuthorizedError, NotFoundError, type OfferCondition, type OfferConditionContext, type OfferProgress, type OfferScope, OfferUtils, type OpenOrder, type Order, OrderStatus, type OrderTotal, type OwnedProduct, type Page, Platform, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, type SignUpResult, type SingleOrMultiple, type Storefront, type StorefrontBundle, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type Voucher, imageWidths, isLocalStorageAvailable, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject };

package/dist/index.d.ts

@@ -26,12 +26,47 @@ interface IStore {
     set: <TItem>(key: string, item: TItem) => void;
     remove: (key: string) => void;
     listen: <TItem>(key: string, callback: (item: TItem | null) => void) => void;
+    /**
+     * True once any storage operation has failed and the store has fallen back to
+     * memory. Optional so custom stores don't have to implement it.
+     */
+    readonly isDegraded?: boolean;
 }
+/**
+ * Whether `localStorage` can be reached at all.
+ *
+ * Deliberately *not* a write probe. Writability is not the right question here,
+ * because `LocalStorageStore` degrades per operation when a write fails, so a
+ * storage that reads fine but is at quota is still worth using: it is holding the
+ * buyer's existing session, and refusing it would throw away a perfectly readable
+ * sign-in and send them back to the login form. The only thing that makes
+ * `localStorage` unusable is not being able to touch it, which is what Firefox
+ * does (`SecurityError` from the property getter) when the buyer has blocked
+ * cookies and site data. That is why even the truthiness check sits inside a
+ * `try`.
+ */
+declare function isLocalStorageAvailable(): boolean;
+/**
+ * `localStorage`-backed store that degrades to memory instead of throwing.
+ *
+ * Storage can start failing at any point in a session, not just at construction:
+ * the origin hits quota, an extension clears site data, the profile's storage
+ * file goes corrupt. Since this is where the auth tokens live, an unhandled
+ * throw here surfaces as a failed sign-in for a buyer whose credentials were
+ * accepted. So every operation falls back to an in-memory copy. The session
+ * keeps working; it just stops surviving a reload.
+ */
 declare class LocalStorageStore implements IStore {
+    private readonly onDegraded?;
+    private readonly fallback;
+    private degraded;
+    constructor(onDegraded?: ((err: unknown) => void) | undefined);
+    get isDegraded(): boolean;
     get<TItem>(key: string): TItem | null;
     set<TItem>(key: string, item: TItem): void;
     remove(key: string): void;
     listen<TItem>(key: string, callback: (item: TItem | null) => void): void;
+    private reportDegraded;
 }
 declare class InMemoryStore implements IStore {
     private readonly store;
@@ -47,6 +82,7 @@ type IdentityWithExpiry = Identity & {
 };
 interface ITokenStore {
     get user(): User | null;
+    get isPersistent(): boolean;
     getAccessToken: () => Promise<string | null>;
     setUser: (user: Identity | User) => User | null;
     clear: () => void;
@@ -57,15 +93,26 @@ declare class TokenStore implements ITokenStore {
     private refreshTimeoutId;
     private refreshPromise;
     private readonly store;
+    private readonly logger;
     static readonly storageKey = "moonbase_auth";
     constructor(configuration: MoonbaseConfiguration);
     get user(): User | null;
+    get isPersistent(): boolean;
     getAccessToken(): Promise<string | null>;
     setUser(user: Identity | User): IdentityWithExpiry | null;
     clear(): null;
     private get isExpired();
+    /**
+     * Start a refresh and hold it so concurrent callers join it rather than firing
+     * their own. The slot is cleared as soon as it settles: a retained promise
+     * would hand every later expiry the same stale access token, and a rejected one
+     * that stayed put would re-throw on every subsequent request (including the
+     * anonymous ones) for the rest of the session.
+     */
+    private startRefresh;
     private refreshTokens;
     private handleStorageUpdate;
+    private warnAboutStorage;
 }
 
 type HttpMethods = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
@@ -1682,6 +1729,8 @@ declare const licenseSchema: z.ZodObject<{
         releaseDescription: z.ZodOptional<z.ZodString>;
         downloadsNeedsUser: z.ZodBoolean;
         downloadsNeedsOwnership: z.ZodBoolean;
+        downloadsNeedsGroupMembership: z.ZodBoolean;
+        downloadsAllowed: z.ZodBoolean;
         downloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             key: z.ZodString;
@@ -1749,6 +1798,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1783,6 +1834,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1850,6 +1903,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -1903,6 +1958,8 @@ declare const licenseSchema: z.ZodObject<{
         currentVersion: string | null;
         downloadsNeedsUser: boolean;
         downloadsNeedsOwnership: boolean;
+        downloadsNeedsGroupMembership: boolean;
+        downloadsAllowed: boolean;
         description?: string | null | undefined;
         tagline?: string | null | undefined;
         website?: string | undefined;
@@ -2450,6 +2507,8 @@ declare const productSummarySchema: z.ZodObject<{
     releaseDescription: z.ZodOptional<z.ZodString>;
     downloadsNeedsUser: z.ZodBoolean;
     downloadsNeedsOwnership: z.ZodBoolean;
+    downloadsNeedsGroupMembership: z.ZodBoolean;
+    downloadsAllowed: z.ZodBoolean;
     downloads: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         key: z.ZodString;
@@ -2517,6 +2576,8 @@ declare const productSummarySchema: z.ZodObject<{
     currentVersion: string | null;
     downloadsNeedsUser: boolean;
     downloadsNeedsOwnership: boolean;
+    downloadsNeedsGroupMembership: boolean;
+    downloadsAllowed: boolean;
     description?: string | null | undefined;
     tagline?: string | null | undefined;
     website?: string | undefined;
@@ -2551,6 +2612,8 @@ declare const productSummarySchema: z.ZodObject<{
     currentVersion: string | null;
     downloadsNeedsUser: boolean;
     downloadsNeedsOwnership: boolean;
+    downloadsNeedsGroupMembership: boolean;
+    downloadsAllowed: boolean;
     description?: string | null | undefined;
     tagline?: string | null | undefined;
     website?: string | undefined;
@@ -22703,15 +22766,25 @@ type LineItem = z.infer<typeof openOrderLineItem>;
 type ProductLineItem = z.infer<typeof openProductLineItem>;
 type BundleLineItem = z.infer<typeof openBundleLineItem>;
 
+interface CheckoutUrlOptions {
+    /** Where to send the buyer once the checkout is done with them. */
+    returnUrl?: string;
+    /**
+     * Whether checkout will be rendered in the overlay iframe rather than as a
+     * full-page redirect. Tells the backend whether a checkout login token is
+     * worth minting: the returned `hostedCheckoutUrl` only carries one when this
+     * is not `false`. Say `false` whenever you intend to redirect, so a day-long
+     * credential is never minted for a URL that will not use it.
+     */
+    embedded?: boolean;
+}
 declare class OrderEndpoints {
     private api;
     constructor(api: MoonbaseApi);
     get(orderId: string, options?: {
         abort?: AbortSignal;
         finalize?: boolean;
-        checkout?: {
-            returnUrl?: string;
-        };
+        checkout?: CheckoutUrlOptions;
     }): Promise<{
         id: string;
         status: OrderStatus.Completed;
@@ -24102,9 +24175,7 @@ declare class OrderEndpoints {
             offerId?: string;
             replaced?: string[];
         })[];
-    }, checkout?: {
-        returnUrl?: string;
-    }, utm?: UrchinTrackingModule): Promise<OpenOrder>;
+    }, checkout?: CheckoutUrlOptions, utm?: UrchinTrackingModule): Promise<OpenOrder>;
     addBillingDetails(orderId: string, details: {
         name: string;
         email: string;
@@ -46733,6 +46804,18 @@ declare class OfferUtils {
     static progress(offer: StorefrontOffer, context: Order | OfferConditionContext): OfferProgress | null;
     private static evaluate;
     static relevantTargets(offer: StorefrontOffer, cartItems: LineItem[]): StorefrontOfferTarget[];
+    /**
+     * Whether every item an offer targets is already in the cart, so the offer has no upsell left to
+     * show.
+     *
+     * This is the set of offers the cart hides: a card inviting the buyer to add what they have already
+     * added says nothing, so it is dropped. Which makes it exactly the set whose discount nothing can
+     * currently claim: an offer is only good for one line, and there is no card left to spend it from.
+     *
+     * An offer with no targets names nothing and so is never in this set.
+     */
+    static allTargetsInCart(offer: StorefrontOffer, cartItems: LineItem[]): boolean;
+    private static targetInCart;
     static targetedVariations(target: StorefrontOfferTarget): PricingVariation[];
     static relevantTargetVariations(offer: StorefrontOffer, cartItems: LineItem[]): {
         target: StorefrontProduct | StorefrontBundle;
@@ -46764,6 +46847,7 @@ declare class CartUtils {
     static measure(catalog: CartCatalog, items: LineItem[], currency: string): Money | undefined;
     static conditionContext(catalog: CartCatalog, order: CartOrder, currency: string): OfferConditionContext;
     static cartOfferAppliesToLine(offer: StorefrontOffer, item: LineItem): boolean;
+    static offerTargetsLine(offer: StorefrontOffer, item: LineItem): boolean;
     static appliedCartOffer(catalog: CartCatalog, order: CartOrder, context: OfferConditionContext): StorefrontOffer | undefined;
     static total(catalog: CartCatalog, order: CartOrder, currency: string): CartTotal;
     static bestCartOffer(catalog: CartCatalog, order: CartOrder, currency: string): StorefrontOffer | undefined;
@@ -46776,6 +46860,54 @@ declare class CartUtils {
      * line discounted to a tenth of its price is worth less than 10% of a full-price one.
      */
     static cartOfferValue(catalog: CartCatalog, order: CartOrder, offer: StorefrontOffer, currency: string, context?: OfferConditionContext): number;
+    /**
+     * The item-scope offer worth attaching to a single line, or `undefined` when none is.
+     *
+     * Ranked by what it would actually take off this line rather than by percentage, the same way
+     * `bestCartOffer` ranks a cart: a flat amount off can beat a bigger-looking percentage on a cheap
+     * line, and the other way round on an expensive one.
+     *
+     * `unavailableOfferIds` are offers the rest of the cart has already claimed. An offer is only ever
+     * good for one line, since the cart treats an offer held by any line as in use. So a caller walking
+     * the cart must reserve each one as it goes, or two lines would both count on the same offer and
+     * the API would honour it once. `assignItemOffers` does that bookkeeping for a whole cart.
+     */
+    static bestItemOffer(catalog: CartCatalog, item: LineItem, currency: string, context: OfferConditionContext, unavailableOfferIds?: ReadonlySet<string>): StorefrontOffer | undefined;
+    /**
+     * Which item-scope offer to attach to which line, for the lines not already carrying one.
+     *
+     * Chosen for what the pairings are worth together rather than by cart order. An offer is only good
+     * for one line, so walking the cart and taking the best offer for each line in turn hands a
+     * multi-target offer to whichever line the buyer happened to add first, which is arbitrary and can
+     * be the cheapest one. A buyer claiming these from the upsell cards would have placed them where
+     * they are worth most, so that is what this does.
+     *
+     * Lines already holding an offer are left alone and their offers reserved: an offer on a line is
+     * intent, whether the buyer's from the upsell or the API's from a refreshed order, and this is not
+     * the place to second-guess it.
+     */
+    static assignItemOffers(catalog: CartCatalog, order: CartOrder, currency: string, context?: OfferConditionContext): {
+        itemId: string;
+        offerId: string;
+    }[];
+    /**
+     * The pairings worth the most together, given each offer can only be spent once.
+     *
+     * Taking the most valuable pairing first is not enough: with one offer worth 100 on line A and 99 on
+     * line B, and a second offer worth 98 on line A alone, claiming the 100 strands the second offer and
+     * saves 100, where putting the first offer on B and the second on A saves 197. The pairings have to
+     * be chosen as a set.
+     *
+     * Walked line by line, memoised on which offers are still free. The candidates have already been
+     * through targeting and eligibility, so in a real cart there are a handful; past `searchableOffers`
+     * distinct offers it takes the most valuable pairing first instead, which is never worse than
+     * applying nothing.
+     */
+    private static maximalItemOfferAssignment;
+    private static mostValuableItemOfferPairings;
+    private static readonly searchableOffers;
+    private static itemOfferCandidates;
+    private static itemOfferUnitDiscount;
     private static unitPriceAfterItemOffer;
 }
 
@@ -46947,4 +47079,4 @@ declare class MoonbaseClient {
     orders: OrderEndpoints;
 }
 
-export { type Activation, ActivationMethod, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type Address, Architecture, type BundleLineItem, type CartCatalog, type CartOrder, type CartTotal, type CartTotalCondition, CartUtils, type CommunicationPreferences, type CommunicationPreferencesInput, type CommunicationPreferencesView, type CompletedOrder, ConnectableAccountProvider, type ConnectedAccount, ConsoleLogger, CycleLength, type Discount, DiscountUtils, type Download, type DownloadManifest, type ILogger, type IRecurrence, type IStore, type ITokenStore, type Identity, type ImageFit, type ImageFormat, type ImageTransform, ImageUtils, InMemoryStore, type License, LicenseStatus, type LineItem, type LineItemTotal, LocalStorageStore, LogLevel, MarketingConsentType, type MilestoneProgress, type Money, type MoneyCollection, MoneyCollectionUtils, MoonbaseApi, MoonbaseClient, type MoonbaseConfiguration, MoonbaseError, NotAuthenticatedError, NotAuthorizedError, NotFoundError, type OfferCondition, type OfferConditionContext, type OfferProgress, type OfferScope, OfferUtils, type OpenOrder, type Order, OrderStatus, type OrderTotal, type OwnedProduct, type Page, Platform, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, type SignUpResult, type SingleOrMultiple, type Storefront, type StorefrontBundle, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type Voucher, imageWidths, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject };
+export { type Activation, ActivationMethod, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type Address, Architecture, type BundleLineItem, type CartCatalog, type CartOrder, type CartTotal, type CartTotalCondition, CartUtils, type CommunicationPreferences, type CommunicationPreferencesInput, type CommunicationPreferencesView, type CompletedOrder, ConnectableAccountProvider, type ConnectedAccount, ConsoleLogger, CycleLength, type Discount, DiscountUtils, type Download, type DownloadManifest, type ILogger, type IRecurrence, type IStore, type ITokenStore, type Identity, type ImageFit, type ImageFormat, type ImageTransform, ImageUtils, InMemoryStore, type License, LicenseStatus, type LineItem, type LineItemTotal, LocalStorageStore, LogLevel, MarketingConsentType, type MilestoneProgress, type Money, type MoneyCollection, MoneyCollectionUtils, MoonbaseApi, MoonbaseClient, type MoonbaseConfiguration, MoonbaseError, NotAuthenticatedError, NotAuthorizedError, NotFoundError, type OfferCondition, type OfferConditionContext, type OfferProgress, type OfferScope, OfferUtils, type OpenOrder, type Order, OrderStatus, type OrderTotal, type OwnedProduct, type Page, Platform, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, type SignUpResult, type SingleOrMultiple, type Storefront, type StorefrontBundle, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type Voucher, imageWidths, isLocalStorageAvailable, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject };