kiosk-rls 0.5.20

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f342f81e8a0c9d98ccf27406ee1e19cbf77c9d4ed685de2ac0b5cfc5869e82fa
+  data.tar.gz: e50975a44e63e8d6e407e8b717e01ff50c692e405399401fb75880d2eab82f32
+SHA512:
+  metadata.gz: 7bb6b277c855a3cb1a802e3124604501b9bc08e7f22124c94c513c718222e4d42091932b1922fd56937eb12c8835a9bace04855d3ae108829c7470f008912521
+  data.tar.gz: dbbb5b6eab46dde59fa8f7c753d1c14793676ec36888fbc5c3ff80cf3bab35c5109540c45ce561133d464c2c406d93562a5b7efbe7ca603b7287a21822a01688

data/CHANGELOG.md

@@ -0,0 +1,129 @@
+# Changelog
+
+All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and [Semantic Versioning](https://semver.org/).
+
+How to write an entry, and what a release section means: `CHANGELOG-RULE.md` at
+the root of this repository —
+<https://github.com/kiosk-hq/kiosk/blob/main/CHANGELOG-RULE.md>. In short: under
+200 characters, one or two sentences, the essence rather than the content; write it
+under `## [Unreleased]`; a cut renames that heading to
+`## [MAJOR.MINOR.PATCH] — <date>` and opens a fresh empty one above it; nothing
+already written is edited.
+
+## [Unreleased]
+
+## [0.5.20] — 2026-10-20
+
+- 2026-10-20: Version 0.5.20, the tree cut that matches skill 0.5.20.
+
+## [0.5.19] — 2026-10-20
+
+- 2026-10-20: Version 0.5.19, the tree cut that matches skill 0.5.19.
+
+## [0.5.18] — 2026-10-18
+
+- 2026-10-18: Version 0.5.18, the tree cut that matches skill 0.5.18.
+
+## [0.5.17] — 2026-10-18
+
+- 2026-10-18: Version 0.5.17, the tree cut that matches skill 0.5.17.
+
+## [0.5.16] — 2026-10-18
+
+- 2026-10-18: Version 0.5.16, the tree cut that matches skill 0.5.16.
+
+## [0.5.15] — 2026-10-18
+
+- 2026-10-18: Version 0.5.15, the tree cut that matches skill 0.5.15.
+
+## [0.5.14] — 2026-10-18
+
+- 2026-10-18: Version 0.5.14, the tree cut that matches skill 0.5.14.
+
+- 2026-10-17: The `system_role` setting is removed; nothing read it.
+
+## [0.5.13] — 2026-10-11
+
+- 2026-10-11: Version 0.5.13, the tree cut that matches skill 0.5.13.
+
+- 2026-10-09: The README says an app using RLS policies needs `schema_format = :sql`, since `schema.rb` cannot carry them.
+
+## [0.5.12] — 2026-10-08
+
+- 2026-10-08: Version 0.5.12, the tree cut that matches skill 0.5.12; this gem's surface is unchanged.
+
+## [0.5.11] — 2026-10-08
+
+- 2026-10-08: Version 0.5.11, the tree cut that matches skill 0.5.11; this gem's surface is unchanged.
+
+## [0.5.10] — 2026-10-08
+
+- 2026-10-08: Version 0.5.10, the tree cut that matches skill 0.5.10; this gem's surface is unchanged.
+
+## [0.5.9] — 2026-10-08
+
+- 2026-10-08: Version 0.5.9, the tree cut that matches skill 0.5.9; this gem's surface is unchanged.
+
+## [0.5.8] — 2026-10-07
+
+- 2026-10-07: Version 0.5.8, the tree cut that matches skill 0.5.8; this gem's surface is unchanged.
+
+## [0.5.7] — 2026-10-07
+
+- 2026-10-07: Version 0.5.7, the tree cut that matches skill 0.5.7; this gem's surface is unchanged.
+
+## [0.5.6] — 2026-10-07
+
+- 2026-10-07: Version 0.5.6, the tree cut that matches skill 0.5.6; this gem's surface is unchanged.
+
+## [0.5.5] — 2026-10-07
+
+- 2026-10-07: Version 0.5.5, the tree cut that matches skill 0.5.5; this gem's surface is unchanged.
+
+## [0.5.4] — 2026-10-07
+
+- 2026-10-07: Version 0.5.4, the tree cut that matches skill 0.5.4; this gem's surface is unchanged.
+
+## [0.5.3] — 2026-10-06
+
+- 2026-10-06: Version 0.5.3, the tree cut that matches skill 0.5.3; this gem's surface is unchanged.
+
+## [0.5.2] — 2026-10-06
+
+- 2026-10-06: Version 0.5.2, the tree cut that matches skill 0.5.2; this gem's surface is unchanged.
+
+## [0.5.0] — 2026-09-26
+
+### Changed
+
+- **The README stopped forecasting `rake kiosk:rls:{show,check}`, which nothing defines (K-1700).** It now points at `psql`, which answers both questions today.
+
+- **The rubygems blurb listed the DDL this gem emits and left out FORCE ROW LEVEL SECURITY (K-1697).** Without it Postgres exempts the table owner and RLS is a no-op.
+- **`system_role` stops pointing at an Action-DSL escalation that has not shipped (K-1695).** Its live caveat now carries the measurement behind it.
+
+- README: every `gem` line in the install section now carries `github: "kiosk-hq/kiosk"`, so a copied line resolves before publication; the banner above them states what the block does rather than asking the reader to add it.
+- Now truly opt-in: no longer a dependency of kiosk-server, kiosk-all, or
+  kiosk-test-support. `ConfigurationExtension` now contributes only
+  `system_role`; `schema` and `app_role` moved to kiosk-core,
+  `enforce_db_role` to kiosk-server.
+
+### Added
+
+- `Kiosk::RLS::Railtie` — a Rails host gets the five migration verbs on
+  `ActiveRecord::Migration` from the gem itself. The README used to tell the
+  host to write `ActiveRecord::Migration.include(Kiosk::RLS::DSL)` in an
+  initializer; that is an application patching a framework class on a gem's
+  behalf, and it is gone. Non-Rails hosts still include `Kiosk::RLS::DSL`
+  wherever they answer `#execute(sql)`. (K-504)
+- Initial skeleton.
+- `Kiosk::RLS::Policy` value type (Data class): name, action, using, check; action ∈ {select, insert, update, delete, all}.
+- `Kiosk::RLS::Table` mutable builder used inside `enable_rls_on` blocks.
+- `Kiosk::RLS::Emitter` — pure SQL-DDL generation (ENABLE ROW LEVEL SECURITY, GRANT, CREATE POLICY, COMMENT ON TABLE, DROP POLICY, ALTER POLICY ... RENAME TO).
+- `Kiosk::RLS::DSL` — `enable_rls_on`, `add_kiosk_policy_to`, `change_kiosk_policy_on`, `remove_kiosk_policy_from`, `rename_kiosk_policy_on`.
+- `Kiosk::RLS::ConfigurationExtension` — adds the RLS-only `system_role` to `Kiosk::Configuration` with a lazy default.
+- RSpec suite covering policy validation, builder semantics, SQL emission, DSL with fake executor, config extension.
+
+### Out of scope for first release
+
+- `rake kiosk:rls:{show,check}` rake tasks (need PG connection — land later).
+- Schema-separated view DSL (`bin/rails g kiosk:view` — deferred to v1.1).

data/LICENSE.txt

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

data/README.md

@@ -0,0 +1,121 @@
+# kiosk-rls
+
+Optional DB-layer defense-in-depth for [Kiosk](https://kiosk.tech) providers.
+
+## Security model overview
+
+**RLS is not Kiosk's primary security model.** Kiosk's isolation comes from the sanctioned verb surface: agents never send raw SQL, named queries enforce app-layer authz, and `kiosk.current_user_id()` GUCs scope per-user reads in Ruby. That surface is sufficient.
+
+`kiosk-rls` is an **optional** companion for providers who want an additional DB-level row enforcement layer — belt-and-suspenders hardening. Calling `enable_rls_on` is opt-in; not calling it is the default and fully correct.
+
+Policies and the `kiosk.current_*()` functions they call are not representable in `db/schema.rb`; an app that uses this gem needs `config.active_record.schema_format = :sql`.
+
+## What it does
+
+`kiosk-rls` provides the Ruby DSL providers use inside their ActiveRecord migrations to declare RLS policies — and compiles those declarations to standard PostgreSQL DDL.
+
+When you opt in, `enable_rls_on` emits both `ENABLE ROW LEVEL SECURITY` **and** `FORCE ROW LEVEL SECURITY` so the policies actually enforce. Without `FORCE`, Postgres exempts the table owner from RLS — making it a no-op for the typical Rails setup where the app connects as the owner.
+
+**Prerequisite for real enforcement:** the application must connect as a **non-superuser, non-owner role** (the `app_role`) with table GRANTs. `FORCE` makes RLS apply to the table owner too, but a Postgres superuser still bypasses all policies unconditionally. Never use a superuser as the runtime role when RLS enforcement matters.
+
+```ruby
+# db/migrate/20260101000002_create_rentals.rb
+class CreateRentals < ActiveRecord::Migration[8.1]
+  def change
+    create_table :rentals do |t|
+      t.references :user,    null: false, foreign_key: true
+      t.references :scooter, null: false, foreign_key: true
+      t.timestamp  :started_at, null: false
+      t.timestamp  :ended_at
+      t.integer    :total_cents
+      t.timestamps
+    end
+
+    enable_rls_on :rentals do
+      policy :select, using: "user_id = kiosk.current_user_id()"
+      policy :insert, check: "user_id = kiosk.current_user_id() AND kiosk.current_role() = 'customer'"
+      comment "Scooter rentals owned by the renting user. Mutations after creation go through Actions."
+    end
+  end
+end
+```
+
+Compiles to:
+
+```sql
+ALTER TABLE "rentals" ENABLE ROW LEVEL SECURITY;
+ALTER TABLE "rentals" FORCE ROW LEVEL SECURITY;
+GRANT SELECT, INSERT, UPDATE, DELETE ON "rentals" TO "app_role";
+CREATE POLICY "rentals_select" ON "rentals" FOR SELECT USING (user_id = kiosk.current_user_id());
+CREATE POLICY "rentals_insert" ON "rentals" FOR INSERT WITH CHECK (user_id = kiosk.current_user_id() AND kiosk.current_role() = 'customer');
+COMMENT ON TABLE "rentals" IS 'Scooter rentals owned by the renting user. ...';
+```
+
+## Evolving policies
+
+```ruby
+add_kiosk_policy_to    :rentals, :select, using: "..."
+change_kiosk_policy_on :rentals, :update, using: "...", check: "..."
+remove_kiosk_policy_from :rentals, :delete
+rename_kiosk_policy_on   :rentals, from: :select, to: "rentals_select_owner_or_admin"
+```
+
+## Install (opt-in)
+
+> **Not on RubyGems yet** — so every `gem` line below carries `github: "kiosk-hq/kiosk"`, which is what makes it copy-pasteable today. Publication status and the canonical install are stated once, in the monorepo README's [Install](https://github.com/kiosk-hq/kiosk#install) section.
+
+`kiosk-rls` is NOT pulled in by `kiosk-server` or `kiosk-all` — opting in
+means adding the gem yourself:
+
+```ruby
+gem "kiosk-rls", github: "kiosk-hq/kiosk"
+```
+
+## Rails integration
+
+Nothing to wire. The gem ships a railtie (`Kiosk::RLS::Railtie`) that adds the
+migration verbs used above to `ActiveRecord::Migration` on boot, so a
+migration can call `enable_rls_on` the moment the gem is in your `Gemfile`. Do
+**not** put `ActiveRecord::Migration.include(Kiosk::RLS::DSL)` in an
+initializer — the gem does that itself, and an application patching a
+framework class on a gem's behalf is a load-order bug waiting to happen.
+
+What *is* yours to configure is the role posture, in
+`config/initializers/kiosk.rb`:
+
+```ruby
+Kiosk.configure do |c|
+  c.app_role        = "app_role"      # lives in kiosk-core config
+  c.enforce_db_role = true            # kiosk-server: SET LOCAL ROLE per request
+end
+```
+
+### Outside Rails
+
+The DSL is a plain module and needs only a host that answers
+`#execute(sql_string)` — a Sequel migration, a rake task, a bare script:
+
+```ruby
+require "kiosk/rls"
+
+class ApplyRLS
+  include Kiosk::RLS::DSL
+
+  def execute(sql) = DB.run(sql)
+end
+```
+
+## Status
+
+Pre-v1.0 alpha. The DSL surface is stable across pre-v1.0 minor bumps; SQL emission may evolve as we add corner cases (schema-qualified tables, partitioned tables, view-based column gating).
+
+This gem emits DDL and ships no rake tasks. What a table's policies actually are on a live database is `psql`'s to answer, and it needs nothing from here: `\d+ TABLE` prints a `Policies (forced row security enabled)` block carrying every policy body, and `select * from pg_policies where tablename = 'TABLE'` returns the same as rows.
+
+## License
+
+Apache-2.0 — see `LICENSE.txt`.
+
+## Links
+
+- [kiosk.tech](https://kiosk.tech)
+- [Issue tracker](https://github.com/kiosk-hq/kiosk/issues)

data/lib/kiosk/rls/dsl.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require 'kiosk/rls/policy'
+require 'kiosk/rls/table'
+require 'kiosk/rls/emitter'
+
+module Kiosk
+  module RLS
+    # RLS migration verbs for any host that provides `#execute(sql)`;
+    # Rails migrations get them through {Kiosk::RLS::Railtie}.
+    module DSL
+      # @example
+      #   enable_rls_on :rentals do
+      #     policy :select, using: "user_id = kiosk.current_user_id()"
+      #     policy :insert, check: "user_id = kiosk.current_user_id() AND kiosk.current_role() = 'customer'"
+      #     comment "Scooter rentals owned by the renting user."
+      #   end
+      def enable_rls_on(table_name, app_role: nil, sequences: [], &block)
+        table = Table.new(table_name, app_role: app_role, sequences: sequences)
+        table.instance_eval(&block) if block
+        table.validate!
+        emit_rls(Emitter.statements_for(table))
+      end
+
+      def add_kiosk_policy_to(table_name, action, name: nil, using: nil, check: nil)
+        policy = Policy.new(
+          name: name || default_policy_name(table_name, action),
+          action: action,
+          using: using,
+          check: check
+        )
+        emit_rls([Emitter.create_policy_sql(table_name.to_s, policy)])
+      end
+
+      # PG has no `CREATE OR REPLACE POLICY`.
+      def change_kiosk_policy_on(table_name, action, name: nil, using: nil, check: nil)
+        policy_name = name || default_policy_name(table_name, action)
+        emit_rls([
+                   Emitter.drop_policy_sql(table_name.to_s, policy_name),
+                   Emitter.create_policy_sql(
+                     table_name.to_s,
+                     Policy.new(name: policy_name, action: action, using: using, check: check)
+                   )
+                 ])
+      end
+
+      def remove_kiosk_policy_from(table_name, action, name: nil)
+        policy_name = name || default_policy_name(table_name, action)
+        emit_rls([Emitter.drop_policy_sql(table_name.to_s, policy_name)])
+      end
+
+      # A Symbol `from:` names the convention policy `<table>_<from>`.
+      def rename_kiosk_policy_on(table_name, from:, to:)
+        from_name = from.is_a?(Symbol) ? default_policy_name(table_name, from) : from.to_s
+        to_name   = to.to_s
+        emit_rls([Emitter.rename_policy_sql(table_name.to_s, from_name, to_name)])
+      end
+
+      private
+
+      def default_policy_name(table_name, action)
+        "#{table_name}_#{action}"
+      end
+
+      def emit_rls(statements)
+        statements.each { |sql| execute(sql) }
+      end
+    end
+  end
+end

data/lib/kiosk/rls/emitter.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module Kiosk
+  module RLS
+    # Compiles {Table} and {Policy} into PostgreSQL DDL.
+    module Emitter
+      class << self
+        def statements_for(table)
+          name = table.name
+          [
+            enable_rls_sql(name),
+            force_rls_sql(name), # without FORCE the table owner bypasses RLS
+            grant_table_sql(name, table.app_role),
+            *table.sequences.map { |seq| grant_sequence_sql(seq, table.app_role) },
+            *table.policies.map { |policy| create_policy_sql(name, policy) },
+            *(comment_sql(name, table.comment_text) if table.comment_text)
+          ]
+        end
+
+        def enable_rls_sql(table_name)
+          %(ALTER TABLE #{quote_ident(table_name)} ENABLE ROW LEVEL SECURITY)
+        end
+
+        def force_rls_sql(table_name)
+          %(ALTER TABLE #{quote_ident(table_name)} FORCE ROW LEVEL SECURITY)
+        end
+
+        def grant_table_sql(table_name, role)
+          %(GRANT SELECT, INSERT, UPDATE, DELETE ON #{quote_ident(table_name)} TO #{quote_ident(role)})
+        end
+
+        def grant_sequence_sql(sequence_name, role)
+          %(GRANT USAGE, SELECT ON SEQUENCE #{quote_ident(sequence_name)} TO #{quote_ident(role)})
+        end
+
+        def create_policy_sql(table_name, policy)
+          parts = [
+            "CREATE POLICY #{quote_ident(policy.name)}",
+            "ON #{quote_ident(table_name)}",
+            "FOR #{policy.action.to_s.upcase}"
+          ]
+          parts << "USING (#{policy.using})"           if policy.using
+          parts << "WITH CHECK (#{policy.check})"      if policy.check
+          parts.join(' ')
+        end
+
+        def drop_policy_sql(table_name, policy_name)
+          %(DROP POLICY IF EXISTS #{quote_ident(policy_name)} ON #{quote_ident(table_name)})
+        end
+
+        def rename_policy_sql(table_name, from_name, to_name)
+          %(ALTER POLICY #{quote_ident(from_name)} ON #{quote_ident(table_name)} ) +
+            %(RENAME TO #{quote_ident(to_name)})
+        end
+
+        def comment_sql(table_name, text)
+          %(COMMENT ON TABLE #{quote_ident(table_name)} IS #{quote_literal(text)})
+        end
+
+        private
+
+        def quote_ident(name)
+          name.to_s.split('.').map do |part|
+            %("#{part.gsub('"', '""')}")
+          end.join('.')
+        end
+
+        def quote_literal(text)
+          %('#{text.to_s.gsub("'", "''")}')
+        end
+      end
+    end
+  end
+end

data/lib/kiosk/rls/policy.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Kiosk
+  module RLS
+    # One PostgreSQL row-level-security policy: `using` filters reads, `check` writes.
+    Policy = Data.define(:name, :action, :using, :check)
+
+    class Policy
+      ACTIONS = %i[select insert update delete all].freeze
+
+      def initialize(name:, action:, using: nil, check: nil)
+        action = action.to_sym
+        raise ArgumentError, "action must be one of #{ACTIONS.inspect}, got #{action.inspect}" unless ACTIONS.include?(action)
+        raise ArgumentError, 'at least one of using:/check: required' if using.nil? && check.nil?
+
+        super(name: name.to_s, action: action, using: using&.to_s, check: check&.to_s)
+      end
+    end
+  end
+end

data/lib/kiosk/rls/railtie.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'kiosk/rls/dsl'
+
+module Kiosk
+  module RLS
+    # Adds the RLS migration verbs to `ActiveRecord::Migration` with no host wiring.
+    class Railtie < ::Rails::Railtie
+      initializer 'kiosk_rls.migration_dsl' do
+        ActiveSupport.on_load(:active_record) do
+          ActiveRecord::Migration.include(Kiosk::RLS::DSL)
+        end
+      end
+    end
+  end
+end

data/lib/kiosk/rls/table.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require 'kiosk/rls/policy'
+
+module Kiosk
+  module RLS
+    # The builder an `enable_rls_on TABLE do ... end` block runs in.
+    class Table
+      attr_reader :name, :policies, :comment_text, :app_role, :sequences
+
+      def initialize(name, app_role: nil, sequences: [])
+        @name         = name.to_s
+        @policies     = []
+        @comment_text = nil
+        @app_role     = app_role || Kiosk.configuration.app_role
+        @sequences    = Array(sequences).map(&:to_s)
+      end
+
+      def policy(action, name: nil, using: nil, check: nil)
+        @policies << Policy.new(
+          name: name || default_policy_name(action),
+          action: action,
+          using: using,
+          check: check
+        )
+      end
+
+      # Mandatory; emitted as COMMENT ON TABLE.
+      def comment(text)
+        @comment_text = text&.to_s
+      end
+
+      def validate!
+        if @comment_text.nil? || @comment_text.empty?
+          raise ArgumentError,
+                "enable_rls_on(:#{@name}) requires a `comment \"...\"` " \
+                'inside the block'
+        end
+        self
+      end
+
+      private
+
+      def default_policy_name(action)
+        "#{@name}_#{action}"
+      end
+    end
+  end
+end

data/lib/kiosk/rls/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kiosk
+  module RLS
+    VERSION = '0.5.20'
+  end
+end

data/lib/kiosk/rls.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+# kiosk-rls — the Kiosk RLS DSL and SQL emitter.
+
+require 'kiosk'
+
+require 'kiosk/rls/version'
+require 'kiosk/rls/policy'
+require 'kiosk/rls/table'
+require 'kiosk/rls/emitter'
+require 'kiosk/rls/dsl'
+
+# Outside Rails the host includes {Kiosk::RLS::DSL} itself.
+require 'kiosk/rls/railtie' if defined?(Rails::Railtie)

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: kiosk-rls
+version: !ruby/object:Gem::Version
+  version: 0.5.20
+platform: ruby
+authors:
+- Phil Pirozhkov
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: kiosk-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+description: |
+  kiosk-rls provides the row-level-security DSL Kiosk providers use inside
+  their ActiveRecord migrations: `enable_rls_on`, `policy`, plus the
+  add/change/remove/rename migration verbs.
+
+  The DSL compiles to standard PostgreSQL DDL (ALTER TABLE ENABLE ROW LEVEL
+  SECURITY, ALTER TABLE FORCE ROW LEVEL SECURITY, GRANT, CREATE POLICY,
+  COMMENT ON TABLE) and runs inside the migration's transaction via the
+  host's `#execute` method. FORCE is not optional: without it Postgres
+  exempts the table owner, and the typical Rails app connects as the owner,
+  so RLS would be a no-op.
+
+  No PostgreSQL runtime dependency — pure SQL generation. The host
+  provides the connection.
+email:
+- hello@fili.pp.ru
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/kiosk/rls.rb
+- lib/kiosk/rls/dsl.rb
+- lib/kiosk/rls/emitter.rb
+- lib/kiosk/rls/policy.rb
+- lib/kiosk/rls/railtie.rb
+- lib/kiosk/rls/table.rb
+- lib/kiosk/rls/version.rb
+homepage: https://kiosk.tech
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://kiosk.tech
+  source_code_uri: https://github.com/kiosk-hq/kiosk
+  changelog_uri: https://github.com/kiosk-hq/kiosk/blob/main/kiosk-rls/CHANGELOG.md
+  bug_tracker_uri: https://github.com/kiosk-hq/kiosk/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: RLS DSL and PostgreSQL DDL emitter for the Kiosk framework
+test_files: []