@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,70 @@
1
+ import { logOps } from './ops.js';
2
+ /**
3
+ * Retell AI's fixed outbound IP (docs.retellai.com). Exempt from the voice
4
+ * agent's own IP buckets only — see RETELL_EXEMPT_BUCKETS.
5
+ */
6
+ export const RETELL_ALLOWLISTED_IP = '100.20.5.228';
7
+ /**
8
+ * The only buckets the Retell IP exemption applies to. Scoped deliberately:
9
+ * `x-forwarded-for` is client-supplied, so a bare identifier match would let
10
+ * anyone spoofing this IP bypass rate limiting in every other edge function
11
+ * that keys on clientIp(). Not included: public-facts' per-(room,date)
12
+ * enumeration bucket, and every non-voice caller.
13
+ */
14
+ export const RETELL_EXEMPT_BUCKETS = new Set([
15
+ 'public-facts-offices-ip', // public-facts: office_availability
16
+ 'public-facts-verify-ip', // public-facts: verify_booking
17
+ 'voice-booking-ip', // voice-booking
18
+ 'voice-tour-booking-ip', // voice-tour-booking
19
+ 'voice-inquiry-ip', // voice-inquiry
20
+ ]);
21
+ export function clientIp(req) {
22
+ const xff = req.headers.get('x-forwarded-for');
23
+ if (xff) {
24
+ const first = xff.split(',')[0]?.trim();
25
+ if (first)
26
+ return first;
27
+ }
28
+ const cf = req.headers.get('cf-connecting-ip');
29
+ if (cf)
30
+ return cf.trim();
31
+ return 'unknown';
32
+ }
33
+ export async function checkRateLimit(supabase, bucket, identifier, max, windowSeconds,
34
+ // Should-fix S2 (adversarial review, round 1): the shared default here is
35
+ // fail-OPEN on an RPC error/throw -- deliberately, since most callers of
36
+ // this shared helper would rather let a request through than block a
37
+ // legitimate user (booking flows, etc.) on a transient DB hiccup. That is
38
+ // the right default for this file as a whole and must NOT change globally
39
+ // (dozens of call sites across this repo rely on it). But a handful of
40
+ // callers guard something where "fail open" is the wrong direction --
41
+ // e.g. a read-only screen mirroring live UniFi Access-Policy/door data,
42
+ // where the worst case of failing CLOSED is just an admin can't load a
43
+ // read-only screen, and the worst case of failing OPEN is an unbounded
44
+ // amplifier against the middleware that fronts physical door hardware.
45
+ // Those callers opt in explicitly with { failClosed: true }; every
46
+ // existing call site that omits this parameter keeps today's fail-open
47
+ // behavior unchanged.
48
+ opts = {}) {
49
+ // Retell's fixed IP, on the voice buckets only: no DB round trip, no bucket
50
+ // consumed. Every other bucket/identifier falls through untouched.
51
+ if (identifier === RETELL_ALLOWLISTED_IP && RETELL_EXEMPT_BUCKETS.has(bucket))
52
+ return true;
53
+ try {
54
+ const { data, error } = await supabase.rpc('check_rate_limit', {
55
+ p_bucket: bucket,
56
+ p_identifier: identifier,
57
+ p_max: max,
58
+ p_window_seconds: windowSeconds,
59
+ });
60
+ if (error) {
61
+ await logOps(supabase, 'rate_limit_check_failed', { bucket, identifier: identifier.slice(0, 64), message: error.message }, { severity: 'warning' });
62
+ return !opts.failClosed;
63
+ }
64
+ return data !== false;
65
+ }
66
+ catch (e) {
67
+ await logOps(supabase, 'rate_limit_check_failed', { bucket, identifier: identifier.slice(0, 64), message: String(e) }, { severity: 'warning' });
68
+ return !opts.failClosed;
69
+ }
70
+ }
@@ -0,0 +1,5 @@
1
+ export interface ReferralCredits {
2
+ referrerCents: number;
3
+ referredCents: number;
4
+ }
5
+ export declare function computeReferralCredits(planPriceCents: number, isPrivateOffice: boolean): ReferralCredits;
@@ -1,34 +1,27 @@
1
- // Member referral program, Phase 1 -- credit formula.
2
- //
3
- // Pure function, zero Stripe/DB dependency, so it's unit-testable on its own
4
- // (see referralCredits.test.ts) and shared verbatim between the two
5
- // stripe-webhook call sites (the signed_up-preview at signup and the real
6
- // grant at first-invoice-paid) -- never re-derived inline. Mirrors the
7
- // _shared/pricing.ts convention: server-authoritative pure logic lives here,
8
- // not duplicated in the edge function that calls it.
9
- //
10
- // Day Pass / any one-time plan is NEVER eligible for a referral credit at
11
- // all -- that gate is enforced by the CALLER (stripe-webhook, before it ever
12
- // creates a referrals row), not here. This function only knows how to turn a
13
- // price + a private-office flag into two credit amounts.
14
-
15
- export interface ReferralCredits {
16
- referrerCents: number;
17
- referredCents: number;
18
- }
19
-
20
- const PRIVATE_OFFICE_REFERRER_CENTS = 30000; // flat $300
21
- const MIN_CREDIT_CENTS = 2500; // $25 floor on both sides
22
-
23
- export function computeReferralCredits(planPriceCents: number, isPrivateOffice: boolean): ReferralCredits {
24
- const referrerCents = isPrivateOffice
25
- ? PRIVATE_OFFICE_REFERRER_CENTS
26
- // Capped at $300 (spec §4), same ceiling as the private-office flat rate --
27
- // otherwise a hypothetical high-priced non-office plan could pay out more
28
- // than the private-office case ever does.
29
- : Math.min(PRIVATE_OFFICE_REFERRER_CENTS, Math.max(MIN_CREDIT_CENTS, Math.round(planPriceCents * 0.5)));
30
- // Half of whatever the referrer got, in ALL cases -- including the flat
31
- // private-office case (30000 / 2 = 15000, i.e. $150).
32
- const referredCents = Math.max(MIN_CREDIT_CENTS, Math.round(referrerCents / 2));
33
- return { referrerCents, referredCents };
34
- }
1
+ // Member referral program, Phase 1 -- credit formula.
2
+ //
3
+ // Pure function, zero Stripe/DB dependency, so it's unit-testable on its own
4
+ // (see referralCredits.test.ts) and shared verbatim between the two
5
+ // stripe-webhook call sites (the signed_up-preview at signup and the real
6
+ // grant at first-invoice-paid) -- never re-derived inline. Mirrors the
7
+ // _shared/pricing.ts convention: server-authoritative pure logic lives here,
8
+ // not duplicated in the edge function that calls it.
9
+ //
10
+ // Day Pass / any one-time plan is NEVER eligible for a referral credit at
11
+ // all -- that gate is enforced by the CALLER (stripe-webhook, before it ever
12
+ // creates a referrals row), not here. This function only knows how to turn a
13
+ // price + a private-office flag into two credit amounts.
14
+ const PRIVATE_OFFICE_REFERRER_CENTS = 30000; // flat $300
15
+ const MIN_CREDIT_CENTS = 2500; // $25 floor on both sides
16
+ export function computeReferralCredits(planPriceCents, isPrivateOffice) {
17
+ const referrerCents = isPrivateOffice
18
+ ? PRIVATE_OFFICE_REFERRER_CENTS
19
+ // Capped at $300 (spec §4), same ceiling as the private-office flat rate --
20
+ // otherwise a hypothetical high-priced non-office plan could pay out more
21
+ // than the private-office case ever does.
22
+ : Math.min(PRIVATE_OFFICE_REFERRER_CENTS, Math.max(MIN_CREDIT_CENTS, Math.round(planPriceCents * 0.5)));
23
+ // Half of whatever the referrer got, in ALL cases -- including the flat
24
+ // private-office case (30000 / 2 = 15000, i.e. $150).
25
+ const referredCents = Math.max(MIN_CREDIT_CENTS, Math.round(referrerCents / 2));
26
+ return { referrerCents, referredCents };
27
+ }
@@ -0,0 +1,49 @@
1
+ import type { SupabaseClient } from '@supabase/supabase-js';
2
+ import type Stripe from 'stripe';
3
+ type SupabaseLike = SupabaseClient<any, 'public', any>;
4
+ /**
5
+ * Records a permanent grant/clawback failure on the referrals row itself
6
+ * (fix #4 from the round-2 review) instead of only console.error/warn --
7
+ * without this, a permanently-failed referral was indistinguishable from
8
+ * one still genuinely pending. Guarded with `.eq('status', fromStatus)` so
9
+ * a failure recorded after the fact can never clobber a row that a
10
+ * concurrent/retried webhook delivery (or a concurrent admin retry) already
11
+ * carried to success -- `fromStatus` must be the row's ACTUAL current
12
+ * status at the time of the call, not an assumed one, or this guard can
13
+ * silently no-op (0 rows updated, no error) instead of protecting anything.
14
+ */
15
+ export declare function recordReferralFailure(supabase: SupabaseLike, referralId: string, fromStatus: 'signed_up' | 'grant_failed' | 'credited', toStatus: 'grant_failed' | 'clawback_failed', error: unknown): Promise<void>;
16
+ /**
17
+ * Referral program Phase 1, step 2 (grant at first-invoice-paid).
18
+ *
19
+ * Called from the webhook only when the first_invoice_paid_at compare-and-
20
+ * swap in the invoice.paid handler actually affected a row (genuinely the
21
+ * first real paid invoice for this membership) -- that call passes no
22
+ * `fromStatuses` override, so it only ever matches a 'signed_up' row.
23
+ *
24
+ * admin-referral-retry calls this SAME function with
25
+ * `fromStatuses: ['grant_failed']` to retry a previously-failed grant --
26
+ * see that function's own header comment for why it gates on the referred
27
+ * membership's live status first, and why it does NOT reset the row to
28
+ * 'signed_up' before calling this (that reset-then-call shape was tried and
29
+ * reverted after a second-model review found it opened a stranded-row
30
+ * window and a same-row race between two concurrent retries).
31
+ *
32
+ * Computes real credit amounts, grants a NEGATIVE Stripe Customer Balance
33
+ * Transaction (a credit) on each of the two Stripe customers, and marks the
34
+ * referral 'credited'.
35
+ *
36
+ * Entirely wrapped in try/catch and logs with the referral id on failure --
37
+ * a Stripe failure here must never break invoice.paid processing for an
38
+ * unrelated membership.
39
+ *
40
+ * IDEMPOTENT BY DESIGN -- this is also what makes it safe for
41
+ * admin-referral-retry to call again on a grant_failed row: before each
42
+ * Stripe call it checks whether this referral already has a txn id
43
+ * persisted, and each Stripe call carries a fixed idempotency key derived
44
+ * from the referral id, so a retry only attempts whichever side didn't
45
+ * already complete. Never write a second, separate recovery path -- retry
46
+ * by calling this function again.
47
+ */
48
+ export declare function maybeGrantReferralCredit(supabase: SupabaseLike, stripe: Stripe, referredMembershipId: string, fromStatuses?: readonly ('signed_up' | 'grant_failed')[]): Promise<void>;
49
+ export {};
@@ -0,0 +1,268 @@
1
+ // Referral program grant logic + failure recorder.
2
+ //
3
+ // Originally moved verbatim out of stripe-webhook/index.ts so the SAME
4
+ // grant logic could be re-invoked on demand by admin-referral-retry (a
5
+ // grant_failed referral needs to re-run this exact function, not a second
6
+ // hand-written copy of Stripe balance-transaction logic that could drift
7
+ // from it over time). Since then (second-model review, 2026-08-24) it has
8
+ // picked up real behavioral fixes on top of that extraction -- it is no
9
+ // longer byte-identical to the original inline version, and should not be
10
+ // described that way again:
11
+ // - `fromStatuses` is now a parameter (default ['signed_up'], the
12
+ // webhook's original single case) instead of a hardcoded 'signed_up'
13
+ // literal, so admin-referral-retry can call this SAME function on a
14
+ // grant_failed row directly -- no separate reset-to-signed_up step,
15
+ // no window where the row sits in a state nothing recognizes.
16
+ // - A failed persist of either side's Stripe transaction id is now a
17
+ // hard stop with a loud last_error, not a console.error-and-continue
18
+ // (see the two `partialUpdErr` blocks below) -- see "24h idempotency
19
+ // key" comment for why this matters.
20
+ // The Supabase and Stripe clients are explicit parameters (same convention
21
+ // as _shared/membershipWelcome.ts and _shared/bookingEffects.ts) instead of
22
+ // closure captures, and console.error tags read [referralGrant] instead of
23
+ // [stripe-webhook] since this code now runs from two different callers.
24
+ //
25
+ // The two clawback functions (maybeClawbackReferralCredit and
26
+ // maybeClawbackReferralCreditForRefundOrDispute) stay in stripe-webhook/
27
+ // index.ts -- they're deliberately NOT extracted here. There are two
28
+ // different clawback code paths and a clawback_failed row alone doesn't
29
+ // say which one failed, so clawback retry is a human decision for now
30
+ // (see AdminReferrals.tsx), not an automated one. recordReferralFailure is
31
+ // still exported here since both index.ts's clawback functions and this
32
+ // file's grant function need it -- index.ts imports it from here rather
33
+ // than keeping a second copy.
34
+ import { logOps } from './ops.js';
35
+ import { computeReferralCredits } from './referralCredits.js';
36
+ /**
37
+ * Records a permanent grant/clawback failure on the referrals row itself
38
+ * (fix #4 from the round-2 review) instead of only console.error/warn --
39
+ * without this, a permanently-failed referral was indistinguishable from
40
+ * one still genuinely pending. Guarded with `.eq('status', fromStatus)` so
41
+ * a failure recorded after the fact can never clobber a row that a
42
+ * concurrent/retried webhook delivery (or a concurrent admin retry) already
43
+ * carried to success -- `fromStatus` must be the row's ACTUAL current
44
+ * status at the time of the call, not an assumed one, or this guard can
45
+ * silently no-op (0 rows updated, no error) instead of protecting anything.
46
+ */
47
+ export async function recordReferralFailure(supabase, referralId, fromStatus, toStatus, error) {
48
+ const message = (error instanceof Error ? error.message : String(error)).slice(0, 2000);
49
+ const { error: updErr } = await supabase
50
+ .from('referrals')
51
+ .update({ status: toStatus, last_error: message })
52
+ .eq('id', referralId)
53
+ .eq('status', fromStatus);
54
+ if (updErr) {
55
+ console.error('[referralGrant] recordReferralFailure: failed to persist failure status', {
56
+ referral_id: referralId, target_status: toStatus, message: updErr.message,
57
+ });
58
+ }
59
+ // Round-3 review finding 4c: a terminal grant_failed/clawback_failed row
60
+ // is otherwise only visible to someone who thinks to query the table.
61
+ // Route it through the same ops-alert channel stripe-webhook uses.
62
+ await logOps(supabase, 'referral_' + toStatus, { referral_id: referralId, message }, { severity: 'error' }).catch(() => { });
63
+ }
64
+ /**
65
+ * Referral program Phase 1, step 2 (grant at first-invoice-paid).
66
+ *
67
+ * Called from the webhook only when the first_invoice_paid_at compare-and-
68
+ * swap in the invoice.paid handler actually affected a row (genuinely the
69
+ * first real paid invoice for this membership) -- that call passes no
70
+ * `fromStatuses` override, so it only ever matches a 'signed_up' row.
71
+ *
72
+ * admin-referral-retry calls this SAME function with
73
+ * `fromStatuses: ['grant_failed']` to retry a previously-failed grant --
74
+ * see that function's own header comment for why it gates on the referred
75
+ * membership's live status first, and why it does NOT reset the row to
76
+ * 'signed_up' before calling this (that reset-then-call shape was tried and
77
+ * reverted after a second-model review found it opened a stranded-row
78
+ * window and a same-row race between two concurrent retries).
79
+ *
80
+ * Computes real credit amounts, grants a NEGATIVE Stripe Customer Balance
81
+ * Transaction (a credit) on each of the two Stripe customers, and marks the
82
+ * referral 'credited'.
83
+ *
84
+ * Entirely wrapped in try/catch and logs with the referral id on failure --
85
+ * a Stripe failure here must never break invoice.paid processing for an
86
+ * unrelated membership.
87
+ *
88
+ * IDEMPOTENT BY DESIGN -- this is also what makes it safe for
89
+ * admin-referral-retry to call again on a grant_failed row: before each
90
+ * Stripe call it checks whether this referral already has a txn id
91
+ * persisted, and each Stripe call carries a fixed idempotency key derived
92
+ * from the referral id, so a retry only attempts whichever side didn't
93
+ * already complete. Never write a second, separate recovery path -- retry
94
+ * by calling this function again.
95
+ */
96
+ export async function maybeGrantReferralCredit(supabase, stripe, referredMembershipId, fromStatuses = ['signed_up']) {
97
+ let referralId = null;
98
+ // Guard used by every recordReferralFailure call below -- always the
99
+ // row's REAL current status as read from the DB just now, never an
100
+ // assumption, so the optimistic-concurrency guard inside
101
+ // recordReferralFailure actually protects against a concurrent winner.
102
+ let currentStatus = 'signed_up';
103
+ try {
104
+ const { data: rawReferral, error: refErr } = await supabase
105
+ .from('referrals')
106
+ .select('id,status,referring_membership_id,referred_membership_id,referred_plan_price_cents,is_private_office,' +
107
+ 'stripe_balance_txn_id_referrer,stripe_balance_txn_id_referred')
108
+ .eq('referred_membership_id', referredMembershipId)
109
+ .in('status', fromStatuses)
110
+ .maybeSingle();
111
+ if (refErr) {
112
+ console.error('[referralGrant] referral lookup failed', {
113
+ membership_id: referredMembershipId, message: refErr.message,
114
+ });
115
+ return;
116
+ }
117
+ if (!rawReferral)
118
+ return; // this membership has no referral in a retryable state -- normal case
119
+ const typedReferral = rawReferral;
120
+ referralId = typedReferral.id;
121
+ currentStatus = typedReferral.status;
122
+ const { referrerCents, referredCents } = computeReferralCredits(typedReferral.referred_plan_price_cents ?? 0, typedReferral.is_private_office === true);
123
+ const { data: parties, error: partiesErr } = await supabase
124
+ .from('memberships')
125
+ .select('id,stripe_customer_id')
126
+ .in('id', [typedReferral.referring_membership_id, typedReferral.referred_membership_id]);
127
+ if (partiesErr || !parties) {
128
+ console.error('[referralGrant] referral credit membership lookup failed', {
129
+ referral_id: typedReferral.id, message: partiesErr?.message ?? 'no rows',
130
+ });
131
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', partiesErr ?? new Error('membership lookup returned no rows'));
132
+ return;
133
+ }
134
+ const referringCustomerId = parties.find((m) => m.id === typedReferral.referring_membership_id)?.stripe_customer_id ?? null;
135
+ const referredCustomerId = parties.find((m) => m.id === typedReferral.referred_membership_id)?.stripe_customer_id ?? null;
136
+ if (!referringCustomerId || !referredCustomerId) {
137
+ console.error('[referralGrant] referral credit missing stripe_customer_id', { referral_id: typedReferral.id });
138
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', new Error('missing stripe_customer_id on one or both parties'));
139
+ return;
140
+ }
141
+ // Each call carries a deterministic idempotency key derived from the
142
+ // referral row's own id -- a webhook redelivery, or our own retry after
143
+ // a transient failure below, can never double-credit either party even
144
+ // if our own DB state is momentarily inconsistent; Stripe itself
145
+ // refuses to apply the same key twice.
146
+ //
147
+ // Round-3 review foot-gun: idempotency keys expire after 24h (Stripe),
148
+ // but a `grant_failed` row can be manually flipped back for retry well
149
+ // after that -- at which point a stale key would no longer protect
150
+ // against a double charge. The real guard is checking whether this
151
+ // referral ALREADY has a txn id persisted (from a prior partial
152
+ // attempt) and skipping straight past re-charging Stripe for that side
153
+ // if so -- which is exactly why a failure to PERSIST that txn id after
154
+ // a successful Stripe call (the `partialUpdErr`/`partialUpdErr2` blocks
155
+ // below) must be treated as fatal, not logged-and-ignored: if the id
156
+ // never lands in the DB, a later retry past the 24h window has no way
157
+ // to know the money already moved, and will move it again.
158
+ let referrerTxnId = typedReferral.stripe_balance_txn_id_referrer ?? null;
159
+ if (!referrerTxnId) {
160
+ try {
161
+ // A NEGATIVE amount on a Customer Balance Transaction decreases what
162
+ // the customer owes -- i.e. grants them a credit against their next
163
+ // invoice. POST /v1/customers/{customer}/balance_transactions.
164
+ const referrerTxn = await stripe.customers.createBalanceTransaction(referringCustomerId, {
165
+ amount: -referrerCents,
166
+ currency: 'usd',
167
+ description: `Referral credit: friend joined via your referral link (referral ${typedReferral.id})`,
168
+ }, { idempotencyKey: `ref-${typedReferral.id}-referrer-grant` });
169
+ referrerTxnId = referrerTxn.id;
170
+ }
171
+ catch (e) {
172
+ console.error('[referralGrant] referral referrer balance transaction creation failed', {
173
+ referral_id: typedReferral.id, message: e instanceof Error ? e.message : String(e),
174
+ });
175
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', e);
176
+ return;
177
+ }
178
+ // Persist immediately -- if the referred-side call below throws, this
179
+ // row already shows real money moved once, with the txn id needed to
180
+ // reconcile or manually complete the pair. A failure to persist THIS
181
+ // txn id is fatal (see the 24h-idempotency-key comment above): the
182
+ // Stripe transaction already exists for real, so silently continuing
183
+ // would leave a retry blind to that fact.
184
+ const { error: partialUpdErr } = await supabase
185
+ .from('referrals')
186
+ .update({ stripe_balance_txn_id_referrer: referrerTxnId, referrer_credit_cents: referrerCents })
187
+ .eq('id', typedReferral.id);
188
+ if (partialUpdErr) {
189
+ console.error('[referralGrant] referral partial grant persist failed -- REFERRER STRIPE CREDIT ALREADY GRANTED', {
190
+ referral_id: typedReferral.id, referrer_txn_id: referrerTxnId, message: partialUpdErr.message,
191
+ });
192
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', new Error(`REFERRER CREDIT GRANTED (txn ${referrerTxnId}) BUT TXN ID NOT PERSISTED (${partialUpdErr.message}) -- reconcile in Stripe before retrying; a retry past 24h without this id would charge again`));
193
+ return;
194
+ }
195
+ }
196
+ let referredTxnId = typedReferral.stripe_balance_txn_id_referred ?? null;
197
+ if (!referredTxnId) {
198
+ try {
199
+ const referredTxn = await stripe.customers.createBalanceTransaction(referredCustomerId, {
200
+ amount: -referredCents,
201
+ currency: 'usd',
202
+ description: `Referral credit: welcome credit for signing up with a referral code (referral ${typedReferral.id})`,
203
+ }, { idempotencyKey: `ref-${typedReferral.id}-referred-grant` });
204
+ referredTxnId = referredTxn.id;
205
+ }
206
+ catch (e) {
207
+ console.error('[referralGrant] referral referred balance transaction creation failed -- referrer side already credited above', {
208
+ referral_id: typedReferral.id, referrer_txn_id: referrerTxnId, message: e instanceof Error ? e.message : String(e),
209
+ });
210
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', e);
211
+ return;
212
+ }
213
+ // Same reasoning as the referrer side above -- a failed persist here
214
+ // means a real Stripe credit exists with no durable record of its id.
215
+ const { error: partialUpdErr2 } = await supabase
216
+ .from('referrals')
217
+ .update({ stripe_balance_txn_id_referred: referredTxnId, referred_credit_cents: referredCents })
218
+ .eq('id', typedReferral.id);
219
+ if (partialUpdErr2) {
220
+ console.error('[referralGrant] referral partial grant persist (referred side) failed -- REFERRED STRIPE CREDIT ALREADY GRANTED', {
221
+ referral_id: typedReferral.id, referred_txn_id: referredTxnId, message: partialUpdErr2.message,
222
+ });
223
+ await recordReferralFailure(supabase, typedReferral.id, currentStatus, 'grant_failed', new Error(`REFERRED CREDIT GRANTED (txn ${referredTxnId}) BUT TXN ID NOT PERSISTED (${partialUpdErr2.message}) -- reconcile in Stripe before retrying; a retry past 24h without this id would charge again`));
224
+ return;
225
+ }
226
+ }
227
+ // referrer_credit_cents/referred_credit_cents are NOT set here -- each
228
+ // was already persisted, atomically with its own txn id, above (round-4
229
+ // review finding) -- so the amount recorded always matches what that
230
+ // specific Stripe transaction actually charged, even across a retry
231
+ // where the formula or the referral's price_cents might have changed.
232
+ //
233
+ // Guarded on `currentStatus` (the row's real status as read at the top
234
+ // of this call), not a hardcoded 'signed_up' -- a retry from
235
+ // grant_failed must flip FROM grant_failed, not from a status the row
236
+ // was never actually in.
237
+ const { error: creditUpdErr } = await supabase
238
+ .from('referrals')
239
+ .update({
240
+ status: 'credited',
241
+ credited_at: new Date().toISOString(),
242
+ clawback_eligible_until: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString(),
243
+ })
244
+ .eq('id', typedReferral.id)
245
+ .eq('status', currentStatus);
246
+ if (creditUpdErr) {
247
+ console.error('[referralGrant] referral row update after crediting failed -- BOTH stripe transactions already succeeded, only this status flip failed', {
248
+ referral_id: typedReferral.id, referrer_txn_id: referrerTxnId, referred_txn_id: referredTxnId,
249
+ message: creditUpdErr.message,
250
+ });
251
+ await logOps(supabase, 'referral_credited_status_flip_failed', { referral_id: typedReferral.id, referrer_txn_id: referrerTxnId, referred_txn_id: referredTxnId, message: creditUpdErr.message }, { severity: 'error' }).catch(() => { });
252
+ // Deliberately NOT recordReferralFailure here -- both Stripe
253
+ // transactions already succeeded, so 'grant_failed' would misleadingly
254
+ // imply the grant itself failed. The row stays at `currentStatus` with
255
+ // both txn ids already persisted above, so a later retry of this
256
+ // function is now SAFE: it will skip both createBalanceTransaction
257
+ // calls (already have referrerTxnId/referredTxnId) and just
258
+ // re-attempt this status flip.
259
+ }
260
+ }
261
+ catch (e) {
262
+ console.error('[referralGrant] maybeGrantReferralCredit failed', {
263
+ membership_id: referredMembershipId, message: e instanceof Error ? e.message : String(e),
264
+ });
265
+ if (referralId)
266
+ await recordReferralFailure(supabase, referralId, currentStatus, 'grant_failed', e);
267
+ }
268
+ }
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Floor applied to a capped credit-funded grant so it's never issued
3
+ * already-dead (or nearly so) just because the ORIGINAL credit it's capped
4
+ * against had already expired by refund/cancellation time. Kyle's call,
5
+ * E10/GATE-0188 follow-up, 2026-09-10.
6
+ */
7
+ export declare const MIN_CREDIT_GRANT_LIFETIME_DAYS = 30;
8
+ /** Minimal structural client surface this module needs. */
9
+ export interface RescheduleCreditLookupClient {
10
+ from(table: string): any;
11
+ rpc(fn: string, args: Record<string, unknown>): PromiseLike<{
12
+ data: any;
13
+ error: any;
14
+ }>;
15
+ }
16
+ /**
17
+ * period_month is always the 1st of a calendar month (DB CHECK
18
+ * credit_periods_period_month_is_first) — pure calendar arithmetic, no
19
+ * timezone ambiguity in computing "the following month" from it.
20
+ */
21
+ export declare function nextPeriodMonthStr(periodMonthStr: string): string;
22
+ export type OrigCreditExpiryResult = {
23
+ exp: Date;
24
+ source: 'system_a' | 'system_b';
25
+ errored: false;
26
+ } | {
27
+ exp: Date;
28
+ source: 'error' | 'not_found';
29
+ errored: true;
30
+ detail: string;
31
+ };
32
+ /**
33
+ * Finds the real expiry that must cap a reschedule's credit-funded refund
34
+ * portion, by tracing which of the two credit mechanisms actually funded
35
+ * `bookingId`'s `credit_applied_cents`. See the module doc comment above.
36
+ *
37
+ * Returns `errored: true` whenever the real expiry could not be confirmed —
38
+ * a query failure OR (just as importantly) a *clean, zero-row* result
39
+ * despite the caller already knowing credit_applied_cents > 0. Both failure
40
+ * shapes are treated identically: fall back to `defaultExp`, but tell the
41
+ * caller so it can log at ERROR severity rather than silently over-granting.
42
+ */
43
+ export declare function resolveOriginalCreditExpiry(admin: RescheduleCreditLookupClient, bookingId: string, defaultExp: Date): Promise<OrigCreditExpiryResult>;
44
+ export interface RescheduleCreditGrant {
45
+ entry_type: 'grant';
46
+ contact_email: string;
47
+ ghl_contact_id: string | null;
48
+ delta_cents: number;
49
+ reason: string;
50
+ booking_id: string;
51
+ expires_at: string;
52
+ }
53
+ export interface BuildRescheduleCreditGrantsResult {
54
+ grants: RescheduleCreditGrant[];
55
+ /** True when the credit-portion expiry lookup failed/came up empty — caller should log at ERROR. */
56
+ expiryLookupErrored: boolean;
57
+ expiryLookupDetail?: string;
58
+ expirySource?: string;
59
+ }
60
+ /**
61
+ * Builds the credits-table INSERT payload for a reschedule's refund: up to
62
+ * two 'grant' rows — a cash-funded portion at the plain 1-year default, and
63
+ * (only if > 0) a credit-funded portion capped at the ORIGINAL credit's own
64
+ * expiry. A zero-cents portion is omitted entirely (a 'grant' row with
65
+ * delta_cents = 0 would violate credits_delta_sign_check).
66
+ */
67
+ export declare function buildRescheduleCreditGrants(admin: RescheduleCreditLookupClient, opts: {
68
+ bookingId: string;
69
+ contactEmail: string;
70
+ ghlContactId: string | null;
71
+ cashPortionCents: number;
72
+ creditPortionCents: number;
73
+ defaultExp: Date;
74
+ }): Promise<BuildRescheduleCreditGrantsResult>;
75
+ /**
76
+ * Same split as buildRescheduleCreditGrants, for the two cancellation paths
77
+ * (manage-booking's customer-initiated cancel, admin-cancel-booking's
78
+ * staff-initiated cancel/refund) — a cancellation credit carries exactly the
79
+ * same laundering risk a reschedule credit does: it must not extend a
80
+ * short-lived credit into a fresh 1-year grant just because it passed
81
+ * through a cancellation instead of a reschedule. See E10/GATE-0188.
82
+ *
83
+ * `reasonOverride`, when given (admin-cancel-booking's optional free-text
84
+ * reason field), replaces the whole default reason string for BOTH portions
85
+ * verbatim — matching this codebase's pre-existing behavior where an admin's
86
+ * stated reason describes the whole cancellation, not which system funded
87
+ * which slice of it.
88
+ */
89
+ export declare function buildCancellationCreditGrants(admin: RescheduleCreditLookupClient, opts: {
90
+ bookingId: string;
91
+ contactEmail: string;
92
+ ghlContactId: string | null;
93
+ cashPortionCents: number;
94
+ creditPortionCents: number;
95
+ defaultExp: Date;
96
+ actor: 'customer' | 'admin';
97
+ reasonOverride?: string | null;
98
+ }): Promise<BuildRescheduleCreditGrantsResult>;