@supabase/supabase-js 2.115.0 → 2.116.0-canary.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supabase/supabase-js",
-  "version": "2.115.0",
+  "version": "2.116.0-canary.0",
   "description": "Isomorphic Javascript SDK for Supabase",
   "keywords": [
     "javascript",
@@ -77,11 +77,11 @@
     "directory": "packages/core/supabase-js"
   },
   "dependencies": {
-    "@supabase/auth-js": "2.115.0",
-    "@supabase/postgrest-js": "2.115.0",
-    "@supabase/storage-js": "2.115.0",
-    "@supabase/realtime-js": "2.115.0",
-    "@supabase/functions-js": "2.115.0"
+    "@supabase/auth-js": "2.116.0-canary.0",
+    "@supabase/postgrest-js": "2.116.0-canary.0",
+    "@supabase/storage-js": "2.116.0-canary.0",
+    "@supabase/realtime-js": "2.116.0-canary.0",
+    "@supabase/functions-js": "2.116.0-canary.0"
   },
   "peerDependencies": {
     "@opentelemetry/api": ">=1.0.0"

package/src/SupabaseClient.ts

@@ -25,6 +25,7 @@ import {
 import { checkApiKeyFormat, fetchWithAuth } from './lib/fetch'
 import {
   applySettingDefaults,
+  checkTopLevelSchemaOption,
   validateSupabaseUrl,
   type ResolvedSupabaseClientOptions,
 } from './lib/helpers'
@@ -320,6 +321,7 @@ export default class SupabaseClient<
     const baseUrl = validateSupabaseUrl(supabaseUrl)
     if (!supabaseKey) throw new Error('supabaseKey is required.')
     checkApiKeyFormat(supabaseKey)
+    checkTopLevelSchemaOption(options)
 
     this.realtimeUrl = new URL('realtime/v1', baseUrl)
     this.realtimeUrl.protocol = this.realtimeUrl.protocol.replace('http', 'ws')

package/src/lib/helpers.ts

@@ -21,6 +21,45 @@ export function ensureTrailingSlash(url: string): string {
 
 export const isBrowser = () => typeof window !== 'undefined'
 
+let warnedTopLevelSchema = false
+
+/**
+ * Warn (once per process) when `schema` is passed at the top level of the client options
+ * instead of under `db`. A top-level `schema` is not part of the options shape and is
+ * ignored, so queries silently go to the default schema. Never throws.
+ *
+ * Only `undefined` counts as unset, matching `db.schema`, where any other value is sent
+ * as the profile header.
+ */
+export function checkTopLevelSchemaOption(options: unknown): void {
+  if (warnedTopLevelSchema) {
+    return
+  }
+  if (
+    typeof options !== 'object' ||
+    options === null ||
+    !('schema' in options) ||
+    (options as { schema?: unknown }).schema === undefined
+  ) {
+    return
+  }
+  warnedTopLevelSchema = true
+  console.warn(
+    '@supabase/supabase-js: The "schema" option must be nested under "db", ' +
+      "e.g. createClient(url, key, { db: { schema: 'myschema' } }). " +
+      'A top-level "schema" is ignored and queries go to the default schema.'
+  )
+}
+
+/**
+ * For tests only. Resets the one-time top-level `schema` warning.
+ *
+ * @internal
+ */
+export function _resetTopLevelSchemaWarning(): void {
+  warnedTopLevelSchema = false
+}
+
 export type ResolvedSupabaseClientOptions<SchemaName> = Omit<
   Required<SupabaseClientOptions<SchemaName>>,
   'tracePropagation'

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.115.0'
+export const version = '2.116.0-canary.0'