<?php
/**
 * Generated stub declarations for EasyCommerce.
 * @see https://wordpress.org/plugins/easycommerce/
 * @see https://github.com/mralaminahamed/phpstan-easycommerce-stubs
 */

namespace EasyCommerce\Traits {
    /**
     * Trait Rest
     *
     * This trait provides methods to register REST API routes and handle JSON responses in the WordPress plugin.
     *
     * @package EasyCommerce
     */
    trait Rest
    {
        // Namespace for the REST API routes specific to this plugin.
        public $namespace = 'easycommerce/v1';
        /**
         * Registers a new REST API route.
         *
         * @param string $path The route path.
         * @param array  $args The route arguments.
         */
        public function register_route($path, $args)
        {
        }
        /**
         * Sends a JSON response success message.
         *
         * @param mixed $data The data to encode as JSON and send.
         * @param int   $status_code HTTP status code to send with the response. Default is 200.
         */
        public function response_success($data = null, $status_code = 200)
        {
        }
        /**
         * Sends a JSON response error message.
         *
         * @param mixed $data The data to encode as JSON and send.
         * @param int   $status_code HTTP status code to send with the response. Default is 400.
         */
        public function response_error($data = null, $status_code = 400)
        {
        }
        /**
         * Sends a JSON response with arbitrary data.
         *
         * @param mixed $data The data to encode as JSON and send.
         * @param int   $status_code HTTP status code to send with the response. Default is 200.
         */
        public function response($data, $status_code = 200)
        {
        }
    }
}
namespace EasyCommerce\Abstracts {
    /**
     * Abstract API class
     *
     * Provides common functionality for API classes.
     */
    abstract class API
    {
        use \EasyCommerce\Traits\Rest;
    }
}
namespace EasyCommerce\API {
    class AI extends \EasyCommerce\Abstracts\API
    {
        public $ai_service;
        public function __construct()
        {
        }
        /**
         * Stop the request with a 403 if the given Generative AI feature is disabled.
         *
         * response_error() sends the JSON response and exits, so when the feature is
         * off this never returns and the calling endpoint short-circuits.
         *
         * @param string $feature Feature key (see easycommerce_is_ai_feature_enabled()).
         * @param string $label   Human-readable feature name for the error message.
         * @return void
         */
        private function require_feature($feature, $label)
        {
        }
        /**
         * Write product description or summary
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function write_copy($request)
        {
        }
        /**
         * Generate product attributes
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function generate_attributes($request)
        {
        }
        /**
         * Design page template using blocks
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function design_template($request)
        {
        }
        /**
         * Draw an image
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function draw_image($request)
        {
        }
        /**
         * Edit an image
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function edit_image($request)
        {
        }
    }
    class Abandoned_Cart extends \EasyCommerce\Abstracts\API
    {
        /**
         * Get a list of abandoned carts.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function get_all($request)
        {
        }
        /**
         * Remove abandoned cart.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function remove($request)
        {
        }
        /**
         * Get the email subject and body (with placeholders resolved) for an abandoned cart.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function get_email_content($request)
        {
        }
        /**
         * Remind abandoned cart.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function remind($request)
        {
        }
        /**
         * Bulk delete abandoned carts.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function bulk_delete($request)
        {
        }
        /**
         * Bulk send reminders for abandoned carts.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function bulk_reminder($request)
        {
        }
        /**
         * Clean/Empty abandoned cart.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function clean($request)
        {
        }
        /**
         * Clean invalid abandoned cart. Means it deletes some of the entries from table which are considered as invalids.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function clean_invalid($request)
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Cache
    {
        private $key_prefix = 'easycommerce_';
        /**
         * Checks if external object cache is in use and returns true or false.
         *
         * @return bool Returns true if external object cache is used, otherwise false.
         */
        private function is_using_object_cache()
        {
        }
        /**
         * Sets a cache value using either object cache or transients based on availability.
         *
         * @param string $key The cache key to store the value under.
         * @param mixed  $value The value to store in the cache.
         * @param int    $expiration Optional. The time until expiration, in seconds. Default 3600 (1 hour).
         * @param bool   $allow_empty Should we allow caching empty values
         */
        public function set_cache($key, $value, $expiration = 3600, $allow_empty = false)
        {
        }
        /**
         * Retrieves a cache value using either object cache or transients based on availability.
         *
         * @param string $key The cache key to retrieve.
         * @return mixed The cached value, or false if the value is not found or is expired.
         */
        public function get_cache($key)
        {
        }
        /**
         * Deletes a cache value using either object cache or transients based on availability.
         *
         * @param string $key The cache key whose value should be deleted.
         */
        public function delete_cache($key)
        {
        }
    }
}
namespace EasyCommerce\API {
    class Addon extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cache;
        private $menu_slug = ['easycommerce-subscriptions' => 'easycommerce-store#/subscriptions', 'easycommerce-wpbakery' => '', 'easycommerce-license' => 'easycommerce-store#/licenses', 'easycommerce-paddle' => 'easycommerce-settings&menu=payment&submenu=paddle', 'easycommerce-points-and-rewards' => 'easycommerce-settings&menu=points-rewards', 'easycommerce-product-recommendations' => 'easycommerce-settings&menu=product-recommendations', 'easycommerce-fluentcrm' => 'easycommerce-settings&menu=fluentcrm', 'easycommerce-bank-transfer' => 'easycommerce-settings&menu=payment&submenu=bank-transfer', 'easycommerce-sliding-cart' => '', 'easycommerce-rocket' => 'easycommerce-settings&menu=payment&submenu=rocket', 'easycommerce-csv-importer' => 'easycommerce-store#/easycommerce-importer', 'easycommerce-wishlist' => '', 'easycommerce-checkout-editor' => 'easycommerce-checkout-editor', 'easycommerce-nagad' => 'easycommerce-settings&menu=payment&submenu=nagad', 'easycommerce-bkash' => 'easycommerce-settings&menu=payment&submenu=bkash', 'easycommerce-google-sheets-sync' => 'easycommerce-settings&menu=google_sheets', 'easycommerce-klaviyo' => 'easycommerce-settings&menu=klaviyo', 'easycommerce-zendesk' => 'easycommerce-settings&menu=zendesk', 'easycommerce-pdf-invoice' => 'easycommerce-settings&menu=pdf-invoice', 'easycommerce-delivery-date-picker' => '', 'easycommerce-mailchimp' => 'easycommerce-settings&menu=mailchimp', 'easycommerce-hubspot' => 'easycommerce-settings&menu=hubspot', 'easycommerce-migration' => 'easycommerce-settings&menu=migration', 'easycommerce-slack' => 'easycommerce-settings&menu=slack'];
        public function list($request)
        {
        }
        public function manage($request)
        {
        }
        /**
         * Resolves a plugin slug to its installed file path (e.g. "fluent-crm" → "fluent-crm/fluentcrm.php").
         *
         * Uses WP_Plugin_Dependencies (WP 6.5+) when available, then falls back to
         * scanning get_plugins() for a file inside the slug's directory.
         *
         * @param string $slug Plugin directory slug.
         * @return string|false Relative plugin file path, or false if not installed.
         */
        private function find_plugin_file(string $slug)
        {
        }
        /**
         * Clears plugin caches and resets WP_Plugin_Dependencies static state.
         *
         * WP_Plugin_Dependencies (WP 6.5+) populates its internal maps once per request
         * via static properties. After installing a new plugin mid-request those statics
         * are stale, so activate_plugin() wrongly reports unmet dependencies.
         *
         * Resetting the statics via reflection forces the next initialize() call to
         * re-read the live plugin list, keeping the dependency check accurate.
         */
        private function refresh_plugin_dependencies(): void
        {
        }
        /**
         * Installs a plugin from a zip URL using the WordPress upgrader.
         *
         * Supports optional auth headers (e.g. for private EasyCommerce store downloads)
         * by temporarily filtering wp_remote_get arguments.
         *
         * Returns the installed plugin's relative file path (e.g. "fluent-crm/fluentcrm.php")
         * via Plugin_Upgrader::plugin_info() — the WP-native way to get the actual installed path
         * regardless of what directory name the zip was extracted to.
         *
         * @param string $zip_url  Direct URL to the plugin zip file.
         * @param array  $headers  Optional HTTP headers to attach to the download request.
         * @param string $slug     Optional canonical plugin slug. When set, the extracted
         *                         source directory is renamed to this slug before install so
         *                         the addon lands in {slug}/ instead of a temp/obfuscated dir.
         * @return string|\WP_Error  Installed plugin file path on success, WP_Error on failure.
         */
        private function install_plugin(string $zip_url, array $headers = [], string $slug = '')
        {
        }
        /**
         * @todo implement API verification
         */
        public function license($request)
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Auth
    {
        /**
         * Check if sandbox/test mode is enabled.
         *
         * @return bool True if sandbox mode is enabled, false otherwise.
         */
        protected function is_sandbox_mode()
        {
        }
        /**
         * Verifies if it's a human user, not bots
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True for regular cases, false otherwise.
         *
         * @todo Introduce real check
         */
        public function is_user($request)
        {
        }
        /**
         * Check if the request is from a logged-in user or carries a valid wp_rest nonce.
         *
         * Used for storefront endpoints that incur real costs (e.g. AI credits) but must
         * remain accessible to guest users who loaded the storefront and received a nonce
         * via EASYCOMMERCE.nonce. Raw unauthenticated API calls without a nonce are rejected.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool
         */
        public function is_nonce_verified($request)
        {
        }
        /**
         * Check if the current user is a guest (not logged in).
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is disabled and the user is not logged in, false otherwise.
         */
        public function is_guest($request)
        {
        }
        /**
         * Check if the current user is a logged in user.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is enabled or the user is logged in, false otherwise.
         */
        public function is_member($request)
        {
        }
        /**
         * Check if the current user is a customer.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is enabled or the user is logged in, false otherwise.
         */
        public function is_customer($request)
        {
        }
        /**
         * Check if the current user is an editor.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is enabled or the user has editor capabilities, false otherwise.
         */
        public function is_editor($request)
        {
        }
        /**
         * Check if the current user is an administrator.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is enabled or the user has administrator capabilities, false otherwise.
         */
        public function is_admin($request)
        {
        }
        /**
         * Check if the current user is an administrator or an manager.
         *
         * @param WP_REST_Request $request The request object.
         * @return bool True if sandbox mode is enabled or the user has administrator capabilities or user has manager capabilities, false otherwise.
         */
        public function is_manager($request)
        {
        }
    }
}
namespace EasyCommerce\Abstracts {
    abstract class Agent
    {
        use \EasyCommerce\Traits\Rest;
        use \EasyCommerce\Traits\Auth;
        protected $ai;
        protected $db;
        /**
         * Usage-log type for this agent. Subclasses override (copilot, shopping_agent).
         *
         * @var string
         */
        protected $log_type = 'agent';
        public function __construct()
        {
        }
        public function handle($request)
        {
        }
        protected function build_response(array $result, string $session_id): array
        {
        }
        public function run_message(string $session_id, string $message): array
        {
        }
        protected function run_agent(array &$history): string
        {
        }
        /**
         * The most recent user message in a history array.
         *
         * @param array $history
         * @return string
         */
        protected function last_user_message(array $history): string
        {
        }
        protected function load_session(string $session_id): array
        {
        }
        protected function save_session(string $session_id, array $history): void
        {
        }
        abstract protected function dispatch_tool(string $name, array $args): array;
        abstract protected function get_tools(): array;
        abstract protected function get_system_prompt(): string;
    }
}
namespace EasyCommerce\API\Agent {
    class Assistant extends \EasyCommerce\Abstracts\Agent
    {
        protected $log_type = 'shopping_agent';
        private $order_url = null;
        // -------------------------------------------------------------------------
        // Overrides
        // -------------------------------------------------------------------------
        public function run_message(string $session_id, string $message): array
        {
        }
        protected function build_response(array $result, string $session_id): array
        {
        }
        // -------------------------------------------------------------------------
        // Tool dispatch
        // -------------------------------------------------------------------------
        protected function dispatch_tool(string $name, array $args): array
        {
        }
        // -------------------------------------------------------------------------
        // Tool implementations
        // -------------------------------------------------------------------------
        private function tool_search_products(array $args): array
        {
        }
        private function tool_get_product_details(array $args): array
        {
        }
        private function tool_check_stock(array $args): array
        {
        }
        private function tool_calculate_shipping(array $args): array
        {
        }
        private function tool_apply_coupon(array $args): array
        {
        }
        private function tool_create_order(array $args): array
        {
        }
        private function tool_generate_payment_link(array $args): array
        {
        }
        private function tool_get_order_status(array $args): array
        {
        }
        private function tool_update_order_contact(array $args): array
        {
        }
        private function tool_update_order_address(array $args): array
        {
        }
        private function tool_add_order_note(array $args): array
        {
        }
        private function tool_get_order_breakdown(array $args): array
        {
        }
        private function tool_get_order_items(array $args): array
        {
        }
        private function tool_estimate_order_total(array $args): array
        {
        }
        private function tool_apply_coupon_to_order(array $args): array
        {
        }
        private function tool_cancel_order(array $args): array
        {
        }
        private function tool_resend_order_email(array $args): array
        {
        }
        private function tool_track_order(array $args): array
        {
        }
        private function tool_get_refund_info(array $args): array
        {
        }
        private function tool_get_customer_profile(array $args): array
        {
        }
        private function tool_list_products_by_category(array $args): array
        {
        }
        private function tool_get_product_reviews(array $args): array
        {
        }
        private function tool_validate_coupon(array $args): array
        {
        }
        // -------------------------------------------------------------------------
        // Tool definitions & system prompt
        // -------------------------------------------------------------------------
        protected function get_tools(): array
        {
        }
        protected function get_system_prompt(): string
        {
        }
    }
    class Copilot extends \EasyCommerce\Abstracts\Agent
    {
        protected $log_type = 'copilot';
        private $reports;
        public function __construct()
        {
        }
        // -------------------------------------------------------------------------
        // Tool dispatch
        // -------------------------------------------------------------------------
        protected function dispatch_tool(string $name, array $args): array
        {
        }
        // -------------------------------------------------------------------------
        // Tool implementations
        // -------------------------------------------------------------------------
        private function tool_create_product(array $args): array
        {
        }
        private function tool_update_product(array $args): array
        {
        }
        private function tool_get_store_overview(array $args): array
        {
        }
        private function tool_get_top_products(array $args): array
        {
        }
        private function tool_list_orders(array $args): array
        {
        }
        private function tool_search_order(array $args): array
        {
        }
        private function tool_list_products(array $args): array
        {
        }
        private function tool_search_customer(array $args): array
        {
        }
        private function tool_update_order_status(array $args): array
        {
        }
        private function tool_delete_product(array $args): array
        {
        }
        private function tool_update_product_stock(array $args): array
        {
        }
        private function tool_create_coupon(array $args): array
        {
        }
        private function tool_issue_refund(array $args): array
        {
        }
        private function tool_run_analytics_query(array $args): array
        {
        }
        // -------------------------------------------------------------------------
        // Tool definitions & system prompt
        // -------------------------------------------------------------------------
        protected function get_tools(): array
        {
        }
        protected function get_system_prompt(): string
        {
        }
    }
}
namespace EasyCommerce\API {
    class Attribute extends \EasyCommerce\Abstracts\API
    {
        /**
         * List all attributes with optional search and details.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function list($request)
        {
        }
        /**
         * Add new attributes and their values.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function add_item($request)
        {
        }
        /**
         * Get values for a specific attribute.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function get_values($request)
        {
        }
        /**
         * Get a specific attribute.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function get_attribute($request)
        {
        }
        /**
         * 	Delete an attribute.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function delete_attribute($request)
        {
        }
        public function bulk_delete_attributes($request)
        {
        }
        /**
         * Update an attribute.
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function update_attribute($request)
        {
        }
    }
    class Cart extends \EasyCommerce\Abstracts\API
    {
        /**
         * List the cart contents and hash.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function list($request)
        {
        }
        /**
         * Add items to the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function add_items($request)
        {
        }
        /**
         * Update a product quantity in the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function update_item($request)
        {
        }
        /**
         * Remove a product from the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function remove_item($request)
        {
        }
        /**
         * Lock the cart for payment processing.
         * Once locked, add/update/remove operations are rejected until the payment completes or fails.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function lock($request)
        {
        }
        /**
         * Get the shipping options for the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_shipping_options($request)
        {
        }
        /**
         * Set the shipping method for the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function set_shipping_method($request)
        {
        }
        public function set_payment_method($request)
        {
        }
        /**
         * Apply a coupon to the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function apply_coupon($request)
        {
        }
        /**
         * Remove a coupon from the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function remove_coupon($request)
        {
        }
        /**
         * Clear the cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function clear($request)
        {
        }
        /**
         * Remind abandoned cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function remind_abandoned($request)
        {
        }
        private function sanitize_address($address)
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Queue
    {
        /**
         * Schedules a single event to run immediately (if not already scheduled).
         *
         * @param string $hook Action hook to execute.
         * @param array  $args Optional. Arguments to pass to the callback function. Default empty array.
         */
        public function schedule($hook, $args = [])
        {
        }
        /**
         * Schedules a single event to run at a specific timestamp.
         *
         * @param int    $run_at When to run the event (Unix timestamp).
         * @param string $hook      Action hook to execute.
         * @param array  $args      Optional. Arguments to pass to the callback function. Default empty array.
         */
        public function schedule_at($run_at, $hook, $args = [])
        {
        }
        /**
         * Schedules a recurring event.
         *
         * @param int    $start_at	 When to run the first event (Unix timestamp).
         * @param string $recurrence How often the event should recur ('hourly', 'daily', etc).
         * @param string $hook       Action hook to execute.
         * @param array  $args       Optional. Arguments to pass to the callback function. Default empty array.
         */
        public function schedule_recurring($start_at, $recurrence, $hook, $args = [])
        {
        }
        /**
         * Unschedules a specific event.
         *
         * @param string $hook Action hook to remove.
         * @param array  $args Optional. Arguments to match when removing. Default empty array.
         */
        public function unschedule($hook, $args = [])
        {
        }
        /**
         * Clears all scheduled hooks with the given hook name and arguments.
         *
         * @param string $hook Hook name to clear.
         * @param array  $args Optional. Arguments to match. Default empty array.
         */
        public function clear_schedules($hook, $args = [])
        {
        }
        /**
         * Checks if an event is already scheduled.
         *
         * @param string $hook Hook name to check.
         * @param array  $args Optional. Arguments to match. Default empty array.
         * @return bool
         */
        public function has_schedule($hook, $args = [])
        {
        }
    }
}
namespace EasyCommerce\API {
    class Connectivity extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cache;
        use \EasyCommerce\Traits\Queue;
        public function save($request)
        {
        }
        public function registration($request)
        {
        }
        /**
         * Handle reset password request
         */
        public function reset_password_request($request)
        {
        }
        /**
         * Handle reset password confirmation
         */
        public function reset_password_confirm($request)
        {
        }
        /**
         * Authenticate a user for the React auth screens.
         *
         * Mirrors the native wp_login_form behaviour (which posts to wp-login.php)
         * but returns JSON so the storefront can log in without a full page reload
         * being driven by the browser's form submit. On success wp_signon sets the
         * auth cookies, and the client redirects to the dashboard.
         */
        public function login($request)
        {
        }
        /**
         * Best-effort client IP for login throttling.
         *
         * Uses REMOTE_ADDR only (proxy headers are spoofable and must not be trusted
         * for a security control); sites behind a trusted proxy can override via the
         * easycommerce_client_ip filter.
         *
         * @return string
         */
        private function client_ip()
        {
        }
        /**
         * Transient key holding the failed-login count for the current client.
         *
         * @return string
         */
        private function login_throttle_key()
        {
        }
        public function get_setup_wizard($request)
        {
        }
        /**
         * Apply a ready-made store design from the setup wizard (#3174).
         *
         * By default this only *creates* the design's pages and leaves the site's
         * front page untouched — safest for existing/live sites. The new home page
         * is set as the static front page ONLY when the store owner explicitly opts
         * in (`set_homepage`), so we never silently clobber a live homepage.
         *
         * @param \WP_REST_Request $request Request object.
         * @return \WP_REST_Response
         */
        public function apply_design($request)
        {
        }
        /**
         * Set a page as the static front page (used to confirm an overwrite from the
         * wizard after the user opts in). #3174.
         *
         * @param \WP_REST_Request $request Request object.
         * @return \WP_REST_Response
         */
        public function set_front_page($request)
        {
        }
        public function check($request)
        {
        }
        public function disconnect($request)
        {
        }
        public function generate_token($request)
        {
        }
        public function verify_token($request)
        {
        }
        public function get_addons($request)
        {
        }
        public function get_docs($request)
        {
        }
        public function get_doc($request)
        {
        }
        public function feedback($request)
        {
        }
        /**
         * The site diagnostics attached to every telemetry event.
         *
         * Every event carries the same payload — wizard completion, deactivation,
         * feedback and integration request alike — so a CRM contact reads the same
         * whichever way the store owner arrived.
         *
         * Rides along only with consent: what the store owner typed is their own
         * submission and always goes, the passive site snapshot (active plugin list,
         * theme, install age, engagement counts) does not.
         *
         * @since 1.45
         * @return array Empty when sharing is declined.
         */
        private function diagnostics()
        {
        }
        public function requests($request)
        {
        }
    }
    class Coupon extends \EasyCommerce\Abstracts\API
    {
        /**
         * Retrieve all coupons or a specific coupon by ID.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_all($request)
        {
        }
        /**
         * Create a new coupon.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Retrieve details of a specific coupon by ID.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_single($request)
        {
        }
        /**
         * Update an existing coupon.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function update($request)
        {
        }
        /**
         * Delete a coupon.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
        /**
         * Bulk delete coupons.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function bulk_delete($request)
        {
        }
        /**
         * Bulk update the status of coupons.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function bulk_status_update($request)
        {
        }
    }
    class Customer extends \EasyCommerce\Abstracts\API
    {
        /**
         * Create a new customer.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Get a specific customer.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * List customers with optional filters such as `s` for search, `page`, and `per_page`.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function list($request)
        {
        }
        /**
         * Delete a customer.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
        /**
         * List customer orders with optional filters such as `s` for search, `page`, and `per_page`.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function list_orders($request)
        {
        }
    }
    /**
     * Dashboard API
     */
    class Dashboard extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cache;
        const CACHE_DURATION_HOUR = 3600;
        /**
         * The dashboard stats
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_stats($request)
        {
        }
        /**
         * Orders by statuses
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_order_statuses($request)
        {
        }
        public function get_setup_status($request)
        {
        }
        /**
         * Sales
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_sales($request)
        {
        }
        /**
         * Recent orders
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_recent_orders($request)
        {
        }
        /**
         * Get single abandoned cart details including items.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_abandoned_cart_details($request)
        {
        }
        /**
         * Resolve a thumbnail value to a full image URL.
         *
         * @param int|string|array $thumbnail  Attachment ID, full URL, relative path, or thumbnail array with id/url keys.
         * @param int|null         $product_id Optional product ID to fall back to if thumbnail is empty.
         * @return string Full image URL, or empty string if not resolvable.
         */
        private function get_image_url($thumbnail, $product_id = null)
        {
        }
        /**
         * Send a custom reminder email for an abandoned cart.
         *
         * @param WP_REST_Request $request The request object.
         */
        public function send_abandoned_cart_reminder($request)
        {
        }
        /**
         * Low stock
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_low_stock($request)
        {
        }
        /*
         * Top seller
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_top_sellers($request)
        {
        }
        /**
         * Recent activities
         *
         * @param WP_REST_Request $request The request object.
         */
        public function get_activities($request)
        {
        }
        /**
         * Returns a date key based on the given timestamp and range.
         *
         * The format of the date key depends on the range:
         * - If the range is a custom range (i.e. it contains a comma), then the date key is the day of the month (e.g. 1st, 2nd, 3rd, etc.).
         * - If the range is 'this-year' or 'last-year', then the date key is the full month name (e.g. January, February, etc.).
         * - If the range is 'this-week', 'last-week', 'last-7', 'today', or 'yesterday', then the date key is the abbreviated day of the week (e.g. Mon, Tue, Wed, etc.).
         *
         * @param int    $timestamp The timestamp to get the date key for.
         * @param string $range The range to get the date key for.
         * @return string The date key.
         */
        public function get_date_key($timestamp, $range)
        {
        }
        /**
         * Total orders
         *
         * @param string $range The date range to query.
         * @param string $status The order status to filter by.
         * @param int    $product_id The product ID.
         * @return array
         */
        public function total_orders($range = 'this-month', $status = '', $product_id = null)
        {
        }
        /**
         * Total sales
         *
         * @param string $range The date range to query.
         * @param string $status The order status to filter by.
         * @param int    $product_id The product ID.
         * @return float
         */
        public function total_sales($range = 'this-month', $status = '', $product_id = null)
        {
        }
        /**
         * Total products sold
         *
         * @param string $range The date range to query.
         * @return int
         */
        public function total_products_sold($range = 'this-month')
        {
        }
        /**
         * Total orders by status
         *
         * @param string $range The date range to query.
         * @param string $status The order status to filter by.
         * @return int
         */
        public function total_orders_by_status($range, $status)
        {
        }
        /**
         * Get customers
         *
         * @param string $range The date range to query.
         * @param string $status The order status to filter by.
         * @return array
         */
        public function get_customers($range = 'this-month')
        {
        }
        public function get_abandoned_carts($range = 'this-month', $from = null, $to = null)
        {
        }
        private function get_total_products()
        {
        }
        /**
         * Delete all cache entries for a given key prefix across every known range.
         *
         * Pass $with_ranges = false for range-independent keys (e.g. 'dashboard_low_stock').
         *
         * @param string $prefix      Cache key prefix, e.g. 'dashboard_stats'.
         * @param bool   $with_ranges Whether to iterate over all date ranges.
         */
        private static function purge_cache(string $prefix, bool $with_ranges = true)
        {
        }
        /**
         * Delete order-related dashboard caches.
         *
         * Call when order, refund, or customer data changes.
         */
        public static function delete_orders_cache()
        {
        }
        /**
         * Delete product-related dashboard caches (stats, low stock, top sellers).
         *
         * Call when product or variation data changes.
         */
        public static function delete_products_cache()
        {
        }
        /**
         * Delete all dashboard caches.
         */
        public static function delete_dashboard_cache()
        {
        }
        /**
         * Get total refunded amount from the Refund model (handles partial refunds correctly)
         *
         * @param string $range The date range to query.
         * @return float
         */
        public function total_refunded_amount($range = 'this-month')
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Hook
    {
        /**
         * Registers an action hook.
         *
         * @param string   $tag The name of the action.
         * @param callable $callback The callback function.
         * @param int      $priority The order of execution. Default is 10.
         * @param int      $accepted_args The number of accepted arguments. Default is 1.
         */
        public function add_action($tag, $callback, $priority = 10, $accepted_args = 1)
        {
        }
        /**
         * Convenience wrapper for add_action.
         */
        public function action($tag, $callback, $priority = 10, $accepted_args = 1)
        {
        }
        /**
         * Registers a filter hook.
         *
         * @param string   $tag The name of the filter.
         * @param callable $callback The callback function.
         * @param int      $priority The order of execution. Default is 10.
         * @param int      $accepted_args The number of accepted arguments. Default is 1.
         */
        public function add_filter($tag, $callback, $priority = 10, $accepted_args = 1)
        {
        }
        /**
         * Convenience wrapper for add_filter.
         */
        public function filter($tag, $callback, $priority = 10, $accepted_args = 1)
        {
        }
        /**
         * Registers a shortcode.
         *
         * @param string   $tag The shortcode tag.
         * @param callable $callback The callback function.
         */
        public function add_shortcode($tag, $callback)
        {
        }
        /**
         * Convenience wrapper for add_shortcode.
         */
        public function shortcode($tag, $callback)
        {
        }
        /**
         * Registers an AJAX action for logged-in users.
         *
         * @param string   $action The AJAX action.
         * @param callable $callback The callback function.
         */
        public function ajax_priv($action, $callback)
        {
        }
        /**
         * Registers an AJAX action for non-logged-in users.
         *
         * @param string   $action The AJAX action.
         * @param callable $callback The callback function.
         */
        public function ajax_nopriv($action, $callback)
        {
        }
        /**
         * Registers both logged-in and non-logged-in AJAX actions.
         */
        public function ajax($action, $callback)
        {
        }
    }
    trait Cleaner
    {
        /**
         * Generic sanitization method that dynamically selects the appropriate sanitization function based on the type or data content.
         *
         * @param mixed  $input The input data to sanitize, can be a string or an array.
         * @param string $type  The type of sanitization to perform, or 'array' to recursively sanitize an array of data.
         * @return mixed The sanitized data, either a string or an array of sanitized strings.
         */
        public function sanitize($input, $type = 'text')
        {
        }
        /**
         * Generic escaping method for securing output against XSS and other vulnerabilities.
         * If an array is provided as output, the specified escaping context will be applied to each element.
         *
         * @param mixed  $output The output data to escape, can be a string or an array of strings.
         * @param string $context The context for escaping. Default is 'html'.
         *                        Supported contexts: 'html', 'url', 'js', 'sql', 'attr'.
         * @return mixed The escaped data, either a string or an array of escaped strings.
         */
        public function escape($output, $context = 'html')
        {
        }
        /**
         * Recursively unserialize a value if it is serialized, handling nested serialization.
         *
         * @param mixed $value The value to unserialize.
         * @return mixed The unserialized value.
         */
        public function unserialize($value)
        {
        }
    }
}
namespace EasyCommerce\API {
    class Email_Placeholder extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Get general email placeholders (available for all emails)
         */
        public function get_general_placeholders(): array
        {
        }
        /**
         * Get order-specific email placeholders
         */
        public function get_order_placeholders(): array
        {
        }
        /**
         * Get cart-specific email placeholders
         */
        public function get_cart_placeholders(): array
        {
        }
        /**
         * Get placeholder description based on key
         *
         * @param string $placeholder The placeholder key.
         *
         * @return string The placeholder description.
         */
        private function get_placeholder_description(string $placeholder): string
        {
        }
        /**
         * REST API handler to get placeholders for Select2
         *
         * @param WP_REST_Request $request The REST request object.
         *
         * @return void Uses Rest trait response methods.
         */
        public function get_placeholders(\EasyCommerce\API\WP_REST_Request $request)
        {
        }
    }
    class Geo extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cache;
        public function list_countries($request)
        {
        }
        public function list_states($request)
        {
        }
        public function list_cities($request)
        {
        }
        public function list_currencies($request)
        {
        }
    }
    class Importer extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cleaner;
        use \EasyCommerce\Traits\Queue;
        public function upload_csv($request)
        {
        }
        public function map_columns($request)
        {
        }
        public function import_products($request)
        {
        }
        public function import_sample_products($request)
        {
        }
        public function create_product($row, $is_demo = false)
        {
        }
        /**
         * Meta key that flags demo products, their categories and their media.
         */
        const DEMO_META_KEY = '_easycommerce_demo';
        /**
         * Flag an imported product, its media and its categories as demo content.
         *
         * Keyed removal (see remove_demo()) relies on every demo artefact carrying
         * this meta, so nothing bundled by the demo importer lingers after cleanup.
         *
         * @param int   $id         Product ID.
         * @param array $args       Product args passed to Product::update().
         * @param array $variations Built variation data (for variation thumbnails + downloads).
         */
        private function tag_demo_content($id, $args, $variations)
        {
        }
        /**
         * REST callback: how many demo products currently exist.
         *
         * Drives the Products-page UI (import vs. remove demo content).
         *
         * @param \WP_REST_Request $request Request object.
         * @return \WP_REST_Response
         */
        public function demo_status($request)
        {
        }
        /**
         * REST callback: remove all demo content.
         *
         * @param \WP_REST_Request $request Request object.
         * @return \WP_REST_Response
         */
        public function delete_demo($request)
        {
        }
        /**
         * Remove all demo content created by the demo importer.
         *
         * Deletes demo products (and their variations via Product::delete-equivalent
         * cascade), their sideloaded attachments, and any demo categories left empty —
         * all keyed off DEMO_META_KEY. Idempotent: safe to run repeatedly.
         *
         * @return array Counts of removed products, attachments and categories.
         */
        public function remove_demo()
        {
        }
        /**
         * Extract unique attribute values from variation data when product-level values are empty
         * 
         * @param string $attribute_names Product-level attribute names (e.g., "Color, Size")
         * @param string $variation_attr_names Variation attribute names (e.g., "Color,Color,Size,Size")
         * @param string $variation_attr_values Variation attribute values (e.g., "Blue,Black,M,L")
         * @return array Structured attributes array with IDs
         */
        private function extract_attributes_from_variations($attribute_names, $variation_attr_names, $variation_attr_values)
        {
        }
        /**
         * Process product attributes and create them in database if they don't exist
         * 
         * @param string $attribute_names Comma-separated attribute names
         * @param string $attribute_values Pipe-separated groups of comma-separated values
         * @return array Structured attributes array with IDs
         */
        private function process_product_attributes($attribute_names, $attribute_values)
        {
        }
        /**
         * Generate all possible variations from product attributes
         * 
         * @param array $attributes Product attributes array
         * @return array Generated variations
         */
        private function generate_variations_from_attributes($variation_data, $attributes)
        {
        }
        private function generate_attribute_combinations($attributes)
        {
        }
        private function get_img_ids($urls, $keep_alignment = false)
        {
        }
        /**
         * Validate that a remote URL is safe to fetch (SSRF guard).
         *
         * Replaces WP's wp_http_validate_url() guard, which is IPv4-only on WP 7.0
         * (gethostbyname()) and rejects IPv6-only CDN hosts. This resolves both A and
         * AAAA records and rejects any URL that points at a private, reserved, loopback
         * or link-local address, while still allowing public IPv6 hosts.
         *
         * @param string $url Remote URL.
         * @return bool True when the URL is safe to request.
         */
        private function is_safe_remote_url($url)
        {
        }
        /**
         * Download a remote image and attach it to the media library.
         *
         * Uses wp_remote_get() rather than media_sideload_image()/download_url() because
         * WP's wp_http_validate_url() guard is IPv4-only on WP 7.0 and rejects IPv6-only
         * CDN hosts. SSRF protection is provided by is_safe_remote_url() instead, which
         * resolves both A and AAAA records and blocks private/reserved targets.
         *
         * @param string $url Remote image URL.
         * @return int|\WP_Error Attachment ID on success, WP_Error on failure.
         */
        private function sideload_remote_image($url)
        {
        }
        /**
         * Sideload a file bundled with the plugin's demo content into the media library.
         *
         * Used for the demo importer, which references bundled assets by bare filename
         * rather than a remote URL. No HTTP request is made, so there is no SSRF surface;
         * the filename is constrained to the requested demo sub-directory (basename only,
         * no path traversal).
         *
         * @param string $filename Bare filename (e.g. green-shoe.jpg).
         * @param string $subdir   Demo sub-directory under samples/dummy-data/ ('images' or 'downloads').
         * @return int|\WP_Error Attachment ID on success, WP_Error on failure.
         */
        private function sideload_local_file($filename, $subdir = 'images')
        {
        }
        /**
         * Build explicit variation from CSV data with proper attribute structure
         */
        private function build_variation($variation_data, $key, $product_attributes)
        {
        }
        public function is_base64_data_url(string $value): bool
        {
        }
        public function sideload_image($request)
        {
        }
    }
    class Log extends \EasyCommerce\Abstracts\API
    {
        /**
         * List logs with optional filters.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function list($request)
        {
        }
        /**
         * Get a single log by ID.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * Add a new log entry.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function add($request)
        {
        }
        /**
         * Delete a log entry.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
    }
    class Notice extends \EasyCommerce\Abstracts\API
    {
        /**
         * List notices via REST API, optionally filtered by type and screen.
         *
         * @param  WP_REST_Request $request Request object containing optional 'type' and 'screen' params.
         * @return WP_REST_Response Response with 'notices' array and 'total' count.
         */
        public function list($request)
        {
        }
        public function dismiss($request)
        {
        }
    }
    class Option extends \EasyCommerce\Abstracts\API
    {
        /**
         * Get the value of a specified option.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * Update the value of a specified option.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function update($request)
        {
        }
        /**
         * Delete the specified option.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
    }
    class Order extends \EasyCommerce\Abstracts\API
    {
        /**
         * Create a new order.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Get a specific order.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * Update an existing order.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function update($request)
        {
        }
        public function bulk_update_statuses($request)
        {
        }
        /**
         * Delete an order.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function delete_order($request)
        {
        }
        /**
         * Refund an order.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function refund($request)
        {
        }
        /**
         * Send an email.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function email($request)
        {
        }
        /**
         * List orders with optional filters such as per_page, page, status, customer_id and customer_email.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function get_all($request)
        {
        }
        public function bulk_delete($request)
        {
        }
        /**
         * Process payment for an existing pending order (agent-created orders).
         */
        public function pay($request)
        {
        }
        /**
         * Validate address fields before creating an order.
         *
         * @param array  $address   Associative array of address data.
         * @param string $type      'billing' or 'shipping'.
         * @return \WP_REST_Response|null Null on success, error response on failure.
         */
        private function sanitize_address($address)
        {
        }
        private function validate_address_fields($address, $type)
        {
        }
    }
    class Product extends \EasyCommerce\Abstracts\API
    {
        public function list($request)
        {
        }
        /**
         * Get a product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * Create a new product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Update a product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function update($request)
        {
        }
        /**
         * Delete a product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
        /**
         * Bulk delete products.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function bulk_delete($request)
        {
        }
        // bulk status update
        public function bulk_update_status($request)
        {
        }
        /**
         * Get review to a product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_reviews($request)
        {
        }
        /**
         * Add review to a product.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function add_review($request)
        {
        }
        /**
         * Get a product's variations
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         *
         * @todo optimize
         */
        public function get_variations($request)
        {
        }
    }
    class Product_Review extends \EasyCommerce\Abstracts\API
    {
        /**
         * Get a list of product reviews.
         *
         * @param WP_REST_Request $request The request object.
         * @return WP_REST_Response
         */
        public function get_all($request)
        {
        }
        /**
         * Delete a product review.
         *
         * @param WP_REST_Request $request The request object.
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
    }
    class Profile extends \EasyCommerce\Abstracts\API
    {
        /**
         * Gets current user summary
         */
        public function get_summary($request)
        {
        }
        /**
         * Gets current user data
         */
        public function get_data($request)
        {
        }
        /**
         * Sets current user data
         */
        public function set_data($request)
        {
        }
        /**
         * List customer orders with optional filters such as `s` for search, `page`, and `per_page`.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_orders($request)
        {
        }
        /**
         * List customer transactions with optional filters such as `s` for search, `page`, and `per_page`.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_transactions($request)
        {
        }
        /**
         * List customer downloads with optional filters such as `s` for search, `page`, and `per_page`.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_downloads($request)
        {
        }
    }
    class Refund extends \EasyCommerce\Abstracts\API
    {
        /**
         * List refunds.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function list($request)
        {
        }
        /**
         * Get a refund.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function get($request)
        {
        }
        /**
         * Create a new refund.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Update a refund.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response|\WP_Error
         */
        public function update($request)
        {
        }
        /**
         * Delete a refund.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function delete($request)
        {
        }
        /**
         * Bulk delete refunds.
         *
         * @param \WP_REST_Request $request
         * @return \WP_REST_Response
         */
        public function bulk_delete($request)
        {
        }
    }
}
namespace EasyCommerce\API\Reports {
    /**
     * Reports Base API
     */
    class Reports extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cache;
        const CACHE_DURATION_HOUR = 3600;
        const CACHE_DURATION_DAY = 86400;
        /**
         * Returns a date key based on the given timestamp and range.
         *
         * @param int    $timestamp The timestamp to get the date key for.
         * @param string $range The range to get the date key for.
         *
         * @return string The date key.
         */
        public function get_date_key($timestamp, $range)
        {
        }
        public function get_date_range($range = 'all')
        {
        }
        /**
         * Resolve from/to date strings for a range.
         *
         * @param string $range
         * @return array { from: string, to: string }
         */
        public function resolve_dates($range)
        {
        }
        /**
         * Build the ordered list of date labels for a given range.
         *
         * @param string $range
         * @return string[]
         */
        public function get_time_series_labels($range)
        {
        }
        /**
         * Ordinal suffix for a day number — 1 → "1st", 22 → "22nd", etc.
         *
         * @param int $day
         * @return string
         */
        private function ordinal($day)
        {
        }
        /**
         * Total orders
         *
         * @param string $range The date range to query.
         * @param array  $args  Optional args passed to Order::list() (e.g. status, product_id, customer_id, meta_query, etc.)
         *
         * @return array
         */
        public function total_orders($range = 'this-month', $args = array())
        {
        }
        /**
         * Total sales
         *
         * @param string $range The date range to query.
         * @param array  $args  Optional args passed to Order::list() (e.g. status, product_id, customer_id, meta_query, etc.)
         *
         * @return float
         */
        public function total_sales($range = 'this-month', $args = array())
        {
        }
        /**
         * Get total refund amount from wp_ec_refunds table.
         *
         * Only counts approved/processed refunds within the date range.
         *
         * @param string $range The date range to query.
         * @return float
         */
        public function total_refunds($range = 'this-month')
        {
        }
        /**
         * Get refund count and total amount from wp_ec_refunds table.
         *
         * Used when both the count and the monetary amount are needed.
         *
         * @param string   $range      The date range to query.
         * @param int|null $product_id Optional product ID to scope to a single product.
         * @param bool     $all_time   Whether to skip date filtering entirely.
         * @return array { refund_count: int, refund_amount: float }
         */
        protected function get_refund_stats($range, $product_id = null, $all_time = false)
        {
        }
        /**
         * Get comparison range for previous period
         *
         * @param string $range The current range.
         * @return string The comparison range.
         */
        protected function get_comparison_range($range)
        {
        }
        /**
         * Calculate stats for a given range
         *
         * @param string $range The date range.
         * @return array
         */
        protected function calculate_stats($range)
        {
        }
        /**
         * Calculate comparison percentage and type
         *
         * @param float $current Current period value.
         * @param float $previous Previous period value.
         * @return array
         */
        protected function calculate_comparison($current, $previous)
        {
        }
        /**
         * Get comparison with vibe for positive metrics (increment is good)
         *
         * @param float $current Current period value.
         * @param float $previous Previous period value.
         * @return array
         */
        public function get_comparison_with_vibe($current, $previous)
        {
        }
        /**
         * Get comparison with vibe for negative metrics (decrement is good)
         *
         * @param float $current Current period value.
         * @param float $previous Previous period value.
         * @return array
         */
        public function get_refund_comparison($current, $previous)
        {
        }
        /**
         * Generate a cache key for a report endpoint.
         *
         * @param string $method The method name.
         * @param array  $params Request parameters.
         * @return string The cache key.
         */
        protected function generate_cache_key($method, $params = array())
        {
        }
        /**
         * Try to get cached response or execute callback and cache the result.
         *
         * @param string   $cache_key   The cache key.
         * @param callable $callback    The callback to execute if cache miss.
         * @param int      $expiration  Cache duration in seconds.
         * @return mixed
         */
        protected function get_cached_or_set($cache_key, $callback, $expiration = self::CACHE_DURATION_HOUR)
        {
        }
        /**
         * Get request params for caching.
         *
         * @param \WP_REST_Request $request The request object.
         * @return array
         */
        protected function get_cache_params($request)
        {
        }
        /**
         * Get all cache keys used for reports.
         *
         * @return array List of cache key prefixes (with 'report_' prefix).
         */
        public static function get_cache_keys()
        {
        }
        /**
         * Get all possible date ranges.
         *
         * @return array List of all range values.
         */
        public static function get_all_ranges()
        {
        }
        /**
         * Get all possible comparison ranges.
         *
         * @return array List of all comparison range values.
         */
        public static function get_all_comparison_ranges()
        {
        }
        /**
         * Get all possible variations of a cache key.
         *
         * Generates: base, range-only, comparison-only, range+comparison combos.
         *
         * @param string $key_prefix The base key prefix (e.g., 'report_overview_stats').
         * @return array List of all possible key variations.
         */
        private function get_cache_key_variations($key_prefix)
        {
        }
        /**
         * Delete all cache variations for a specific product.
         *
         * @param int $product_id The product ID.
         */
        public static function delete_single_product_cache($product_id)
        {
        }
        /**
         * Get all possible cache key variations for a single product.
         *
         * Generates: base, range-only, comparison-only, range+comparison combos, all with product_id.
         *
         * @param string $key_prefix The base key prefix (e.g., 'products_single_info').
         * @param int    $product_id  The product ID.
         * @return array List of all possible key variations with product_id.
         */
        private function get_single_product_cache_key_variations($key_prefix, $product_id)
        {
        }
        /**
         * Delete all single product report caches for all products.
         *
         * Gets all product IDs from database and deletes their cache variations.
         */
        public static function delete_all_single_product_caches()
        {
        }
        /**
         * Get all product IDs from database.
         *
         * @return array List of product IDs.
         */
        private function get_all_product_ids()
        {
        }
        /**
         * Delete all variations of a cache key.
         *
         * @param string $key_prefix The base key prefix (without 'report_' prefix).
         */
        private function delete_cache_variations($key_prefix)
        {
        }
        /**
         * Get product-related cache keys.
         *
         * @return array List of product cache key prefixes (without 'report_' prefix).
         */
        public static function get_product_cache_keys()
        {
        }
        /**
         * Get single product-related cache keys.
         *
         * @return array List of single product cache key prefixes (with product_id).
         */
        public static function get_single_product_cache_keys()
        {
        }
        /**
         * Get order/customer-related cache keys.
         *
         * @return array List of order/customer cache key prefixes (without 'report_' prefix).
         */
        public static function get_order_cache_keys()
        {
        }
        /**
         * Delete all report caches.
         *
         * @param string $key_prefix Optional key prefix to delete specific caches.
         */
        public static function delete_all_cache($key_prefix = '')
        {
        }
        /**
         * Delete product-related report caches.
         */
        public static function delete_product_cache()
        {
        }
        /**
         * Delete order/customer-related report caches.
         */
        public static function delete_order_cache()
        {
        }
        /**
         * Get orders data by location (country/state) with aggregation.
         *
         * @param string     $date_from  Start date.
         * @param string     $date_to    End date.
         * @param string     $aggregate 'count' for order count, 'customers' for unique customer count, 'sum' for revenue.
         * @param int        $product_id Optional product ID to filter orders.
         * @param array|null $statuses   Optional list of order statuses to include. Null means no status filter.
         * @return array
         */
        public function get_orders_by_location($date_from, $date_to, $aggregate = 'count', $product_id = null, $statuses = null)
        {
        }
        /**
         * Get chart labels for the given range (alias of get_time_series_labels).
         *
         * @param string $range The date range.
         *
         * @return array
         */
        protected function get_chart_labels($range)
        {
        }
        /**
         * Format series data as x/y array
         *
         * @param array $values The data values.
         * @param array $labels The labels.
         * @return array
         */
        public function format_chart_data($values, $labels)
        {
        }
        /**
         * Format chart data with labels (int variant).
         *
         * @param array $values The data values.
         * @param array $labels The labels.
         * @return array
         */
        protected function format_chart_data_with_labels($values, $labels)
        {
        }
        /**
         * Map raw date-grouped query results to a flat array aligned with labels.
         *
         * Replaces the repeated pattern of: fill keys with 0, loop results,
         * call get_date_key(), assign to matching bucket, return array_values().
         *
         * @param array  $rows    Query results with 'order_date' and a value column.
         * @param string $range   The date range (used for label formatting).
         * @param string $value_col Column name for the value (default 'order_count').
         * @param string $cast    Type to cast values to: 'int' or 'float'.
         * @return array Flat array of cast values aligned with labels.
         */
        protected function map_to_date_series($rows, $range, $value_col = 'order_count', $cast = 'int')
        {
        }
        /**
         * Get 24-hour labels for heatmap charts.
         *
         * @return string[]
         */
        protected function get_hour_labels()
        {
        }
        /**
         * Get order status color map.
         *
         * @return array
         */
        protected function get_status_colors()
        {
        }
        /**
         * Get order status label map.
         *
         * @return array
         */
        protected function get_status_labels()
        {
        }
        /**
         * Build a date-to-hours map for heatmap queries.
         *
         * @param string $date_from Start date (Y-m-d).
         * @param string $date_to   End date (Y-m-d).
         * @return array<string, int[]>
         */
        protected function build_heatmap_date_map($date_from, $date_to)
        {
        }
        /**
         * Build heatmap data array from a date-hours map and hour labels.
         *
         * @param array   $map          Date-to-hours map from build_heatmap_date_map().
         * @param string[] $hour_labels  24-hour labels from get_hour_labels().
         * @return array
         */
        protected function build_heatmap_data($map, $hour_labels)
        {
        }
        /**
         * Build a status/fulfillment breakdown array.
         *
         * @param string $range      The date range.
         * @param array  $statuses   Status key => label pairs.
         * @param array  $colors     Status key => color pairs.
         * @param array  $labels     Status key => translated label pairs.
         * @param string $filter_key The query filter key ('status' or 'fulfill_status').
         * @return array
         */
        protected function build_status_breakdown($range, $statuses, $colors, $labels, $filter_key = 'status')
        {
        }
    }
    /**
     * Reports Customer API
     */
    class Customers extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Customer stats - total, new, repeat, orders per customer, LTV, AOV
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function stats($request)
        {
        }
        /**
         * Calculate customer stats for a given range
         *
         * @param string $range The date range.
         * @return array
         */
        protected function calculate_customer_stats($range)
        {
        }
        /**
         * Customers over time — New and Repeat customer datasets (current + comparison).
         *
         * @param \WP_REST_Request $request
         */
        public function over_time($request)
        {
        }
        /**
         * Customer heatmap - customers over time by hour and day
         *
         * Response:
         * {
         *   "range": "last-30",
         *   "from": "2026-03-01",
         *   "to": "2026-03-30",
         *   "data": [
         *     { "x": "12am", "y": "2026-03-01", "v": 0 },
         *     { "x": "1am",  "y": "2026-03-01", "v": 0 },
         *     ...
         *     { "x": "11pm", "y": "2026-03-01", "v": 3 },
         *     { "x": "0am",  "y": "2026-03-02", "v": 0 },
         *     ...
         *   ]
         * }
         *
         * @param \WP_REST_Request $request
         */
        public function heatmap($request)
        {
        }
        /**
         * Build new customers series for a given range
         *
         * @param string   $range
         * @param string[] $categories
         * @return int[]
         */
        private function build_new_customers_series($range, $categories)
        {
        }
        /**
         * Build repeat customers series for a given range
         *
         * @param string   $range
         * @param string[] $categories
         * @return int[]
         */
        private function build_repeat_customers_series($range, $categories)
        {
        }
        /**
         * Customers by country/state location
         *
         * Response (world):
         * {
         *   "range": "last-30",
         *   "type": "world",
         *   "data": { "US": 100, "GB": 60 },
         *   "country_names": { "US": "United States", ... },
         *   "country_numeric": { "US": "840", ... }
         * }
         *
         * Response (states):
         * {
         *   "range": "last-30",
         *   "type": "states",
         *   "country": "US",
         *   "country_iso3": "USA",
         *   "data": { "CA": 40, "NY": 30 },
         *   "states_data": [...]
         * }
         *
         * @param \WP_REST_Request $request
         */
        public function customer_by_location($request)
        {
        }
        /**
         * Top customers
         *
         * @param \WP_REST_Request $request
         */
        public function top_customers($request)
        {
        }
        /**
         * Get top customers by revenue for a date range.
         *
         * @param string $date_from Start date.
         * @param string $date_to   End date.
         * @param int    $limit     Number of customers to return.
         * @return array
         */
        private function get_top_customers_by_revenue($date_from, $date_to, $limit = 50)
        {
        }
    }
    /**
     * Reports Legacy API - maintains backward compatibility
     */
    class LegacyReports extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Get the full report data with charts
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function reports($request)
        {
        }
    }
    /**
     * Reports Orders API
     */
    class Orders extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Reports orders overview stats
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function stats($request)
        {
        }
        /**
         * Orders over time — Order Count and Order Amount datasets (current + comparison).
         *
         * @param \WP_REST_Request $request
         */
        public function over_time($request)
        {
        }
        /**
         * Build a flat order-count array (int per category bucket).
         *
         * @param string   $range
         * @param string[] $categories
         * @return int[]
         */
        private function build_count_series($range, $categories)
        {
        }
        /**
         * Build a flat order-amount array (float per category bucket).
         *
         * @param string   $range
         * @param string[] $categories
         * @return float[]
         */
        private function build_amount_series($range, $categories)
        {
        }
        /**
         * Customer order frequency report.
         *
         * @param \WP_REST_Request $request
         */
        public function order_frequency($request)
        {
        }
        /**
         * Orders by status
         *
         * @param \WP_REST_Request $request
         */
        public function status_breakdown($request)
        {
        }
        /**
         * Get fulfillment status color map.
         *
         * @return array
         */
        private function get_fulfill_colors()
        {
        }
        /**
         * Orders by fulfillment status
         *
         * @param \WP_REST_Request $request
         */
        public function fulfillment_breakdown($request)
        {
        }
        /**
         * Orders heatmap — hourly order count per date.
         * Each date has 24 hourly buckets (0–23).
         *
         * Response:
         * {
         *   "range": "last-30",
         *   "from": "2026-03-01",
         *   "to": "2026-03-30",
         *   "data": [
         *     { "x": "0am",  "y": "2026-03-01", "v": 5 },
         *     { "x": "1am",  "y": "2026-03-01", "v": 0 },
         *     ...
         *     { "x": "11pm", "y": "2026-03-01", "v": 3 },
         *     { "x": "0am",  "y": "2026-03-02", "v": 0 },
         *     ...
         *   ]
         * }
         *
         * @param \WP_REST_Request $request
         */
        public function heatmap($request)
        {
        }
        /**
         * Orders by country
         *
         * Response (world):
         * {
         *   "range": "last-30",
         *   "type": "world",
         *   "data": { "US": 100, "GB": 60 },
         *   "country_names": { "US": "United States", ... },
         *   "country_numeric": { "US": "840", ... }
         * }
         *
         * Response (states):
         * {
         *   "range": "last-30",
         *   "type": "states",
         *   "country": "US",
         *   "country_iso3": "USA",
         *   "data": { "CA": 40, "NY": 30 },
         *   "states_data": [...]
         * }
         *
         * @param \WP_REST_Request $request
         */
        public function order_by_location($request)
        {
        }
    }
    /**
     * Reports Overview API
     */
    class Overview extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Reports stats overview
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function stats($request)
        {
        }
        /**
         * Get total products sold
         *
         * @param string $range The date range.
         * @return int
         */
        private function get_products_sold($range)
        {
        }
        /**
         * Get unique customers count
         *
         * @param string $range The date range.
         * @return int
         */
        private function get_unique_customers($range)
        {
        }
        /**
         * Get Sales vs Refund vs Revenue data with chart visualization
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function sales_refund_revenue($request)
        {
        }
        /**
         * Count items by date from an array of records with 'created_at'.
         *
         * @param array  $items Array of records with 'created_at' key.
         * @param string $range The date range.
         * @return array Chart-formatted data array.
         */
        private function count_items_by_date($items, $range)
        {
        }
        /**
         * Sum values by date from an array of records with 'created_at'.
         *
         * @param array  $items Array of records with 'created_at' and 'total'.
         * @param string $range The date range.
         * @return array Chart-formatted data array.
         */
        private function sum_items_by_date($items, $range)
        {
        }
        /**
         * Get sales amount by date
         *
         * @param string $range The date range.
         * @param string $status Optional status filter.
         *
         * @return array
         */
        private function get_sales_by_date($range)
        {
        }
        /**
         * Get refunds by date from the refunds table
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_refunds_by_date($range)
        {
        }
        /**
         * Sum refunds by date and format for chart
         *
         * @param array  $refunds_by_date Refunds keyed by date.
         * @param string $range The date range.
         *
         * @return array
         */
        private function sum_refunds_by_date($refunds_by_date, $range)
        {
        }
        /**
         * Get net revenue by date
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_revenue_by_date($range)
        {
        }
        /**
         * Get orders vs refund count comparison for chart visualization
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function order_vs_refund($request)
        {
        }
        /**
         * Get order count by date
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_order_count_by_date($range)
        {
        }
        /**
         * Get refund count by date
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_refund_count_by_date($range)
        {
        }
        /**
         * Get order status breakdown
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function order_status($request)
        {
        }
        /**
         * Get order type breakdown (new vs returning orders)
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function order_type($request)
        {
        }
        /**
         * Get order count by type (new vs returning) for chart data
         *
         * @param string $range The date range.
         * @param string $type The order type ('new' or 'returning').
         *
         * @return array
         */
        private function get_order_type_by_date($range, $type = 'new')
        {
        }
        /**
         * Get top selling products
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function top_selling($request)
        {
        }
        /**
         * Get top selling products
         *
         * @param string $range The date range.
         * @param int    $limit Number of products to return.
         *
         * @return array
         */
        private function get_top_selling_products($range, $limit = 5)
        {
        }
        /**
         * Get product catalog stats
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function catalog_stats($request)
        {
        }
        /**
         * Get catalog stats data
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_catalog_stats_data($range)
        {
        }
        /**
         * Get new vs returning customers chart data
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function customer_type($request)
        {
        }
        /**
         * Get customer type data by date
         *
         * @param string $range The date range.
         * @param string $type The customer type ('new' or 'returning').
         *
         * @return array
         */
        private function get_customer_type_by_date($range, $type = 'new')
        {
        }
        /**
         * Get customer overview stats and top customers
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function customer_overview($request)
        {
        }
        /**
         * Get customer metrics for a date range
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_customer_metrics($range)
        {
        }
        /**
         * Get top customers by spending
         *
         * @param string $range The date range.
         * @param int    $limit Number of customers to return.
         *
         * @return array
         */
        private function get_top_customers($range, $limit = 10)
        {
        }
    }
    /**
     * Reports Products API
     */
    class Products extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Products stats overview
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function stats($request)
        {
        }
        /**
         * Get date range with time for queries.
         *
         * @param string $range The date range.
         * @return array { from: string, to: string, from_raw: string, to_raw: string, is_all_time: bool }
         */
        private function get_query_date_range($range)
        {
        }
        /**
         * Calculate product stats for a given range
         *
         * @param string $range The date range.
         * @return array
         */
        private function calculate_product_stats($range)
        {
        }
        /**
         * Get product sales stats (gross sales and refunds)
         *
         * @param string $range The date range.
         * @return array
         */
        private function get_product_sales_stats($range)
        {
        }
        /**
         * Get average rating across products
         *
         * @param string $range The date range.
         * @return float
         */
        private function get_average_rating($range)
        {
        }
        /**
         * Get total count of ratings across products
         *
         * @param string $range The date range.
         * @return int
         */
        private function get_total_ratings_count($range)
        {
        }
        /**
         * Get products sold over time with comparison
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function products_sold_over_time($request)
        {
        }
        /**
         * Get products sold count by date
         *
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_products_sold_by_date($range)
        {
        }
        /**
         * Get most sold products with detailed metrics
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function most_sold($request)
        {
        }
        /**
         * Get least sold products with detailed metrics
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function least_sold($request)
        {
        }
        /**
         * Get most sold products data
         *
         * @param string $range The date range.
         * @param int    $limit Number of products to return.
         *
         * @return array
         */
        private function get_most_sold_products($range, $limit = 10)
        {
        }
        /**
         * Get least sold products data
         *
         * @param string $range The date range.
         * @param int    $limit Number of products to return.
         *
         * @return array
         */
        private function get_least_sold_products($range, $limit = 10)
        {
        }
        /**
         * Get sold products data with detailed metrics.
         *
         * @param string $range The date range.
         * @param int    $limit Number of products to return.
         * @param string $order Sort direction: 'ASC' or 'DESC'.
         *
         * @return array
         */
        private function get_sold_products($range, $limit = 10, $order = 'DESC')
        {
        }
        /**
         * Get total stock for a product
         *
         * @param int    $product_id The product ID.
         * @param string $variations_table The variations table name.
         *
         * @return int
         */
        private function get_product_stock($product_id, $variations_table)
        {
        }
        /**
         * Get product name by ID
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function get_product_name($request)
        {
        }
        /**
         * Get single product stats
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function single_product_stats($request)
        {
        }
        /**
         * Get single product stats data
         *
         * @param int    $product_id The product ID.
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_single_product_stats_data($product_id, $range)
        {
        }
        /**
         * Get product rating
         *
         * @param int $product_id The product ID.
         *
         * @return float
         */
        private function get_product_rating($product_id)
        {
        }
        /**
         * Get single product basic info with variations
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function single_product_info($request)
        {
        }
        /**
         * Get single product info data
         *
         * @param \EasyCommerce\Models\Product $product The product object.
         * @param string  $range   The date range.
         *
         * @return array
         */
        private function get_single_product_info_data($product, $range = 'last-30')
        {
        }
        /**
         * Get product variations with sales and rating stats
         *
         * @param int    $product_id The product ID.
         * @param string $range      The date range.
         *
         * @return array
         */
        private function get_product_variations_with_stats($product_id, $range = 'last-30')
        {
        }
        /**
         * Get single product sales over time with new vs repeat customers
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function single_product_sales_over_time($request)
        {
        }
        /**
         * Get new customers who bought a specific product by date
         *
         * @param int    $product_id The product ID.
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_single_product_new_customers_by_date($product_id, $range)
        {
        }
        /**
         * Get repeat customers who bought a specific product by date
         *
         * @param int    $product_id The product ID.
         * @param string $range The date range.
         *
         * @return array
         */
        private function get_single_product_repeat_customers_by_date($product_id, $range)
        {
        }
        /**
         * Get single product sales by location (country/state).
         *
         * Response (world):
         * {
         *   "range": "last-30",
         *   "type": "world",
         *   "data": { "US": 120.00, "GB": 60.00 },
         *   "country_names": { "US": "United States", ... },
         *   "country_numeric": { "US": "840", ... }
         * }
         *
         * Response (states):
         * {
         *   "range": "last-30",
         *   "type": "states",
         *   "country": "US",
         *   "country_iso3": "USA",
         *   "data": { "CA": 80.00, "NY": 40.00 },
         *   "states_data": [...]
         * }
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function product_sale_by_location($request)
        {
        }
        /**
         * Aggregate product-level revenue by country/state.
         *
         * Unlike get_orders_by_location() which sums o.total (the full order
         * amount), this method uses oi.price * oi.quantity so that only the
         * specific product's contribution is counted per location.
         *
         * @param int    $product_id Product ID to scope.
         * @param string $date_from  Start datetime (Y-m-d).
         * @param string $date_to    End datetime (Y-m-d H:i:s, with 23:59:59 appended by caller).
         * @return array Same shape as get_orders_by_location() with type=world|states.
         */
        private function get_product_sales_by_location(int $product_id, string $date_from, string $date_to): array
        {
        }
        /**
         * Get single product reviews with stats
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function single_product_reviews($request)
        {
        }
        /**
         * Get single product reviews data
         *
         * @param int    $product_id The product ID.
         * @param int    $limit      Number of reviews to return.
         * @param string $range      The date range.
         *
         * @return array
         */
        private function get_single_product_reviews_data($product_id, $limit = 6, $range = 'last-30')
        {
        }
        /**
         * Get product review count
         *
         * @param int   $product_id The product ID.
         * @param array $date_query Optional WP_Comment_Query date_query array.
         *
         * @return int
         */
        private function get_product_review_count($product_id, $date_query = array())
        {
        }
        /**
         * Get product rating counts by star
         *
         * @param int   $product_id The product ID.
         * @param array $date_query Optional WP_Comment_Query date_query array.
         *
         * @return array
         */
        private function get_product_rating_counts($product_id, $date_query = array())
        {
        }
        /**
         * Get product reviews
         *
         * @param int   $product_id The product ID.
         * @param int   $limit      Number of reviews to return.
         * @param array $date_query Optional WP_Comment_Query date_query array.
         *
         * @return array
         */
        private function get_product_reviews($product_id, $limit = 6, $date_query = array())
        {
        }
    }
    /**
     * Reports Revenue API
     */
    class Revenue extends \EasyCommerce\API\Reports\Reports
    {
        /**
         * Revenue stats - gross revenue, averages by customer, order, and product
         *
         * @param \WP_REST_Request $request The request object.
         */
        public function stats($request)
        {
        }
        /**
         * Revenue over time — Revenue Amount datasets (current + comparison)
         *
         * @param \WP_REST_Request $request
         */
        public function over_time($request)
        {
        }
        /**
         * Build a revenue amount array keyed by label.
         *
         * @param string   $range
         * @param string[] $labels
         * @return float[]
         */
        private function build_revenue_series($range, $labels)
        {
        }
        /**
         * Calculate revenue stats for a given range
         *
         * Mirrors calculate_stats() in Reports: only completed, processing,
         * partially_refunded, and refunded orders count toward gross revenue,
         * and refunds come from the Refund table (approved refunds only).
         *
         * @param string $range The date range.
         * @return array
         */
        protected function calculate_revenue_stats($range)
        {
        }
        /**
         * Top customers by revenue
         *
         * @param \WP_REST_Request $request
         */
        public function top_customers($request)
        {
        }
        /**
         * Revenue by country/state location
         *
         * Response (world):
         * {
         *   "range": "last-30",
         *   "type": "world",
         *   "data": { "US": 1000.00, "GB": 600.00 },
         *   "country_names": { "US": "United States", ... },
         *   "country_numeric": { "US": "840", ... }
         * }
         *
         * Response (states):
         * {
         *   "range": "last-30",
         *   "type": "states",
         *   "country": "US",
         *   "country_iso3": "USA",
         *   "data": { "CA": 400.00, "NY": 300.00 },
         *   "states_data": [...]
         * }
         *
         * @param \WP_REST_Request $request
         */
        public function revenue_by_location($request)
        {
        }
    }
}
namespace EasyCommerce\API {
    class Shipping_Plan extends \EasyCommerce\Abstracts\API
    {
        /**
         * Retrieve all shipping plans or a specific plan by ID.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_all($request)
        {
        }
        /**
         * Create a new shipping plan.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function create($request)
        {
        }
        /**
         * Update an existing shipping plan.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function update($request)
        {
        }
        /**
         * Delete a shipping plan.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete($request)
        {
        }
        /**
         * Retrieve shipping plans available for a specific region.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function get_by_location($request)
        {
        }
    }
    /**
     * Tax API class
     */
    class Tax extends \EasyCommerce\Abstracts\API
    {
        public function list_classes($request)
        {
        }
        /**
         * Create a tax class with associated rates.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function create_class($request)
        {
        }
        public function get_class($request)
        {
        }
        /**
         * Update a tax class with associated rates.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function update_class($request)
        {
        }
        /**
         * Delete a tax class and its associated rates.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function delete_class($request)
        {
        }
        /**
         * Retrieve matching tax CSV files for the given countries and return them in a JSON response.
         *
         * This REST API endpoint uses the Tax_Model to search the plugin's /taxes folder
         * for CSV files matching the provided country codes. Only existing files are returned.
         *
         * @param WP_REST_Request $request The current REST API request containing 'countries' parameter.
         * @return WP_REST_Response JSON response containing an array of matched country codes.
         */
        public function get_tax_files($request)
        {
        }
        /**
         * Retrieve tax rates from CSV and return them in a JSON response.
         *
         * This endpoint uses the Tax_Model to read tax rates from the CSV file
         * and formats them for API consumption.
         *
         * @param WP_REST_Request $request The current REST API request.
         * @return WP_REST_Response JSON response containing tax rates or an error message.
         */
        public function get_tax_rates($request)
        {
        }
    }
    class Taxonomy extends \EasyCommerce\Abstracts\API
    {
        use \EasyCommerce\Traits\Cleaner;
        public function get_categories($request)
        {
        }
        public function add_category($request)
        {
        }
        public function update_category($request)
        {
        }
        public function delete_category($request)
        {
        }
        public function bulk_delete_categories($request)
        {
        }
        public function get_brands($request)
        {
        }
        public function add_brand($request)
        {
        }
        public function update_brand($request)
        {
        }
        public function delete_brand($request)
        {
        }
        public function bulk_delete_brands($request)
        {
        }
        public function get_tags($request)
        {
        }
        public function add_tag($request)
        {
        }
        public function update_tag($request)
        {
        }
        public function delete_tag($request)
        {
        }
        public function bulk_delete_tags($request)
        {
        }
    }
    class Transaction extends \EasyCommerce\Abstracts\API
    {
        /**
         * List transactions with optional filters like order ID, status, and pagination.
         *
         * @param WP_REST_Request $request
         * @return WP_REST_Response
         */
        public function list($request)
        {
        }
        public function delete($request)
        {
        }
    }
}
namespace EasyCommerce\Abstracts {
    /**
     * Abstract Field Class
     */
    abstract class Field
    {
        /**
         * Field ID.
         *
         * @var string
         */
        protected $id = '';
        /**
         * Field name attribute.
         *
         * @var string
         */
        protected $name = '';
        /**
         * Field label.
         *
         * @var string
         */
        protected $label = '';
        /**
         * Field value.
         *
         * @var string
         */
        protected $value = '';
        /**
         * Field description.
         *
         * @var string
         */
        protected $description = '';
        /**
         * Field column size.
         *
         * @var int
         */
        protected $cols = 1;
        /**
         * Field placeholder.
         *
         * @var string
         */
        protected $placeholder = '';
        /**
         * Field options.
         *
         * @var array
         */
        protected $options = array();
        /**
         * Field default value.
         *
         * @var mixed
         */
        protected $default = '';
        /**
         * Whether the field is disabled.
         *
         * @var bool
         */
        protected $disabled = false;
        /**
         * Whether the field is readonly.
         *
         * @var bool
         */
        protected $readonly = false;
        /**
         * Whether the field is required.
         *
         * @var bool
         */
        protected $required = false;
        /**
         * Field type.
         *
         * @var string
         */
        protected $type = 'text';
        /**
         * Field CSS class.
         *
         * @var string
         */
        protected $class = '';
        /**
         * Field attributes.
         *
         * @var array
         */
        protected $atts = array();
        /**
         * Additional field args.
         *
         * @var array
         */
        protected $args = array();
        /**
         * Whether the field supports multiple selections.
         *
         * @var bool
         */
        protected $multiple = false;
        /**
         * Constructor.
         *
         * @param array $config Field configuration.
         */
        public function __construct($config = array())
        {
        }
        /**
         * Set whether the field supports multiple selections.
         *
         * @param bool $multiple
         */
        public function set_multiple($multiple = false)
        {
        }
        /**
         * Get whether the field supports multiple selections.
         *
         * @return bool
         */
        public function is_multiple()
        {
        }
        /**
         * Get the field ID.
         *
         * @return string
         */
        public function get_id()
        {
        }
        /**
         * Get the field name attribute.
         *
         * @return string
         */
        public function get_name()
        {
        }
        /**
         * Get the field label.
         *
         * @return string
         */
        public function get_label()
        {
        }
        /**
         * Get the field value.
         *
         * @return string
         */
        public function get_value()
        {
        }
        /**
         * Get the field description.
         *
         * @param string $wrapper Wrapper HTML tag.
         * @return string
         */
        public function get_description($wrapper = '')
        {
        }
        /**
         * Get the field column size.
         *
         * @return int
         */
        public function get_cols()
        {
        }
        /**
         * Get the field placeholder.
         *
         * @return string
         */
        public function get_placeholder()
        {
        }
        /**
         * Get the field options.
         *
         * @return array
         */
        public function get_options()
        {
        }
        /**
         * Get the field default value.
         *
         * @return mixed
         */
        public function get_default()
        {
        }
        /**
         * Check if the field is disabled.
         *
         * @return bool
         */
        public function is_disabled()
        {
        }
        /**
         * Check if the field is readonly.
         *
         * @return bool
         */
        public function is_readonly()
        {
        }
        /**
         * Check if the field is required.
         *
         * @return bool
         */
        public function is_required()
        {
        }
        /**
         * Get the field type.
         *
         * @return string
         */
        public function get_type()
        {
        }
        /**
         * Get the field class.
         *
         * @return string
         */
        public function get_class()
        {
        }
        /**
         * Set the field value.
         *
         * @param string $value
         */
        public function set_value($value = '')
        {
        }
        /**
         * Set the field description.
         *
         * @param string $description
         */
        public function set_description($description = '')
        {
        }
        /**
         * Set the field column size.
         *
         * @param int $cols
         */
        public function set_cols($cols = 1)
        {
        }
        /**
         * Set the field placeholder.
         *
         * @param string $placeholder
         */
        public function set_placeholder($placeholder = '')
        {
        }
        /**
         * Set the field options.
         *
         * @param array $options
         */
        public function set_options($options = array())
        {
        }
        /**
         * Set the field default value.
         *
         * @param mixed $default
         */
        public function set_default($default = '')
        {
        }
        /**
         * Set the field disabled state.
         *
         * @param bool $disabled
         */
        public function set_disabled($disabled = false)
        {
        }
        /**
         * Set the field readonly state.
         *
         * @param bool $readonly
         */
        public function set_readonly($readonly = false)
        {
        }
        /**
         * Set the field type.
         *
         * @param string $type
         */
        public function set_type($type = 'text')
        {
        }
        /**
         * Set the field class.
         *
         * @param string $class
         */
        public function set_class($class = '')
        {
        }
        /**
         * Generate the CSS ID for the field.
         *
         * @return string
         */
        public function get_field_id()
        {
        }
        /**
         * Generate the CSS class for the field.
         *
         * @return string
         */
        public function get_field_class()
        {
        }
        /**
         * Set attributes.
         *
         * @param array $atts
         */
        public function set_atts($atts = array())
        {
        }
        /**
         * Get additional attributes.
         *
         * @return array
         */
        public function get_atts()
        {
        }
        /**
         * Render additional attributes as a string.
         *
         * @return string
         */
        protected function render_atts()
        {
        }
        /**
         * Set args.
         *
         * @param array $args
         */
        public function set_args($args = array())
        {
        }
        /**
         * Get args.
         *
         * @return array
         */
        public function get_args()
        {
        }
        /**
         * Get a single arg.
         *
         * @return mix
         */
        public function get_arg($key, $default = '')
        {
        }
        /**
         * Generate the CSS ID for the field wrapper.
         *
         * @return string
         */
        public function get_wrapper_id()
        {
        }
        /**
         * Generate the CSS class for the field wrapper.
         *
         * @return string
         */
        public function get_wrapper_class()
        {
        }
        /**
         * Render the field.
         *
         * @return string
         */
        abstract public function render();
    }
}
namespace EasyCommerce\Models {
    /**
     * Generic Database class for handling database operations across different tables.
     */
    class Database
    {
        /**
         * The WordPress database access abstraction object.
         *
         * @var wpdb
         */
        public $db;
        /**
         * The common prefix for the tables.
         *
         * @var string
         */
        protected $prefix = 'ec_';
        /**
         * The full database table name including the prefix.
         *
         * @var string
         */
        protected $table_name;
        /**
         * The primary key for the specific table.
         *
         * @var string
         */
        protected $primary_key;
        /**
         * Constructor to set up database operations.
         *
         * @param string $table_name Table name for the specific entity (without prefix).
         * @param string $primary_key The primary key for the specific table.
         */
        public function __construct($table_name = null, $primary_key = 'id')
        {
        }
        /**
         * Sets the table name and updates the table name property.
         *
         * @param string $table_name Table name for the specific entity (without prefix).
         * @return void
         */
        public function set_table($table_name)
        {
        }
        /**
         * Gets the table name
         *
         * @return string $table_name Table name for the specific entity (with prefix).
         */
        public function get_table()
        {
        }
        /**
         * Gets the primary key
         *
         * @return string $primary_key The primary key for the table.
         */
        public function get_primary_key()
        {
        }
        /**
         * Gets table data
         *
         * @return array $data Table data
         * @todo rename method and maybve marge it with get_rows
         */
        public function get_data($data = '*')
        {
        }
        /**
         * Creates a new table in the database based on the table name provided during the object's instantiation.
         *
         * @param array $columns Associative array of column definitions.
         * @param array $options Additional options for table creation like primary key.
         * @return void
         */
        public function create_table($columns, $options = array())
        {
        }
        /**
         * Drops the table from the database.
         *
         * @return void
         */
        public function drop_table()
        {
        }
        public function prepare($query, ...$args)
        {
        }
        /**
         * Retrieves an entry by its primary key ID.
         *
         * @param int $id The ID of the entry to retrieve.
         * @return object|null The object if found, otherwise null.
         */
        public function get_by_id($id)
        {
        }
        /**
         * Inserts a new entry into the database.
         *
         * @param array $data Associative array of data to insert.
         * @return int|null The last inserted ID or null on failure.
         */
        public function insert_row($data)
        {
        }
        /**
         * Updates an existing entry.
         *
         * @param int   $id The ID of the entry to update.
         * @param array $data Associative array of data to update.
         * @return bool True if successful, false otherwise.
         */
        public function update_row($id, array $data)
        {
        }
        /**
         * Deletes an entry by its primary key ID.
         *
         * @param int $id The ID of the entry to delete.
         * @return bool True if successful, false otherwise.
         */
        public function delete_row($id)
        {
        }
        /**
         * Inserts multiple entries into the database.
         *
         * @param array $rows Array of associative arrays of data to insert.
         * @return array Array of inserted IDs or null on failure.
         */
        public function insert_rows($rows)
        {
        }
        /**
         * Updates multiple entries in the database.
         *
         * @param array $rows Array of associative arrays containing 'id' and 'data' keys.
         * @return bool True if all updates are successful, false otherwise.
         */
        public function update_rows($rows)
        {
        }
        /**
         * Deletes multiple entries from the database.
         *
         * @param array $ids Array of IDs of the entries to delete.
         * @return bool True if all deletions are successful, false otherwise.
         */
        public function delete_rows($ids)
        {
        }
        /**
         * Retrieves an entry based on associative array of conditions.
         *
         * @param array $conditions Associative array of conditions.
         * @return object|null The object if found, otherwise null.
         */
        public function get_row($conditions)
        {
        }
        /**
         * Retrieves multiple entries based on associative array of conditions.
         *
         * This method dynamically builds a query to retrieve rows from the database
         * table, allowing for flexible conditions, sorting, pagination, and nested conditions.
         *
         * CONDITIONS EXAMPLES:
         * - Basic conditions: `[ [ 'status' => 'active' ], [ 'price' => 100 ] ]`
         *   Produces: `WHERE status = 'active' AND price = 100`
         * - Nested conditions: `[ [ 'price' => [ '>', 50 ] ] ]`
         *   Produces: `WHERE price > 50`
         * - Multiple nested conditions: `[ [ 'price' => [ '>', 50 ] ], [ 'quantity' => [ '<', 20 ] ] ]`
         *   Produces: `WHERE price > 50 AND quantity < 20`
         *
         * SORTING EXAMPLES:
         * - Default sorting by ID ascending: `'ASC'`
         * - For descending order: `'DESC'`
         *
         * PAGINATION EXAMPLES:
         * - Limit to 10 rows: `$limit = 10`
         * - Skip the first 5 rows: `$offset = 5`
         *
         * @param array  $conditions Associative array of conditions.
         *    - For simple conditions: `[ [ 'column' => 'value' ] ]` (e.g., `[ [ 'status' => 'active' ] ]`).
         *    - For nested conditions: `[ [ 'column' => [ 'operator', value ] ] ]` (e.g., `[ [ 'price' => [ '>', 50 ] ] ]`).
         *
         * @param int    $limit The number of rows to return. Defaults to 0 (no limit).
         * @param int    $offset The number of rows to skip before starting to return results. Defaults to 0.
         * @param string $order The sorting order ('ASC' or 'DESC'). Defaults to 'ASC'.
         *
         * @return array Array of objects if found, otherwise an empty array.
         *
         * USAGE EXAMPLES:
         *
         * Example 1: Retrieve all active rows with price > 100, sorted descending
         * $rows = $db->get_rows(
         *     [
         *          [ 'status'  => 'active' ],
         *          [ 'price'   => [ '>', 100 ]
         *     ],
         *     10, // Limit
         *     0,  // Offset
         *     'DESC' // Order
         * );
         *
         * Example 2: Retrieve rows with multiple conditions and pagination
         * $rows = $db->get_rows(
         *     [
         *         [ 'price'    => [ '>', 50 ] ],
         *         [ 'quantity' => [ '<', 20 ] ],
         *     ],
         *     5,  // Limit
         *     10, // Offset
         *     'ASC' // Order
         * );
         *
         * Example 3: Retrieve rows without any conditions (get all)
         * $rows = $db->get_rows( [], 20, 0, 'ASC');
         */
        public function get_rows($conditions = array(), $limit = 0, $offset = 0, $order = 'DESC', $orderby = 'id')
        {
        }
        /**
         * Retrieves the total count of entries based on associative array of conditions.
         *
         * @param array $conditions Associative array of conditions.
         * @return int The count of entries.
         */
        public function get_count($conditions = array())
        {
        }
        /**
         * Prepares an SQL clause
         * 
         * @see get_rows()
         * @return [ 'where' => 'where clause statements', 'values' => 'clause values' ]
         */
        private function prepare_clause($conditions)
        {
        }
        /**
         * Get the default WordPress table prefix.
         *
         * @return string
         */
        public function get_wp_prefix()
        {
        }
        /**
         * Get the table prefix.
         *
         * @return string
         */
        public function get_prefix()
        {
        }
        public function exec($sql, $output = OBJECT)
        {
        }
        /**
         * Gets the $db instance
         */
        public function get_instance()
        {
        }
    }
}
namespace EasyCommerce\Abstracts {
    /**
     * Class Meta
     * Handles generic meta operations.
     */
    abstract class Meta extends \EasyCommerce\Models\Database
    {
        use \EasyCommerce\Traits\Cleaner;
        /**
         * The key used to identify unique IDs in the meta table.
         *
         * @var string
         */
        protected $unique_id_key;
        /**
         * Constructor.
         *
         * @param string $table_name    The name of the table.
         * @param string $unique_id_key The key used to identify unique IDs.
         */
        public function __construct($table_name, $unique_id_key)
        {
        }
        /**
         * Add meta data.
         *
         * @param int    $unique_id The unique ID to associate the meta data with.
         * @param string $key       The meta key.
         * @param mixed  $value     The meta value.
         * @return int|null The last inserted ID or null on failure.
         */
        public function add($unique_id, $key, $value)
        {
        }
        /**
         * Get meta data.
         *
         * @param int         $unique_id The unique ID to retrieve meta data for.
         * @param string|null $key       The meta key to retrieve. If null, retrieves all meta data.
         * @param bool        $single    Whether to return a single value or an array of values.
         * @return mixed
         */
        public function get($unique_id, $key = null, $single = true)
        {
        }
        /**
         * Update meta data.
         *
         * @param int    $unique_id The unique ID to update meta data for.
         * @param string $key       The meta key.
         * @param mixed  $value     The meta value.
         * @return bool|int If updating an existing entry, returns true on success, false on failure.
         *                  If creating a new entry, returns the last inserted ID or null on failure.
         */
        public function update($unique_id, $key, $value)
        {
        }
        /**
         * Delete meta data.
         *
         * @param int    $unique_id The unique ID to delete meta data for.
         * @param string $key       The meta key.
         * @return bool
         */
        public function delete($unique_id, $key)
        {
        }
    }
    /**
     * Abstract Model Class
     * Provides a base for all model classes with Database dependency injection.
     */
    abstract class Model
    {
        /**
         * @var \EasyCommerce\Models\Database Instance for handling DB operations
         */
        public $db;
        /**
         * @var string Table name (without prefix)
         */
        protected $table;
        /**
         * @var string Primary key column
         */
        protected $primary_key = 'id';
        /**
         * Constructor for the Model class.
         *
         * @param \EasyCommerce\Models\Database|null $db Optional. Database instance for dependency injection.
         */
        public function __construct(\EasyCommerce\Models\Database $db = null)
        {
        }
    }
    /**
     * Abstract Payment Method Class
     */
    abstract class Payment_Method
    {
        /**
         * Payment method ID
         *
         * @var string
         */
        protected $id;
        /**
         * Payment method title
         *
         * @var string
         */
        protected $title;
        /**
         * Payment method description
         *
         * @var string
         */
        protected $description;
        /**
         * IDs of already-registered payment methods, used to prevent duplicate
         * registration when a legacy standalone addon plugin is active alongside
         * the built-in core version of the same gateway.
         *
         * @var string[]
         */
        private static array $registered_ids = [];
        /**
         * Constructor
         *
         * @param string $id
         * @param string $title
         * @param string $description
         */
        public function __construct($id, $title, $description = '')
        {
        }
        /**
         * Register payment method in the checkout form
         */
        public function register_payment_method()
        {
        }
        /**
         * Add payment method to the available methods
         *
         * @param array $methods Existing payment methods.
         * @return array Updated list of payment methods.
         */
        public function add_payment_method($methods)
        {
        }
        /**
         * Enqueue payment method scripts
         */
        public function enqueue_scripts()
        {
        }
        /**
         * Localize payment method variables
         *
         * @param array $vars Existing localized variables.
         * @return array Updated list of localized variables.
         */
        public function localized($vars)
        {
        }
        /**
         * Display and save payment method settings
         *
         * @return array Payment method settings.
         */
        public function settings()
        {
        }
        /**
         * Process payment
         *
         * @param string $status Payment status.
         * @param int $order_id Order ID.
         * @param array $params Payment parameters.
         * @param int $customer_id Customer ID.
         */
        public function process_payment($status, $order_id, $params, $customer_id)
        {
        }
        /**
         * Process transaction
         *
         * @param mixed $transaction_id Transaction ID.
         * @param int $order_id Order ID.
         * @param float $total_amount Total amount.
         * @param int $customer_id Customer ID.
         * @param array $params Payment parameters.
         */
        public function insert_transaction($transaction_id, $order_id, $total_amount, $customer_id, $params)
        {
        }
        /**
         * Display payment form
         *
         * @return string Payment form HTML.
         */
        public function payment_form()
        {
        }
        /**
         * Get payment method status
         *
         * @return bool Payment method status.
         */
        public function get_status()
        {
        }
        /**
         * Get payment method ID
         *
         * @return string Payment method ID.
         */
        public function get_id()
        {
        }
        /**
         * Get payment method title
         *
         * @return string Payment method title.
         */
        public function get_title()
        {
        }
        /**
         * Get payment method name
         *
         * @return string Payment method name.
         */
        public function get_method_name()
        {
        }
        /**
         * Get payment method description
         *
         * @return string Payment method description.
         */
        public function get_description()
        {
        }
        /**
         * Get payment method icon
         *
         * @return string Payment method icon HTML or URL.
         */
        public function get_icon()
        {
        }
        public function is_enabled()
        {
        }
        public function is_available()
        {
        }
        public function is_offline(): bool
        {
        }
        public function refund($order_id, $reason, $amount)
        {
        }
        public function supports_refund()
        {
        }
        /**
         * Check payment method availability
         *
         * @param bool $unset Unset flag.
         * @param bool $has_physical Flag for physical product.
         *
         * @return bool Updated unset flag.
         */
        public function validate_availability($unset, $has_physical)
        {
        }
        /**
         * Supports recurring payments
         *
         * @param bool $supports Supports recurring payments.
         * @return bool Updated supports flag.
         *
         */
        public function supports_recurring($supports, $payment_id, $cart)
        {
        }
    }
    /**
     * Abstract User Class
     */
    abstract class User
    {
        use \EasyCommerce\Traits\Cache;
        /**
         * User ID
         *
         * @var int
         */
        protected $id = 0;
        /**
         * User email
         *
         * @var string
         */
        protected $email = '';
        /**
         * User display name
         *
         * @var string
         */
        protected $name = '';
        /**
         * User first name
         *
         * @var string
         */
        protected $first_name = '';
        /**
         * User last name
         *
         * @var string
         */
        protected $last_name = '';
        /**
         * User role
         *
         * @var string
         */
        protected $role = '';
        /**
         * User password
         *
         * @var string
         */
        protected $password;
        /**
         * User join date
         *
         * @var string
         */
        protected $join_date;
        /**
         * Constructor
         *
         * @param int|null $id User ID.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Get user ID.
         *
         * @return int
         */
        public function get_id()
        {
        }
        /**
         * Get user email.
         *
         * @return string
         */
        public function get_email()
        {
        }
        /**
         * Get user name.
         *
         * @return string
         */
        public function get_name()
        {
        }
        /**
         * Set user first name.
         */
        public function set_first_name($first_name)
        {
        }
        /**
         * Get user first name.
         *
         * @return string
         */
        public function get_first_name()
        {
        }
        /**
         * Get user last name.
         *
         * @return string
         */
        public function get_last_name()
        {
        }
        /**
         * Set user last name.
         */
        public function set_last_name($last_name)
        {
        }
        /**
         * Get user role.
         *
         * @return string
         */
        public function get_role()
        {
        }
        /**
         * Set user email.
         *
         * @param string $email
         */
        public function set_email($email)
        {
        }
        /**
         * Set user photo.
         *
         * @param string $photo
         */
        public function set_photo($photo = '')
        {
        }
        /**
         * Get user photo.
         *
         * @return string $photo
         */
        public function get_photo()
        {
        }
        /**
         * Set user name.
         *
         * @param string $name
         */
        public function set_name($name)
        {
        }
        /**
         * Set user role.
         *
         * @param string $role
         */
        public function set_role($role)
        {
        }
        public function get_join_date()
        {
        }
        /**
         * Save user data.
         *
         * @return bool
         */
        public function save()
        {
        }
        /**
         * Delete user.
         *
         * @return bool
         */
        public function delete()
        {
        }
        /**
         * Add user meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function add_meta($key, $value)
        {
        }
        /**
         * Get user meta data.
         *
         * @param string $key
         * @param bool   $single
         * @return mixed
         */
        public function get_meta($key, $single = true)
        {
        }
        /**
         * Update user meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function update_meta($key, $value)
        {
        }
        /**
         * Delete user meta data.
         *
         * @param string $key
         * @return bool
         */
        public function delete_meta($key)
        {
        }
        /**
         * Create a new user.
         *
         * @param array $args
         * @return bool
         */
        public function create($args)
        {
        }
        /**
         * Set user password.
         *
         * @param string $password
         */
        public function set_password($password)
        {
        }
        /**
         * @param int $expiry Time to expire the link, in minutes
         */
        public function get_login_link($expiry = 1, $redirect = '')
        {
        }
        /**
         * List users by role with optional filters such as search query, page, and per_page.
         *
         * @param string      $role
         * @param string|null $search
         * @param int         $page
         * @param int         $per_page
         * @return array List of users with pagination info
         */
        public static function list($role, $search = null, $page = 1, $per_page = 10)
        {
        }
    }
}
namespace EasyCommerce\Bootstrap {
    class Activator
    {
        use \EasyCommerce\Traits\Hook;
        /**
         * Handles plugin activation tasks.
         *
         * @return void
         */
        public static function activate()
        {
        }
        /**
         * Synchronizes plugin updates with the WordPress update system.
         *
         * @return void
         */
        public function sync_updates()
        {
        }
        /**
         * Registers custom user roles for the plugin.
         *
         * @return void
         */
        public function register_roles()
        {
        }
        /**
         * Registers custom post types for the plugin.
         *
         * @return void
         */
        public function register_post_types()
        {
        }
        /**
         * Registers custom taxonomies for the plugin.
         *
         * @return void
         */
        public function register_taxonomies()
        {
        }
        /**
         * Registers thumbnail sizes for the plugin.
         *
         * @return void
         */
        public function register_thumbnails()
        {
        }
        /**
         * Deactivates conflicting plugins if they are active.
         *
         * @return void
         */
        public function deactivate_conflicting_plugins()
        {
        }
    }
}
namespace EasyCommerce\Bootstrap\Activator {
    class Post_Type
    {
        /**
         * Registers the custom post type for products.
         *
         * @return void
         */
        public function register()
        {
        }
        // Set default content for new products
        public function insert_default_content($post_id, $post, $update)
        {
        }
    }
    class Taxonomy
    {
        public function register()
        {
        }
        private function registerProductCategory()
        {
        }
        private function registerProductBrand()
        {
        }
        private function registerProductTag()
        {
        }
    }
    class Thumbnail
    {
        /**
         * Registers thumbnail sizes for the plugin.
         *
         * @return void
         */
        public function register()
        {
        }
    }
    class Updater
    {
        /**
         * List of plugin slugs to check for updates.
         *
         * @var array
         */
        private $slugs = array();
        /**
         * API URLs for fetching plugin update data.
         *
         * @var array
         */
        private $data_urls = array();
        /**
         * Initializes the updater by setting plugin slugs and generating API URLs.
         */
        public function __construct()
        {
        }
        /**
         * Checks for plugin updates.
         *
         * @param object $transient The update transient object.
         * @return object Modified transient object with update data.
         */
        public function check($transient)
        {
        }
        /**
         * Retrieves plugin information for the WordPress update system.
         *
         * @param mixed  $result The result object.
         * @param string $action The type of request.
         * @param object $args   Request arguments.
         * @return mixed Plugin information or the original result.
         */
        public function get_info($result, $action, $args)
        {
        }
        /**
         * When an addon is activated, store its first activation time
         */
        public function set_addon_flag($plugin_file, $network_wide)
        {
        }
    }
    class User_Role
    {
        /**
         * Registers custom user roles.
         *
         * @return void
         */
        public function register()
        {
        }
    }
}
namespace EasyCommerce\Bootstrap {
    class Initializer
    {
        /**
         * Initializes the plugin's components.
         *
         * @return void
         */
        public static function initialize()
        {
        }
        /**
         * Loads configuration files for the plugin.
         *
         * @return void
         */
        public function load_config()
        {
        }
        /**
         * Initializes controllers for wp-admin.
         *
         * @return void
         */
        private function load_admin_controllers()
        {
        }
        /**
         * Initializes controllers for public-facing parts of the site.
         *
         * @return void
         */
        private function load_public_controllers()
        {
        }
        /**
         * Initializes controllers that operate on both admin and public interfaces.
         *
         * @return void
         */
        private function load_common_controllers()
        {
        }
        private function load_payment_controllers()
        {
        }
    }
    class Installer
    {
        use \EasyCommerce\Traits\Queue;
        /**
         * Runs the installation routines.
         *
         * @return void
         */
        public static function install()
        {
        }
        public function setup_wizard_redirect($plugin)
        {
        }
        /**
         * Seeds sensible defaults on a fresh install so the store is usable
         * even when the setup wizard is skipped.
         *
         * Each value is only written if the slot is currently empty, so existing
         * data is never overwritten (e.g. on upgrades or re-activations).
         *
         * @return void
         */
        private function setup_defaults()
        {
        }
        /**
         * Prepares the plugin settings and configurations.
         *
         * @return void
         */
        public function prepare()
        {
        }
        /**
         * Seeds Cash on Delivery as an active payment method on fresh install.
         *
         * @return void
         */
        protected function seed_default_payment_methods()
        {
        }
        /**
         * Sets up scheduled tasks for the plugin.
         *
         * @return void
         */
        public function set_cron()
        {
        }
        /**
         * Checks if the database is up to date.
         *
         * @return bool True if the database is up to date, false otherwise.
         */
        protected function is_database_up_to_date()
        {
        }
        /**
         * Creates database tables from the configuration file.
         *
         * @return void
         */
        protected function create_tables()
        {
        }
        /**
         * Updates existing database tables to match the current schema.
         *
         * @return void
         */
        protected function update_existing_tables()
        {
        }
        /**
         * Handles data migration for the coupons table during schema updates.
         *
         * This method migrates legacy columns ('discount_type' to 'type', 'amount' to 'offer')
         * by adding new columns, copying data, and dropping legacy ones.
         *
         * @param \EasyCommerce\Models\Database $db              Database instance.
         * @param string   $table_full_name Full table name with prefix.
         * @param array    $columns         Current column definitions from config.
         * @param array    $options         Current table options from config.
         *
         * @return void
         */
        public function handle_coupons_data_migration(\EasyCommerce\Models\Database $db, string $table_full_name, array $columns, array $options)
        {
        }
        /**
         * Handles schema migration for the cart_sessions table during schema updates.
         *
         * Adds the `payment_initiated` value to the `status` ENUM on existing installs.
         * dbDelta does not reliably ALTER ENUM definitions on existing columns, so the
         * change is applied explicitly here. Without it, the payment lock silently fails
         * because MySQL coerces the unknown ENUM value to an empty string.
         *
         * @param \EasyCommerce\Models\Database $db              Database instance.
         * @param string   $table_full_name Full table name with prefix.
         * @param array    $columns         Current column definitions from config.
         * @param array    $options         Current table options from config.
         *
         * @return void
         */
        public function handle_cart_sessions_data_migration(\EasyCommerce\Models\Database $db, string $table_full_name, array $columns, array $options)
        {
        }
        /**
         * Migrates the Stripe customer id from the legacy `_stripe_customer_id` user-meta
         * key to the canonical `stripe_customer_id` so existing customers are reused after
         * the PaymentIntent helper was standardized onto the canonical key.
         *
         * @return void
         */
        public function migrate_stripe_customer_meta()
        {
        }
        /**
         * Handles schema migration for the orders table during schema updates.
         *
         * Adds the `failed` value to the `status` ENUM on existing installs and
         * back-fills any orders whose status was previously coerced to '' (failed
         * payments written before `failed` existed) to `failed`. dbDelta does not
         * reliably alter ENUM definitions on existing columns, so the change is
         * applied explicitly here.
         *
         * @param \EasyCommerce\Models\Database $db              Database instance.
         * @param string   $table_full_name Full table name with prefix.
         * @param array    $columns         Current column definitions from config.
         * @param array    $options         Current table options from config.
         *
         * @return void
         */
        public function handle_orders_data_migration(\EasyCommerce\Models\Database $db, string $table_full_name, array $columns, array $options)
        {
        }
        /**
         * Updates or adds the database version in the options table.
         *
         * @return void
         */
        protected function update_db_version()
        {
        }
    }
    class Uninstaller
    {
        /**
         * Runs the uninstallation routines.
         *
         * @return void
         */
        public static function uninstall()
        {
        }
        /**
         * Removes stored flags and options related to the plugin.
         *
         * @return void
         */
        protected function delete_flags()
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Asset
    {
        /**
         * Registers a script with WordPress.
         *
         * @param string $handle    Script handle.
         * @param string $src       Script source URL.
         * @param array  $deps      Script dependencies.
         * @param string $ver       Script version, defaults to the constant EASYCOMMERCE_VERSION.
         * @param bool   $args      Optional arguments.
         */
        public function register_script($handle, $src, $deps = array(), $ver = null, $args = array())
        {
        }
        /**
         * Enqueues a script in WordPress, registering it first if not already registered.
         *
         * @param string $handle    Script handle.
         * @param string $src       Script source URL.
         * @param array  $deps      Script dependencies.
         * @param string $ver       Script version, defaults to the constant EASYCOMMERCE_VERSION.
         * @param bool   $args      Whether to enqueue the script in the footer.
         */
        public function enqueue_script($handle, $src, $deps = array(), $ver = null, $args = array('in_footer' => true))
        {
        }
        /**
         * Localizes a script in WordPress.
         *
         * @param string $handle Script handle.
         * @param string $object_name Name of the JavaScript object.
         * @param array  $l10n        Data to localize.
         */
        public function localize_script($handle, $object_name, $l10n)
        {
        }
        /**
         * Registers a style with WordPress.
         *
         * @param string $handle Style handle.
         * @param string $src    Style source URL.
         * @param array  $deps   Style dependencies.
         * @param string $ver    Style version, defaults to the constant EASYCOMMERCE_VERSION.
         * @param string $media  Media for which this stylesheet has been defined.
         */
        public function register_style($handle, $src, $deps = array(), $ver = null, $media = 'all')
        {
        }
        /**
         * Enqueues a style in WordPress, registering it first if not already registered.
         *
         * @param string $handle Style handle.
         * @param string $src    Style source URL.
         * @param array  $deps   Style dependencies.
         * @param string $ver    Style version, defaults to the constant EASYCOMMERCE_VERSION.
         * @param string $media  Media for which this stylesheet has been defined.
         */
        public function enqueue_style($handle, $src, $deps = array(), $ver = null, $media = 'all')
        {
        }
        /**
         * Retrieves the correct version for enqueued assets.
         *
         * If WP_DEBUG is enabled, returns the current timestamp for cache busting.
         * Otherwise, returns the specified version or the EASYCOMMERCE_VERSION constant if no version is provided.
         *
         * @param string|null $version Optional. The version number to return. Default is null.
         *
         * @return string The version number for the asset.
         */
        private function get_ver($version = null)
        {
        }
    }
}
namespace EasyCommerce\Controllers\Admin {
    class Init
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        use \EasyCommerce\Traits\Cache;
        use \EasyCommerce\Traits\Queue;
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * Handles the AI activation magic link from the token email.
         *
         * The link lands in wp-admin carrying the one-time token + email. It does not
         * authenticate anyone - it only works inside an already-authenticated admin
         * session (capability check below), then verifies the token against the
         * EasyCommerce store and persists the connection exactly like the manual
         * copy-paste flow ( {@see \EasyCommerce\API\Connectivity::verify_token} ).
         *
         * @return void
         */
        public function connect_via_magic_link()
        {
        }
        /**
         * Adds custom body class to the admin area.
         *
         * @param string $classes Existing body classes.
         *
         * @return string Modified body classes with 'easycommerce' class added if conditions met.
         */
        public function add_body_class($classes)
        {
        }
        /**
         * Schedules the locations database download when manually retried
         * via the "Retry Download" notice button.
         */
        public function handle_locations_db_retry()
        {
        }
        /**
         * Handles secure file downloads for customers.
         */
        public function secure_download()
        {
        }
        public function show_plugin_notice($plugin_file)
        {
        }
        public function add_page_labels($post_states, $post)
        {
        }
        /**
         * Force using block editor even if the Classic Editor plugin is activated
         *
         * @since 0.9.18-beta
         */
        public function force_block_editor($use_block_editor, $post)
        {
        }
        /**
         * Register the email-placeholders TinyMCE plugin as a real script handle.
         *
         * TinyMCE pulls the file in through `mce_external_plugins`, which never goes
         * through wp_enqueue_script() - so wp_set_script_translations() never ran for
         * it and its __() strings always rendered in English. Enqueueing it as a
         * normal handle (after `wp-tinymce`, so `tinymce` is defined) prints the
         * locale data and self-registers the plugin with TinyMCE's PluginManager;
         * TinyMCE then skips its own fetch because the plugin is already in its
         * lookup table, so the external-plugin registration keeps working untouched.
         *
         * @return void
         */
        public function enqueue_email_placeholders_script(): void
        {
        }
        /**
         * Initialize the TinyMCE plugin and button
         */
        public function tinymce_dropdown_init(): void
        {
        }
        /**
         * Add TinyMCE plugin
         */
        public function add_tinymce_dropdown_plugin(array $plugin_array): array
        {
        }
        /**
         * Add button to TinyMCE toolbar
         */
        public function register_tinymce_dropdown_button(array $buttons): array
        {
        }
        /**
         * Add migration button in the admin secondary top bar
         */
        public function add_migration_btn_in_admin_bar()
        {
        }
        /**
         * Add migration popup for installing 'Migration Addon'
         */
        public function add_migration_popup()
        {
        }
        /**
         * Load HelpWP chat widget on all EasyCommerce admin pages.
         */
        public function add_ai_assistant()
        {
        }
        /*
         * Intercept theme query to show custom themes
         */
        public function intercept_theme_query()
        {
        }
        /**
         * Handles data migration for the cart sessions table on admin_init.
         * Adds missing columns introduced in newer versions.
         *
         * @return void
         * @todo remove it in future
         */
        public function handle_cart_sessions_migration()
        {
        }
        /**
         * Truncates the local ec_ai_logs table (Settings > AI > Usage > Reset Logs).
         *
         * This only clears the per-action usage history rows; it has no effect on
         * the hub's authoritative monthly credit ledger (easycommerce_ai_status()).
         *
         * @return void
         */
        public function reset_ai_logs()
        {
        }
    }
}
namespace EasyCommerce\Traits {
    /**
     * Trait Menu
     *
     * This trait provides methods to add menu and submenu pages in the WordPress admin dashboard.
     *
     * @package EasyCommerce
     */
    trait Menu
    {
        /**
         * Add a menu page to the WordPress admin dashboard.
         *
         * @param string   $page_title The text to be displayed in the title tags of the page when the menu is selected.
         * @param string   $menu_title The text to be used for the menu.
         * @param string   $capability The capability required for this menu to be displayed to the user.
         * @param string   $menu_slug  The slug name to refer to this menu by (should be unique for this menu).
         * @param callable $callback   Optional. The function to be called to output the content for this page.
         * @param string   $icon_url   Optional. The URL to the icon to be used for this menu.
         * @param int      $position   Optional. The position in the menu order this item should appear.
         */
        public function add_menu($page_title, $menu_title, $capability, $menu_slug, $callback = '', $icon_url = '', $position = null)
        {
        }
        /**
         * Add a submenu page to a parent menu in the WordPress admin dashboard.
         *
         * @param string   $parent_slug The slug name for the parent menu (or the file name of a standard WordPress admin page).
         * @param string   $page_title  The text to be displayed in the title tags of the page when the submenu is selected.
         * @param string   $menu_title  The text to be used for the submenu.
         * @param string   $capability  The capability required for this menu to be displayed to the user.
         * @param string   $menu_slug   The slug name to refer to this submenu by (should be unique for this submenu).
         * @param callable $callback    Optional. The function to be called to output the content for this page.
         * @param int      $position    Optional. The position in the menu order this item should appear.
         */
        public function add_submenu($parent_slug, $page_title, $menu_title, $capability, $menu_slug, $callback = '', $position = null)
        {
        }
    }
}
namespace EasyCommerce\Controllers\Admin {
    class Menu
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        use \EasyCommerce\Traits\Menu;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        public function register()
        {
        }
        public function hide_menu()
        {
        }
        public function render_settings()
        {
        }
        public function add_action_links($actions)
        {
        }
        public function survey_popup()
        {
        }
    }
}
namespace EasyCommerce\Controllers\Common {
    class API
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Auth;
        use \EasyCommerce\Traits\Rest;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * Register all API endpoints
         */
        public function register_endpoints()
        {
        }
        /**
         * Register Auth-related API endpoints
         */
        private function register_connectivity_endpoints()
        {
        }
        /**
         * Register Addon-related API endpoints
         */
        private function register_addon_endpoints()
        {
        }
        /**
         * Register Dashboard-related API endpoints
         */
        private function register_dashboard_endpoints()
        {
        }
        /**
         * Register Reports-related API endpoints
         */
        private function register_reports_endpoints()
        {
        }
        /**
         * Register Option-related API endpoints
         */
        private function register_option_endpoints()
        {
        }
        /**
         * Register Attribute-related API endpoints
         */
        private function register_attribute_endpoints()
        {
        }
        /**
         * Register Product-related API endpoints
         */
        private function register_product_endpoints()
        {
        }
        /**
         * Register Product Review-related API endpoints
         */
        private function register_product_review_endpoints()
        {
        }
        /**
         * Register Customer-related API endpoints
         */
        private function register_customer_endpoints()
        {
        }
        /**
         * Register Profile-related API endpoints
         */
        private function register_profile_endpoints()
        {
        }
        /**
         * Register Taxonomy-related API endpoints
         */
        private function register_taxonomy_endpoints()
        {
        }
        /**
         * Register Cart-related API endpoints
         */
        private function register_cart_endpoints()
        {
        }
        /**
         * Register Order-related API endpoints
         */
        private function register_order_endpoints()
        {
        }
        /**
         * Register Transaction-related API endpoints
         */
        private function register_transaction_endpoints()
        {
        }
        /**
         * Register Shipping Plan-related API endpoints
         */
        private function register_shipping_plan_endpoints()
        {
        }
        /**
         * Register Geo-related API endpoints
         */
        private function register_location_endpoints()
        {
        }
        /**
         * Register Coupon-related API endpoints
         */
        private function register_coupon_endpoints()
        {
        }
        /**
         * Register Unified Tax API endpoints.
         */
        private function register_tax_endpoints()
        {
        }
        /**
         * Register Abandoned Carts API endpoints.
         */
        private function register_abandoned_cart_endpoints()
        {
        }
        /**
         * Register AI API endpoints.
         */
        private function register_ai_endpoints()
        {
        }
        /**
         * Register AI Assistant endpoint (customer-facing).
         */
        private function register_agent_assistant_endpoints()
        {
        }
        /**
         * Register AI Copilot endpoint (admin only).
         */
        private function register_agent_copilot_endpoints()
        {
        }
        /**
         * Register Email Placeholder-related API endpoints
         */
        private function register_email_placeholder_endpoints()
        {
        }
        /**
         * Register Importer-related API endpoints
         */
        private function register_importer_endpoints()
        {
        }
        /**
         * Register Log-related API endpoints
         */
        private function register_log_endpoints()
        {
        }
        /**
         * Register Notice-related API endpoints
         */
        private function register_notice_endpoints()
        {
        }
        /**
         * Register Refund-related API endpoints
         */
        private function register_refund_endpoints()
        {
        }
    }
    class Asset
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * Front-end assets for the store patterns (#3175 — theme compatibility).
         *
         * Block themes render the patterns from theme.json tokens as-is. Classic
         * themes additionally get store-patterns.css — a self-contained, `.ec-pattern`
         * scoped fallback for spacing, full-width alignment and colour presets. The
         * applied design's colour/typography preset is layered on both via inline CSS.
         *
         * Only loads on pages that actually contain a store pattern.
         */
        public function add_pattern_assets()
        {
        }
        /**
         * Mirror the applied design's token system inside the block editor canvas,
         * so editing a store page previews its real design (radius, elevation,
         * spacing rhythm, buttons) rather than the theme's bare block defaults.
         *
         * Scoped under `.editor-styles-wrapper` so it only styles the canvas, and
         * still only bites on `.ec-pattern` elements — inert unless a store pattern
         * is present. Card rules are frontend-only (the grid block renders a
         * placeholder in the editor), which is harmless.
         */
        public function add_pattern_editor_styles()
        {
        }
        /**
         * Register JS translations for an EasyCommerce React SPA bundle.
         *
         * Points at the plugin's own languages/ directory, where the shipped
         * easycommerce-{locale}-{md5}.json files live, so the bundle's __() strings
         * load translations instead of always rendering in English. Without the
         * explicit path WordPress only looks in the global WP languages directory.
         *
         * @param string $handle Registered/enqueued script handle.
         * @return void
         */
        private function set_spa_translations($handle)
        {
        }
        /**
         * Enqueue block assets.
         *
         * Editor: always load so EC blocks can be inserted/previewed in any post
         * type.  Front-end: skip the 1+ MB bundle on pages that have no EC blocks
         * (fixes a site-wide performance regression — see GitHub issue #3083).
         */
        public function enqueue_block_assets()
        {
        }
        /**
         * Enqueue block editor only assets.
         */
        public function enqueue_block_editor_assets()
        {
        }
        /**
         * Whether the current public request needs the shared EasyCommerce frontend
         * bundle (Tailwind + plugin common CSS/JS).
         *
         * Loading the bundle site-wide injects Tailwind's preflight reset onto every
         * page, including the theme's own (non-EasyCommerce) pages. This limits it to
         * pages that actually render EasyCommerce content:
         *   - the product CPT (single + archive),
         *   - any singular page/post containing an EasyCommerce block or shortcode,
         *   - any page when the AI shopping agent chatbot is enabled (shown site-wide).
         *
         * Block themes can place EasyCommerce blocks inside templates/template parts
         * (not the post content), which this cannot detect - the
         * `easycommerce_load_storefront_assets` filter is the escape hatch for that.
         *
         * @param \WP_Post|null $post The queried post, if any.
         * @return bool
         */
        private function is_storefront_context($post)
        {
        }
        public function add_assets()
        {
        }
    }
    class Block
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        public $categories = array();
        public $pattern_categories = array();
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        public function register()
        {
        }
        /**
         * Register custom block categories.
         *
         * @param array $categories Existing block categories.
         * @return array Updated block categories.
         */
        public function register_category($categories)
        {
        }
        /**
         * Registers patterns
         */
        public function register_patterns()
        {
        }
        /**
         * Register the store pattern library (section + page patterns).
         *
         * Each file under views/patterns/store/ defines a $pattern_meta array
         * (title/description/categories/keywords/blockTypes/viewportWidth) and
         * echoes its block markup. The markup is captured via output buffering,
         * so pattern copy can be translated inline.
         */
        public function register_store_patterns()
        {
        }
        /**
         * Registers pattern categories
         */
        public function register_pattern_categories()
        {
        }
    }
    class Email
    {
        use \EasyCommerce\Traits\Hook;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * The sender
         */
        public function shoot($recipient, $subject, $body, $placeholders = array())
        {
        }
        public function remind_password_reset($user_id, \EasyCommerce\Abstracts\User $user)
        {
        }
        public function order_email($event, $order_id)
        {
        }
        public function send_abandoned_reminder($hash)
        {
        }
    }
    class Init
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        use \EasyCommerce\Traits\Cache;
        use \EasyCommerce\Traits\Cleaner;
        use \EasyCommerce\Traits\Queue;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        public function invalidate_cache()
        {
        }
        /**
         * Handle the easycommerce_clear_cache action by delegating to the
         * appropriate Reports cache purge for the given scope.
         *
         * @param string $scope Cache scope to clear. Defaults to 'all'.
         * @param mixed  $arg   Optional scope argument (e.g. product ID for 'single_product').
         */
        public function handle_clear_cache($scope = 'all', $arg = null)
        {
        }
        /**
         * Custom capability mapping for EasyCommerce features
         * This allows editors to access certain store features
         */
        public function map_meta_cap($caps, $cap, $user_id)
        {
        }
        public function migrate_old_block_names()
        {
        }
        public function modal()
        {
        }
        public function auto_login()
        {
        }
        public function edit_product_link($link, $post_id, $context)
        {
        }
        public function add_admin_bar_menu()
        {
        }
        public function restrict_media_access($query)
        {
        }
        /**
         * Add a log entry to the database.
         *
         * This method is hooked to the 'easycommerce_log' action and handles logging
         * various activities within the e-commerce system such as order creation,
         * product updates, coupon usage, etc.
         *
         * @param array $data Log data array with the following keys:
         *   - object (string, required): The object type being logged ('order', 'product', 'coupon', etc.)
         *   - action (string, required): The action performed ('created', 'updated', 'deleted', etc.)
         *   - object_id (int, required): The ID of the object being logged
         *   - user_id (int, optional): User ID who performed the action. Defaults to current user
         *   - note (string, optional): Additional notes or description of the action
         *   - ip_address (string, optional): IP address of the client. Auto-detected if not provided
         *   - type (string, optional): Log level/type ('info', 'warning', 'error'). Defaults to 'info'
         *   - meta (string|array, optional): Additional meta. Can be JSON string or array (will be JSON encoded)
         *
         * @return bool|int Log ID on success, false on failure or validation error.
         *
         * @example
         * do_action( 'easycommerce_log', array(
         *     'object'    => 'order',
         *     'action'    => 'created',
         *     'object_id' => 123,
         *     'note'      => 'Order placed via checkout',
         *     'type'      => 'info',
         *     'meta'  	   => array('amount' => 99.99, 'currency' => 'USD')
         * ) );
         */
        public function add_log($data)
        {
        }
        public function add_notices()
        {
        }
        /**
         * Register EasyCommerce Full Width page template
         *
         * @param array $templates Existing page templates.
         * @return array Modified page templates.
         */
        public function register_full_width_template($templates)
        {
        }
        /**
         * Load EasyCommerce Full Width page template from plugin
         *
         * @param string $template Current template path.
         * @return string Modified template path.
         */
        public function load_full_width_template($template)
        {
        }
        /**
         * Add Store Mode badge to admin bar.
         *
         * @param WP_Admin_Bar $wp_admin_bar Admin bar instance.
         */
        public function add_store_mode_admin_bar()
        {
        }
        /**
         * Show an "AI Credits: used/limit" badge at the top-right of the admin bar,
         * left of the Howdy menu, linking to the AI usage screen.
         *
         * Reads the locally cached credit state only (no hub call on page load); the
         * numbers refresh on AI usage and when the usage screen is opened.
         *
         * @param \WP_Admin_Bar $wp_admin_bar
         */
        public function add_ai_credits_admin_bar($wp_admin_bar)
        {
        }
        public function output_admin_bar_css()
        {
        }
    }
    class Process
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        use \EasyCommerce\Traits\Cache;
        use \EasyCommerce\Traits\Queue;
        use \EasyCommerce\Traits\Cleaner;
        use \EasyCommerce\Traits\Rest;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * Registers custom WP-Cron recurrence intervals.
         */
        public function register_cron_intervals($schedules)
        {
        }
        /**
         * Keeps the abandoned-cart auto-send cron in sync with the setting.
         * Schedules every 5 minutes when enabled; unschedules when disabled.
         */
        public function sync_abandoned_cart_cron()
        {
        }
        /**
         * Cron callback: sends a reminder to every pending abandoned cart that has not yet received one.
         */
        public function send_abandoned_cart_reminders()
        {
        }
        /**
         * Cron callback: creates the core store pages in the background right after
         * install. Idempotent — reuses existing pages, so it is a no-op once the
         * pages exist (e.g. after the setup wizard already created them).
         */
        public function create_store_pages()
        {
        }
        public function process_import_batch($import_id, $offset)
        {
        }
        public function import_sample_products()
        {
        }
        /**
         * Downloads the `locations.json` database file from the CDN.
         *
         * Retries up to 5 times with exponential backoff (60 s, 120 s, 240 s, 480 s, 960 s).
         * Validates the HTTP response code and JSON structure before persisting.
         */
        public function download_geo_db()
        {
        }
        public function handle_addon_installation($slug)
        {
        }
    }
}
namespace EasyCommerce\Controllers\Front {
    class Init
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        public function add_body_class($classes)
        {
        }
        public function add_to_cart()
        {
        }
        /**
         * Processes the [easycommerce-checkout] shortcode in the current post.
         *
         * If the shortcode includes a "products" attribute, parses its comma-separated list
         * of products. Each product should be in the format: product_id|price_id|quantity.
         * - product_id is required.
         * - price_id is optional (default: 1).
         * - quantity is optional (default: 1).
         *
         * Examples:
         *   products="9"
         *       -> Adds product ID 9 with default price_id (1) and quantity (1).
         *   products="9|2|4"
         *       -> Adds product ID 9 with price ID 2 and quantity 4.
         *   products="9,10|3,11|2|5"
         *       -> Processes multiple products:
         *           - Product ID 9 with defaults,
         *           - Product ID 10 with price ID 3 and default quantity,
         *           - Product ID 11 with price ID 2 and quantity 5.
         *
         * For each product, if it already exists in the cart, its quantity is updated;
         * otherwise, the product is added to the cart.
         *
         * @param object $cart The cart instance to update.
         *
         * @return void
         */
        public function parse_shortcode_params($cart)
        {
        }
        /**
         * If the cart is empty, return to the shop page
         */
        public function empty_cart_redirect()
        {
        }
        /**
         * Restore the cart from a hash
         */
        public function restore_cart()
        {
        }
        public function product_head()
        {
        }
        public function smart_search($result, $filters, $request)
        {
        }
        /**
         * Check if required elements are present on setup wizard pages
         */
        public function check_required_elements($content)
        {
        }
        /**
         * Show notices
         */
        public function show_notices()
        {
        }
        /**
         * Show an admin-only banner on the storefront when the store is in Test mode.
         *
         * Admins are exempt from the Test-mode checkout/dashboard gate, so the storefront
         * looks live to them while real customers are silently blocked at checkout. This
         * banner closes that awareness gap. Hooked to wp_body_open (primary) with a
         * wp_footer fallback for themes that don't fire wp_body_open; a static guard
         * prevents duplicate output when a theme fires both.
         */
        public function show_test_mode_banner()
        {
        }
    }
    class Shortcode
    {
        use \EasyCommerce\Traits\Hook;
        use \EasyCommerce\Traits\Asset;
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        /**
         * Markup for the React auth SPA mount point.
         *
         * The login/registration/reset-password screens are rendered by the React
         * `auth` bundle which mounts into this container. The initial screen is
         * passed via data-screen so a directly-loaded shortcode page still opens on
         * the expected screen; in-app navigation is handled by the hash router.
         *
         * @param string $screen One of `login`, `register`, `reset`.
         * @return string
         */
        private function auth_container($screen = 'login')
        {
        }
        /**
         * Panel shown when a logged-in user lands on an auth screen.
         */
        private function already_logged_in($title, $message)
        {
        }
        public function reset_password()
        {
        }
        public function login()
        {
        }
        public function register()
        {
        }
        /**
         * Render the checkout, dispatching to the template chosen in settings.
         *
         * The active template comes from Settings -> Checkout ("checkout_template").
         * Note that template-2 is the intentionally compact checkout: it collects
         * only name, email and country and does not gather a full shipping/billing
         * address (see views/shortcodes/checkout/template-2.php). That is by design
         * for low-friction / digital-goods stores, not a missing-address bug.
         */
        public function checkout($atts)
        {
        }
        public function dashboard($atts)
        {
        }
        public function payment()
        {
        }
    }
    class Template
    {
        use \EasyCommerce\Traits\Hook;
        /**
         * Constructor to add all hooks.
         */
        public function __construct()
        {
        }
        public function override_template($template)
        {
        }
        public function show_product_archive()
        {
        }
        public function show_product_archive_loop()
        {
        }
        public function show_product_archive_pagination()
        {
        }
        public function show_single_product()
        {
        }
        public function show_thumbnail()
        {
        }
        public function show_gallery()
        {
        }
        public function show_stock()
        {
        }
        public function show_title()
        {
        }
        public function show_rating()
        {
        }
        public function show_price()
        {
        }
        public function show_attributes()
        {
        }
        public function show_sale_price()
        {
        }
        public function show_add_to_cart()
        {
        }
        public function show_product_tab()
        {
        }
        public function show_product_description()
        {
        }
        public function show_product_summary()
        {
        }
        public function show_product_review()
        {
        }
        public function show_excerpt()
        {
        }
        public function show_shop_products($settings, $products, $shop_name, $view)
        {
        }
        private function render_checkout_template(string $path, array $args = [])
        {
        }
        public function show_billing($cart_obj)
        {
        }
        public function show_shipping($cart_obj)
        {
        }
        public function show_items($cart)
        {
        }
        public function show_summary($cart, $cart_obj)
        {
        }
        public function show_payment_methods($cart_obj)
        {
        }
    }
}
namespace EasyCommerce\Controllers\Payment\Stripe\API {
    class Payment_Intent
    {
        use \EasyCommerce\Traits\Rest;
        protected $api_client;
        protected $payment_methods_helper;
        public function __construct()
        {
        }
        /**
         * Get or create a Stripe customer for the current user.
         *
         * @return string|\WP_Error Customer ID or error.
         */
        protected function get_or_create_customer()
        {
        }
        /**
         * Prepare metadata for Stripe.
         *
         * @param array  $cart Cart data.
         * @param string $customer_email Customer email.
         *
         * @return array Metadata array.
         */
        protected function prepare_metadata($cart, $customer_email)
        {
        }
        /**
         * Create a Payment Intent OR Setup Intent based on cart contents.
         *
         * @param \WP_REST_Request $request The REST request.
         *
         * @return array|\WP_Error The intent data or error.
         */
        public function create(\WP_REST_Request $request)
        {
        }
        /**
         * Update Payment Intent or SetupIntent with current cart amount.
         *
         * @param \WP_REST_Request $request The REST request.
         *
         * @return array|\WP_Error The update result or error.
         */
        public function update(\WP_REST_Request $request)
        {
        }
    }
    class Webhook
    {
        use \EasyCommerce\Traits\Rest;
        /**
         * Order-meta keys that bind a Stripe payment intent to an order.
         *
         * `stripe_payment_intent_id` is written by the synchronous checkout flow
         * (Stripe.php); `_ec_pending_stripe_intent_id` is written by the order-pay
         * flow (Payment_Intent.php). Either can resolve an inbound webhook to its order.
         *
         * @var string[]
         */
        private const INTENT_ORDER_META_KEYS = array('stripe_payment_intent_id', '_ec_pending_stripe_intent_id');
        /**
         * Prefix for the per-event dedup mark stored on the order.
         *
         * @var string
         */
        private const PROCESSED_META_PREFIX = '_ec_processed_evt_';
        /**
         * Prefix for the MySQL advisory lock that serialises same-event deliveries.
         *
         * @var string
         */
        private const LOCK_PREFIX = 'ec_stripe_evt_';
        /**
         * Seconds to wait for the advisory lock before giving up (Stripe then retries).
         *
         * @var int
         */
        private const LOCK_TIMEOUT = 5;
        /**
         * Validates the incoming request to ensure it is a legitimate webhook event from Stripe.
         * It checks for the presence of required parameters and verifies the request signature.
         *
         * @see https://docs.stripe.com/webhooks?snapshot-or-thin=thin#verify-webhook-signatures-with-official-libraries
         *
         * @param \WP_REST_Request $request The incoming REST request to validate.
         *
         * @return \Stripe\Event|\WP_Error
         */
        public function validate_request(\WP_REST_Request $request)
        {
        }
        /**
         * Listen to webhook events.
         *
         * @see https://docs.stripe.com/webhooks#webhook-endpoint-def
         *
         * @return void
         */
        public function listen(\WP_REST_Request $request)
        {
        }
        /**
         * Process a payment_intent.* event idempotently.
         *
         * Serialises concurrent deliveries of the same event on a MySQL advisory
         * lock, then dedups on an order-meta mark so a replayed webhook cannot
         * re-run the completion path. The event is recorded as processed only
         * after the completion path succeeds, so a mid-processing failure lets
         * Stripe retry cleanly.
         *
         * @param \Stripe\Event|object $event The Stripe event object.
         *
         * @return array{code:int,message:string,processed:bool} HTTP code + whether the completion path ran this call.
         */
        public function process_event($event)
        {
        }
        /**
         * Resolve the order bound to a Stripe payment intent.
         *
         * Reverse-looks-up order meta on the intent id (the intent's own Stripe
         * metadata does not carry the order id).
         *
         * @param object $payment_intent The Stripe payment intent object (needs ->id).
         *
         * @return \EasyCommerce\Models\Order|null The bound order, or null when none is resolvable.
         */
        public function resolve_order_from_intent($payment_intent)
        {
        }
        /**
         * Dispatch the event to its completion handler (fires the completion action).
         *
         * @param \Stripe\Event|object $event The Stripe event object.
         *
         * @return void
         */
        private function dispatch_event($event)
        {
        }
        /**
         * Build the advisory-lock name for an event, bounded to MySQL's 64-char limit.
         *
         * Standard Stripe event ids keep the readable `ec_stripe_evt_{id}` form; an
         * over-long id (which would otherwise error GET_LOCK and 503 forever) falls
         * back to a hashed, fixed-width name.
         *
         * @param string $event_id The Stripe event id.
         *
         * @return string
         */
        private function lock_name($event_id)
        {
        }
        /**
         * Acquire a MySQL advisory lock scoped to this DB connection.
         *
         * @param string $lock_name The lock name.
         * @param int    $timeout   Seconds to wait.
         *
         * @return bool True if the lock was acquired.
         */
        private function acquire_lock($lock_name, $timeout = self::LOCK_TIMEOUT)
        {
        }
        /**
         * Release a previously acquired advisory lock.
         *
         * @param string $lock_name The lock name.
         *
         * @return void
         */
        private function release_lock($lock_name)
        {
        }
        /**
         * Handle successful payment intent (fires the completion action).
         *
         * @param \Stripe\Event $event The event object.
         *
         * @return void
         */
        public function payment_intent_succeeded($event)
        {
        }
        /**
         * Handle failed payment intent (fires the completion action).
         *
         * @param \Stripe\Event $event The event object.
         *
         * @return void
         */
        public function payment_intent_failed($event)
        {
        }
    }
}
namespace EasyCommerce\Controllers\Payment\Stripe\Helpers {
    class Payment_Methods
    {
        protected $api_client;
        protected array $payment_method_configs = array();
        protected string $cache_key = 'easycommerce_stripe_payment_methods_cache';
        protected string $pmc_id_cache_key = 'easycommerce_stripe_default_pmc_id';
        public function __construct()
        {
        }
        /**
         * Force sync payment methods from Stripe API and save to database
         *
         * @return void
         */
        public function force_sync_payment_methods(): void
        {
        }
        /**
         * Find the account's default payment method configuration.
         *
         * Stripe uses this configuration for any PaymentIntent that does not name a
         * specific one, so it is the single source of truth for what shows at
         * checkout. Per Stripe's API, the account default is uniquely identified by
         * `parent === null` (a top-level config, not a child) AND `is_default === true`.
         * Stripe guarantees exactly one such configuration per account/mode.
         *
         * `name` is a user-editable label and is deliberately NOT matched on — a
         * renamed default, or an unrelated config coincidentally named "Default",
         * must not change the result.
         *
         * The list is auto-paginated, so the default is found even when the account
         * has more configurations than fit in a single API page.
         *
         * @return \Stripe\PaymentMethodConfiguration|null The account default, or null if none/error.
         */
        private function get_account_default_pmc()
        {
        }
        /**
         * Fetch payment methods directly from Stripe API
         *
         * @return array Array of payment method data
         */
        private function fetch_payment_methods_from_api(): array
        {
        }
        /**
         * Gets enabled payment methods from Stripe's default configuration.
         *
         * @return array Array of enabled payment method types.
         */
        public function get_enabled_payment_methods(): array
        {
        }
        /**
         * Get the id of the default Stripe payment method configuration in use.
         *
         * Returns the cached id, syncing from the Stripe API if not yet cached.
         * Used to deep-link the admin settings to the exact configuration that
         * supplies the checkout payment methods.
         *
         * @return string The default PMC id (pmc_...), or empty string if unavailable.
         */
        public function get_default_pmc_id(): string
        {
        }
        /**
         * Gets a human-readable label for a payment method type.
         *
         * @param string $method_type The payment method type.
         *
         * @return string The human-readable label.
         */
        private function get_payment_method_label(string $method_type): string
        {
        }
        /**
         * Get all available payment methods from Stripe's default configuration
         *
         * @return array Array of payment method data
         */
        public function get_all_available_payment_methods(): array
        {
        }
        /**
         * Get all possible payment method labels
         *
         * @return array Array of payment method labels
         */
        private function get_all_payment_method_labels(): array
        {
        }
    }
    class Webhook
    {
        protected $api_client;
        protected $events = array(\Stripe\Event::PAYMENT_INTENT_SUCCEEDED, \Stripe\Event::PAYMENT_INTENT_REQUIRES_ACTION, \Stripe\Event::PAYMENT_INTENT_AMOUNT_CAPTURABLE_UPDATED, \Stripe\Event::PAYMENT_INTENT_PAYMENT_FAILED, \Stripe\Event::SETUP_INTENT_SUCCEEDED, \Stripe\Event::SETUP_INTENT_SETUP_FAILED, \Stripe\Event::CHARGE_SUCCEEDED, \Stripe\Event::CHARGE_CAPTURED, \Stripe\Event::CHARGE_FAILED, \Stripe\Event::CHARGE_DISPUTE_CREATED, \Stripe\Event::CHARGE_DISPUTE_CLOSED, \Stripe\Event::BALANCE_AVAILABLE, \Stripe\Event::REVIEW_OPENED, \Stripe\Event::REVIEW_CLOSED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_CREATED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_UPDATED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_DELETED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_PAUSED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_RESUMED, \Stripe\Event::CUSTOMER_SUBSCRIPTION_TRIAL_WILL_END, \Stripe\Event::INVOICE_PAYMENT_SUCCEEDED, \Stripe\Event::INVOICE_PAYMENT_FAILED, \Stripe\Event::INVOICE_PAYMENT_ACTION_REQUIRED, \Stripe\Event::INVOICE_PAID, \Stripe\Event::REFUND_CREATED, \Stripe\Event::ACCOUNT_UPDATED);
        public function __construct()
        {
        }
        /**
         * List of events to register.
         *
         * @return string[]
         */
        public function get_events(): array
        {
        }
        /**
         * Deletes any existing webhook event destination matching the provided URL.
         *
         * @param string $webhook_url The webhook URL to match for deletion.
         *
         * @return void
         * @throws \Stripe\Exception\ApiErrorException If an error occurs during deletion.
         */
        protected function delete_existing_endpoint(string $webhook_url): void
        {
        }
        /**
         * Creates a new event destination in Stripe and updates the signing secret if available.
         *
         * @param string $webhook_url The URL for the new webhook endpoint.
         *
         * @return void
         * @throws \Stripe\Exception\ApiErrorException If an error occurs during creation.
         */
        protected function create_new_endpoint(string $webhook_url): void
        {
        }
        /**
         * Registers a new event destination in the Stripe payment gateway.
         *
         * @see https://docs.stripe.com/webhooks
         * @see https://docs.stripe.com/api/v2/core/event_destinations/create
         *
         * @return void
         */
        public function register()
        {
        }
        /**
         * Deregisters the webhook endpoint from Stripe.
         *
         * @return void
         */
        public function deregister(): void
        {
        }
    }
}
namespace EasyCommerce\Helpers {
    /**
     * Email class to handle email template rendering and sending.
     */
    class Email
    {
        use \EasyCommerce\Traits\Cleaner;
        private $title = '';
        private $header = '';
        private $body = '';
        private $footer = '';
        private $subject = '';
        private $headers = array('Content-Type: text/html; charset=UTF-8');
        private $attachments = array();
        private $recipients = array();
        private $placeholders = array();
        /**
         * Sets the title of the email.
         *
         * @param string $title The title for the email.
         */
        public function set_title($title)
        {
        }
        /**
         * Sets the header of the email.
         *
         * @param string $header The HTML content for the email header section.
         */
        public function set_header($header)
        {
        }
        /**
         * Sets the body of the email.
         *
         * @param string $body The main content for the email body.
         */
        public function set_body($body)
        {
        }
        /**
         * Sets the footer of the email.
         *
         * @param string $footer The content for the email footer.
         */
        public function set_footer($footer)
        {
        }
        /**
         * Gets the header of the email.
         *
         * @return string $header The HTML content for the email header section.
         */
        public function get_header()
        {
        }
        /**
         * Gets the body of the email.
         *
         * @return string $body The HTML content for the email body section.
         */
        public function get_body()
        {
        }
        /**
         * Gets the footer of the email.
         *
         * @param string $footer The HTML content for the email footer section.
         */
        public function get_footer()
        {
        }
        /**
         * Sets the subject of the email.
         *
         * @param string $subject The subject of the email.
         */
        public function set_subject($subject)
        {
        }
        /**
         * Sets the recipient(s) of the email.
         *
         * @param mixed $recipients A single email address or an array of email addresses.
         */
        public function set_recipient($recipients)
        {
        }
        /**
         * Adds a recipient to the email.
         *
         * @param mixed $recipients A single email address or an array of email addresses.
         */
        public function add_recipient($recipients)
        {
        }
        /**
         * Adds a header to the email.
         *
         * @param string $header The header to add.
         */
        public function add_header($header)
        {
        }
        /**
         * Adds an attachment to the email.
         *
         * @param string $attachment The file path of the attachment.
         */
        public function add_attachment($attachment)
        {
        }
        /**
         * Gets the subject of the email.
         *
         * @return string The email subject.
         */
        public function get_subject()
        {
        }
        /**
         * Gets the recipient(s) of the email.
         *
         * @return string A comma-separated string of valid recipients.
         */
        public function get_recipient()
        {
        }
        /**
         * Gets the headers for the email.
         *
         * @return array The headers for the email.
         */
        public function get_headers()
        {
        }
        /**
         * Gets the attachments for the email.
         *
         * @return array The list of attachment file paths.
         */
        public function get_attachments()
        {
        }
        /**
         * Gets the email header content.
         *
         * @return string The header HTML content for the email.
         */
        public function get_header_content()
        {
        }
        /**
         * Gets the email body content.
         *
         * @return string The HTML content for the email body.
         */
        public function get_body_content()
        {
        }
        /**
         * Gets the email footer content.
         *
         * @return string The HTML content for the email footer.
         */
        public function get_footer_content()
        {
        }
        /**
         * Combines and returns the full email content.
         *
         * @return string The complete HTML content of the email.
         */
        public function get_content()
        {
        }
        /**
         * Loads and sets the email template.
         *
         * @param string $template_name The name of the template file (without extension).
         * @param array  $args Optional. Associative array of variables to pass to the template.
         */
        public function set_template($template_name, $args = array())
        {
        }
        /**
         * Sets placeholders for the email content (title, body, footer, and subject).
         *
         * @param array $placeholders Associative array of placeholders and their values.
         */
        public function set_placeholders($placeholders = array())
        {
        }
        public function apply_placeholders($content)
        {
        }
        /**
         * Sends the email.
         *
         * @param string|null $to The recipient email address.
         * @param string      $subject The subject of the email.
         * @param string      $body The body content of the email.
         * @param string      $footer The footer content of the email.
         * @return bool Whether the email was sent successfully.
         */
        public function send($to = null, $subject = '', $body = '', $footer = '')
        {
        }
    }
}
namespace EasyCommerce\Helpers\Field {
    /**
     * Checkbox Field Class
     */
    class Checkbox extends \EasyCommerce\Abstracts\Field
    {
        /**
         * Get the field label.
         *
         * @return string
         */
        public function get_value()
        {
        }
        public function render()
        {
        }
    }
    /**
     * Input Field Class
     */
    class Text extends \EasyCommerce\Abstracts\Field
    {
        public function render()
        {
        }
    }
    /**
     * Color Field Class
     */
    class Color extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * Date Field Class
     */
    class Date extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * WYSIWYG Field Class
     */
    class WYSIWYG extends \EasyCommerce\Abstracts\Field
    {
        /**
         * Renders the WYSIWYG field.
         */
        public function render()
        {
        }
    }
    /**
     * Editor Field Class (an alias of WYSIWYG)
     */
    class Editor extends \EasyCommerce\Helpers\Field\WYSIWYG
    {
    }
    /**
     * Email Field Class
     */
    class Email extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * File Field Class
     */
    class File extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * File Field Class
     */
    class Image extends \EasyCommerce\Helpers\Field\Text
    {
        public function render()
        {
        }
    }
    /**
     * File Field Class
     */
    class Media extends \EasyCommerce\Helpers\Field\Text
    {
        public function render()
        {
        }
    }
    class Multicheck extends \EasyCommerce\Abstracts\Field
    {
        protected $option_type = 'checkbox';
        public function render()
        {
        }
    }
    /**
     * Number Field Class
     */
    class Number extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * Password Field Class
     */
    class Password extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * Radio Field Class
     */
    class Radio extends \EasyCommerce\Helpers\Field\Multicheck
    {
        protected $option_type = 'radio';
        protected function get_input_class(): string
        {
        }
        public function render()
        {
        }
    }
    /**
     * Range Field Class
     */
    class Range extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * Select Field Class
     */
    class Select extends \EasyCommerce\Abstracts\Field
    {
        /**
         * Whether the field allows free-text input alongside the options list.
         *
         * @var bool
         */
        protected $allow_input = false;
        /**
         * Constructor.
         *
         * @param array $config Field configuration.
         */
        public function __construct($config = array())
        {
        }
        /**
         * Whether the field allows free-text input alongside the options list.
         *
         * @return bool
         */
        public function allow_input()
        {
        }
        public function render()
        {
        }
        /**
         * Render the field as a free-text input backed by a datalist.
         *
         * @return string
         */
        protected function render_open_text()
        {
        }
    }
    /**
     * Submit Field Class
     */
    class Submit extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * Switcher Field Class
     */
    class Switcher extends \EasyCommerce\Helpers\Field\Checkbox
    {
        public function render()
        {
        }
    }
    /**
     * Textarea Field Class
     */
    class Textarea extends \EasyCommerce\Abstracts\Field
    {
        public function render()
        {
        }
    }
    /**
     * Time Field Class
     */
    class Time extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
    /**
     * URL Field Class
     */
    class URL extends \EasyCommerce\Helpers\Field\Text
    {
        public function __construct($config = array())
        {
        }
    }
}
namespace EasyCommerce\Helpers {
    /**
     * Utility class with static helper functions for general use throughout the plugin.
     */
    class Utility
    {
        use \EasyCommerce\Traits\Cache;
        /**
         * Retrieves an option from the WordPress database, formatted according to EasyCommerce settings.
         *
         * This function gets an option using a combination of the provided menu, submenu, and key.
         * If the option is not set, a default value is returned.
         *
         * @param string $menu The menu name or key to be used as part of the option name.
         * @param string $submenu The submenu name or key to be used as part of the option name.
         * @param string $key The specific option key to retrieve within the option array.
         * @param mixed  $default Optional. The default value to return if the option key is not set. Default is an empty string.
         *
         * @return mixed The value of the option if it exists, or the default value if it doesn't.
         */
        public static function get_option($menu, $submenu, $key, $default = '')
        {
        }
        /**
         * Set an option value.
         *
         * @param string $menu The menu slug.
         * @param string $submenu The submenu slug.
         * @param string $key The option key.
         * @param mixed  $value The value to set.
         * @return bool True if the option was updated, false otherwise.
         */
        public static function set_option($menu, $submenu, $key, $value)
        {
        }
        /**
         * Formats a date string according to WordPress settings.
         *
         * @param string $date The date string (e.g., 'Y-m-d H:i:s').
         * @param string $format Optional. PHP date format. Defaults to WordPress date format setting.
         * @return string Formatted date string.
         */
        public static function format_date($date, $format = '')
        {
        }
        /**
         * Formats a time string according to WordPress settings.
         *
         * @param string $time The time string (e.g., 'Y-m-d H:i:s').
         * @param string $format Optional. PHP time format. Defaults to 'h:i:s A'.
         * @return string Formatted time string.
         */
        public static function format_time($time, $format = '')
        {
        }
        /**
         * Formats a price
         *
         * @param float $price The price
         * @return string Formatted price string.
         */
        public static function format_price($price)
        {
        }
        /**
         * Logs messages to a specific log file.
         *
         * @param mixed  $message The message to log. If not a string, it will be converted to JSON.
         * @param string $log_file The log file to write to within the wp-content directory.
         */
        public static function log_debug($message, $log_file = 'debug.log')
        {
        }
        /**
         * Error Log
         */
        public static function el($message, $log_file = 'debug.log')
        {
        }
        /**
         * Prints information about a variable in a more readable format.
         *
         * @param mixed $data The variable you want to display.
         * @param bool  $admin_only Should it display in wp-admin area only
         * @param bool  $hide_adminbar Should it hide the admin bar
         */
        public static function pri($data, $admin_only = true, $hide_adminbar = true)
        {
        }
        /**
         * Resolve the file to load for a template, allowing themes and addons to
         * override it.
         *
         * Resolution order:
         *   1. Theme override - wp-content/themes/<active-theme>/easycommerce/<template>
         *   2. Plugin default - <plugin>/views/<template>
         *
         * The result is filterable through `easycommerce_template_path`, so an addon
         * can point any EasyCommerce template at its own file:
         *
         *     add_filter( 'easycommerce_template_path', function ( $path, $template ) {
         *         if ( 'templates/single-product/price.php' === $template ) {
         *             return MY_ADDON_DIR . 'templates/price.php';
         *         }
         *         return $path;
         *     }, 10, 2 );
         *
         * @param string $template Template path relative to the views/ directory.
         * @return string Absolute path to the template that will be loaded.
         */
        public static function get_template_path($template)
        {
        }
        /**
         * Includes a template file from the 'view' directory.
         *
         * Themes and addons can override the file via `easycommerce_template_path`
         * (see get_template_path()), adjust the variables passed in via
         * `easycommerce_template_args`, or filter the rendered output via
         * `easycommerce_template_html`.
         *
         * @param string $template The template file name.
         * @param array  $args Optional. An associative array of variables to pass to the template file.
         */
        public static function get_template($template, $args = array())
        {
        }
        /**
         * @param bool $show_cached either to use a cached list of posts or not. If enabled, make sure to wp_cache_delete() with the `save_post` hook
         */
        public static function get_posts($args = array(), $show_heading = false, $show_cached = false, $key = 'ID')
        {
        }
        public static function create_post($args)
        {
        }
        /**
         * Generates a hash
         */
        public static function generate_hash()
        {
        }
        /**
         * Get date range
         *
         * @param string $range The date range to query.
         * @return array
         */
        public static function get_date_range($range = 'all')
        {
        }
        /**
         * Performs local fuzzy search on product titles using multiple matching strategies.
         *
         * The search uses the following priority order:
         * 1. Exact substring match (case-insensitive)
         * 2. Individual search words found in product title
         * 3. Product title words containing the search term
         * 4. Fuzzy word matching (70%+ similarity via similar_text)
         * 5. Full title fuzzy matching (50%+ similarity)
         * 6. Levenshtein distance algorithm for typo tolerance
         *
         * Results are cached for 6 hours to improve performance.
         *
         * @since 1.21
         *
         * @param string $search The search term to match against product titles.
         * @return string|false   The matching product title on success, or false if no match found.
         */
        public static function get_product_titles(): array
        {
        }
        public static function fuzzy_search($search)
        {
        }
    }
}
namespace EasyCommerce\Models {
    /**
     * Cart Model
     *
     * @package EasyCommerce
     */
    class Cart extends \EasyCommerce\Abstracts\Model
    {
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Cart data
         *
         * @var array
         */
        public $cart;
        /**
         * Cart hash
         *
         * @var string
         */
        protected $hash;
        /**
         * User ID
         *
         * @var int
         */
        protected $user_id = null;
        /**
         * Formatted cart cache
         *
         * @var array|null
         */
        protected $formatted_cart = null;
        protected $table = 'cart_sessions';
        /**
         * Constructor
         *
         * @param string $hash The cart hash.
         */
        public function __construct($hash = null)
        {
        }
        /**
         * Get the user's cart hash.
         *
         * @return string The user's cart hash.
         */
        private function get_user_hash()
        {
        }
        /**
         * Set the user's cart hash.
         *
         * @param string $hash The cart hash.
         * @return string The cart hash.
         */
        public function set_user_hash($hash = '')
        {
        }
        /**
         * Clear the formatted cart cache.
         */
        protected function clear_cache()
        {
        }
        /**
         * Save the cart data to the database.
         */
        public function save()
        {
        }
        /**
         * Load the cart data from the database using the hash.
         *
         * @param string $hash The cart hash.
         */
        public function load_cart_by_hash($hash = null)
        {
        }
        /**
         * Get the items in the cart.
         *
         * @return array The items in the cart.
         */
        public function get_items()
        {
        }
        /**
         * Get the item count in the cart.
         *
         * @return int The item count in the cart.
         */
        public function get_item_count()
        {
        }
        /**
         * Get the selected shipping method ID
         *
         * @return int|bool
         */
        public function get_shipping_method_id()
        {
        }
        /**
         * Get the selected shipping method
         *
         * @return array|null
         */
        public function get_shipping_method()
        {
        }
        /**
         * Get the selected shipping cost
         *
         * @return array|null
         */
        public function get_shipping_cost()
        {
        }
        /**
         * Get the shipping methods in the cart.
         *
         * @return array The shipping methods in the cart.
         */
        public function get_shipping_methods()
        {
        }
        /**
         * Get the tax applicable on the cart items
         *
         * @return float The tax ammount
         */
        public function get_item_tax()
        {
        }
        /**
         * Get the tax applicable on shipping
         *
         * @return float The tax ammount
         */
        public function get_shipping_tax()
        {
        }
        /**
         * Get the tax applicable on shipping
         *
         * @return float The tax ammount
         */
        public function get_tax()
        {
        }
        /**
         * Get the data from the cart.
         *
         * @param string $column The column to get the data from.
         * @return mixed The data from the cart.
         */
        public function get_data($column)
        {
        }
        /**
         * If it's from a logged in user/customer
         * 
         * @return \EasyCommerce\Models\Customer object | false
         */
        public function get_customer()
        {
        }
        /**
         * Get the cart data.
         *
         * @param bool $formatted Whether to format the cart data.
         * @param bool $formatted_price Whether to format the price.
         * @return array The cart data.
         */
        public function get($formatted = false, $formatted_price = true)
        {
        }
        /**
         * Check if the shipping address is the same as the billing address.
         *
         * @return bool
         */
        public function is_shipping_same_as_billing()
        {
        }
        /**
         * Get the payment intent ID for a specific payment method.
         *
         * @param string $method The payment method.
         * @return string|null The payment intent ID or null if not found.
         */
        public function get_payment_intent($method)
        {
        }
        public function get_payment_method()
        {
        }
        /**
         * Set the payment intent ID for a specific payment method.
         *
         * @param string $method The payment method.
         * @param string $payment_intent_id The payment intent ID.
         */
        public function set_payment_intent($method, $payment_intent_id)
        {
        }
        public function clear_payment_intent($method)
        {
        }
        /**
         * Get the customer name from the cart.
         *
         * @return string The customer name.
         */
        public function get_customer_name()
        {
        }
        /**
         * Get the customer email from the cart.
         *
         * @return string The customer email.
         */
        public function get_customer_email()
        {
        }
        /**
         * Get the amounts from the cart.
         *
         * @return array The amounts from the cart.
         */
        public function get_amounts()
        {
        }
        /**
         * Get the amount from the cart.
         *
         * @param string $segment The segment to get the amount from.
         * @return mixed The amount from the cart.
         */
        public function get_amount($segment = 'total')
        {
        }
        /**
         * Get total amount from the cart.
         *
         * @return float The total amount from the cart.
         */
        public function get_total()
        {
        }
        /**
         * Get the quantity from the cart.
         *
         * @return int The quantity from the cart.
         */
        public function get_quantity()
        {
        }
        /**
         * Get the weight from the cart.
         *
         * @return float The weight from the cart.
         */
        public function get_weight()
        {
        }
        /**
         * Adds product data to the cart, now storing more detailed information.
         *
         * @param int       $product_id The ID of the product.
         * @param int|array $price_id The price_id or an associative array of attributes.
         * @param int       $quantity The quantity to add.
         * @param int       $user_id The user ID.
         * @param bool      $is_free Whether this is a free product from coupon.
         */
        public function add($product_id, $price_id = 1, $quantity = 1, $user_id = null, $is_free = false)
        {
        }
        /**
         * Updates a product quantity in the cart.
         *
         * @param int $product_id The ID of the product.
         * @param int $quantity The new quantity to set.
         */
        public function update_qty($product_id, $price_id = 0, $quantity = 1)
        {
        }
        /**
         * Checks if the cart contains a given product_id and price_id
         *
         * @return bool
         */
        public function has_product($product_id, $price_id = 1)
        {
        }
        /**
         * Get the current status of the cart.
         *
         * @return string|null The cart status if found, null if the cart doesn't exist.
         */
        public function get_status()
        {
        }
        /**
         * Check whether the cart is locked for payment processing.
         *
         * @return bool
         */
        public function is_locked()
        {
        }
        /**
         * Get the cart total snapshotted at payment initiation time.
         *
         * @return float|null Null if no snapshot exists.
         */
        public function get_lock_amount()
        {
        }
        /**
         * Lock the cart for payment and snapshot the current total in one DB write.
         *
         * @return float The snapshotted amount.
         */
        public function lock_for_payment(): float
        {
        }
        /**
         * Set the status of the cart.
         *
         * @param string $status The new status for the cart.
         * @return bool True if status is updated, False if failure.
         */
        public function set_status($status)
        {
        }
        /**
         * Check if the cart contains at least 1 item of the given type.
         *
         * @param string $type The type of item to check for (e.g., 'physical').
         * @return bool True if the cart contains an item of the given type, false otherwise.
         */
        public function has_item_type($type = 'physical')
        {
        }
        /**
         * Removes a product from the cart.
         *
         * @param int $product_id The ID of the product to remove.
         * @param int $price_id The price ID. Default 1.
         * @param bool $is_free Whether this is a free product removal.
         */
        public function remove($product_id, $price_id = 1, $is_free = false)
        {
        }
        public function add_coupon($code = null)
        {
        }
        /**
         * Adds fee to the cart
         * 
         * @param array $fee An associative array of `name => amount` pair
         * 
         * @since 0.9.20
         */
        public function add_fee($fee = [])
        {
        }
        /**
         * Empties the cart.
         */
        public function empty()
        {
        }
        /**
         * Remove reference from the user meta or session.
         */
        public function remove_flag()
        {
        }
        /**
         * Reset the cart hash and store the new hash in the database.
         *
         * @return string The new cart hash.
         */
        public function reset()
        {
        }
        /**
         * Completely erase the cart session.
         *
         * @return bool True if the cart session is successfully deleted, false otherwise.
         */
        public function delete()
        {
        }
        /**
         * Get the billing address from the cart.
         *
         * @return array The billing address from the cart.
         */
        public function get_billing_address()
        {
        }
        /**
         * Get the shipping address from the cart.
         *
         * @return array The shipping address from the cart.
         */
        public function get_shipping_address()
        {
        }
        /**
         * Retrieve a specific field from the billing or shipping address.
         *
         * @param string $field The field name to retrieve.
         * @param string $type  The address type ('billing' or 'shipping'). Default is 'billing'.
         * @return string The value of the requested field or an empty string if not set.
         */
        public function get_address_field($field, $type = 'billing')
        {
        }
        public function get_phone($type = 'billing')
        {
        }
        public function get_address_1($type = 'billing')
        {
        }
        public function get_address_2($type = 'billing')
        {
        }
        public function get_country($type = 'billing')
        {
        }
        public function get_state($type = 'billing')
        {
        }
        public function get_city($type = 'billing')
        {
        }
        public function get_postcode($type = 'billing')
        {
        }
        /**
         * Get abandoned carts
         *
         * @param int $period The time delay to consider as abandoned, in minutes. Default is 30 minutes.
         * @return array Array of abandoned carts.
         */
        public function get_abandoned($period, $range = null, $from = null, $to = null)
        {
        }
        /**
         * Retrieves the current cart hash.
         *
         * @return string The cart hash.
         */
        public function get_hash()
        {
        }
        /**
         * Retrieves the current cart link.
         *
         * @return string The cart link.
         */
        public function get_link()
        {
        }
        /**
         * Pre-fill cart data (items + addresses) from external source such as the AI agent.
         * Computes and stores the total from item prices so the cart is ready for checkout.
         *
         * @param array  $items        Items keyed as [ product_id => [ price_id => [ quantity, rate, price ] ] ].
         * @param array  $billing      Billing address fields.
         * @param array  $shipping     Shipping address fields.
         * @param string $coupon_code  Optional coupon code.
         */
        public function prefill(array $items, array $billing, array $shipping, string $coupon_code = ''): void
        {
        }
        /**
         * Handle free products discount (BXGY functionality)
         *
         * @param \EasyCommerce\Models\Coupon $coupon The coupon object
         * @param array $cart_items All cart items
         * @param array $applicable_items Applicable item indices
         * @return float The discount amount
         */
        private function handle_free_products($coupon, $cart_items, $applicable_items)
        {
        }
    }
    /**
     * Class to do operation for abandoned cart
     */
    class Abandoned_Cart extends \EasyCommerce\Models\Cart
    {
        use \EasyCommerce\Traits\Cleaner;
        public function list($search = '', $from_date = '', $to_date = '')
        {
        }
        /**
         * Empties the table by deleting all its entries.
         *
         * @return string Returns:
         *                - 'cleaned' if rows were deleted,
         *                - 'empty' if the table was already empty,
         *                - 'error' if the operation failed.
         */
        public function clean()
        {
        }
        /**
         * Cleans all invalid entries from the abandoned cart.
         *
         * An invalid entry is a row where the 'items' array is empty.
         *
         * @return string Returns:
         *                - 'cleaned' if one or more invalid entries were deleted,
         *                - 'empty' if no invalid entries were found,
         *                - 'error' if the deletion query failed.
         */
        public function clean_invalid()
        {
        }
    }
    /**
     * Class Attribute
     * Handles product attributes operations.
     *
     * @package EasyCommerce\Model
     */
    class Attribute extends \EasyCommerce\Abstracts\Model
    {
        use \EasyCommerce\Traits\Cleaner;
        protected $table = 'attributes';
        /**
         * Add an attribute.
         *
         * @param string $name
         * @param string $slug
         * @return bool
         */
        public function add($name, $type = 'Text', $slug = null)
        {
        }
        /**
         * Get an attribute.
         *
         * @param int $id
         * @return object|null
         */
        public function get($id)
        {
        }
        /**
         * Get an attribute by slug.
         *
         * @param string $slug
         * @return object|null
         */
        public function get_by_slug($slug)
        {
        }
        /**
         * Get all attributes.
         *
         * @return array
         */
        public function get_all($args = array(), $limit = 0, $offset = 0, $order = 'DESC', $orderby = 'id')
        {
        }
        public function count()
        {
        }
        /**
         * Update an attribute.
         *
         * @param int   $id
         * @param array $data
         * @return bool
         */
        public function update($id, $data)
        {
        }
        /**
         * Delete an attribute.
         *
         * @param int $id
         * @return bool
         */
        public function delete($id)
        {
        }
        /**
         * Bulk delete attributes.
         *
         * @param array $ids
         * @return bool
         */
        public function bulk_delete($ids)
        {
        }
    }
    /**
     * Class Attribute_Value
     * Handles attribute values operations.
     *
     * @package EasyCommerce\Model
     */
    class Attribute_Value extends \EasyCommerce\Abstracts\Model
    {
        use \EasyCommerce\Traits\Cleaner;
        protected $table = 'attribute_values';
        /**
         * Add an attribute value.
         *
         * @param int    $attribute_id
         * @param string $name
         * @param string $slug
         * @return bool
         */
        public function add($attribute_id, $name, $value = null, $slug = null)
        {
        }
        /**
         * Get an attribute value.
         *
         * @param int $id
         * @return object|null
         */
        public function get($id)
        {
        }
        /**
         * Get values by attribute ID
         */
        public function get_by($id, $key = 'attribute_id', $search = null)
        {
        }
        /**
         * Get an attribute by slug.
         *
         * @param string $slug
         * @return object|null
         */
        public function get_by_slug($slug)
        {
        }
        /**
         * Get all attribute values.
         *
         * @return array
         */
        public function get_all()
        {
        }
        /**
         * Get all values for a specific attribute.
         *
         * @param int $attribute_id
         * @return array
         */
        public function get_by_attribute($attribute_id)
        {
        }
        /**
         * Update an attribute value.
         *
         * @param int   $id
         * @param array $data
         * @return bool
         */
        public function update($attribute_value_id, $data)
        {
        }
        /**
         * Delete an attribute value.
         *
         * @param int $id
         * @return bool
         */
        public function delete($id)
        {
        }
    }
    /**
     * Coupon Class
     * Handles coupon-related operations in the database.
     */
    class Coupon extends \EasyCommerce\Abstracts\Model
    {
        protected $id;
        protected $name;
        protected $code;
        protected $type = 'percentage';
        protected $offer = 0.0;
        protected $active = 1;
        protected $exists = false;
        protected $table = 'coupons';
        /**
         * Constructor for the Coupon class.
         *
         * @param int|string|null $identifier Optional. The coupon ID or code.
         */
        public function __construct($identifier = null)
        {
        }
        protected function load_by_id($id)
        {
        }
        protected function load_by_code($code)
        {
        }
        protected function initialize_coupon($coupon)
        {
        }
        public function exists()
        {
        }
        public static function get($identifier)
        {
        }
        public function get_id()
        {
        }
        public function get_name()
        {
        }
        public function get_code()
        {
        }
        public function get_type()
        {
        }
        public function get_offer()
        {
        }
        // @todo: remove exec and use get_rows
        public function get_usage_count()
        {
        }
        public function is_active()
        {
        }
        public function set_status($status)
        {
        }
        public function create($args)
        {
        }
        public function update($data)
        {
        }
        /**
         * Update the coupon's associated rules.
         *
         * @param array $rules Array of rules to update (each with 'type' and 'value').
         */
        protected function update_rules($rules)
        {
        }
        public function delete()
        {
        }
        public function get_rules($format = false)
        {
        }
        public function add_rule($rule_data)
        {
        }
        public static function list($args = array())
        {
        }
        public function is_applicable($cart = null)
        {
        }
        /**
         * Get all product IDs associated with the coupon rules.
         *
         * @return array Array of unique product IDs.
         */
        public function get_products()
        {
        }
    }
    /**
     * Concrete Customer Class
     */
    class Customer extends \EasyCommerce\Abstracts\User
    {
        protected $role = 'customer';
        public function __construct($id = null)
        {
        }
        /**
         * Get order count
         *
         * @return int
         */
        public function get_order_count($range = '')
        {
        }
        /**
         * Get total spent
         *
         * @return int
         */
        public function get_ltv()
        {
        }
        /**
         * Get average order value
         *
         * @return int
         */
        public function get_aov()
        {
        }
        /**
         * Get last order date
         *
         * @return string
         */
        public function get_last_order_date()
        {
        }
        /**
         * Get phone number
         *
         * @return string
         */
        public function get_phone($type = '')
        {
        }
        /**
         * Get billing address
         *
         * @return array The billing address fields, or an empty array when unset.
         */
        public function get_billing_address()
        {
        }
        /**
         * Get shipping address
         *
         * @return array The shipping address fields, or an empty array when unset.
         */
        public function get_shipping_address()
        {
        }
        /**
         * Retrieve a specific field from the billing or shipping address.
         *
         * @param string $field The field name to retrieve.
         * @param string $type  The address type ('billing' or 'shipping'). Default is 'billing'.
         * @return string The value of the requested field or an empty string if not set.
         */
        public function get_address_field($field, $type = 'billing')
        {
        }
        public function get_first_name($type = '')
        {
        }
        public function get_last_name($type = '')
        {
        }
        public function get_name($type = '')
        {
        }
        public function get_email($type = '')
        {
        }
        public function get_address_1($type = 'billing')
        {
        }
        public function get_address_2($type = 'billing')
        {
        }
        public function get_country($type = 'billing')
        {
        }
        public function get_state($type = 'billing')
        {
        }
        public function get_city($type = 'billing')
        {
        }
        public function get_postcode($type = 'billing')
        {
        }
        /**
         * @since 1.2.3
         */
        public function get_address($type = 'billing')
        {
        }
        /**
         * Get orders
         *
         * @param int $count
         * @return array
         */
        public function get_orders($count = -1)
        {
        }
        /**
         * Get the customer's orders filtered by one or more statuses.
         *
         * @param string|array $status One status or a list of statuses.
         * @param int          $count  Number of orders to return (-1 for all).
         * @return array
         */
        public function get_orders_by_status($status, $count = -1)
        {
        }
        /**
         * Order statuses that entitle a customer to access digital downloads.
         *
         * Excludes unpaid (`pending`), aborted (`cancelled`, `on_hold`) and
         * fully-refunded (`refunded`) orders. A paid order that is still
         * `processing` counts, so buyers are not blocked before completion.
         *
         * @since 1.32
         * @return array
         */
        public static function downloadable_order_statuses()
        {
        }
        /**
         * Get the customer's downloadable files, keyed by media ID.
         *
         * Single source of truth for download entitlement: only orders whose
         * status is in {@see self::downloadable_order_statuses()} are considered,
         * and only `digital` variations contribute files. Used by both the
         * dashboard list (`/me/downloads`) and the secure-download handler so the
         * two can never disagree.
         *
         * @since 1.32
         * @return array<int,object> media_id => decorated download object.
         */
        public function get_downloads()
        {
        }
        /**
         * Get total spent
         *
         * @return float
         */
        public function get_total_spent()
        {
        }
        /**
         * List customers with optional filters such as search, page, and per_page.
         *
         * @param string|null $search
         * @param int         $page
         * @param int         $per_page
         * @return array List of customers with pagination info
         */
        public static function customer_list($search = null, $page = 1, $per_page = 10)
        {
        }
    }
    /**
     * Location Class
     * Handles loading country, state, city, and other location-related data from a static JSON file.
     */
    class Location
    {
        /**
         * @var array Cached data from the JSON file
         */
        protected static $data = array();
        /**
         * Load data from the JSON file if not already loaded.
         */
        protected static function load_data()
        {
        }
        /**
         * Retrieve the list of all countries.
         *
         * @return array List of countries with basic details.
         */
        public static function get_countries()
        {
        }
        /**
         * Retrieve the list of states for a given country.
         *
         * @param string $country_code ISO-2 code of the country.
         * @return array List of states for the given country.
         */
        public static function get_states($country_code)
        {
        }
        /**
         * Retrieve the list of cities for a given state within a country.
         * If no state code is provided, return all cities in the country.
         *
         * @param string      $country_code ISO-2 code of the country.
         * @param string|null $state_code Optional. State code within the country.
         * @return array List of cities for the given state or all cities for the country if state code is not provided.
         */
        public static function get_cities($country_code, $state_code = null)
        {
        }
        /**
         * Bundled country data keyed by ISO-2 code.
         * Used as fallback when locations.json has not yet been downloaded.
         *
         * @return array [ 'US' => [ 'iso3', 'numeric_code', 'name' ], ... ]
         */
        protected static function fallback_countries()
        {
        }
        /**
         * Bundled currency data keyed by ISO-2 country code.
         * Used as fallback when locations.json has not yet been downloaded.
         *
         * @return array [ 'US' => [ 'USD', 'US Dollar', '$' ], ... ]
         */
        protected static function fallback_currencies()
        {
        }
        /**
         * Retrieve the list of currencies.
         * If a country is specified, return only the currency for that country.
         *
         * @param string|null $country ISO-2 code of the country.
         * @return array List of all currencies or a single currency for the specified country.
         */
        public static function get_currencies($country = null)
        {
        }
        /**
         * Retrieve the list of ISD codes.
         * If a country is specified, return only the ISD code for that country.
         *
         * @param string|null $country ISO-2 code of the country.
         * @return array List of ISD codes for all countries or a single ISD code for the specified country.
         */
        public static function get_isd_codes($country = null)
        {
        }
        /**
         * Retrieve the list of timezones.
         * If a country is specified, return only the timezones for that country.
         *
         * @param string|null $country ISO-2 code of the country.
         * @return array List of timezones for all countries or specific timezones for the specified country.
         */
        public static function get_timezones($country = null)
        {
        }
    }
    /**
     * Class Log
     * Handles log records in the database.
     *
     * @package EasyCommerce\Model
     */
    class Log extends \EasyCommerce\Abstracts\Model
    {
        protected $table = 'logs';
        /**
         * @var int
         */
        protected $id = 0;
        /**
         * @var string
         */
        protected $object = '';
        /**
         * @var string
         */
        protected $action = '';
        /**
         * @var int
         */
        protected $object_id = 0;
        /**
         * @var int|null
         */
        protected $user_id = null;
        /**
         * @var string|null
         */
        protected $note = null;
        /**
         * @var string|null
         */
        protected $ip_address = null;
        /**
         * @var int
         */
        protected $seen = 0;
        /**
         * @var string
         */
        protected $type = 'info';
        /**
         * @var string|null
         */
        protected $meta = null;
        /**
         * @var int
         */
        protected $is_public = 1;
        /**
         * @var string
         */
        protected $created_at = '';
        /**
         * Log constructor.
         * Initializes the class with the 'logs' table and optionally loads a log by ID.
         *
         * @param int $id The log ID to load.
         */
        public function __construct($id = 0)
        {
        }
        /**
         * Load log data from database.
         */
        protected function load()
        {
        }
        /**
         * Check if the log exists.
         *
         * @return bool True if exists, false otherwise.
         */
        public function exists()
        {
        }
        /**
         * Get the log ID.
         *
         * @return int
         */
        public function get_id()
        {
        }
        /**
         * Get the object.
         *
         * @return string
         */
        public function get_object()
        {
        }
        /**
         * Get the action.
         *
         * @return string
         */
        public function get_action()
        {
        }
        /**
         * Get the object ID.
         *
         * @return int
         */
        public function get_object_id()
        {
        }
        /**
         * Get the user ID.
         *
         * @return int|null
         */
        public function get_user_id()
        {
        }
        /**
         * Get the note.
         *
         * @return string|null
         */
        public function get_note()
        {
        }
        /**
         * Get the IP address.
         *
         * @return string|null
         */
        public function get_ip_address()
        {
        }
        /**
         * Get the seen status.
         *
         * @return int
         */
        public function get_seen()
        {
        }
        /**
         * Get the log type.
         *
         * @return string
         */
        public function get_type()
        {
        }
        /**
         * Get the is_public status.
         *
         * @return int
         */
        public function get_is_public()
        {
        }
        /**
         * Get the meta.
         *
         * @return string|null
         */
        public function get_meta()
        {
        }
        /**
         * Get the created at timestamp.
         *
         * @return string
         */
        public function get_created_at()
        {
        }
        /**
         * Get all logs based on filters like object, action, user ID, date range, pagination.
         *
         * @param array $args Filters for querying logs (e.g., object, action, user_id, from_date, to_date).
         * @param int   $per_page Number of records per page.
         * @param int   $offset Offset for pagination.
         * @param string $sort Sort order (asc/desc).
         * @return array List of logs with total count.
         */
        public static function list($args = array(), $per_page = 10, $offset = 0, $sort = 'desc')
        {
        }
        /**
         * Get all logs based on filters like object, action, user ID, date range, pagination.
         * This method handles exclude_objects filtering using custom SQL.
         *
         * @param array $args Filters for querying logs.
         * @param int   $per_page Number of records per page.
         * @param int   $offset Offset for pagination.
         * @param string $sort Sort order (asc/desc).
         * @return array List of logs with total count.
         */
        public static function list_with_exclude($args = array(), $per_page = 10, $offset = 0, $sort = 'desc')
        {
        }
        /**
         * Add a new log entry to the database.
         *
         * @param array $data The log data (object, action, object_id, user_id, note, ip_address, seen).
         * @return bool|int Log ID on success, false on failure.
         */
        public function add($data)
        {
        }
        /**
         * Delete a log entry by its ID.
         *
         * @param int $log_id The log ID.
         * @return bool True on success, false on failure.
         */
        public function delete($log_id)
        {
        }
        /**
         * Get a specific log entry by its ID.
         *
         * @param int $id The log ID.
         * @return array|null The log data if found, otherwise null.
         */
        public function get($id)
        {
        }
    }
    /**
     * Concrete Manager Class
     */
    class Manager extends \EasyCommerce\Abstracts\User
    {
        protected $role = 'manager';
        public function __construct($id = null)
        {
        }
    }
    /**
     * Concrete Notice Class
     */
    class Notice
    {
        /**
         * Get a list of notices, optionally filtered by type and screen.
         *
         * @param  string|null $type   Filter notices by type (e.g., 'error', 'success').
         * @param  string|null $screen Filter notices by screen context (e.g., '#/orders').
         * @param  int|null $limit Number of notices to return
         * 
         * @return array Array of notice arrays, each with structure:
         * 	array(
         * 		'id'			=> 'my-notice',
         * 		'type'			=> 'error',
         * 		'screen'		=> '#/orders',
         * 		'title'			=> 'This is notice',
         * 		'message'		=> 'Please notice this notice',
         * 		'dismissible'	=> true,
         * 		'button'		=> 'Click here',
         * 		'url'			=> 'https://easycommerce.dev'
         * 	)
         */
        public static function list($type = null, $screen = null, $limit = null)
        {
        }
        /**
         * @param array Array of notice arrays, each with structure:
         * 	array(
         * 		'id'			=> 'my-notice',
         * 		'type'			=> 'error',
         * 		'screen'		=> '#/orders',
         * 		'title'			=> 'This is notice',
         * 		'message'		=> 'Please notice this notice',
         * 		'dismissible'	=> true,
         * 		'button'		=> 'Click here',
         * 		'url'			=> 'https://easycommerce.dev'
         * 	)														   
         */
        public function add($data)
        {
        }
        public function remove($id)
        {
        }
    }
    /**
     * Concrete Order Class
     * Handles order-related operations in the database.
     */
    class Order extends \EasyCommerce\Abstracts\Model
    {
        /**
         * @var int Order ID
         */
        protected $id;
        /**
         * @var int Customer ID
         */
        protected $customer_id = 0;
        /**
         * @var float Order total amount
         */
        protected $total = 0.0;
        /**
         * @var float Order subtotal amount
         */
        protected $subtotal = 0.0;
        /**
         * @var string Order status
         */
        protected $status = 'pending';
        /**
         * @var string Fulfillment status
         */
        protected $fulfill_status = '';
        /**
         * @var string Payment method
         */
        protected $payment_method = '';
        /**
         * @var string Order creation date
         */
        protected $created_at = '';
        /**
         * @var string Last modified date
         */
        protected $updated_at = '';
        /**
         * @var bool Order existence flag
         */
        protected $exists = false;
        /**
         * @var \EasyCommerce\Models\Order_Meta Instance for handling order meta data
         */
        protected $meta;
        /**
         * @var \EasyCommerce\Models\Order_Item Instance for handling order items
         */
        protected $items;
        protected $table = 'orders';
        /**
         * Constructor for the Order class.
         *
         * @param int|null $id Optional. The order ID.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Get the order ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Check if the order exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Get the customer ID for the order.
         *
         * @return int
         */
        public function get_customer_id()
        {
        }
        public function get_customer_name()
        {
        }
        /**
         * Get the total amount of the order.
         *
         * @return float
         */
        public function get_total()
        {
        }
        /**
         * Get the subtotal amount of the order.
         *
         * @return float
         */
        public function get_subtotal()
        {
        }
        /**
         * Get the product tax amount of the order.
         *
         * @return float
         */
        public function get_product_tax()
        {
        }
        /**
         * Get the shipping tax amount of the order.
         *
         * @return float
         */
        public function get_shipping_tax()
        {
        }
        /**
         * Get the tax amount of the order.
         *
         * @return float
         */
        public function get_tax_total()
        {
        }
        /**
         * Get the shipping amount of the order.
         *
         * @return float
         */
        public function get_shipping_total()
        {
        }
        /**
         * Get the coupon discount amount of the order.
         *
         * @return float
         */
        public function get_discount_total()
        {
        }
        /**
         * Get the status of the order.
         *
         * @return string
         */
        public function get_status()
        {
        }
        /**
         * Set the status of the order.
         *
         * @return bool|int
         */
        public function set_status($status)
        {
        }
        /**
         * Get the fulfillment status of the order.
         *
         * @return string
         */
        public function get_fulfillment_status()
        {
        }
        /**
         * Set the fulfillment status of the order.
         *
         * @return bool|int
         */
        public function set_fulfillment_status($fulfill_status)
        {
        }
        /**
         * Get the payment method for the order.
         *
         * @return string
         */
        public function get_payment_method()
        {
        }
        public function get_created_at()
        {
        }
        public function get_updated_at()
        {
        }
        public function get_transactions($formatted = false)
        {
        }
        public function get_refunds($formatted = false)
        {
        }
        /**
         * Get the total refunded amount for the order.
         *
         * @return float
         */
        public function get_total_refunded()
        {
        }
        /**
         * Create a new order.
         *
         * @param array $args Order data.
         * @return bool|int Order ID on success, false on failure.
         */
        public function create($args)
        {
        }
        /**
         * Update the order.
         *
         * @param array $data Updated order data.
         * @return bool|int Number of affected rows on success, false on failure.
         */
        public function update($data)
        {
        }
        /**
         * Delete the order.
         *
         * @return bool True on success, false on failure.
         */
        public function delete()
        {
        }
        /**
         * Add order meta data using the Order_Meta class.
         *
         * @param string $key Meta key.
         * @param mixed  $value Meta value.
         * @return bool True on success, false on failure.
         */
        public function add_meta($key, $value)
        {
        }
        /**
         * Get order meta data using the Order_Meta class.
         *
         * @param string $key Meta key.
         * @param bool   $single Whether to return a single value.
         * @return mixed Meta value or null if not found.
         */
        public function get_meta($key, $single = true)
        {
        }
        /**
         * Update order meta data using the Order_Meta class.
         *
         * @param string $key Meta key.
         * @param mixed  $value Meta value.
         * @return bool True on success, false on failure.
         */
        public function update_meta($key, $value)
        {
        }
        /**
         * Delete order meta data using the Order_Meta class.
         *
         * @param string $key Meta key.
         * @return bool True on success, false on failure.
         */
        public function delete_meta($key)
        {
        }
        /**
         * Get all items for the order using the Order_Item class.
         *
         * @return array List of order items.
         */
        public function get_items($formatted = false)
        {
        }
        /**
         * Add an item to the order using the Order_Item class.
         *
         * @param array $item_data Item data (product ID, quantity, price, etc.).
         * @return bool True on success, false on failure.
         */
        public function add_item($item_data)
        {
        }
        /**
         * Remove an item from the order using the Order_Item class.
         *
         * @param int $item_id The order item ID.
         * @return bool True on success, false on failure.
         */
        public function remove_item($item_id)
        {
        }
        /**
         * Update an item in the order using the Order_Item class.
         *
         * @param int   $item_id The order item ID.
         * @param array $data    Updated item data.
         * @return bool True on success, false on failure.
         */
        public function update_item($item_id, $data)
        {
        }
        /**
         * Static method to list orders with optional filters such as per_page, page, status, and search_query.
         *
         * @param array $args Arguments that may include 'per_page', 'page', 'status', and 'search_query'.
         * @return array List of orders and pagination info.
         */
        public static function list($args = array(), $formatted = false)
        {
        }
    }
    /**
     * Class Order_Item
     * Handles order items and their metadata operations in the database.
     *
     * @package EasyCommerce\Model
     */
    class Order_Item extends \EasyCommerce\Abstracts\Model
    {
        /**
         * @var Order Item ID
         */
        protected $id;
        protected $table = 'order_items';
        /**
         * @var Order_Item_Meta Instance for handling order item metadata
         */
        protected $meta;
        /**
         * Order_Item constructor.
         * Initializes the class with the 'order_items' table and metadata handler.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Get all items for a specific order by order ID.
         *
         * @param int $order_id The order ID.
         * @return array List of order items.
         */
        public function get_by_order_id($order_id)
        {
        }
        /**
         * Add a new item to the order.
         *
         * @param int   $order_id The order ID.
         * @param array $item_data The item data (product ID, quantity, price, etc.).
         * @return bool|int Item ID on success, false on failure.
         */
        public function add($order_id, $item_data)
        {
        }
        /**
         * Update an existing order item.
         *
         * @param int   $item_id The item ID.
         * @param array $data    Updated item data (quantity, price, etc.).
         * @return bool True on success, false on failure.
         */
        public function update($data)
        {
        }
        /**
         * Delete an order item by its item ID.
         * The associated metadata will be automatically deleted by the database.
         *
         * @param int $item_id The item ID.
         * @return bool True on success, false on failure.
         */
        public function delete()
        {
        }
        /**
         * Get a specific order item by its ID.
         *
         * @param int $item_id The item ID.
         * @return object|null The order item object if found, otherwise null.
         */
        public function get_by_id($item_id)
        {
        }
        /**
         * Get a specific order item by its ID.
         *
         * @param int $item_id The item ID.
         * @return object|null The order item object if found, otherwise null.
         */
        public function get_by($value, $key = 'order_id')
        {
        }
        /**
         * Add metadata to a specific order item using Order_Item_Meta.
         *
         * @param int    $item_id The item ID.
         * @param string $key     The meta key.
         * @param mixed  $value   The meta value.
         * @return bool True on success, false on failure.
         */
        public function add_meta($key, $value)
        {
        }
        /**
         * Get metadata for a specific order item using Order_Item_Meta.
         *
         * @param int    $item_id The item ID.
         * @param string $key     The meta key.
         * @param bool   $single  Whether to return a single value.
         * @return mixed The meta value or null if not found.
         */
        public function get_meta($key, $single = true)
        {
        }
        /**
         * Update metadata for a specific order item using Order_Item_Meta.
         *
         * @param int    $item_id The item ID.
         * @param string $key     The meta key.
         * @param mixed  $value   The meta value.
         * @return bool True on success, false on failure.
         */
        public function update_meta($key, $value)
        {
        }
        /**
         * Delete metadata for a specific order item using Order_Item_Meta.
         *
         * @param int    $item_id The item ID.
         * @param string $key     The meta key.
         * @return bool True on success, false on failure.
         */
        public function delete_meta($key)
        {
        }
    }
    /**
     * Class Order_Item_Meta
     * Handles product meta operations.
     *
     * This class extends the abstract Meta class to handle operations
     * related to product metadata. It specifies the table name as
     * 'order_item_meta' and uses 'order_item_id' as the unique identifier key.
     *
     * @package EasyCommerce\Model
     */
    class Order_Item_Meta extends \EasyCommerce\Abstracts\Meta
    {
        /**
         * Order_Item_Meta constructor.
         * Initializes the Order_Item_Meta class with the specified table name and unique identifier key.
         */
        public function __construct()
        {
        }
    }
    /**
     * Class Order_Meta
     * Handles order meta operations.
     *
     * This class extends the abstract Meta class to handle operations
     * related to order metadata. It specifies the table name as
     * 'order_meta' and uses 'order_id' as the unique identifier key.
     *
     * @package EasyCommerce\Model
     */
    class Order_Meta extends \EasyCommerce\Abstracts\Meta
    {
        /**
         * Order_Meta constructor.
         * Initializes the Order_Meta class with the specified table name and unique identifier key.
         */
        public function __construct()
        {
        }
    }
    /**
     * Concrete Product Class
     */
    class Product extends \EasyCommerce\Abstracts\Model
    {
        use \EasyCommerce\Traits\Cleaner;
        /**
         * Sort keys backed by a post meta value.
         *
         * @var array
         */
        protected static $meta_sorts = array('top-rating' => array('key' => 'average_rating', 'order' => 'DESC', 'nulls_last' => true), 'lowest-rating' => array('key' => 'average_rating', 'order' => 'ASC', 'nulls_last' => true), 'best-selling' => array('key' => 'total_sale', 'order' => 'DESC', 'nulls_last' => false), 'lowest-selling' => array('key' => 'total_sale', 'order' => 'ASC', 'nulls_last' => false));
        /**
         * @var int Product ID
         */
        protected $id;
        /**
         * @var string Product title
         */
        protected $title = '';
        /**
         * @var string Product slug
         */
        protected $slug = '';
        /**
         * @var string Product description
         */
        protected $description = '';
        /**
         * @var string Product post_content
         */
        protected $content = '';
        /**
         * @var string Product status
         */
        protected $status = '';
        /**
         * @var timestamp Product created_at
         */
        protected $created_at = '';
        /**
         * @var timestamp Product updated_at
         */
        protected $updated_at = '';
        /**
         * @var string Product thumbnail
         */
        protected $thumbnail = '';
        /**
         * @var bool Product existence flag
         */
        protected $exists = false;
        /**
         * @var Product_Meta Product_Meta instance
         */
        protected $meta;
        protected $table = 'products';
        public function __construct($id = null)
        {
        }
        /**
         * Get product ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Check if the product exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Check if the product is sellable.
         *
         * @return bool
         */
        public function is_sellable()
        {
        }
        /**
         * Check if the product is deletable.
         *
         * @return bool
         */
        public function is_deletable()
        {
        }
        /**
         * Get product title.
         *
         * @return string
         */
        public function get_title()
        {
        }
        /**
         * Get product slug.
         *
         * @return string
         */
        public function get_slug()
        {
        }
        /**
         * Set product title.
         *
         * @param string $title
         */
        public function set_title($title)
        {
        }
        /**
         * Set product slug.
         *
         * @param string $slug
         */
        public function set_slug($slug)
        {
        }
        /**
         * Set product thumbnail.
         *
         * @param int $thumbnail The thumbnail ID
         */
        public function set_thumbnail($thumbnail)
        {
        }
        /**
         * Get product description.
         *
         * @return string
         */
        public function get_description()
        {
        }
        /**
         * Set product description.
         *
         * @param string $description
         */
        public function set_description($description)
        {
        }
        /**
         * Get product summary.
         *
         * @return string
         */
        public function get_summary()
        {
        }
        /**
         * Set product summary.
         *
         * @param string $summary
         */
        public function set_summary($summary)
        {
        }
        /**
         * Get product status.
         *
         * @return string
         */
        public function get_status()
        {
        }
        /**
         * Set product status.
         *
         * @param string $status
         */
        public function set_status($status)
        {
        }
        /**
         * Get product thumbnail.
         *
         * @return string
         */
        public function get_thumbnail($size = null)
        {
        }
        /**
         * Get product url.
         *
         * @return string
         */
        public function get_url()
        {
        }
        /**
         * Get product gallery.
         *
         * @return string
         */
        public function get_gallery()
        {
        }
        /**
         * Get product attributes.
         *
         * @return string
         */
        public function get_attributes()
        {
        }
        /**
         * Get product rating
         *
         * @return float
         */
        public function get_rating()
        {
        }
        /**
         * Get product rating
         *
         * @return float
         */
        public function get_rating_count()
        {
        }
        /**
         * Get product total sales
         *
         * @return float
         */
        public function get_sales($formatted = true)
        {
        }
        /**
         * Get product prices.
         *
         * @param bool $formatted Whether to return formatted prices.
         * @return array
         */
        public function get_prices($formatted = true)
        {
        }
        public function is_variable()
        {
        }
        public function get_price($formatted = true, $type = 'regular_price')
        {
        }
        public function get_sale_price($formatted = true)
        {
        }
        /**
         * Get product stock.
         *
         * @return integer|bool The stock of the product or false if not found
         */
        public function get_stock()
        {
        }
        /**
         * Get product created_at.
         *
         * @return integer
         */
        public function get_created_at()
        {
        }
        /**
         * Get product updated_at.
         *
         * @return integer
         */
        public function get_updated_at()
        {
        }
        /**
         * Check if the product has variations.
         *
         * @return bool
         */
        public function has_variations()
        {
        }
        /**
         * Get variations of the product.
         *
         * @return array
         */
        public function get_variations()
        {
        }
        /**
         * An unorganized list of all downloads from all variations of this product.
         */
        public function get_downloads()
        {
        }
        /**
         * Set product categories.
         *
         * @param array $categories Array of category IDs, slugs, or names.
         * @return bool
         */
        public function set_categories($categories)
        {
        }
        /**
         * Get product categories.
         *
         * @return array List of category objects.
         */
        public function get_categories()
        {
        }
        /**
         * Set product tags.
         *
         * @param array $tags Array of tag IDs, slugs, or names.
         * @return bool
         */
        public function set_tags($tags)
        {
        }
        /**
         * Get product tags.
         *
         * @return array List of tag objects.
         */
        public function get_tags()
        {
        }
        /**
         * Set product brands.
         *
         * @param array $brands Array of brand IDs, slugs, or names.
         * @return bool
         */
        public function set_brands($brands)
        {
        }
        /**
         * Get product brands.
         *
         * @return array List of brand objects.
         */
        public function get_brands()
        {
        }
        /**
         * Get terms of a product.
         *
         * Retrieves the terms assigned to a product for a specified taxonomy (e.g., 'product_cat' or 'product_brand').
         *
         * @param string $taxonomy The taxonomy name, e.g., 'product_cat' or 'product_brand'.
         * @return array List of terms with filtered data.
         */
        public function get_terms($taxonomy = 'product_cat')
        {
        }
        /**
         * Create a new product.
         *
         * @param array $args Arguments for creating the product, including title, slug, description, status, categories, attributes, and variations.
         * @return int|bool The product ID on success, false on failure.
         */
        public function create($args)
        {
        }
        public function update($args)
        {
        }
        /**
         * Save product data.
         *
         * @return bool
         */
        public function save()
        {
        }
        /**
         * Delete product.
         *
         * @return bool
         */
        public function delete($force = false)
        {
        }
        /**
         * Static method to get products by filters using WP_Query and return total count.
         *
         * @param array $filters Filters like search query, status, etc.
         * @param int   $limit   Number of products to return.
         * @param int   $offset  Offset for pagination.
         * @return array List of Product objects and total count.
         *
         * @todo improve logic for params of different sets. It should work like this-
         *              ( cat1 OR cat2 ) AND ( tag1 OR tag2 ) AND ( color1 OR color2 )
         */
        public static function list($filters = array(), $limit = 10, $offset = 0, $detailed = true, $product_status = false)
        {
        }
        /**
         * Order a product query by a post meta value without excluding products that lack it.
         *
         * @param array     $clauses SQL clauses for the query.
         * @param \WP_Query $query   The query being run.
         * @return array
         */
        public static function meta_sort_clauses($clauses, $query)
        {
        }
        /**
         * @var string $type The range type- min or max
         */
        public static function get_store_price($type, $formatted = false)
        {
        }
        /**
         * Set product terms.
         *
         * @param array  $terms Array of category/brand IDs, slugs, or names.
         * @param string $taxonomy The taxonomy name
         *
         * @return bool
         */
        public function set_terms($terms = array(), $taxonomy = 'product_cat')
        {
        }
        /**
         * Add product meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function add_meta($key, $value)
        {
        }
        /**
         * Get product meta data.
         *
         * @param string $key
         * @param bool   $single
         * @return mixed
         */
        public function get_meta($key = '', $single = true)
        {
        }
        /**
         * Update product meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function update_meta($key, $value)
        {
        }
        /**
         * Delete product meta data.
         *
         * @param string $key
         * @return bool
         */
        public function delete_meta($key)
        {
        }
        /**
         * Get product reviews.
         */
        public function get_reviews($limit = '')
        {
        }
        /**
         * Get related products.
         */
        public function get_related($number = 5, $detailed = false)
        {
        }
        protected static $badge_definitions = array('sale' => array('label' => 'Sale', 'color' => '#EF4444', 'text' => '#FFFFFF'), 'new' => array('label' => 'New Arrival', 'color' => '#22C55E', 'text' => '#FFFFFF'), 'best_seller' => array('label' => 'Best Seller', 'color' => '#F59E0B', 'text' => '#FFFFFF'), 'featured' => array('label' => 'Featured', 'color' => '#3B82F6', 'text' => '#FFFFFF'));
        // Precedence, highest first. "out_of_stock" is derived from stock, not a
        // manual/meta badge, so it's handled separately in get_badges().
        protected static $badge_precedence = array('sale', 'best_seller', 'new', 'featured');
        // -----------------------------------------------------------------------
        // 2) Badge methods
        // -----------------------------------------------------------------------
        /**
         * Get the active badges for this product, ordered by display precedence
         * (Sale > Best Seller > New > Featured > Out of Stock).
         *
         * Each entry: array( 'type' => string, 'label' => string, 'color' => string, 'text_color' => string, 'position' => string )
         *
         * @return array
         */
        public function get_badges()
        {
        }
        /**
         * Build a badge array from the static definitions.
         *
         * @param string $type One of self::$badge_definitions keys.
         * @return array
         */
        protected function build_badge($type)
        {
        }
        /**
         * Whether the product currently has a genuine sale (sale_price < regular_price)
         * on at least one variation.
         *
         * @return bool
         */
        public function has_active_sale_price()
        {
        }
        /**
         * Whether the manually-set "New" badge is still within its 30-day window.
         *
         * @return bool
         */
        public function has_active_new_badge()
        {
        }
        /**
         * Set (or clear) a manual badge on this product.
         *
         * Supported $badge_type values: 'new', 'best_seller', 'featured', 'sale'.
         *
         * @param string $badge_type
         * @param bool   $value
         * @return bool
         */
        public function set_badge($badge_type, $value)
        {
        }
        /**
         * Recompute the auto sale badge from current variation prices. Call this
         * whenever a variation's regular_price/sale_price changes (e.g. from
         * Product::update() after variations are saved).
         *
         * @return bool Whether the product is currently on sale.
         */
        public function auto_set_sale_badge()
        {
        }
    }
    /**
     * Class Product_Meta
     * Handles product meta operations.
     *
     * This class extends the abstract Meta class to handle operations
     * related to product metadata. It specifies the table name as
     * 'product_meta' and uses 'product_id' as the unique identifier key.
     *
     * @package EasyCommerce\Model
     */
    class Product_Meta extends \EasyCommerce\Abstracts\Meta
    {
        /**
         * Product_Meta constructor.
         * Initializes the Product_Meta class with the specified table name and unique identifier key.
         */
        public function __construct()
        {
        }
    }
    /**
     * Class Product_Review
     * Handles product review operations using WordPress comments system.
     *
     * @package EasyCommerce\Models
     */
    class Product_Review
    {
        /**
         * @var int Review ID (maps to comment ID)
         */
        protected $id;
        /**
         * @var bool Whether the review exists
         */
        protected $exists = false;
        /**
         * Constructor
         *
         * @param int|null $id Comment ID
         */
        public function __construct($id = null)
        {
        }
        /**
         * Validate if the review exists and is a product review
         *
         * @return bool True if valid, false otherwise
         */
        protected function validate()
        {
        }
        /**
         * Delete a review
         *
         * @return bool True on success, false on failure
         */
        public function delete()
        {
        }
        /**
         * List product reviews with optional filters
         *
         * @param array $args Arguments for filtering reviews
         * @param int $per_page Number of reviews per page
         * @param int $offset Offset for pagination
         * @return array Array of review data with total count
         */
        public static function list($args = array())
        {
        }
        /**
         * Check if review exists
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Get review ID
         *
         * @return int|null
         */
        public function get_id()
        {
        }
    }
    /**
     * Concrete Variation Class
     */
    class Product_Variation extends \EasyCommerce\Abstracts\Model
    {
        /**
         * @var int Variation ID
         */
        public $id;
        /**
         * @var int Product ID
         */
        public $product_id;
        /**
         * @var string Variation name
         */
        public $name = '';
        /**
         * @var string Variation SKU
         */
        public $sku = '';
        /**
         * @var float Variation price
         */
        public $price = 0.0;
        /**
         * @var int Variation price_id
         */
        public $price_id = 0.0;
        /**
         * @var float Variation sale price
         */
        public $sale_price = 0.0;
        /**
         * @var int Variation type
         */
        public $type = 'digital';
        /**
         * @var int|null Variation stock quantity. Null means stock is not managed.
         */
        public $stock_quantity = null;
        /**
         * @var int Variation stock limit
         */
        public $stock_limit = 0;
        /**
         * @var string Variation status
         */
        public $status = '';
        /**
         * @var bool Variation existence flag
         */
        public $exists = false;
        /**
         * @var Product_Variation_Meta Variation meta instance
         */
        public $meta;
        /**
         * @var Product_Variation_Download Variation downloads instance
         */
        public $downloads;
        /**
         * @var Product_Variation_Attribute Variation attributes instance
         */
        public $attributes;
        protected $table = 'product_variations';
        public function __construct($id = null)
        {
        }
        /**
         * Get variation ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Get product ID.
         *
         * @return int|null
         */
        public function get_product_id()
        {
        }
        /**
         * Get product.
         *
         * @return int|null
         */
        public function get_product()
        {
        }
        /**
         * Check if the variation exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Get variation name.
         *
         * @param bool $full Should it prepend the product name
         *
         * @return string
         */
        public function get_name($full = false)
        {
        }
        /**
         * Get variation SKU.
         *
         * @return string
         */
        public function get_sku()
        {
        }
        /**
         * Set variation name.
         *
         * @param string $name
         */
        public function set_name($name)
        {
        }
        /**
         * Set variation SKU.
         *
         * @param string $sku
         */
        public function set_sku($sku)
        {
        }
        /**
         * Get variation thumbnail
         *
         * If no thumbnail is set for this variation, fallback to the product thumbnail
         *
         * @return string The URL
         */
        public function get_thumbnail()
        {
        }
        /**
         * Get variation thumbnail
         *
         * @param string $url The URL
         */
        public function set_thumbnail($url = '')
        {
        }
        /**
         * Get variation price.
         *
         * If the variation has a "valid" sale price set, return it. Otherwise return the regular price.
         *
         * @return float
         */
        public function get_price($formatted = false)
        {
        }
        /**
         * Get variation regular (non-sale) price.
         *
         * @return float
         */
        public function get_regular_price($formatted = false)
        {
        }
        /**
         * Set variation price.
         *
         * @param float $price
         */
        public function set_price($price)
        {
        }
        /**
         * Get variation price_id.
         *
         * @return float
         */
        public function get_price_id()
        {
        }
        /**
         * Set variation price_id.
         *
         * @param float $price_id
         */
        public function set_price_id($price_id)
        {
        }
        /**
         * Get variation sale price.
         *
         * @return float
         */
        public function get_sale_price($formatted = false)
        {
        }
        /**
         * Set variation sale price.
         *
         * @param float $sale_price
         */
        public function set_sale_price($sale_price)
        {
        }
        /**
         * If this variation manages stock
         *
         * @return bool
         */
        public function manages_stock()
        {
        }
        /**
         * Get variation stock quantity.
         *
         * @return int|null
         */
        public function get_stock()
        {
        }
        /**
         * Set variation stock quantity.
         *
         * @param int|null $stock_quantity
         */
        public function set_stock_quantity($stock_quantity)
        {
        }
        /**
         * Set variation type.
         *
         * @param string $type
         */
        public function set_type($type)
        {
        }
        /**
         * Get variation type.
         *
         * @return string
         */
        public function get_type()
        {
        }
        /**
         * Get variation status.
         *
         * @return string
         */
        public function get_status()
        {
        }
        /**
         * Set variation status.
         *
         * @param string $status
         */
        public function set_status($status)
        {
        }
        /**
         * Save variation data.
         *
         * @return int|bool Variation ID on success, false on failure.
         */
        public function save()
        {
        }
        /**
         * Delete variation.
         *
         * @return bool
         */
        public function delete()
        {
        }
        /**
         * Get variation meta data.
         *
         * @param string $key
         * @param bool   $single
         * @return mixed
         */
        public function get_meta($key = '', $single = true)
        {
        }
        /**
         * Add variation meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function add_meta($key, $value)
        {
        }
        /**
         * Update variation meta data.
         *
         * @param string $key
         * @param mixed  $value
         * @return bool
         */
        public function update_meta($key, $value)
        {
        }
        /**
         * Delete variation meta data.
         *
         * @param string $key
         * @return bool
         */
        public function delete_meta($key)
        {
        }
        /**
         * Get variation downloads.
         *
         * @return array
         */
        public function get_downloads()
        {
        }
        /**
         * Add variation download.
         *
         * @param string $name
         * @param string $filename
         * @param int    $filesize
         * @param int    $download_limit
         * @param string $expiry
         * @return bool
         */
        public function add_download($media_id, $name)
        {
        }
        /**
         * Delete variation download.
         *
         * @param int $id
         * @return bool
         */
        public function delete_download($id)
        {
        }
        /**
         * Get variation attributes.
         *
         * @return array
         */
        public function get_attributes()
        {
        }
        /**
         * Get height
         *
         * @return array|bool An array of value and unit, if found. False otherwise.
         */
        public function get_height()
        {
        }
        /**
         * Get width
         *
         * @return array|bool An array of value and unit, if found. False otherwise.
         */
        public function get_width()
        {
        }
        /**
         * Get length
         *
         * @return array|bool An array of value and unit, if found. False otherwise.
         */
        public function get_length()
        {
        }
        /**
         * Get tax class
         *
         * @return integer The Tax Class ID
         */
        public function get_tax_class()
        {
        }
        /**
         * Set tax class
         *
         * @param int $class_id The Tax Class ID
         */
        public function set_tax_class($class_id)
        {
        }
        /**
         * Get stock limit
         *
         * @return integer get stock limit
         */
        public function get_low_stock_limit()
        {
        }
        /**
         * Set stock limit
         *
         * @return integer set stock limit
         */
        public function set_low_stock_limit($limit)
        {
        }
        /**
         * Get weight
         *
         * @return array|bool An array of value and unit, if found. False otherwise.
         */
        public function get_weight($in_kg = false)
        {
        }
        /**
         * Add variation attribute.
         *
         * @param int $attribute_id
         * @param int $value_id
         * @return bool
         */
        public function add_attribute($attribute_id, $value_id)
        {
        }
        /**
         * Delete variation attribute.
         *
         * @param int $id
         * @return bool
         */
        public function delete_attribute($id)
        {
        }
        /**
         * Get a variation by price_id and product_id.
         *
         * @param int $price_id The price_id
         * @param int $product_id The product_id
         * @return bool|object
         */
        public function get_by_price($price_id, $product_id)
        {
        }
        /**
         * Get variation by attributes.
         *
         * @param array $attributes Associative array of attribute_slug => value_slug pairs.
         *                          Example:
         *                          [
         *                              'color' => 'midnight',
         *                              'size' => '41mm',
         *                              'connectivity' => 'gps'
         *                          ]
         * @return Product_Variation|null The matching variation instance or null if not found.
         *
         * @todo improve as it's not considering product_id
         */
        public function get_by_attributes($attributes = array(), $show_all = false)
        {
        }
        /**
         * Get all variations by a specific field and value.
         *
         * @param mixed  $value The value to search for (e.g., product ID).
         * @param string $key The field to search by (defaults to 'product_id').
         * @return array An array of Product_Variation instances.
         */
        public function get_by($value, $key = 'product_id')
        {
        }
    }
    /**
     * Class Product_Variation_Attribute
     * Handles product variation attributes operations.
     *
     * @package EasyCommerce\Model
     */
    class Product_Variation_Attribute extends \EasyCommerce\Abstracts\Model
    {
        protected $table = 'product_variation_attributes';
        public function __construct()
        {
        }
        /**
         * Add variation attribute.
         *
         * @param int    $variation_id
         * @param string $attribute_slug
         * @param string $value_slug
         * @param int    $attribute_id
         * @param int    $value_id
         * @return bool
         */
        public function add($variation_id, $attribute_slug, $value_slug, $attribute_id = 0, $value_id = 0)
        {
        }
        /**
         * Get variation attributes.
         *
         * @param int $variation_id
         * @return array
         */
        public function get($variation_id)
        {
        }
        /**
         * Update variation attribute.
         *
         * @param int   $id
         * @param array $data
         * @return bool
         */
        public function update($id, $data)
        {
        }
        /**
         * Delete variation attribute.
         *
         * @param int $id
         * @return bool
         */
        public function delete($id)
        {
        }
    }
    /**
     * Class Product_Variation_Download
     * Handles product variation downloads operations.
     *
     * @package EasyCommerce\Model
     */
    class Product_Variation_Download extends \EasyCommerce\Abstracts\Model
    {
        protected $table = 'product_variation_downloads';
        public function __construct()
        {
        }
        /**
         * Add variation download.
         *
         * @param int    $variation_id
         * @param string $name
         * @param string $filename
         * @param int    $filesize
         *
         * @return bool
         */
        public function add($variation_id, $media_id, $name = '')
        {
        }
        /**
         * Get variation downloads.
         *
         * @param int $variation_id
         * @return array
         */
        public function get($variation_id)
        {
        }
        /**
         * Update variation download.
         *
         * @param int   $id
         * @param array $data
         * @return bool
         */
        public function update($id, $data)
        {
        }
        /**
         * Delete variation download.
         *
         * @param int $id
         * @return bool
         */
        public function delete($id)
        {
        }
        /**
         * Delete all downloads belonging to a variation.
         *
         * @param int $variation_id
         * @return bool
         */
        public function delete_by_variation($variation_id)
        {
        }
    }
    /**
     * Class Product_Variation_Meta
     * Handles product variation meta operations.
     *
     * This class extends the abstract Meta class to handle operations
     * related to product variation metadata. It specifies the table name as
     * 'product_variation_meta' and uses 'variation_id' as the unique identifier key.
     *
     * @package EasyCommerce\Model
     */
    class Product_Variation_Meta extends \EasyCommerce\Abstracts\Meta
    {
        /**
         * Product_Variation_Meta constructor.
         * Initializes the Product_Variation_Meta class with the specified table name and unique identifier key.
         */
        public function __construct()
        {
        }
    }
    /**
     * Class Refund
     * Handles refund records in the database.
     *
     * @package EasyCommerce\Model
     */
    class Refund extends \EasyCommerce\Abstracts\Model
    {
        /**
         * @var int Refund ID
         */
        protected $id;
        /**
         * @var int Order ID
         */
        protected $order_id;
        /**
         * @var float Refund amount
         */
        protected $amount = 0.0;
        /**
         * @var string Currency
         */
        protected $currency = '';
        /**
         * @var string Reason for refund
         */
        protected $reason = '';
        /**
         * @var string Refund status
         */
        protected $status = 'pending';
        /**
         * @var string Transaction ID from gateway
         */
        protected $transaction_id = '';
        /**
         * @var string Payment gateway
         */
        protected $payment_gateway = '';
        /**
         * @var string Notes
         */
        protected $notes = '';
        /**
         * @var int Refunded by user ID
         */
        protected $refunded_by;
        /**
         * @var string Created at
         */
        protected $created_at = '';
        /**
         * @var string Updated at
         */
        protected $updated_at = '';
        /**
         * @var bool Refund existence flag
         */
        protected $exists = false;
        protected $table = 'refunds';
        /**
         * Constructor for the Refund class.
         *
         * @param int|null $id Optional. The refund ID.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Get the refund ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Check if the refund exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Get the order ID.
         *
         * @return int
         */
        public function get_order_id()
        {
        }
        /**
         * Get the refund amount.
         *
         * @return float
         */
        public function get_amount()
        {
        }
        /**
         * Get the currency.
         *
         * @return string
         */
        public function get_currency()
        {
        }
        /**
         * Get the refund reason.
         *
         * @return string
         */
        public function get_reason()
        {
        }
        /**
         * Get the refund status.
         *
         * @return string
         */
        public function get_status()
        {
        }
        /**
         * Set the refund status.
         *
         * @param string $status
         * @return bool|int
         */
        public function set_status($status)
        {
        }
        /**
         * Get the transaction ID.
         *
         * @return string
         */
        public function get_transaction_id()
        {
        }
        /**
         * Get the payment gateway.
         *
         * @return string
         */
        public function get_payment_gateway()
        {
        }
        /**
         * Get the notes.
         *
         * @return string
         */
        public function get_notes()
        {
        }
        /**
         * Get the refunded by user ID.
         *
         * @return int
         */
        public function get_refunded_by()
        {
        }
        /**
         * Get the created at timestamp.
         *
         * @return string
         */
        public function get_created_at()
        {
        }
        /**
         * Get the updated at timestamp.
         *
         * @return string
         */
        public function get_updated_at()
        {
        }
        /**
         * Get the associated order object.
         *
         * @return Order|null
         */
        public function get_order()
        {
        }
        /**
         * Create a new refund.
         *
         * @param array $args Refund data.
         * @return bool|int Refund ID on success, false on failure.
         */
        public function create($args)
        {
        }
        /**
         * Update the refund.
         *
         * @param array $data Updated refund data.
         * @return bool|int Number of affected rows on success, false on failure.
         */
        public function update($data)
        {
        }
        /**
         * Delete the refund.
         *
         * @return bool True on success, false on failure.
         */
        public function delete()
        {
        }
        /**
         * Get all refunds based on filters like order ID, status, pagination.
         *
         * @param array $filters Filters for querying refunds (e.g., order_id, status).
         * @param int   $per_page Number of records per page.
         * @param int   $offset Offset for pagination.
         * @return array List of refunds.
         */
        public static function list($args = array(), $per_page = 10, $offset = 0, $sort = 'desc')
        {
        }
        /**
         * Get all refunds for a specific order by order ID.
         *
         * @param int $order_id The order ID.
         * @return array List of refunds.
         */
        public function get_by_order_id($order_id)
        {
        }
        /**
         * Get a specific refund by its ID (static method).
         *
         * @param int $refund_id The refund ID.
         * @return Refund|null The refund object if found, otherwise null.
         */
        public static function get_by_id($refund_id)
        {
        }
    }
    /**
     * Shipping Plan Class
     * Handles shipping plan-related operations in the database.
     */
    class Shipping_Plan extends \EasyCommerce\Abstracts\Model
    {
        /**
         * @var int Shipping Plan ID
         */
        protected $id;
        /**
         * @var string Shipping plan name
         */
        protected $name;
        /**
         * @var string Shipping plan description
         */
        protected $description;
        /**
         * @var bool Active status (1 = active, 0 = inactive)
         */
        protected $active = 1;
        /**
         * @var bool Taxable status (1 = active, 0 = inactive)
         */
        protected $taxable = 0;
        /**
         * @var string Calculation base (price, weight, quantity)
         */
        protected $calculation_base = 'price';
        /**
         * @var bool Shipping plan existence flag
         */
        protected $exists = false;
        protected $table = 'shipping_plans';
        /**
         * Constructor for the Shipping_Plan class.
         *
         * @param int|null $id Optional. The shipping plan ID.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Check if the shipping plan exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Retrieve basic information for a specific shipping plan.
         *
         * @param int $id The shipping plan ID.
         * @return array|null Shipping plan details or null if not found.
         */
        public static function get($id)
        {
        }
        /**
         * Get the shipping plan ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Get the name of the shipping plan.
         *
         * @return string
         */
        public function get_name()
        {
        }
        /**
         * Get the description of the shipping plan.
         *
         * @return string
         */
        public function get_description()
        {
        }
        /**
         * Get the active status of the shipping plan.
         *
         * @return bool
         */
        public function is_active()
        {
        }
        /**
         * Get the taxable status of the shipping plan.
         *
         * @return bool
         */
        public function is_taxable()
        {
        }
        /**
         * Get the calculation base for the shipping plan.
         *
         * @return string
         */
        public function get_calculation_base()
        {
        }
        /**
         * Set the status of the shipping plan.
         *
         * @param bool $status Active status (1 = active, 0 = inactive).
         */
        public function set_status($status)
        {
        }
        /**
         * Create a new shipping plan with associated regions and methods.
         *
         * @param array $args Shipping plan data, including 'regions' and 'methods'.
         * @return bool|int Shipping Plan ID on success, false on failure.
         */
        public function create($args)
        {
        }
        /**
         * Update the shipping plan and its associated regions and methods.
         *
         * @param array $data Updated shipping plan data.
         * @return bool True on success, false on failure.
         */
        public function update($data)
        {
        }
        /**
         * Update the regions associated with the shipping plan.
         *
         * @param array $new_regions Array of new region data.
         */
        protected function update_regions($new_regions)
        {
        }
        /**
         * Update the methods associated with the shipping plan.
         *
         * @param array $new_methods Array of new method data.
         */
        protected function update_methods($new_methods)
        {
        }
        /**
         * Delete the shipping plan.
         *
         * @return bool True on success, false on failure.
         */
        public function delete()
        {
        }
        /**
         * Get all methods (price ranges) for the shipping plan.
         *
         * @return array List of shipping plan methods.
         */
        public function get_methods()
        {
        }
        /**
         * Add a method (price range) to the shipping plan.
         *
         * @param array $method_data Method data (name, min, min_unit, max, max_unit, cost).
         * @return bool|int Method ID on success, false on failure.
         */
        public function add_method($method_data)
        {
        }
        /**
         * Update an existing method in the shipping plan.
         *
         * @param int   $method_id The method ID.
         * @param array $method_data Updated method data.
         * @return bool
         */
        public function update_method($method_id, $method_data)
        {
        }
        /**
         * Get all regions assigned to the shipping plan.
         *
         * @return array List of regions.
         */
        public function get_regions()
        {
        }
        /**
         * Add a region to the shipping plan.
         *
         * @param string $region_code Standardized region code.
         * @return bool|int Region ID on success, false on failure.
         */
        public function add_region($region)
        {
        }
        /**
         * Update an existing region associated with the shipping plan.
         *
         * @param int   $region_id The ID of the region to update.
         * @param array $region_data Data to update the region with (e.g., region_code).
         * @return bool
         */
        protected function update_region($region_id, $region_data)
        {
        }
        /**
         * Static method to list shipping plans with optional filters.
         *
         * @param array $args Arguments that may include 'per_page', 'page', 'active'.
         * @return array List of shipping plans and pagination info.
         */
        public static function list($args = array())
        {
        }
        /**
         * Retrieve shipping plans available for a specific region code.
         *
         * @param string $region_code The standardized region code (e.g., "NG-LA").
         * @param int    $limit Number of plans to return
         *
         * @return array List of shipping plans available for the given region.
         */
        public static function get_by_location($region_code, $limit = -1)
        {
        }
        public static function get_by_location_address($country, $state, $city, $zip_code = '')
        {
        }
        /**
         * Static method to get a shipping method by its ID.
         *
         * @param int $method_id The ID of the shipping method.
         * @return object|null The shipping method data if found, otherwise null.
         */
        public static function get_method_by_id($method_id)
        {
        }
        public static function get_shipping_plan_by_id($method_id)
        {
        }
    }
    class Tax
    {
        /**
         * @var int Tax class ID.
         */
        protected $id;
        /**
         * @var string Tax class name.
         */
        protected $name;
        /**
         * @var string Tax class description.
         */
        protected $description;
        /**
         * @var bool Tax class status (1 = active, 0 = inactive).
         */
        protected $status = 1;
        /**
         * @var bool Flag to check if the tax class exists.
         */
        protected $exists = false;
        /**
         * @var Database Database instance for tax classes.
         */
        protected $class_db;
        /**
         * @var Database Database instance for tax rates.
         */
        protected $rate_db;
        /**
         * Constructor for the Tax class.
         *
         * @param int|null $id Optional. The tax class ID.
         */
        public function __construct($id = null)
        {
        }
        /**
         * Check if the tax class exists.
         *
         * @return bool
         */
        public function exists()
        {
        }
        /**
         * Get the tax class ID.
         *
         * @return int|null
         */
        public function get_id()
        {
        }
        /**
         * Get the tax class name.
         *
         * @return string|null
         */
        public function get_name()
        {
        }
        /**
         * Get the tax class description.
         *
         * @return string|null
         */
        public function get_description()
        {
        }
        /**
         * Get the tax class status.
         *
         * @return bool
         */
        public function get_status()
        {
        }
        /**
         * Get all rates for the tax class.
         *
         * @return array List of tax rates.
         */
        public function get_rates()
        {
        }
        /**
         * Get all regions assigned to the tax plan.
         *
         * @return string String of comma-separated regions.
         */
        public function get_regions()
        {
        }
        /** 
         * Check if a tax class name already exists.
         * 
         * @param string $name Tax class name to check. 
         * @return bool True if the name exists, false otherwise.  
         */
        public function name_exists($name)
        {
        }
        /**
         * Create a tax class with rates.
         *
         * @param array $data Tax class data, including rates.
         * @return int|false Tax class ID on success, false on failure.
         */
        public function create_class($data)
        {
        }
        /**
         * Update a tax class and its rates.
         *
         * @param int   $id Tax class ID.
         * @param array $data Updated tax class data, including rates.
         * @return bool True on success, false on failure.
         */
        public function update_class($id, $data)
        {
        }
        /**
         * Delete a tax class and its rates.
         *
         * @param int $id Tax class ID.
         * @return bool True on success, false on failure.
         */
        public function delete_class($id)
        {
        }
        /**
         * Get tax CSV files that match the given country codes.
         *
         * This method searches the plugin's /taxes directory for CSV files
         * corresponding to the provided country codes. Only existing files
         * are returned, and the codes are returned in uppercase format.
         *
         * @param array $countries Array of country codes to search for.
         * @return array Array of matched country codes in uppercase.
         */
        public function get_tax_files_by_countries(array $countries): array
        {
        }
        /**
         * Get all states and combined tax rates from a country's CSV file.
         *
         * The CSV file should have columns: state, combined tax rate
         *
         * @param string $country Country code (e.g., 'us', 'bd').
         * @return array Array of arrays with keys 'state', 'city', 'country' and 'combined_rate'.
         */
        public function get_country_tax_rates_from_csv(string $country): array
        {
        }
        /**
         * Static method to retrieve a tax class with its details.
         *
         * @param int $id Tax class ID.
         * @return array|null Tax class details or null if not found.
         */
        public static function get($id)
        {
        }
        /**
         * Get the correct tax rate based on location data.
         *
         * @param int         $tax_class_id The tax class ID (required).
         * @param string      $country The country code (required).
         * @param string|null $state The state code (optional).
         * @param string|null $city The city name (optional).
         *
         * @return float
         */
        public function get_rate_by_location($tax_class_id, $country, $state = null, $city = null, $details = false)
        {
        }
        /**
         * Get tax rate for a location by finding any matching active tax class.
         * This is used when product doesn't have a specific tax class.
         * 
         * @param string      $country Country code.
         * @param string|null $state   State code.
         * @param string|null $city    City name.
         * @return float Tax rate percentage.
         */
        public function get_rate_for_location($country, $state = null, $city = null)
        {
        }
        /**
         * Static method to list tax classes.
         *
         * @return array List of tax classes.
         */
        public static function list_classes()
        {
        }
    }
    /**
     * Class Taxonomy
     * Handles product taxonomy operations.
     *
     * @package EasyCommerce\Model
     */
    class Taxonomy
    {
        /**
         * Lists terms and their children
         *
         * @param int    $parent_id The parent term ID
         * @param string $taxonomy The taxonomy name
         *
         * @return array
         */
        public function list_terms($parent_id = 0, $taxonomy = 'product_cat', $limit = 10, $offset = 0)
        {
        }
        /**
         * Adds a new term to the specified taxonomy
         *
         * @param string   $name The name of the term
         * @param string   $slug The slug of the term (optional)
         * @param string   $taxonomy The taxonomy name
         * @param int|null $parent The parent term ID (optional)
         *
         * @return array
         */
        public function add_term($name, $taxonomy, $slug = null, $parent = null)
        {
        }
        /**
         * Updates a term in the specified taxonomy
         * @param int      $term_id The ID of the term to update
         * @param string   $name The new name of the term ( optional )
         * @param string   $taxonomy The taxonomy name
         * @param int|null $parent The new parent term ID (optional)
         *
         * @return array
         */
        public function update_term($term_id, $name, $taxonomy, $slug = null, $parent = null)
        {
        }
        /**
         * Deletes a term from the specified taxonomy
         *
         * @param int    $term_id  The ID of the term to delete
         * @param string $taxonomy The taxonomy name
         *
         * @return bool True on success, false on failure
         */
        public function delete_term($term_id, $taxonomy)
        {
        }
        /**
         * Bulk deletes multiple terms from the specified taxonomy
         *
         * @param array  $term_ids Array of term IDs to delete
         * @param string $taxonomy The taxonomy name
         *
         * @return bool True on completion
         */
        public function bulk_delete($term_ids, $taxonomy)
        {
        }
    }
    /**
     * Class Transaction
     * Handles transaction records in the database.
     *
     * @package EasyCommerce\Model
     */
    class Transaction extends \EasyCommerce\Abstracts\Model
    {
        protected $table = 'transactions';
        /**
         * Transaction constructor.
         * Initializes the class with the 'transactions' table.
         */
        public function __construct()
        {
        }
        /**
         * Get all transactions based on filters like order ID, status, pagination.
         *
         * @param array $filters Filters for querying transactions (e.g., order_id, status).
         * @param int   $per_page Number of records per page.
         * @param int   $offset Offset for pagination.
         * @return array List of transactions.
         */
        public static function list($args = array(), $per_page = 10, $offset = 0, $sort = 'desc')
        {
        }
        /**
         * Get all transactions for a specific order by order ID.
         *
         * @param int $order_id The order ID.
         * @return array List of transactions.
         */
        public function get_by_order_id($order_id)
        {
        }
        /**
         * Add a new transaction to the database.
         *
         * @param int         $order_id        The order ID.
         * @param array       $data The transaction data (transaction ID, payment gateway, amount, etc.).
         * @param bool|string $order_status If it should update the order status.
         *
         * @return bool|int Transaction ID on success, false on failure.
         */
        public function add($order_id, $data, $order_status = false)
        {
        }
        /**
         * Update an existing transaction.
         *
         * @param int         $transaction_id The transaction ID.
         * @param array       $data           Updated transaction data (amount, status, etc.).
         * @param bool|string $order_status If it should update the order status.
         *
         * @return bool True on success, false on failure.
         */
        public function update($transaction_id, $data, $order_status = false)
        {
        }
        /**
         * Delete a transaction by its transaction ID.
         *
         * @param int $transaction_id The transaction ID.
         * @return bool True on success, false on failure.
         */
        public function delete($transaction_id)
        {
        }
        /**
         * Get a specific transaction by its ID.
         *
         * @param int $transaction_id The transaction ID.
         * @return object|null The transaction object if found, otherwise null.
         */
        public function get_by_id($transaction_id)
        {
        }
    }
}
namespace EasyCommerce\Traits {
    /**
     * Trait Request
     *
     * Outbound HTTP helper using WordPress HTTP API.
     *
     * Method signatures:
     *   call( string $method, string $url, array $body = [], array $headers = [], array $opts = [] )
     *   get|post|put|delete|patch|head( string $url, array $body = [], array $headers = [], array $opts = [] )
     *
     * - All inputs that are applicable (body, headers, opts) must be arrays.
     * - By default arrays in $body are auto-encoded to JSON for non-GET requests (set $opts['json'] = false to disable).
     * - For GET requests, $body array is appended as query params.
     * - $headers is an associative array of header => value.
     *
     * Normalized response (always returned; won't call wp_send_json_*):
     *  [
     *    'success' => (bool),            // true for 2xx responses
     *    'status'  => (int),             // HTTP status code (0 on WP_Error)
     *    'content' => (mixed|null),      // JSON payload's `data` key when present, else the decoded JSON, else the raw body
     *    'error'   => (string|null),     // error message on failure ("HTTP <code>", or the WP_Error message)
     *  ]
     *
     * Usage examples:
     *   $this->post( 'https://api.example.com/items', ['name' => 'x'], ['Authorization' => 'Bearer ...'], ['timeout' => 20] );
     *   $this->get( 'https://api.example.com/items', ['search' => 'a'] ); // body appended as query
     */
    trait Request
    {
        /**
         * Default timeout (seconds) for HTTP calls.
         *
         * @var int
         */
        public $request_timeout = 300;
        /**
         * Perform an HTTP request.
         *
         * @param string $method  HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD).
         * @param string $url     Full request URL.
         * @param array  $body    Request body. For GET this will be converted to query args. For non-GET arrays are JSON-encoded by default.
         * @param array  $headers Associative array of headers (header => value).
         * @param array  $opts    Additional options (array). Supported keys:
         *                        - json (bool|null) : null = auto (encode arrays to JSON), true = force JSON, false = disable JSON encoding
         *                        - timeout (int)    : seconds (overrides $this->request_timeout)
         *                        - sslverify (bool) : whether to verify SSL (default true)
         *                        - args (array)     : extra args merged into wp_remote_request() args
         *
         * @return array Normalized response structure (see trait docblock).
         */
        public function call($method, $url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience GET.
         *
         * Appends $body as query args (if non-empty array).
         *
         * @param string $url     URL.
         * @param array  $body    Query args as associative array.
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function get($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience POST.
         *
         * @param string $url     URL.
         * @param array  $body    Body as array (auto JSON-encoded by default) or string.
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function post($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience PUT.
         *
         * @param string $url     URL.
         * @param array  $body    Body as array (auto JSON-encoded by default) or string.
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function put($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience DELETE.
         *
         * Note: some APIs accept body for DELETE; pass it if needed.
         *
         * @param string $url     URL.
         * @param array  $body    Optional body as array or string.
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function delete($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience PATCH.
         *
         * @param string $url     URL.
         * @param array  $body    Body as array (auto JSON-encoded by default) or string.
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function patch($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Convenience HEAD.
         *
         * @param string $url     URL.
         * @param array  $body    Ignored for HEAD (kept for consistent signature).
         * @param array  $headers Headers array.
         * @param array  $opts    Additional options (see call()).
         * @return array Normalized response.
         */
        public function head($url, $body = array(), $headers = array(), $opts = array())
        {
        }
        /**
         * Attempt to JSON decode a raw response body.
         *
         * Returns decoded value when valid JSON, otherwise null.
         *
         * @param string $raw Raw response body.
         * @return mixed|null Decoded JSON (array/object) or null when not JSON.
         */
        protected function maybe_json_decode($raw)
        {
        }
    }
}
namespace EasyCommerce\Services {
    /**
     * Class AI
     * Handles AI related operations for the EasyCommerce plugin.
     *
     * Provides integration with external AI services for features like:
     * - Product description generation
     * - Image generation and editing
     * - Report analysis from natural language queries
     * - Product attribute generation
     * - Spelling correction
     * - Block template design
     *
     * @package EasyCommerce\Services
     * @since 1.16
     */
    class AI
    {
        use \EasyCommerce\Traits\Cleaner;
        use \EasyCommerce\Traits\Request;
        /**
         * HTTP headers to include in API requests.
         *
         * @since 1.16
         * @var array
         */
        private $headers = array();
        /**
         * Base URL for the AI API endpoint.
         *
         * @since 1.16
         * @var string
         */
        private $api_base;
        /**
         * Constructor.
         *
         * Initializes the AI service. No initialization needed as credentials
         * are fetched dynamically from WordPress options.
         *
         * @since 1.16
         */
        public function __construct()
        {
        }
        /**
         * Checks if the AI service is ready to use.
         *
         * Verifies that API credentials are configured in WordPress options.
         *
         * @since 1.16
         *
         * @return bool True if API credentials are configured, false otherwise.
         */
        private function prepare()
        {
        }
        /**
         * Makes an API call to the external AI service.
         *
         * Sends a request to the EasyCommerce AI API endpoint with the provided
         * data and configuration. Includes API credentials from WordPress options.
         *
         * @since 1.16
         *
         * @param string $path   The API endpoint path (e.g., 'ask', 'write', 'paint').
         * @param array  $data   The data to send with the request.
         * @param string $method The HTTP method to use. Default 'POST'.
         * @param array  $config  Optional. Additional configuration options.
         *                        - timeout: Request timeout in seconds (default 60)
         *                        - ssl: Enable SSL verification (default true)
         *                        - headers: Additional headers to include.
         *
         * @return object|\WP_Error The response from the API as an object, or WP_Error on failure.
         */
        private function call($path, $data, $method = 'POST', $config = [])
        {
        }
        /**
         * Insert a row into the AI usage log.
         *
         * @param string $type     The hub path (write, paint, enhance, agent, ...).
         * @param array  $data      Request body sent to the hub.
         * @param object $response  Decoded hub response.
         */
        private function log_usage($type, $data, $response)
        {
        }
        /**
         * Log one conversational AI use (Copilot / shopping agent / smart search) as a
         * single row, even though it spanned several hub turns. The caller provides the
         * question, final answer, and the total credits the turns consumed.
         *
         * @param string $type   Log type (copilot, shopping_agent, search, ...).
         * @param string $input  User question.
         * @param string $output Final answer.
         * @param int    $credit Total credits consumed across the conversation.
         */
        public function log_conversation($type, $input, $output, $credit)
        {
        }
        /**
         * Default per-type credit cost when the hub did not report one.
         *
         * @param string $type
         * @return int
         */
        private function default_credit($type)
        {
        }
        /**
         * Insert a row into the AI usage log.
         *
         * @param string $type
         * @param string $input
         * @param string $output
         * @param int    $credit
         */
        private function insert_log($type, $input, $output, $credit)
        {
        }
        /**
         * Extract a human-readable prompt/question from the request body.
         *
         * @param string $type
         * @param array  $data
         * @return string
         */
        private function usage_input($type, $data)
        {
        }
        /**
         * Extract the assistant answer (or an image marker) from the hub response.
         *
         * @param object $response
         * @return string
         */
        private function usage_output($response)
        {
        }
        /**
         * Create the ai_logs table on first use (option-guarded) so the usage log
         * works without waiting for a full plugin reinstall. The column definition
         * lives in app/Config/tables.php (single source of truth).
         */
        private function ensure_log_table()
        {
        }
        /**
         * Runs an agentic chat completion turn with tool/function-calling support.
         *
         * Sends the full conversation history and tool definitions to the AI
         * server. The response may contain tool_calls that the caller must
         * execute and loop on until a final text reply is returned.
         *
         * @param array  $messages      Full conversation history [{role, content}, ...].
         * @param array  $tools         Tool definitions in OpenAI function-calling format.
         * @param string $system_prompt System prompt injected on the server side.
         *
         * @return object Response from the AI service.
         */
        public function agent(array $messages, array $tools, string $system_prompt = '')
        {
        }
        /**
         * Generates product description or summary using AI.
         *
         * Creates compelling product descriptions based on the product name,
         * optional custom prompt, and desired length.
         *
         * @since 1.16
         *
         * @param string $product The name of the product to generate description for.
         * @param string $prompt  Optional. Custom instructions to customize the output.
         *                        Default empty string.
         * @param string $length  Optional. Desired length of output. Accepts 'short' or 'long'.
         *                        Default 'short'.
         *
         * @return array {
         *     Response from the AI service.
         *
         *     @type bool   $success Whether the request was successful.
         *     @type string $message The generated description or error message.
         * }
         */
        public function write($product, $prompt = '', $length = 'short')
        {
        }
        /**
         * Generates product attributes based on product name.
         *
         * Uses AI to create relevant product attributes (e.g., Color, Size, Material)
         * along with their possible values based on the product name.
         *
         * @since 1.16
         *
         * @param string $product        The name of the product to generate attributes for.
         * @param string $num_attributes Optional. Number of attributes to generate (e.g., "1-3").
         *                                Default "1-3".
         * @param string $num_values     Optional. Number of values per attribute (e.g., "2-5").
         *                                Default "2-5".
         *
         * @return array {
         *     Response from the AI service.
         *
         *     @type bool   $success Whether the request was successful.
         *     @type string $message The generated attributes or error message.
         * }
         */
        public function generate_attributes($product, $num_attributes = "1-3", $num_values = "2-5")
        {
        }
        /**
         * Designs a block template using AI.
         *
         * Generates a Gutenberg block template based on the provided prompt
         * and optionally based on a specific product.
         *
         * @since 1.16
         *
         * @param string $prompt  The instruction describing the desired block design.
         * @param string $product Optional. The product name to base the design on.
         *                        Default empty string.
         *
         * @return array {
         *     Response from the AI service.
         *
         *     @type bool   $success Whether the request was successful.
         *     @type string $message The generated block template or error message.
         * }
         */
        public function design($prompt, $product = '')
        {
        }
        /**
         * Generates an image based on a text prompt.
         *
         * Uses AI image generation to create a new image based on the provided
         * text description. This operation costs 50 AI credits.
         *
         * @since 1.16
         *
         * @param string $prompt   Optional. The text description of the image to generate.
         *                         Default empty string.
         * @param string $size     Optional. The dimensions of the image. Accepts '1024x1024',
         *                         '1024x1792', or '1792x1024'. Default '1024x1024'.
         * @param string $quality  Optional. The quality of the image. Accepts 'standard' or
         *                         'hd'. Default 'standard'.
         * @param mixed  $product   Optional. Product context for the image generation.
         *                         Default null.
         *
         * @return array {
         *     Response from the AI service.
         *
         *     @type bool   $success Whether the request was successful.
         *     @type string $message The response message or error message.
         *     @type string $url     The URL of the generated image (if successful).
         * }
         */
        public function draw($prompt = '', $size = '1024x1024', $quality = 'standard', $product = null)
        {
        }
        /**
         * Edits an existing image based on a text prompt.
         *
         * Uses AI image editing to modify an existing image according to the
         * provided text description. This operation costs 50 AI credits.
         *
         * @since 1.16
         *
         * @param string $image   The image to edit (URL or base64 encoded).
         * @param string $prompt  The text description of how to edit the image.
         * @param string $size     Optional. The dimensions of the output image.
         *                         Accepts '1024x1024', '1024x1792', or '1792x1024'.
         *                         Default '1024x1024'.
         * @param string $quality  Optional. The quality of the output image.
         *                         Accepts 'standard' or 'hd'. Default 'standard'.
         *
         * @return array {
         *     Response from the AI service.
         *
         *     @type bool   $success Whether the request was successful.
         *     @type string $message The response message or error message.
         *     @type string $url     The URL of the edited image (if successful).
         * }
         */
        public function edit_image($image, $prompt, $size = '1024x1024', $quality = 'standard')
        {
        }
        /**
         * Extracts a product search keyword from a natural-language query.
         *
         * Passes the real product catalog to the AI so it can pick the closest
         * matching product name or keyword. Returns null when the query does not
         * clearly map to any known product (e.g. profanity, nonsense, off-topic).
         *
         * @param string $query         The raw search string entered by the user.
         * @param array  $product_titles All product titles from the store.
         *
         * @return array|null Associative array with 'search' key, or null on failure / no match.
         */
        public function search_intent(string $query, array $product_titles = []): ?array
        {
        }
    }
}
namespace EasyCommerce\Traits {
    trait Limiter
    {
        /**
         * Meta key for the request count.
         *
         * @var string
         */
        private $count_key = '_request_count';
        /**
         * Meta key for the first request time.
         *
         * @var string
         */
        private $time_key = '_first_request_time';
        /**
         * Check the rate limit for a user.
         *
         * @param int $user_id The user ID.
         * @param int $limit The maximum number of requests allowed within the interval. Default is 100.
         * @param int $interval The time interval in seconds within which the requests are limited. Default is 3600 (1 hour).
         *
         * @return bool True if the request is within the limit, false if the limit is exceeded.
         */
        private function check_rate_limit($user_id, $limit = 100, $interval = 3600)
        {
        }
    }
}
/**
 * @package EasyCommerce
 *
 * Plugin Name: EasyCommerce
 * Plugin URI: https://wordpress.org/plugins/easycommerce/
 * Author: EasyCommerce
 * Author URI: https://easycommerce.dev/
 * Description: AI-Powered Ecommerce To Sell Physical & Digital Products
 * Version: 1.47
 * Requires at least: 6.0
 * Tested up to: 7.0
 * Requires PHP: 7.4
 * Text Domain: easycommerce
 * Domain Path: /languages
 * License:     GPLv2 or later
 * License URI: http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 *
 * EasyCommerce is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * any later version.
 *
 * EasyCommerce is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 */
namespace EasyCommerce {
    function easycommerce_install()
    {
    }
    function easycommerce_activate()
    {
    }
    function easycommerce_initialize()
    {
    }
    function easycommerce_uninstall()
    {
    }
}
namespace {
    /**
     * Retrieves the Stripe API version being used.
     *
     * @return string The Stripe API version.
     */
    function easycommerce_stripe_get_api_version(): string
    {
    }
    /**
     * Checks if Stripe is configured in sandbox mode.
     *
     * @return bool True if sandbox mode is enabled, false otherwise.
     */
    function easycommerce_stripe_is_sandbox(): bool
    {
    }
    /**
     * Retrieves the Stripe publishable key based on the current mode (sandbox or live).
     *
     * @return string The publishable key for Stripe integration.
     */
    function easycommerce_stripe_get_publishable_key(): string
    {
    }
    /**
     * Retrieves the Stripe secret key based on the current mode (sandbox or live).
     *
     * @return string The secret key for Stripe API authentication.
     */
    function easycommerce_stripe_get_secret_key(): string
    {
    }
    /**
     * Retrieves the Stripe webhook signing secret based on the current mode (sandbox or live).
     *
     * @return string The webhook signing secret for verifying webhook authenticity.
     */
    function easycommerce_stripe_get_webhook_secret(): string
    {
    }
    /**
     * Updates the Stripe webhook signing secret in the database.
     *
     * @param string $signing_secret The new webhook signing secret from Stripe.
     *
     * @return void
     */
    function easycommerce_stripe_update_webhook_secret(string $signing_secret): void
    {
    }
    /**
     * Checks if Stripe payment gateway is properly configured and ready for use.
     *
     * @return bool True if both publishable and secret keys are configured, false otherwise.
     */
    function easycommerce_stripe_is_ready(): bool
    {
    }
    /**
     * Generates the webhook URL for Stripe webhook endpoints.
     *
     * @return string The full REST API URL for Stripe webhooks.
     */
    function easycommerce_stripe_get_webhook_url(): string
    {
    }
    /**
     * Validates a URL for public accessibility, HTTPS, and ensures it's not a local/test domain.
     *
     * @param string $url The URL to validate.
     *
     * @return bool True if valid, false otherwise.
     */
    function easycommerce_stripe_is_valid_domain_url(string $url): bool
    {
    }
    /**
     * Retrieves or creates a singleton instance of the Stripe API client.
     *
     * @return \Stripe\StripeClient|null The configured Stripe API client instance or null if API key is empty.
     */
    function easycommerce_stripe_get_api_client()
    {
    }
    /**
     * Filter payment methods based on currency compatibility.
     *
     * Used by the SetupIntent (recurring) path and by client-side localisation. The
     * non-recurring PaymentIntent path no longer calls this — it relies on Stripe's
     * automatic payment methods to filter by account country, currency and amount,
     * which is authoritative and self-updating (e.g. Klarna's currency support that
     * varies by Stripe account country).
     *
     * @link https://docs.stripe.com/payments/payment-methods/dynamic-payment-methods
     * @link https://docs.stripe.com/payments/klarna Klarna currency by account country.
     *
     * @param array  $payment_methods List of payment method types.
     * @param string $currency        Currency code (lowercase).
     *
     * @return array Filtered payment methods compatible with the currency.
     */
    function easycommerce_stripe_filter_payment_methods_by_currency($payment_methods, $currency)
    {
    }
    /**
     * Filter out only the wallets Stripe rejects as explicit Payment Element
     * paymentMethodTypes. `apple_pay` and `google_pay` are NOT valid types — passing
     * them throws and breaks the whole element; the Payment Element instead surfaces
     * them automatically as buttons when the shopper's browser/device supports them.
     * Every other wallet (alipay, amazon_pay, cashapp, wechat_pay, link, samsung_pay,
     * kakao_pay, mb_way, naver_pay, payco) is a valid type and stays so it renders.
     *
     * @param array $payment_methods List of payment method types.
     *
     * @return array Filtered payment methods without the non-listable express wallets.
     */
    function easycommerce_stripe_filter_wallet_payment_methods($payment_methods)
    {
    }
    /**
     * Single source of truth for Stripe payment method minimum transaction amounts.
     *
     * Keyed by method, then lowercase currency code, value in cents. Shared by the
     * server-side filter and localized to the client (stripe-payment.js) so both
     * sides apply identical thresholds. These are public Stripe limits, not secrets.
     *
     * @return array<string, array<string, int>> Minimum amounts in cents.
     */
    function easycommerce_stripe_payment_method_minimums()
    {
    }
    /**
     * Single source of truth for Stripe payment method maximum transaction amounts.
     *
     * Keyed by method, then lowercase currency code, value in cents. Shared by the
     * server-side filter and localized to the client (stripe-payment.js) so both
     * sides apply identical thresholds. These are public Stripe limits, not secrets.
     *
     * @return array<string, array<string, int>> Maximum amounts in cents.
     */
    function easycommerce_stripe_payment_method_maximums()
    {
    }
    /**
     * Filter payment methods based on both minimum and maximum transaction amounts.
     *
     * @param array  $payment_methods List of payment method types.
     * @param int    $amount_in_cents Transaction amount in cents.
     * @param string $currency        Currency code (lowercase).
     *
     * @return array Filtered payment methods within the allowed amount range.
     */
    function easycommerce_stripe_filter_payment_methods_by_amount($payment_methods, $amount_in_cents, $currency)
    {
    }
    function easycommerce_dev_store($path = '')
    {
    }
    function easycommerce_dev_docs($path = '')
    {
    }
    /**
     * Whether a Generative AI feature is enabled in settings.
     *
     * Reads the raw option array directly instead of Utility::get_option(): that
     * helper treats a stored "0" as empty and falls back to its default, which would
     * make the disabled state unreachable for a default-on checkbox. Defaults to
     * enabled when the feature key has never been saved (matches the field defaults
     * in app/Config/settings.php → ai → generative-ai).
     *
     * @param string $feature Feature key: 'text_generator', 'image_generator',
     *                        'template_generator', 'attribute_generator'.
     * @return bool
     */
    function easycommerce_is_ai_feature_enabled($feature)
    {
    }
    /**
     * Whether the stock availability badge is enabled in store settings.
     *
     * Reads the option array directly rather than Utility::get_option(), which
     * treats a saved "off" value as empty. Defaults to enabled on a fresh install
     * where the setting has not been saved yet.
     *
     * @return bool
     */
    function easycommerce_is_stock_badge_enabled()
    {
    }
    /**
     * Returns the home URL of the WordPress site.
     *
     * @param string $path    Optional. Path relative to the home URL.
     * @param int    $blog_id Optional. ID of the blog in a multisite installation.
     *
     * @return string Home URL with optional path appended.
     */
    function easycommerce_home_url($path = '', $blog_id = \null)
    {
    }
    /**
     * Returns the EasyCommerce community space URL.
     *
     * Single source for every community link in the admin (dashboard card, header,
     * setup wizard, help page), surfaced to the SPA as `EASYCOMMERCE.community_url`.
     *
     * @return string Community URL.
     */
    function easycommerce_community_url()
    {
    }
    function easycommerce_shop_page($url = \false)
    {
    }
    function easycommerce_checkout_page($url = \false)
    {
    }
    function easycommerce_dashboard_page($url = \false)
    {
    }
    function easycommerce_registration_page($url = \false)
    {
    }
    function easycommerce_terms_of_service_page($url = \false)
    {
    }
    function easycommerce_privacy_policy_page($url = \false)
    {
    }
    function easycommerce_reset_password_page($url = \false)
    {
    }
    function easycommerce_payment_page($url = \false)
    {
    }
    /**
     * Ensure the core store pages (dashboard, shop, checkout, payment) exist.
     *
     * Idempotent: reuses any already-created pages stored in the
     * `easycommerce-general-store` option and only creates the missing ones, so
     * it is safe to run on install (via the background cron) and again from the
     * setup wizard without producing duplicate pages.
     *
     * @param array $overrides Optional page overrides keyed by slug (page ID or 'create').
     * @return array The resolved store option group.
     */
    function easycommerce_ensure_store_pages($overrides = array())
    {
    }
    /**
     * Resolve a store-pattern image URL (hero backgrounds, promo/category art).
     *
     * Centralised + filterable so the image source can be switched between the CDN
     * and a locally-bundled directory without touching pattern markup. Default is
     * the CDN; filter `easycommerce_pattern_image_base` to point at bundled assets
     * (e.g. EASYCOMMERCE_ASSETS_URL . 'public/img/patterns/').
     *
     * @param string $file Image filename (e.g. gadget-hero-1.jpg); see PATTERN-IMAGES.md.
     * @return string Full image URL.
     */
    function easycommerce_pattern_image($file)
    {
    }
    /**
     * Returns the ready-made store designs registry.
     *
     * @return array Design id => design definition (see app/Config/store-designs.php).
     */
    function easycommerce_store_designs()
    {
    }
    /**
     * Returns a single store design definition, or null.
     *
     * @param string $design_id Design id, e.g. grocery|gadget|furniture.
     * @return array|null
     */
    function easycommerce_get_store_design($design_id)
    {
    }
    /**
     * Expand nested `wp:pattern` references into their registered block markup.
     *
     * Page patterns are composed of section patterns via `wp:pattern` references.
     * Expanding them into a page's content produces self-contained, individually
     * editable markup (rather than opaque pattern-reference blocks).
     *
     * @param string $content Block markup that may contain wp:pattern references.
     * @param int    $depth   Internal recursion guard.
     * @return string Expanded block markup.
     */
    function easycommerce_expand_pattern($content, $depth = 0)
    {
    }
    /**
     * Apply a ready-made store design.
     *
     * Creates (or idempotently updates) the design's home and shop pages from its
     * page patterns, aligns the shop grid to the design's shop
     * template, persists the applied design id and its colour/typography preset,
     * and tags the created pages as design content so they can be removed cleanly.
     *
     * Does NOT set the static front page — that is handled at wizard completion
     * (#3174), with an "ask before overwrite" prompt. Theme-aware preset rendering
     * is handled in #3175; here we only persist the preset and fire an action.
     *
     * @param string $design_id Design id, e.g. grocery|gadget|furniture.
     * @return array|false The updated `easycommerce-general-store` group, or false if unknown.
     */
    function easycommerce_apply_store_design($design_id)
    {
    }
    /**
     * Whether the active theme is a block (FSE) theme.
     *
     * @return bool
     */
    function easycommerce_is_block_theme()
    {
    }
    /**
     * Whether the active theme can render the store designs acceptably.
     *
     * Both block and classic themes are supported (block themes use theme.json
     * tokens; classic themes use the scoped store-patterns.css fallback). This is a
     * hook point so an add-on can flag a specific broken theme and let the wizard
     * (#3174) show an honest notice instead of shipping something broken.
     *
     * @return bool
     */
    function easycommerce_is_theme_supported()
    {
    }
    /**
     * Returns the colour/typography preset of the applied store design, or null.
     *
     * @return array|null
     */
    function easycommerce_store_design_preset()
    {
    }
    /**
     * Default design tokens, merged beneath a design's own `tokens`.
     *
     * Guarantees the CSS generator always has a complete token set — even for a
     * custom design registered via the `easycommerce_store_designs` filter without
     * a full `tokens` array. These defaults reproduce the neutral pre-token look
     * (medium radius, subtle shadow, 8px rhythm) so custom designs render sanely.
     *
     * @return array
     */
    function easycommerce_store_design_default_tokens()
    {
    }
    /**
     * Build the scoped CSS that renders the applied design's full token system onto
     * the store patterns — a distinct design system per design, not a re-skin.
     *
     * Emits: an 8-step spacing scale (redefining the `--wp--preset--spacing--*`
     * tokens the patterns consume, so rhythm changes with no pattern edits), radius
     * and elevation custom properties, the button system, product-card treatment,
     * section transitions and heading scale. Colours/fonts included.
     *
     * Scoped to `.ec-pattern` (every pattern's root) and `.ec-product-collection`
     * (our grid block's wrapper) — both EasyCommerce-only, so the skin never leaks
     * onto the native shop archive or the rest of the theme. Loads on both block
     * and classic themes; the applied design is the single source of truth, so
     * `.ec-pattern` scoping is sufficient (only one design is live per site).
     *
     * @param string $scope Optional selector prefix (e.g. `.editor-styles-wrapper `
     *                      to mirror the design inside the block editor canvas).
     * @return string CSS, or '' when no design is applied.
     */
    function easycommerce_store_design_preset_css($scope = '')
    {
    }
    function send_reset_password_email($user_data, $key)
    {
    }
    function easycommerce_rest_base()
    {
    }
    function easycommerce_single_product_patterns()
    {
    }
    function easycommerce_checkout_template()
    {
    }
    function easycommerce_checkout_templates()
    {
    }
    function easycommerce_refund_reasons()
    {
    }
    function easycommerce_product_sort_options()
    {
    }
    function easycommerce_email_events()
    {
    }
    function easycommerce_email_default($event)
    {
    }
    function easycommerce_order_statuses()
    {
    }
    function easycommerce_get_all_payment_methods()
    {
    }
    function easycommerce_product_statuses()
    {
    }
    function easycommerce_global_default_status()
    {
    }
    function easycommerce_fulfill_statuses()
    {
    }
    function easycommerce_length_units()
    {
    }
    function easycommerce_weight_units()
    {
    }
    function easycommerce_weight_unit_conversion($baseUnit = 'g')
    {
    }
    function easycommerce_time_units()
    {
    }
    function easycommerce_get_field_factory($type)
    {
    }
    function easycommerce_product_post_type()
    {
    }
    function easycommerce_get_cart()
    {
    }
    function easycommerce_get_cart_hash()
    {
    }
    function easycommerce_add_payment_method_icons($methods)
    {
    }
    function easycommerce_payment_methods()
    {
    }
    /**
     * @return array of payment method IDs
     */
    function easycommerce_active_payment_methods()
    {
    }
    function easycommerce_payment_method_class($method)
    {
    }
    function easycommerce_cart_redirect()
    {
    }
    function easycommerce_order_redirect($order_id)
    {
    }
    function easycommerce_date_ranges()
    {
    }
    // get_range_dates
    function easycommerce_get_range_dates($range, $custom_from = \null, $custom_to = \null)
    {
    }
    /**
     * The cache wrapper
     */
    function easycommerce_cache()
    {
    }
    /**
     * Get an associative list of countries
     *
     * @return array [ 'BD' => 'Bangladesh', ... ]
     */
    function easycommerce_countries()
    {
    }
    /**
     * Get an associative list of currencies
     *
     * @return []
     */
    function easycommerce_currencies($label = 'currency_name')
    {
    }
    function easycommerce_currency_format_options()
    {
    }
    function easycommerce_menus()
    {
    }
    /**
     * @see app/Config/settings.php
     */
    function easycommerce_settings_menus()
    {
    }
    function easycommerce_render_sidebar()
    {
    }
    function easycommerce_render_menu_item($item)
    {
    }
    /**
     * @see app/Config/order-fields.php
     */
    function easycommerce_checkout_fields($section = '')
    {
    }
    function easycommerce_custom_checkout_fields($sections = '')
    {
    }
    function easycommerce_get_file_type($filename)
    {
    }
    function easycommerce_format_size($bytes)
    {
    }
    function easycommerce_currency()
    {
    }
    function easycommerce_currency_format()
    {
    }
    function easycommerce_currency_symbol()
    {
    }
    /**
     * Formats price
     */
    function easycommerce_price($price)
    {
    }
    function easycommerce_secure_download($media_id)
    {
    }
    function easycommerce_get_business_types()
    {
    }
    function easycommerce_get_product($product_id)
    {
    }
    function easycommerce_order_placeholders($order_id)
    {
    }
    function easycommerce_cart_placeholders($cart)
    {
    }
    function easycommerce_generate_random_coupon_code()
    {
    }
    function easycommerce_is_api_connected()
    {
    }
    /**
     * Returns true if the current page is a product page.
     *
     * @return bool
     */
    function easycommerce_is_product(): bool
    {
    }
    /**
     * Returns true if the current page is the shop page.
     *
     * @return bool
     */
    function easycommerce_is_shop(): bool
    {
    }
    /**
     * Returns true if the current page is the checkout page.
     *
     * @return bool
     */
    function easycommerce_is_checkout(): bool
    {
    }
    function easycommerce_is_payment_page(): bool
    {
    }
    /**
     * Returns true if the current page is the account page.
     *
     * @return bool
     */
    function easycommerce_is_dashboard(): bool
    {
    }
    /**
     * Returns true if the current page is one of the EasyCommerce pages.
     *
     * @return bool
     */
    function is_easycommerce_page(): bool
    {
    }
    /**
     * Import a remote image URL into WP Media Library.
     *
     * @param string $url     Remote image URL.
     * @param int    $post_id Optional post ID to attach to (0 = unattached).
     * @param string $desc    Optional attachment description.
     * @return array|WP_Error {
     *     On success: [
     *         'attachment_id' => int,
     *         'url'           => string,
     *         'file'          => string, // full path
     *         'mime'          => string,
     *         'width'         => int,
     *         'height'        => int,
     *         'sizes'         => array,
     *     ]
     *     On failure: WP_Error
     * }
     */
    function easycommerce_import_image($url, $post_id = 0, $desc = '')
    {
    }
    function easycommerce_import_encoded_image($data, $post_id = 0, $desc = '')
    {
    }
    function easycommerce_is_paid_addon_active()
    {
    }
    /**
     * Single source of truth for the client's AI credit/plan state.
     *
     * One option (`easycommerce_ai`) holds everything: plan, monthly allowance,
     * usage, remaining balance, next reset date and the last hub-sync timestamp. It
     * replaces the legacy `easycommerce_ai_credits` + `easycommerce_ai_plan` options
     * and the status transient, migrating them once on first read.
     *
     * @return array { plan, plan_name, limit, used, remaining, next_refresh, synced_at }
     */
    function easycommerce_ai_data()
    {
    }
    /**
     * Merge a partial update into the single AI state option.
     *
     * @param array $patch Keys to overwrite.
     * @return array The full, updated state.
     */
    function easycommerce_ai_update(array $patch)
    {
    }
    function easycommerce_get_ai_credits()
    {
    }
    /**
     * Server-side onboarding/engagement snapshot for the deactivation survey.
     *
     * Every value is derived from existing WordPress state (options, post counts,
     * the ec_orders table) — nothing is tracked client-side, so it can't be spoofed
     * and costs the user no effort. Booleans are emitted as 'yes'/'no' strings and
     * counts are bucketed so the values map cleanly onto FluentCRM custom-field
     * filters/segments on the hub. Attached to the feedback body by
     * Connectivity::feedback() and forwarded to the CRM as ec_* custom fields.
     *
     * @return array
     */
    function easycommerce_onboarding_snapshot()
    {
    }
    /**
     * The telemetry event vocabulary understood by the hub.
     *
     * @since 1.45
     * @return string[]
     */
    function easycommerce_telemetry_events()
    {
    }
    /**
     * Resolve which telemetry event a submission represents.
     *
     * An explicit event wins. Anything else falls back to the legacy shape so an
     * older caller (or a third-party one) still classifies correctly.
     *
     * @since 1.45
     * @param string $event       Explicit event name, if any.
     * @param int    $deactivated Legacy deactivation flag.
     * @param string $subject     Submitted subject.
     * @return string
     */
    function easycommerce_telemetry_event($event, $deactivated = 0, $subject = '')
    {
    }
    /**
     * Whether the store owner consented to sharing diagnostics/usage data.
     *
     * Gates the passive site snapshot only — what the owner actually typed into a
     * feedback or deactivation form is their own submission and always goes.
     *
     * Sources, in precedence order:
     * - `easycommerce_share_data`, the standalone mirror written by the wizard. This
     *   is authoritative: the `general-business` option group it also lives in gets
     *   replaced wholesale on every settings save, so the group copy cannot be
     *   trusted to survive.
     * - `share_data` in the `easycommerce-general-business` group (the wizard's
     *   Business step checkbox), for installs saved before the mirror existed.
     * - `_easycommerce-no_tracking`, written by the wizard's older `dont_share_data`
     *   field (it was never read anywhere until now).
     *
     * Installs that predate the checkbox have none of these; they keep their existing
     * behaviour rather than silently going dark.
     *
     * @since 1.45
     * @return bool
     */
    function easycommerce_can_share_data()
    {
    }
    function easycommerce_deduct_ai_credits($deduct = 1, $credits = \null)
    {
    }
    /**
     * Fetch the authoritative monthly AI credit status from the hub.
     *
     * Returns the plan, monthly allowance, usage, remaining balance and the next
     * reset date from the single `easycommerce_ai` option. Re-syncs from the hub
     * when the cached state is older than 10 minutes (tracked via `synced_at`).
     * Falls back to the locally-stored state when the hub is unreachable or no
     * account is connected.
     *
     * @param bool $force Skip the freshness check and re-fetch.
     * @return array See easycommerce_ai_data().
     */
    function easycommerce_ai_status($force = \false)
    {
    }
    function easycommerce_get_conflicting_plugins()
    {
    }
    function easycommerce_detect_external_plugins_for_migration()
    {
    }
    function easycommerce_get_migratable_platforms()
    {
    }
    function easycommerce_is_compatible_theme_active()
    {
    }
    function easycommerce_compatible_themes()
    {
    }
    function easycommerce_get_user_country()
    {
    }
    function easycommerce_business_address_1()
    {
    }
    function easycommerce_business_address_2()
    {
    }
    function easycommerce_business_state()
    {
    }
    function easycommerce_business_city()
    {
    }
    function easycommerce_business_postcode()
    {
    }
    function easycommerce_business_country()
    {
    }
    function easycommerce_business_full_address(): string
    {
    }
}