supabase-rb 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2589d2d48421b3667b8db24781d8f09d1d3919846e8c08512561c6b9fecd69b7
-  data.tar.gz: 227b035cb0da6d059a5c43886c8d31801b26ce88b16d3178357c166ceb8c1288
+  metadata.gz: 4c6d9216ec9407182b784f962757533f0dcb4bff3be7c7b04a4b2e3ff708878f
+  data.tar.gz: cd2aa70a2e15fdb624d0891d23ea5fdcd018eb258f3585a22e70b5736b6e03d1
 SHA512:
-  metadata.gz: be23970a53045e60aa4ec5dc8de14731013ddbf08f38c1a0a43694337aefe0d380339c877b773a9e93cbfc4713334abe47da12f4b51948b48f1ea0a0c2355072
-  data.tar.gz: d533a8d6ad8ef5563ead20e71cf9dfeabeb0d7403a4032330b602135145c440d5c841482ca8c5dba934ed73adb6ccaafdd66c4945c58c30613d12c8051480632
+  metadata.gz: 595191ce59fb0c18028b0dc32d4b87fcc3c8a83ba4039cd3bd104c78653935c00ec234c6da85dcda2d173856465270262e2ddce8dc1b3cb8af105259b3727a15
+  data.tar.gz: b494cdfd89a8ac25eddc59434545bc705116ff01ea97d06e279c5c88555e35ecea638ab88ac6f3c3381b1ed9f7a3d6276af85e87b4f67f8fe02ce0c20ee89c1d

data/lib/supabase/auth/client.rb

@@ -1205,7 +1205,7 @@ module Supabase
         payload = decoded[:payload]
 
         aal = payload["aal"]
-        amr = payload["amr"] || []
+        amr_entries = (payload["amr"] || []).map { |entry| Types::AMREntry.from_hash(entry) }.compact
 
         verified_factors = (session.user&.factors || []).select { |f| f.status == "verified" }
         next_level = verified_factors.any? ? "aal2" : aal
@@ -1213,7 +1213,7 @@ module Supabase
         Types::AuthMFAGetAuthenticatorAssuranceLevelResponse.new(
           current_level: aal,
           next_level: next_level,
-          current_authentication_methods: amr
+          current_authentication_methods: amr_entries
         )
       end
     end

data/lib/supabase/client.rb

@@ -100,9 +100,11 @@ module Supabase
       postgrest.rpc(func, params, **opts)
     end
 
+    # Return a Postgrest client scoped to `name` without mutating self. Matches
+    # supabase-py: `client.schema("foo").from_("x")` queries the foo schema but
+    # leaves `client.from(...)` (and other call sites) on the default schema.
     def schema(name)
-      @postgrest = postgrest.schema(name)
-      self
+      postgrest.schema(name)
     end
 
     # --- Shared auth context -------------------------------------------------

data/lib/supabase/functions/types.rb

@@ -31,6 +31,24 @@ module Supabase
           CA_CENTRAL_1, EU_CENTRAL_1, EU_WEST_1, EU_WEST_2, EU_WEST_3,
           SA_EAST_1, US_EAST_1, US_WEST_1, US_WEST_2
         ].freeze
+
+        # PascalCase aliases mirroring supabase-py's FunctionRegion StrEnum, so
+        # snippets ported from py (`FunctionRegion.UsEast1`) work without edits.
+        Any            = ANY
+        ApNortheast1   = AP_NORTHEAST_1
+        ApNortheast2   = AP_NORTHEAST_2
+        ApSouth1       = AP_SOUTH_1
+        ApSoutheast1   = AP_SOUTHEAST_1
+        ApSoutheast2   = AP_SOUTHEAST_2
+        CaCentral1     = CA_CENTRAL_1
+        EuCentral1     = EU_CENTRAL_1
+        EuWest1        = EU_WEST_1
+        EuWest2        = EU_WEST_2
+        EuWest3        = EU_WEST_3
+        SaEast1        = SA_EAST_1
+        UsEast1        = US_EAST_1
+        UsWest1        = US_WEST_1
+        UsWest2        = US_WEST_2
       end
     end
   end

data/lib/supabase/postgrest/client.rb

@@ -64,6 +64,9 @@ module Supabase
       end
 
       alias table from
+      # Compat alias for snippets ported from supabase-py where `from` is a
+      # reserved keyword and the method is named `from_`.
+      alias from_ from
 
       # Stored procedure call.
       # @param func [String] function name

data/lib/supabase/realtime/channel.rb

@@ -138,6 +138,34 @@ module Supabase
         self
       end
 
+      # Convenience wrappers around the underlying `channel.presence` object,
+      # matching supabase-py's `channel.on_presence_sync/join/leave` API. If
+      # called after the channel is already joined, the channel resubscribes so
+      # the server starts forwarding presence events (presence has to be enabled
+      # in the join config — see #default_params).
+      def on_presence_sync(&block)
+        @presence.on_sync(&block)
+        resubscribe_for_presence!
+        self
+      end
+
+      def on_presence_join(&block)
+        @presence.on_join(&block)
+        resubscribe_for_presence!
+        self
+      end
+
+      def on_presence_leave(&block)
+        @presence.on_leave(&block)
+        resubscribe_for_presence!
+        self
+      end
+
+      # Shortcut for `channel.presence.state` so callers don't have to drill in.
+      def presence_state
+        @presence.state
+      end
+
       # ----- Outbound -----
 
       # Send a custom broadcast message. The server will forward it to other
@@ -214,7 +242,9 @@ module Supabase
       # Mirrors phoenix.js / supabase-py: every registered on_postgres_changes
       # listener is serialized into config.postgres_changes on the join payload
       # so the server filters before sending, instead of shipping every change
-      # for the topic and forcing the client to drop most of them.
+      # for the topic and forcing the client to drop most of them. Also flips
+      # config.presence.enabled when any presence callback is attached, so the
+      # server starts emitting presence_state/diff frames.
       def inject_postgres_changes_bindings
         config = (@join_push.payload["config"] ||= {})
         config["postgres_changes"] = @postgres_changes_callbacks.map do |binding|
@@ -224,6 +254,21 @@ module Supabase
           entry["filter"] = binding[:filter] if binding[:filter]
           entry
         end
+
+        presence_cfg = (config["presence"] ||= {})
+        presence_cfg["enabled"] = true if @presence.any_callbacks?
+      end
+
+      # If a presence callback is added after the channel is already joined,
+      # the server's join config is stale (presence.enabled is still false), so
+      # we resubscribe to send a fresh join payload. Matches py's _resubscribe.
+      def resubscribe_for_presence!
+        return unless joined?
+
+        unsubscribe
+        @joined_once = false
+        @join_push.instance_variable_set(:@received_status, nil)
+        subscribe(&@subscribe_callback)
       end
 
       def send_push(push, register_pending:)

data/lib/supabase/realtime/client.rb

@@ -88,14 +88,23 @@ module Supabase
         self
       end
 
+      # Compat alias mirroring supabase-py's `client.close()`.
+      alias close disconnect
+
       def connected?
         @socket && @socket.connected?
       end
 
       # Get or create a Channel for the given topic. Subsequent calls with the
       # same topic return the same Channel instance, matching phoenix.js semantics.
+      #
+      # Topic names are auto-prefixed with `"realtime:"` to match supabase-py:
+      # `client.channel("public:users")` reaches the same channel as
+      # `client.channel("realtime:public:users")`. Pre-prefixed topics are left
+      # alone so existing code keeps working.
       def channel(topic, params: nil)
-        @channels[topic] ||= Channel.new(topic, params: params, socket: self)
+        full_topic = topic.start_with?("realtime:") ? topic : "realtime:#{topic}"
+        @channels[full_topic] ||= Channel.new(full_topic, params: params, socket: self)
       end
 
       def get_channels
@@ -176,6 +185,10 @@ module Supabase
         end
       end
 
+      # NOTE: supabase-py exposes this as `client.send(message)`. In Ruby that
+      # name would shadow Object#send and break reflective `obj.send(:method)`
+      # calls, so the rb port uses `push` instead.
+
       private
 
       def attach_socket
