Seven Gum Commerce: %s
%s
]
+ * : Restrict to one marketplace.
+ *
+ * [--limit=]
+ * : Maximum products to process (default 20).
+ */
+ public function describe_all( array $args, array $assoc ): void {
+ global $wpdb;
+ $market = isset( $assoc['market'] ) ? strtoupper( (string) $assoc['market'] ) : '';
+ $limit = isset( $assoc['limit'] ) ? max( 1, (int) $assoc['limit'] ) : 20;
+
+ $where = "WHERE NOT EXISTS (SELECT 1 FROM {$wpdb->prefix}sg_descriptions d WHERE d.product_id = p.id AND d.language='en')";
+ $params = array();
+ if ( '' !== $market ) {
+ $where .= ' AND market = %s';
+ $params[] = $market;
+ }
+ $sql = "SELECT id FROM {$wpdb->prefix}sg_products p {$where} LIMIT %d";
+ $params[] = $limit;
+ $ids = $wpdb->get_col( $wpdb->prepare( $sql, ...$params ) );
+
+ if ( empty( $ids ) ) {
+ \WP_CLI::success( 'nothing to do' );
+ return;
+ }
+ $copywriter = $this->container()->get( Copywriter::class );
+ $progress = \WP_CLI\Utils\make_progress_bar( 'Describing', count( $ids ) );
+ $ok = 0; $fail = 0;
+ foreach ( $ids as $id ) {
+ try { $copywriter->describe( (int) $id ); $ok++; }
+ catch ( \Throwable $e ) { $fail++; \WP_CLI::warning( "{$id}: " . $e->getMessage() ); }
+ $progress->tick();
+ }
+ $progress->finish();
+ \WP_CLI::success( "described {$ok}, failed {$fail}" );
+ }
+
+ /**
+ * Translate one product's description into a market language.
+ *
+ *
+ * : Product id.
+ *
+ *
+ * : Target marketplace code.
+ */
+ public function translate( array $args, array $assoc ): void {
+ $id = (int) ( $args[0] ?? 0 );
+ $market = strtoupper( (string) ( $args[1] ?? '' ) );
+ if ( $id <= 0 || '' === $market ) {
+ \WP_CLI::error( 'usage: wp sg-commerce translate ' );
+ }
+ try {
+ $text = $this->container()->get( Copywriter::class )->translate( $id, $market );
+ \WP_CLI::log( $text );
+ \WP_CLI::success( 'translation saved' );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /** Run the repricer engine once. */
+ public function repricer_tick( array $args, array $assoc ): void {
+ try {
+ $result = $this->container()->get( RepricerEngine::class )->tick();
+ \WP_CLI::log( wp_json_encode( $result, JSON_PRETTY_PRINT ) );
+ \WP_CLI::success( 'repricer tick complete' );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /** Print high-level status. */
+ public function status( array $args, array $assoc ): void {
+ $c = $this->container();
+ $products = $c->get( ProductRepository::class );
+ $client = $c->get( AmazonClient::class );
+ $mp = $c->get( Marketplaces::class );
+
+ \WP_CLI::log( '── Seven Gum Commerce v' . SG_COMMERCE_VERSION . ' ──' );
+ \WP_CLI::log( 'Amazon credentials: ' . ( $client->has_credentials() ? 'configured' : 'NOT configured' ) );
+ \WP_CLI::log( 'Primary market: ' . $mp->primary() );
+ \WP_CLI::log( 'Enabled markets: ' . implode( ', ', $mp->enabled_codes() ) );
+ \WP_CLI::log( 'Products tracked: ' . $products->count_total() );
+ \WP_CLI::log( 'In stock: ' . $products->count_in_stock() );
+ \WP_CLI::log( 'Winning Buy Box: ' . $products->count_winning_buybox() );
+ \WP_CLI::log( 'Last sync: ' . ( $products->last_sync_at() ?? 'never' ) );
+ }
+
+ /**
+ * Refresh tracking for all pending MCF orders.
+ */
+ public function mcf_refresh( array $args, array $assoc ): void {
+ try {
+ $module = $this->container()->get( \SevenGum\Commerce\Fulfillment\FulfillmentModule::class );
+ $module->refresh_pending_tracking();
+ \WP_CLI::success( 'MCF tracking refreshed' );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /**
+ * List recent MCF orders.
+ *
+ * [--limit=]
+ * : Max rows (default 20).
+ */
+ public function mcf_list( array $args, array $assoc ): void {
+ $limit = isset( $assoc['limit'] ) ? max( 1, (int) $assoc['limit'] ) : 20;
+ $repo = $this->container()->get( \SevenGum\Commerce\Fulfillment\MCFOrderRepository::class );
+ $rows = $repo->recent( $limit );
+ if ( empty( $rows ) ) { \WP_CLI::log( 'No MCF orders.' ); return; }
+ \WP_CLI\Utils\format_items(
+ 'table',
+ array_map( static fn( $r ) => array(
+ 'id' => $r['id'],
+ 'order' => $r['displayable_order_id'],
+ 'market' => $r['market'],
+ 'status' => $r['status'],
+ 'customer' => $r['customer_name'],
+ 'created' => $r['created_at'],
+ ), $rows ),
+ array( 'id', 'order', 'market', 'status', 'customer', 'created' )
+ );
+ }
+
+ /**
+ * Probe the geo-resolver from CLI (useful for debugging headers).
+ */
+ public function geo( array $args, array $assoc ): void {
+ $resolver = $this->container()->get( \SevenGum\Commerce\Geotargeting\GeoResolver::class );
+ \WP_CLI::log( 'country: ' . $resolver->country() );
+ \WP_CLI::log( 'market: ' . $resolver->market() );
+ }
+
+ /**
+ * Run PII anonymization pass immediately.
+ */
+ public function pii_purge( array $args, array $assoc ): void {
+ try {
+ $count = $this->container()->get( \SevenGum\Commerce\Security\PIIManager\PIIManager::class )->purge_expired();
+ \WP_CLI::success( "Anonymized {$count} expired MCF orders." );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /**
+ * Resync all theme posts' prices + URLs from Amazon data.
+ */
+ public function theme_sync( array $args, array $assoc ): void {
+ try {
+ $updated = $this->container()->get( \SevenGum\Commerce\Integration\ThemeBridge::class )
+ ->on_sync_completed( array() );
+ \WP_CLI::success( 'Theme bridge resync complete.' );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /**
+ * Parse + import a local settlement report TSV file.
+ *
+ * ## OPTIONS
+ *
+ *
+ * : Path to the GET_V2_SETTLEMENT_REPORT TSV file.
+ *
+ * [--settlement-id=]
+ * : Settlement ID to tag these rows with (optional).
+ */
+ public function settlement_import( array $args, array $assoc ): void {
+ $path = (string) ( $args[0] ?? '' );
+ if ( '' === $path || ! file_exists( $path ) ) {
+ \WP_CLI::error( "File not found: {$path}" );
+ }
+ $content = (string) file_get_contents( $path );
+ $parser = new \SevenGum\Commerce\Amazon\ReportsParser\SettlementsParser();
+ $events = $parser->parse( $content );
+
+ $settlement_id = isset( $assoc['settlement-id'] ) ? sanitize_text_field( (string) $assoc['settlement-id'] ) : '';
+ global $wpdb;
+ $table = $wpdb->prefix . 'sg_settlements';
+ $imported = 0;
+ foreach ( $events as $e ) {
+ $result = $wpdb->insert( $table, array(
+ 'event_date' => $e['date'] ? gmdate( 'Y-m-d', strtotime( $e['date'] ) ) : null,
+ 'event_type' => $e['type'],
+ 'sku' => $e['sku'],
+ 'order_id' => $e['order_id'],
+ 'marketplace' => $e['marketplace'],
+ 'amount' => $e['amount'],
+ 'currency' => $e['currency'],
+ 'description' => substr( $e['description'], 0, 190 ),
+ 'settlement_id' => $settlement_id,
+ 'imported_at' => current_time( 'mysql', true ),
+ ), array( '%s', '%s', '%s', '%s', '%s', '%f', '%s', '%s', '%s', '%s' ) );
+ if ( false !== $result ) $imported++;
+ }
+ $summary = $parser->summary( $events );
+ \WP_CLI::log( "Parsed: {$summary['event_count']} events" );
+ foreach ( $summary['totals'] as $t => $amt ) {
+ \WP_CLI::log( sprintf( ' %-16s %10.2f', $t, $amt ) );
+ }
+ \WP_CLI::log( sprintf( " %-16s %10.2f", 'NET', $summary['net'] ) );
+ \WP_CLI::success( "Imported {$imported} rows." );
+ }
+
+ /**
+ * Poll SQS once (outside the normal cron).
+ */
+ public function sqs_poll( array $args, array $assoc ): void {
+ try {
+ $processed = $this->container()->get( \SevenGum\Commerce\Amazon\SQSConsumer\SQSConsumer::class )->poll();
+ \WP_CLI::success( "Processed {$processed} SQS messages." );
+ } catch ( \Throwable $e ) {
+ \WP_CLI::error( $e->getMessage() );
+ }
+ }
+
+ /**
+ * Mint a new API key for the Headless API. Prints the plaintext key ONCE.
+ *
+ * ', esc_html( $post->post_name )
+ ); ?>
+
+
+ + +
+ + sync_post( $post_id ); + } + + /** + * Shortcode: [sg_theme_price slug="cookie"] — used by the theme itself + * if it wants to show the live price with currency. + */ + public function shortcode_price( $atts ): string { + $atts = shortcode_atts( array( 'slug' => '', 'post_id' => 0 ), is_array( $atts ) ? $atts : array(), 'sg_theme_price' ); + $post_id = (int) $atts['post_id']; + if ( 0 === $post_id && '' !== (string) $atts['slug'] ) { + $post = get_page_by_path( (string) $atts['slug'], OBJECT, self::CPT ); + if ( $post ) $post_id = $post->ID; + } + if ( 0 === $post_id ) return ''; + $sku = (string) get_post_meta( $post_id, self::META_SKU, true ); + $market = (string) get_post_meta( $post_id, self::META_MARKET, true ) ?: $this->geo->market(); + if ( '' === $sku ) return ''; + $row = $this->products->find_by_sku( $market, $sku ); + if ( null === $row || null === $row['buybox_price'] ) return ''; + $currency = $row['buybox_currency'] ?: ( $this->marketplaces->get( $market )['currency'] ?? '' ); + return sprintf( + '%s %s', + esc_html( number_format( (float) $row['buybox_price'], 2 ) ), + esc_html( $currency ) + ); + } + + /** + * Shortcode: [sg_theme_buy slug="cookie"] — geotargeted Amazon button + * that also updates in place via the widget auto-refresh JS. + */ + public function shortcode_buy( $atts ): string { + $atts = shortcode_atts( + array( 'slug' => '', 'post_id' => 0, 'label' => '' ), + is_array( $atts ) ? $atts : array(), + 'sg_theme_buy' + ); + $post_id = (int) $atts['post_id']; + if ( 0 === $post_id && '' !== (string) $atts['slug'] ) { + $post = get_page_by_path( (string) $atts['slug'], OBJECT, self::CPT ); + if ( $post ) $post_id = $post->ID; + } + if ( 0 === $post_id ) return ''; + + $sku = (string) get_post_meta( $post_id, self::META_SKU, true ); + if ( '' === $sku ) return ''; + + // Geotargeted: use visitor's market, not the mapped one. + $market = $this->geo->market(); + $row = $this->products->find_by_sku( $market, $sku ); + + // Fallback: if we don't have this SKU in visitor's market, fall back to + // the mapped market. + if ( null === $row ) { + $mapped_market = (string) get_post_meta( $post_id, self::META_MARKET, true ); + if ( '' !== $mapped_market ) { + $row = $this->products->find_by_sku( $mapped_market, $sku ); + if ( null !== $row ) $market = $mapped_market; + } + } + + if ( null === $row || '' === $row['asin'] ) return ''; + + $url = $this->marketplaces->product_url( (string) $row['asin'], $market ); + $currency = $row['buybox_currency'] ?: ( $this->marketplaces->get( $market )['currency'] ?? '' ); + $price_str = null !== $row['buybox_price'] + ? number_format( (float) $row['buybox_price'], 2 ) . ' ' . $currency + : ''; + + $default_label = '' !== $price_str + ? sprintf( /* translators: %s: price */ __( 'Buy on Amazon — %s', 'sg-commerce' ), $price_str ) + : __( 'Buy on Amazon', 'sg-commerce' ); + $label = (string) $atts['label'] !== '' ? (string) $atts['label'] : $default_label; + + return sprintf( + '🛒 %s', + esc_url( $url ), + esc_attr( $sku ), + esc_attr( $market ), + esc_html( $label ) + ); + } +} diff --git a/sg-commerce-pro/src/Logging/Logger.php b/sg-commerce-pro/src/Logging/Logger.php new file mode 100644 index 0000000..a17cadb --- /dev/null +++ b/sg-commerce-pro/src/Logging/Logger.php @@ -0,0 +1,154 @@ + 'DEBUG', + self::INFO => 'INFO', + self::NOTICE => 'NOTICE', + self::WARNING => 'WARNING', + self::ERROR => 'ERROR', + self::CRITICAL => 'CRITICAL', + ); + + private ?string $log_dir = null; + private int $threshold; + + public function __construct() { + $settings = get_option( 'sg_commerce_settings', array() ); + $level = is_array( $settings ) ? (string) ( $settings['log_level'] ?? 'info' ) : 'info'; + $this->threshold = $this->level_from_name( $level ); + } + + public function debug ( string $msg, array $ctx = array() ): void { $this->log( self::DEBUG, $msg, $ctx ); } + public function info ( string $msg, array $ctx = array() ): void { $this->log( self::INFO, $msg, $ctx ); } + public function notice ( string $msg, array $ctx = array() ): void { $this->log( self::NOTICE, $msg, $ctx ); } + public function warning ( string $msg, array $ctx = array() ): void { $this->log( self::WARNING, $msg, $ctx ); } + public function error ( string $msg, array $ctx = array() ): void { $this->log( self::ERROR, $msg, $ctx ); } + public function critical( string $msg, array $ctx = array() ): void { $this->log( self::CRITICAL, $msg, $ctx ); } + + public function log( int $level, string $message, array $context = array() ): void { + if ( $level < $this->threshold ) { + return; + } + $record = array( + 'timestamp' => gmdate( 'c' ), + 'level' => self::LEVEL_NAMES[ $level ] ?? 'UNKNOWN', + 'message' => $message, + 'context' => $context, + ); + $encoded = wp_json_encode( $record, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE ); + + $file = $this->ensure_log_file(); + if ( null !== $file ) { + @file_put_contents( $file, $encoded . "\n", FILE_APPEND | LOCK_EX ); + } else { + // Fallback — at least keep the record findable. + error_log( '[SG Commerce] ' . $encoded ); + } + } + + public function get_log_dir(): ?string { + return $this->log_dir ?? $this->resolve_log_dir(); + } + + /** + * Read recent log lines for display in admin (most recent first). + * + * @return array
+
+
+
+ container;
+
+ $c->singleton( Shortcode::class, static fn( Container $c ) =>
+ new Shortcode(
+ $c->get( ProductRepository::class ),
+ $c->get( Marketplaces::class ),
+ $c->get( Copywriter::class )
+ )
+ );
+
+ add_shortcode( 'sg_product', function ( $atts ): string {
+ return $this->container->get( Shortcode::class )->render( $atts );
+ } );
+
+ add_action( 'wp_enqueue_scripts', array( $this, 'maybe_enqueue_assets' ) );
+ }
+
+ public function maybe_enqueue_assets(): void {
+ global $post;
+ // Only load on pages containing our shortcode.
+ if ( ! $post || ! has_shortcode( (string) $post->post_content, 'sg_product' ) ) {
+ return;
+ }
+ wp_enqueue_style(
+ 'sg-commerce-widget',
+ SG_COMMERCE_URL . 'assets/css/widget.css',
+ array(),
+ SG_COMMERCE_VERSION
+ );
+ wp_enqueue_script(
+ 'sg-commerce-widget',
+ SG_COMMERCE_URL . 'assets/js/widget.js',
+ array(),
+ SG_COMMERCE_VERSION,
+ true
+ );
+ wp_localize_script(
+ 'sg-commerce-widget',
+ 'SG_COMMERCE',
+ array( 'rest' => esc_url_raw( rest_url( 'sg-commerce/v1/' ) ) )
+ );
+ }
+}
diff --git a/sg-commerce-pro/tests/integration-smoke.php b/sg-commerce-pro/tests/integration-smoke.php
new file mode 100644
index 0000000..fd31119
--- /dev/null
+++ b/sg-commerce-pro/tests/integration-smoke.php
@@ -0,0 +1,161 @@
+ 'administrator', 'number' => 1 ) );
+wp_set_current_user( $admins[0]->ID );
+
+$fail = 0;
+$call = static function ( string $method, string $route, array $params = array() ) use ( &$fail ) {
+ $req = new WP_REST_Request( $method, '/sg-commerce/v1/suite' . $route );
+ if ( 'GET' === $method ) {
+ $req->set_query_params( $params );
+ } else {
+ $req->set_header( 'content-type', 'application/json' );
+ $req->set_body( wp_json_encode( $params ) );
+ }
+ $t = microtime( true );
+ $res = rest_do_request( $req );
+ $ms = (int) ( ( microtime( true ) - $t ) * 1000 );
+ $ok = $res->get_status() < 300;
+ if ( ! $ok ) {
+ $fail++;
+ }
+ printf( "%-4s %-34s %d %5dms %s\n", $method, $route, $res->get_status(), $ms, $ok ? '' : wp_json_encode( $res->get_data() ) );
+ return $res->get_data();
+};
+$assert = static function ( bool $cond, string $msg ) use ( &$fail ) {
+ if ( ! $cond ) {
+ $fail++;
+ echo "ASSERT FAILED: {$msg}\n";
+ }
+};
+
+$seed = $call( 'POST', '/demo', array() );
+echo 'seed counts: ' . wp_json_encode( $seed['counts'] ?? array() ) . "\n";
+$assert( ( $seed['counts']['orders'] ?? 0 ) > 500, 'demo orders seeded' );
+
+$o = $call( 'GET', '/overview' );
+$assert( isset( $o['periods']['mtd']['sales'] ), 'overview has MTD sales' );
+$assert( ( $o['totals_30']['sales'] ?? 0 ) > 0, '30-day sales > 0' );
+$assert( ( $o['totals_30']['amazon_fees'] ?? 0 ) < 0, 'fees negative' );
+$assert( ( $o['totals_30']['cogs'] ?? 0 ) < 0, 'cogs negative' );
+echo 'overview 30d: ' . wp_json_encode( array_intersect_key( $o['totals_30'], array_flip( array( 'orders', 'units', 'sales', 'refunds', 'amazon_fees', 'fees_estimated', 'account_fees', 'ads', 'cogs', 'expenses', 'net_profit', 'margin_pct', 'roi_pct', 'tacos_pct' ) ) ) ) . "\n";
+echo 'forecast: ' . wp_json_encode( $o['periods']['forecast'] ) . "\n";
+
+$p = $call( 'GET', '/profit', array( 'from' => gmdate( 'Y-m-d', strtotime( '-60 days' ) ) ) );
+$assert( count( $p['skus'] ?? array() ) >= 18, 'profit by sku rows' );
+$assert( count( $p['series'] ?? array() ) >= 60, 'profit daily series' );
+$assert( ! empty( $p['fee_breakdown'] ), 'fee breakdown' );
+
+$ord = $call( 'GET', '/orders' );
+$assert( count( $ord['orders'] ?? array() ) > 50, 'orders list' );
+$call( 'GET', '/orders', array( 'q' => 'SPEARMINT' ) );
+
+$c = $call( 'GET', '/costs' );
+$assert( count( $c['rows'] ?? array() ) >= 19, 'costs rows' );
+$call( 'POST', '/costs', array( 'rows' => array( array( 'sku' => 'DEMO-P1-LEMON', 'unit_cost' => 1.2, 'inbound_per_unit' => 0.1, 'lead_time_days' => 40 ) ) ) );
+$e = $call( 'POST', '/expenses', array( 'label' => 'Test expense', 'amount' => 10, 'recurrence' => 'once' ) );
+$call( 'GET', '/expenses' );
+$call( 'DELETE', '/expenses/' . (int) ( $e['id'] ?? 0 ) );
+
+$r = $call( 'GET', '/restock' );
+$assert( ( $r['summary']['skus'] ?? 0 ) >= 19, 'restock skus' );
+$statuses = array_count_values( array_column( $r['rows'] ?? array(), 'status' ) );
+echo 'restock statuses: ' . wp_json_encode( $statuses ) . "\n";
+$assert( isset( $statuses['out_of_stock'] ), 'restock has OOS sku' );
+$call( 'GET', '/inventory-health' );
+
+$a = $call( 'GET', '/ads/overview' );
+$assert( ( $a['totals']['cost'] ?? 0 ) > 0, 'ads spend' );
+$call( 'GET', '/ads/campaigns' );
+$call( 'GET', '/ads/targets' );
+$call( 'GET', '/ads/search-terms' );
+$plan = $call( 'POST', '/ads/optimize' );
+echo 'ppc plan: ' . wp_json_encode( $plan ) . "\n";
+$assert( ( $plan['bids'] ?? 0 ) + ( $plan['terms'] ?? 0 ) > 0, 'optimizer produced actions' );
+$acts = $call( 'GET', '/ads/actions' );
+$kinds = array_count_values( array_column( $acts['planned'] ?? array(), 'kind' ) );
+echo 'planned kinds: ' . wp_json_encode( $kinds ) . "\n";
+$ids = array_slice( array_map( 'intval', array_column( array_filter( $acts['planned'], static fn( $x ) => 'bid' === $x['kind'] ), 'id' ) ), 0, 2 );
+$ap = $call( 'POST', '/ads/apply', array( 'ids' => $ids ) );
+$assert( ( $ap['applied'] ?? 0 ) === count( $ids ), 'demo actions applied' );
+
+$k = $call( 'GET', '/keywords' );
+$assert( count( $k['rows'] ?? array() ) >= 10, 'tracked keywords' );
+$call( 'POST', '/keywords', array( 'asin' => 'B0DEMO0001', 'keywords' => "test keyword one\ntest keyword two" ) );
+$call( 'GET', '/keywords/queries', array( 'asin' => 'B0DEMO0001' ) );
+$call( 'POST', '/keywords/research', array( 'asins' => array( 'B0DEMO0001' ) ) );
+
+$l = $call( 'GET', '/listings' );
+$assert( count( $l['rows'] ?? array() ) >= 19, 'listing audits' );
+echo 'listing scores: ' . implode( ',', array_column( $l['rows'], 'score' ) ) . "\n";
+
+$m = $call( 'GET', '/monitor' );
+$assert( count( $m['hijacks'] ?? array() ) >= 1, 'hijacker detected in demo' );
+$call( 'GET', '/monitor/history', array( 'asin' => 'B0DEMO0006' ) );
+
+$rv = $call( 'GET', '/reviews' );
+echo 'reviews: ' . wp_json_encode( $rv['by_status'] ?? array() ) . "\n";
+
+$rb = $call( 'GET', '/reimbursements' );
+$kinds = array_count_values( array_column( $rb['rows'] ?? array(), 'kind' ) );
+echo 'reimbursement cases: ' . wp_json_encode( $kinds ) . ' value=' . array_sum( array_column( $rb['rows'], 'est_amount' ) ) . "\n";
+$assert( count( $rb['rows'] ?? array() ) > 0, 'reimbursement cases found' );
+if ( ! empty( $rb['rows'][0]['id'] ) ) {
+ $call( 'POST', '/reimbursements/' . (int) $rb['rows'][0]['id'], array( 'status' => 'filed', 'amazon_case_id' => '1234567890' ) );
+}
+
+$calc = $call( 'POST', '/research/calc', array( 'price' => 16.99, 'unit_cost' => 4.2, 'inbound' => 0.5, 'referral_pct' => 15, 'fba_fee' => 4.02, 'tacos_pct' => 10, 'return_pct' => 2 ) );
+echo 'calc: ' . wp_json_encode( $calc ) . "\n";
+$assert( abs( ( $calc['profit_per_unit'] ?? 0 ) - 3.5 ) < 1.5, 'calc profit sane' );
+
+$call( 'GET', '/traffic' );
+$call( 'GET', '/returns' );
+$call( 'GET', '/feedback' );
+$call( 'GET', '/alerts' );
+$call( 'GET', '/reports' );
+$s = $call( 'GET', '/settings' );
+$assert( ! isset( $s['settings']['ads_client_secret'] ), 'no secrets in settings payload' );
+$call( 'POST', '/settings', array( 'suite_ads_target_acos' => '25', 'ads_client_secret' => 'shh-secret-value' ) );
+$s2 = $call( 'GET', '/settings' );
+$assert( true === ( $s2['settings']['has_ads_client_secret'] ?? null ), 'secret stored flag' );
+$assert( ! str_contains( wp_json_encode( $s2 ), 'shh-secret-value' ), 'secret never echoed' );
+$raw = get_option( 'sg_commerce_secret_ads_client_secret' );
+$assert( is_string( $raw ) && ! str_contains( $raw, 'shh-secret-value' ), 'secret encrypted at rest' );
+
+// Permission check: anonymous must be rejected.
+wp_set_current_user( 0 );
+$res = rest_do_request( new WP_REST_Request( 'GET', '/sg-commerce/v1/suite/overview' ) );
+$assert( in_array( $res->get_status(), array( 401, 403 ), true ), 'anonymous rejected' );
+wp_set_current_user( $admins[0]->ID );
+
+// Remove the keywords this test added (they are not demo-flagged).
+\SevenGum\Commerce\Suite\Support\Db::exec( 'DELETE FROM {t:keywords} WHERE keyword LIKE %s', array( 'test keyword%' ) );
+$al = $call( 'GET', '/alerts' );
+$assert( count( $al['rows'] ?? array() ) >= 5, 'demo alerts seeded' );
+
+$call( 'DELETE', '/demo' );
+global $wpdb;
+$left = 0;
+foreach ( \SevenGum\Commerce\Suite\SuiteSchema::TABLES as $t ) {
+ if ( in_array( $t, array( 'reports', 'sku_costs' ), true ) ) {
+ continue;
+ }
+ $left += (int) $wpdb->get_var( 'SELECT COUNT(*) FROM ' . \SevenGum\Commerce\Suite\SuiteSchema::table( $t ) . ' WHERE is_demo = 1' );
+}
+$left += (int) $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}sg_products WHERE sku LIKE 'DEMO-%'" );
+$left += (int) $wpdb->get_var( "SELECT COUNT(*) FROM {$wpdb->prefix}sg_alerts WHERE context LIKE '%\"demo\":true%'" );
+$assert( 0 === $left, "demo fully cleared (left={$left})" );
+
+echo $fail ? "\nFAILED: {$fail}\n" : "\nALL OK\n";
diff --git a/sg-commerce-pro/tests/unit.php b/sg-commerce-pro/tests/unit.php
new file mode 100644
index 0000000..a3cf6eb
--- /dev/null
+++ b/sg-commerce-pro/tests/unit.php
@@ -0,0 +1,266 @@
+ $c, 'CurrencyAmount' => $v );
+}
+
+/* -------------------------------------------------------------------- */
+echo "FinancialEventFlattener\n";
+$events = array(
+ 'ShipmentEventList' => array( array(
+ 'AmazonOrderId' => '111-1', 'PostedDate' => '2026-09-10T12:00:00Z', 'MarketplaceName' => 'Amazon.com',
+ 'ShipmentItemList' => array( array(
+ 'SellerSKU' => 'SKU-A', 'QuantityShipped' => 2,
+ 'ItemChargeList' => array(
+ array( 'ChargeType' => 'Principal', 'ChargeAmount' => money( 33.98 ) ),
+ array( 'ChargeType' => 'Tax', 'ChargeAmount' => money( 2.46 ) ),
+ ),
+ 'ItemFeeList' => array(
+ array( 'FeeType' => 'Commission', 'FeeAmount' => money( -5.10 ) ),
+ array( 'FeeType' => 'FBAPerUnitFulfillmentFee', 'FeeAmount' => money( -8.04 ) ),
+ ),
+ 'PromotionList' => array( array( 'PromotionType' => 'PromotionMetaDataDefinitionValue', 'PromotionAmount' => money( -3.40 ) ) ),
+ 'ItemTaxWithheldList' => array( array( 'TaxesWithheld' => array( array( 'ChargeType' => 'MarketplaceFacilitatorTax-Principal', 'ChargeAmount' => money( -2.46 ) ) ) ) ),
+ ) ),
+ ) ),
+ 'RefundEventList' => array( array(
+ 'AmazonOrderId' => '111-0', 'PostedDate' => '2026-09-11T08:00:00Z',
+ 'ShipmentItemAdjustmentList' => array( array(
+ 'SellerSKU' => 'SKU-A', 'QuantityShipped' => 1,
+ 'ItemChargeAdjustmentList' => array( array( 'ChargeType' => 'Principal', 'ChargeAmount' => money( -16.99 ) ) ),
+ 'ItemFeeAdjustmentList' => array(
+ array( 'FeeType' => 'Commission', 'FeeAmount' => money( 2.04 ) ),
+ array( 'FeeType' => 'RefundCommission', 'FeeAmount' => money( -0.51 ) ),
+ ),
+ ) ),
+ ) ),
+ 'ServiceFeeEventList' => array( array( 'FeeList' => array( array( 'FeeType' => 'FBAStorageFee', 'FeeAmount' => money( -42.17 ) ) ) ) ),
+ 'AdjustmentEventList' => array( array(
+ 'AdjustmentType' => 'WAREHOUSE_DAMAGE', 'PostedDate' => '2026-09-12T00:00:00Z',
+ 'AdjustmentItemList' => array( array( 'SellerSKU' => 'SKU-A', 'Quantity' => 2, 'TotalAmount' => money( 19.80 ) ) ),
+ ) ),
+ 'ProductAdsPaymentEventList' => array( array( 'postedDate' => '2026-09-13T00:00:00Z', 'transactionType' => 'Charge', 'invoiceId' => 'INV1', 'transactionValue' => money( 250.00 ) ) ),
+);
+$lines = FinancialEventFlattener::flatten( $events, '2026-09-30T00:00:00Z' );
+$by = array();
+foreach ( $lines as $l ) {
+ $by[ $l['category'] ] = ( $by[ $l['category'] ] ?? 0 ) + $l['amount'];
+}
+check( 'revenue = principal only', near( $by['revenue'] ?? 0, 33.98 ) );
+check( 'tax nets to zero (collected + withheld)', near( $by['tax'] ?? 1, 0.0 ) );
+check( 'fees include item, refund and storage fees', near( $by['fee'] ?? 0, -5.10 - 8.04 + 2.04 - 0.51 - 42.17 ) );
+check( 'promotion captured', near( $by['promo'] ?? 0, -3.40 ) );
+check( 'refund principal negative', near( $by['refund'] ?? 0, -16.99 ) );
+check( 'warehouse damage is a reimbursement', near( $by['reimbursement'] ?? 0, 19.80 ) );
+check( 'ads invoice negative', near( $by['ads'] ?? 0, -250.0 ) );
+$units = array_sum( array_map( static fn( $l ) => 'revenue' === $l['category'] ? $l['qty'] : 0, $lines ) );
+check( 'units attributed once on Principal', 2 === $units, (string) $units );
+$refund_units = array_sum( array_map( static fn( $l ) => 'refund' === $l['category'] ? $l['qty'] : 0, $lines ) );
+check( 'refund units negative', -1 === $refund_units );
+$storage = array_values( array_filter( $lines, static fn( $l ) => 'FBAStorageFee' === $l['charge_type'] ) );
+check( 'ServiceFeeEvent without PostedDate uses window end', '2026-09-30T00:00:00Z' === ( $storage[0]['posted'] ?? '' ) );
+check( 'payout identity: Σ amount == net', near( array_sum( array_column( $lines, 'amount' ) ), 33.98 + 2.46 - 2.46 - 5.10 - 8.04 - 3.40 - 16.99 + 2.04 - 0.51 - 42.17 + 19.80 - 250.0 ) );
+check( 'hash is deterministic', FinancialEventFlattener::hash( $lines[0], 0 ) === FinancialEventFlattener::hash( $lines[0], 0 ) );
+check( 'hash ordinal disambiguates duplicates', FinancialEventFlattener::hash( $lines[0], 0 ) !== FinancialEventFlattener::hash( $lines[0], 1 ) );
+check( 'adjustment categories', 'fee' === FinancialEventFlattener::adjustment_category( 'FBAStorageFeeAdjustment' ) && 'adjustment' === FinancialEventFlattener::adjustment_category( 'ReserveDebit' ) );
+
+/* -------------------------------------------------------------------- */
+echo "ReportParser / ReportIngestor::date\n";
+$tsv = "amazon-order-id\tsku\tquantity\titem-price\n111-1\tSKU-A\t2\t33.98\r\n111-2\tSKU-B\t1\t\"4.99\"\n";
+$rows = ReportParser::tsv( $tsv );
+check( 'tsv rows', 2 === count( $rows ) );
+check( 'tsv header normalised', isset( $rows[0]['amazon-order-id'] ) && '33.98' === $rows[0]['item-price'] );
+check( 'tsv strips quotes', '4.99' === $rows[1]['item-price'] );
+check( 'gzip transparently decoded', 2 === count( ReportParser::tsv( gzencode( $tsv ) ) ) );
+check( 'Windows-1252 converted to UTF-8', 'Café' === ReportParser::tsv( "name\n" . "Caf\xE9" )[0]['name'] );
+check( 'BOM stripped from header', isset( ReportParser::tsv( "\xEF\xBB\xBFDate\tFNSKU\n1\t2" )[0]['date'] ) );
+check( 'header with spaces → hyphens', isset( ReportParser::tsv( "Event Type\tReference ID\nA\tB" )[0]['event-type'] ) );
+check( 'money US', near( ReportParser::money( '$1,234.50' ), 1234.50 ) );
+check( 'money EU', near( ReportParser::money( '1.234,50' ), 1234.50 ) );
+check( 'money EU decimal', near( ReportParser::money( '4,99' ), 4.99 ) );
+check( 'money negative', near( ReportParser::money( '-12.30' ), -12.30 ) );
+check( 'json gzip', 1 === ReportParser::json( gzencode( '[{"a":1}]' ) )[0]['a'] );
+check( 'date ISO', '2026-09-01' === ReportIngestor::date( '2026-09-01T07:00:00+00:00' ) );
+check( 'date US m/d/Y', '2026-09-05' === ReportIngestor::date( '09/05/2026' ) );
+check( 'date empty', null === ReportIngestor::date( '' ) );
+
+/* -------------------------------------------------------------------- */
+echo "BidOptimizer\n";
+$opt = new BidOptimizer( array( 'target_acos' => 30, 'min_clicks' => 12, 'max_step_pct' => 20, 'min_bid' => 0.2, 'max_bid' => 4, 'raise_low_impr' => true, 'neg_min_clicks' => 15, 'harvest_min_orders' => 2, 'avg_order_value' => 17 ) );
+$base = array( 'kind' => 'keyword', 'campaign_id' => 'C1', 'ad_group_id' => 'AG1', 'state' => 'ENABLED' );
+$plan = $opt->bids( array(
+ $base + array( 'target_id' => 'hi-acos', 'label' => 'a', 'bid' => 1.50, 'impressions' => 5000, 'clicks' => 100, 'cost' => 120, 'sales' => 200, 'orders' => 10 ),
+ $base + array( 'target_id' => 'lo-acos', 'label' => 'b', 'bid' => 0.50, 'impressions' => 5000, 'clicks' => 50, 'cost' => 25, 'sales' => 300, 'orders' => 15 ),
+ $base + array( 'target_id' => 'no-orders', 'label' => 'c', 'bid' => 1.00, 'impressions' => 3000, 'clicks' => 14, 'cost' => 9, 'sales' => 0, 'orders' => 0 ),
+ $base + array( 'target_id' => 'bleeder', 'label' => 'd', 'bid' => 1.00, 'impressions' => 3000, 'clicks' => 40, 'cost' => 40, 'sales' => 0, 'orders' => 0 ),
+ $base + array( 'target_id' => 'invisible', 'label' => 'e', 'bid' => 0.40, 'impressions' => 20, 'clicks' => 0, 'cost' => 0, 'sales' => 0, 'orders' => 0 ),
+ $base + array( 'target_id' => 'on-target', 'label' => 'f', 'bid' => 0.60, 'impressions' => 5000, 'clicks' => 100, 'cost' => 60, 'sales' => 200, 'orders' => 10 ),
+ array_merge( $base, array( 'state' => 'PAUSED' ) ) + array( 'target_id' => 'paused', 'label' => 'g', 'bid' => 1.0, 'impressions' => 0, 'clicks' => 50, 'cost' => 50, 'sales' => 0, 'orders' => 0 ),
+) );
+$a = array();
+foreach ( $plan as $p ) {
+ $a[ $p['entity_id'] ] = $p;
+}
+check( 'high ACoS → bid cut, capped at -20%', isset( $a['hi-acos'] ) && near( (float) $a['hi-acos']['new_value'], 1.20 ) );
+check( 'low ACoS → bid raised, capped at +20%', isset( $a['lo-acos'] ) && near( (float) $a['lo-acos']['new_value'], 0.60 ) );
+check( 'no orders after min clicks → cut', isset( $a['no-orders'] ) && near( (float) $a['no-orders']['new_value'], 0.80 ) );
+check( 'heavy bleeder (≥2× break-even CPA) → pause', 'pause' === ( $a['bleeder']['kind'] ?? '' ) );
+check( 'low impressions → raise half step', isset( $a['invisible'] ) && near( (float) $a['invisible']['new_value'], 0.44 ) );
+check( 'on-target keyword left alone', ! isset( $a['on-target'] ) );
+check( 'paused keywords ignored', ! isset( $a['paused'] ) );
+$clamp = ( new BidOptimizer( array( 'target_acos' => 90, 'max_step_pct' => 50, 'max_bid' => 1.0 ) ) )->bids( array(
+ $base + array( 'target_id' => 'x', 'label' => 'x', 'bid' => 0.9, 'impressions' => 900, 'clicks' => 10, 'cost' => 9, 'sales' => 100, 'orders' => 5 ),
+) );
+check( 'bids clamp to max_bid', near( (float) ( $clamp[0]['new_value'] ?? 0 ), 1.0 ) );
+
+$terms = $opt->search_terms( array(
+ array( 'search_term' => 'Sugar Free Gum Bulk', 'campaign_id' => 'AUTO', 'ad_group_id' => 'AGA', 'keyword_text' => 'close-match', 'match_type' => 'AUTO', 'impressions' => 900, 'clicks' => 20, 'cost' => 15, 'sales' => 85, 'orders' => 5 ),
+ array( 'search_term' => 'nicotine gum', 'campaign_id' => 'BROAD', 'ad_group_id' => 'AGB', 'keyword_text' => 'gum', 'match_type' => 'BROAD', 'impressions' => 900, 'clicks' => 22, 'cost' => 18, 'sales' => 0, 'orders' => 0 ),
+ array( 'search_term' => 'spearmint gum', 'campaign_id' => 'AUTO', 'ad_group_id' => 'AGA', 'keyword_text' => 'close-match', 'match_type' => 'AUTO', 'impressions' => 900, 'clicks' => 20, 'cost' => 10, 'sales' => 80, 'orders' => 4 ),
+ array( 'search_term' => 'b0abcdefgh', 'campaign_id' => 'AUTO', 'ad_group_id' => 'AGA', 'keyword_text' => 'substitutes', 'match_type' => 'AUTO', 'impressions' => 900, 'clicks' => 20, 'cost' => 10, 'sales' => 80, 'orders' => 4 ),
+ array( 'search_term' => 'bubble gum machine', 'campaign_id' => 'BROAD', 'ad_group_id' => 'AGB', 'keyword_text' => 'gum', 'match_type' => 'BROAD', 'impressions' => 900, 'clicks' => 30, 'cost' => 20, 'sales' => 0, 'orders' => 0 ),
+), array( 'spearmint gum' => true ), array( 'AGB|bubble gum machine' => true ), 'EXACT-C', 'EXACT-AG' );
+$k = array();
+foreach ( $terms as $t ) {
+ $k[ $t['entity_id'] ] = $t;
+}
+check( 'converting term harvested to exact destination', 'harvest' === ( $k['sugar free gum bulk']['kind'] ?? '' ) && 'EXACT-AG' === $k['sugar free gum bulk']['ad_group_id'] );
+check( 'harvest bid = CPC × 1.1', near( (float) $k['sugar free gum bulk']['payload']['bid'], 0.83 ) );
+check( 'non-converting term negated in its source ad group', 'negative' === ( $k['nicotine gum']['kind'] ?? '' ) && 'AGB' === $k['nicotine gum']['ad_group_id'] );
+check( 'already-exact keyword not re-harvested', ! isset( $k['spearmint gum'] ) );
+check( 'ASIN term → product-target harvest', 'harvest_asin' === ( $k['b0abcdefgh']['kind'] ?? '' ) );
+check( 'existing negative not duplicated', ! isset( $k['bubble gum machine'] ) );
+
+$budgets = $opt->budgets( array(
+ array( 'campaign_id' => 'capped-good', 'name' => 'A', 'state' => 'ENABLED', 'daily_budget' => 20, 'days' => 7, 'cost' => 135, 'sales' => 700 ),
+ array( 'campaign_id' => 'capped-bad', 'name' => 'B', 'state' => 'ENABLED', 'daily_budget' => 20, 'days' => 7, 'cost' => 138, 'sales' => 200 ),
+ array( 'campaign_id' => 'fine', 'name' => 'C', 'state' => 'ENABLED', 'daily_budget' => 50, 'days' => 7, 'cost' => 100, 'sales' => 600 ),
+) );
+$b = array_column( $budgets, 'new_value', 'entity_id' );
+check( 'profitable capped campaign → +20% budget', near( (float) ( $b['capped-good'] ?? 0 ), 24.0 ) );
+check( 'unprofitable capped campaign → -15% budget', near( (float) ( $b['capped-bad'] ?? 0 ), 17.0 ) );
+check( 'uncapped campaign untouched', ! isset( $b['fine'] ) );
+
+/* -------------------------------------------------------------------- */
+echo "RestockPlanner::plan\n";
+$in = static fn( array $o ) => $o + array( 'sku' => 'S', 'asin' => 'A', 'title' => 'T', 'fulfillable' => 0, 'reserved' => 0, 'inbound' => 0, 'units_7' => 0, 'units_30' => 0, 'units_90' => 0, 'oos_days_30' => 0, 'lead_time' => 30, 'moq' => 0, 'case_pack' => 0, 'unit_cost' => 2.0, 'price' => 10.0 );
+$plan = RestockPlanner::plan( array(
+ $in( array( 'sku' => 'steady', 'fulfillable' => 300, 'units_7' => 70, 'units_30' => 300, 'units_90' => 900, 'case_pack' => 24, 'moq' => 100 ) ),
+ $in( array( 'sku' => 'oos', 'fulfillable' => 0, 'units_7' => 0, 'units_30' => 150, 'units_90' => 600, 'oos_days_30' => 15 ) ),
+ $in( array( 'sku' => 'fat', 'fulfillable' => 5000, 'units_7' => 14, 'units_30' => 60, 'units_90' => 180 ) ),
+ $in( array( 'sku' => 'gap', 'fulfillable' => 20, 'inbound' => 2000, 'units_7' => 70, 'units_30' => 300, 'units_90' => 900 ) ),
+ $in( array( 'sku' => 'dead', 'fulfillable' => 40 ) ),
+), '2026-10-01', array( 'safety_days' => 14, 'target_cover' => 60, 'overstock_days' => 180 ) );
+$r = array_column( $plan['rows'], null, 'sku' );
+check( 'velocity = 0.5·v7 + 0.3·v30 + 0.2·v90', near( $r['steady']['velocity'], 10.0 ) );
+check( 'days of cover', 30 === $r['steady']['days_of_cover'] );
+check( 'steady SKU below reorder point → critical', 'critical' === $r['steady']['status'], $r['steady']['status'] );
+// need = 10 × (30 + 60) − 300 = 600 → case pack 24 → 600
+check( 'order qty rounded up to case pack', 600 === $r['steady']['order_qty'], (string) $r['steady']['order_qty'] );
+check( 'stock-out date', '2026-10-31' === $r['steady']['stockout_date'] );
+// v30 = 150 / (30 − 15 OOS days) = 10 → 0.3·10 + 0.2·6.67 = 4.33 (vs 2.83 if OOS days were counted).
+check( 'OOS SKU flagged + velocity excludes stock-out days', 'out_of_stock' === $r['oos']['status'] && near( $r['oos']['velocity'], 4.333 ) );
+check( 'lost sales per day for OOS', $r['oos']['lost_sales_day'] > 40 );
+check( 'overstock detected', 'overstock' === $r['fat']['status'] && 0 === $r['fat']['order_qty'] );
+check( 'inbound gap → stockout_risk', 'stockout_risk' === $r['gap']['status'], $r['gap']['status'] );
+check( 'no sales → no_sales, no order', 'no_sales' === $r['dead']['status'] && 0 === $r['dead']['order_qty'] );
+check( 'urgency ordering', 'oos' === $plan['rows'][0]['sku'] );
+check( 'summary PO value', near( $plan['summary']['order_value'], array_sum( array_column( $plan['rows'], 'order_value' ) ) ) );
+
+/* -------------------------------------------------------------------- */
+echo "ListingAuditor::score\n";
+$good = array(
+ 'asin' => 'B0X', 'brand' => '7 SEVEN', 'product_type' => 'GUM', 'status' => array( 'BUYABLE', 'DISCOVERABLE' ), 'issues' => array(),
+ 'title' => '7 SEVEN Sugar-Free Gum, Spearmint, 50 Pieces, Xylitol Sweetened, Aspartame-Free, Long-Lasting Flavor, Vegan',
+ 'bullets' => array_fill( 0, 5, 'LONG-LASTING FLAVOR — Our slow-release flavor beads keep every piece fresh for up to 45 minutes, so one piece covers your whole commute or meeting without fading.' ),
+ 'description' => str_repeat( 'Clean, confident chewing gum with xylitol sweetness and long-lasting flavor. ', 18 ),
+ 'backend' => 'sugarless chewing gum xylitol mints breath freshener keto vegan office travel bottle aspartame free dental gum fresh breath dry mouth',
+ 'images' => array_fill( 0, 7, 'x.jpg' ),
+);
+$s = ListingAuditor::score( $good, array( 'spearmint gum', 'xylitol gum' ) );
+check( 'good listing scores ≥ 90', $s['score'] >= 90, (string) $s['score'] );
+check( 'keyword coverage 100%', 100 === $s['keyword_coverage']['pct'] );
+$bad = array_merge( $good, array(
+ 'title' => 'Gum Gum Gum!! Best Seller Sugar Free GUM GUM', 'bullets' => array( 'Short 😀' ), 'description' => '',
+ 'backend' => str_repeat( 'gum ', 70 ) . 'B0ABCDEFGH', 'images' => array( 'x.jpg' ),
+ 'status' => array( 'DISCOVERABLE' ), 'issues' => array( array( 'code' => '90220', 'severity' => 'ERROR', 'message' => 'missing weight' ) ),
+) );
+$s2 = ListingAuditor::score( $bad, array( 'spearmint gum' ) );
+$msgs = implode( ' | ', array_column( $s2['findings'], 'message' ) );
+check( 'bad listing scores < 40', $s2['score'] < 40, (string) $s2['score'] );
+check( 'flags repeated words', str_contains( $msgs, 'more than twice' ) );
+check( 'flags banned characters', str_contains( $msgs, 'decorative characters' ) );
+check( 'flags promotional claims', str_contains( $msgs, 'best seller' ) );
+check( 'flags emoji in bullets', str_contains( $msgs, 'emoji' ) );
+check( 'flags backend > 249 bytes', str_contains( $msgs, '249 bytes' ) );
+check( 'flags ASIN in backend', str_contains( $msgs, 'ASINs' ) );
+check( 'flags suppression', 'suppressed' === $s2['status'] );
+check( 'grade F', 'F' === $s2['grade'] );
+check( 'claims ignore substrings (wholesale ≠ sale)', array() === ListingAuditor::claims( 'wholesale pack' ) );
+check( 'extract() maps Listings API attributes', 'Hello' === ListingAuditor::extract( array(
+ 'summaries' => array( array( 'asin' => 'B0X', 'status' => array( 'BUYABLE' ) ) ),
+ 'attributes' => array( 'item_name' => array( array( 'value' => 'Hello' ) ), 'bullet_point' => array( array( 'value' => 'b1' ), array( 'value' => 'b2' ) ),
+ 'other_product_image_locator_1' => array( array( 'media_location' => 'i1' ) ), 'main_product_image_locator' => array( array( 'media_location' => 'm' ) ) ),
+) )['title'] );
+
+/* -------------------------------------------------------------------- */
+echo "ProductResearch\n";
+$c = ProductResearch::calc( array( 'price' => 20, 'unit_cost' => 4, 'inbound' => 1, 'referral_pct' => 15, 'fba_fee' => 5, 'tacos_pct' => 10, 'return_pct' => 0, 'cvr_pct' => 10 ) );
+// 20 − 3 (referral) − 5 (FBA) − 5 (COGS) − 2 (ads) = 5
+check( 'profit per unit', near( $c['profit_per_unit'], 5.0 ) );
+check( 'margin %', near( $c['margin_pct'], 25.0 ) );
+check( 'ROI %', near( $c['roi_pct'], 100.0 ) );
+check( 'break-even ACoS = pre-ad margin', near( $c['breakeven_acos'], 35.0 ) );
+check( 'max CPC = pre-ad profit × CVR', near( $c['max_cpc'], 0.70 ) );
+check( 'break-even price', near( $c['breakeven_price'], 10 / 0.75 ) );
+check( 'BSR estimate decreases with rank', ProductResearch::estimate_monthly_units( 100, 'grocery' ) > ProductResearch::estimate_monthly_units( 10000, 'grocery' ) );
+check( 'BSR group factor applied', ProductResearch::estimate_monthly_units( 1000, 'home' ) > ProductResearch::estimate_monthly_units( 1000, 'baby' ) );
+
+echo "\n{$pass} passed, {$fail} failed\n";
+exit( $fail ? 1 : 0 );
diff --git a/sg-commerce-pro/uninstall.php b/sg-commerce-pro/uninstall.php
new file mode 100644
index 0000000..a59db49
--- /dev/null
+++ b/sg-commerce-pro/uninstall.php
@@ -0,0 +1,123 @@
+prefix}sg_products",
+ "{$wpdb->prefix}sg_price_history",
+ "{$wpdb->prefix}sg_descriptions",
+ "{$wpdb->prefix}sg_competitors",
+ "{$wpdb->prefix}sg_rules",
+ "{$wpdb->prefix}sg_alerts",
+ "{$wpdb->prefix}sg_audit",
+ "{$wpdb->prefix}sg_mcf_orders",
+ "{$wpdb->prefix}sg_comparisons",
+ "{$wpdb->prefix}sg_injection_rules",
+ "{$wpdb->prefix}sg_settlements",
+ "{$wpdb->prefix}sg_inbound_plans",
+ "{$wpdb->prefix}sg_product_ean",
+ );
+ // v4.0 — every Amazon Seller Suite table shares the sg_suite_ prefix.
+ $suite_tables = $wpdb->get_col( $wpdb->prepare( 'SHOW TABLES LIKE %s', $wpdb->esc_like( $wpdb->prefix . 'sg_suite_' ) . '%' ) );
+ $tables = array_merge( $tables, (array) $suite_tables );
+ foreach ( $tables as $t ) {
+ $wpdb->query( "DROP TABLE IF EXISTS {$t}" );
+ }
+
+ $option_keys = array(
+ 'sg_commerce_settings',
+ 'sg_commerce_schema_version',
+ 'sg_commerce_installed_at',
+ 'sg_commerce_activated_at',
+ 'sg_commerce_default_rules_seeded',
+ 'sg_commerce_last_cron_sync',
+ );
+ foreach ( $option_keys as $key ) {
+ delete_option( $key );
+ }
+
+ // Encrypted secrets — one option each.
+ $secret_keys = array(
+ 'amazon_client_id',
+ 'amazon_client_secret',
+ 'amazon_refresh_token',
+ 'amazon_seller_id',
+ 'openai_api_key',
+ 'anthropic_api_key',
+ 'ollama_auth_token',
+ 'ads_client_id',
+ 'ads_client_secret',
+ 'ads_refresh_token',
+ );
+ foreach ( $secret_keys as $sk ) {
+ delete_option( 'sg_commerce_secret_' . $sk );
+ }
+
+ // Catch-all: any other core option added over time (carton templates, sandbox flag,
+ // notices, API-key flashes…) shares the sg_commerce_ prefix.
+ $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", $wpdb->esc_like( 'sg_commerce_' ) . '%' ) );
+
+ // Suite options (cursors, job status, demo flag, schema version).
+ $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s", $wpdb->esc_like( 'sg_suite_' ) . '%' ) );
+ $wpdb->query( $wpdb->prepare( "DELETE FROM {$wpdb->options} WHERE option_name LIKE %s OR option_name LIKE %s", $wpdb->esc_like( '_transient_sg_suite_' ) . '%', $wpdb->esc_like( '_transient_timeout_sg_suite_' ) . '%' ) );
+
+ // Transients.
+ $wpdb->query( "DELETE FROM {$wpdb->options} WHERE option_name LIKE '_transient_sg_commerce/%' OR option_name LIKE '_transient_timeout_sg_commerce/%'" );
+
+ // Cron.
+ $crons = array(
+ 'sg_commerce_hourly_sync',
+ 'sg_commerce_daily_analytics',
+ 'sg_commerce_repricer_tick',
+ 'sg_commerce_competitor_scan',
+ 'sg_commerce_ai_queue_process',
+ 'sg_commerce_mcf_refresh',
+ 'sg_commerce_pii_purge',
+ 'sg_commerce_sqs_poll',
+ 'sg_commerce_ai_describe',
+ 'sg_commerce_ai_translate',
+ 'sg_suite_tick',
+ 'sg_suite_hourly',
+ 'sg_suite_daily',
+ );
+ foreach ( $crons as $hook ) {
+ wp_clear_scheduled_hook( $hook );
+ }
+ if ( function_exists( 'as_unschedule_all_actions' ) ) {
+ as_unschedule_all_actions( '', array(), 'sg_commerce' );
+ }
+
+ // Log directory.
+ $uploads = wp_upload_dir( null, false );
+ if ( ! empty( $uploads['basedir'] ) ) {
+ $log_dir = trailingslashit( $uploads['basedir'] ) . 'sg-commerce-logs';
+ if ( is_dir( $log_dir ) ) {
+ array_map( 'unlink', glob( $log_dir . '/*' ) ?: array() );
+ @rmdir( $log_dir );
+ }
+ }
+}
+
+if ( is_multisite() ) {
+ $sites = get_sites( array( 'fields' => 'ids', 'number' => 0 ) );
+ foreach ( (array) $sites as $blog_id ) {
+ switch_to_blog( (int) $blog_id );
+ sg_commerce_uninstall_one_site();
+ restore_current_blog();
+ }
+} else {
+ sg_commerce_uninstall_one_site();
+}
+ ![<?php echo esc_attr( $d['name'] ); ?>](<?php echo esc_url( $d['image_url'] ); ?>)
+
+
+
+
+