@simplelayer/graniteer-core 0.2.1 → 0.2.2

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 (124) hide show
  1. package/index.js +2 -2
  2. package/package.json +1 -1
  3. package/src/agreementCheckout.ts +250 -250
  4. package/src/agreementPortalEmail.ts +128 -128
  5. package/src/billingPortalLinkEmail.ts +117 -117
  6. package/src/bookingAgreementEmail.ts +149 -149
  7. package/src/bookingEffects.ts +388 -388
  8. package/src/busClient.ts +268 -268
  9. package/src/busSignature.ts +71 -71
  10. package/src/checkoutCoupon.test.ts +675 -675
  11. package/src/checkoutCoupon.ts +455 -455
  12. package/src/commonsDeposit.ts +298 -298
  13. package/src/commonsDepositWebhook.ts +237 -237
  14. package/src/dayPassConfirmation.ts +230 -230
  15. package/src/dunningEmails.test.ts +263 -263
  16. package/src/dunningEmails.ts +203 -203
  17. package/src/email-templates/brand.ts +93 -93
  18. package/src/email-templates/magic-link.tsx +59 -59
  19. package/src/email-templates/recovery.tsx +59 -59
  20. package/src/email-templates/signup.tsx +67 -67
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -312
  23. package/src/functions/admin-charge-guest-print.ts +229 -229
  24. package/src/functions/admin-correct-booking.ts +333 -333
  25. package/src/functions/admin-create-booking.ts +460 -460
  26. package/src/functions/admin-create-commons-event.ts +244 -244
  27. package/src/functions/admin-debug-boldsign-doc.ts +93 -93
  28. package/src/functions/admin-door-write.ts +272 -272
  29. package/src/functions/admin-issue-day-pass.ts +231 -231
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -168
  32. package/src/functions/admin-mint-portal-link.ts +62 -62
  33. package/src/functions/admin-photo-upload.ts +128 -128
  34. package/src/functions/admin-remove-team-member.ts +150 -150
  35. package/src/functions/admin-request-trial.ts +366 -366
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -323
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.ts +333 -333
  39. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  40. package/src/functions/admin-revoke-agreement.ts +467 -467
  41. package/src/functions/admin-send-commons-agreement.ts +214 -214
  42. package/src/functions/admin-set-credit-amount.ts +123 -123
  43. package/src/functions/admin-skip-commons-contract.ts +165 -165
  44. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  45. package/src/functions/admin-wall-photo-write.ts +141 -141
  46. package/src/functions/auth-email-hook.ts +259 -259
  47. package/src/functions/boldsign-sender-identity.ts +114 -114
  48. package/src/functions/booking-availability.ts +419 -419
  49. package/src/functions/booking-member-preview.ts +136 -136
  50. package/src/functions/booking-status.ts +149 -149
  51. package/src/functions/create-booking.ts +648 -648
  52. package/src/functions/create-day-pass-checkout.ts +218 -218
  53. package/src/functions/create-portal-session.ts +142 -142
  54. package/src/functions/create-subscription-checkout.test.ts +222 -222
  55. package/src/functions/create-subscription-checkout.ts +440 -440
  56. package/src/functions/day-pass-status.ts +89 -89
  57. package/src/functions/diag-webpush-test.ts +45 -45
  58. package/src/functions/event-access-admin.ts +277 -277
  59. package/src/functions/event-access-store.ts +334 -334
  60. package/src/functions/ezeep-print-webhook.ts +213 -213
  61. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  62. package/src/functions/fetch-avatar-original.ts +457 -457
  63. package/src/functions/get-provider-sign-link.ts +155 -155
  64. package/src/functions/get-signing-link.ts +211 -211
  65. package/src/functions/guest-print-setup-confirm.ts +128 -128
  66. package/src/functions/guest-print-submit.ts +149 -149
  67. package/src/functions/luma-webhook.ts +165 -165
  68. package/src/functions/mcp.ts +67 -67
  69. package/src/functions/member-door-action.test.ts +1248 -1248
  70. package/src/functions/member-door-action.ts +863 -863
  71. package/src/functions/member-unifi-mapping.test.ts +516 -516
  72. package/src/functions/member-unifi-mapping.ts +206 -206
  73. package/src/functions/membership-door-sync.ts +956 -956
  74. package/src/functions/migration-collision-alert.copy.ts +232 -232
  75. package/src/functions/migration-collision-alert.test.ts +349 -349
  76. package/src/functions/migration-collision-alert.ts +232 -232
  77. package/src/functions/office-assignment-end.ts +146 -146
  78. package/src/functions/portal-booking-access.ts +217 -217
  79. package/src/functions/portal-list-invoices.ts +99 -99
  80. package/src/functions/portal-request-login.ts +219 -192
  81. package/src/functions/portal-resend-invite.ts +248 -248
  82. package/src/functions/portal-submit-event.ts +168 -168
  83. package/src/functions/print-billing-recover.ts +97 -97
  84. package/src/functions/print-billing-run.ts +183 -183
  85. package/src/functions/public-facts.ts +168 -168
  86. package/src/functions/push-send.ts +348 -348
  87. package/src/functions/push-test.ts +234 -234
  88. package/src/functions/request-portal-link.ts +211 -211
  89. package/src/functions/review-ratings.ts +113 -113
  90. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  91. package/src/functions/space-availability-range.ts +142 -142
  92. package/src/functions/stripe-db-reconcile.ts +319 -319
  93. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -78
  94. package/src/functions/stripe-webhook.ts +2595 -2595
  95. package/src/functions/sync-gcal-blackouts.ts +298 -298
  96. package/src/functions/timetable-event-register.ts +162 -162
  97. package/src/functions/timetable-event-status.ts +90 -90
  98. package/src/functions/timetable-spaces.ts +219 -219
  99. package/src/functions/touch-pass-reconciler.ts +689 -689
  100. package/src/functions/touch-pass-signup.ts +478 -478
  101. package/src/functions/upload-booking-display-image.ts +179 -179
  102. package/src/functions/virtual-onboarding-purge.ts +134 -134
  103. package/src/functions/virtual-onboarding-submit.ts +315 -315
  104. package/src/functions/voice-booking.ts +453 -453
  105. package/src/functions/voice-day-pass.ts +346 -346
  106. package/src/functions/voice-inquiry.test.ts +301 -301
  107. package/src/functions/voice-inquiry.ts +198 -198
  108. package/src/functions/voice-membership-signup.ts +355 -355
  109. package/src/functions/voice-tour-availability.ts +204 -204
  110. package/src/functions/voice-tour-booking.ts +429 -429
  111. package/src/ghlEventInquiry.ts +143 -143
  112. package/src/mailArrivalEmail.ts +121 -121
  113. package/src/manageToken.ts +363 -363
  114. package/src/membershipBusClient.ts +537 -537
  115. package/src/membershipWelcome.ts +683 -683
  116. package/src/migrationCheckout.ts +366 -366
  117. package/src/paymentLinkEmail.ts +123 -123
  118. package/src/signedUnpaidReminderEmail.test.ts +246 -246
  119. package/src/signedUnpaidReminderEmail.ts +132 -132
  120. package/src/stripeCoworkingPortal.ts +91 -91
  121. package/src/supabaseTestFakes.ts +131 -131
  122. package/src/supportTicketEmail.ts +119 -119
  123. package/src/unifiAccessPolicies.ts +228 -228
  124. package/src/unifiGroups.ts +129 -129
