@proxima-io/storefront-core 0.3.0 → 0.8.1

package/dist/types/address.d.ts

@@ -0,0 +1,40 @@
+export interface UbigeoResult {
+    code: string;
+    department: string;
+    province: string;
+    district: string;
+    full_name: string;
+}
+export interface CustomerAddress {
+    id: number;
+    customer_id: number;
+    business_id: string;
+    label?: string | null;
+    recipient_name?: string | null;
+    phone?: string | null;
+    line1: string;
+    line2?: string | null;
+    ubigeo_code?: string | null;
+    ubigeo?: UbigeoResult | null;
+    reference?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    geocoding_source?: string | null;
+    is_default: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface AddressInput {
+    label?: string | null;
+    recipient_name?: string | null;
+    phone?: string | null;
+    line1: string;
+    line2?: string | null;
+    ubigeo_code?: string | null;
+    reference?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    geocoding_source?: string | null;
+    is_default?: boolean;
+}
+//# sourceMappingURL=address.d.ts.map

package/dist/types/address.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/types/address.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/types/address.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=address.js.map

package/dist/types/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../src/types/address.ts"],"names":[],"mappings":""}

package/dist/types/analytics.d.ts

@@ -0,0 +1,79 @@
+/** Storefront analytics events accepted by proxima-api ingest. */
+export type StorefrontEventType = 'page_view' | 'product_view' | 'category_view' | 'brand_view' | 'search' | 'add_to_cart' | 'remove_from_cart' | 'cart_view' | 'checkout_started' | 'checkout_completed' | 'checkout_error' | 'order_completed' | 'not_found_page_viewed' | 'filter_applied' | 'sort_changed' | 'promotion_view' | 'wishlist_add' | 'login_completed' | 'register_completed';
+export interface StorefrontEventPayload {
+    product_slug?: string;
+    product_id?: string;
+    product_name?: string;
+    variant_id?: number;
+    quantity?: number;
+    price?: number;
+    order_id?: string;
+    order_total?: number;
+    query?: string;
+    results_count?: number;
+    category_slug?: string;
+    category_name?: string;
+    brand_slug?: string;
+    brand_name?: string;
+    item_count?: number;
+    cart_total?: number;
+    requested_path?: string;
+    error_code?: string;
+    step?: string;
+    filter_type?: string;
+    filter_value?: string;
+    pathname?: string;
+    sort?: string;
+    promotion_slug?: string;
+    section_type?: string;
+    badge_text?: string;
+    method?: string;
+    attribution?: SessionAttributionPayload;
+    [key: string]: unknown;
+}
+/** First-touch marketing attribution attached to every analytics event in a session. */
+export interface SessionAttributionPayload {
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_term?: string;
+    gclid?: string;
+    fbclid?: string;
+    msclkid?: string;
+    landing_path?: string;
+    landing_referrer?: string;
+}
+export interface StorefrontAnalyticsConfig {
+    apiUrl: string;
+    websiteId: string;
+    businessId: string;
+    locale?: string;
+    flushInterval?: number;
+    debug?: boolean;
+    /** SSR-provided session (e.g. httpOnly cart cookie read server-side). */
+    sessionId?: string;
+    /** Optional runtime resolver — runs before cookie/localStorage fallbacks. */
+    getSessionId?: () => string | null | undefined;
+    /** Cookie name for guest cart session (default `cart_session_id`). */
+    cartSessionCookieName?: string;
+}
+export interface ProductViewPayload {
+    product_slug: string;
+    product_id?: string;
+    product_name?: string;
+    price?: number;
+}
+export interface AddToCartPayload {
+    product_slug: string;
+    product_id?: string;
+    product_name?: string;
+    variant_id: number;
+    price?: number;
+    quantity?: number;
+}
+export interface CheckoutStartedPayload {
+    item_count: number;
+    cart_total?: number;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/types/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":"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"}

package/dist/types/analytics.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analytics.js.map

package/dist/types/analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/types/analytics.ts"],"names":[],"mappings":""}

package/dist/types/business.d.ts

@@ -0,0 +1,95 @@
+export interface StorefrontBusinessProfile {
+    business_id: string;
+    name: string;
+    slug: string;
+    logo_url: string | null;
+    tagline: string | null;
+    currency_code: string;
+    timezone: string;
+    contact: {
+        email: string | null;
+        support_email: string | null;
+        support_phone: string | null;
+        whatsapp: string | null;
+        /** Pre-built `https://wa.me/{digits}` link derived from `whatsapp`. */
+        whatsapp_url: string | null;
+    };
+    social: {
+        instagram: string | null;
+        facebook: string | null;
+        tiktok: string | null;
+        youtube: string | null;
+        twitter: string | null;
+        linkedin: string | null;
+    };
+    legal: {
+        terms_url: string | null;
+        privacy_url: string | null;
+        /** Peru-specific "Libro de Reclamaciones" URL. */
+        complaints_book_url: string | null;
+    };
+    presence_mode: "physical" | "virtual" | "both";
+    primary_location: StorefrontBusinessLocation | null;
+    locations: StorefrontBusinessLocation[];
+}
+export interface StorefrontBusinessLocation {
+    id: string | null;
+    kind: "store" | "pickup_point" | "showroom";
+    label: string;
+    is_primary: boolean;
+    address_line: string;
+    ubigeo_code: string | null;
+    reference: string | null;
+    phone: string | null;
+    hours_text: string | null;
+    show_on_website: boolean;
+    is_active: boolean;
+    sort_order: number;
+    warehouse_id: number | null;
+    ubigeo: {
+        code: string;
+        department: string;
+        province: string;
+        district: string;
+        full_name: string;
+    } | null;
+}
+/**
+ * Fetch the public business profile for a tenant. Call this once per request
+ * and cache the result on `Astro.locals` so the footer (and any other
+ * profile-aware component) reads from memory, not over the wire.
+ *
+ * @example
+ * const profile = await fetchBusinessProfile(
+ *   { baseUrl: env.apiUrl, serviceKey: env.serviceKey },
+ *   website.business_id
+ * );
+ */
+export interface StorefrontCampaign {
+    id: number;
+    slug: string | null;
+    name: Record<string, string>;
+    description: Record<string, string> | null;
+    discount_type: "percentage" | "fixed_amount";
+    discount_value: number;
+    target_type: "product" | "category" | "brand" | "global";
+    target_ids: number[];
+    active_from: string | null;
+    active_until: string | null;
+    smart_collection_id: number | null;
+    display_config: {
+        badge_text?: string | null;
+        hero_copy?: Record<string, string> | null;
+        theme_color?: string | null;
+        show_countdown?: boolean | null;
+    } | null;
+}
+export interface StorefrontPaymentMethod {
+    code: string;
+    name_es: string;
+    description_es: string | null;
+    category: string;
+    kind: "offline" | "online" | "hybrid";
+    icon_url: string | null;
+}
+//# sourceMappingURL=business.d.ts.map

package/dist/types/business.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.d.ts","sourceRoot":"","sources":["../../src/types/business.ts"],"names":[],"mappings":"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"}

package/dist/types/business.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=business.js.map

package/dist/types/business.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business.js","sourceRoot":"","sources":["../../src/types/business.ts"],"names":[],"mappings":""}

package/dist/types/buyer.d.ts

@@ -0,0 +1,144 @@
+/** Well-known error detail strings returned by the API. Use these for comparison
+ *  instead of hardcoding strings in your storefront.
+ *
+ * @example
+ * try { await resetPassword(...) } catch (e: any) {
+ *   if (e.data?.detail === BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID) { ... }
+ * }
+ */
+export declare const BUYER_AUTH_ERRORS: {
+    readonly RESET_TOKEN_INVALID: "RESET_TOKEN_INVALID";
+    readonly VERIFY_TOKEN_INVALID: "VERIFY_TOKEN_INVALID";
+    readonly EMAIL_ALREADY_VERIFIED: "EMAIL_ALREADY_VERIFIED";
+    readonly EMAIL_TAKEN: "Email already registered in this store";
+    readonly MISSING_REQUIRED_FIELDS: "MISSING_REQUIRED_FIELDS";
+    /** Turnstile enabled but captcha_token missing or invalid (HTTP 422). */
+    readonly CAPTCHA_REQUIRED: "CAPTCHA_REQUIRED";
+};
+/** True when the API rejected auth because Turnstile verification failed or was omitted. */
+export declare function isCaptchaRequiredError(err: unknown): boolean;
+/** Token pair returned by /store/auth/register, /store/auth/login, /store/auth/refresh */
+export interface BuyerSession {
+    access_token: string;
+    refresh_token: string | null;
+    token_type: string;
+}
+/** Full customer profile from GET /store/me */
+export interface BuyerProfile {
+    id: number;
+    email: string;
+    business_id: string;
+    full_name: string | null;
+    phone: string | null;
+    doc_type: number | null;
+    doc_number: string | null;
+    birth_date: string | null;
+    newsletter_subscribed: boolean;
+    avatar_url: string | null;
+    metadata: Record<string, any>;
+    registration_source: string;
+    last_login_at: string | null;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/** A single resolved field in the storefront registration form. */
+export interface RegistrationFormField {
+    name: string;
+    label: string;
+    /** "text" | "password" | "phone" | "date" | "select" | "boolean" | "image" | "address" | "custom" */
+    type: string;
+    /** "text_input" | "phone_input" | "date_picker" | "select" | "checkbox" | "toggle"
+     *  | "image_upload" | "ubigeo_selector" | "google_maps_picker" | "manual" */
+    widget: string;
+    widget_config: Record<string, any>;
+    required: boolean;
+    order: number;
+    options: string[] | null;
+}
+/** A single step in the form (always at least one). */
+export interface RegistrationFormStep {
+    id: string;
+    label: string;
+    order: number;
+    skippable: boolean;
+    fields: RegistrationFormField[];
+}
+/** Full resolved form schema from GET /store/auth/registration-form.
+ *  `email` and `password` are always present in steps[0].fields — no need to add them. */
+export interface RegistrationForm {
+    mode: "single_step" | "multi_step";
+    steps: RegistrationFormStep[];
+}
+/** Address submitted during customer registration. */
+export interface AddressInRegistration {
+    line1: string;
+    line2?: string | null;
+    reference?: string | null;
+    /** 6-digit Peruvian ubigeo code, e.g. "150101" */
+    ubigeo_code?: string | null;
+    latitude?: number | null;
+    longitude?: number | null;
+    /** "google_maps" | "ubigeo_centroid" | "manual" */
+    geocoding_source?: string | null;
+}
+/** All accepted fields for POST /store/auth/register.
+ *  Which fields are required depends on the merchant's registration form configuration.
+ *  Use fetchRegistrationForm() to know which fields to show and which are required. */
+export interface BuyerRegisterParams {
+    email: string;
+    password: string;
+    fullName?: string | null;
+    phone?: string | null;
+    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
+    docType?: number | null;
+    docNumber?: string | null;
+    /** ISO date "YYYY-MM-DD" */
+    birthDate?: string | null;
+    newsletterSubscribed?: boolean;
+    /** Default "organic". */
+    registrationSource?: string;
+    /** Custom fields configured by the merchant — keyed by field name. */
+    metadata?: Record<string, any>;
+    address?: AddressInRegistration | null;
+    /** Cloudflare Turnstile token from the widget — required when API has TURNSTILE_ENABLED=true */
+    captchaToken?: string | null;
+}
+/** A single field that was missing in the registration request. */
+export interface MissingField {
+    field: string;
+    msg: string;
+}
+/**
+ * Thrown when the API returns 422 MISSING_REQUIRED_FIELDS.
+ * Use `error.missingFields` to mark exactly which fields are invalid in the UI.
+ *
+ * @example
+ * try {
+ *   await registerBuyer(config, website, params);
+ * } catch (e) {
+ *   if (e instanceof MissingFieldsError) {
+ *     for (const { field } of e.missingFields) markFieldError(field);
+ *   }
+ * }
+ */
+export declare class MissingFieldsError extends Error {
+    status: 422;
+    missingFields: MissingField[];
+    constructor(missingFields: MissingField[]);
+}
+/** Fields the customer can update via PATCH /store/me/profile. All optional. */
+export interface BuyerProfileUpdateParams {
+    fullName?: string | null;
+    phone?: string | null;
+    /** 1=DNI 2=CE 3=Pasaporte 6=RUC */
+    docType?: number | null;
+    docNumber?: string | null;
+    /** ISO date "YYYY-MM-DD" */
+    birthDate?: string | null;
+    newsletterSubscribed?: boolean;
+    avatarUrl?: string | null;
+    /** If provided, changes the customer's password. */
+    password?: string;
+}
+//# sourceMappingURL=buyer.d.ts.map

package/dist/types/buyer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer.d.ts","sourceRoot":"","sources":["../../src/types/buyer.ts"],"names":[],"mappings":"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"}

package/dist/types/buyer.js

@@ -0,0 +1,45 @@
+/** Well-known error detail strings returned by the API. Use these for comparison
+ *  instead of hardcoding strings in your storefront.
+ *
+ * @example
+ * try { await resetPassword(...) } catch (e: any) {
+ *   if (e.data?.detail === BUYER_AUTH_ERRORS.RESET_TOKEN_INVALID) { ... }
+ * }
+ */
+export const BUYER_AUTH_ERRORS = {
+    RESET_TOKEN_INVALID: "RESET_TOKEN_INVALID",
+    VERIFY_TOKEN_INVALID: "VERIFY_TOKEN_INVALID",
+    EMAIL_ALREADY_VERIFIED: "EMAIL_ALREADY_VERIFIED",
+    EMAIL_TAKEN: "Email already registered in this store",
+    MISSING_REQUIRED_FIELDS: "MISSING_REQUIRED_FIELDS",
+    /** Turnstile enabled but captcha_token missing or invalid (HTTP 422). */
+    CAPTCHA_REQUIRED: "CAPTCHA_REQUIRED",
+};
+/** True when the API rejected auth because Turnstile verification failed or was omitted. */
+export function isCaptchaRequiredError(err) {
+    const e = err;
+    return e?.status === 422 && e?.data?.detail === BUYER_AUTH_ERRORS.CAPTCHA_REQUIRED;
+}
+/**
+ * Thrown when the API returns 422 MISSING_REQUIRED_FIELDS.
+ * Use `error.missingFields` to mark exactly which fields are invalid in the UI.
+ *
+ * @example
+ * try {
+ *   await registerBuyer(config, website, params);
+ * } catch (e) {
+ *   if (e instanceof MissingFieldsError) {
+ *     for (const { field } of e.missingFields) markFieldError(field);
+ *   }
+ * }
+ */
+export class MissingFieldsError extends Error {
+    status = 422;
+    missingFields;
+    constructor(missingFields) {
+        super("MISSING_REQUIRED_FIELDS");
+        this.name = "MissingFieldsError";
+        this.missingFields = missingFields;
+    }
+}
+//# sourceMappingURL=buyer.js.map

package/dist/types/buyer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buyer.js","sourceRoot":"","sources":["../../src/types/buyer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,mBAAmB,EAAK,qBAAqB;IAC7C,oBAAoB,EAAI,sBAAsB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,WAAW,EAAa,wCAAwC;IAChE,uBAAuB,EAAE,yBAAyB;IAClD,yEAAyE;IACzE,gBAAgB,EAAQ,kBAAkB;CAClC,CAAC;AAEX,4FAA4F;AAC5F,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,MAAM,CAAC,GAAG,GAAsD,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC,gBAAgB,CAAC;AACrF,CAAC;AAkHD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,GAAG,GAAY,CAAC;IACtB,aAAa,CAAiB;IAC9B,YAAY,aAA6B;QACvC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF"}

package/dist/types/campaign.d.ts

@@ -0,0 +1,51 @@
+export interface CampaignScheduleMeta {
+    /** ISO UTC datetime — null if not configured. */
+    countdown_target_at: string | null;
+    /** Which field the target was sourced from. */
+    countdown_target_source: "section_attribute" | "config.display.countdown_target_at" | "active_until" | null;
+}
+/**
+ * Full shape of a resolved Smart Collection as returned in section
+ * `attributes_meta` or `resolved_data` by the composition API.
+ */
+export interface ResolvedSmartCollectionInfo {
+    collection: {
+        id: number;
+        name: string;
+        type: string;
+        is_active: boolean;
+        active_from: string | null;
+        active_until: string | null;
+        config: {
+            display?: {
+                countdown_target_at?: string | null;
+            };
+        };
+        website_id?: string | null;
+        cache_ttl?: number;
+        contract_type?: string | null;
+    };
+    schedule: {
+        data_window: {
+            from: string | null;
+            until: string | null;
+        };
+        countdown_target_at: string | null;
+        countdown_target_source: string | null;
+    };
+    meta: {
+        inactive: boolean;
+        inactive_reason: "disabled" | "before_start" | "after_end" | null;
+    };
+}
+/** Remaining-time snapshot for a countdown. */
+export interface CampaignCountdownState {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    /** True when targetAt is null or already in the past. */
+    expired: boolean;
+    targetAt: string | null;
+}
+//# sourceMappingURL=campaign.d.ts.map

package/dist/types/campaign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.d.ts","sourceRoot":"","sources":["../../src/types/campaign.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,+CAA+C;IAC/C,uBAAuB,EACnB,mBAAmB,GACnB,oCAAoC,GACpC,cAAc,GACd,IAAI,CAAC;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,MAAM,EAAE;YAAE,OAAO,CAAC,EAAE;gBAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAA;SAAE,CAAC;QAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QAC3D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;QACnC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;KACxC,CAAC;IACF,IAAI,EAAE;QACJ,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,UAAU,GAAG,cAAc,GAAG,WAAW,GAAG,IAAI,CAAC;KACnE,CAAC;CACH;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/types/campaign.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=campaign.js.map

package/dist/types/campaign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign.js","sourceRoot":"","sources":["../../src/types/campaign.ts"],"names":[],"mappings":""}

package/dist/types/cart.d.ts

@@ -0,0 +1,40 @@
+/** A line item inside a Cart. */
+export interface CartItem {
+    id: number;
+    product_variant_id: number;
+    quantity: number;
+    metadata?: {
+        name?: string | null;
+        slug?: string | null;
+        brand?: string | null;
+        image?: string | null;
+        unit_price?: number | null;
+        unit_price_string?: string | null;
+    } | null;
+}
+export interface CartTotals {
+    subtotal: number;
+    formatted_subtotal: string;
+    currency: string;
+}
+/** Shopping cart for a guest session or authenticated customer. */
+export interface Cart {
+    id: string;
+    session_id?: string | null;
+    customer_id?: number | null;
+    items: CartItem[];
+    totals: CartTotals;
+}
+/** Customer and shipping details submitted at checkout. */
+export interface CheckoutRequest {
+    customer_name: string;
+    customer_phone: string;
+    customer_email?: string | null;
+    shipping_address?: string | null;
+    notes?: string | null;
+    coupon_code?: string | null;
+    customer_doc_type?: number | null;
+    customer_doc_number?: string | null;
+    address_id?: number | null;
+}
+//# sourceMappingURL=cart.d.ts.map

package/dist/types/cart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.d.ts","sourceRoot":"","sources":["../../src/types/cart.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B"}

package/dist/types/cart.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cart.js.map

package/dist/types/cart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart.js","sourceRoot":"","sources":["../../src/types/cart.ts"],"names":[],"mappings":""}