Changelog

​

March 2026

​

v1.8.1 — Pipeline Hardening + Marketplace Hub

• Bronze idempotency: duplicate imports from the same source are silently de-duplicated via source_identifier hash key — re-running an import no longer creates duplicate products
• Unified optimization score: optimization_score is now a top-level field on the product object; score_history tracks the full progression from 0 to 100 across pipeline runs
• Pipeline settings API: GET/PUT /api/workspace/{workspaceId}/settings/pipeline — configure Silver field mappings, Gold rubric weights, and auto-trigger behavior per workspace

• Pagination: GET /api/hub/catalogs now returns cursor-based pagination (after, limit params); first page defaults to 20 catalogs
• Preview endpoint: GET /api/hub/catalogs/{catalogId}/preview — inspect catalog metadata and a sample of products before cloning or subscribing
• Subscribe + sync: POST /api/hub/catalogs/{catalogId}/subscribe creates a live subscription; POST /api/hub/subscriptions/{subscriptionId}/sync triggers manual refresh
• Conflict resolution: GET /api/hub/subscriptions/{subscriptionId}/conflicts lists field-level conflicts; PATCH resolves individual conflicts with keep_local, accept_remote, or manual_review
• Publisher analytics: GET /api/hub/catalogs/{catalogId}/analytics returns subscriber count, clone count, and weekly view trends (up to 90 days)
• Versioning: publishing a new version of a subscribed catalog triggers catalog.version.published webhooks to all active subscribers

• Bright Data integration promoted from beta to GA; real billing API wired (usage billed per scrape credit consumed)
• URL import webhooks: url_import.completed and url_import.failed events now delivered with full product payload on success
• Dataset delivery endpoint: POST /api/workspace/{workspaceId}/datasets/ingest accepts Bright Data bulk dataset payloads directly

• llms.txt published at https://docs.alana.shopping/llms.txt — machine-readable platform summary for LLM context windows
• Feed API: NDJSON streaming now supported via Accept: application/x-ndjson header on GET /api/mcp/feed/{platform}
• Unified error catalog: all API errors now include error_code (e.g., CATALOG_NOT_PUBLISHED, RATE_LIMIT_EXCEEDED) — see Error Reference
• MCP Tools: tool filtering via ?tools= query param on SSE connect — subscribe to only the tool categories you need
• Platform quickstarts added for Shopify, WooCommerce, and custom storefronts
• Feed webhooks: POST /api/v1/feeds/{platform}/webhooks — register endpoints to receive feed.updated events
• Feed analytics: GET /api/v1/feeds/{platform}/analytics — consumption metrics (requests, cache hit rate, error rate, top consumers)
• Postman collection published: import via https://docs.alana.shopping/postman.json

​

v1.8.0 — Bright Data Integration + Bronze/Silver/Gold Pipeline

• Five Bright Data clients integrated: ProductScraper, WebUnlocker, DatasetDelivery, ProxyManager, SearchScraper
• URL import: POST /api/workspace/{workspaceId}/url-import/jobs — submit a product page URL; Bright Data scrapes and extracts structured data
• Web scraping with automatic CAPTCHA bypass, residential proxy rotation, and JavaScript rendering
• Async job status polling and webhook delivery on completion

• Bronze stage: raw product ingest with idempotency key (source_identifier) — prevents duplicate imports from the same source in repeated runs
• Silver stage: field normalization (maps arbitrary column names to Alana schema), duplicate detection across catalog, image URL validation
• Gold stage: 7-stage optimization rubric scoring (0–100) across identity, content, media, pricing, availability, SEO, and compliance dimensions; returns score + gap list per product
• Pipeline stages run automatically after import (configurable) or on-demand via Batch Actions

• New Batch Actions panel in catalog view: run Silver normalization or Gold scoring on a selection or entire catalog
• Real-time progress indicator with per-product status updates
• Error summary with row-level detail export (CSV)

• New Pipeline Settings panel in workspace settings:
  • Silver mappings: map custom column names to standard Alana fields
  • Gold weights: adjust per-dimension rubric weights (identity, content, media, pricing, availability, SEO, compliance)
  • Auto-trigger: configure whether Silver runs automatically after Bronze, and whether Gold runs after Silver

​

v1.7.0 — Distribution Excellence

• BREAKING: ?key= query parameter removed from all /api/v1/* endpoints. API keys must be passed via the x-api-key request header. Keys in URLs are visible in logs, Referer headers, and browser history — this change improves security for all Search API consumers.
  • Migration: Replace GET /api/v1/search?key=ak_xxx with GET /api/v1/search + x-api-key: ak_xxx header.
  • Affected endpoints: /api/v1/search, /api/v1/autocomplete, /api/v1/browse, /api/v1/recommend, /api/v1/recommendations/*, /api/v1/events, /api/v1/analytics/*, /api/v1/serving-configs/*, /api/v1/facets/*, /api/v1/synonyms/*, /api/v1/boost-rules/*, /api/v1/language, /api/v1/pipeline/status, /api/v1/bandit/state, /api/v1/cache/metrics

• Input validation hardening on GET /api/mcp/feed/[platform]:
  • ?q= parameter: control characters stripped, max 500 characters enforced (400 on violation)
  • ?catalog_id= parameter: UUID format validated (400 on invalid format)

• Responses authenticated with legacy API keys now include deprecation headers:
  • X-Api-Key-Deprecated: true
  • X-Deprecation-Info: https://docs.alana.shopping/en/authentication#m2m-migration
  • Deprecation: true (RFC 8594)
• Migrate to Auth0 M2M tokens: see migration guide

• All API responses include X-Request-Id for distributed tracing
• X-Request-Id echoed from upstream when client sends it; generated (UUID v4) otherwise
• Canal 1: 60 req/min per API key; 429 includes X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After
• Canal 3: 200 req/min per key + 50 req/min per key+IP; dual-level enforcement

​

February 2026

​

v1.0.0 — General Availability

• Workspace management with full RBAC (owner, admin, editor, viewer)
• Row-level security across all resources
• Onboarding wizard with sample data loading
• Custom domain support and workspace branding
• GDPR-compliant data export and account deletion
• Comprehensive audit logging (38+ action types)

• Create, publish, fork, and merge catalogs
• Product CRUD with optimization scoring (0–100)
• Feed readiness validation for Google Shopping and Meta Commerce
• Bulk import from CSV and Excel files
• Public product feed endpoint for published catalogs

• Brand-aware content generation via LiteLLM abstraction
• Canvas AI chat with RAG (brand specs + product context)
• Text generation for descriptions, titles, and bullet points
• Content enhancement with grammar, tone, and keyword alignment
• Per-brand AI specifications: tone, keywords, policies, audience

• Four plans: Standard, Pro, Business, Enterprise
• Stripe-powered checkout, subscriptions, and customer portal
• Usage tracking with configurable alerts
• Invoice history and PDF download

• OAuth-based platform connections
• Bidirectional product sync with e-commerce platforms
• MCP protocol support (inbound batches, feed subscriptions, search)
• Intercom customer support integration

• REST API with 90+ endpoints and interactive playground
• API key management with granular permissions
• Cursor-based pagination across all list endpoints
• Structured error responses with error codes
• Health and readiness endpoints for monitoring

• Supabase Auth with email/password, magic links, and OAuth
• Configurable session timeouts and 2FA enforcement
• IP allowlisting for API access
• Stripe webhook signature verification
• Workspace-level force logout