@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.
- package/dist/adminBookingCredit.d.ts +107 -0
- package/dist/adminBookingCredit.js +163 -0
- package/dist/agreementCheckout.d.ts +34 -0
- package/dist/agreementCheckout.js +211 -0
- package/dist/agreementPortalEmail.d.ts +15 -0
- package/dist/agreementPortalEmail.js +107 -0
- package/dist/availability.d.ts +51 -0
- package/dist/availability.js +152 -0
- package/dist/billingPortalLinkEmail.d.ts +14 -0
- package/dist/billingPortalLinkEmail.js +98 -0
- package/dist/bookingAgreementEmail.d.ts +23 -0
- package/dist/bookingAgreementEmail.js +116 -0
- package/dist/bookingEffects.d.ts +84 -0
- package/dist/bookingEffects.js +309 -0
- package/dist/bookingHoldReclaim.d.ts +16 -0
- package/dist/bookingHoldReclaim.js +74 -0
- package/dist/busClient.d.ts +44 -0
- package/dist/busClient.js +196 -0
- package/dist/busSignature.d.ts +19 -0
- package/{src/busSignature.ts → dist/busSignature.js} +64 -71
- package/dist/checkoutCoupon.d.ts +156 -0
- package/dist/checkoutCoupon.js +369 -0
- package/dist/checkoutSessionParams.d.ts +32 -0
- package/dist/checkoutSessionParams.js +72 -0
- package/dist/commonsContract.d.ts +70 -0
- package/dist/commonsContract.js +142 -0
- package/dist/commonsDeposit.d.ts +78 -0
- package/dist/commonsDeposit.js +199 -0
- package/dist/commonsDepositWebhook.d.ts +37 -0
- package/dist/commonsDepositWebhook.js +147 -0
- package/dist/conductorAdmin.d.ts +76 -0
- package/dist/conductorAdmin.js +88 -0
- package/dist/dayPassConfirmation.d.ts +17 -0
- package/dist/dayPassConfirmation.js +187 -0
- package/dist/dunningEmails.d.ts +40 -0
- package/dist/dunningEmails.js +174 -0
- package/dist/email-templates/brand.d.ts +82 -0
- package/dist/email-templates/brand.js +72 -0
- package/dist/email-templates/email-change.d.ts +10 -0
- package/dist/email-templates/email-change.js +50 -0
- package/dist/email-templates/invite.d.ts +8 -0
- package/dist/email-templates/invite.js +44 -0
- package/dist/email-templates/magic-link.d.ts +10 -0
- package/dist/email-templates/magic-link.js +26 -0
- package/dist/email-templates/reauthentication.d.ts +6 -0
- package/dist/email-templates/reauthentication.js +35 -0
- package/dist/email-templates/recovery.d.ts +10 -0
- package/dist/email-templates/recovery.js +26 -0
- package/dist/email-templates/signup.d.ts +12 -0
- package/dist/email-templates/signup.js +30 -0
- package/dist/entitlements.d.ts +17 -0
- package/dist/entitlements.js +33 -0
- package/dist/functions/admin-cancel-membership.d.ts +3 -0
- package/dist/functions/admin-cancel-membership.js +294 -0
- package/dist/functions/admin-change-membership-plan.d.ts +3 -0
- package/dist/functions/admin-change-membership-plan.js +289 -0
- package/dist/functions/admin-charge-guest-print.d.ts +1 -0
- package/dist/functions/admin-charge-guest-print.js +227 -0
- package/dist/functions/admin-correct-booking.d.ts +1 -0
- package/dist/functions/admin-correct-booking.js +326 -0
- package/dist/functions/admin-create-booking.d.ts +43 -0
- package/dist/functions/admin-create-booking.js +410 -0
- package/dist/functions/admin-create-commons-event.d.ts +1 -0
- package/dist/functions/admin-create-commons-event.js +237 -0
- package/dist/functions/admin-debug-boldsign-doc.d.ts +1 -0
- package/dist/functions/admin-debug-boldsign-doc.js +110 -0
- package/dist/functions/admin-door-write.d.ts +1 -0
- package/dist/functions/admin-door-write.js +267 -0
- package/dist/functions/admin-issue-day-pass.d.ts +14 -0
- package/dist/functions/admin-issue-day-pass.js +213 -0
- package/dist/functions/admin-mark-booking-paid.d.ts +1 -0
- package/dist/functions/admin-mark-booking-paid.js +202 -0
- package/dist/functions/admin-mint-billing-portal-link.d.ts +6 -0
- package/dist/functions/admin-mint-billing-portal-link.js +159 -0
- package/dist/functions/admin-mint-portal-link.d.ts +3 -0
- package/dist/functions/admin-mint-portal-link.js +54 -0
- package/dist/functions/admin-onboard-connect-account.d.ts +47 -0
- package/dist/functions/admin-onboard-connect-account.js +197 -0
- package/dist/functions/admin-photo-upload.d.ts +1 -0
- package/dist/functions/admin-photo-upload.js +104 -0
- package/dist/functions/admin-remove-team-member.d.ts +1 -0
- package/dist/functions/admin-remove-team-member.js +140 -0
- package/dist/functions/admin-request-trial.d.ts +5 -0
- package/dist/functions/admin-request-trial.js +349 -0
- package/dist/functions/admin-resend-commons-deposit-link.d.ts +7 -0
- package/dist/functions/admin-resend-commons-deposit-link.js +298 -0
- package/dist/functions/admin-reset-mfa.d.ts +1 -0
- package/dist/functions/admin-reset-mfa.js +129 -0
- package/dist/functions/admin-retry-invoice-payment.d.ts +76 -0
- package/dist/functions/admin-retry-invoice-payment.js +269 -0
- package/dist/functions/admin-reverse-coupon-redemption.d.ts +1 -0
- package/dist/functions/admin-reverse-coupon-redemption.js +91 -0
- package/dist/functions/admin-revoke-agreement.d.ts +4 -0
- package/dist/functions/admin-revoke-agreement.js +410 -0
- package/dist/functions/admin-send-commons-agreement.d.ts +1 -0
- package/dist/functions/admin-send-commons-agreement.js +212 -0
- package/dist/functions/admin-set-credit-amount.d.ts +1 -0
- package/dist/functions/admin-set-credit-amount.js +112 -0
- package/dist/functions/admin-skip-commons-contract.d.ts +1 -0
- package/dist/functions/admin-skip-commons-contract.js +170 -0
- package/dist/functions/admin-undo-membership-cancel.d.ts +3 -0
- package/dist/functions/admin-undo-membership-cancel.js +143 -0
- package/dist/functions/admin-wall-photo-write.d.ts +1 -0
- package/dist/functions/admin-wall-photo-write.js +137 -0
- package/dist/functions/auth-email-hook.d.ts +20 -0
- package/dist/functions/auth-email-hook.js +209 -0
- package/dist/functions/boldsign-sender-identity.d.ts +1 -0
- package/dist/functions/boldsign-sender-identity.js +109 -0
- package/dist/functions/booking-availability.d.ts +1 -0
- package/dist/functions/booking-availability.js +355 -0
- package/dist/functions/booking-member-preview.d.ts +1 -0
- package/dist/functions/booking-member-preview.js +123 -0
- package/dist/functions/booking-status.d.ts +3 -0
- package/dist/functions/booking-status.js +139 -0
- package/dist/functions/conductor.d.ts +3 -0
- package/dist/functions/conductor.js +451 -0
- package/dist/functions/create-agreement.d.ts +8 -0
- package/dist/functions/create-agreement.js +498 -0
- package/dist/functions/create-booking.d.ts +44 -0
- package/dist/functions/create-booking.js +538 -0
- package/dist/functions/create-day-pass-checkout.d.ts +6 -0
- package/dist/functions/create-day-pass-checkout.js +225 -0
- package/dist/functions/create-portal-session.d.ts +4 -0
- package/dist/functions/create-portal-session.js +127 -0
- package/dist/functions/create-subscription-checkout.d.ts +7 -0
- package/dist/functions/create-subscription-checkout.js +405 -0
- package/dist/functions/day-pass-status.d.ts +1 -0
- package/dist/functions/day-pass-status.js +70 -0
- package/dist/functions/dayStatus.d.ts +15 -0
- package/dist/functions/dayStatus.js +59 -0
- package/dist/functions/diag-webpush-test.d.ts +1 -0
- package/dist/functions/diag-webpush-test.js +42 -0
- package/dist/functions/event-access-admin.d.ts +17 -0
- package/dist/functions/event-access-admin.js +262 -0
- package/dist/functions/event-access-store.d.ts +1 -0
- package/dist/functions/event-access-store.js +343 -0
- package/dist/functions/ezeep-print-webhook.d.ts +1 -0
- package/dist/functions/ezeep-print-webhook.js +160 -0
- package/dist/functions/ezeep-usage-reconcile.d.ts +1 -0
- package/dist/functions/ezeep-usage-reconcile.js +305 -0
- package/dist/functions/fetch-avatar-original.d.ts +3 -0
- package/dist/functions/fetch-avatar-original.js +423 -0
- package/dist/functions/get-provider-sign-link.d.ts +3 -0
- package/dist/functions/get-provider-sign-link.js +146 -0
- package/dist/functions/get-signing-link.d.ts +1 -0
- package/dist/functions/get-signing-link.js +192 -0
- package/dist/functions/guest-print-setup-confirm.d.ts +1 -0
- package/dist/functions/guest-print-setup-confirm.js +126 -0
- package/dist/functions/guest-print-submit.d.ts +1 -0
- package/dist/functions/guest-print-submit.js +145 -0
- package/dist/functions/luma-webhook.d.ts +1 -0
- package/dist/functions/luma-webhook.js +123 -0
- package/dist/functions/manage-booking.d.ts +75 -0
- package/dist/functions/manage-booking.js +409 -0
- package/dist/functions/mcp.d.ts +16 -0
- package/dist/functions/mcp.js +51 -0
- package/dist/functions/member-door-action.d.ts +60 -0
- package/dist/functions/member-door-action.js +774 -0
- package/dist/functions/member-unifi-mapping.d.ts +15 -0
- package/dist/functions/member-unifi-mapping.js +198 -0
- package/dist/functions/membership-door-sync.d.ts +14 -0
- package/dist/functions/membership-door-sync.js +863 -0
- package/dist/functions/migration-collision-alert.copy.d.ts +7 -0
- package/dist/functions/migration-collision-alert.copy.js +207 -0
- package/dist/functions/migration-collision-alert.d.ts +7 -0
- package/dist/functions/migration-collision-alert.js +207 -0
- package/dist/functions/office-assignment-end.d.ts +12 -0
- package/dist/functions/office-assignment-end.js +140 -0
- package/dist/functions/portal-booking-access.d.ts +22 -0
- package/dist/functions/portal-booking-access.js +163 -0
- package/dist/functions/portal-list-invoices.d.ts +1 -0
- package/dist/functions/portal-list-invoices.js +90 -0
- package/dist/functions/portal-request-login.d.ts +7 -0
- package/dist/functions/portal-request-login.js +199 -0
- package/dist/functions/portal-resend-invite.d.ts +6 -0
- package/dist/functions/portal-resend-invite.js +225 -0
- package/dist/functions/portal-submit-event.d.ts +4 -0
- package/dist/functions/portal-submit-event.js +152 -0
- package/dist/functions/print-billing-recover.d.ts +1 -0
- package/dist/functions/print-billing-recover.js +83 -0
- package/dist/functions/print-billing-run.d.ts +1 -0
- package/dist/functions/print-billing-run.js +153 -0
- package/dist/functions/public-facts.d.ts +1 -0
- package/dist/functions/public-facts.js +141 -0
- package/dist/functions/push-send.d.ts +3 -0
- package/dist/functions/push-send.js +297 -0
- package/dist/functions/push-test.d.ts +3 -0
- package/dist/functions/push-test.js +215 -0
- package/dist/functions/request-portal-link.d.ts +7 -0
- package/dist/functions/request-portal-link.js +178 -0
- package/dist/functions/reschedule-booking.d.ts +50 -0
- package/dist/functions/reschedule-booking.js +571 -0
- package/dist/functions/review-ratings.d.ts +1 -0
- package/dist/functions/review-ratings.js +95 -0
- package/dist/functions/space-availability-range.d.ts +1 -0
- package/dist/functions/space-availability-range.js +109 -0
- package/dist/functions/stripe-db-reconcile.d.ts +7 -0
- package/dist/functions/stripe-db-reconcile.js +326 -0
- package/dist/functions/stripe-webhook.d.ts +46 -0
- package/dist/functions/stripe-webhook.js +2381 -0
- package/dist/functions/sync-gcal-blackouts.d.ts +1 -0
- package/dist/functions/sync-gcal-blackouts.js +251 -0
- package/dist/functions/timetable-event-register.d.ts +1 -0
- package/dist/functions/timetable-event-register.js +155 -0
- package/dist/functions/timetable-event-status.d.ts +1 -0
- package/dist/functions/timetable-event-status.js +86 -0
- package/dist/functions/timetable-spaces.d.ts +1 -0
- package/dist/functions/timetable-spaces.js +161 -0
- package/dist/functions/touch-pass-reconciler.d.ts +1 -0
- package/dist/functions/touch-pass-reconciler.js +688 -0
- package/dist/functions/touch-pass-signup.d.ts +1 -0
- package/dist/functions/touch-pass-signup.js +447 -0
- package/dist/functions/upload-booking-display-image.d.ts +4 -0
- package/dist/functions/upload-booking-display-image.js +159 -0
- package/dist/functions/virtual-onboarding-purge.d.ts +1 -0
- package/dist/functions/virtual-onboarding-purge.js +123 -0
- package/dist/functions/virtual-onboarding-submit.d.ts +1 -0
- package/dist/functions/virtual-onboarding-submit.js +303 -0
- package/dist/functions/voice-booking.d.ts +10 -0
- package/dist/functions/voice-booking.js +360 -0
- package/dist/functions/voice-day-pass.d.ts +15 -0
- package/dist/functions/voice-day-pass.js +269 -0
- package/dist/functions/voice-inquiry.d.ts +1 -0
- package/dist/functions/voice-inquiry.js +156 -0
- package/dist/functions/voice-membership-signup.d.ts +16 -0
- package/dist/functions/voice-membership-signup.js +277 -0
- package/dist/functions/voice-tour-availability.d.ts +1 -0
- package/dist/functions/voice-tour-availability.js +179 -0
- package/dist/functions/voice-tour-booking.d.ts +21 -0
- package/dist/functions/voice-tour-booking.js +308 -0
- package/dist/gcalSync.d.ts +29 -0
- package/dist/gcalSync.js +119 -0
- package/dist/ghlEventInquiry.d.ts +16 -0
- package/dist/ghlEventInquiry.js +116 -0
- package/dist/ghlNote.d.ts +5 -0
- package/dist/ghlNote.js +29 -0
- package/dist/ghlTask.d.ts +7 -0
- package/dist/ghlTask.js +39 -0
- package/dist/ghlVoiceInquiry.d.ts +26 -0
- package/dist/ghlVoiceInquiry.js +68 -0
- package/dist/guestPrintCapture.d.ts +217 -0
- package/dist/guestPrintCapture.js +362 -0
- package/dist/index.d.ts +3 -0
- package/{index.js → dist/index.js} +3 -2
- package/dist/lumaGhl.d.ts +19 -0
- package/dist/lumaGhl.js +147 -0
- package/dist/mailArrivalEmail.d.ts +15 -0
- package/dist/mailArrivalEmail.js +99 -0
- package/dist/manageToken.d.ts +64 -0
- package/dist/manageToken.js +261 -0
- package/dist/membership.d.ts +20 -0
- package/dist/membership.js +87 -0
- package/dist/membershipBusClient.d.ts +139 -0
- package/dist/membershipBusClient.js +443 -0
- package/dist/membershipWelcome.d.ts +117 -0
- package/dist/membershipWelcome.js +497 -0
- package/dist/migrationCheckout.d.ts +169 -0
- package/dist/migrationCheckout.js +250 -0
- package/dist/money.d.ts +20 -0
- package/dist/money.js +35 -0
- package/dist/ops.d.ts +27 -0
- package/dist/ops.js +87 -0
- package/dist/pacificDate.d.ts +8 -0
- package/{src/pacificDate.ts → dist/pacificDate.js} +76 -88
- package/dist/paymentLinkEmail.d.ts +15 -0
- package/dist/paymentLinkEmail.js +102 -0
- package/dist/policyAcknowledgment.d.ts +46 -0
- package/dist/policyAcknowledgment.js +58 -0
- package/dist/portalSession.d.ts +15 -0
- package/dist/portalSession.js +31 -0
- package/dist/pricing.d.ts +306 -0
- package/dist/pricing.js +788 -0
- package/dist/printBilling.d.ts +340 -0
- package/dist/printBilling.js +619 -0
- package/dist/printBillingAdapters.d.ts +29 -0
- package/dist/printBillingAdapters.js +130 -0
- package/dist/printCorrections.d.ts +175 -0
- package/dist/printCorrections.js +328 -0
- package/dist/rateLimit.d.ts +20 -0
- package/dist/rateLimit.js +70 -0
- package/dist/referralCredits.d.ts +5 -0
- package/{src/referralCredits.ts → dist/referralCredits.js} +27 -34
- package/dist/referralGrant.d.ts +49 -0
- package/dist/referralGrant.js +268 -0
- package/dist/rescheduleCredit.d.ts +98 -0
- package/dist/rescheduleCredit.js +263 -0
- package/dist/reservationWifiCode.d.ts +19 -0
- package/{src/reservationWifiCode.ts → dist/reservationWifiCode.js} +67 -81
- package/dist/retellCallAnalyzed.d.ts +18 -0
- package/dist/retellCallAnalyzed.js +91 -0
- package/dist/retellSignature.d.ts +14 -0
- package/dist/retellSignature.js +60 -0
- package/dist/signedUnpaidReminderEmail.d.ts +15 -0
- package/dist/signedUnpaidReminderEmail.js +111 -0
- package/dist/slackAlert.d.ts +13 -0
- package/dist/slackAlert.js +37 -0
- package/dist/stripeCoworkingPortal.d.ts +21 -0
- package/dist/stripeCoworkingPortal.js +80 -0
- package/dist/supabaseTestFakes.d.ts +67 -0
- package/dist/supabaseTestFakes.js +79 -0
- package/dist/supportTicketEmail.d.ts +16 -0
- package/dist/supportTicketEmail.js +98 -0
- package/dist/tier1Agreement.d.ts +51 -0
- package/dist/tier1Agreement.js +86 -0
- package/dist/unifiAccessPolicies.d.ts +36 -0
- package/dist/unifiAccessPolicies.js +185 -0
- package/dist/unifiGroups.d.ts +26 -0
- package/dist/unifiGroups.js +106 -0
- package/package.json +653 -169
- package/src/adminBookingCredit.test.ts +0 -451
- package/src/adminBookingCredit.ts +0 -239
- package/src/agreementCheckout.ts +0 -250
- package/src/agreementPortalEmail.ts +0 -128
- package/src/availability.test.ts +0 -25
- package/src/availability.ts +0 -201
- package/src/billingPortalLinkEmail.ts +0 -117
- package/src/bookingAgreementEmail.ts +0 -149
- package/src/bookingEffects.ts +0 -388
- package/src/bookingHoldReclaim.ts +0 -94
- package/src/busClient.ts +0 -268
- package/src/checkoutCoupon.test.ts +0 -675
- package/src/checkoutCoupon.ts +0 -455
- package/src/checkoutSessionParams.ts +0 -56
- package/src/commonsContract.ts +0 -175
- package/src/commonsDeposit.ts +0 -298
- package/src/commonsDepositWebhook.ts +0 -237
- package/src/conductorAdmin.ts +0 -141
- package/src/dayPassConfirmation.ts +0 -230
- package/src/dunningEmails.test.ts +0 -263
- package/src/dunningEmails.ts +0 -203
- package/src/email-templates/brand.ts +0 -93
- package/src/email-templates/email-change.tsx +0 -92
- package/src/email-templates/invite.tsx +0 -79
- package/src/email-templates/magic-link.tsx +0 -59
- package/src/email-templates/reauthentication.tsx +0 -60
- package/src/email-templates/recovery.tsx +0 -59
- package/src/email-templates/signup.tsx +0 -67
- package/src/functions/admin-cancel-membership.ts +0 -311
- package/src/functions/admin-change-membership-plan.ts +0 -312
- package/src/functions/admin-charge-guest-print.ts +0 -229
- package/src/functions/admin-correct-booking.ts +0 -333
- package/src/functions/admin-create-booking.ts +0 -460
- package/src/functions/admin-create-commons-event.ts +0 -244
- package/src/functions/admin-debug-boldsign-doc.ts +0 -93
- package/src/functions/admin-door-write.ts +0 -272
- package/src/functions/admin-issue-day-pass.ts +0 -231
- package/src/functions/admin-mark-booking-paid.ts +0 -203
- package/src/functions/admin-mint-billing-portal-link.ts +0 -168
- package/src/functions/admin-mint-portal-link.ts +0 -62
- package/src/functions/admin-photo-upload.ts +0 -128
- package/src/functions/admin-remove-team-member.ts +0 -150
- package/src/functions/admin-request-trial.ts +0 -366
- package/src/functions/admin-resend-commons-deposit-link.ts +0 -323
- package/src/functions/admin-reset-mfa.ts +0 -138
- package/src/functions/admin-retry-invoice-payment.test.ts +0 -567
- package/src/functions/admin-retry-invoice-payment.ts +0 -333
- package/src/functions/admin-reverse-coupon-redemption.ts +0 -98
- package/src/functions/admin-revoke-agreement.ts +0 -467
- package/src/functions/admin-send-commons-agreement.ts +0 -214
- package/src/functions/admin-set-credit-amount.ts +0 -123
- package/src/functions/admin-skip-commons-contract.ts +0 -165
- package/src/functions/admin-undo-membership-cancel.ts +0 -144
- package/src/functions/admin-wall-photo-write.ts +0 -141
- package/src/functions/auth-email-hook.ts +0 -259
- package/src/functions/boldsign-sender-identity.ts +0 -114
- package/src/functions/booking-availability.ts +0 -419
- package/src/functions/booking-member-preview.ts +0 -136
- package/src/functions/booking-status.ts +0 -149
- package/src/functions/conductor.ts +0 -505
- package/src/functions/create-agreement.ts +0 -537
- package/src/functions/create-booking.ts +0 -648
- package/src/functions/create-day-pass-checkout.ts +0 -218
- package/src/functions/create-portal-session.ts +0 -142
- package/src/functions/create-subscription-checkout.test.ts +0 -222
- package/src/functions/create-subscription-checkout.ts +0 -440
- package/src/functions/day-pass-status.ts +0 -89
- package/src/functions/dayStatus.ts +0 -71
- package/src/functions/diag-webpush-test.ts +0 -45
- package/src/functions/event-access-admin.ts +0 -277
- package/src/functions/event-access-store.ts +0 -334
- package/src/functions/ezeep-print-webhook.ts +0 -213
- package/src/functions/ezeep-usage-reconcile.ts +0 -299
- package/src/functions/fetch-avatar-original.ts +0 -457
- package/src/functions/get-provider-sign-link.ts +0 -155
- package/src/functions/get-signing-link.ts +0 -211
- package/src/functions/guest-print-setup-confirm.ts +0 -128
- package/src/functions/guest-print-submit.ts +0 -149
- package/src/functions/luma-webhook.ts +0 -165
- package/src/functions/manage-booking.ts +0 -472
- package/src/functions/mcp.ts +0 -67
- package/src/functions/member-door-action.test.ts +0 -1248
- package/src/functions/member-door-action.ts +0 -863
- package/src/functions/member-unifi-mapping.test.ts +0 -516
- package/src/functions/member-unifi-mapping.ts +0 -206
- package/src/functions/membership-door-sync.ts +0 -956
- package/src/functions/migration-collision-alert.copy.ts +0 -232
- package/src/functions/migration-collision-alert.test.ts +0 -349
- package/src/functions/migration-collision-alert.ts +0 -232
- package/src/functions/office-assignment-end.ts +0 -146
- package/src/functions/portal-booking-access.ts +0 -217
- package/src/functions/portal-list-invoices.ts +0 -99
- package/src/functions/portal-request-login.ts +0 -219
- package/src/functions/portal-resend-invite.ts +0 -248
- package/src/functions/portal-submit-event.ts +0 -168
- package/src/functions/print-billing-recover.ts +0 -97
- package/src/functions/print-billing-run.ts +0 -183
- package/src/functions/public-facts.ts +0 -168
- package/src/functions/push-send.ts +0 -348
- package/src/functions/push-test.ts +0 -234
- package/src/functions/request-portal-link.ts +0 -211
- package/src/functions/reschedule-booking.ts +0 -649
- package/src/functions/review-ratings.ts +0 -113
- package/src/functions/space-availability-range.acceptance.test.ts +0 -161
- package/src/functions/space-availability-range.ts +0 -142
- package/src/functions/stripe-db-reconcile.ts +0 -319
- package/src/functions/stripe-webhook.moved-regression.test.ts +0 -78
- package/src/functions/stripe-webhook.ts +0 -2595
- package/src/functions/sync-gcal-blackouts.ts +0 -298
- package/src/functions/timetable-event-register.ts +0 -162
- package/src/functions/timetable-event-status.ts +0 -90
- package/src/functions/timetable-spaces.ts +0 -219
- package/src/functions/touch-pass-reconciler.ts +0 -689
- package/src/functions/touch-pass-signup.ts +0 -478
- package/src/functions/upload-booking-display-image.ts +0 -179
- package/src/functions/virtual-onboarding-purge.ts +0 -134
- package/src/functions/virtual-onboarding-submit.ts +0 -315
- package/src/functions/voice-booking.ts +0 -453
- package/src/functions/voice-day-pass.ts +0 -346
- package/src/functions/voice-inquiry.test.ts +0 -301
- package/src/functions/voice-inquiry.ts +0 -198
- package/src/functions/voice-membership-signup.ts +0 -355
- package/src/functions/voice-tour-availability.ts +0 -204
- package/src/functions/voice-tour-booking.ts +0 -429
- package/src/gcalSync.ts +0 -142
- package/src/ghlEventInquiry.ts +0 -143
- package/src/ghlNote.ts +0 -34
- package/src/ghlTask.ts +0 -48
- package/src/ghlVoiceInquiry.ts +0 -90
- package/src/guestPrintCapture.test.ts +0 -722
- package/src/guestPrintCapture.ts +0 -538
- package/src/lumaGhl.ts +0 -195
- package/src/mailArrivalEmail.ts +0 -121
- package/src/manageToken.ts +0 -363
- package/src/membership.ts +0 -109
- package/src/membershipBusClient.ts +0 -537
- package/src/membershipWelcome.ts +0 -683
- package/src/migrationCheckout.ts +0 -366
- package/src/money.ts +0 -36
- package/src/ops.ts +0 -97
- package/src/paymentLinkEmail.ts +0 -123
- package/src/policyAcknowledgment.test.ts +0 -50
- package/src/policyAcknowledgment.ts +0 -96
- package/src/portalSession.ts +0 -46
- package/src/pricing.test.ts +0 -660
- package/src/pricing.ts +0 -1025
- package/src/printBilling.test.ts +0 -750
- package/src/printBilling.ts +0 -891
- package/src/printBillingAdapters.ts +0 -169
- package/src/printCorrections.test.ts +0 -348
- package/src/printCorrections.ts +0 -496
- package/src/rateLimit.ts +0 -82
- package/src/referralCredits.test.ts +0 -31
- package/src/referralGrant.ts +0 -321
- package/src/rescheduleCredit.test.ts +0 -521
- package/src/rescheduleCredit.ts +0 -337
- package/src/reservationWifiCode.test.ts +0 -69
- package/src/retellCallAnalyzed.test.ts +0 -167
- package/src/retellCallAnalyzed.ts +0 -113
- package/src/retellSignature.test.ts +0 -137
- package/src/retellSignature.ts +0 -82
- package/src/signedUnpaidReminderEmail.test.ts +0 -246
- package/src/signedUnpaidReminderEmail.ts +0 -132
- package/src/slackAlert.ts +0 -38
- package/src/stripeCoworkingPortal.ts +0 -91
- package/src/supabaseTestFakes.ts +0 -131
- package/src/supportTicketEmail.ts +0 -119
- package/src/tier1Agreement.ts +0 -125
- package/src/unifiAccessPolicies.ts +0 -228
- 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 {};
|