@@ -218,7 +231,9 @@ module Supabase
         return if @heartbeat_interval.nil? || @heartbeat_interval <= 0
         return if @heartbeat_thread&.alive?
 
-        interval = @heartbeat_interval
+        # Mirror supabase-py: clamp to a 15s floor so an overeager caller can't
+        # hammer the server with sub-15s heartbeats.
+        interval = [@heartbeat_interval, 15].max
         @heartbeat_thread = Thread.new do
           Thread.current.report_on_exception = false
           loop do

data/lib/supabase/storage/client.rb

@@ -50,6 +50,8 @@ module Supabase
       end
 
       alias bucket from
+      # Compat alias for snippets ported from supabase-py (`storage.from_(id)`).
+      alias from_ from
 
       # Iceberg / analytics bucket management. Mirrors storage3's
       # `SyncStorageClient#analytics`.

data/lib/supabase/storage/file_api.rb

@@ -53,9 +53,20 @@ module Supabase
 
       # ----- Download -----
 
-      def download(path)
+      # When `transform:` is provided, the request is routed through the image
+      # rendering endpoint (`render/image/authenticated`) and the transform opts
+      # are passed as query params. Mirrors supabase-py's DownloadOptions /
+      # TransformOptions split.
+      def download(path, transform: nil)
+        render_path = transform ? %w[render image authenticated] : %w[object]
+        query = if transform
+                  transform.transform_keys(&:to_s).transform_values(&:to_s)
+                else
+                  {}
+                end
+
         parts = Utils.relative_path_to_parts(path)
-        response = _request(:get, ["object", @id, *parts], raw_response: true)
+        response = _request(:get, [*render_path, @id, *parts], raw_response: true, query: query)
         response.body
       end
 
@@ -196,7 +207,8 @@ module Supabase
         send_multipart(:put, ["object", "upload", "sign", @id, *parts],
                        file: file, filename: parts.last, content_type: content_type,
                        cache_control: cache_control, upsert: nil, metadata: metadata,
-                       extra_headers: headers, query: { "token" => token })
+                       extra_headers: headers, query: { "token" => token },
+                       relative_path: parts.join("/"))
       end
 
       private
@@ -207,10 +219,11 @@ module Supabase
                        file: file, filename: parts.last,
                        content_type: content_type, cache_control: cache_control,
                        upsert: omit_upsert ? nil : upsert,
-                       metadata: metadata, extra_headers: headers)
+                       metadata: metadata, extra_headers: headers,
+                       relative_path: parts.join("/"))
       end
 
-      def send_multipart(method, segments, file:, filename:, content_type:, cache_control:, upsert:, metadata:, extra_headers:, query: nil)
+      def send_multipart(method, segments, file:, filename:, content_type:, cache_control:, upsert:, metadata:, extra_headers:, query: nil, relative_path: nil)
         request_headers = {}
         request_headers["cache-control"] = "max-age=#{cache_control}" if cache_control
         request_headers["x-upsert"]      = upsert.to_s unless upsert.nil?
@@ -240,7 +253,11 @@ module Supabase
         response = @session.run_request(method, url, form, merged_headers)
         raise_for_status(response)
         parsed = parse_json(response.body) || {}
-        Types::UploadResponse.from_hash(path: segments[2..].join("/"), key: parsed["Key"])
+        # Caller passes the user-facing relative path explicitly: index slicing
+        # off `segments` would yield "sign/<bucket>/<path>" for upload_to_signed_url
+        # (segments: ["object","upload","sign",@id,*parts]) instead of just <path>.
+        upload_path = relative_path || segments[2..].join("/")
+        Types::UploadResponse.from_hash(path: upload_path, key: parsed["Key"])
       end
 
       def build_upload_io(file, filename, content_type)

data/lib/supabase/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Supabase
-  VERSION = "3.0.0"
+  VERSION = "3.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: supabase-rb
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 3.1.0
 platform: ruby
 authors:
 - Supabase