@@ -1,168 +1,168 @@
1
- // Member-portal event submission -> gc-events-hub member-submit route.
2
- //
3
- // Trust boundary: this function signs the submitter's identity (email + name)
4
- // server-side from the portal session, then forwards it to gc-events-hub's
5
- // authenticated /submit/member route via a shared-secret HMAC. gc-events-hub
6
- // still lands every submission `pending` for staff review -- the signature
7
- // only proves "this came from a real member session", it never auto-approves
8
- // anything.
9
- //
10
- // Signature scheme MUST match gc-events-hub's verifyMemberSignature exactly:
11
- // Member-Signature: t=<unix_seconds>,kid=<1|2>,v1=<hex hmac>
12
- // HMAC-SHA256 over `${t}.${method}.${path}.${rawBody}`, hex-encoded.
13
- // This is a fourth, byte-distinct HMAC construction alongside busClient's v1
14
- // (b64url) and portal-resend-invite's r1 (b64url) -- do not merge or reuse
15
- // their helpers; the receiver (gc-events-hub, a separate Cloudflare
16
- // Worker/D1 codebase) expects hex, not base64url.
17
- import { createClient } from 'npm:@supabase/supabase-js@2';
18
- import { resolvePortalSession } from 'npm:@simplelayer/graniteer-core/portalSession';
19
- import { checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
20
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
21
-
22
- const corsHeaders = {
23
- 'Access-Control-Allow-Origin': '*',
24
- 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
25
- 'Access-Control-Allow-Methods': 'POST, OPTIONS',
26
- };
27
-
28
- const SUBMIT_PATH = '/submit/member';
29
- const TIMEOUT_MS = 10_000;
30
-
31
- export interface PortalSubmitEventConfig {
32
- eventsHubBase: string;
33
- }
34
-
35
- function json(status: number, body: unknown) {
36
- return new Response(JSON.stringify(body), {
37
- status,
38
- headers: { ...corsHeaders, 'Content-Type': 'application/json' },
39
- });
40
- }
41
-
42
- function toHex(buf: ArrayBuffer): string {
43
- return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, '0')).join('');
44
- }
45
-
46
- async function signMemberSubmit(
47
- method: string, path: string, rawBody: string, secret: string, ts: number,
48
- ): Promise<string> {
49
- const payload = `${ts}.${method}.${path}.${rawBody}`;
50
- const key = await crypto.subtle.importKey(
51
- 'raw', new TextEncoder().encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign'],
52
- );
53
- const sig = await crypto.subtle.sign('HMAC', key, new TextEncoder().encode(payload));
54
- return toHex(sig);
55
- }
56
-
57
- export async function handle(req: Request, config: PortalSubmitEventConfig): Promise<Response> {
58
- if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
59
- if (req.method !== 'POST') return json(405, { error: 'method_not_allowed' });
60
-
61
- const admin = createClient(
62
- Deno.env.get('SUPABASE_URL')!,
63
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
64
- { auth: { persistSession: false, autoRefreshToken: false } },
65
- );
66
-
67
- try {
68
- const session = await resolvePortalSession(req, admin);
69
- if (!session) return json(401, { error: 'unauthorized' });
70
- const email = session.email.toLowerCase();
71
-
72
- const ok = await checkRateLimit(admin, 'portal-submit-event', email, 10, 3600);
73
- if (!ok) return json(429, { error: 'rate_limited' });
74
-
75
- let body: Record<string, unknown>;
76
- try {
77
- body = await req.json();
78
- } catch {
79
- return json(400, { error: 'invalid_json' });
80
- }
81
-
82
- const title = typeof body.title === 'string' ? body.title.trim() : '';
83
- const startAt = typeof body.start_at === 'string' ? body.start_at.trim() : '';
84
- if (!title || !startAt) return json(400, { error: 'missing_required_fields' });
85
- if (isNaN(Date.parse(startAt))) return json(400, { error: 'invalid_start_at' });
86
-
87
- const description = typeof body.description === 'string' ? body.description.slice(0, 2000) : '';
88
- const endAt = typeof body.end_at === 'string' && !isNaN(Date.parse(body.end_at)) ? body.end_at : undefined;
89
- const locationText = typeof body.location_text === 'string' ? body.location_text.slice(0, 200) : '';
90
- const sourceUrl = typeof body.source_url === 'string' ? body.source_url.slice(0, 500) : '';
91
-
92
- // Name/email are NEVER taken from the request body -- always the verified
93
- // portal session, matching portal-resend-invite's identity model.
94
- // PLURALITY: never .maybeSingle() here -- supabase-js returns data:null when
95
- // >1 row matches, so a member with two memberships would silently lose their
96
- // display name and submit as a bare email. Oldest-first + limit(1), matching
97
- // _shared/membership.ts's "THE OLDEST ENTITLED MEMBERSHIP PAYS" intent.
98
- const { data: membershipRows, error: membershipErr } = await admin
99
- .from('memberships')
100
- .select('customer_name')
101
- .eq('auth_user_id', session.id)
102
- .order('created_at', { ascending: true })
103
- .limit(1);
104
- if (membershipErr) {
105
- await logOps(admin, 'portal_submit_event_membership_lookup_failed',
106
- { email, message: membershipErr.message }, { severity: 'warning' });
107
- }
108
- const membership = (membershipRows ?? [])[0];
109
- const submitterName = (membership?.customer_name as string | null)?.trim() || email;
110
-
111
- const secret = Deno.env.get('MEMBER_EVENTS_HUB_SECRET');
112
- if (!secret) {
113
- await logOps(admin, 'portal_submit_event_not_configured', {}, { severity: 'error' });
114
- return json(503, { error: 'not_configured' });
115
- }
116
-
117
- const payload: Record<string, unknown> = {
118
- title,
119
- description,
120
- start_at: startAt,
121
- submitter_email: email,
122
- submitter_name: submitterName,
123
- };
124
- if (endAt) payload.end_at = endAt;
125
- if (locationText) payload.location_text = locationText;
126
- if (sourceUrl) payload.source_url = sourceUrl;
127
-
128
- const rawBody = JSON.stringify(payload);
129
- const ts = Math.floor(Date.now() / 1000);
130
- const sig = await signMemberSubmit('POST', SUBMIT_PATH, rawBody, secret, ts);
131
-
132
- const res = await fetch(`${config.eventsHubBase}${SUBMIT_PATH}`, {
133
- method: 'POST',
134
- headers: {
135
- 'Content-Type': 'application/json',
136
- 'Member-Signature': `t=${ts},kid=1,v1=${sig}`,
137
- },
138
- body: rawBody,
139
- signal: AbortSignal.timeout(TIMEOUT_MS),
140
- });
141
-
142
- const text = await res.text();
143
- let parsed: Record<string, unknown> = {};
144
- try { parsed = text ? JSON.parse(text) : {}; } catch { parsed = {}; }
145
-
146
- if (!res.ok) {
147
- await logOps(admin, 'portal_submit_event_upstream_failed', {
148
- status: res.status, detail: text.slice(0, 300),
149
- }, { severity: 'error' });
150
- return json(502, { error: 'submit_failed' });
151
- }
152
-
153
- return json(200, {
154
- ok: true,
155
- id: typeof parsed.id === 'string' ? parsed.id : undefined,
156
- message: typeof parsed.message === 'string'
157
- ? parsed.message
158
- : "Thanks — our team reviews submissions before they go on the calendar.",
159
- });
160
- } catch (e) {
161
- try {
162
- await logOps(admin, 'portal_submit_event_error', {
163
- message: e instanceof Error ? e.message : String(e),
164
- }, { severity: 'error' });
165
- } catch { /* ignore */ }
166
- return json(502, { error: 'submit_failed' });
167
- }
168
- }
1
+ // Member-portal event submission -> gc-events-hub member-submit route.
2
+ //
3
+ // Trust boundary: this function signs the submitter's identity (email + name)
4
+ // server-side from the portal session, then forwards it to gc-events-hub's
5
+ // authenticated /submit/member route via a shared-secret HMAC. gc-events-hub
6
+ // still lands every submission `pending` for staff review -- the signature
7
+ // only proves "this came from a real member session", it never auto-approves
8
+ // anything.
9
+ //
10
+ // Signature scheme MUST match gc-events-hub's verifyMemberSignature exactly:
11
+ // Member-Signature: t=<unix_seconds>,kid=<1|2>,v1=<hex hmac>
12
+ // HMAC-SHA256 over `${t}.${method}.${path}.${rawBody}`, hex-encoded.
13
+ // This is a fourth, byte-distinct HMAC construction alongside busClient's v1
14
+ // (b64url) and portal-resend-invite's r1 (b64url) -- do not merge or reuse
15
+ // their helpers; the receiver (gc-events-hub, a separate Cloudflare
16
+ // Worker/D1 codebase) expects hex, not base64url.
17
+ import { createClient } from 'npm:@supabase/supabase-js@2';
18
+ import { resolvePortalSession } from 'npm:@simplelayer/graniteer-core/portalSession';
19
+ import { checkRateLimit } from 'npm:@simplelayer/graniteer-core/rateLimit';
20
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
21
+
22
+ const corsHeaders = {
23
+ 'Access-Control-Allow-Origin': '*',
24
+ 'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type',
25
+ 'Access-Control-Allow-Methods': 'POST, OPTIONS',
26
+ };
27
+
28
+ const SUBMIT_PATH = '/submit/member';
29
+ const TIMEOUT_MS = 10_000;
30
+
31
+ export interface PortalSubmitEventConfig {
32
+ eventsHubBase: string;
33
+ }
34
+
35
+ function json(status: number, body: unknown) {
36
+ return new Response(JSON.stringify(body), {
37
+ status,
38
+ headers: { ...corsHeaders, 'Content-Type': 'application/json' },
39
+ });
40
+ }
41
+
42
+ function toHex(buf: ArrayBuffer): string {
43
+ return Array.from(new Uint8Array(buf)).map((b) => b.toString(16).padStart(2, '0')).join('');
44
+ }
45
+
46
+ async function signMemberSubmit(
47
+ method: string, path: string, rawBody: string, secret: string, ts: number,
48
+ ): Promise<string> {
49
+ const payload = `${ts}.${method}.${path}.${rawBody}`;
50
+ const key = await crypto.subtle.importKey(
51
+ 'raw', new TextEncoder().encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign'],
52
+ );
53
+ const sig = await crypto.subtle.sign('HMAC', key, new TextEncoder().encode(payload));
54
+ return toHex(sig);
55
+ }
56
+
57
+ export async function handle(req: Request, config: PortalSubmitEventConfig): Promise<Response> {
58
+ if (req.method === 'OPTIONS') return new Response('ok', { headers: corsHeaders });
59
+ if (req.method !== 'POST') return json(405, { error: 'method_not_allowed' });
60
+
61
+ const admin = createClient(
62
+ Deno.env.get('SUPABASE_URL')!,
63
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
64
+ { auth: { persistSession: false, autoRefreshToken: false } },
65
+ );
66
+
67
+ try {
68
+ const session = await resolvePortalSession(req, admin);
69
+ if (!session) return json(401, { error: 'unauthorized' });
70
+ const email = session.email.toLowerCase();
71
+
72
+ const ok = await checkRateLimit(admin, 'portal-submit-event', email, 10, 3600);
73
+ if (!ok) return json(429, { error: 'rate_limited' });
74
+
75
+ let body: Record<string, unknown>;
76
+ try {
77
+ body = await req.json();
78
+ } catch {
79
+ return json(400, { error: 'invalid_json' });
80
+ }
81
+
82
+ const title = typeof body.title === 'string' ? body.title.trim() : '';
83
+ const startAt = typeof body.start_at === 'string' ? body.start_at.trim() : '';
84
+ if (!title || !startAt) return json(400, { error: 'missing_required_fields' });
85
+ if (isNaN(Date.parse(startAt))) return json(400, { error: 'invalid_start_at' });
86
+
87
+ const description = typeof body.description === 'string' ? body.description.slice(0, 2000) : '';
88
+ const endAt = typeof body.end_at === 'string' && !isNaN(Date.parse(body.end_at)) ? body.end_at : undefined;
89
+ const locationText = typeof body.location_text === 'string' ? body.location_text.slice(0, 200) : '';
90
+ const sourceUrl = typeof body.source_url === 'string' ? body.source_url.slice(0, 500) : '';
91
+
92
+ // Name/email are NEVER taken from the request body -- always the verified
93
+ // portal session, matching portal-resend-invite's identity model.
94
+ // PLURALITY: never .maybeSingle() here -- supabase-js returns data:null when
95
+ // >1 row matches, so a member with two memberships would silently lose their
96
+ // display name and submit as a bare email. Oldest-first + limit(1), matching
97
+ // _shared/membership.ts's "THE OLDEST ENTITLED MEMBERSHIP PAYS" intent.
98
+ const { data: membershipRows, error: membershipErr } = await admin
99
+ .from('memberships')
100
+ .select('customer_name')
101
+ .eq('auth_user_id', session.id)
102
+ .order('created_at', { ascending: true })
103
+ .limit(1);
104
+ if (membershipErr) {
105
+ await logOps(admin, 'portal_submit_event_membership_lookup_failed',
106
+ { email, message: membershipErr.message }, { severity: 'warning' });
107
+ }
108
+ const membership = (membershipRows ?? [])[0];
109
+ const submitterName = (membership?.customer_name as string | null)?.trim() || email;
110
+
111
+ const secret = Deno.env.get('MEMBER_EVENTS_HUB_SECRET');
112
+ if (!secret) {
113
+ await logOps(admin, 'portal_submit_event_not_configured', {}, { severity: 'error' });
114
+ return json(503, { error: 'not_configured' });
115
+ }
116
+
117
+ const payload: Record<string, unknown> = {
118
+ title,
119
+ description,
120
+ start_at: startAt,
121
+ submitter_email: email,
122
+ submitter_name: submitterName,
123
+ };
124
+ if (endAt) payload.end_at = endAt;
125
+ if (locationText) payload.location_text = locationText;
126
+ if (sourceUrl) payload.source_url = sourceUrl;
127
+
128
+ const rawBody = JSON.stringify(payload);
129
+ const ts = Math.floor(Date.now() / 1000);
130
+ const sig = await signMemberSubmit('POST', SUBMIT_PATH, rawBody, secret, ts);
131
+
132
+ const res = await fetch(`${config.eventsHubBase}${SUBMIT_PATH}`, {
133
+ method: 'POST',
134
+ headers: {
135
+ 'Content-Type': 'application/json',
136
+ 'Member-Signature': `t=${ts},kid=1,v1=${sig}`,
137
+ },
138
+ body: rawBody,
139
+ signal: AbortSignal.timeout(TIMEOUT_MS),
140
+ });
141
+
142
+ const text = await res.text();
143
+ let parsed: Record<string, unknown> = {};
144
+ try { parsed = text ? JSON.parse(text) : {}; } catch { parsed = {}; }
145
+
146
+ if (!res.ok) {
147
+ await logOps(admin, 'portal_submit_event_upstream_failed', {
148
+ status: res.status, detail: text.slice(0, 300),
149
+ }, { severity: 'error' });
150
+ return json(502, { error: 'submit_failed' });
151
+ }
152
+
153
+ return json(200, {
154
+ ok: true,
155
+ id: typeof parsed.id === 'string' ? parsed.id : undefined,
156
+ message: typeof parsed.message === 'string'
157
+ ? parsed.message
158
+ : "Thanks — our team reviews submissions before they go on the calendar.",
159
+ });
160
+ } catch (e) {
161
+ try {
162
+ await logOps(admin, 'portal_submit_event_error', {
163
+ message: e instanceof Error ? e.message : String(e),
164
+ }, { severity: 'error' });
165
+ } catch { /* ignore */ }
166
+ return json(502, { error: 'submit_failed' });
167
+ }
168
+ }
@@ -1,97 +1,97 @@
1
- // supabase/functions/print-billing-recover/index.ts
2
- //
3
- // print-usage-bill P2 — the recovery sweep. Design: PRINT-USAGE-BILL-DESIGN.md
4
- // v19 section 5.
5
- //
6
- // RUNS EVERY 5 MINUTES, PERMANENTLY — not monthly (section 5.1, cadence PINNED by
7
- // R6 finding 2). The run itself is monthly; recovery is not. Two reasons, both
8
- // load-bearing:
9
- // 1. It is what makes ORACLE LAYER 3 (idempotency-key replay, which Stripe
10
- // expires at 24h) reachable at all. At a monthly cadence that layer is dead.
11
- // 2. It bounds the time a crashed run sits unresolved to minutes rather than a
12
- // month, during which its membership cannot be billed at all.
13
- //
14
- // Every run this picks up arrives with NO recorded failure origin — section 5.2
15
- // selects purely on lease age, and there is deliberately no failure_origin column
16
- // (section 4.4.1). So section 4.4 rows 23-25 are the COMMON path here, not an exotic
17
- // one, and every decision is made by the ORACLE and the run's persisted status.
18
- // The question is always what actually happened, never what we intended.
19
-
20
- import Stripe from 'npm:stripe@17.5.0';
21
- import { createClient } from 'npm:@supabase/supabase-js@2';
22
- import { runRecoverySweep, type RunInput, type RunRow } from 'npm:@simplelayer/graniteer-core/printBilling';
23
- import { makeDb, makeStripe } from 'npm:@simplelayer/graniteer-core/printBillingAdapters';
24
-
25
- function safeEqual(a: string, b: string): boolean {
26
- const enc = new TextEncoder();
27
- const ab = enc.encode(a), bb = enc.encode(b);
28
- if (ab.length !== bb.length) return false;
29
- let diff = 0;
30
- for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
31
- return diff === 0;
32
- }
33
-
34
- export async function handle(req: Request): Promise<Response> {
35
- const supabase = createClient(
36
- Deno.env.get('SUPABASE_URL')!,
37
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
38
- );
39
-
40
- const { data: secret } = await supabase.rpc('get_print_billing_run_secret');
41
- const provided = req.headers.get('x-gc-print-billing-secret') ?? '';
42
- if (!secret || !safeEqual(String(secret), provided)) {
43
- return new Response(JSON.stringify({ ok: false, error: 'forbidden' }), {
44
- status: 403, headers: { 'Content-Type': 'application/json' },
45
- });
46
- }
47
-
48
- const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
49
- const expectedAccountId = Deno.env.get('STRIPE_ACCOUNT_ID');
50
- if (!stripeKey || !expectedAccountId) {
51
- return new Response(JSON.stringify({ ok: false, error: 'stripe_config_missing' }), {
52
- status: 500, headers: { 'Content-Type': 'application/json' },
53
- });
54
- }
55
-
56
- const stripe = makeStripe(
57
- new Stripe(stripeKey, { apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion }),
58
- );
59
- const db = makeDb(supabase as never);
60
-
61
- // section 5.3's escalation ladder. A held run gets LOUDER rather than expiring —
62
- // an automatic expiry that frees the periods is exactly what created the
63
- // double-charge hole in R7 F4 / R8 F2. warning -> error at 24h -> critical at 7d.
64
- // The ladder now ends somewhere: public.print_run_resolve (M-21), surfaced in
65
- // the admin panel as "Resolve held run".
66
- await supabase.rpc('print_billing_escalate_stuck');
67
-
68
- const results = await runRecoverySweep({
69
- stripe,
70
- db,
71
- expectedAccountId,
72
- expectedLivemode: (Deno.env.get('ENVIRONMENT') ?? '') === 'production',
73
-
74
- // Rebuild the RunInput a recovered run needs to resume. period_ids is the
75
- // snapshot taken at claim time and never revised; STEP 3.1 re-checks each
76
- // period is still claimed by this run before posting its item (v17/B11-1).
77
- loadRunInput: async (run: RunRow): Promise<RunInput> => {
78
- const { data: months } = await supabase.rpc('print_billing_run_months',
79
- { p_run_id: run.id });
80
- return {
81
- runId: run.id,
82
- membershipId: run.membership_id,
83
- customerId: run.stripe_customer_id,
84
- periodIds: run.period_ids,
85
- periodMonths: (months ?? []) as string[],
86
- amountCents: 0, // not re-asserted on resume; the claim already did
87
- defaultPaymentMethod: null, // the invoice already exists by this point
88
- expectedAccountId,
89
- expectedLivemode: (Deno.env.get('ENVIRONMENT') ?? '') === 'production',
90
- };
91
- },
92
- });
93
-
94
- return new Response(JSON.stringify({ ok: true, swept: results.length, results }), {
95
- headers: { 'Content-Type': 'application/json' },
96
- });
97
- }
1
+ // supabase/functions/print-billing-recover/index.ts
2
+ //
3
+ // print-usage-bill P2 — the recovery sweep. Design: PRINT-USAGE-BILL-DESIGN.md
4
+ // v19 section 5.
5
+ //
6
+ // RUNS EVERY 5 MINUTES, PERMANENTLY — not monthly (section 5.1, cadence PINNED by
7
+ // R6 finding 2). The run itself is monthly; recovery is not. Two reasons, both
8
+ // load-bearing:
9
+ // 1. It is what makes ORACLE LAYER 3 (idempotency-key replay, which Stripe
10
+ // expires at 24h) reachable at all. At a monthly cadence that layer is dead.
11
+ // 2. It bounds the time a crashed run sits unresolved to minutes rather than a
12
+ // month, during which its membership cannot be billed at all.
13
+ //
14
+ // Every run this picks up arrives with NO recorded failure origin — section 5.2
15
+ // selects purely on lease age, and there is deliberately no failure_origin column
16
+ // (section 4.4.1). So section 4.4 rows 23-25 are the COMMON path here, not an exotic
17
+ // one, and every decision is made by the ORACLE and the run's persisted status.
18
+ // The question is always what actually happened, never what we intended.
19
+
20
+ import Stripe from 'npm:stripe@17.5.0';
21
+ import { createClient } from 'npm:@supabase/supabase-js@2';
22
+ import { runRecoverySweep, type RunInput, type RunRow } from 'npm:@simplelayer/graniteer-core/printBilling';
23
+ import { makeDb, makeStripe } from 'npm:@simplelayer/graniteer-core/printBillingAdapters';
24
+
25
+ function safeEqual(a: string, b: string): boolean {
26
+ const enc = new TextEncoder();
27
+ const ab = enc.encode(a), bb = enc.encode(b);
28
+ if (ab.length !== bb.length) return false;
29
+ let diff = 0;
30
+ for (let i = 0; i < ab.length; i++) diff |= ab[i] ^ bb[i];
31
+ return diff === 0;
32
+ }
33
+
34
+ export async function handle(req: Request): Promise<Response> {
35
+ const supabase = createClient(
36
+ Deno.env.get('SUPABASE_URL')!,
37
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
38
+ );
39
+
40
+ const { data: secret } = await supabase.rpc('get_print_billing_run_secret');
41
+ const provided = req.headers.get('x-gc-print-billing-secret') ?? '';
42
+ if (!secret || !safeEqual(String(secret), provided)) {
43
+ return new Response(JSON.stringify({ ok: false, error: 'forbidden' }), {
44
+ status: 403, headers: { 'Content-Type': 'application/json' },
45
+ });
46
+ }
47
+
48
+ const stripeKey = Deno.env.get('STRIPE_SECRET_KEY');
49
+ const expectedAccountId = Deno.env.get('STRIPE_ACCOUNT_ID');
50
+ if (!stripeKey || !expectedAccountId) {
51
+ return new Response(JSON.stringify({ ok: false, error: 'stripe_config_missing' }), {
52
+ status: 500, headers: { 'Content-Type': 'application/json' },
53
+ });
54
+ }
55
+
56
+ const stripe = makeStripe(
57
+ new Stripe(stripeKey, { apiVersion: '2024-11-20.acacia' as Stripe.LatestApiVersion }),
58
+ );
59
+ const db = makeDb(supabase as never);
60
+
61
+ // section 5.3's escalation ladder. A held run gets LOUDER rather than expiring —
62
+ // an automatic expiry that frees the periods is exactly what created the
63
+ // double-charge hole in R7 F4 / R8 F2. warning -> error at 24h -> critical at 7d.
64
+ // The ladder now ends somewhere: public.print_run_resolve (M-21), surfaced in
65
+ // the admin panel as "Resolve held run".
66
+ await supabase.rpc('print_billing_escalate_stuck');
67
+
68
+ const results = await runRecoverySweep({
69
+ stripe,
70
+ db,
71
+ expectedAccountId,
72
+ expectedLivemode: (Deno.env.get('ENVIRONMENT') ?? '') === 'production',
73
+
74
+ // Rebuild the RunInput a recovered run needs to resume. period_ids is the
75
+ // snapshot taken at claim time and never revised; STEP 3.1 re-checks each
76
+ // period is still claimed by this run before posting its item (v17/B11-1).
77
+ loadRunInput: async (run: RunRow): Promise<RunInput> => {
78
+ const { data: months } = await supabase.rpc('print_billing_run_months',
79
+ { p_run_id: run.id });
80
+ return {
81
+ runId: run.id,
82
+ membershipId: run.membership_id,
83
+ customerId: run.stripe_customer_id,
84
+ periodIds: run.period_ids,
85
+ periodMonths: (months ?? []) as string[],
86
+ amountCents: 0, // not re-asserted on resume; the claim already did
87
+ defaultPaymentMethod: null, // the invoice already exists by this point
88
+ expectedAccountId,
89
+ expectedLivemode: (Deno.env.get('ENVIRONMENT') ?? '') === 'production',
90
+ };
91
+ },
92
+ });
93
+
94
+ return new Response(JSON.stringify({ ok: true, swept: results.length, results }), {
95
+ headers: { 'Content-Type': 'application/json' },
96
+ });
97
+ }