pg_sql_triggers 1.0.0

data/lib/tasks/trigger_migrations.rake

@@ -0,0 +1,254 @@
+# frozen_string_literal: true
+
+namespace :trigger do
+  desc "Migrate trigger migrations (options: VERSION=x, VERBOSE=false)"
+  task migrate: :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+
+    target_version = ENV["VERSION"]&.to_i
+    verbose = ENV["VERBOSE"] != "false"
+
+    if verbose
+      puts "Running trigger migrations..."
+      puts "Current version: #{PgSqlTriggers::Migrator.current_version}"
+    end
+
+    PgSqlTriggers::Migrator.run_up(target_version)
+
+    puts "Trigger migrations complete. Current version: #{PgSqlTriggers::Migrator.current_version}" if verbose
+  end
+
+  desc "Rollback trigger migrations (specify steps w/ STEP=n)"
+  task rollback: :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+
+    steps = ENV["STEP"] ? ENV["STEP"].to_i : 1
+    current_version = PgSqlTriggers::Migrator.current_version
+    target_version = [0, current_version - steps].max
+
+    puts "Rolling back trigger migrations..."
+    puts "Current version: #{current_version}"
+    puts "Target version: #{target_version}"
+
+    PgSqlTriggers::Migrator.run_down(target_version)
+
+    puts "Rollback complete. Current version: #{PgSqlTriggers::Migrator.current_version}"
+  end
+
+  desc "Display status of trigger migrations"
+  task "migrate:status" => :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+
+    statuses = PgSqlTriggers::Migrator.status
+
+    if statuses.empty?
+      puts "No trigger migrations found"
+      return
+    end
+
+    puts "\nTrigger Migration Status"
+    puts "=" * 80
+    printf "%<version>-20s %<name>-40s %<status>-10s\n", version: "Version", name: "Name", status: "Status"
+    puts "-" * 80
+
+    statuses.each do |status|
+      printf "%<version>-20s %<name>-40s %<status>-10s\n",
+             version: status[:version],
+             name: status[:name],
+             status: status[:status]
+    end
+
+    puts "=" * 80
+    puts "Current version: #{PgSqlTriggers::Migrator.current_version}"
+  end
+
+  desc "Runs the 'up' for a given migration VERSION"
+  task "migrate:up" => :environment do
+    version = ENV.fetch("VERSION", nil)
+    raise "VERSION is required" unless version
+
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+    PgSqlTriggers::Migrator.run_up(version.to_i)
+    puts "Trigger migration #{version} up complete"
+  end
+
+  desc "Runs the 'down' for a given migration VERSION"
+  task "migrate:down" => :environment do
+    version = ENV.fetch("VERSION", nil)
+    raise "VERSION is required" unless version
+
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+    PgSqlTriggers::Migrator.run_down(version.to_i)
+    puts "Trigger migration #{version} down complete"
+  end
+
+  desc "Rollbacks the database one migration and re migrate up (options: STEP=x, VERSION=x)"
+  task "migrate:redo" => :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+
+    if ENV["VERSION"]
+      version = ENV["VERSION"].to_i
+      PgSqlTriggers::Migrator.run_down(version)
+      PgSqlTriggers::Migrator.run_up(version)
+    else
+      steps = ENV["STEP"] ? ENV["STEP"].to_i : 1
+      current_version = PgSqlTriggers::Migrator.current_version
+      target_version = [0, current_version - steps].max
+
+      PgSqlTriggers::Migrator.run_down(target_version)
+      PgSqlTriggers::Migrator.run_up
+    end
+
+    puts "Trigger migration redo complete"
+  end
+
+  desc "Retrieves the current schema version number for trigger migrations"
+  task version: :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+    puts "Current trigger migration version: #{PgSqlTriggers::Migrator.current_version}"
+  end
+
+  desc "Raises an error if there are pending trigger migrations"
+  task "abort_if_pending_migrations" => :environment do
+    PgSqlTriggers::Migrator.ensure_migrations_table!
+
+    pending = PgSqlTriggers::Migrator.pending_migrations
+    if pending.any?
+      puts "You have #{pending.length} pending trigger migration(s):"
+      pending.each do |migration|
+        puts "  #{migration.version}_#{migration.name}"
+      end
+      raise "Pending trigger migrations found"
+    end
+  end
+end
+
+# Combined tasks for running both schema and trigger migrations
+namespace :db do
+  desc "Migrate the database schema and triggers (options: VERSION=x, VERBOSE=false)"
+  task "migrate:with_triggers" => :environment do
+    verbose = ENV["VERBOSE"] != "false"
+
+    puts "Running schema and trigger migrations..." if verbose
+
+    # Run schema migrations first
+    Rake::Task["db:migrate"].invoke
+
+    # Then run trigger migrations
+    Rake::Task["trigger:migrate"].invoke
+  end
+
+  desc "Rollback schema and trigger migrations (specify steps w/ STEP=n)"
+  task "rollback:with_triggers" => :environment do
+    ENV["STEP"] ? ENV["STEP"].to_i : 1
+
+    # Determine which type of migration was last run
+    schema_version = ActiveRecord::Base.connection.schema_migration_context.current_version || 0
+    trigger_version = PgSqlTriggers::Migrator.current_version
+
+    # Rollback the most recent migration (schema or trigger)
+    if schema_version > trigger_version
+      Rake::Task["db:rollback"].invoke
+    else
+      Rake::Task["trigger:rollback"].invoke
+    end
+  end
+
+  desc "Display status of schema and trigger migrations"
+  task "migrate:status:with_triggers" => :environment do
+    puts "\nSchema Migrations:"
+    puts "=" * 80
+    begin
+      Rake::Task["db:migrate:status"].invoke
+    rescue StandardError => e
+      puts "Error displaying schema migration status: #{e.message}"
+    end
+
+    puts "\nTrigger Migrations:"
+    puts "=" * 80
+    Rake::Task["trigger:migrate:status"].invoke
+  end
+
+  desc "Runs the 'up' for a given migration VERSION (schema or trigger)"
+  task "migrate:up:with_triggers" => :environment do
+    version = ENV.fetch("VERSION", nil)
+    raise "VERSION is required" unless version
+
+    version_int = version.to_i
+
+    # Check if it's a schema or trigger migration
+    schema_migrations = ActiveRecord::Base.connection.migration_context.migrations
+    trigger_migrations = PgSqlTriggers::Migrator.migrations
+
+    schema_migration = schema_migrations.find { |m| m.version == version_int }
+    trigger_migration = trigger_migrations.find { |m| m.version == version_int }
+
+    if schema_migration && trigger_migration
+      # Both exist - run schema first
+      Rake::Task["db:migrate:up"].invoke
+      Rake::Task["trigger:migrate:up"].invoke
+    elsif schema_migration
+      Rake::Task["db:migrate:up"].invoke
+    elsif trigger_migration
+      Rake::Task["trigger:migrate:up"].invoke
+    else
+      raise "No migration found with version #{version}"
+    end
+  rescue StandardError => e
+    puts "Error: #{e.message}"
+    raise
+  end
+
+  desc "Runs the 'down' for a given migration VERSION (schema or trigger)"
+  task "migrate:down:with_triggers" => :environment do
+    version = ENV.fetch("VERSION", nil)
+    raise "VERSION is required" unless version
+
+    version_int = version.to_i
+
+    # Check if it's a schema or trigger migration
+    schema_migrations = ActiveRecord::Base.connection.migration_context.migrations
+    trigger_migrations = PgSqlTriggers::Migrator.migrations
+
+    schema_migration = schema_migrations.find { |m| m.version == version_int }
+    trigger_migration = trigger_migrations.find { |m| m.version == version_int }
+
+    if schema_migration && trigger_migration
+      # Both exist - run trigger down first
+      Rake::Task["trigger:migrate:down"].invoke
+      Rake::Task["db:migrate:down"].invoke
+    elsif schema_migration
+      Rake::Task["db:migrate:down"].invoke
+    elsif trigger_migration
+      Rake::Task["trigger:migrate:down"].invoke
+    else
+      raise "No migration found with version #{version}"
+    end
+  end
+
+  desc "Rollbacks the database one migration and re migrate up (options: STEP=x, VERSION=x)"
+  task "migrate:redo:with_triggers" => :environment do
+    if ENV["VERSION"]
+      Rake::Task["db:migrate:down:with_triggers"].invoke
+      Rake::Task["db:migrate:up:with_triggers"].invoke
+    else
+      Rake::Task["db:rollback:with_triggers"].invoke
+      Rake::Task["db:migrate:with_triggers"].invoke
+    end
+  end
+
+  desc "Retrieves the current schema version numbers for schema and trigger migrations"
+  task "version:with_triggers" => :environment do
+    schema_version = ActiveRecord::Base.connection.schema_migration_context.current_version
+    trigger_version = PgSqlTriggers::Migrator.current_version
+
+    puts "Schema migration version: #{schema_version || 0}"
+    puts "Trigger migration version: #{trigger_version}"
+  end
+
+  desc "Raises an error if there are pending migrations or trigger migrations"
+  task "abort_if_pending_migrations:with_triggers" => :environment do
+    Rake::Task["db:abort_if_pending_migrations"].invoke
+    Rake::Task["trigger:abort_if_pending_migrations"].invoke
+  end
+end

