@moonbase.sh/storefront-api 3.11.0 → 3.13.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ZodTypeAny, z } from 'zod';
+import { z, ZodTypeAny } from 'zod';
 
 interface ILogger {
     debug: (message?: any, ...optionalParams: any[]) => void;
@@ -149,6 +149,361 @@ declare class TokenStore implements ITokenStore {
     private warnAboutStorage;
 }
 
+declare const moneySchema: z.ZodObject<{
+    currency: z.ZodString;
+    amount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    amount: number;
+}, {
+    currency: string;
+    amount: number;
+}>;
+declare const discountSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    promotionId: z.ZodOptional<z.ZodString>;
+    validFrom: z.ZodOptional<z.ZodString>;
+    validUntil: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"PercentageOffDiscount">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    percentage: z.ZodNumber;
+    total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    isExclusive: z.ZodBoolean;
+    recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: "PercentageOffDiscount";
+    percentage: number;
+    isExclusive: boolean;
+    description?: string | undefined;
+    total?: Record<string, number> | undefined;
+    recurringPaymentUseCount?: number | undefined;
+    promotionId?: string | undefined;
+    validFrom?: string | undefined;
+    validUntil?: string | undefined;
+}, {
+    name: string;
+    type: "PercentageOffDiscount";
+    percentage: number;
+    isExclusive: boolean;
+    description?: string | undefined;
+    total?: Record<string, number> | undefined;
+    recurringPaymentUseCount?: number | undefined;
+    promotionId?: string | undefined;
+    validFrom?: string | undefined;
+    validUntil?: string | undefined;
+}>, z.ZodObject<{
+    promotionId: z.ZodOptional<z.ZodString>;
+    validFrom: z.ZodOptional<z.ZodString>;
+    validUntil: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"FlatAmountOffDiscount">;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    isExclusive: z.ZodBoolean;
+    recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: "FlatAmountOffDiscount";
+    isExclusive: boolean;
+    description?: string | undefined;
+    total?: Record<string, number> | undefined;
+    recurringPaymentUseCount?: number | undefined;
+    promotionId?: string | undefined;
+    validFrom?: string | undefined;
+    validUntil?: string | undefined;
+}, {
+    name: string;
+    type: "FlatAmountOffDiscount";
+    isExclusive: boolean;
+    description?: string | undefined;
+    total?: Record<string, number> | undefined;
+    recurringPaymentUseCount?: number | undefined;
+    promotionId?: string | undefined;
+    validFrom?: string | undefined;
+    validUntil?: string | undefined;
+}>]>;
+declare const recurrenceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"OneOff">;
+}, "strip", z.ZodTypeAny, {
+    type: "OneOff";
+}, {
+    type: "OneOff";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"Recurring">;
+    cycleLength: z.ZodNativeEnum<typeof CycleLength>;
+}, "strip", z.ZodTypeAny, {
+    type: "Recurring";
+    cycleLength: CycleLength;
+}, {
+    type: "Recurring";
+    cycleLength: CycleLength;
+}>]>;
+declare const pricingTierSchema: z.ZodObject<{
+    minQuantity: z.ZodNumber;
+    originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    price: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    minQuantity: number;
+    originalPrice: Record<string, number>;
+    price: Record<string, number>;
+}, {
+    minQuantity: number;
+    originalPrice: Record<string, number>;
+    price: Record<string, number>;
+}>;
+declare const pricingVariationSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    price: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    hasDiscount: z.ZodBoolean;
+    discount: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        promotionId: z.ZodOptional<z.ZodString>;
+        validFrom: z.ZodOptional<z.ZodString>;
+        validUntil: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"PercentageOffDiscount">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        percentage: z.ZodNumber;
+        total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        isExclusive: z.ZodBoolean;
+        recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "PercentageOffDiscount";
+        percentage: number;
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    }, {
+        name: string;
+        type: "PercentageOffDiscount";
+        percentage: number;
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    }>, z.ZodObject<{
+        promotionId: z.ZodOptional<z.ZodString>;
+        validFrom: z.ZodOptional<z.ZodString>;
+        validUntil: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"FlatAmountOffDiscount">;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        isExclusive: z.ZodBoolean;
+        recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "FlatAmountOffDiscount";
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    }, {
+        name: string;
+        type: "FlatAmountOffDiscount";
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    }>]>>;
+    recurrence: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"OneOff">;
+    }, "strip", z.ZodTypeAny, {
+        type: "OneOff";
+    }, {
+        type: "OneOff";
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"Recurring">;
+        cycleLength: z.ZodNativeEnum<typeof CycleLength>;
+    }, "strip", z.ZodTypeAny, {
+        type: "Recurring";
+        cycleLength: CycleLength;
+    }, {
+        type: "Recurring";
+        cycleLength: CycleLength;
+    }>]>;
+    pricingTiers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        minQuantity: z.ZodNumber;
+        originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        price: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minQuantity: number;
+        originalPrice: Record<string, number>;
+        price: Record<string, number>;
+    }, {
+        minQuantity: number;
+        originalPrice: Record<string, number>;
+        price: Record<string, number>;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    originalPrice: Record<string, number>;
+    price: Record<string, number>;
+    hasDiscount: boolean;
+    recurrence: {
+        type: "OneOff";
+    } | {
+        type: "Recurring";
+        cycleLength: CycleLength;
+    };
+    discount?: {
+        name: string;
+        type: "PercentageOffDiscount";
+        percentage: number;
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    } | {
+        name: string;
+        type: "FlatAmountOffDiscount";
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    } | undefined;
+    pricingTiers?: {
+        minQuantity: number;
+        originalPrice: Record<string, number>;
+        price: Record<string, number>;
+    }[] | null | undefined;
+}, {
+    id: string;
+    name: string;
+    originalPrice: Record<string, number>;
+    price: Record<string, number>;
+    hasDiscount: boolean;
+    recurrence: {
+        type: "OneOff";
+    } | {
+        type: "Recurring";
+        cycleLength: CycleLength;
+    };
+    discount?: {
+        name: string;
+        type: "PercentageOffDiscount";
+        percentage: number;
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    } | {
+        name: string;
+        type: "FlatAmountOffDiscount";
+        isExclusive: boolean;
+        description?: string | undefined;
+        total?: Record<string, number> | undefined;
+        recurringPaymentUseCount?: number | undefined;
+        promotionId?: string | undefined;
+        validFrom?: string | undefined;
+        validUntil?: string | undefined;
+    } | undefined;
+    pricingTiers?: {
+        minQuantity: number;
+        originalPrice: Record<string, number>;
+        price: Record<string, number>;
+    }[] | null | undefined;
+}>;
+
+type Discount = z.infer<typeof discountSchema>;
+type PricingVariation = z.infer<typeof pricingVariationSchema>;
+type PricingTier = z.infer<typeof pricingTierSchema>;
+interface Page<T> {
+    items: Array<T>;
+    hasMore: boolean;
+    next: string | null;
+}
+interface Quantifiable<T> {
+    value: T;
+    quantity: number;
+}
+type SingleOrMultiple<T> = T | T[];
+interface RawPropertyObject {
+    [key: string]: RawPropertyValue;
+}
+type RawPropertyArray = RawPropertyValue[];
+type RawPropertyValue = string | number | boolean | null | RawPropertyObject | RawPropertyArray;
+declare enum CycleLength {
+    Daily = "Daily",
+    Weekly = "Weekly",
+    Monthly = "Monthly",
+    Quarterly = "Quarterly",
+    Yearly = "Yearly"
+}
+type IRecurrence = z.infer<typeof recurrenceSchema>;
+type Money = z.infer<typeof moneySchema>;
+declare enum MarketingConsentType {
+    OptIn = "OptIn",
+    OptedInByDefault = "OptedInByDefault",
+    OptOut = "OptOut"
+}
+/**
+ * A money collection is a dict of currency to amount
+ */
+type MoneyCollection = Record<string, number>;
+interface UrchinTrackingModule {
+    source?: string;
+    medium?: string;
+    campaign?: string;
+    term?: string;
+    content?: string;
+    referrer?: string;
+    /** Google Ads click ID, added to the landing page URL by auto-tagging. */
+    gclid?: string;
+    /** What Google Ads sends instead of `gclid` for some clicks on iOS. */
+    gbraid?: string;
+    /** What Google Ads sends instead of `gclid` for some clicks on iOS. */
+    wbraid?: string;
+    /** Meta click ID, added to links clicked on Facebook, Instagram and Messenger. */
+    fbclid?: string;
+    /** Microsoft Advertising click ID, added to the landing page URL by auto-tagging. */
+    msclkid?: string;
+    /** TikTok Ads click ID, added to the landing page URL of a TikTok ad. */
+    ttclid?: string;
+    /**
+     * The platforms whose click IDs were on the link. A click ID identifies the
+     * visitor's click, so the storefront only passes one on once the visitor has
+     * agreed to marketing cookies (`attributionConsent`). Until then it sends
+     * these instead, which still tell Moonbase the visit came from an ad.
+     */
+    adClicks?: AdPlatform[];
+}
+/** An ad platform whose click IDs Moonbase recognises on a link. */
+type AdPlatform = 'google' | 'microsoft' | 'meta' | 'tiktok';
+/**
+ * The query parameters for `utm`: the tags and referrer as `utm_*`, the ad
+ * click IDs under their own names (`gclid`, `gbraid`, `wbraid`, `fbclid`,
+ * `msclkid`, `ttclid`), as they appear on the landing page URL, and the
+ * platforms they came from as `utm_ad_click`. Fields left out are not sent.
+ */
+declare function utmToObject(utm?: UrchinTrackingModule): Record<string, string>;
+
 type HttpMethods = 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE';
 interface Response<T> {
     data: T;
@@ -1312,7 +1667,12 @@ declare class ActivationRequestEndpoints {
     get(requestId: string): Promise<ActivationRequest>;
     isCompleted(requestId: string): Promise<boolean>;
     fulfillLicense(requestId: string): Promise<ActivationRequest>;
-    fulfillTrial(requestId: string): Promise<ActivationRequest>;
+    /**
+     * Starts the trial the request's app asked for. `utm` is the tracking the visitor arrived with, which the
+     * trial is put down to, as a sign-up or an order is, so trials can be told apart by the marketing that
+     * brought them.
+     */
+    fulfillTrial(requestId: string, utm?: UrchinTrackingModule): Promise<ActivationRequest>;
     cancel(requestId: string): Promise<ActivationRequest>;
 }
 
@@ -1436,352 +1796,6 @@ declare class PendingPasswordStore {
     private write;
 }
 
-declare const moneySchema: z.ZodObject<{
-    currency: z.ZodString;
-    amount: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    currency: string;
-    amount: number;
-}, {
-    currency: string;
-    amount: number;
-}>;
-declare const discountSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-    promotionId: z.ZodOptional<z.ZodString>;
-    validFrom: z.ZodOptional<z.ZodString>;
-    validUntil: z.ZodOptional<z.ZodString>;
-    type: z.ZodLiteral<"PercentageOffDiscount">;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    percentage: z.ZodNumber;
-    total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    isExclusive: z.ZodBoolean;
-    recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "PercentageOffDiscount";
-    percentage: number;
-    isExclusive: boolean;
-    description?: string | undefined;
-    total?: Record<string, number> | undefined;
-    recurringPaymentUseCount?: number | undefined;
-    promotionId?: string | undefined;
-    validFrom?: string | undefined;
-    validUntil?: string | undefined;
-}, {
-    name: string;
-    type: "PercentageOffDiscount";
-    percentage: number;
-    isExclusive: boolean;
-    description?: string | undefined;
-    total?: Record<string, number> | undefined;
-    recurringPaymentUseCount?: number | undefined;
-    promotionId?: string | undefined;
-    validFrom?: string | undefined;
-    validUntil?: string | undefined;
-}>, z.ZodObject<{
-    promotionId: z.ZodOptional<z.ZodString>;
-    validFrom: z.ZodOptional<z.ZodString>;
-    validUntil: z.ZodOptional<z.ZodString>;
-    type: z.ZodLiteral<"FlatAmountOffDiscount">;
-    name: z.ZodString;
-    description: z.ZodOptional<z.ZodString>;
-    total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    isExclusive: z.ZodBoolean;
-    recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    name: string;
-    type: "FlatAmountOffDiscount";
-    isExclusive: boolean;
-    description?: string | undefined;
-    total?: Record<string, number> | undefined;
-    recurringPaymentUseCount?: number | undefined;
-    promotionId?: string | undefined;
-    validFrom?: string | undefined;
-    validUntil?: string | undefined;
-}, {
-    name: string;
-    type: "FlatAmountOffDiscount";
-    isExclusive: boolean;
-    description?: string | undefined;
-    total?: Record<string, number> | undefined;
-    recurringPaymentUseCount?: number | undefined;
-    promotionId?: string | undefined;
-    validFrom?: string | undefined;
-    validUntil?: string | undefined;
-}>]>;
-declare const recurrenceSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-    type: z.ZodLiteral<"OneOff">;
-}, "strip", z.ZodTypeAny, {
-    type: "OneOff";
-}, {
-    type: "OneOff";
-}>, z.ZodObject<{
-    type: z.ZodLiteral<"Recurring">;
-    cycleLength: z.ZodNativeEnum<typeof CycleLength>;
-}, "strip", z.ZodTypeAny, {
-    type: "Recurring";
-    cycleLength: CycleLength;
-}, {
-    type: "Recurring";
-    cycleLength: CycleLength;
-}>]>;
-declare const pricingTierSchema: z.ZodObject<{
-    minQuantity: z.ZodNumber;
-    originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    price: z.ZodRecord<z.ZodString, z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    minQuantity: number;
-    originalPrice: Record<string, number>;
-    price: Record<string, number>;
-}, {
-    minQuantity: number;
-    originalPrice: Record<string, number>;
-    price: Record<string, number>;
-}>;
-declare const pricingVariationSchema: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-    originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    price: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    hasDiscount: z.ZodBoolean;
-    discount: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-        promotionId: z.ZodOptional<z.ZodString>;
-        validFrom: z.ZodOptional<z.ZodString>;
-        validUntil: z.ZodOptional<z.ZodString>;
-        type: z.ZodLiteral<"PercentageOffDiscount">;
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        percentage: z.ZodNumber;
-        total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        isExclusive: z.ZodBoolean;
-        recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "PercentageOffDiscount";
-        percentage: number;
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    }, {
-        name: string;
-        type: "PercentageOffDiscount";
-        percentage: number;
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    }>, z.ZodObject<{
-        promotionId: z.ZodOptional<z.ZodString>;
-        validFrom: z.ZodOptional<z.ZodString>;
-        validUntil: z.ZodOptional<z.ZodString>;
-        type: z.ZodLiteral<"FlatAmountOffDiscount">;
-        name: z.ZodString;
-        description: z.ZodOptional<z.ZodString>;
-        total: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        isExclusive: z.ZodBoolean;
-        recurringPaymentUseCount: z.ZodOptional<z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        type: "FlatAmountOffDiscount";
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    }, {
-        name: string;
-        type: "FlatAmountOffDiscount";
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    }>]>>;
-    recurrence: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
-        type: z.ZodLiteral<"OneOff">;
-    }, "strip", z.ZodTypeAny, {
-        type: "OneOff";
-    }, {
-        type: "OneOff";
-    }>, z.ZodObject<{
-        type: z.ZodLiteral<"Recurring">;
-        cycleLength: z.ZodNativeEnum<typeof CycleLength>;
-    }, "strip", z.ZodTypeAny, {
-        type: "Recurring";
-        cycleLength: CycleLength;
-    }, {
-        type: "Recurring";
-        cycleLength: CycleLength;
-    }>]>;
-    pricingTiers: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        minQuantity: z.ZodNumber;
-        originalPrice: z.ZodRecord<z.ZodString, z.ZodNumber>;
-        price: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    }, "strip", z.ZodTypeAny, {
-        minQuantity: number;
-        originalPrice: Record<string, number>;
-        price: Record<string, number>;
-    }, {
-        minQuantity: number;
-        originalPrice: Record<string, number>;
-        price: Record<string, number>;
-    }>, "many">>>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    originalPrice: Record<string, number>;
-    price: Record<string, number>;
-    hasDiscount: boolean;
-    recurrence: {
-        type: "OneOff";
-    } | {
-        type: "Recurring";
-        cycleLength: CycleLength;
-    };
-    discount?: {
-        name: string;
-        type: "PercentageOffDiscount";
-        percentage: number;
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    } | {
-        name: string;
-        type: "FlatAmountOffDiscount";
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    } | undefined;
-    pricingTiers?: {
-        minQuantity: number;
-        originalPrice: Record<string, number>;
-        price: Record<string, number>;
-    }[] | null | undefined;
-}, {
-    id: string;
-    name: string;
-    originalPrice: Record<string, number>;
-    price: Record<string, number>;
-    hasDiscount: boolean;
-    recurrence: {
-        type: "OneOff";
-    } | {
-        type: "Recurring";
-        cycleLength: CycleLength;
-    };
-    discount?: {
-        name: string;
-        type: "PercentageOffDiscount";
-        percentage: number;
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    } | {
-        name: string;
-        type: "FlatAmountOffDiscount";
-        isExclusive: boolean;
-        description?: string | undefined;
-        total?: Record<string, number> | undefined;
-        recurringPaymentUseCount?: number | undefined;
-        promotionId?: string | undefined;
-        validFrom?: string | undefined;
-        validUntil?: string | undefined;
-    } | undefined;
-    pricingTiers?: {
-        minQuantity: number;
-        originalPrice: Record<string, number>;
-        price: Record<string, number>;
-    }[] | null | undefined;
-}>;
-
-type Discount = z.infer<typeof discountSchema>;
-type PricingVariation = z.infer<typeof pricingVariationSchema>;
-type PricingTier = z.infer<typeof pricingTierSchema>;
-interface Page<T> {
-    items: Array<T>;
-    hasMore: boolean;
-    next: string | null;
-}
-interface Quantifiable<T> {
-    value: T;
-    quantity: number;
-}
-type SingleOrMultiple<T> = T | T[];
-interface RawPropertyObject {
-    [key: string]: RawPropertyValue;
-}
-type RawPropertyArray = RawPropertyValue[];
-type RawPropertyValue = string | number | boolean | null | RawPropertyObject | RawPropertyArray;
-declare enum CycleLength {
-    Daily = "Daily",
-    Weekly = "Weekly",
-    Monthly = "Monthly",
-    Quarterly = "Quarterly",
-    Yearly = "Yearly"
-}
-type IRecurrence = z.infer<typeof recurrenceSchema>;
-type Money = z.infer<typeof moneySchema>;
-declare enum MarketingConsentType {
-    OptIn = "OptIn",
-    OptedInByDefault = "OptedInByDefault",
-    OptOut = "OptOut"
-}
-/**
- * A money collection is a dict of currency to amount
- */
-type MoneyCollection = Record<string, number>;
-interface UrchinTrackingModule {
-    source?: string;
-    medium?: string;
-    campaign?: string;
-    term?: string;
-    content?: string;
-    referrer?: string;
-    /** Google Ads click ID, added to the landing page URL by auto-tagging. */
-    gclid?: string;
-    /** What Google Ads sends instead of `gclid` for some clicks on iOS. */
-    gbraid?: string;
-    /** What Google Ads sends instead of `gclid` for some clicks on iOS. */
-    wbraid?: string;
-    /** Meta click ID, added to links clicked on Facebook, Instagram and Messenger. */
-    fbclid?: string;
-    /** Microsoft Advertising click ID, added to the landing page URL by auto-tagging. */
-    msclkid?: string;
-    /** TikTok Ads click ID, added to the landing page URL of a TikTok ad. */
-    ttclid?: string;
-}
-/**
- * The query parameters for `utm`: the tags and referrer as `utm_*`, and the ad
- * click IDs under their own names (`gclid`, `gbraid`, `wbraid`, `fbclid`,
- * `msclkid`, `ttclid`), as they appear on the landing page URL. Fields left out
- * are not sent.
- */
-declare function utmToObject(utm?: UrchinTrackingModule): Record<string, string>;
-
 declare const addressSchema: z.ZodObject<{
     countryCode: z.ZodString;
     streetAddress1: z.ZodString;
@@ -2368,6 +2382,13 @@ declare class IdentityEndpoints {
             hasSubscriptions?: boolean | null | undefined;
         };
     }>;
