@blezgo/api-sdk 0.1.2 → 0.1.3

package/dist/products/generated.d.ts

@@ -1217,276 +1217,169 @@ export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
         /**
-         * VariantUpdateRequest
-         * @description Request model for updating a variant.
-         */
-        VariantUpdateRequest: {
-            /** Name */
-            name?: string | null;
-            /** Sku */
-            sku?: string | null;
-            /** Barcode */
-            barcode?: string | null;
-            /** Attributes */
-            attributes?: {
-                [key: string]: unknown;
-            } | null;
-            /** Is Default */
-            is_default?: boolean | null;
-            status?: components["schemas"]["VariantStatus"] | null;
-            /** Display Order */
-            display_order?: number | null;
-            /** Metadata */
-            metadata?: {
-                [key: string]: unknown;
-            } | null;
-            /** Track Inventory */
-            track_inventory?: boolean | null;
-            /** Stock Quantity */
-            stock_quantity?: number | null;
-            /** Allow Backorder */
-            allow_backorder?: boolean | null;
-            /** Weight */
-            weight?: number | string | null;
-            /** Length */
-            length?: number | string | null;
-            /** Width */
-            width?: number | string | null;
-            /** Height */
-            height?: number | string | null;
-        };
-        ErrorResponse: {
-            /** @example about:blank */
-            type?: string;
-            /** @example GENERIC_ERROR */
-            code?: string;
-            /** @example Client Error */
-            title?: string;
-            /** @example 400 */
-            status?: number;
-            /** @example An error occurred */
-            detail?: string;
-            /** @example /v1/cart/items */
-            instance?: string;
-            extensions?: components["schemas"]["Extensions"];
-        };
-        /**
-         * VariantStatus
-         * @description Variant status enum.
-         * @enum {string}
-         */
-        VariantStatus: "active" | "inactive" | "out_of_stock" | "discontinued";
-        /**
-         * SeoUpsertRequest
-         * @description Unified SEO upsert schema for all entity types (space, product, service, ...).
-         *
-         *     Locale is NOT in this body — it comes from the URL path:
-         *         PUT /v1/spaces/admin/{space_id}/seo/{locale}
-         *         PUT /v1/products/{product_id}/seo/{locale}
-         *
-         *     All fields are optional; supply only what you want to set.
-         *     Fields absent from the request body are stored as NULL (PUT semantics — full replace).
-         *
-         *     extra='forbid' inherited from BaseSeoFields — unknown keys are rejected.
-         *     All validators (robots, URL, og_locale, twitter handle, alternate_languages)
-         *     are also inherited from BaseSeoFields.
-         * @example {
-         *       "alternate_languages": [
-         *         {
-         *           "lang": "en-US",
-         *           "url": "https://www.example.com/courses/python"
-         *         },
-         *         {
-         *           "lang": "es-PR",
-         *           "url": "https://www.example.com/es/cursos/python"
-         *         },
-         *         {
-         *           "lang": "fr-FR",
-         *           "url": "https://www.example.com/fr/cours/python"
-         *         },
-         *         {
-         *           "lang": "x-default",
-         *           "url": "https://www.example.com/courses/python"
-         *         }
-         *       ],
-         *       "canonical_url": "https://www.example.com/courses/python",
-         *       "is_indexable": true,
-         *       "meta_description": "Explore our full library of Python courses. Beginner to advanced, taught by industry experts.",
-         *       "meta_keywords": "python, programming, learn python, python course, coding",
-         *       "meta_title": "Browse Python Courses — Learn at Any Level",
-         *       "og_description": "From beginner to advanced. Join 50,000+ learners on MyPlatform.",
-         *       "og_image": "https://cdn.example.com/og/python-courses.jpg",
-         *       "og_image_alt": "A student learning Python on a laptop in a modern workspace",
-         *       "og_image_height": 630,
-         *       "og_image_width": 1200,
-         *       "og_locale": "en_US",
-         *       "og_site_name": "MyPlatform",
-         *       "og_title": "Python Courses — Learn at Your Own Pace",
-         *       "og_type": "website",
-         *       "og_url": "https://www.example.com/courses/python",
-         *       "robots": "index,follow,max-snippet:-1,max-image-preview:large,max-video-preview:30",
-         *       "structured_data": {
-         *         "@context": "https://schema.org",
-         *         "@type": "ItemList",
-         *         "description": "Browse all Python courses on MyPlatform",
-         *         "itemListElement": [
-         *           {
-         *             "@type": "ListItem",
-         *             "name": "Python for Beginners",
-         *             "position": 1,
-         *             "url": "https://www.example.com/courses/python-beginners"
-         *           },
-         *           {
-         *             "@type": "ListItem",
-         *             "name": "Advanced Python",
-         *             "position": 2,
-         *             "url": "https://www.example.com/courses/python-advanced"
-         *           }
-         *         ],
-         *         "name": "Python Courses",
-         *         "numberOfItems": 42,
-         *         "url": "https://www.example.com/courses/python"
-         *       },
-         *       "twitter_card": "summary_large_image",
-         *       "twitter_creator": "@myplatform",
-         *       "twitter_description": "From beginner to advanced. Join 50,000+ learners.",
-         *       "twitter_image": "https://cdn.example.com/twitter/python-courses.jpg",
-         *       "twitter_image_alt": "A student learning Python on a laptop",
-         *       "twitter_site": "@myplatform",
-         *       "twitter_title": "Python Courses on MyPlatform"
-         *     }
+         * ProductIdentityCreateRequest
+         * @description Create localized product content
          */
-        SeoUpsertRequest: {
-            /**
-             * Og Title
-             * @description og:title — headline shown in social link previews. Defaults to the entity title if omitted. Keep ≤95 chars.
-             */
-            og_title?: string | null;
-            /**
-             * Og Description
-             * @description og:description — subtitle shown in social link previews.
-             */
-            og_description?: string | null;
-            /**
-             * Og Image
-             * @description og:image — full URL (http/https) of the preview image. Recommended size: 1200×630 px.
-             */
-            og_image?: string | null;
-            /**
-             * Og Type
-             * @description og:type — content type for social platforms. Values: 'website' | 'article' | 'product' | 'video.other' | 'music.song' | 'profile' | 'book'.
-             */
-            og_type?: ("website" | "article" | "product" | "video.other" | "music.song" | "profile" | "book") | null;
-            /**
-             * Twitter Card
-             * @description twitter:card — card layout on Twitter/X. Values: 'summary' | 'summary_large_image' | 'app' | 'player'.
-             */
-            twitter_card?: ("summary" | "summary_large_image" | "app" | "player") | null;
-            /**
-             * Twitter Title
-             * @description twitter:title — overrides og_title for Twitter/X. Keep ≤70 chars.
-             */
-            twitter_title?: string | null;
-            /**
-             * Twitter Description
-             * @description twitter:description — overrides og_description for Twitter/X.
-             */
-            twitter_description?: string | null;
-            /**
-             * Twitter Image
-             * @description twitter:image — full URL (http/https). Overrides og_image for Twitter/X. Min 144×144 px, max 4096×4096 px.
-             */
-            twitter_image?: string | null;
-            /**
-             * Canonical Url
-             * @description <link rel='canonical'>. Full URL (http/https). Set when this page has duplicate content at another URL.
-             */
-            canonical_url?: string | null;
-            /**
-             * Robots
-             * @description <meta name='robots'>. Comma-separated directives. Simple: index, noindex, follow, nofollow, noarchive, nosnippet, noimageindex, none, all, notranslate, noodp. Parametric: max-snippet:-1, max-snippet:150, max-image-preview:none|standard|large, max-video-preview:-1, max-video-preview:30, unavailable_after:<date>. Examples: 'index,follow' | 'noindex,nofollow' | 'index,follow,max-snippet:-1,max-image-preview:large'.
-             */
-            robots?: string | null;
+        ProductIdentityCreateRequest: {
             /**
-             * Meta Title
-             * @description <title> and <meta name='title'>. Keep ≤60 chars for Google display.
+             * @description Locale (language-country format)
+             * @example en-US
              */
-            meta_title?: string | null;
+            locale: components["schemas"]["Locale"];
             /**
-             * Meta Description
-             * @description <meta name='description'>. Keep ≤160 chars for Google display.
+             * Title
+             * @example Python Programming Course
              */
-            meta_description?: string | null;
+            title: string;
             /**
-             * Meta Keywords
-             * @description Comma-separated keywords. Low weight for Google, used for internal search.
+             * Subtitle
+             * @example Master Python in 30 days
              */
-            meta_keywords?: string | null;
+            subtitle?: string | null;
             /**
-             * Og Image Width
-             * @description og:image:width in pixels. Recommended: 1200.
+             * Description
+             * @example Comprehensive Python course covering basics to advanced topics
              */
-            og_image_width?: number | null;
+            description?: string | null;
             /**
-             * Og Image Height
-             * @description og:image:height in pixels. Recommended: 630.
+             * Short Description
+             * @example Learn Python from scratch with hands-on projects
              */
-            og_image_height?: number | null;
+            short_description?: string | null;
+        };
+        /**
+         * Locale
+         * @description Supported locales (language-country format)
+         * @enum {string}
+         */
+        Locale: "en-US" | "es-PR" | "es-ES" | "fr-FR" | "pt-BR" | "de-DE" | "it-IT" | "ja-JP" | "zh-CN";
+        /**
+         * AddTagToProductRequest
+         * @example {
+         *       "display_order": 0,
+         *       "tag_id": 5
+         *     }
+         */
+        AddTagToProductRequest: {
             /**
-             * Og Image Alt
-             * @description og:image:alt — alt text for the OG image.
+             * Tag Id
+             * @example 5
              */
-            og_image_alt?: string | null;
+            tag_id: number;
             /**
-             * Og Url
-             * @description og:url — canonical URL used by social platforms.
+             * Display Order
+             * @default 0
+             * @example 0
              */
-            og_url?: string | null;
+            display_order: number;
+        };
+        /**
+         * ProductCurrency
+         * @enum {string}
+         */
+        ProductCurrency: "USD" | "INR" | "EUR" | "GBP";
+        /**
+         * VariantStatus
+         * @description Variant status enum.
+         * @enum {string}
+         */
+        VariantStatus: "active" | "inactive" | "out_of_stock" | "discontinued";
+        /**
+         * ProductStatus
+         * @description Product status values (Phase 1 - VARCHAR)
+         * @enum {string}
+         */
+        ProductStatus: "draft" | "published" | "archived" | "review_required" | "deleted";
+        /**
+         * AddBundleItemRequest
+         * @example {
+         *       "discount_percentage": 10,
+         *       "display_order": 0,
+         *       "is_required": true,
+         *       "is_visible": true,
+         *       "item_product_id": 456,
+         *       "quantity": 1
+         *     }
+         */
+        AddBundleItemRequest: {
             /**
-             * Og Site Name
-             * @description og:site_name — your platform name shown in the link preview card.
+             * Item Product Id
+             * @example 456
              */
-            og_site_name?: string | null;
+            item_product_id: number;
             /**
-             * Og Locale
-             * @description og:locale — language in underscore format: en_US, es_ES, fr_FR.
+             * Quantity
+             * @default 1
+             * @example 1
              */
-            og_locale?: string | null;
+            quantity: number;
             /**
-             * Twitter Image Alt
-             * @description twitter:image:alt — alt text for the Twitter card image.
+             * Discount Percentage
+             * @description Discount % (0-100)
+             * @example 10
              */
-            twitter_image_alt?: string | null;
+            discount_percentage?: number | null;
             /**
-             * Twitter Site
-             * @description twitter:site — your Twitter/X account handle. Must start with '@'.
+             * Override Price
+             * @description Override price for this item
+             * @example 49.99
              */
-            twitter_site?: string | null;
+            override_price?: number | null;
             /**
-             * Twitter Creator
-             * @description twitter:creator — author's Twitter/X handle. Must start with '@'.
+             * Is Required
+             * @default true
+             * @example true
              */
-            twitter_creator?: string | null;
+            is_required: boolean;
             /**
-             * Is Indexable
-             * @description System-level indexing override. False → page is treated as noindex regardless of the robots field. True → robots field is authoritative.
+             * Is Visible
              * @default true
+             * @example true
              */
-            is_indexable: boolean;
+            is_visible: boolean;
             /**
-             * Structured Data
-             * @description Schema.org JSON-LD object for Google rich results.
+             * Display Order
+             * @default 0
+             * @example 0
              */
-            structured_data?: {
-                [key: string]: unknown;
-            } | null;
+            display_order: number;
+        };
+        /**
+         * ProductInterval
+         * @enum {string}
+         */
+        ProductInterval: "day" | "week" | "month" | "year";
+        /** Body_createProductImageUpload */
+        Body_createProductImageUpload: {
             /**
-             * Alternate Languages
-             * @description hreflang list: [{"lang":"en-US","url":"https://..."},{"lang":"x-default","url":"..."}]. Always include x-default.
+             * Image File
+             * Format: binary
              */
-            alternate_languages?: {
-                [key: string]: string;
-            }[] | null;
+            image_file: string;
+        };
+        Extensions: {
+            /** @example GENERIC_ERROR */
+            message_code?: string;
+            /** @example [] */
+            invalid_params?: components["schemas"]["InvalidParam"][];
+            extra_data?: Record<string, never> | null;
+            /** @example Detailed debug information */
+            debug?: string | null;
+        };
+        ErrorResponse: {
+            /** @example about:blank */
+            type?: string;
+            /** @example GENERIC_ERROR */
+            code?: string;
+            /** @example Client Error */
+            title?: string;
+            /** @example 400 */
+            status?: number;
+            /** @example An error occurred */
+            detail?: string;
+            /** @example /v1/cart/items */
+            instance?: string;
+            extensions?: components["schemas"]["Extensions"];
         };
         /**
          * ProductUpdateRequest
@@ -1528,65 +1421,111 @@ export interface components {
              */
             description?: string | null;
         };
