activerecord-beagle-turso 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 954e05b945781cc01a630306c4cb5d9368ef5dcc54876269229afed57f3a56d1
-  data.tar.gz: e512726ed37adeeee5ce7fe6268d3ecda615c079a4b041cca7a1677cce9d55fd
+  metadata.gz: 0a1a95bf62c876f996098db6a065aa9157af882b13d5038c7a86226ea6514b8b
+  data.tar.gz: 36d1eb3bdaf31d214ca80a1ab3754323cec795172bf00e2bcfd78d6812a7b3d7
 SHA512:
-  metadata.gz: e48728f8d4c61291db44090aab87067f31b76ef0503db34cdfcab18cb66e4d204a35b2ab7cdc3d6114ce555a49b347fdf88cc6406f5a08acb6cbc43e97d748e8
-  data.tar.gz: 70b9fb0e606a6e8e844a737d250016b800fdf21eb47e29ab3ead567821a5250ba95ff90a2e3dbaeb9283e1673624b3a8d31ed506bb0ce9e4217e5d5751e24965
+  metadata.gz: ab8346581f6054cec006ab218b12e03db82b4dde79f5afe3093fee8ccfc8e3116f5dc82b4152cccaac0415c449a19a4fbe4343cf6bfc34c11992eb3a7ee6b925
+  data.tar.gz: 83ba09effe58a3c3598034db2982ab7f6a0037da1b4beeefea01db6b57c1ffc94de39b8ebf6b9bd09af87da48d94a2cbffdbe2445e911270c7e293f416f8eade

data/README.md

@@ -67,6 +67,8 @@ An optional `bootstrap_if_empty:` (default `true`) controls whether a brand
 new/empty local file is populated from the remote on first open — see
 `Beagle::Turso::Database.open`.
 
+The sync engine's own tables (`turso_cdc`, `turso_cdc_version`, `turso_sync_last_change_id`) are hidden from `connection.tables`/`data_sources` and therefore from schema dumps and table-truncating tooling.
+
 ### Durability note: writes commit on-sync, not synchronously
 
 Writes go to the **local** file immediately, as part of the normal
@@ -94,7 +96,7 @@ All three default their `connection` argument to `ActiveRecord::Base.connection`
 so `Beagle::Turso::SyncManager.sync!` alone is the usual call. Calling any of
 them against a **local-only** connection (no `remote_url:`/`auth_token:` in
 `database.yml`) raises `Beagle::Turso::SyncManager::NotSyncedError` — a
-distinct, rescuable type — rather than the driver's bare `RuntimeError`.
+distinct, rescuable type — rather than the driver's own `Beagle::Turso::NotSyncedError`.
 
 To sync on a timer, wire
 `ActiveRecord::ConnectionAdapters::BeagleTurso::SyncJob` (a thin delegator to

data/lib/active_record/connection_adapters/beagle_turso/sync_manager.rb

@@ -46,23 +46,14 @@ module Beagle
     module SyncManager
       # Raised by +push!+/+pull!+/+sync!+ when the given connection is
       # local-only (its database.yml entry has no +remote_url+/+auth_token+,
-      # so BeagleTursoAdapter opened it via +Database.open_local+). The
-      # underlying Client#push/#pull already raise a bare RuntimeError for
-      # this (see Beagle::Turso::Database#push/#pull); SyncManager re-raises
-      # it as this distinct, documented type so callers can rescue it
-      # specifically instead of matching on the driver's message text. A
+      # so BeagleTursoAdapter opened it via +Database.open_local+). The driver
+      # raises Beagle::Turso::NotSyncedError for this; SyncManager re-raises it
+      # as this type (kept for compatibility) with a database.yml hint. A
       # genuine sync failure against a real remote (network error, auth
-      # failure, etc.) is NOT reclassified -- it propagates as whatever error
-      # the driver raised, unchanged.
+      # failure, etc.) is NOT reclassified -- it propagates as
+      # Beagle::Turso::SyncError (or another Beagle::Turso::Error), unchanged.
       class NotSyncedError < StandardError; end
 
-      # Matches only the driver's local-only wording (see
-      # beagle_turso_core's `Error::Sync` in `Database::push`/`Database::pull`)
-      # so a real sync failure -- which also surfaces as a RuntimeError, just
-      # with different text -- is never misreported as "not synced".
-      LOCAL_ONLY_MESSAGE_REGEX = /on a local-only database/i
-      private_constant :LOCAL_ONLY_MESSAGE_REGEX
-
       module_function
 
       # Push this connection's local writes to its remote Turso database.
@@ -88,9 +79,7 @@ module Beagle
 
       def reraise_local_only
         yield
-      rescue RuntimeError => e
-        raise e unless LOCAL_ONLY_MESSAGE_REGEX.match?(e.message)
-
+      rescue Beagle::Turso::NotSyncedError => e
         raise NotSyncedError,
           "#{e.message} -- this connection is local-only; configure remote_url: " \
           "and auth_token: in database.yml to enable sync"

data/lib/active_record/connection_adapters/beagle_turso_adapter.rb

@@ -219,8 +219,21 @@ module ActiveRecord
         # `create_table "__turso_internal_seq_..."` block per table into
         # db/schema.rb, and the next `db:schema:load` tries to create them for
         # real.
+        #
+        # On a synced replica the sync engine also keeps its change log in
+        # three tables (`turso_cdc`, `turso_cdc_version`,
+        # `turso_sync_last_change_id`). They are matched by EXACT name so a user
+        # table such as `turso_sync_log` stays visible. Left unfiltered,
+        # `db:schema:dump` would dump them and `db:truncate_all`, fixtures or
+        # DatabaseCleaner truncation would wipe the change log (losing unpushed
+        # sync data).
+        SYNC_ENGINE_TABLES = %w[turso_cdc turso_cdc_version turso_sync_last_change_id].freeze
+        private_constant :SYNC_ENGINE_TABLES
+
         def data_source_sql(name = nil, type: nil)
-          "#{super} AND name NOT LIKE '\\_\\_turso\\_internal\\_%' ESCAPE '\\'"
+          hidden = SYNC_ENGINE_TABLES.map { |t| quote(t) }.join(", ")
+          "#{super} AND name NOT LIKE '\\_\\_turso\\_internal\\_%' ESCAPE '\\'" \
+            " AND name NOT IN (#{hidden})"
         end
 
         # A column definition in the DDL that carries a parenthesised type

data/lib/activerecord/beagle_turso/version.rb

@@ -2,6 +2,6 @@
 
 module ActiveRecord
   module BeagleTurso
-    VERSION = "0.1.4"
+    VERSION = "0.1.6"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-beagle-turso
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.6
 platform: ruby
 authors:
 - BeagleSoftwareUK
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-09 00:00:00.000000000 Z
+date: 2026-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: sqlite3
   requirement: !ruby/object:Gem::Requirement