graphql-anycable_postgresql-store 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 98dc409019bc7dcd4b3cf768c48b0c849fa51b2a8fe13e752485cf37dbc6d347
-  data.tar.gz: fd1f0469d8f228257092cd4e6a8dcacfca9306139fb6e624c0c8ddd71a408bf3
+  metadata.gz: 7f4a6948b58b9ff40992a1a02f9381919c29e25862a62eedfeb1ffd3b80ee5d1
+  data.tar.gz: db167a2158578f0d025dd0ef48dbcb1924dfeace2347d3e863fe45b8abdb4e74
 SHA512:
-  metadata.gz: ee6d8b98417a98906635103a89c4c7683bc931f1da3f627a6e17aabbb8f62b41ea662f68e2d7c5f3950f878c2cdc41836ca2fd20cf0ad7fb849f319e4f4bf7b4
-  data.tar.gz: 935c1c06e7115264b065c57320fe1917bfc46fd12ae67cf58ebf6b32a5b9a44fafbdbdd07c29b7d73e6713e965f83c53105adad2c090716f7e81874739e84796
+  metadata.gz: 6b5abf158a18a24b2be97bb0659b875eaa9ef2726bddf32721a0f5f1495a936429833d42e0b2548bac41ea486cadac4c32dafc7b7850b3a0428db1ac5e0bd562
+  data.tar.gz: 796480eb81e8fd6733d296ad445b86820bc8fb45d9d4f3b8088ef93b16af7d38df909db697e6c12a297e84a8b4898f255cd6ed3639825d8205f2c4ee2b780cdc

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.0 - 2026-05-28
+
+- Add a PostgreSQL store cleaner matching the `graphql-anycable` store cleanup contract.
+- Extract PostgreSQL stats into a `Store::Stats` object to match the core store design.
+
 ## 0.1.0 - 2026-05-27
 
 - Add PostgreSQL subscription store for `graphql-anycable`.

data/README.md

