@simplelayer/graniteer-core 0.2.2 → 0.2.3

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 (475) hide show
  1. package/dist/adminBookingCredit.d.ts +107 -0
  2. package/dist/adminBookingCredit.js +163 -0
  3. package/dist/agreementCheckout.d.ts +34 -0
  4. package/dist/agreementCheckout.js +211 -0
  5. package/dist/agreementPortalEmail.d.ts +15 -0
  6. package/dist/agreementPortalEmail.js +107 -0
  7. package/dist/availability.d.ts +51 -0
  8. package/dist/availability.js +152 -0
  9. package/dist/billingPortalLinkEmail.d.ts +14 -0
  10. package/dist/billingPortalLinkEmail.js +98 -0
  11. package/dist/bookingAgreementEmail.d.ts +23 -0
  12. package/dist/bookingAgreementEmail.js +116 -0
  13. package/dist/bookingEffects.d.ts +84 -0
  14. package/dist/bookingEffects.js +309 -0
  15. package/dist/bookingHoldReclaim.d.ts +16 -0
  16. package/dist/bookingHoldReclaim.js +74 -0
  17. package/dist/busClient.d.ts +44 -0
  18. package/dist/busClient.js +196 -0
  19. package/dist/busSignature.d.ts +19 -0
  20. package/{src/busSignature.ts → dist/busSignature.js} +64 -71
  21. package/dist/checkoutCoupon.d.ts +156 -0
  22. package/dist/checkoutCoupon.js +369 -0
  23. package/dist/checkoutSessionParams.d.ts +19 -0
  24. package/dist/checkoutSessionParams.js +36 -0
  25. package/dist/commonsContract.d.ts +70 -0
  26. package/dist/commonsContract.js +142 -0
  27. package/dist/commonsDeposit.d.ts +78 -0
  28. package/dist/commonsDeposit.js +199 -0
  29. package/dist/commonsDepositWebhook.d.ts +37 -0
  30. package/dist/commonsDepositWebhook.js +147 -0
  31. package/dist/conductorAdmin.d.ts +76 -0
  32. package/dist/conductorAdmin.js +88 -0
  33. package/dist/dayPassConfirmation.d.ts +17 -0
  34. package/dist/dayPassConfirmation.js +187 -0
  35. package/dist/dunningEmails.d.ts +40 -0
  36. package/dist/dunningEmails.js +174 -0
  37. package/dist/email-templates/brand.d.ts +82 -0
  38. package/dist/email-templates/brand.js +72 -0
  39. package/dist/email-templates/email-change.d.ts +10 -0
  40. package/dist/email-templates/email-change.js +50 -0
  41. package/dist/email-templates/invite.d.ts +8 -0
  42. package/dist/email-templates/invite.js +44 -0
  43. package/dist/email-templates/magic-link.d.ts +10 -0
  44. package/dist/email-templates/magic-link.js +26 -0
  45. package/dist/email-templates/reauthentication.d.ts +6 -0
  46. package/dist/email-templates/reauthentication.js +35 -0
  47. package/dist/email-templates/recovery.d.ts +10 -0
  48. package/dist/email-templates/recovery.js +26 -0
  49. package/dist/email-templates/signup.d.ts +12 -0
  50. package/dist/email-templates/signup.js +30 -0
  51. package/dist/functions/admin-cancel-membership.d.ts +1 -0
  52. package/dist/functions/admin-cancel-membership.js +286 -0
  53. package/dist/functions/admin-change-membership-plan.d.ts +1 -0
  54. package/dist/functions/admin-change-membership-plan.js +281 -0
  55. package/dist/functions/admin-charge-guest-print.d.ts +1 -0
  56. package/dist/functions/admin-charge-guest-print.js +227 -0
  57. package/dist/functions/admin-correct-booking.d.ts +1 -0
  58. package/dist/functions/admin-correct-booking.js +326 -0
  59. package/dist/functions/admin-create-booking.d.ts +43 -0
  60. package/dist/functions/admin-create-booking.js +410 -0
  61. package/dist/functions/admin-create-commons-event.d.ts +1 -0
  62. package/dist/functions/admin-create-commons-event.js +237 -0
  63. package/dist/functions/admin-debug-boldsign-doc.d.ts +1 -0
  64. package/dist/functions/admin-debug-boldsign-doc.js +110 -0
  65. package/dist/functions/admin-door-write.d.ts +1 -0
  66. package/dist/functions/admin-door-write.js +267 -0
  67. package/dist/functions/admin-issue-day-pass.d.ts +14 -0
  68. package/dist/functions/admin-issue-day-pass.js +213 -0
  69. package/dist/functions/admin-mark-booking-paid.d.ts +1 -0
  70. package/dist/functions/admin-mark-booking-paid.js +202 -0
  71. package/dist/functions/admin-mint-billing-portal-link.d.ts +6 -0
  72. package/dist/functions/admin-mint-billing-portal-link.js +159 -0
  73. package/dist/functions/admin-mint-portal-link.d.ts +3 -0
  74. package/dist/functions/admin-mint-portal-link.js +54 -0
  75. package/dist/functions/admin-photo-upload.d.ts +1 -0
  76. package/dist/functions/admin-photo-upload.js +104 -0
  77. package/dist/functions/admin-remove-team-member.d.ts +1 -0
  78. package/dist/functions/admin-remove-team-member.js +140 -0
  79. package/dist/functions/admin-request-trial.d.ts +5 -0
  80. package/dist/functions/admin-request-trial.js +349 -0
  81. package/dist/functions/admin-resend-commons-deposit-link.d.ts +7 -0
  82. package/dist/functions/admin-resend-commons-deposit-link.js +298 -0
  83. package/dist/functions/admin-reset-mfa.d.ts +1 -0
  84. package/dist/functions/admin-reset-mfa.js +129 -0
  85. package/dist/functions/admin-retry-invoice-payment.d.ts +76 -0
  86. package/dist/functions/admin-retry-invoice-payment.js +269 -0
  87. package/dist/functions/admin-reverse-coupon-redemption.d.ts +1 -0
  88. package/dist/functions/admin-reverse-coupon-redemption.js +91 -0
  89. package/dist/functions/admin-revoke-agreement.d.ts +4 -0
  90. package/dist/functions/admin-revoke-agreement.js +410 -0
  91. package/dist/functions/admin-send-commons-agreement.d.ts +1 -0
  92. package/dist/functions/admin-send-commons-agreement.js +212 -0
  93. package/dist/functions/admin-set-credit-amount.d.ts +1 -0
  94. package/dist/functions/admin-set-credit-amount.js +112 -0
  95. package/dist/functions/admin-skip-commons-contract.d.ts +1 -0
  96. package/dist/functions/admin-skip-commons-contract.js +170 -0
  97. package/dist/functions/admin-undo-membership-cancel.d.ts +1 -0
  98. package/dist/functions/admin-undo-membership-cancel.js +135 -0
  99. package/dist/functions/admin-wall-photo-write.d.ts +1 -0
  100. package/dist/functions/admin-wall-photo-write.js +137 -0
  101. package/dist/functions/auth-email-hook.d.ts +20 -0
  102. package/dist/functions/auth-email-hook.js +209 -0
  103. package/dist/functions/boldsign-sender-identity.d.ts +1 -0
  104. package/dist/functions/boldsign-sender-identity.js +109 -0
  105. package/dist/functions/booking-availability.d.ts +1 -0
  106. package/dist/functions/booking-availability.js +355 -0
  107. package/dist/functions/booking-member-preview.d.ts +1 -0
  108. package/dist/functions/booking-member-preview.js +123 -0
  109. package/dist/functions/booking-status.d.ts +3 -0
  110. package/dist/functions/booking-status.js +139 -0
  111. package/dist/functions/conductor.d.ts +3 -0
  112. package/dist/functions/conductor.js +451 -0
  113. package/dist/functions/create-agreement.d.ts +8 -0
  114. package/dist/functions/create-agreement.js +498 -0
  115. package/dist/functions/create-booking.d.ts +44 -0
  116. package/dist/functions/create-booking.js +538 -0
  117. package/dist/functions/create-day-pass-checkout.d.ts +4 -0
  118. package/dist/functions/create-day-pass-checkout.js +196 -0
  119. package/dist/functions/create-portal-session.d.ts +4 -0
  120. package/dist/functions/create-portal-session.js +127 -0
  121. package/dist/functions/create-subscription-checkout.d.ts +4 -0
  122. package/dist/functions/create-subscription-checkout.js +394 -0
  123. package/dist/functions/day-pass-status.d.ts +1 -0
  124. package/dist/functions/day-pass-status.js +70 -0
  125. package/dist/functions/dayStatus.d.ts +15 -0
  126. package/dist/functions/dayStatus.js +59 -0
  127. package/dist/functions/diag-webpush-test.d.ts +1 -0
  128. package/dist/functions/diag-webpush-test.js +42 -0
  129. package/dist/functions/event-access-admin.d.ts +17 -0
  130. package/dist/functions/event-access-admin.js +262 -0
  131. package/dist/functions/event-access-store.d.ts +1 -0
  132. package/dist/functions/event-access-store.js +343 -0
  133. package/dist/functions/ezeep-print-webhook.d.ts +1 -0
  134. package/dist/functions/ezeep-print-webhook.js +160 -0
  135. package/dist/functions/ezeep-usage-reconcile.d.ts +1 -0
  136. package/dist/functions/ezeep-usage-reconcile.js +305 -0
  137. package/dist/functions/fetch-avatar-original.d.ts +3 -0
  138. package/dist/functions/fetch-avatar-original.js +423 -0
  139. package/dist/functions/get-provider-sign-link.d.ts +3 -0
  140. package/dist/functions/get-provider-sign-link.js +146 -0
  141. package/dist/functions/get-signing-link.d.ts +1 -0
  142. package/dist/functions/get-signing-link.js +192 -0
  143. package/dist/functions/guest-print-setup-confirm.d.ts +1 -0
  144. package/dist/functions/guest-print-setup-confirm.js +126 -0
  145. package/dist/functions/guest-print-submit.d.ts +1 -0
  146. package/dist/functions/guest-print-submit.js +145 -0
  147. package/dist/functions/luma-webhook.d.ts +1 -0
  148. package/dist/functions/luma-webhook.js +123 -0
  149. package/dist/functions/manage-booking.d.ts +75 -0
  150. package/dist/functions/manage-booking.js +409 -0
  151. package/dist/functions/mcp.d.ts +16 -0
  152. package/dist/functions/mcp.js +51 -0
  153. package/dist/functions/member-door-action.d.ts +60 -0
  154. package/dist/functions/member-door-action.js +774 -0
  155. package/dist/functions/member-unifi-mapping.d.ts +15 -0
  156. package/dist/functions/member-unifi-mapping.js +198 -0
  157. package/dist/functions/membership-door-sync.d.ts +14 -0
  158. package/dist/functions/membership-door-sync.js +863 -0
  159. package/dist/functions/migration-collision-alert.copy.d.ts +7 -0
  160. package/dist/functions/migration-collision-alert.copy.js +207 -0
  161. package/dist/functions/migration-collision-alert.d.ts +7 -0
  162. package/dist/functions/migration-collision-alert.js +207 -0
  163. package/dist/functions/office-assignment-end.d.ts +12 -0
  164. package/dist/functions/office-assignment-end.js +140 -0
  165. package/dist/functions/portal-booking-access.d.ts +22 -0
  166. package/dist/functions/portal-booking-access.js +163 -0
  167. package/dist/functions/portal-list-invoices.d.ts +1 -0
  168. package/dist/functions/portal-list-invoices.js +90 -0
  169. package/dist/functions/portal-request-login.d.ts +7 -0
  170. package/dist/functions/portal-request-login.js +199 -0
  171. package/dist/functions/portal-resend-invite.d.ts +6 -0
  172. package/dist/functions/portal-resend-invite.js +225 -0
  173. package/dist/functions/portal-submit-event.d.ts +4 -0
  174. package/dist/functions/portal-submit-event.js +152 -0
  175. package/dist/functions/print-billing-recover.d.ts +1 -0
  176. package/dist/functions/print-billing-recover.js +83 -0
  177. package/dist/functions/print-billing-run.d.ts +1 -0
  178. package/dist/functions/print-billing-run.js +153 -0
  179. package/dist/functions/public-facts.d.ts +1 -0
  180. package/dist/functions/public-facts.js +141 -0
  181. package/dist/functions/push-send.d.ts +3 -0
  182. package/dist/functions/push-send.js +297 -0
  183. package/dist/functions/push-test.d.ts +3 -0
  184. package/dist/functions/push-test.js +215 -0
  185. package/dist/functions/request-portal-link.d.ts +7 -0
  186. package/dist/functions/request-portal-link.js +178 -0
  187. package/dist/functions/reschedule-booking.d.ts +50 -0
  188. package/dist/functions/reschedule-booking.js +571 -0
  189. package/dist/functions/review-ratings.d.ts +1 -0
  190. package/dist/functions/review-ratings.js +95 -0
  191. package/dist/functions/space-availability-range.d.ts +1 -0
  192. package/dist/functions/space-availability-range.js +109 -0
  193. package/dist/functions/stripe-db-reconcile.d.ts +3 -0
  194. package/dist/functions/stripe-db-reconcile.js +314 -0
  195. package/dist/functions/stripe-webhook.d.ts +46 -0
  196. package/dist/functions/stripe-webhook.js +2367 -0
  197. package/dist/functions/sync-gcal-blackouts.d.ts +1 -0
  198. package/dist/functions/sync-gcal-blackouts.js +251 -0
  199. package/dist/functions/timetable-event-register.d.ts +1 -0
  200. package/dist/functions/timetable-event-register.js +155 -0
  201. package/dist/functions/timetable-event-status.d.ts +1 -0
  202. package/dist/functions/timetable-event-status.js +86 -0
  203. package/dist/functions/timetable-spaces.d.ts +1 -0
  204. package/dist/functions/timetable-spaces.js +161 -0
  205. package/dist/functions/touch-pass-reconciler.d.ts +1 -0
  206. package/dist/functions/touch-pass-reconciler.js +688 -0
  207. package/dist/functions/touch-pass-signup.d.ts +1 -0
  208. package/dist/functions/touch-pass-signup.js +447 -0
  209. package/dist/functions/upload-booking-display-image.d.ts +4 -0
  210. package/dist/functions/upload-booking-display-image.js +159 -0
  211. package/dist/functions/virtual-onboarding-purge.d.ts +1 -0
  212. package/dist/functions/virtual-onboarding-purge.js +123 -0
  213. package/dist/functions/virtual-onboarding-submit.d.ts +1 -0
  214. package/dist/functions/virtual-onboarding-submit.js +303 -0
  215. package/dist/functions/voice-booking.d.ts +10 -0
  216. package/dist/functions/voice-booking.js +360 -0
  217. package/dist/functions/voice-day-pass.d.ts +15 -0
  218. package/dist/functions/voice-day-pass.js +269 -0
  219. package/dist/functions/voice-inquiry.d.ts +1 -0
  220. package/dist/functions/voice-inquiry.js +156 -0
  221. package/dist/functions/voice-membership-signup.d.ts +15 -0
  222. package/dist/functions/voice-membership-signup.js +273 -0
  223. package/dist/functions/voice-tour-availability.d.ts +1 -0
  224. package/dist/functions/voice-tour-availability.js +179 -0
  225. package/dist/functions/voice-tour-booking.d.ts +21 -0
  226. package/dist/functions/voice-tour-booking.js +308 -0
  227. package/dist/gcalSync.d.ts +29 -0
  228. package/dist/gcalSync.js +119 -0
  229. package/dist/ghlEventInquiry.d.ts +16 -0
  230. package/dist/ghlEventInquiry.js +116 -0
  231. package/dist/ghlNote.d.ts +5 -0
  232. package/dist/ghlNote.js +29 -0
  233. package/dist/ghlTask.d.ts +7 -0
  234. package/dist/ghlTask.js +39 -0
  235. package/dist/ghlVoiceInquiry.d.ts +26 -0
  236. package/dist/ghlVoiceInquiry.js +68 -0
  237. package/dist/guestPrintCapture.d.ts +217 -0
  238. package/dist/guestPrintCapture.js +362 -0
  239. package/dist/index.d.ts +3 -0
  240. package/{index.js → dist/index.js} +3 -2
  241. package/dist/lumaGhl.d.ts +19 -0
  242. package/dist/lumaGhl.js +147 -0
  243. package/dist/mailArrivalEmail.d.ts +15 -0
  244. package/dist/mailArrivalEmail.js +99 -0
  245. package/dist/manageToken.d.ts +64 -0
  246. package/dist/manageToken.js +261 -0
  247. package/dist/membership.d.ts +20 -0
  248. package/dist/membership.js +87 -0
  249. package/dist/membershipBusClient.d.ts +139 -0
  250. package/dist/membershipBusClient.js +443 -0
  251. package/dist/membershipWelcome.d.ts +117 -0
  252. package/dist/membershipWelcome.js +497 -0
  253. package/dist/migrationCheckout.d.ts +169 -0
  254. package/dist/migrationCheckout.js +250 -0
  255. package/dist/money.d.ts +20 -0
  256. package/dist/money.js +35 -0
  257. package/dist/ops.d.ts +27 -0
  258. package/dist/ops.js +87 -0
  259. package/dist/pacificDate.d.ts +8 -0
  260. package/{src/pacificDate.ts → dist/pacificDate.js} +76 -88
  261. package/dist/paymentLinkEmail.d.ts +15 -0
  262. package/dist/paymentLinkEmail.js +102 -0
  263. package/dist/policyAcknowledgment.d.ts +46 -0
  264. package/dist/policyAcknowledgment.js +58 -0
  265. package/dist/portalSession.d.ts +15 -0
  266. package/dist/portalSession.js +31 -0
  267. package/dist/pricing.d.ts +306 -0
  268. package/dist/pricing.js +788 -0
  269. package/dist/printBilling.d.ts +340 -0
  270. package/dist/printBilling.js +619 -0
  271. package/dist/printBillingAdapters.d.ts +29 -0
  272. package/dist/printBillingAdapters.js +130 -0
  273. package/dist/printCorrections.d.ts +175 -0
  274. package/dist/printCorrections.js +328 -0
  275. package/dist/rateLimit.d.ts +20 -0
  276. package/dist/rateLimit.js +70 -0
  277. package/dist/referralCredits.d.ts +5 -0
  278. package/{src/referralCredits.ts → dist/referralCredits.js} +27 -34
  279. package/dist/referralGrant.d.ts +49 -0
  280. package/dist/referralGrant.js +268 -0
  281. package/dist/rescheduleCredit.d.ts +98 -0
  282. package/dist/rescheduleCredit.js +263 -0
  283. package/dist/reservationWifiCode.d.ts +19 -0
  284. package/{src/reservationWifiCode.ts → dist/reservationWifiCode.js} +67 -81
  285. package/dist/retellCallAnalyzed.d.ts +18 -0
  286. package/dist/retellCallAnalyzed.js +91 -0
  287. package/dist/retellSignature.d.ts +14 -0
  288. package/dist/retellSignature.js +60 -0
  289. package/dist/signedUnpaidReminderEmail.d.ts +15 -0
  290. package/dist/signedUnpaidReminderEmail.js +111 -0
  291. package/dist/slackAlert.d.ts +13 -0
  292. package/dist/slackAlert.js +37 -0
  293. package/dist/stripeCoworkingPortal.d.ts +21 -0
  294. package/dist/stripeCoworkingPortal.js +80 -0
  295. package/dist/supabaseTestFakes.d.ts +67 -0
  296. package/dist/supabaseTestFakes.js +79 -0
  297. package/dist/supportTicketEmail.d.ts +16 -0
  298. package/dist/supportTicketEmail.js +98 -0
  299. package/dist/tier1Agreement.d.ts +51 -0
  300. package/dist/tier1Agreement.js +86 -0
  301. package/dist/unifiAccessPolicies.d.ts +36 -0
  302. package/dist/unifiAccessPolicies.js +185 -0
  303. package/dist/unifiGroups.d.ts +26 -0
  304. package/dist/unifiGroups.js +106 -0
  305. package/package.json +645 -169
  306. package/src/adminBookingCredit.test.ts +0 -451
  307. package/src/adminBookingCredit.ts +0 -239
  308. package/src/agreementCheckout.ts +0 -250
  309. package/src/agreementPortalEmail.ts +0 -128
  310. package/src/availability.test.ts +0 -25
  311. package/src/availability.ts +0 -201
  312. package/src/billingPortalLinkEmail.ts +0 -117
  313. package/src/bookingAgreementEmail.ts +0 -149
  314. package/src/bookingEffects.ts +0 -388
  315. package/src/bookingHoldReclaim.ts +0 -94
  316. package/src/busClient.ts +0 -268
  317. package/src/checkoutCoupon.test.ts +0 -675
  318. package/src/checkoutCoupon.ts +0 -455
  319. package/src/checkoutSessionParams.ts +0 -56
  320. package/src/commonsContract.ts +0 -175
  321. package/src/commonsDeposit.ts +0 -298
  322. package/src/commonsDepositWebhook.ts +0 -237
  323. package/src/conductorAdmin.ts +0 -141
  324. package/src/dayPassConfirmation.ts +0 -230
  325. package/src/dunningEmails.test.ts +0 -263
  326. package/src/dunningEmails.ts +0 -203
  327. package/src/email-templates/brand.ts +0 -93
  328. package/src/email-templates/email-change.tsx +0 -92
  329. package/src/email-templates/invite.tsx +0 -79
  330. package/src/email-templates/magic-link.tsx +0 -59
  331. package/src/email-templates/reauthentication.tsx +0 -60
  332. package/src/email-templates/recovery.tsx +0 -59
  333. package/src/email-templates/signup.tsx +0 -67
  334. package/src/functions/admin-cancel-membership.ts +0 -311
  335. package/src/functions/admin-change-membership-plan.ts +0 -312
  336. package/src/functions/admin-charge-guest-print.ts +0 -229
  337. package/src/functions/admin-correct-booking.ts +0 -333
  338. package/src/functions/admin-create-booking.ts +0 -460
  339. package/src/functions/admin-create-commons-event.ts +0 -244
  340. package/src/functions/admin-debug-boldsign-doc.ts +0 -93
  341. package/src/functions/admin-door-write.ts +0 -272
  342. package/src/functions/admin-issue-day-pass.ts +0 -231
  343. package/src/functions/admin-mark-booking-paid.ts +0 -203
  344. package/src/functions/admin-mint-billing-portal-link.ts +0 -168
  345. package/src/functions/admin-mint-portal-link.ts +0 -62
  346. package/src/functions/admin-photo-upload.ts +0 -128
  347. package/src/functions/admin-remove-team-member.ts +0 -150
  348. package/src/functions/admin-request-trial.ts +0 -366
  349. package/src/functions/admin-resend-commons-deposit-link.ts +0 -323
  350. package/src/functions/admin-reset-mfa.ts +0 -138
  351. package/src/functions/admin-retry-invoice-payment.test.ts +0 -567
  352. package/src/functions/admin-retry-invoice-payment.ts +0 -333
  353. package/src/functions/admin-reverse-coupon-redemption.ts +0 -98
  354. package/src/functions/admin-revoke-agreement.ts +0 -467
  355. package/src/functions/admin-send-commons-agreement.ts +0 -214
  356. package/src/functions/admin-set-credit-amount.ts +0 -123
  357. package/src/functions/admin-skip-commons-contract.ts +0 -165
  358. package/src/functions/admin-undo-membership-cancel.ts +0 -144
  359. package/src/functions/admin-wall-photo-write.ts +0 -141
  360. package/src/functions/auth-email-hook.ts +0 -259
  361. package/src/functions/boldsign-sender-identity.ts +0 -114
  362. package/src/functions/booking-availability.ts +0 -419
  363. package/src/functions/booking-member-preview.ts +0 -136
  364. package/src/functions/booking-status.ts +0 -149
  365. package/src/functions/conductor.ts +0 -505
  366. package/src/functions/create-agreement.ts +0 -537
  367. package/src/functions/create-booking.ts +0 -648
  368. package/src/functions/create-day-pass-checkout.ts +0 -218
  369. package/src/functions/create-portal-session.ts +0 -142
  370. package/src/functions/create-subscription-checkout.test.ts +0 -222
  371. package/src/functions/create-subscription-checkout.ts +0 -440
  372. package/src/functions/day-pass-status.ts +0 -89
  373. package/src/functions/dayStatus.ts +0 -71
  374. package/src/functions/diag-webpush-test.ts +0 -45
  375. package/src/functions/event-access-admin.ts +0 -277
  376. package/src/functions/event-access-store.ts +0 -334
  377. package/src/functions/ezeep-print-webhook.ts +0 -213
  378. package/src/functions/ezeep-usage-reconcile.ts +0 -299
  379. package/src/functions/fetch-avatar-original.ts +0 -457
  380. package/src/functions/get-provider-sign-link.ts +0 -155
  381. package/src/functions/get-signing-link.ts +0 -211
  382. package/src/functions/guest-print-setup-confirm.ts +0 -128
  383. package/src/functions/guest-print-submit.ts +0 -149
  384. package/src/functions/luma-webhook.ts +0 -165
  385. package/src/functions/manage-booking.ts +0 -472
  386. package/src/functions/mcp.ts +0 -67
  387. package/src/functions/member-door-action.test.ts +0 -1248
  388. package/src/functions/member-door-action.ts +0 -863
  389. package/src/functions/member-unifi-mapping.test.ts +0 -516
  390. package/src/functions/member-unifi-mapping.ts +0 -206
  391. package/src/functions/membership-door-sync.ts +0 -956
  392. package/src/functions/migration-collision-alert.copy.ts +0 -232
  393. package/src/functions/migration-collision-alert.test.ts +0 -349
  394. package/src/functions/migration-collision-alert.ts +0 -232
  395. package/src/functions/office-assignment-end.ts +0 -146
  396. package/src/functions/portal-booking-access.ts +0 -217
  397. package/src/functions/portal-list-invoices.ts +0 -99
  398. package/src/functions/portal-request-login.ts +0 -219
  399. package/src/functions/portal-resend-invite.ts +0 -248
  400. package/src/functions/portal-submit-event.ts +0 -168
  401. package/src/functions/print-billing-recover.ts +0 -97
  402. package/src/functions/print-billing-run.ts +0 -183
  403. package/src/functions/public-facts.ts +0 -168
  404. package/src/functions/push-send.ts +0 -348
  405. package/src/functions/push-test.ts +0 -234
  406. package/src/functions/request-portal-link.ts +0 -211
  407. package/src/functions/reschedule-booking.ts +0 -649
  408. package/src/functions/review-ratings.ts +0 -113
  409. package/src/functions/space-availability-range.acceptance.test.ts +0 -161
  410. package/src/functions/space-availability-range.ts +0 -142
  411. package/src/functions/stripe-db-reconcile.ts +0 -319
  412. package/src/functions/stripe-webhook.moved-regression.test.ts +0 -78
  413. package/src/functions/stripe-webhook.ts +0 -2595
  414. package/src/functions/sync-gcal-blackouts.ts +0 -298
  415. package/src/functions/timetable-event-register.ts +0 -162
  416. package/src/functions/timetable-event-status.ts +0 -90
  417. package/src/functions/timetable-spaces.ts +0 -219
  418. package/src/functions/touch-pass-reconciler.ts +0 -689
  419. package/src/functions/touch-pass-signup.ts +0 -478
  420. package/src/functions/upload-booking-display-image.ts +0 -179
  421. package/src/functions/virtual-onboarding-purge.ts +0 -134
  422. package/src/functions/virtual-onboarding-submit.ts +0 -315
  423. package/src/functions/voice-booking.ts +0 -453
  424. package/src/functions/voice-day-pass.ts +0 -346
  425. package/src/functions/voice-inquiry.test.ts +0 -301
  426. package/src/functions/voice-inquiry.ts +0 -198
  427. package/src/functions/voice-membership-signup.ts +0 -355
  428. package/src/functions/voice-tour-availability.ts +0 -204
  429. package/src/functions/voice-tour-booking.ts +0 -429
  430. package/src/gcalSync.ts +0 -142
  431. package/src/ghlEventInquiry.ts +0 -143
  432. package/src/ghlNote.ts +0 -34
  433. package/src/ghlTask.ts +0 -48
  434. package/src/ghlVoiceInquiry.ts +0 -90
  435. package/src/guestPrintCapture.test.ts +0 -722
  436. package/src/guestPrintCapture.ts +0 -538
  437. package/src/lumaGhl.ts +0 -195
  438. package/src/mailArrivalEmail.ts +0 -121
  439. package/src/manageToken.ts +0 -363
  440. package/src/membership.ts +0 -109
  441. package/src/membershipBusClient.ts +0 -537
  442. package/src/membershipWelcome.ts +0 -683
  443. package/src/migrationCheckout.ts +0 -366
  444. package/src/money.ts +0 -36
  445. package/src/ops.ts +0 -97
  446. package/src/paymentLinkEmail.ts +0 -123
  447. package/src/policyAcknowledgment.test.ts +0 -50
  448. package/src/policyAcknowledgment.ts +0 -96
  449. package/src/portalSession.ts +0 -46
  450. package/src/pricing.test.ts +0 -660
  451. package/src/pricing.ts +0 -1025
  452. package/src/printBilling.test.ts +0 -750
  453. package/src/printBilling.ts +0 -891
  454. package/src/printBillingAdapters.ts +0 -169
  455. package/src/printCorrections.test.ts +0 -348
  456. package/src/printCorrections.ts +0 -496
  457. package/src/rateLimit.ts +0 -82
  458. package/src/referralCredits.test.ts +0 -31
  459. package/src/referralGrant.ts +0 -321
  460. package/src/rescheduleCredit.test.ts +0 -521
  461. package/src/rescheduleCredit.ts +0 -337
  462. package/src/reservationWifiCode.test.ts +0 -69
  463. package/src/retellCallAnalyzed.test.ts +0 -167
  464. package/src/retellCallAnalyzed.ts +0 -113
  465. package/src/retellSignature.test.ts +0 -137
  466. package/src/retellSignature.ts +0 -82
  467. package/src/signedUnpaidReminderEmail.test.ts +0 -246
  468. package/src/signedUnpaidReminderEmail.ts +0 -132
  469. package/src/slackAlert.ts +0 -38
  470. package/src/stripeCoworkingPortal.ts +0 -91
  471. package/src/supabaseTestFakes.ts +0 -131
  472. package/src/supportTicketEmail.ts +0 -119
  473. package/src/tier1Agreement.ts +0 -125
  474. package/src/unifiAccessPolicies.ts +0 -228
  475. package/src/unifiGroups.ts +0 -129
