Skip to content

Releases

v0.12.0 — refunds through the Store API

Choose a tag to compare

@kmizzi kmizzi released this 18 Nov 03:56
59173ea

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

Choose a tag to compare

@kmizzi kmizzi released this 05 Nov 05:37
d55b6a9

@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

Choose a tag to compare

@kmizzi kmizzi released this 02 Nov 16:27
82fc7bd

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

Choose a tag to compare

@kmizzi kmizzi released this 02 Nov 16:04
50aeafc

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

Choose a tag to compare

@kmizzi kmizzi released this 27 Oct 16:03
a9e78fa

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

Choose a tag to compare

@kmizzi kmizzi released this 27 Oct 14:41
d636b25

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)

Choose a tag to compare

@kmizzi kmizzi released this 26 Oct 23:23
97aef4b

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.quotes and migration 0008_quotes. Run your migrations: npm run db:migrate on Cloudflare; Node hosts migrate on boot.
  • Store API: GET /quotes, GET /quotes/{id}, PATCH /quotes/{id} (offer, external_reference, cancel) under a new quotes scope. Existing connections must reconnect to grant it.
  • New quotes block: run npx @skuio/cli add quotes to 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, and config.quotes (number prefix, max quantity, per-hour throttle).

See docs/store-api.md → Quotes. (#12)

v0.6.1

Choose a tag to compare

@kmizzi kmizzi released this 20 Oct 19:27
6ce4be2
  • Store API for any operations system: /api/store/v1 (and /api/skuio/v1, unchanged for SKU.io); any client_id the owner approves.
  • Scopes enforced per endpoint; new payments scope for marking orders paid/refunded/failed (migration 0007 grants it to existing orders connections). 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

Choose a tag to compare

@kmizzi kmizzi released this 20 Oct 15:22
6c7e56d

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) and paypal-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.