-        Extensions: {
-            /** @example GENERIC_ERROR */
-            message_code?: string;
-            /** @example [] */
-            invalid_params?: components["schemas"]["InvalidParam"][];
-            extra_data?: Record<string, never> | null;
-            /** @example Detailed debug information */
-            debug?: string | null;
-        };
-        InvalidParam: {
-            /** @example items[0].quantity */
-            field?: string;
-            /** @example Input should be greater than or equal to 1 */
-            error?: string;
-        };
-        /** Body_createProductImageUpload */
-        Body_createProductImageUpload: {
+        /**
+         * VariantInventoryInput
+         * @description Inventory data for variant creation.
+         */
+        VariantInventoryInput: {
             /**
-             * Image File
-             * Format: binary
+             * Track Inventory
+             * @description Track stock for this variant
+             * @default true
              */
-            image_file: string;
+            track_inventory: boolean;
+            /**
+             * Stock Quantity
+             * @description Initial stock quantity
+             */
+            stock_quantity?: number | null;
+            /**
+             * Allow Backorder
+             * @description Allow orders when out of stock
+             * @default false
+             */
+            allow_backorder: boolean;
+        };
+        /**
+         * VariantUpdateRequest
+         * @description Request model for updating a variant.
+         */
+        VariantUpdateRequest: {
+            /** Name */
+            name?: string | null;
+            /** Sku */
+            sku?: string | null;
+            /** Barcode */
+            barcode?: string | null;
+            /** Attributes */
+            attributes?: {
+                [key: string]: unknown;
+            } | null;
+            /** Is Default */
+            is_default?: boolean | null;
+            status?: components["schemas"]["VariantStatus"] | null;
+            /** Display Order */
+            display_order?: number | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /** Track Inventory */
+            track_inventory?: boolean | null;
+            /** Stock Quantity */
+            stock_quantity?: number | null;
+            /** Allow Backorder */
+            allow_backorder?: boolean | null;
+            /** Weight */
+            weight?: number | string | null;
+            /** Length */
+            length?: number | string | null;
+            /** Width */
+            width?: number | string | null;
+            /** Height */
+            height?: number | string | null;
         };
         /**
-         * ProductType
-         * @description Product types supported (11 active types)
-         * @enum {string}
-         */
-        ProductType: "course" | "package" | "session" | "webinar" | "bundle" | "meeting" | "open_class" | "plan" | "test" | "appointment" | "limit_minutes";
-        /**
-         * ProductCurrency
-         * @enum {string}
-         */
-        ProductCurrency: "USD" | "INR" | "EUR" | "GBP";
-        /**
-         * ProductInterval
-         * @enum {string}
-         */
-        ProductInterval: "day" | "week" | "month" | "year";
-        /**
-         * InventoryAdjustmentRequest
-         * @description Request model for inventory adjustment.
+         * @example {
+         *       "status": "success",
+         *       "message": "Operation successful",
+         *       "message_code": "api_suc_20001",
+         *       "data": {},
+         *       "metadata": {
+         *         "timestamp": "2026-03-26T10:00:00.000Z",
+         *         "requestId": "07e22004-cb60-4dfc-bc9c-b6f99664dca1",
+         *         "traceId": "a9f1204c-bb82-41de-b234-7c3a9e120000",
+         *         "version": "v1",
+         *         "executionTime": 42,
+         *         "language": "en-US"
+         *       }
+         *     }
          */
-        InventoryAdjustmentRequest: {
-            /**
-             * Adjustment Type
-             * @description add, subtract, or set
-             */
-            adjustment_type: string;
-            /**
-             * Quantity
-             * @description Quantity to add/subtract/set
-             */
-            quantity: number;
-            /**
-             * Reason
-             * @description Reason for adjustment
-             */
-            reason?: string | null;
+        StandardResponse: {
+            /** @example success */
+            status?: string;
+            data?: Record<string, never> | null;
+            /** @example Operation successful */
+            message?: string | null;
+            /** @example api_suc_20001 */
+            message_code?: string | null;
+            metadata?: Record<string, never> | null;
+            error?: components["schemas"]["ErrorResponse"];
+        };
+        /** ProductPriceUpdateRequest */
+        ProductPriceUpdateRequest: {
+            /** Amount */
+            amount?: number | null;
+            currency?: components["schemas"]["ProductCurrency"] | null;
+            interval?: components["schemas"]["ProductInterval"] | null;
+            /** Interval Count */
+            interval_count?: number | null;
+            /** Trial Period Days */
+            trial_period_days?: number | null;
+            /** Initial Amount */
+            initial_amount?: number | null;
+            /** Compare Price */
+            compare_price?: number | null;
+            /** Is Active */
+            is_active?: boolean | null;
         };
         /**
          * VariantCreateRequest
@@ -1669,65 +1608,240 @@ export interface components {
             } | null;
         };
         /**
-         * ProductIdentityCreateRequest
-         * @description Create localized product content
+         * InventoryAdjustmentRequest
+         * @description Request model for inventory adjustment.
          */
-        ProductIdentityCreateRequest: {
+        InventoryAdjustmentRequest: {
+            /**
+             * Adjustment Type
+             * @description add, subtract, or set
+             */
+            adjustment_type: string;
+            /**
+             * Quantity
+             * @description Quantity to add/subtract/set
+             */
+            quantity: number;
+            /**
+             * Reason
+             * @description Reason for adjustment
+             */
+            reason?: string | null;
+        };
+        /** ProductPriceRequest */
+        ProductPriceRequest: {
+            /**
+             * Company Id
+             * @description Company ID for gateway configuration
+             * @example 1
+             */
+            company_id: number;
+            /** @example subscription */
+            price_type: components["schemas"]["ProductPriceType"];
+            /**
+             * Amount
+             * @example 52
+             */
+            amount: number;
+            /** @example USD */
+            currency: components["schemas"]["ProductCurrency"];
+            /**
+             * Gateway
+             * @example stripe
+             */
+            gateway?: string | null;
+            /**
+             * Is Live
+             * @default false
+             * @example false
+             */
+            is_live: boolean;
+            /** @example month */
+            interval?: components["schemas"]["ProductInterval"] | null;
+            /**
+             * Interval Count
+             * @example 1
+             */
+            interval_count?: number | null;
+            /**
+             * Trial Period Days
+             * @default 0
+             * @example 0
+             */
+            trial_period_days: number | null;
+            /**
+             * Initial Amount
+             * @example 0
+             */
+            initial_amount?: number | null;
+            /**
+             * Compare Price
+             * @example 0
+             */
+            compare_price?: number | null;
+            /**
+             * Object Id
+             * @example 0
+             */
+            object_id?: number | null;
+            /**
+             * Module Id
+             * @example 0
+             */
+            module_id?: number | null;
+            /**
+             * Requires Payment Method Upfront
+             * @description False=Gateway-managed trial (send trial to gateway), True=App-managed trial (don't send trial to gateway)
+             * @default false
+             * @example false
+             */
+            requires_payment_method_upfront: boolean;
+        };
+        /** Body_createProductImage */
+        Body_createProductImage: {
+            /**
+             * File
+             * Format: binary
+             */
+            file: string;
+        };
+        /**
+         * ProductPriceType
+         * @enum {string}
+         */
+        ProductPriceType: "free" | "subscription" | "onetime" | "emi";
+        InvalidParam: {
+            /** @example items[0].quantity */
+            field?: string;
+            /** @example Input should be greater than or equal to 1 */
+            error?: string;
+        };
+        /**
+         * CreateTagRequest
+         * @example {
+         *       "color": "#3776AB",
+         *       "description": "Programming language tag for Python courses",
+         *       "tag_name": "Python Programming",
+         *       "tag_type": "skill"
+         *     }
+         */
+        app__routes__products__product_phase2_routes__CreateTagRequest: {
+            /**
+             * Tag Name
+             * @example Python Programming
+             */
+            tag_name: string;
+            /**
+             * Tag Type
+             * @description category, topic, skill, difficulty
+             * @example skill
+             */
+            tag_type?: string | null;
+            /**
+             * Description
+             * @example Programming language tag for Python courses
+             */
+            description?: string | null;
+            /**
+             * Color
+             * @description HEX color code
+             * @example #3776AB
+             */
+            color?: string | null;
+        };
+        /**
+         * VariantImageInput
+         * @description Image data for variant creation.
+         */
+        VariantImageInput: {
+            /**
+             * Image Url
+             * @description Image URL
+             */
+            image_url: string;
+            /**
+             * Image Type
+             * @description primary, gallery, thumbnail
+             * @default primary
+             */
+            image_type: string;
+            /**
+             * Display Order
+             * @description Display order
+             * @default 100
+             */
+            display_order: number;
+        };
+        /**
+         * ProductCreateRequest
+         * @description Create new product (base record only)
+         *     Identity (title, description, images) managed separately via ProductIdentity endpoints
+         */
+        ProductCreateRequest: {
+            /**
+             * Company Id
+             * @description Company ID for multi-company orgs
+             * @example 1
+             */
+            company_id?: number | null;
+            /**
+             * @description Product type
+             * @example course
+             */
+            product_type: components["schemas"]["ProductType"];
             /**
-             * @description Locale (language-country format)
-             * @example en-US
+             * Featured
+             * @description Featured product flag
+             * @default false
+             * @example false
              */
-            locale: components["schemas"]["Locale"];
+            featured: boolean;
             /**
-             * Title
-             * @example Python Programming Course
+             * Is Digital
+             * @description Digital product (default: True)
+             * @default true
+             * @example true
              */
-            title: string;
+            is_digital: boolean;
             /**
-             * Subtitle
-             * @example Master Python in 30 days
+             * Visibility
+             * @description Visibility: public, private, hidden, unlisted
+             * @default public
+             * @example public
              */
-            subtitle?: string | null;
+            visibility: string | null;
             /**
-             * Description
-             * @example Comprehensive Python course covering basics to advanced topics
+             * Is Org Level
+             * @description Organization-level product (True) vs user-created (False)
+             * @default true
+             * @example true
              */
-            description?: string | null;
+            is_org_level: boolean | null;
             /**
-             * Short Description
-             * @example Learn Python from scratch with hands-on projects
+             * Staff Id
+             * @description Staff/instructor who delivers this product
+             * @example 5
              */
-            short_description?: string | null;
-        };
-        /**
-         * VariantInventoryInput
-         * @description Inventory data for variant creation.
-         */
-        VariantInventoryInput: {
+            staff_id?: number | null;
             /**
-             * Track Inventory
-             * @description Track stock for this variant
-             * @default true
+             * Owner Id
+             * @description Owner of the product (user who created/owns it)
+             * @example 10
              */
-            track_inventory: boolean;
+            owner_id?: number | null;
             /**
-             * Stock Quantity
-             * @description Initial stock quantity
+             * Title
+             * @description DEPRECATED: Use ProductIdentity instead
+             * @example Python Programming
              */
-            stock_quantity?: number | null;
+            title?: string | null;
             /**
-             * Allow Backorder
-             * @description Allow orders when out of stock
-             * @default false
+             * Description
+             * @description DEPRECATED: Use ProductIdentity instead
+             * @example Learn Python from scratch
              */
-            allow_backorder: boolean;
+            description?: string | null;
         };
-        /**
-         * Locale
-         * @description Supported locales (language-country format)
-         * @enum {string}
-         */
-        Locale: "en-US" | "es-PR" | "es-ES" | "fr-FR" | "pt-BR" | "de-DE" | "it-IT" | "ja-JP" | "zh-CN";
         /**
          * VariantPricingInput
          * @description Pricing data for variant creation.
@@ -1763,337 +1877,223 @@ export interface components {
              */
             is_active: boolean;
         };
-        /** Body_createProductImage */
-        Body_createProductImage: {
-            /**
-             * File
-             * Format: binary
-             */
-            file: string;
-        };
-        /**
-         * AddBundleItemRequest
-         * @example {
-         *       "discount_percentage": 10,
-         *       "display_order": 0,
-         *       "is_required": true,
-         *       "is_visible": true,
-         *       "item_product_id": 456,
-         *       "quantity": 1
-         *     }
-         */
-        AddBundleItemRequest: {
-            /**
-             * Item Product Id
-             * @example 456
-             */
-            item_product_id: number;
-            /**
-             * Quantity
-             * @default 1
-             * @example 1
-             */
-            quantity: number;
-            /**
-             * Discount Percentage
-             * @description Discount % (0-100)
-             * @example 10
-             */
-            discount_percentage?: number | null;
-            /**
-             * Override Price
-             * @description Override price for this item
-             * @example 49.99
-             */
-            override_price?: number | null;
-            /**
-             * Is Required
-             * @default true
-             * @example true
-             */
-            is_required: boolean;
-            /**
-             * Is Visible
-             * @default true
-             * @example true
-             */
-            is_visible: boolean;
-            /**
-             * Display Order
-             * @default 0
-             * @example 0
-             */
-            display_order: number;
-        };
-        /**
-         * AddTagToProductRequest
-         * @example {
-         *       "display_order": 0,
-         *       "tag_id": 5
-         *     }
-         */
-        AddTagToProductRequest: {
-            /**
-             * Tag Id
-             * @example 5
-             */
-            tag_id: number;
-            /**
-             * Display Order
-             * @default 0
-             * @example 0
-             */
-            display_order: number;
-        };
         /**
-         * ProductPriceType
+         * ProductType
+         * @description Product types supported (11 active types)
          * @enum {string}
          */
-        ProductPriceType: "free" | "subscription" | "onetime" | "emi";
-        /** ProductPriceUpdateRequest */
-        ProductPriceUpdateRequest: {
-            /** Amount */
-            amount?: number | null;
-            currency?: components["schemas"]["ProductCurrency"] | null;
-            interval?: components["schemas"]["ProductInterval"] | null;
-            /** Interval Count */
-            interval_count?: number | null;
-            /** Trial Period Days */
-            trial_period_days?: number | null;
-            /** Initial Amount */
-            initial_amount?: number | null;
-            /** Compare Price */
-            compare_price?: number | null;
-            /** Is Active */
-            is_active?: boolean | null;
-        };
+        ProductType: "course" | "package" | "session" | "webinar" | "bundle" | "meeting" | "open_class" | "plan" | "test" | "appointment" | "limit_minutes";
         /**
-         * ProductCreateRequest
-         * @description Create new product (base record only)
-         *     Identity (title, description, images) managed separately via ProductIdentity endpoints
+         * SeoUpsertRequest
+         * @description Unified SEO upsert schema for all entity types (space, product, service, ...).
+         *
+         *     Locale is NOT in this body — it comes from the URL path:
+         *         PUT /v1/spaces/admin/{space_id}/seo/{locale}
+         *         PUT /v1/products/{product_id}/seo/{locale}
+         *
+         *     All fields are optional; supply only what you want to set.
+         *     Fields absent from the request body are stored as NULL (PUT semantics — full replace).
+         *
+         *     extra='forbid' inherited from BaseSeoFields — unknown keys are rejected.
+         *     All validators (robots, URL, og_locale, twitter handle, alternate_languages)
+         *     are also inherited from BaseSeoFields.
+         * @example {
+         *       "alternate_languages": [
+         *         {
+         *           "lang": "en-US",
+         *           "url": "https://www.example.com/courses/python"
+         *         },
+         *         {
+         *           "lang": "es-PR",
+         *           "url": "https://www.example.com/es/cursos/python"
+         *         },
+         *         {
+         *           "lang": "fr-FR",
+         *           "url": "https://www.example.com/fr/cours/python"
+         *         },
+         *         {
+         *           "lang": "x-default",
+         *           "url": "https://www.example.com/courses/python"
+         *         }
+         *       ],
+         *       "canonical_url": "https://www.example.com/courses/python",
+         *       "is_indexable": true,
+         *       "meta_description": "Explore our full library of Python courses. Beginner to advanced, taught by industry experts.",
+         *       "meta_keywords": "python, programming, learn python, python course, coding",
+         *       "meta_title": "Browse Python Courses — Learn at Any Level",
+         *       "og_description": "From beginner to advanced. Join 50,000+ learners on MyPlatform.",
+         *       "og_image": "https://cdn.example.com/og/python-courses.jpg",
+         *       "og_image_alt": "A student learning Python on a laptop in a modern workspace",
+         *       "og_image_height": 630,
+         *       "og_image_width": 1200,
+         *       "og_locale": "en_US",
+         *       "og_site_name": "MyPlatform",
+         *       "og_title": "Python Courses — Learn at Your Own Pace",
+         *       "og_type": "website",
+         *       "og_url": "https://www.example.com/courses/python",
+         *       "robots": "index,follow,max-snippet:-1,max-image-preview:large,max-video-preview:30",
+         *       "structured_data": {
+         *         "@context": "https://schema.org",
+         *         "@type": "ItemList",
+         *         "description": "Browse all Python courses on MyPlatform",
+         *         "itemListElement": [
+         *           {
+         *             "@type": "ListItem",
+         *             "name": "Python for Beginners",
+         *             "position": 1,
+         *             "url": "https://www.example.com/courses/python-beginners"
+         *           },
+         *           {
+         *             "@type": "ListItem",
+         *             "name": "Advanced Python",
+         *             "position": 2,
+         *             "url": "https://www.example.com/courses/python-advanced"
+         *           }
+         *         ],
+         *         "name": "Python Courses",
+         *         "numberOfItems": 42,
+         *         "url": "https://www.example.com/courses/python"
+         *       },
+         *       "twitter_card": "summary_large_image",
+         *       "twitter_creator": "@myplatform",
+         *       "twitter_description": "From beginner to advanced. Join 50,000+ learners.",
+         *       "twitter_image": "https://cdn.example.com/twitter/python-courses.jpg",
+         *       "twitter_image_alt": "A student learning Python on a laptop",
+         *       "twitter_site": "@myplatform",
+         *       "twitter_title": "Python Courses on MyPlatform"
+         *     }
          */
-        ProductCreateRequest: {
-            /**
-             * Company Id
-             * @description Company ID for multi-company orgs
-             * @example 1
-             */
-            company_id?: number | null;
-            /**
-             * @description Product type
-             * @example course
-             */
-            product_type: components["schemas"]["ProductType"];
-            /**
-             * Featured
-             * @description Featured product flag
-             * @default false
-             * @example false
-             */
-            featured: boolean;
+        SeoUpsertRequest: {
             /**
-             * Is Digital
-             * @description Digital product (default: True)
-             * @default true
-             * @example true
+             * Og Title
+             * @description og:title — headline shown in social link previews. Defaults to the entity title if omitted. Keep ≤95 chars.
              */
-            is_digital: boolean;
+            og_title?: string | null;
             /**
-             * Visibility
-             * @description Visibility: public, private, hidden, unlisted
-             * @default public
-             * @example public
+             * Og Description
+             * @description og:description — subtitle shown in social link previews.
              */
-            visibility: string | null;
+            og_description?: string | null;
             /**
-             * Is Org Level
-             * @description Organization-level product (True) vs user-created (False)
-             * @default true
-             * @example true
+             * Og Image
+             * @description og:image — full URL (http/https) of the preview image. Recommended size: 1200×630 px.
              */
-            is_org_level: boolean | null;
+            og_image?: string | null;
             /**
-             * Staff Id
-             * @description Staff/instructor who delivers this product
-             * @example 5
+             * Og Type
+             * @description og:type — content type for social platforms. Values: 'website' | 'article' | 'product' | 'video.other' | 'music.song' | 'profile' | 'book'.
              */
-            staff_id?: number | null;
+            og_type?: ("website" | "article" | "product" | "video.other" | "music.song" | "profile" | "book") | null;
             /**
-             * Owner Id
-             * @description Owner of the product (user who created/owns it)
-             * @example 10
+             * Twitter Card
+             * @description twitter:card — card layout on Twitter/X. Values: 'summary' | 'summary_large_image' | 'app' | 'player'.
              */
-            owner_id?: number | null;
+            twitter_card?: ("summary" | "summary_large_image" | "app" | "player") | null;
             /**
-             * Title
-             * @description DEPRECATED: Use ProductIdentity instead
-             * @example Python Programming
+             * Twitter Title
+             * @description twitter:title — overrides og_title for Twitter/X. Keep ≤70 chars.
              */
-            title?: string | null;
+            twitter_title?: string | null;
             /**
-             * Description
-             * @description DEPRECATED: Use ProductIdentity instead
-             * @example Learn Python from scratch
+             * Twitter Description
+             * @description twitter:description — overrides og_description for Twitter/X.
              */
-            description?: string | null;
-        };
-        /**
-         * CreateTagRequest
-         * @example {
-         *       "color": "#3776AB",
-         *       "description": "Programming language tag for Python courses",
-         *       "tag_name": "Python Programming",
-         *       "tag_type": "skill"
-         *     }
-         */
-        CreateTagRequest: {
+            twitter_description?: string | null;
             /**
-             * Tag Name
-             * @example Python Programming
+             * Twitter Image
+             * @description twitter:image — full URL (http/https). Overrides og_image for Twitter/X. Min 144×144 px, max 4096×4096 px.
              */
-            tag_name: string;
+            twitter_image?: string | null;
             /**
-             * Tag Type
-             * @description category, topic, skill, difficulty
-             * @example skill
+             * Canonical Url
+             * @description <link rel='canonical'>. Full URL (http/https). Set when this page has duplicate content at another URL.
              */
-            tag_type?: string | null;
+            canonical_url?: string | null;
             /**
-             * Description
-             * @example Programming language tag for Python courses
+             * Robots
+             * @description <meta name='robots'>. Comma-separated directives. Simple: index, noindex, follow, nofollow, noarchive, nosnippet, noimageindex, none, all, notranslate, noodp. Parametric: max-snippet:-1, max-snippet:150, max-image-preview:none|standard|large, max-video-preview:-1, max-video-preview:30, unavailable_after:<date>. Examples: 'index,follow' | 'noindex,nofollow' | 'index,follow,max-snippet:-1,max-image-preview:large'.
              */
-            description?: string | null;
+            robots?: string | null;
             /**
-             * Color
-             * @description HEX color code
-             * @example #3776AB
+             * Meta Title
+             * @description <title> and <meta name='title'>. Keep ≤60 chars for Google display.
              */
-            color?: string | null;
-        };
-        /** ProductPriceRequest */
-        ProductPriceRequest: {
+            meta_title?: string | null;
             /**
-             * Company Id
-             * @description Company ID for gateway configuration
-             * @example 1
+             * Meta Description
+             * @description <meta name='description'>. Keep ≤160 chars for Google display.
              */
-            company_id: number;
-            /** @example subscription */
-            price_type: components["schemas"]["ProductPriceType"];
+            meta_description?: string | null;
             /**
-             * Amount
-             * @example 52
+             * Meta Keywords
+             * @description Comma-separated keywords. Low weight for Google, used for internal search.
              */
-            amount: number;
-            /** @example USD */
-            currency: components["schemas"]["ProductCurrency"];
+            meta_keywords?: string | null;
             /**
-             * Gateway
-             * @example stripe
+             * Og Image Width
+             * @description og:image:width in pixels. Recommended: 1200.
              */
-            gateway?: string | null;
+            og_image_width?: number | null;
             /**
-             * Is Live
-             * @default false
-             * @example false
+             * Og Image Height
+             * @description og:image:height in pixels. Recommended: 630.
              */
-            is_live: boolean;
-            /** @example month */
-            interval?: components["schemas"]["ProductInterval"] | null;
+            og_image_height?: number | null;
             /**
-             * Interval Count
-             * @example 1
+             * Og Image Alt
+             * @description og:image:alt — alt text for the OG image.
              */
-            interval_count?: number | null;
+            og_image_alt?: string | null;
             /**
-             * Trial Period Days
-             * @default 0
-             * @example 0
+             * Og Url
+             * @description og:url — canonical URL used by social platforms.
              */
-            trial_period_days: number | null;
+            og_url?: string | null;
             /**
-             * Initial Amount
-             * @example 0
+             * Og Site Name
+             * @description og:site_name — your platform name shown in the link preview card.
              */
-            initial_amount?: number | null;
+            og_site_name?: string | null;
             /**
-             * Compare Price
-             * @example 0
+             * Og Locale
+             * @description og:locale — language in underscore format: en_US, es_ES, fr_FR.
              */
-            compare_price?: number | null;
+            og_locale?: string | null;
             /**
-             * Object Id
-             * @example 0
+             * Twitter Image Alt
+             * @description twitter:image:alt — alt text for the Twitter card image.
              */
-            object_id?: number | null;
+            twitter_image_alt?: string | null;
             /**
-             * Module Id
-             * @example 0
+             * Twitter Site
+             * @description twitter:site — your Twitter/X account handle. Must start with '@'.
              */
-            module_id?: number | null;
+            twitter_site?: string | null;
             /**
-             * Requires Payment Method Upfront
-             * @description False=Gateway-managed trial (send trial to gateway), True=App-managed trial (don't send trial to gateway)
-             * @default false
-             * @example false
+             * Twitter Creator
+             * @description twitter:creator — author's Twitter/X handle. Must start with '@'.
              */
-            requires_payment_method_upfront: boolean;
-        };
-        /**
-         * @example {
-         *       "status": "success",
-         *       "message": "Operation successful",
-         *       "message_code": "api_suc_20001",
-         *       "data": {},
-         *       "metadata": {
-         *         "timestamp": "2026-03-26T10:00:00.000Z",
-         *         "requestId": "07e22004-cb60-4dfc-bc9c-b6f99664dca1",
-         *         "traceId": "a9f1204c-bb82-41de-b234-7c3a9e120000",
-         *         "version": "v1",
-         *         "executionTime": 42,
-         *         "language": "en-US"
-         *       }
-         *     }
-         */
-        StandardResponse: {
-            /** @example success */
-            status?: string;
-            data?: Record<string, never> | null;
-            /** @example Operation successful */
-            message?: string | null;
-            /** @example api_suc_20001 */
-            message_code?: string | null;
-            metadata?: Record<string, never> | null;
-            error?: components["schemas"]["ErrorResponse"];
-        };
-        /**
-         * ProductStatus
-         * @description Product status values (Phase 1 - VARCHAR)
-         * @enum {string}
-         */
-        ProductStatus: "draft" | "published" | "archived" | "review_required" | "deleted";
-        /**
-         * VariantImageInput
-         * @description Image data for variant creation.
-         */
-        VariantImageInput: {
+            twitter_creator?: string | null;
             /**
-             * Image Url
-             * @description Image URL
+             * Is Indexable
+             * @description System-level indexing override. False → page is treated as noindex regardless of the robots field. True → robots field is authoritative.
+             * @default true
              */
-            image_url: string;
+            is_indexable: boolean;
             /**
-             * Image Type
-             * @description primary, gallery, thumbnail
-             * @default primary
+             * Structured Data
+             * @description Schema.org JSON-LD object for Google rich results.
              */
-            image_type: string;
+            structured_data?: {
+                [key: string]: unknown;
+            } | null;
             /**
-             * Display Order
-             * @description Display order
-             * @default 100
+             * Alternate Languages
+             * @description hreflang list: [{"lang":"en-US","url":"https://..."},{"lang":"x-default","url":"..."}]. Always include x-default.
              */
-            display_order: number;
+            alternate_languages?: {
+                [key: string]: string;
+            }[] | null;
         };
     };
     responses: never;
@@ -7865,7 +7865,7 @@ export interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateTagRequest"];
+                "application/json": components["schemas"]["app__routes__products__product_phase2_routes__CreateTagRequest"];
             };
         };
         responses: {