@techninja/staticart 0.1.7 → 0.1.9

package/api/checkout.js

@@ -51,12 +51,17 @@ export async function handler(event) {
       config: cfg,
     });
     const url = await createCheckoutSession({
-      items: items.map((i) => ({
-        name: i.name,
-        price: i.price,
-        currency: i.currency || cfg.store?.currency || 'usd',
-        quantity: i.quantity,
-      })),
+      items: items.map((i) => {
+        const p = productData.find((pd) => pd.sku === i.sku);
+        return {
+          sku: i.sku,
+          name: i.name,
+          price: i.price,
+          currency: i.currency || cfg.store?.currency || 'usd',
+          quantity: i.quantity,
+          metadata: p?.metadata || {},
+        };
+      }),
       successUrl,
       cancelUrl,
       shipping: { type: 'flat', amount: shippingAmount, displayName: shippingSummary || '' },

package/api/lib/stripe.js

@@ -21,7 +21,7 @@ export function getStripe() {
 
 /**
  * @typedef {Object} CheckoutOptions
- * @property {Array<{name: string, price: number, currency: string, quantity: number}>} items
+ * @property {Array<{name: string, price: number, currency: string, quantity: number, sku?: string, metadata?: any}>} items
  * @property {string} successUrl
  * @property {string} cancelUrl
  * @property {{type: string, amount?: number, displayName?: string}} [shipping]
@@ -78,6 +78,13 @@ export async function createCheckoutSession(opts) {
     ];
   }
 
+  const itemsMeta = opts.items.map((i) => ({
+    sku: i.sku || '',
+    quantity: i.quantity,
+    metadata: i.metadata || {},
+  }));
+  params.metadata = { items: JSON.stringify(itemsMeta) };
+
   const session = await getStripe().checkout.sessions.create(params);
   return session.url;
 }

package/docs/staticart/CUSTOMIZATION.md

@@ -61,3 +61,60 @@ npx clearstack update             # re-vendor + sync docs
 ```
 
 Your config, tokens, products, and overrides are never touched.
+
+## Shipping Types
+
+StatiCart supports three shipping modes via `staticart.config.json`:
+
+### Flat Rate
+
+```json
+{ "shipping": { "type": "flat", "amount": 499 } }
+```
+
+### Tiered (by cart subtotal + product class)
+
+See the demo store config for a full example with `classes`, `regions`,
+and `tiers`.
+
+### Custom (external API)
+
+```json
+{ "shipping": { "type": "custom" } }
+```
+
+Create `api/lib/shipping-custom.js` exporting:
+
+```javascript
+export async function calculateShipping(ctx) {
+  // ctx.items — cart items with metadata
+  // ctx.country — ISO country code
+  // ctx.config — full staticart.config.json
+  return amountInCents;
+}
+```
+
+The platform calls this automatically when `shipping.type` is `"custom"`.
+
+## Stock Convention
+
+- `stock > 0` — finite inventory, decremented on purchase
+- `stock: 0` — out of stock, hidden from catalog
+- `stock: -1` — unlimited / dropship (always in stock, never decremented)
+
+Use `stock: -1` for print-on-demand or dropshipped products.
+
+## Post-Checkout Fulfillment
+
+To add fulfillment logic after a successful payment, import your module
+in `api/webhook.js` and call it after the order is recorded:
+
+```javascript
+import { fulfillOrder } from './lib/fulfillment.js';
+
+// Inside handleCheckoutCompleted, after putItem:
+const result = await fulfillOrder({ orderId, email, items, session });
+```
+
+Item metadata (from `products.json`) is passed through the Stripe session
+and available in the webhook's `items` array.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techninja/staticart",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "StatiCart — a full-featured e-commerce platform built 99% on static hosting",
   "repository": {
     "type": "git",

package/src/components/organisms/product-grid/product-grid.js

@@ -72,7 +72,7 @@ export default define({
         return html`<p>${t('general.loading')}</p>`;
       const filtered = /** @type {any[]} */ (products).filter(
         (p) =>
-          p.stock > 0 &&
+          p.stock !== 0 &&
           (!category ||
             (Array.isArray(p.category)
               ? p.category.includes(category)

package/src/store/Product.js

@@ -69,7 +69,7 @@ const Product = {
       const products = await fetchProducts();
       const p = /** @type {any} */ (params) || {};
       let filtered = products.filter((item) => item.active);
-      if (!p.showOutOfStock) filtered = filtered.filter((item) => item.stock > 0);
+      if (!p.showOutOfStock) filtered = filtered.filter((item) => item.stock !== 0);
       if (p.category) {
         filtered = filtered.filter((item) =>
           Array.isArray(item.category)

package/vendor/components/organisms/product-grid/product-grid.js

@@ -72,7 +72,7 @@ export default define({
         return html`<p>${t('general.loading')}</p>`;
       const filtered = /** @type {any[]} */ (products).filter(
         (p) =>
-          p.stock > 0 &&
+          p.stock !== 0 &&
           (!category ||
             (Array.isArray(p.category)
               ? p.category.includes(category)

package/vendor/store/Product.js

@@ -69,7 +69,7 @@ const Product = {
       const products = await fetchProducts();
       const p = /** @type {any} */ (params) || {};
       let filtered = products.filter((item) => item.active);
-      if (!p.showOutOfStock) filtered = filtered.filter((item) => item.stock > 0);
+      if (!p.showOutOfStock) filtered = filtered.filter((item) => item.stock !== 0);
       if (p.category) {
         filtered = filtered.filter((item) =>
           Array.isArray(item.category)