@aglyn/plugins-commerce 1.0.0-beta.229 → 1.0.0-beta.231

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (590) hide show
  1. package/package.json +13 -13
  2. package/src/index.d.ts +0 -1
  3. package/src/index.js +0 -1
  4. package/src/index.js.map +1 -1
  5. package/src/lib/barcode/barcode-decode.d.ts +71 -0
  6. package/src/lib/barcode/barcode-decode.js +498 -0
  7. package/src/lib/barcode/barcode-decode.js.map +1 -0
  8. package/src/lib/barcode/barcode-encode.d.ts +44 -0
  9. package/src/lib/barcode/barcode-encode.js +138 -0
  10. package/src/lib/barcode/barcode-encode.js.map +1 -0
  11. package/src/lib/barcode/barcode-scanner.component.d.ts +23 -0
  12. package/src/lib/barcode/barcode-scanner.component.js +260 -0
  13. package/src/lib/barcode/barcode-scanner.component.js.map +1 -0
  14. package/src/lib/barcode/scan-button.component.d.ts +10 -0
  15. package/src/lib/barcode/scan-button.component.js +62 -0
  16. package/src/lib/barcode/scan-button.component.js.map +1 -0
  17. package/src/lib/barcode/scanner-wedge.d.ts +35 -0
  18. package/src/lib/barcode/scanner-wedge.js +108 -0
  19. package/src/lib/barcode/scanner-wedge.js.map +1 -0
  20. package/src/lib/components/account.js +10 -1
  21. package/src/lib/components/account.js.map +1 -1
  22. package/src/lib/components/cart-extras.d.ts +45 -0
  23. package/src/lib/components/cart-extras.js +127 -0
  24. package/src/lib/components/cart-extras.js.map +1 -0
  25. package/src/lib/components/cart.js +82 -15
  26. package/src/lib/components/cart.js.map +1 -1
  27. package/src/lib/components/checkout-return-notice.d.ts +26 -0
  28. package/src/lib/components/checkout-return-notice.js +48 -0
  29. package/src/lib/components/checkout-return-notice.js.map +1 -0
  30. package/src/lib/components/commerce-console-page.js +124 -0
  31. package/src/lib/components/commerce-console-page.js.map +1 -1
  32. package/src/lib/components/commerce-console-sections.d.ts +1 -1
  33. package/src/lib/components/commerce-console-sections.js +4 -0
  34. package/src/lib/components/commerce-console-sections.js.map +1 -1
  35. package/src/lib/components/console/bulk-fulfill.d.ts +44 -0
  36. package/src/lib/components/console/bulk-fulfill.js +84 -0
  37. package/src/lib/components/console/bulk-fulfill.js.map +1 -0
  38. package/src/lib/components/console/customer-notifications-card.component.d.ts +19 -0
  39. package/src/lib/components/console/customer-notifications-card.component.js +149 -0
  40. package/src/lib/components/console/customer-notifications-card.component.js.map +1 -0
  41. package/src/lib/components/console/host-orders-card.component.js +84 -5
  42. package/src/lib/components/console/host-orders-card.component.js.map +1 -1
  43. package/src/lib/components/console/locations-card.component.js +164 -57
  44. package/src/lib/components/console/locations-card.component.js.map +1 -1
  45. package/src/lib/components/console/order-detail-dialog.component.js +209 -61
  46. package/src/lib/components/console/order-detail-dialog.component.js.map +1 -1
  47. package/src/lib/components/console/order-fulfillment-panel.component.d.ts +48 -0
  48. package/src/lib/components/console/order-fulfillment-panel.component.js +542 -0
  49. package/src/lib/components/console/order-fulfillment-panel.component.js.map +1 -0
  50. package/src/lib/components/console/order-invoice.component.d.ts +33 -0
  51. package/src/lib/components/console/order-invoice.component.js +81 -0
  52. package/src/lib/components/console/order-invoice.component.js.map +1 -0
  53. package/src/lib/components/console/order-receipt-resend.component.d.ts +21 -0
  54. package/src/lib/components/console/order-receipt-resend.component.js +203 -0
  55. package/src/lib/components/console/order-receipt-resend.component.js.map +1 -0
  56. package/src/lib/components/console/order-returns.component.d.ts +36 -0
  57. package/src/lib/components/console/order-returns.component.js +142 -0
  58. package/src/lib/components/console/order-returns.component.js.map +1 -0
  59. package/src/lib/components/console/order-shipping-actions.component.d.ts +54 -0
  60. package/src/lib/components/console/order-shipping-actions.component.js +149 -0
  61. package/src/lib/components/console/order-shipping-actions.component.js.map +1 -0
  62. package/src/lib/components/console/order-webhooks-card.component.d.ts +50 -0
  63. package/src/lib/components/console/order-webhooks-card.component.js +623 -0
  64. package/src/lib/components/console/order-webhooks-card.component.js.map +1 -0
  65. package/src/lib/components/console/order-zones.d.ts +155 -0
  66. package/src/lib/components/console/order-zones.js +40 -0
  67. package/src/lib/components/console/order-zones.js.map +1 -0
  68. package/src/lib/components/console/payment-methods-card.component.d.ts +67 -0
  69. package/src/lib/components/console/payment-methods-card.component.js +395 -0
  70. package/src/lib/components/console/payment-methods-card.component.js.map +1 -0
  71. package/src/lib/components/console/pos/pos-api.d.ts +124 -0
  72. package/src/lib/components/console/pos/pos-api.js +101 -0
  73. package/src/lib/components/console/pos/pos-api.js.map +1 -0
  74. package/src/lib/components/console/pos/pos-cart-panel.component.d.ts +36 -0
  75. package/src/lib/components/console/pos/pos-cart-panel.component.js +160 -0
  76. package/src/lib/components/console/pos/pos-cart-panel.component.js.map +1 -0
  77. package/src/lib/components/console/pos/pos-item-dialog.component.d.ts +39 -0
  78. package/src/lib/components/console/pos/pos-item-dialog.component.js +352 -0
  79. package/src/lib/components/console/pos/pos-item-dialog.component.js.map +1 -0
  80. package/src/lib/components/console/pos/pos-product-grid.component.d.ts +47 -0
  81. package/src/lib/components/console/pos/pos-product-grid.component.js +272 -0
  82. package/src/lib/components/console/pos/pos-product-grid.component.js.map +1 -0
  83. package/src/lib/components/console/pos/pos-receipt-panel.component.d.ts +27 -0
  84. package/src/lib/components/console/pos/pos-receipt-panel.component.js +282 -0
  85. package/src/lib/components/console/pos/pos-receipt-panel.component.js.map +1 -0
  86. package/src/lib/components/console/pos/pos-tender-dialogs.component.d.ts +53 -0
  87. package/src/lib/components/console/pos/pos-tender-dialogs.component.js +445 -0
  88. package/src/lib/components/console/pos/pos-tender-dialogs.component.js.map +1 -0
  89. package/src/lib/components/console/pos/pos-tender-panel.component.d.ts +31 -0
  90. package/src/lib/components/console/pos/pos-tender-panel.component.js +640 -0
  91. package/src/lib/components/console/pos/pos-tender-panel.component.js.map +1 -0
  92. package/src/lib/components/console/pos/use-pos-display.d.ts +43 -0
  93. package/src/lib/components/console/pos/use-pos-display.js +161 -0
  94. package/src/lib/components/console/pos/use-pos-display.js.map +1 -0
  95. package/src/lib/components/console/pos-devices-card.component.d.ts +14 -0
  96. package/src/lib/components/console/pos-devices-card.component.js +546 -0
  97. package/src/lib/components/console/pos-devices-card.component.js.map +1 -0
  98. package/src/lib/components/console/pos-display/brand-screen.d.ts +33 -0
  99. package/src/lib/components/console/pos-display/brand-screen.js +85 -0
  100. package/src/lib/components/console/pos-display/brand-screen.js.map +1 -0
  101. package/src/lib/components/console/pos-display/cart-screen.d.ts +29 -0
  102. package/src/lib/components/console/pos-display/cart-screen.js +166 -0
  103. package/src/lib/components/console/pos-display/cart-screen.js.map +1 -0
  104. package/src/lib/components/console/pos-display/pairing-screen.d.ts +24 -0
  105. package/src/lib/components/console/pos-display/pairing-screen.js +127 -0
  106. package/src/lib/components/console/pos-display/pairing-screen.js.map +1 -0
  107. package/src/lib/components/console/pos-display/pos-display-api.d.ts +90 -0
  108. package/src/lib/components/console/pos-display/pos-display-api.js +140 -0
  109. package/src/lib/components/console/pos-display/pos-display-api.js.map +1 -0
  110. package/src/lib/components/console/pos-display/receipt-screen.d.ts +35 -0
  111. package/src/lib/components/console/pos-display/receipt-screen.js +200 -0
  112. package/src/lib/components/console/pos-display/receipt-screen.js.map +1 -0
  113. package/src/lib/components/console/pos-display/tip-screen.d.ts +36 -0
  114. package/src/lib/components/console/pos-display/tip-screen.js +211 -0
  115. package/src/lib/components/console/pos-display/tip-screen.js.map +1 -0
  116. package/src/lib/components/console/pos-display-page.component.d.ts +16 -0
  117. package/src/lib/components/console/pos-display-page.component.js +407 -0
  118. package/src/lib/components/console/pos-display-page.component.js.map +1 -0
  119. package/src/lib/components/console/pos-ops/pos-customer-lookup.component.d.ts +40 -0
  120. package/src/lib/components/console/pos-ops/pos-customer-lookup.component.js +289 -0
  121. package/src/lib/components/console/pos-ops/pos-customer-lookup.component.js.map +1 -0
  122. package/src/lib/components/console/pos-ops/pos-last-receipt.component.d.ts +34 -0
  123. package/src/lib/components/console/pos-ops/pos-last-receipt.component.js +61 -0
  124. package/src/lib/components/console/pos-ops/pos-last-receipt.component.js.map +1 -0
  125. package/src/lib/components/console/pos-ops/pos-operations-bar.component.d.ts +38 -0
  126. package/src/lib/components/console/pos-ops/pos-operations-bar.component.js +129 -0
  127. package/src/lib/components/console/pos-ops/pos-operations-bar.component.js.map +1 -0
  128. package/src/lib/components/console/pos-ops/pos-ops-api.d.ts +37 -0
  129. package/src/lib/components/console/pos-ops/pos-ops-api.js +60 -0
  130. package/src/lib/components/console/pos-ops/pos-ops-api.js.map +1 -0
  131. package/src/lib/components/console/pos-ops/pos-pin-pad.component.d.ts +48 -0
  132. package/src/lib/components/console/pos-ops/pos-pin-pad.component.js +220 -0
  133. package/src/lib/components/console/pos-ops/pos-pin-pad.component.js.map +1 -0
  134. package/src/lib/components/console/pos-ops/pos-receipt-actions.component.d.ts +63 -0
  135. package/src/lib/components/console/pos-ops/pos-receipt-actions.component.js +186 -0
  136. package/src/lib/components/console/pos-ops/pos-receipt-actions.component.js.map +1 -0
  137. package/src/lib/components/console/pos-ops/pos-receipt.d.ts +39 -0
  138. package/src/lib/components/console/pos-ops/pos-receipt.js +182 -0
  139. package/src/lib/components/console/pos-ops/pos-receipt.js.map +1 -0
  140. package/src/lib/components/console/pos-ops/pos-return-dialog.component.d.ts +40 -0
  141. package/src/lib/components/console/pos-ops/pos-return-dialog.component.js +465 -0
  142. package/src/lib/components/console/pos-ops/pos-return-dialog.component.js.map +1 -0
  143. package/src/lib/components/console/pos-ops/pos-shift-history-card.component.d.ts +29 -0
  144. package/src/lib/components/console/pos-ops/pos-shift-history-card.component.js +253 -0
  145. package/src/lib/components/console/pos-ops/pos-shift-history-card.component.js.map +1 -0
  146. package/src/lib/components/console/pos-ops/pos-shift-panel.component.d.ts +34 -0
  147. package/src/lib/components/console/pos-ops/pos-shift-panel.component.js +494 -0
  148. package/src/lib/components/console/pos-ops/pos-shift-panel.component.js.map +1 -0
  149. package/src/lib/components/console/pos-ops/pos-shift-report.component.d.ts +37 -0
  150. package/src/lib/components/console/pos-ops/pos-shift-report.component.js +102 -0
  151. package/src/lib/components/console/pos-ops/pos-shift-report.component.js.map +1 -0
  152. package/src/lib/components/console/pos-ops/pos-staff-pins-card.component.d.ts +30 -0
  153. package/src/lib/components/console/pos-ops/pos-staff-pins-card.component.js +277 -0
  154. package/src/lib/components/console/pos-ops/pos-staff-pins-card.component.js.map +1 -0
  155. package/src/lib/components/console/pos-ops/register-ops.d.ts +28 -0
  156. package/src/lib/components/console/pos-ops/register-ops.js +28 -0
  157. package/src/lib/components/console/pos-ops/register-ops.js.map +1 -0
  158. package/src/lib/components/console/pos-ops/use-pos-cashier.d.ts +46 -0
  159. package/src/lib/components/console/pos-ops/use-pos-cashier.js +128 -0
  160. package/src/lib/components/console/pos-ops/use-pos-cashier.js.map +1 -0
  161. package/src/lib/components/console/pos-ops/use-pos-sale-receipt.d.ts +36 -0
  162. package/src/lib/components/console/pos-ops/use-pos-sale-receipt.js +64 -0
  163. package/src/lib/components/console/pos-ops/use-pos-sale-receipt.js.map +1 -0
  164. package/src/lib/components/console/pos-page.component.d.ts +13 -5
  165. package/src/lib/components/console/pos-page.component.js +729 -657
  166. package/src/lib/components/console/pos-page.component.js.map +1 -1
  167. package/src/lib/components/console/product-editor-dialog.component.js +51 -7
  168. package/src/lib/components/console/product-editor-dialog.component.js.map +1 -1
  169. package/src/lib/components/console/product-labels-dialog.component.d.ts +13 -0
  170. package/src/lib/components/console/product-labels-dialog.component.js +197 -0
  171. package/src/lib/components/console/product-labels-dialog.component.js.map +1 -0
  172. package/src/lib/components/console/product-register-fields.component.d.ts +19 -0
  173. package/src/lib/components/console/product-register-fields.component.js +241 -0
  174. package/src/lib/components/console/product-register-fields.component.js.map +1 -0
  175. package/src/lib/components/console/product-zones.d.ts +58 -2
  176. package/src/lib/components/console/product-zones.js +10 -2
  177. package/src/lib/components/console/product-zones.js.map +1 -1
  178. package/src/lib/components/console/products-hub-card.component.js +51 -11
  179. package/src/lib/components/console/products-hub-card.component.js.map +1 -1
  180. package/src/lib/components/console/register-hardware-card.component.d.ts +33 -0
  181. package/src/lib/components/console/register-hardware-card.component.js +826 -0
  182. package/src/lib/components/console/register-hardware-card.component.js.map +1 -0
  183. package/src/lib/components/console/registers-card.component.js +24 -5
  184. package/src/lib/components/console/registers-card.component.js.map +1 -1
  185. package/src/lib/components/console/return-actions.d.ts +38 -0
  186. package/src/lib/components/console/return-actions.js +76 -0
  187. package/src/lib/components/console/return-actions.js.map +1 -0
  188. package/src/lib/components/console/return-detail-dialog.component.d.ts +34 -0
  189. package/src/lib/components/console/return-detail-dialog.component.js +718 -0
  190. package/src/lib/components/console/return-detail-dialog.component.js.map +1 -0
  191. package/src/lib/components/console/return-settings-card.component.d.ts +34 -0
  192. package/src/lib/components/console/return-settings-card.component.js +195 -0
  193. package/src/lib/components/console/return-settings-card.component.js.map +1 -0
  194. package/src/lib/components/console/return-zones.d.ts +87 -0
  195. package/src/lib/components/console/return-zones.js +31 -0
  196. package/src/lib/components/console/return-zones.js.map +1 -0
  197. package/src/lib/components/console/returns-card.component.d.ts +45 -0
  198. package/src/lib/components/console/returns-card.component.js +159 -0
  199. package/src/lib/components/console/returns-card.component.js.map +1 -0
  200. package/src/lib/components/console/shipping-settings-card.component.js +161 -5
  201. package/src/lib/components/console/shipping-settings-card.component.js.map +1 -1
  202. package/src/lib/components/console/shippingeasy-card.component.d.ts +59 -0
  203. package/src/lib/components/console/shippingeasy-card.component.js +378 -0
  204. package/src/lib/components/console/shippingeasy-card.component.js.map +1 -0
  205. package/src/lib/components/console/shipstation-card.component.d.ts +35 -0
  206. package/src/lib/components/console/shipstation-card.component.js +345 -0
  207. package/src/lib/components/console/shipstation-card.component.js.map +1 -0
  208. package/src/lib/components/console/start-return-dialog.component.d.ts +40 -0
  209. package/src/lib/components/console/start-return-dialog.component.js +243 -0
  210. package/src/lib/components/console/start-return-dialog.component.js.map +1 -0
  211. package/src/lib/components/console/stock-movements-card.component.js +2 -1
  212. package/src/lib/components/console/stock-movements-card.component.js.map +1 -1
  213. package/src/lib/components/console/store-settings-card.component.js +2 -66
  214. package/src/lib/components/console/store-settings-card.component.js.map +1 -1
  215. package/src/lib/components/console/store-zones.d.ts +42 -0
  216. package/src/lib/components/console/store-zones.js +39 -0
  217. package/src/lib/components/console/store-zones.js.map +1 -0
  218. package/src/lib/components/order-status.d.ts +36 -0
  219. package/src/lib/components/order-status.js +502 -0
  220. package/src/lib/components/order-status.js.map +1 -0
  221. package/src/lib/components/product-detail.js +44 -2
  222. package/src/lib/components/product-detail.js.map +1 -1
  223. package/src/lib/components/return-request.d.ts +32 -0
  224. package/src/lib/components/return-request.js +576 -0
  225. package/src/lib/components/return-request.js.map +1 -0
  226. package/src/lib/components/storefront-payment-appearance.d.ts +32 -0
  227. package/src/lib/components/storefront-payment-appearance.js +114 -0
  228. package/src/lib/components/storefront-payment-appearance.js.map +1 -0
  229. package/src/lib/components/storefront-payment-element.d.ts +57 -1
  230. package/src/lib/components/storefront-payment-element.js +332 -33
  231. package/src/lib/components/storefront-payment-element.js.map +1 -1
  232. package/src/lib/constants/order-status.d.ts +22 -0
  233. package/src/lib/constants/order-status.js +22 -0
  234. package/src/lib/constants/order-status.js.map +1 -0
  235. package/src/lib/constants/return-request.d.ts +27 -0
  236. package/src/lib/constants/return-request.js +32 -0
  237. package/src/lib/constants/return-request.js.map +1 -0
  238. package/src/lib/constants/stock-movement-query.js +2 -1
  239. package/src/lib/constants/stock-movement-query.js.map +1 -1
  240. package/src/lib/declarations.console-server.js +9 -0
  241. package/src/lib/declarations.console-server.js.map +1 -1
  242. package/src/lib/declarations.server.d.ts +2 -1
  243. package/src/lib/declarations.server.js +47 -1
  244. package/src/lib/declarations.server.js.map +1 -1
  245. package/src/lib/model/buyer-notifications.d.ts +59 -0
  246. package/src/lib/model/buyer-notifications.js +97 -0
  247. package/src/lib/model/buyer-notifications.js.map +1 -0
  248. package/src/lib/model/commerce-orders.d.ts +127 -1
  249. package/src/lib/model/commerce-orders.js +24 -15
  250. package/src/lib/model/commerce-orders.js.map +1 -1
  251. package/src/lib/model/commerce-payment-methods.d.ts +146 -0
  252. package/src/lib/model/commerce-payment-methods.js +247 -0
  253. package/src/lib/model/commerce-payment-methods.js.map +1 -0
  254. package/src/lib/model/commerce-pos-ops.d.ts +437 -0
  255. package/src/lib/model/commerce-pos-ops.js +721 -0
  256. package/src/lib/model/commerce-pos-ops.js.map +1 -0
  257. package/src/lib/model/commerce-pos.d.ts +263 -0
  258. package/src/lib/model/commerce-pos.js +375 -0
  259. package/src/lib/model/commerce-pos.js.map +1 -0
  260. package/src/lib/model/commerce-printers.d.ts +211 -0
  261. package/src/lib/model/commerce-printers.js +181 -0
  262. package/src/lib/model/commerce-printers.js.map +1 -0
  263. package/src/lib/model/commerce-receipt.d.ts +97 -0
  264. package/src/lib/model/commerce-receipt.js +180 -0
  265. package/src/lib/model/commerce-receipt.js.map +1 -0
  266. package/src/lib/model/commerce-returns.d.ts +207 -0
  267. package/src/lib/model/commerce-returns.js +300 -0
  268. package/src/lib/model/commerce-returns.js.map +1 -0
  269. package/src/lib/model/commerce-shipping.d.ts +44 -1
  270. package/src/lib/model/commerce-shipping.js +53 -9
  271. package/src/lib/model/commerce-shipping.js.map +1 -1
  272. package/src/lib/model/commerce-tax-engine.d.ts +90 -0
  273. package/src/lib/model/commerce-tax-engine.js +129 -0
  274. package/src/lib/model/commerce-tax-engine.js.map +1 -0
  275. package/src/lib/model/commerce.d.ts +88 -2
  276. package/src/lib/model/commerce.js +89 -1
  277. package/src/lib/model/commerce.js.map +1 -1
  278. package/src/lib/model/index.d.ts +15 -0
  279. package/src/lib/model/index.js +15 -0
  280. package/src/lib/model/index.js.map +1 -1
  281. package/src/lib/model/order-events.d.ts +154 -0
  282. package/src/lib/model/order-events.js +153 -0
  283. package/src/lib/model/order-events.js.map +1 -0
  284. package/src/lib/model/order-fulfillment.d.ts +117 -0
  285. package/src/lib/model/order-fulfillment.js +217 -0
  286. package/src/lib/model/order-fulfillment.js.map +1 -0
  287. package/src/lib/model/order-history.d.ts +58 -0
  288. package/src/lib/model/order-history.js +22 -0
  289. package/src/lib/model/order-history.js.map +1 -0
  290. package/src/lib/model/order-list-fields.d.ts +9 -1
  291. package/src/lib/model/order-list-fields.js +7 -1
  292. package/src/lib/model/order-list-fields.js.map +1 -1
  293. package/src/lib/model/order-shipping-export.d.ts +91 -0
  294. package/src/lib/model/order-shipping-export.js +192 -0
  295. package/src/lib/model/order-shipping-export.js.map +1 -0
  296. package/src/lib/model/order-status-view.d.ts +103 -0
  297. package/src/lib/model/order-status-view.js +156 -0
  298. package/src/lib/model/order-status-view.js.map +1 -0
  299. package/src/lib/model/order-webhooks.d.ts +142 -0
  300. package/src/lib/model/order-webhooks.js +91 -0
  301. package/src/lib/model/order-webhooks.js.map +1 -0
  302. package/src/lib/model/product-channel.d.ts +56 -0
  303. package/src/lib/model/product-channel.js +86 -0
  304. package/src/lib/model/product-channel.js.map +1 -0
  305. package/src/lib/model/product-modifiers.d.ts +80 -0
  306. package/src/lib/model/product-modifiers.js +140 -0
  307. package/src/lib/model/product-modifiers.js.map +1 -0
  308. package/src/lib/model/shippingeasy.d.ts +94 -0
  309. package/src/lib/model/shippingeasy.js +267 -0
  310. package/src/lib/model/shippingeasy.js.map +1 -0
  311. package/src/lib/model/shipstation.d.ts +125 -0
  312. package/src/lib/model/shipstation.js +399 -0
  313. package/src/lib/model/shipstation.js.map +1 -0
  314. package/src/lib/model/smart-collection-reads.d.ts +32 -0
  315. package/src/lib/model/smart-collection-reads.js +63 -0
  316. package/src/lib/model/smart-collection-reads.js.map +1 -0
  317. package/src/lib/model/tracking-url.d.ts +74 -0
  318. package/src/lib/model/tracking-url.js +159 -0
  319. package/src/lib/model/tracking-url.js.map +1 -0
  320. package/src/lib/plugin-config.d.ts +13 -0
  321. package/src/lib/plugin-config.js +77 -5
  322. package/src/lib/plugin-config.js.map +1 -1
  323. package/src/lib/plugin.js +23 -0
  324. package/src/lib/plugin.js.map +1 -1
  325. package/src/lib/pos-ops-config.d.ts +39 -0
  326. package/src/lib/pos-ops-config.js +88 -0
  327. package/src/lib/pos-ops-config.js.map +1 -0
  328. package/src/lib/printing/print-document.d.ts +106 -0
  329. package/src/lib/printing/print-document.js +464 -0
  330. package/src/lib/printing/print-document.js.map +1 -0
  331. package/src/lib/printing/product-labels.d.ts +58 -0
  332. package/src/lib/printing/product-labels.js +116 -0
  333. package/src/lib/printing/product-labels.js.map +1 -0
  334. package/src/lib/printing/render-epson.d.ts +57 -0
  335. package/src/lib/printing/render-epson.js +135 -0
  336. package/src/lib/printing/render-epson.js.map +1 -0
  337. package/src/lib/printing/render-star.d.ts +45 -0
  338. package/src/lib/printing/render-star.js +100 -0
  339. package/src/lib/printing/render-star.js.map +1 -0
  340. package/src/lib/printing/render-text.d.ts +25 -0
  341. package/src/lib/printing/render-text.js +53 -0
  342. package/src/lib/printing/render-text.js.map +1 -0
  343. package/src/lib/server/api-v1/openapi.js +27 -4
  344. package/src/lib/server/api-v1/openapi.js.map +1 -1
  345. package/src/lib/server/api-v1/order-view.d.ts +67 -0
  346. package/src/lib/server/api-v1/order-view.js +120 -0
  347. package/src/lib/server/api-v1/order-view.js.map +1 -0
  348. package/src/lib/server/api-v1/orders-and-products.js +58 -65
  349. package/src/lib/server/api-v1/orders-and-products.js.map +1 -1
  350. package/src/lib/server/billing-webhook.js +135 -28
  351. package/src/lib/server/billing-webhook.js.map +1 -1
  352. package/src/lib/server/cancel-order.js +29 -0
  353. package/src/lib/server/cancel-order.js.map +1 -1
  354. package/src/lib/server/carrier-rates-availability.d.ts +26 -0
  355. package/src/lib/server/carrier-rates-availability.js +76 -0
  356. package/src/lib/server/carrier-rates-availability.js.map +1 -0
  357. package/src/lib/server/carrier-shipping.d.ts +84 -0
  358. package/src/lib/server/carrier-shipping.js +135 -0
  359. package/src/lib/server/carrier-shipping.js.map +1 -0
  360. package/src/lib/server/cart-checkout.d.ts +2 -0
  361. package/src/lib/server/cart-checkout.js +226 -22
  362. package/src/lib/server/cart-checkout.js.map +1 -1
  363. package/src/lib/server/checkout-extras.d.ts +64 -0
  364. package/src/lib/server/checkout-extras.js +157 -0
  365. package/src/lib/server/checkout-extras.js.map +1 -0
  366. package/src/lib/server/{feed.d.ts → checkout-status.d.ts} +2 -7
  367. package/src/lib/server/checkout-status.js +111 -0
  368. package/src/lib/server/checkout-status.js.map +1 -0
  369. package/src/lib/server/checkout.js +86 -9
  370. package/src/lib/server/checkout.js.map +1 -1
  371. package/src/lib/server/draft-order.js +34 -5
  372. package/src/lib/server/draft-order.js.map +1 -1
  373. package/src/lib/server/fulfill-order.d.ts +127 -10
  374. package/src/lib/server/fulfill-order.js +451 -49
  375. package/src/lib/server/fulfill-order.js.map +1 -1
  376. package/src/lib/server/legacy-feed.d.ts +28 -0
  377. package/src/lib/server/legacy-feed.js +52 -0
  378. package/src/lib/server/legacy-feed.js.map +1 -0
  379. package/src/lib/server/native-checkout.d.ts +34 -15
  380. package/src/lib/server/native-checkout.js +32 -17
  381. package/src/lib/server/native-checkout.js.map +1 -1
  382. package/src/lib/server/order-event-host-emit.d.ts +23 -0
  383. package/src/lib/server/order-event-host-emit.js +30 -0
  384. package/src/lib/server/order-event-host-emit.js.map +1 -0
  385. package/src/lib/server/order-event-triggers.d.ts +37 -0
  386. package/src/lib/server/order-event-triggers.js +119 -0
  387. package/src/lib/server/order-event-triggers.js.map +1 -0
  388. package/src/lib/server/order-events.d.ts +62 -0
  389. package/src/lib/server/order-events.js +109 -0
  390. package/src/lib/server/order-events.js.map +1 -0
  391. package/src/lib/server/order-history.d.ts +23 -0
  392. package/src/lib/server/order-history.js +65 -0
  393. package/src/lib/server/order-history.js.map +1 -0
  394. package/src/lib/server/order-notifications.d.ts +185 -0
  395. package/src/lib/server/order-notifications.js +567 -0
  396. package/src/lib/server/order-notifications.js.map +1 -0
  397. package/src/lib/server/order-receipt-send.d.ts +39 -0
  398. package/src/lib/server/order-receipt-send.js +151 -0
  399. package/src/lib/server/order-receipt-send.js.map +1 -0
  400. package/src/lib/server/order-status-token.d.ts +31 -0
  401. package/src/lib/server/order-status-token.js +75 -0
  402. package/src/lib/server/order-status-token.js.map +1 -0
  403. package/src/lib/server/order-status.d.ts +58 -0
  404. package/src/lib/server/order-status.js +141 -0
  405. package/src/lib/server/order-status.js.map +1 -0
  406. package/src/lib/server/order-webhooks.d.ts +108 -0
  407. package/src/lib/server/order-webhooks.js +622 -0
  408. package/src/lib/server/order-webhooks.js.map +1 -0
  409. package/src/lib/server/orders-shipping-prepare.d.ts +26 -0
  410. package/src/lib/server/orders-shipping-prepare.js +121 -0
  411. package/src/lib/server/orders-shipping-prepare.js.map +1 -0
  412. package/src/lib/server/payment-method-domains.d.ts +209 -0
  413. package/src/lib/server/payment-method-domains.js +444 -0
  414. package/src/lib/server/payment-method-domains.js.map +1 -0
  415. package/src/lib/server/payment-methods.d.ts +77 -0
  416. package/src/lib/server/payment-methods.js +284 -0
  417. package/src/lib/server/payment-methods.js.map +1 -0
  418. package/src/lib/server/pos-auth.d.ts +50 -0
  419. package/src/lib/server/pos-auth.js +121 -0
  420. package/src/lib/server/pos-auth.js.map +1 -0
  421. package/src/lib/server/pos-customer.d.ts +49 -0
  422. package/src/lib/server/pos-customer.js +257 -0
  423. package/src/lib/server/pos-customer.js.map +1 -0
  424. package/src/lib/server/pos-display.d.ts +57 -0
  425. package/src/lib/server/pos-display.js +419 -0
  426. package/src/lib/server/pos-display.js.map +1 -0
  427. package/src/lib/server/pos-fee-month.d.ts +34 -0
  428. package/src/lib/server/pos-fee-month.js +36 -0
  429. package/src/lib/server/pos-fee-month.js.map +1 -0
  430. package/src/lib/server/pos-ops-gate.d.ts +161 -0
  431. package/src/lib/server/pos-ops-gate.js +295 -0
  432. package/src/lib/server/pos-ops-gate.js.map +1 -0
  433. package/src/lib/server/pos-ops-routes.d.ts +22 -0
  434. package/src/lib/server/pos-ops-routes.js +36 -0
  435. package/src/lib/server/pos-ops-routes.js.map +1 -0
  436. package/src/lib/server/pos-order.d.ts +1 -18
  437. package/src/lib/server/pos-order.js +222 -42
  438. package/src/lib/server/pos-order.js.map +1 -1
  439. package/src/lib/server/pos-payment.d.ts +39 -0
  440. package/src/lib/server/pos-payment.js +922 -0
  441. package/src/lib/server/pos-payment.js.map +1 -0
  442. package/src/lib/server/pos-print.d.ts +82 -0
  443. package/src/lib/server/pos-print.js +193 -0
  444. package/src/lib/server/pos-print.js.map +1 -0
  445. package/src/lib/server/pos-readers.d.ts +27 -0
  446. package/src/lib/server/pos-readers.js +276 -0
  447. package/src/lib/server/pos-readers.js.map +1 -0
  448. package/src/lib/server/pos-refund-authority.d.ts +60 -0
  449. package/src/lib/server/pos-refund-authority.js +72 -0
  450. package/src/lib/server/pos-refund-authority.js.map +1 -0
  451. package/src/lib/server/pos-return.d.ts +58 -0
  452. package/src/lib/server/pos-return.js +891 -0
  453. package/src/lib/server/pos-return.js.map +1 -0
  454. package/src/lib/server/pos-sale-stamp.d.ts +66 -0
  455. package/src/lib/server/pos-sale-stamp.js +84 -0
  456. package/src/lib/server/pos-sale-stamp.js.map +1 -0
  457. package/src/lib/server/pos-sale.d.ts +170 -0
  458. package/src/lib/server/pos-sale.js +461 -0
  459. package/src/lib/server/pos-sale.js.map +1 -0
  460. package/src/lib/server/pos-shift.d.ts +45 -0
  461. package/src/lib/server/pos-shift.js +484 -0
  462. package/src/lib/server/pos-shift.js.map +1 -0
  463. package/src/lib/server/pos-staff-pin.d.ts +26 -0
  464. package/src/lib/server/pos-staff-pin.js +339 -0
  465. package/src/lib/server/pos-staff-pin.js.map +1 -0
  466. package/src/lib/server/pos-stripe.d.ts +91 -0
  467. package/src/lib/server/pos-stripe.js +129 -0
  468. package/src/lib/server/pos-stripe.js.map +1 -0
  469. package/src/lib/server/pos-terminal-connection-token.d.ts +48 -0
  470. package/src/lib/server/pos-terminal-connection-token.js +166 -0
  471. package/src/lib/server/pos-terminal-connection-token.js.map +1 -0
  472. package/src/lib/server/pos-terminal.d.ts +218 -0
  473. package/src/lib/server/pos-terminal.js +1014 -0
  474. package/src/lib/server/pos-terminal.js.map +1 -0
  475. package/src/lib/server/print-queue.d.ts +124 -0
  476. package/src/lib/server/print-queue.js +301 -0
  477. package/src/lib/server/print-queue.js.map +1 -0
  478. package/src/lib/server/printer-poll.d.ts +75 -0
  479. package/src/lib/server/printer-poll.js +325 -0
  480. package/src/lib/server/printer-poll.js.map +1 -0
  481. package/src/lib/server/printer-secret.d.ts +39 -0
  482. package/src/lib/server/printer-secret.js +56 -0
  483. package/src/lib/server/printer-secret.js.map +1 -0
  484. package/src/lib/server/printers.d.ts +114 -0
  485. package/src/lib/server/printers.js +546 -0
  486. package/src/lib/server/printers.js.map +1 -0
  487. package/src/lib/server/product-ai-capability.d.ts +42 -0
  488. package/src/lib/server/product-ai-capability.js +159 -0
  489. package/src/lib/server/product-ai-capability.js.map +1 -0
  490. package/src/lib/server/product-catalog.d.ts +42 -0
  491. package/src/lib/server/product-catalog.js +305 -0
  492. package/src/lib/server/product-catalog.js.map +1 -0
  493. package/src/lib/server/product-drafts.d.ts +119 -0
  494. package/src/lib/server/product-drafts.js +384 -0
  495. package/src/lib/server/product-drafts.js.map +1 -0
  496. package/src/lib/server/refund.js +110 -45
  497. package/src/lib/server/refund.js.map +1 -1
  498. package/src/lib/server/reserve.js +2 -0
  499. package/src/lib/server/reserve.js.map +1 -1
  500. package/src/lib/server/return-status-action.d.ts +37 -0
  501. package/src/lib/server/return-status-action.js +57 -0
  502. package/src/lib/server/return-status-action.js.map +1 -0
  503. package/src/lib/server/returns.d.ts +119 -0
  504. package/src/lib/server/returns.js +938 -0
  505. package/src/lib/server/returns.js.map +1 -0
  506. package/src/lib/server/shipment-records.d.ts +36 -0
  507. package/src/lib/server/shipment-records.js +289 -0
  508. package/src/lib/server/shipment-records.js.map +1 -0
  509. package/src/lib/server/shipping-connector-gates.d.ts +40 -0
  510. package/src/lib/server/shipping-connector-gates.js +97 -0
  511. package/src/lib/server/shipping-connector-gates.js.map +1 -0
  512. package/src/lib/server/shipping-connectors.d.ts +29 -0
  513. package/src/lib/server/shipping-connectors.js +236 -0
  514. package/src/lib/server/shipping-connectors.js.map +1 -0
  515. package/src/lib/server/shippingeasy.d.ts +238 -0
  516. package/src/lib/server/shippingeasy.js +787 -0
  517. package/src/lib/server/shippingeasy.js.map +1 -0
  518. package/src/lib/server/shipstation.d.ts +129 -0
  519. package/src/lib/server/shipstation.js +483 -0
  520. package/src/lib/server/shipstation.js.map +1 -0
  521. package/src/lib/server/site-page-resolver.d.ts +5 -0
  522. package/src/lib/server/site-page-resolver.js +156 -1
  523. package/src/lib/server/site-page-resolver.js.map +1 -1
  524. package/src/lib/server/stock-levels.d.ts +21 -0
  525. package/src/lib/server/stock-levels.js +263 -0
  526. package/src/lib/server/stock-levels.js.map +1 -0
  527. package/src/lib/server/stripe-refund.d.ts +47 -0
  528. package/src/lib/server/stripe-refund.js +87 -0
  529. package/src/lib/server/stripe-refund.js.map +1 -0
  530. package/src/lib/server/supplier-update.js +46 -5
  531. package/src/lib/server/supplier-update.js.map +1 -1
  532. package/src/lib/server/tax-engine-quote.d.ts +47 -0
  533. package/src/lib/server/tax-engine-quote.js +105 -0
  534. package/src/lib/server/tax-engine-quote.js.map +1 -0
  535. package/src/lib/server.js +146 -2
  536. package/src/lib/server.js.map +1 -1
  537. package/src/lib/site.js +12 -0
  538. package/src/lib/site.js.map +1 -1
  539. package/src/lib/subprocessors.d.ts +26 -0
  540. package/src/lib/subprocessors.js +50 -0
  541. package/src/lib/subprocessors.js.map +1 -0
  542. package/src/lib/tenant-emails.js +461 -3
  543. package/src/lib/tenant-emails.js.map +1 -1
  544. package/src/lib/testing/fake-firestore.d.ts +45 -0
  545. package/src/lib/testing/fake-firestore.js +189 -0
  546. package/src/lib/testing/fake-firestore.js.map +1 -0
  547. package/src/lib/testing/memory-firestore.d.ts +123 -0
  548. package/src/lib/testing/memory-firestore.js +274 -0
  549. package/src/lib/testing/memory-firestore.js.map +1 -0
  550. package/src/lib/testing/pos-ops-harness.d.ts +50 -0
  551. package/src/lib/testing/pos-ops-harness.js +184 -0
  552. package/src/lib/testing/pos-ops-harness.js.map +1 -0
  553. package/src/lib/testing/pos-ops-memory-firestore.d.ts +55 -0
  554. package/src/lib/testing/pos-ops-memory-firestore.js +376 -0
  555. package/src/lib/testing/pos-ops-memory-firestore.js.map +1 -0
  556. package/src/lib/transfer/records-transfer.d.ts +11 -1
  557. package/src/lib/transfer/records-transfer.js +127 -5
  558. package/src/lib/transfer/records-transfer.js.map +1 -1
  559. package/src/lib/transfer/records.server.d.ts +9 -2
  560. package/src/lib/transfer/records.server.js +58 -7
  561. package/src/lib/transfer/records.server.js.map +1 -1
  562. package/src/lib/transfer/register-transfer-resources.js +40 -1
  563. package/src/lib/transfer/register-transfer-resources.js.map +1 -1
  564. package/src/lib/transfer/register-transfer-ui.js +4 -1
  565. package/src/lib/transfer/register-transfer-ui.js.map +1 -1
  566. package/src/lib/transfer/shipping-presets.d.ts +23 -0
  567. package/src/lib/transfer/shipping-presets.js +156 -0
  568. package/src/lib/transfer/shipping-presets.js.map +1 -0
  569. package/src/lib/transfer/tracking-transfer.d.ts +101 -0
  570. package/src/lib/transfer/tracking-transfer.js +546 -0
  571. package/src/lib/transfer/tracking-transfer.js.map +1 -0
  572. package/src/lib/transfer/tracking.server.d.ts +37 -0
  573. package/src/lib/transfer/tracking.server.js +393 -0
  574. package/src/lib/transfer/tracking.server.js.map +1 -0
  575. package/src/lib/transfer/transfer-keys.d.ts +2 -1
  576. package/src/lib/transfer/transfer-keys.js +6 -2
  577. package/src/lib/transfer/transfer-keys.js.map +1 -1
  578. package/src/lib/utils/code128.d.ts +37 -0
  579. package/src/lib/utils/code128.js +199 -0
  580. package/src/lib/utils/code128.js.map +1 -0
  581. package/src/lib/utils/order-invoice.d.ts +55 -0
  582. package/src/lib/utils/order-invoice.js +127 -0
  583. package/src/lib/utils/order-invoice.js.map +1 -0
  584. package/src/lib/utils/use-checkout-return-notice.d.ts +34 -0
  585. package/src/lib/utils/use-checkout-return-notice.js +78 -0
  586. package/src/lib/utils/use-checkout-return-notice.js.map +1 -0
  587. package/src/lib/utils/use-storefront-purchase-event.js +4 -0
  588. package/src/lib/utils/use-storefront-purchase-event.js.map +1 -1
  589. package/src/lib/server/feed.js +0 -69
  590. package/src/lib/server/feed.js.map +0 -1