@@ -6,7 +6,7 @@ PostgreSQL subscription store for [`graphql-anycable`](https://github.com/anycab
 
 This gem stores GraphQL subscription state in PostgreSQL. It does not deliver AnyCable broadcasts itself; delivery still goes through the AnyCable broadcast adapter configured by the application.
 
-This gem requires a `graphql-anycable` version that supports custom subscription stores.
+This gem requires a `graphql-anycable` version that supports custom subscription stores and store-backed cleanup.
 
 ## Installation
 
@@ -106,6 +106,13 @@ subscriptions, topics, fingerprints, and channels with SQL aggregate queries;
 `scan_count` is accepted for graphql-anycable interface compatibility and is not
 used by PostgreSQL.
 
+## Cleanup
+
+`GraphQL::AnyCable::Cleaner` delegates to this store when `subscription_store`
+is configured as `:postgresql` or `:postgres`. The cleaner removes expired
+subscription rows; PostgreSQL foreign keys with `ON DELETE CASCADE` remove
+associated event and channel rows.
+
 ## Development
 
 Install dependencies and run tests:
@@ -130,8 +137,8 @@ bundle exec rake build
 Publish the same versioned gem artifact to RubyGems and GitHub Releases:
 
 ```sh
-gem push pkg/graphql-anycable_postgresql-store-0.1.0.gem
-gh release create v0.1.0 pkg/graphql-anycable_postgresql-store-0.1.0.gem \
-  --title "v0.1.0" \
+gem push pkg/graphql-anycable_postgresql-store-0.2.0.gem
+gh release create v0.2.0 pkg/graphql-anycable_postgresql-store-0.2.0.gem \
+  --title "v0.2.0" \
   --notes-file CHANGELOG.md
 ```

data/lib/graphql/anycable/postgresql_store/store/cleaner.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module GraphQL
+  module AnyCable
+    module PostgreSQLStore
+      class Store
+        class Cleaner
+          def initialize(connection_provider:, subscriptions_table:, events_table:, channels_table:)
+            @connection_provider = connection_provider
+            @subscriptions_table = subscriptions_table
+            @events_table = events_table
+            @channels_table = channels_table
+          end
+
+          def clean
+            clean_subscriptions
+            clean_fingerprint_subscriptions
+            clean_channels
+            clean_topic_fingerprints
+          end
+
+          def clean_channels
+            with_connection do |conn|
+              conn.exec_params(<<~SQL)
+                DELETE FROM #{channels_table} channels
+                WHERE NOT EXISTS (
+                  SELECT 1
+                  FROM #{subscriptions_table} subscriptions
+                  WHERE subscriptions.id = channels.subscription_id
+                )
+              SQL
+            end
+          end
+
+          def clean_subscriptions
+            with_connection do |conn|
+              conn.exec_params(<<~SQL)
+                DELETE FROM #{subscriptions_table}
+                WHERE expires_at IS NOT NULL
+                  AND expires_at <= CURRENT_TIMESTAMP
+              SQL
+            end
+          end
+
+          def clean_fingerprint_subscriptions
+            with_connection do |conn|
+              conn.exec_params(<<~SQL)
+                DELETE FROM #{events_table} events
+                WHERE NOT EXISTS (
+                  SELECT 1
+                  FROM #{subscriptions_table} subscriptions
+                  WHERE subscriptions.id = events.subscription_id
+                )
+              SQL
+            end
+          end
+
+          def clean_topic_fingerprints
+            nil
+          end
+
+          private
+
+          attr_reader :channels_table, :connection_provider, :events_table, :subscriptions_table
+
+          def with_connection(&block)
+            connection_provider.call(&block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/graphql/anycable/postgresql_store/store/stats.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module GraphQL
+  module AnyCable
+    module PostgreSQLStore
+      class Store
+        class Stats
+          def initialize(connection_provider:, subscriptions_table:, events_table:, channels_table:, scan_count:, include_subscriptions:)
+            @connection_provider = connection_provider
+            @subscriptions_table = subscriptions_table
+            @events_table = events_table
+            @channels_table = channels_table
+            @scan_count = scan_count
+            @include_subscriptions = include_subscriptions
+          end
+
+          def collect
+            # PostgreSQL uses aggregate queries rather than key scans; scan_count
+            # is accepted to match graphql-anycable's store stats interface.
+            raise ArgumentError, "scan_count must be positive" if scan_count.to_i <= 0
+
+            with_connection do |conn|
+              result = {total: total_stats(conn)}
+              result[:subscriptions] = subscription_stats(conn) if include_subscriptions
+              result
+            end
+          end
+
+          private
+
+          attr_reader :channels_table, :connection_provider, :events_table, :include_subscriptions, :scan_count, :subscriptions_table
+
+          def with_connection(&block)
+            connection_provider.call(&block)
+          end
+
+          def total_stats(conn)
+            conn.exec_params(<<~SQL).first.transform_values(&:to_i).transform_keys(&:to_sym)
+              SELECT
+                (
+                  SELECT COUNT(*)
+                  FROM #{subscriptions_table}
+                  WHERE #{active_subscription_sql}
+                ) AS subscription,
+                (
+                  SELECT COUNT(DISTINCT events.topic)
+                  FROM #{events_table} events
+                  INNER JOIN #{subscriptions_table} subscriptions
+                    ON subscriptions.id = events.subscription_id
+                  WHERE #{active_subscription_sql("subscriptions")}
+                ) AS fingerprints,
+                (
+                  SELECT COUNT(DISTINCT events.fingerprint)
+                  FROM #{events_table} events
+                  INNER JOIN #{subscriptions_table} subscriptions
+                    ON subscriptions.id = events.subscription_id
+                  WHERE #{active_subscription_sql("subscriptions")}
+                ) AS subscriptions,
+                (
+                  SELECT COUNT(DISTINCT channels.channel_id)
+                  FROM #{channels_table} channels
+                  INNER JOIN #{subscriptions_table} subscriptions
+                    ON subscriptions.id = channels.subscription_id
+                  WHERE #{active_subscription_sql("subscriptions")}
+                ) AS channel
+            SQL
+          end
+
+          def subscription_stats(conn)
+            conn.exec_params(<<~SQL).to_h { |row| [row.fetch("topic"), row.fetch("subscriptions").to_i] }
+              SELECT events.topic, COUNT(DISTINCT events.subscription_id) AS subscriptions
+              FROM #{events_table} events
+              INNER JOIN #{subscriptions_table} subscriptions
+                ON subscriptions.id = events.subscription_id
+              WHERE #{active_subscription_sql("subscriptions")}
+              GROUP BY events.topic
+              ORDER BY events.topic ASC
+            SQL
+          end
+
+          def active_subscription_sql(table_name = nil)
+            prefix = table_name ? "#{table_name}." : ""
+            "(#{prefix}expires_at IS NULL OR #{prefix}expires_at > CURRENT_TIMESTAMP)"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/graphql/anycable/postgresql_store/store.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "time"
+require_relative "store/cleaner"
+require_relative "store/stats"
 
 module GraphQL
   module AnyCable
@@ -156,15 +158,23 @@ module GraphQL
         end
 
         def stats(scan_count:, include_subscriptions: false)
-          # PostgreSQL uses aggregate queries rather than key scans; scan_count
-          # is accepted to match graphql-anycable's store stats interface.
-          raise ArgumentError, "scan_count must be positive" if scan_count.to_i <= 0
+          Stats.new(
+            connection_provider: ->(&block) { with_connection(&block) },
+            subscriptions_table: subscriptions_table,
+            events_table: events_table,
+            channels_table: channels_table,
+            scan_count: scan_count,
+            include_subscriptions: include_subscriptions
+          ).collect
+        end
 
-          with_connection do |conn|
-            result = {total: total_stats(conn)}
-            result[:subscriptions] = subscription_stats(conn) if include_subscriptions
-            result
-          end
+        def cleaner
+          @cleaner ||= Cleaner.new(
+            connection_provider: ->(&block) { with_connection(&block) },
+            subscriptions_table: subscriptions_table,
+            events_table: events_table,
+            channels_table: channels_table
+          )
         end
 
         private
@@ -204,55 +214,6 @@ module GraphQL
           Array.new(count) { |index| "$#{index + 1}" }.join(", ")
         end
 
-        def total_stats(conn)
-          conn.exec_params(<<~SQL).first.transform_values(&:to_i).transform_keys(&:to_sym)
-            SELECT
-              (
-                SELECT COUNT(*)
-                FROM #{subscriptions_table}
-                WHERE #{active_subscription_sql}
-              ) AS subscription,
-              (
-                SELECT COUNT(DISTINCT events.topic)
-                FROM #{events_table} events
-                INNER JOIN #{subscriptions_table} subscriptions
-                  ON subscriptions.id = events.subscription_id
-                WHERE #{active_subscription_sql("subscriptions")}
-              ) AS fingerprints,
-              (
-                SELECT COUNT(DISTINCT events.fingerprint)
-                FROM #{events_table} events
-                INNER JOIN #{subscriptions_table} subscriptions
-                  ON subscriptions.id = events.subscription_id
-                WHERE #{active_subscription_sql("subscriptions")}
-              ) AS subscriptions,
-              (
-                SELECT COUNT(DISTINCT channels.channel_id)
-                FROM #{channels_table} channels
-                INNER JOIN #{subscriptions_table} subscriptions
-                  ON subscriptions.id = channels.subscription_id
-                WHERE #{active_subscription_sql("subscriptions")}
-              ) AS channel
-          SQL
-        end
-
-        def subscription_stats(conn)
-          conn.exec_params(<<~SQL).to_h { |row| [row.fetch("topic"), row.fetch("subscriptions").to_i] }
-            SELECT events.topic, COUNT(DISTINCT events.subscription_id) AS subscriptions
-            FROM #{events_table} events
-            INNER JOIN #{subscriptions_table} subscriptions
-              ON subscriptions.id = events.subscription_id
-            WHERE #{active_subscription_sql("subscriptions")}
-            GROUP BY events.topic
-            ORDER BY events.topic ASC
-          SQL
-        end
-
-        def active_subscription_sql(table_name = nil)
-          prefix = table_name ? "#{table_name}." : ""
-          "(#{prefix}expires_at IS NULL OR #{prefix}expires_at > CURRENT_TIMESTAMP)"
-        end
-
         def quote_table_name(name)
           parts = name.to_s.split(".")
           raise ArgumentError, "PostgreSQL table name cannot be empty" if parts.empty? || parts.any?(&:empty?)

data/lib/graphql/anycable/postgresql_store/version.rb

@@ -3,7 +3,7 @@
 module GraphQL
   module AnyCable
     module PostgreSQLStore
-      VERSION = "0.1.0"
+      VERSION = "0.2.0"
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: graphql-anycable_postgresql-store
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - TikiTDO
@@ -117,6 +117,8 @@ files:
 - lib/graphql/anycable/postgresql_store/config.rb
 - lib/graphql/anycable/postgresql_store/railtie.rb
 - lib/graphql/anycable/postgresql_store/store.rb
+- lib/graphql/anycable/postgresql_store/store/cleaner.rb
+- lib/graphql/anycable/postgresql_store/store/stats.rb
 - lib/graphql/anycable/postgresql_store/version.rb
 homepage: https://github.com/TikiTDO/graphql-anycable_postgresql-store
 licenses:
@@ -142,7 +144,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.10
 specification_version: 4
 summary: PostgreSQL subscription store for graphql-anycable.
 test_files: []