platform/packages/commerce

@blade-and-brawn/commerce

Printful and Webflow API clients, plus the ProductSyncer that keeps Webflow CMS products/SKUs in sync with Printful's catalog.

Exports

• PrintfulClient — new PrintfulClient({ storeId, token, webhookSecret }); products, webhooks.
• WebflowClient — new WebflowClient({ siteId, collectionIds: { products, skus }, token, webhookSecret }); CMS products/SKUs, webhooks.
• ProductSyncer — new ProductSyncer(printful, webflow); syncApparel(options) pulls Printful products and upserts them into the Webflow collections, respecting the naming conventions below.
• Shared Printful/Webflow request/response types (util/types.ts) and misc helpers (util/misc.ts, e.g. formatSlug).

Printful product naming conventions

• "Color-grouped" products follow the format Product Name [color].

Constraints:

1. A color-grouped product should have no more than one Printful color variant.
2. That single color-grouped product's variant should match [color].
3. Printful product names should be unique.

See apps/api/src/scripts/register-webhooks.ts for how webhooks are registered against the API's domain, and apps/api/src/services/commerce.ts for how ProductSyncer is invoked.