search-engine-for-typesense 30.1.6.15 → 30.1.6.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48a6665d86071a02b3e8505f519806dfca7fd541f9255cee1af66854fe393ef3
-  data.tar.gz: bf40e151c3270f5c3315af9e06bc50362071e3a930b463a8564292ffe545de4f
+  metadata.gz: e4f73039b28d08542d582f09279574bf2d982218434259e17e2ef341a98959cf
+  data.tar.gz: 1c4b811b429fd29d13b878a1cc9e292ca268e79f8746c1632ac29810bf82c0c6
 SHA512:
-  metadata.gz: 2479ab7907fc6d71485480bfab17ffe557a3596c920d7342036e97c94ae462ee0f833ab9922a71e20164a49038099df0cfa31f2323ff597f29ce91341fc79cd6
-  data.tar.gz: 5ee38e09488e332bff0509de4168f2871f8e43ec70a8691c2f623c701dcd1a0f8255d17d0fe41db7ef99fcd46938740198d8ef1f0999c4f34d51f7182521dc59
+  metadata.gz: afeca782edfa298e76b459e6ec7307d2b896a6a77987d70e3525602a2f052e2556df973d204f6be4ec38ef562e0b90ef0ce679c737c715ae278b783c014eab30
+  data.tar.gz: b7eb1fb839c37de2999bc1bdbcc78598aaa3b151961ae04fd8f3964d84207550f562b8d72840d03e2a97d0ca6ffc109ec9d34ea7608f8f6aea88c56c5e866c53

data/lib/search_engine/schema.rb

@@ -1284,12 +1284,55 @@ module SearchEngine
       # @raise [ArgumentError] if schema cannot be retrieved
       def retrieve_referenced_schema(logical_coll, physical_coll, client)
         referenced_schema = client.retrieve_collection_schema(physical_coll)
-        if referenced_schema.nil?
-          raise ArgumentError,
-                "Referenced collection '#{logical_coll}' (physical: '#{physical_coll}') " \
-                'schema could not be retrieved'
+        return referenced_schema unless referenced_schema.nil?
+
+        repaired_physical = recover_reference_alias_target(
+          logical_coll,
+          missing_physical: physical_coll,
+          client: client
+        )
+        unless repaired_physical.nil?
+          referenced_schema = client.retrieve_collection_schema(repaired_physical)
+          return referenced_schema unless referenced_schema.nil?
+        end
+
+        raise ArgumentError,
+              "Referenced collection '#{logical_coll}' (physical: '#{physical_coll}') " \
+              'schema could not be retrieved'
+      end
+
+      # Best-effort repair when a reference alias points to a missing physical
+      # collection. Repoints the logical alias to the newest retained physical.
+      # Returns nil if no safe repair candidate exists.
+      #
+      # @param logical_coll [String]
+      # @param missing_physical [String]
+      # @param client [SearchEngine::Client]
+      # @return [String, nil]
+      def recover_reference_alias_target(logical_coll, missing_physical:, client:)
+        logical_name = logical_coll.to_s
+        return nil if logical_name.strip.empty?
+
+        candidates = list_physicals(logical_name, client: client)
+        return nil if candidates.empty?
+
+        repaired_physical = order_physicals_desc(logical_name, candidates).first
+        return nil if repaired_physical.nil? || repaired_physical.to_s.strip.empty?
+        return nil if repaired_physical.to_s == missing_physical.to_s
+
+        client.upsert_alias(logical_name, repaired_physical)
+        if defined?(ActiveSupport::Notifications)
+          SearchEngine::Instrumentation.instrument(
+            'search_engine.schema.reference_alias_repaired',
+            logical: logical_name,
+            stale_physical: missing_physical.to_s,
+            repaired_physical: repaired_physical
+          ) {}
         end
-        referenced_schema
+
+        repaired_physical
+      rescue StandardError
+        nil
       end
 
       # Build a detailed error message when a referenced field is not found.

data/lib/search_engine/version.rb

@@ -3,5 +3,5 @@
 module SearchEngine
   # Current gem version.
   # @return [String]
-  VERSION = '30.1.6.15'
+  VERSION = '30.1.6.16'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: search-engine-for-typesense
 version: !ruby/object:Gem::Version
-  version: 30.1.6.15
+  version: 30.1.6.16
 platform: ruby
 authors:
 - Nikita Shkoda
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-30 00:00:00.000000000 Z
+date: 2026-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby