cli-market-core 1.9.5__tar.gz

cli_market_core-1.9.5/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: cli-market-core
+Version: 1.9.5
+Summary: CLI Market core — VTEX/Shopify/Magento/WooCommerce connectors, 68 retailers, collector, MCP primitives. MIT.
+Author-email: CLI Market <hello@cli-market.dev>
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn>=0.30
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: psycopg2-binary>=2.9
+Requires-Dist: asyncpg>=0.29
+Requires-Dist: playwright>=1.45.0

cli_market_core-1.9.5/README.md

@@ -0,0 +1,76 @@
+# cli-market-core
+
+> **Intelligence Layer** — Indicators, billing, connectors, and MCP tools for CLI Market
+
+```bash
+pip install cli-market-core
+```
+
+---
+
+## What is this?
+
+`cli-market-core` is the intelligence engine of the CLI Market ecosystem. It takes canonical product data from `cli-market-index` and adds market intelligence: price indicators, spread analysis, billing/payments, retailer connectors, and 43 MCP tools.
+
+---
+
+## Ecosystem
+
+```
+cli-market-backend  ->  Data ingestion (scrapers, FastAPI)
+cli-market-index    ->  Semantic Refinery (entity resolution, Golden Records)
+cli-market-core     ->  Intelligence (THIS REPO)
+cli-market-world    ->  Exposure (landing, docs, MCP registry)
+```
+
+---
+
+## Modules
+
+| Module | Role |
+|---|---|
+| `market_core.py` | Core service orchestrator |
+| `market_indicators.py` | 34 market indicators from shelf data |
+| `market_spread.py` | Cross-retailer price spreads |
+| `market_stats.py` | Platform statistics and version |
+| `market_db.py` | Database access layer |
+| `market_mcp.py` | 43 MCP tool definitions |
+| `market_basket.py` | Basket comparison logic |
+| `market_billing.py` | Subscription and billing |
+| `market_alerts.py` | Price alert engine |
+| `market_security.py` | Auth and webhook validation |
+| `market_intel_agent.py` | AI agent intelligence queries |
+| `market_enrich_sources.py` | External data enrichment (OFF, IMF, World Bank) |
+| `market_enrich_subcategory.py` | Subcategory classification |
+| `market_health_alert.py` | System health monitoring |
+| `source_health.py` | Scraper health tracking |
+| `price_confidence.py` | Price quality heuristics |
+| `store_credentials.py` | Retailer credential management |
+| `market_units.py` | Unit conversion utilities |
+| `market_stores.py` | Retailer catalog |
+| `retailer_onboarding.py` | Retailer onboarding workflow |
+| `dashboard_glossary.py` | Dashboard metric definitions |
+| `dashboard_quality.py` | Dashboard quality indicators |
+| `dashboard_renderer.py` | Dashboard HTML renderer |
+| `dashboard_view_model.py` | Dashboard data model |
+| `data_v1_service.py` | Core data API endpoints |
+| `market_connectors/` | PayPal, Mercado Pago, WooCommerce, VTEX, Shopify, SUNAT, etc. |
+| `market_stats.py` | Canonical figures for README, PyPI, landing (run `sync_market_stats.py` in world) |
+
+---
+
+## Version
+
+Current: **1.9.5** — 68 retailers, 4 platforms (incl. WooCommerce FMCG pilot `nunaorganica_pe`)
+
+---
+
+## Dev setup
+
+```bash
+pip install -e .
+```
+
+No external dependencies required in creation phase.
+
+MIT License · [SINAPSIS INNOVADORA S.A.C.](https://cli-market.dev) · Lima, Peru

cli_market_core-1.9.5/cli_market_core.egg-info/PKG-INFO

@@ -0,0 +1,16 @@
+Metadata-Version: 2.4
+Name: cli-market-core
+Version: 1.9.5
+Summary: CLI Market core — VTEX/Shopify/Magento/WooCommerce connectors, 68 retailers, collector, MCP primitives. MIT.
+Author-email: CLI Market <hello@cli-market.dev>
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn>=0.30
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: psycopg2-binary>=2.9
+Requires-Dist: asyncpg>=0.29
+Requires-Dist: playwright>=1.45.0

cli_market_core-1.9.5/cli_market_core.egg-info/SOURCES.txt

@@ -0,0 +1,78 @@
+README.md
+dashboard_glossary.py
+dashboard_quality.py
+dashboard_renderer.py
+dashboard_view_model.py
+data_v1_service.py
+market_alerts.py
+market_basket.py
+market_billing.py
+market_db.py
+market_enrich_sources.py
+market_enrich_subcategory.py
+market_health_alert.py
+market_indicators.py
+market_intel_agent.py
+market_mcp.py
+market_security.py
+market_spread.py
+market_stats.py
+market_units.py
+price_confidence.py
+pyproject.toml
+retailer_onboarding.py
+source_health.py
+store_credentials.py
+cli_market_core.egg-info/PKG-INFO
+cli_market_core.egg-info/SOURCES.txt
+cli_market_core.egg-info/dependency_links.txt
+cli_market_core.egg-info/requires.txt
+cli_market_core.egg-info/top_level.txt
+market_connectors/__init__.py
+market_connectors/base.py
+market_connectors/email_outbound.py
+market_connectors/lemon_payments.py
+market_connectors/magento.py
+market_connectors/mercadopago_payments.py
+market_connectors/minimax.py
+market_connectors/paypal_payments.py
+market_connectors/shopify.py
+market_connectors/sunat_invoicing.py
+market_connectors/vtex.py
+market_connectors/wise_payments.py
+market_connectors/woocommerce.py
+market_core/__init__.py
+market_core/dashboard_glossary.py
+market_core/dashboard_quality.py
+market_core/dashboard_renderer.py
+market_core/dashboard_view_model.py
+market_core/data_v1_service.py
+market_core/market_alerts.py
+market_core/market_basket.py
+market_core/market_billing.py
+market_core/market_core.py
+market_core/market_db.py
+market_core/market_enrich_sources.py
+market_core/market_enrich_subcategory.py
+market_core/market_health_alert.py
+market_core/market_indicators.py
+market_core/market_intel_agent.py
+market_core/market_mcp.py
+market_core/market_security.py
+market_core/market_spread.py
+market_core/market_stats.py
+market_core/market_stores.py
+market_core/market_units.py
+market_core/price_confidence.py
+market_core/retailer_onboarding.py
+market_core/source_health.py
+market_core/store_credentials.py
+tests/test_dashboard.py
+tests/test_market_connectors.py
+tests/test_market_core.py
+tests/test_market_services.py
+tests/test_mercadopago_payments.py
+tests/test_mercadopago_signature.py
+tests/test_store_credentials_woocommerce.py
+tests/test_vtex_206.py
+tests/test_woocommerce_connector.py

cli_market_core-1.9.5/cli_market_core.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

cli_market_core-1.9.5/cli_market_core.egg-info/requires.txt

@@ -0,0 +1,9 @@
+httpx>=0.27
+rich>=13.0
+fastapi>=0.115
+uvicorn>=0.30
+pydantic>=2.0
+python-multipart>=0.0.9
+psycopg2-binary>=2.9
+asyncpg>=0.29
+playwright>=1.45.0

cli_market_core-1.9.5/cli_market_core.egg-info/top_level.txt

@@ -0,0 +1,25 @@
+dashboard_glossary
+dashboard_quality
+dashboard_renderer
+dashboard_view_model
+data_v1_service
+market_alerts
+market_basket
+market_billing
+market_connectors
+market_core
+market_db
+market_enrich_sources
+market_enrich_subcategory
+market_health_alert
+market_indicators
+market_intel_agent
+market_mcp
+market_security
+market_spread
+market_stats
+market_units
+price_confidence
+retailer_onboarding
+source_health
+store_credentials

cli_market_core-1.9.5/dashboard_glossary.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.dashboard_glossary`` in new code."""
+
+from market_core.dashboard_glossary import *  # noqa: F403

cli_market_core-1.9.5/dashboard_quality.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.dashboard_quality`` in new code."""
+
+from market_core.dashboard_quality import *  # noqa: F403

cli_market_core-1.9.5/dashboard_renderer.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.dashboard_renderer`` in new code."""
+
+from market_core.dashboard_renderer import *  # noqa: F403

cli_market_core-1.9.5/dashboard_view_model.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.dashboard_view_model`` in new code."""
+
+from market_core.dashboard_view_model import *  # noqa: F403

cli_market_core-1.9.5/data_v1_service.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.data_v1_service`` in new code."""
+
+from market_core.data_v1_service import *  # noqa: F403

cli_market_core-1.9.5/market_alerts.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.market_alerts`` in new code."""
+
+from market_core.market_alerts import *  # noqa: F403

cli_market_core-1.9.5/market_basket.py

@@ -0,0 +1,4 @@
+"""Compatibility shim — prefer ``market_core.market_basket`` in new code."""
+
+from market_core.market_basket import *  # noqa: F403
+from market_core.market_basket import _canasta_name_sql  # noqa: F401 — backend tests

cli_market_core-1.9.5/market_billing.py

@@ -0,0 +1,3 @@
+"""Compatibility shim — prefer ``market_core.market_billing`` in new code."""
+
+from market_core.market_billing import *  # noqa: F403

cli_market_core-1.9.5/market_connectors/__init__.py

@@ -0,0 +1,18 @@
+"""market_connectors — Multi-platform e-commerce connectors."""
+from .vtex import VtexConnector
+from .shopify import ShopifyConnector
+from .magento import MagentoConnector
+from .woocommerce import WooCommerceConnector
+
+_CONNECTORS = {
+    "vtex": VtexConnector(),
+    "shopify": ShopifyConnector(),
+    "magento": MagentoConnector(),
+    "woocommerce": WooCommerceConnector(),
+}
+
+def get_connector(platform: str):
+    conn = _CONNECTORS.get(platform)
+    if not conn:
+        raise ValueError(f"Unknown platform: {platform}. Known: {list(_CONNECTORS)}")
+    return conn

cli_market_core-1.9.5/market_connectors/base.py

@@ -0,0 +1,36 @@
+"""
+market_connectors/base.py — Abstract connector interface.
+
+Every e-commerce platform connector implements this protocol.
+The rest of the system never knows which platform a store runs on.
+"""
+
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+class BaseConnector(ABC):
+    platform: str = ""
+
+    @abstractmethod
+    async def search(self, store_config: dict, term: str,
+                     page: int = 1, limit: int = 20) -> list[dict]:
+        """Search products. Returns raw platform-specific dicts."""
+
+    @abstractmethod
+    def normalize(self, raw: dict, store_key: str, store_config: dict) -> dict:
+        """Convert raw product into unified schema:
+        {id, product_id, name, brand, category, price, list_price,
+         discount, stock, store, store_name, currency, url, line, line_name}"""
+
+    @abstractmethod
+    async def categories(self, store_config: dict) -> list[dict]:
+        """Return category tree."""
+
+
+def parse_price(price: Any) -> float:
+    try: return float(price or 0)
+    except (ValueError, TypeError): return 0.0
+
+def clean_name(name: str) -> str:
+    return name.replace("-", " ")