efficient-storefront-blocks 0.56.0 → 0.58.0

package/dist/render/lib/api/index.d.ts

@@ -0,0 +1,806 @@
+import type { AdminFieldUsageRow } from "../links/link-rules.js";
+import type { TyreFitVehicleQuery } from "../tyres/tyre-vehicle-fitment.js";
+import type { SocialPlatform } from "efficient-web-builder/format/lib/content/social-links";
+import type { SiteThemeRow, SiteThemeRowPatch } from "efficient-web-builder/format/lib/site-theme-row";
+export declare const API_URL: string;
+export declare class ApiError extends Error {
+    status: number;
+    data: unknown;
+    constructor(status: number, message: string, data: unknown);
+}
+export declare const SERVER_UNREACHABLE_MESSAGE: string;
+export declare const STATUS_NETWORK_ERROR = 0;
+export declare const EFFICIENT_CLIENT_CLOSED_MESSAGE = "This editor runs on its host's own backend, which does not serve this request.";
+export declare const SERVER_READ_TIMEOUT_MS = 5000;
+export declare const BROWSER_READ_TIMEOUT_MS = 15000;
+export declare const readDeadlineMs: () => number;
+export declare function defaultRequestDeadline(req: Pick<RequestInit, 'method' | 'body'> & {
+    audience?: PortalAudience | null;
+}): AbortSignal | undefined;
+type PortalAudience = 'shop' | EditorPortalAudience;
+export type EditorPortalAudience = 'admin' | 'venue';
+export declare function setEditorPortalAudience(audience: EditorPortalAudience): void;
+export declare function editorPortalAudience(): EditorPortalAudience;
+export declare function setEditorLanguage(language: string | null): void;
+export declare function editorRequestLanguage(): string | null;
+type RequestOpts = RequestInit & {
+    token?: string | null;
+    baseUrl?: string;
+    audience?: PortalAudience | null;
+};
+export declare function apiFetch<T = unknown>(path: string, opts?: RequestOpts): Promise<T>;
+declare function loadShopMe(): Promise<ShopMe>;
+export declare const api: {
+    login: (email: string, password: string) => Promise<{
+        access: string;
+        refresh?: string;
+    }>;
+    refresh: (refresh?: string) => Promise<{
+        access: string;
+        refresh?: string;
+    }>;
+    logout: () => Promise<void>;
+    restoreSession: () => Promise<string>;
+    me: typeof loadShopMe;
+    updateMe: (patch: Partial<ShopMe>) => Promise<ShopMe>;
+    changePassword: (oldPassword: string, newPassword: string) => Promise<ShopMe>;
+    changeEmail: (newEmail: string, currentPassword: string) => Promise<ShopMe>;
+    myProfile: () => Promise<ShopProfile>;
+    updateMyProfile: (patch: Partial<ShopProfile>) => Promise<ShopProfile>;
+    myAddresses: () => Promise<ShopAddress[]>;
+    createAddress: (body: Partial<ShopAddress>) => Promise<ShopAddress>;
+    updateAddress: (id: string, patch: Partial<ShopAddress>) => Promise<ShopAddress>;
+    deleteAddress: (id: string) => Promise<void>;
+    passwordResetRequest: (email: string) => Promise<{
+        detail: string;
+    }>;
+    passwordResetConfirm: (uid: string, token: string, newPassword: string) => Promise<{
+        detail: string;
+    }>;
+    brands: () => Promise<Paginated<Brand>>;
+    myOrders: () => Promise<ShopOrder[]>;
+    myOrder: (id: string) => Promise<ShopOrder>;
+    cancelOrder: (id: string) => Promise<ShopOrder>;
+    myReturns: (orderId?: string) => Promise<ShopReturn[]>;
+    createReturn: (payload: {
+        order: string;
+        shipment?: string;
+        notes?: string;
+        items: {
+            part_number: string;
+            quantity_claim: number;
+            reason?: string;
+        }[];
+    }) => Promise<ShopReturn>;
+    withdrawReturn: (id: string) => Promise<ShopReturn>;
+    uploadReturnPhoto: (claimItemId: string, file: File) => Promise<ShopReturnMedia>;
+};
+export interface ShopMe {
+    id: number;
+    email: string;
+    username: string;
+    first_name: string;
+    last_name: string;
+    phone: string;
+    portal: 'shop';
+    default_delivery_location: string | null;
+}
+export interface ShopProfile {
+    id: string;
+    cid: string;
+    company_name: string;
+    contact_name: string;
+    email: string;
+    phone: string;
+    address: string;
+    city: string;
+    state: string;
+    zip_code: string;
+    country: string;
+    currency: string;
+}
+export interface ShopAddress {
+    id: string;
+    customer: string;
+    label: string;
+    contact_name: string;
+    phone: string;
+    email: string;
+    address: string;
+    city: string;
+    state: string;
+    zip_code: string;
+    country: string;
+    instructions: string;
+    is_active: boolean;
+    formatted_address: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface ShopOrder {
+    id: string;
+    proforma_number: string;
+    status: string;
+    order_date: string;
+    currency: string;
+    total_amount?: string;
+    delivery_address?: string;
+    items?: {
+        part_number: string;
+        quantity: number;
+        unit_price: string;
+        description?: string;
+        total_price?: string;
+        line_number?: number;
+    }[];
+    shipments?: ShopShipment[];
+    can_cancel?: boolean;
+    can_request_return?: boolean;
+}
+export interface ShopShipment {
+    id: string;
+    shipment_number: string;
+    status: string;
+    shipping_type: string;
+    shipment_date: string | null;
+    etd: string | null;
+    eta: string | null;
+    tracking_number: string;
+    forwarder: string;
+    items?: {
+        part_number: string;
+        description: string;
+        quantity: number;
+    }[];
+}
+export interface ShopReturnMedia {
+    id: string;
+    claim_item: string;
+    file_url: string | null;
+    media_type: string;
+    caption: string;
+}
+export interface ShopReturnItem {
+    id: string;
+    line_number: number;
+    part_number: string;
+    description: string;
+    quantity_claim: number;
+    reason: string;
+    media_files?: ShopReturnMedia[];
+}
+export interface ShopReturn {
+    id: string;
+    claim_number: string;
+    status: string;
+    claim_date: string;
+    notes: string;
+    shipment: string | null;
+    shipment_number: string;
+    order: string | null;
+    order_number: string;
+    items: ShopReturnItem[];
+    created_at?: string;
+    updated_at?: string;
+}
+export type Paginated<T> = {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: T[];
+};
+export type Brand = {
+    id: number;
+    code: string;
+    name: string;
+    website: string;
+    is_active: boolean;
+    logo_url: string | null;
+    client_name: string;
+    design_count: number;
+};
+import type { components } from "./types.js";
+export declare function resolveMediaUrls<T>(value: T): T;
+export type Process = components["schemas"]["Process"];
+export type FinishFamily = components["schemas"]["FinishFamily"];
+export type Badge = components["schemas"]["Badge"];
+export type Currency = components["schemas"]["Currency"];
+export type Prices = components["schemas"]["Prices"];
+export type CountrySubdivision = components["schemas"]["CountrySubdivision"];
+export type CartQuote = components["schemas"]["CartQuote"];
+export type CartQuoteRequest = components["schemas"]["CartQuoteRequest"];
+export type Finish = components["schemas"]["Finish"];
+export type FinishFeature = components["schemas"]["FinishFeature"];
+export type WheelSpec = components["schemas"]["WheelSpec"];
+export type FitmentRow = components["schemas"]["FitmentRow"];
+export type MediaGroupItem = components["schemas"]["MediaGroupItem"];
+export type MediaGroup = components["schemas"]["MediaGroup"];
+export type MediaGroups = components["schemas"]["MediaGroups"];
+export type WheelSummary = components["schemas"]["WheelSummary"];
+export type Wheel = components["schemas"]["Wheel"];
+export type ProductKind = components["schemas"]["ProductKind"];
+export type ProductSummary = components["schemas"]["ProductSummary"];
+export type AlloyWheelProductSummary = components["schemas"]["AlloyWheelProductSummary"];
+export type TyreSummary = components["schemas"]["TyreSummary"];
+export type TyreProductSummary = components["schemas"]["TyreProductSummary"];
+export type Bundle = components["schemas"]["Bundle"];
+export type BundleComponent = components["schemas"]["BundleComponent"];
+export type AppliedBundle = components["schemas"]["AppliedBundle"];
+export type WheelVariant = components["schemas"]["WheelVariant"];
+export type SizePair = components["schemas"]["SizePair"];
+export type CompatibleTyre = components["schemas"]["CompatibleTyre"];
+export type CompatibleWheel = components["schemas"]["CompatibleWheel"];
+export type Tyre = components["schemas"]["Tyre"];
+export type TyreVariant = components["schemas"]["TyreVariant"];
+export type TyreVehicleFitment = components["schemas"]["TyreVehicleFitment"];
+export type TyreFitVariant = components["schemas"]["TyreFitVariant"];
+export type TyreFitVehicle = components["schemas"]["TyreFitVehicle"];
+export type Site = components["schemas"]["Site"];
+export type PageStub = components["schemas"]["PageStub"];
+export type Page = components["schemas"]["Page"];
+export type ProductTemplateStub = components["schemas"]["ProductTemplateStub"];
+export type DynamicPageStub = components["schemas"]["DynamicPageStub"];
+export type PublicRecord = components["schemas"]["PublicRecord"];
+export type RecordKeys = components["schemas"]["RecordKeys"];
+export type ProductTypeChoice = components["schemas"]["ProductTypeChoice"];
+export type FieldUsage = components["schemas"]["FieldUsage"];
+export type HeaderSettings = components["schemas"]["HeaderSettings"] & {
+    logoReversed?: string | null;
+    logoInkIsDark?: boolean | null;
+};
+export type ThemeSettings = components["schemas"]["ThemeSettings"];
+export type ChatSettings = components["schemas"]["ChatSettings"];
+export type GalleryBuild = components["schemas"]["GalleryBuild"];
+export type FitmentMake = components["schemas"]["FitmentMake"];
+export type FitmentModel = components["schemas"]["FitmentModel"];
+export type FitmentModification = components["schemas"]["FitmentModification"];
+export type StockFitment = components["schemas"]["StockFitment"];
+export type ShippingMethod = components["schemas"]["ShippingMethod"];
+export type ShippingMethodPrices = components["schemas"]["ShippingMethodPrices"];
+export type DeliveryOption = components["schemas"]["DeliveryOption"];
+export type PickupLocation = components["schemas"]["PickupLocation"];
+export type CouponValidateRequest = components["schemas"]["CouponValidateRequest"];
+export type CouponValidateResponse = components["schemas"]["CouponValidateResponse"];
+export type CouponPreview = CouponValidateResponse & {
+    askedAsShopper: boolean;
+};
+export type PaymentIntentRequest = components["schemas"]["PaymentIntentRequest"];
+export type PaymentIntent = components["schemas"]["PaymentIntent"];
+export type PaypalOrderRequest = components["schemas"]["PaypalOrderRequest"];
+export type PaypalOrder = components["schemas"]["PaypalOrder"];
+export type PaypalCaptureRequest = components["schemas"]["PaypalCaptureRequest"];
+export type PaymentOutcome = components["schemas"]["PaymentOutcome"];
+export type AfterpayCheckoutRequest = components["schemas"]["AfterpayCheckoutRequest"];
+export type AfterpayCheckout = components["schemas"]["AfterpayCheckout"];
+export type AfterpayCaptureRequest = components["schemas"]["AfterpayCaptureRequest"];
+export type SquareChargeRequest = components["schemas"]["SquareChargeRequest"];
+export type GocardlessBillingRequest = components["schemas"]["GocardlessBillingRequest"];
+export type GocardlessBillingRequestResult = components["schemas"]["GocardlessBillingRequestResult"];
+export type GocardlessComplete = components["schemas"]["GocardlessComplete"];
+export type ZipCheckoutRequest = components["schemas"]["ZipCheckoutRequest"];
+export type ZipCheckout = components["schemas"]["ZipCheckout"];
+export type ZipCaptureRequest = components["schemas"]["ZipCaptureRequest"];
+export type KlarnaCheckoutRequest = components["schemas"]["KlarnaCheckoutRequest"];
+export type KlarnaCheckout = components["schemas"]["KlarnaCheckout"];
+export type KlarnaCaptureRequest = components["schemas"]["KlarnaCaptureRequest"];
+export type StockAlertRequest = components["schemas"]["StockAlertRequest"];
+export type StockAlertAck = components["schemas"]["StockAlertAck"];
+export type PreOrderIntentRequest = components["schemas"]["PreOrderIntentRequest"];
+export type PreOrderIntentAck = components["schemas"]["PreOrderIntentAck"];
+export type NewsletterSubscribeRequest = components["schemas"]["NewsletterSubscribeRequest"];
+export type NewsletterUnsubscribeRequest = components["schemas"]["NewsletterUnsubscribeRequest"];
+export type NewsletterAck = components["schemas"]["NewsletterAck"];
+export type CartLineSnapshot = components["schemas"]["CartLine"];
+export type CartLinePack = components["schemas"]["CartLinePack"];
+export type CartCaptureRequest = components["schemas"]["CartCaptureRequest"];
+export type CartTokenRequest = components["schemas"]["CartTokenRequest"];
+export type CartSnapshot = components["schemas"]["CartSnapshot"];
+export type CartAck = components["schemas"]["CartAck"];
+export type Review = components["schemas"]["Review"];
+export type ReviewSubmit = components["schemas"]["ReviewSubmit"];
+export type ReviewAck = components["schemas"]["ReviewAck"];
+export type Form = components["schemas"]["Form"];
+export type FormField = components["schemas"]["FormField"];
+export type FormSubmit = components["schemas"]["FormSubmit"];
+export type FormAck = components["schemas"]["FormAck"];
+export type CouponEffects = components["schemas"]["CouponEffects"];
+export type CouponFreeUnit = components["schemas"]["CouponFreeUnit"];
+export type BlogPostSummary = components["schemas"]["BlogPostStub"];
+export type BlogPostDetail = components["schemas"]["BlogPost"];
+export { PRODUCT_API_BASE } from "./origins.js";
+export declare function resolveSiteHost(): Promise<string | null>;
+export declare function resolveSiteHostSource(): Promise<{
+    host: string | null;
+    matchesRequestHost: boolean;
+}>;
+export declare function resolveClientIp(): Promise<string | null>;
+export declare function resolveSiteSlug(): Promise<string | null>;
+export declare function appendSiteQuery(path: string, siteQueryFragment: string): string;
+export declare const PREVIEW_PARAM = "preview";
+export declare function resolvePreviewToken(): Promise<string | null>;
+export declare const fitment: {
+    listMakes: (region?: string) => Promise<FitmentMake[]>;
+    listModels: (make: string, region?: string) => Promise<FitmentModel[]>;
+    listYears: (make: string, model: string, region?: string) => Promise<number[]>;
+    listModifications: (make: string, model: string, year: number, region?: string) => Promise<FitmentModification[]>;
+    getStockFitment: (make: string, model: string, year: number, modification: string, region?: string) => Promise<StockFitment | null>;
+};
+export declare const products: {
+    listWheels: (process?: string | null) => Promise<WheelSummary[]>;
+    listCatalog: (kinds: readonly ProductKind[], vehicle?: TyreFitVehicleQuery | null) => Promise<ProductSummary[]>;
+    getWheel: (slug: string) => Promise<Wheel>;
+    getTyre: (slug: string) => Promise<Tyre>;
+    listBundles: () => Promise<Bundle[]>;
+    getBundle: (slug: string) => Promise<Bundle>;
+    listGalleryBuilds: (opts?: {
+        process?: Process | null;
+        wheelSlug?: string | null;
+    }) => Promise<GalleryBuild[]>;
+    getSite: () => Promise<Site>;
+    getSiteBySlug: (slug: string) => Promise<Site>;
+    listPages: () => Promise<PageStub[]>;
+    listProductTemplates: () => Promise<ProductTemplateStub[]>;
+    listDynamicPages: (recordType?: string) => Promise<DynamicPageStub[]>;
+    getRecord: (type: string, key: string) => Promise<PublicRecord | null>;
+    listRecordKeys: (type: string) => Promise<string[]>;
+    listProductTypeChoices: () => Promise<ProductTypeChoice[]>;
+    listFieldUsage: () => Promise<FieldUsage[]>;
+    getPage: (slug: string, opts?: {
+        revalidate?: number;
+        record?: string;
+    }) => Promise<Page>;
+    listBlogPosts: () => Promise<BlogPostSummary[]>;
+    getBlogPost: (slug: string) => Promise<BlogPostDetail>;
+    createOrder: (body: OrderRequest) => Promise<OrderConfirmation>;
+    createOrderAuthed: (body: OrderRequest) => Promise<OrderConfirmation>;
+    lookupOrder: (body: OrderLookupRequest) => Promise<OrderTracking>;
+    createPaymentIntent: (body: PaymentIntentRequest) => Promise<PaymentIntent>;
+    createPaypalOrder: (body: PaypalOrderRequest) => Promise<PaypalOrder>;
+    capturePaypalOrder: (body: PaypalCaptureRequest) => Promise<PaymentOutcome>;
+    createAfterpayCheckout: (body: AfterpayCheckoutRequest) => Promise<AfterpayCheckout>;
+    captureAfterpayPayment: (body: AfterpayCaptureRequest) => Promise<PaymentOutcome>;
+    chargeSquare: (body: SquareChargeRequest) => Promise<PaymentOutcome>;
+    createGocardlessBillingRequest: (body: GocardlessBillingRequest) => Promise<GocardlessBillingRequestResult>;
+    completeGocardlessPayment: (body: GocardlessComplete) => Promise<PaymentOutcome>;
+    createZipCheckout: (body: ZipCheckoutRequest) => Promise<ZipCheckout>;
+    captureZipPayment: (body: ZipCaptureRequest) => Promise<PaymentOutcome>;
+    createKlarnaCheckout: (body: KlarnaCheckoutRequest) => Promise<KlarnaCheckout>;
+    captureKlarnaPayment: (body: KlarnaCaptureRequest) => Promise<PaymentOutcome>;
+    createStockAlert: (body: StockAlertRequest) => Promise<StockAlertAck>;
+    createPreOrderIntent: (body: PreOrderIntentRequest) => Promise<PreOrderIntentAck>;
+    createNewsletterSubscription: (body: NewsletterSubscribeRequest) => Promise<NewsletterAck>;
+    unsubscribeNewsletter: (body: NewsletterUnsubscribeRequest) => Promise<NewsletterAck>;
+    captureCart: (body: CartCaptureRequest) => Promise<CartAck>;
+    restoreCart: (body: CartTokenRequest) => Promise<CartSnapshot>;
+    unsubscribeCartReminders: (body: CartTokenRequest) => Promise<CartAck>;
+    listReviews: (params?: {
+        limit?: number;
+        designCode?: string;
+    }) => Promise<Review[]>;
+    submitReview: (body: ReviewSubmit) => Promise<ReviewAck>;
+    getForm: (slug: string) => Promise<Form>;
+    submitForm: (slug: string, body: FormSubmit) => Promise<FormAck>;
+    listShippingMethods: () => Promise<ShippingMethod[]>;
+    listCountrySubdivisions: (code: string) => Promise<CountrySubdivision[]>;
+    quoteCart: (body: CartQuoteRequest) => Promise<CartQuote>;
+    validateCoupon: (body: CouponValidateRequest) => Promise<CouponPreview>;
+    getHeaderSettings: () => Promise<HeaderSettings>;
+    getThemeSettings: () => Promise<ThemeSettings>;
+    getChatSettings: () => Promise<ChatSettings>;
+};
+export type OrderRequest = components["schemas"]["OrderRequest"];
+export type OrderConfirmation = components["schemas"]["OrderConfirmation"];
+export type OrderLookupRequest = components["schemas"]["OrderLookupRequest"];
+export type OrderTracking = components["schemas"]["OrderTracking"];
+export type OrderTrackingItem = components["schemas"]["OrderTrackingItem"];
+export type OrderShipment = components["schemas"]["OrderShipment"];
+export type BookingService = components["schemas"]["BookingService"];
+export type BookingServiceList = components["schemas"]["BookingServiceList"];
+export type BookingAvailability = components["schemas"]["BookingAvailability"];
+export type BookingRequest = components["schemas"]["BookingRequest"];
+export type BookingConfirmation = components["schemas"]["BookingConfirmation"];
+export type BookingPublic = components["schemas"]["BookingPublic"];
+export type BookingPaymentIntent = components["schemas"]["BookingPaymentIntent"];
+export declare const bookings: {
+    listServices: () => Promise<BookingServiceList>;
+    getAvailability: (serviceId: string, date: string) => Promise<BookingAvailability>;
+    create: (body: BookingRequest) => Promise<BookingConfirmation>;
+    get: (token: string) => Promise<BookingPublic>;
+    cancel: (token: string) => Promise<BookingPublic>;
+    createPaymentIntent: (manageToken: string) => Promise<BookingPaymentIntent>;
+};
+export interface AdminStorefrontPage {
+    id: string;
+    slug: string;
+    title: string;
+    is_published: boolean;
+    layout: Record<string, unknown>;
+    published_layout?: Record<string, unknown> | null;
+    updated_at?: string;
+    layout_updated_at?: string;
+    group?: string | null;
+    kind?: "normal" | "dynamic" | "lightbox" | "footer";
+    live_state?: "live" | "changed" | "never";
+}
+export interface AdminPagePreviewLink {
+    token: string;
+    expires_at: string;
+    url: string | null;
+}
+export interface AdminStorefrontPageTemplate {
+    id: string;
+    name: string;
+    layout: Record<string, unknown>;
+}
+export interface AdminEditLock {
+    held_by_you: boolean;
+    holder: number;
+    holder_name: string;
+    client_id: string;
+    last_seen_at: string;
+    seconds_since_seen: number;
+    seconds_since_held: number;
+    heartbeat_seconds: number;
+    expiry_seconds: number;
+}
+export interface AdminStorefrontSite {
+    id: string;
+    name: string;
+    slug: string;
+    maps_api_key: string;
+    maps_map_id: string;
+    display_order?: number;
+    created_at?: string;
+}
+export type AdminStorefrontSitePatch = {
+    maps_api_key?: string;
+    maps_map_id?: string;
+};
+export interface AdminSiteChange {
+    kind: string;
+    id: string;
+    name: string;
+    change: "publish" | "take_down" | "update";
+    version?: number;
+}
+export interface AdminSiteLiveState {
+    state: "live" | "changed";
+    changes: AdminSiteChange[];
+}
+export interface AdminSitePublishResult {
+    state: "live" | "changed";
+    published: AdminSiteChange[];
+    publish: {
+        id: string;
+        number: number;
+    } | null;
+}
+export interface AdminStorefrontSiteCurrency {
+    id: string;
+    currency_code: string;
+    symbol?: string;
+    decimal_places?: number;
+    is_default: boolean;
+    display_order: number;
+}
+export interface AdminStorefrontTemplatePage {
+    id: string;
+    template: string;
+    slug: string;
+    title: string;
+    layout: Record<string, unknown>;
+    display_order: number;
+}
+export interface AdminHeaderSettings {
+    id: string;
+    logo: string | null;
+    logo_url: string | null;
+    default_logo_url: string | null;
+    effective_logo_url: string | null;
+    effective_reverse_logo_url?: string | null;
+    logo_position: "left" | "center" | "right";
+    logo_size: "small" | "medium" | "large";
+    logo_size_px: number | null;
+    reverse_logo: boolean;
+    menu: string | null;
+    menu_handle: string | null;
+    menu_name: string | null;
+    menu_items: {
+        label: string;
+        url: string;
+        dropdown_menu: string | null;
+        dropdown_items: {
+            label: string;
+            url: string;
+        }[];
+    }[];
+    menu_position: "left" | "center" | "right" | "beside";
+    menu_split: number;
+    menu_gap_px?: number | null;
+    menu_row: "top" | "bottom" | "inline";
+    account_enabled?: boolean;
+    cart_enabled?: boolean;
+    util_style?: "icon" | "text";
+    nav_text_case?: "uppercase" | "capitalised";
+    country_selector_enabled: boolean;
+    country_selector_show_as?: "name" | "code_currency" | "globe_code" | "currency" | "flag_code" | "flag";
+    country_urls: Record<string, string>;
+    search_enabled: boolean;
+    search_position: "left" | "right";
+    search_row: "top" | "bottom";
+    width: "page" | "full";
+    height: "compact" | "standard";
+    height_px: number | null;
+    sticky: "none" | "always" | "on_scroll_up";
+    border_thickness: number;
+    color_scheme_default: "light" | "dark";
+    color_scheme_inverse: "light" | "dark";
+    light_reverse_text: boolean;
+    top_text_color?: "auto" | "light" | "dark";
+    theme?: number | null;
+    transparent_top?: boolean;
+    surface?: "" | "dark" | "light" | "accent";
+    transparent_home: boolean;
+    transparent_product: boolean;
+    transparent_collection: boolean;
+}
+export type AdminHeaderSettingsPatch = Partial<Omit<AdminHeaderSettings, "id" | "logo" | "logo_url" | "default_logo_url" | "effective_logo_url" | "menu_handle" | "menu_name" | "menu_items">>;
+export type AdminThemeSettings = SiteThemeRow;
+export type AdminThemeSettingsPatch = SiteThemeRowPatch;
+export interface AdminChatSettings {
+    id: string;
+    enabled: boolean;
+    title: string;
+    subtitle: string;
+    greeting: string;
+    launcher_color?: string;
+    launcher_icon?: string;
+    launcher_position?: "right" | "left";
+    launcher_label?: string;
+    show_on_phones?: boolean;
+}
+export type AdminChatSettingsPatch = Partial<Omit<AdminChatSettings, "id">>;
+export type AdminSocialSettings = {
+    id: string | null;
+    site: string;
+} & Record<`${SocialPlatform}_url`, string>;
+export type AdminSocialSettingsPatch = Partial<Record<`${SocialPlatform}_url`, string>>;
+export interface AdminMenuItem {
+    id: string;
+    label: string;
+    url: string;
+    dropdown_menu: string | null;
+    dropdown_items?: {
+        label: string;
+        url: string;
+    }[];
+    sort_order: number;
+}
+export interface AdminMenu {
+    id: string;
+    name: string;
+    handle: string;
+    sort_order: number;
+    items: AdminMenuItem[];
+    item_count: number;
+}
+export interface AdminBlogPost {
+    id: string;
+    brand?: string | null;
+    slug: string;
+    title: string;
+    excerpt: string;
+    body: string;
+    author: string;
+    category: string;
+    cover_image: string;
+    is_visible: boolean;
+    published_at: string | null;
+    display_order: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface AdminStorefrontCategory {
+    id: string;
+    brand?: string | null;
+    name: string;
+    slug: string;
+    sort_order: number;
+    is_visible: boolean;
+    description: string;
+    image: string;
+}
+export interface AdminStorefrontForm {
+    id: string;
+    title: string;
+    slug: string;
+    fields: {
+        key?: string;
+        label: string;
+        type: string;
+        required: boolean;
+    }[];
+    kind: "contact" | "account_signup";
+    signup_customer_type: "" | "retail" | "importer";
+    mailing_list_name?: string;
+    notify_email?: string;
+    subscribe_mode?: "always" | "checkbox";
+    is_active: boolean;
+}
+export interface MediaAsset {
+    id: string;
+    url: string;
+    kind: "image" | "video" | "";
+    original_name: string;
+    content_type: string;
+    size: number;
+    created_at: string;
+}
+export declare class AmbiguousPageSlugError extends Error {
+    readonly slug: string;
+    readonly count: number;
+    constructor(slug: string, count: number);
+}
+export declare class MediaUploadDestinationError extends Error {
+    constructor();
+}
+export declare function editorMediaUploadPath(): string;
+export declare const adminFetch: <T = unknown>(path: string, opts?: RequestOpts) => Promise<T>;
+export interface AdminClient {
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    audience?: EditorPortalAudience;
+    siteDrafts?: boolean;
+}
+export declare function createStorefrontAdmin(client?: AdminClient): {
+    findPageBySlug: (slug: string, token: string, siteId?: string) => Promise<AdminStorefrontPage | null>;
+    getPageById: (id: string, token: string) => Promise<AdminStorefrontPage>;
+    saveLayout: (id: string, layout: Record<string, unknown>, token: string, version: string, clientId?: string) => Promise<AdminStorefrontPage>;
+    duplicatePage: (id: string, copy: {
+        title: string;
+        slug: string;
+    }, token: string) => Promise<AdminStorefrontPage>;
+    createPagePreviewLink: (id: string, token: string) => Promise<AdminPagePreviewLink>;
+    claimPageEditLock: (id: string, token: string, clientId: string, takeover?: boolean) => Promise<AdminEditLock>;
+    releasePageEditLock: (id: string, token: string) => Promise<void>;
+    createTemplate: (name: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPageTemplate>;
+    getTemplate: (id: string, token: string) => Promise<AdminStorefrontPageTemplate>;
+    saveTemplateLayout: (id: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPageTemplate>;
+    listTemplatePages: (templateId: string, token: string) => Promise<AdminStorefrontTemplatePage[]>;
+    findTemplatePageBySlug: (templateId: string, slug: string, token: string) => Promise<AdminStorefrontTemplatePage | null>;
+    createTemplatePage: (templateId: string, page: {
+        slug: string;
+        title: string;
+        layout: Record<string, unknown>;
+    }, token: string) => Promise<AdminStorefrontTemplatePage>;
+    saveTemplatePageLayout: (id: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontTemplatePage>;
+    deleteTemplatePage: (id: string, token: string, options?: {
+        keepalive?: boolean;
+    }) => Promise<void>;
+    listPages: (token: string, siteId?: string) => Promise<AdminStorefrontPage[]>;
+    createPage: (title: string, slug: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPage>;
+    deletePage: (id: string, token: string) => Promise<void>;
+    getHeaderSettings: (token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    listMenus: (token: string | null, siteId?: string | null) => Promise<AdminMenu[]>;
+    listBlogPosts: (token: string | null, opts?: {
+        visibleOnly?: boolean;
+        siteId?: string | null;
+    }) => Promise<AdminBlogPost[]>;
+    listFieldUsage: (token: string | null, siteId: string) => Promise<AdminFieldUsageRow[]>;
+    listCategories: (token: string | null, opts?: {
+        visibleOnly?: boolean;
+        siteId?: string | null;
+    }) => Promise<AdminStorefrontCategory[]>;
+    listForms: (token: string | null, opts?: {
+        siteId?: string | null;
+    }) => Promise<AdminStorefrontForm[]>;
+    listWheelSummaries: (token: string | null, opts?: {
+        siteId?: string | null;
+    }) => Promise<WheelSummary[]>;
+    listProducts: (token: string | null, opts?: {
+        siteId?: string | null;
+        kinds?: readonly ProductKind[];
+    }) => Promise<ProductSummary[]>;
+    getWheelDetail: (token: string, slug: string, opts?: {
+        siteId?: string | null;
+    }) => Promise<Wheel>;
+    updateHeaderSettings: (patch: AdminHeaderSettingsPatch, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    getSite: (siteId: string, token: string) => Promise<AdminStorefrontSite>;
+    listSites: (token: string) => Promise<AdminStorefrontSite[]>;
+    listSiteCurrencies: (siteId: string, token: string) => Promise<AdminStorefrontSiteCurrency[]>;
+    publishSite: (siteId: string, token: string) => Promise<AdminSitePublishResult>;
+    getSiteLiveState: (siteId: string, token: string) => Promise<AdminSiteLiveState>;
+    updateSite: (siteId: string, patch: AdminStorefrontSitePatch, token: string) => Promise<AdminStorefrontSite>;
+    getThemeSettings: (token: string, siteId?: string) => Promise<AdminThemeSettings>;
+    updateThemeSettings: (patch: AdminThemeSettingsPatch, token: string, siteId?: string) => Promise<AdminThemeSettings>;
+    getChatSettings: (token: string, siteId?: string) => Promise<AdminChatSettings>;
+    updateChatSettings: (patch: AdminChatSettingsPatch, token: string, siteId?: string) => Promise<AdminChatSettings>;
+    getSocialSettings: (token: string, siteId: string) => Promise<AdminSocialSettings>;
+    updateSocialSettings: (patch: AdminSocialSettingsPatch, token: string, siteId: string) => Promise<AdminSocialSettings>;
+    uploadHeaderLogo: (file: File, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    clearHeaderLogo: (token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    setHeaderLogoFromAsset: (assetId: string, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    uploadMedia: (file: File, token: string) => Promise<{
+        id: string;
+        url: string;
+        kind: "image" | "video";
+        reused: boolean;
+    }>;
+    listMedia: (token: string, kind?: "image" | "video") => Promise<MediaAsset[]>;
+};
+export declare const storefrontAdmin: {
+    findPageBySlug: (slug: string, token: string, siteId?: string) => Promise<AdminStorefrontPage | null>;
+    getPageById: (id: string, token: string) => Promise<AdminStorefrontPage>;
+    saveLayout: (id: string, layout: Record<string, unknown>, token: string, version: string, clientId?: string) => Promise<AdminStorefrontPage>;
+    duplicatePage: (id: string, copy: {
+        title: string;
+        slug: string;
+    }, token: string) => Promise<AdminStorefrontPage>;
+    createPagePreviewLink: (id: string, token: string) => Promise<AdminPagePreviewLink>;
+    claimPageEditLock: (id: string, token: string, clientId: string, takeover?: boolean) => Promise<AdminEditLock>;
+    releasePageEditLock: (id: string, token: string) => Promise<void>;
+    createTemplate: (name: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPageTemplate>;
+    getTemplate: (id: string, token: string) => Promise<AdminStorefrontPageTemplate>;
+    saveTemplateLayout: (id: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPageTemplate>;
+    listTemplatePages: (templateId: string, token: string) => Promise<AdminStorefrontTemplatePage[]>;
+    findTemplatePageBySlug: (templateId: string, slug: string, token: string) => Promise<AdminStorefrontTemplatePage | null>;
+    createTemplatePage: (templateId: string, page: {
+        slug: string;
+        title: string;
+        layout: Record<string, unknown>;
+    }, token: string) => Promise<AdminStorefrontTemplatePage>;
+    saveTemplatePageLayout: (id: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontTemplatePage>;
+    deleteTemplatePage: (id: string, token: string, options?: {
+        keepalive?: boolean;
+    }) => Promise<void>;
+    listPages: (token: string, siteId?: string) => Promise<AdminStorefrontPage[]>;
+    createPage: (title: string, slug: string, layout: Record<string, unknown>, token: string) => Promise<AdminStorefrontPage>;
+    deletePage: (id: string, token: string) => Promise<void>;
+    getHeaderSettings: (token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    listMenus: (token: string | null, siteId?: string | null) => Promise<AdminMenu[]>;
+    listBlogPosts: (token: string | null, opts?: {
+        visibleOnly?: boolean;
+        siteId?: string | null;
+    }) => Promise<AdminBlogPost[]>;
+    listFieldUsage: (token: string | null, siteId: string) => Promise<AdminFieldUsageRow[]>;
+    listCategories: (token: string | null, opts?: {
+        visibleOnly?: boolean;
+        siteId?: string | null;
+    }) => Promise<AdminStorefrontCategory[]>;
+    listForms: (token: string | null, opts?: {
+        siteId?: string | null;
+    }) => Promise<AdminStorefrontForm[]>;
+    listWheelSummaries: (token: string | null, opts?: {
+        siteId?: string | null;
+    }) => Promise<WheelSummary[]>;
+    listProducts: (token: string | null, opts?: {
+        siteId?: string | null;
+        kinds?: readonly ProductKind[];
+    }) => Promise<ProductSummary[]>;
+    getWheelDetail: (token: string, slug: string, opts?: {
+        siteId?: string | null;
+    }) => Promise<Wheel>;
+    updateHeaderSettings: (patch: AdminHeaderSettingsPatch, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    getSite: (siteId: string, token: string) => Promise<AdminStorefrontSite>;
+    listSites: (token: string) => Promise<AdminStorefrontSite[]>;
+    listSiteCurrencies: (siteId: string, token: string) => Promise<AdminStorefrontSiteCurrency[]>;
+    publishSite: (siteId: string, token: string) => Promise<AdminSitePublishResult>;
+    getSiteLiveState: (siteId: string, token: string) => Promise<AdminSiteLiveState>;
+    updateSite: (siteId: string, patch: AdminStorefrontSitePatch, token: string) => Promise<AdminStorefrontSite>;
+    getThemeSettings: (token: string, siteId?: string) => Promise<AdminThemeSettings>;
+    updateThemeSettings: (patch: AdminThemeSettingsPatch, token: string, siteId?: string) => Promise<AdminThemeSettings>;
+    getChatSettings: (token: string, siteId?: string) => Promise<AdminChatSettings>;
+    updateChatSettings: (patch: AdminChatSettingsPatch, token: string, siteId?: string) => Promise<AdminChatSettings>;
+    getSocialSettings: (token: string, siteId: string) => Promise<AdminSocialSettings>;
+    updateSocialSettings: (patch: AdminSocialSettingsPatch, token: string, siteId: string) => Promise<AdminSocialSettings>;
+    uploadHeaderLogo: (file: File, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    clearHeaderLogo: (token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    setHeaderLogoFromAsset: (assetId: string, token: string, siteId?: string) => Promise<AdminHeaderSettings>;
+    uploadMedia: (file: File, token: string) => Promise<{
+        id: string;
+        url: string;
+        kind: "image" | "video";
+        reused: boolean;
+    }>;
+    listMedia: (token: string, kind?: "image" | "video") => Promise<MediaAsset[]>;
+};