@@ -0,0 +1,130 @@
1
+ // Real-world adapters for the print-usage-bill P2 decision core.
2
+ //
3
+ // This is the ONLY place the injected interfaces in printBilling.ts are bound to
4
+ // a live Stripe SDK and a live Supabase client. printBilling.ts itself imports
5
+ // nothing and can therefore be tested with hand-rolled stubs; everything with a
6
+ // network edge lives here, behind the same two interfaces.
7
+ //
8
+ // C-09 is visible in every method of makeDb(): there is not one `.from(...).update(...)`
9
+ // in this file. service_role holds SELECT only on all four tables, and every write
10
+ // goes through a `private` SECURITY DEFINER function owned by `postgres`.
11
+ /** Postgres raises our conditions with `errcode = 'GC0xx'`; PostgREST surfaces
12
+ * that string in `error.code`. Rethrow it in the shape gcCodeOf() reads so the
13
+ * core can branch on the code and never on message text. */
14
+ function throwGc(error) {
15
+ const e = new Error(error.message);
16
+ e.gcCode = error.code;
17
+ throw e;
18
+ }
19
+ export function makeDb(supabase) {
20
+ const call = async (fn, args) => {
21
+ const { data, error } = await supabase.rpc(fn, args);
22
+ if (error)
23
+ throwGc(error);
24
+ return data;
25
+ };
26
+ return {
27
+ async claim(a) {
28
+ const rows = await call('print_billing_claim', {
29
+ p_run_id: a.runId,
30
+ p_period_months: a.periodMonths,
31
+ p_period_ids: a.periodIds,
32
+ p_stripe_customer_id: a.customerId,
33
+ p_amount_cents: a.amountCents,
34
+ p_idempotency_key: a.idempotencyKey,
35
+ });
36
+ return Array.isArray(rows) ? rows[0] : rows;
37
+ },
38
+ async attemptBump(runId, leaseToken) {
39
+ return await call('print_billing_attempt_bump', { p_run_id: runId, p_lease_token: leaseToken });
40
+ },
41
+ async leaseRenew(runId, leaseToken) {
42
+ return await call('print_billing_lease_renew', { p_run_id: runId, p_lease_token: leaseToken });
43
+ },
44
+ async leaseAcquire(runId) {
45
+ const rows = await call('print_billing_lease_acquire', { p_run_id: runId });
46
+ // 0 rows means someone else acquired it between the select and the acquire.
47
+ // That is NOT an error and must not be treated as one (round 7 finding 1).
48
+ return rows && rows.length ? rows[0] : null;
49
+ },
50
+ async writeback(runId, leaseToken, status, invoiceId, detail) {
51
+ await call('print_billing_writeback', {
52
+ p_run_id: runId, p_lease_token: leaseToken, p_new_status: status,
53
+ p_invoice_id: invoiceId, p_detail: detail ?? {},
54
+ });
55
+ },
56
+ async hold(runId, leaseToken, reason) {
57
+ await call('print_billing_hold', { p_run_id: runId, p_lease_token: leaseToken, p_reason: reason });
58
+ },
59
+ async releaseRun(runId, leaseToken, reason, listVerifiedEmpty) {
60
+ await call('print_billing_release_run', {
61
+ p_run_id: runId, p_lease_token: leaseToken, p_reason: reason,
62
+ p_list_verified_empty: listVerifiedEmpty,
63
+ });
64
+ },
65
+ async paymentStatus(invoiceId, status, detail) {
66
+ await call('print_billing_payment_status', {
67
+ p_stripe_invoice_id: invoiceId, p_payment_status: status, p_detail: detail ?? {},
68
+ });
69
+ },
70
+ async getPeriod(periodId) {
71
+ // SELECT is the one thing service_role does hold on this table (M-08).
72
+ const { data, error } = await supabase
73
+ .from('print_usage_periods')
74
+ .select('id, charge_cents_total, bw_billable, color_pages, period_month, ' +
75
+ 'billing_run_id, billed_run_id, stripe_invoice_item_id, stripe_invoice_id')
76
+ .eq('id', periodId)
77
+ .maybeSingle();
78
+ if (error)
79
+ throw new Error(`getPeriod failed: ${JSON.stringify(error)}`);
80
+ return data ?? null;
81
+ },
82
+ async baseline(membershipId) {
83
+ const data = await call('print_billing_baseline', { p_membership_id: membershipId });
84
+ const row = data && data.length ? data[0] : null;
85
+ return {
86
+ baseline_cents: Number(row?.baseline_cents ?? 0),
87
+ qualifying_periods: Number(row?.qualifying_periods ?? 0),
88
+ };
89
+ },
90
+ async recoverySelect(limit) {
91
+ // v18/B12-2: this MUST go through the wrapper. The bare statement raises
92
+ // 42501 for service_role, because `for update skip locked` needs UPDATE
93
+ // privilege and M-08 grants SELECT only.
94
+ return await call('print_billing_recovery_select', { p_limit: limit });
95
+ },
96
+ async opsEvent(kind, severity, detail, dedupeKey) {
97
+ await supabase.from('ops_events').insert({
98
+ kind, severity, detail, ...(dedupeKey ? { dedupe_key: dedupeKey } : {}),
99
+ });
100
+ },
101
+ };
102
+ }
103
+ /** Narrow the Stripe SDK down to the surface the design touches. The method
104
+ * names differ slightly from the SDK's (finalize / listLines), which is
105
+ * deliberate: the core names what it MEANS, and the mapping lives here. */
106
+ // deno-lint-ignore no-explicit-any
107
+ export function makeStripe(stripe) {
108
+ return {
109
+ account: {
110
+ retrieve: () => stripe.accounts.retrieve(),
111
+ },
112
+ invoices: {
113
+ create: (params, opts) => stripe.invoices.create(params, opts),
114
+ retrieve: (id) => stripe.invoices.retrieve(id),
115
+ list: (params) => stripe.invoices.list(params),
116
+ finalize: (id, params, opts) => stripe.invoices.finalizeInvoice(id, params, opts),
117
+ listLines: (id, params) => stripe.invoices.listLineItems(id, params),
118
+ },
119
+ invoiceItems: {
120
+ create: (params, opts) => stripe.invoiceItems.create(params, opts),
121
+ },
122
+ // STEP 0.4 / C-13 — see resolveDefaultPaymentMethod() in printBilling.ts.
123
+ subscriptions: {
124
+ retrieve: (id) => stripe.subscriptions.retrieve(id),
125
+ },
126
+ customers: {
127
+ retrieve: (id) => stripe.customers.retrieve(id),
128
+ },
129
+ };
130
+ }
@@ -0,0 +1,175 @@
1
+ import type { PrintStripeLike } from './printBilling.js';
2
+ /** Reused so the correction's Idempotency-Key is stable across retries. */
3
+ export declare const creditNoteKey: (correctionId: string) => string;
4
+ export interface InvoicePayment {
5
+ /** Stripe: "The status of the payment, one of `open`, `paid`, or `canceled`." */
6
+ status: "open" | "paid" | "canceled" | string;
7
+ /** Stripe creates a DEFAULT InvoicePayment at finalize, and it is NOT cancellable. */
8
+ is_default?: boolean;
9
+ }
10
+ export interface PaymentIntentLike {
11
+ id?: string;
12
+ status?: string;
13
+ }
14
+ export interface CorrectionInvoice {
15
+ id: string;
16
+ /** draft | open | paid | uncollectible | void */
17
+ status: string;
18
+ payments?: InvoicePayment[];
19
+ payment_intent?: PaymentIntentLike | null;
20
+ amount_remaining?: number;
21
+ }
22
+ export interface CreditNotePreview {
23
+ pre_payment_amount: number;
24
+ post_payment_amount: number;
25
+ }
26
+ /** The extra Stripe surface the ladder needs, beyond printBilling's. */
27
+ export interface CorrectionStripeLike extends PrintStripeLike {
28
+ creditNotes: {
29
+ preview(params: Record<string, unknown>): Promise<CreditNotePreview>;
30
+ create(params: Record<string, unknown>, opts?: {
31
+ idempotencyKey?: string;
32
+ }): Promise<{
33
+ id: string;
34
+ }>;
35
+ };
36
+ refunds: {
37
+ create(params: Record<string, unknown>, opts?: {
38
+ idempotencyKey?: string;
39
+ }): Promise<{
40
+ id: string;
41
+ }>;
42
+ };
43
+ invoicesAdmin: {
44
+ voidInvoice(id: string): Promise<CorrectionInvoice>;
45
+ markUncollectible(id: string): Promise<CorrectionInvoice>;
46
+ del(id: string): Promise<{
47
+ deleted: boolean;
48
+ }>;
49
+ };
50
+ invoiceItemsAdmin: {
51
+ del(id: string): Promise<{
52
+ deleted: boolean;
53
+ }>;
54
+ };
55
+ }
56
+ export type GateName = "VOID_EDIT_GATE" | "UNCOLLECTIBLE_GATE" | "CREDIT_NOTE_GATE";
57
+ export interface GateVerdict {
58
+ blocked: boolean;
59
+ gate: GateName;
60
+ /** Surfaced to staff as `last_error.clears_when` — the two gates clear on
61
+ * DIFFERENT events, which is why the UI must show which one blocked. */
62
+ clearsWhen: string;
63
+ }
64
+ /**
65
+ * Stripe: "When an invoice has `open` or `paid` payments, you can't void or edit
66
+ * the invoice."
67
+ *
68
+ * S10-1: v15 implemented `status == 'open'` and let a `paid` payment sail through.
69
+ * Note the consequence, which is correct rather than unfortunate: once the card
70
+ * succeeds, void is not merely delayed — it is PERMANENTLY foreclosed. You refund
71
+ * a paid invoice, you do not void it.
72
+ */
73
+ export declare function voidEditGate(invoice: CorrectionInvoice): GateVerdict;
74
+ /** Stripe: "When an invoice has `open` payments, you can't mark it uncollectible."
75
+ * The `open`-only asymmetry vs voidEditGate is deliberate: two sentences, two rules. */
76
+ export declare function uncollectibleGate(invoice: CorrectionInvoice): GateVerdict;
77
+ /**
78
+ * Stripe: "Open invoices can't have a credit note with a pending payment_intent."
79
+ *
80
+ * S10-2: this is a DIFFERENT AND NARROWER rule than the void/edit one — scoped to
81
+ * `open` invoices and keyed on the PaymentIntent, not on InvoicePayment status.
82
+ * Applying the void rule here made Rung 3 unreachable for the whole dunning window
83
+ * and made the ladder look far more paralysed than it is. In particular a credit
84
+ * note IS available on a `paid` or `uncollectible` invoice.
85
+ */
86
+ export declare function creditNoteGate(invoice: CorrectionInvoice): GateVerdict;
87
+ export type Rung = "delete_draft_item" | "delete_draft_invoice" | "credit_note_partial" | "credit_note_full" | "void_invoice" | "mark_uncollectible" | "write_off";
88
+ export interface Reachability {
89
+ rung: Rung;
90
+ available: boolean;
91
+ gate?: GateName;
92
+ reason: string;
93
+ }
94
+ /**
95
+ * section 6.2.1's table, encoded. THE ADMIN UI MUST BE BUILT FROM THIS, not from one
96
+ * "blocked" boolean: on a `paid` or `uncollectible` invoice a credit note is
97
+ * available even though void is not.
98
+ *
99
+ * ALWAYS read the invoice's LIVE status first. Never act on the stored status —
100
+ * three rounds running shipped a rung that called an illegal Stripe action on a
101
+ * state that does not accept it.
102
+ */
103
+ export declare function rungReachability(invoice: CorrectionInvoice): Reachability[];
104
+ export interface CreditNoteArgs {
105
+ correctionId: string;
106
+ invoiceId: string;
107
+ /** MUST be the invoice LINE id (il_...), never the invoice ITEM id (ii_...).
108
+ * Round 8's should-fix; it is why M-02 stores two separate columns and why
109
+ * section 4.2 STEP 4.4 resolves the il_ at finalize time. */
110
+ invoiceLineId: string;
111
+ /** POSITIVE cents to credit. For credit_note_full this is exactly the period's
112
+ * billed_amount_cents (M-06's trigger enforces that). */
113
+ amountCents: number;
114
+ periodId: string;
115
+ reason?: "duplicate" | "fraudulent" | "order_change" | "product_unsatisfactory";
116
+ }
117
+ /**
118
+ * Builds the POST /v1/credit_notes body.
119
+ *
120
+ * NOTE WHAT IS ABSENT: `lines[0].quantity`. Not "quantity: 1", not the page count.
121
+ * ABSENT.
122
+ *
123
+ * Stripe, verbatim: "You can't combine discount types on an invoice line item. …
124
+ * If you discount a line item amount, then a future credit note can only discount
125
+ * that line item by amount, not by quantity."
126
+ *
127
+ * Our lines are amount-shaped from birth — section 4.2 STEP 3.3 posts every invoice item
128
+ * with `amount`, never quantity x unit_amount — so the amount form is the ONLY legal
129
+ * one here, on BOTH rungs. v14 sent quantity for a full reversal and amount for a
130
+ * partial, and M-06's CHECKs had encoded that illegal mixing as the schema's
131
+ * PREFERRED representation (v15/B4).
132
+ */
133
+ export declare function buildCreditNoteBody(args: CreditNoteArgs): Record<string, unknown>;
134
+ export interface CreditNoteResult {
135
+ creditNoteId: string;
136
+ refundIds: string[];
137
+ refundedCents: number;
138
+ }
139
+ /**
140
+ * Rung 3/5. On a PAID invoice this always refunds (section 6.5).
141
+ *
142
+ * WHY A REFUND IS MANDATORY THERE: credit notes do NOT auto-refund (C-18). A credit
143
+ * note with no refund parameter creates a CUSTOMER BALANCE CREDIT, which Stripe
144
+ * applies to the member's next invoice — their MEMBERSHIP invoice. That is the exact
145
+ * leak C-10 exists to prevent, arriving by a different door.
146
+ *
147
+ * `credit_amount` MUST NEVER BE USED BY THIS DESIGN, for the same reason.
148
+ */
149
+ export declare function issueCreditNote(stripe: CorrectionStripeLike, invoice: CorrectionInvoice, args: CreditNoteArgs): Promise<CreditNoteResult>;
150
+ export declare function voidInvoice(stripe: CorrectionStripeLike, invoice: CorrectionInvoice): Promise<CorrectionInvoice>;
151
+ export declare function markUncollectible(stripe: CorrectionStripeLike, invoice: CorrectionInvoice): Promise<CorrectionInvoice>;
152
+ export interface WriteOffPlan {
153
+ /** No Stripe call is made for the write-off itself. */
154
+ stripeCalls: ("mark_uncollectible" | "void")[];
155
+ /** True when the correction must be parked rather than recorded `applied`. */
156
+ blocked: boolean;
157
+ gate?: GateName;
158
+ clearsWhen?: string;
159
+ note: string;
160
+ }
161
+ /**
162
+ * Rung 7. No Stripe call for the write-off itself — but if a real invoice exists
163
+ * and is still `open`, prefer mark_uncollectible then void, because a write-off that
164
+ * leaves an `open` invoice sitting in Stripe WILL KEEP DUNNING THE MEMBER.
165
+ *
166
+ * The two calls are gated by two DIFFERENT rules and the sequence matters.
167
+ *
168
+ * DO NOT RECORD THE WRITE-OFF AS `applied` WHILE THE STRIPE SIDE IS STILL OPEN —
169
+ * that is precisely the drift section 6.6 exists to catch.
170
+ */
171
+ export declare function planWriteOff(invoice: CorrectionInvoice | null): WriteOffPlan;
172
+ /** Rung 1. C-18, R8-verified: DELETE works on DRAFTS ONLY. */
173
+ export declare function deleteDraftItem(stripe: CorrectionStripeLike, invoice: CorrectionInvoice, invoiceItemId: string): Promise<void>;
174
+ /** Rung 2. */
175
+ export declare function deleteDraftInvoice(stripe: CorrectionStripeLike, invoice: CorrectionInvoice): Promise<void>;
@@ -0,0 +1,328 @@
1
+ // print-usage-bill P2 — the correction ladder.
2
+ // Design: PRINT-USAGE-BILL-DESIGN.md v19 section 6.
3
+ //
4
+ // ###########################################################################
5
+ // ### section 6 IS THE LEAST-TRUSTWORTHY SECTION OF THE DESIGN. ###
6
+ // ### Its call shapes are DOCUMENTATION-VERIFIED, NOT EXECUTION-VERIFIED. ###
7
+ // ### ###
8
+ // ### Kyle's Stripe account is live-only — there is no test mode — so no ###
9
+ // ### round has ever issued a real credit note against a real invoice. ###
10
+ // ### T-08 is GATED. NOTHING IN THIS FILE MAY BE RUN AGAINST LIVE STRIPE ###
11
+ // ### WITHOUT KYLE'S EXPLICIT GO-AHEAD. The first real credit note is a ###
12
+ // ### supervised event (section 11 step 8). ###
13
+ // ### ###
14
+ // ### Like printBilling.ts this module IMPORTS NOTHING and makes no ###
15
+ // ### network call of its own: Stripe arrives injected, so the whole ###
16
+ // ### ladder is exercisable against a stub. ###
17
+ // ###########################################################################
18
+ /** Reused so the correction's Idempotency-Key is stable across retries. */
19
+ export const creditNoteKey = (correctionId) => `gc-p2-cn-${correctionId}`;
20
+ /**
21
+ * Stripe: "When an invoice has `open` or `paid` payments, you can't void or edit
22
+ * the invoice."
23
+ *
24
+ * S10-1: v15 implemented `status == 'open'` and let a `paid` payment sail through.
25
+ * Note the consequence, which is correct rather than unfortunate: once the card
26
+ * succeeds, void is not merely delayed — it is PERMANENTLY foreclosed. You refund
27
+ * a paid invoice, you do not void it.
28
+ */
29
+ export function voidEditGate(invoice) {
30
+ const blocked = (invoice.payments ?? []).some((p) => p.status === "open" || p.status === "paid");
31
+ return {
32
+ blocked,
33
+ gate: "VOID_EDIT_GATE",
34
+ clearsWhen: "the invoice's payments are all canceled. Stripe cancels the default payment " +
35
+ "when dunning is exhausted. A PAID payment never clears this — refund instead.",
36
+ };
37
+ }
38
+ /** Stripe: "When an invoice has `open` payments, you can't mark it uncollectible."
39
+ * The `open`-only asymmetry vs voidEditGate is deliberate: two sentences, two rules. */
40
+ export function uncollectibleGate(invoice) {
41
+ const blocked = (invoice.payments ?? []).some((p) => p.status === "open");
42
+ return {
43
+ blocked,
44
+ gate: "UNCOLLECTIBLE_GATE",
45
+ clearsWhen: "the invoice has no `open` payments (dunning exhausted, or the card settled).",
46
+ };
47
+ }
48
+ /**
49
+ * Stripe: "Open invoices can't have a credit note with a pending payment_intent."
50
+ *
51
+ * S10-2: this is a DIFFERENT AND NARROWER rule than the void/edit one — scoped to
52
+ * `open` invoices and keyed on the PaymentIntent, not on InvoicePayment status.
53
+ * Applying the void rule here made Rung 3 unreachable for the whole dunning window
54
+ * and made the ladder look far more paralysed than it is. In particular a credit
55
+ * note IS available on a `paid` or `uncollectible` invoice.
56
+ */
57
+ export function creditNoteGate(invoice) {
58
+ const verdict = (blocked) => ({
59
+ blocked,
60
+ gate: "CREDIT_NOTE_GATE",
61
+ clearsWhen: "the invoice leaves `open`, or its PaymentIntent reaches `succeeded` or `canceled`.",
62
+ });
63
+ if (invoice.status !== "open")
64
+ return verdict(false);
65
+ if (!invoice.payment_intent)
66
+ return verdict(false);
67
+ const st = invoice.payment_intent.status;
68
+ if (st === "succeeded" || st === "canceled")
69
+ return verdict(false);
70
+ // Fail-closed on anything still pending (R-19).
71
+ return verdict(true);
72
+ }
73
+ /**
74
+ * section 6.2.1's table, encoded. THE ADMIN UI MUST BE BUILT FROM THIS, not from one
75
+ * "blocked" boolean: on a `paid` or `uncollectible` invoice a credit note is
76
+ * available even though void is not.
77
+ *
78
+ * ALWAYS read the invoice's LIVE status first. Never act on the stored status —
79
+ * three rounds running shipped a rung that called an illegal Stripe action on a
80
+ * state that does not accept it.
81
+ */
82
+ export function rungReachability(invoice) {
83
+ const ve = voidEditGate(invoice);
84
+ const un = uncollectibleGate(invoice);
85
+ const cn = creditNoteGate(invoice);
86
+ const isDraft = invoice.status === "draft";
87
+ const isVoid = invoice.status === "void";
88
+ const isPaid = invoice.status === "paid";
89
+ return [
90
+ {
91
+ rung: "delete_draft_item",
92
+ available: isDraft,
93
+ reason: isDraft ? "Draft invoice — delete the item." : "Only on a draft invoice (C-18: DELETE works on drafts only).",
94
+ },
95
+ {
96
+ rung: "delete_draft_invoice",
97
+ available: isDraft,
98
+ reason: isDraft ? "Draft invoice — delete the whole draft." : "Only on a draft invoice.",
99
+ },
100
+ {
101
+ rung: "credit_note_partial",
102
+ available: !isDraft && !isVoid && !cn.blocked,
103
+ gate: "CREDIT_NOTE_GATE",
104
+ reason: isDraft
105
+ ? "Use the draft rungs instead."
106
+ : isVoid
107
+ ? "The invoice is void — nothing to credit."
108
+ : cn.blocked
109
+ ? `Blocked by CREDIT_NOTE_GATE: ${cn.clearsWhen}`
110
+ : "Available.",
111
+ },
112
+ {
113
+ rung: "credit_note_full",
114
+ available: !isDraft && !isVoid && !cn.blocked,
115
+ gate: "CREDIT_NOTE_GATE",
116
+ reason: cn.blocked ? `Blocked by CREDIT_NOTE_GATE: ${cn.clearsWhen}` : "Available.",
117
+ },
118
+ {
119
+ rung: "void_invoice",
120
+ available: !isDraft && !isVoid && !ve.blocked,
121
+ gate: "VOID_EDIT_GATE",
122
+ reason: ve.blocked
123
+ ? isPaid
124
+ ? "PERMANENTLY blocked: this invoice has a paid payment. Refund it (credit note with refund_amount); do not void it."
125
+ : `Blocked by VOID_EDIT_GATE: ${ve.clearsWhen}`
126
+ : "Available.",
127
+ },
128
+ {
129
+ rung: "mark_uncollectible",
130
+ available: !isDraft && !isVoid && !isPaid && !un.blocked,
131
+ gate: "UNCOLLECTIBLE_GATE",
132
+ reason: isPaid
133
+ ? "The invoice is paid — there is nothing to mark uncollectible."
134
+ : un.blocked
135
+ ? `Blocked by UNCOLLECTIBLE_GATE: ${un.clearsWhen}`
136
+ : "Available.",
137
+ },
138
+ {
139
+ rung: "write_off",
140
+ // THE ADMIN UI MUST NOT OFFER "write off" AS A WAY OUT OF A PAID INVOICE.
141
+ // If the card succeeded, the money was collected and the correct instrument
142
+ // is a credit note WITH a refund.
143
+ available: !isPaid,
144
+ reason: isPaid
145
+ ? "The money was collected. Use a credit note with a refund, not a write-off."
146
+ : "Available (no Stripe call; records the decision not to pursue).",
147
+ },
148
+ ];
149
+ }
150
+ /**
151
+ * Builds the POST /v1/credit_notes body.
152
+ *
153
+ * NOTE WHAT IS ABSENT: `lines[0].quantity`. Not "quantity: 1", not the page count.
154
+ * ABSENT.
155
+ *
156
+ * Stripe, verbatim: "You can't combine discount types on an invoice line item. …
157
+ * If you discount a line item amount, then a future credit note can only discount
158
+ * that line item by amount, not by quantity."
159
+ *
160
+ * Our lines are amount-shaped from birth — section 4.2 STEP 3.3 posts every invoice item
161
+ * with `amount`, never quantity x unit_amount — so the amount form is the ONLY legal
162
+ * one here, on BOTH rungs. v14 sent quantity for a full reversal and amount for a
163
+ * partial, and M-06's CHECKs had encoded that illegal mixing as the schema's
164
+ * PREFERRED representation (v15/B4).
165
+ */
166
+ export function buildCreditNoteBody(args) {
167
+ if (args.amountCents <= 0) {
168
+ throw new Error(`credit note amount must be positive cents, got ${args.amountCents}`);
169
+ }
170
+ if (!args.invoiceLineId.startsWith("il_")) {
171
+ // ii_ is an invoice ITEM; a credit note needs the invoice LINE. Conflating the
172
+ // two Stripe object types was a round-8 defect.
173
+ throw new Error(`credit note needs an invoice LINE id (il_...), got "${args.invoiceLineId}"`);
174
+ }
175
+ return {
176
+ invoice: args.invoiceId,
177
+ ...(args.reason ? { reason: args.reason } : {}),
178
+ lines: [{
179
+ type: "invoice_line_item",
180
+ invoice_line_item: args.invoiceLineId,
181
+ amount: args.amountCents,
182
+ }],
183
+ metadata: {
184
+ gc_period_id: args.periodId,
185
+ gc_correction_id: args.correctionId,
186
+ },
187
+ };
188
+ }
189
+ /**
190
+ * Rung 3/5. On a PAID invoice this always refunds (section 6.5).
191
+ *
192
+ * WHY A REFUND IS MANDATORY THERE: credit notes do NOT auto-refund (C-18). A credit
193
+ * note with no refund parameter creates a CUSTOMER BALANCE CREDIT, which Stripe
194
+ * applies to the member's next invoice — their MEMBERSHIP invoice. That is the exact
195
+ * leak C-10 exists to prevent, arriving by a different door.
196
+ *
197
+ * `credit_amount` MUST NEVER BE USED BY THIS DESIGN, for the same reason.
198
+ */
199
+ export async function issueCreditNote(stripe, invoice, args) {
200
+ const gate = creditNoteGate(invoice);
201
+ if (gate.blocked) {
202
+ const e = new Error(`credit note blocked by ${gate.gate}: ${gate.clearsWhen}`);
203
+ e.gate = gate.gate;
204
+ e.clearsWhen = gate.clearsWhen;
205
+ throw e;
206
+ }
207
+ const body = buildCreditNoteBody(args);
208
+ const needsRefund = invoice.status === "paid";
209
+ if (!needsRefund) {
210
+ const cn = await stripe.creditNotes.create(body, { idempotencyKey: creditNoteKey(args.correctionId) });
211
+ return { creditNoteId: cn.id, refundIds: [], refundedCents: 0 };
212
+ }
213
+ // section 6.5 rule 2: refund_amount must equal POST_PAYMENT_AMOUNT, not the line
214
+ // amount. Stripe applies a credit note to amount_remaining first
215
+ // (pre_payment_amount) and only the excess is refundable (post_payment_amount).
216
+ // On a fully paid invoice these coincide; on a PARTIALLY paid one they do not,
217
+ // and passing the line amount will fail or over-refund.
218
+ // The preview endpoint is a READ, so it is safe and is NOT part of the T-08 gate.
219
+ const preview = await stripe.creditNotes.preview(body);
220
+ const refundCents = preview.post_payment_amount;
221
+ try {
222
+ const cn = await stripe.creditNotes.create({ ...body, refund_amount: refundCents }, { idempotencyKey: creditNoteKey(args.correctionId) });
223
+ return { creditNoteId: cn.id, refundIds: [], refundedCents: refundCents };
224
+ }
225
+ catch (err) {
226
+ // section 6.5 rule 3, the documented fallback. Verbatim: "When you create a credit
227
+ // note with a refund_amount, Stripe attempts to refund the invoice's most recent
228
+ // payment. If you already issued a refund for that payment, or the refund amount
229
+ // exceeds the payment amount, the refund fails. To create a credit note in this
230
+ // situation, create the refunds separately and link them to the credit note using
231
+ // the `refunds` parameter."
232
+ if (refundCents <= 0)
233
+ throw err;
234
+ const refund = await stripe.refunds.create({ charge: undefined, payment_intent: invoice.payment_intent?.id, amount: refundCents }, { idempotencyKey: `${creditNoteKey(args.correctionId)}-refund` });
235
+ const cn = await stripe.creditNotes.create({ ...body, refunds: [{ refund: refund.id, amount_refunded: refundCents }] }, { idempotencyKey: `${creditNoteKey(args.correctionId)}-linked` });
236
+ return { creditNoteId: cn.id, refundIds: [refund.id], refundedCents: refundCents };
237
+ }
238
+ }
239
+ // --------------------------------------------------- void / uncollectible --
240
+ export async function voidInvoice(stripe, invoice) {
241
+ const gate = voidEditGate(invoice);
242
+ if (gate.blocked) {
243
+ const e = new Error(`void blocked by ${gate.gate}: ${gate.clearsWhen}`);
244
+ e.gate = gate.gate;
245
+ e.clearsWhen = gate.clearsWhen;
246
+ throw e;
247
+ }
248
+ return await stripe.invoicesAdmin.voidInvoice(invoice.id);
249
+ }
250
+ export async function markUncollectible(stripe, invoice) {
251
+ const gate = uncollectibleGate(invoice);
252
+ if (gate.blocked) {
253
+ const e = new Error(`mark_uncollectible blocked by ${gate.gate}: ${gate.clearsWhen}`);
254
+ e.gate = gate.gate;
255
+ e.clearsWhen = gate.clearsWhen;
256
+ throw e;
257
+ }
258
+ return await stripe.invoicesAdmin.markUncollectible(invoice.id);
259
+ }
260
+ /**
261
+ * Rung 7. No Stripe call for the write-off itself — but if a real invoice exists
262
+ * and is still `open`, prefer mark_uncollectible then void, because a write-off that
263
+ * leaves an `open` invoice sitting in Stripe WILL KEEP DUNNING THE MEMBER.
264
+ *
265
+ * The two calls are gated by two DIFFERENT rules and the sequence matters.
266
+ *
267
+ * DO NOT RECORD THE WRITE-OFF AS `applied` WHILE THE STRIPE SIDE IS STILL OPEN —
268
+ * that is precisely the drift section 6.6 exists to catch.
269
+ */
270
+ export function planWriteOff(invoice) {
271
+ if (!invoice || invoice.status === "void") {
272
+ return { stripeCalls: [], blocked: false, note: "No live Stripe invoice; DB-only write-off." };
273
+ }
274
+ if (invoice.status === "paid") {
275
+ return {
276
+ stripeCalls: [],
277
+ blocked: true,
278
+ note: "The money was collected. A write-off is the wrong instrument — use a credit " +
279
+ "note WITH a refund (Rung 5). Void is permanently foreclosed by a paid payment.",
280
+ };
281
+ }
282
+ if (invoice.status === "uncollectible") {
283
+ const ve = voidEditGate(invoice);
284
+ return {
285
+ stripeCalls: ve.blocked ? [] : ["void"],
286
+ blocked: ve.blocked,
287
+ gate: ve.blocked ? ve.gate : undefined,
288
+ clearsWhen: ve.blocked ? ve.clearsWhen : undefined,
289
+ note: "Already uncollectible; void it once the payments clear.",
290
+ };
291
+ }
292
+ const un = uncollectibleGate(invoice);
293
+ if (un.blocked) {
294
+ return {
295
+ stripeCalls: [],
296
+ blocked: true,
297
+ gate: un.gate,
298
+ clearsWhen: un.clearsWhen,
299
+ note: "The invoice is actively dunning. This correction parks at " +
300
+ "blocked_pending_payment until the payment settles or is canceled.",
301
+ };
302
+ }
303
+ const ve = voidEditGate(invoice);
304
+ return {
305
+ stripeCalls: ve.blocked ? ["mark_uncollectible"] : ["mark_uncollectible", "void"],
306
+ blocked: false,
307
+ gate: ve.blocked ? ve.gate : undefined,
308
+ clearsWhen: ve.blocked ? ve.clearsWhen : undefined,
309
+ note: ve.blocked
310
+ ? "Mark uncollectible now; void remains blocked while a payment is open or paid."
311
+ : "Mark uncollectible, then void.",
312
+ };
313
+ }
314
+ // --------------------------------------------------------- draft rungs ----
315
+ /** Rung 1. C-18, R8-verified: DELETE works on DRAFTS ONLY. */
316
+ export async function deleteDraftItem(stripe, invoice, invoiceItemId) {
317
+ if (invoice.status !== "draft") {
318
+ throw new Error(`delete_draft_item requires a draft invoice; this one is "${invoice.status}"`);
319
+ }
320
+ await stripe.invoiceItemsAdmin.del(invoiceItemId);
321
+ }
322
+ /** Rung 2. */
323
+ export async function deleteDraftInvoice(stripe, invoice) {
324
+ if (invoice.status !== "draft") {
325
+ throw new Error(`delete_draft_invoice requires a draft invoice; this one is "${invoice.status}"`);
326
+ }
327
+ await stripe.invoicesAdmin.del(invoice.id);
328
+ }
@@ -0,0 +1,20 @@
1
+ import type { SupabaseClient } from '@supabase/supabase-js';
2
+ type SupabaseLike = SupabaseClient<any, any, any>;
3
+ /**
4
+ * Retell AI's fixed outbound IP (docs.retellai.com). Exempt from the voice
5
+ * agent's own IP buckets only — see RETELL_EXEMPT_BUCKETS.
6
+ */
7
+ export declare const RETELL_ALLOWLISTED_IP = "100.20.5.228";
8
+ /**
9
+ * The only buckets the Retell IP exemption applies to. Scoped deliberately:
10
+ * `x-forwarded-for` is client-supplied, so a bare identifier match would let
11
+ * anyone spoofing this IP bypass rate limiting in every other edge function
12
+ * that keys on clientIp(). Not included: public-facts' per-(room,date)
13
+ * enumeration bucket, and every non-voice caller.
14
+ */
15
+ export declare const RETELL_EXEMPT_BUCKETS: Set<string>;
16
+ export declare function clientIp(req: Request): string;
17
+ export declare function checkRateLimit(supabase: SupabaseLike, bucket: string, identifier: string, max: number, windowSeconds: number, opts?: {
18
+ failClosed?: boolean;
19
+ }): Promise<boolean>;
20
+ export {};