data/sig/pg_sql_triggers.rbs

@@ -0,0 +1,4 @@
+module PgSqlTriggers
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,260 @@
+--- !ruby/object:Gem::Specification
+name: pg_sql_triggers
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- samaswin87
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2025-12-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner-active_record
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rails-controller-testing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.19'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+description: Production-grade PostgreSQL trigger management for Rails with lifecycle
+  management, safe deploys, versioning, drift detection, and a mountable UI.
+email:
+- samaswin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- Goal.md
+- LICENSE
+- README.md
+- RELEASE.md
+- Rakefile
+- app/assets/javascripts/pg_sql_triggers/application.js
+- app/assets/stylesheets/pg_sql_triggers/application.css
+- app/controllers/pg_sql_triggers/application_controller.rb
+- app/controllers/pg_sql_triggers/dashboard_controller.rb
+- app/controllers/pg_sql_triggers/generator_controller.rb
+- app/controllers/pg_sql_triggers/migrations_controller.rb
+- app/controllers/pg_sql_triggers/tables_controller.rb
+- app/models/pg_sql_triggers/application_record.rb
+- app/models/pg_sql_triggers/trigger_registry.rb
+- app/views/layouts/pg_sql_triggers/application.html.erb
+- app/views/pg_sql_triggers/dashboard/index.html.erb
+- app/views/pg_sql_triggers/generator/new.html.erb
+- app/views/pg_sql_triggers/generator/preview.html.erb
+- app/views/pg_sql_triggers/tables/index.html.erb
+- app/views/pg_sql_triggers/tables/show.html.erb
+- config/routes.rb
+- db/migrate/20251222000001_create_pg_sql_triggers_tables.rb
+- lib/generators/pg_sql_triggers/install_generator.rb
+- lib/generators/pg_sql_triggers/templates/README
+- lib/generators/pg_sql_triggers/templates/create_pg_sql_triggers_tables.rb
+- lib/generators/pg_sql_triggers/templates/initializer.rb
+- lib/generators/pg_sql_triggers/templates/trigger_migration.rb.erb
+- lib/generators/pg_sql_triggers/trigger_migration_generator.rb
+- lib/generators/trigger/migration_generator.rb
+- lib/pg_sql_triggers.rb
+- lib/pg_sql_triggers/database_introspection.rb
+- lib/pg_sql_triggers/drift.rb
+- lib/pg_sql_triggers/dsl.rb
+- lib/pg_sql_triggers/dsl/trigger_definition.rb
+- lib/pg_sql_triggers/engine.rb
+- lib/pg_sql_triggers/generator.rb
+- lib/pg_sql_triggers/generator/form.rb
+- lib/pg_sql_triggers/generator/service.rb
+- lib/pg_sql_triggers/migration.rb
+- lib/pg_sql_triggers/migrator.rb
+- lib/pg_sql_triggers/permissions.rb
+- lib/pg_sql_triggers/permissions/checker.rb
+- lib/pg_sql_triggers/registry.rb
+- lib/pg_sql_triggers/registry/manager.rb
+- lib/pg_sql_triggers/registry/validator.rb
+- lib/pg_sql_triggers/sql.rb
+- lib/pg_sql_triggers/testing.rb
+- lib/pg_sql_triggers/testing/dry_run.rb
+- lib/pg_sql_triggers/testing/function_tester.rb
+- lib/pg_sql_triggers/testing/safe_executor.rb
+- lib/pg_sql_triggers/testing/syntax_validator.rb
+- lib/pg_sql_triggers/version.rb
+- lib/tasks/trigger_migrations.rake
+- sig/pg_sql_triggers.rbs
+homepage: https://github.com/samaswin87/pg_sql_triggers
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/samaswin87/pg_sql_triggers
+  source_code_uri: https://github.com/samaswin87/pg_sql_triggers
+  changelog_uri: https://github.com/samaswin87/pg_sql_triggers/blob/main/CHANGELOG.md
+  github_repo: ssh://github.com/samaswin87/pg_sql_triggers
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: A PostgreSQL Trigger Control Plane for Rails
+test_files: []