+    /**
+     * Saves the signed-in customer's address, which their next checkout starts from. A checkout
+     * they have already entered billing details in keeps those. Rejects with a `MoonbaseError` for
+     * an address the store can't use: it needs a known country, a street address, a city or a
+     * region, and in the US a postal code.
+     */
+    updateAddress(address: Address): Promise<User>;
     setPassword(currentPassword: string, newPassword: string): Promise<void>;
     forgotPassword(email: string): Promise<void>;
     resetPassword(email: string, newPassword: string, code: string): Promise<void>;
@@ -27252,6 +27273,7 @@ declare class StorefrontEndpoints {
             rate: number;
             region?: string | undefined;
         } | undefined;
+        cookieConsentRequired?: boolean | undefined;
     }>;
 }
 
@@ -51381,6 +51403,7 @@ declare const storefrontSchema: z.ZodObject<{
         rate: number;
         region?: string | undefined;
     }>>;
+    cookieConsentRequired: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     products: {
         id: string;
@@ -51875,6 +51898,7 @@ declare const storefrontSchema: z.ZodObject<{
         rate: number;
         region?: string | undefined;
     } | undefined;
+    cookieConsentRequired?: boolean | undefined;
 }, {
     products: {
         id: string;
@@ -52195,6 +52219,7 @@ declare const storefrontSchema: z.ZodObject<{
         rate: number;
         region?: string | undefined;
     } | undefined;
+    cookieConsentRequired?: boolean | undefined;
 }>;
 
 declare const schemas$1_offerConditionSchema: typeof offerConditionSchema;
@@ -52579,6 +52604,20 @@ declare const problemDetailsSchema: z.ZodObject<{
 }>;
 type ProblemDetails = z.infer<typeof problemDetailsSchema>;
 
+/**
+ * The platforms the click IDs in `utm` came from, together with any it already
+ * names in `adClicks`, each once; undefined when there are none, so a visit
+ * without an ad click carries no empty list.
+ */
+declare function adClicksOf(utm: UrchinTrackingModule | undefined): AdPlatform[] | undefined;
+/**
+ * `utm` without the values of its ad click IDs, which identify the visitor's
+ * click, but still naming in `adClicks` the platforms they came from, which
+ * identify no one. This is what the storefront keeps and sends until the
+ * visitor has agreed to marketing cookies: the visit still counts as an ad
+ * click, and a sale from it is still put down to the ad's tags.
+ */
+declare function withoutClickIds(utm: UrchinTrackingModule): UrchinTrackingModule;
 /**
  * Returns the host of `rawReferrer` if it parses as a URL with a different
  * origin from `currentOrigin`. Returns `undefined` for same-origin (internal
@@ -52611,7 +52650,25 @@ declare function resolveUtm(cached: UrchinTrackingModule | undefined, fresh: Urc
 
 interface MoonbaseConfiguration {
     endpoint: string;
+    /**
+     * Keep the attribution a visitor arrived with in localStorage, across visits,
+     * rather than in sessionStorage for the tab. Only with the visitor's consent
+     * (see `attributionConsent`), as it remembers them beyond the visit; a refusal
+     * removes it.
+     */
     persistUtm?: boolean;
+    /**
+     * Whether the visitor has agreed to marketing cookies, as your cookie banner
+     * reports it, so `@moonbase.sh/vue` may keep and send the ad click IDs on the
+     * landing page URL (`gclid`, `fbclid` and the rest) and record a tagged arrival
+     * before they put anything in the cart. Without them it keeps only the UTM
+     * tags, the referring site and which ad platforms the click IDs came from, for
+     * the tab. Left out, the storefront follows the store's own setting in Moonbase
+     * (always, per country, or only with cookie consent), which the catalog
+     * reports for this visitor as `cookieConsentRequired`. Change it later with
+     * `setAttributionConsent()`.
+     */
+    attributionConsent?: boolean;
     includeManifests?: boolean;
     store?: IStore;
     logger?: ILogger;
@@ -52641,4 +52698,4 @@ declare class MoonbaseClient {
     orders: OrderEndpoints;
 }
 
-export { type Activation, ActivationMethod, type ActivationReleaseNotCovered, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type Address, Architecture, type BundleLineItem, CaptchaRequiredError, 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, type LicenseReleaseAccess, 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, PasswordSetupRequiredError, type PendingPlanChange, Platform, type PricingOption, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type ProductRelease, type ProductReleaseAccess, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, ReleaseNotCoveredError, type SignUpOptions, type SignUpResult, type SingleOrMultiple, StoreClosedError, type Storefront, type StorefrontBundle, type StorefrontLicenseUpgrade, type StorefrontLicenseUpgradeReleaseAccess, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, type SubscriptionCancellationFeedback, SubscriptionCancellationReason, type SubscriptionPlanOption, type SubscriptionPlanOptions, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type VendorCaptcha, type VendorFeatures, type Voucher, accessTokenLifetime, imageWidths, isLocalStorageAvailable, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, normalizeGroupIds, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject };
+export { type Activation, ActivationMethod, type ActivationReleaseNotCovered, type ActivationRequest, ActivationRequestFulfillmentType, ActivationRequestStatus, ActivationStatus, type AdPlatform, type Address, Architecture, type BundleLineItem, CaptchaRequiredError, 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, type LicenseReleaseAccess, 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, PasswordSetupRequiredError, type PendingPlanChange, Platform, type PricingOption, type PricingTier, type PricingVariation, type ProblemDetails, type ProductLineItem, type ProductRelease, type ProductReleaseAccess, type PromotionDisplay, type Quantifiable, type RawPropertyArray, type RawPropertyObject, type RawPropertyValue, ReleaseNotCoveredError, type SignUpOptions, type SignUpResult, type SingleOrMultiple, StoreClosedError, type Storefront, type StorefrontBundle, type StorefrontLicenseUpgrade, type StorefrontLicenseUpgradeReleaseAccess, type StorefrontOffer, type StorefrontOfferTarget, type StorefrontProduct, type StorefrontPromotion, type StorefrontPromotionCta, type StorefrontPromotionTarget, type SubscribeInput, type SubscribeResponse, type Subscription, type SubscriptionCancellationFeedback, SubscriptionCancellationReason, type SubscriptionPlanOption, type SubscriptionPlanOptions, SubscriptionStatus, type TaxEstimate, TokenStore, type UrchinTrackingModule, type User, type UserAccountConfirmed, type UserAccountConfirmedStatus, type Vendor, type VendorCaptcha, type VendorFeatures, type Voucher, accessTokenLifetime, adClicksOf, imageWidths, isLocalStorageAvailable, isPromotionDisplay, isTransformableImageUrl, maxImageDimension, normalizeGroupIds, objectToQuery, parseOffSiteReferrer, problemDetailsSchema, promotionDisplays, resolveUtm, schemas, utmToObject, withoutClickIds };