@develemit/commerce-server 0.7.0 → 0.9.0

package/docs/admin.md

@@ -18,16 +18,17 @@ management under `/admin`. Without it, no admin routes exist (404).
   files with `openStoredFile(dir, key)`, which returns `{ stream, contentType,
 size }` or `null` (answer 404).
 
-| Route                                    | Purpose                                                  |
-| ---------------------------------------- | -------------------------------------------------------- |
-| `GET/POST /admin/products`               | List all statuses / create (`adminProductInputSchema`)   |
-| `GET /admin/products/counts`             | `{ all, live, draft, sold, archived, incompleteDrafts }` |
-| `GET/PATCH /admin/products/:id`          | Read / edit; `{ sold: true }` sets quantity to 0         |
-| `POST /admin/products/:id/images`        | Multipart `file` (+ optional `alt`), 8MB max             |
-| `PATCH /admin/products/:id/images/order` | `{ imageIds }`, every image exactly once                 |
-| `PATCH /admin/products/:id/images/:id`   | `{ alt }` (trimmed, max 500); 404 for unknown image      |
-| `DELETE /admin/products/:id/images/:id`  | Removes the row and the stored file                      |
-| `GET/PUT /admin/shipping-rates`          | `PUT` replaces the full set of rates                     |
+| Route                                    | Purpose                                                                                                                |
+| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `GET/POST /admin/products`               | List all statuses / create (`adminProductInputSchema`)                                                                 |
+| `GET /admin/products/counts`             | `{ all, live, draft, sold, archived, incompleteDrafts }`                                                               |
+| `GET/PATCH /admin/products/:id`          | Read / edit; `{ sold: true }` sets quantity to 0                                                                       |
+| `DELETE /admin/products/:id`             | Deletes a never-live draft with no order lines (204), its files and holds; else 409 `PRODUCT_NOT_DELETABLE` (`reason`) |
+| `POST /admin/products/:id/images`        | Multipart `file` (+ optional `alt`), 8MB max                                                                           |
+| `PATCH /admin/products/:id/images/order` | `{ imageIds }`, every image exactly once                                                                               |
+| `PATCH /admin/products/:id/images/:id`   | `{ alt }` (trimmed, max 500); 404 for unknown image                                                                    |
+| `DELETE /admin/products/:id/images/:id`  | Removes the row and the stored file                                                                                    |
+| `GET/PUT /admin/shipping-rates`          | `PUT` replaces the full set of rates                                                                                   |
 
 Stored image keys are `products/<productId>/<uuid>.<ext>` and are never
 overwritten, so their URLs are safe to cache forever. Serve `FileStorage` URLs

package/docs/payments.md

@@ -58,6 +58,43 @@ buyer is charged the undiscounted price while the order records the discount.
 `duration: 'once'`, `max_redemptions: 1`) and passes it in `discounts`.
 `createFakeGateway` records the discount on `sessions`.
 
+## Sales tax (Stripe Tax)
+
+Pass `tax` to `createStripeGateway` (or `resolvePayment(env, { tax })`):
+
+```ts
+createStripeGateway({
+  secretKey,
+  webhookSecret,
+  tax: {
+    enabled: true,
+    behavior: 'exclusive',
+    shippingTaxCode: 'txcd_92010001',
+  },
+});
+```
+
+With tax on, Checkout Sessions get `automatic_tax: { enabled: true }` and a
+`tax_behavior` (`exclusive` by default; `inclusive` for VAT-style prices) on
+every line and shipping option. A `CheckoutLine.taxCode` is sent as the
+product's `tax_code`. The completed-session webhook stores
+`total_details.amount_tax` as the order's `taxCents`; `shippingCents` stays
+pre-tax, so `subtotal - discount + shipping + tax = total`. The discount
+applies before tax. Without the option, sessions are exactly as before.
+
+A product can carry an optional `taxCode` (a Stripe tax code such as
+`txcd_20010000`, see [Stripe's list](https://docs.stripe.com/tax/tax-categories)),
+set through the admin API (`taxCode` on create and patch, `null` clears it) and
+shown in `AdminProductFlow` when the host passes `taxCodes`. Checkout puts it on
+that line; products without one use the account's default tax code. The public
+catalog never exposes it. Migration `0011` adds `commerce_products.tax_code`.
+
+The host sets up Stripe Tax in the Stripe dashboard (origin address and tax
+registrations); the kit does neither.
+
+For local checkout, `createFakeGateway({ tax: { rate: 0.0825 } })` taxes
+merchandise less discount plus shipping, and `devCheckout` records it.
+
 ## Manual Stripe test-mode purchase
 
 Uses the playground apps in this repo and a Stripe account in test mode.

package/migrations/0009_product_published_at.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "commerce_products" ADD COLUMN "published_at" timestamp with time zone;--> statement-breakpoint
+UPDATE "commerce_products" SET "published_at" = "updated_at" WHERE "status" <> 'draft';

package/migrations/0010_order_tax.sql

@@ -0,0 +1 @@
+ALTER TABLE "commerce_orders" ADD COLUMN "tax_cents" integer DEFAULT 0 NOT NULL;

package/migrations/0011_product_tax_code.sql

@@ -0,0 +1 @@
+ALTER TABLE "commerce_products" ADD COLUMN "tax_code" text;