@simplelayer/graniteer-core 0.1.2 → 0.2.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 (130) hide show
  1. package/index.js +2 -2
  2. package/package.json +73 -2
  3. package/src/agreementCheckout.ts +250 -0
  4. package/src/agreementPortalEmail.ts +128 -0
  5. package/src/billingPortalLinkEmail.ts +117 -0
  6. package/src/bookingAgreementEmail.ts +149 -0
  7. package/src/bookingEffects.ts +388 -0
  8. package/src/busClient.ts +268 -0
  9. package/src/busSignature.ts +71 -0
  10. package/src/checkoutCoupon.test.ts +675 -0
  11. package/src/checkoutCoupon.ts +455 -0
  12. package/src/commonsDeposit.ts +298 -0
  13. package/src/commonsDepositWebhook.ts +237 -0
  14. package/src/dayPassConfirmation.ts +230 -0
  15. package/src/dunningEmails.test.ts +263 -0
  16. package/src/dunningEmails.ts +203 -0
  17. package/src/email-templates/brand.ts +93 -0
  18. package/src/email-templates/magic-link.tsx +59 -0
  19. package/src/email-templates/recovery.tsx +59 -0
  20. package/src/email-templates/signup.tsx +67 -0
  21. package/src/functions/admin-cancel-membership.ts +311 -311
  22. package/src/functions/admin-change-membership-plan.ts +312 -308
  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 -0
  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 -0
  30. package/src/functions/admin-mark-booking-paid.ts +203 -203
  31. package/src/functions/admin-mint-billing-portal-link.ts +168 -0
  32. package/src/functions/admin-mint-portal-link.ts +62 -0
  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 -0
  36. package/src/functions/admin-resend-commons-deposit-link.ts +323 -0
  37. package/src/functions/admin-reset-mfa.ts +138 -138
  38. package/src/functions/admin-retry-invoice-payment.test.ts +567 -0
  39. package/src/functions/admin-retry-invoice-payment.ts +333 -0
  40. package/src/functions/admin-reverse-coupon-redemption.ts +98 -98
  41. package/src/functions/admin-revoke-agreement.ts +467 -0
  42. package/src/functions/admin-send-commons-agreement.ts +214 -214
  43. package/src/functions/admin-set-credit-amount.ts +123 -123
  44. package/src/functions/admin-skip-commons-contract.ts +165 -165
  45. package/src/functions/admin-undo-membership-cancel.ts +144 -144
  46. package/src/functions/admin-wall-photo-write.ts +141 -141
  47. package/src/functions/auth-email-hook.ts +259 -0
  48. package/src/functions/boldsign-sender-identity.ts +114 -114
  49. package/src/functions/booking-availability.ts +419 -419
  50. package/src/functions/booking-member-preview.ts +136 -136
  51. package/src/functions/booking-status.ts +149 -0
  52. package/src/functions/conductor.ts +505 -0
  53. package/src/functions/create-agreement.ts +537 -0
  54. package/src/functions/create-booking.ts +648 -0
  55. package/src/functions/create-day-pass-checkout.ts +218 -0
  56. package/src/functions/create-portal-session.ts +142 -0
  57. package/src/functions/create-subscription-checkout.test.ts +222 -0
  58. package/src/functions/create-subscription-checkout.ts +440 -0
  59. package/src/functions/day-pass-status.ts +89 -89
  60. package/src/functions/diag-webpush-test.ts +45 -45
  61. package/src/functions/event-access-admin.ts +277 -0
  62. package/src/functions/event-access-store.ts +309 -309
  63. package/src/functions/ezeep-print-webhook.ts +213 -213
  64. package/src/functions/ezeep-usage-reconcile.ts +299 -299
  65. package/src/functions/fetch-avatar-original.ts +457 -0
  66. package/src/functions/get-provider-sign-link.ts +155 -0
  67. package/src/functions/get-signing-link.ts +211 -211
  68. package/src/functions/guest-print-setup-confirm.ts +128 -128
  69. package/src/functions/guest-print-submit.ts +149 -149
  70. package/src/functions/luma-webhook.ts +165 -165
  71. package/src/functions/manage-booking.ts +472 -0
  72. package/src/functions/mcp.ts +67 -0
  73. package/src/functions/member-door-action.test.ts +1248 -0
  74. package/src/functions/member-door-action.ts +863 -0
  75. package/src/functions/member-unifi-mapping.test.ts +516 -0
  76. package/src/functions/member-unifi-mapping.ts +206 -0
  77. package/src/functions/membership-door-sync.ts +956 -0
  78. package/src/functions/migration-collision-alert.copy.ts +232 -232
  79. package/src/functions/migration-collision-alert.test.ts +349 -349
  80. package/src/functions/migration-collision-alert.ts +232 -232
  81. package/src/functions/office-assignment-end.ts +146 -146
  82. package/src/functions/portal-booking-access.ts +95 -95
  83. package/src/functions/portal-list-invoices.ts +99 -99
  84. package/src/functions/portal-request-login.ts +192 -0
  85. package/src/functions/portal-resend-invite.ts +248 -0
  86. package/src/functions/portal-submit-event.ts +168 -0
  87. package/src/functions/print-billing-recover.ts +97 -97
  88. package/src/functions/print-billing-run.ts +183 -183
  89. package/src/functions/public-facts.ts +168 -168
  90. package/src/functions/push-send.ts +348 -0
  91. package/src/functions/push-test.ts +234 -0
  92. package/src/functions/request-portal-link.ts +211 -0
  93. package/src/functions/reschedule-booking.ts +649 -0
  94. package/src/functions/review-ratings.ts +113 -0
  95. package/src/functions/space-availability-range.acceptance.test.ts +161 -161
  96. package/src/functions/space-availability-range.ts +142 -142
  97. package/src/functions/stripe-db-reconcile.ts +319 -0
  98. package/src/functions/stripe-webhook.moved-regression.test.ts +78 -0
  99. package/src/functions/stripe-webhook.ts +2595 -0
  100. package/src/functions/sync-gcal-blackouts.ts +298 -298
  101. package/src/functions/timetable-event-register.ts +162 -162
  102. package/src/functions/timetable-event-status.ts +90 -90
  103. package/src/functions/timetable-spaces.ts +219 -219
  104. package/src/functions/touch-pass-reconciler.ts +689 -689
  105. package/src/functions/touch-pass-signup.ts +478 -0
  106. package/src/functions/upload-booking-display-image.ts +179 -0
  107. package/src/functions/virtual-onboarding-purge.ts +134 -134
  108. package/src/functions/virtual-onboarding-submit.ts +315 -315
  109. package/src/functions/voice-booking.ts +453 -0
  110. package/src/functions/voice-day-pass.ts +346 -0
  111. package/src/functions/voice-inquiry.test.ts +301 -301
  112. package/src/functions/voice-inquiry.ts +198 -198
  113. package/src/functions/voice-membership-signup.ts +355 -0
  114. package/src/functions/voice-tour-availability.ts +204 -204
  115. package/src/functions/voice-tour-booking.ts +429 -0
  116. package/src/ghlEventInquiry.ts +143 -0
  117. package/src/mailArrivalEmail.ts +121 -0
  118. package/src/manageToken.ts +363 -0
  119. package/src/membershipBusClient.ts +537 -0
  120. package/src/membershipWelcome.ts +683 -0
  121. package/src/migrationCheckout.ts +366 -0
  122. package/src/pacificDate.ts +54 -0
  123. package/src/paymentLinkEmail.ts +123 -0
  124. package/src/signedUnpaidReminderEmail.test.ts +246 -0
  125. package/src/signedUnpaidReminderEmail.ts +132 -0
  126. package/src/stripeCoworkingPortal.ts +91 -0
  127. package/src/supabaseTestFakes.ts +131 -131
  128. package/src/supportTicketEmail.ts +119 -0
  129. package/src/unifiAccessPolicies.ts +228 -0
  130. package/src/unifiGroups.ts +129 -0
@@ -1,213 +1,213 @@
1
- import { createClient } from 'npm:@supabase/supabase-js@2';
2
- import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
3
-
4
- /**
5
- * Inbound ezeep print-job webhook receiver (Phase 1 ingest).
6
- *
7
- * Receive -> verify Basic auth -> redact -> idempotent insert into `print_jobs`.
8
- * This function NEVER touches billing tables (`print_usage_periods` et al) or
9
- * Stripe; the nightly rollup owns that.
10
- *
11
- * Auth: ezeep only supports HTTP Basic auth on outbound webhooks — no HMAC and
12
- * no signature header. Known, accepted limitation; credentials live in
13
- * EZEEP_WEBHOOK_USER / EZEEP_WEBHOOK_PASS.
14
- *
15
- * Privacy: `content.printjob.filename` is redacted to null before anything is
16
- * persisted. Document names are never stored.
17
- *
18
- * Retry posture: ezeep retries non-2xx deliveries for ~3 days. We return 2xx
19
- * for anything a retry cannot fix (unparseable payload, schema mismatch) after
20
- * recording it in `ops_events`, and 5xx only for genuinely transient DB errors.
21
- */
22
-
23
- type Json = Record<string, unknown>;
24
-
25
- function json(status: number, body: unknown) {
26
- return new Response(JSON.stringify(body), {
27
- status,
28
- headers: { 'Content-Type': 'application/json' },
29
- });
30
- }
31
-
32
- /** Constant-time string compare (Web Crypto exposes no timingSafeEqual). */
33
- function timingSafeEqual(a: string, b: string): boolean {
34
- if (a.length !== b.length) return false;
35
- let acc = 0;
36
- for (let i = 0; i < a.length; i++) acc |= a.charCodeAt(i) ^ b.charCodeAt(i);
37
- return acc === 0;
38
- }
39
-
40
- function checkBasicAuth(req: Request): boolean {
41
- const expectedUser = Deno.env.get('EZEEP_WEBHOOK_USER');
42
- const expectedPass = Deno.env.get('EZEEP_WEBHOOK_PASS');
43
- if (!expectedUser || !expectedPass) {
44
- console.error(JSON.stringify({ level: 'error', kind: 'ezeep_webhook_not_configured' }));
45
- return false;
46
- }
47
-
48
- const header = req.headers.get('Authorization') ?? '';
49
- if (!header.toLowerCase().startsWith('basic ')) return false;
50
-
51
- let decoded: string;
52
- try {
53
- decoded = atob(header.slice(6).trim());
54
- } catch {
55
- return false;
56
- }
57
-
58
- const sep = decoded.indexOf(':');
59
- if (sep < 0) return false;
60
- const user = decoded.slice(0, sep);
61
- const pass = decoded.slice(sep + 1);
62
-
63
- // Both compared unconditionally so a wrong username costs the same time.
64
- const userOk = timingSafeEqual(user, expectedUser);
65
- const passOk = timingSafeEqual(pass, expectedPass);
66
- return userOk && passOk;
67
- }
68
-
69
- function isObject(v: unknown): v is Json {
70
- return typeof v === 'object' && v !== null && !Array.isArray(v);
71
- }
72
-
73
- function str(v: unknown): string | null {
74
- return typeof v === 'string' && v.length > 0 ? v : null;
75
- }
76
-
77
- function int(v: unknown): number | null {
78
- return typeof v === 'number' && Number.isFinite(v) ? Math.trunc(v) : null;
79
- }
80
-
81
- function bool(v: unknown): boolean | null {
82
- return typeof v === 'boolean' ? v : null;
83
- }
84
-
85
- /** ISO timestamp or null — never throws on garbage input. */
86
- function ts(v: unknown): string | null {
87
- const s = str(v);
88
- if (!s) return null;
89
- const d = new Date(s);
90
- return Number.isNaN(d.getTime()) ? null : d.toISOString();
91
- }
92
-
93
- // No CORS — this is called by ezeep's servers, not a browser.
94
- export async function handle(req: Request): Promise<Response> {
95
- if (req.method !== 'POST') {
96
- return new Response('Method not allowed', { status: 405 });
97
- }
98
-
99
- // 1. Auth first, before reading the body at all.
100
- if (!checkBasicAuth(req)) {
101
- return new Response('Unauthorized', {
102
- status: 401,
103
- headers: { 'WWW-Authenticate': 'Basic realm="ezeep-print-webhook"' },
104
- });
105
- }
106
-
107
- const supabase = createClient(
108
- Deno.env.get('SUPABASE_URL')!,
109
- Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
110
- { auth: { persistSession: false, autoRefreshToken: false } },
111
- );
112
- const opsClient = supabase as unknown as Parameters<typeof logOps>[0];
113
-
114
- const rawBody = await req.text();
115
-
116
- // 2. Parse + shape check. Anything we can never parse is logged and acked.
117
- let payload: Json | null = null;
118
- try {
119
- const parsed = JSON.parse(rawBody);
120
- if (isObject(parsed)) payload = parsed;
121
- } catch { /* handled below */ }
122
-
123
- const content = payload && isObject(payload.content) ? payload.content : null;
124
- const printjob = content && isObject(content.printjob) ? content.printjob : null;
125
- const printjobId = printjob ? str(printjob.printjob_id) : null;
126
-
127
- if (!payload || !printjob || !printjobId) {
128
- await logOps(
129
- opsClient,
130
- 'ezeep_webhook_unparseable',
131
- {
132
- reason: !payload
133
- ? 'body_not_json_object'
134
- : !printjob
135
- ? 'missing_content_printjob'
136
- : 'missing_printjob_id',
137
- topic: payload ? str(payload.topic) : null,
138
- event_id: payload ? str(payload.event_id) : null,
139
- raw_body: rawBody.slice(0, 8000),
140
- },
141
- { severity: 'warning' },
142
- );
143
- // 2xx on purpose: retrying an unparseable payload for 3 days helps nobody.
144
- return json(202, { received: true, stored: false, reason: 'unparseable' });
145
- }
146
-
147
- // 3. Redact the document name before anything is persisted.
148
- const redactedPrintjob: Json = { ...printjob, filename: null };
149
- const redactedRaw: Json = {
150
- ...payload,
151
- content: { ...content, printjob: redactedPrintjob },
152
- };
153
-
154
- // 4 + 6. Field mapping (email lowercased).
155
- const email = str(printjob.user_email);
156
- const row = {
157
- ezeep_printjob_id: printjobId,
158
- ezeep_event_id: str(payload.event_id),
159
- topic: str(payload.topic),
160
- user_billing_code: str(printjob.user_billing_code),
161
- user_email: email ? email.toLowerCase() : null,
162
- ezeep_user_id: str(printjob.user_id),
163
- total_printed_pages: int(printjob.total_printed_pages),
164
- total_printed_sheets: int(printjob.total_printed_sheets),
165
- copies: int(printjob.copies),
166
- color: bool(printjob.color),
167
- duplex: str(printjob.duplex),
168
- paper: str(printjob.paper),
169
- printer_name: str(printjob.printer_name),
170
- job_created_at: ts(printjob.job_created_at) ?? ts(printjob.created) ?? ts(payload.created),
171
- raw: redactedRaw,
172
- };
173
-
174
- // 5. Idempotent insert — a redelivery must not duplicate or error.
175
- const { error } = await supabase
176
- .from('print_jobs')
177
- .upsert(row as never, { onConflict: 'ezeep_printjob_id', ignoreDuplicates: true });
178
-
179
- if (error) {
180
- const code = (error as { code?: string }).code ?? null;
181
- // 23505 cannot normally surface with ignoreDuplicates, but if it does the
182
- // row already exists — that is success from ezeep's point of view.
183
- if (code === '23505') {
184
- return json(200, { received: true, stored: true, duplicate: true });
185
- }
186
-
187
- // Permanent-ish failures (bad column, constraint violation, malformed
188
- // value) will fail identically on every retry: log and ack.
189
- const permanent = typeof code === 'string' && /^(22|23|42|PGRST)/.test(code);
190
- await logOps(
191
- opsClient,
192
- 'ezeep_webhook_error',
193
- {
194
- printjob_id: printjobId,
195
- event_id: str(payload.event_id),
196
- topic: str(payload.topic),
197
- code,
198
- message: error.message,
199
- permanent,
200
- },
201
- { severity: 'error' },
202
- );
203
-
204
- if (permanent) {
205
- return json(202, { received: true, stored: false, reason: 'insert_failed' });
206
- }
207
- // Transient (connectivity, timeout): let ezeep retry.
208
- return json(500, { received: false, error: 'db_error' });
209
- }
210
-
211
- // 7. Fast ack. No downstream calls.
212
- return json(200, { received: true, stored: true });
213
- }
1
+ import { createClient } from 'npm:@supabase/supabase-js@2';
2
+ import { logOps } from 'npm:@simplelayer/graniteer-core/ops';
3
+
4
+ /**
5
+ * Inbound ezeep print-job webhook receiver (Phase 1 ingest).
6
+ *
7
+ * Receive -> verify Basic auth -> redact -> idempotent insert into `print_jobs`.
8
+ * This function NEVER touches billing tables (`print_usage_periods` et al) or
9
+ * Stripe; the nightly rollup owns that.
10
+ *
11
+ * Auth: ezeep only supports HTTP Basic auth on outbound webhooks — no HMAC and
12
+ * no signature header. Known, accepted limitation; credentials live in
13
+ * EZEEP_WEBHOOK_USER / EZEEP_WEBHOOK_PASS.
14
+ *
15
+ * Privacy: `content.printjob.filename` is redacted to null before anything is
16
+ * persisted. Document names are never stored.
17
+ *
18
+ * Retry posture: ezeep retries non-2xx deliveries for ~3 days. We return 2xx
19
+ * for anything a retry cannot fix (unparseable payload, schema mismatch) after
20
+ * recording it in `ops_events`, and 5xx only for genuinely transient DB errors.
21
+ */
22
+
23
+ type Json = Record<string, unknown>;
24
+
25
+ function json(status: number, body: unknown) {
26
+ return new Response(JSON.stringify(body), {
27
+ status,
28
+ headers: { 'Content-Type': 'application/json' },
29
+ });
30
+ }
31
+
32
+ /** Constant-time string compare (Web Crypto exposes no timingSafeEqual). */
33
+ function timingSafeEqual(a: string, b: string): boolean {
34
+ if (a.length !== b.length) return false;
35
+ let acc = 0;
36
+ for (let i = 0; i < a.length; i++) acc |= a.charCodeAt(i) ^ b.charCodeAt(i);
37
+ return acc === 0;
38
+ }
39
+
40
+ function checkBasicAuth(req: Request): boolean {
41
+ const expectedUser = Deno.env.get('EZEEP_WEBHOOK_USER');
42
+ const expectedPass = Deno.env.get('EZEEP_WEBHOOK_PASS');
43
+ if (!expectedUser || !expectedPass) {
44
+ console.error(JSON.stringify({ level: 'error', kind: 'ezeep_webhook_not_configured' }));
45
+ return false;
46
+ }
47
+
48
+ const header = req.headers.get('Authorization') ?? '';
49
+ if (!header.toLowerCase().startsWith('basic ')) return false;
50
+
51
+ let decoded: string;
52
+ try {
53
+ decoded = atob(header.slice(6).trim());
54
+ } catch {
55
+ return false;
56
+ }
57
+
58
+ const sep = decoded.indexOf(':');
59
+ if (sep < 0) return false;
60
+ const user = decoded.slice(0, sep);
61
+ const pass = decoded.slice(sep + 1);
62
+
63
+ // Both compared unconditionally so a wrong username costs the same time.
64
+ const userOk = timingSafeEqual(user, expectedUser);
65
+ const passOk = timingSafeEqual(pass, expectedPass);
66
+ return userOk && passOk;
67
+ }
68
+
69
+ function isObject(v: unknown): v is Json {
70
+ return typeof v === 'object' && v !== null && !Array.isArray(v);
71
+ }
72
+
73
+ function str(v: unknown): string | null {
74
+ return typeof v === 'string' && v.length > 0 ? v : null;
75
+ }
76
+
77
+ function int(v: unknown): number | null {
78
+ return typeof v === 'number' && Number.isFinite(v) ? Math.trunc(v) : null;
79
+ }
80
+
81
+ function bool(v: unknown): boolean | null {
82
+ return typeof v === 'boolean' ? v : null;
83
+ }
84
+
85
+ /** ISO timestamp or null — never throws on garbage input. */
86
+ function ts(v: unknown): string | null {
87
+ const s = str(v);
88
+ if (!s) return null;
89
+ const d = new Date(s);
90
+ return Number.isNaN(d.getTime()) ? null : d.toISOString();
91
+ }
92
+
93
+ // No CORS — this is called by ezeep's servers, not a browser.
94
+ export async function handle(req: Request): Promise<Response> {
95
+ if (req.method !== 'POST') {
96
+ return new Response('Method not allowed', { status: 405 });
97
+ }
98
+
99
+ // 1. Auth first, before reading the body at all.
100
+ if (!checkBasicAuth(req)) {
101
+ return new Response('Unauthorized', {
102
+ status: 401,
103
+ headers: { 'WWW-Authenticate': 'Basic realm="ezeep-print-webhook"' },
104
+ });
105
+ }
106
+
107
+ const supabase = createClient(
108
+ Deno.env.get('SUPABASE_URL')!,
109
+ Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!,
110
+ { auth: { persistSession: false, autoRefreshToken: false } },
111
+ );
112
+ const opsClient = supabase as unknown as Parameters<typeof logOps>[0];
113
+
114
+ const rawBody = await req.text();
115
+
116
+ // 2. Parse + shape check. Anything we can never parse is logged and acked.
117
+ let payload: Json | null = null;
118
+ try {
119
+ const parsed = JSON.parse(rawBody);
120
+ if (isObject(parsed)) payload = parsed;
121
+ } catch { /* handled below */ }
122
+
123
+ const content = payload && isObject(payload.content) ? payload.content : null;
124
+ const printjob = content && isObject(content.printjob) ? content.printjob : null;
125
+ const printjobId = printjob ? str(printjob.printjob_id) : null;
126
+
127
+ if (!payload || !printjob || !printjobId) {
128
+ await logOps(
129
+ opsClient,
130
+ 'ezeep_webhook_unparseable',
131
+ {
132
+ reason: !payload
133
+ ? 'body_not_json_object'
134
+ : !printjob
135
+ ? 'missing_content_printjob'
136
+ : 'missing_printjob_id',
137
+ topic: payload ? str(payload.topic) : null,
138
+ event_id: payload ? str(payload.event_id) : null,
139
+ raw_body: rawBody.slice(0, 8000),
140
+ },
141
+ { severity: 'warning' },
142
+ );
143
+ // 2xx on purpose: retrying an unparseable payload for 3 days helps nobody.
144
+ return json(202, { received: true, stored: false, reason: 'unparseable' });
145
+ }
146
+
147
+ // 3. Redact the document name before anything is persisted.
148
+ const redactedPrintjob: Json = { ...printjob, filename: null };
149
+ const redactedRaw: Json = {
150
+ ...payload,
151
+ content: { ...content, printjob: redactedPrintjob },
152
+ };
153
+
154
+ // 4 + 6. Field mapping (email lowercased).
155
+ const email = str(printjob.user_email);
156
+ const row = {
157
+ ezeep_printjob_id: printjobId,
158
+ ezeep_event_id: str(payload.event_id),
159
+ topic: str(payload.topic),
160
+ user_billing_code: str(printjob.user_billing_code),
161
+ user_email: email ? email.toLowerCase() : null,
162
+ ezeep_user_id: str(printjob.user_id),
163
+ total_printed_pages: int(printjob.total_printed_pages),
164
+ total_printed_sheets: int(printjob.total_printed_sheets),
165
+ copies: int(printjob.copies),
166
+ color: bool(printjob.color),
167
+ duplex: str(printjob.duplex),
168
+ paper: str(printjob.paper),
169
+ printer_name: str(printjob.printer_name),
170
+ job_created_at: ts(printjob.job_created_at) ?? ts(printjob.created) ?? ts(payload.created),
171
+ raw: redactedRaw,
172
+ };
173
+
174
+ // 5. Idempotent insert — a redelivery must not duplicate or error.
175
+ const { error } = await supabase
176
+ .from('print_jobs')
177
+ .upsert(row as never, { onConflict: 'ezeep_printjob_id', ignoreDuplicates: true });
178
+
179
+ if (error) {
180
+ const code = (error as { code?: string }).code ?? null;
181
+ // 23505 cannot normally surface with ignoreDuplicates, but if it does the
182
+ // row already exists — that is success from ezeep's point of view.
183
+ if (code === '23505') {
184
+ return json(200, { received: true, stored: true, duplicate: true });
185
+ }
186
+
187
+ // Permanent-ish failures (bad column, constraint violation, malformed
188
+ // value) will fail identically on every retry: log and ack.
189
+ const permanent = typeof code === 'string' && /^(22|23|42|PGRST)/.test(code);
190
+ await logOps(
191
+ opsClient,
192
+ 'ezeep_webhook_error',
193
+ {
194
+ printjob_id: printjobId,
195
+ event_id: str(payload.event_id),
196
+ topic: str(payload.topic),
197
+ code,
198
+ message: error.message,
199
+ permanent,
200
+ },
201
+ { severity: 'error' },
202
+ );
203
+
204
+ if (permanent) {
205
+ return json(202, { received: true, stored: false, reason: 'insert_failed' });
206
+ }
207
+ // Transient (connectivity, timeout): let ezeep retry.
208
+ return json(500, { received: false, error: 'db_error' });
209
+ }
210
+
211
+ // 7. Fast ack. No downstream calls.
212
+ return json(200, { received: true, stored: true });
213
+ }