@tonytang99/integration-canonical 1.0.0 → 1.2.0

package/dist/schemas/product.d.ts

@@ -0,0 +1,717 @@
+import { z } from 'zod';
+import { type Money } from '../types/common';
+/**
+ * Product availability status
+ */
+export declare const ProductAvailability: z.ZodEnum<["available", "preorder", "backorder", "discontinued", "out-of-stock"]>;
+export type ProductAvailability = z.infer<typeof ProductAvailability>;
+/**
+ * Product condition
+ */
+export declare const ProductCondition: z.ZodEnum<["new", "refurbished", "used"]>;
+export type ProductCondition = z.infer<typeof ProductCondition>;
+/**
+ * Product weight with unit
+ */
+export declare const ProductWeightSchema: z.ZodObject<{
+    value: z.ZodNumber;
+    unit: z.ZodEnum<["kg", "g", "lb", "oz"]>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    unit: "g" | "kg" | "oz" | "lb";
+}, {
+    value: number;
+    unit: "g" | "kg" | "oz" | "lb";
+}>;
+export type ProductWeight = z.infer<typeof ProductWeightSchema>;
+/**
+ * Product dimensions
+ */
+export declare const ProductDimensionsSchema: z.ZodObject<{
+    length: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    unit: z.ZodEnum<["cm", "m", "in", "ft"]>;
+}, "strip", z.ZodTypeAny, {
+    length: number;
+    unit: "cm" | "m" | "in" | "ft";
+    width: number;
+    height: number;
+}, {
+    length: number;
+    unit: "cm" | "m" | "in" | "ft";
+    width: number;
+    height: number;
+}>;
+export type ProductDimensions = z.infer<typeof ProductDimensionsSchema>;
+/**
+ * Product image
+ */
+export declare const ProductImageSchema: z.ZodObject<{
+    url: z.ZodString;
+    altText: z.ZodOptional<z.ZodString>;
+    sortOrder: z.ZodOptional<z.ZodNumber>;
+    isThumbnail: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    altText?: string | undefined;
+    sortOrder?: number | undefined;
+    isThumbnail?: boolean | undefined;
+}, {
+    url: string;
+    altText?: string | undefined;
+    sortOrder?: number | undefined;
+    isThumbnail?: boolean | undefined;
+}>;
+export type ProductImage = z.infer<typeof ProductImageSchema>;
+/**
+ * Product variant/option
+ */
+export declare const ProductVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    sku: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    price: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>>;
+    compareAtPrice: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>>;
+    inventory: z.ZodOptional<z.ZodObject<{
+        quantity: z.ZodNumber;
+        tracked: z.ZodBoolean;
+        allowBackorder: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+    }, {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+    }>>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    image: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        altText: z.ZodOptional<z.ZodString>;
+        sortOrder: z.ZodOptional<z.ZodNumber>;
+        isThumbnail: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }, {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }>>;
+    isAvailable: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    sku: string;
+    options?: Record<string, string> | undefined;
+    name?: string | undefined;
+    price?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    compareAtPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    inventory?: {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+    } | undefined;
+    image?: {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    } | undefined;
+    isAvailable?: boolean | undefined;
+}, {
+    id: string;
+    sku: string;
+    options?: Record<string, string> | undefined;
+    name?: string | undefined;
+    price?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    compareAtPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    inventory?: {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+    } | undefined;
+    image?: {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    } | undefined;
+    isAvailable?: boolean | undefined;
+}>;
+export type ProductVariant = z.infer<typeof ProductVariantSchema>;
+/**
+ * Canonical Product Schema
+ *
+ * This represents a normalized product that can be mapped to/from:
+ * - BigCommerce Products
+ * - MYOB Stock Items
+ * - Adobe Commerce (Magento) Products
+ * - Shopify Products
+ * etc.
+ */
+export declare const CanonicalProductSchema: z.ZodObject<{
+    id: z.ZodString;
+    sku: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    shortDescription: z.ZodOptional<z.ZodString>;
+    price: z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>;
+    compareAtPrice: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>>;
+    costPrice: z.ZodOptional<z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>>;
+    taxable: z.ZodOptional<z.ZodBoolean>;
+    taxCode: z.ZodOptional<z.ZodString>;
+    inventory: z.ZodObject<{
+        quantity: z.ZodNumber;
+        tracked: z.ZodBoolean;
+        allowBackorder: z.ZodOptional<z.ZodBoolean>;
+        lowStockLevel: z.ZodOptional<z.ZodNumber>;
+        warningLevel: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+        lowStockLevel?: number | undefined;
+        warningLevel?: number | undefined;
+    }, {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+        lowStockLevel?: number | undefined;
+        warningLevel?: number | undefined;
+    }>;
+    weight: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        unit: z.ZodEnum<["kg", "g", "lb", "oz"]>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        unit: "g" | "kg" | "oz" | "lb";
+    }, {
+        value: number;
+        unit: "g" | "kg" | "oz" | "lb";
+    }>>;
+    dimensions: z.ZodOptional<z.ZodObject<{
+        length: z.ZodNumber;
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        unit: z.ZodEnum<["cm", "m", "in", "ft"]>;
+    }, "strip", z.ZodTypeAny, {
+        length: number;
+        unit: "cm" | "m" | "in" | "ft";
+        width: number;
+        height: number;
+    }, {
+        length: number;
+        unit: "cm" | "m" | "in" | "ft";
+        width: number;
+        height: number;
+    }>>;
+    isVisible: z.ZodOptional<z.ZodBoolean>;
+    availability: z.ZodOptional<z.ZodEnum<["available", "preorder", "backorder", "discontinued", "out-of-stock"]>>;
+    condition: z.ZodOptional<z.ZodEnum<["new", "refurbished", "used"]>>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    brand: z.ZodOptional<z.ZodString>;
+    manufacturer: z.ZodOptional<z.ZodString>;
+    images: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        altText: z.ZodOptional<z.ZodString>;
+        sortOrder: z.ZodOptional<z.ZodNumber>;
+        isThumbnail: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }, {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }>, "many">>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sku: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        price: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        }, {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        }>>;
+        compareAtPrice: z.ZodOptional<z.ZodObject<{
+            amount: z.ZodNumber;
+            currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        }, {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        }>>;
+        inventory: z.ZodOptional<z.ZodObject<{
+            quantity: z.ZodNumber;
+            tracked: z.ZodBoolean;
+            allowBackorder: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        }, {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        }>>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        image: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            altText: z.ZodOptional<z.ZodString>;
+            sortOrder: z.ZodOptional<z.ZodNumber>;
+            isThumbnail: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        }, {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        }>>;
+        isAvailable: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        sku: string;
+        options?: Record<string, string> | undefined;
+        name?: string | undefined;
+        price?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        compareAtPrice?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        inventory?: {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        } | undefined;
+        image?: {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        } | undefined;
+        isAvailable?: boolean | undefined;
+    }, {
+        id: string;
+        sku: string;
+        options?: Record<string, string> | undefined;
+        name?: string | undefined;
+        price?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        compareAtPrice?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        inventory?: {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        } | undefined;
+        image?: {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        } | undefined;
+        isAvailable?: boolean | undefined;
+    }>, "many">>;
+    hasVariants: z.ZodOptional<z.ZodBoolean>;
+    seo: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        keywords: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        description?: string | undefined;
+        title?: string | undefined;
+        keywords?: string[] | undefined;
+    }, {
+        description?: string | undefined;
+        title?: string | undefined;
+        keywords?: string[] | undefined;
+    }>>;
+    requiresShipping: z.ZodOptional<z.ZodBoolean>;
+    freeShipping: z.ZodOptional<z.ZodBoolean>;
+    customFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    metadata: z.ZodObject<{
+        createdAt: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        source: z.ZodString;
+        sourceId: z.ZodString;
+        externalIds: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        sourceId: string;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        externalIds?: Record<string, string> | undefined;
+    }, {
+        source: string;
+        sourceId: string;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        externalIds?: Record<string, string> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    sku: string;
+    name: string;
+    price: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    };
+    inventory: {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+        lowStockLevel?: number | undefined;
+        warningLevel?: number | undefined;
+    };
+    metadata: {
+        source: string;
+        sourceId: string;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        externalIds?: Record<string, string> | undefined;
+    };
+    compareAtPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    description?: string | undefined;
+    shortDescription?: string | undefined;
+    costPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    taxable?: boolean | undefined;
+    taxCode?: string | undefined;
+    weight?: {
+        value: number;
+        unit: "g" | "kg" | "oz" | "lb";
+    } | undefined;
+    dimensions?: {
+        length: number;
+        unit: "cm" | "m" | "in" | "ft";
+        width: number;
+        height: number;
+    } | undefined;
+    isVisible?: boolean | undefined;
+    availability?: "available" | "preorder" | "backorder" | "discontinued" | "out-of-stock" | undefined;
+    condition?: "new" | "refurbished" | "used" | undefined;
+    categories?: string[] | undefined;
+    brand?: string | undefined;
+    manufacturer?: string | undefined;
+    images?: {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }[] | undefined;
+    variants?: {
+        id: string;
+        sku: string;
+        options?: Record<string, string> | undefined;
+        name?: string | undefined;
+        price?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        compareAtPrice?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        inventory?: {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        } | undefined;
+        image?: {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        } | undefined;
+        isAvailable?: boolean | undefined;
+    }[] | undefined;
+    hasVariants?: boolean | undefined;
+    seo?: {
+        description?: string | undefined;
+        title?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
+    requiresShipping?: boolean | undefined;
+    freeShipping?: boolean | undefined;
+    customFields?: Record<string, any> | undefined;
+}, {
+    id: string;
+    sku: string;
+    name: string;
+    price: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    };
+    inventory: {
+        quantity: number;
+        tracked: boolean;
+        allowBackorder?: boolean | undefined;
+        lowStockLevel?: number | undefined;
+        warningLevel?: number | undefined;
+    };
+    metadata: {
+        source: string;
+        sourceId: string;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        externalIds?: Record<string, string> | undefined;
+    };
+    compareAtPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    description?: string | undefined;
+    shortDescription?: string | undefined;
+    costPrice?: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    } | undefined;
+    taxable?: boolean | undefined;
+    taxCode?: string | undefined;
+    weight?: {
+        value: number;
+        unit: "g" | "kg" | "oz" | "lb";
+    } | undefined;
+    dimensions?: {
+        length: number;
+        unit: "cm" | "m" | "in" | "ft";
+        width: number;
+        height: number;
+    } | undefined;
+    isVisible?: boolean | undefined;
+    availability?: "available" | "preorder" | "backorder" | "discontinued" | "out-of-stock" | undefined;
+    condition?: "new" | "refurbished" | "used" | undefined;
+    categories?: string[] | undefined;
+    brand?: string | undefined;
+    manufacturer?: string | undefined;
+    images?: {
+        url: string;
+        altText?: string | undefined;
+        sortOrder?: number | undefined;
+        isThumbnail?: boolean | undefined;
+    }[] | undefined;
+    variants?: {
+        id: string;
+        sku: string;
+        options?: Record<string, string> | undefined;
+        name?: string | undefined;
+        price?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        compareAtPrice?: {
+            amount: number;
+            currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+        } | undefined;
+        inventory?: {
+            quantity: number;
+            tracked: boolean;
+            allowBackorder?: boolean | undefined;
+        } | undefined;
+        image?: {
+            url: string;
+            altText?: string | undefined;
+            sortOrder?: number | undefined;
+            isThumbnail?: boolean | undefined;
+        } | undefined;
+        isAvailable?: boolean | undefined;
+    }[] | undefined;
+    hasVariants?: boolean | undefined;
+    seo?: {
+        description?: string | undefined;
+        title?: string | undefined;
+        keywords?: string[] | undefined;
+    } | undefined;
+    requiresShipping?: boolean | undefined;
+    freeShipping?: boolean | undefined;
+    customFields?: Record<string, any> | undefined;
+}>;
+export type CanonicalProduct = z.infer<typeof CanonicalProductSchema>;
+/**
+ * Minimal product schema for simple operations
+ */
+export declare const MinimalProductSchema: z.ZodObject<{
+    id: z.ZodString;
+    sku: z.ZodString;
+    name: z.ZodString;
+    price: z.ZodObject<{
+        amount: z.ZodNumber;
+        currency: z.ZodEnum<["USD", "EUR", "GBP", "AUD", "CAD", "NZD", "JPY", "CNY", "INR", "SGD", "HKD", "MXN", "BRL", "ZAR"]>;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }, {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    }>;
+    inventory: z.ZodObject<{
+        quantity: z.ZodNumber;
+        tracked: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        quantity: number;
+        tracked: boolean;
+    }, {
+        quantity: number;
+        tracked: boolean;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    sku: string;
+    name: string;
+    price: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    };
+    inventory: {
+        quantity: number;
+        tracked: boolean;
+    };
+}, {
+    id: string;
+    sku: string;
+    name: string;
+    price: {
+        amount: number;
+        currency: "USD" | "EUR" | "GBP" | "AUD" | "CAD" | "NZD" | "JPY" | "CNY" | "INR" | "SGD" | "HKD" | "MXN" | "BRL" | "ZAR";
+    };
+    inventory: {
+        quantity: number;
+        tracked: boolean;
+    };
+}>;
+export type MinimalProduct = z.infer<typeof MinimalProductSchema>;
+export declare const ProductHelper: {
+    /**
+     * Check if product is in stock
+     */
+    isInStock(product: CanonicalProduct): boolean;
+    /**
+     * Check if product is low stock
+     */
+    isLowStock(product: CanonicalProduct): boolean;
+    /**
+     * Get product display price (considering compare-at price)
+     */
+    getDisplayPrice(product: CanonicalProduct): {
+        price: Money;
+        isOnSale: boolean;
+        discount?: Money;
+    };
+    /**
+     * Get product thumbnail image
+     */
+    getThumbnail(product: CanonicalProduct): ProductImage | null;
+    /**
+     * Get variant by SKU
+     */
+    getVariantBySku(product: CanonicalProduct, sku: string): ProductVariant | null;
+    /**
+     * Get total inventory across all variants
+     */
+    getTotalInventory(product: CanonicalProduct): number;
+    /**
+     * Create a minimal product from full product
+     */
+    toMinimal(product: CanonicalProduct): MinimalProduct;
+    /**
+     * Check if product has valid price
+     */
+    hasValidPrice(product: CanonicalProduct): boolean;
+    /**
+     * Get product weight in kilograms (normalized)
+     */
+    getWeightInKg(product: CanonicalProduct): number | null;
+    /**
+     * Get product volume in cubic meters (normalized)
+     */
+    getVolumeInCubicMeters(product: CanonicalProduct): number | null;
+};
+//# sourceMappingURL=product.d.ts.map