@stacksjs/commerce 0.75.138 → 0.75.140

package/README.md

@@ -28,14 +28,15 @@ import * as commerce from '@stacksjs/commerce'
 
 ### Shop rules in the browser
 
-Four modules are pure and import nothing, so a page bundles them on its own
-instead of the barrel (which imports the database):
+Five modules are pure and import nothing outside commerce, so a page bundles
+them on its own instead of the barrel (which imports the database):
 
 ```ts
 import { formatCurrency, parseMoneyInput } from '@stacksjs/commerce/money'
 import { addToBasket, basketTotal, stockLabel, CENTS_FIELDS } from '@stacksjs/commerce/register'
 import { compareCatalog, matchesSearch, isLowStock } from '@stacksjs/commerce/catalog'
 import { releaseSchedule, rolloutFromProduct, describeRollout } from '@stacksjs/commerce/releases'
+import { receiptLinesText } from '@stacksjs/commerce/receipt-text'
 
 // A front desk's basket, held to the stock on the shelf
 let basket = addToBasket([], gatorade, CENTS_FIELDS)
@@ -46,6 +47,9 @@ products.sort(compareCatalog(['Drinks', 'Apparel']))
 
 // When each video or week of a digital product opens for a buyer
 releaseSchedule(rolloutFromProduct(product), weeks, purchasedAt, new Date())
+
+// A receipt email's lines (pairs with the `order_receipt` notification template)
+receiptLinesText([{ name: 'Day pass', quantity: 2, amountMinor: 2000 }], 'EUR', 'en-US') // "2 × Day pass: €20.00"
 ```
 
 Learn more in the docs.

package/dist/index.d.ts

@@ -104,5 +104,6 @@ export {
 // charges. Browser code imports it from `@stacksjs/commerce/sales-tax`.
 export { breakdownFor, multiplierOf } from './sales-tax';
 export { restockedQuantity } from './inventory';
+export { receiptLinesText, type ReceiptTextLine } from './receipt-text';
 export { parseSalesTaxSetup, parseTaxRateWriteData } from './tax-input';
 export default commerce;

package/dist/index.js

@@ -1 +1 @@
-import*as auctions from"./auctions";import*as carts from"./carts";import*as catalog from"./catalog";import*as catalogImport from"./imports";import*as coupons from"./coupons";import*as customers from"./customers";import*as devices from"./devices";import*as errors from"./errors";import*as giftCards from"./gift-cards";import*as money from"./money";import*as orders from"./orders";import*as payments from"./payments";import*as products from"./products";import*as register from"./register";import*as releases from"./releases";import*as receipts from"./receipts";import*as shippings from"./shippings";import*as tax from"./tax";import*as waitlists from"./waitlists";import*as restaurant from"./waitlists/restaurant";export const commerce={auctions,carts,catalog,coupons,customers,devices,errors,giftCards,orders,payments,products,receipts,register,releases,restaurant,shippings,tax,waitlists};export default commerce;export{auctions,carts,catalog,catalogImport,coupons,customers,devices,errors,giftCards,money,orders,payments,products,receipts,register,releases,restaurant,shippings,tax,waitlists};export{currencyExponent,decimalToMinor,formatCurrency,formatMinor,minorToDecimal,minorToInput,minorToMajor,moneyInputError,moneyInputStep,parseMoneyInput,PriceFormatError}from"./money";export{breakdownFor,multiplierOf}from"./sales-tax";export{restockedQuantity}from"./inventory";export{parseSalesTaxSetup,parseTaxRateWriteData}from"./tax-input";
+import*as auctions from"./auctions";import*as carts from"./carts";import*as catalog from"./catalog";import*as catalogImport from"./imports";import*as coupons from"./coupons";import*as customers from"./customers";import*as devices from"./devices";import*as errors from"./errors";import*as giftCards from"./gift-cards";import*as money from"./money";import*as orders from"./orders";import*as payments from"./payments";import*as products from"./products";import*as register from"./register";import*as releases from"./releases";import*as receipts from"./receipts";import*as shippings from"./shippings";import*as tax from"./tax";import*as waitlists from"./waitlists";import*as restaurant from"./waitlists/restaurant";export const commerce={auctions,carts,catalog,coupons,customers,devices,errors,giftCards,orders,payments,products,receipts,register,releases,restaurant,shippings,tax,waitlists};export default commerce;export{auctions,carts,catalog,catalogImport,coupons,customers,devices,errors,giftCards,money,orders,payments,products,receipts,register,releases,restaurant,shippings,tax,waitlists};export{currencyExponent,decimalToMinor,formatCurrency,formatMinor,minorToDecimal,minorToInput,minorToMajor,moneyInputError,moneyInputStep,parseMoneyInput,PriceFormatError}from"./money";export{breakdownFor,multiplierOf}from"./sales-tax";export{restockedQuantity}from"./inventory";export{receiptLinesText}from"./receipt-text";export{parseSalesTaxSetup,parseTaxRateWriteData}from"./tax-input";

package/dist/receipt-text.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A purchase's lines as plain text, one per line, for a receipt email or
+ * text: `2 × Day pass: €20.00`. Amounts are formatted for `locale` in the
+ * order's `currency`, so a receipt never shows a bare number.
+ *
+ * Browser-safe; pairs with the `order_receipt` template from
+ * `@stacksjs/notifications/templates`.
+ */
+export declare function receiptLinesText(lines: ReceiptTextLine[], currency: string, locale?: string): string;
+/** One line of a purchase, as a receipt shows it. */
+export declare interface ReceiptTextLine {
+  name: string
+  quantity?: number
+  amountMinor: number
+}

package/dist/receipt-text.js

@@ -0,0 +1,2 @@
+import{formatCurrency}from"./money";export function receiptLinesText(lines,currency,locale){return lines.map((line)=>{const quantity=Math.max(1,Math.trunc(Number(line.quantity??1))||1),name=String(line.name||"").replace(/\s+/g," ").trim();return`${quantity>1?`${quantity} \xD7 `:""}${name}: ${formatCurrency(line.amountMinor,currency,locale)}`}).join(`
+`)}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/commerce",
   "type": "module",
-  "version": "0.75.138",
+  "version": "0.75.140",
   "description": "Stacks commerce utilities.",
   "author": "Chris Breuer",
   "contributors": [
@@ -57,18 +57,18 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/cache": "0.75.138",
-    "@stacksjs/config": "0.75.138",
-    "@stacksjs/database": "0.75.138",
-    "@stacksjs/env": "0.75.138",
-    "@stacksjs/error-handling": "0.75.138",
-    "@stacksjs/events": "0.75.138",
-    "@stacksjs/logging": "0.75.138",
-    "@stacksjs/orm": "0.75.138",
-    "@stacksjs/payments": "0.75.138",
-    "@stacksjs/realtime": "0.75.138",
-    "@stacksjs/strings": "0.75.138",
-    "@stacksjs/validation": "0.75.138",
+    "@stacksjs/cache": "0.75.140",
+    "@stacksjs/config": "0.75.140",
+    "@stacksjs/database": "0.75.140",
+    "@stacksjs/env": "0.75.140",
+    "@stacksjs/error-handling": "0.75.140",
+    "@stacksjs/events": "0.75.140",
+    "@stacksjs/logging": "0.75.140",
+    "@stacksjs/orm": "0.75.140",
+    "@stacksjs/payments": "0.75.140",
+    "@stacksjs/realtime": "0.75.140",
+    "@stacksjs/strings": "0.75.140",
+    "@stacksjs/validation": "0.75.140",
     "ts-spreadsheets": "^0.2.0"
   },
   "devDependencies": {