Catalog sync app on Vareons: install, Meta and TikTok connect, and feeds

The app installs from the /dashboard/apps marketplace with an Install button on the "Catalog Sync" card marked Featured and described as syncing products with Meta and TikTok catalogs, after which an Open button leads to /dashboard/catalog-sync. The card carries a Free badge.

The page titled "Catalog Sync" with a products-ready-for-ads description shows a readiness strip with the blocked count, two columns — a Meta connection panel and a TikTok connection panel — then a sync-status table when errors or blocks exist, and an advanced feed-URL section. Panel states include Meta connect, sync all, retry, disconnect and reconnect, expired with reconnect, synced with "X ago", and a TikTok form for the access token plus business-center, catalog, and pixel ids.

The Meta flow starts with the connect button to the OAuth URL, then the callback at /meta/callback with a code and ten-minute HMAC state, then business-and-catalog selection, then an automatic full resync with status and progress polled every five seconds until zero pending. The TikTok flow pastes the access token with BC, catalog, and pixel ids, validates, then runs a full sync. The feed path needs no approvals: copy the /api/catalog-feed/[slug].xml or .csv URL with token and paste it into Commerce Manager.

Buttons include token regeneration (new feed URL or failure) and per-item or retry-all-failed through retry-failed. State is managed by a zustand store fetching status, feed, and readiness on mount. Connections are stored in CatalogConnection (AES-256-GCM encrypted token, business, catalog, and pixel ids, status, settings), items in ProductCatalogSync (status, content hash, retry counters), logs in CatalogSyncLog with thirty-day expiry, and the feed token in User.catalogFeedToken. The sync engine in sync-engine.js uses fire-and-forget queues, batches of one hundred, and exponential backoff up to six retries.