diff --git a/docs/quick-start/connecting-mysql/page.md b/docs/quick-start/connecting-mysql/page.md index d0aa9cdd7..22764e951 100644 --- a/docs/quick-start/connecting-mysql/page.md +++ b/docs/quick-start/connecting-mysql/page.md @@ -239,3 +239,73 @@ Now when we access {% new-tab-link title="http://localhost:9000/customer" href=" ``` **Note:** When using PostgreSQL or Supabase, you may need to use `$1` instead of `?` in SQL queries, depending on your driver configuration. + +### Enabling Read/Write Splitting in MySQL (DBResolver) +GoFr provides built-in support for read/write splitting using its `DBRESOLVER` module for **MySQL**. +This feature allows applications to route write queries (e.g., `INSERT`, `UPDATE`) to the **primary database**, and +distribute read queries (`SELECT`) across **one or more replicas**, boosting performance, scalability, and reliability. + +Import the GoFr's dbresolver for MySQL: + +```shell +go get gofr.dev/pkg/gofr/datasource/dbresolver@latest +``` + +After importing the package, you can configure the DBResolver in your GoFr application using the `AddDBResolver` method. +You can choose the load balancing strategy and enable fallback to primary: + +```go +// Add DB resolver with round-robin strategy and fallback enabled +resolver := dbresolver.NewProvider("round-robin", true) +a.AddDBResolver(resolver) +``` + +- The first argument specifies the **load balancing strategy** for read queries. Supported values: + - `round-robin`: Distributes reads evenly across replicas. + - `random`: Selects a replica at random for each read. +- The second argument enables **fallback** to the primary if all replicas are unavailable. + +### Configuration + +#### 1. Replica Hosts +Add replica hosts, ports,users, passwords to your `.env` file using the following configs: + +```env +DB_REPLICA_HOSTS=localhost,replica1,replica2 +DB_REPLICA_PORTS=3307,3308,3309 +DB_REPLICA_USERS=readonly1,readonly2,readonly3 +DB_REPLICA_PASSWORDS=pass1,pass2,pass3 + +``` + +These hosts will be treated as **read replicas**. + +#### 2. Replica Connection Pool Tuning +By default, GoFr automatically scales connection pools for replicas based on your primary database settings: + +`DB_MAX_IDLE_CONNECTION` → multiplied by 4 +`DB_MAX_OPEN_CONNECTION` → multiplied by 2 + +This ensures replicas can handle higher read concurrency without impacting the primary. +GoFr also applies min/max caps to keep values safe. These can be customized: + +```go +# Primary DB pool settings +DB_MAX_IDLE_CONNECTION=2 +DB_MAX_OPEN_CONNECTION=20 + +# Replica pool overrides (optional) +DB_REPLICA_MAX_IDLE_CAP=100 +DB_REPLICA_MIN_IDLE=5 +DB_REPLICA_DEFAULT_IDLE=15 + +DB_REPLICA_MAX_OPEN_CAP=500 +DB_REPLICA_MIN_OPEN=20 +DB_REPLICA_DEFAULT_OPEN=150 + +``` + +**Benefits** +- Performance: Offloads read traffic from the primary, reducing latency. +- Scalability: Easily scale reads by adding more replicas. +- Resilience: Ensures high availability through automatic fallback. \ No newline at end of file diff --git a/docs/references/configs/page.md b/docs/references/configs/page.md index 3e0953dde..2804227ba 100644 --- a/docs/references/configs/page.md +++ b/docs/references/configs/page.md @@ -195,6 +195,67 @@ This document lists all the configuration options supported by the GoFr framewor --- +- DB_REPLICA_HOSTS +- Comma-separated list of replica database hosts. Used for read replicas. +- None + +--- + +- DB_REPLICA_PORTS +- Comma-separated list of replica database ports. Used for read replicas. +- None + +--- + +- DB_REPLICA_USERS +- Comma-separated list of replica database users. Used for read replicas. +- None + +--- + +- DB_REPLICA_PASSWORDS_ +- Comma-separated list of replica database passwords. Used for read replicas. +- None + +--- + +- DB_REPLICA_MAX_IDLE_CONNECTIONS +- Maximum idle connections allowed for a replica +- 50 + +--- + +- DB_REPLICA_MIN_IDLE_CONNECTIONS +- Minimum idle connections for a replica +- 10 + +--- + +- DB_REPLICA_DEFAULT_IDLE_CONNECTIONS +- Idle connections used if no primary setting is provided +- 10 + +--- + +- DB_REPLICA_MAX_OPEN_CONNECTIONS +- Maximum open connections allowed for a replica +- 200 + +--- + +- DB_REPLICA_MIN_OPEN_CONNECTIONS +- Minimum open connections for a replica +- 50 + +--- + +- DB_REPLICA_DEFAULT_OPEN_CONNECTIONS +- Open connections used if no primary setting is provided +- 100 + +--- + + - DB_CHARSET - The character set for database connection - utf8 diff --git a/go.work b/go.work index 4772f9d2f..aa0a8af61 100644 --- a/go.work +++ b/go.work @@ -7,6 +7,7 @@ use ( ./pkg/gofr/datasource/cassandra ./pkg/gofr/datasource/clickhouse ./pkg/gofr/datasource/couchbase + ./pkg/gofr/datasource/dbresolver ./pkg/gofr/datasource/dgraph ./pkg/gofr/datasource/elasticsearch ./pkg/gofr/datasource/file/ftp diff --git a/go.work.sum b/go.work.sum index b18de40ab..323d93884 100644 --- a/go.work.sum +++ b/go.work.sum @@ -108,6 +108,8 @@ cloud.google.com/go/auth v0.12.1/go.mod h1:BFMu+TNpF3DmvfBO9ClqTR/SiqVIm7LukKF9m cloud.google.com/go/auth v0.13.0/go.mod h1:COOjD9gwfKNKz+IIduatIhYJQIc0mG3H102r/EMxX6Q= cloud.google.com/go/auth v0.14.1/go.mod h1:4JHUxlGXisL0AW8kXPtUF6ztuOksyfUQNFjfsOCXkPM= cloud.google.com/go/auth v0.15.0/go.mod h1:WJDGqZ1o9E9wKIL+IwStfyn/+s59zl4Bi+1KQNVXLZ8= +cloud.google.com/go/auth v0.16.0/go.mod h1:1howDHJ5IETh/LwYs3ZxvlkXF48aSqqJUM+5o02dNOI= +cloud.google.com/go/auth v0.16.1/go.mod h1:1howDHJ5IETh/LwYs3ZxvlkXF48aSqqJUM+5o02dNOI= cloud.google.com/go/auth/oauth2adapt v0.2.2/go.mod h1:wcYjgpZI9+Yu7LyYBg4pqSiaRkfEK3GQcpb7C/uyF1Q= cloud.google.com/go/automl v1.14.2/go.mod h1:mIat+Mf77W30eWQ/vrhjXsXaRh8Qfu4WiymR0hR6Uxk= cloud.google.com/go/automl v1.14.4 h1:vkD+hQ75SMINMgJBT/KDpFYvfQLzJbtIQZdw0AWq8Rs= @@ -388,6 +390,8 @@ cloud.google.com/go/gkemulticloud v1.5.3 h1:334aZmOzIt3LVBpguCof8IHaLaftcZlx+L0T cloud.google.com/go/gkemulticloud v1.5.3/go.mod h1:KPFf+/RcfvmuScqwS9/2MF5exZAmXSuoSLPuaQ98Xlk= cloud.google.com/go/grafeas v0.3.11 h1:CobnwnyeY1j1Defi5vbEircI+jfrk3ci5m004ZjiFP4= cloud.google.com/go/grafeas v0.3.11/go.mod h1:dcQyG2+T4tBgG0MvJAh7g2wl/xHV2w+RZIqivwuLjNg= +cloud.google.com/go/grafeas v0.3.15 h1:lBjwKmhpiqOAFaE0xdqF8CqO74a99s8tUT5mCkBBxPs= +cloud.google.com/go/grafeas v0.3.15/go.mod h1:irwcwIQOBlLBotGdMwme8PipnloOPqILfIvMwlmu8Pk= cloud.google.com/go/gsuiteaddons v1.7.2/go.mod h1:GD32J2rN/4APilqZw4JKmwV84+jowYYMkEVwQEYuAWc= cloud.google.com/go/gsuiteaddons v1.7.3 h1:QafYhVhyFGpidBUUlVhy6lUHFogFOycVYm9DV7MinhA= cloud.google.com/go/gsuiteaddons v1.7.3/go.mod h1:0rR+LC21v1Sx1Yb6uohHI/F8DF3h2arSJSHvfi3GmyQ= @@ -429,6 +433,7 @@ cloud.google.com/go/logging v1.12.0/go.mod h1:wwYBt5HlYP1InnrtYI0wtwttpVU1rifnMT cloud.google.com/go/logging v1.13.0 h1:7j0HgAp0B94o1YRDqiqm26w4q1rDMH7XNRU34lJXHYc= cloud.google.com/go/logging v1.13.0/go.mod h1:36CoKh6KA/M0PbhPKMq6/qety2DCAErbhXT62TuXALA= cloud.google.com/go/longrunning v0.5.6/go.mod h1:vUaDrWYOMKRuhiv6JBnn49YxCPz2Ayn9GqyjaBT8/mA= +cloud.google.com/go/longrunning v0.6.6/go.mod h1:hyeGJUrPHcx0u2Uu1UFSoYZLn4lkMrccJig0t4FI7yw= cloud.google.com/go/managedidentities v1.7.2/go.mod h1:t0WKYzagOoD3FNtJWSWcU8zpWZz2i9cw2sKa9RiPx5I= cloud.google.com/go/managedidentities v1.7.3 h1:b9xGs24BIjfyvLgCtJoClOZpPi8d8owPgWe5JEINgaY= cloud.google.com/go/managedidentities v1.7.3/go.mod h1:H9hO2aMkjlpY+CNnKWRh+WoQiUIDO8457wWzUGsdtLA= @@ -651,6 +656,8 @@ cloud.google.com/go/storage v1.43.0 h1:CcxnSohZwizt4LCzQHWvBf1/kvtHUn7gk9QERXPyX cloud.google.com/go/storage v1.43.0/go.mod h1:ajvxEa7WmZS1PxvKRq4bq0tFT3vMd502JwstCcYv0Q0= cloud.google.com/go/storage v1.50.0 h1:3TbVkzTooBvnZsk7WaAQfOsNrdoM8QHusXA1cpk6QJs= cloud.google.com/go/storage v1.50.0/go.mod h1:l7XeiD//vx5lfqE3RavfmU9yvk5Pp0Zhcv482poyafY= +cloud.google.com/go/storage v1.53.0 h1:gg0ERZwL17pJ+Cz3cD2qS60w1WMDnwcm5YPAIQBHUAw= +cloud.google.com/go/storage v1.53.0/go.mod h1:7/eO2a/srr9ImZW9k5uufcNahT2+fPb8w5it1i5boaA= cloud.google.com/go/storagetransfer v1.11.2/go.mod h1:FcM29aY4EyZ3yVPmW5SxhqUdhjgPBUOFyy4rqiQbias= cloud.google.com/go/storagetransfer v1.12.1 h1:W3v9A7MGBN7H9sAFstyciwP/1XEQhUhZfrjclmDnpMs= cloud.google.com/go/storagetransfer v1.12.1/go.mod h1:hQqbfs8/LTmObJyCC0KrlBw8yBJ2bSFlaGila0qBMk4= @@ -772,14 +779,20 @@ github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.49 github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.49.0/go.mod h1:6fTWu4m3jocfUZLYF5KsZC1TUfRvEjs7lM4crme/irw= github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.50.0 h1:5IT7xOdq17MtcdtL/vtl6mGfzhaq4m4vpollPRmlsBQ= github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.50.0/go.mod h1:ZV4VOm0/eHR06JLrXWe09068dHpr3TRpY9Uo7T+anuA= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.51.0 h1:fYE9p3esPxA/C0rQ0AHhP0drtPXDRhaWiwg1DPqO7IU= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/exporter/metric v0.51.0/go.mod h1:BnBReJLvVYx2CS/UHOgVz2BXKXD9wsQPxZug20nZhd0= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.49.0 h1:jJKWl98inONJAr/IZrdFQUWcwUO95DLY1XMD1ZIut+g= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.49.0/go.mod h1:l2fIqmwB+FKSfvn3bAD/0i+AXAxhIZjTK2svT/mgUXs= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.50.0 h1:nNMpRpnkWDAaqcpxMJvxa/Ud98gjbYwayJY4/9bdjiU= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.50.0/go.mod h1:SZiPHWGOOk3bl8tkevxkoiwPgsIl6CwrWcbwjfHZpdM= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.51.0 h1:OqVGm6Ei3x5+yZmSJG1Mh2NwHvpVmZ08CB5qJhT9Nuk= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/cloudmock v0.51.0/go.mod h1:SZiPHWGOOk3bl8tkevxkoiwPgsIl6CwrWcbwjfHZpdM= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.49.0 h1:GYUJLfvd++4DMuMhCFLgLXvFwofIxh/qOwoGuS/LTew= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.49.0/go.mod h1:wRbFgBQUVm1YXrvWKofAEmq9HNJTDphbAaJSSX01KUI= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.50.0 h1:ig/FpDD2JofP/NExKQUbn7uOSZzJAQqogfqluZK4ed4= github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.50.0/go.mod h1:otE2jQekW/PqXk1Awf5lmfokJx4uwuqcj1ab5SpGeW0= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.51.0 h1:6/0iUd0xrnX7qt+mLNRwg5c0PGv8wpE8K90ryANQwMI= +github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.51.0/go.mod h1:otE2jQekW/PqXk1Awf5lmfokJx4uwuqcj1ab5SpGeW0= github.com/IBM/sarama v1.43.1 h1:Z5uz65Px7f4DhI/jQqEm/tV9t8aU+JUdTyW/K/fCXpA= github.com/IBM/sarama v1.43.1/go.mod h1:GG5q1RURtDNPz8xxJs3mgX6Ytak8Z9eLhAkJPObe2xE= github.com/Microsoft/go-winio v0.6.1 h1:9/kr64B9VUZrLm5YYwbGtUJnMgqWVOdUAXu6Migciow= @@ -869,6 +882,8 @@ github.com/docker/docker v28.1.1+incompatible h1:49M11BFLsVO1gxY9UX9p/zwkE/rswgg github.com/docker/docker v28.1.1+incompatible/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk= github.com/docker/docker v28.2.2+incompatible h1:CjwRSksz8Yo4+RmQ339Dp/D2tGO5JxwYeqtMOEe0LDw= github.com/docker/docker v28.2.2+incompatible/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk= +github.com/docker/docker v28.3.2+incompatible h1:wn66NJ6pWB1vBZIilP8G3qQPqHy5XymfYn5vsqeA5oA= +github.com/docker/docker v28.3.2+incompatible/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk= github.com/docker/docker v28.3.3+incompatible h1:Dypm25kh4rmk49v1eiVbsAtpAsYURjYkaKubwuBdxEI= github.com/docker/docker v28.3.3+incompatible/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk= github.com/docker/go-connections v0.5.0 h1:USnMq7hx7gwdVZq1L49hLXaFtUdTADjXGp+uj1Br63c= @@ -1001,6 +1016,8 @@ github.com/googleapis/gax-go/v2 v2.0.4/go.mod h1:0Wqv26UfaUD9n4G6kQubkQ+KchISgw+ github.com/googleapis/gax-go/v2 v2.0.5/go.mod h1:DWXyrwAJ9X0FpwwEdw+IPEYBICEFu5mhpdKc/us6bOk= github.com/googleapis/gax-go/v2 v2.12.3/go.mod h1:AKloxT6GtNbaLm8QTNSidHUVsHYcBHwWRvkNFJUQcS4= github.com/googleapis/gax-go/v2 v2.14.0/go.mod h1:lhBCnjdLrWRaPvLWhmc8IS24m9mr07qSYnHncrgo+zk= +github.com/googleapis/gax-go/v2 v2.14.1/go.mod h1:Hb/NubMaVM88SrNkvl8X/o8XWwDJEPqouaLeN2IUxoA= +github.com/googleapis/gax-go/v2 v2.14.2/go.mod h1:ON64QhlJkhVtSqp4v1uaK92VyZ2gmvDQsweuyLV+8+w= github.com/googleapis/google-cloud-go-testing v0.0.0-20200911160855-bcd43fbb19e8 h1:tlyzajkF3030q6M8SvmJSemC9DTHL/xaMa18b65+JM4= github.com/googleapis/google-cloud-go-testing v0.0.0-20200911160855-bcd43fbb19e8/go.mod h1:dvDLG8qkwmyD9a/MJJN3XJcT3xFxOKAvTZGvuZmac9g= github.com/hashicorp/go-uuid v1.0.3 h1:2gKiV6YVmrJ1i2CKKa9obLvRieoRGviZFL26PcT/Co8= @@ -1125,6 +1142,7 @@ github.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10/go.mod h1 github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c h1:ncq/mPwQF4JjgDlrVEn3C11VoGHZN7m8qihwgMEtzYw= github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c/go.mod h1:OmDBASR4679mdNQnz2pUhc2G8CO2JrUAVFDRBDP/hJE= github.com/prometheus/client_golang v1.20.4/go.mod h1:PIEt8X02hGcP8JWbeHyeZ53Y/jReSnHgO035n//V5WE= +github.com/prometheus/client_golang v1.22.0/go.mod h1:R7ljNsLXhuQXYZYtw6GAE9AZg8Y7vEW5scdCXrWRXC0= github.com/rabbitmq/amqp091-go v1.9.0 h1:qrQtyzB4H8BQgEuJwhmVQqVHB9O4+MNDJCCAcpc3Aoo= github.com/rabbitmq/amqp091-go v1.9.0/go.mod h1:+jPrT9iY2eLjRaMSRHUhc3z14E/l85kv/f+6luSD3pc= github.com/rcrowley/go-metrics v0.0.0-20201227073835-cf1acfcdf475 h1:N/ElC8H3+5XpJzTSTfLsJV/mx9Q9g7kxmchpfZyxgzM= @@ -1156,6 +1174,7 @@ github.com/spf13/pflag v1.0.5/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An github.com/spiffe/go-spiffe/v2 v2.5.0 h1:N2I01KCUkv1FAjZXJMwh95KK1ZIQLYbPfhaxw8WS0hE= github.com/spiffe/go-spiffe/v2 v2.5.0/go.mod h1:P+NxobPc6wXhVtINNtFjNWGBTreew1GBUCwT2wPmb7g= github.com/stretchr/testify v1.8.4/go.mod h1:sz/lmYIOXD/1dqDmKjjqLyZ2RngseejIcXlSw2iwfAo= +github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= github.com/testcontainers/testcontainers-go v0.28.0 h1:1HLm9qm+J5VikzFDYhOd+Zw12NtOl+8drH2E8nTY1r8= github.com/testcontainers/testcontainers-go v0.28.0/go.mod h1:COlDpUXbwW3owtpMkEB1zo9gwb1CoKVKlyrVPejF4AU= github.com/testcontainers/testcontainers-go v0.33.0 h1:zJS9PfXYT5O0ZFXM2xxXfk4J5UMw/kRiISng037Gxdw= @@ -1201,10 +1220,12 @@ go.opentelemetry.io/contrib/detectors/gcp v1.36.0 h1:F7q2tNlCaHY9nMKHR6XH9/qkp8F go.opentelemetry.io/contrib/detectors/gcp v1.36.0/go.mod h1:IbBN8uAIIx734PTonTPxAxnjc2pQTxWNkwfstZ+6H2k= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.54.0/go.mod h1:B9yO6b04uB80CzjedvewuqDhxJxi11s7/GtiGa8bAjI= go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.59.0/go.mod h1:ijPqXp5P6IRRByFVVg9DY8P5HkxkHE5ARIa+86aXPf4= +go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.60.0/go.mod h1:rg+RlpR5dKwaS95IyyZqj5Wd4E13lk/msnTS0Xl9lJM= go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.56.0/go.mod h1:3qi2EEwMgB4xnKgPLqsDP3j9qxnHDZeHsnAxfjQqTko= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.49.0/go.mod h1:p8pYQP+m5XfbZm9fxtSKAbM6oIllS7s2AfxrChvc7iw= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.54.0/go.mod h1:L7UH0GbB0p47T4Rri3uHjbpCFYrVrwc1I25QhNPiGK8= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.58.0/go.mod h1:umTcuxiv1n/s/S6/c2AT/g2CQ7u5C59sHDNmfSwgz7Q= +go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.60.0/go.mod h1:69uWxva0WgAA/4bu2Yy70SLDBwZXuQ6PbBpbsa5iZrQ= go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.61.0/go.mod h1:UHB22Z8QsdRDrnAtX4PntOl36ajSxcdUMt1sF7Y6E7Q= go.opentelemetry.io/otel v1.22.0/go.mod h1:eoV4iAi3Ea8LkAEI9+GFT44O6T/D0GWAVFyZVCC6pMI= go.opentelemetry.io/otel v1.24.0/go.mod h1:W7b9Ozg4nkF5tWI5zsXkaKKDjdVjpD4oAt9Qi/MArHo= @@ -1218,6 +1239,8 @@ go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0 h1:IeMey go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0/go.mod h1:oVdCUtjq9MK9BlS7TtucsQwUcXcymNiEDjgDD2jMtZU= go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.29.0 h1:WDdP9acbMYjbKIyJUhTvtzj601sVJOqgWdUxSdR/Ysc= go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.29.0/go.mod h1:BLbf7zbNIONBLPwvFnwNHGj4zge8uTCM/UPIVW1Mq2I= +go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.35.0 h1:PB3Zrjs1sG1GBX51SXyTSoOTqcDglmsk7nT6tkKPb/k= +go.opentelemetry.io/otel/exporters/stdout/stdoutmetric v1.35.0/go.mod h1:U2R3XyVPzn0WX7wOIypPuptulsMcPDPs/oiSVOMVnHY= go.opentelemetry.io/otel/metric v1.22.0/go.mod h1:evJGjVpZv0mQ5QBRJoBF64yMuOf4xCWdXjK8pzFvliY= go.opentelemetry.io/otel/metric v1.24.0/go.mod h1:VYhLe1rFfxuTXLgj4CBiyz+9WYBA8pNGJgDcSFRKBco= go.opentelemetry.io/otel/metric v1.29.0/go.mod h1:auu/QWieFVWx+DmQOUMgj0F8LHWdgalxXqvp7BII/W8= @@ -1231,7 +1254,9 @@ go.opentelemetry.io/otel/sdk v1.22.0/go.mod h1:iu7luyVGYovrRpe2fmj3CVKouQNdTOkxt go.opentelemetry.io/otel/sdk v1.29.0/go.mod h1:pM8Dx5WKnvxLCb+8lG1PRNIDxu9g9b9g59Qr7hfAAok= go.opentelemetry.io/otel/sdk v1.32.0/go.mod h1:LqgegDBjKMmb2GC6/PrTnteJG39I8/vJCAP9LlJXEjU= go.opentelemetry.io/otel/sdk v1.33.0/go.mod h1:A1Q5oi7/9XaMlIWzPSxLRWOI8nG3FnzHJNbiENQuihM= +go.opentelemetry.io/otel/sdk v1.35.0/go.mod h1:+ga1bZliga3DxJ3CQGg3updiaAJoNECOgJREo9KHGQg= go.opentelemetry.io/otel/sdk/metric v1.32.0/go.mod h1:PWeZlq0zt9YkYAp3gjKZ0eicRYvOh1Gd+X99x6GHpCQ= +go.opentelemetry.io/otel/sdk/metric v1.35.0/go.mod h1:is6XYCUMpcKi+ZsOvfluY5YstFnhW0BidkR+gL+qN+w= go.opentelemetry.io/otel/trace v1.22.0/go.mod h1:RbbHXVqKES9QhzZq/fE5UnOSILqRt40a21sPw2He1xo= go.opentelemetry.io/otel/trace v1.24.0/go.mod h1:HPc3Xr/cOApsBI154IU0OI0HJexz+aw5uPdbs3UCjNU= go.opentelemetry.io/otel/trace v1.29.0/go.mod h1:eHl3w0sp3paPkYstJOmAimxhiFXPg+MMTlEh3nsQgWQ= @@ -1253,9 +1278,13 @@ golang.org/x/crypto v0.0.0-20210421170649-83a5a9bb288b/go.mod h1:T9bdIzuCu7OtxOm golang.org/x/crypto v0.0.0-20220722155217-630584e8d5aa/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4= golang.org/x/crypto v0.16.0/go.mod h1:gCAAfMLgwOJRpTjQ2zCCt2OcSfYMTeZVSRtQlPC7Nq4= golang.org/x/crypto v0.31.0/go.mod h1:kDsLvtWBEx7MV9tJOj9bnXsPbxwJQ6csT/x4KIN4Ssk= +golang.org/x/crypto v0.32.0/go.mod h1:ZnnJkOaASj8g0AjIduWNlq2NRxL0PlBrbKVyZ6V/Ugc= golang.org/x/crypto v0.33.0/go.mod h1:bVdXmD7IV/4GdElGPozy6U7lWdRXA4qyRVGJV57uQ5M= -golang.org/x/crypto v0.36.0/go.mod h1:Y4J0ReaxCR1IMaabaSMugxJES1EpwhBHhv2bDHklZvc= +golang.org/x/crypto v0.37.0/go.mod h1:vg+k43peMZ0pUMhYmVAWysMK35e6ioLh3wB8ZCAfbVc= golang.org/x/crypto v0.38.0/go.mod h1:MvrbAqul58NNYPKnOra203SB9vpuZW0e+RRZV+Ggqjw= +golang.org/x/crypto v0.39.0/go.mod h1:L+Xg3Wf6HoL4Bn4238Z6ft6KfEpN0tJGo53AAPC632U= +golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4= +golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc= golang.org/x/exp v0.0.0-20190306152737-a1d7652674e8/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= golang.org/x/exp v0.0.0-20190510132918-efd6b22b2522/go.mod h1:ZjyILWgesfNpC6sMxTJOJm9Kp84zZh5NQWvqDGG3Qr8= golang.org/x/exp v0.0.0-20190829153037-c13cbed26979/go.mod h1:86+5VVa7VpoJ4kLfm080zCjGlMRFzhUhsZKEZO7MGek= @@ -1291,6 +1320,7 @@ golang.org/x/mod v0.17.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= golang.org/x/mod v0.18.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= golang.org/x/mod v0.19.0/go.mod h1:hTbmBsO62+eylJbnUtE2MGJUyE7QWk4xUqPFrRgJ+7c= golang.org/x/mod v0.24.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww= +golang.org/x/mod v0.26.0/go.mod h1:/j6NAhSk8iQ723BGAUyoAcn7SlD7s15Dp9Nd/SfeaFQ= golang.org/x/net v0.0.0-20190108225652-1e06a53dbb7e/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= golang.org/x/net v0.0.0-20190501004415-9ce7a6920f09/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= golang.org/x/net v0.0.0-20190503192946-f4e77d36d62c/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= @@ -1323,7 +1353,10 @@ golang.org/x/net v0.33.0/go.mod h1:HXLR5J+9DxmrqMwG9qjGCxZ+zKXxBru04zlTvWlWuN4= golang.org/x/net v0.34.0/go.mod h1:di0qlW3YNM5oh6GqDGQr92MyTozJPmybPK4Ev/Gm31k= golang.org/x/net v0.35.0/go.mod h1:EglIi67kWsHKlRzzVMUD93VMSWGFOMSZgxFjparz1Qk= golang.org/x/net v0.37.0/go.mod h1:ivrbrMbzFq5J41QOQh0siUuly180yBYtLp+CKbEaFx8= +golang.org/x/net v0.39.0/go.mod h1:X7NRbYVEA+ewNkCNyJ513WmMdQ3BineSwVtN2zD/d+E= golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA= +golang.org/x/net v0.43.0 h1:lat02VYK2j4aLzMzecihNvTlJNQUq316m2Mr9rnM6YE= +golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg= golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20190604053449-0f29369cfe45/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= golang.org/x/oauth2 v0.0.0-20191202225959-858c2ad4c8b6/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= @@ -1349,6 +1382,7 @@ golang.org/x/sync v0.8.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sync v0.10.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk= golang.org/x/sync v0.12.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= golang.org/x/sync v0.13.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= +golang.org/x/sync v0.14.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= golang.org/x/sync v0.15.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= golang.org/x/sys v0.0.0-20190312061237-fead79001313/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.0.0-20190502145724-3ef323f4f1fd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= @@ -1389,21 +1423,26 @@ golang.org/x/telemetry v0.0.0-20240521205824-bda55230c457 h1:zf5N6UOrA487eEFacMe golang.org/x/telemetry v0.0.0-20240521205824-bda55230c457/go.mod h1:pRgIJT+bRLFKnoM1ldnzKoxTIn14Yxz928LQRYYgIN0= golang.org/x/telemetry v0.0.0-20250710130107-8d8967aff50b h1:DU+gwOBXU+6bO0sEyO7o/NeMlxZxCZEvI7v+J4a1zRQ= golang.org/x/telemetry v0.0.0-20250710130107-8d8967aff50b/go.mod h1:4ZwOYna0/zsOKwuR5X/m0QFOJpSZvAxFfkQT+Erd9D4= +golang.org/x/telemetry v0.0.0-20250807160809-1a19826ec488 h1:3doPGa+Gg4snce233aCWnbZVFsyFMo/dR40KK/6skyE= +golang.org/x/telemetry v0.0.0-20250807160809-1a19826ec488/go.mod h1:fGb/2+tgXXjhjHsTNdVEEMZNWA0quBnfrO+AfoDSAKw= golang.org/x/term v0.31.0/go.mod h1:R4BeIy7D95HzImkxGkTW1UQTtP54tio2RyHz7PwK0aw= golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk= golang.org/x/text v0.3.4/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU= golang.org/x/text v0.16.0/go.mod h1:GhwF1Be+LQoKShO3cGOHzqOgRrGaYc9AvblQOmPVHnI= golang.org/x/text v0.17.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY= golang.org/x/text v0.19.0/go.mod h1:BuEKDfySbSR4drPmRPG/7iBdf8hvFMuRexcpahXilzY= golang.org/x/text v0.21.0/go.mod h1:4IBbMaMmOPCJ8SecivzSH54+73PCFmPWxNTLm+vZkEQ= golang.org/x/text v0.24.0/go.mod h1:L8rBsPeo2pSS+xqN0d5u2ikmjtmoJbDBT1b7nHvFCdU= +golang.org/x/text v0.26.0/go.mod h1:QK15LZJUUQVJxhz7wXgxSy/CJaTFjd0G+YLonydOVQA= golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.0.0-20190308202827-9d24e82272b4/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.0.0-20191024005414-555d28b269f0/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= golang.org/x/time v0.5.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= golang.org/x/time v0.8.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM= +golang.org/x/time v0.11.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg= golang.org/x/tools v0.0.0-20190312151545-0bb0c0a6e846/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190312170243-e65039ee4138/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= golang.org/x/tools v0.0.0-20190425150028-36563e24a262/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= @@ -1449,6 +1488,7 @@ golang.org/x/tools v0.13.0/go.mod h1:HvlwmtVNQAhOuCjW7xxvovg8wbNq7LwfXh/k7wXUl58 golang.org/x/tools v0.21.1-0.20240508182429-e35e4ccd0d2d/go.mod h1:aiJjzUbINMkxbQROHiO6hDPo2LHcIPhhQsa9DLh0yGk= golang.org/x/tools v0.22.0/go.mod h1:aCwcsjqvq7Yqt6TNyX7QMU2enbQ/Gt0bo6krSeEri+c= golang.org/x/tools v0.23.0/go.mod h1:pnu6ufv6vQkll6szChhK3C3L/ruaIv5eBeztNG8wtsI= +golang.org/x/tools v0.35.0/go.mod h1:NKdj5HkL/73byiZSJjqJgKn3ep7KjFkBOkR/Hps3VPw= golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da h1:noIWHXmPHxILtqtCOPIhSt0ABwskkZKjD3bXGnZGpNY= golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da/go.mod h1:NDW/Ps6MPRej6fsCIbMTohpP40sJ/P/vI1MoTEGwX90= @@ -1480,6 +1520,9 @@ google.golang.org/api v0.219.0/go.mod h1:K6OmjGm+NtLrIkHxv1U3a0qIf/0JOvAHd5O/6Ao google.golang.org/api v0.222.0/go.mod h1:efZia3nXpWELrwMlN5vyQrD4GmJN1Vw0x68Et3r+a9c= google.golang.org/api v0.224.0/go.mod h1:3V39my2xAGkodXy0vEqcEtkqgw2GtrFL5WuBZlCTCOQ= google.golang.org/api v0.227.0/go.mod h1:EIpaG6MbTgQarWF5xJvX0eOJPK9n/5D4Bynb9j2HXvQ= +google.golang.org/api v0.229.0/go.mod h1:wyDfmq5g1wYJWn29O22FDWN48P7Xcz0xz+LBpptYvB0= +google.golang.org/api v0.232.0/go.mod h1:p9QCfBWZk1IJETUdbTKloR5ToFdKbYh2fkjsUL6vNoY= +google.golang.org/api v0.239.0/go.mod h1:cOVEm2TpdAGHL2z+UwyS+kmlGr3bVWQQ6sYEqkKje50= google.golang.org/appengine v1.5.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= google.golang.org/appengine v1.6.1/go.mod h1:i06prIuMbXzDqacNJfV5OdTW448YApPu5ww/cMBSeb0= google.golang.org/appengine v1.6.5/go.mod h1:8WjMMxjGQR8xUklV/ARdw2HLXBOI7O7uCIDZVag1xfc= @@ -1522,6 +1565,7 @@ google.golang.org/genproto v0.0.0-20210108203827-ffc7fda8c3d7/go.mod h1:FWY/as6D google.golang.org/genproto v0.0.0-20210226172003-ab064af71705/go.mod h1:FWY/as6DDZQgahTzZj3fqbO1CbirC29ZNUFHwi0/+no= google.golang.org/genproto v0.0.0-20240711142825-46eb208f015d/go.mod h1:FfBgJBJg9GcpPvKIuHSZ/aE1g2ecGL74upMzGZjiGEY= google.golang.org/genproto v0.0.0-20250122153221-138b5a5a4fd4/go.mod h1:qbZzneIOXSq+KFAFut9krLfRLZiFLzZL5u2t8SV83EE= +google.golang.org/genproto v0.0.0-20250303144028-a0af3efb3deb/go.mod h1:sAo5UzpjUwgFBCzupwhcLcxHVDK7vG5IqI30YnwX2eE= google.golang.org/genproto/googleapis/api v0.0.0-20230822172742-b8732ec3820d/go.mod h1:KjSP20unUpOx5kyQUFa7k4OJg0qeJ7DEZflGDu2p6Bk= google.golang.org/genproto/googleapis/api v0.0.0-20240429193739-8cf5692501f6/go.mod h1:10yRODfgim2/T8csjQsMPgZOMvtytXKTDRzH6HRGzRw= google.golang.org/genproto/googleapis/api v0.0.0-20240814211410-ddb44dafa142/go.mod h1:d6be+8HhtEtucleCbxpPW9PA9XwISACu8nvpPqF0BVo= @@ -1536,7 +1580,8 @@ google.golang.org/genproto/googleapis/api v0.0.0-20250218202821-56aae31c358a/go. google.golang.org/genproto/googleapis/api v0.0.0-20250219182151-9fdb1cabc7b2/go.mod h1:W9ynFDP/shebLB1Hl/ESTOap2jHd6pmLXPNZC7SVDbA= google.golang.org/genproto/googleapis/api v0.0.0-20250227231956-55c901821b1e/go.mod h1:Xsh8gBVxGCcbV8ZeTB9wI5XPyZ5RvC6V3CTeeplHbiA= google.golang.org/genproto/googleapis/api v0.0.0-20250303144028-a0af3efb3deb/go.mod h1:jbe3Bkdp+Dh2IrslsFCklNhweNTBgSYanP1UXhJDhKg= -google.golang.org/genproto/googleapis/api v0.0.0-20250324211829-b45e905df463/go.mod h1:U90ffi8eUL9MwPcrJylN5+Mk2v3vuPDptd5yyNUiRR8= +google.golang.org/genproto/googleapis/api v0.0.0-20250414145226-207652e42e2e/go.mod h1:085qFyf2+XaZlRdCgKNCIZ3afY2p4HHZdoIRpId8F4A= +google.golang.org/genproto/googleapis/api v0.0.0-20250425173222-7b384671a197/go.mod h1:Cd8IzgPo5Akum2c9R6FsXNaZbH3Jpa2gpHlW89FqlyQ= google.golang.org/genproto/googleapis/api v0.0.0-20250528174236-200df99c418a/go.mod h1:a77HrdMjoeKbnd2jmgcWdaS++ZLZAEq3orIOAEIKiVw= google.golang.org/genproto/googleapis/bytestream v0.0.0-20250106144421-5f5ef82da422 h1:w6g+P/ZscmNlGxVVXGaPVQOLu1q19ubsTOZKwaDqm4k= google.golang.org/genproto/googleapis/bytestream v0.0.0-20250106144421-5f5ef82da422/go.mod h1:s4mHJ3FfG8P6A3O+gZ8TVqB3ufjOl9UG3ANCMMwCHmo= @@ -1574,8 +1619,11 @@ google.golang.org/genproto/googleapis/rpc v0.0.0-20250219182151-9fdb1cabc7b2/go. google.golang.org/genproto/googleapis/rpc v0.0.0-20250227231956-55c901821b1e/go.mod h1:LuRYeWDFV6WOn90g357N17oMCaxpgCnbi/44qJvDn2I= google.golang.org/genproto/googleapis/rpc v0.0.0-20250303144028-a0af3efb3deb/go.mod h1:LuRYeWDFV6WOn90g357N17oMCaxpgCnbi/44qJvDn2I= google.golang.org/genproto/googleapis/rpc v0.0.0-20250313205543-e70fdf4c4cb4/go.mod h1:LuRYeWDFV6WOn90g357N17oMCaxpgCnbi/44qJvDn2I= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250414145226-207652e42e2e/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250505200425-f936aa4a68b2/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= google.golang.org/genproto/googleapis/rpc v0.0.0-20250512202823-5a2f75b736a9/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= google.golang.org/genproto/googleapis/rpc v0.0.0-20250519155744-55703ea1f237/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250603155806-513f23925822/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= google.golang.org/grpc v1.21.1/go.mod h1:oYelfM1adQP15Ek0mdvEgi9Df8B9CZIaU1084ijfRaM= google.golang.org/grpc v1.26.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= @@ -1594,8 +1642,10 @@ google.golang.org/grpc v1.68.1/go.mod h1:+q1XYFJjShcqn0QZHvCyeR4CXPA+llXIeUIfIe0 google.golang.org/grpc v1.70.0/go.mod h1:ofIJqVKDXx/JiXrwr2IG4/zwdH9txy3IlF40RmcJSQw= google.golang.org/grpc v1.71.0/go.mod h1:H0GRtasmQOh9LkFoCPDu3ZrwUtD1YGE+b2vYBYd/8Ec= google.golang.org/grpc v1.71.1/go.mod h1:H0GRtasmQOh9LkFoCPDu3ZrwUtD1YGE+b2vYBYd/8Ec= +google.golang.org/grpc v1.72.0/go.mod h1:wH5Aktxcg25y1I3w7H69nHfXdOG3UiadoBtjh3izSDM= google.golang.org/grpc v1.72.1/go.mod h1:wH5Aktxcg25y1I3w7H69nHfXdOG3UiadoBtjh3izSDM= google.golang.org/grpc v1.72.2/go.mod h1:wH5Aktxcg25y1I3w7H69nHfXdOG3UiadoBtjh3izSDM= +google.golang.org/grpc v1.73.0/go.mod h1:50sbHOUqWoCQGI8V2HQLJM0B+LMlIUjNSZmow7EVBQc= google.golang.org/grpc/examples v0.0.0-20230224211313-3775f633ce20 h1:MLBCGN1O7GzIx+cBiwfYPwtmZ41U3Mn/cotLJciaArI= google.golang.org/grpc/examples v0.0.0-20230224211313-3775f633ce20/go.mod h1:Nr5H8+MlGWr5+xX/STzdoEqJrO+YteqFbMyCsrb6mH0= google.golang.org/protobuf v1.24.0/go.mod h1:r/3tXBNzIEhYS9I1OUVjXDlt8tc493IdKGjtUeSXeh4= diff --git a/pkg/gofr/container/datasources.go b/pkg/gofr/container/datasources.go index 6ae51f674..5b7ec4154 100644 --- a/pkg/gofr/container/datasources.go +++ b/pkg/gofr/container/datasources.go @@ -776,3 +776,11 @@ type CouchbaseProvider interface { provider } + +// DBResolverProvider defines an interface for SQL read/write splitting providers. +type DBResolverProvider interface { + // Build creates a resolver with the given primary and replicas. + Build(primary DB, replicas []DB) (DB, error) + + provider +} diff --git a/pkg/gofr/container/mock_datasources.go b/pkg/gofr/container/mock_datasources.go index e2fb27b2b..299a5bccf 100644 --- a/pkg/gofr/container/mock_datasources.go +++ b/pkg/gofr/container/mock_datasources.go @@ -14105,3 +14105,90 @@ func (mr *MockCouchbaseProviderMockRecorder) UseTracer(tracer any) *gomock.Call mr.mock.ctrl.T.Helper() return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseTracer", reflect.TypeOf((*MockCouchbaseProvider)(nil).UseTracer), tracer) } + +// MockDBResolverProvider is a mock of DBResolverProvider interface. +type MockDBResolverProvider struct { + ctrl *gomock.Controller + recorder *MockDBResolverProviderMockRecorder + isgomock struct{} +} + +// MockDBResolverProviderMockRecorder is the mock recorder for MockDBResolverProvider. +type MockDBResolverProviderMockRecorder struct { + mock *MockDBResolverProvider +} + +// NewMockDBResolverProvider creates a new mock instance. +func NewMockDBResolverProvider(ctrl *gomock.Controller) *MockDBResolverProvider { + mock := &MockDBResolverProvider{ctrl: ctrl} + mock.recorder = &MockDBResolverProviderMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockDBResolverProvider) EXPECT() *MockDBResolverProviderMockRecorder { + return m.recorder +} + +// Build mocks base method. +func (m *MockDBResolverProvider) Build(primary DB, replicas []DB) (DB, error) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Build", primary, replicas) + ret0, _ := ret[0].(DB) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Build indicates an expected call of Build. +func (mr *MockDBResolverProviderMockRecorder) Build(primary, replicas any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Build", reflect.TypeOf((*MockDBResolverProvider)(nil).Build), primary, replicas) +} + +// Connect mocks base method. +func (m *MockDBResolverProvider) Connect() { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Connect") +} + +// Connect indicates an expected call of Connect. +func (mr *MockDBResolverProviderMockRecorder) Connect() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Connect", reflect.TypeOf((*MockDBResolverProvider)(nil).Connect)) +} + +// UseLogger mocks base method. +func (m *MockDBResolverProvider) UseLogger(logger any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseLogger", logger) +} + +// UseLogger indicates an expected call of UseLogger. +func (mr *MockDBResolverProviderMockRecorder) UseLogger(logger any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseLogger", reflect.TypeOf((*MockDBResolverProvider)(nil).UseLogger), logger) +} + +// UseMetrics mocks base method. +func (m *MockDBResolverProvider) UseMetrics(metrics any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseMetrics", metrics) +} + +// UseMetrics indicates an expected call of UseMetrics. +func (mr *MockDBResolverProviderMockRecorder) UseMetrics(metrics any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseMetrics", reflect.TypeOf((*MockDBResolverProvider)(nil).UseMetrics), metrics) +} + +// UseTracer mocks base method. +func (m *MockDBResolverProvider) UseTracer(tracer any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseTracer", tracer) +} + +// UseTracer indicates an expected call of UseTracer. +func (mr *MockDBResolverProviderMockRecorder) UseTracer(tracer any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseTracer", reflect.TypeOf((*MockDBResolverProvider)(nil).UseTracer), tracer) +} diff --git a/pkg/gofr/datasource/dbresolver/circuit_breaker.go b/pkg/gofr/datasource/dbresolver/circuit_breaker.go new file mode 100644 index 000000000..4f7f32fe5 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/circuit_breaker.go @@ -0,0 +1,55 @@ +package dbresolver + +import ( + "sync/atomic" + "time" +) + +// Circuit breaker for replica health with atomic operations. +type circuitBreaker struct { + failures atomic.Int32 + lastFailure atomic.Int64 + state atomic.Int32 // 0=closed, 1=open, 2=half-open. + maxFailures int32 + timeout time.Duration +} + +func newCircuitBreaker(maxFailures int32, timeout time.Duration) *circuitBreaker { + return &circuitBreaker{ + maxFailures: maxFailures, + timeout: timeout, + } +} + +func (cb *circuitBreaker) allowRequest() bool { + state := cb.state.Load() + + switch state { + case circuitStateClosed: + return true + case circuitStateOpen: + if time.Since(time.Unix(0, cb.lastFailure.Load())) > cb.timeout { + return cb.state.CompareAndSwap(circuitStateOpen, circuitStateHalfOpen) + } + + return false + case circuitStateHalfOpen: + return true + default: + return true + } +} + +func (cb *circuitBreaker) recordSuccess() { + cb.failures.Store(0) + cb.state.Store(0) +} + +func (cb *circuitBreaker) recordFailure() { + failures := cb.failures.Add(1) + cb.lastFailure.Store(time.Now().UnixNano()) + + if failures >= cb.maxFailures { + cb.state.Store(1) + } +} diff --git a/pkg/gofr/datasource/dbresolver/dbresolver_wrapper.go b/pkg/gofr/datasource/dbresolver/dbresolver_wrapper.go new file mode 100644 index 000000000..420eb5cb8 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/dbresolver_wrapper.go @@ -0,0 +1,78 @@ +package dbresolver + +import ( + "errors" + + "go.opentelemetry.io/otel/trace" + "gofr.dev/pkg/gofr/container" +) + +var ( + errPrimaryNil = errors.New("primary database cannot be nil") + errReplicaFailedNoFallback = errors.New("replica query failed and fallback disabled") +) + +// ResolverWrapper implements container.DBResolverProvider interface +// It acts as a factory that creates a Resolver with given config. +type ResolverWrapper struct { + logger Logger + metrics Metrics + tracer trace.Tracer + strategy Strategy + readFallback bool +} + +// NewProvider creates a new ResolverWrapper with strategy and fallback config. +func NewProvider(strategy Strategy, readFallback bool) *ResolverWrapper { + return &ResolverWrapper{ + strategy: strategy, + readFallback: readFallback, + } +} + +// UseLogger sets the logger instance. +func (r *ResolverWrapper) UseLogger(logger any) { + if l, ok := logger.(Logger); ok { + r.logger = l + } +} + +// UseMetrics sets the metrics instance. +func (r *ResolverWrapper) UseMetrics(metrics any) { + if m, ok := metrics.(Metrics); ok { + r.metrics = m + } +} + +// UseTracer sets the tracer instance. +func (r *ResolverWrapper) UseTracer(tracer any) { + if t, ok := tracer.(trace.Tracer); ok { + r.tracer = t + } +} + +// Connect is no-op for wrapper as connections are created externally. +func (*ResolverWrapper) Connect() { + // no-op +} + +// Build creates a Resolver instance with primary and replica DBs. +func (r *ResolverWrapper) Build(primary container.DB, replicas []container.DB) (container.DB, error) { + if primary == nil { + return nil, errPrimaryNil + } + + // Update RoundRobinStrategy count if needed + if rr, ok := r.strategy.(*RoundRobinStrategy); ok { + rr.count = len(replicas) + } + + // Create options slice + var opts []Option + + // Add options. + opts = append(opts, WithStrategy(r.strategy), WithFallback(r.readFallback)) + + // Create and return the resolver. + return NewResolver(primary, replicas, r.logger, r.metrics, opts...), nil +} diff --git a/pkg/gofr/datasource/dbresolver/dbresolver_wrapper_test.go b/pkg/gofr/datasource/dbresolver/dbresolver_wrapper_test.go new file mode 100644 index 000000000..02b5b57c1 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/dbresolver_wrapper_test.go @@ -0,0 +1,162 @@ +package dbresolver + +import ( + "sync" + "testing" + "time" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "go.opentelemetry.io/otel" + "go.uber.org/mock/gomock" + "gofr.dev/pkg/gofr/container" +) + +// Mocks contains all the dependencies needed for testing. +type Mocks struct { + Ctrl *gomock.Controller + Primary *MockDB + Replicas []container.DB + MockReplicas []*MockDB + Strategy *MockStrategy + Logger Logger + Metrics Metrics + Resolver *Resolver +} + +// setupMocks creates and returns common mocks used in tests. +func setupMocks(t *testing.T, createResolver bool) *Mocks { + t.Helper() + + // Create controller and mocks. + ctrl := gomock.NewController(t) + mockPrimary := NewMockDB(ctrl) + mockReplica1 := NewMockDB(ctrl) + mockReplica2 := NewMockDB(ctrl) + + // Create both typed and interface versions of replicas. + typedMockReplicas := []*MockDB{mockReplica1, mockReplica2} + + mockReplicas := make([]container.DB, len(typedMockReplicas)) + for i, r := range typedMockReplicas { + mockReplicas[i] = r + } + + mockLogger := NewMockLogger(ctrl) + mockMetrics := NewMockMetrics(ctrl) + mockStrategy := NewMockStrategy(ctrl) + + mockMetrics.EXPECT().NewHistogram("dbresolver_query_duration", + "Response time of DB resolver operations in microseconds", + gomock.Any()).AnyTimes() + mockMetrics.EXPECT().NewGauge(gomock.Any(), gomock.Any()).AnyTimes() + mockMetrics.EXPECT().SetGauge(gomock.Any(), gomock.Any()).AnyTimes() + + mockMetrics.EXPECT().RecordHistogram(gomock.Any(), gomock.Any(), gomock.Any(), + gomock.Any(), gomock.Any(), gomock.Any(), gomock.Any()).AnyTimes() + + mockLogger.EXPECT().Logf(gomock.Any(), gomock.Any()).AnyTimes() + mockLogger.EXPECT().Debugf(gomock.Any(), gomock.Any()).AnyTimes() + mockLogger.EXPECT().Debug(gomock.Any()).AnyTimes() + + mocks := &Mocks{ + Ctrl: ctrl, + Primary: mockPrimary, + Replicas: mockReplicas, + MockReplicas: typedMockReplicas, + Strategy: mockStrategy, + Logger: mockLogger, + Metrics: mockMetrics, + } + + if createResolver { + replicaWrappers := make([]*replicaWrapper, len(mockReplicas)) + for i, r := range mockReplicas { + replicaWrappers[i] = &replicaWrapper{ + db: r, + breaker: newCircuitBreaker(5, 30*time.Second), + } + } + + mocks.Resolver = &Resolver{ + primary: mockPrimary, + replicas: replicaWrappers, + strategy: mockStrategy, + readFallback: true, + tracer: otel.GetTracerProvider().Tracer("gofr-dbresolver"), + logger: mockLogger, + metrics: mockMetrics, + stats: &statistics{}, + stopChan: make(chan struct{}), + once: sync.Once{}, + queryCache: newQueryCache(100), + } + } + + return mocks +} + +func TestResolverWrapper_Build_Error(t *testing.T) { + mocks := setupMocks(t, false) + defer mocks.Ctrl.Finish() + + t.Run("Error_NilPrimary", func(t *testing.T) { + wrapper := NewProvider(NewRoundRobinStrategy(2), true) + wrapper.UseLogger(mocks.Logger) + wrapper.UseMetrics(mocks.Metrics) + wrapper.UseTracer(otel.GetTracerProvider().Tracer("gofr-dbresolver")) + + resolver, err := wrapper.Build(nil, mocks.Replicas) + + require.Error(t, err) + assert.Equal(t, errPrimaryNil.Error(), err.Error()) + assert.Nil(t, resolver) + }) +} + +func TestResolverWrapper_Build_Success(t *testing.T) { + mocks := setupMocks(t, false) + defer mocks.Ctrl.Finish() + + successTests := []struct { + name string + strategy Strategy + readFallback bool + replicas []container.DB + }{ + { + name: "RoundRobinStrategy", + strategy: NewRoundRobinStrategy(0), + readFallback: true, + replicas: mocks.Replicas, + }, + { + name: "RandomStrategy", + strategy: NewRandomStrategy(), + readFallback: false, + replicas: mocks.Replicas, + }, + { + name: "EmptyReplicas", + strategy: NewRoundRobinStrategy(0), + readFallback: true, + replicas: []container.DB{}, + }, + } + + for _, tt := range successTests { + t.Run(tt.name, func(t *testing.T) { + wrapper := NewProvider(tt.strategy, tt.readFallback) + wrapper.UseLogger(mocks.Logger) + wrapper.UseMetrics(mocks.Metrics) + + resolver, err := wrapper.Build(mocks.Primary, tt.replicas) + + require.NoError(t, err) + assert.NotNil(t, resolver) + + _, ok := resolver.(*Resolver) + assert.True(t, ok, "Result should be a *Resolver") + }) + } +} diff --git a/pkg/gofr/datasource/dbresolver/go.mod b/pkg/gofr/datasource/dbresolver/go.mod new file mode 100644 index 000000000..c97e97ce0 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/go.mod @@ -0,0 +1,90 @@ +module gofr.dev/pkg/gofr/datasource/dbresolver + +go 1.24.0 + +require ( + github.com/stretchr/testify v1.10.0 + go.opentelemetry.io/otel v1.37.0 + go.opentelemetry.io/otel/trace v1.37.0 + go.uber.org/mock v0.5.2 + gofr.dev v1.42.4 +) + +require ( + cloud.google.com/go v0.121.1 // indirect + cloud.google.com/go/auth v0.16.3 // indirect + cloud.google.com/go/auth/oauth2adapt v0.2.8 // indirect + cloud.google.com/go/compute/metadata v0.7.0 // indirect + cloud.google.com/go/iam v1.5.2 // indirect + cloud.google.com/go/pubsub v1.49.0 // indirect + filippo.io/edwards25519 v1.1.0 // indirect + github.com/DATA-DOG/go-sqlmock v1.5.2 // indirect + github.com/XSAM/otelsql v0.39.0 // indirect + github.com/beorn7/perks v1.0.1 // indirect + github.com/cespare/xxhash/v2 v2.3.0 // indirect + github.com/davecgh/go-spew v1.1.1 // indirect + github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect + github.com/dustin/go-humanize v1.0.1 // indirect + github.com/eclipse/paho.mqtt.golang v1.5.0 // indirect + github.com/felixge/httpsnoop v1.0.4 // indirect + github.com/go-logr/logr v1.4.3 // indirect + github.com/go-logr/stdr v1.2.2 // indirect + github.com/go-sql-driver/mysql v1.9.3 // indirect + github.com/golang-jwt/jwt/v5 v5.2.3 // indirect + github.com/google/s2a-go v0.1.9 // indirect + github.com/google/uuid v1.6.0 // indirect + github.com/googleapis/enterprise-certificate-proxy v0.3.6 // indirect + github.com/googleapis/gax-go/v2 v2.15.0 // indirect + github.com/gorilla/mux v1.8.1 // indirect + github.com/gorilla/websocket v1.5.3 // indirect + github.com/joho/godotenv v1.5.1 // indirect + github.com/klauspost/compress v1.18.0 // indirect + github.com/lib/pq v1.10.9 // indirect + github.com/mattn/go-isatty v0.0.20 // indirect + github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect + github.com/ncruces/go-strftime v0.1.9 // indirect + github.com/pierrec/lz4/v4 v4.1.22 // indirect + github.com/pkg/errors v0.9.1 // indirect + github.com/pmezard/go-difflib v1.0.0 // indirect + github.com/prometheus/client_golang v1.23.0 // indirect + github.com/prometheus/client_model v0.6.2 // indirect + github.com/prometheus/common v0.65.0 // indirect + github.com/prometheus/procfs v0.16.1 // indirect + github.com/redis/go-redis/extra/rediscmd/v9 v9.11.0 // indirect + github.com/redis/go-redis/extra/redisotel/v9 v9.11.0 // indirect + github.com/redis/go-redis/v9 v9.11.0 // indirect + github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect + github.com/segmentio/kafka-go v0.4.48 // indirect + github.com/xdg-go/pbkdf2 v1.0.0 // indirect + github.com/xdg-go/scram v1.1.2 // indirect + github.com/xdg-go/stringprep v1.0.4 // indirect + go.opencensus.io v0.24.0 // indirect + go.opentelemetry.io/auto/sdk v1.1.0 // indirect + go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.61.0 // indirect + go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.62.0 // indirect + go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0 // indirect + go.opentelemetry.io/otel/exporters/prometheus v0.59.0 // indirect + go.opentelemetry.io/otel/metric v1.37.0 // indirect + go.opentelemetry.io/otel/sdk v1.37.0 // indirect + go.opentelemetry.io/otel/sdk/metric v1.37.0 // indirect + golang.org/x/crypto v0.40.0 // indirect + golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b // indirect + golang.org/x/net v0.42.0 // indirect + golang.org/x/oauth2 v0.30.0 // indirect + golang.org/x/sync v0.16.0 // indirect + golang.org/x/sys v0.34.0 // indirect + golang.org/x/term v0.33.0 // indirect + golang.org/x/text v0.27.0 // indirect + golang.org/x/time v0.12.0 // indirect + google.golang.org/api v0.243.0 // indirect + google.golang.org/genproto v0.0.0-20250603155806-513f23925822 // indirect + google.golang.org/genproto/googleapis/api v0.0.0-20250603155806-513f23925822 // indirect + google.golang.org/genproto/googleapis/rpc v0.0.0-20250715232539-7130f93afb79 // indirect + google.golang.org/grpc v1.74.2 // indirect + google.golang.org/protobuf v1.36.6 // indirect + gopkg.in/yaml.v3 v3.0.1 // indirect + modernc.org/libc v1.66.3 // indirect + modernc.org/mathutil v1.7.1 // indirect + modernc.org/memory v1.11.0 // indirect + modernc.org/sqlite v1.38.1 // indirect +) diff --git a/pkg/gofr/datasource/dbresolver/go.sum b/pkg/gofr/datasource/dbresolver/go.sum new file mode 100644 index 000000000..e7ded8628 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/go.sum @@ -0,0 +1,346 @@ +cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= +cloud.google.com/go v0.121.1 h1:S3kTQSydxmu1JfLRLpKtxRPA7rSrYPRPEUmL/PavVUw= +cloud.google.com/go v0.121.1/go.mod h1:nRFlrHq39MNVWu+zESP2PosMWA0ryJw8KUBZ2iZpxbw= +cloud.google.com/go/auth v0.16.3 h1:kabzoQ9/bobUmnseYnBO6qQG7q4a/CffFRlJSxv2wCc= +cloud.google.com/go/auth v0.16.3/go.mod h1:NucRGjaXfzP1ltpcQ7On/VTZ0H4kWB5Jy+Y9Dnm76fA= +cloud.google.com/go/auth/oauth2adapt v0.2.8 h1:keo8NaayQZ6wimpNSmW5OPc283g65QNIiLpZnkHRbnc= +cloud.google.com/go/auth/oauth2adapt v0.2.8/go.mod h1:XQ9y31RkqZCcwJWNSx2Xvric3RrU88hAYYbjDWYDL+c= +cloud.google.com/go/compute/metadata v0.7.0 h1:PBWF+iiAerVNe8UCHxdOt6eHLVc3ydFeOCw78U8ytSU= +cloud.google.com/go/compute/metadata v0.7.0/go.mod h1:j5MvL9PprKL39t166CoB1uVHfQMs4tFQZZcKwksXUjo= +cloud.google.com/go/iam v1.5.2 h1:qgFRAGEmd8z6dJ/qyEchAuL9jpswyODjA2lS+w234g8= +cloud.google.com/go/iam v1.5.2/go.mod h1:SE1vg0N81zQqLzQEwxL2WI6yhetBdbNQuTvIKCSkUHE= +cloud.google.com/go/kms v1.22.0 h1:dBRIj7+GDeeEvatJeTB19oYZNV0aj6wEqSIT/7gLqtk= +cloud.google.com/go/kms v1.22.0/go.mod h1:U7mf8Sva5jpOb4bxYZdtw/9zsbIjrklYwPcvMk34AL8= +cloud.google.com/go/longrunning v0.6.7 h1:IGtfDWHhQCgCjwQjV9iiLnUta9LBCo8R9QmAFsS/PrE= +cloud.google.com/go/longrunning v0.6.7/go.mod h1:EAFV3IZAKmM56TyiE6VAP3VoTzhZzySwI/YI1s/nRsY= +cloud.google.com/go/pubsub v1.49.0 h1:5054IkbslnrMCgA2MAEPcsN3Ky+AyMpEZcii/DoySPo= +cloud.google.com/go/pubsub v1.49.0/go.mod h1:K1FswTWP+C1tI/nfi3HQecoVeFvL4HUOB1tdaNXKhUY= +filippo.io/edwards25519 v1.1.0 h1:FNf4tywRC1HmFuKW5xopWpigGjJKiJSV0Cqo0cJWDaA= +filippo.io/edwards25519 v1.1.0/go.mod h1:BxyFTGdWcka3PhytdK4V28tE5sGfRvvvRV7EaN4VDT4= +github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= +github.com/DATA-DOG/go-sqlmock v1.5.2 h1:OcvFkGmslmlZibjAjaHm3L//6LiuBgolP7OputlJIzU= +github.com/DATA-DOG/go-sqlmock v1.5.2/go.mod h1:88MAG/4G7SMwSE3CeA0ZKzrT5CiOU3OJ+JlNzwDqpNU= +github.com/XSAM/otelsql v0.39.0 h1:4o374mEIMweaeevL7fd8Q3C710Xi2Jh/c8G4Qy9bvCY= +github.com/XSAM/otelsql v0.39.0/go.mod h1:uMOXLUX+wkuAuP0AR3B45NXX7E9lJS2mERa8gqdU8R0= +github.com/alicebob/miniredis/v2 v2.35.0 h1:QwLphYqCEAo1eu1TqPRN2jgVMPBweeQcR21jeqDCONI= +github.com/alicebob/miniredis/v2 v2.35.0/go.mod h1:TcL7YfarKPGDAthEtl5NBeHZfeUQj6OXMm/+iu5cLMM= +github.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM= +github.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw= +github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs= +github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c= +github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA= +github.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0= +github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU= +github.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs= +github.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs= +github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw= +github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78= +github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc= +github.com/dustin/go-humanize v1.0.1 h1:GzkhY7T5VNhEkwH0PVJgjz+fX1rhBrR7pRT3mDkpeCY= +github.com/dustin/go-humanize v1.0.1/go.mod h1:Mu1zIs6XwVuF/gI1OepvI0qD18qycQx+mFykh5fBlto= +github.com/eclipse/paho.mqtt.golang v1.5.0 h1:EH+bUVJNgttidWFkLLVKaQPGmkTUfQQqjOsyvMGvD6o= +github.com/eclipse/paho.mqtt.golang v1.5.0/go.mod h1:du/2qNQVqJf/Sqs4MEL77kR8QTqANF7XU7Fk0aOTAgk= +github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= +github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= +github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98= +github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c= +github.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg= +github.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U= +github.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A= +github.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI= +github.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY= +github.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag= +github.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE= +github.com/go-sql-driver/mysql v1.9.3 h1:U/N249h2WzJ3Ukj8SowVFjdtZKfu9vlLZxjPXV1aweo= +github.com/go-sql-driver/mysql v1.9.3/go.mod h1:qn46aNg1333BRMNU69Lq93t8du/dwxI64Gl8i5p1WMU= +github.com/golang-jwt/jwt/v5 v5.2.3 h1:kkGXqQOBSDDWRhWNXTFpqGSCMyh/PLnqUvMGJPDJDs0= +github.com/golang-jwt/jwt/v5 v5.2.3/go.mod h1:pqrtFR0X4osieyHYxtmOUWsAWrfe1Q5UVIyoH402zdk= +github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q= +github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= +github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 h1:f+oWsMOmNPc8JmEHVZIycC7hBoQxHH9pNKQORJNozsQ= +github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8/go.mod h1:wcDNUvekVysuuOpQKo3191zZyTpiI6se1N1ULghS0sw= +github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= +github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= +github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= +github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= +github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= +github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= +github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8= +github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= +github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek= +github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps= +github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= +github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.3/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8= +github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU= +github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs= +github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e/go.mod h1:boTsfXsheKC2y+lKOCMpSfarhxDeIzfZG1jqGcPl3cA= +github.com/google/s2a-go v0.1.9 h1:LGD7gtMgezd8a/Xak7mEWL0PjoTQFvpRudN895yqKW0= +github.com/google/s2a-go v0.1.9/go.mod h1:YA0Ei2ZQL3acow2O62kdp9UlnvMmU7kA6Eutn0dXayM= +github.com/google/uuid v1.1.2/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/googleapis/enterprise-certificate-proxy v0.3.6 h1:GW/XbdyBFQ8Qe+YAmFU9uHLo7OnF5tL52HFAgMmyrf4= +github.com/googleapis/enterprise-certificate-proxy v0.3.6/go.mod h1:MkHOF77EYAE7qfSuSS9PU6g4Nt4e11cnsDUowfwewLA= +github.com/googleapis/gax-go/v2 v2.15.0 h1:SyjDc1mGgZU5LncH8gimWo9lW1DtIfPibOG81vgd/bo= +github.com/googleapis/gax-go/v2 v2.15.0/go.mod h1:zVVkkxAQHa1RQpg9z2AUCMnKhi0Qld9rcmyfL1OZhoc= +github.com/gorilla/mux v1.8.1 h1:TuBL49tXwgrFYWhqrNgrUNEY92u81SPhu7sTdzQEiWY= +github.com/gorilla/mux v1.8.1/go.mod h1:AKf9I4AEqPTmMytcMc0KkNouC66V3BtZ4qD5fmWSiMQ= +github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg= +github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0= +github.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4= +github.com/kisielk/sqlstruct v0.0.0-20201105191214-5f3e10d3ab46/go.mod h1:yyMNCyc/Ib3bDTKd379tNMpB/7/H5TjM2Y9QJ5THLbE= +github.com/klauspost/compress v1.15.9/go.mod h1:PhcZ0MbTNciWF3rruxRgKxI5NkcHHrHUDtV4Yw2GlzU= +github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo= +github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ= +github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE= +github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk= +github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= +github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc= +github.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw= +github.com/lib/pq v1.10.9 h1:YXG7RB+JIjhP29X+OtkiDnYaXQwpS4JEWq7dtCCRUEw= +github.com/lib/pq v1.10.9/go.mod h1:AlVN5x4E4T544tWzH6hKfbfQvm3HdbOxrmggDNAPY9o= +github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY= +github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y= +github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA= +github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ= +github.com/ncruces/go-strftime v0.1.9 h1:bY0MQC28UADQmHmaF5dgpLmImcShSi2kHU9XLdhx/f4= +github.com/ncruces/go-strftime v0.1.9/go.mod h1:Fwc5htZGVVkseilnfgOVb9mKy6w1naJmn9CehxcKcls= +github.com/pierrec/lz4/v4 v4.1.15/go.mod h1:gZWDp/Ze/IJXGXf23ltt2EXimqmTUXEy0GFuRQyBid4= +github.com/pierrec/lz4/v4 v4.1.22 h1:cKFw6uJDK+/gfw5BcDL0JL5aBsAFdsIT18eRtLj7VIU= +github.com/pierrec/lz4/v4 v4.1.22/go.mod h1:gZWDp/Ze/IJXGXf23ltt2EXimqmTUXEy0GFuRQyBid4= +github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= +github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/prometheus/client_golang v1.23.0 h1:ust4zpdl9r4trLY/gSjlm07PuiBq2ynaXXlptpfy8Uc= +github.com/prometheus/client_golang v1.23.0/go.mod h1:i/o0R9ByOnHX0McrTMTyhYvKE4haaf2mW08I+jGAjEE= +github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= +github.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk= +github.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE= +github.com/prometheus/common v0.65.0 h1:QDwzd+G1twt//Kwj/Ww6E9FQq1iVMmODnILtW1t2VzE= +github.com/prometheus/common v0.65.0/go.mod h1:0gZns+BLRQ3V6NdaerOhMbwwRbNh9hkGINtQAsP5GS8= +github.com/prometheus/procfs v0.16.1 h1:hZ15bTNuirocR6u0JZ6BAHHmwS1p8B4P6MRqxtzMyRg= +github.com/prometheus/procfs v0.16.1/go.mod h1:teAbpZRB1iIAJYREa1LsoWUXykVXA1KlTmWl8x/U+Is= +github.com/redis/go-redis/extra/rediscmd/v9 v9.11.0 h1:vP5CH2rJ3L4yk3o8FdXqiPL1lGl5APjHcxk5/OT6H0Q= +github.com/redis/go-redis/extra/rediscmd/v9 v9.11.0/go.mod h1:/2yj0RD4xjZQ7wOg9u7gVoBM0IgMGrHunAql1hr1NDg= +github.com/redis/go-redis/extra/redisotel/v9 v9.11.0 h1:dMNmusapfQefntfUqAYAvaVJMrJCdKUaQoPSZtd99WU= +github.com/redis/go-redis/extra/redisotel/v9 v9.11.0/go.mod h1:Yy5oaeVwWj7KMu6Mga/i4imlXFvgitQWN5HFiT5JqoE= +github.com/redis/go-redis/v9 v9.11.0 h1:E3S08Gl/nJNn5vkxd2i78wZxWAPNZgUNTp8WIJUAiIs= +github.com/redis/go-redis/v9 v9.11.0/go.mod h1:huWgSWd8mW6+m0VPhJjSSQ+d6Nh1VICQ6Q5lHuCH/Iw= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= +github.com/rogpeppe/go-internal v1.13.1 h1:KvO1DLK/DRN07sQ1LQKScxyZJuNnedQ5/wKSR38lUII= +github.com/rogpeppe/go-internal v1.13.1/go.mod h1:uMEvuHeurkdAXX61udpOXGD/AzZDWNMNyH2VO9fmH0o= +github.com/segmentio/kafka-go v0.4.48 h1:9jyu9CWK4W5W+SroCe8EffbrRZVqAOkuaLd/ApID4Vs= +github.com/segmentio/kafka-go v0.4.48/go.mod h1:HjF6XbOKh0Pjlkr5GVZxt6CsjjwnmhVOfURM5KMd8qg= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw= +github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo= +github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY= +github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA= +github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU= +github.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4= +github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA= +github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY= +github.com/xdg-go/pbkdf2 v1.0.0 h1:Su7DPu48wXMwC3bs7MCNG+z4FhcyEuz5dlvchbq0B0c= +github.com/xdg-go/pbkdf2 v1.0.0/go.mod h1:jrpuAogTd400dnrH08LKmI/xc1MbPOebTwRqcT5RDeI= +github.com/xdg-go/scram v1.1.2 h1:FHX5I5B4i4hKRVRBCFRxq1iQRej7WO3hhBuJf+UUySY= +github.com/xdg-go/scram v1.1.2/go.mod h1:RT/sEzTbU5y00aCK8UOx6R7YryM0iF1N2MOmC3kKLN4= +github.com/xdg-go/stringprep v1.0.4 h1:XLI/Ng3O1Atzq0oBs3TWm+5ZVgkq2aqdlvP9JtoZ6c8= +github.com/xdg-go/stringprep v1.0.4/go.mod h1:mPGuuIYwz7CmR2bT9j4GbQqutWS1zV24gijq1dTyGkM= +github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= +github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M= +github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw= +go.einride.tech/aip v0.68.1 h1:16/AfSxcQISGN5z9C5lM+0mLYXihrHbQ1onvYTr93aQ= +go.einride.tech/aip v0.68.1/go.mod h1:XaFtaj4HuA3Zwk9xoBtTWgNubZ0ZZXv9BZJCkuKuWbg= +go.opencensus.io v0.24.0 h1:y73uSU6J157QMP2kn2r30vwW1A2W2WFwSCGnAVxeaD0= +go.opencensus.io v0.24.0/go.mod h1:vNK8G9p7aAivkbmorf4v+7Hgx+Zs0yY+0fOtgBfjQKo= +go.opentelemetry.io/auto/sdk v1.1.0 h1:cH53jehLUN6UFLY71z+NDOiNJqDdPRaXzTel0sJySYA= +go.opentelemetry.io/auto/sdk v1.1.0/go.mod h1:3wSPjt5PWp2RhlCcmmOial7AvC4DQqZb7a7wCow3W8A= +go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.61.0 h1:q4XOmH/0opmeuJtPsbFNivyl7bCt7yRBbeEm2sC/XtQ= +go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.61.0/go.mod h1:snMWehoOh2wsEwnvvwtDyFCxVeDAODenXHtn5vzrKjo= +go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.62.0 h1:wCeciVlAfb5DC8MQl/DlmAv/FVPNpQgFvI/71+hatuc= +go.opentelemetry.io/contrib/instrumentation/net/http/httptrace/otelhttptrace v0.62.0/go.mod h1:WfEApdZDMlLUAev/0QQpr8EJ/z0VWDKYZ5tF5RH5T1U= +go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0 h1:Hf9xI/XLML9ElpiHVDNwvqI0hIFlzV8dgIr35kV1kRU= +go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0/go.mod h1:NfchwuyNoMcZ5MLHwPrODwUF1HWCXWrL31s8gSAdIKY= +go.opentelemetry.io/otel v1.37.0 h1:9zhNfelUvx0KBfu/gb+ZgeAfAgtWrfHJZcAqFC228wQ= +go.opentelemetry.io/otel v1.37.0/go.mod h1:ehE/umFRLnuLa/vSccNq9oS1ErUlkkK71gMcN34UG8I= +go.opentelemetry.io/otel/exporters/prometheus v0.59.0 h1:HHf+wKS6o5++XZhS98wvILrLVgHxjA/AMjqHKes+uzo= +go.opentelemetry.io/otel/exporters/prometheus v0.59.0/go.mod h1:R8GpRXTZrqvXHDEGVH5bF6+JqAZcK8PjJcZ5nGhEWiE= +go.opentelemetry.io/otel/metric v1.37.0 h1:mvwbQS5m0tbmqML4NqK+e3aDiO02vsf/WgbsdpcPoZE= +go.opentelemetry.io/otel/metric v1.37.0/go.mod h1:04wGrZurHYKOc+RKeye86GwKiTb9FKm1WHtO+4EVr2E= +go.opentelemetry.io/otel/sdk v1.37.0 h1:ItB0QUqnjesGRvNcmAcU0LyvkVyGJ2xftD29bWdDvKI= +go.opentelemetry.io/otel/sdk v1.37.0/go.mod h1:VredYzxUvuo2q3WRcDnKDjbdvmO0sCzOvVAiY+yUkAg= +go.opentelemetry.io/otel/sdk/metric v1.37.0 h1:90lI228XrB9jCMuSdA0673aubgRobVZFhbjxHHspCPc= +go.opentelemetry.io/otel/sdk/metric v1.37.0/go.mod h1:cNen4ZWfiD37l5NhS+Keb5RXVWZWpRE+9WyVCpbo5ps= +go.opentelemetry.io/otel/trace v1.37.0 h1:HLdcFNbRQBE2imdSEgm/kwqmQj1Or1l/7bW6mxVK7z4= +go.opentelemetry.io/otel/trace v1.37.0/go.mod h1:TlgrlQ+PtQO5XFerSPUYG0JSgGyryXewPGyayAWSBS0= +go.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto= +go.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE= +go.uber.org/mock v0.5.2 h1:LbtPTcP8A5k9WPXj54PPPbjcI4Y6lhyOZXn+VS7wNko= +go.uber.org/mock v0.5.2/go.mod h1:wLlUxC2vVTPTaE3UD51E0BGOAElKrILxhVSDYQLld5o= +gofr.dev v1.42.4 h1:Nd58Rw1/9ydzZ8dn9d6s5lh3DkzsVKXQ0gYKpLUEDfM= +gofr.dev v1.42.4/go.mod h1:y/tFyLFsRYdxYijVyLPqO9LjLqLd66Ee/pYgK/rxc28= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc= +golang.org/x/crypto v0.14.0/go.mod h1:MVFd36DqK4CsrnJYDkBA3VC4m2GkXAM0PvzMCn4JQf4= +golang.org/x/crypto v0.40.0 h1:r4x+VvoG5Fm+eJcxMaY8CQM7Lb0l1lsmjGBQ6s8BfKM= +golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY= +golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= +golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b h1:M2rDM6z3Fhozi9O7NWsxAkg/yqS/lQJ6PmkyIV3YP+o= +golang.org/x/exp v0.0.0-20250620022241-b7579e27df2b/go.mod h1:3//PLf8L/X+8b4vuAfHzxeRUl04Adcb341+IGKfnqS8= +golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= +golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= +golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4= +golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs= +golang.org/x/mod v0.25.0 h1:n7a+ZbQKQA/Ysbyb0/6IbB1H/X41mKgbhfv7AfG/44w= +golang.org/x/mod v0.25.0/go.mod h1:IXM97Txy2VM4PJ3gI61r1YEk/gAj6zAHN3AdZt6S9Ww= +golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20201110031124-69a78807bb2b/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= +golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg= +golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c= +golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs= +golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg= +golang.org/x/net v0.17.0/go.mod h1:NxSsAGuq816PNPmqtQdLE42eU2Fs7NoRIZrHJAlaCOE= +golang.org/x/net v0.42.0 h1:jzkYrhi3YQWD6MLBJcsklgQsoAcw89EcZbJw8Z614hs= +golang.org/x/net v0.42.0/go.mod h1:FF1RA5d3u7nAYA4z2TkclSCKh68eSXtiFwcWQpPXdt8= +golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= +golang.org/x/oauth2 v0.30.0 h1:dnDm7JmhM45NNpd8FDDeLhK6FwqbOf4MLCM9zb1BOHI= +golang.org/x/oauth2 v0.30.0/go.mod h1:B++QgG3ZKulg6sRPGD/mqlHQs5rB3Ml9erfeDY7xKlU= +golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.16.0 h1:ycBJEhp9p4vXvUZNszeOq0kGTPghopOL8q0fq3vstxw= +golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA= +golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.13.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/sys v0.34.0 h1:H5Y5sJ2L2JRdyv7ROF1he/lPdvFsd0mJHFw2ThKHxLA= +golang.org/x/sys v0.34.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k= +golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= +golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8= +golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k= +golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo= +golang.org/x/term v0.13.0/go.mod h1:LTmsnFJwVN6bCy1rVCoS+qHT1HhALEFxKncY3WNNh4U= +golang.org/x/term v0.33.0 h1:NuFncQrRcaRvVmgRkvM3j/F00gWIAlcmlB8ACEKmGIg= +golang.org/x/term v0.33.0/go.mod h1:s18+ql9tYWp1IfpV9DmCtQDDSRBUjKaw9M1eAv5UeF0= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ= +golang.org/x/text v0.3.8/go.mod h1:E6s5w1FMmriuDzIBO73fBruAKo1PCIq6d2Q6DHfQ8WQ= +golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8= +golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8= +golang.org/x/text v0.13.0/go.mod h1:TvPlkZtksWOMsz7fbANvkp4WM8x/WCo/om8BMLbz+aE= +golang.org/x/text v0.27.0 h1:4fGWRpyh641NLlecmyl4LOe6yDdfaYNrGb2zdfo4JV4= +golang.org/x/text v0.27.0/go.mod h1:1D28KMCvyooCX9hBiosv5Tz/+YLxj0j7XhWjpSUF7CU= +golang.org/x/time v0.12.0 h1:ScB/8o8olJvc+CQPWrK3fPZNfh7qgwCrY0zJmoEQLSE= +golang.org/x/time v0.12.0/go.mod h1:CDIdPxbZBQxdj6cxyCIdrNogrJKMJ7pr37NYpMcMDSg= +golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY= +golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= +golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc= +golang.org/x/tools v0.6.0/go.mod h1:Xwgl3UAJ/d3gWutnCtw505GrjyAbvKui8lOU390QaIU= +golang.org/x/tools v0.34.0 h1:qIpSLOxeCYGg9TrcJokLBG4KFA6d795g0xkBkiESGlo= +golang.org/x/tools v0.34.0/go.mod h1:pAP9OwEaY1CAW3HOmg3hLZC5Z0CCmzjAF2UQMSqNARg= +golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +google.golang.org/api v0.243.0 h1:sw+ESIJ4BVnlJcWu9S+p2Z6Qq1PjG77T8IJ1xtp4jZQ= +google.golang.org/api v0.243.0/go.mod h1:GE4QtYfaybx1KmeHMdBnNnyLzBZCVihGBXAmJu/uUr8= +google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= +google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= +google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= +google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= +google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo= +google.golang.org/genproto v0.0.0-20250603155806-513f23925822 h1:rHWScKit0gvAPuOnu87KpaYtjK5zBMLcULh7gxkCXu4= +google.golang.org/genproto v0.0.0-20250603155806-513f23925822/go.mod h1:HubltRL7rMh0LfnQPkMH4NPDFEWp0jw3vixw7jEM53s= +google.golang.org/genproto/googleapis/api v0.0.0-20250603155806-513f23925822 h1:oWVWY3NzT7KJppx2UKhKmzPq4SRe0LdCijVRwvGeikY= +google.golang.org/genproto/googleapis/api v0.0.0-20250603155806-513f23925822/go.mod h1:h3c4v36UTKzUiuaOKQ6gr3S+0hovBtUrXzTG/i3+XEc= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250715232539-7130f93afb79 h1:1ZwqphdOdWYXsUHgMpU/101nCtf/kSp9hOrcvFsnl10= +google.golang.org/genproto/googleapis/rpc v0.0.0-20250715232539-7130f93afb79/go.mod h1:qQ0YXyHHx3XkvlzUtpXDkS29lDSafHMZBAZDc03LQ3A= +google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= +google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= +google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= +google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= +google.golang.org/grpc v1.33.2/go.mod h1:JMHMWHQWaTccqQQlmk3MJZS+GWXOdAesneDmEnv2fbc= +google.golang.org/grpc v1.74.2 h1:WoosgB65DlWVC9FqI82dGsZhWFNBSLjQ84bjROOpMu4= +google.golang.org/grpc v1.74.2/go.mod h1:CtQ+BGjaAIXHs/5YS3i473GqwBBa1zGQNevxdeBEXrM= +google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= +google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= +google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= +google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= +google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= +google.golang.org/protobuf v1.22.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c= +google.golang.org/protobuf v1.36.6 h1:z1NpPI8ku2WgiWnf+t9wTPsn6eP1L7ksHUlkfLvd9xY= +google.golang.org/protobuf v1.36.6/go.mod h1:jduwjTPXsFjZGTmRluh+L6NjiWu7pchiJ2/5YcXBHnY= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA= +gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +modernc.org/cc/v4 v4.26.2 h1:991HMkLjJzYBIfha6ECZdjrIYz2/1ayr+FL8GN+CNzM= +modernc.org/cc/v4 v4.26.2/go.mod h1:uVtb5OGqUKpoLWhqwNQo/8LwvoiEBLvZXIQ/SmO6mL0= +modernc.org/ccgo/v4 v4.28.0 h1:rjznn6WWehKq7dG4JtLRKxb52Ecv8OUGah8+Z/SfpNU= +modernc.org/ccgo/v4 v4.28.0/go.mod h1:JygV3+9AV6SmPhDasu4JgquwU81XAKLd3OKTUDNOiKE= +modernc.org/fileutil v1.3.8 h1:qtzNm7ED75pd1C7WgAGcK4edm4fvhtBsEiI/0NQ54YM= +modernc.org/fileutil v1.3.8/go.mod h1:HxmghZSZVAz/LXcMNwZPA/DRrQZEVP9VX0V4LQGQFOc= +modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI= +modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito= +modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks= +modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI= +modernc.org/libc v1.66.3 h1:cfCbjTUcdsKyyZZfEUKfoHcP3S0Wkvz3jgSzByEWVCQ= +modernc.org/libc v1.66.3/go.mod h1:XD9zO8kt59cANKvHPXpx7yS2ELPheAey0vjIuZOhOU8= +modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU= +modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg= +modernc.org/memory v1.11.0 h1:o4QC8aMQzmcwCK3t3Ux/ZHmwFPzE6hf2Y5LbkRs+hbI= +modernc.org/memory v1.11.0/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw= +modernc.org/opt v0.1.4 h1:2kNGMRiUjrp4LcaPuLY2PzUfqM/w9N23quVwhKt5Qm8= +modernc.org/opt v0.1.4/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns= +modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w= +modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE= +modernc.org/sqlite v1.38.1 h1:jNnIjleVta+DKSAr3TnkKK87EEhjPhBLzi6hvIX9Bas= +modernc.org/sqlite v1.38.1/go.mod h1:cPTJYSlgg3Sfg046yBShXENNtPrWrDX8bsbAQBzgQ5E= +modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0= +modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A= +modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y= +modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM= diff --git a/pkg/gofr/datasource/dbresolver/logger.go b/pkg/gofr/datasource/dbresolver/logger.go new file mode 100644 index 000000000..7b85da516 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/logger.go @@ -0,0 +1,43 @@ +package dbresolver + +import ( + "fmt" + "regexp" + "strings" +) + +var whitespaceRegex = regexp.MustCompile(`\s+`) + +// Logger defines the logging interface for dbresolver. +type Logger interface { + Debug(args ...any) + Debugf(pattern string, args ...any) + Logf(pattern string, args ...any) + Errorf(pattern string, args ...any) + Warnf(pattern string, args ...any) +} + +// QueryLog contains information about a SQL query. +type QueryLog struct { + Type string `json:"type"` + Query string `json:"query"` + Duration int64 `json:"duration"` + Target string `json:"target"` + IsRead bool `json:"is_read"` +} + +// PrettyPrint formats the QueryLog for output. +func (ql *QueryLog) PrettyPrint(logger Logger) { + formattedLog := fmt.Sprintf("\u001B[38;5;8m%-32s \u001B[38;5;206m%-6s\u001B[0m %8d\u001B[38;5;8mµs\u001B[0m %s %s\n", + clean(ql.Type), "DBRESOLVER", ql.Duration, + clean(fmt.Sprintf("%s %s", ql.Target, ql.Query)), clean(ql.Query)) + + logger.Debug(formattedLog) +} + +func clean(query string) string { + // Replace multiple consecutive whitespace characters with a single space + query = whitespaceRegex.ReplaceAllString(query, " ") + // Trim leading and trailing whitespace from the string + return strings.TrimSpace(query) +} diff --git a/pkg/gofr/datasource/dbresolver/metrics.go b/pkg/gofr/datasource/dbresolver/metrics.go new file mode 100644 index 000000000..63684b7a1 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/metrics.go @@ -0,0 +1,13 @@ +package dbresolver + +import ( + "context" +) + +// Metrics interface for metrics operations. +type Metrics interface { + NewHistogram(name, description string, buckets ...float64) + NewGauge(name, description string) + RecordHistogram(ctx context.Context, name string, value float64, labels ...string) + SetGauge(name string, value float64, labels ...string) +} diff --git a/pkg/gofr/datasource/dbresolver/mock_db.go b/pkg/gofr/datasource/dbresolver/mock_db.go new file mode 100644 index 000000000..3d3f9f9a3 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/mock_db.go @@ -0,0 +1,251 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: gofr.dev/pkg/gofr/container (interfaces: DB) +// +// Generated by this command: +// +// mockgen -package=dbresolver -destination=mock_db.go gofr.dev/pkg/gofr/container DB +// + +// Package dbresolver is a generated GoMock package. +package dbresolver + +import ( + context "context" + sql "database/sql" + reflect "reflect" + + gomock "go.uber.org/mock/gomock" + datasource "gofr.dev/pkg/gofr/datasource" + sql0 "gofr.dev/pkg/gofr/datasource/sql" +) + +// MockDB is a mock of DB interface. +type MockDB struct { + ctrl *gomock.Controller + recorder *MockDBMockRecorder + isgomock struct{} +} + +// MockDBMockRecorder is the mock recorder for MockDB. +type MockDBMockRecorder struct { + mock *MockDB +} + +// NewMockDB creates a new mock instance. +func NewMockDB(ctrl *gomock.Controller) *MockDB { + mock := &MockDB{ctrl: ctrl} + mock.recorder = &MockDBMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockDB) EXPECT() *MockDBMockRecorder { + return m.recorder +} + +// Begin mocks base method. +func (m *MockDB) Begin() (*sql0.Tx, error) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Begin") + ret0, _ := ret[0].(*sql0.Tx) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Begin indicates an expected call of Begin. +func (mr *MockDBMockRecorder) Begin() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Begin", reflect.TypeOf((*MockDB)(nil).Begin)) +} + +// Close mocks base method. +func (m *MockDB) Close() error { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Close") + ret0, _ := ret[0].(error) + return ret0 +} + +// Close indicates an expected call of Close. +func (mr *MockDBMockRecorder) Close() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Close", reflect.TypeOf((*MockDB)(nil).Close)) +} + +// Dialect mocks base method. +func (m *MockDB) Dialect() string { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Dialect") + ret0, _ := ret[0].(string) + return ret0 +} + +// Dialect indicates an expected call of Dialect. +func (mr *MockDBMockRecorder) Dialect() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Dialect", reflect.TypeOf((*MockDB)(nil).Dialect)) +} + +// Exec mocks base method. +func (m *MockDB) Exec(query string, args ...any) (sql.Result, error) { + m.ctrl.T.Helper() + varargs := []any{query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "Exec", varargs...) + ret0, _ := ret[0].(sql.Result) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Exec indicates an expected call of Exec. +func (mr *MockDBMockRecorder) Exec(query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Exec", reflect.TypeOf((*MockDB)(nil).Exec), varargs...) +} + +// ExecContext mocks base method. +func (m *MockDB) ExecContext(ctx context.Context, query string, args ...any) (sql.Result, error) { + m.ctrl.T.Helper() + varargs := []any{ctx, query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "ExecContext", varargs...) + ret0, _ := ret[0].(sql.Result) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// ExecContext indicates an expected call of ExecContext. +func (mr *MockDBMockRecorder) ExecContext(ctx, query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{ctx, query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "ExecContext", reflect.TypeOf((*MockDB)(nil).ExecContext), varargs...) +} + +// HealthCheck mocks base method. +func (m *MockDB) HealthCheck() *datasource.Health { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "HealthCheck") + ret0, _ := ret[0].(*datasource.Health) + return ret0 +} + +// HealthCheck indicates an expected call of HealthCheck. +func (mr *MockDBMockRecorder) HealthCheck() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "HealthCheck", reflect.TypeOf((*MockDB)(nil).HealthCheck)) +} + +// Prepare mocks base method. +func (m *MockDB) Prepare(query string) (*sql.Stmt, error) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Prepare", query) + ret0, _ := ret[0].(*sql.Stmt) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Prepare indicates an expected call of Prepare. +func (mr *MockDBMockRecorder) Prepare(query any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Prepare", reflect.TypeOf((*MockDB)(nil).Prepare), query) +} + +// Query mocks base method. +func (m *MockDB) Query(query string, args ...any) (*sql.Rows, error) { + m.ctrl.T.Helper() + varargs := []any{query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "Query", varargs...) + ret0, _ := ret[0].(*sql.Rows) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Query indicates an expected call of Query. +func (mr *MockDBMockRecorder) Query(query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Query", reflect.TypeOf((*MockDB)(nil).Query), varargs...) +} + +// QueryContext mocks base method. +func (m *MockDB) QueryContext(ctx context.Context, query string, args ...any) (*sql.Rows, error) { + m.ctrl.T.Helper() + varargs := []any{ctx, query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "QueryContext", varargs...) + ret0, _ := ret[0].(*sql.Rows) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// QueryContext indicates an expected call of QueryContext. +func (mr *MockDBMockRecorder) QueryContext(ctx, query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{ctx, query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "QueryContext", reflect.TypeOf((*MockDB)(nil).QueryContext), varargs...) +} + +// QueryRow mocks base method. +func (m *MockDB) QueryRow(query string, args ...any) *sql.Row { + m.ctrl.T.Helper() + varargs := []any{query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "QueryRow", varargs...) + ret0, _ := ret[0].(*sql.Row) + return ret0 +} + +// QueryRow indicates an expected call of QueryRow. +func (mr *MockDBMockRecorder) QueryRow(query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "QueryRow", reflect.TypeOf((*MockDB)(nil).QueryRow), varargs...) +} + +// QueryRowContext mocks base method. +func (m *MockDB) QueryRowContext(ctx context.Context, query string, args ...any) *sql.Row { + m.ctrl.T.Helper() + varargs := []any{ctx, query} + for _, a := range args { + varargs = append(varargs, a) + } + ret := m.ctrl.Call(m, "QueryRowContext", varargs...) + ret0, _ := ret[0].(*sql.Row) + return ret0 +} + +// QueryRowContext indicates an expected call of QueryRowContext. +func (mr *MockDBMockRecorder) QueryRowContext(ctx, query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{ctx, query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "QueryRowContext", reflect.TypeOf((*MockDB)(nil).QueryRowContext), varargs...) +} + +// Select mocks base method. +func (m *MockDB) Select(ctx context.Context, data any, query string, args ...any) { + m.ctrl.T.Helper() + varargs := []any{ctx, data, query} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Select", varargs...) +} + +// Select indicates an expected call of Select. +func (mr *MockDBMockRecorder) Select(ctx, data, query any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{ctx, data, query}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Select", reflect.TypeOf((*MockDB)(nil).Select), varargs...) +} diff --git a/pkg/gofr/datasource/dbresolver/mock_logger.go b/pkg/gofr/datasource/dbresolver/mock_logger.go new file mode 100644 index 000000000..b03c0dd13 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/mock_logger.go @@ -0,0 +1,124 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: logger.go +// +// Generated by this command: +// +// mockgen -source=logger.go -destination=mock_logger.go -package=dbresolver +// + +// Package dbresolver is a generated GoMock package. +package dbresolver + +import ( + reflect "reflect" + + gomock "go.uber.org/mock/gomock" +) + +// MockLogger is a mock of Logger interface. +type MockLogger struct { + ctrl *gomock.Controller + recorder *MockLoggerMockRecorder + isgomock struct{} +} + +// MockLoggerMockRecorder is the mock recorder for MockLogger. +type MockLoggerMockRecorder struct { + mock *MockLogger +} + +// NewMockLogger creates a new mock instance. +func NewMockLogger(ctrl *gomock.Controller) *MockLogger { + mock := &MockLogger{ctrl: ctrl} + mock.recorder = &MockLoggerMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockLogger) EXPECT() *MockLoggerMockRecorder { + return m.recorder +} + +// Debug mocks base method. +func (m *MockLogger) Debug(args ...any) { + m.ctrl.T.Helper() + varargs := []any{} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Debug", varargs...) +} + +// Debug indicates an expected call of Debug. +func (mr *MockLoggerMockRecorder) Debug(args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Debug", reflect.TypeOf((*MockLogger)(nil).Debug), args...) +} + +// Debugf mocks base method. +func (m *MockLogger) Debugf(pattern string, args ...any) { + m.ctrl.T.Helper() + varargs := []any{pattern} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Debugf", varargs...) +} + +// Debugf indicates an expected call of Debugf. +func (mr *MockLoggerMockRecorder) Debugf(pattern any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{pattern}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Debugf", reflect.TypeOf((*MockLogger)(nil).Debugf), varargs...) +} + +// Errorf mocks base method. +func (m *MockLogger) Errorf(pattern string, args ...any) { + m.ctrl.T.Helper() + varargs := []any{pattern} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Errorf", varargs...) +} + +// Errorf indicates an expected call of Errorf. +func (mr *MockLoggerMockRecorder) Errorf(pattern any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{pattern}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Errorf", reflect.TypeOf((*MockLogger)(nil).Errorf), varargs...) +} + +// Logf mocks base method. +func (m *MockLogger) Logf(pattern string, args ...any) { + m.ctrl.T.Helper() + varargs := []any{pattern} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Logf", varargs...) +} + +// Logf indicates an expected call of Logf. +func (mr *MockLoggerMockRecorder) Logf(pattern any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{pattern}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Logf", reflect.TypeOf((*MockLogger)(nil).Logf), varargs...) +} + +// Warnf mocks base method. +func (m *MockLogger) Warnf(pattern string, args ...any) { + m.ctrl.T.Helper() + varargs := []any{pattern} + for _, a := range args { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "Warnf", varargs...) +} + +// Warnf indicates an expected call of Warnf. +func (mr *MockLoggerMockRecorder) Warnf(pattern any, args ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{pattern}, args...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Warnf", reflect.TypeOf((*MockLogger)(nil).Warnf), varargs...) +} diff --git a/pkg/gofr/datasource/dbresolver/mock_metrics.go b/pkg/gofr/datasource/dbresolver/mock_metrics.go new file mode 100644 index 000000000..076b43e5e --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/mock_metrics.go @@ -0,0 +1,104 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: metrics.go +// +// Generated by this command: +// +// mockgen -source=metrics.go -destination=mock_metrics.go -package=dbresolver +// + +// Package dbresolver is a generated GoMock package. +package dbresolver + +import ( + context "context" + reflect "reflect" + + gomock "go.uber.org/mock/gomock" +) + +// MockMetrics is a mock of Metrics interface. +type MockMetrics struct { + ctrl *gomock.Controller + recorder *MockMetricsMockRecorder + isgomock struct{} +} + +// MockMetricsMockRecorder is the mock recorder for MockMetrics. +type MockMetricsMockRecorder struct { + mock *MockMetrics +} + +// NewMockMetrics creates a new mock instance. +func NewMockMetrics(ctrl *gomock.Controller) *MockMetrics { + mock := &MockMetrics{ctrl: ctrl} + mock.recorder = &MockMetricsMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockMetrics) EXPECT() *MockMetricsMockRecorder { + return m.recorder +} + +// NewGauge mocks base method. +func (m *MockMetrics) NewGauge(name, description string) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "NewGauge", name, description) +} + +// NewGauge indicates an expected call of NewGauge. +func (mr *MockMetricsMockRecorder) NewGauge(name, description any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "NewGauge", reflect.TypeOf((*MockMetrics)(nil).NewGauge), name, description) +} + +// NewHistogram mocks base method. +func (m *MockMetrics) NewHistogram(name, description string, buckets ...float64) { + m.ctrl.T.Helper() + varargs := []any{name, description} + for _, a := range buckets { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "NewHistogram", varargs...) +} + +// NewHistogram indicates an expected call of NewHistogram. +func (mr *MockMetricsMockRecorder) NewHistogram(name, description any, buckets ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{name, description}, buckets...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "NewHistogram", reflect.TypeOf((*MockMetrics)(nil).NewHistogram), varargs...) +} + +// RecordHistogram mocks base method. +func (m *MockMetrics) RecordHistogram(ctx context.Context, name string, value float64, labels ...string) { + m.ctrl.T.Helper() + varargs := []any{ctx, name, value} + for _, a := range labels { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "RecordHistogram", varargs...) +} + +// RecordHistogram indicates an expected call of RecordHistogram. +func (mr *MockMetricsMockRecorder) RecordHistogram(ctx, name, value any, labels ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{ctx, name, value}, labels...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "RecordHistogram", reflect.TypeOf((*MockMetrics)(nil).RecordHistogram), varargs...) +} + +// SetGauge mocks base method. +func (m *MockMetrics) SetGauge(name string, value float64, labels ...string) { + m.ctrl.T.Helper() + varargs := []any{name, value} + for _, a := range labels { + varargs = append(varargs, a) + } + m.ctrl.Call(m, "SetGauge", varargs...) +} + +// SetGauge indicates an expected call of SetGauge. +func (mr *MockMetricsMockRecorder) SetGauge(name, value any, labels ...any) *gomock.Call { + mr.mock.ctrl.T.Helper() + varargs := append([]any{name, value}, labels...) + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "SetGauge", reflect.TypeOf((*MockMetrics)(nil).SetGauge), varargs...) +} diff --git a/pkg/gofr/datasource/dbresolver/mock_resolver_provider.go b/pkg/gofr/datasource/dbresolver/mock_resolver_provider.go new file mode 100644 index 000000000..b235cf130 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/mock_resolver_provider.go @@ -0,0 +1,104 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: gofr.dev/pkg/gofr/container (interfaces: DBResolverProvider) +// +// Generated by this command: +// +// mockgen -package=dbresolver -destination=mock_resolver_provider.go gofr.dev/pkg/gofr/container DBResolverProvider +// + +// Package dbresolver is a generated GoMock package. +package dbresolver + +import ( + reflect "reflect" + + gomock "go.uber.org/mock/gomock" + container "gofr.dev/pkg/gofr/container" +) + +// MockDBResolverProvider is a mock of DBResolverProvider interface. +type MockDBResolverProvider struct { + ctrl *gomock.Controller + recorder *MockDBResolverProviderMockRecorder + isgomock struct{} +} + +// MockDBResolverProviderMockRecorder is the mock recorder for MockDBResolverProvider. +type MockDBResolverProviderMockRecorder struct { + mock *MockDBResolverProvider +} + +// NewMockDBResolverProvider creates a new mock instance. +func NewMockDBResolverProvider(ctrl *gomock.Controller) *MockDBResolverProvider { + mock := &MockDBResolverProvider{ctrl: ctrl} + mock.recorder = &MockDBResolverProviderMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockDBResolverProvider) EXPECT() *MockDBResolverProviderMockRecorder { + return m.recorder +} + +// Build mocks base method. +func (m *MockDBResolverProvider) Build(primary container.DB, replicas []container.DB) (container.DB, error) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Build", primary, replicas) + ret0, _ := ret[0].(container.DB) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Build indicates an expected call of Build. +func (mr *MockDBResolverProviderMockRecorder) Build(primary, replicas any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Build", reflect.TypeOf((*MockDBResolverProvider)(nil).Build), primary, replicas) +} + +// Connect mocks base method. +func (m *MockDBResolverProvider) Connect() { + m.ctrl.T.Helper() + m.ctrl.Call(m, "Connect") +} + +// Connect indicates an expected call of Connect. +func (mr *MockDBResolverProviderMockRecorder) Connect() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Connect", reflect.TypeOf((*MockDBResolverProvider)(nil).Connect)) +} + +// UseLogger mocks base method. +func (m *MockDBResolverProvider) UseLogger(logger any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseLogger", logger) +} + +// UseLogger indicates an expected call of UseLogger. +func (mr *MockDBResolverProviderMockRecorder) UseLogger(logger any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseLogger", reflect.TypeOf((*MockDBResolverProvider)(nil).UseLogger), logger) +} + +// UseMetrics mocks base method. +func (m *MockDBResolverProvider) UseMetrics(metrics any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseMetrics", metrics) +} + +// UseMetrics indicates an expected call of UseMetrics. +func (mr *MockDBResolverProviderMockRecorder) UseMetrics(metrics any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseMetrics", reflect.TypeOf((*MockDBResolverProvider)(nil).UseMetrics), metrics) +} + +// UseTracer mocks base method. +func (m *MockDBResolverProvider) UseTracer(tracer any) { + m.ctrl.T.Helper() + m.ctrl.Call(m, "UseTracer", tracer) +} + +// UseTracer indicates an expected call of UseTracer. +func (mr *MockDBResolverProviderMockRecorder) UseTracer(tracer any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "UseTracer", reflect.TypeOf((*MockDBResolverProvider)(nil).UseTracer), tracer) +} diff --git a/pkg/gofr/datasource/dbresolver/mock_strategy.go b/pkg/gofr/datasource/dbresolver/mock_strategy.go new file mode 100644 index 000000000..89f6c4d1b --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/mock_strategy.go @@ -0,0 +1,70 @@ +// Code generated by MockGen. DO NOT EDIT. +// Source: strategy.go +// +// Generated by this command: +// +// mockgen -source=strategy.go -destination=mock_strategy.go -package=dbresolver +// + +// Package dbresolver is a generated GoMock package. +package dbresolver + +import ( + reflect "reflect" + + gomock "go.uber.org/mock/gomock" + container "gofr.dev/pkg/gofr/container" +) + +// MockStrategy is a mock of Strategy interface. +type MockStrategy struct { + ctrl *gomock.Controller + recorder *MockStrategyMockRecorder + isgomock struct{} +} + +// MockStrategyMockRecorder is the mock recorder for MockStrategy. +type MockStrategyMockRecorder struct { + mock *MockStrategy +} + +// NewMockStrategy creates a new mock instance. +func NewMockStrategy(ctrl *gomock.Controller) *MockStrategy { + mock := &MockStrategy{ctrl: ctrl} + mock.recorder = &MockStrategyMockRecorder{mock} + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockStrategy) EXPECT() *MockStrategyMockRecorder { + return m.recorder +} + +// Choose mocks base method. +func (m *MockStrategy) Choose(replicas []container.DB) (container.DB, error) { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Choose", replicas) + ret0, _ := ret[0].(container.DB) + ret1, _ := ret[1].(error) + return ret0, ret1 +} + +// Choose indicates an expected call of Choose. +func (mr *MockStrategyMockRecorder) Choose(replicas any) *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Choose", reflect.TypeOf((*MockStrategy)(nil).Choose), replicas) +} + +// Name mocks base method. +func (m *MockStrategy) Name() string { + m.ctrl.T.Helper() + ret := m.ctrl.Call(m, "Name") + ret0, _ := ret[0].(string) + return ret0 +} + +// Name indicates an expected call of Name. +func (mr *MockStrategyMockRecorder) Name() *gomock.Call { + mr.mock.ctrl.T.Helper() + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "Name", reflect.TypeOf((*MockStrategy)(nil).Name)) +} diff --git a/pkg/gofr/datasource/dbresolver/options.go b/pkg/gofr/datasource/dbresolver/options.go new file mode 100644 index 000000000..8db622061 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/options.go @@ -0,0 +1,18 @@ +package dbresolver + +// Option is a function type for configuring the resolver. +type Option func(*Resolver) + +// WithStrategy sets the strategy for the resolver. +func WithStrategy(strategy Strategy) Option { + return func(r *Resolver) { + r.strategy = strategy + } +} + +// WithFallback sets whether to fallback to primary on replica failure. +func WithFallback(fallback bool) Option { + return func(r *Resolver) { + r.readFallback = fallback + } +} diff --git a/pkg/gofr/datasource/dbresolver/query_cache.go b/pkg/gofr/datasource/dbresolver/query_cache.go new file mode 100644 index 000000000..5aa854a5a --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/query_cache.go @@ -0,0 +1,45 @@ +package dbresolver + +import ( + "sync" + "sync/atomic" +) + +// queryCache implements a thread-safe, size-limited cache for query classification. +type queryCache struct { + cache sync.Map + size atomic.Int64 + max int64 +} + +func newQueryCache(maxSize int64) *queryCache { + return &queryCache{ + max: maxSize, + } +} + +func (c *queryCache) get(key string) (value, exists bool) { + val, found := c.cache.Load(key) + if !found { + return false, false + } + + boolVal, ok := val.(bool) + if !ok { + return false, false + } + + return boolVal, true +} + +func (c *queryCache) set(key string, value bool) { + // Simple bounded cache - reject if full + if c.size.Load() >= c.max { + return + } + + // Only increment size if it's a new key. + if _, loaded := c.cache.LoadOrStore(key, value); !loaded { + c.size.Add(1) + } +} diff --git a/pkg/gofr/datasource/dbresolver/resolver.go b/pkg/gofr/datasource/dbresolver/resolver.go new file mode 100644 index 000000000..7e2659082 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/resolver.go @@ -0,0 +1,504 @@ +package dbresolver + +import ( + "context" + "database/sql" + "fmt" + "regexp" + "strings" + "sync" + "sync/atomic" + "time" + + "go.opentelemetry.io/otel/attribute" + "go.opentelemetry.io/otel/trace" + "gofr.dev/pkg/gofr/container" + "gofr.dev/pkg/gofr/datasource" + gofrSQL "gofr.dev/pkg/gofr/datasource/sql" +) + +// Constants for strategies and intervals. +const ( + healthStatusUP = "UP" + healthStatusDOWN = "DOWN" + circuitStateClosed int32 = 0 + circuitStateOpen int32 = 1 + circuitStateHalfOpen int32 = 2 + defaultMaxFailures int32 = 5 + defaultTimeoutSec int = 30 + defaultCacheSize int64 = 1000 + minQueryLength int = 6 +) + +// Pre-compiled regex - compiled once at package init. +var readQueryRegex = regexp.MustCompile(`(?i)^\s*(SELECT|SHOW|DESCRIBE|EXPLAIN)`) + +// statistics holds atomic counters for various operations. +type statistics struct { + primaryReads atomic.Uint64 + primaryWrites atomic.Uint64 + replicaReads atomic.Uint64 + primaryFallbacks atomic.Uint64 + replicaFailures atomic.Uint64 + totalQueries atomic.Uint64 +} + +// Replica wrapper with circuit breaker. +type replicaWrapper struct { + db container.DB + breaker *circuitBreaker +} + +// Resolver is the main struct that implements the container.DB interface. +type Resolver struct { + primary container.DB + replicas []*replicaWrapper + strategy Strategy + readFallback bool + + logger Logger + metrics Metrics + tracer trace.Tracer + + queryCache *queryCache + stats *statistics + + // Background task management. + stopChan chan struct{} + wg sync.WaitGroup + once sync.Once +} + +// NewResolver creates a new Resolver instance with the provided primary and replicas. +func NewResolver(primary container.DB, replicas []container.DB, logger Logger, metrics Metrics, opts ...Option) container.DB { + // Wrap replicas with circuit breakers + replicaWrappers := make([]*replicaWrapper, len(replicas)) + for i, replica := range replicas { + replicaWrappers[i] = &replicaWrapper{ + db: replica, + breaker: newCircuitBreaker(defaultMaxFailures, time.Duration(defaultTimeoutSec)*time.Second), + } + } + + r := &Resolver{ + primary: primary, + replicas: replicaWrappers, + readFallback: true, // Default to true + logger: logger, + metrics: metrics, + queryCache: newQueryCache(defaultCacheSize), // Bounded sync.Map cache. + stats: &statistics{}, + stopChan: make(chan struct{}), + } + + // Default strategy + if len(replicas) > 0 { + r.strategy = NewRoundRobinStrategy(len(replicas)) + } + + // Apply options + for _, opt := range opts { + opt(r) + } + + // Initialize metrics and start background tasks. + r.initializeMetrics() + r.startBackgroundTasks() + + if r.logger != nil { + r.logger.Logf("DB Resolver initialized with %d replicas using circuit breakers", len(replicas)) + } + + return r +} + +// initializeMetrics sets up metrics following GoFr patterns. +func (r *Resolver) initializeMetrics() { + if r.metrics == nil { + return + } + + // Histogram for query response times + buckets := []float64{0.05, 0.1, 0.2, 0.5, 1.0, 2.0, 5.0, 10.0} + r.metrics.NewHistogram("dbresolver_query_duration", "Response time of DB resolver operations in microseconds", buckets...) + + // Gauges for operation tracking + r.metrics.NewGauge("dbresolver_primary_reads", "Total reads routed to primary") + r.metrics.NewGauge("dbresolver_primary_writes", "Total writes routed to primary") + r.metrics.NewGauge("dbresolver_replica_reads", "Total reads routed to replicas") + r.metrics.NewGauge("dbresolver_fallbacks", "Total fallbacks to primary") + r.metrics.NewGauge("dbresolver_failures", "Total replica failures") +} + +// startBackgroundTasks starts minimal background processing. +func (r *Resolver) startBackgroundTasks() { + r.wg.Add(1) + go r.backgroundProcessor() +} + +// backgroundProcessor handles metrics collection with reduced frequency. +func (r *Resolver) backgroundProcessor() { + defer r.wg.Done() + + ticker := time.NewTicker(time.Duration(defaultTimeoutSec) * time.Second) + defer ticker.Stop() + + for { + select { + case <-r.stopChan: + return + case <-ticker.C: + r.updateMetrics() + } + } +} + +// updateMetrics updates gauge metrics. +func (r *Resolver) updateMetrics() { + if r.metrics == nil { + return + } + + r.metrics.SetGauge("dbresolver_primary_reads", float64(r.stats.primaryReads.Load())) + r.metrics.SetGauge("dbresolver_primary_writes", float64(r.stats.primaryWrites.Load())) + r.metrics.SetGauge("dbresolver_replica_reads", float64(r.stats.replicaReads.Load())) + r.metrics.SetGauge("dbresolver_fallbacks", float64(r.stats.primaryFallbacks.Load())) + r.metrics.SetGauge("dbresolver_failures", float64(r.stats.replicaFailures.Load())) +} + +// Fast query classification with optimized string operations. +func (r *Resolver) isReadQuery(query string) bool { + // Fast path: check first few characters for common patterns + if len(query) < minQueryLength { + return false + } + + // Trim whitespace and get first word + trimmed := strings.TrimLeft(query, " \t\n\r") + if len(trimmed) < minQueryLength { + return false + } + + // Fast string comparison for common cases + firstSix := strings.ToUpper(trimmed[:6]) + switch firstSix { + case "SELECT", "SHOW ", "DESCRI", "EXPLAI": + return true + } + + // Check cache for edge cases + if cached, exists := r.queryCache.get(query); exists { + return cached + } + + // Fallback to regex for complex queries + isRead := readQueryRegex.MatchString(query) + + r.queryCache.set(query, isRead) + + return isRead +} + +// selectHealthyReplica chooses an available replica using circuit breaker. +func (r *Resolver) selectHealthyReplica() (availableDB container.DB, availableIndex int) { + if len(r.replicas) == 0 { + return nil, -1 + } + + // Get all available DBs for strategy + var ( + availableDbs []container.DB + availableIndexes []int + ) + + for i, wrapper := range r.replicas { + if wrapper.breaker.allowRequest() { + availableDbs = append(availableDbs, wrapper.db) + availableIndexes = append(availableIndexes, i) + } + } + + if len(availableDbs) == 0 { + return nil, -1 + } + + // Use strategy to choose from available replicas + chosenDB, err := r.strategy.Choose(availableDbs) + if err != nil { + return nil, -1 + } + + // Find the index of chosen replica + for i, db := range availableDbs { + if db == chosenDB { + return chosenDB, availableIndexes[i] + } + } + + return chosenDB, availableIndexes[0] +} + +// addTrace adds tracing information to the context and returns a span. +func (r *Resolver) addTrace(ctx context.Context, method, query string) (context.Context, trace.Span) { + if r.tracer == nil { + return ctx, nil + } + + tracedCtx, span := r.tracer.Start(ctx, fmt.Sprintf("dbresolver-%s", method)) + if span != nil { + span.SetAttributes( + attribute.String("dbresolver.query", query), + attribute.String("dbresolver.method", method), + ) + } + + return tracedCtx, span +} + +// recordStats records operation statistics and updates tracing spans. +func (r *Resolver) recordStats(start time.Time, method, target string, span trace.Span, isRead bool) { + duration := time.Since(start).Microseconds() + + // Update trace if available. + if span != nil { + defer span.End() + span.SetAttributes( + attribute.String("dbresolver.target", target), + attribute.Int64("dbresolver.duration", duration), + attribute.Bool("dbresolver.is_read", isRead), + ) + } + + // Record metrics histogram only if metrics are enabled. + if r.metrics != nil { + r.metrics.RecordHistogram(context.Background(), "dbresolver_query_duration", + float64(duration), "method", method, "target", target) + } +} + +// Query routes to replica for reads, primary for writes. +func (r *Resolver) Query(query string, args ...any) (*sql.Rows, error) { + return r.QueryContext(context.Background(), query, args...) +} + +// QueryContext routes queries with optimized path. +func (r *Resolver) QueryContext(ctx context.Context, query string, args ...any) (*sql.Rows, error) { + start := time.Now() + isRead := r.isReadQuery(query) + r.stats.totalQueries.Add(1) + + tracedCtx, span := r.addTrace(ctx, "query", query) + + if isRead && len(r.replicas) > 0 { + // Try replica first + replica, replicaIdx := r.selectHealthyReplica() + if replica != nil { + rows, err := replica.QueryContext(tracedCtx, query, args...) + if err == nil { + r.stats.replicaReads.Add(1) + r.replicas[replicaIdx].breaker.recordSuccess() + r.recordStats(start, "query", "replica", span, true) + + return rows, nil + } + + // Record failure + r.replicas[replicaIdx].breaker.recordFailure() + r.stats.replicaFailures.Add(1) + } + + // Fallback to primary if enabled + if r.readFallback { + r.stats.primaryFallbacks.Add(1) + r.stats.primaryReads.Add(1) + rows, err := r.primary.QueryContext(tracedCtx, query, args...) + r.recordStats(start, "query", "primary-fallback", span, true) + + return rows, err + } + + r.recordStats(start, "query", "replica-failed", span, true) + + return nil, errReplicaFailedNoFallback + } + + // Write query - always use primary + r.stats.primaryWrites.Add(1) + rows, err := r.primary.QueryContext(tracedCtx, query, args...) + r.recordStats(start, "query", "primary", span, false) + + return rows, err +} + +// QueryRow routes to replica for reads, primary for writes. +func (r *Resolver) QueryRow(query string, args ...any) *sql.Row { + return r.QueryRowContext(context.Background(), query, args...) +} + +// QueryRowContext routes queries with circuit breaker. +func (r *Resolver) QueryRowContext(ctx context.Context, query string, args ...any) *sql.Row { + start := time.Now() + isRead := r.isReadQuery(query) + r.stats.totalQueries.Add(1) + + tracedCtx, span := r.addTrace(ctx, "query-row", query) + defer r.recordStats(start, "query-row", "primary", span, isRead) + + if isRead && len(r.replicas) > 0 { + replica, replicaIdx := r.selectHealthyReplica() + if replica != nil { + r.stats.replicaReads.Add(1) + r.replicas[replicaIdx].breaker.recordSuccess() + + return replica.QueryRowContext(tracedCtx, query, args...) + } + + r.stats.replicaFailures.Add(1) + } + + r.stats.primaryWrites.Add(1) + + return r.primary.QueryRowContext(tracedCtx, query, args...) +} + +// Exec always routes to primary (write operation). +func (r *Resolver) Exec(query string, args ...any) (sql.Result, error) { + return r.ExecContext(context.Background(), query, args...) +} + +// ExecContext always routes to primary (write operation). +func (r *Resolver) ExecContext(ctx context.Context, query string, args ...any) (sql.Result, error) { + start := time.Now() + + r.stats.primaryWrites.Add(1) + r.stats.totalQueries.Add(1) + + tracedCtx, span := r.addTrace(ctx, "exec", query) + defer r.recordStats(start, "exec", "primary", span, false) + + return r.primary.ExecContext(tracedCtx, query, args...) +} + +// Select routes to replica for reads, primary for writes. +func (r *Resolver) Select(ctx context.Context, data any, query string, args ...any) { + start := time.Now() + isRead := r.isReadQuery(query) + r.stats.totalQueries.Add(1) + + tracedCtx, span := r.addTrace(ctx, "select", query) + + if isRead && len(r.replicas) > 0 { + replica, replicaIdx := r.selectHealthyReplica() + + if replica != nil { + r.stats.replicaReads.Add(1) + r.replicas[replicaIdx].breaker.recordSuccess() + replica.Select(tracedCtx, data, query, args...) + r.recordStats(start, "select", "replica", span, true) + + return + } + + r.stats.replicaFailures.Add(1) + } + + r.stats.primaryWrites.Add(1) + + r.primary.Select(tracedCtx, data, query, args...) + + r.recordStats(start, "select", "primary", span, isRead) +} + +// Prepare always routes to primary (consistency). +func (r *Resolver) Prepare(query string) (*sql.Stmt, error) { + r.stats.totalQueries.Add(1) + + return r.primary.Prepare(query) +} + +// Begin always routes to primary (transactions). +func (r *Resolver) Begin() (*gofrSQL.Tx, error) { + r.stats.totalQueries.Add(1) + + return r.primary.Begin() +} + +// Dialect returns the database dialect. +func (r *Resolver) Dialect() string { + return r.primary.Dialect() +} + +// HealthCheck returns comprehensive health information. +func (r *Resolver) HealthCheck() *datasource.Health { + primaryHealth := r.primary.HealthCheck() + + health := &datasource.Health{ + Status: primaryHealth.Status, + Details: map[string]any{ + "primary": primaryHealth, + "stats": map[string]any{ + "primaryReads": r.stats.primaryReads.Load(), + "primaryWrites": r.stats.primaryWrites.Load(), + "replicaReads": r.stats.replicaReads.Load(), + "primaryFallbacks": r.stats.primaryFallbacks.Load(), + "replicaFailures": r.stats.replicaFailures.Load(), + "totalQueries": r.stats.totalQueries.Load(), + }, + }, + } + + // Check replica health with circuit breaker status + replicaDetails := make([]any, len(r.replicas)) + + for i, wrapper := range r.replicas { + replicaHealth := wrapper.db.HealthCheck() + state := wrapper.breaker.state.Load() + + var stateStr string + + switch state { + case circuitStateClosed: + stateStr = "CLOSED" + case circuitStateOpen: + stateStr = "OPEN" + case circuitStateHalfOpen: + stateStr = "HALF_OPEN" + } + + replicaDetails[i] = map[string]any{ + "index": i, + "health": replicaHealth, + "circuit_state": stateStr, + "failures": wrapper.breaker.failures.Load(), + } + } + + health.Details["replicas"] = replicaDetails + + return health +} + +// Close cleans up resources properly. +func (r *Resolver) Close() error { + var err error + + // Stop background tasks only once + r.once.Do(func() { + close(r.stopChan) + r.wg.Wait() + }) + + // Close primary + if closeErr := r.primary.Close(); closeErr != nil { + err = closeErr + } + + // Close replicas + for _, wrapper := range r.replicas { + if closeErr := wrapper.db.Close(); closeErr != nil { + err = closeErr + } + } + + return err +} diff --git a/pkg/gofr/datasource/dbresolver/resolver_test.go b/pkg/gofr/datasource/dbresolver/resolver_test.go new file mode 100644 index 000000000..ac8634c35 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/resolver_test.go @@ -0,0 +1,424 @@ +package dbresolver + +import ( + "database/sql" + "errors" + "reflect" + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "go.uber.org/mock/gomock" + "gofr.dev/pkg/gofr/datasource" + gofrSQL "gofr.dev/pkg/gofr/datasource/sql" +) + +var errTestReplicaFailed = errors.New("replica connection failed") + +// MockResult is a mock of sql.Result interface. +type MockResult struct { + ctrl *gomock.Controller + recorder *MockResultMockRecorder +} + +// MockResultMockRecorder is the mock recorder for MockResult. +type MockResultMockRecorder struct { + mock *MockResult +} + +// NewMockResult creates a new mock instance. +func NewMockResult(ctrl *gomock.Controller) *MockResult { + mock := &MockResult{ctrl: ctrl} + mock.recorder = &MockResultMockRecorder{mock} + + return mock +} + +// EXPECT returns an object that allows the caller to indicate expected use. +func (m *MockResult) EXPECT() *MockResultMockRecorder { + return m.recorder +} + +// LastInsertId mocks base method. +func (m *MockResult) LastInsertId() (int64, error) { + ret := m.ctrl.Call(m, "LastInsertId") + + ret0, _ := ret[0].(int64) + ret1, _ := ret[1].(error) + + return ret0, ret1 +} + +// LastInsertId indicates an expected call of LastInsertId. +func (mr *MockResultMockRecorder) LastInsertId() *gomock.Call { + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "LastInsertId", reflect.TypeOf((*MockResult)(nil).LastInsertId)) +} + +// RowsAffected mocks base method. +func (m *MockResult) RowsAffected() (int64, error) { + ret := m.ctrl.Call(m, "RowsAffected") + ret0, _ := ret[0].(int64) + ret1, _ := ret[1].(error) + + return ret0, ret1 +} + +// RowsAffected indicates an expected call of RowsAffected. +func (mr *MockResultMockRecorder) RowsAffected() *gomock.Call { + return mr.mock.ctrl.RecordCallWithMethodType(mr.mock, "RowsAffected", reflect.TypeOf((*MockResult)(nil).RowsAffected)) +} + +func TestResolver_Query_ReadGoesToReplica(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + readQuery := "SELECT * FROM users" + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryContext(gomock.Any(), readQuery).Return(expectedRows, nil) + + rows, err := mocks.Resolver.Query(readQuery) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_Query_WriteGoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + writeQuery := "INSERT INTO users (name) VALUES (?)" + args := []any{"test_user"} + + mocks.Primary.EXPECT().QueryContext(gomock.Any(), writeQuery, args[0]).Return(expectedRows, nil) + + rows, err := mocks.Resolver.Query(writeQuery, args[0]) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_Query_FallbackToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + readQuery := "SELECT * FROM users" + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryContext(gomock.Any(), readQuery).Return(expectedRows, nil) + + rows, err := mocks.Resolver.Query(readQuery) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_QueryContext_ReadGoesToReplica(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + readQuery := "SELECT * FROM users" + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryContext(gomock.Any(), readQuery).Return(expectedRows, nil) + + rows, err := mocks.Resolver.QueryContext(t.Context(), readQuery) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_QueryContext_WriteGoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + writeQuery := "INSERT INTO users (name) VALUES (?)" + args := []any{"test_user"} + + mocks.Primary.EXPECT().QueryContext(gomock.Any(), writeQuery, args[0]).Return(expectedRows, nil) + + rows, err := mocks.Resolver.QueryContext(t.Context(), writeQuery, args[0]) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_QueryRow_ReadGoesToReplica(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRow := &sql.Row{} + readQuery := "SELECT * FROM users WHERE id = ?" + args := []any{1} + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryRowContext(gomock.Any(), readQuery, args[0]).Return(expectedRow) + + row := mocks.Resolver.QueryRow(readQuery, args[0]) + + assert.NotNil(t, row) + assert.NoError(t, row.Err()) +} + +func TestResolver_QueryRow_WriteGoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRow := &sql.Row{} + writeQuery := "INSERT INTO users (name) VALUES (?) RETURNING id" + args := []any{"test_user"} + + mocks.Primary.EXPECT().QueryRowContext(gomock.Any(), writeQuery, args[0]).Return(expectedRow) + + row := mocks.Resolver.QueryRow(writeQuery, args[0]) + + assert.NotNil(t, row) + assert.NoError(t, row.Err()) +} + +func TestResolver_QueryRowContext_ReadGoesToReplica(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRow := &sql.Row{} + readQuery := "SELECT * FROM users WHERE id = ?" + args := []any{1} + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryRowContext(gomock.Any(), readQuery, args[0]).Return(expectedRow) + + row := mocks.Resolver.QueryRowContext(t.Context(), readQuery, args[0]) + + assert.NotNil(t, row) + assert.NoError(t, row.Err()) +} + +func TestResolver_QueryRowContext_WriteGoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRow := &sql.Row{} + writeQuery := "INSERT INTO users (name) VALUES (?) RETURNING id" + args := []any{"test_user"} + + mocks.Primary.EXPECT().QueryRowContext(gomock.Any(), writeQuery, args[0]).Return(expectedRow) + + row := mocks.Resolver.QueryRowContext(t.Context(), writeQuery, args[0]) + + assert.NotNil(t, row) + assert.NoError(t, row.Err()) +} + +func TestResolver_ExecContext_GoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedResult := NewMockResult(mocks.Ctrl) + writeQuery := "UPDATE users SET name = ? WHERE id = ?" + args := []any{"new_name", 1} + + mocks.Primary.EXPECT().ExecContext(gomock.Any(), writeQuery, args[0], args[1]).Return(expectedResult, nil) + + result, err := mocks.Resolver.ExecContext(t.Context(), writeQuery, args[0], args[1]) + + require.NoError(t, err) + assert.Equal(t, expectedResult, result) +} + +func TestResolver_Exec_GoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedResult := NewMockResult(mocks.Ctrl) + writeQuery := "UPDATE users SET name = ? WHERE id = ?" + args := []any{"new_name", 1} + + mocks.Primary.EXPECT().ExecContext(gomock.Any(), writeQuery, args[0], args[1]).Return(expectedResult, nil) + + result, err := mocks.Resolver.Exec(writeQuery, args[0], args[1]) + + require.NoError(t, err) + assert.Equal(t, expectedResult, result) +} + +func TestResolver_Select_ReadGoesToReplica(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + data := &struct{ Name string }{} + readQuery := "SELECT name FROM users WHERE id = ?" + args := []any{1} + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().Select(gomock.Any(), data, readQuery, args[0]) + + mocks.Resolver.Select(t.Context(), data, readQuery, args[0]) +} + +func TestResolver_Select_WriteGoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + data := &struct{ ID int64 }{} + writeQuery := "INSERT INTO users (name) VALUES (?) RETURNING id" + args := []any{"test_user"} + + mocks.Primary.EXPECT().Select(gomock.Any(), data, writeQuery, args[0]) + + mocks.Resolver.Select(t.Context(), data, writeQuery, args[0]) +} + +func TestResolver_Prepare_GoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedStmt := &sql.Stmt{} + query := "SELECT * FROM users WHERE id = ?" + + mocks.Primary.EXPECT().Prepare(query).Return(expectedStmt, nil) + + stmt, err := mocks.Resolver.Prepare(query) + + require.NoError(t, err) + assert.Equal(t, expectedStmt, stmt) +} + +func TestResolver_Begin_GoesToPrimary(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedTx := &gofrSQL.Tx{} + + mocks.Primary.EXPECT().Begin().Return(expectedTx, nil) + + tx, err := mocks.Resolver.Begin() + + require.NoError(t, err) + assert.Equal(t, expectedTx, tx) +} + +func TestResolver_Dialect(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedDialect := "mysql" + mocks.Primary.EXPECT().Dialect().Return(expectedDialect) + + dialect := mocks.Resolver.Dialect() + assert.Equal(t, expectedDialect, dialect) +} + +func TestResolver_Close(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + // Test primary close + mocks.Primary.EXPECT().Close().Return(nil) + + // Test replicas close + for _, replica := range mocks.MockReplicas { + replica.EXPECT().Close().Return(nil) + } + + err := mocks.Resolver.Close() + assert.NoError(t, err) +} + +func TestResolver_Close_WithError(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + // Primary returns error + mocks.Primary.EXPECT().Close().Return(errTestReplicaFailed) + + // Replicas don't error + for _, replica := range mocks.MockReplicas { + replica.EXPECT().Close().Return(nil) + } + + err := mocks.Resolver.Close() + assert.Equal(t, errTestReplicaFailed, err) +} + +func TestResolver_QueryContext_WithFallback(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + expectedRows := &sql.Rows{} + readQuery := "SELECT * FROM users" + + mocks.Strategy.EXPECT().Choose(gomock.Any()).Return(mocks.MockReplicas[0], nil) + mocks.MockReplicas[0].EXPECT().QueryContext(gomock.Any(), readQuery).Return(nil, errTestReplicaFailed) + mocks.Primary.EXPECT().QueryContext(gomock.Any(), readQuery).Return(expectedRows, nil) + + rows, err := mocks.Resolver.QueryContext(t.Context(), readQuery) + + require.NoError(t, err) + assert.NoError(t, rows.Err()) + assert.Equal(t, expectedRows, rows) +} + +func TestResolver_HealthCheck(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + primaryHealth := &datasource.Health{ + Status: healthStatusUP, + Details: map[string]any{ + "connections": 5, + }, + } + + replica1Health := &datasource.Health{ + Status: healthStatusUP, + Details: map[string]any{ + "connections": 3, + }, + } + + replica2Health := &datasource.Health{ + Status: healthStatusDOWN, + Details: map[string]any{ + "error": "connection refused", + }, + } + + mocks.Primary.EXPECT().HealthCheck().Return(primaryHealth) + mocks.MockReplicas[0].EXPECT().HealthCheck().Return(replica1Health) + mocks.MockReplicas[1].EXPECT().HealthCheck().Return(replica2Health) + + health := mocks.Resolver.HealthCheck() + + assert.Equal(t, healthStatusUP, health.Status) + assert.Equal(t, primaryHealth, health.Details["primary"]) + + replicas := health.Details["replicas"].([]any) + assert.Len(t, replicas, 2) + + stats := health.Details["stats"].(map[string]any) + assert.Contains(t, stats, "primaryReads") + assert.Contains(t, stats, "replicaReads") + assert.Contains(t, stats, "totalQueries") +} + +func TestResolver_AddTrace(t *testing.T) { + mocks := setupMocks(t, true) + defer mocks.Ctrl.Finish() + + method := "query" + query := "SELECT * FROM users" + + _, span := mocks.Resolver.addTrace(t.Context(), method, query) + + assert.NotNil(t, span) +} diff --git a/pkg/gofr/datasource/dbresolver/strategy.go b/pkg/gofr/datasource/dbresolver/strategy.go new file mode 100644 index 000000000..a0f51e7b6 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/strategy.go @@ -0,0 +1,84 @@ +package dbresolver + +import ( + "errors" + "math/rand" + "sync/atomic" + + "gofr.dev/pkg/gofr/container" +) + +// StrategyType defines the load balancing strategy type. +type StrategyType string + +const ( + // StrategyRoundRobin distributes load sequentially across replicas. + StrategyRoundRobin StrategyType = "round-robin" + // StrategyRandom randomly selects a replica for each request. + StrategyRandom StrategyType = "random" +) + +var errNoReplicasAvailable = errors.New("no replicas available") + +// Strategy interface defines replica selection logic. +type Strategy interface { + Choose(replicas []container.DB) (container.DB, error) + Name() string +} + +// RoundRobinStrategy selects replicas in round-robin order. +type RoundRobinStrategy struct { + current atomic.Int64 + count int +} + +// NewRoundRobinStrategy creates a new round-robin strategy instance. +func NewRoundRobinStrategy(count int) Strategy { + return &RoundRobinStrategy{ + count: count, + } +} + +// Choose selects the next replica in round-robin fashion. +// Choose selects the next replica in round-robin fashion. +func (s *RoundRobinStrategy) Choose(replicas []container.DB) (container.DB, error) { + replicaCount := int64(len(replicas)) + if replicaCount == 0 { + return nil, errNoReplicasAvailable + } + + count := s.current.Add(1) + + idx64 := count % replicaCount + + idx := int(idx64) + + return replicas[idx], nil +} + +// Name returns the name of strategy. +func (*RoundRobinStrategy) Name() string { + return string(StrategyRoundRobin) +} + +// RandomStrategy selects a replica randomly. +type RandomStrategy struct{} + +// NewRandomStrategy creates a new random strategy instance. +func NewRandomStrategy() Strategy { + return &RandomStrategy{} +} + +// Choose selects a random replica. +func (*RandomStrategy) Choose(replicas []container.DB) (container.DB, error) { + if len(replicas) == 0 { + return nil, errNoReplicasAvailable + } + + return replicas[rand.Intn(len(replicas))], nil //nolint:gosec // acceptable randomness for load balance +} + +// Name returns the name of the strategy. +func (*RandomStrategy) Name() string { + return string(StrategyRandom) +} diff --git a/pkg/gofr/datasource/dbresolver/strategy_test.go b/pkg/gofr/datasource/dbresolver/strategy_test.go new file mode 100644 index 000000000..5e71a12d8 --- /dev/null +++ b/pkg/gofr/datasource/dbresolver/strategy_test.go @@ -0,0 +1,129 @@ +package dbresolver + +import ( + "testing" + + "github.com/stretchr/testify/assert" + "github.com/stretchr/testify/require" + "go.uber.org/mock/gomock" + "gofr.dev/pkg/gofr/container" +) + +func TestRoundRobinStrategy_Choose(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + // Create mock replicas + mockReplica1 := NewMockDB(ctrl) + mockReplica2 := NewMockDB(ctrl) + mockReplica3 := NewMockDB(ctrl) + + replicas := []container.DB{mockReplica1, mockReplica2, mockReplica3} + + // Create strategy + strategy := NewRoundRobinStrategy(len(replicas)) + + // First call should return first replica + db, err := strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica1, db) + + // Second call should return second replica + db, err = strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica2, db) + + // Third call should return third replica + db, err = strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica3, db) + + // Fourth call should wrap around to first replica + db, err = strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica1, db) +} + +func TestRoundRobinStrategy_Choose_SingleReplica(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + // Create mock replica + mockReplica := NewMockDB(ctrl) + replicas := []container.DB{mockReplica} + + // Create strategy + strategy := NewRoundRobinStrategy(len(replicas)) + + // All calls should return the same replica + for i := 0; i < 5; i++ { + db, err := strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica, db) + } +} + +func TestRoundRobinStrategy_Choose_NoReplicas(t *testing.T) { + strategy := NewRoundRobinStrategy(0) + + db, err := strategy.Choose([]container.DB{}) + assert.Nil(t, db) + assert.ErrorIs(t, err, errNoReplicasAvailable) +} + +func TestRandomStrategy_Choose(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + // Create mock replicas + mockReplica1 := NewMockDB(ctrl) + mockReplica2 := NewMockDB(ctrl) + mockReplica3 := NewMockDB(ctrl) + + replicas := []container.DB{mockReplica1, mockReplica2, mockReplica3} + + // Create strategy + strategy := NewRandomStrategy() + + // Verify that multiple calls return one of the replicas + for i := 0; i < 10; i++ { + result, err := strategy.Choose(replicas) + require.NoError(t, err) + assert.Contains(t, replicas, result) + } +} + +func TestRandomStrategy_Choose_SingleReplica(t *testing.T) { + ctrl := gomock.NewController(t) + defer ctrl.Finish() + + // Create mock replica + mockReplica := NewMockDB(ctrl) + replicas := []container.DB{mockReplica} + + // Create strategy + strategy := NewRandomStrategy() + + // All calls should return the same replica + for i := 0; i < 5; i++ { + db, err := strategy.Choose(replicas) + require.NoError(t, err) + assert.Equal(t, mockReplica, db) + } +} + +func TestRandomStrategy_Choose_NoReplicas(t *testing.T) { + strategy := NewRandomStrategy() + + db, err := strategy.Choose([]container.DB{}) + assert.Nil(t, db) + assert.ErrorIs(t, err, errNoReplicasAvailable) +} + +func TestStrategy_Name(t *testing.T) { + roundRobin := NewRoundRobinStrategy(3) + assert.Equal(t, string(StrategyRoundRobin), roundRobin.Name()) + + random := NewRandomStrategy() + assert.Equal(t, string(StrategyRandom), random.Name()) +} diff --git a/pkg/gofr/external_db.go b/pkg/gofr/external_db.go index 3effa9347..0114af936 100644 --- a/pkg/gofr/external_db.go +++ b/pkg/gofr/external_db.go @@ -1,10 +1,26 @@ package gofr import ( + "strconv" + "strings" + "go.opentelemetry.io/otel" + "gofr.dev/pkg/gofr/config" "gofr.dev/pkg/gofr/container" "gofr.dev/pkg/gofr/datasource/file" + "gofr.dev/pkg/gofr/datasource/sql" + "gofr.dev/pkg/gofr/logging" + "gofr.dev/pkg/gofr/metrics" +) + +const ( + maxIdleReplicaCapDefault = 50 + minIdleReplicaDefault = 10 + maxOpenReplicaCapDefault = 200 + minOpenReplicaDefault = 50 + defaultIdleReplicaDefault = 10 + defaultOpenReplicaDefault = 100 ) // AddMongo sets the Mongo datasource in the app's container. @@ -220,3 +236,189 @@ func (a *App) AddCouchbase(db container.CouchbaseProvider) { a.container.Couchbase = db } + +// AddDBResolver sets up read/write splitting for SQL databases. +func (a *App) AddDBResolver(resolver container.DBResolverProvider) { + // Exit if SQL is not configured. + if a.container.SQL == nil { + a.Logger().Errorf("Cannot set up DB resolver: SQL is not configured") + return + } + + // Set up logger, metrics, tracer. + resolver.UseLogger(a.Logger()) + resolver.UseMetrics(a.Metrics()) + + tracer := otel.GetTracerProvider().Tracer("gofr.dbresolver") + resolver.UseTracer(tracer) + + // Connect (no-op for resolver) + resolver.Connect() + + // Create replica connections. + replicas := createReplicaConnections(a.Config, a.Logger(), a.Metrics()) + if len(replicas) == 0 { + a.Logger().Debugf("No replicas configured, skipping DB resolver setup") + return + } + + // Build resolver with primary and replicas. + resolverDB, err := resolver.Build(a.container.SQL, replicas) + if err != nil { + a.Logger().Errorf("Failed to build DB resolver: %v", err) + return + } + + a.container.SQL = resolverDB + a.Logger().Logf("DB read/write splitting enabled with %d replicas", len(replicas)) +} + +// createReplicaConnections creates optimized DB connections to replicas. +func createReplicaConnections(cfg config.Config, logger logging.Logger, mtrcs metrics.Manager) []container.DB { + hosts := strings.Split(cfg.Get("DB_REPLICA_HOSTS"), ",") + ports := strings.Split(cfg.Get("DB_REPLICA_PORTS"), ",") + users := strings.Split(cfg.Get("DB_REPLICA_USERS"), ",") + passwords := strings.Split(cfg.Get("DB_REPLICA_PASSWORDS"), ",") + + // Ensure minimum: at least hosts must be defined + if len(hosts) == 0 || (len(hosts) == 1 && hosts[0] == "") { + return nil + } + + var replicas []container.DB + + for i, host := range hosts { + host = strings.TrimSpace(host) + if host == "" { + continue + } + + port := safeGet(ports, i, cfg.Get("DB_PORT")) + user := safeGet(users, i, cfg.Get("DB_USER")) + pass := safeGet(passwords, i, cfg.Get("DB_PASSWORD")) + + // Wrap replica config + replicaConfig := &replicaConfigWrapper{ + Config: cfg, + host: host, + port: port, + user: user, + password: pass, + } + + replica := sql.NewSQL(replicaConfig, logger, mtrcs) + if replica != nil { + replicas = append(replicas, replica) + + logger.Logf("Created DB replica connection to %s:%s as user %s", host, port, user) + } + } + + return replicas +} + +// safeGet returns the element at index i if present, otherwise fallback. +func safeGet(list []string, i int, fallback string) string { + if i < len(list) && strings.TrimSpace(list[i]) != "" { + return strings.TrimSpace(list[i]) + } + + return fallback +} + +// replicaConfigWrapper wraps config and optimizes connection settings for replicas. +type replicaConfigWrapper struct { + config.Config + host string + port string + user string + password string +} + +// Get overrides config values for replica optimization. +func (c *replicaConfigWrapper) Get(key string) string { + switch key { + case "DB_HOST": + return c.host + case "DB_PORT": + return c.port + case "DB_USER": + return c.user + case "DB_PASSWORD": + return c.password + case "DB_MAX_IDLE_CONNECTION": + return optimizedIdleConnections(c.Config) + case "DB_MAX_OPEN_CONNECTION": + return optimizedOpenConnections(c.Config) + default: + return c.Config.Get(key) + } +} + +func getReplicaConfigInt(cfg config.Config, key string, fallback int) int { + valStr := cfg.Get(key) + + if valStr == "" { + return fallback + } + + val, err := strconv.Atoi(valStr) + + if err != nil || val <= 0 { + return fallback + } + + return val +} + +func optimizedIdleConnections(cfg config.Config) string { + // Load caps from config or fallback to defaults + maxCap := getReplicaConfigInt(cfg, "DB_REPLICA_MAX_IDLE_CONNECTIONS", maxIdleReplicaCapDefault) + minVal := getReplicaConfigInt(cfg, "DB_REPLICA_MIN_IDLE_CONNECTIONS", minIdleReplicaDefault) + defaultVal := getReplicaConfigInt(cfg, "DB_REPLICA_DEFAULT_IDLE_CONNECTIONS", defaultIdleReplicaDefault) + + val, err := strconv.Atoi(cfg.Get("DB_MAX_IDLE_CONNECTION")) + + if err != nil || val <= 0 { + return strconv.Itoa(defaultVal) + } + + optimized := val * 4 + + switch { + case optimized > maxCap: + optimized = maxCap + case optimized < minVal: + optimized = minVal + } + + return strconv.Itoa(optimized) +} + +func optimizedOpenConnections(cfg config.Config) string { + // Load caps from config or fallback to defaults + maxCap := getReplicaConfigInt(cfg, "DB_REPLICA_MAX_OPEN_CONNECTIONS", maxOpenReplicaCapDefault) + minVal := getReplicaConfigInt(cfg, "DB_REPLICA_MIN_OPEN_CONNECTIONS", minOpenReplicaDefault) + defaultVal := getReplicaConfigInt(cfg, "DB_REPLICA_DEFAULT_OPEN_CONNECTIONS", defaultOpenReplicaDefault) + + val, err := strconv.Atoi(cfg.Get("DB_MAX_OPEN_CONNECTION")) + + if err != nil { + return strconv.Itoa(defaultVal) + } + + if val == 0 { + return strconv.Itoa(defaultVal) + } + + optimized := val * 2 + + switch { + case optimized > maxCap: + optimized = maxCap + case optimized < minVal: + optimized = minVal + } + + return strconv.Itoa(optimized) +}