feat(lago-rails): configurable DB session timeouts (INF-294) (#225)

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: binaryknot

charts/lago-rails/templates/deployment.yaml

@@ -73,6 +73,22 @@ spec:
             - name: DATABASE_PREPARED_STATEMENTS
               value: {{ .Values.global.database.preparedStatement | quote }}
             {{- end }}
+            {{/* DB session timeouts. Per-instance override wins over the umbrella default; rendered only when set so an unset value falls back to the Postgres server default. */}}
+            {{- $statementTimeout := default .Values.global.database.statementTimeout .Values.config.database.statementTimeout }}
+            {{- if $statementTimeout }}
+            - name: LAGO_DATABASE_STATEMENT_TIMEOUT
+              value: {{ $statementTimeout | quote }}
+            {{- end }}
+            {{- $idleInTransactionTimeout := default .Values.global.database.idleInTransactionTimeout .Values.config.database.idleInTransactionTimeout }}
+            {{- if $idleInTransactionTimeout }}
+            - name: LAGO_DATABASE_IDLE_TX_TIMEOUT
+              value: {{ $idleInTransactionTimeout | quote }}
+            {{- end }}
+            {{- $lockTimeout := default .Values.global.database.lockTimeout .Values.config.database.lockTimeout }}
+            {{- if $lockTimeout }}
+            - name: LAGO_DATABASE_LOCK_TIMEOUT
+              value: {{ $lockTimeout | quote }}
+            {{- end }}
             - name: LAGO_SIDEKIQ_PRO_REQUIRED
               value: {{ .Values.global.sidekiq.pro | quote }}
             - name: LAGO_SIDEKIQ_WEB

charts/lago-rails/values.yaml

@@ -76,6 +76,21 @@ global:
     # explicitly set.
     # @section -- Database
     preparedStatement:
+    # -- (int, milliseconds) Per-instance `statement_timeout`, rendered as
+    # `LAGO_DATABASE_STATEMENT_TIMEOUT`. Overrides `global.database.statementTimeout`.
+    # Unset → falls back to the Postgres server default.
+    # @section -- Database
+    statementTimeout:
+    # -- (int, milliseconds) Per-instance `idle_in_transaction_session_timeout`,
+    # rendered as `LAGO_DATABASE_IDLE_TX_TIMEOUT`. Overrides
+    # `global.database.idleInTransactionTimeout`. Unset → Postgres server default.
+    # @section -- Database
+    idleInTransactionTimeout:
+    # -- (int, milliseconds) Per-instance `lock_timeout`, rendered as
+    # `LAGO_DATABASE_LOCK_TIMEOUT`. Overrides `global.database.lockTimeout`.
+    # Unset → Postgres server default.
+    # @section -- Database
+    lockTimeout:
 
   encryption:
     # -- Primary encryption key (`openssl rand -hex 16`)

charts/lago/values.yaml

@@ -81,6 +81,21 @@ global:
     # explicitly set.
     # @section -- Database
     preparedStatement:
+    # -- (int, milliseconds) Default `statement_timeout` for every Rails pod,
+    # rendered as `LAGO_DATABASE_STATEMENT_TIMEOUT`. Per-component
+    # `config.database.statementTimeout` overrides. Unset → Postgres server default.
+    # @section -- Database
+    statementTimeout:
+    # -- (int, milliseconds) Default `idle_in_transaction_session_timeout`,
+    # rendered as `LAGO_DATABASE_IDLE_TX_TIMEOUT`. Per-component override via
+    # `config.database.idleInTransactionTimeout`. Unset → Postgres server default.
+    # @section -- Database
+    idleInTransactionTimeout:
+    # -- (int, milliseconds) Default `lock_timeout`, rendered as
+    # `LAGO_DATABASE_LOCK_TIMEOUT`. Per-component override via
+    # `config.database.lockTimeout`. Unset → Postgres server default.
+    # @section -- Database
+    lockTimeout:
 
   encryption:
     # -- Primary encryption key (`openssl rand -hex 16`)