@@ -0,0 +1,461 @@
1
+ import { _ as _extends } from "@swc/helpers/_/_extends";
2
+ /**
3
+ * @license
4
+ * Copyright 2026 Aglyn LLC
5
+ *
6
+ * Licensed under the Apache License, Version 2.0 (the "License");
7
+ * you may not use this file except in compliance with the License.
8
+ * You may obtain a copy of the License at
9
+ *
10
+ * http://www.apache.org/licenses/LICENSE-2.0
11
+ *
12
+ * Unless required by applicable law or agreed to in writing, software
13
+ * distributed under the License is distributed on an "AS IS" BASIS,
14
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15
+ * See the License for the specific language governing permissions and
16
+ * limitations under the License.
17
+ */ import { createHash } from "crypto";
18
+ import { firebaseAdmin } from "@aglyn/tenant-data-admin";
19
+ import recordCapturedContact from "@aglyn/aglyn/plugin-manager/record-captured-contact";
20
+ import * as CommerceModel from "../model/index.js";
21
+ import { alertLowStockCrossing } from "./low-stock.js";
22
+ import { decrementVariantStock } from "./reserve-stock.js";
23
+ import { releasePromotionHold, settlePromotionSlot } from "./promotion-hold.js";
24
+ import { offlineFeeMonthKey } from "./pos-fee-month.js";
25
+ import { resetPosDisplay } from "./pos-display.js";
26
+ import { notifyOrderBuyer, sendOrderReceipt } from "./order-notifications.js";
27
+ import { raiseOrderEvent } from "./order-events.js";
28
+ import { ORDER_PAID_EVENT } from "../model/order-events.js";
29
+ /**
30
+ * A payment's id, derived from the register's attempt key so a retried tap
31
+ * finds the payment it already started instead of starting a second one.
32
+ */ export function posPaymentId(orderId, attemptKey) {
33
+ return `pay_${createHash('sha256').update(`${orderId}:${attemptKey}`).digest('hex').slice(0, 24)}`;
34
+ }
35
+ /** The open sale's ledger, as the register reads it back after any change. */ export function posSaleSummary(order) {
36
+ var _ref;
37
+ var _order_totals;
38
+ const payments = CommerceModel.orderPayments(order);
39
+ const totalCents = Number((_ref = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref : 0);
40
+ return {
41
+ orderId: order.$id,
42
+ status: order.status,
43
+ totalCents,
44
+ paidCents: CommerceModel.posSettledCents(payments),
45
+ dueCents: CommerceModel.posBalanceDueCents(totalCents, payments),
46
+ tenderableCents: CommerceModel.posTenderableCents(totalCents, payments),
47
+ tipCents: CommerceModel.posTipCents(payments),
48
+ payments: payments.map((payment)=>_extends({
49
+ id: payment.id,
50
+ method: payment.method,
51
+ amountCents: payment.amountCents
52
+ }, payment.tipCents ? {
53
+ tipCents: payment.tipCents
54
+ } : {}, {
55
+ status: payment.status
56
+ }, payment.cardBrand ? {
57
+ cardBrand: payment.cardBrand
58
+ } : {}, payment.last4 ? {
59
+ last4: payment.last4
60
+ } : {}, payment.changeCents != null ? {
61
+ changeCents: payment.changeCents
62
+ } : {}, payment.checkoutUrl && payment.status === 'pending' ? {
63
+ checkoutUrl: payment.checkoutUrl
64
+ } : {}, payment.readerId ? {
65
+ readerId: payment.readerId
66
+ } : {}, payment.failureMessage ? {
67
+ failureMessage: payment.failureMessage
68
+ } : {}, payment.livemode != null ? {
69
+ livemode: payment.livemode
70
+ } : {}))
71
+ };
72
+ }
73
+ /**
74
+ * The fields that complete a sale, when its settled payments now cover the
75
+ * total; null when the balance is still open or the sale is not pending.
76
+ *
77
+ * Pure, so the spec can hold the arithmetic: the fee is every card payment's
78
+ * own `application_fee_amount` plus the take the cards did not carry, the tip
79
+ * is summed beside the total and never inside it.
80
+ */ export function posCompletionPatch(order, payments, nowMs) {
81
+ var _ref, _order_posTakeFeeCents, _order_totals;
82
+ var _order_totals1;
83
+ if (order.status !== 'pending') return null;
84
+ const totalCents = Number((_ref = (_order_totals1 = order.totals) == null ? void 0 : _order_totals1.totalCents) != null ? _ref : 0);
85
+ if (CommerceModel.posBalanceDueCents(totalCents, payments) > 0) return null;
86
+ const takeFeeCents = Math.max(0, Math.round(Number((_order_posTakeFeeCents = order.posTakeFeeCents) != null ? _order_posTakeFeeCents : 0)));
87
+ const invoiceTakeCents = CommerceModel.posInvoiceTakeCents({
88
+ takeFeeCents,
89
+ payments
90
+ });
91
+ const settled = payments.filter((payment)=>payment.status === 'succeeded');
92
+ const cardFeeCents = settled.filter((payment)=>CommerceModel.isCardPaymentMethod(payment.method)).reduce((sum, payment)=>{
93
+ var _payment_feeCents;
94
+ return sum + Math.max(0, Math.round(Number((_payment_feeCents = payment.feeCents) != null ? _payment_feeCents : 0)));
95
+ }, 0);
96
+ const feeCents = cardFeeCents + invoiceTakeCents;
97
+ const tipCents = CommerceModel.posTipCents(payments);
98
+ const intents = settled.map((payment)=>payment.paymentIntentId).filter((id)=>Boolean(id));
99
+ const tenders = settled.map((payment)=>CommerceModel.describeOrderPayment(payment));
100
+ const overpaid = CommerceModel.posSettledCents(payments) - totalCents;
101
+ return {
102
+ invoiceTakeCents,
103
+ patch: _extends({
104
+ status: 'paid',
105
+ paidAtMs: nowMs,
106
+ totals: _extends({}, (_order_totals = order.totals) != null ? _order_totals : {}, {
107
+ feeCents
108
+ }, tipCents > 0 ? {
109
+ tipCents
110
+ } : {})
111
+ }, feeCents > 0 ? {
112
+ feeCollection: CommerceModel.posFeeCollection(payments)
113
+ } : {}, intents.length ? {
114
+ paymentIntentIds: intents
115
+ } : {}, intents.length === 1 ? {
116
+ paymentIntentId: intents[0]
117
+ } : {}, settled.some((payment)=>payment.livemode === false) ? {
118
+ livemode: false
119
+ } : {}, {
120
+ timeline: CommerceModel.appendOrderEvent(order, 'paid', `Paid — ${tenders.join(', ')}` + (overpaid > 0 ? `. Overpaid by $${(overpaid / 100).toFixed(2)}: refund the difference.` : ''), nowMs)
121
+ })
122
+ };
123
+ }
124
+ /** The order document, lifted, with its id. */ function liftOrder(id, data) {
125
+ return _extends({}, CommerceModel.liftLegacyOrder(data != null ? data : {}), {
126
+ $id: id
127
+ });
128
+ }
129
+ /**
130
+ * The ONE writer of a sale's ledger. Runs `prepare` (extra reads) and
131
+ * `decide` inside one transaction on the order, writes the payment, and
132
+ * completes the sale in the same commit when the balance reaches zero.
133
+ */ export async function applyPosPayment(options) {
134
+ var _options_nowMs;
135
+ const firestore = firebaseAdmin.app().firestore();
136
+ const orderRef = firestore.collection('hosts').doc(options.hostId).collection('orders').doc(options.orderId);
137
+ const nowMs = (_options_nowMs = options.nowMs) != null ? _options_nowMs : Date.now();
138
+ const outcome = await firestore.runTransaction(async (transaction)=>{
139
+ const snapshot = await transaction.get(orderRef);
140
+ if (!snapshot.exists) {
141
+ return {
142
+ ok: false,
143
+ status: 404,
144
+ error: 'Unknown sale'
145
+ };
146
+ }
147
+ const order = liftOrder(orderRef.id, snapshot.data());
148
+ if (order.channel !== 'pos' || !Array.isArray(order.payments)) {
149
+ return {
150
+ ok: false,
151
+ status: 409,
152
+ error: 'This order is not an open register sale'
153
+ };
154
+ }
155
+ const context = options.prepare ? await options.prepare(transaction) : undefined;
156
+ const payments = CommerceModel.orderPayments(order);
157
+ const existing = payments.find((payment)=>payment.id === options.paymentId);
158
+ const step = options.decide({
159
+ order,
160
+ payments,
161
+ existing,
162
+ context
163
+ });
164
+ if (step.kind === 'refuse') {
165
+ return {
166
+ ok: false,
167
+ status: step.status,
168
+ error: step.error
169
+ };
170
+ }
171
+ if (step.kind === 'keep') {
172
+ return {
173
+ ok: true,
174
+ order,
175
+ payment: existing != null ? existing : null,
176
+ completed: false,
177
+ changed: false
178
+ };
179
+ }
180
+ const nextPayments = existing ? payments.map((payment)=>payment.id === step.payment.id ? step.payment : payment) : [
181
+ ...payments,
182
+ step.payment
183
+ ];
184
+ let next = _extends({}, order, {
185
+ payments: nextPayments
186
+ });
187
+ if (step.event) {
188
+ next = _extends({}, next, {
189
+ timeline: CommerceModel.appendOrderEvent(order, step.event.event, step.event.detail, nowMs)
190
+ });
191
+ }
192
+ const completion = posCompletionPatch(next, nextPayments, nowMs);
193
+ const write = _extends({
194
+ payments: nextPayments
195
+ }, next.timeline !== order.timeline ? {
196
+ timeline: next.timeline
197
+ } : {});
198
+ if (completion) {
199
+ var _order_posFeeOrgId;
200
+ Object.assign(write, completion.patch);
201
+ next = _extends({}, next, completion.patch);
202
+ Object.assign(write, CommerceModel.orderListFields(next, orderRef.id));
203
+ // ACCRUED IN THE SAME COMMIT AS THE FLIP (the AGL-2111 rule): the part
204
+ // of the take no card payout carried goes on the org's invoice, and an
205
+ // order and the fee it owes cannot diverge.
206
+ const feeOrgId = String((_order_posFeeOrgId = order.posFeeOrgId) != null ? _order_posFeeOrgId : '');
207
+ if (completion.invoiceTakeCents > 0 && feeOrgId) {
208
+ const month = offlineFeeMonthKey(new Date(nowMs));
209
+ transaction.set(firestore.collection('orgs').doc(feeOrgId).collection('offlineFees').doc(month), {
210
+ month,
211
+ feeCents: firebaseAdmin.firestore.FieldValue.increment(completion.invoiceTakeCents),
212
+ orders: firebaseAdmin.firestore.FieldValue.increment(1)
213
+ }, {
214
+ merge: true
215
+ });
216
+ }
217
+ } else if (order.status === 'paid' && step.payment.status === 'succeeded' && (existing == null ? void 0 : existing.status) !== 'succeeded') {
218
+ // MONEY THAT ARRIVED AFTER THE SALE WAS ALREADY PAID: a QR page paid
219
+ // after the cashier took another tender. It is recorded, never
220
+ // dropped, and said on the order so the merchant can refund it.
221
+ write['timeline'] = CommerceModel.appendOrderEvent(next, 'pos-overpaid', `${CommerceModel.describeOrderPayment(step.payment)} arrived after the ` + 'sale was already paid. Refund it from Stripe.', nowMs);
222
+ }
223
+ transaction.set(orderRef, write, {
224
+ merge: true
225
+ });
226
+ options.write == null ? void 0 : options.write.call(options, transaction, context, step.payment, existing);
227
+ return {
228
+ ok: true,
229
+ order: next,
230
+ payment: step.payment,
231
+ completed: Boolean(completion),
232
+ changed: true
233
+ };
234
+ });
235
+ if (outcome.ok && outcome.completed) {
236
+ await completePosSale(options.hostId, outcome.order);
237
+ }
238
+ return outcome;
239
+ }
240
+ const saleCompletedListeners = new Set();
241
+ /** Subscribes to completed register sales; returns the unsubscribe. */ export function onPosSaleCompleted(listener) {
242
+ saleCompletedListeners.add(listener);
243
+ return ()=>saleCompletedListeners.delete(listener);
244
+ }
245
+ /**
246
+ * Tells every listener a register sale completed. Awaited, and never throws:
247
+ * the money is already taken, so a listener's failure is logged, not
248
+ * returned to a cashier who would ring the sale again.
249
+ */ export async function notifyPosSaleCompleted(event) {
250
+ for (const listener of [
251
+ ...saleCompletedListeners
252
+ ]){
253
+ try {
254
+ await listener(event);
255
+ } catch (error) {
256
+ console.error('[pos-sale] sale-completed listener failed', event.orderId, error);
257
+ }
258
+ }
259
+ }
260
+ /** Reads the sale as it stands, for the register's status polls. */ export async function readPosSale(hostId, orderId) {
261
+ const snapshot = await firebaseAdmin.app().firestore().collection('hosts').doc(hostId).collection('orders').doc(orderId).get();
262
+ if (!snapshot.exists) return null;
263
+ return liftOrder(snapshot.id, snapshot.data());
264
+ }
265
+ /**
266
+ * Everything that follows a sale being paid, run once by the call whose
267
+ * commit completed it. Each step is guarded on its own and none can undo the
268
+ * sale: the money is taken, so a failure here is logged and said on the order
269
+ * rather than thrown back at a cashier who would ring it again.
270
+ */ export async function completePosSale(hostId, order) {
271
+ var _order_lineItems, _receipt_to, _order_customerEmail, _ref;
272
+ var _order_totals;
273
+ const firestore = firebaseAdmin.app().firestore();
274
+ const hostRef = firestore.collection('hosts').doc(hostId);
275
+ const orderRef = hostRef.collection('orders').doc(order.$id);
276
+ const notes = [];
277
+ // The promotion's slot becomes a redemption only now: a sale that was
278
+ // voided half-paid never counted against the merchant's cap (AGL-305).
279
+ if (order.discountId && order.discountHoldKey) {
280
+ const settled = await settlePromotionSlot({
281
+ firestore,
282
+ ref: hostRef.collection('discounts').doc(order.discountId),
283
+ holdKey: order.discountHoldKey,
284
+ label: `pos discount ${order.discountId}`
285
+ });
286
+ if (settled === 'missing' || settled === 'error') {
287
+ notes.push({
288
+ event: 'redemption-orphaned',
289
+ detail: `Discount ${order.discountId} was applied to this sale but its ` + 'redemption could not be counted against its limit.'
290
+ });
291
+ }
292
+ }
293
+ // Stock comes off exactly once, here, compounding across lines of one
294
+ // product (AGL-1828) and atomically against other channels (AGL-2320).
295
+ const products = new Map();
296
+ for (const line of (_order_lineItems = order.lineItems) != null ? _order_lineItems : []){
297
+ try {
298
+ var _line_variantId;
299
+ var _product_variants_;
300
+ if (!products.has(line.productId)) {
301
+ const snapshot = await hostRef.collection('products').doc(line.productId).get();
302
+ if (!snapshot.exists) continue;
303
+ products.set(line.productId, CommerceModel.liftLegacyProduct(snapshot.data()));
304
+ }
305
+ const product = products.get(line.productId);
306
+ const variantId = (_line_variantId = line.variantId) != null ? _line_variantId : (_product_variants_ = product.variants[0]) == null ? void 0 : _product_variants_.id;
307
+ const tracked = product.variants.some((variant)=>variant.id === variantId && variant.inventory != null);
308
+ if (!variantId || !tracked) continue;
309
+ const moved = await decrementVariantStock({
310
+ firestore,
311
+ hostRef,
312
+ hostId,
313
+ productId: line.productId,
314
+ variantId,
315
+ quantity: line.quantity,
316
+ locationId: order.locationId || undefined,
317
+ ledger: {
318
+ reason: 'sale',
319
+ orderId: order.$id
320
+ }
321
+ });
322
+ if (!moved.before || !moved.after) continue;
323
+ products.set(line.productId, moved.after);
324
+ alertLowStockCrossing(hostId, moved.before, moved.after);
325
+ } catch (error) {
326
+ console.error('[pos-sale] stock decrement failed', order.$id, line.productId, error);
327
+ }
328
+ }
329
+ const receipt = order.receiptRequest;
330
+ const receiptEmail = (receipt == null ? void 0 : receipt.channel) === 'email' ? String((_receipt_to = receipt.to) != null ? _receipt_to : '') : '';
331
+ const contactEmail = receiptEmail || String((_order_customerEmail = order.customerEmail) != null ? _order_customerEmail : '');
332
+ const marketingOptIn = Boolean(receipt == null ? void 0 : receipt.marketingOptIn);
333
+ const totalCents = Number((_ref = (_order_totals = order.totals) == null ? void 0 : _order_totals.totalCents) != null ? _ref : 0);
334
+ if (contactEmail) {
335
+ await recordCapturedContact(_extends({
336
+ orgId: '',
337
+ hostId,
338
+ identity: {
339
+ email: contactEmail
340
+ },
341
+ surface: 'relationship',
342
+ lifecycleFloor: 'customer'
343
+ }, marketingOptIn ? {
344
+ marketingConsent: true
345
+ } : {}, {
346
+ purchaseCents: totalCents,
347
+ interaction: {
348
+ source: 'order',
349
+ refId: order.$id,
350
+ summary: `In-store purchase ($${(totalCents / 100).toFixed(2)})`
351
+ }
352
+ })).catch((error)=>{
353
+ console.error('[pos-sale] contact capture failed', error);
354
+ });
355
+ }
356
+ // The receipt and the paid event, through the same doors every sale uses
357
+ // (AGL-3610, AGL-3611): the buyer-notification door claims each message
358
+ // per channel, so a second completion path can never mail twice, and it
359
+ // texts the receipt when the customer chose a text and a provider is on.
360
+ if (((receipt == null ? void 0 : receipt.channel) === 'email' || (receipt == null ? void 0 : receipt.channel) === 'sms') && receipt.to) {
361
+ var _order_customerEmail1;
362
+ // The customer named where it goes: it goes there, whatever else the
363
+ // order holds (AGL-3608).
364
+ const sent = await deliverChosenPosReceipt({
365
+ hostId,
366
+ orderId: order.$id
367
+ }, {
368
+ channel: receipt.channel,
369
+ to: receipt.to,
370
+ orderEmail: String((_order_customerEmail1 = order.customerEmail) != null ? _order_customerEmail1 : '')
371
+ });
372
+ if (sent !== 'sent') {
373
+ notes.push({
374
+ event: 'receipt-unsent',
375
+ detail: `The ${receipt.channel === 'sms' ? 'text' : 'email'} receipt could not be sent.`
376
+ });
377
+ }
378
+ } else if (contactEmail) {
379
+ await notifyOrderBuyer({
380
+ hostId,
381
+ orderId: order.$id
382
+ }, 'receipt', {
383
+ email: contactEmail
384
+ });
385
+ }
386
+ await raiseOrderEvent(ORDER_PAID_EVENT, {
387
+ hostId,
388
+ orderId: order.$id,
389
+ key: 'paid'
390
+ }).catch((error)=>console.error('[pos-sale] order.paid event failed', error));
391
+ if (notes.length) {
392
+ await firestore.runTransaction(async (transaction)=>{
393
+ var _fresh_timeline;
394
+ const fresh = liftOrder(orderRef.id, (await transaction.get(orderRef)).data());
395
+ let timeline = (_fresh_timeline = fresh.timeline) != null ? _fresh_timeline : [];
396
+ for (const note of notes){
397
+ timeline = CommerceModel.appendOrderEvent({
398
+ timeline
399
+ }, note.event, note.detail);
400
+ }
401
+ transaction.set(orderRef, {
402
+ timeline
403
+ }, {
404
+ merge: true
405
+ });
406
+ }).catch((error)=>console.error('[pos-sale] note failed', error));
407
+ }
408
+ await notifyPosSaleCompleted({
409
+ hostId,
410
+ orderId: order.$id,
411
+ order
412
+ });
413
+ // The customer screen says thank you and forgets the customer: the state
414
+ // is rewritten whole, so no address or phone outlives the sale (AGL-3608).
415
+ if (order.registerId) {
416
+ await resetPosDisplay(hostId, order.registerId).catch((error)=>console.error('[pos-sale] display reset failed', error));
417
+ }
418
+ }
419
+ /**
420
+ * Sends a receipt the customer (or the cashier for them) explicitly asked
421
+ * for, to the address or number they gave (AGL-3607, AGL-3608).
422
+ *
423
+ * It goes through the buyer-notification door first, so the order's
424
+ * once-per-channel marker is claimed and a completion that races this call
425
+ * cannot send a second copy. The door can skip it, though, for reasons that
426
+ * do not apply to a request made at the counter: the store switched
427
+ * automatic receipts or texts off, a receipt already went out on that
428
+ * channel to an earlier address, or the door would use the email the order
429
+ * was opened with rather than the one just typed. In each of those cases the
430
+ * receipt is sent explicitly, as the order dialog's "Resend receipt" does.
431
+ */ export async function deliverChosenPosReceipt(ref, input) {
432
+ var _input_orderEmail;
433
+ const orderEmail = String((_input_orderEmail = input.orderEmail) != null ? _input_orderEmail : '').trim().toLowerCase();
434
+ const to = input.to.trim();
435
+ const doorAddressesIt = input.channel === 'sms' || !orderEmail || orderEmail === to.toLowerCase();
436
+ if (doorAddressesIt) {
437
+ const door = await notifyOrderBuyer(ref, 'receipt', input.channel === 'email' ? {
438
+ email: to
439
+ } : {});
440
+ const entry = door.outcome === 'handled' ? door.channels.find((channel)=>channel.channel === input.channel) : undefined;
441
+ if ((entry == null ? void 0 : entry.outcome) === 'sent') return 'sent';
442
+ if ((entry == null ? void 0 : entry.outcome) === 'failed') return 'failed';
443
+ // Already sent to this very address: nothing more to do.
444
+ if ((entry == null ? void 0 : entry.outcome) === 'already' && input.channel === 'email') return 'sent';
445
+ }
446
+ const explicit = await sendOrderReceipt(ref, {
447
+ channel: input.channel,
448
+ to
449
+ });
450
+ if (explicit.outcome === 'sent') return 'sent';
451
+ return explicit.outcome === 'not_configured' ? 'not_configured' : 'failed';
452
+ }
453
+ /**
454
+ * Hands back a promotion slot an open sale was holding, when the sale is
455
+ * voided rather than paid.
456
+ */ export async function releasePosSaleDiscount(hostId, order) {
457
+ if (!order.discountId || !order.discountHoldKey) return;
458
+ await releasePromotionHold(firebaseAdmin.app().firestore().collection('hosts').doc(hostId).collection('discounts').doc(order.discountId), order.discountHoldKey);
459
+ }
460
+
461
+ //# sourceMappingURL=pos-sale.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/server/pos-sale.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n * http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createHash } from 'crypto'\nimport { firebaseAdmin } from '@aglyn/tenant-data-admin'\nimport recordCapturedContact from '@aglyn/aglyn/plugin-manager/record-captured-contact'\nimport * as CommerceModel from '../model'\nimport { alertLowStockCrossing } from './low-stock'\nimport { decrementVariantStock } from './reserve-stock'\nimport { releasePromotionHold, settlePromotionSlot } from './promotion-hold'\nimport { offlineFeeMonthKey } from './pos-fee-month'\nimport { resetPosDisplay } from './pos-display'\nimport { notifyOrderBuyer, sendOrderReceipt } from './order-notifications'\nimport { raiseOrderEvent } from './order-events'\nimport { ORDER_PAID_EVENT } from '../model/order-events'\n\n/*==========================================\n * AN OPEN REGISTER SALE (AGL-3607).\n *\n * A split-tender sale is an order written `pending` with an empty\n * `payments[]`, priced once by `pos-order.ts` (`payment: 'open'`). Each tender\n * then adds one payment through {@link applyPosPayment}, which is the ONLY\n * writer of the ledger and runs every change in one transaction on the order\n * document. When the settled payments cover the total, the same transaction\n * flips the order to `paid` and accrues the invoiced part of the fee, so a\n * sale is completed exactly once however many webhooks, polls and retries\n * race to report its last payment. Stock, the promotion slot, the contact and\n * the receipt follow from that one flip ({@link completePosSale}).\n *=========================================*/\n\nexport type PosLiftedOrder = CommerceModel.HostOrder & {\n $id: string\n /** The sale's platform take, before any card processing (AGL-2111). */\n posTakeFeeCents?: number\n /** The org the invoiced part of the take accrues to. */\n posFeeOrgId?: string\n /** The promotion slot this sale holds until it completes (AGL-305). */\n discountId?: string\n discountHoldKey?: string\n paymentIntentIds?: string[]\n reservationId?: string\n}\n\n/**\n * A payment's id, derived from the register's attempt key so a retried tap\n * finds the payment it already started instead of starting a second one.\n */\nexport function posPaymentId(orderId: string, attemptKey: string): string {\n return `pay_${createHash('sha256')\n .update(`${orderId}:${attemptKey}`)\n .digest('hex')\n .slice(0, 24)}`\n}\n\n/** What one ledger change decided. */\nexport type PosPaymentStep =\n | { kind: 'refuse'; status: number; error: string }\n /** Nothing to change: the payment is already in the state asked for. */\n | { kind: 'keep' }\n | {\n kind: 'put'\n payment: CommerceModel.OrderPayment\n /** A timeline line for the order, when the change is worth one. */\n event?: { event: string; detail?: string }\n }\n\nexport type PosPaymentOutcome =\n | { ok: false; status: number; error: string }\n | {\n ok: true\n order: PosLiftedOrder\n payment: CommerceModel.OrderPayment | null\n /** True only on the call whose change completed the sale. */\n completed: boolean\n changed: boolean\n }\n\n/** The open sale's ledger, as the register reads it back after any change. */\nexport function posSaleSummary(order: PosLiftedOrder) {\n const payments = CommerceModel.orderPayments(order)\n const totalCents = Number(order.totals?.totalCents ?? 0)\n return {\n orderId: order.$id,\n status: order.status,\n totalCents,\n paidCents: CommerceModel.posSettledCents(payments),\n dueCents: CommerceModel.posBalanceDueCents(totalCents, payments),\n tenderableCents: CommerceModel.posTenderableCents(totalCents, payments),\n tipCents: CommerceModel.posTipCents(payments),\n payments: payments.map((payment) => ({\n id: payment.id,\n method: payment.method,\n amountCents: payment.amountCents,\n ...(payment.tipCents ? { tipCents: payment.tipCents } : {}),\n status: payment.status,\n ...(payment.cardBrand ? { cardBrand: payment.cardBrand } : {}),\n ...(payment.last4 ? { last4: payment.last4 } : {}),\n ...(payment.changeCents != null ? { changeCents: payment.changeCents } : {}),\n ...(payment.checkoutUrl && payment.status === 'pending'\n ? { checkoutUrl: payment.checkoutUrl }\n : {}),\n ...(payment.readerId ? { readerId: payment.readerId } : {}),\n ...(payment.failureMessage ? { failureMessage: payment.failureMessage } : {}),\n ...(payment.livemode != null ? { livemode: payment.livemode } : {}),\n })),\n }\n}\n\n/**\n * The fields that complete a sale, when its settled payments now cover the\n * total; null when the balance is still open or the sale is not pending.\n *\n * Pure, so the spec can hold the arithmetic: the fee is every card payment's\n * own `application_fee_amount` plus the take the cards did not carry, the tip\n * is summed beside the total and never inside it.\n */\nexport function posCompletionPatch(\n order: PosLiftedOrder,\n payments: CommerceModel.OrderPayment[],\n nowMs: number,\n): {\n patch: Record<string, unknown>\n invoiceTakeCents: number\n} | null {\n if (order.status !== 'pending') return null\n const totalCents = Number(order.totals?.totalCents ?? 0)\n if (CommerceModel.posBalanceDueCents(totalCents, payments) > 0) return null\n const takeFeeCents = Math.max(0, Math.round(Number(order.posTakeFeeCents ?? 0)))\n const invoiceTakeCents = CommerceModel.posInvoiceTakeCents({ takeFeeCents, payments })\n const settled = payments.filter((payment) => payment.status === 'succeeded')\n const cardFeeCents = settled\n .filter((payment) => CommerceModel.isCardPaymentMethod(payment.method))\n .reduce((sum, payment) => sum + Math.max(0, Math.round(Number(payment.feeCents ?? 0))), 0)\n const feeCents = cardFeeCents + invoiceTakeCents\n const tipCents = CommerceModel.posTipCents(payments)\n const intents = settled\n .map((payment) => payment.paymentIntentId)\n .filter((id): id is string => Boolean(id))\n const tenders = settled.map((payment) => CommerceModel.describeOrderPayment(payment))\n const overpaid = CommerceModel.posSettledCents(payments) - totalCents\n return {\n invoiceTakeCents,\n patch: {\n status: 'paid',\n paidAtMs: nowMs,\n totals: {\n ...(order.totals ?? {}),\n feeCents,\n ...(tipCents > 0 ? { tipCents } : {}),\n },\n ...(feeCents > 0 ? { feeCollection: CommerceModel.posFeeCollection(payments) } : {}),\n ...(intents.length ? { paymentIntentIds: intents } : {}),\n // The single-charge readers (refund, dispute lookup) key on this; a\n // sale with one card payment keeps working with every one of them.\n ...(intents.length === 1 ? { paymentIntentId: intents[0] } : {}),\n ...(settled.some((payment) => payment.livemode === false) ? { livemode: false } : {}),\n timeline: CommerceModel.appendOrderEvent(\n order,\n 'paid',\n `Paid — ${tenders.join(', ')}` +\n (overpaid > 0\n ? `. Overpaid by $${(overpaid / 100).toFixed(2)}: refund the difference.`\n : ''),\n nowMs,\n ),\n },\n }\n}\n\n/** The order document, lifted, with its id. */\nfunction liftOrder(id: string, data: unknown): PosLiftedOrder {\n return {\n ...(CommerceModel.liftLegacyOrder((data ?? {}) as any) as any),\n $id: id,\n }\n}\n\n/**\n * The ONE writer of a sale's ledger. Runs `prepare` (extra reads) and\n * `decide` inside one transaction on the order, writes the payment, and\n * completes the sale in the same commit when the balance reaches zero.\n */\nexport async function applyPosPayment<C = undefined>(options: {\n hostId: string\n orderId: string\n paymentId: string\n /** Reads beyond the order (a gift card, a stay), before any write. */\n prepare?: (transaction: any) => Promise<C>\n decide: (sale: {\n order: PosLiftedOrder\n payments: CommerceModel.OrderPayment[]\n existing: CommerceModel.OrderPayment | undefined\n context: C\n }) => PosPaymentStep\n /** Writes beyond the order, in the same transaction, for a `put`. */\n write?: (\n transaction: any,\n context: C,\n payment: CommerceModel.OrderPayment,\n previous: CommerceModel.OrderPayment | undefined,\n ) => void\n nowMs?: number\n}): Promise<PosPaymentOutcome> {\n const firestore = firebaseAdmin.app().firestore()\n const orderRef = firestore\n .collection('hosts')\n .doc(options.hostId)\n .collection('orders')\n .doc(options.orderId)\n const nowMs = options.nowMs ?? Date.now()\n const outcome = await firestore.runTransaction(async (transaction: any) => {\n const snapshot = await transaction.get(orderRef)\n if (!snapshot.exists) {\n return { ok: false as const, status: 404, error: 'Unknown sale' }\n }\n const order = liftOrder(orderRef.id, snapshot.data())\n if (order.channel !== 'pos' || !Array.isArray(order.payments)) {\n return { ok: false as const, status: 409, error: 'This order is not an open register sale' }\n }\n const context = (options.prepare\n ? await options.prepare(transaction)\n : undefined) as C\n const payments = CommerceModel.orderPayments(order)\n const existing = payments.find((payment) => payment.id === options.paymentId)\n const step = options.decide({ order, payments, existing, context })\n if (step.kind === 'refuse') {\n return { ok: false as const, status: step.status, error: step.error }\n }\n if (step.kind === 'keep') {\n return {\n ok: true as const,\n order,\n payment: existing ?? null,\n completed: false,\n changed: false,\n }\n }\n const nextPayments = existing\n ? payments.map((payment) => (payment.id === step.payment.id ? step.payment : payment))\n : [...payments, step.payment]\n let next: PosLiftedOrder = { ...order, payments: nextPayments }\n if (step.event) {\n next = {\n ...next,\n timeline: CommerceModel.appendOrderEvent(\n order,\n step.event.event,\n step.event.detail,\n nowMs,\n ),\n }\n }\n const completion = posCompletionPatch(next, nextPayments, nowMs)\n const write: Record<string, unknown> = {\n payments: nextPayments,\n ...(next.timeline !== order.timeline ? { timeline: next.timeline } : {}),\n }\n if (completion) {\n Object.assign(write, completion.patch)\n next = { ...next, ...(completion.patch as Partial<PosLiftedOrder>) }\n Object.assign(write, CommerceModel.orderListFields(next, orderRef.id))\n // ACCRUED IN THE SAME COMMIT AS THE FLIP (the AGL-2111 rule): the part\n // of the take no card payout carried goes on the org's invoice, and an\n // order and the fee it owes cannot diverge.\n const feeOrgId = String(order.posFeeOrgId ?? '')\n if (completion.invoiceTakeCents > 0 && feeOrgId) {\n const month = offlineFeeMonthKey(new Date(nowMs))\n transaction.set(\n firestore.collection('orgs').doc(feeOrgId).collection('offlineFees').doc(month),\n {\n month,\n feeCents: firebaseAdmin.firestore.FieldValue.increment(completion.invoiceTakeCents),\n orders: firebaseAdmin.firestore.FieldValue.increment(1),\n },\n { merge: true },\n )\n }\n } else if (\n order.status === 'paid' &&\n step.payment.status === 'succeeded' &&\n existing?.status !== 'succeeded'\n ) {\n // MONEY THAT ARRIVED AFTER THE SALE WAS ALREADY PAID: a QR page paid\n // after the cashier took another tender. It is recorded, never\n // dropped, and said on the order so the merchant can refund it.\n write['timeline'] = CommerceModel.appendOrderEvent(\n next,\n 'pos-overpaid',\n `${CommerceModel.describeOrderPayment(step.payment)} arrived after the ` +\n 'sale was already paid. Refund it from Stripe.',\n nowMs,\n )\n }\n transaction.set(orderRef, write, { merge: true })\n options.write?.(transaction, context, step.payment, existing)\n return {\n ok: true as const,\n order: next,\n payment: step.payment,\n completed: Boolean(completion),\n changed: true,\n }\n })\n if (outcome.ok && outcome.completed) {\n await completePosSale(options.hostId, outcome.order)\n }\n return outcome\n}\n\n/*==========================================\n * \"A REGISTER SALE COMPLETED\" — the one point every POS sale passes through\n * (AGL-3607), whichever way it was paid: the ledger's last payment\n * ({@link completePosSale}), a single-tender cash or room sale\n * (`pos-order.ts`), or a legacy QR sale paid through the `commerce-draft`\n * webhook branch. Peripherals (a cloud receipt printer, a cash drawer kick)\n * and anything else that must follow a sale subscribe here rather than\n * patching each path.\n *=========================================*/\n\nexport interface PosSaleCompletedEvent {\n hostId: string\n orderId: string\n order: CommerceModel.HostOrder\n}\n\nexport type PosSaleCompletedListener = (event: PosSaleCompletedEvent) => void | Promise<void>\n\nconst saleCompletedListeners = new Set<PosSaleCompletedListener>()\n\n/** Subscribes to completed register sales; returns the unsubscribe. */\nexport function onPosSaleCompleted(listener: PosSaleCompletedListener): () => void {\n saleCompletedListeners.add(listener)\n return () => saleCompletedListeners.delete(listener)\n}\n\n/**\n * Tells every listener a register sale completed. Awaited, and never throws:\n * the money is already taken, so a listener's failure is logged, not\n * returned to a cashier who would ring the sale again.\n */\nexport async function notifyPosSaleCompleted(event: PosSaleCompletedEvent): Promise<void> {\n for (const listener of [...saleCompletedListeners]) {\n try {\n await listener(event)\n } catch (error) {\n console.error('[pos-sale] sale-completed listener failed', event.orderId, error)\n }\n }\n}\n\n/** Reads the sale as it stands, for the register's status polls. */\nexport async function readPosSale(\n hostId: string,\n orderId: string,\n): Promise<PosLiftedOrder | null> {\n const snapshot = await firebaseAdmin\n .app()\n .firestore()\n .collection('hosts')\n .doc(hostId)\n .collection('orders')\n .doc(orderId)\n .get()\n if (!snapshot.exists) return null\n return liftOrder(snapshot.id, snapshot.data())\n}\n\n/**\n * Everything that follows a sale being paid, run once by the call whose\n * commit completed it. Each step is guarded on its own and none can undo the\n * sale: the money is taken, so a failure here is logged and said on the order\n * rather than thrown back at a cashier who would ring it again.\n */\nexport async function completePosSale(\n hostId: string,\n order: PosLiftedOrder,\n): Promise<void> {\n const firestore = firebaseAdmin.app().firestore()\n const hostRef = firestore.collection('hosts').doc(hostId)\n const orderRef = hostRef.collection('orders').doc(order.$id)\n const notes: Array<{ event: string; detail: string }> = []\n\n // The promotion's slot becomes a redemption only now: a sale that was\n // voided half-paid never counted against the merchant's cap (AGL-305).\n if (order.discountId && order.discountHoldKey) {\n const settled = await settlePromotionSlot({\n firestore,\n ref: hostRef.collection('discounts').doc(order.discountId),\n holdKey: order.discountHoldKey,\n label: `pos discount ${order.discountId}`,\n })\n if (settled === 'missing' || settled === 'error') {\n notes.push({\n event: 'redemption-orphaned',\n detail:\n `Discount ${order.discountId} was applied to this sale but its ` +\n 'redemption could not be counted against its limit.',\n })\n }\n }\n\n // Stock comes off exactly once, here, compounding across lines of one\n // product (AGL-1828) and atomically against other channels (AGL-2320).\n const products = new Map<string, CommerceModel.HostProduct>()\n for (const line of order.lineItems ?? []) {\n try {\n if (!products.has(line.productId)) {\n const snapshot = await hostRef.collection('products').doc(line.productId).get()\n if (!snapshot.exists) continue\n products.set(line.productId, CommerceModel.liftLegacyProduct(snapshot.data() as any))\n }\n const product = products.get(line.productId) as CommerceModel.HostProduct\n const variantId = line.variantId ?? product.variants[0]?.id\n const tracked = product.variants.some(\n (variant) => variant.id === variantId && variant.inventory != null,\n )\n if (!variantId || !tracked) continue\n const moved = await decrementVariantStock({\n firestore,\n hostRef,\n hostId,\n productId: line.productId,\n variantId,\n quantity: line.quantity,\n locationId: order.locationId || undefined,\n ledger: { reason: 'sale', orderId: order.$id },\n })\n if (!moved.before || !moved.after) continue\n products.set(line.productId, moved.after)\n alertLowStockCrossing(hostId, moved.before, moved.after)\n } catch (error) {\n console.error('[pos-sale] stock decrement failed', order.$id, line.productId, error)\n }\n }\n\n const receipt = order.receiptRequest\n const receiptEmail = receipt?.channel === 'email' ? String(receipt.to ?? '') : ''\n const contactEmail = receiptEmail || String(order.customerEmail ?? '')\n const marketingOptIn = Boolean((receipt as { marketingOptIn?: boolean } | undefined)?.marketingOptIn)\n const totalCents = Number(order.totals?.totalCents ?? 0)\n if (contactEmail) {\n await recordCapturedContact({\n orgId: '',\n hostId,\n identity: { email: contactEmail },\n surface: 'relationship',\n lifecycleFloor: 'customer',\n // The customer's own tick on the display, the same opt-in the online\n // checkout records (AGL-3608); an unticked box records nothing.\n ...(marketingOptIn ? { marketingConsent: true } : {}),\n purchaseCents: totalCents,\n interaction: {\n source: 'order',\n refId: order.$id,\n summary: `In-store purchase ($${(totalCents / 100).toFixed(2)})`,\n },\n }).catch((error: unknown) => {\n console.error('[pos-sale] contact capture failed', error)\n })\n }\n\n // The receipt and the paid event, through the same doors every sale uses\n // (AGL-3610, AGL-3611): the buyer-notification door claims each message\n // per channel, so a second completion path can never mail twice, and it\n // texts the receipt when the customer chose a text and a provider is on.\n if ((receipt?.channel === 'email' || receipt?.channel === 'sms') && receipt.to) {\n // The customer named where it goes: it goes there, whatever else the\n // order holds (AGL-3608).\n const sent = await deliverChosenPosReceipt(\n { hostId, orderId: order.$id },\n { channel: receipt.channel, to: receipt.to, orderEmail: String(order.customerEmail ?? '') },\n )\n if (sent !== 'sent') {\n notes.push({\n event: 'receipt-unsent',\n detail: `The ${receipt.channel === 'sms' ? 'text' : 'email'} receipt could not be sent.`,\n })\n }\n } else if (contactEmail) {\n await notifyOrderBuyer({ hostId, orderId: order.$id }, 'receipt', { email: contactEmail })\n }\n await raiseOrderEvent(ORDER_PAID_EVENT, { hostId, orderId: order.$id, key: 'paid' }).catch(\n (error: unknown) => console.error('[pos-sale] order.paid event failed', error),\n )\n\n if (notes.length) {\n await firestore\n .runTransaction(async (transaction: any) => {\n const fresh = liftOrder(orderRef.id, (await transaction.get(orderRef)).data())\n let timeline = fresh.timeline ?? []\n for (const note of notes) {\n timeline = CommerceModel.appendOrderEvent({ timeline }, note.event, note.detail)\n }\n transaction.set(orderRef, { timeline }, { merge: true })\n })\n .catch((error: unknown) => console.error('[pos-sale] note failed', error))\n }\n\n await notifyPosSaleCompleted({ hostId, orderId: order.$id, order })\n\n // The customer screen says thank you and forgets the customer: the state\n // is rewritten whole, so no address or phone outlives the sale (AGL-3608).\n if (order.registerId) {\n await resetPosDisplay(hostId, order.registerId).catch((error: unknown) =>\n console.error('[pos-sale] display reset failed', error),\n )\n }\n}\n\n/**\n * Sends a receipt the customer (or the cashier for them) explicitly asked\n * for, to the address or number they gave (AGL-3607, AGL-3608).\n *\n * It goes through the buyer-notification door first, so the order's\n * once-per-channel marker is claimed and a completion that races this call\n * cannot send a second copy. The door can skip it, though, for reasons that\n * do not apply to a request made at the counter: the store switched\n * automatic receipts or texts off, a receipt already went out on that\n * channel to an earlier address, or the door would use the email the order\n * was opened with rather than the one just typed. In each of those cases the\n * receipt is sent explicitly, as the order dialog's \"Resend receipt\" does.\n */\nexport async function deliverChosenPosReceipt(\n ref: { hostId: string; orderId: string },\n input: { channel: 'email' | 'sms'; to: string; orderEmail?: string },\n): Promise<'sent' | 'failed' | 'not_configured'> {\n const orderEmail = String(input.orderEmail ?? '').trim().toLowerCase()\n const to = input.to.trim()\n const doorAddressesIt = input.channel === 'sms' || !orderEmail || orderEmail === to.toLowerCase()\n if (doorAddressesIt) {\n const door = await notifyOrderBuyer(ref, 'receipt', input.channel === 'email' ? { email: to } : {})\n const entry =\n door.outcome === 'handled'\n ? door.channels.find((channel) => channel.channel === input.channel)\n : undefined\n if (entry?.outcome === 'sent') return 'sent'\n if (entry?.outcome === 'failed') return 'failed'\n // Already sent to this very address: nothing more to do.\n if (entry?.outcome === 'already' && input.channel === 'email') return 'sent'\n }\n const explicit = await sendOrderReceipt(ref, { channel: input.channel, to })\n if (explicit.outcome === 'sent') return 'sent'\n return explicit.outcome === 'not_configured' ? 'not_configured' : 'failed'\n}\n\n/**\n * Hands back a promotion slot an open sale was holding, when the sale is\n * voided rather than paid.\n */\nexport async function releasePosSaleDiscount(\n hostId: string,\n order: PosLiftedOrder,\n): Promise<void> {\n if (!order.discountId || !order.discountHoldKey) return\n await releasePromotionHold(\n firebaseAdmin\n .app()\n .firestore()\n .collection('hosts')\n .doc(hostId)\n .collection('discounts')\n .doc(order.discountId),\n order.discountHoldKey,\n )\n}\n"],"names":["createHash","firebaseAdmin","recordCapturedContact","CommerceModel","alertLowStockCrossing","decrementVariantStock","releasePromotionHold","settlePromotionSlot","offlineFeeMonthKey","resetPosDisplay","notifyOrderBuyer","sendOrderReceipt","raiseOrderEvent","ORDER_PAID_EVENT","posPaymentId","orderId","attemptKey","update","digest","slice","posSaleSummary","order","payments","orderPayments","totalCents","Number","totals","$id","status","paidCents","posSettledCents","dueCents","posBalanceDueCents","tenderableCents","posTenderableCents","tipCents","posTipCents","map","payment","id","method","amountCents","cardBrand","last4","changeCents","checkoutUrl","readerId","failureMessage","livemode","posCompletionPatch","nowMs","takeFeeCents","Math","max","round","posTakeFeeCents","invoiceTakeCents","posInvoiceTakeCents","settled","filter","cardFeeCents","isCardPaymentMethod","reduce","sum","feeCents","intents","paymentIntentId","Boolean","tenders","describeOrderPayment","overpaid","patch","paidAtMs","feeCollection","posFeeCollection","length","paymentIntentIds","some","timeline","appendOrderEvent","join","toFixed","liftOrder","data","liftLegacyOrder","applyPosPayment","options","firestore","app","orderRef","collection","doc","hostId","Date","now","outcome","runTransaction","transaction","snapshot","get","exists","ok","error","channel","Array","isArray","context","prepare","undefined","existing","find","paymentId","step","decide","kind","completed","changed","nextPayments","next","event","detail","completion","write","Object","assign","orderListFields","feeOrgId","String","posFeeOrgId","month","set","FieldValue","increment","orders","merge","completePosSale","saleCompletedListeners","Set","onPosSaleCompleted","listener","add","delete","notifyPosSaleCompleted","console","readPosSale","receipt","hostRef","notes","discountId","discountHoldKey","ref","holdKey","label","push","products","Map","line","lineItems","product","has","productId","liftLegacyProduct","variantId","variants","tracked","variant","inventory","moved","quantity","locationId","ledger","reason","before","after","receiptRequest","receiptEmail","to","contactEmail","customerEmail","marketingOptIn","orgId","identity","email","surface","lifecycleFloor","marketingConsent","purchaseCents","interaction","source","refId","summary","catch","sent","deliverChosenPosReceipt","orderEmail","key","fresh","note","registerId","input","trim","toLowerCase","doorAddressesIt","door","entry","channels","explicit","releasePosSaleDiscount"],"mappings":"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"}
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @license
3
+ * Copyright 2026 Aglyn LLC
4
+ *
5
+ * Licensed under the Apache License, Version 2.0 (the "License");
6
+ * you may not use this file except in compliance with the License.
7
+ * You may obtain a copy of the License at
8
+ *
9
+ * http://www.apache.org/licenses/LICENSE-2.0
10
+ *
11
+ * Unless required by applicable law or agreed to in writing, software
12
+ * distributed under the License is distributed on an "AS IS" BASIS,
13
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ * See the License for the specific language governing permissions and
15
+ * limitations under the License.
16
+ */
17
+ import type { PluginApiHandler, PluginApiRequest } from '@aglyn/aglyn/server';
18
+ import { type PosShift, type PosShiftReport } from '../model/commerce-pos-ops';
19
+ import { type PosOpsDeps, type PosOpsStaff } from './pos-ops-gate';
20
+ /** The most sales one report reads; past it the report says it is partial. */
21
+ export declare const POS_SHIFT_SALES_CEILING = 5000;
22
+ /** The largest float or cash movement the drawer records in one entry. */
23
+ export declare const POS_CASH_ENTRY_MAX_CENTS = 10000000;
24
+ /**
25
+ * The figures for a shift, read from the sales stamped with it and the
26
+ * returns rung against it. Inside a transaction when one is given, so a Z
27
+ * report and the close it freezes see the same sales.
28
+ */
29
+ export declare function readPosShiftReport(registerRef: FirebaseFirestore.DocumentReference, hostRef: FirebaseFirestore.DocumentReference, shiftId: string, shift: Pick<PosShift, 'openingFloatCents' | 'cashEvents'>, transaction?: FirebaseFirestore.Transaction): Promise<PosShiftReport>;
30
+ type Outcome = {
31
+ status: number;
32
+ body: Record<string, unknown>;
33
+ };
34
+ export declare function handlePosShift(deps: PosOpsDeps, req: PluginApiRequest): Promise<Outcome>;
35
+ /** Whether a register may take a sale or pay cash out, by the site's shift rule. */
36
+ export declare function posShiftForSale(staff: Pick<PosOpsStaff, 'settings'>, registerRef: FirebaseFirestore.DocumentReference): Promise<{
37
+ ok: true;
38
+ shiftId: string | null;
39
+ } | {
40
+ ok: false;
41
+ error: string;
42
+ }>;
43
+ export declare function createPosShiftHandler(deps?: () => PosOpsDeps): PluginApiHandler;
44
+ export declare const posShiftHandler: PluginApiHandler;
45
+ export {};