@stacksjs/commerce 0.75.105 → 0.75.107

package/dist/orders/index.d.ts

@@ -1,4 +1,5 @@
 export type { PlaceOrderInput, PlaceOrderLineItem, PlaceOrderResult } from './place-order';
+export type { OrderTransitionOptions } from './transition';
 export type { OrderStatus } from './events';
 export type {
   RecomputeLineItem,
@@ -39,6 +40,7 @@ export {
 // Wraps order + lines + payment + inventory + idempotency in a
 // single transaction so any failure rolls back the rest.
 export { findOrderByIdempotencyKey, placeOrder } from './place-order';
+export { transitionStatus } from './transition';
 // Event bus integration + status-transition state machine
 // (stacksjs/stacks#1879 Co-18, Co-4). Emit helpers fire
 // order:created / order:paid / order:shipped / order:delivered /

package/dist/orders/transition.d.ts

@@ -0,0 +1,8 @@
+import { db } from '@stacksjs/database/runtime';
+import type { OrderStatus } from './events';
+/** A conditional status change and its delivery share one commit and one event. */
+export declare function transitionStatus(id: number, from: OrderStatus, to: OrderStatus, options?: OrderTransitionOptions): Promise<boolean>;
+export declare interface OrderTransitionOptions {
+  values?: Record<string, unknown>
+  apply?: (transaction: Parameters<Parameters<typeof db.transaction>[0]>[0], order: Record<string, unknown>) => Promise<void>
+}

package/dist/orders/update.d.ts

@@ -1,3 +1,4 @@
+import { transitionStatus } from './transition';
 import type { ModelRow, Order, UpdateModelData } from '@stacksjs/orm';
 import type { OrderStatus } from './events';
 /**
@@ -25,5 +26,7 @@ export declare function updateStatus(id: number, status: OrderStatus): Promise<O
  * @returns The updated order
  */
 export declare function updateDeliveryInfo(id: number, delivery_address?: string, estimated_delivery_time?: string): Promise<OrderJsonResponse | undefined>;
+// Import dependencies
 declare type OrderJsonResponse = ModelRow<typeof Order>;
 declare type OrderUpdate = UpdateModelData<typeof Order>;
+export { transitionStatus } from './transition';

package/dist/refund-allocation.d.ts

@@ -0,0 +1,4 @@
+/** Allocate a requested refund against its original cash and account-credit tenders. */
+export declare function allocateRefund(amount: number, cashRemaining: number, creditRemaining: number): { cash: number, credit: number };
+/** Difference of cumulative rounded tax keeps split refunds equal to a full refund. */
+export declare function refundTaxDelta(before: number, amount: number, total: number, tax: number): number;

package/dist/refund-allocation.js

@@ -0,0 +1,2 @@
+// @bun
+function d(r,n,e){if(![r,n,e].every((b)=>Number.isSafeInteger(b)&&b>=0)||r<1||r>n+e)throw Error("Refund amount exceeds remaining refundable amount");let u=Math.min(r,n);return{cash:u,credit:r-u}}function f(r,n,e,u){if(![r,n,e,u].every((b)=>Number.isSafeInteger(b)&&b>=0)||r+n>e)throw Error("Invalid refund tax amounts");if(e===0)return 0;return Math.round((r+n)*u/e)-Math.round(r*u/e)}export{d as allocateRefund,f as refundTaxDelta};

package/dist/register.d.ts

@@ -1,3 +1,5 @@
+/** Combine repeated products into one validated line before checking or writing stock. */
+export declare function normalizeBasket(basket: readonly BasketLine[]): BasketLine[];
 /** Units still on the shelf once the basket is taken off it; null when stock is not counted. */
 export declare function shelfLeft(product: Product, basket: BasketLine[], fields?: RegisterFields): number | null;
 /** Whether one more can be rung up. */

package/dist/register.js

@@ -1,2 +1,2 @@
 // @bun
-var k=Object.defineProperty;var x=(t)=>t;function m(t,n){this[t]=x.bind(null,n)}var b=(t,n)=>{for(var e in n)k(t,e,{get:n[e],enumerable:!0,configurable:!0,set:m.bind(n,e)})};var h=(t,n,e)=>()=>{if(t)try{n=t(t=0)}catch(r){e=[r]}if(e)throw e[0];return n};var S={};b(S,{CENTS_FIELDS:()=>g,DEFAULT_FIELDS:()=>u,addToBasket:()=>L,basketCount:()=>B,basketLines:()=>l,basketTaxable:()=>I,basketTotal:()=>F,canAdd:()=>f,groupsOf:()=>T,setQuantity:()=>y,shelfLeft:()=>a,stockLabel:()=>R});var u={id:"id",price:"price",inventory:"inventory",lowStock:"low_stock_threshold",taxable:"taxable"},g={id:"id",price:"price_cents",inventory:"inventory_quantity",lowStock:"low_stock_threshold",taxable:"taxable"};function s(t,n){return Number(t[n.id])}function p(t,n){let e=t[n.inventory];return e===null||e===void 0||e===""?null:Number(e)}function a(t,n,e=u){let r=p(t,e);if(r===null)return null;let o=n.find((c)=>c.productId===s(t,e))?.quantity||0;return Math.max(0,r-o)}function f(t,n,e=u){let r=a(t,n,e);return r===null||r>0}function L(t,n,e=u){if(!f(n,t,e))return t;let r=s(n,e);return t.some((o)=>o.productId===r)?t.map((o)=>o.productId===r?{...o,quantity:o.quantity+1}:o):[...t,{productId:r,quantity:1}]}function y(t,n,e,r=u){let o=s(n,r),c=p(n,r),d=Math.min(Math.max(0,Math.floor(Number(e)||0)),c===null?Number.POSITIVE_INFINITY:c);if(d===0)return t.filter((i)=>i.productId!==o);return t.some((i)=>i.productId===o)?t.map((i)=>i.productId===o?{...i,quantity:d}:i):[...t,{productId:o,quantity:d}]}function l(t,n,e=u){return t.map((r)=>({...r,product:n.find((o)=>s(o,e)===r.productId)})).filter((r)=>!!r.product)}function F(t,n,e=u){return l(t,n,e).reduce((r,o)=>r+Number(o.product[e.price]||0)*o.quantity,0)}function I(t,n,e=u){return l(t,n,e).filter((r)=>r.product[e.taxable]!==!1).reduce((r,o)=>r+Number(o.product[e.price]||0)*o.quantity,0)}function B(t){return t.reduce((n,e)=>n+e.quantity,0)}function R(t,n=[],e=u,r=5){let o=a(t,n,e);if(o===null)return null;if(o===0)return{text:"Sold out",tone:"out"};let c=t[e.lowStock]===null||t[e.lowStock]===void 0?r:Number(t[e.lowStock]);return{text:`${o} left`,tone:o<=c?"low":"ok"}}function T(t,n){let e=[];for(let r of t){let o=n(r);if(!e.includes(o))e.push(o)}return e}export{g as CENTS_FIELDS,u as DEFAULT_FIELDS,L as addToBasket,B as basketCount,l as basketLines,I as basketTaxable,F as basketTotal,f as canAdd,T as groupsOf,y as setQuantity,a as shelfLeft,R as stockLabel};
+var g=Object.defineProperty;var k=(t)=>t;function x(t,r){this[t]=k.bind(null,r)}var b=(t,r)=>{for(var e in r)g(t,e,{get:r[e],enumerable:!0,configurable:!0,set:x.bind(r,e)})};var R=(t,r,e)=>()=>{if(t)try{r=t(t=0)}catch(n){e=[n]}if(e)throw e[0];return r};var q={};b(q,{CENTS_FIELDS:()=>y,DEFAULT_FIELDS:()=>u,addToBasket:()=>L,basketCount:()=>w,basketLines:()=>p,basketTaxable:()=>F,basketTotal:()=>I,canAdd:()=>m,groupsOf:()=>h,normalizeBasket:()=>d,setQuantity:()=>B,shelfLeft:()=>l,stockLabel:()=>S});var u={id:"id",price:"price",inventory:"inventory",lowStock:"low_stock_threshold",taxable:"taxable"},y={id:"id",price:"price_cents",inventory:"inventory_quantity",lowStock:"low_stock_threshold",taxable:"taxable"};function a(t,r){return Number(t[r.id])}function f(t,r){let e=t[r.inventory];return e===null||e===void 0||e===""?null:Number(e)}function d(t){let r=new Map;for(let{productId:e,quantity:n}of t){if(!Number.isSafeInteger(e)||e<1||!Number.isSafeInteger(n)||n<1)throw Error("Basket products and quantities must be positive safe integers");let o=(r.get(e)||0)+n;if(!Number.isSafeInteger(o))throw Error("Basket quantity exceeds the safe integer range");r.set(e,o)}return[...r].map(([e,n])=>({productId:e,quantity:n}))}function l(t,r,e=u){let n=f(t,e);if(n===null)return null;let o=r.filter((i)=>i.productId===a(t,e)).reduce((i,c)=>i+c.quantity,0);return Math.max(0,n-o)}function m(t,r,e=u){let n=l(t,r,e);return n===null||n>0}function L(t,r,e=u){let n=d(t);if(!m(r,n,e))return t;t=n;let o=a(r,e);return t.some((i)=>i.productId===o)?t.map((i)=>i.productId===o?{...i,quantity:i.quantity+1}:i):[...t,{productId:o,quantity:1}]}function B(t,r,e,n=u){let o=a(r,n),i=f(r,n);t=d(t);let c=Math.min(Math.max(0,Math.floor(Number(e)||0)),i===null?Number.POSITIVE_INFINITY:i);if(c===0)return t.filter((s)=>s.productId!==o);return t.some((s)=>s.productId===o)?t.map((s)=>s.productId===o?{...s,quantity:c}:s):[...t,{productId:o,quantity:c}]}function p(t,r,e=u){return d(t).map((n)=>({...n,product:r.find((o)=>a(o,e)===n.productId)})).filter((n)=>!!n.product)}function I(t,r,e=u){return p(t,r,e).reduce((n,o)=>n+Number(o.product[e.price]||0)*o.quantity,0)}function F(t,r,e=u){return p(t,r,e).filter((n)=>n.product[e.taxable]!==!1).reduce((n,o)=>n+Number(o.product[e.price]||0)*o.quantity,0)}function w(t){return t.reduce((r,e)=>r+e.quantity,0)}function S(t,r=[],e=u,n=5){let o=l(t,r,e);if(o===null)return null;if(o===0)return{text:"Sold out",tone:"out"};let i=t[e.lowStock]===null||t[e.lowStock]===void 0?n:Number(t[e.lowStock]);return{text:`${o} left`,tone:o<=i?"low":"ok"}}function h(t,r){let e=[];for(let n of t){let o=r(n);if(!e.includes(o))e.push(o)}return e}export{y as CENTS_FIELDS,u as DEFAULT_FIELDS,L as addToBasket,w as basketCount,p as basketLines,F as basketTaxable,I as basketTotal,m as canAdd,h as groupsOf,d as normalizeBasket,B as setQuantity,l as shelfLeft,S as stockLabel};

package/dist/tsconfig.json

@@ -0,0 +1,5 @@
+{
+  "compilerOptions": {
+    "paths": {}
+  }
+}

package/package.json

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