Repository navigation
Releases
v0.12.0 — refunds through the Store API
Refunds through the Store API (SKU-8838): optional PaymentAdapter.refund()/refundStatus() for Stripe and PayPal, order_refunds table, POST/GET /orders/{id}/refunds under a new refunds connect scope, payment.refundable/refunded/refundable_amount and refunds[] on orders, partial and dashboard refunds from webhooks, unanswered processor calls kept pending and settled by replaying the idempotency key, unknown connect scopes dropped instead of rejected, /health sdk_version. Stores: run the database migration before deploying.
v0.11.0
@skuio/storefront and @skuio/cli 0.11.0
- Order payment method label now comes from the payment method actually used on the order, not the store's configured/default method.
- Payout lines carry
payment_method, so each line in a Store API payout says which method (e.g. card, wallet) the money came from. - Additive and backwards compatible: no fields removed or renamed; existing integrations keep working unchanged.
PR: #20
v0.9.0
Stripe express checkout is now approve-first: stripeExpress.authorize holds the wallet payment from the Express Checkout Element's ConfirmationToken, the store makes the order only once the hold succeeds, then attach + capture. Declined or abandoned wallet taps no longer leave unpaid orders. intent() is deprecated. See the 240sxconversions.com / verticallambodoors.com stripe-express endpoints for the reference integration.
v0.8.1
Fix: Stripe express checkout (Apple Pay / Google Pay / Link) intents no longer set shipping server-side. The Express Checkout Element re-sends the wallet address on confirmation, which Stripe rejects from a publishable key (payment_intent_invalid_parameter), so every express payment failed before reaching the card. Stores using stripeExpress should upgrade.
v0.8.0
Store API: each order's payment now reports what the processor captured and kept — amount_received, fee, net (ApiMoney, in the processor's settlement currency), transaction_id and fee_reported_at. Stripe and PayPal adapters record them when a payment confirms; GET /orders/{id} fills a missing fee from the processor (pass the new payments option to handleStoreApi). D1 migration 0009_payment_settlement. (#15)
v0.7.1
Store API: images[].url is now always an absolute URL. New optional StoreApiOptions.imageUrl(src) hook lets a store map a catalogue image to its public URL (e.g. Astro's fingerprinted /_astro/ path); without it, absolute URLs pass through and relative ones are made absolute against the request origin. (#14)
0.7.0 — Quotes (request for quote)
Quotes, guest-friendly. A buyer can ask for a price instead of checking out, with no account: a name and an email, and the emailed link is their way back to the quote. The operations system prices it through the Store API, and the buyer accepts in one click, which places a pay-later order at the quoted prices.
- SDK:
store.quotesand migration0008_quotes. Run your migrations:npm run db:migrateon Cloudflare; Node hosts migrate on boot. - Store API:
GET /quotes,GET /quotes/{id},PATCH /quotes/{id}(offer,external_reference, cancel) under a newquotesscope. Existing connections must reconnect to grant it. - New
quotesblock: runnpx @skuio/cli add quotesto add it to an existing store. It includes Add to quote, the quote list,/quote/,/quotes/{id}/and/account/quotes/. - New config: optional
QUOTE_NOTIFICATION_EMAIL, andconfig.quotes(number prefix, max quantity, per-hour throttle).
See docs/store-api.md → Quotes. (#12)
v0.6.1
- Store API for any operations system:
/api/store/v1(and/api/skuio/v1, unchanged for SKU.io); anyclient_idthe owner approves. - Scopes enforced per endpoint; new
paymentsscope for marking orders paid/refunded/failed (migration 0007 grants it to existingordersconnections). No endpoint can create an order. - Any host: Cloudflare Workers + D1 or Node + SQLite (
@skuio/storefront/db/sqlite). - Template:
npm run backup, predeploy checks, launch/cutover skills, lessons from live stores. - Published by GitHub Actions with npm trusted publishing (provenance attached). 0.6.0 is the same code.
v0.5.0 — first public release
First public release of the SKU.io storefront kit.
@skuio/storefront@0.5.0— the store core (catalogue, checkout, orders, customers, buyer portal, partner program, discount codes), the Store API, payment adapters (Stripe, PayPal incl. express, BTCPay, on-chain bitcoin, manual) and mail adapters.@skuio/cli@0.5.0—npx @skuio/cli create my-store,npx @skuio/cli add <block>.- Runs on any host: Cloudflare Workers + D1 (default) or any Node server with a SQLite file (
STORE_HOST=node, new@skuio/storefront/db/sqlite). - New blocks:
attribution(first/last touch on every order) andpaypal-express; every block uses colour tokens so dark-themed stores take them unchanged.
See the README for how the kit, a store and SKU.io (or another ERP) fit together.