@simplelayer/graniteer-core 0.2.2 → 0.3.0

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 (479) 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 +32 -0
  24. package/dist/checkoutSessionParams.js +72 -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/entitlements.d.ts +17 -0
  52. package/dist/entitlements.js +33 -0
  53. package/dist/functions/admin-cancel-membership.d.ts +3 -0
  54. package/dist/functions/admin-cancel-membership.js +294 -0
  55. package/dist/functions/admin-change-membership-plan.d.ts +3 -0
  56. package/dist/functions/admin-change-membership-plan.js +289 -0
  57. package/dist/functions/admin-charge-guest-print.d.ts +1 -0
  58. package/dist/functions/admin-charge-guest-print.js +227 -0
  59. package/dist/functions/admin-correct-booking.d.ts +1 -0
  60. package/dist/functions/admin-correct-booking.js +326 -0
  61. package/dist/functions/admin-create-booking.d.ts +43 -0
  62. package/dist/functions/admin-create-booking.js +410 -0
  63. package/dist/functions/admin-create-commons-event.d.ts +1 -0
  64. package/dist/functions/admin-create-commons-event.js +237 -0
  65. package/dist/functions/admin-debug-boldsign-doc.d.ts +1 -0
  66. package/dist/functions/admin-debug-boldsign-doc.js +110 -0
  67. package/dist/functions/admin-door-write.d.ts +1 -0
  68. package/dist/functions/admin-door-write.js +267 -0
  69. package/dist/functions/admin-issue-day-pass.d.ts +14 -0
  70. package/dist/functions/admin-issue-day-pass.js +213 -0
  71. package/dist/functions/admin-mark-booking-paid.d.ts +1 -0
  72. package/dist/functions/admin-mark-booking-paid.js +202 -0
  73. package/dist/functions/admin-mint-billing-portal-link.d.ts +6 -0
  74. package/dist/functions/admin-mint-billing-portal-link.js +159 -0
  75. package/dist/functions/admin-mint-portal-link.d.ts +3 -0
  76. package/dist/functions/admin-mint-portal-link.js +54 -0
  77. package/dist/functions/admin-onboard-connect-account.d.ts +47 -0
  78. package/dist/functions/admin-onboard-connect-account.js +197 -0
  79. package/dist/functions/admin-photo-upload.d.ts +1 -0
  80. package/dist/functions/admin-photo-upload.js +104 -0
  81. package/dist/functions/admin-remove-team-member.d.ts +1 -0
  82. package/dist/functions/admin-remove-team-member.js +140 -0
  83. package/dist/functions/admin-request-trial.d.ts +5 -0
  84. package/dist/functions/admin-request-trial.js +349 -0
  85. package/dist/functions/admin-resend-commons-deposit-link.d.ts +7 -0
  86. package/dist/functions/admin-resend-commons-deposit-link.js +298 -0
  87. package/dist/functions/admin-reset-mfa.d.ts +1 -0
  88. package/dist/functions/admin-reset-mfa.js +129 -0
  89. package/dist/functions/admin-retry-invoice-payment.d.ts +76 -0
  90. package/dist/functions/admin-retry-invoice-payment.js +269 -0
  91. package/dist/functions/admin-reverse-coupon-redemption.d.ts +1 -0
  92. package/dist/functions/admin-reverse-coupon-redemption.js +91 -0
  93. package/dist/functions/admin-revoke-agreement.d.ts +4 -0
  94. package/dist/functions/admin-revoke-agreement.js +410 -0
  95. package/dist/functions/admin-send-commons-agreement.d.ts +1 -0
  96. package/dist/functions/admin-send-commons-agreement.js +212 -0
  97. package/dist/functions/admin-set-credit-amount.d.ts +1 -0
  98. package/dist/functions/admin-set-credit-amount.js +112 -0
  99. package/dist/functions/admin-skip-commons-contract.d.ts +1 -0
  100. package/dist/functions/admin-skip-commons-contract.js +170 -0
  101. package/dist/functions/admin-undo-membership-cancel.d.ts +3 -0
  102. package/dist/functions/admin-undo-membership-cancel.js +143 -0
  103. package/dist/functions/admin-wall-photo-write.d.ts +1 -0
  104. package/dist/functions/admin-wall-photo-write.js +137 -0
  105. package/dist/functions/auth-email-hook.d.ts +20 -0
  106. package/dist/functions/auth-email-hook.js +209 -0
  107. package/dist/functions/boldsign-sender-identity.d.ts +1 -0
  108. package/dist/functions/boldsign-sender-identity.js +109 -0
  109. package/dist/functions/booking-availability.d.ts +1 -0
  110. package/dist/functions/booking-availability.js +355 -0
  111. package/dist/functions/booking-member-preview.d.ts +1 -0
  112. package/dist/functions/booking-member-preview.js +123 -0
  113. package/dist/functions/booking-status.d.ts +3 -0
  114. package/dist/functions/booking-status.js +139 -0
  115. package/dist/functions/conductor.d.ts +3 -0
  116. package/dist/functions/conductor.js +451 -0
  117. package/dist/functions/create-agreement.d.ts +8 -0
  118. package/dist/functions/create-agreement.js +498 -0
  119. package/dist/functions/create-booking.d.ts +44 -0
  120. package/dist/functions/create-booking.js +538 -0
  121. package/dist/functions/create-day-pass-checkout.d.ts +6 -0
  122. package/dist/functions/create-day-pass-checkout.js +225 -0
  123. package/dist/functions/create-portal-session.d.ts +4 -0
  124. package/dist/functions/create-portal-session.js +127 -0
  125. package/dist/functions/create-subscription-checkout.d.ts +7 -0
  126. package/dist/functions/create-subscription-checkout.js +405 -0
  127. package/dist/functions/day-pass-status.d.ts +1 -0
  128. package/dist/functions/day-pass-status.js +70 -0
  129. package/dist/functions/dayStatus.d.ts +15 -0
  130. package/dist/functions/dayStatus.js +59 -0
  131. package/dist/functions/diag-webpush-test.d.ts +1 -0
  132. package/dist/functions/diag-webpush-test.js +42 -0
  133. package/dist/functions/event-access-admin.d.ts +17 -0
  134. package/dist/functions/event-access-admin.js +262 -0
  135. package/dist/functions/event-access-store.d.ts +1 -0
  136. package/dist/functions/event-access-store.js +343 -0
  137. package/dist/functions/ezeep-print-webhook.d.ts +1 -0
  138. package/dist/functions/ezeep-print-webhook.js +160 -0
  139. package/dist/functions/ezeep-usage-reconcile.d.ts +1 -0
  140. package/dist/functions/ezeep-usage-reconcile.js +305 -0
  141. package/dist/functions/fetch-avatar-original.d.ts +3 -0
  142. package/dist/functions/fetch-avatar-original.js +423 -0
  143. package/dist/functions/get-provider-sign-link.d.ts +3 -0
  144. package/dist/functions/get-provider-sign-link.js +146 -0
  145. package/dist/functions/get-signing-link.d.ts +1 -0
  146. package/dist/functions/get-signing-link.js +192 -0
  147. package/dist/functions/guest-print-setup-confirm.d.ts +1 -0
  148. package/dist/functions/guest-print-setup-confirm.js +126 -0
  149. package/dist/functions/guest-print-submit.d.ts +1 -0
  150. package/dist/functions/guest-print-submit.js +145 -0
  151. package/dist/functions/luma-webhook.d.ts +1 -0
  152. package/dist/functions/luma-webhook.js +123 -0
  153. package/dist/functions/manage-booking.d.ts +75 -0
  154. package/dist/functions/manage-booking.js +409 -0
  155. package/dist/functions/mcp.d.ts +16 -0
  156. package/dist/functions/mcp.js +51 -0
  157. package/dist/functions/member-door-action.d.ts +60 -0
  158. package/dist/functions/member-door-action.js +774 -0
  159. package/dist/functions/member-unifi-mapping.d.ts +15 -0
  160. package/dist/functions/member-unifi-mapping.js +198 -0
  161. package/dist/functions/membership-door-sync.d.ts +14 -0
  162. package/dist/functions/membership-door-sync.js +863 -0
  163. package/dist/functions/migration-collision-alert.copy.d.ts +7 -0
  164. package/dist/functions/migration-collision-alert.copy.js +207 -0
  165. package/dist/functions/migration-collision-alert.d.ts +7 -0
  166. package/dist/functions/migration-collision-alert.js +207 -0
  167. package/dist/functions/office-assignment-end.d.ts +12 -0
  168. package/dist/functions/office-assignment-end.js +140 -0
  169. package/dist/functions/portal-booking-access.d.ts +22 -0
  170. package/dist/functions/portal-booking-access.js +163 -0
  171. package/dist/functions/portal-list-invoices.d.ts +1 -0
  172. package/dist/functions/portal-list-invoices.js +90 -0
  173. package/dist/functions/portal-request-login.d.ts +7 -0
  174. package/dist/functions/portal-request-login.js +199 -0
  175. package/dist/functions/portal-resend-invite.d.ts +6 -0
  176. package/dist/functions/portal-resend-invite.js +225 -0
  177. package/dist/functions/portal-submit-event.d.ts +4 -0
  178. package/dist/functions/portal-submit-event.js +152 -0
  179. package/dist/functions/print-billing-recover.d.ts +1 -0
  180. package/dist/functions/print-billing-recover.js +83 -0
  181. package/dist/functions/print-billing-run.d.ts +1 -0
  182. package/dist/functions/print-billing-run.js +153 -0
  183. package/dist/functions/public-facts.d.ts +1 -0
  184. package/dist/functions/public-facts.js +141 -0
  185. package/dist/functions/push-send.d.ts +3 -0
  186. package/dist/functions/push-send.js +297 -0
  187. package/dist/functions/push-test.d.ts +3 -0
  188. package/dist/functions/push-test.js +215 -0
  189. package/dist/functions/request-portal-link.d.ts +7 -0
  190. package/dist/functions/request-portal-link.js +178 -0
  191. package/dist/functions/reschedule-booking.d.ts +50 -0
  192. package/dist/functions/reschedule-booking.js +571 -0
  193. package/dist/functions/review-ratings.d.ts +1 -0
  194. package/dist/functions/review-ratings.js +95 -0
  195. package/dist/functions/space-availability-range.d.ts +1 -0
  196. package/dist/functions/space-availability-range.js +109 -0
  197. package/dist/functions/stripe-db-reconcile.d.ts +7 -0
  198. package/dist/functions/stripe-db-reconcile.js +326 -0
  199. package/dist/functions/stripe-webhook.d.ts +46 -0
  200. package/dist/functions/stripe-webhook.js +2381 -0
  201. package/dist/functions/sync-gcal-blackouts.d.ts +1 -0
  202. package/dist/functions/sync-gcal-blackouts.js +251 -0
  203. package/dist/functions/timetable-event-register.d.ts +1 -0
  204. package/dist/functions/timetable-event-register.js +155 -0
  205. package/dist/functions/timetable-event-status.d.ts +1 -0
  206. package/dist/functions/timetable-event-status.js +86 -0
  207. package/dist/functions/timetable-spaces.d.ts +1 -0
  208. package/dist/functions/timetable-spaces.js +161 -0
  209. package/dist/functions/touch-pass-reconciler.d.ts +1 -0
  210. package/dist/functions/touch-pass-reconciler.js +688 -0
  211. package/dist/functions/touch-pass-signup.d.ts +1 -0
  212. package/dist/functions/touch-pass-signup.js +447 -0
  213. package/dist/functions/upload-booking-display-image.d.ts +4 -0
  214. package/dist/functions/upload-booking-display-image.js +159 -0
  215. package/dist/functions/virtual-onboarding-purge.d.ts +1 -0
  216. package/dist/functions/virtual-onboarding-purge.js +123 -0
  217. package/dist/functions/virtual-onboarding-submit.d.ts +1 -0
  218. package/dist/functions/virtual-onboarding-submit.js +303 -0
  219. package/dist/functions/voice-booking.d.ts +10 -0
  220. package/dist/functions/voice-booking.js +360 -0
  221. package/dist/functions/voice-day-pass.d.ts +15 -0
  222. package/dist/functions/voice-day-pass.js +269 -0
  223. package/dist/functions/voice-inquiry.d.ts +1 -0
  224. package/dist/functions/voice-inquiry.js +156 -0
  225. package/dist/functions/voice-membership-signup.d.ts +16 -0
  226. package/dist/functions/voice-membership-signup.js +277 -0
  227. package/dist/functions/voice-tour-availability.d.ts +1 -0
  228. package/dist/functions/voice-tour-availability.js +179 -0
  229. package/dist/functions/voice-tour-booking.d.ts +21 -0
  230. package/dist/functions/voice-tour-booking.js +308 -0
  231. package/dist/gcalSync.d.ts +29 -0
  232. package/dist/gcalSync.js +119 -0
  233. package/dist/ghlEventInquiry.d.ts +16 -0
  234. package/dist/ghlEventInquiry.js +116 -0
  235. package/dist/ghlNote.d.ts +5 -0
  236. package/dist/ghlNote.js +29 -0
  237. package/dist/ghlTask.d.ts +7 -0
  238. package/dist/ghlTask.js +39 -0
  239. package/dist/ghlVoiceInquiry.d.ts +26 -0
  240. package/dist/ghlVoiceInquiry.js +68 -0
  241. package/dist/guestPrintCapture.d.ts +217 -0
  242. package/dist/guestPrintCapture.js +362 -0
  243. package/dist/index.d.ts +3 -0
  244. package/{index.js → dist/index.js} +3 -2
  245. package/dist/lumaGhl.d.ts +19 -0
  246. package/dist/lumaGhl.js +147 -0
  247. package/dist/mailArrivalEmail.d.ts +15 -0
  248. package/dist/mailArrivalEmail.js +99 -0
  249. package/dist/manageToken.d.ts +64 -0
  250. package/dist/manageToken.js +261 -0
  251. package/dist/membership.d.ts +20 -0
  252. package/dist/membership.js +87 -0
  253. package/dist/membershipBusClient.d.ts +139 -0
  254. package/dist/membershipBusClient.js +443 -0
  255. package/dist/membershipWelcome.d.ts +117 -0
  256. package/dist/membershipWelcome.js +497 -0
  257. package/dist/migrationCheckout.d.ts +169 -0
  258. package/dist/migrationCheckout.js +250 -0
  259. package/dist/money.d.ts +20 -0
  260. package/dist/money.js +35 -0
  261. package/dist/ops.d.ts +27 -0
  262. package/dist/ops.js +87 -0
  263. package/dist/pacificDate.d.ts +8 -0
  264. package/{src/pacificDate.ts → dist/pacificDate.js} +76 -88
  265. package/dist/paymentLinkEmail.d.ts +15 -0
  266. package/dist/paymentLinkEmail.js +102 -0
  267. package/dist/policyAcknowledgment.d.ts +46 -0
  268. package/dist/policyAcknowledgment.js +58 -0
  269. package/dist/portalSession.d.ts +15 -0
  270. package/dist/portalSession.js +31 -0
  271. package/dist/pricing.d.ts +306 -0
  272. package/dist/pricing.js +788 -0
  273. package/dist/printBilling.d.ts +340 -0
  274. package/dist/printBilling.js +619 -0
  275. package/dist/printBillingAdapters.d.ts +29 -0
  276. package/dist/printBillingAdapters.js +130 -0
  277. package/dist/printCorrections.d.ts +175 -0
  278. package/dist/printCorrections.js +328 -0
  279. package/dist/rateLimit.d.ts +20 -0
  280. package/dist/rateLimit.js +70 -0
  281. package/dist/referralCredits.d.ts +5 -0
  282. package/{src/referralCredits.ts → dist/referralCredits.js} +27 -34
  283. package/dist/referralGrant.d.ts +49 -0
  284. package/dist/referralGrant.js +268 -0
  285. package/dist/rescheduleCredit.d.ts +98 -0
  286. package/dist/rescheduleCredit.js +263 -0
  287. package/dist/reservationWifiCode.d.ts +19 -0
  288. package/{src/reservationWifiCode.ts → dist/reservationWifiCode.js} +67 -81
  289. package/dist/retellCallAnalyzed.d.ts +18 -0
  290. package/dist/retellCallAnalyzed.js +91 -0
  291. package/dist/retellSignature.d.ts +14 -0
  292. package/dist/retellSignature.js +60 -0
  293. package/dist/signedUnpaidReminderEmail.d.ts +15 -0
  294. package/dist/signedUnpaidReminderEmail.js +111 -0
  295. package/dist/slackAlert.d.ts +13 -0
  296. package/dist/slackAlert.js +37 -0
  297. package/dist/stripeCoworkingPortal.d.ts +21 -0
  298. package/dist/stripeCoworkingPortal.js +80 -0
  299. package/dist/supabaseTestFakes.d.ts +67 -0
  300. package/dist/supabaseTestFakes.js +79 -0
  301. package/dist/supportTicketEmail.d.ts +16 -0
  302. package/dist/supportTicketEmail.js +98 -0
  303. package/dist/tier1Agreement.d.ts +51 -0
  304. package/dist/tier1Agreement.js +86 -0
  305. package/dist/unifiAccessPolicies.d.ts +36 -0
  306. package/dist/unifiAccessPolicies.js +185 -0
  307. package/dist/unifiGroups.d.ts +26 -0
  308. package/dist/unifiGroups.js +106 -0
  309. package/package.json +653 -169
  310. package/src/adminBookingCredit.test.ts +0 -451
  311. package/src/adminBookingCredit.ts +0 -239
  312. package/src/agreementCheckout.ts +0 -250
  313. package/src/agreementPortalEmail.ts +0 -128
  314. package/src/availability.test.ts +0 -25
  315. package/src/availability.ts +0 -201
  316. package/src/billingPortalLinkEmail.ts +0 -117
  317. package/src/bookingAgreementEmail.ts +0 -149
  318. package/src/bookingEffects.ts +0 -388
  319. package/src/bookingHoldReclaim.ts +0 -94
  320. package/src/busClient.ts +0 -268
  321. package/src/checkoutCoupon.test.ts +0 -675
  322. package/src/checkoutCoupon.ts +0 -455
  323. package/src/checkoutSessionParams.ts +0 -56
  324. package/src/commonsContract.ts +0 -175
  325. package/src/commonsDeposit.ts +0 -298
  326. package/src/commonsDepositWebhook.ts +0 -237
  327. package/src/conductorAdmin.ts +0 -141
  328. package/src/dayPassConfirmation.ts +0 -230
  329. package/src/dunningEmails.test.ts +0 -263
  330. package/src/dunningEmails.ts +0 -203
  331. package/src/email-templates/brand.ts +0 -93
  332. package/src/email-templates/email-change.tsx +0 -92
  333. package/src/email-templates/invite.tsx +0 -79
  334. package/src/email-templates/magic-link.tsx +0 -59
  335. package/src/email-templates/reauthentication.tsx +0 -60
  336. package/src/email-templates/recovery.tsx +0 -59
  337. package/src/email-templates/signup.tsx +0 -67
  338. package/src/functions/admin-cancel-membership.ts +0 -311
  339. package/src/functions/admin-change-membership-plan.ts +0 -312
  340. package/src/functions/admin-charge-guest-print.ts +0 -229
  341. package/src/functions/admin-correct-booking.ts +0 -333
  342. package/src/functions/admin-create-booking.ts +0 -460
  343. package/src/functions/admin-create-commons-event.ts +0 -244
  344. package/src/functions/admin-debug-boldsign-doc.ts +0 -93
  345. package/src/functions/admin-door-write.ts +0 -272
  346. package/src/functions/admin-issue-day-pass.ts +0 -231
  347. package/src/functions/admin-mark-booking-paid.ts +0 -203
  348. package/src/functions/admin-mint-billing-portal-link.ts +0 -168
  349. package/src/functions/admin-mint-portal-link.ts +0 -62
  350. package/src/functions/admin-photo-upload.ts +0 -128
  351. package/src/functions/admin-remove-team-member.ts +0 -150
  352. package/src/functions/admin-request-trial.ts +0 -366
  353. package/src/functions/admin-resend-commons-deposit-link.ts +0 -323
  354. package/src/functions/admin-reset-mfa.ts +0 -138
  355. package/src/functions/admin-retry-invoice-payment.test.ts +0 -567
  356. package/src/functions/admin-retry-invoice-payment.ts +0 -333
  357. package/src/functions/admin-reverse-coupon-redemption.ts +0 -98
  358. package/src/functions/admin-revoke-agreement.ts +0 -467
  359. package/src/functions/admin-send-commons-agreement.ts +0 -214
  360. package/src/functions/admin-set-credit-amount.ts +0 -123
  361. package/src/functions/admin-skip-commons-contract.ts +0 -165
  362. package/src/functions/admin-undo-membership-cancel.ts +0 -144
  363. package/src/functions/admin-wall-photo-write.ts +0 -141
  364. package/src/functions/auth-email-hook.ts +0 -259
  365. package/src/functions/boldsign-sender-identity.ts +0 -114
  366. package/src/functions/booking-availability.ts +0 -419
  367. package/src/functions/booking-member-preview.ts +0 -136
  368. package/src/functions/booking-status.ts +0 -149
  369. package/src/functions/conductor.ts +0 -505
  370. package/src/functions/create-agreement.ts +0 -537
  371. package/src/functions/create-booking.ts +0 -648
  372. package/src/functions/create-day-pass-checkout.ts +0 -218
  373. package/src/functions/create-portal-session.ts +0 -142
  374. package/src/functions/create-subscription-checkout.test.ts +0 -222
  375. package/src/functions/create-subscription-checkout.ts +0 -440
  376. package/src/functions/day-pass-status.ts +0 -89
  377. package/src/functions/dayStatus.ts +0 -71
  378. package/src/functions/diag-webpush-test.ts +0 -45
  379. package/src/functions/event-access-admin.ts +0 -277
  380. package/src/functions/event-access-store.ts +0 -334
  381. package/src/functions/ezeep-print-webhook.ts +0 -213
  382. package/src/functions/ezeep-usage-reconcile.ts +0 -299
  383. package/src/functions/fetch-avatar-original.ts +0 -457
  384. package/src/functions/get-provider-sign-link.ts +0 -155
  385. package/src/functions/get-signing-link.ts +0 -211
  386. package/src/functions/guest-print-setup-confirm.ts +0 -128
  387. package/src/functions/guest-print-submit.ts +0 -149
  388. package/src/functions/luma-webhook.ts +0 -165
  389. package/src/functions/manage-booking.ts +0 -472
  390. package/src/functions/mcp.ts +0 -67
  391. package/src/functions/member-door-action.test.ts +0 -1248
  392. package/src/functions/member-door-action.ts +0 -863
  393. package/src/functions/member-unifi-mapping.test.ts +0 -516
  394. package/src/functions/member-unifi-mapping.ts +0 -206
  395. package/src/functions/membership-door-sync.ts +0 -956
  396. package/src/functions/migration-collision-alert.copy.ts +0 -232
  397. package/src/functions/migration-collision-alert.test.ts +0 -349
  398. package/src/functions/migration-collision-alert.ts +0 -232
  399. package/src/functions/office-assignment-end.ts +0 -146
  400. package/src/functions/portal-booking-access.ts +0 -217
  401. package/src/functions/portal-list-invoices.ts +0 -99
  402. package/src/functions/portal-request-login.ts +0 -219
  403. package/src/functions/portal-resend-invite.ts +0 -248
  404. package/src/functions/portal-submit-event.ts +0 -168
  405. package/src/functions/print-billing-recover.ts +0 -97
  406. package/src/functions/print-billing-run.ts +0 -183
  407. package/src/functions/public-facts.ts +0 -168
  408. package/src/functions/push-send.ts +0 -348
  409. package/src/functions/push-test.ts +0 -234
  410. package/src/functions/request-portal-link.ts +0 -211
  411. package/src/functions/reschedule-booking.ts +0 -649
  412. package/src/functions/review-ratings.ts +0 -113
  413. package/src/functions/space-availability-range.acceptance.test.ts +0 -161
  414. package/src/functions/space-availability-range.ts +0 -142
  415. package/src/functions/stripe-db-reconcile.ts +0 -319
  416. package/src/functions/stripe-webhook.moved-regression.test.ts +0 -78
  417. package/src/functions/stripe-webhook.ts +0 -2595
  418. package/src/functions/sync-gcal-blackouts.ts +0 -298
  419. package/src/functions/timetable-event-register.ts +0 -162
  420. package/src/functions/timetable-event-status.ts +0 -90
  421. package/src/functions/timetable-spaces.ts +0 -219
  422. package/src/functions/touch-pass-reconciler.ts +0 -689
  423. package/src/functions/touch-pass-signup.ts +0 -478
  424. package/src/functions/upload-booking-display-image.ts +0 -179
  425. package/src/functions/virtual-onboarding-purge.ts +0 -134
  426. package/src/functions/virtual-onboarding-submit.ts +0 -315
  427. package/src/functions/voice-booking.ts +0 -453
  428. package/src/functions/voice-day-pass.ts +0 -346
  429. package/src/functions/voice-inquiry.test.ts +0 -301
  430. package/src/functions/voice-inquiry.ts +0 -198
  431. package/src/functions/voice-membership-signup.ts +0 -355
  432. package/src/functions/voice-tour-availability.ts +0 -204
  433. package/src/functions/voice-tour-booking.ts +0 -429
  434. package/src/gcalSync.ts +0 -142
  435. package/src/ghlEventInquiry.ts +0 -143
  436. package/src/ghlNote.ts +0 -34
  437. package/src/ghlTask.ts +0 -48
  438. package/src/ghlVoiceInquiry.ts +0 -90
  439. package/src/guestPrintCapture.test.ts +0 -722
  440. package/src/guestPrintCapture.ts +0 -538
  441. package/src/lumaGhl.ts +0 -195
  442. package/src/mailArrivalEmail.ts +0 -121
  443. package/src/manageToken.ts +0 -363
  444. package/src/membership.ts +0 -109
  445. package/src/membershipBusClient.ts +0 -537
  446. package/src/membershipWelcome.ts +0 -683
  447. package/src/migrationCheckout.ts +0 -366
  448. package/src/money.ts +0 -36
  449. package/src/ops.ts +0 -97
  450. package/src/paymentLinkEmail.ts +0 -123
  451. package/src/policyAcknowledgment.test.ts +0 -50
  452. package/src/policyAcknowledgment.ts +0 -96
  453. package/src/portalSession.ts +0 -46
  454. package/src/pricing.test.ts +0 -660
  455. package/src/pricing.ts +0 -1025
  456. package/src/printBilling.test.ts +0 -750
  457. package/src/printBilling.ts +0 -891
  458. package/src/printBillingAdapters.ts +0 -169
  459. package/src/printCorrections.test.ts +0 -348
  460. package/src/printCorrections.ts +0 -496
  461. package/src/rateLimit.ts +0 -82
  462. package/src/referralCredits.test.ts +0 -31
  463. package/src/referralGrant.ts +0 -321
  464. package/src/rescheduleCredit.test.ts +0 -521
  465. package/src/rescheduleCredit.ts +0 -337
  466. package/src/reservationWifiCode.test.ts +0 -69
  467. package/src/retellCallAnalyzed.test.ts +0 -167
  468. package/src/retellCallAnalyzed.ts +0 -113
  469. package/src/retellSignature.test.ts +0 -137
  470. package/src/retellSignature.ts +0 -82
  471. package/src/signedUnpaidReminderEmail.test.ts +0 -246
  472. package/src/signedUnpaidReminderEmail.ts +0 -132
  473. package/src/slackAlert.ts +0 -38
  474. package/src/stripeCoworkingPortal.ts +0 -91
  475. package/src/supabaseTestFakes.ts +0 -131
  476. package/src/supportTicketEmail.ts +0 -119
  477. package/src/tier1Agreement.ts +0 -125
  478. package/src/unifiAccessPolicies.ts +0 -228
  479. 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 {};