search-engine-for-typesense 30.1.6.14 → 30.1.6.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 751fec345b2fe0e2e9290ffba4af92639a58fc7663d6cd78e09527ace07d5104
-  data.tar.gz: 3332605b4afa0d24b66c4f4f0ab5f7be4a6676765213bf9441b508fddc1c8f9f
+  metadata.gz: e4f73039b28d08542d582f09279574bf2d982218434259e17e2ef341a98959cf
+  data.tar.gz: 1c4b811b429fd29d13b878a1cc9e292ca268e79f8746c1632ac29810bf82c0c6
 SHA512:
-  metadata.gz: bdc7e4250b406a06004d532cd379a597866a1a5419c90697fd177692f6b8a31c682e7dbc1c1f3727a823190d95c6612022a64520bc88e3dd3cec9a98e555e7c9
-  data.tar.gz: 68f460a120e7763bb2353531b0fadbc3f1b4f642eafebcc6cecd2af6ec1423db936159f6cce586f74d47f4e10782e0e02dfaf3673caa1e94d037f0628dcd9844
+  metadata.gz: afeca782edfa298e76b459e6ec7307d2b896a6a77987d70e3525602a2f052e2556df973d204f6be4ec38ef562e0b90ef0ce679c737c715ae278b783c014eab30
+  data.tar.gz: b7eb1fb839c37de2999bc1bdbcc78598aaa3b151961ae04fd8f3964d84207550f562b8d72840d03e2a97d0ca6ffc109ec9d34ea7608f8f6aea88c56c5e866c53

data/lib/search_engine/schema.rb

@@ -1259,6 +1259,12 @@ module SearchEngine
         existing = client.retrieve_collection_schema(logical_name)
         return unless existing
 
+        # Typesense GET /collections/:name transparently resolves aliases.
+        # If the returned schema's name differs from the logical name, no bare
+        # collection exists — the alias was resolved to its physical target.
+        schema_name = (existing[:name] || existing['name']).to_s
+        return unless schema_name == logical_name
+
         client.delete_collection(logical_name, timeout_ms: 60_000)
         return unless defined?(ActiveSupport::Notifications)
 
@@ -1278,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
-        referenced_schema
+
+        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
+
+        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.14'
+  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.14
+  version: 30.1.6.16
 platform: ruby
 authors:
 - Nikita Shkoda
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
+date: 2026-04-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby