@supabase/supabase-js 2.101.1 → 2.102.0-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supabase/supabase-js",
-  "version": "2.101.1",
+  "version": "2.102.0-beta.0",
   "description": "Isomorphic Javascript SDK for Supabase",
   "keywords": [
     "javascript",
@@ -80,11 +80,11 @@
     "update:test-deps:bun": "cd test/integration/bun && bun install"
   },
   "dependencies": {
-    "@supabase/auth-js": "2.101.1",
-    "@supabase/functions-js": "2.101.1",
-    "@supabase/postgrest-js": "2.101.1",
-    "@supabase/realtime-js": "2.101.1",
-    "@supabase/storage-js": "2.101.1"
+    "@supabase/auth-js": "2.102.0-beta.0",
+    "@supabase/functions-js": "2.102.0-beta.0",
+    "@supabase/postgrest-js": "2.102.0-beta.0",
+    "@supabase/realtime-js": "2.102.0-beta.0",
+    "@supabase/storage-js": "2.102.0-beta.0"
   },
   "devDependencies": {
     "jsr": "^0.13.5",

package/src/cors.ts

@@ -33,8 +33,15 @@
  * - x-client-info: Library version information
  * - apikey: Project API key
  * - content-type: Standard HTTP content type
+ * - x-retry-count: Retry attempt number sent by postgrest-js on retried requests
  */
-const SUPABASE_HEADERS = ['authorization', 'x-client-info', 'apikey', 'content-type'].join(', ')
+const SUPABASE_HEADERS = [
+  'authorization',
+  'x-client-info',
+  'apikey',
+  'content-type',
+  'x-retry-count',
+].join(', ')
 
 /**
  * All HTTP methods used by the Supabase SDK

package/src/lib/rest/types/common/common.ts

@@ -12,6 +12,33 @@
 
 export type Fetch = typeof fetch
 
+/**
+ * Default number of retry attempts.
+ */
+export const DEFAULT_MAX_RETRIES = 3
+
+/**
+ * Default exponential backoff delay function.
+ * Delays: 1s, 2s, 4s, 8s, ... (max 30s)
+ *
+ * @param attemptIndex - Zero-based index of the retry attempt
+ * @returns Delay in milliseconds before the next retry
+ */
+export const getRetryDelay = (attemptIndex: number): number =>
+  Math.min(1000 * 2 ** attemptIndex, 30000)
+
+/**
+ * Status codes that are safe to retry.
+ * 520 = Cloudflare timeout/connection errors (transient)
+ * 503 = PostgREST schema cache not yet loaded (transient, signals retry via Retry-After header)
+ */
+export const RETRYABLE_STATUS_CODES = [520, 503] as const
+
+/**
+ * HTTP methods that are safe to retry (idempotent operations).
+ */
+export const RETRYABLE_METHODS = ['GET', 'HEAD', 'OPTIONS'] as const
+
 export type GenericRelationship = {
   foreignKeyName: string
   columns: string[]

package/src/lib/version.ts

@@ -4,4 +4,4 @@
 // - Debugging and support (identifying which version is running)
 // - Telemetry and logging (version reporting in errors/analytics)
 // - Ensuring build artifacts match the published package version
-export const version = '2.101.1'
+export const version = '2.102.0-beta.0'